[tobyvee]

ENG-017 — Local-git DeliveryAdapter (commit without GitHub)

A first live run surfaced that a no-GitHub run produces no verifiable code: delivery is
GitHub-API-only, so with GITHUB_* unset the coding agent's files are discarded and QA (tool-less
api backend) has nothing to verify — every ticket reworks to the cap and blocked (6/6 in the run).

This adds a LocalGitDeliveryAdapter behind the existing DeliveryAdapter port — no GitHub
account/remote needed; a ticket can reach done offline with real, inspectable code on disk.

• packages/integrations/src/local/delivery.ts — full port via local git: createBranch,
  commitFiles (write → add → commit, returns SHA), openPullRequest (synthetic file:// ref),
  getChecks → success, merge (local --no-ff); deploy hooks no-op. Per-commit identity (no global
  git config needed), path-traversal-guarded writes.
• Concurrency-safe: in-process queue + self-contained checkout -f → write → commit units, so the
  heartbeat auto-starting all backlog tickets can't corrupt the shared repo.
• localGitBranchFiles() reads a branch's committed files via git (not the working tree).
• Wiring: deliveryFromEnv() returns the local adapter when DELIVERY_BACKEND=local;
  implementTicket is unchanged (the port abstraction commits to the local repo). QA now verifies
  real code — verifyTicket injects the committed files into the assess prompt (and says "nothing to
  verify" when none), fixing the doomed-rework cost.
• Ops: DELIVERY_BACKEND passthrough + a ./workspace bind-mount in compose; .env.example documents
  it.

Verification

Real-git unit tests (commit→branch→merge, concurrent commits isolated, traversal rejected, missing
repo → []); typecheck · lint · 98 tests green.

Notes

• A live run also needs the worker fix (separate PR fix/worker-temporal-connection) to reach Temporal
  in Docker. Both PRs touch docker-compose.yml in different sections (restart policy vs. volume/env).
• Follow-up: run the target repo's tests as the local "CI" check before the merge gate.

🤖 Generated with Claude Code