From 2f9ec0d89399351a75a986665532ffde4a4d002e Mon Sep 17 00:00:00 2001 From: Brandon Harvey Date: Thu, 26 Feb 2026 10:07:42 -0800 Subject: [PATCH] docs(audit): align stale command and planning log references Audit commits since 2026-02-25 and fix concrete documentation drift. Update README complexity table to reflect supported CLI behavior. Remove stale references to the removed export command surface. Describe replay-window complexity via follow --since/--replay semantics. Align docs index text with the current ergo plans log filename. Keep changes surgical and avoid behavior or API modifications. Preserve 80/20 simplicity by correcting docs instead of adding abstraction. Risk is low and limited to wording; no runtime paths are affected. Validation completed earlier in this run via just ci-fast. --- README.md | 4 ++-- docs/README.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index e236f05..f26aa1a 100644 --- a/README.md +++ b/README.md @@ -242,8 +242,8 @@ Algorithmic complexity below uses **N** = visible messages in the pool (depends |---|---|---| | Append | O(1) + O(payload bytes) | Writes one frame, updates one index slot, publishes the header. `durability=flush` adds OS flush cost. | | Get by seq (`fetch POOL SEQ`) | Usually O(1); O(N) worst case | If the index slot matches, it's a direct jump. If the slot is overwritten/stale/invalid (or M=0), it scans forward from the tail until it finds (or passes) the target seq. | -| Tail / follow (`follow`, `export --tail`) | O(k) to emit k; then O(1)/message | Steady-state work is per message. Tag filters are cheap; `--where` runs a jq predicate per message. | -| Export range (`export --from/--to`) | O(R) | Linear in the number of exported messages. | +| Tail / follow (`follow --tail`) | O(k) to emit k; then O(1)/message | Steady-state work is per message. Tag filters are cheap; `--where` runs a jq predicate per message. | +| Replay window (`follow --since ... --replay`) | O(R) | Linear in the number of replayed messages. | | Validate (`doctor`, `pool info` warnings) | O(N) | Full ring scan. Index checks are sampled/best-effort diagnostics. | ## Bindings diff --git a/docs/README.md b/docs/README.md index 9792342..5b36862 100644 --- a/docs/README.md +++ b/docs/README.md @@ -3,7 +3,7 @@ Plasmite documentation is intentionally split into: - `docs/record/`: canonical docs of record -- `.ergo/`: feature planning and task tracking via the ergo graph and events log +- `.ergo/`: feature planning and task tracking via the ergo graph and plans log (`plans.jsonl`) ## Start here