test: add E2E integration tests with CI support (#27) (#27)

- Add tests/integration/e2e_test.go with 6 comprehensive E2E tests
  - TestE2E_VersionSelection_RealRepository
  - TestE2E_VersionSelection_EdgeCases (regression for v0.7.6 bug)
  - TestE2E_ResolveWorkflow
  - TestE2E_DependencyChain
  - TestE2E_AtomMatching
  - TestE2E_CachedRepository

- Update integration.yml to run E2E tests in Gentoo container
- Update CHANGELOG.md and ROADMAP.md for v0.7.7

Author: kolkov

.github/workflows/integration.yml

@@ -16,7 +16,7 @@ on:
   workflow_dispatch:
     inputs:
       test_filter:
-        description: 'Test filter (e.g., TestAutotools, TestCMake, TestMeson)'
+        description: 'Test filter (e.g., E2E, Autotools, CMake, Meson)'
         required: false
         default: ''
       timeout_minutes:
@@ -76,6 +76,19 @@ jobs:
           go build -v -o bin/grpm ./cmd/grpm
           ./bin/grpm version || echo "Version check completed"
 
+      - name: Run E2E Tests
+        if: ${{ !github.event.inputs.test_filter || contains(github.event.inputs.test_filter, 'E2E') }}
+        run: |
+          echo "=== E2E Integration Tests ==="
+          echo "Testing version selection, resolve workflow, dependency chains..."
+          go test -v -tags=integration -timeout=10m \
+            -run 'TestE2E' \
+            ./tests/integration/...
+        env:
+          GRPM_REPO_PATH: /var/db/repos/gentoo
+          GRPM_DIST_DIR: /var/cache/distfiles
+          GRPM_TMP_DIR: /var/tmp/portage
+
       - name: Run Autotools Tests
         if: ${{ !github.event.inputs.test_filter || contains(github.event.inputs.test_filter, 'Autotools') }}
         run: |

CHANGELOG.md

@@ -14,6 +14,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.7.7] - 2026-01-13
+
+### E2E Integration Tests & CI Enhancement
+
+> **Professional E2E test suite for full workflow validation**
+>
+> Adds comprehensive end-to-end tests that would have caught the v0.7.6
+> version selection bug automatically. Tests run in CI with real Gentoo.
+
+### Added
+
+#### E2E Integration Tests (`tests/integration/e2e_test.go`)
+- **TestE2E_VersionSelection_RealRepository** — Version selection on real Gentoo tree
+  - Validates correct version is selected for app-misc/hello, dev-libs/openssl, app-shells/bash
+  - Catches alphabetical vs PMS version comparison bugs
+- **TestE2E_VersionSelection_EdgeCases** — 5 edge cases with controlled repository
+  - `patch_vs_base`: 2.12 vs 2.12.2
+  - `numeric_comparison`: 1.9 vs 1.10 vs 1.11
+  - `suffix_ordering`: 1.0_alpha < 1.0_beta < 1.0_rc1 < 1.0
+  - `revision_comparison`: 2.0-r1 vs 2.0-r10 (numeric, not string)
+  - `complex_gentoo_real`: Real-world version sets
+- **TestE2E_ResolveWorkflow** — Full dependency resolution workflow
+- **TestE2E_DependencyChain** — Deep dependency chain resolution
+- **TestE2E_AtomMatching** — Atom constraints (>=, <, =)
+- **TestE2E_CachedRepository** — Cache consistency verification
+
+#### CI Integration
+- **E2E tests added to integration.yml** — Runs in Gentoo container
+  - New step "Run E2E Tests" before Autotools/CMake/Meson tests
+  - Uses real `/var/db/repos/gentoo` repository
+  - 10-minute timeout (E2E tests are fast)
+- **Manual trigger support** — Filter with `E2E` in workflow dispatch
+
+### Test Results (Gentoo WSL2)
+```
+TestE2E_VersionSelection_RealRepository: PASS (0.18s)
+  - app-misc/hello: 2.12.2 (correct!)
+  - dev-libs/openssl: 3.6.9999 (from 14 versions)
+  - app-shells/bash: 9999 (from 20 versions)
+TestE2E_VersionSelection_EdgeCases: PASS (0.01s)
+TestE2E_ResolveWorkflow: PASS (0.02s)
+TestE2E_AtomMatching: PASS (0.00s)
+TestE2E_CachedRepository: PASS (0.16s)
+```
+
+### Changed
+- `.github/workflows/integration.yml` — Added E2E test step with Gentoo environment
+
+---
+
 ## [0.7.6] - 2026-01-13
 
 ### Critical Bug Fix: Version Selection

ROADMAP.md

@@ -1,12 +1,13 @@
 # GRPM Roadmap
 
-> **Version Selection Fix (v0.7.6)**
+> **E2E Integration Tests (v0.7.7)**
 >
 > Rapid development complete (v0.1.0 → v0.5.0).
 > Infrastructure release complete (v0.6.0).
 > Portage-style logging (v0.7.0) + compatibility fixes (v0.7.2 → v0.7.4).
 > Build reliability and output quality improvements (v0.7.5).
 > Critical version selection bug fix + emerge flags (v0.7.6).
+> Professional E2E test suite with CI integration (v0.7.7).
 > **98.2% tree coverage verified on real Gentoo!**
 
 ---
@@ -67,14 +68,18 @@ Key insight: **Eclasses don't need Go implementations.** They are loaded dynamic
 
 ## Release History
 
-### v0.7.5 — Build Quality Release (Current)
+### v0.7.7 — E2E Integration Tests (Current)
 
-**Professional output and reliable builds:**
+**Professional E2E test suite with CI integration:**
 
-- **Unified logging infrastructure** — All output uses `internal/logging/` package
-- **Debug output suppressed** — Clean output by default, verbose with `-v`
-- **Source build fixes** — S variable parsing, timestamp preservation, replace mode
-- **CLI improvements** — --help exit code fix, mirror:// expansion in emerge
+- **6 E2E tests** — Version selection, resolve workflow, dependency chains, atom matching
+- **CI integration** — Tests run in Gentoo container on every release
+- **Regression prevention** — Would have caught v0.7.6 version selection bug automatically
+
+### v0.7.5/v0.7.6 — Build Quality & Bug Fixes
+
+- **v0.7.6** — Critical version selection bug fix, --replace/--force flags
+- **v0.7.5** — Unified logging, debug output suppressed, source build fixes
 
 ### v0.7.4 — Critical Hotfix
 
@@ -155,11 +160,13 @@ Key insight: **Eclasses don't need Go implementations.** They are loaded dynamic
 ## Roadmap to v1.0.0
 
 ```
-v0.7.5 ← CURRENT (Build Quality Release)
+v0.7.7 ← CURRENT (E2E Integration Tests)
     │   ✅ v0.6.0: Distfile fetching, debug helpers, coverage analyzer
     │   ✅ v0.7.0: Portage-style logging
     │   ✅ v0.7.2-v0.7.4: Portage compatibility fixes
     │   ✅ v0.7.5: Unified logging, source build reliability
+    │   ✅ v0.7.6: Version selection fix, emerge flags
+    │   ✅ v0.7.7: E2E tests + CI integration
     │   ✅ 98.2% tree coverage on real Gentoo!
     ↓
 v0.8.0 — Production Hardening (2 tasks)
@@ -290,4 +297,4 @@ Key deliverables:
 ---
 
 *This roadmap evolves based on community feedback and project needs.*
-*Last updated: 2026-01-13 (v0.7.5 release)*
+*Last updated: 2026-01-13 (v0.7.7 release)*