gnomonlearn
Docs/Kernel field to RFC trace

Kernel field to RFC trace

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.

The field names and AX identifiers below come from the pinned external Spec.Kernel at commit 3725bd9f6d2711aa9bb179deea84f51e4424382a. lean/Gnomon/Spec/AxiomsCatalog.lean supplies a motivating RFC, which is a starting lead, not proof that the authored clause covers the whole field. Links below were checked against the current authored Markdown. This table checks specification traceability only; implementation conformance and proof status are separate gates.

K1 — Identity and uniqueness

Formal fieldAuthored clauseTrace result
idStable (AX-001)RFC-0036 §3.1: backend-allocated, stable IDsExact authored rule; implementation test mapping pending.
externalIdPermanent (AX-010)RFC-0036 §3.3: external ID must not be reassigned after deletionExact authored rule; implementation test mapping pending.
idSpaceDisjoint (AX-011)RFC-0036 §3.1: Resource and Statement IDs must not be sharedExact authored rule; implementation test mapping pending.
statementUniqueness (AX-016)RFC-0036 §4.2: overlapping intervals on the same triple rejected with M36011Partial: the formal field says equal S/P/O/validFrom implies equal Statements, including interval edge cases the prose does not spell out. Clarify the authored uniqueness key and test it.
noTripleOverlap (AX-045)RFC-0036 §4.2: overlapping intervals on the same triple rejected with M36011Exact authored rule; this shares one authored clause with AX-016. Formal relationship and test mapping pending.

K2 — Boundary fidelity

Formal fieldAuthored clauseTrace result
emitDeterministic (AX-005)AxiomsCatalog nominates RFC-0008; its diagnostics section catalogs codesGap: no exact rule found that identical input and rule produce identical code, severity, and anchor. Add a normative clause and deterministic compiler test.
predicateWriteAndPersist (AX-008)RFC-0036 §3.4 requires both persisted forms; §4.2 requires exactly one at write timeExact authored rules; implementation test mapping pending.
softDeleteFilteredWithOverride (AX-014)RFC-0036 §9.1 requires default filtering and explicit includeSoftDeleted overrideExact authored rule; implementation test mapping pending.
boundaryAcceptOrReject (AX-020)AxiomsCatalog nominates RFC-0036; RFC-0034 §5 rejects malformed inbound requestsGap: the cited rule covers one request boundary, not every write, read, validation, and error boundary quantified by the formal field. Define scope or add clauses and tests.
softDeleteObservable (AX-022)RFC-0036 §9.2 requires projected deletedAt in traversalExact authored rule for traversal; check the formal field’s wider read-result scope and implementation tests.
schemaValidationTotal (AX-043)AxiomsCatalog nominates RFC-0024; RFC-0034 §5 requires malformed input rejection before handler executionPartial: RFC-0034 is the closer authored clause, but the total accept-or-reject proposition for every Endpoint schema is not stated. Align the catalog citation and add a complete normative rule/test.

K3 — Mediated state and authorization

Formal fieldAuthored clause or closest leadTrace result
storageMediated (AX-002)RFC-0007 §6Partial: describes physical storage, not every state-persisting Operation and time.
permissionBitfield (AX-012)RFC-0036 §5Gap in formalization: the Lean proposition is canonicalCheck x y = canonicalCheck x y, which cannot establish the bitfield rules.
cacheCoherent (AX-017)RFC-0042 §5.2Partial: four permission-cache invalidation triggers, not all caches and mutated inputs.
refIntegrity (AX-018)RFC-0036 §4.2Partial: Statement reference rules do not cover every live Reference.
denormCoherent (AX-023)RFC-0036 §3.4Partial: predicate denormalization is constrained; the Lean predicate is stipulated and needs a substantive definition.
provenanceTracked (AX-025)RFC-0007 §3Partial: derived gnomons require lineage; formal DerivedEntity scope may be wider.
epistemicAuthorship (AX-026)RFC-0007 §4.4 and §8Partial: compare actor attribution and synchronous determinism separately; Lean uses stipulated predicates.
principalBearing (AX-039)RFC-0048 §9.1Partial: inbound identity flow does not establish a Principal for every Operation.
capabilityMediated (AX-040)RFC-0042 §4.2 and RFC-0048 §5Partial: policy evaluation and attenuation need reconciliation with the Lean iff over every Operation.
sessionPrincipalBinding (AX-041)RFC-0048 §4Partial: session identity is described; test the universal binding of every in-session Operation.

K4 — Bitemporal types

Formal fieldAuthored clause or closest leadTrace result
workspaceReachable (AX-006)RFC-0036 §6.1Partial: workspace membership is modeled; Lean constructs a workspace with universal membership, which does not establish persisted reachability.
bitemporalityFirstClass (AX-007)RFC-0036 §8Partial: graph queries expose both times; formal field quantifies over every Boundary.
resourceKindMinimum (AX-009)RFC-0036 §3.2Partial: nonempty kind uses kindNonempty axiom; opacity needs an authored rule.
bigintIsDecimal (AX-015)RFC-0036 §7.3Authored decimal-string serialization rule; implementation test mapping pending.
intervalWellFormed (AX-019)RFC-0036 §4.2Authored rejection for inverted Statement intervals; implementation test mapping pending.
bitfieldValidityDecidable (AX-021)RFC-0036 §5Partial: allowed bits are specified, but Lean proves excluded middle, not validator behavior.
typeAssignmentTotal (AX-038)RFC-0006 §4.APartial: type hierarchy does not establish total typing of every Value and Expression.
endpointSchemaPair (AX-042)RFC-0024 §3Partial: operation input/output schema requirement; formal Endpoint scope may differ.
bindingPreservesSchema (AX-044)RFC-0024 §6Gap: no rule found equating request and response Schemas for all Endpoints bound to one Aion function.

K5 — Spec discipline

Formal fieldAuthored clause or closest leadTrace result
moduleSurfaceUnique (AX-003)RFC-0001 §3Gap: declared namespace/version do not guarantee equal surfaces for equal identities.
rfcImmutableOnceAccepted (AX-004)RFC-0001 §4Gap: this module contract does not state RFC immutability; Lean Accepted is uninhabited.
conformanceExact (AX-013)RFC-0036 §10Gap: graph invariants are narrower than every implementation and SpecArtifact.
edgeAionForm (AX-027)RFC-0007 §3Exact rule for edge-gnomons’ subject, predicate, and object; test mapping pending.
generationDiscipline (AX-028)RFC-0007 §3Partial: physical projection tables are generated; Lean quantifies over every PhysicalArtifact.
conceptNamedFiles (AX-029)RFC-0008 §5Partial: concept folder and naming conventions need comparison with every formal File.
fileClassPurity (AX-030)RFC-0008 §3Authored one-class rule has explicit co-location exceptions; formal equality omits them.
meaningIsPlainProse (AX-031)RFC-0008 §3Partial: meaning required for entity/facet; Lean quantifies over every Declaration.
grammarIsPeg (AX-032)RFC-0008 §8Mismatch: authored grammar is EBNF; PEG expressibility needs evidence.
concernsLocalized (AX-033)RFC-0008 §3Partial: selected concern placement rules, not every Concern.
projectManifestName (AX-034)RFC-0008 §7Conflict: authored name is project.gnm; formal field asserts project.aion. Change the formal field and catalog lead to the emitted contract.
approvalGate (AX-035)RFC-0008 §3Gap: universal sensitive-declaration human approval rule absent; Lean sensitivity is uninhabited.
aionDeclarationLocality (AX-036)RFC-0007 §3Gap: no clause found that every formal AionFn has a declaring Module.
effectSetStatic (AX-037)RFC-0007 §3Gap: no static effect-set rule found; Lean decidability follows from a stipulated relation.
predicatePathValidUnique (AX-046)RFC-0036 §4.3Partial: path uniqueness is authored; formal kind/path global equality is a named axiom and needs exact scope and test.

K6 — Optimizable substrate

Formal fieldAuthored clause or closest leadTrace result
authIdempotent (AX-047)RFC-0005 §4aGap: no all-operation idempotence rule for install, migrate, generate, and register.
refinementMonotone (AX-048)RFC-0006 §7Partial: authored monotonicity does not define the Lean Module refinement order.
selfConformant (AX-049)RFC-0008 §3Gap: an existing conformant implementation is not established by authoring rules or Lean’s constructed witness.
improvementClosed (AX-050)RFC-0001 §5Gap: every positive-score Module having a Refactor is not an authored rule.

K7 — Aesthetic floor

Formal fieldAuthored clause or closest leadTrace result
noCompositionCycles (AX-051)RFC-0004 §4Gap: no universal cycle rejection rule found; Lean defines hasCompositionCycle as false.
boundedCompositionDepth (AX-052)RFC-0004 §4Gap: no numeric maximum for every composition chain found.
refactorMonotone (AX-053)RFC-0006 §7Partial: semantic monotonicity is authored; strict complexity decrease or justification is not.
unjustifiedRefactorWF (AX-054)RFC-0001 §5Gap: no authored termination measure or well-founded refactor rule.
justifiedRequiresApproval (AX-055)RFC-0000Gap: no matching approval-record and human-approver rule identified.
boundedDeclarationDensity (AX-056)RFC-0008 §3Gap: file-class rules do not impose a numeric density bound.
boundedCoupling (AX-057)RFC-0001 §3Gap: resolvable cross references do not impose a numeric coupling bound.

These are specification traces, not proof or implementation conformance claims. For each partial row, compare the authored rule’s domain and quantifiers with the Lean field and align them. For each gap or conflict, amend the authored and formal contracts together, then add an executable implementation test. Record declaration and assumption dependencies; the proof gate must compile before any row is called proved.