Chronicle · Schemas

Satoshium Chronicle Schemas

Chronicle Schemas define the structural and machine-readable contracts used to represent canonical Chronicle Entries and supporting Chronicle-owned records.

Phase VII completed Chronicle's production schema architecture: one universal Chronicle Base Schema, specialized Event-Type Profiles, governed Controlled Values, explicit Schema Versions, machine-readable schema validation, and compatibility rules that preserve older records without silent structural rewriting. Phase VIII applies those contracts through Chronicle's institutional Validation and Entry Production Procedure, which have now been exercised in production.

Phase VII — Production Schemas Complete

Phase VII is complete. Chronicle now has a production Base Schema in both human-readable and machine-readable form, a production Certification Event-Type Profile, and a validated two-layer schema stack.

chronicle-base-schema.md → Human-readable production specification
chronicle-base-schema.json → Machine-readable production contract

Canonical Object

The canonical historical-preservation object is the Chronicle Entry. Supporting schemas exist only where a distinct Chronicle-owned function requires separate structure.

Authority Boundary

Chronicle schemas define Chronicle-owned records only. Authoritative Suite objects are referenced rather than redefined, and reference does not transfer authority.

Base Schema

The Chronicle Base Schema defines only universal Entry structure. A field is Required by the Base Schema only if every production Chronicle Entry needs it.

Event-Type Profiles

Event-Type Profiles specialize the Base Schema for specific Occurrence classes without creating competing canonical Entry objects.

Controlled Values

Enumerated meaning is governed through the Chronicle Controlled Values Registry rather than invented independently inside each schema.

Schema Validation and Chronicle Validation

Machine-readable schema validation tests structural conformance to the Base Schema and applicable Event-Type Profile. Chronicle Validation is broader: it also tests Controlled Values, identifier requirements, authoritative references, date / time rules, Relationship integrity, Provenance, Correction / Version consistency, Verification dependency, authority boundaries, and publication readiness.

Schema Versions

Every production Chronicle record remains associated with the Schema Version that governed it. Schema Version remains distinct from record Version.

Compatibility

Schema evolution must preserve backward interpretability through explicit compatibility, deprecation, migration, and historical-preservation rules.

Chronicle Base Schema

The Chronicle Base Schema is the universal structural contract for every production Chronicle Entry.

Required:
entry_id · schema_id · schema_version · entry_version · title · summary · event_type · event_date · historical_context · provenance · verification_state · lifecycle_state · publication_state · entry_created_at

Conditional fields support Event-Type Profiles, originating system where required by a Profile, authoritative references, Sources, Evidence, Relationships, Corrections, prior-Version linkage, publication timestamps, maintenance timestamps, and limitations where applicable.

Universal Means Universal

The Base Schema intentionally does not require every architectural concept Chronicle may ever use.

Not universally required:
Preservation Eligibility result · Preservation Basis · standalone Historical Significance · Originating System · generic Entry Status · embedded Validation State · tags · jurisdiction

These concepts belong in procedure, Historical Context, Event-Type Profiles, supporting records, Validation artifacts, or later schema evolution where operational need justifies them. In particular, Validation State is not embedded as a universal Base Schema field in Version 1.0.0.

Event-Type Profiles

A Profile may make conditional Base Schema fields Required, restrict Event Type, require authoritative references, strengthen Provenance, constrain Relationships, add Validation rules, or impose publication prerequisites.

Chronicle Base Schema + Event-Type Profile = Specialized Chronicle Entry

The Certification Event-Type Profile is Chronicle's first production Event-Type Profile. It specializes the Base Schema for qualifying certification-related Occurrences and requires event_type_profile, originating_system = certifier, non-null event_date, and authoritative certification references meeting the Profile's structured authority requirement.

Open Certification Event-Type Profile →

Controlled Values

Production schemas reference approved Controlled Values.

Event Type · Verification State · Lifecycle State · Publication State · Relationship Type · Source Type · Evidence Type · Correction Type

Candidate vocabularies such as Source Role, Evidence Relationship, Preservation State, and certain actor roles remain intentionally unfrozen until production use proves the need.

Production Schema Artifacts

The current schema family includes the production Chronicle Base Schema, Chronicle's first production Event-Type Profile, its Phase VII profile-validation report, and three reconciled supporting schema specifications.

chronicle-base-schema.md
chronicle-base-schema.json

certification-event-profile/
  index.html
  certification-event-profile.md
  certification-event-profile.json
  chronicle-phase-vii-profile-validation-report.md

source-record-schema.md
evidence-record-schema.md
correction-record-schema.md

The Certification Event-Type Profile is published as a three-file Profile package: public landing page, human-readable specification, and machine-readable validation profile. Supporting JSON schemas should be created only after their human-readable specifications are tested against real production supporting records.

Open Certification Event-Type Profile →

Source Record Schema

Defines Chronicle-owned Source Records using the approved Source Type vocabulary, required Provenance, stable references, limitations, Version lineage, and authority boundaries.

Evidence Record Schema

Defines Chronicle-owned Evidence Records using the approved Evidence Type vocabulary, Entry / claim linkage, required Provenance, limitations, integrity information, and Version lineage.

Correction Record Schema

Defines Chronicle-owned Correction Records using approved Correction Types and mandatory preservation of original information, corrected information, Correction date, reason, affected fields, and resulting Version.

Future Supporting Schemas

Verification, Validation, Publication, Provenance, Relationship, or Version artifacts should receive separate schemas only when production requirements justify distinct, independently governed records. Phase VIII intentionally keeps the first Validation implementation lightweight and procedural rather than creating a new canonical Validation object.

Schema Identity and Versioning

Production Chronicle records distinguish schema identity, Schema Version, and record Version.

schema_id → Which schema governs this record?
schema_version → Which Version of that schema?
entry_version / supporting-record version → Which preserved record state?

Compatibility

Backward-compatible changes may add Optional fields, clarify documentation, or introduce new Profiles without invalidating existing records.

Breaking changes include removing Required fields, renaming Required fields, changing field meaning or type, making Optional fields Required, or changing identifier or Version semantics.

Breaking change → New Schema Version → Migration guidance → Prior Schema preserved → Older records remain interpretable

Schema, Verification, Validation, and Publication

Schema = Defines structure.
Verification = Reviews Chronicle's historical representation.
Validation = Tests conformance to governing institutional and machine-readable requirements.
Publication = Determines public-production state.

These functions remain institutionally distinct.

Current Production Position

The production schema stack is complete and has been exercised through Chronicle's Phase VIII operational layer and first canonical production Entry.

Chronicle Base Schema → Certification Event-Type Profile → Phase VII Schema Validation PASS → Chronicle Validation Rules → Validation Sequence → Validation Behavior / Record → Chronicle Entry Production Procedure → Operational Dry Run PASS → CHR-2026-0001 Production Validation PASS → Publication Gate APPROVED → Published

Two Validation Layers

Chronicle now uses two related but distinct validation layers.

Machine-readable Schema Validation → Does the JSON representation satisfy the Base Schema and applicable Profile?

Institutional Chronicle Validation → Does the current Entry Version satisfy the full CHR-VAL rule set and publication-readiness requirements?

A machine-readable schema PASS is necessary where the machine-readable Entry is required, but it does not by itself establish overall Chronicle Validation PASS.

First Production Schema Application

The production schema stack has now governed a real Chronicle Entry: CHR-2026-0001 Entry Version 1.

schema_id: chronicle-entry
schema_version: 1.0.0
event_type_profile: certification-event-profile
Profile Version: 1.0.0
Machine / Institutional Validation: PASS

The production case confirmed the intended two-layer model: machine-readable schema conformance is necessary where applicable, while overall Chronicle Validation also evaluates institutional rules that schema alone cannot establish.

Schema Philosophy

Chronicle schema architecture should remain minimal, explicit, version-aware, machine-readable, and durable.

The goal is not schema proliferation. The goal is one coherent structural language centered on the canonical Chronicle Entry with only the supporting schemas production actually requires.

One Entry. One Base Schema. Profiles specialize without multiplying canonical objects.
Open Certification Event-Type Profile → Open Validation → Back to Chronicle →

Durable history requires durable structure. Chronicle schemas make that structure reviewable.