docs: reconcile requirements/CLAUDE.md with shipped reality (high-confidence)

Flip stale Phase-1 checkboxes whose capability is clearly delivered:
M1/M2/M3 (modes), Q1/Q2 (SQL subset — shipped via the unified walker, not
sqlparser-rs), TT1/TT2/TT3 (test tiers 1–3) → [x]; TT4 (PTY e2e, critical
flows only) → [~].

Fix stale CLAUDE.md claims: the stack no longer uses chumsky (DSL) or a
reserved sqlparser-rs (SQL) — both retired (ADR-0024 §migration Phase F);
the DSL and advanced-mode SQL are both parsed by the unified grammar
walker (ADRs 0024 / 0030–0036). Corrects the stack note, drops the
now-done "SQL handling in advanced mode" deferred bullet, and updates the
parser.rs layout comment.

Lower-confidence items (C1 rename, A1, I1a, I3, I4, T3, V2, export/import,
resume) left for a dedicated per-item reconciliation pass (handoff-45 §5).
This commit is contained in:
claude@clouddev1
2026-05-27 14:31:52 +00:00
parent 35e1963ad0
commit 2bcc55f939
2 changed files with 17 additions and 15 deletions
+8 -6
View File
@@ -22,9 +22,13 @@ new ADR that supersedes the old one.
Current decisions at a glance (each backed by an ADR):
- **Stack:** Rust + Ratatui + Crossterm; `sqlparser-rs` reserved
for SQL (advanced mode, not yet wired); `chumsky` for the DSL;
`rusqlite` for the database (ADR-0001).
- **Stack:** Rust + Ratatui + Crossterm; both the DSL and
advanced-mode SQL are parsed by a single hand-rolled
grammar/walker (ADR-0024's unified grammar tree; SQL added by
ADRs 00300036) — superseding ADR-0001's original plan of
`chumsky` for the DSL + a reserved `sqlparser-rs` for SQL
(neither is a dependency now); `rusqlite` for the database
(ADR-0001).
- **Backend:** SQLite with `STRICT` tables and FK enforcement on
(ADR-0002). Database access through a dedicated worker thread
with mpsc/oneshot request channels (ADR-0010).
@@ -116,7 +120,7 @@ Current decisions at a glance (each backed by an ADR):
│ │ ├── action.rs # ReferentialAction enum + parsing
│ │ ├── command.rs # Command AST + RelationshipSelector + RowFilter
│ │ ├── mod.rs # re-exports
│ │ ├── parser.rs # chumsky grammar (all DSL commands)
│ │ ├── parser.rs # parse entry point → unified-grammar walker
│ │ ├── shortid.rs # base58 generator + validator
│ │ ├── types.rs # user-facing Type enum + fk_target_type
│ │ └── value.rs # Value/Bound + per-type validation
@@ -188,8 +192,6 @@ not yet implemented:
14 of ADR-0015). Pending pieces: `export` / `import` (Iter
5), `--resume` + persistent input history hydration +
migration framework scaffold (Iter 6).
- **SQL handling in advanced mode** (Q1): `sqlparser-rs` parser
+ a defined SQL subset (Q4 — its own ADR).
- **Column drops/renames/type changes** (B2 / C2 partial): the
rebuild-table primitive (ADR-0013) is in place; the grammar
and dispatch are pending.