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 →