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

package/docs/world-evolution-engine.md

@@ -0,0 +1,150 @@
+# World Evolution Engine Integrator Guide
+
+## Intended audience
+
+This guide is for **host-platform integrators** (game backend engineers, simulation platform engineers, and tooling teams) who need deterministic, long-horizon world progression with explicit adapter boundaries.
+
+If you are building direct game logic on top of the root Tier-1 API, this is likely not your first stop.
+
+## Import path and stability tier
+
+Preferred additive subpath:
+
+```ts
+import {
+  runWorldEvolution,
+  toWorldEvolutionRunRequest,
+  buildEvolutionTimeline,
+} from "@its-not-rocket-science/ananke/world-evolution-engine";
+```
+
+Stability status:
+
+- Root (`@its-not-rocket-science/ananke`) remains the only **Tier-1 stable** contract.
+- `@its-not-rocket-science/ananke/world-evolution-engine` is a **shipped, non-Tier-1 additive subpath**.
+- `@its-not-rocket-science/ananke/world-evolution-backend` remains supported as a compatibility alias.
+
+## Minimal integration path
+
+1. Construct host data using `WorldEvolutionInput`.
+2. Convert to a deterministic run request via `toWorldEvolutionRunRequest(...)`.
+3. Execute `runWorldEvolution(...)`.
+4. Optionally project run output into host UI timelines with `buildEvolutionTimeline(...)`.
+
+```ts
+import {
+  toWorldEvolutionRunRequest,
+  runWorldEvolution,
+  buildEvolutionTimeline,
+  type WorldEvolutionInput,
+} from "@its-not-rocket-science/ananke/world-evolution-engine";
+
+const hostInput: WorldEvolutionInput = {
+  worldSeed: 1337,
+  entities: [
+    { kind: "polity", id: "p.alpha", name: "Alpha", population: 120_000, treasury_cu: 40_000 },
+    { kind: "polity", id: "p.beta", name: "Beta", population: 80_000, treasury_cu: 35_000 },
+  ],
+};
+
+const runRequest = toWorldEvolutionRunRequest(hostInput, 30, {
+  includeDeltas: true,
+  checkpointInterval: 10,
+});
+
+const result = runWorldEvolution(runRequest);
+const timeline = buildEvolutionTimeline(result, { includeSummaryText: true });
+```
+
+## Schema expectations
+
+- Host ingress contract: `WorldEvolutionInput`.
+- Adapter normalization/validation:
+  - `validateWorldEvolutionInput(...)` for deterministic, path-addressed errors.
+  - `normalizeHostWorldInput(...)` for canonical sorting.
+- Canonical schema versions:
+  - host input schema: `ananke.host-world-evolution-input.v1`
+  - backend snapshot schema: `ananke.world-evolution-backend.v1`
+- JSON Schema for host validation: `schema/world-evolution-input.schema.json`.
+
+## Determinism guarantees
+
+For identical:
+
+- normalized input payload,
+- seed,
+- profile + overrides,
+- step count,
+- and engine version,
+
+the engine produces deterministic outputs (snapshot/timeline/metrics/deltas/checkpoints).
+
+Determinism is supported by:
+
+- explicit fixed subsystem order,
+- sorted iteration over IDs,
+- fixed-point simulation primitives,
+- no `Math.random` in the world-evolution step pipeline.
+
+## Checkpointing and branching model
+
+- `runWorldEvolution(...)` supports periodic checkpoints via `checkpointInterval`.
+- Session/branch orchestration remains in `@its-not-rocket-science/ananke/world-evolution`.
+- Typical flow:
+  - evolve with checkpoints,
+  - persist checkpoint payloads,
+  - resume/fork using orchestration APIs,
+  - diff branch output against base for host dashboards.
+
+This separation keeps the engine focused on deterministic stepping while orchestration handles lifecycle concerns.
+
+## First-hour integrator example
+
+See:
+
+- `examples/world-evolution-engine-first-hour.ts`
+
+It shows:
+
+- host-input normalization + validation,
+- deterministic run configuration,
+- timeline projection,
+- checkpoint emission,
+- and a lightweight deterministic re-run sanity check.
+
+## Optional host-backend facade
+
+For hosts that want a single higher-level wrapper combining adapter + deterministic run + orchestration helpers, use:
+
+```ts
+import { runHostDeterministicEvolution } from "@its-not-rocket-science/ananke/world-evolution-host-backend";
+```
+
+See `docs/world-evolution-host-backend.md` for lifecycle wrappers (session/checkpoint resume/branch what-if).
+
+
+## Reproducibility fingerprints (additive)
+
+Use deterministic fingerprints to verify replay identity across hosts, caches, and audit logs.
+
+```ts
+import {
+  buildEvolutionRunReproducibilityRecord,
+  runWorldEvolution,
+  toWorldEvolutionRunRequest,
+} from "@its-not-rocket-science/ananke/world-evolution-engine";
+
+const hostInput = {
+  worldSeed: 1337,
+  entities: [],
+};
+
+const request = toWorldEvolutionRunRequest(hostInput, 30, {
+  includeDeltas: true,
+  checkpointInterval: 10,
+});
+const result = runWorldEvolution(request);
+const proof = buildEvolutionRunReproducibilityRecord(request, result);
+
+// proof.requestFingerprint and proof.outputDigest are stable 8-hex hashes
+```

package/docs/world-evolution-host-backend.md

@@ -0,0 +1,70 @@
+# World Evolution Host Backend (Additive Facade)
+
+## Why this exists
+
+`@its-not-rocket-science/ananke/world-evolution-host-backend` is an additive integration facade for external host platforms (e.g. OpenWorldBuilder-style generators) that want a single deterministic call path without bypassing existing authoritative subsystems.
+
+It **does not replace** core modules. It composes:
+
+- host schema adapter + validator (`world-evolution-backend`)
+- deterministic step engine (`world-evolution-backend`)
+- session/checkpoint/branch orchestration (`world-evolution`)
+
+## Stability boundary
+
+- Root Tier-1 API (`@its-not-rocket-science/ananke`) remains unchanged.
+- This facade is a dedicated additive subpath for host integrations.
+- Existing backend/orchestration APIs remain authoritative and fully usable directly.
+
+## Architecture (composition points)
+
+1. Host input enters as `WorldEvolutionInput`.
+2. `normalizeHostWorldInput` / `toAnankeEvolutionState` canonicalize and validate deterministically.
+3. `toWorldEvolutionRunRequest` maps host input into canonical evolution snapshots.
+4. `runWorldEvolution` executes deterministic N-step simulation.
+5. `buildEvolutionTimeline` projects host-friendly timeline/history events.
+6. Optional orchestration wrappers expose:
+   - sessions
+   - checkpoints/resume
+   - branch sandbox runs
+
+This keeps deterministic simulation logic in existing subsystem modules while providing a smaller host-facing operational surface.
+
+## Example import
+
+```ts
+import {
+  runHostDeterministicEvolution,
+  createHostEvolutionSession,
+  runHostEvolutionSession,
+  resumeHostEvolutionSessionFromCheckpoint,
+  createHostEvolutionBranch,
+  runHostEvolutionBranch,
+} from "@its-not-rocket-science/ananke/world-evolution-host-backend";
+```
+
+## Reproducibility contract
+
+For identical normalized host input + ruleset/profile + seed + steps + engine version, outputs are deterministic:
+
+- final snapshot
+- timeline/history projection
+- metrics
+- deltas/checkpoints (when enabled)
+
+Resume and branch flows preserve deterministic behavior because they route through existing checkpoint and branch orchestration primitives.
+
+
+### Replay proof helper
+
+If hosts need a single call that includes deterministic replay proof metadata, use:
+
+- `runHostDeterministicEvolutionWithReplayProof(...)`
+
+It returns the same data as `runHostDeterministicEvolution(...)` plus:
+
+- `reproducibility.requestFingerprint`
+- `reproducibility.outputDigest`
+
+Both values are deterministic for the same normalized run request/output and are intended for traceability/caching checks.
+

package/docs/world-evolution-orchestration.md

@@ -0,0 +1,248 @@
+# World Evolution Orchestration API (Host-facing)
+
+## Purpose
+
+The orchestration API adds a session-oriented host surface on top of existing deterministic world subsystems. It is designed for external tools (for example OpenWorldBuilder) that need both:
+
+- one-shot evolution runs
+- stepwise evolution loops with checkpoints/timelines
+
+It is additive and uses the existing world-evolution backend as the deterministic subsystem pipeline.
+
+## Import path
+
+```ts
+import {
+  createEvolutionSession,
+  createEvolutionBranch,
+  forkEvolutionBranch,
+  runEvolutionOnBranch,
+  diffBranchAgainstBase,
+  runEvolution,
+  stepEvolution,
+  getEvolutionSummary,
+  resumeEvolutionSessionFromCheckpoint,
+  serializeEvolutionCheckpoint,
+  deserializeEvolutionCheckpoint,
+  serializeEvolutionIntermediateState,
+  serializeEvolutionFinalState,
+  buildEvolutionCheckpointDiffs,
+  serializeEvolutionResult,
+  deserializeEvolutionResult,
+} from "@its-not-rocket-science/ananke/world-evolution";
+```
+
+## Determinism contract
+
+For a fixed:
+
+- canonical input snapshot
+- ruleset
+- seed
+- step count
+- engine version (`ananke.world-evolution-backend.v1`)
+
+the API returns deterministic outputs.
+
+## Canonical vs derived state
+
+- `canonicalSnapshot` passed to `createEvolutionSession` is preserved as canonical input.
+- mutable simulation progression happens on an internal clone.
+- all returned snapshots/results are cloned host-safe copies.
+- `createEvolutionBranch(...)` keeps a `baseSnapshotRef` immutable and writes all branch progression to `derivedState`.
+
+## Canonical-vs-sandbox timelines for external platforms
+
+The branching surface is built for host platforms (worldbuilding tools, procedural generators, editor sandboxes) that need “what-if” simulation while preserving canonical truth.
+
+- Canonical world data stays untouched as the source of truth.
+- Each sandbox branch stores:
+  - `baseSnapshotRef` (immutable branch base checkpoint/snapshot/hash)
+  - `derivedState` (mutable branch-local simulation state)
+  - `branchMetadata`:
+    - `name`
+    - `description`
+    - `seed`
+    - `rulesetProfile`
+    - `createdAtStep`
+    - optional `parentBranchId`
+- Multiple timelines can be created from the same canonical snapshot, each with independent seed/ruleset/step progression.
+
+### Branch lifecycle
+
+1. Start from canonical snapshot:
+
+```ts
+import { createEvolutionBranch } from "@its-not-rocket-science/ananke/world-evolution";
+import type { WorldEvolutionSnapshot } from "@its-not-rocket-science/ananke/world-evolution-backend";
+
+declare const canonicalSnapshot: WorldEvolutionSnapshot;
+
+const branch = createEvolutionBranch({
+  baseSnapshot: canonicalSnapshot,
+  metadata: {
+    name: "alt-history: no treaty",
+    description: "stress-test a no-alliance variant",
+    seed: 1337,
+    rulesetId: "full_world_evolution",
+  },
+});
+```
+
+2. Run deterministic branch evolution:
+
+```ts
+import { createEvolutionBranch, runEvolutionOnBranch } from "@its-not-rocket-science/ananke/world-evolution";
+import type { WorldEvolutionSnapshot } from "@its-not-rocket-science/ananke/world-evolution-backend";
+
+declare const canonicalSnapshot: WorldEvolutionSnapshot;
+
+const branch = createEvolutionBranch({
+  baseSnapshot: canonicalSnapshot,
+  metadata: { name: "alt-history: no treaty", seed: 1337, rulesetId: "full_world_evolution" },
+});
+
+runEvolutionOnBranch(branch, { steps: 120, includeDeltas: true });
+```
+
+3. Fork additional sandboxes from any branch point:
+
+```ts
+import { createEvolutionBranch, forkEvolutionBranch } from "@its-not-rocket-science/ananke/world-evolution";
+import type { WorldEvolutionSnapshot } from "@its-not-rocket-science/ananke/world-evolution-backend";
+
+declare const canonicalSnapshot: WorldEvolutionSnapshot;
+
+const branch = createEvolutionBranch({
+  baseSnapshot: canonicalSnapshot,
+  metadata: { name: "alt-history: no treaty", seed: 1337, rulesetId: "full_world_evolution" },
+});
+
+const fork = forkEvolutionBranch(branch, {
+  metadata: { name: "alt-history: hard winter", seed: 7331 },
+});
+```
+
+4. Compute host-friendly canonical-vs-sandbox diffs:
+
+```ts
+import { createEvolutionBranch, diffBranchAgainstBase } from "@its-not-rocket-science/ananke/world-evolution";
+import type { WorldEvolutionSnapshot } from "@its-not-rocket-science/ananke/world-evolution-backend";
+
+declare const canonicalSnapshot: WorldEvolutionSnapshot;
+
+const branch = createEvolutionBranch({
+  baseSnapshot: canonicalSnapshot,
+  metadata: { name: "alt-history: no treaty", seed: 1337, rulesetId: "full_world_evolution" },
+});
+
+const diff = diffBranchAgainstBase(branch);
+// worldChanges + polityDeltas for dashboards/tools/review UIs
+```
+
+### Determinism and isolation guarantees
+
+- Same base snapshot + same seed + same ruleset + same step inputs => same branch result.
+- Branch state cannot mutate its `baseSnapshotRef`.
+- Branch execution does not mutate canonical host state.
+- Sibling branches remain isolated from each other.
+
+## Explicit pipeline ordering
+
+Each step uses the deterministic backend pipeline in this order:
+
+1. polity day (trade/war baseline)
+2. governance progression and tax effects
+3. diplomacy treaty updates
+4. trade route efficiency + trade application
+5. migration resolution + flow application
+6. climate event generation/aggregation/lifecycle
+7. epidemic progression and death pressure
+
+The ordering is fixed, iteration is sorted where needed, and no random host clock/source is used.
+
+## Host integration flow
+
+1. `createEvolutionSession(config)`
+2. evolve either with:
+   - `runEvolution(session, { steps })`, or
+   - repeated `stepEvolution(session)`
+3. call `getEvolutionSummary(session)` at any point
+4. archive run artifacts via `serializeEvolutionResult(result)` / `deserializeEvolutionResult(json)`
+
+## Checkpointing and resume for long-running jobs
+
+- Set `checkpointInterval` in `createEvolutionSession` and/or `runEvolution`.
+- Each checkpoint now includes deterministic metadata:
+  - `engineVersion`
+  - `seed`
+  - `rulesetProfile`
+  - `step`
+  - backend `schemaVersion`
+- Resume from a checkpoint with `resumeEvolutionSessionFromCheckpoint(checkpoint)`.
+- Compatibility validation is enforced on deserialize/resume:
+  - engine mismatch -> reject
+  - backend schema mismatch -> reject
+  - seed mismatch between metadata and snapshot -> reject
+
+### 1000-step host pattern (background worker)
+
+```ts
+import { runEvolution, serializeEvolutionCheckpoint } from "@its-not-rocket-science/ananke/world-evolution";
+import type { EvolutionSession } from "@its-not-rocket-science/ananke/world-evolution";
+
+declare const session: EvolutionSession;
+declare const hostStorage: { put(path: string, content: string): Promise<void> };
+declare const jobId: string;
+
+const result = runEvolution(session, {
+  steps: 1000,
+  checkpointInterval: 100,
+  includeCheckpointDiffs: true, // optional
+});
+
+const cp = result.checkpoints?.at(-1);
+if (cp) {
+  await hostStorage.put(`jobs/${jobId}/checkpoint.json`, serializeEvolutionCheckpoint(cp));
+}
+```
+
+On restart:
+
+```ts
+import {
+  deserializeEvolutionCheckpoint,
+  resumeEvolutionSessionFromCheckpoint,
+  runEvolution,
+} from "@its-not-rocket-science/ananke/world-evolution";
+
+declare const hostStorage: { get(path: string): Promise<string> };
+declare const jobId: string;
+declare const remainingSteps: number;
+
+const raw = await hostStorage.get(`jobs/${jobId}/checkpoint.json`);
+const checkpoint = deserializeEvolutionCheckpoint(raw);
+const resumed = resumeEvolutionSessionFromCheckpoint(checkpoint);
+runEvolution(resumed, { steps: remainingSteps, checkpointInterval: 100 });
+```
+
+### User-saveable sandbox branches
+
+For “save branch” UX in a sandbox/editor host:
+
+1. Persist `serializeEvolutionIntermediateState(session)` as the branch point.
+2. Resume branch sessions with `resumeEvolutionSessionFromCheckpoint(...)`.
+3. Optionally compare branch progression via `buildEvolutionCheckpointDiffs(...)`.
+4. Persist final branch states with `serializeEvolutionFinalState(...)`.
+
+## Types
+
+- `EvolutionSessionConfig`
+- `EvolutionRequest`
+- `EvolutionRuleset`
+- `EvolutionRunResult`
+- `EvolutionCheckpoint`
+- `EvolutionCheckpointMetadata`
+- `EvolutionCheckpointDiff`
+- `EvolutionTimelineEvent`
+- `EvolutionMetrics` (re-export of world metrics)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@its-not-rocket-science/ananke",
-  "version": "0.1.69",
+  "version": "0.5.1",
   "type": "module",
   "description": "Deterministic lockstep-friendly SI-units RPG/physics core (fixed-point TS)",
   "license": "MIT",
@@ -38,6 +38,10 @@
       "import": "./dist/src/campaign-layer.js",
       "types": "./dist/src/campaign-layer.d.ts"
     },
+    "./campaign-layer": {
+      "import": "./dist/src/campaign-layer.js",
+      "types": "./dist/src/campaign-layer.d.ts"
+    },
     "./social": {
       "import": "./dist/src/social.js",
       "types": "./dist/src/social.d.ts"
@@ -46,6 +50,10 @@
       "import": "./dist/src/narrative-layer.js",
       "types": "./dist/src/narrative-layer.d.ts"
     },
+    "./narrative-layer": {
+      "import": "./dist/src/narrative-layer.js",
+      "types": "./dist/src/narrative-layer.d.ts"
+    },
     "./anatomy": {
       "import": "./dist/src/anatomy/index.js",
       "types": "./dist/src/anatomy/index.d.ts"
@@ -178,10 +186,18 @@
       "import": "./dist/src/schema-migration.js",
       "types": "./dist/src/schema-migration.d.ts"
     },
+    "./schema-migration": {
+      "import": "./dist/src/schema-migration.js",
+      "types": "./dist/src/schema-migration.d.ts"
+    },
     "./content-pack": {
       "import": "./dist/src/content-pack.js",
       "types": "./dist/src/content-pack.d.ts"
     },
+    "./content": {
+      "import": "./dist/src/content/index.js",
+      "types": "./dist/src/content/index.d.ts"
+    },
     "./terrain-bridge": {
       "import": "./dist/src/terrain-bridge.js",
       "types": "./dist/src/terrain-bridge.d.ts"
@@ -205,6 +221,38 @@
     "./conformance": {
       "import": "./dist/src/conformance.js",
       "types": "./dist/src/conformance.d.ts"
+    },
+    "./tier2": {
+      "import": "./dist/src/tier2.js",
+      "types": "./dist/src/tier2.d.ts"
+    },
+    "./tier3": {
+      "import": "./dist/src/tier3.js",
+      "types": "./dist/src/tier3.d.ts"
+    },
+    "./data-governance": {
+      "import": "./dist/src/data-governance.js",
+      "types": "./dist/src/data-governance.d.ts"
+    },
+    "./world-evolution-backend": {
+      "import": "./dist/src/world-evolution-backend/index.js",
+      "types": "./dist/src/world-evolution-backend/index.d.ts"
+    },
+    "./world-evolution": {
+      "import": "./dist/src/world-evolution.js",
+      "types": "./dist/src/world-evolution.d.ts"
+    },
+    "./world-evolution-engine": {
+      "import": "./dist/src/world-evolution-backend/public.js",
+      "types": "./dist/src/world-evolution-backend/public.d.ts"
+    },
+    "./world-evolution-host-backend": {
+      "import": "./dist/src/world-evolution-host-backend.js",
+      "types": "./dist/src/world-evolution-host-backend.d.ts"
+    },
+    "./session": {
+      "import": "./dist/src/session.js",
+      "types": "./dist/src/session.d.ts"
     }
   },
   "workspaces": [
@@ -219,21 +267,41 @@
     "docs/host-contract.md",
     "docs/integration-primer.md",
     "docs/bridge-contract.md",
+    "docs/plugins/README.md",
+    "docs/plugins/hooks.md",
+    "docs/plugins/publishing.md",
+    "docs/plugins/security-model.md",
     "docs/performance.md",
+    "docs/release-dashboard.md",
     "docs/versioning.md",
+    "docs/world-evolution-backend.md",
+    "docs/world-evolution-orchestration.md",
+    "docs/session-api.md",
     "docs/emergent-validation-report.md",
+    "docs/completion-evidence-dashboard.md",
+    "docs/trust-dashboard.md",
     "docs/package-architecture.md",
     "docs/migration-monolith-to-modular.md",
     "docs/wire-protocol.md",
     "schema/world.schema.json",
     "schema/replay.schema.json",
     "schema/pack.schema.json",
+    "schema/content-pack.schema.json",
+    "schema/plugin.schema.json",
     "CHANGELOG.md",
-    "STABLE_API.md"
+    "STABLE_API.md",
+    "docs/stable-api-manifest.json",
+    "docs/host-world-evolution-schema.md",
+    "schema/world-evolution-input.schema.json",
+    "docs/world-evolution-engine.md",
+    "docs/world-evolution-host-backend.md"
   ],
   "engines": {
     "node": ">=18"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/its-not-rocket-science/ananke.git"
@@ -248,12 +316,13 @@
     "game-engine"
   ],
   "scripts": {
+    "release": "bash scripts/tag-release.sh",
     "prepublishOnly": "npm run build && npm run test:coverage && npm run audit-deprecations -- --check",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "npm run sync-version && tsc -p tsconfig.build.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "ci": "npm run build && npm run test:coverage && npm run check-boundaries",
+    "ci": "npm run check-version-sync && npm run build && npm run test:coverage && npm run check-boundaries && npm run check-stable-api && npm run check-maturity-evidence && npm run check-trust-dashboard-artifacts && npm run check-public-contract && npm run check-export-status-matrix && npm run check:docs",
     "release-check": "node dist/tools/release-check.js",
     "release-check:quick": "node dist/tools/release-check.js --quick",
     "check-boundaries": "node dist/tools/check-package-boundaries.js",
@@ -285,6 +354,8 @@
     "ref:species-lab:quick": "node dist/examples/reference/species-lab/index.js --quick",
     "generate-module-index": "node dist/tools/generate-module-index.js",
     "generate-recipes-matrix": "node dist/tools/generate-recipes-matrix.js",
+    "generate-release-dashboard": "node tools/generate-release-dashboard.mjs --write",
+    "check-release-dashboard": "node tools/generate-release-dashboard.mjs --check",
     "generate-conformance-fixtures": "node dist/tools/generate-conformance-fixtures.js",
     "conformance-runner": "node dist/tools/conformance-runner.js",
     "generate-corpus": "node dist/tools/generate-corpus.js",
@@ -308,8 +379,56 @@
     "build:wasm": "asc as/units.ts --outFile dist/as/units.wasm --textFile dist/as/units.wat --runtime stub --optimize",
     "build:wasm:push": "asc as/push.ts --outFile dist/as/push.wasm --textFile dist/as/push.wat --runtime stub --optimize --initialMemory 1",
     "build:wasm:injury": "asc as/injury.ts --outFile dist/as/injury.wasm --textFile dist/as/injury.wat --runtime stub --optimize --initialMemory 1",
-    "build:wasm:all": "npm run build:wasm && npm run build:wasm:push && npm run build:wasm:injury",
-    "test:wasm": "npm run build:wasm:all && vitest run test/as/"
+    "build:wasm:all": "npm run build:wasm && npm run build:wasm:push && npm run build:wasm:injury && npm run build:wasm:core",
+    "test:wasm": "npm run build:wasm:all && vitest run test/as/",
+    "check-stable-api": "node dist/tools/check-stable-api.js",
+    "check-boundaries:report": "node dist/tools/check-package-boundaries.js --report-md=docs/package-boundary-report.md",
+    "example:first-hour": "node dist/examples/guided-first-hour.js",
+    "check-maturity-evidence": "node tools/check-maturity-evidence.mjs",
+    "test:determinism": "npm run build:wasm:all && node tools/run-determinism-tests.mjs test/determinism/fuzz-against-wasm.spec.ts test/determinism/regression.spec.ts",
+    "test:determinism:nightly": "ANANKE_STRICT_DETERMINISM=1 DETERMINISM_WORLD_STATES=10000 DETERMINISM_COMMANDS_PER_STATE=1000 npm run test:determinism -- --seed=1337",
+    "test:determinism:ci": "ANANKE_STRICT_DETERMINISM=1 DETERMINISM_WORLD_STATES=2000 DETERMINISM_COMMANDS_PER_STATE=500 npm run test:determinism -- --seed=1337",
+    "benchmark:run": "node dist/tools/benchmark-dashboard/run.js",
+    "benchmark:history": "node dist/tools/benchmark-dashboard/publish-history.js",
+    "benchmark:dashboard": "node dist/tools/benchmark-dashboard/generate-dashboard.js",
+    "benchmark:budget": "node dist/tools/benchmark-dashboard/check-budget.js",
+    "extract-api-surface": "node dist/tools/api-surface.js --out=api/api-surface-v1.0.0.json",
+    "check-api-diff": "node dist/tools/api-diff-check.js --base=api-surface-main.json --head=api-surface-pr.json",
+    "check-semver": "node dist/tools/semver-check.js --baseSurface=api-surface-main.json --headSurface=api-surface-pr.json --basePackage=package-main.json --headPackage=package.json",
+    "build:wasm:core": "asc as/ananke-core.ts --outFile wasm/ananke-core.wasm --runtime stub --optimize --noAssert",
+    "benchmark": "node dist/tools/wasm-benchmark.js",
+    "docs:api": "npm run sync-version && node tools/generate-api-docs.mjs",
+    "check:beta-readiness": "node tools/check-beta-readiness.mjs --file=.github/beta-launch-readiness.json",
+    "run:proof-of-use": "node dist/tools/proof-of-use-stable.js",
+    "sync-version": "node tools/sync-version.mjs --write",
+    "check-version-sync": "node tools/sync-version.mjs --check",
+    "run:proof-of-use:extended": "node dist/tools/proof-of-use-extended.js",
+    "check-boundaries:strict-all": "node dist/tools/check-package-boundaries.js --strict-all",
+    "check-boundaries:ci": "node dist/tools/check-package-boundaries.js --report-md=docs/package-boundary-report.md --max-hard=84 --max-suspicious=60",
+    "ref:host-coherence": "node dist/examples/reference/host-coherence/index.js",
+    "ref:host-coherence:web": "node examples/reference/host-coherence/server.mjs",
+    "check-docs-tier1-imports": "node tools/check-docs-tier1-imports.mjs",
+    "check-doc-version-sync": "node tools/check-doc-version-sync.mjs",
+    "check-doc-ts-examples": "npm run check:doc-examples",
+    "check-public-contract": "node dist/tools/check-public-contract.js",
+    "check:doc-examples": "node dist/tools/check-doc-examples.js",
+    "generate-export-status-matrix": "node dist/tools/generate-export-status-matrix.js --write",
+    "check-export-status-matrix": "node dist/tools/generate-export-status-matrix.js --check",
+    "test:first-hour-smoke": "npm run build && node tools/first-hour-smoke.mjs",
+    "check-trust-dashboard-artifacts": "node dist/tools/generate-trust-dashboard.js --check",
+    "check:docs": "node dist/tools/check-doc-links-and-references.js && node dist/tools/check-doc-semantic-consistency.js && node dist/tools/check-doc-language.js",
+    "check-doc-semantic-consistency": "node dist/tools/check-doc-semantic-consistency.js",
+    "generate-trust-dashboard": "node dist/tools/generate-trust-dashboard.js --write",
+    "check-doc-language": "node dist/tools/check-doc-language.js",
+    "generate-ci-trust-report": "node tools/generate-ci-trust-report.mjs --output=docs/dashboard/ci-trust-report.json",
+    "check-trust-dashboard-main": "node dist/tools/generate-trust-dashboard.js --fail-on-unverified",
+    "generate-determinism-release-artifacts": "node tools/generate-determinism-release-artifacts.mjs --input=determinism-report/results.json --summary=docs/dashboard/determinism-release-status.json --matrix=docs/dashboard/determinism-matrix-summary.json --doc=docs/determinism-status.md",
+    "check-determinism-release-artifacts": "node tools/check-determinism-release-artifacts.mjs --summary=docs/dashboard/determinism-release-status.json",
+    "check-coverage-summary": "node tools/check-coverage-summary.mjs --input=coverage/coverage-summary.json",
+    "generate-coverage-status": "node tools/check-coverage-summary.mjs --input=coverage/coverage-summary.json --markdown-out=docs/dashboard/coverage-status.md",
+    "audit:repo-discipline": "node tools/audit-repo-discipline.mjs",
+    "example:session-embedding-minimal": "node dist/examples/session-embedding-minimal/index.js",
+    "generate-stub-pages": "node scripts/template.js"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.3",