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

package/CHANGELOG.md

@@ -6,6 +6,43 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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
+
+- **PM-1 — First-Party Reference Builds (complete):**
+  - `examples/reference/tactical-duel/` — end-to-end tactical demonstration: combat, anatomy, AI, `serializeBridgeFrame`, `hashWorldState`, `ReplayRecorder`. Runs in < 1 ms/tick; produces a replay file comparable with `npx ananke replay diff`. Includes architecture doc and pain-points guide.
+  - `examples/reference/campaign-sandbox/` — turn-based world simulation: four polities (Rome, Carthage, Athens, Sparta) with trade, alliances, population dynamics, plague outbreak, inter-polity spread, save/reload via `stampSnapshot`. Runs in < 1 ms/day. Includes full `README.md` with correct API signatures.
+  - `examples/reference/species-lab/` — xenobiology lab: attribute profiles for 6 species (Elf, Dwarf, Orc, Goblin, Troll, Halfling), extended-senses predicates, round-robin combat tournament (100 seeds × 15 matchups) with outcome distributions and physics insights. Quick mode (`--quick`) completes 150 trials in < 1 s. Includes pain-points guide and extension examples.
+  - Each reference build includes: architecture diagram, package choices rationale, measured performance envelope, pain points encountered and resolved, extension examples.
+  - npm scripts: `ref:tactical-duel`, `ref:campaign-sandbox`, `ref:species-lab`, `ref:species-lab:quick`.
+  - ROADMAP: PM-1 through PM-10 added (Platform Maturity Roadmap); PA-1, PA-5–PA-8 marked complete.
+
+---
+
 ## [0.1.59] — 2026-03-30
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "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",
@@ -268,6 +271,10 @@
     "example:species": "node dist/examples/quickstart-species.js",
     "example:lockstep": "node dist/examples/lockstep-server.js",
     "example:rollback": "node dist/examples/rollback-client.js",
+    "ref:tactical-duel": "node dist/examples/reference/tactical-duel/index.js",
+    "ref:campaign-sandbox": "node dist/examples/reference/campaign-sandbox/index.js",
+    "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",
     "pack": "node dist/tools/pack-cli.js pack",
     "generate-fixtures": "node dist/tools/generate-fixtures.js",