RFC-0018 completion filter proposal
Versioned draft snapshot
RFCs, reference catalogs, and evidence reflect Spec 3b2e3e7a114fb826b1445d39a48756b8fff629cd. Counts and pending/status notes belong to that snapshot. Read the dated project update for later progress.
Source repositories are private during staging. Links marked “repository access required” need access to the linked repository.
This is a trace and gap record from the pinned draft specification. It does not establish proof or implementation conformance.
Status: owner decision requested, 2026-10-04. Owners: Compiler, DX, and Spec. No Gnomon compiler is deployed.
Conflict
RFC-0018 §7.3 gives two incompatible instructions for completion after
mustSatisfy [:
- Return only
invariantdeclarations whose parameter types are compatible with the enclosing action’s input types. - Show incompatible invariants with a warning suffix and
deprecated: true.
The projection claim
https://gnomon.sh/claim/RFC-0018/sec-7/mustsatisfy-incompatible-deprecated
records the second rule. The RFC-0018 Lean completion catalog does not settle
the contradiction. This is an editor suggestion contract, not a change to
type-checking: an incompatible invariant remains invalid when selected.
Recommendation
Return only compatible invariants in the default completion list. A completion candidate is normally an actionable insertion, and filtering keeps the list focused. A separate explicit search or diagnostic may show an incompatible invariant and explain the type mismatch, but it should not be presented as a deprecated valid completion. Remove the incompatible-display bullet and update the projection claim to the filtered result, retaining its subject IRI. This keeps the first §7.3 instruction and the normal completion semantics consistent.
The alternate choice is to include incompatible invariants with warning and
deprecated: true. In that case remove “only compatible,” specify stable
ranking and the insertion-time diagnostic, and test that users can distinguish
deprecated-but-valid items from type-invalid items.
Acceptance
- Align RFC-0018 §7.3, its Lean completion facts, claim projection source, generated Turtle, and source-bound review. Compare the literal RDF diff and local query results before publication.
- Test compatible and incompatible invariant candidates with an action input type, including diagnostics after an incompatible item is inserted.
- Verify the chosen behavior in the LSP adapter once a Gnomon compiler implementation exists. The current framework checkout has no such compiler to test.