@its-not-rocket-science/ananke 0.1.62 → 0.1.64

package/CHANGELOG.md

@@ -6,6 +6,46 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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
+
+- **PM-4 — Release Discipline Dashboard (complete):**
+  - `tools/release-check.ts` (new): pre-release gate runner that executes 6 gates in sequence and produces two output artefacts:
+    1. **Schema migration pass** — runs `test/schema-migration.test.ts` + `test/anatomy_schema.test.ts` via Vitest
+    2. **Golden replay / fixture round-trip** — skips gracefully if `test/fixtures/` does not exist; runs fixture tests when present
+    3. **Bridge contract type-check** — `tsc --noEmit -p tsconfig.build.json`; counts TypeScript errors
+    4. **Benchmark regression** — delegates to `dist/tools/benchmark-check.js`; exit-code based
+    5. **Emergent behaviour validation** — runs emergent-validation and parses PASS / PARTIAL PASS / FAIL from stdout
+    6. **Module-index freshness** — re-generates `docs/module-index.md` and diffs against the committed version; warns if stale
+  - `docs/release-report.json` (auto-generated): structured JSON with timestamp, version, per-gate status, duration, summary, and detail strings.
+  - `docs/release-dashboard.md` (auto-generated): human-readable Markdown audit trail rendered from the JSON report. Includes verdict, gate table, and per-gate detail blocks.
+  - `--quick` flag: skips slow gates (benchmark, emergent validation) for fast local checks.
+  - Exit code: 0 = releasable (no failures, no warnings); 1 = not releasable.
+  - npm scripts: `release-check`, `release-check:quick`.
+- 0 new tests (5,569 total). Coverage unchanged. Build: clean.
+
+---
+
 ## [0.1.62] — 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "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",
@@ -248,6 +253,8 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "ci": "npm run build && npm run test:coverage && npm run check-boundaries",
+    "release-check": "node dist/tools/release-check.js",
+    "release-check:quick": "node dist/tools/release-check.js --quick",
     "check-boundaries": "node dist/tools/check-package-boundaries.js",
     "check-boundaries:strict": "node dist/tools/check-package-boundaries.js --strict",
     "extract-api": "node dist/tools/extract-api.js",
@@ -277,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",