glm-5.3-flash
e76f91f6d7
- 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
43 lines
2.7 KiB
Markdown
43 lines
2.7 KiB
Markdown
# alkgit Research Index
|
|
|
|
Phase 0 (exploration) research. Feeds phase 1 (architecture).
|
|
|
|
| Doc | Topic | Status |
|
|
|---|---|---|
|
|
| [vision.md](vision.md) | Vision, guiding principles, non-goals, phase-0 checklist | draft v2 (amended 2026-09-21) |
|
|
| [gitoxide.md](gitoxide.md) | gitoxide (gix) capability + version alignment | initial pass complete |
|
|
| [alk-stack.md](alk-stack.md) | alk stack fit, integration surface, gitea-lesson constraints | initial pass complete |
|
|
| [git-protocol.md](git-protocol.md) | Server-side git smart protocol inventory (what we own) | initial pass complete |
|
|
| [reference-policy.md](reference-policy.md) | Licenses, reference projects, reuse policy | complete |
|
|
| [pocs.md](pocs.md) | POC plan (what to validate before architecture commits) | planned |
|
|
| [poc-1-findings.md](poc-1-findings.md) | POC-1: pkt-line over alkcall BiStream (duplex producer) | complete — proceed |
|
|
| [poc2-findings.md](poc2-findings.md) | POC-2: server-side pack generation (streaming pipeline) | complete — proceed |
|
|
| [poc3-findings.md](poc3-findings.md) | POC-3: smart-http shape through alkhttp (stateless substrate) | complete — proceed |
|
|
| [push-captures.md](push-captures.md) | Normative receive-pack (push) wire record (real git captures) | complete — ADR-013 basis |
|
|
| [negotiation-captures.md](negotiation-captures.md) | Normative V2 negotiation record (real git captures + source) | complete — ADR-014 basis |
|
|
|
|
## Key findings so far
|
|
|
|
- gitoxide covers storage + pkt-line; the **server half of the smart
|
|
protocol is ours to write** (gix-protocol/transport are client-side).
|
|
- Published gix 0.87.1 == local clone base; pin crates.io versions.
|
|
- alkcall `BiStream` is the natural substrate under pkt-line for both ssh
|
|
and http paths.
|
|
- The incompatible-license prior art confirms feasibility but contributes
|
|
nothing; policy in [reference-policy.md](reference-policy.md).
|
|
- `gix` with `default-features = false` requires an explicit hash feature;
|
|
workspace pins `sha1` with a `sha256` passthrough feature everywhere.
|
|
|
|
## Convergence criteria (phase 0 → phase 1)
|
|
|
|
Phase 0 is done when POC-1..3 have results and a recommended-approach
|
|
summary is written here (append below). Then the Architect produces
|
|
`docs/architecture/` per sdd_process.
|
|
|
|
**Convergence (2026-09-21)**: phase 0 gates all pass (POC-1/2/3 proceed).
|
|
Phase 1 opened with `docs/architecture/`; the structural decision is
|
|
ADR-010 — pure protocol crate following the alktty/alktunnels template
|
|
(the v1 "monorepo + alkgitd binary" framing in these research docs was an
|
|
init-agent artifact, amended in vision.md v2). POC-1 maps to the producer
|
|
half, POC-2 to the gix backend implementation, POC-3 to the stateless
|
|
substrate consumed by alkhttp's future `git` feature. |