@its-not-rocket-science/ananke 0.1.63 → 0.1.65

package/CHANGELOG.md

@@ -6,6 +6,48 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.65] — 2026-04-01
+
+### Added
+
+- **PM-6 — Content-Pack Registry Format (complete):**
+  - `PackRegistryMeta` interface (new): optional `registry` block in `AnankePackManifest` with fields:
+    - `compatRange` (string): semver range enforced at runtime by `validatePack` — rejects packs incompatible with the running engine version.
+    - `stabilityTier` (`"stable"` | `"experimental"` | `"internal"`): controls listing in a public registry.
+    - `requiredExports` (string[]): subpath exports the pack's content depends on — informational.
+    - `checksum` (string): SHA-256 hex digest of the pack JSON — computed by `npx ananke pack bundle`, verified by the host.
+    - `license` (string): SPDX identifier.
+    - `provenance` (object[]): dataset / paper references for empirically grounded content.
+  - `PackStabilityTier` and `PackProvenanceRef` types (new, exported from `"./content-pack"`).
+  - `ANANKE_ENGINE_VERSION = "0.1.65"` constant (new, exported from `"./content-pack"`): current engine version used in `compatRange` evaluation.
+  - `semverSatisfies(version, range)` (new, exported): lightweight semver range evaluator — supports `>=`, `>`, `<=`, `<`, `=`, `^` (caret), `~` (tilde), bare version, and compound space-separated ranges. No external dependencies.
+  - `validatePack` extended to validate all registry sub-fields and reject incompatible `compatRange`.
+  - `tools/pack-cli.ts` `bundle` command: automatically computes SHA-256 checksum and embeds it in `registry.checksum` before writing the bundle.
+  - `schema/pack.schema.json`: `registry` block with full JSON Schema definition for all sub-fields.
+  - `docs/pack-registry-spec.md` (new): full specification — field reference, checksum algorithm, runtime enforcement table, future online registry design.
+- 24 new tests (5,593 total). Coverage: 97.11%/88.07%/95.83%/97.11%. Build: clean.
+
+---
+
+## [0.1.64] — 2026-04-01
+
+### Added
+
+- **PM-5 — Deterministic Conformance Suite (complete):**
+  - `conformance/` directory (published in package): 5 self-contained JSON fixture files that any third-party host SDK can use to verify deterministic compatibility with the reference TypeScript engine.
+    - `state-hash.json`: given a canonical `WorldState`, `hashWorldState` must return specific hex values at tick 0 and tick 1.
+    - `replay-parity.json`: re-simulating a recorded 10-tick replay with `replayTo` must reproduce the per-tick hash trace exactly. Uses `noMove` commands to avoid AI-state side-effect divergence.
+    - `command-round-trip.json`: verifies `SCALE` constants and `CommandMap` JSON serialisation round-trips without loss for all 4 command kinds.
+    - `bridge-snapshot.json`: `serializeBridgeFrame` must produce a `BridgeFrame` with the correct schema, tick, entity count, and entity IDs.
+    - `lockstep-sequence.json`: stepping the simulation 20 ticks with `lineInfantry` AI must produce matching entity positions, dead flags, shock values, and world-state hashes at each tick.
+  - `tools/generate-conformance-fixtures.ts`: reference fixture generator; run `npm run generate-conformance-fixtures` to regenerate after changes to the hash algorithm, `stepWorld`, or `serializeBridgeFrame`.
+  - `tools/conformance-runner.ts`: standalone runner with `--json` (machine-readable) and `--fixture=<kind>` (single fixture) flags; exits 0 on all-pass, 1 on any failure.
+  - `src/conformance.ts` (new subpath export `"./conformance"`): public TypeScript types for third-party runners — `FixtureKind`, `ConformanceFixtureHeader`, `StateHashFixture`, `ReplayParityFixture`, `CommandRoundTripFixture`, `BridgeSnapshotFixture`, `LockstepSequenceFixture`, `ConformanceResult`, `ConformanceSummary`, and `CONFORMANCE_VERSION`.
+  - npm scripts: `generate-conformance-fixtures`, `conformance-runner`.
+- 0 new tests (5,569 total). Coverage: 97.11%/88.08%/95.82%/97.11%. Build: clean.
+
+---
+
 ## [0.1.63] — 2026-04-01
 
 ### Added

package/conformance/README.md

@@ -0,0 +1,44 @@
+# Ananke — Conformance Fixtures
+
+Test fixtures for verifying host-SDK determinism.  Any implementation that
+passes all fixtures is guaranteed to produce the same simulation state as the
+reference TypeScript engine.
+
+## Fixture files
+
+| File | Kind | What it tests |
+|------|------|---------------|
+| `state-hash.json` | `state-hash` | `hashWorldState` output for a known WorldState |
+| `replay-parity.json` | `replay-parity` | Per-tick hash trace when re-simulating a recorded replay |
+| `command-round-trip.json` | `command-round-trip` | CommandMap wire encoding and field semantics |
+| `bridge-snapshot.json` | `bridge-snapshot` | `serializeBridgeFrame` output shape and invariants |
+| `lockstep-sequence.json` | `lockstep-sequence` | Entity positions and shock at each tick of a 20-tick run |
+
+## Running the suite
+
+```bash
+npm run build
+npm run conformance-runner          # TypeScript reference implementation
+npm run conformance-runner -- --json  # machine-readable output
+```
+
+## Integrating from a non-TypeScript host
+
+1. Load the fixture JSON.
+2. Reconstruct the initial `WorldState` from the fixture's `input` section.
+3. Step the simulation exactly as described.
+4. Compare your output against the `expected` / `snapshots` / `hashTrace` fields.
+5. A mismatch means your fixed-point arithmetic or RNG seeding diverges.
+
+## Fixture format version
+
+All fixtures carry `"version": "conformance/v1"`.  A breaking change in the
+hash algorithm or wire format will bump to `v2` with a migration note.
+
+## Regenerating
+
+```bash
+npm run build && npm run generate-conformance-fixtures
+```
+
+Re-run after any change to `hashWorldState`, `stepWorld`, or `serializeBridgeFrame`.

package/conformance/bridge-snapshot.json

@@ -0,0 +1,40 @@
+{
+  "version": "conformance/v1",
+  "id": "bridge-snapshot-01",
+  "description": "serializeBridgeFrame must produce a BridgeFrame with these invariants.",
+  "kind": "bridge-snapshot",
+  "notes": [
+    "Check: frame.schema === 'ananke-bridge/v1'.",
+    "Check: frame.tick === 0.",
+    "Check: frame.entities.length === 2.",
+    "Check: entity positions match input WorldState positions.",
+    "The generatedAt timestamp is non-deterministic — do not compare it."
+  ],
+  "input": {
+    "seed": 42,
+    "tick": 0,
+    "entityCount": 2,
+    "entityPositions": [
+      {
+        "id": 1,
+        "x_m": -0.5,
+        "y_m": 0
+      },
+      {
+        "id": 2,
+        "x_m": 0.5,
+        "y_m": 0
+      }
+    ]
+  },
+  "expected": {
+    "schema": "ananke.bridge.frame.v1",
+    "tick": 0,
+    "entityCount": 2,
+    "scenarioId": "conformance-test",
+    "entityIds": [
+      1,
+      2
+    ]
+  }
+}

package/conformance/command-round-trip.json

@@ -0,0 +1,47 @@
+{
+  "version": "conformance/v1",
+  "id": "command-round-trip-01",
+  "description": "CommandMap entries must serialise to and from JSON without loss.",
+  "kind": "command-round-trip",
+  "notes": [
+    "CommandMap is Map<entityId, Command[]>.",
+    "For wire transport, serialise as [[entityId, commands[]], ...].",
+    "All numeric fields are fixed-point integers (SCALE.Q = 10000)."
+  ],
+  "scale": {
+    "Q": 10000,
+    "kg": 1000,
+    "m": 10000,
+    "mps": 10000
+  },
+  "commands": [
+    {
+      "entityId": 1,
+      "kind": "attack",
+      "mode": "strike",
+      "targetId": 2,
+      "intensity_Q": 10000,
+      "description": "Full-intensity strike at entity 2"
+    },
+    {
+      "entityId": 2,
+      "kind": "move",
+      "direction_x": 5000,
+      "direction_y": 0,
+      "direction_z": 0,
+      "mode": "walk",
+      "description": "Walk toward +x at 0.5 m/s"
+    },
+    {
+      "entityId": 1,
+      "kind": "defend",
+      "mode": "active",
+      "description": "Active defence stance"
+    },
+    {
+      "entityId": 2,
+      "kind": "idle",
+      "description": "No action this tick"
+    }
+  ]
+}

package/conformance/lockstep-sequence.json

@@ -0,0 +1,396 @@
+{
+  "version": "conformance/v1",
+  "id": "lockstep-sequence-01",
+  "description": "Stepping the simulation must produce identical entity state at each tick.",
+  "kind": "lockstep-sequence",
+  "notes": [
+    "seed=42; 2 entities (lineInfantry AI); 20 ticks.",
+    "tractionCoeff = q(0.90) = 9000.",
+    "At each tick: verify hashWorldState === hashHex and entity fields match.",
+    "x_m values are rounded to 3 decimal places for cross-language comparison.",
+    "shock_Q is raw fixed-point (SCALE.Q = 10000); 10000 = 100% shock."
+  ],
+  "context": {
+    "tractionCoeff_Q": 9000
+  },
+  "snapshots": [
+    {
+      "tick": 0,
+      "hashHex": "0xec578e005fcbef34",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.5,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.5,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 1,
+      "hashHex": "0x94e31245fae65074",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.478,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.479,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 2,
+      "hashHex": "0x5f433b5815b27103",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.433,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.437,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 3,
+      "hashHex": "0xacb3ed02702144c4",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.366,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.373,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 4,
+      "hashHex": "0xd8cd8894e32b5d24",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.276,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.289,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 5,
+      "hashHex": "0xd5e1600766daf978",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.164,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.183,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 6,
+      "hashHex": "0xf775238c6b6c2339",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": -0.049,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.076,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 7,
+      "hashHex": "0xa4adf7d41c67f090",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.031,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": 0.004,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 8,
+      "hashHex": "0x5f39532dfa0cf053",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.168,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.131,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 9,
+      "hashHex": "0xa87941a6b840c6d7",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.309,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.272,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 10,
+      "hashHex": "0x49d767bfed374445",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.429,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.391,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 11,
+      "hashHex": "0xce74d9688b813796",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.526,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.49,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 12,
+      "hashHex": "0x1efbc95cd539db56",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.6,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.567,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 13,
+      "hashHex": "0xd4f1d44a8c11b01e",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.652,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.623,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 14,
+      "hashHex": "0xc9fd237324abe444",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.682,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.659,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 15,
+      "hashHex": "0xaf66c06fb25eac2d",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.689,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.672,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 16,
+      "hashHex": "0xc6a0cb965ff544d1",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.689,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.672,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 17,
+      "hashHex": "0xc067905d49583c8a",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.689,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.672,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 18,
+      "hashHex": "0x8e104127ec08a2c7",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.689,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.672,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 19,
+      "hashHex": "0xb3468a0cce37d1ea",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.667,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.651,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    },
+    {
+      "tick": 20,
+      "hashHex": "0xacb04548fd68a7fb",
+      "entities": [
+        {
+          "id": 1,
+          "x_m": 0.622,
+          "dead": false,
+          "shock_Q": 0
+        },
+        {
+          "id": 2,
+          "x_m": -0.609,
+          "dead": false,
+          "shock_Q": 0
+        }
+      ]
+    }
+  ]
+}

package/conformance/replay-parity.json

@@ -0,0 +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"
+    }
+  ]
+}

package/conformance/state-hash.json

@@ -0,0 +1,23 @@
+{
+  "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"
+    }
+  ]
+}

package/dist/src/conformance.d.ts

@@ -0,0 +1,108 @@
+/** Discriminated union of all supported fixture kinds. */
+export type FixtureKind = "state-hash" | "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. */
+export interface ConformanceFixtureHeader {
+    /** Fixture format version — check this before reading. */
+    version: typeof CONFORMANCE_VERSION;
+    /** Unique fixture identifier. */
+    id: string;
+    /** Human-readable description of what this fixture tests. */
+    description: string;
+    /** Fixture kind — determines which runner handles it. */
+    kind: FixtureKind;
+    /** Implementation notes — read before writing a custom runner. */
+    notes: string[];
+}
+/** State-hash fixture: given an initial world, hashWorldState must return a known hex. */
+export interface StateHashFixture extends ConformanceFixtureHeader {
+    kind: "state-hash";
+    cases: Array<{
+        tick: number;
+        description: string;
+        /** FNV-64 hash as a 0x-prefixed hex string. */
+        hashHex: string;
+    }>;
+}
+/** Replay-parity fixture: re-simulating a replay must produce the same per-tick hashes. */
+export interface ReplayParityFixture extends ConformanceFixtureHeader {
+    kind: "replay-parity";
+    /** Serialised Replay JSON produced by ReplayRecorder. */
+    replayJson: string;
+    hashTrace: Array<{
+        tick: number;
+        hashHex: string;
+    }>;
+}
+/** Command round-trip fixture: verifies scale constants and JSON round-trips. */
+export interface CommandRoundTripFixture extends ConformanceFixtureHeader {
+    kind: "command-round-trip";
+    scale: {
+        Q: number;
+        kg: number;
+        m: number;
+        mps: number;
+    };
+    commands: Array<Record<string, unknown>>;
+}
+/** Bridge-snapshot fixture: serializeBridgeFrame must produce this shape. */
+export interface BridgeSnapshotFixture extends ConformanceFixtureHeader {
+    kind: "bridge-snapshot";
+    input: {
+        seed: number;
+        tick: number;
+        entityCount: number;
+        entityPositions: Array<{
+            id: number;
+            x_m: number;
+            y_m: number;
+        }>;
+    };
+    expected: {
+        schema: string;
+        tick: number;
+        entityCount: number;
+        scenarioId: string;
+        entityIds: number[];
+    };
+}
+/** Lockstep-sequence fixture: entity state at each tick of a deterministic run. */
+export interface LockstepSequenceFixture extends ConformanceFixtureHeader {
+    kind: "lockstep-sequence";
+    context: {
+        tractionCoeff_Q: number;
+    };
+    snapshots: Array<{
+        tick: number;
+        hashHex: string;
+        entities: Array<{
+            id: number;
+            x_m: number;
+            dead: boolean;
+            shock_Q: number;
+        }>;
+    }>;
+}
+/** Union of all fixture types. */
+export type ConformanceFixture = StateHashFixture | ReplayParityFixture | CommandRoundTripFixture | BridgeSnapshotFixture | LockstepSequenceFixture;
+/** Result of running a single fixture. */
+export interface ConformanceResult {
+    id: string;
+    kind: FixtureKind;
+    status: "pass" | "fail" | "skip" | "error";
+    checks: number;
+    failures: string[];
+    durationMs: number;
+}
+/** Summary of a full conformance run. */
+export interface ConformanceSummary {
+    _generated: string;
+    passed: number;
+    failed: number;
+    errored: number;
+    skipped: number;
+    total: number;
+    conformant: boolean;
+    results: ConformanceResult[];
+}

package/dist/src/conformance.js

@@ -0,0 +1,13 @@
+// src/conformance.ts
+// PM-5: Conformance suite public API
+//
+// Exports types and helpers used by third-party host SDKs to verify
+// deterministic compatibility with the reference Ananke engine.
+//
+// Usage:
+//   import type { ConformanceFixture, FixtureKind } from "@its-not-rocket-science/ananke/conformance";
+//
+// The full conformance fixtures live in conformance/*.json (published in the package).
+// Run the suite with: npx ananke conformance  (via pack-cli)
+/** Version identifier embedded in every fixture file. */
+export const CONFORMANCE_VERSION = "conformance/v1";

package/dist/src/content-pack.d.ts

@@ -1,4 +1,6 @@
 import type { WorldState } from "./sim/world.js";
+/** Current Ananke engine version — used to evaluate pack compatRange at runtime. */
+export declare const ANANKE_ENGINE_VERSION = "0.1.65";
 /** A single actionable validation failure from `validatePack`. */
 export interface PackValidationError {
     /** JSONPath-style location, e.g. `"$.weapons[2].mass_kg"`. */
@@ -6,6 +8,61 @@ export interface PackValidationError {
     /** Human-readable explanation of what is wrong. */
     message: string;
 }
+/** Stability tier for a content pack — controls how it is listed in a registry. */
+export type PackStabilityTier = "stable" | "experimental" | "internal";
+/** Dataset or paper reference for empirically grounded pack content. */
+export interface PackProvenanceRef {
+    /** Short description of the source. */
+    title: string;
+    /** URL of the source, if available. */
+    url?: string;
+    /** DOI of the source, if applicable. */
+    doi?: string;
+    /** Free-text notes about what this source grounds. */
+    notes?: string;
+}
+/**
+ * Registry metadata block — optional top-level section of a pack manifest.
+ *
+ * Including a `registry` block enables:
+ * - Runtime compatibility checking via `compatRange`
+ * - Deterministic integrity verification via `checksum` (SHA-256)
+ * - Licensing and provenance attestation for empirical content
+ *
+ * Generate the checksum with:
+ *   `npx ananke pack bundle <dir>`  (embeds it automatically)
+ *
+ * or manually with `computePackChecksum(manifest)` from `@ananke/content-pack`.
+ */
+export interface PackRegistryMeta {
+    /**
+     * Semver range of Ananke engine versions this pack targets.
+     * Examples: `">=0.1.50"`, `">=0.1 <0.2"`, `"^0.1.60"`.
+     * `validatePack` rejects packs whose `compatRange` excludes the running version.
+     */
+    compatRange?: string;
+    /** Stability guarantee — governs how the pack appears in a public registry. */
+    stabilityTier?: PackStabilityTier;
+    /**
+     * Subpath exports from `@its-not-rocket-science/ananke` that this pack's
+     * content references, e.g. `["./combat", "./catalog"]`.
+     * Informational only — not enforced at runtime.
+     */
+    requiredExports?: string[];
+    /**
+     * SHA-256 hex digest of the pack JSON (with `registry.checksum` set to `""`
+     * before hashing, so the field is present but blank).
+     * Compute with `npx ananke pack bundle` or `computePackChecksum`.
+     */
+    checksum?: string;
+    /** SPDX license identifier, e.g. `"MIT"`, `"CC-BY-4.0"`. */
+    license?: string;
+    /**
+     * Dataset or paper references for empirically grounded pack content.
+     * Include when your pack derives parameters from research data.
+     */
+    provenance?: PackProvenanceRef[];
+}
 /**
  * The `.ananke-pack` manifest schema.
  *
@@ -24,9 +81,14 @@ export interface AnankePackManifest {
     description?: string;
     /**
      * Minimum Ananke version required, as a semver range string.
-     * Used for documentation only — not enforced at runtime in v0.1.
+     * @deprecated Use `registry.compatRange` instead — this field is informational only.
      */
     anankeVersion?: string;
+    /**
+     * Registry metadata — compatibility, checksum, license, and provenance.
+     * `registry.compatRange` is enforced at runtime by `validatePack`.
+     */
+    registry?: PackRegistryMeta;
     /** Weapon definitions — each passed to `registerWeapon`. */
     weapons?: unknown[];
     /** Armour definitions — each passed to `registerArmour`. */
@@ -59,6 +121,11 @@ export interface LoadPackResult {
     /** Validation and registration errors.  Empty on full success. */
     errors: PackValidationError[];
 }
+/**
+ * Test whether `version` satisfies `range`.
+ * Returns `false` if the range string is unparseable.
+ */
+export declare function semverSatisfies(version: string, range: string): boolean;
 /**
  * Validate a pack manifest for structural conformance without loading it.
  *

package/dist/src/content-pack.js

@@ -13,6 +13,95 @@ import { registerWeapon, registerArmour, registerArchetype } from "./catalog.js"
 import { validateScenario, loadScenario } from "./scenario.js";
 import { hashMod } from "./modding.js";
 import { registerWorldArchetype, registerWorldItem } from "./world-factory.js";
+// ── Version constant ──────────────────────────────────────────────────────────
+// Must be kept in sync with package.json "version" field.
+/** Current Ananke engine version — used to evaluate pack compatRange at runtime. */
+export const ANANKE_ENGINE_VERSION = "0.1.65";
+// ── Semver utilities ──────────────────────────────────────────────────────────
+// Lightweight range evaluator — no external dependencies.
+// Supports: >=X.Y.Z  >X.Y.Z  <=X.Y.Z  <X.Y.Z  =X.Y.Z  ^X.Y.Z  ~X.Y.Z
+// Short forms X.Y and X treated as X.Y.0 and X.0.0 respectively.
+// Compound ranges (space-separated) require all constraints to match.
+function parseSemverTuple(v) {
+    const parts = v.replace(/^v/, "").split(".").map(Number);
+    if (parts.some(isNaN))
+        return null;
+    const [major = 0, minor = 0, patch = 0] = parts;
+    return [major, minor, patch];
+}
+function cmpSemver(a, b) {
+    if (a[0] !== b[0])
+        return a[0] - b[0];
+    if (a[1] !== b[1])
+        return a[1] - b[1];
+    return a[2] - b[2];
+}
+/**
+ * Test whether `version` satisfies `range`.
+ * Returns `false` if the range string is unparseable.
+ */
+export function semverSatisfies(version, range) {
+    const ver = parseSemverTuple(version);
+    if (!ver)
+        return false;
+    const constraints = range.trim().split(/\s+/);
+    for (const constraint of constraints) {
+        if (!evalConstraint(ver, constraint.trim()))
+            return false;
+    }
+    return true;
+}
+function evalConstraint(ver, c) {
+    // Caret: ^X.Y.Z — compatible within the leftmost non-zero component.
+    // ^1.2.3 → >=1.2.3 <2.0.0 (major locked when major > 0)
+    // ^0.2.3 → >=0.2.3 <0.3.0 (minor locked when major == 0, minor > 0)
+    // ^0.0.3 → >=0.0.3 <0.0.4 (patch locked when both major and minor == 0)
+    if (c.startsWith("^")) {
+        const lo = parseSemverTuple(c.slice(1));
+        if (!lo)
+            return false;
+        let hi;
+        if (lo[0] > 0)
+            hi = [lo[0] + 1, 0, 0];
+        else if (lo[1] > 0)
+            hi = [0, lo[1] + 1, 0];
+        else
+            hi = [0, 0, lo[2] + 1];
+        return cmpSemver(ver, lo) >= 0 && cmpSemver(ver, hi) < 0;
+    }
+    // Tilde: ~X.Y.Z → >=X.Y.Z <X.(Y+1).0
+    if (c.startsWith("~")) {
+        const lo = parseSemverTuple(c.slice(1));
+        if (!lo)
+            return false;
+        const hi = [lo[0], lo[1] + 1, 0];
+        return cmpSemver(ver, lo) >= 0 && cmpSemver(ver, hi) < 0;
+    }
+    // Comparators
+    if (c.startsWith(">=")) {
+        const t = parseSemverTuple(c.slice(2));
+        return t !== null && cmpSemver(ver, t) >= 0;
+    }
+    if (c.startsWith(">")) {
+        const t = parseSemverTuple(c.slice(1));
+        return t !== null && cmpSemver(ver, t) > 0;
+    }
+    if (c.startsWith("<=")) {
+        const t = parseSemverTuple(c.slice(2));
+        return t !== null && cmpSemver(ver, t) <= 0;
+    }
+    if (c.startsWith("<")) {
+        const t = parseSemverTuple(c.slice(1));
+        return t !== null && cmpSemver(ver, t) < 0;
+    }
+    if (c.startsWith("=")) {
+        const t = parseSemverTuple(c.slice(1));
+        return t !== null && cmpSemver(ver, t) === 0;
+    }
+    // Bare version: exact match
+    const t = parseSemverTuple(c);
+    return t !== null && cmpSemver(ver, t) === 0;
+}
 const _packs = new Map();
 // ── Validation ────────────────────────────────────────────────────────────────
 /**
@@ -39,6 +128,75 @@ export function validatePack(manifest) {
         !/^\d+\.\d+(\.\d+)?$/.test(m["version"])) {
         errors.push({ path: "$.version", message: 'must be a semver string like "1.0.0" or "1.0"' });
     }
+    // Optional: registry block
+    if (m["registry"] !== undefined) {
+        if (typeof m["registry"] !== "object" || m["registry"] === null || Array.isArray(m["registry"])) {
+            errors.push({ path: "$.registry", message: "must be a plain object if present" });
+        }
+        else {
+            const reg = m["registry"];
+            // compatRange — semver range string; must include the running engine version
+            if (reg["compatRange"] !== undefined) {
+                if (typeof reg["compatRange"] !== "string") {
+                    errors.push({ path: "$.registry.compatRange", message: "must be a string" });
+                }
+                else if (!semverSatisfies(ANANKE_ENGINE_VERSION, reg["compatRange"])) {
+                    errors.push({
+                        path: "$.registry.compatRange",
+                        message: `engine version ${ANANKE_ENGINE_VERSION} does not satisfy range "${reg["compatRange"]}"`,
+                    });
+                }
+            }
+            // stabilityTier — must be one of the known tiers
+            const TIERS = ["stable", "experimental", "internal"];
+            if (reg["stabilityTier"] !== undefined && !TIERS.includes(reg["stabilityTier"])) {
+                errors.push({
+                    path: "$.registry.stabilityTier",
+                    message: `must be one of: ${TIERS.join(", ")}`,
+                });
+            }
+            // requiredExports — must be array of strings
+            if (reg["requiredExports"] !== undefined) {
+                if (!Array.isArray(reg["requiredExports"])) {
+                    errors.push({ path: "$.registry.requiredExports", message: "must be an array" });
+                }
+                else {
+                    for (let i = 0; i < reg["requiredExports"].length; i++) {
+                        if (typeof reg["requiredExports"][i] !== "string") {
+                            errors.push({ path: `$.registry.requiredExports[${i}]`, message: "must be a string" });
+                        }
+                    }
+                }
+            }
+            // checksum — must be a 64-char hex string (SHA-256) if present
+            if (reg["checksum"] !== undefined) {
+                if (typeof reg["checksum"] !== "string" || !/^[0-9a-f]{64}$/.test(reg["checksum"])) {
+                    errors.push({ path: "$.registry.checksum", message: "must be a 64-character lowercase hex string (SHA-256)" });
+                }
+            }
+            // license — must be a non-empty string
+            if (reg["license"] !== undefined && (typeof reg["license"] !== "string" || reg["license"].trim() === "")) {
+                errors.push({ path: "$.registry.license", message: "must be a non-empty SPDX identifier string" });
+            }
+            // provenance — must be array of objects with at least a title
+            if (reg["provenance"] !== undefined) {
+                if (!Array.isArray(reg["provenance"])) {
+                    errors.push({ path: "$.registry.provenance", message: "must be an array" });
+                }
+                else {
+                    for (let i = 0; i < reg["provenance"].length; i++) {
+                        const ref = reg["provenance"][i];
+                        if (typeof ref !== "object" || ref === null) {
+                            errors.push({ path: `$.registry.provenance[${i}]`, message: "must be an object" });
+                        }
+                        else if (typeof ref["title"] !== "string") {
+                            errors.push({ path: `$.registry.provenance[${i}].title`, message: "must be a string" });
+                        }
+                    }
+                }
+            }
+        }
+    }
     // Optional arrays — must be arrays if present
     for (const key of ["weapons", "armour", "archetypes", "scenarios"]) {
         if (m[key] !== undefined && !Array.isArray(m[key])) {

package/dist/tools/pack-cli.js

@@ -12,6 +12,7 @@
 //   npx ananke replay diff <a.json> <b.json>
 import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { join, resolve, extname, basename } from "node:path";
+import { createHash } from "node:crypto";
 import { validatePack, loadPack } from "../src/content-pack.js";
 import { diffReplayJson } from "../src/netcode.js";
 import { q } from "../src/units.js";
@@ -97,6 +98,13 @@ function cmdBundle(args) {
         if (!bundle.name && typeof partial.name === "string")
             bundle.name = partial.name;
     }
+    // Compute SHA-256 checksum: serialise with checksum="" (placeholder), then hash.
+    // Store in registry block so consumers can verify integrity.
+    if (!bundle.registry)
+        bundle.registry = {};
+    bundle.registry.checksum = ""; // placeholder — field present but blank for hashing
+    const checksumInput = JSON.stringify(bundle, null, 2);
+    bundle.registry.checksum = createHash("sha256").update(checksumInput).digest("hex");
     // Pre-validate before writing
     const errors = validatePack(bundle);
     if (errors.length > 0) {
@@ -107,6 +115,7 @@ function cmdBundle(args) {
     writeFileSync(outFile, json, "utf8");
     console.log(`✓  Bundle written to ${outFile}`);
     console.log(`   weapons: ${bundle.weapons.length}, armour: ${bundle.armour.length}, archetypes: ${bundle.archetypes.length}, scenarios: ${bundle.scenarios.length}`);
+    console.log(`   checksum: ${bundle.registry.checksum}`);
 }
 function cmdLoad(args) {
     const filePath = args[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -201,6 +201,10 @@
     "./netcode": {
       "import": "./dist/src/netcode.js",
       "types": "./dist/src/netcode.d.ts"
+    },
+    "./conformance": {
+      "import": "./dist/src/conformance.js",
+      "types": "./dist/src/conformance.d.ts"
     }
   },
   "workspaces": [
@@ -209,6 +213,7 @@
   "files": [
     "dist/src",
     "dist/as",
+    "conformance",
     "docs/project-overview.md",
     "docs/host-contract.md",
     "docs/integration-primer.md",
@@ -279,6 +284,8 @@
     "ref:species-lab:quick": "node dist/examples/reference/species-lab/index.js --quick",
     "generate-module-index": "node dist/tools/generate-module-index.js",
     "generate-recipes-matrix": "node dist/tools/generate-recipes-matrix.js",
+    "generate-conformance-fixtures": "node dist/tools/generate-conformance-fixtures.js",
+    "conformance-runner": "node dist/tools/conformance-runner.js",
     "pack": "node dist/tools/pack-cli.js pack",
     "generate-fixtures": "node dist/tools/generate-fixtures.js",
     "generate-zoo": "node dist/tools/generate-zoo.js",

package/schema/pack.schema.json

@@ -26,7 +26,51 @@
     },
     "anankeVersion": {
       "type": "string",
-      "description": "Minimum Ananke version required (semver range), e.g. \">=0.1\"."
+      "description": "Deprecated: use registry.compatRange instead. Minimum Ananke version required (semver range)."
+    },
+    "registry": {
+      "type": "object",
+      "description": "Registry metadata — compatibility, checksum, license, and provenance. registry.compatRange is enforced at runtime by validatePack.",
+      "properties": {
+        "compatRange": {
+          "type": "string",
+          "description": "Semver range of Ananke engine versions this pack targets, e.g. \">=0.1.50\", \"^0.1.60\". Validated at runtime against the running engine version."
+        },
+        "stabilityTier": {
+          "type": "string",
+          "enum": ["stable", "experimental", "internal"],
+          "description": "Stability guarantee — governs how the pack appears in a public registry."
+        },
+        "requiredExports": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Subpath exports from @its-not-rocket-science/ananke this pack's content depends on. Informational only."
+        },
+        "checksum": {
+          "type": "string",
+          "pattern": "^([0-9a-f]{64}|)$",
+          "description": "SHA-256 hex digest of the pack JSON (with registry.checksum set to \"\" before hashing). Computed by `npx ananke pack bundle`."
+        },
+        "license": {
+          "type": "string",
+          "description": "SPDX license identifier, e.g. \"MIT\", \"CC-BY-4.0\"."
+        },
+        "provenance": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["title"],
+            "properties": {
+              "title": { "type": "string" },
+              "url":   { "type": "string" },
+              "doi":   { "type": "string" },
+              "notes": { "type": "string" }
+            }
+          },
+          "description": "Dataset or paper references for empirically grounded pack content."
+        }
+      },
+      "additionalProperties": false
     },
     "weapons": {
       "type": "array",