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

package/CHANGELOG.md

@@ -6,6 +6,42 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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
+
+- **PM-2 — Package-Boundary Enforcement in CI (complete):**
+  - `tools/check-package-boundaries.ts` (new): static import-graph analyser mapping all 207 src/ files to their planned `@ananke/*` package. Reports:
+    - **Hard violations** — files classified as `@ananke/core` that import from `@ananke/combat`, `@ananke/campaign`, or `@ananke/content` (86 identified; all expected in Phase 1 monolith, must be resolved in Phase 2 source migration).
+    - **Suspicious cross-boundary imports** — peer-layer imports (`combat↔campaign`, `combat↔content`, `content↔campaign`) grouped by edge with file:line references and example paths.
+    - **Cross-package import matrix** — NxN table showing import counts between packages, annotated ✓ (allowed) or ✗ (violation).
+    - **Source size estimate** — raw TypeScript byte counts per package (core 341 KB, combat 499 KB, campaign 833 KB, content 248 KB).
+    - **Unmapped files** — 9 files not yet in the mapping (atmosphere, battle-bridge, debug, host-loop, index, parallel, sensory, terrain-bridge).
+    - Flags: `--strict` (exit 1 on hard violations), `--json` (machine-readable output).
+  - `tools/extract-api.ts` (new): public API surface extraction — scans each package's entry-point source files for exported symbols, generates `docs/api-surface-<package>.md` with grouped tables (types/interfaces, enums, functions, constants, classes) and a source-file index.
+    - `docs/api-surface-core.md` — 125 exports
+    - `docs/api-surface-combat.md` — 221 exports
+    - `docs/api-surface-campaign.md` — 691 exports
+    - `docs/api-surface-content.md` — 103 exports (1140 total)
+  - `"ci"` script now runs `check-boundaries` after test coverage, making cross-boundary drift visible in CI output.
+  - npm scripts: `check-boundaries`, `check-boundaries:strict`, `extract-api`.
+- 0 new tests (5,569 total — tools only). Coverage unchanged: 97.11% stmt, 88.08% branch, 95.82% func. Build: clean.
+
+---
+
 ## [0.1.60] — 2026-03-31
 
 ### 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.60",
+  "version": "0.1.62",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -247,7 +247,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "ci": "npm run build && npm run test:coverage",
+    "ci": "npm run build && npm run test:coverage && npm run check-boundaries",
+    "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",
     "lint": "node tools/lint-open.mjs",
     "run:demo": "node dist/tools/run-demo.js",
     "run:vertical-slice": "node dist/tools/vertical-slice.js",
@@ -273,6 +276,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",