Roadmap registry

A repository can carry a typed, versioned roadmap that the agent and team mutate through the same atomic contract.

Canonical files

roadmap/roadmap.yaml is canonical. roadmap/schema/roadmap-v1.schema.json defines the machine contract. Human views are deterministic generated outputs.

Mutation guarantees

• Every operation uses a stable sibling lock.
• expectedRevision detects concurrent updates.
• Writes use a same-directory temporary file, flush, fsync, atomic rename, and parent-directory fsync.
• Dependencies must resolve and remain acyclic.
• passed requires evidence; external_blocked requires an external prerequisite.

Core commands

$ jeden roadmap list --status planned --priority P1 --json
$ jeden roadmap show JED-024 --json
$ jeden roadmap graph --json
$ jeden roadmap check --json
$ jeden roadmap render
$ jeden roadmap work JED-024 --cwd .

State transitions

roadmap work sets the active goal and plan, creates todos from acceptance criteria, records a start event in the current session, and pins subsequent artifacts and branches to the roadmap item.