@its-not-rocket-science/ananke 0.1.48 → 0.1.50

package/CHANGELOG.md

@@ -6,6 +6,35 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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.
+
+### 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 %.
+
+---
+
 ## [0.1.48] — 2026-03-28
 
 ### Fixed

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/dist/src/crafting/index.js

@@ -199,7 +199,7 @@ export function integrateCraftingIntoInventory(inventory, result, instanceId) {
         instanceId,
         templateId: result.outputItemId,
         quantity: result.outputQuantity,
-        durability_Q: result.quality_Q, // Use quality as durability placeholder
+        durability_Q: result.quality_Q, // New items start with durability matching their crafting quality
         modifications: [],
         containerPath: [],
     };

package/dist/src/crafting/manufacturing.js

@@ -112,16 +112,20 @@ function updateQualityRange(currentRange) {
  * Create assembly steps for a complex recipe.
  */
 export function createAssemblySteps(recipe) {
-    // Placeholder: generate steps based on recipe complexity
     const steps = [];
     const stepCount = Math.max(1, Math.round(recipe.complexity_Q / q(0.30)));
+    // Derive skills and tools from recipe requirements
+    const skillTypes = recipe.skillRequirements.length > 0
+        ? recipe.skillRequirements.map(sr => sr.skillType)
+        : ["bodilyKinesthetic", "logicalMathematical"];
+    const toolCategories = recipe.toolRequirements.map(tr => tr.toolCategory);
     for (let i = 0; i < stepCount; i++) {
         steps.push({
             stepId: `step_${i}`,
             description: `Step ${i + 1}`,
-            requiredSkill: i % 2 === 0 ? "bodilyKinesthetic" : "logicalMathematical",
+            requiredSkill: skillTypes[i % skillTypes.length],
             timeFraction: Math.round(SCALE.Q / stepCount),
-            toolRequirements: i === 0 ? ["forge"] : [],
+            toolRequirements: i === 0 && toolCategories.length > 0 ? [toolCategories[0]] : [],
         });
     }
     return steps;

package/dist/src/crafting/recipes.js

@@ -196,7 +196,7 @@ export function resolveRecipe(recipe, entity, inventory, availableToolQualities,
     const timeTaken_s = Math.round(time_s * q(0.50) / (skillBonus > 0 ? skillBonus : q(0.50)));
     // Determine descriptor
     const descriptor = qualityToDescriptor(quality_Q);
-    // Consume ingredients (placeholder)
+    // Build consumed ingredients list (actual inventory mutation is handled by the caller)
     const consumedIngredients = recipe.ingredients.map(ing => ({
         itemId: ing.itemId,
         quantity: ing.quantity,

package/dist/src/dialogue.d.ts

@@ -49,7 +49,8 @@ export type DialogueOutcome = {
 /**
  * Context for a dialogue resolution.
  *
- * `sharedFaction` — Phase 24 placeholder; set to true when entities share a faction.
+ * `sharedFaction` — when true, applies a `PERSUADE_FACTION_BONUS` to persuasion rolls;
+ *   set by the host when entities belong to the same faction.
  * `priorFailedAttempts` — cumulative failed persuasion attempts by this initiator against
  *   this target; each one imposes a PERSUADE_FAILURE_PENALTY.
  */

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/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.48",
+  "version": "0.1.50",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -226,6 +226,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",