docs: record ADR-0024 completion, reconcile requirements.md + handoff-14

ADR-0024 audited as fully implemented. Amend the ADR with a "Phase F
minimal" implementation note (parser.rs retained as the router +
ParseError home) and update the README index line to match.

Reconcile docs/requirements.md against handoffs 10-14: refresh the
test baseline (449 -> 1006), mark U4 (replay) satisfied, correct the
A1 / H1a / H3 progress notes.

Amend handoff-14: §3 flagged items both resolved (ranker kept,
CommandNode.hint_mode removed); §4 rewritten as a concrete next-work
pointer at the reconciled requirements.md.
This commit is contained in:
claude@clouddev1
2026-05-15 23:03:18 +00:00
parent 6d2b92996d
commit 41043d686b
4 changed files with 125 additions and 53 deletions
+29 -14
View File
@@ -26,9 +26,12 @@ repo is pushed).
## Test baseline
After B2/C2 (column drop / rename / change-type): **449
passing, 0 failing, 0 skipped** (`cargo test`). Clippy clean
with the nursery lint group enabled.
After ADR-0024 full implementation + the handoff-14 cleanup
pass: **1006 passing, 0 failing, 1 ignored** (`cargo test`
the one ignored test is a long-standing `` ```ignore ``
doc-test in `src/friendly/mod.rs`). Clippy clean with the
nursery lint group enabled. (Earlier reference point, after
B2/C2: 449 passing.)
---
@@ -101,11 +104,12 @@ with the nursery lint group enabled.
available in both modes: `save`, `save as`, `load`, `new`,
`rebuild`, `export`, `import`, `seed`, `replay`, `undo`,
`redo`, `mode`, `help`, `hint`, `quit`.
*(Progress: `quit`/`q`, `mode simple|advanced`, `help` (basic
listing), `save`, `save as`, `load`, `new`, `rebuild`,
`export`, `import` all implemented (Iterations 4 + 5). `seed`
in the seeding iteration; `replay` / `undo` / `redo` in the
U-series; `hint` with H2.)*
*(Progress: `quit`/`q`, `mode simple|advanced`, `help`,
`save`, `save as`, `load`, `new`, `rebuild`, `export`,
`import`, `replay` all implemented (Iterations 4 + 5;
`replay` via ADR-0024 Phase E — see U4). `seed` in the
seeding iteration; `undo` / `redo` in the U-series; `hint`
with H2.)*
## DSL data commands
@@ -301,8 +305,12 @@ with the nursery lint group enabled.
- [x] **U3** `history.log` records every successfully executed
command in append-only form (Iteration 2). Format:
`<ISO-8601 Z>|ok|<source>` per ADR-0015 §5.
- [ ] **U4** `replay` runs commands from a `history.log` or
`.commands` file.
- [x] **U4** `replay` runs commands from a `history.log` or
`.commands` file. *(Implemented via ADR-0024 Phase E:
`runtime::run_replay` parses each non-blank, non-`#`-comment
line with the schema-aware parser and dispatches it through
the normal pipeline; stops at the first error, no rollback;
nested replay refused. Covered by `tests/replay_command.rs`.)*
## Sharing and export (per ADR-0007)
@@ -350,14 +358,21 @@ with the nursery lint group enabled.
separate effort from H1 (which targets database errors); it
targets parser errors. Pending — multiple targeted fixes
shipping piecemeal so far (e.g. `values` becoming optional in
INSERT removes one such case).
INSERT removes one such case; ADR-0024's typed value slots
give per-column-type rejection wording; `insert into T (col)`
with no `values` clause now flags "looks like Form A — add
`values (...)`"). A systematic pass is still pending.
- [ ] **H2** `hint` provides contextual help for the current
input or the most recent error.
- [ ] **H3** `help` provides general reference and per-command
help.
*(Progress: `help` app-level command lists currently-supported
commands + DSL grammar reference + types, kept in sync with
what's wired up. Per-command detail is the missing piece.)*
*(Progress: the `help` command lists currently-supported
commands + DSL grammar reference + types. As of ADR-0024
§help_id it is assembled by iterating the command REGISTRY
and translating each `CommandNode.help_id`, so a new command
appears automatically. A general reference and `help
<command>`-style detailed per-command help are still the
missing pieces.)*
## CLI