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

package/CHANGELOG.md

@@ -6,6 +6,24 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [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,7 @@ 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/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.68";
 /** 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.68";
 // ── 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.68",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",