@its-not-rocket-science/ananke 0.1.67 → 0.1.69

package/CHANGELOG.md

@@ -6,6 +6,44 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.69] — 2026-04-01
+
+### Added
+
+- **PM-10 — Maintenance Budget Roadmap (complete):**
+  - `docs/maintenance-policy.md` (new): standing maintenance commitments covering:
+    - **Docs reconciliation** — `generate-module-index` + `generate-recipes-matrix` must match committed files before every release.
+    - **Issue triage cadence** — P0 (regression) same day; P1 (correctness) within one week; P2 (enhancement) roadmap-tracked; P3 (docs) best-effort.
+    - **Migration maintenance** — every minor version bump that changes a `@core` field must ship a registered migration in `src/schema-migration.ts`.
+    - **SDK parity policy** — Unity, Godot, and Web sidecars must update to the current `BRIDGE_SCHEMA_VERSION` within one minor release.
+    - **Example and corpus upkeep** — all `examples/` compile cleanly; `npm run verify-corpus` passes on every release.
+    - **Content-pack schema evolution** — minor bumps are backward-compatible; major bumps ship a migration tool.
+    - **Coverage floor** — statements 90%, branches 80%, functions 85%, lines 90%.
+    - **Deprecation budget** — no more than 10 symbols in deprecated state at once.
+  - `docs/maintenance-checklist.md` (new): per-release preparation checklist (10 sections, 30 items) operationalising the policy; includes a hotfix fast-path for P0 regressions.
+  - Link added to `README.md` Further Reading table.
+- 0 new tests (5,593 total). Coverage: 97.06%/88.06%/95.83%/97.06%. Build: clean.
+
+---
+
+## [0.1.68] — 2026-04-01
+
+### Added
+
+- **PM-9 — Core Guarantees Technical Paper (complete):**
+  - `docs/core-guarantees.md` (new): concise, self-contained reference covering Ananke's full guarantee surface:
+    1. **Fixed-point determinism** — the guarantee, how it is enforced (integer arithmetic, no `Math.random()`, insertion-order iteration, corpus hash CI), and what can break it.
+    2. **API stability tiers** — what "breaking" means for Tier 1, the pre-1.0 note, and the deprecation lifecycle.
+    3. **Schema and wire contracts** — world-state hash, replay format, content-pack checksum, semver range enforcement.
+    4. **Validation philosophy** — three claim types: Empirical (source-bounded), Plausibility (first-principles), and Content-layer (definitional).
+    5. **Benchmark methodology** — what the numbers mean and do not mean; how to detect correctness vs. performance regressions.
+    6. **Known limits** — floating-point interop boundary, JS engine version portability, host clock independence, entity count scalability, numerical overflow handling.
+  - Each claim is labelled **Engineering claim**, **Empirical claim**, or **Design principle**.
+  - Links added to `README.md` Further Reading table and `STABLE_API.md` intro.
+- 0 new tests (5,593 total). Coverage: 97.06%/88.06%/95.83%/97.06%. Build: clean.
+
+---
+
 ## [0.1.67] — 2026-04-01
 
 ### Added

package/README.md

@@ -420,6 +420,8 @@ Ananke's outputs are validated against historical and experimental sources:
 | [`docs/cookbook.md`](docs/cookbook.md) | Task-oriented recipes — duel, 500-agent battle, species, renderer, campaign, replay, and more |
 | [`corpus/README.md`](corpus/README.md) | Scenario corpus — 5 canonical deterministic scenarios (tutorial, benchmark, validation, networking, bridge); run `npm run verify-corpus` |
 | [`docs/module-index.md`](docs/module-index.md) | All 41 entry points — stability tier, use case, key exports, doc links |
+| [`docs/core-guarantees.md`](docs/core-guarantees.md) | Core guarantees — determinism contract, API stability, validation philosophy, known limits |
+| [`docs/maintenance-policy.md`](docs/maintenance-policy.md) | Maintenance commitments — docs reconciliation, issue triage, SDK parity, deprecation budget |
 | [`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/STABLE_API.md

@@ -3,6 +3,8 @@
 This document defines the three stability tiers for Ananke's public API surface.
 See [`docs/versioning.md`](docs/versioning.md) for the full versioning policy, upgrade
 cadence, and commit-hash pinning guide.
+See [`docs/core-guarantees.md`](docs/core-guarantees.md) for the full determinism contract,
+validation philosophy, benchmark methodology, and known limits.
 
 ---
 

package/dist/src/content-pack.d.ts

@@ -1,6 +1,6 @@
 import type { WorldState } from "./sim/world.js";
 /** Current Ananke engine version — used to evaluate pack compatRange at runtime. */
-export declare const ANANKE_ENGINE_VERSION = "0.1.67";
+export declare const ANANKE_ENGINE_VERSION = "0.1.69";
 /** A single actionable validation failure from `validatePack`. */
 export interface PackValidationError {
     /** JSONPath-style location, e.g. `"$.weapons[2].mass_kg"`. */

package/dist/src/content-pack.js

@@ -16,7 +16,7 @@ import { registerWorldArchetype, registerWorldItem } from "./world-factory.js";
 // ── Version constant ──────────────────────────────────────────────────────────
 // Must be kept in sync with package.json "version" field.
 /** Current Ananke engine version — used to evaluate pack compatRange at runtime. */
-export const ANANKE_ENGINE_VERSION = "0.1.67";
+export const ANANKE_ENGINE_VERSION = "0.1.69";
 // ── Semver utilities ──────────────────────────────────────────────────────────
 // Lightweight range evaluator — no external dependencies.
 // Supports: >=X.Y.Z  >X.Y.Z  <=X.Y.Z  <X.Y.Z  =X.Y.Z  ^X.Y.Z  ~X.Y.Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.67",
+  "version": "0.1.69",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",