Calculation Content Schema

The product content unit is a versioned CalculationProblem joined to a CalculationArchetype, SolutionGraph, and MarkingPolicy. The initial fixture is calculation_problems_seed.json; its executable contract is schemas/calculation-content.schema.json.

Invariants

• IDs and semantic versions are immutable once referenced by a trace.
• A problem names its board, syllabus, module, epic, archetype, source evidence, and review status.
• Each graph node has one primary responsibility and declared deterministic validator.
• Every dependency edge points to existing nodes and the graph is acyclic.
• Archetype, problem, graph, policy, follow-up, and eval versions form one validated chain.
• Accepted expressions use bounded structural equivalence rules; free-text similarity is not authoritative.
• Mark nodes and ECF rules belong to one exact problem/policy version.
• Mark dependencies resolve to graph nodes; ECF targets are reachable downstream and cannot contain their trigger.
• Hints and follow-up mappings cannot convert unreviewed content into an authoritative claim.

Review Status

AI_DRAFT content is executable only as labelled development evidence. SOURCE_SCOPED identifies exact evidence but is not expert approval. EXPERT_REVIEWED requires reviewer identity, scope, timestamp, and evidence link. RETIRED remains reproducible for old traces but cannot start new attempts.

First Archetype Contract

KP_FROM_EQUILIBRIUM_MOLES requires nodes for balanced equation, equilibrium moles, total moles, mole fractions, partial pressures, Kp expression, substitution, numerical result, unit, and significant figures. No arbitrary question or handwriting parser is part of this schema.