glm-5.3-flash
a3cdef909b
- Cargo workspace with 5 sub-crates: alkgit-core (storage), alkgit-transport (smart protocol), alkgit-http, alkgit-ssh, alkgitd (binary); sha1 pinned through the gix stack, sha256 passthrough feature - docs/research/: vision, gitoxide alignment, alk stack fit, server-side protocol inventory, license/reference policy, POC plan - AGENTS.md: conventions mirroring alkcall (no comments, thiserror, tokio, no secrets on wire/at rest, visible-surface=authorized-surface, gitoxide-only serving path, bounded resources, registry-resolved repos) Verified: cargo build, clippy -D warnings, fmt, test, check --all-features
30 lines
1.6 KiB
Markdown
30 lines
1.6 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 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. |