Prime Radiant / Schema v0.1

Schema v0.1 · 2026-05-24

Machine Card — field inventory

One base entity (Machine) with two discriminated subclasses (Place, Path) and 13 embedded entity types. Fields are organized by concern; enums are closed — non-listed values are rejected at write time.

Entity index

EntityRealizationPurpose
Machinetop-level nodebase class; carries is_place / is_path discriminators
MachineSnapshotembedded list on Machineper-phase typed state slice
Throughputembedded list (inputs/outputs, Path)typed flow unit
StateVariableembedded list on Machine and Snapshottyped scalar with provenance
Couplingembedded list on Machineintra-era edge
CrossEraCouplingembedded list on Machineera-spanning edge (different parent_machine)
InstanceRefembedded list on class-card Machinenamed instance
SourceCitationembedded on any field carrierper-attribute provenance
LandscapePressureembedded list on Machineexternal pressure description
ToolSetGenerationembedded list on Machinewithin-card tool-set evolution
OrganizationalFormembedded list on Machinelegal-form mutation history
MachineStateembedded in Snapshotper-snapshot typed state values
CalibrationAnchortop-level event nodedated historical calibration event

§3.1 Identity / metadata

FieldType / enumRequiredNotes
idstryesmachine:<slug>-<era-or-year>
namestryeshuman-readable class name
descriptionstryessource for semantic_emb; 150–400 words
lifecycle_statusLifecycleStatus enumyesproposed | reviewed | integrated
class_cardboolyesdefault true; false = named instance card
wave_sourcestryesoriginating brief/wave slug
canon_flagCanonFlag enumyes[CANON] | [EXTRAP] | hybrid
sourceslist[SourceCitation]yescard-level provenance (1+)
schema_versionstryesdefault "v0.1"

§3.2 Discriminators

FieldTypeNotes
is_placebool (default false)enables Place extra fields (ScalingState, PowerGeometryPosition, StoryEntry, GaWCTier)
is_pathbool (default false)enables Path extra fields; mutually exclusive with is_place

§3.6 Cyclical dynamics / structural position

FieldType / enumRequiredWave source
tep_paradigm_primaryTepParadigm enumrequired for MM/DMWave 4 — Perez TEP
tep_paradigm_secondaryTepParadigm enumoptionalWave 4
tep_phaseTepPhase enumoptionalWave 4
kondratiev_waveK1–K6optionalWave 3 — Braudel cyclical
kondratiev_phaseK_A | K_BoptionalWave 3
secular_cycle_phaseintegrative | disintegrativeoptionalWave 3 — Turchin
wallerstein_position_geographiccore | semi | periphery | contestedoptionalWave 5 — Wallerstein
wallerstein_position_functionalsame enumoptionalWave 5
dm_currentDMFourCurrent enumoptional (DM cards)Wave 6 — Castells
artifact_type_in_2026live | energetic_zombie | intelligent_ghost | ennervated_necromancy | historicaloptionalWave 0

§3.7 Temporal

FieldTypeRequired
t_emergeint (year)optional
t_active_startint (year)yes
t_active_endint or nulloptional (null = ongoing)

§3.14 Multi-view embeddings (computed; not authored)

FieldDimensionsMethodComputed when
semantic_emb768dembeddinggemma-300M over descriptionPhase 2
state_emb~50dnormalized state_variables + era/phase one-hotPhase 2
graph_emb~64dnode2vec over coupling graphPhase 2 (after cards + edges loaded)