Skip to content

docs: reconcile stale refinement-type ("TRefined parses") claims — owner-only SPDX edits (follow-up to #558) #599

Description

@hyperpolymath

Follow-up to #558 (closed) / #598.

#558's premise was stale — refinement/dependent types were removed 2026-04-10, so refinement syntax parse-errors (no silent-accept path). #598 landed the code-side honest-rejection (assume(...)) + the misnamed-fixture fix. This issue tracks the remaining doc reconciliation, which is owner-only: the strict pre-commit SPDX / literal-owner-header check gates .adoc/.md edits, so automated changes are blocked (and --no-verify must not be used — the hook is a load-bearing LLM-attribution-drift detector).

Stale claims to correct

  • docs/CAPABILITY-MATRIX.adoc (~line 152): "TRefined parses; predicates do not reduce; no SMT" — false. TRefined does not exist; T where (P) and assume(...) parse-error today. Should read: refinement types unsupported (grammar removed 2026-04-10; CORE-05 deferred post-v1).
  • docs/STATE-2026-*.adoc CORE-05 row(s): "parse-only" → "removed / deferred post-v1".
  • docs/TECH-DEBT.adoc (CORE-05 row): same reconciliation.

Non-goals / notes

  • T where (P) parser-level honest-rejection is non-viable — the shared WHERE token forces a shift/reduce that menhir resolves by shifting into the refinement, regressing trait where-clauses (fn f() -> T where C). It remains a generic parse error by design; do not add a grammar production for it.
  • Optional low-priority hygiene: dead error codes E0305 / W0701 (defined in lib/error.ml, never constructed) could be removed.

Why this is owner-only

The .adoc files need the owner's SPDX + literal-owner header to pass the strict pre-commit gate; these are manual owner edits, same constraint that parked the #554 doc prose.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationDocs, prose, diagrams, READMEs, ADRslicensingLicences, SPDX headers, REUSE compliance, attribution

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions