3.0 KiB
Roadmap
The detailed backlog is AGENTS-TASKS.md.
Implemented foundation
- Local CLI repository with full-world epoch snapshots.
- Five entity collections with add/edit/show/diff/delete operations.
- Statistics, positions, duration/effects, selected relationships, and random generation.
- Timeline advance, switch, log, tags, summaries, and explicit future deletion.
Current release target
The trustworthy-foundation milestone is complete: documentation now reflects
the executable, user-triggerable panic paths found in the audit are guarded,
initialisation is safe, show, read-only fsck, and world diff are real,
individual files are persisted atomically, and CLI workflows are covered.
The dependable-daily-CLI milestone is complete: naming and aliases are consistent, organisations are managed directly, help includes examples, Nerd Font output has a portable build option, relationships are type-validated, and every mutation has documented and tested recovery guidance.
The Phase 4 format contract is implemented. Native format 1.0 initialization, locking, recovery, staging, immutable commits, revert, and recoverable pruning are implemented. The unreleased prototype reader and its temporary migration were removed before the first release. Future compatible changes use 1.x versions and regain explicit migration tooling when needed. Organisation-agnostic custom fields and types follow, with unknown-field retention designed before that format change.
The TUI browser now includes search, layer browsing, responsive layouts, and guarded terminal handling. Its entity editor supports previewed worktree creation/edits and conflict-checked one-step undo through the library. Interactive staging, commits, relationships, and general deletion remain later workflows.
The simulation track has deterministic world generation, road topology, character travel, and spatial event frontiers. The next approved work is the shared resolution and conflict design: influx first, then protected-town/character diffusion outcomes, then fight/war. The presentation design is implemented alongside those slices so every new preview is buffered and exportable rather than adding more direct terminal printing. PNG map rendering follows those tracker issues.
Proposed stretch goals
- Shell completions and generated man pages.
- Stable JSON/JSONL output and query/filter expressions.
- Extend the TUI entity editor with previewed staging and commit workflows.
- Named timeline branches with merge/conflict handling.
- Setting templates for empires, companies, guilds, and nations.
- Validation/simulation hooks before committing an epoch.
- Optional signed snapshots and append-only audit records.
- Deterministic seeded generation/simulation.
- A scripting/plugin boundary after persistence is stable.
Completions and structured output are the best first stretch investments. A TUI and branching should wait until staging, revert, and locking are reliable.