alkgit/docs/research

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 v1
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

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.