docs(spec): archive ABC-5 clone cache work

Author: skulidropek

.kanban/changes/ABC-5/design.md

@@ -64,3 +64,24 @@ The bare mirror path remains:
 ## Recommended Implementation Constraint
 
 Prefer minimal changes to the existing bare mirror flow first. Treat "git pull под нужную нам ветку" as the externally visible invariant: cache is refreshed, then workspace is checked out to the requested branch. Add a working-copy cache only if e2e verification shows the bare mirror flow cannot satisfy the requirement.
+
+## Final Design Decision
+
+The implementation kept the existing bare mirror cache and did not introduce a separate working-copy cache. This preserved the established cache root and state-repo ignore contract while satisfying the branch-refresh invariant:
+
+1. Refresh `/home/<sshUser>/.docker-git/.cache/git-mirrors/<repo-cache-key>.git` with branch/tag-only refspecs.
+2. Clone warm-cache workspaces from that local mirror.
+3. Restore `origin` to the authenticated repository URL before network fetch/pull.
+4. Run `git pull --ff-only origin <repoRef>` for normal branch refs, or `git pull --ff-only` for no-ref default-branch clones.
+5. Keep PR/MR refs on explicit fetch into deterministic local branches.
+6. Keep issue refs as deterministic local branches after fallback clone.
+
+No new cache directory was added, so the existing `.cache/git-mirrors/` ignore and untrack behavior remains sufficient.
+
+## Archive Invariants
+
+- Cache key remains derived from canonical `REPO_URL`, not `AUTH_REPO_URL`.
+- Broad cache refresh remains limited to `refs/heads/*` and `refs/tags/*`.
+- Tokenized auth URLs are used for network operations only; final remote normalization still runs through the existing fork/upstream remote block.
+- Clone completion/failure markers remain `/run/docker-git/clone.done` and `/run/docker-git/clone.failed`.
+- CLI/API contracts are unchanged.

.kanban/changes/ABC-5/proposal.md

@@ -42,3 +42,11 @@ GitHub issue #138:
 - Cache paths remain ignored and untracked by state repository sync.
 - Existing clone flows continue to work for normal branches, issue URLs, GitHub PR refs, GitLab MR refs, and no-ref clones.
 - Tests document the cache reuse and branch-refresh contract.
+
+## Archive Status
+
+- Status: implemented
+- Spec commit: `f961baa docs(spec): add ABC-5 clone cache plan`
+- Implementation commit: `a47e794 feat(clone): reuse repository cache for branch pulls`
+- Final behavior: warm-cache clones use the refreshed bare mirror as the local clone source, then restore the authenticated origin and run branch-aware `git pull --ff-only` for normal branch/default branch flows.
+- E2E note: `bun run e2e:clone-cache` is updated but could not run in the local review environment because the host CLI cannot auto-discover the controller when `DOCKER_HOST=tcp://host.docker.internal:2375` and `DOCKER_GIT_API_URL` is unset.

.kanban/changes/ABC-5/tasks.md

@@ -34,6 +34,24 @@
 
 ## Open Questions
 
-- Should the final implementation use only the existing bare mirror cache, or introduce a separate working-copy cache to match the literal "git pull" wording?
-- Should concurrent clone cache refreshes use a lock file in the shared cache volume?
-- Should failed cache refresh be a warning with fallback or a hard clone failure?
+- Resolved: use the existing bare mirror cache; no separate working-copy cache was added.
+- Deferred: concurrent clone cache refreshes still do not use a lock file.
+- Preserved: failed cache refresh remains a warning/fallback behavior rather than a hard clone failure.
+
+## Archive Verification
+
+- [x] `bun run --filter @effect-template/lib test -- tests/core/templates.test.ts` (48 tests passed)
+- [x] `bun run --filter @effect-template/lib test` (51 files, 268 tests passed)
+- [x] `bun run --filter @prover-coder-ai/docker-git test` (73 files, 463 tests passed)
+- [x] `bun run typecheck`
+- [x] `bun run lint`
+- [x] `bun run build`
+- [x] Local git repro for warm-cache branch path: bare mirror refresh, clone from mirror, restore origin, `git pull --ff-only origin <branch>`.
+- [ ] `bun run e2e:clone-cache` blocked by local Docker/controller discovery: `DOCKER_HOST=tcp://host.docker.internal:2375` with no reachable `DOCKER_GIT_API_URL`.
+
+## Archive Result
+
+- Completed branch: `vk/d6b8-abc-5-github-138`
+- Spec commit: `f961baa docs(spec): add ABC-5 clone cache plan`
+- Implementation commit: `a47e794 feat(clone): reuse repository cache for branch pulls`
+- Merge status: not merged to `main`.