Integration tests - GitHub API mocking and caching

[johnproblems]

Task: Integration tests - GitHub API mocking and caching

Description

Create integration tests for GitHub API integration including authentication, issue sync, caching, and error handling. Test API request/response flow, rate limiting, offline behavior, and cache invalidation with proper mocking.

Acceptance Criteria

• Tests verify GitHub authentication flow
• Tests validate issue creation and updates
• Tests check issue fetching and synchronization
• Tests verify caching behavior and cache hits
• Tests validate rate limiting handling
• Tests check offline/network error scenarios
• Tests verify cache invalidation on data changes
• All tests pass consistently

Technical Details

• Create test files:
  • test/integration/github/githubClient.test.ts
  • test/integration/github/issueSync.test.ts
  • test/integration/github/caching.test.ts
• Test scenarios:
  • OAuth authentication with GitHub
  • Personal Access Token validation
  • Create GitHub issue from task
  • Update existing GitHub issue
  • Fetch issues for epic/task
  • Two-way sync (GitHub → local, local → GitHub)
  • Cache hit for recent requests
  • Cache miss triggers API call
  • Cache invalidation on manual refresh
  • Rate limit detection (HTTP 429)
  • Rate limit backoff and retry
  • Network timeout handling
  • Offline mode behavior
  • API error response handling
• Mock GitHub API using nock or similar HTTP mocking library
• Create test fixtures for GitHub API responses
• Test caching with different TTL values
• Simulate rate limiting responses
• Files affected: test/integration/github/*.test.ts (new)

Dependencies

• Task 24 - GitHub authentication implemented
• Task 25 - GitHub issue sync implemented
• Task 26 - Sync commands implemented
• Task 3 - Testing infrastructure configured

Effort Estimate

• Size: L
• Hours: 10
• Parallel: true

Definition of Done

• Code implemented
• Tests written and passing
• Documentation updated
• Code reviewed
• All GitHub integration paths tested
• Mock API responses validated