@its-not-rocket-science/ananke 0.1.49 → 0.1.51

package/CHANGELOG.md

@@ -6,13 +6,49 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.51] — 2026-03-28
+
+### Added
+
+- **PA-2 — Modular Package Architecture (Phase 1 complete):**
+  - `packages/core/` — `@ananke/core` stub; re-exports the full main `"."` entry point (kernel, entity model, units, RNG, replay, bridge).
+  - `packages/combat/` — `@ananke/combat` stub; re-exports `"./combat"`, `"./anatomy"`, `"./competence"`, `"./wasm-kernel"`.
+  - `packages/campaign/` — `@ananke/campaign` stub; re-exports all 32 campaign-scale subpaths (polity, social, narrative, feudal, demography, economy, military…).
+  - `packages/content/` — `@ananke/content` stub; re-exports `"./species"`, `"./catalog"`, `"./character"`, `"./crafting"`.
+  - Each stub ships a pre-built `index.js` + `index.d.ts` (no separate compilation step); `@its-not-rocket-science/ananke` is a peer dependency.
+  - Root `package.json` gains `"workspaces": ["packages/*"]` for local linking.
+  - `docs/package-architecture.md` (new): canonical package boundary design — dependency graph, monolith subpath → package mapping table, full source-file → package mapping for Phase 2 migration, and a before/after import example.
+  - `docs/migration-monolith-to-modular.md` (new): step-by-step migration guide from the monolith to `@ananke/*` packages, with a complete old-import → new-package lookup table and Phase 2 expectations.
+  - `docs/package-architecture.md` and `docs/migration-monolith-to-modular.md` added to `package.json` `"files"` so they ship with the published package.
+- Build: clean. Tests: 5,261 passing. Coverage unchanged.
+
+---
+
+## [0.1.50] — 2026-03-28
+
+### Docs
+
+- **PA-1 — Documentation Reconciliation & Architecture Map (complete):**
+  - `docs/project-overview.md`: Updated stale "next priority" reference plugin note to reflect Godot and Unity bridge plugins are complete; updated CE-1–CE-4 companion infrastructure from "planned" to "all complete"; updated PH-1–PH-8 platform hardening table from "Planned" to "Complete".
+  - `docs/module-index.md` (new): Machine-checkable table of all 41 package subpath exports, with stability tier (Tier 1 Stable / Tier 2 Experimental / Tier 3 Campaign-scale), key exports, use-case notes, and doc links. Includes use-case entry-point guide at the top.
+  - `tools/generate-module-index.ts` (new): Script that reads `package.json` exports and renders `docs/module-index.md`. Added `generate-module-index` npm script.
+  - `docs/integration-primer.md`: Added "Choose Your Entry Point" section before Architecture Overview, with use-case decision tree and module tier table linking to `docs/module-index.md`.
+  - `README.md`: Added `docs/module-index.md` row to Further Reading table.
+- Build: clean. Tests: 5,261 passing. Coverage: statements 97.1 %, branches 87.83 %, functions 95.65 %, lines 97.1 %.
+
+---
+
 ## [0.1.49] — 2026-03-28
 
 ### Fixed
 
 - **Crafting subsystem — remaining TODO/placeholder items resolved:**
-- `src/crafting/manufacturing.ts` — `createAssemblySteps`: now derives skill types and tool categories from the recipe's actual `skillRequirements` and `toolRequirements` instead of hardcoded `"forge"`/alternating BK–LM defaults.
-- Removed misleading "placeholder" and outdated "Phase 24 placeholder" comments from `recipes.ts`, `crafting/index.ts`, and `dialogue.ts`; documentation now accurately reflects current behaviour.
+  - `src/crafting/manufacturing.ts` — `createAssemblySteps`: now derives skill types and tool categories from the recipe's actual `skillRequirements` and `toolRequirements` instead of hardcoded `"forge"`/alternating BK–LM defaults.
+  - Removed misleading "placeholder" and outdated "Phase 24 placeholder" comments from `recipes.ts`, `crafting/index.ts`, and `dialogue.ts`; documentation now accurately reflects current behaviour.
+
+### Docs
+
+- **ROADMAP — Platformization & Adoption Roadmap (2026–2027):** Added a new top-level section following external review batch 4, which concluded that the simulation kernel is feature-complete and the next phase should focus on adoption, composability, and contract stability rather than new subsystems. Ten new roadmap items added (PA-1 through PA-10): documentation reconciliation & architecture map, modular package architecture (`@ananke/core`, `@ananke/combat`, etc.), stable schema/save/wire contract, scenario & content pack system, campaign ↔ tactical terrain bridge, unified atmosphere model, advanced non-visual sensory systems, host integration SDKs (Unity / Godot / Unreal / Web), simulation cookbook, and deterministic networking kit.
 - Build: clean. Tests: 5,261 passing. Coverage: statements 97.1 %, branches 87.83 %, functions 95.65 %, lines 97.1 %.
 
 ---

package/README.md

@@ -411,6 +411,7 @@ Ananke's outputs are validated against historical and experimental sources:
 
 | Document | What's in it |
 |---|---|
+| [`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/` |
 | [`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/docs/integration-primer.md

@@ -20,6 +20,26 @@ The spike consisted of three concrete experiments:
 
 Each experiment is documented below, followed by a glossary of critical types and a list of integration gotchas.
 
+## Choose your entry point
+
+Use the table below to find the right subpath export for your use case.
+The full module index with all 41 exports is in [`docs/module-index.md`](module-index.md).
+
+| I want to… | Start with | Then add |
+|---|---|---|
+| **Simulate a duel or battle** | `"@its-not-rocket-science/ananke"` (main) | `"…/combat"` for grapple, ranged, formation |
+| **Run a campaign / world simulation** | `"…"` + `"…/polity"` | `"…/campaign"` + whichever campaign extensions you need |
+| **Design a species or xenobiology** | `"…"` + `"…/species"` + `"…/anatomy"` | `"…/character"` for aging, sleep, disease |
+| **Drive a 3D renderer** | `"…"` (bridge exports are in main bundle) | See [`docs/bridge-contract.md`](bridge-contract.md) |
+| **Build a multiplayer host** | `"…"` (deterministic by design) | See [`docs/host-contract.md`](host-contract.md) for lockstep pattern |
+| **Add narrative / storytelling** | `"…/narrative"` + `"…/narrative-prose"` | `"…/renown"` for legend-building |
+| **Craft / economic simulation** | `"…/crafting"` + `"…/catalog"` | `"…/social"` for trade and faction effects |
+| **Grand strategy / 4X** | `"…/polity"` + `"…/campaign"` | Any combination of the 26 campaign extension modules |
+
+**Stability:** `"."` and `"./polity"` are **Tier 1 (Stable)** — no breaking changes without a major version bump.
+All other subpaths are **Tier 2 (Experimental)** — changelog documents any breaking changes.
+See [`STABLE_API.md`](../STABLE_API.md) for the full tier table.
+
 ---
 
 ## 1. Architecture Overview

package/docs/migration-monolith-to-modular.md

@@ -0,0 +1,120 @@
+# Migration Guide: Monolith to Modular Packages
+
+This guide covers how to migrate from `@its-not-rocket-science/ananke` to the
+focused `@ananke/*` packages.  Migration is optional — the monolith package is
+maintained indefinitely for backwards compatibility.
+
+---
+
+## Should you migrate?
+
+| Situation | Recommendation |
+|-----------|----------------|
+| Existing project, everything working | Stay on the monolith. No action required. |
+| New project, only needs combat | Start with `@ananke/combat` + `@ananke/core` |
+| New project, full simulation stack | Use the monolith; migrate to modular when convenient |
+| Bundle size is a concern (Phase 2+) | Migrate after Phase 2 (source migration) for real tree-shaking |
+
+---
+
+## Phase 1 Migration (stubs — available now)
+
+Phase 1 packages are thin wrappers that re-export from the monolith.  Bundle
+size is unchanged, but import paths are cleaner and signal which API tier you
+depend on.
+
+### Step 1 — Install the sub-package(s) you need
+
+```bash
+# Combat-only host
+npm install @ananke/core @ananke/combat
+
+# Full world simulation
+npm install @ananke/core @ananke/combat @ananke/campaign @ananke/content
+```
+
+The monolith is installed automatically as a peer dependency.
+
+### Step 2 — Update imports
+
+Replace monolith paths with the appropriate package name:
+
+| Old import | New import |
+|-----------|-----------|
+| `@its-not-rocket-science/ananke` | `@ananke/core` |
+| `@its-not-rocket-science/ananke/combat` | `@ananke/combat` |
+| `@its-not-rocket-science/ananke/anatomy` | `@ananke/combat` |
+| `@its-not-rocket-science/ananke/competence` | `@ananke/combat` |
+| `@its-not-rocket-science/ananke/wasm-kernel` | `@ananke/combat` |
+| `@its-not-rocket-science/ananke/species` | `@ananke/content` |
+| `@its-not-rocket-science/ananke/catalog` | `@ananke/content` |
+| `@its-not-rocket-science/ananke/character` | `@ananke/content` |
+| `@its-not-rocket-science/ananke/crafting` | `@ananke/content` |
+| `@its-not-rocket-science/ananke/campaign` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/polity` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/social` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/narrative` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/narrative-prose` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/renown` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/kinship` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/succession` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/calendar` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/feudal` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/diplomacy` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/migration` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/espionage` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/trade-routes` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/siege` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/faith` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/demography` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/granary` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/epidemic` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/infrastructure` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/unrest` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/research` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/taxation` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/military-campaign` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/governance` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/resources` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/climate` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/famine` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/containment` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/mercenaries` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/wonders` | `@ananke/campaign` |
+| `@its-not-rocket-science/ananke/monetary` | `@ananke/campaign` |
+
+### Step 3 — Verify
+
+```bash
+npm run build   # or tsc --noEmit
+npm test
+```
+
+No other changes are needed.
+
+---
+
+## Phase 2 Migration (source migration — planned)
+
+When Phase 2 lands, `@ananke/combat` will no longer depend on the monolith.
+The import paths remain identical — only the transitive dependency graph changes.
+
+**No code changes required in your project for Phase 2.**
+
+Run `npm update` when the new versions are published; your bundler will
+automatically produce a smaller output.
+
+---
+
+## Staying on the monolith
+
+If you prefer to keep using `@its-not-rocket-science/ananke` directly, nothing
+changes.  The 41 subpath exports are stable and will not be removed.
+
+---
+
+## See also
+
+- [`docs/package-architecture.md`](package-architecture.md) — full design document and source file mapping
+- [`docs/module-index.md`](module-index.md) — all exports with stability tiers and use cases
+- [`STABLE_API.md`](../STABLE_API.md) — stable API surface (Tier 1)

package/docs/package-architecture.md

@@ -0,0 +1,323 @@
+# Ananke — Modular Package Architecture
+
+> **Status: Phase 1 complete** — Package stubs with re-exports are published.
+> Phase 2 (source migration) moves code into individual packages so combat has
+> no campaign dependency at the module level.
+
+---
+
+## Problem
+
+`@its-not-rocket-science/ananke` ships 41 subpath exports in a single package.
+A host that only needs tactical combat transitively depends on feudal succession,
+epidemic simulation, and monetary policy.  A renderer integration author has no
+clean way to depend only on the bridge layer.
+
+---
+
+## Package Overview
+
+| Package | Stability | Description | Key entry point(s) |
+|---------|-----------|-------------|-------------------|
+| `@ananke/core` | **Stable** | Kernel, entity model, fixed-point units, RNG, replay | `"@ananke/core"` |
+| `@ananke/combat` | Experimental | Combat resolution, anatomy, grapple, ranged, competence | `"@ananke/combat"` |
+| `@ananke/campaign` | Experimental | World simulation — polity, economy, social, demography | `"@ananke/campaign"` |
+| `@ananke/content` | Experimental | Species, equipment catalogue, archetypes, crafting | `"@ananke/content"` |
+| `@ananke/bridge` | Experimental | Renderer bridge, interpolation, animation hints *(Phase 2)* | `"@ananke/bridge"` |
+| `@its-not-rocket-science/ananke` | **Meta-package** | Re-exports all of the above for backwards compatibility | unchanged |
+
+> `@ananke/bridge` is not yet a standalone stub — bridge exports are part of
+> `@ananke/core` until Phase 2 adds a dedicated `"./bridge"` subpath to the
+> monolith.
+
+---
+
+## Package Dependency Graph
+
+```
+@ananke/core
+    │
+    ├── @ananke/combat      (peer: @ananke/core)
+    ├── @ananke/campaign    (peer: @ananke/core)
+    ├── @ananke/content     (peer: @ananke/core)
+    └── @ananke/bridge      (peer: @ananke/core)   [Phase 2]
+
+@its-not-rocket-science/ananke  (meta: re-exports all four)
+```
+
+---
+
+## Monolith Subpath → Package Mapping
+
+### @ananke/core
+
+| Monolith subpath | Notes |
+|-----------------|-------|
+| `"."` | Entire main export — kernel, entity, units, RNG, replay, bridge |
+
+### @ananke/combat
+
+| Monolith subpath | Notes |
+|-----------------|-------|
+| `"./combat"` | resolveHit, resolveBlock, CombatContext |
+| `"./anatomy"` | BodyPlan, AnatomyRegion, injury regions |
+| `"./competence"` | skill contest resolution, interspecies signalling |
+| `"./wasm-kernel"` | WASM-accelerated combat math |
+
+### @ananke/campaign
+
+| Monolith subpath | Notes |
+|-----------------|-------|
+| `"./campaign"` | Campaign layer, strategic tick |
+| `"./polity"` | Polity, stepPolityDay, tech diffusion |
+| `"./social"` | Social relationships, dialogue |
+| `"./narrative"` | Narrative event system |
+| `"./narrative-prose"` | Prose generation |
+| `"./renown"` | Fame and reputation |
+| `"./kinship"` | Family trees, genealogy |
+| `"./succession"` | Inheritance rules |
+| `"./calendar"` | In-world calendar and date tracking |
+| `"./feudal"` | Feudal hierarchy |
+| `"./diplomacy"` | Treaties and diplomatic acts |
+| `"./migration"` | Population movement |
+| `"./espionage"` | Espionage and spycraft |
+| `"./trade-routes"` | Trade route simulation |
+| `"./siege"` | Siege warfare mechanics |
+| `"./faith"` | Religion and doctrine |
+| `"./demography"` | Population simulation |
+| `"./granary"` | Food storage and distribution |
+| `"./epidemic"` | Disease spread |
+| `"./infrastructure"` | Buildings and construction |
+| `"./unrest"` | Civil unrest |
+| `"./research"` | Technology research |
+| `"./taxation"` | Tax collection |
+| `"./military-campaign"` | Military campaign mechanics |
+| `"./governance"` | Governance and edicts |
+| `"./resources"` | Resource management |
+| `"./climate"` | Climate and weather effects |
+| `"./famine"` | Famine simulation |
+| `"./containment"` | Disease containment |
+| `"./mercenaries"` | Mercenary companies |
+| `"./wonders"` | Wonders and monuments |
+| `"./monetary"` | Monetary policy and currency |
+
+### @ananke/content
+
+| Monolith subpath | Notes |
+|-----------------|-------|
+| `"./species"` | Species definitions, stat profiles |
+| `"./catalog"` | Equipment and item catalogue |
+| `"./character"` | Character generation and archetypes |
+| `"./crafting"` | Crafting recipes, workshops, manufacturing |
+
+---
+
+## Source File → Package Mapping (Phase 2 migration)
+
+### @ananke/core
+```
+src/units.ts
+src/rng.ts
+src/types.ts
+src/replay.ts
+src/sim/entity.ts
+src/sim/kernel.ts
+src/sim/seeds.ts
+src/sim/world.ts
+src/sim/kinds.ts
+src/sim/condition.ts
+src/sim/body.ts
+src/sim/bodyplan.ts
+src/sim/limb.ts
+src/sim/tick.ts
+src/sim/indexing.ts
+src/sim/events.ts
+src/sim/commands.ts
+src/sim/commandBuilders.ts
+src/sim/context.ts
+src/sim/intent.ts
+src/sim/vec3.ts
+src/sim/spatial.ts
+src/sim/skills.ts
+src/sim/traits.ts
+src/sim/terrain.ts
+src/sim/action.ts
+src/sim/step/           (all 10 step files)
+src/bridge/             (all 5 bridge files)
+src/presets.ts
+src/generate.ts
+src/derive.ts
+src/describe.ts
+src/traits.ts
+src/metrics.ts
+src/dist.ts
+src/wasm-kernel.ts
+```
+
+### @ananke/combat
+```
+src/sim/combat.ts
+src/sim/injury.ts
+src/sim/wound-aging.ts
+src/sim/medical.ts
+src/sim/morale.ts
+src/sim/grapple.ts
+src/sim/ranged.ts
+src/sim/stamina.ts      (if present)
+src/sim/impairment.ts
+src/sim/knockback.ts
+src/sim/cover.ts
+src/sim/cone.ts
+src/sim/formation.ts
+src/sim/formation-combat.ts
+src/sim/formation-unit.ts
+src/sim/frontage.ts
+src/sim/density.ts
+src/sim/occlusion.ts
+src/sim/ai/             (all 8 AI files)
+src/combat.ts
+src/equipment.ts
+src/weapons.ts
+src/anatomy/            (all 5 anatomy files)
+src/competence/         (all 13 competence files)
+src/arena.ts
+src/dialogue.ts
+src/party.ts
+src/faction.ts
+src/downtime.ts
+```
+
+### @ananke/campaign
+```
+src/campaign.ts
+src/campaign-layer.ts
+src/polity.ts
+src/polity-vassals.ts
+src/social.ts
+src/relationships.ts
+src/relationships-effects.ts
+src/emotional-contagion.ts
+src/narrative.ts
+src/narrative-layer.ts
+src/narrative-prose.ts
+src/narrative-render.ts
+src/narrative-stress.ts
+src/story-arcs.ts
+src/quest.ts
+src/quest-generators.ts
+src/chronicle.ts
+src/legend.ts
+src/mythology.ts
+src/renown.ts
+src/kinship.ts
+src/succession.ts
+src/calendar.ts
+src/feudal.ts
+src/diplomacy.ts
+src/migration.ts
+src/espionage.ts
+src/trade-routes.ts
+src/siege.ts
+src/faith.ts
+src/demography.ts
+src/granary.ts
+src/epidemic.ts
+src/infrastructure.ts
+src/unrest.ts
+src/research.ts
+src/taxation.ts
+src/military-campaign.ts
+src/governance.ts
+src/resources.ts
+src/climate.ts
+src/famine.ts
+src/containment.ts
+src/mercenaries.ts
+src/wonders.ts
+src/monetary.ts
+src/collective-activities.ts
+src/economy.ts
+src/economy-gen.ts
+src/tech-diffusion.ts
+src/culture.ts
+src/settlement.ts
+src/settlement-services.ts
+src/channels.ts
+src/inheritance.ts
+src/progression.ts
+src/sim/disease.ts
+src/sim/aging.ts
+src/sim/sleep.ts
+src/sim/mount.ts
+src/sim/hazard.ts
+src/sim/nutrition.ts
+src/sim/thermoregulation.ts
+src/sim/toxicology.ts
+src/sim/systemic-toxicology.ts
+src/sim/substance.ts
+src/sim/weather.ts
+src/sim/biome.ts
+src/sim/tech.ts
+```
+
+### @ananke/content
+```
+src/species.ts
+src/catalog.ts
+src/character.ts
+src/archetypes.ts
+src/crafting/           (all 5 crafting files)
+src/inventory.ts
+src/item-durability.ts
+src/snapshot.ts
+src/world-generation.ts
+src/world-factory.ts
+src/scenario.ts
+src/modding.ts
+src/lod.ts
+src/model3d.ts
+```
+
+---
+
+## Phase 2: Source Migration Plan
+
+1. **Create workspace package directories** with their own `tsconfig.build.json`.
+2. **Move source files** from `src/` into `packages/NAME/src/` following the table above.
+3. **Update internal imports** — use `@ananke/core` etc. instead of relative paths that cross
+   package boundaries.
+4. **Wire inter-package dependencies** — `@ananke/combat` lists `@ananke/core` as a dependency.
+5. **Update the monolith meta-package** (`@its-not-rocket-science/ananke`) to re-export from
+   the five sub-packages instead of from `src/`.
+6. **Verify** that all existing tests pass without modification (test paths remain unchanged).
+
+The most complex step is (3) — identifying which imports cross package boundaries.  A planned
+tool (`tools/check-package-boundaries.ts`) will analyse the import graph and report violations.
+
+---
+
+## What Changes for Package Consumers
+
+### Phase 1 (now — stubs)
+```typescript
+// Before (monolith)
+import { resolveHit } from "@its-not-rocket-science/ananke/combat";
+
+// After (modular stub — same bundle size, cleaner import path)
+import { resolveHit } from "@ananke/combat";
+```
+
+### Phase 2 (source migration — smaller bundles)
+```typescript
+// Same import — but now @ananke/combat has no campaign dependency
+import { resolveHit } from "@ananke/combat";
+```
+
+The import path is the same in Phase 1 and Phase 2; only the bundle contents change.
+
+---
+
+## Backwards Compatibility
+
+`@its-not-rocket-science/ananke` will remain published indefinitely as a meta-package.
+All 41 subpath exports will continue to work.  Existing hosts do not need to migrate.

package/docs/project-overview.md

@@ -1161,9 +1161,11 @@ Map each `segmentId` to a skeleton bone and drive blend-shape or constraint weig
 **Integration note:** These functions provide data snapshots only.  Mapping Ananke's abstract
 segment IDs to a specific engine's skeleton, handling tick-rate mismatch (20 Hz → 60+ Hz), and
 wiring animation hints into a state machine are the host's responsibility.  See
-`docs/bridge-api.md` for the full API reference and `docs/ecosystem.md` for Unity/Godot adapter
-sketches.  A minimal runnable reference plugin (ROADMAP item 6) is the next priority for
-lowering this integration barrier.
+[`docs/bridge-contract.md`](bridge-contract.md) for the field-by-field contract and
+[`docs/integration-primer.md`](integration-primer.md) for worked integration code.  The
+[`ananke-godot-reference`](https://github.com/its-not-rocket-science/ananke-godot-reference)
+and [`ananke-unity-reference`](https://github.com/its-not-rocket-science/ananke-unity-reference)
+companion repos provide complete runnable reference plugins for Godot 4 and Unity 6.
 
 ---
 
@@ -2144,25 +2146,14 @@ suggested first milestone.
 | `ananke-historical-battles` | Historical battle validation suite comparing outcomes against primary sources |
 | `ananke-archive` | Searchable public database of simulation runs, parameter spaces, and raw trace data |
 
-### Companion ecosystem infrastructure (ROADMAP CE-1 to CE-4)
+### Companion ecosystem infrastructure — all complete
 
-The following Ananke-side changes are the highest-leverage items for enabling companion projects:
+ROADMAP items CE-1 through CE-4 are complete:
 
-**CE-1 — npm publish + subpath exports map.**  Remove `"private": true` from `package.json`,
-add a `"exports"` map so consumers can import `ananke/units`, `ananke/sim/kernel`, etc.
-without bundling the whole library.  See ROADMAP for proposed exports JSON.
-
-**CE-2 — `createWorld()` convenience factory.**  A single call that builds a `World` with
-sensible defaults (5 humans, no terrain, tactical tuning).  Eliminates 20 lines of setup
-boilerplate for companion projects that need a quick simulation harness.
-
-**CE-3 — JSON scenario schema + `loadScenario()`.**  Lets companion projects (especially
-`ananke-historical-battles` and `ananke-fantasy-species`) ship scenario definitions as JSON
-files rather than TypeScript, reducing the barrier to non-developer contribution.
-
-**CE-4 — `src/index.ts` stable-API barrel.**  A single import surface (`import { ... } from "ananke"`)
-covering everything in `STABLE_API.md`.  Companion projects should depend on this barrel, not
-on internal module paths that may change.
+- **CE-1** — Package published as `@its-not-rocket-science/ananke` with 41 named subpath exports.
+- **CE-2** — `createWorld()` convenience factory ships in `src/sim/world.ts`.
+- **CE-3** — JSON scenario schema and `loadScenario()` in `src/sim/world.ts`.
+- **CE-4** — `src/index.ts` stable-API barrel covers everything in `STABLE_API.md`.
 
 ---
 
@@ -2203,25 +2194,23 @@ Agincourt, Roman testudo vs. Gaul charge, small-unit skirmish attrition, epidemi
 each run across 100 seeds.  The distribution of outcomes is compared against historical
 casualty data.  Run with `npm run run:emergent-validation`.
 
-Results from both suites are committed to `docs/` and linked from releases.  See ROADMAP
-item PH-8 for the plan to make these first-class trust artifacts.
+Results from both suites are committed to `docs/` and linked from releases.  See [`docs/emergent-validation-report.md`](emergent-validation-report.md) for the committed result summaries.
 
 ---
 
-## Next steps — Platform Hardening
+## Platform Hardening — all complete
 
-The simulation is architecturally complete.  The highest-leverage remaining work is making
-the existing depth trustworthy and legible to adopters:
+ROADMAP items PH-1 through PH-8 are complete as of 2026-03-19:
 
 | Item | What | Status |
 |------|------|--------|
-| PH-1 | API tiering — Stable / Advanced / Internal tiers in exports and docs | Planned |
-| PH-2 | Versioning policy unification — one unambiguous adopter contract | Planned |
-| PH-3 | Minimal host integration contract document | Planned |
-| PH-4 | Save / replay / bridge contract tests — golden compatibility fixtures | Planned |
-| PH-5 | Bridge as first-class supported surface — `docs/bridge-contract.md` | Planned |
-| PH-6 | Entity / WorldState core vs. extensions split — JSDoc annotations | Planned |
-| PH-7 | Benchmark operational guide — tick-rate and entity-cap recommendations | Planned |
-| PH-8 | Emergent validation as flagship trust artifact — versioned, CI-enforced | Planned |
-
-See ROADMAP `## Platform Hardening` for full scope of each item.
+| PH-1 | API tiering — Stable / Advanced / Internal tiers in exports and docs | **Complete** |
+| PH-2 | Versioning policy unification — one unambiguous adopter contract | **Complete** |
+| PH-3 | Minimal host integration contract document | **Complete** |
+| PH-4 | Save / replay / bridge contract tests — golden compatibility fixtures | **Complete** |
+| PH-5 | Bridge as first-class supported surface — `docs/bridge-contract.md` | **Complete** |
+| PH-6 | Entity / WorldState core vs. extensions split — JSDoc annotations | **Complete** |
+| PH-7 | Benchmark operational guide — tick-rate and entity-cap recommendations | **Complete** |
+| PH-8 | Emergent validation as flagship trust artifact — versioned, CI-enforced | **Complete** |
+
+See `ROADMAP.md` → `## Platform Hardening` for the full scope of each item.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -172,6 +172,9 @@
       "types": "./dist/src/monetary.d.ts"
     }
   },
+  "workspaces": [
+    "packages/*"
+  ],
   "files": [
     "dist/src",
     "dist/as",
@@ -182,6 +185,8 @@
     "docs/performance.md",
     "docs/versioning.md",
     "docs/emergent-validation-report.md",
+    "docs/package-architecture.md",
+    "docs/migration-monolith-to-modular.md",
     "CHANGELOG.md",
     "STABLE_API.md"
   ],
@@ -226,6 +231,7 @@
     "example:combat": "node dist/examples/quickstart-combat.js",
     "example:campaign": "node dist/examples/quickstart-campaign.js",
     "example:species": "node dist/examples/quickstart-species.js",
+    "generate-module-index": "node dist/tools/generate-module-index.js",
     "generate-fixtures": "node dist/tools/generate-fixtures.js",
     "generate-zoo": "node dist/tools/generate-zoo.js",
     "generate-playground": "node dist/tools/generate-playground.js",