gnomonlearn
Docs/RFC-0035/Reference catalog

RFC-0035 · Reference catalog

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.

← Read the authored RFC

Generated reference catalog. This page renders structured Lean data for RFC-0035: defined terms, diagnostics, dependencies, and invariants. It does not establish proof coverage or runtime conformance. The authored narrative lives in RFC-0035.

This page is generated from the lean/Gnomon/Spec/ module for RFC-0035. Edit that source and regenerate this catalog.


Title: Core Standard Library
Status: draft
Owners: Compiler, Module Platform, Runtime
Diagnostic range: M35000-M35099

Depends on: RFC-0006, RFC-0008, RFC-0010, RFC-0016

Proof citations in source: 4 / 4. Standalone proof verification is pending.


Definitions

TermMeaning
core.types.CurrencyCodeAn ISO 4217 currency code (e.g., USD, EUR). Underlying type Text.
core.types.EmailAn RFC 5321 email address. The compiler validates format at parse time when used as a literal.
core.types.IdentifierA stable, opaque identity value (e.g., UUID, ULID). Never reused after deletion. Underlying type Text.
core.types.InstantA point in time with millisecond precision (UTC). Alias for RFC-0006’s Timestamp.
core.types.LocaleA BCP 47 language tag (e.g., en-US). Underlying type Text.
core.types.MoneyA monetary amount over Decimal. Does not carry a currency; pair with a core.types.CurrencyCode field.
core.types.URLAn absolute URL. The compiler validates scheme at parse time when used as a literal.

Diagnostics

CodeSeverityDescription
M35001ErrorThird-party module declares a name in the reserved core namespace
M35002ErrorReference to an unknown core.* name — not defined in any RFC
M35010Errorcore.migrations.* intrinsic slot has a type mismatch
M35020WarningType brand mismatch — value of one core.types.* branded type assigned to a differently-branded field

Dependency neighborhood

graph LR
  nRFC_0035["RFC-0035"]
  nRFC_0006["RFC-0006"]
  nRFC_0035 --> nRFC_0006
  nRFC_0008["RFC-0008"]
  nRFC_0035 --> nRFC_0008
  nRFC_0010["RFC-0010"]
  nRFC_0035 --> nRFC_0010
  nRFC_0016["RFC-0016"]
  nRFC_0035 --> nRFC_0016

Invariants

  1. Any core.* name not defined in this or a future RFC MUST produce error M35002. (enforced by: compile-time)
  2. Authors MUST NOT depend on the absence of a core.* name since non-breaking additions may occur in minor compiler releases. (enforced by: RFC process)
  3. Third-party modules MUST NOT declare names in the core namespace or any sub-namespace. (enforced by: compile-time)
  4. core is versioned with the Gnomon compiler and breaking changes to any core.* declaration constitute a breaking change to the language itself. (enforced by: RFC process)
  5. core.migrations.* intrinsics are compiler-opaque and pass through to the migration DAG builder as structured nodes. (enforced by: compile-time)

Normative Statements

Statements are structured source data. Proof citations, where present, have not passed a standalone Gnomon proof gate.

Reserved Namespace

  1. MUST — Any core.* name not defined in this or a future RFC MUST produce error M35002. (proof citation: rfc0035_b6_grounded; verification pending)
  2. MUST — Declaring a name in the core namespace MUST produce error M35001 at module declaration time. (proof citation: rfc0035_b2_grounded; verification pending)
  3. MAY — Future RFCs MAY reserve additional core sub-namespaces.
  4. MUST_NOT — Third-party modules MUST NOT declare names in the core namespace or any sub-namespace.

Versioning

  1. MUST_NOT — Authors MUST NOT depend on the absence of a core.* name.
  2. MAY — Non-breaking additions to core MAY be made in minor compiler releases.

core.migrations — Schema Migration Intrinsics

  1. MUST — AddEntity.target MUST be a declared entity in the same module. (proof citation: rfc0035_b8_grounded; verification pending)
  2. MUST — ChangeType.transform MUST reference a declared transform declaration. (proof citation: rfc0035_b0_grounded; verification pending)

Linked References

DirectionTarget
Depends onRFC-0006
Depends onRFC-0008
Depends onRFC-0010
Depends onRFC-0016