Skip to content

docs(plan): implementation plan for the grammar drift verifier (#643) - #646

Merged
adityamukho merged 3 commits into
v3from
plan/643-grammar-verifier
Oct 20, 2026
Merged

adityamukho merged 3 commits into
v3from
plan/643-grammar-verifier

Conversation

@adityamukho

Copy link
Copy Markdown
Collaborator

Implementation plan for #643, following the merged spec (#644).

Plan: docs/superpowers/plans/2026-10-20-643-grammar-verifier.md

PRs:

  • PR 2 (v3): 25 new codes, PRS-083–PRS-107 (24 user-facing INT-019 sites + the retract-arity INT-000); the 4 unreachable INT-019 sites stay.
  • PR 3 (v3): the verifier: lexical and structural levels, the semantic-code list with witnesses, KNOWN_DRIFT.
  • PR 4 (v3): pest → EBNF renderer, generated docs/GRAMMAR.md, docs-site snapshot PR.
  • PR 5 (main): verifier backport (no new codes) and the scheduled job for both branches.

Deviations from the spec, for approval (plan "Deviations"):

  1. grammar.pest's fact becomes exact (3 values + optional valid-time map; retract exactly 3). Otherwise the loose rule hides the 5+ element fact bug, and the generated EBNF would be loose too. This moves two corpus files to invalid/syntax/ and makes the fact-shape codes syntax.
  2. 15 templates instead of 12, so short fillers reach full clauses.
  3. A no-separator join at k ≤ 3 replaces the spec's claim that gluing is the lexical level's job (parse_edn and pest both read :find?e as one keyword).
  4. Known-drift entries carry min_k.
  5. Correction: new codes have no binding build impact (ErrorCode is pub(crate)).

Reviewed with Codex: line references, workflows and grammar claims confirmed; drift entries now state their direction and a witness.

Docs only. Part of #643.

🤖 Generated with Claude Code

https://claude.ai/code/session_019kY61Y11gcRD91Y6b7jbGT

@adityamukho
adityamukho merged commit bd4a0db into v3 Oct 20, 2026
24 checks passed
@adityamukho
adityamukho deleted the plan/643-grammar-verifier branch October 20, 2026 10:26
@codecov

codecov Bot commented Oct 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant