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

package/CHANGELOG.md

@@ -6,6 +6,40 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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
+
+- **PM-3 — Supported-Recipes Matrix (complete):**
+  - `docs/recipes-matrix.md` (new, auto-generated): 36 recipes across 6 domains (Tactical ⚔️, Campaign 🏰, Content 📦, Renderer 🖼️, Multiplayer 🌐, Tooling 🔧). Each row maps a use case to recommended packages, stability tier (🟢 Stable / 🟡 Experimental), runnable npm script, performance envelope, and save/replay compatibility status. Domain tables, summary counts, and a quick-reference "I want to…" table at the bottom.
+  - `tools/generate-recipes-matrix.ts` (new): structured recipe catalogue as TypeScript array; outputs `docs/recipes-matrix.md` deterministically. Run `npm run generate-recipes-matrix` to refresh.
+  - `npm run generate-recipes-matrix` script added.
+  - README: "Not sure which entry point to use? → Recipes Matrix" note added near the cookbook paragraph; matrix linked first in the Further Reading table.
+- 0 new tests (5,569 total). Coverage unchanged. Build: clean.
+
+---
+
 ## [0.1.61] — 2026-04-01
 
 ### Added

package/README.md

@@ -96,6 +96,8 @@ for (let tick = 0; tick < 2000; tick++) {
 `stepWorld` is the only function that mutates state.  Everything else is pure computation.
 Call it at 20 Hz for real-time simulation; 1 Hz or lower for campaign-scale time.
 
+Not sure which entry point to use?  See the **[Recipes Matrix](docs/recipes-matrix.md)** — use case → package → stability → runnable example → performance in one table.
+
 For task-oriented walkthroughs, see the **[Simulation Cookbook](docs/cookbook.md)** — 12 recipes
 from "Simulate a duel" to "Load a content pack", each with step-by-step code and expected output.
 
@@ -414,6 +416,7 @@ Ananke's outputs are validated against historical and experimental sources:
 
 | Document | What's in it |
 |---|---|
+| [`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 |
 | [`docs/module-index.md`](docs/module-index.md) | All 41 entry points — stability tier, use case, key exports, doc links |
 | [`docs/host-contract.md`](docs/host-contract.md) | Stable integration surface — everything needed to embed Ananke without reading `src/` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -248,6 +248,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",
@@ -276,6 +278,7 @@
     "ref:species-lab": "node dist/examples/reference/species-lab/index.js",
     "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",
     "pack": "node dist/tools/pack-cli.js pack",
     "generate-fixtures": "node dist/tools/generate-fixtures.js",
     "generate-zoo": "node dist/tools/generate-zoo.js",