epoch_forge/docs/issue-audit.md

4.3 KiB
Raw Blame History

Gitea issue audit

This audit maps the open issues from the project tracker to the current codebase as of 2026-09-21. Tracker entries predate several milestones, so an open checkbox does not necessarily mean the behavior is absent.

Issue Current assessment Next action
#19 Tweak Show Addressed: normal rows now use a dedicated short renderer with name, kind, stable ID, position, and aggregate stats. Verify visual density in real terminals.
#18 Implement show Addressed for the CLI: show defaults to all, dispatches every collection, filters by name/text/position, reads historical epochs, and renders epoch summaries at three detail levels. Consider structured output and richer stat predicates later.
#17 Serialization errors/upgrades Version detection and actionable rejection are complete. No legacy release exists, so a speculative upgrader was intentionally removed. Add explicit 1.x migrations when the first real format change exists.
#16 Rewrite backend Addressed by Workspace, typed snapshots, transactional writes, broad integration coverage, and removal of the remaining unjustified legacy unsafe fn declarations. Avoid rewriting stable code wholesale; continue adding focused tests.
#15 Clamp stats Addressed: CLI/TUI mutations clamp normalized persistent stats to 0..=120, event/blocker modifiers and growth to -120..=120, and population remains an unbounded non-negative count (or a bounded negative modifier). Workspace validation rejects bypassed invalid state. Move these defaults into schemas if custom-stat domains become configurable.
#14 Build fsck Addressed for read-only validation: every epoch is parsed and checked for duplicate IDs, collection types, ordinary links, governors, and capitals. Put serializer rewriting in a separately previewed repair command, not fsck.
#13 Add all cards into pre-events Explicitly deferred by the maintainer for this milestone. Revisit only when requested.
#12 Add fight/war Open simulation feature. Model it as configured events/relationships after custom fields and influx semantics settle.
#11 Epoch Diffing Addressed: epoch and layer comparisons share a deterministic, serializable typed diff with changed-field details and importance classification. Extend the type rather than parsing terminal output when structured formats arrive.
#10 Display functions Addressed for inspection: unified show and diff rendering build complete strings before a single output write, and Displayable::full_display no longer forces library output through println!. Apply the same boundary opportunistically to mutation confirmations.
#9 Adding influx Open and underspecified. Define versioned deterministic severity and avoidance rules before commands.
#8 Event diffusion Planned in the simulation roadmap; blocked on roads, residency, and deterministic routing. Complete simulation checkpoints 2–3 in order.
#6 HashMap/HashSet Addressed without format churn: EntityIndex provides ephemeral UUID/name hash indexes and duplicate-ID detection over the stable vector representation. Repository validation uses the index and hash lookup for relationships. Rebuild indexes after mutation; never persist them.

Preferred order: finish display buffering/structured output and custom fields, implement roads/residency, then build influx, fight/war, and diffusion on those foundations.