@its-not-rocket-science/ananke 0.1.69 → 0.5.4

package/conformance/phase-order.json

@@ -0,0 +1,21 @@
+{
+  "version": "conformance/v1",
+  "id": "phase-order-01",
+  "description": "World-step phases must execute in this exact order for deterministic behavior.",
+  "kind": "phase-order",
+  "notes": [
+    "phase order is part of deterministic runtime contract.",
+    "changing order can alter cooldown, movement, and combat interaction semantics.",
+    "fixtures and runtime tests should fail immediately on order drift."
+  ],
+  "phases": [
+    "prepare",
+    "cooldowns",
+    "input",
+    "movement",
+    "actions",
+    "impacts",
+    "systems",
+    "finalize"
+  ]
+}

package/conformance/replay-parity.json

@@ -1,66 +1,66 @@
-{
-  "version": "conformance/v1",
-  "id": "replay-parity-01",
-  "description": "Re-simulating this replay must reproduce the hash after each recorded frame.",
-  "kind": "replay-parity",
-  "notes": [
-    "seed=42; 2 entities; 10 ticks of noMove commands.",
-    "Fixed commands are used (not AI) so replayTo starts from a clean initial state.",
-    "For each entry: call replayTo(replay, recordedAtTick, ctx).",
-    "The returned world.tick must equal expectedWorldTick.",
-    "hashWorldState(world) must equal hashHex."
-  ],
-  "replayJson": "{\"initialState\":{\"tick\":0,\"seed\":42,\"entities\":[{\"id\":1,\"teamId\":1,\"attributes\":{\"morphology\":{\"stature_m\":17400,\"mass_kg\":74977,\"actuatorMass_kg\":30125,\"actuatorScale\":9946,\"structureScale\":20000,\"reachScale\":10233},\"performance\":{\"peakForce_N\":165802,\"peakPower_W\":3600,\"continuousPower_W\":128,\"reserveEnergy_J\":15800,\"conversionEfficiency\":8651},\"control\":{\"controlQuality\":6848,\"reactionTime_s\":2329,\"stability\":6855,\"fineControl\":7624},\"resilience\":{\"surfaceIntegrity\":9459,\"bulkIntegrity\":9437,\"structureIntegrity\":10163,\"distressTolerance\":4629,\"shockTolerance\":5169,\"concussionTolerance\":5526,\"heatTolerance\":4758,\"coldTolerance\":4505,\"fatigueRate\":9668,\"recoveryRate\":10195},\"perception\":{\"visionRange_m\":2000000,\"visionArcDeg\":120,\"halfArcCosQ\":5000,\"hearingRange_m\":500000,\"decisionLatency_s\":5000,\"attentionDepth\":4,\"threatHorizon_m\":400000},\"cognition\":{\"linguistic\":6500,\"logicalMathematical\":6000,\"spatial\":6000,\"bodilyKinesthetic\":6000,\"musical\":5000,\"interpersonal\":6000,\"intrapersonal\":5500,\"naturalist\":5000,\"interSpecies\":3500}},\"energy\":{\"reserveEnergy_J\":15800,\"fatigue\":0},\"loadout\":{\"items\":[{\"id\":\"wpn_longsword\",\"kind\":\"weapon\",\"name\":\"Longsword\",\"mass_kg\":1500,\"bulk\":15000,\"reach_m\":9000,\"handedness\":\"twoHand\",\"momentArm_m\":5500,\"handlingMul\":10500,\"strikeEffectiveMassFrac\":1500,\"strikeSpeedMul\":10000,\"readyTime_s\":7500,\"damage\":{\"surfaceFrac\":3500,\"internalFrac\":4500,\"structuralFrac\":2000,\"bleedFactor\":7000,\"penetrationBias\":4000}}]},\"traits\":[],\"position_m\":{\"x\":-5000,\"y\":0,\"z\":0},\"velocity_mps\":{\"x\":0,\"y\":0,\"z\":0},\"intent\":{\"move\":{\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"},\"defence\":{\"mode\":\"none\",\"intensity\":0},\"prone\":false},\"action\":{\"attackCooldownTicks\":0,\"defenceCooldownTicks\":0,\"grappleCooldownTicks\":0,\"facingDirQ\":{\"x\":10000,\"y\":0,\"z\":0},\"weaponBindPartnerId\":0,\"weaponBindTicks\":0,\"swingMomentumQ\":0,\"shootCooldownTicks\":0,\"aimTicks\":0,\"aimTargetId\":0},\"condition\":{\"onFire\":0,\"corrosiveExposure\":0,\"radiation\":0,\"electricalOverload\":0,\"suffocation\":0,\"stunned\":0,\"prone\":false,\"pinned\":false,\"standBlockedTicks\":0,\"unconsciousTicks\":0,\"suppressedTicks\":0,\"blindTicks\":0,\"fearQ\":0,\"suppressionFearMul\":10000,\"recentAllyDeaths\":0,\"lastAllyDeathTick\":-1,\"surrendered\":false,\"rallyCooldownTicks\":0},\"injury\":{\"byRegion\":{\"head\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"torso\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0}},\"fluidLoss\":0,\"shock\":0,\"consciousness\":10000,\"dead\":false,\"hemolymphLoss\":0},\"grapple\":{\"holdingTargetId\":0,\"heldByIds\":[],\"gripQ\":0,\"position\":\"standing\"}},{\"id\":2,\"teamId\":2,\"attributes\":{\"morphology\":{\"stature_m\":17440,\"mass_kg\":74182,\"actuatorMass_kg\":29420,\"actuatorScale\":9904,\"structureScale\":20000,\"reachScale\":9895},\"performance\":{\"peakForce_N\":154468,\"peakPower_W\":3600,\"continuousPower_W\":129,\"reserveEnergy_J\":14502,\"conversionEfficiency\":8557},\"control\":{\"controlQuality\":7058,\"reactionTime_s\":2091,\"stability\":6517,\"fineControl\":7109},\"resilience\":{\"surfaceIntegrity\":9544,\"bulkIntegrity\":10338,\"structureIntegrity\":9742,\"distressTolerance\":5605,\"shockTolerance\":5235,\"concussionTolerance\":4836,\"heatTolerance\":5353,\"coldTolerance\":4988,\"fatigueRate\":9233,\"recoveryRate\":9064},\"perception\":{\"visionRange_m\":2000000,\"visionArcDeg\":120,\"halfArcCosQ\":5000,\"hearingRange_m\":500000,\"decisionLatency_s\":5000,\"attentionDepth\":4,\"threatHorizon_m\":400000},\"cognition\":{\"linguistic\":6500,\"logicalMathematical\":6000,\"spatial\":6000,\"bodilyKinesthetic\":6000,\"musical\":5000,\"interpersonal\":6000,\"intrapersonal\":5500,\"naturalist\":5000,\"interSpecies\":3500}},\"energy\":{\"reserveEnergy_J\":14502,\"fatigue\":0},\"loadout\":{\"items\":[{\"id\":\"wpn_longsword\",\"kind\":\"weapon\",\"name\":\"Longsword\",\"mass_kg\":1500,\"bulk\":15000,\"reach_m\":9000,\"handedness\":\"twoHand\",\"momentArm_m\":5500,\"handlingMul\":10500,\"strikeEffectiveMassFrac\":1500,\"strikeSpeedMul\":10000,\"readyTime_s\":7500,\"damage\":{\"surfaceFrac\":3500,\"internalFrac\":4500,\"structuralFrac\":2000,\"bleedFactor\":7000,\"penetrationBias\":4000}}]},\"traits\":[],\"position_m\":{\"x\":5000,\"y\":0,\"z\":0},\"velocity_mps\":{\"x\":0,\"y\":0,\"z\":0},\"intent\":{\"move\":{\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"},\"defence\":{\"mode\":\"none\",\"intensity\":0},\"prone\":false},\"action\":{\"attackCooldownTicks\":0,\"defenceCooldownTicks\":0,\"grappleCooldownTicks\":0,\"facingDirQ\":{\"x\":10000,\"y\":0,\"z\":0},\"weaponBindPartnerId\":0,\"weaponBindTicks\":0,\"swingMomentumQ\":0,\"shootCooldownTicks\":0,\"aimTicks\":0,\"aimTargetId\":0},\"condition\":{\"onFire\":0,\"corrosiveExposure\":0,\"radiation\":0,\"electricalOverload\":0,\"suffocation\":0,\"stunned\":0,\"prone\":false,\"pinned\":false,\"standBlockedTicks\":0,\"unconsciousTicks\":0,\"suppressedTicks\":0,\"blindTicks\":0,\"fearQ\":0,\"suppressionFearMul\":10000,\"recentAllyDeaths\":0,\"lastAllyDeathTick\":-1,\"surrendered\":false,\"rallyCooldownTicks\":0},\"injury\":{\"byRegion\":{\"head\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"torso\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0}},\"fluidLoss\":0,\"shock\":0,\"consciousness\":10000,\"dead\":false,\"hemolymphLoss\":0},\"grapple\":{\"holdingTargetId\":0,\"heldByIds\":[],\"gripQ\":0,\"position\":\"standing\"}}]},\"frames\":[{\"tick\":0,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":1,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":2,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":3,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":4,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":5,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":6,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":7,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":8,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":9,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]}]}",
-  "hashTrace": [
-    {
-      "recordedAtTick": 0,
-      "expectedWorldTick": 1,
-      "hashHex": "0xfdf533148d08f459"
-    },
-    {
-      "recordedAtTick": 1,
-      "expectedWorldTick": 2,
-      "hashHex": "0xfdf233148d06be82"
-    },
-    {
-      "recordedAtTick": 2,
-      "expectedWorldTick": 3,
-      "hashHex": "0xfdee2f148d02cedf"
-    },
-    {
-      "recordedAtTick": 3,
-      "expectedWorldTick": 4,
-      "hashHex": "0xfe062f148d1760c0"
-    },
-    {
-      "recordedAtTick": 4,
-      "expectedWorldTick": 5,
-      "hashHex": "0xfe0333148d1531b5"
-    },
-    {
-      "recordedAtTick": 5,
-      "expectedWorldTick": 6,
-      "hashHex": "0xfdff33148d1148de"
-    },
-    {
-      "recordedAtTick": 6,
-      "expectedWorldTick": 7,
-      "hashHex": "0xfdfc2f148d0f0c3b"
-    },
-    {
-      "recordedAtTick": 7,
-      "expectedWorldTick": 8,
-      "hashHex": "0xfddd2f148cf45bac"
-    },
-    {
-      "recordedAtTick": 8,
-      "expectedWorldTick": 9,
-      "hashHex": "0xfdda33148cf22ca1"
-    },
-    {
-      "recordedAtTick": 9,
-      "expectedWorldTick": 10,
-      "hashHex": "0x8fe5f3eba59e0b75"
-    }
-  ]
+{
+  "version": "conformance/v1",
+  "id": "replay-parity-01",
+  "description": "Re-simulating this replay must reproduce the hash after each recorded frame.",
+  "kind": "replay-parity",
+  "notes": [
+    "seed=42; 2 entities; 10 ticks of noMove commands.",
+    "Fixed commands are used (not AI) so replayTo starts from a clean initial state.",
+    "For each entry: call replayTo(replay, recordedAtTick, ctx).",
+    "The returned world.tick must equal expectedWorldTick.",
+    "hashWorldState(world) must equal hashHex."
+  ],
+  "replayJson": "{\"initialState\":{\"tick\":0,\"seed\":42,\"entities\":[{\"id\":1,\"teamId\":1,\"attributes\":{\"morphology\":{\"stature_m\":17400,\"mass_kg\":74977,\"actuatorMass_kg\":30125,\"actuatorScale\":9946,\"structureScale\":20000,\"reachScale\":10233},\"performance\":{\"peakForce_N\":165802,\"peakPower_W\":3600,\"continuousPower_W\":128,\"reserveEnergy_J\":15800,\"conversionEfficiency\":8651},\"control\":{\"controlQuality\":6848,\"reactionTime_s\":2329,\"stability\":6855,\"fineControl\":7624},\"resilience\":{\"surfaceIntegrity\":9459,\"bulkIntegrity\":9437,\"structureIntegrity\":10163,\"distressTolerance\":4629,\"shockTolerance\":5169,\"concussionTolerance\":5526,\"heatTolerance\":4758,\"coldTolerance\":4505,\"fatigueRate\":9668,\"recoveryRate\":10195},\"perception\":{\"visionRange_m\":2000000,\"visionArcDeg\":120,\"halfArcCosQ\":5000,\"hearingRange_m\":500000,\"decisionLatency_s\":5000,\"attentionDepth\":4,\"threatHorizon_m\":400000},\"cognition\":{\"linguistic\":6500,\"logicalMathematical\":6000,\"spatial\":6000,\"bodilyKinesthetic\":6000,\"musical\":5000,\"interpersonal\":6000,\"intrapersonal\":5500,\"naturalist\":5000,\"interSpecies\":3500}},\"energy\":{\"reserveEnergy_J\":15800,\"fatigue\":0},\"loadout\":{\"items\":[{\"id\":\"wpn_longsword\",\"kind\":\"weapon\",\"name\":\"Longsword\",\"mass_kg\":1500,\"bulk\":15000,\"reach_m\":9000,\"handedness\":\"twoHand\",\"momentArm_m\":5500,\"handlingMul\":10500,\"strikeEffectiveMassFrac\":1500,\"strikeSpeedMul\":10000,\"readyTime_s\":7500,\"damage\":{\"surfaceFrac\":3500,\"internalFrac\":4500,\"structuralFrac\":2000,\"bleedFactor\":7000,\"penetrationBias\":4000}}]},\"traits\":[],\"position_m\":{\"x\":-5000,\"y\":0,\"z\":0},\"velocity_mps\":{\"x\":0,\"y\":0,\"z\":0},\"intent\":{\"move\":{\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"},\"defence\":{\"mode\":\"none\",\"intensity\":0},\"prone\":false},\"action\":{\"attackCooldownTicks\":0,\"defenceCooldownTicks\":0,\"grappleCooldownTicks\":0,\"facingDirQ\":{\"x\":10000,\"y\":0,\"z\":0},\"weaponBindPartnerId\":0,\"weaponBindTicks\":0,\"swingMomentumQ\":0,\"shootCooldownTicks\":0,\"aimTicks\":0,\"aimTargetId\":0},\"condition\":{\"onFire\":0,\"corrosiveExposure\":0,\"radiation\":0,\"electricalOverload\":0,\"suffocation\":0,\"stunned\":0,\"prone\":false,\"pinned\":false,\"standBlockedTicks\":0,\"unconsciousTicks\":0,\"suppressedTicks\":0,\"blindTicks\":0,\"fearQ\":0,\"suppressionFearMul\":10000,\"recentAllyDeaths\":0,\"lastAllyDeathTick\":-1,\"surrendered\":false,\"rallyCooldownTicks\":0},\"injury\":{\"byRegion\":{\"head\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"torso\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0}},\"fluidLoss\":0,\"shock\":0,\"consciousness\":10000,\"dead\":false,\"hemolymphLoss\":0},\"grapple\":{\"holdingTargetId\":0,\"heldByIds\":[],\"gripQ\":0,\"position\":\"standing\"},\"ai\":{\"focusTargetId\":0,\"retargetCooldownTicks\":0,\"decisionCooldownTicks\":0}},{\"id\":2,\"teamId\":2,\"attributes\":{\"morphology\":{\"stature_m\":17440,\"mass_kg\":74182,\"actuatorMass_kg\":29420,\"actuatorScale\":9904,\"structureScale\":20000,\"reachScale\":9895},\"performance\":{\"peakForce_N\":154468,\"peakPower_W\":3600,\"continuousPower_W\":129,\"reserveEnergy_J\":14502,\"conversionEfficiency\":8557},\"control\":{\"controlQuality\":7058,\"reactionTime_s\":2091,\"stability\":6517,\"fineControl\":7109},\"resilience\":{\"surfaceIntegrity\":9544,\"bulkIntegrity\":10338,\"structureIntegrity\":9742,\"distressTolerance\":5605,\"shockTolerance\":5235,\"concussionTolerance\":4836,\"heatTolerance\":5353,\"coldTolerance\":4988,\"fatigueRate\":9233,\"recoveryRate\":9064},\"perception\":{\"visionRange_m\":2000000,\"visionArcDeg\":120,\"halfArcCosQ\":5000,\"hearingRange_m\":500000,\"decisionLatency_s\":5000,\"attentionDepth\":4,\"threatHorizon_m\":400000},\"cognition\":{\"linguistic\":6500,\"logicalMathematical\":6000,\"spatial\":6000,\"bodilyKinesthetic\":6000,\"musical\":5000,\"interpersonal\":6000,\"intrapersonal\":5500,\"naturalist\":5000,\"interSpecies\":3500}},\"energy\":{\"reserveEnergy_J\":14502,\"fatigue\":0},\"loadout\":{\"items\":[{\"id\":\"wpn_longsword\",\"kind\":\"weapon\",\"name\":\"Longsword\",\"mass_kg\":1500,\"bulk\":15000,\"reach_m\":9000,\"handedness\":\"twoHand\",\"momentArm_m\":5500,\"handlingMul\":10500,\"strikeEffectiveMassFrac\":1500,\"strikeSpeedMul\":10000,\"readyTime_s\":7500,\"damage\":{\"surfaceFrac\":3500,\"internalFrac\":4500,\"structuralFrac\":2000,\"bleedFactor\":7000,\"penetrationBias\":4000}}]},\"traits\":[],\"position_m\":{\"x\":5000,\"y\":0,\"z\":0},\"velocity_mps\":{\"x\":0,\"y\":0,\"z\":0},\"intent\":{\"move\":{\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"},\"defence\":{\"mode\":\"none\",\"intensity\":0},\"prone\":false},\"action\":{\"attackCooldownTicks\":0,\"defenceCooldownTicks\":0,\"grappleCooldownTicks\":0,\"facingDirQ\":{\"x\":10000,\"y\":0,\"z\":0},\"weaponBindPartnerId\":0,\"weaponBindTicks\":0,\"swingMomentumQ\":0,\"shootCooldownTicks\":0,\"aimTicks\":0,\"aimTargetId\":0},\"condition\":{\"onFire\":0,\"corrosiveExposure\":0,\"radiation\":0,\"electricalOverload\":0,\"suffocation\":0,\"stunned\":0,\"prone\":false,\"pinned\":false,\"standBlockedTicks\":0,\"unconsciousTicks\":0,\"suppressedTicks\":0,\"blindTicks\":0,\"fearQ\":0,\"suppressionFearMul\":10000,\"recentAllyDeaths\":0,\"lastAllyDeathTick\":-1,\"surrendered\":false,\"rallyCooldownTicks\":0},\"injury\":{\"byRegion\":{\"head\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"torso\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightArm\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"leftLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0},\"rightLeg\":{\"surfaceDamage\":0,\"internalDamage\":0,\"structuralDamage\":0,\"bleedingRate\":0,\"fractured\":false,\"infectedTick\":-1,\"bleedDuration_ticks\":0,\"permanentDamage\":0}},\"fluidLoss\":0,\"shock\":0,\"consciousness\":10000,\"dead\":false,\"hemolymphLoss\":0},\"grapple\":{\"holdingTargetId\":0,\"heldByIds\":[],\"gripQ\":0,\"position\":\"standing\"},\"ai\":{\"focusTargetId\":0,\"retargetCooldownTicks\":0,\"decisionCooldownTicks\":0}}]},\"frames\":[{\"tick\":0,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":1,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":2,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":3,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":4,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":5,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":6,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":7,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":8,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]},{\"tick\":9,\"commands\":[[1,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]],[2,[{\"kind\":\"move\",\"dir\":{\"x\":0,\"y\":0,\"z\":0},\"intensity\":0,\"mode\":\"walk\"}]]]}]}",
+  "hashTrace": [
+    {
+      "recordedAtTick": 0,
+      "expectedWorldTick": 1,
+      "hashHex": "0xfdf533148d08f459"
+    },
+    {
+      "recordedAtTick": 1,
+      "expectedWorldTick": 2,
+      "hashHex": "0xfdf233148d06be82"
+    },
+    {
+      "recordedAtTick": 2,
+      "expectedWorldTick": 3,
+      "hashHex": "0xfdee2f148d02cedf"
+    },
+    {
+      "recordedAtTick": 3,
+      "expectedWorldTick": 4,
+      "hashHex": "0xfe062f148d1760c0"
+    },
+    {
+      "recordedAtTick": 4,
+      "expectedWorldTick": 5,
+      "hashHex": "0xfe0333148d1531b5"
+    },
+    {
+      "recordedAtTick": 5,
+      "expectedWorldTick": 6,
+      "hashHex": "0xfdff33148d1148de"
+    },
+    {
+      "recordedAtTick": 6,
+      "expectedWorldTick": 7,
+      "hashHex": "0xfdfc2f148d0f0c3b"
+    },
+    {
+      "recordedAtTick": 7,
+      "expectedWorldTick": 8,
+      "hashHex": "0xfddd2f148cf45bac"
+    },
+    {
+      "recordedAtTick": 8,
+      "expectedWorldTick": 9,
+      "hashHex": "0xfdda33148cf22ca1"
+    },
+    {
+      "recordedAtTick": 9,
+      "expectedWorldTick": 10,
+      "hashHex": "0x8fe5f3eba59e0b75"
+    }
+  ]
 }

package/conformance/state-hash-regression.json

@@ -0,0 +1,39 @@
+{
+  "version": "conformance/v1",
+  "id": "state-hash-02",
+  "description": "Given a canonical WorldState, hashWorldState must return the specified hex value.",
+  "kind": "state-hash",
+  "commandSource": "lineInfantry",
+  "notes": [
+    "seed=42; two humanoid entities with lineInfantry AI commands.",
+    "captures a longer deterministic timeline to guard against kernel regressions.",
+    "x/y/z positions and injury state changes are included through hashWorldState."
+  ],
+  "cases": [
+    {
+      "tick": 0,
+      "description": "World state at tick 0",
+      "hashHex": "0xfdf82f148d0b2364"
+    },
+    {
+      "tick": 1,
+      "description": "World state at tick 1",
+      "hashHex": "0x94e31245fae65074"
+    },
+    {
+      "tick": 5,
+      "description": "World state at tick 5",
+      "hashHex": "0xd5e1600766daf978"
+    },
+    {
+      "tick": 10,
+      "description": "World state at tick 10",
+      "hashHex": "0x49d767bfed374445"
+    },
+    {
+      "tick": 20,
+      "description": "World state at tick 20",
+      "hashHex": "0xacb04548fd68a7fb"
+    }
+  ]
+}

package/conformance/state-hash.json

@@ -1,23 +1,24 @@
-{
-  "version": "conformance/v1",
-  "id": "state-hash-01",
-  "description": "Given a canonical WorldState, hashWorldState must return the specified hex value.",
-  "kind": "state-hash",
-  "notes": [
-    "seed=42; two humanoid entities at ±0.5 m with chainmail and longsword.",
-    "hash is FNV-64 over canonical JSON (sorted keys, Map→sorted entries).",
-    "A conforming implementation must produce identical hashes."
-  ],
-  "cases": [
-    {
-      "tick": 0,
-      "description": "Initial world state before any tick",
-      "hashHex": "0xec578e005fcbef34"
-    },
-    {
-      "tick": 1,
-      "description": "World state after one idle tick (noMove commands)",
-      "hashHex": "0xfdf533148d08f459"
-    }
-  ]
+{
+  "version": "conformance/v1",
+  "id": "state-hash-01",
+  "description": "Given a canonical WorldState, hashWorldState must return the specified hex value.",
+  "kind": "state-hash",
+  "commandSource": "idle",
+  "notes": [
+    "seed=42; two humanoid entities at ±0.5 m with chainmail and longsword.",
+    "hash is FNV-64 over canonical JSON (sorted keys, Map→sorted entries).",
+    "A conforming implementation must produce identical hashes."
+  ],
+  "cases": [
+    {
+      "tick": 0,
+      "description": "World state at tick 0",
+      "hashHex": "0xfdf82f148d0b2364"
+    },
+    {
+      "tick": 1,
+      "description": "World state at tick 1",
+      "hashHex": "0xfdf533148d08f459"
+    }
+  ]
 }

package/dist/src/conformance.d.ts

@@ -1,5 +1,5 @@
 /** Discriminated union of all supported fixture kinds. */
-export type FixtureKind = "state-hash" | "replay-parity" | "command-round-trip" | "bridge-snapshot" | "lockstep-sequence";
+export type FixtureKind = "state-hash" | "phase-order" | "replay-parity" | "command-round-trip" | "bridge-snapshot" | "lockstep-sequence";
 /** Version identifier embedded in every fixture file. */
 export declare const CONFORMANCE_VERSION: "conformance/v1";
 /** Common header shared by all conformance fixtures. */
@@ -18,6 +18,7 @@ export interface ConformanceFixtureHeader {
 /** State-hash fixture: given an initial world, hashWorldState must return a known hex. */
 export interface StateHashFixture extends ConformanceFixtureHeader {
     kind: "state-hash";
+    commandSource: "idle" | "lineInfantry";
     cases: Array<{
         tick: number;
         description: string;
@@ -25,6 +26,11 @@ export interface StateHashFixture extends ConformanceFixtureHeader {
         hashHex: string;
     }>;
 }
+/** Phase-order fixture: world-step phases must execute in this exact order. */
+export interface PhaseOrderFixture extends ConformanceFixtureHeader {
+    kind: "phase-order";
+    phases: string[];
+}
 /** Replay-parity fixture: re-simulating a replay must produce the same per-tick hashes. */
 export interface ReplayParityFixture extends ConformanceFixtureHeader {
     kind: "replay-parity";
@@ -85,7 +91,7 @@ export interface LockstepSequenceFixture extends ConformanceFixtureHeader {
     }>;
 }
 /** Union of all fixture types. */
-export type ConformanceFixture = StateHashFixture | ReplayParityFixture | CommandRoundTripFixture | BridgeSnapshotFixture | LockstepSequenceFixture;
+export type ConformanceFixture = StateHashFixture | PhaseOrderFixture | ReplayParityFixture | CommandRoundTripFixture | BridgeSnapshotFixture | LockstepSequenceFixture;
 /** Result of running a single fixture. */
 export interface ConformanceResult {
     id: string;

package/dist/src/content/index.d.ts

@@ -0,0 +1,3 @@
+export { loadContentPack, clearContentPackCache } from "./loader.js";
+export { applyContentPack } from "./injector.js";
+export type { ContentPack, ContentArchetype, ContentArmour, ContentTerrain, ContentWeapon, ContentPackValidationError } from "./types.js";

package/dist/src/content/index.js

@@ -0,0 +1,2 @@
+export { loadContentPack, clearContentPackCache } from "./loader.js";
+export { applyContentPack } from "./injector.js";

package/dist/src/content/injector.d.ts

@@ -0,0 +1,19 @@
+import type { WorldState } from "../sim/world.js";
+import type { ContentPack, ContentTerrain } from "./types.js";
+export interface ContentRegistryState {
+    packs: Map<string, ContentPack>;
+    archetypes: Map<string, unknown>;
+    weapons: Map<string, unknown>;
+    armour: Map<string, unknown>;
+    terrain: Map<string, ContentTerrain>;
+}
+/**
+ * Apply a content pack into a live world.
+ *
+ * Example:
+ * ```ts
+ * const pack = await loadContentPack("./my-hero.json");
+ * world = applyContentPack(world, pack);
+ * ```
+ */
+export declare function applyContentPack(world: WorldState, pack: ContentPack): WorldState;

package/dist/src/content/injector.js

@@ -0,0 +1,61 @@
+import { registerArchetype, registerArmour, registerWeapon } from "../catalog.js";
+import { ANANKE_ENGINE_VERSION, semverSatisfies } from "../content-pack.js";
+import { registerWorldArchetype, registerWorldItem } from "../world-factory.js";
+function ensureRegistry(world) {
+    const runtime = (world.runtimeState ?? {});
+    const existing = runtime.contentRegistry;
+    if (existing)
+        return existing;
+    const created = {
+        packs: new Map(),
+        archetypes: new Map(),
+        weapons: new Map(),
+        armour: new Map(),
+        terrain: new Map(),
+    };
+    runtime.contentRegistry = created;
+    world.runtimeState = runtime;
+    return created;
+}
+/**
+ * Apply a content pack into a live world.
+ *
+ * Example:
+ * ```ts
+ * const pack = await loadContentPack("./my-hero.json");
+ * world = applyContentPack(world, pack);
+ * ```
+ */
+export function applyContentPack(world, pack) {
+    const compatRange = pack.registry?.compatRange;
+    if (typeof compatRange === "string" && !semverSatisfies(ANANKE_ENGINE_VERSION, compatRange)) {
+        throw new Error(`Pack ${pack.name}@${pack.version} is incompatible with engine ${ANANKE_ENGINE_VERSION}; expected ${compatRange}`);
+    }
+    const nextWorld = {
+        ...world,
+        runtimeState: { ...(world.runtimeState ?? {}) },
+    };
+    const registry = ensureRegistry(nextWorld);
+    const packId = `${pack.name}@${pack.version}`;
+    // hot-reload: if pack id already exists, overwrite registry entries.
+    registry.packs.set(packId, pack);
+    for (const archetype of pack.archetypes ?? []) {
+        const parsed = registerArchetype(archetype);
+        registerWorldArchetype(archetype.id, parsed);
+        registry.archetypes.set(archetype.id, archetype);
+    }
+    for (const weapon of pack.weapons ?? []) {
+        const parsed = registerWeapon(weapon);
+        registerWorldItem(weapon.id, parsed);
+        registry.weapons.set(weapon.id, weapon);
+    }
+    for (const armour of pack.armour ?? []) {
+        const parsed = registerArmour(armour);
+        registerWorldItem(armour.id, parsed);
+        registry.armour.set(armour.id, armour);
+    }
+    for (const terrain of pack.terrain ?? []) {
+        registry.terrain.set(terrain.id, terrain);
+    }
+    return nextWorld;
+}

package/dist/src/content/loader.d.ts

@@ -0,0 +1,3 @@
+import type { ContentPack } from "./types.js";
+export declare function loadContentPack(path: string): Promise<ContentPack>;
+export declare function clearContentPackCache(): void;

package/dist/src/content/loader.js

@@ -0,0 +1,170 @@
+import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+const PACK_CACHE = new Map();
+const SCHEMA_CACHE = new Map();
+function buildJsonParseError(raw, err) {
+    const posMatch = /position\s+(\d+)/i.exec(err.message);
+    if (!posMatch)
+        return err;
+    const pos = Number(posMatch[1]);
+    const prefix = raw.slice(0, Math.max(0, pos));
+    const line = prefix.split("\n").length;
+    const col = pos - prefix.lastIndexOf("\n");
+    return new Error(`Invalid JSON at line ${line}, column ${col}: ${err.message}`);
+}
+function getByPointer(root, pointer) {
+    if (pointer === "" || pointer === "#")
+        return root;
+    const segments = pointer.replace(/^#\//, "").split("/").map(p => p.replace(/~1/g, "/").replace(/~0/g, "~"));
+    let cur = root;
+    for (const seg of segments) {
+        if (typeof cur !== "object" || cur === null || !(seg in cur)) {
+            return undefined;
+        }
+        cur = cur[seg];
+    }
+    return cur;
+}
+async function loadSchemaRef(ref, basePath) {
+    if (ref.startsWith("#"))
+        return undefined;
+    const [docUrlPart] = ref.split("#");
+    const docUrl = docUrlPart ?? "";
+    if (SCHEMA_CACHE.has(docUrl))
+        return SCHEMA_CACHE.get(docUrl);
+    let schemaDoc;
+    if (docUrl.startsWith("https://")) {
+        const response = await fetch(docUrl);
+        if (!response.ok)
+            throw new Error(`Failed to fetch schema ref ${docUrl}: HTTP ${response.status}`);
+        schemaDoc = await response.json();
+    }
+    else {
+        const schemaPath = isAbsolute(docUrl) ? docUrl : resolve(dirname(basePath), docUrl);
+        schemaDoc = JSON.parse(await readFile(schemaPath, "utf8"));
+    }
+    SCHEMA_CACHE.set(docUrl, schemaDoc);
+    return schemaDoc;
+}
+async function resolveRefs(schema, basePath, rootSchema) {
+    if (Array.isArray(schema)) {
+        return Promise.all(schema.map(item => resolveRefs(item, basePath, rootSchema ?? schema)));
+    }
+    if (typeof schema !== "object" || schema === null)
+        return schema;
+    const record = schema;
+    if (typeof record["$ref"] === "string") {
+        const ref = record["$ref"];
+        if (ref.startsWith("#")) {
+            const target = getByPointer(rootSchema ?? schema, ref);
+            if (target === undefined)
+                throw new Error(`Unresolvable local schema ref: ${ref}`);
+            return resolveRefs(target, basePath, rootSchema ?? schema);
+        }
+        const external = await loadSchemaRef(ref, basePath);
+        const pointer = ref.includes("#") ? `#${ref.split("#")[1]}` : "#";
+        const target = getByPointer(external, pointer);
+        if (target === undefined)
+            throw new Error(`Unresolvable external schema ref: ${ref}`);
+        return resolveRefs(target, basePath, external);
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(record)) {
+        out[k] = await resolveRefs(v, basePath, rootSchema ?? schema);
+    }
+    return out;
+}
+function validateAgainstSchema(data, schema, path = "$") {
+    const errors = [];
+    if (typeof schema !== "object" || schema === null)
+        return errors;
+    const s = schema;
+    const expectedType = s.type;
+    if (expectedType) {
+        const typeOkay = (expectedType === "array" && Array.isArray(data)) ||
+            (expectedType === "object" && typeof data === "object" && data !== null && !Array.isArray(data)) ||
+            (expectedType === "string" && typeof data === "string") ||
+            (expectedType === "number" && typeof data === "number") ||
+            (expectedType === "integer" && Number.isInteger(data)) ||
+            (expectedType === "boolean" && typeof data === "boolean");
+        if (!typeOkay) {
+            errors.push({ path, message: `expected ${expectedType}` });
+            return errors;
+        }
+    }
+    if (typeof data === "string") {
+        if (typeof s.minLength === "number" && data.length < s.minLength)
+            errors.push({ path, message: `minLength ${s.minLength}` });
+        if (typeof s.pattern === "string" && !(new RegExp(s.pattern).test(data)))
+            errors.push({ path, message: `must match pattern ${s.pattern}` });
+    }
+    if (typeof data === "number") {
+        if (typeof s.minimum === "number" && data < s.minimum)
+            errors.push({ path, message: `must be >= ${s.minimum}` });
+        if (typeof s.maximum === "number" && data > s.maximum)
+            errors.push({ path, message: `must be <= ${s.maximum}` });
+        if (typeof s.exclusiveMinimum === "number" && data <= s.exclusiveMinimum)
+            errors.push({ path, message: `must be > ${s.exclusiveMinimum}` });
+    }
+    if (Array.isArray(s.enum) && !s.enum.includes(data)) {
+        errors.push({ path, message: `must be one of ${s.enum.join(", ")}` });
+    }
+    if (Array.isArray(data)) {
+        if (typeof s.minItems === "number" && data.length < s.minItems)
+            errors.push({ path, message: `minItems ${s.minItems}` });
+        if (s.items !== undefined) {
+            data.forEach((item, idx) => {
+                errors.push(...validateAgainstSchema(item, s.items, `${path}[${idx}]`));
+            });
+        }
+    }
+    if (typeof data === "object" && data !== null && !Array.isArray(data)) {
+        const o = data;
+        const required = Array.isArray(s.required) ? s.required : [];
+        for (const req of required) {
+            if (!(req in o))
+                errors.push({ path: `${path}.${req}`, message: "is required" });
+        }
+        const properties = (s.properties ?? {});
+        for (const [key, propSchema] of Object.entries(properties)) {
+            if (key in o)
+                errors.push(...validateAgainstSchema(o[key], propSchema, `${path}.${key}`));
+        }
+        const additional = s.additionalProperties;
+        if (additional && typeof additional === "object") {
+            for (const [key, value] of Object.entries(o)) {
+                if (!(key in properties))
+                    errors.push(...validateAgainstSchema(value, additional, `${path}.${key}`));
+            }
+        }
+    }
+    return errors;
+}
+export async function loadContentPack(path) {
+    const absPath = resolve(path);
+    const cached = PACK_CACHE.get(absPath);
+    if (cached)
+        return cached;
+    const raw = await readFile(absPath, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw buildJsonParseError(raw, err);
+    }
+    const schemaPath = resolve(process.cwd(), "schema/content-pack.schema.json");
+    const schemaRaw = JSON.parse(await readFile(schemaPath, "utf8"));
+    const resolvedSchema = await resolveRefs(schemaRaw, schemaPath, schemaRaw);
+    const errors = validateAgainstSchema(parsed, resolvedSchema);
+    if (errors.length > 0) {
+        const lines = errors.map(e => `${e.path}: ${e.message}`).join("\n");
+        throw new Error(`Content pack schema validation failed:\n${lines}`);
+    }
+    const pack = parsed;
+    PACK_CACHE.set(absPath, pack);
+    return pack;
+}
+export function clearContentPackCache() {
+    PACK_CACHE.clear();
+}