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

## 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.