test: Complete integration test infrastructure

[anjor]

Test Infrastructure Enhancement: Complete Integration Tests

Overview

Complete the integration test infrastructure that was started in Phase 7 but needs additional work to be fully functional and reliable.

Current Status

• Foundation Complete: 23 integration tests with architectural framework established
• Infrastructure: Keyring mocking and test fixtures in place
• Gap: Integration tests currently excluded from CI due to reliability issues

Proposed Improvements

• Fix Reliability Issues: Address keyring backend and API mocking inconsistencies
• CI Integration: Enable integration tests in GitHub Actions pipeline
• Test Coverage Expansion: Add integration tests for all major workflows
• Mock Service Improvements: Better Foundry API mocking for realistic testing
• Performance Optimization: Faster test execution for CI efficiency

Integration Test Categories

1. End-to-End Workflows: Full user journeys from auth to data retrieval
2. Authentication Flows: Token and OAuth2 authentication complete cycles
3. Data Pipeline Tests: Complex multi-step data operations
4. Error Handling: Network failures, API errors, invalid credentials
5. Cross-Platform: Windows/macOS/Linux compatibility validation

Technical Requirements

• Reliable keyring mocking that works across platforms
• Consistent API response mocking with realistic data
• Test isolation to prevent side effects
• Configurable test environments (staging Foundry instances)
• Performance benchmarks for regression detection

Acceptance Criteria

• All 23+ integration tests pass reliably in CI
• New integration tests added for recent features (shell, completion, aliases)
• Integration tests enabled in GitHub Actions
• Test execution time under 5 minutes for CI efficiency
• Cross-platform compatibility verified
• Mock services provide realistic API behavior
• Documentation for writing new integration tests

Priority: High
Labels: enhancement, technical-debt
Effort: Medium

Related

• Builds on foundation from Phase 7 (PR feat(testing): Add integration tests and pre-commit hooks #12, fix: Fix integration tests and enable in CI #13)
• Critical for maintaining quality as project grows
• Enables confident refactoring and new feature development