Skip to content

docs: refresh roadmap after v5.3.3 review cycle #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
flyingrobots wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: refresh roadmap after v5.3.3 review cycle #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 33 additions & 42 deletions ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ lives in [GRAVEYARD.md](./GRAVEYARD.md).

## Current Reality

- **Current release:** `v5.3.2` (2026-03-15)
- **Current line:** M16 Capstone shipped in `v5.3.0`; `v5.3.1` fixed repeated-chunk tree emission for repetitive content; `v5.3.2` stabilized test/runtime tooling; `v5.3.3` is the remaining M17 Ledger closeout in flight.
- **Current release:** `v5.3.3` (2026-03-17)
- **Current line:** M17 Ledger shipped in `v5.3.3`; the next planned line is M18 Relay targeting `v5.4.0`.
- **Supported runtimes:** Node.js 22.x (primary), Bun, Deno
- **Current operator experience:** the human-facing CLI/TUI is shipped now; the machine-facing agent CLI is planned next.

Expand Down Expand Up @@ -45,40 +45,38 @@ The agent CLI is a first-class workflow, not an extension of the human `--json`

## Shipped Summary

| Version | Milestone | Codename | Theme | Status |
|---------|-----------|----------|-------|--------|
| v3.1.0 | M13 | Bijou | TUI dashboard and animated progress | ✅ Shipped |
| v4.0.0 | M14 | Conduit | Streaming restore, observability, parallel chunk I/O | ✅ Shipped |
| v4.0.1 | M8 + M9 | Spit Shine + Cockpit | Review hardening, `verify`, `--json`, CLI polish | ✅ Shipped |
| v5.0.0 | M10 | Hydra | Content-defined chunking | ✅ Shipped |
| v5.1.0 | M11 | Locksmith | Envelope encryption and recipient management | ✅ Shipped |
| v5.2.0 | M12 | Carousel | Key rotation without re-encrypting data | ✅ Shipped |
| v5.3.0 | M16 | Capstone | Audit remediation and security hardening | ✅ Shipped |
| v5.3.1 | — | Maintenance | Repeated-chunk tree integrity fix | ✅ Shipped |
| v5.3.2 | — | Maintenance | Vitest workspace split, CLI version sync, and runtime/tooling stabilization | ✅ Shipped |
| Version | Milestone | Codename | Theme | Status |
| ------- | --------- | -------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------- |
| v3.1.0 | M13 | Bijou | TUI dashboard and animated progress | ✅ Shipped |
| v4.0.0 | M14 | Conduit | Streaming restore, observability, parallel chunk I/O | ✅ Shipped |
| v4.0.1 | M8 + M9 | Spit Shine + Cockpit | Review hardening, `verify`, `--json`, CLI polish | ✅ Shipped |
| v5.0.0 | M10 | Hydra | Content-defined chunking | ✅ Shipped |
| v5.1.0 | M11 | Locksmith | Envelope encryption and recipient management | ✅ Shipped |
| v5.2.0 | M12 | Carousel | Key rotation without re-encrypting data | ✅ Shipped |
| v5.3.0 | M16 | Capstone | Audit remediation and security hardening | ✅ Shipped |
| v5.3.1 | — | Maintenance | Repeated-chunk tree integrity fix | ✅ Shipped |
| v5.3.2 | — | Maintenance | Vitest workspace split, CLI version sync, and runtime/tooling stabilization | ✅ Shipped |
| v5.3.3 | M17 | Ledger | Release verification, review automation baseline, property tests, and hardened Ubuntu/non-root Docker test stages | ✅ Shipped |

Older history remains in [CHANGELOG.md](./CHANGELOG.md).

## Planned Release Sequence

| Version | Milestone | Codename | Theme | Status |
|---------|-----------|----------|-------|--------|
| v5.3.3 | M17 | Ledger | Planning and ops reset | 📝 Planned |
| v5.4.0 | M18 | Relay | LLM-native CLI foundation | 📝 Planned |
| v5.5.0 | M19 | Nouveau | Bijou v3 human UX refresh | 📝 Planned |
| v5.6.0 | M20 | Sentinel | Vault health and safety | 📝 Planned |
| v5.7.0 | M21 | Atelier | Vault ergonomics and publishing | 📝 Planned |
| v5.8.0 | M22 | Cartographer | Repo intelligence and change analysis | 📝 Planned |
| v5.9.0 | M23 | Courier | Artifact sets and transfer | 📝 Planned |
| v5.10.0 | M24 | Spectrum | Storage and observability extensibility | 📝 Planned |
| v5.11.0 | M25 | Bastion | Enterprise key management research | 📝 Planned |
| Version | Milestone | Codename | Theme | Status |
| ------- | --------- | ------------ | --------------------------------------- | ---------- |
| v5.4.0 | M18 | Relay | LLM-native CLI foundation | 📝 Planned |
| v5.5.0 | M19 | Nouveau | Bijou v3 human UX refresh | 📝 Planned |
| v5.6.0 | M20 | Sentinel | Vault health and safety | 📝 Planned |
| v5.7.0 | M21 | Atelier | Vault ergonomics and publishing | 📝 Planned |
| v5.8.0 | M22 | Cartographer | Repo intelligence and change analysis | 📝 Planned |
| v5.9.0 | M23 | Courier | Artifact sets and transfer | 📝 Planned |
| v5.10.0 | M24 | Spectrum | Storage and observability extensibility | 📝 Planned |
| v5.11.0 | M25 | Bastion | Enterprise key management research | 📝 Planned |

## Dependency Sequence

```text
M16 Capstone + v5.3.1/v5.3.2 maintenance ✅
|
M17 Ledger
M17 Ledger + v5.3.1/v5.3.2/v5.3.3 maintenance ✅
|
M18 Relay
|
Expand All @@ -97,31 +95,24 @@ M16 Capstone + v5.3.1/v5.3.2 maintenance ✅
M25 Bastion
```

This sequence is intentionally linear. It forces the docs/ops reset first, then the machine
interface split, then the human TUI refresh, and only then the broader feature expansion.
This sequence is intentionally linear. It keeps the docs/ops reset behind us, then moves into
the machine interface split, then the human TUI refresh, and only then the broader feature
expansion.

## Open Milestones

### M17 — Ledger (`v5.3.3`)

**Theme:** planning and operational reset after Capstone.

Deliverables:

- Close M16 in docs and reconcile [ROADMAP.md](./ROADMAP.md), [STATUS.md](./STATUS.md), and the shipped version history.
- Add `CODEOWNERS` or equivalent review-assignment automation.
- Document Git tree filename ordering semantics in test conventions to prevent future false positives.
- Define a release-prep workflow for `CHANGELOG` updates and version bump timing.
- Automate test-count injection into release notes or changelog prep.
- Add property-based fuzz coverage for envelope-encryption round-trips.

### M18 — Relay (`v5.4.0`)

**Theme:** first-class LLM-native CLI.

Deliverables:

- Introduce `git cas agent` as a separate machine-facing namespace.
- Add `actionlint` to CI and local checks.
- Automate GitHub Actions dependency updates so workflow runtime maintenance becomes proactive instead of reactive.
- Add regression coverage that Docker test images stay unprivileged and that the Deno image retains the Node binary needed for npm package install scripts.
- Define repository policy for JSDoc/review-bot coverage expectations so automated review warnings stay actionable.
- Document maintainer PR-thread resolution workflow for bot-driven review cycles.
- Add a dedicated machine command runner instead of extending the current human `runAction()` path.
- Define and implement the JSONL envelope contract:
`protocol`, `command`, `type`, `seq`, `ts`, `data`.
Expand Down
68 changes: 30 additions & 38 deletions STATUS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# @git-stunts/cas — Project Status

**Current release:** `v5.3.2`
**Current release:** `v5.3.3`
**Current branch version:** `v5.3.3`
**Last release:** `2026-03-15`
**Current line:** M16 Capstone shipped in `v5.3.0`; `v5.3.1` fixed repeated-chunk tree emission; `v5.3.2` stabilized test/runtime tooling; `v5.3.3` is the remaining M17 closeout in flight.
**Last release:** `2026-03-17`
**Current line:** M17 Ledger shipped in `v5.3.3`; the next planned line is M18 Relay targeting `v5.4.0`.
**Runtimes:** Node.js 22.x, Bun, Deno

---
Expand All @@ -17,43 +17,36 @@

## Recently Shipped

| Version | Milestone | Highlights |
|---------|-----------|------------|
| `v5.3.2` | Maintenance | Vitest workspace split for deterministic integration runs; CLI version sync; test/runtime tooling stabilization |
| `v5.3.1` | Maintenance | Repeated-chunk tree integrity fix; unique chunk tree entries; `git fsck` regression coverage |
| `v5.3.0` | M16 Capstone | Audit remediation, `.casrc`, passphrase-file support, restore guards, `encryptionCount`, lifecycle rename |
| `v5.2.0` | M12 Carousel | Key rotation without re-encrypting data |
| `v5.1.0` | M11 Locksmith | Envelope encryption and recipient management |
| `v5.0.0` | M10 Hydra | Content-defined chunking |
| `v4.0.1` | M8 + M9 | Review hardening, `verify`, `--json`, CLI polish |
| `v4.0.0` | M14 Conduit | Streaming restore, observability, parallel chunk I/O |
| `v3.1.0` | M13 Bijou | Interactive dashboard and animated progress |
| Version | Milestone | Highlights |
| -------- | ------------- | --------------------------------------------------------------------------------------------------------------- |
| `v5.3.3` | M17 Ledger | `release:verify`, `CODEOWNERS`, property-based envelope coverage, Ubuntu/non-root Docker test stages |
| `v5.3.2` | Maintenance | Vitest workspace split for deterministic integration runs; CLI version sync; test/runtime tooling stabilization |
| `v5.3.1` | Maintenance | Repeated-chunk tree integrity fix; unique chunk tree entries; `git fsck` regression coverage |
| `v5.3.0` | M16 Capstone | Audit remediation, `.casrc`, passphrase-file support, restore guards, `encryptionCount`, lifecycle rename |
| `v5.2.0` | M12 Carousel | Key rotation without re-encrypting data |
| `v5.1.0` | M11 Locksmith | Envelope encryption and recipient management |
| `v5.0.0` | M10 Hydra | Content-defined chunking |
| `v4.0.1` | M8 + M9 | Review hardening, `verify`, `--json`, CLI polish |
| `v4.0.0` | M14 Conduit | Streaming restore, observability, parallel chunk I/O |
| `v3.1.0` | M13 Bijou | Interactive dashboard and animated progress |

Milestone labels are thematic and non-sequential; the versions above are listed in release order.

---

## Next Up

### M17 — Ledger (`v5.3.3`)

Planning and ops reset:

- Reconcile `ROADMAP.md`, `STATUS.md`, and release messaging
- Add review automation (`CODEOWNERS` or equivalent)
- Document Git tree ordering test conventions
- Define release-prep workflow for changelog/version timing
- Automate test-count injection into release notes or changelog prep
- Add property-based fuzz coverage for envelope encryption

### M18 — Relay (`v5.4.0`)

LLM-native CLI foundation:
LLM-native CLI foundation plus review-cycle follow-through:

- Introduce `git cas agent`
- Define the JSONL protocol envelope and exit codes
- Add machine-facing parity for the current operational command set
- Enforce strict non-interactive input handling
- Add `actionlint` to CI/local checks and automate GitHub Actions version maintenance
- Add regression coverage for unprivileged Docker test images and the Deno stage's Node-assisted npm install path
- Define repository policy for JSDoc/review-bot coverage expectations and document PR thread-resolution workflow

### M19 — Nouveau (`v5.5.0`)

Expand All @@ -68,18 +61,17 @@ Human UX refresh:

## Sequenced Roadmap

| Version | Milestone | Theme |
|---------|-----------|-------|
| `v5.3.3` | M17 Ledger | Planning and ops reset |
| `v5.4.0` | M18 Relay | LLM-native CLI foundation |
| `v5.5.0` | M19 Nouveau | Bijou v3 human UX refresh |
| `v5.6.0` | M20 Sentinel | Vault health and safety |
| `v5.7.0` | M21 Atelier | Vault ergonomics and publishing |
| `v5.8.0` | M22 Cartographer | Repo intelligence and change analysis |
| `v5.9.0` | M23 Courier | Artifact sets and transfer |
| `v5.10.0` | M24 Spectrum | Storage and observability extensibility |
| `v5.11.0` | M25 Bastion | Enterprise key-management research |
| Version | Milestone | Theme |
| --------- | ---------------- | --------------------------------------- |
| `v5.4.0` | M18 Relay | LLM-native CLI foundation |
| `v5.5.0` | M19 Nouveau | Bijou v3 human UX refresh |
| `v5.6.0` | M20 Sentinel | Vault health and safety |
| `v5.7.0` | M21 Atelier | Vault ergonomics and publishing |
| `v5.8.0` | M22 Cartographer | Repo intelligence and change analysis |
| `v5.9.0` | M23 Courier | Artifact sets and transfer |
| `v5.10.0` | M24 Spectrum | Storage and observability extensibility |
| `v5.11.0` | M25 Bastion | Enterprise key-management research |

---

*Future details: [ROADMAP.md](./ROADMAP.md) | Shipped detail: [COMPLETED_TASKS.md](./COMPLETED_TASKS.md) | Superseded: [GRAVEYARD.md](./GRAVEYARD.md)*
_Future details: [ROADMAP.md](./ROADMAP.md) | Shipped detail: [COMPLETED_TASKS.md](./COMPLETED_TASKS.md) | Superseded: [GRAVEYARD.md](./GRAVEYARD.md)_