Two-layer schema (Will v4). Layer 1: 16 immutable core fields (the Meridian protocol). Layer 2: 20+ extensible fields (personal only, null defaults, never emitted). Layer 1 never changes. Layer 2 grows without migration.
16 immutable core fields — the Meridian protocol. Never changed.
| Field | Type | Purpose |
|---|---|---|
| id | UUID4 | Primary key across all systems |
| schema_version | str | Bumped on breaking Layer 1 change |
| vector | float32[1024] | BGE-M3 embedding. Always 1024-dim. |
| text | str required | The atomic principle. Max 2000 chars. |
| title | str required | Human-readable label. Max 120 chars. |
| node_type | enum | principle | chunk | framework | error | dream_insight | reasoning_trace |
| source_id | UUID4 | Traces any principle to its origin |
| collection | str required | Top-level domain bucket |
| date_added | ISO 8601 | Set at creation, never modified |
| confidence_score | float 0.0-1.0 | Earned not assigned |
| gravity_score | float 0.0-1.0 | Composite weight-of-evidence. Primary ranking signal. |
| edge_weight | float 0.0-1.0 | Default = cosine similarity. Updated by co-activation. |
| mechanism | str | How and why this principle is true |
| situation | str | When this principle applies |
| when_not | str | When this principle does not apply |
| reasoning_trace_id | UUID4 or null | Links to reasoning_trace node. The generational intelligence link. |
Extensible envelope — personal system only. Null defaults. Never emitted.
| Field | Type | Purpose |
|---|---|---|
| framework_id | UUID4 | Which framework cluster |
| parent_id | UUID4 | Parent node in hierarchy |
| validation_count | int | Times principle informed a real decision |
| error_count | int | Times principle led to bad outcome |
| confidence_history | JSON array | [{score, timestamp, trigger}] — belief archaeology |
| emission_status | enum | not_ready | queued | emitted | suppressed |
| tags | CSV | Personal taxonomy. Never emitted. |
| domain_path | hierarchical str | Full path: investing/private-markets/series-b |
| novelty_score | float 0.0-1.0 | Anti-confirmation-bias signal for exploration mode |
| generation | int | Which generation created this node |
| inherited_from | UUID4 | Links to ancestor node in previous generation |
Migration: Q's TAO: 6,797 nodes need remapping from NODE_SCHEMA (14 fields) to Layer 1 (16 fields). Add: schema_version, gravity_score, edge_weight, reasoning_trace_id. Rob: 16,717 holons need full schema alignment after embedding migration.
Amendment Rule: New field would break codex interoperability? Layer 1, MAJOR version bump (rare, founder consensus). Personal extension? Layer 2, MINOR bump: add the field, set null defaults, done.
Sovereign Intelligence Infrastructure (Whitepaper v5) > 15_technical_spec
Two-layer: 16 immutable core + extensible envelope
View in whitepaper
Sovereign Intelligence Infrastructure (Whitepaper v5) > 05_knowledge_architecture
Gravity replaces confidence as primary retrieval signal
View in whitepaper
v8 2026-04-05 Q Fixed learning doc links — specific concepts not duplicate files
v7 2026-04-05 Q Fixed summary — was showing old Was field
v6 2026-04-05 Q Restructured definition with full Layer 1 and Layer 2 field tables
v5 2026-04-05 Q Added learning doc references
v4 2026-04-05 Q Mapped to whitepaper sections
v3 2026-04-05 Q Merged vision refs from research into SPEC-001
v2 2026-04-05 Q Imported SPEC-001 from model_specifications_v2.html
v1 2026-04-05 Q Created spec: SPEC-001: Universal Node Schema — Two-Layer Model