@its-not-rocket-science/ananke 0.1.66 → 0.1.68

package/CHANGELOG.md

@@ -6,6 +6,41 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.68] — 2026-04-01
+
+### Added
+
+- **PM-9 — Core Guarantees Technical Paper (complete):**
+  - `docs/core-guarantees.md` (new): concise, self-contained reference covering Ananke's full guarantee surface:
+    1. **Fixed-point determinism** — the guarantee, how it is enforced (integer arithmetic, no `Math.random()`, insertion-order iteration, corpus hash CI), and what can break it.
+    2. **API stability tiers** — what "breaking" means for Tier 1, the pre-1.0 note, and the deprecation lifecycle.
+    3. **Schema and wire contracts** — world-state hash, replay format, content-pack checksum, semver range enforcement.
+    4. **Validation philosophy** — three claim types: Empirical (source-bounded), Plausibility (first-principles), and Content-layer (definitional).
+    5. **Benchmark methodology** — what the numbers mean and do not mean; how to detect correctness vs. performance regressions.
+    6. **Known limits** — floating-point interop boundary, JS engine version portability, host clock independence, entity count scalability, numerical overflow handling.
+  - Each claim is labelled **Engineering claim**, **Empirical claim**, or **Design principle**.
+  - Links added to `README.md` Further Reading table and `STABLE_API.md` intro.
+- 0 new tests (5,593 total). Coverage: 97.06%/88.06%/95.83%/97.06%. Build: clean.
+
+---
+
+## [0.1.67] — 2026-04-01
+
+### Added
+
+- **PM-8 — Scenario Corpus as Shared Benchmark and Pedagogy Asset (complete):**
+  - `corpus/` directory with 5 canonical deterministic scenarios, each carrying a `corpus.json` manifest (`version`, `id`, `title`, `tags`, `stabilityStatus`, `scenario`, `expectedOutputHash`, `performanceClass`, `replayFixture`, `bridgeExpected`).
+  - Tags: `tutorial`, `benchmark`, `validation`, `networking`, `bridge`, `content-pack`.
+  - Entries: `basic-duel` (tutorial, 30 ticks), `armoured-combat` (validation+content-pack, 50 ticks), `lockstep-replay` (networking, 10 ticks + replay.json fixture), `bridge-snapshot` (bridge, 0 ticks), `ai-benchmark` (benchmark, 20 ticks).
+  - `tools/generate-corpus.ts`: regenerates all corpus entries from scenario definitions; computes world-state hashes, replay fixtures, and bridge-frame invariants. Run after any change to `stepWorld`, `hashWorldState`, or equipment constants.
+  - `tools/verify-corpus.ts`: verifies all corpus entries against the live engine; checks world-state hash, replay parity (networking), and bridge frame shape (bridge). Supports `--id=<entry>` and `--json` flags.
+  - npm scripts: `generate-corpus`, `verify-corpus`.
+  - `corpus` added to `package.json` `files` array (shipped with the npm package).
+  - Links added to README "Further Reading" table and `docs/cookbook.md` "Further reading" table.
+- 0 new tests (5,593 total). Coverage: 97.11%/88.07%/95.83%/97.11%. Build: clean.
+
+---
+
 ## [0.1.66] — 2026-04-01
 
 ### Added

package/README.md

@@ -418,7 +418,9 @@ Ananke's outputs are validated against historical and experimental sources:
 |---|---|
 | [`docs/recipes-matrix.md`](docs/recipes-matrix.md) | **Start here** — use case → package → stability → example → performance in one table |
 | [`docs/cookbook.md`](docs/cookbook.md) | Task-oriented recipes — duel, 500-agent battle, species, renderer, campaign, replay, and more |
+| [`corpus/README.md`](corpus/README.md) | Scenario corpus — 5 canonical deterministic scenarios (tutorial, benchmark, validation, networking, bridge); run `npm run verify-corpus` |
 | [`docs/module-index.md`](docs/module-index.md) | All 41 entry points — stability tier, use case, key exports, doc links |
+| [`docs/core-guarantees.md`](docs/core-guarantees.md) | Core guarantees — determinism contract, API stability, validation philosophy, known limits |
 | [`docs/host-contract.md`](docs/host-contract.md) | Stable integration surface — everything needed to embed Ananke without reading `src/` |
 | [`docs/integration-primer.md`](docs/integration-primer.md) | Data-flow diagrams, type glossary, gotchas |
 | [`docs/bridge-contract.md`](docs/bridge-contract.md) | 3D renderer bridge protocol (AnimationHints, GrapplePoseConstraint) |

package/STABLE_API.md

@@ -3,6 +3,8 @@
 This document defines the three stability tiers for Ananke's public API surface.
 See [`docs/versioning.md`](docs/versioning.md) for the full versioning policy, upgrade
 cadence, and commit-hash pinning guide.
+See [`docs/core-guarantees.md`](docs/core-guarantees.md) for the full determinism contract,
+validation philosophy, benchmark methodology, and known limits.
 
 ---
 

package/corpus/README.md

@@ -0,0 +1,47 @@
+# Ananke — Scenario Corpus
+
+Each subdirectory contains a `corpus.json` manifest describing a canonical
+deterministic scenario.  Run `npm run verify-corpus` to verify all entries
+against the reference engine.
+
+## Entries
+
+| ID | Tags | Ticks | Description |
+|----|------|-------|-------------|
+| `basic-duel` | `tutorial` | 30 | Basic 1v1 Duel (No AI) |
+| `armoured-combat` | `validation`, `content-pack` | 50 | Armoured 1v1 Combat (Line Infantry AI) |
+| `lockstep-replay` | `networking` | 10 | Lockstep Replay Parity (10 Ticks) |
+| `bridge-snapshot` | `bridge` | 0 | Renderer Bridge Snapshot |
+| `ai-benchmark` | `benchmark` | 20 | AI Skirmish Benchmark (20 Ticks) |
+
+## Tag meanings
+
+| Tag | Purpose |
+|-----|---------|
+| `tutorial` | Entry-level; no prior knowledge required |
+| `benchmark` | Stable timing baseline; detect performance regressions |
+| `validation` | Compared against empirical data |
+| `networking` | Exercises replay, hash, lockstep |
+| `bridge` | Exercises the renderer bridge |
+| `content-pack` | Exercises equipment loading and composition |
+
+## Verifying
+
+```bash
+npm run build
+npm run verify-corpus              # all entries
+npm run verify-corpus -- --id=basic-duel   # single entry
+npm run verify-corpus -- --json    # machine-readable
+```
+
+## Regenerating
+
+Re-run after any change to `stepWorld`, `hashWorldState`, or equipment constants:
+
+```bash
+npm run build && npm run generate-corpus
+```
+
+## Corpus format version
+
+All manifests carry `"version": "corpus/v1"`.

package/corpus/ai-benchmark/corpus.json

@@ -0,0 +1,36 @@
+{
+  "version": "corpus/v1",
+  "id": "ai-benchmark",
+  "title": "AI Skirmish Benchmark (20 Ticks)",
+  "description": "Two line-infantry entities engaging over 20 ticks. Benchmark scenario: exercises the full AI decision + physics + injury path. Use the timing result to detect performance regressions between engine versions.",
+  "tags": [
+    "benchmark"
+  ],
+  "stabilityStatus": "stable",
+  "scenario": {
+    "seed": 42,
+    "tractionCoeff_Q": 9000,
+    "entities": [
+      {
+        "id": 1,
+        "teamId": 1,
+        "x_m": -0.5,
+        "weapon": "wpn_longsword"
+      },
+      {
+        "id": 2,
+        "teamId": 2,
+        "x_m": 0.5,
+        "weapon": "wpn_longsword"
+      }
+    ],
+    "aiPolicy": "lineInfantry",
+    "tickCount": 20
+  },
+  "expectedOutputHash": "0xacb04548fd68a7fb",
+  "performanceClass": {
+    "entityCount": 2,
+    "expectedTickBudgetMs": 150
+  },
+  "replayFixture": null
+}

package/corpus/armoured-combat/corpus.json

@@ -0,0 +1,39 @@
+{
+  "version": "corpus/v1",
+  "id": "armoured-combat",
+  "title": "Armoured 1v1 Combat (Line Infantry AI)",
+  "description": "Two entities equipped with chainmail armour and longswords, driven by lineInfantry AI. Validation scenario: armour damage absorption, shock accumulation, and equipment interaction over 50 ticks.",
+  "tags": [
+    "validation",
+    "content-pack"
+  ],
+  "stabilityStatus": "stable",
+  "scenario": {
+    "seed": 42,
+    "tractionCoeff_Q": 9000,
+    "entities": [
+      {
+        "id": 1,
+        "teamId": 1,
+        "x_m": -0.5,
+        "weapon": "wpn_longsword",
+        "armour": "arm_chainmail"
+      },
+      {
+        "id": 2,
+        "teamId": 2,
+        "x_m": 0.5,
+        "weapon": "wpn_longsword",
+        "armour": "arm_chainmail"
+      }
+    ],
+    "aiPolicy": "lineInfantry",
+    "tickCount": 50
+  },
+  "expectedOutputHash": "0x8231f53b3211a379",
+  "performanceClass": {
+    "entityCount": 2,
+    "expectedTickBudgetMs": 200
+  },
+  "replayFixture": null
+}

package/corpus/basic-duel/corpus.json

@@ -0,0 +1,36 @@
+{
+  "version": "corpus/v1",
+  "id": "basic-duel",
+  "title": "Basic 1v1 Duel (No AI)",
+  "description": "Two entities face off with longswords and no AI commands. Entry-level tutorial: demonstrates combat resolution, injury accumulation, and deterministic world-state hashing over 30 ticks.",
+  "tags": [
+    "tutorial"
+  ],
+  "stabilityStatus": "stable",
+  "scenario": {
+    "seed": 42,
+    "tractionCoeff_Q": 9000,
+    "entities": [
+      {
+        "id": 1,
+        "teamId": 1,
+        "x_m": -0.5,
+        "weapon": "wpn_longsword"
+      },
+      {
+        "id": 2,
+        "teamId": 2,
+        "x_m": 0.5,
+        "weapon": "wpn_longsword"
+      }
+    ],
+    "aiPolicy": "noMove",
+    "tickCount": 30
+  },
+  "expectedOutputHash": "0x7d82acd3d1966c61",
+  "performanceClass": {
+    "entityCount": 2,
+    "expectedTickBudgetMs": 100
+  },
+  "replayFixture": null
+}

package/corpus/bridge-snapshot/corpus.json

@@ -0,0 +1,42 @@
+{
+  "version": "corpus/v1",
+  "id": "bridge-snapshot",
+  "title": "Renderer Bridge Snapshot",
+  "description": "Two entities at tick 0 serialized through serializeBridgeFrame. Bridge scenario: verifies the BridgeFrame schema version, tick, entity count, and entity IDs. Baseline for renderer integration testing.",
+  "tags": [
+    "bridge"
+  ],
+  "stabilityStatus": "stable",
+  "scenario": {
+    "seed": 42,
+    "tractionCoeff_Q": 9000,
+    "entities": [
+      {
+        "id": 1,
+        "teamId": 1,
+        "x_m": -0.5,
+        "weapon": "wpn_longsword"
+      },
+      {
+        "id": 2,
+        "teamId": 2,
+        "x_m": 0.5,
+        "weapon": "wpn_longsword"
+      }
+    ],
+    "aiPolicy": "noMove",
+    "tickCount": 0
+  },
+  "expectedOutputHash": "0xec578e005fcbef34",
+  "performanceClass": {
+    "entityCount": 2,
+    "expectedTickBudgetMs": 10
+  },
+  "replayFixture": null,
+  "bridgeExpected": {
+    "schema": "ananke.bridge.frame.v1",
+    "tick": 0,
+    "entityCount": 2,
+    "scenarioId": "corpus-bridge"
+  }
+}

package/corpus/lockstep-replay/corpus.json

@@ -0,0 +1,36 @@
+{
+  "version": "corpus/v1",
+  "id": "lockstep-replay",
+  "title": "Lockstep Replay Parity (10 Ticks)",
+  "description": "Two entities with noMove commands over 10 ticks. Networking scenario: records a reference replay and verifies that replayTo() reproduces identical world-state hashes at each tick. Use as a correctness check when porting to a new host environment.",
+  "tags": [
+    "networking"
+  ],
+  "stabilityStatus": "stable",
+  "scenario": {
+    "seed": 42,
+    "tractionCoeff_Q": 9000,
+    "entities": [
+      {
+        "id": 1,
+        "teamId": 1,
+        "x_m": -0.5,
+        "weapon": "wpn_longsword"
+      },
+      {
+        "id": 2,
+        "teamId": 2,
+        "x_m": 0.5,
+        "weapon": "wpn_longsword"
+      }
+    ],
+    "aiPolicy": "noMove",
+    "tickCount": 10
+  },
+  "expectedOutputHash": "0x8fe5f3eba59e0b75",
+  "performanceClass": {
+    "entityCount": 2,
+    "expectedTickBudgetMs": 200
+  },
+  "replayFixture": "replay.json"
+}

package/corpus/lockstep-replay/replay.json

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

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

@@ -1,6 +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.66";
+export declare const ANANKE_ENGINE_VERSION = "0.1.68";
 /** A single actionable validation failure from `validatePack`. */
 export interface PackValidationError {
     /** JSONPath-style location, e.g. `"$.weapons[2].mass_kg"`. */

package/dist/src/content-pack.js

@@ -16,7 +16,7 @@ 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.66";
+export const ANANKE_ENGINE_VERSION = "0.1.68";
 // ── 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -214,6 +214,7 @@
     "dist/src",
     "dist/as",
     "conformance",
+    "corpus",
     "docs/project-overview.md",
     "docs/host-contract.md",
     "docs/integration-primer.md",
@@ -286,6 +287,8 @@
     "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",
+    "generate-corpus": "node dist/tools/generate-corpus.js",
+    "verify-corpus": "node dist/tools/verify-corpus.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",