ContriveAtlas
neostory-schema-set/22snapshot a59c206cec9d
Open Observatory

Contracts and data · Portable contract system

One versioned schema closure projects into every runtime without surrendering meaning

Stable descriptor identifiers and a pinned schema-set revision are the portable authority. Swift types, the Python gateway, and the web snapshot are checked projections of that same contract rather than independent models.

Engineering · Partners
DeclaredImplementedObservedPlanned
neostory-schema-set/22snapshot a59c206cec9d

Contracts and data · Portable contract system

One versioned schema closure projects into every runtime without surrendering meaning

Stable descriptor identifiers and a pinned schema-set revision are the portable authority. Swift types, the Python gateway, and the web snapshot are checked projections of that same contract rather than independent models.

Engineering · Partners11 nodes · 11 directed relationships

What this view establishes

The architectural commitments

  1. The schema-set revision is the cross-runtime compatibility boundary; a language package version is not.
  2. Stable descriptor identifiers preserve meaning across renames and keep domain packages independently allocatable.
  3. Generated and interpreted projections are drift-gated, so no runtime gets to invent a competing ontology.

Pinned closure fan-out

03

Pinned closure

schema-setdeclared

Schema-set pin

One named closure with exact package versions and digests

schema-packagesdeclared

Schema packages

Entities, relationships, fields, traits and open enums

descriptor-idsimplemented

Stable identifier ledger

Allocations survive renames and prevent domain collisions

02

Generation and gates

schema-generatorimplemented

Schema generator

Resolves inheritance and emits deterministic projections

contract-gatesimplemented

Drift gates

Reject stale generated code, revisions and allocations

03

Distinct projections

swift-typesimplemented

Swift projections

Typed values plus lossless dynamic records

gateway-schemaimplemented

Gateway interpreter

Loads the pinned closure and validates canonical JSON

explorer-schemaimplemented

Explorer snapshot

Descriptor-driven inspection from Core-produced facts

03

Typed consumers

domain-codeimplemented

Domain-native code

Generated types and optional trusted behavior

generic-toolsimplemented

Generic tooling

Forms, queries and lenses for packages never imported

wire-recordsimplemented

Canonical wire records

The same bytes cross local, HTTP and server runtimes

Schema packages
02generatesSchema generatorimplemented
05interpreted byGateway interpreterimplemented
06exported byExplorer snapshotimplemented

Connections and evidence

Open the 11-relationship source key

Numbers set an explanatory reading order. They do not measure runtime timing.

  1. 01

    Schema-set pinSchema packages

    pins closure

    declared
  2. 02

    Schema packagesSchema generator

    generates

    implemented
  3. 03

    Stable identifier ledgerDrift gates

    governs

    implemented
  4. 04

    Schema generatorSwift projections

    emits

    implemented
  5. 05

    Schema packagesGateway interpreter

    interpreted by

    implemented
  6. 06

    Schema packagesExplorer snapshot

    exported by

    implemented
  7. 07

    Drift gatesSwift projections

    checks

    implemented
  8. 08

    Swift projectionsDomain-native code

    specializes

    implemented
  9. 09

    Swift projectionsGeneric tooling

    registers descriptors

    implemented
  10. 10

    Gateway interpreterCanonical wire records

    validates

    implemented
  11. 11

    Explorer snapshotGeneric tooling

    describes

    implemented

Connections and evidence

11 directed, source-backed relationships

Numbers set an explanatory reading order. They do not measure runtime timing.

  1. 01

    Schema-set pinSchema packages

    pins closure

    declared
  2. 02

    Schema packagesSchema generator

    generates

    implemented
  3. 03

    Stable identifier ledgerDrift gates

    governs

    implemented
  4. 04

    Schema generatorSwift projections

    emits

    implemented
  5. 05

    Schema packagesGateway interpreter

    interpreted by

    implemented
  6. 06

    Schema packagesExplorer snapshot

    exported by

    implemented
  7. 07

    Drift gatesSwift projections

    checks

    implemented
  8. 08

    Swift projectionsDomain-native code

    specializes

    implemented
  9. 09

    Swift projectionsGeneric tooling

    registers descriptors

    implemented
  10. 10

    Gateway interpreterCanonical wire records

    validates

    implemented
  11. 11

    Explorer snapshotGeneric tooling

    describes

    implemented

What this view establishes

The architectural commitments

  1. The schema-set revision is the cross-runtime compatibility boundary; a language package version is not.
  2. Stable descriptor identifiers preserve meaning across renames and keep domain packages independently allocatable.
  3. Generated and interpreted projections are drift-gated, so no runtime gets to invent a competing ontology.

Follow the live system

The Atlas is static and source-backed. The Observatory shows authenticated environment state.

22 repository sources behind this view
  • Explorer/app/explorer-snapshot.json
  • Explorer/app/page.tsx
  • README.md
  • Sources/ExplorerExport/main.swift
  • Sources/NeoStoryCore/Generated/Schema.generated.swift
  • Sources/NeoStoryCore/SchemaRegistry.swift
  • Sources/NeoStoryUI/EntityLibraryView.swift
  • Sources/SchemaGen/main.swift
  • docs/package-architecture.md
  • domains/bird/Sources/BirdDomain/Generated/Schema.generated.swift
  • domains/skate/Sources/SkateDomain/Generated/Schema.generated.swift
  • domains/skate/schema/skate-domain.schema-package.json
  • fixtures/schema-set.json
  • gateway/src/neostory_gateway/app.py
  • gateway/src/neostory_gateway/canonical.py
  • gateway/src/neostory_gateway/contracts.py
  • generate.sh
  • schema/allocations.json
  • schema/core.schema-package.json
  • schema/media-domain.schema-package.json
  • scripts/check_descriptor_ids.py
  • scripts/check_schema_revisions.py