alkdev/alkgit

0 Fork 0

Files

T

History

glm-5.3-flash 201c7a1fce docs: D-1 remainder — stale Internal-ops framing and OQ list

Completes review 001 D-1 (vision.md's half landed with ADR-015):

- alk-stack.md gitea-lesson item 2: supersession note pointing at
  ADR-012 §3 / ADR-015 (repo ops are External, scope + manage grant —
  right mechanism, wrong axis).
- AGENTS.md lifecycle status: active OQ list updated (OQ-03
  partially resolved, OQ-05 deferred, OQ-16 deferred; OQ-04/06/08
  resolved via ADR-013/012/011).
- review 001: D-1 marked resolved.

All three stale statements were pre-decomposition landmines: research
docs are declared 'current source of truth' by AGENTS.md, so the
superseded admin-API design needed marking.

2026-09-29 08:30:45 +00:00

alk-stack.md

docs: D-1 remainder — stale Internal-ops framing and OQ list

2026-09-29 08:30:45 +00:00

git-protocol.md

docs(research): POC-2 complete — server-side pack generation verified

2026-09-20 18:36:11 +00:00

gitoxide.md

docs(research): POC-2 complete — server-side pack generation verified

2026-09-20 18:36:11 +00:00

negotiation-captures.md

docs(architecture): resolve OQ-02 — V2 negotiation ack loop (ADR-014)

2026-09-25 04:05:11 +00:00

poc2-findings.md

docs(research): POC-2 complete — server-side pack generation verified

2026-09-20 18:36:11 +00:00

poc3-findings.md

docs(research): POC-3 complete — smart-http through alkhttp verified

2026-09-21 02:44:25 +00:00

poc-1-findings.md

docs(research): POC-1 complete — pkt-line over alkcall BiStream verified

2026-09-20 12:18:04 +00:00

pocs.md

docs(research): record POC-3 outcome — phase 0 gates all pass

2026-09-21 02:45:08 +00:00

push-captures.md

docs(architecture): resolve OQ-04 — receive-pack state machine (ADR-013)

2026-09-25 04:05:07 +00:00

README.md

docs(architecture): resolve OQ-04 — receive-pack state machine (ADR-013)

2026-09-25 04:05:07 +00:00

reference-policy.md

feat: workspace skeleton + phase 0 research docs

2026-09-19 15:36:21 +00:00

vision.md

docs(architecture): ADR-015 — manage grant tier + repo-op gate, OQ-16 identity namespace

2026-09-26 11:50:25 +00:00

README.md

alkgit Research Index

Phase 0 (exploration) research. Feeds phase 1 (architecture).

Doc	Topic	Status
vision.md	Vision, guiding principles, non-goals, phase-0 checklist	draft v2 (amended 2026-09-21)
gitoxide.md	gitoxide (gix) capability + version alignment	initial pass complete
alk-stack.md	alk stack fit, integration surface, gitea-lesson constraints	initial pass complete
git-protocol.md	Server-side git smart protocol inventory (what we own)	initial pass complete
reference-policy.md	Licenses, reference projects, reuse policy	complete
pocs.md	POC plan (what to validate before architecture commits)	planned
poc-1-findings.md	POC-1: pkt-line over alkcall BiStream (duplex producer)	complete — proceed
poc2-findings.md	POC-2: server-side pack generation (streaming pipeline)	complete — proceed
poc3-findings.md	POC-3: smart-http shape through alkhttp (stateless substrate)	complete — proceed
push-captures.md	Normative receive-pack (push) wire record (real git captures)	complete — ADR-013 basis
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.
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.