Files
alkgit/tasks/architecture/oq-04-receive-pack.md
T
glm-5.3-flash e76f91f6d7 docs(architecture): resolve OQ-04 — receive-pack state machine (ADR-013)
- ADR-013: V0-framed push machine grounded in real git 2.43.0 captures
  (file://, git://, smart-http mock, raw stdio into real receive-pack):
  V0-shaped ref advertisement (caps on first ref line, capabilities^{}
  sentinel only for empty repos), served capability set, shallow requests
  rejected for v1, thin packs accepted with server-odb bases (no
  capability involved; push.thin default), ingestion bound to
  Bundle::write_to_directory_eagerly + gix-fsck + one gix-ref transaction
  per push (.keep-guarded), unpack-first CAS timing with observed
  upstream order, band-1 pkt-line-framed status report, http framing
  (probe/Content-Length/chunked), v1 update policy (CAS only; deletes
  and force-push allowed)
- docs/research/push-captures.md: the normative push wire record
- transport.md/backend.md/doors.md: receive-pack sections rewritten to
  the decided shapes; backend.md ingestion composition bound; stale
  OQ-04 references resolved
- ADR-003 amended: V2-only governs fetch; push is V0-framed by upstream
  design (fixes the V2-only contradiction found in review)
- ADR-009 amended: haves default reconciled with the client's stateless
  ceiling (16384); blocking-pipeline budget covers generation+ingestion
- OQ-04 resolved; tracker task closed; CAS-fail-fast optimization
  tracked (tasks/architecture/oq-13-cas-failfast.md)
- research index: poc findings + capture docs listed

Verification: cargo test / clippy -D warnings / fmt --check / doc pass
2026-09-25 04:05:07 +00:00

1.4 KiB

id, name, status, depends_on, scope, risk, impact, level, tags
id name status depends_on scope risk impact level tags
architecture/oq-04-receive-pack OQ-04 unblock — receive-pack walkthrough/POC arrives completed
narrow trivial component research
external-trigger
deferred-oq
resolved-early

Description

Tracker for OQ-04 (deferred(unclear)): receive-pack (push) design validation. Resolved early (2026-09-25, ADR-013) — the investigation was run in-session rather than waiting for scheduling: real git push captures (git 2.43.0 over file://, git://, smart-http, plus raw stdio requests into real git receive-pack) resolved the full push state machine. OQ-04 is resolved by docs/architecture/decisions/013-receive-pack-state-machine.md; captures in docs/research/push-captures.md.

Work

None by default. On trigger: set OQ-04 to open in docs/architecture/open-questions.md and spawn the focused session that works through the push state machine. (Triggered and completed in the 2026-09-25 session.)

Verification

  • OQ-04 status matches this task's state in docs/architecture/open-questions.md (resolved).

Out of scope

  • Actually implementing receive-pack (phase 3 implementation work).

Summary

Resolved early via ADR-013: the walkthrough ran in-session; all seven unknowns (advertisement set, shallow policy, thin-pack acceptance, ingestion composition, CAS timing, status report, version/framing surface) have capture-grounded decisions.