chore: git cache cleanup

docs/plans/archive/docker_compose_ci_fix_summary.md

@@ -0,0 +1,83 @@
+# Docker Compose CI Fix - Quick Reference
+
+**Document**: [Full Remediation Plan](docker_compose_ci_fix.md)
+**Status**: Ready for Implementation
+**Priority**: CRITICAL
+
+---
+
+## Problem
+
+E2E tests failing with:
+```
+charon-app Error pull access denied for sha256, repository does not exist
+```
+
+## Root Cause
+
+The workflow passes **bare SHA256 digest** to Docker Compose:
+```yaml
+CHARON_E2E_IMAGE_DIGEST: sha256:057a9998...
+```
+
+Docker tries to pull from a repository named "sha256" (doesn't exist).
+
+## Solution
+
+Use the **local tag** that already exists after `docker load`:
+
+### Change 1: Workflow
+
+**File**: `.github/workflows/e2e-tests.yml` (line 158)
+
+```diff
+- CHARON_E2E_IMAGE_DIGEST: ${{ needs.build.outputs.image_digest }}
++ # Use local tag for pre-built image (loaded from artifact)
++ CHARON_E2E_IMAGE: charon:e2e-test
+```
+
+### Change 2: Compose File
+
+**File**: `.docker/compose/docker-compose.playwright-ci.yml` (lines 31-37)
+
+```diff
+- # CI default (digest-pinned via workflow output):
+- # CHARON_E2E_IMAGE_DIGEST=ghcr.io/wikid82/charon:nightly@sha256:<digest>
+- # Local override (tag-based):
++ # CI default: Uses pre-built image loaded from artifact
++ # Set via workflow: CHARON_E2E_IMAGE=charon:e2e-test
++ # Local development: Uses locally built image
++ # Override with: CHARON_E2E_IMAGE=charon:local-dev
+- image: ${CHARON_E2E_IMAGE_DIGEST:-${CHARON_E2E_IMAGE:-charon:e2e-test}}
++ image: ${CHARON_E2E_IMAGE:-charon:e2e-test}
+```
+
+## Why This Works
+
+| Step | Current (Broken) | Fixed |
+|------|-----------------|-------|
+| Build | Tags as `charon:e2e-test` | Same |
+| Load | Image available as `charon:e2e-test` | Same |
+| Compose | Tries to use `sha256:...` ❌ | Uses `charon:e2e-test` ✅ |
+
+## Verification
+
+```bash
+# After changes, run locally:
+export CHARON_E2E_IMAGE=charon:e2e-test
+docker compose -f .docker/compose/docker-compose.playwright-ci.yml config | grep "image:"
+
+# Should output:
+# image: charon:e2e-test
+```
+
+## Testing
+
+1. Create PR with both changes
+2. Monitor `e2e-tests.yml` workflow
+3. Verify "Start test environment" step succeeds
+4. Confirm health check passes
+
+---
+
+**See [docker_compose_ci_fix.md](docker_compose_ci_fix.md) for full analysis and implementation details.**