@its-not-rocket-science/ananke 0.1.46 → 0.1.47

package/CHANGELOG.md

@@ -6,6 +6,20 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [0.1.47] — 2026-03-27
+
+### Changed
+
+- **Lint clean-up (zero issues)** — eliminated all 574 ESLint errors and warnings across `src/` and `test/`:
+  - Replaced all `as any` casts with proper types (`as Q`, `as TechEra`, `as WonderType`, `as unknown as TypeName`, etc.)
+  - Removed unused imports and prefixed unused locals with `_` across 50+ test files
+  - Fixed `getAvailableMaterials` TODO in `src/crafting/materials.ts` — now accepts `readonly Material[]` and derives per-type totals
+  - Removed `@ts-nocheck` from `as/injury.ts`; applied `const` fixes and removed dead imports throughout `src/`
+- **UK English** — updated all comments, JSDoc, and documentation prose to British spelling (`armour`, `defence`, `behaviour`, `analyse`, `calibre`, `colour`); exported API identifiers unchanged
+- Build: clean. Tests: 5,261 passing. Coverage: statements 97.12 %, branches 87.87 %, functions 95.65 %, lines 97.12 %.
+
+---
+
 ## [0.1.46] — 2026-03-27
 
 ### Added
@@ -41,7 +55,7 @@ Versioning follows [Semantic Versioning](https://semver.org/).
   - `WonderEffects { stabilityBonus_Q, moraleBonus_Q, researchPointBonus, unrestReduction_Q, tradeIncomeBonus_Q, defenseBonus_Q, epidemicResistance_Q }` — advisory bundle.
   - `WONDER_BASE_COST_CU`: grand_library 150k → great_pyramid 1,000k cu.
   - `WONDER_TYPICAL_DAYS`: grand_library 180 → great_pyramid 3,650 days (10 years).
-  - `WONDER_BASE_EFFECTS`: distinct niches — great_wall highest defense (q(0.20)), grand_harbour highest trade (q(0.25)), aqueduct_system highest epidemic resistance (q(0.15)), colosseum highest unrest reduction (q(0.12)), grand_library +3 RP/day, great_pyramid highest stability (q(0.08)).
+  - `WONDER_BASE_EFFECTS`: distinct niches — great_wall highest defence (q(0.20)), grand_harbour highest trade (q(0.25)), aqueduct_system highest epidemic resistance (q(0.15)), colosseum highest unrest reduction (q(0.12)), grand_library +3 RP/day, great_pyramid highest stability (q(0.08)).
   - `WONDER_DAMAGED_EFFECT_MUL = q(0.50)` — damaged wonders provide half effects.
   - `WONDER_REPAIR_COST_FRAC = q(0.25)` — repair costs 25% of base construction cost.
   - `createWonderProject(projectId, polityId, type, startTick)` — factory.
@@ -781,15 +795,15 @@ Versioning follows [Semantic Versioning](https://semver.org/).
 - **CE-16 · Modding Support** (`src/modding.ts`)
   - Layer 1 — `hashMod(json)`: deterministic FNV-1a fingerprint (8-char hex) for any
     parsed JSON mod file; canonical key-sorted serialisation ensures order-independence.
-  - Layer 2 — Post-tick behavior hooks: `registerPostTickHook / unregisterPostTickHook /
+  - Layer 2 — Post-tick behaviour hooks: `registerPostTickHook / unregisterPostTickHook /
     runPostTickHooks / listPostTickHooks / clearPostTickHooks`; hooks fire after
     `stepWorld`, are purely observational (logging, analytics, renderer updates).
-  - Layer 3 — AI behavior node registry: `registerBehaviorNode / unregisterBehaviorNode /
+  - Layer 3 — AI behaviour node registry: `registerBehaviorNode / unregisterBehaviorNode /
     getBehaviorNode / listBehaviorNodes / clearBehaviorNodes`; custom `BehaviorNode`
-    factories registered by id for scenario and behavior-tree composition.
+    factories registered by id for scenario and behaviour-tree composition.
   - Session fingerprint: `computeModManifest(catalogIds)` returns sorted id lists and a
     single fingerprint covering all three layers for multiplayer client validation.
-  - `clearAllMods()` resets hooks and behavior nodes (catalog unchanged).
+  - `clearAllMods()` resets hooks and behaviour nodes (catalog unchanged).
   - 42 tests in `test/modding.test.ts`; exported via `src/index.ts`.
 
 - **CE-14 · Socio-Economic Campaign Layer → Stable Promotion**
@@ -884,7 +898,7 @@ Adding new **optional** fields to these interfaces is never a breaking change.
 
   - **CE-16 · Modding Support — HashMod, Post-tick Hooks, Behaviour Node Registry** (`src/parallel.ts`)
     - Three-layer modding contract: FNV-1a data fingerprinting, observational
-      post-tick hooks, and named AI behavior node factories. computeModManifest()
+      post-tick hooks, and named AI behaviour node factories. computeModManifest()
       provides a single session fingerprint for multiplayer client validation.
     - exported via src/index.ts.
 

package/dist/src/bridge/bridge-engine.js

@@ -151,7 +151,6 @@ export class BridgeEngine {
                 // Render time at or after current snapshot
                 if (this.config.extrapolationAllowed) {
                     // Extrapolate forward using velocity
-                    const delta = renderTime_s - this.currTime_s;
                     t = SCALE.Q;
                     fromTick = curr.tick;
                     toTick = curr.tick;

package/dist/src/competence/acoustic.d.ts

@@ -42,7 +42,7 @@ export interface AcousticDetectionOutcome {
  *   movementNoise = velocity_mps × 10
  *   equipmentNoise = based on armour material and weapon mass
  *
- * @param entity - The entity to analyze.
+ * @param entity - The entity to analyse.
  * @returns Acoustic signature with all noise components.
  */
 export declare function deriveAcousticSignature(entity: Entity): AcousticSignature;

package/dist/src/competence/acoustic.js

@@ -10,8 +10,6 @@ import { SCALE, q, clampQ, mulDiv } from "../units.js";
 // ── Constants ─────────────────────────────────────────────────────────────────
 /** Scale factor for acoustic detection formula. */
 const SCALE_ACOUSTIC = 100; // multiplier to get useful detection ranges
-/** Base detection range in metres at average musical intelligence. */
-const BASE_DETECTION_RANGE_m = 50;
 /** Maximum effective detection range. */
 const MAX_DETECTION_RANGE_m = 500;
 /** Range factor: clarity degrades with distance. */
@@ -23,11 +21,7 @@ const BASE_SIGNAL_LATENCY_MS = 200;
 /** Latency reduction from high musical intelligence. */
 const MUSICAL_LATENCY_REDUCTION_FACTOR = 0.5; // up to 50% faster
 // Noise level constants
-const NOISE_SILENT = 0;
-const NOISE_VERY_QUIET = 10;
-const NOISE_QUIET = 25;
 const NOISE_NORMAL = 50;
-const NOISE_LOUD = 75;
 const NOISE_VERY_LOUD = 100;
 // ── Helpers ───────────────────────────────────────────────────────────────────
 /**
@@ -85,7 +79,7 @@ function calculateEquipmentNoise(entity) {
  *   movementNoise = velocity_mps × 10
  *   equipmentNoise = based on armour material and weapon mass
  *
- * @param entity - The entity to analyze.
+ * @param entity - The entity to analyse.
  * @returns Acoustic signature with all noise components.
  */
 export function deriveAcousticSignature(entity) {

package/dist/src/competence/catalogue.js

@@ -181,7 +181,7 @@ const entries = [
         domain: "logicalMathematical",
         difficulty_Q: q(0.55),
         timeBase_s: 1800, // 30 minutes
-        description: "Analyze tactical situation and propose solution",
+        description: "Analyse tactical situation and propose solution",
     },
     // ── Musical (performance, signaling) ─────────────────────────────────────────
     {

package/dist/src/competence/engineering.js

@@ -13,8 +13,6 @@ const BASE_QUALITY_MUL = q(0.70);
 const MAX_QUALITY_MUL = q(1.20);
 /** Minimum quality multiplier for success. */
 const MIN_SUCCESS_QUALITY = q(0.30);
-/** Time factor: rushed work reduces quality. */
-const TIME_FACTOR_BASE = 1.0;
 // ── Public API ────────────────────────────────────────────────────────────────
 /**
  * Resolve an engineering project.

package/dist/src/competence/framework.js

@@ -31,8 +31,6 @@ const QUALITY_XP_MULTIPLIERS = {
 };
 /** Difficulty XP bonus: harder tasks grant more XP. */
 const MAX_DIFFICULTY_BONUS = 15;
-/** Tool quality bonus lookup (default if tool not specified). */
-const DEFAULT_TOOL_BONUS = q(1.0);
 // ── Helper Functions ──────────────────────────────────────────────────────────
 /**
  * Map domain-specific descriptors to canonical descriptors.
@@ -279,7 +277,7 @@ function resolveNaturalist(actor, task, action) {
 /**
  * Resolve inter-species tasks.
  */
-function resolveInterSpecies(actor, task, action, world) {
+function resolveInterSpecies(actor, task, action) {
     const seed = action.seed;
     const spec = {
         targetSpecies: "unknown",
@@ -647,7 +645,7 @@ export function resolveCompetence(actor, action, world) {
             result = resolveNaturalist(actor, task, action);
             break;
         case "interSpecies":
-            result = resolveInterSpecies(actor, task, action, world);
+            result = resolveInterSpecies(actor, task, action);
             break;
         case "linguistic":
             result = resolveLinguistic(actor, task, action, world);

package/dist/src/competence/interspecies.js

@@ -11,8 +11,6 @@ import { makeRng } from "../rng.js";
 const MAX_LATENCY_PENALTY_MS = 80 * SCALE.s / 1000; // 80ms in Q-units
 /** Scaling factor: penalty = (1.0 − interSpecies) × MAX_LATENCY_PENALTY_MS. */
 const LATENCY_PENALTY_SCALE = MAX_LATENCY_PENALTY_MS;
-/** Base success probability for signaling without vocabulary. */
-const SIGNAL_BASE_PROBABILITY = q(0.10);
 /** Aggravation threshold: low empathy + high fear → possible hostile reaction. */
 const AGGRAVATION_THRESHOLD = q(0.30);
 // ── Public API ────────────────────────────────────────────────────────────────

package/dist/src/competence/language.js

@@ -6,8 +6,6 @@
 // No kernel import — pure resolution module.
 import { SCALE, q, clampQ, qMul, mulDiv } from "../units.js";
 // ── Constants ─────────────────────────────────────────────────────────────────
-/** Base reception rate at linguistic q(0.50) for formation size 1. */
-const BASE_RECEPTION_RATE = q(0.70);
 /** Maximum formation size before reception penalties apply. */
 const OPTIMAL_FORMATION_SIZE = 10;
 /** Base delay divisor: linguistic × BASE_DELAY_DIVISOR. */

package/dist/src/competence/naturalist.js

@@ -162,7 +162,7 @@ export function resolveTaming(entity, spec, seed) {
     const fearPenalty = mulDiv(spec.animalFearQ, q(0.50), SCALE.Q);
     // Prior successes bonus: +5% per success, max +25%
     const experienceBonus = Math.min(spec.priorSuccesses * q(0.05), q(0.25));
-    let trust_Q = clampQ((baseTrust - fearPenalty + experienceBonus), q(0), q(1.0));
+    const trust_Q = clampQ((baseTrust - fearPenalty + experienceBonus), q(0), q(1.0));
     // Attack check: high fear with low trust is dangerous
     // P(attack) = max(0, (animalFearQ − trust_Q) × 0.30)
     const fearFloat = mulDiv(spec.animalFearQ, q(1.0), SCALE.Q);

package/dist/src/crafting/index.d.ts

@@ -1,6 +1,7 @@
 import type { Q } from "../units.js";
 import type { Entity } from "../sim/entity.js";
 import type { Inventory } from "../inventory.js";
+import type { ItemBase } from "../equipment.js";
 import type { Recipe } from "./recipes.js";
 import type { Material } from "./materials.js";
 import type { WorkshopInstance } from "./workshops.js";
@@ -41,8 +42,7 @@ export declare function getAvailableRecipes(entity: Entity, inventory: Inventory
  * Get material properties for a crafted item.
  * Applies material property modifiers to base item stats.
  */
-export declare function applyMaterialProperties(baseItem: any, // Placeholder: Item type
-material: Material): MaterialPropertyModifier;
+export declare function applyMaterialProperties(baseItem: ItemBase, material: Material): MaterialPropertyModifier;
 /**
  * Integrate crafting result into inventory.
  * Consumes ingredients and adds crafted item.

package/dist/src/crafting/index.js

@@ -107,8 +107,8 @@ export function startManufacturing(recipeId, quantity, workshop, workers, worldS
     if (!skilledWorkerExists) {
         return { success: false, error: "No worker meets skill requirements" };
     }
-    const primaryWorkerId = workers.length > 0 ? workers[0].id : 0;
-    const lineSeed = eventSeed(worldSeed, tick, primaryWorkerId, hashString(recipe.id), salt);
+    const _primaryWorkerId = workers.length > 0 ? workers[0].id : 0;
+    const _lineSeed = eventSeed(worldSeed, tick, _primaryWorkerId, hashString(recipe.id), salt);
     const orderId = `order_${worldSeed}_${tick}_${recipe.id}_${salt}`;
     // Create manufacturing order
     const order = {
@@ -118,7 +118,7 @@ export function startManufacturing(recipeId, quantity, workshop, workers, worldS
         workshop,
     };
     // Setup production line
-    const line = setupProductionLine(order, workers, lineSeed);
+    const line = setupProductionLine(order, workers);
     // TODO: store production line in persistent state
     return { success: true, lineId: line.lineId };
 }
@@ -131,7 +131,7 @@ export function advanceManufacturing(lineId, deltaTime_s, workers, workshop, wor
     let lineIdHash = 0;
     for (let i = 0; i < lineId.length; i++)
         lineIdHash += lineId.charCodeAt(i);
-    const seed = eventSeed(worldSeed, tick, lineIdHash, 0, salt);
+    const _seed = eventSeed(worldSeed, tick, lineIdHash, 0, salt);
     // TODO: retrieve production line by lineId
     const line = {
         lineId,
@@ -143,7 +143,7 @@ export function advanceManufacturing(lineId, deltaTime_s, workers, workshop, wor
         priority: 1,
         qualityRange: { min_Q: q(0.30), max_Q: q(0.90), avg_Q: q(0.60) },
     };
-    const result = advanceProduction(line, deltaTime_s, workers, workshop, seed);
+    const result = advanceProduction(line, deltaTime_s, workers);
     // TODO: update stored line
     return {
         itemsCompleted: result.itemsCompleted,
@@ -171,8 +171,7 @@ export function getAvailableRecipes(entity, inventory, workshop) {
  * Get material properties for a crafted item.
  * Applies material property modifiers to base item stats.
  */
-export function applyMaterialProperties(baseItem, // Placeholder: Item type
-material) {
+export function applyMaterialProperties(baseItem, material) {
     return calculateMaterialEffect(baseItem, material);
 }
 // ── Integration with Existing Systems ─────────────────────────────────────────

package/dist/src/crafting/manufacturing.d.ts

@@ -3,6 +3,11 @@ import type { Entity } from "../sim/entity.js";
 import type { Recipe } from "./recipes.js";
 import type { WorkshopInstance } from "./workshops.js";
 /** Production line state for batch manufacturing. */
+export type ProductQualityRange = {
+    min_Q: Q;
+    max_Q: Q;
+    avg_Q: Q;
+};
 export interface ProductionLine {
     lineId: string;
     recipeId: string;
@@ -11,11 +16,7 @@ export interface ProductionLine {
     progress_Q: Q;
     assignedWorkers: number[];
     priority: number;
-    qualityRange: {
-        min_Q: Q;
-        max_Q: Q;
-        avg_Q: Q;
-    };
+    qualityRange: ProductQualityRange;
 }
 /** Manufacturing order for starting batch production. */
 export interface ManufacturingOrder {
@@ -30,11 +31,7 @@ export interface ProductionAdvanceResult {
     itemsCompleted: number;
     totalItemsProduced: number;
     progress_Q: Q;
-    qualityRange: {
-        min_Q: Q;
-        max_Q: Q;
-        avg_Q: Q;
-    };
+    qualityRange: ProductQualityRange;
 }
 /** Assembly step for multi-stage crafting. */
 export interface AssemblyStep {
@@ -47,19 +44,18 @@ export interface AssemblyStep {
 /**
  * Initialize a production line for batch manufacturing.
  */
-export declare function setupProductionLine(order: ManufacturingOrder, workers: Entity[], seed: number): ProductionLine;
+export declare function setupProductionLine(order: ManufacturingOrder, workers: Entity[]): ProductionLine;
 /**
  * Advance production line by deltaTime seconds.
  * Progress accumulates based on number of workers and their skills.
  * Returns new items completed and updated progress.
  */
-export declare function advanceProduction(productionLine: ProductionLine, deltaTime_s: number, workers: Entity[], // Must match assignedWorkers IDs
-workshop: WorkshopInstance, seed: number): ProductionAdvanceResult;
+export declare function advanceProduction(productionLine: ProductionLine, deltaTime_s: number, workers: Entity[]): ProductionAdvanceResult;
 /**
  * Calculate predicted quality range for a batch based on workers, materials, workshop.
  * Returns min, max, and average expected quality.
  */
-export declare function calculateBatchQualityRange(workers: Entity[], workshop: WorkshopInstance, seed: number): {
+export declare function calculateBatchQualityRange(workers: Entity[]): {
     min_Q: Q;
     max_Q: Q;
     avg_Q: Q;
@@ -76,7 +72,7 @@ export declare function advanceAssemblyStep(step: AssemblyStep, worker: Entity,
     completed: boolean;
 };
 /** Estimate time to complete a batch given workers and workshop. */
-export declare function estimateBatchCompletionTime(batchSize: number, workers: Entity[], workshop: WorkshopInstance): number;
+export declare function estimateBatchCompletionTime(batchSize: number, workers: Entity[]): number;
 /** Check if production line is complete. */
 export declare function isProductionLineComplete(line: ProductionLine): boolean;
 /** Get progress percentage (0–1). */

package/dist/src/crafting/manufacturing.js

@@ -4,8 +4,6 @@
 // Deterministic batch quality range based on workers, materials, workshop.
 import { SCALE, q, clampQ, qMul, mulDiv } from "../units.js";
 // ── Constants ─────────────────────────────────────────────────────────────────
-/** Default progress per worker per second (Q units). */
-const PROGRESS_PER_WORKER_PER_SECOND = q(0.001);
 /** Quality variance factor based on number of workers (more workers → less variance). */
 const WORKER_VARIANCE_REDUCTION = q(0.10);
 /** Minimum quality variance per batch. */
@@ -14,9 +12,9 @@ const MIN_QUALITY_VARIANCE = q(0.05);
 /**
  * Initialize a production line for batch manufacturing.
  */
-export function setupProductionLine(order, workers, seed) {
+export function setupProductionLine(order, workers) {
     const workerIds = workers.map(w => w.id);
-    const qualityRange = calculateBatchQualityRange(workers, order.workshop, seed);
+    const qualityRange = calculateBatchQualityRange(workers);
     return {
         lineId: `line_${order.orderId}`,
         recipeId: order.recipeId,
@@ -33,8 +31,7 @@ export function setupProductionLine(order, workers, seed) {
  * Progress accumulates based on number of workers and their skills.
  * Returns new items completed and updated progress.
  */
-export function advanceProduction(productionLine, deltaTime_s, workers, // Must match assignedWorkers IDs
-workshop, seed) {
+export function advanceProduction(productionLine, deltaTime_s, workers) {
     if (productionLine.itemsProduced >= productionLine.batchSize) {
         return {
             itemsCompleted: 0,
@@ -64,8 +61,7 @@ workshop, seed) {
     }
     productionLine.progress_Q = clampQ(newProgress, q(0), SCALE.Q);
     // Update quality range based on remaining workers (variance reduces as more items produced)
-    const remainingItems = productionLine.batchSize - productionLine.itemsProduced;
-    const updatedRange = updateQualityRange(productionLine.qualityRange, workers, remainingItems, seed);
+    const updatedRange = updateQualityRange(productionLine.qualityRange);
     return {
         itemsCompleted,
         totalItemsProduced: productionLine.itemsProduced,
@@ -77,7 +73,7 @@ workshop, seed) {
  * Calculate predicted quality range for a batch based on workers, materials, workshop.
  * Returns min, max, and average expected quality.
  */
-export function calculateBatchQualityRange(workers, workshop, seed) {
+export function calculateBatchQualityRange(workers) {
     if (workers.length === 0) {
         return { min_Q: q(0), max_Q: q(0), avg_Q: q(0) };
     }
@@ -98,7 +94,7 @@ export function calculateBatchQualityRange(workers, workshop, seed) {
     return { min_Q, max_Q, avg_Q };
 }
 /** Update quality range as production progresses (variance may change). */
-function updateQualityRange(currentRange, workers, remainingItems, seed) {
+function updateQualityRange(currentRange) {
     // For simplicity, keep range constant; could adjust based on worker fatigue, etc.
     return currentRange;
 }
@@ -139,7 +135,7 @@ export function advanceAssemblyStep(step, worker, deltaTime_s, availableTools) {
 }
 // ── Utility Functions ────────────────────────────────────────────────────────
 /** Estimate time to complete a batch given workers and workshop. */
-export function estimateBatchCompletionTime(batchSize, workers, workshop) {
+export function estimateBatchCompletionTime(batchSize, workers) {
     if (workers.length === 0)
         return Infinity;
     let totalSkill = 0;

package/dist/src/crafting/materials.d.ts

@@ -43,7 +43,7 @@ material: Material): MaterialPropertyModifier;
  * Extract materials from inventory items that are of kind "material".
  * Returns map of materialTypeId to total quantity (kg) and average quality.
  */
-export declare function getAvailableMaterials(inventory: any): Map<string, {
+export declare function getAvailableMaterials(materials: readonly Material[]): Map<string, {
     totalKg: number;
     avgQuality_Q: Q;
 }>;

package/dist/src/crafting/materials.js

@@ -74,7 +74,6 @@ material) {
     if (!materialType) {
         return {}; // No effect for unknown material
     }
-    const qualityFactor = material.quality_Q / SCALE.Q; // 0–1
     const modifiers = {};
     // Strength affects durability and damage
     modifiers.durabilityMul = clampQ(Math.round(q(0.80) + mulDiv(materialType.strength_Q, q(0.40), SCALE.Q)), q(0.50), q(1.50));
@@ -92,10 +91,19 @@ material) {
  * Extract materials from inventory items that are of kind "material".
  * Returns map of materialTypeId to total quantity (kg) and average quality.
  */
-export function getAvailableMaterials(inventory) {
+export function getAvailableMaterials(materials) {
     const map = new Map();
-    // TODO: iterate through inventory items, filter by kind === "material"
-    // For each material item, accumulate quantity and weighted quality.
+    for (const mat of materials) {
+        const existing = map.get(mat.materialTypeId);
+        if (existing) {
+            const newTotalKg = existing.totalKg + mat.quantity_kg;
+            const avgQuality_Q = Math.round((existing.avgQuality_Q * existing.totalKg + mat.quality_Q * mat.quantity_kg) / newTotalKg);
+            map.set(mat.materialTypeId, { totalKg: newTotalKg, avgQuality_Q });
+        }
+        else {
+            map.set(mat.materialTypeId, { totalKg: mat.quantity_kg, avgQuality_Q: mat.quality_Q });
+        }
+    }
     return map;
 }
 // ── Utility Functions ────────────────────────────────────────────────────────

package/dist/src/crafting/recipes.d.ts

@@ -60,7 +60,7 @@ export declare function validateRecipeFeasibility(recipe: Recipe, inventory: Inv
  * Calculate crafting cost (time, material consumption) based on recipe, materials, and workshop bonuses.
  */
 export declare function calculateCraftingCost(recipe: Recipe, materialQualities: Map<string, Q>, // itemId -> quality_Q
-workshopTimeReduction_Q?: Q, workshopQualityBonus_Q?: Q): {
+workshopTimeReduction_Q?: Q): {
     time_s: number;
     materialQualityAvg_Q: Q;
 };

package/dist/src/crafting/recipes.js

@@ -116,7 +116,7 @@ function getEntitySkill(entity, skillType) {
  * Calculate crafting cost (time, material consumption) based on recipe, materials, and workshop bonuses.
  */
 export function calculateCraftingCost(recipe, materialQualities, // itemId -> quality_Q
-workshopTimeReduction_Q = q(1.0), workshopQualityBonus_Q = q(0)) {
+workshopTimeReduction_Q = q(1.0)) {
     // Average material quality (default q(0.50))
     let totalQuality = 0;
     let count = 0;

package/dist/src/item-durability.d.ts

@@ -62,7 +62,7 @@ export declare function calculateRepairNeed(item: ItemInstance): {
  * @param toolQuality_Q Quality of tools being used (0-1)
  * @param seed RNG seed for determinism
  */
-export declare function resolveRepair(item: ItemInstance, crafterCognitionQ: Q, toolQuality_Q: Q, seed: number): RepairResult;
+export declare function resolveRepair(item: ItemInstance, crafterCognitionQ: Q, toolQuality_Q: Q, _seed: number): RepairResult;
 /** Quick repair with no skill check (field repair). */
 export declare function fieldRepair(item: ItemInstance): RepairResult;
 /** Calculate item value based on durability and modifications. */

package/dist/src/item-durability.js

@@ -161,7 +161,7 @@ export function calculateRepairNeed(item) {
  * @param toolQuality_Q Quality of tools being used (0-1)
  * @param seed RNG seed for determinism
  */
-export function resolveRepair(item, crafterCognitionQ, toolQuality_Q, seed) {
+export function resolveRepair(item, crafterCognitionQ, toolQuality_Q, _seed) {
     if (!hasDurability(item)) {
         return {
             success: false,

package/dist/src/legend.d.ts

@@ -62,7 +62,7 @@ export declare function createLegendRegistry(): LegendRegistry;
 export declare function registerLegend(registry: LegendRegistry, legend: Legend): void;
 /** Get all legends about a specific entity. */
 export declare function getLegendsBySubject(registry: LegendRegistry, subjectId: number): Legend[];
-/** Derive NPC-behavior modifiers from a legend. */
+/** Derive NPC-behaviour modifiers from a legend. */
 export declare function getLegendEffect(legend: Legend): LegendEffect;
 /**
  * Determine whether an NPC "knows" a legend.

package/dist/src/legend.js

@@ -141,7 +141,7 @@ export function getLegendsBySubject(registry, subjectId) {
         .filter((l) => l !== undefined);
 }
 // ── Effects ───────────────────────────────────────────────────────────────────
-/** Derive NPC-behavior modifiers from a legend. */
+/** Derive NPC-behaviour modifiers from a legend. */
 export function getLegendEffect(legend) {
     const f = legend.fame_Q;
     switch (legend.reputation) {

package/dist/src/modding.d.ts

@@ -8,13 +8,13 @@
  *   mod file.  The network replication layer (CE-11) compares fingerprints across clients
  *   to guarantee all participants use identical mod definitions.
  *
- * **Layer 2 — Post-tick behavior hooks**
+ * **Layer 2 — Post-tick behaviour hooks**
  *   `registerPostTickHook(id, fn)` registers an observer callback that the host fires
  *   after each `stepWorld` call via `runPostTickHooks(world)`.  Hooks are purely
  *   observational — they MUST NOT mutate `WorldState` during the call.  Because they run
  *   outside the kernel path they cannot break determinism.
  *
- * **Layer 3 — AI behavior node overrides**
+ * **Layer 3 — AI behaviour node overrides**
  *   `registerBehaviorNode(id, factory)` installs a named factory for custom
  *   `BehaviorNode` implementations.  `loadScenario` (CE-3) can reference them by id in
  *   scenario JSON.  AI overrides require explicit host opt-in.
@@ -75,7 +75,7 @@ export type BehaviorNodeFactory = (...args: unknown[]) => BehaviorNode;
  * Register a named factory for a custom `BehaviorNode` implementation.
  *
  * The factory will be looked up by id when `loadScenario` (CE-3) encounters an
- * `"aiOverride"` reference in scenario JSON, or when a host builds a behavior
+ * `"aiOverride"` reference in scenario JSON, or when a host builds a behaviour
  * tree programmatically:
  *
  * ```typescript
@@ -87,32 +87,32 @@ export type BehaviorNodeFactory = (...args: unknown[]) => BehaviorNode;
  * ```
  *
  * **Deterministic multiplayer**: AI overrides affect simulation output.  All
- * clients must register the same behavior nodes (verified via `computeModManifest`)
+ * clients must register the same behaviour nodes (verified via `computeModManifest`)
  * before joining a session.
  *
  * Re-registering an existing id overwrites the previous factory.
  */
 export declare function registerBehaviorNode(id: string, factory: BehaviorNodeFactory): void;
 /**
- * Remove a previously registered behavior node factory.
+ * Remove a previously registered behaviour node factory.
  * Returns `true` if the factory existed and was removed.
  */
 export declare function unregisterBehaviorNode(id: string): boolean;
 /**
- * Look up a registered behavior node factory by id.
+ * Look up a registered behaviour node factory by id.
  * Returns `undefined` if not found.
  */
 export declare function getBehaviorNode(id: string): BehaviorNodeFactory | undefined;
-/** Return the ids of all registered behavior node factories in registration order. */
+/** Return the ids of all registered behaviour node factories in registration order. */
 export declare function listBehaviorNodes(): string[];
-/** Remove all behavior node factories (useful for testing and hot-reload scenarios). */
+/** Remove all behaviour node factories (useful for testing and hot-reload scenarios). */
 export declare function clearBehaviorNodes(): void;
 export interface ModManifest {
     /** Sorted list of all data mod ids currently in the CE-12 catalog. */
     dataIds: string[];
     /** Sorted list of all registered post-tick hook ids. */
     hookIds: string[];
-    /** Sorted list of all registered behavior node ids. */
+    /** Sorted list of all registered behaviour node ids. */
     behaviorIds: string[];
     /**
      * Single fingerprint covering all three id lists.
@@ -122,7 +122,7 @@ export interface ModManifest {
 }
 /**
  * Compute a session manifest covering all active mods (CE-12 catalog entries,
- * post-tick hooks, and AI behavior node overrides).
+ * post-tick hooks, and AI behaviour node overrides).
  *
  * The `fingerprint` is a deterministic 8-char hex string suitable for
  * multiplayer session comparison.  Clients are considered mod-compatible iff
@@ -133,5 +133,5 @@ export interface ModManifest {
  *   on `catalog.ts`.
  */
 export declare function computeModManifest(catalogIds?: string[]): ModManifest;
-/** Remove all hooks and behavior node factories. Does not affect the CE-12 catalog. */
+/** Remove all hooks and behaviour node factories. Does not affect the CE-12 catalog. */
 export declare function clearAllMods(): void;

package/dist/src/modding.js

@@ -8,13 +8,13 @@
  *   mod file.  The network replication layer (CE-11) compares fingerprints across clients
  *   to guarantee all participants use identical mod definitions.
  *
- * **Layer 2 — Post-tick behavior hooks**
+ * **Layer 2 — Post-tick behaviour hooks**
  *   `registerPostTickHook(id, fn)` registers an observer callback that the host fires
  *   after each `stepWorld` call via `runPostTickHooks(world)`.  Hooks are purely
  *   observational — they MUST NOT mutate `WorldState` during the call.  Because they run
  *   outside the kernel path they cannot break determinism.
  *
- * **Layer 3 — AI behavior node overrides**
+ * **Layer 3 — AI behaviour node overrides**
  *   `registerBehaviorNode(id, factory)` installs a named factory for custom
  *   `BehaviorNode` implementations.  `loadScenario` (CE-3) can reference them by id in
  *   scenario JSON.  AI overrides require explicit host opt-in.
@@ -117,7 +117,7 @@ const _behaviorNodes = new Map();
  * Register a named factory for a custom `BehaviorNode` implementation.
  *
  * The factory will be looked up by id when `loadScenario` (CE-3) encounters an
- * `"aiOverride"` reference in scenario JSON, or when a host builds a behavior
+ * `"aiOverride"` reference in scenario JSON, or when a host builds a behaviour
  * tree programmatically:
  *
  * ```typescript
@@ -129,7 +129,7 @@ const _behaviorNodes = new Map();
  * ```
  *
  * **Deterministic multiplayer**: AI overrides affect simulation output.  All
- * clients must register the same behavior nodes (verified via `computeModManifest`)
+ * clients must register the same behaviour nodes (verified via `computeModManifest`)
  * before joining a session.
  *
  * Re-registering an existing id overwrites the previous factory.
@@ -140,30 +140,30 @@ export function registerBehaviorNode(id, factory) {
     _behaviorNodes.set(id, factory);
 }
 /**
- * Remove a previously registered behavior node factory.
+ * Remove a previously registered behaviour node factory.
  * Returns `true` if the factory existed and was removed.
  */
 export function unregisterBehaviorNode(id) {
     return _behaviorNodes.delete(id);
 }
 /**
- * Look up a registered behavior node factory by id.
+ * Look up a registered behaviour node factory by id.
  * Returns `undefined` if not found.
  */
 export function getBehaviorNode(id) {
     return _behaviorNodes.get(id);
 }
-/** Return the ids of all registered behavior node factories in registration order. */
+/** Return the ids of all registered behaviour node factories in registration order. */
 export function listBehaviorNodes() {
     return [..._behaviorNodes.keys()];
 }
-/** Remove all behavior node factories (useful for testing and hot-reload scenarios). */
+/** Remove all behaviour node factories (useful for testing and hot-reload scenarios). */
 export function clearBehaviorNodes() {
     _behaviorNodes.clear();
 }
 /**
  * Compute a session manifest covering all active mods (CE-12 catalog entries,
- * post-tick hooks, and AI behavior node overrides).
+ * post-tick hooks, and AI behaviour node overrides).
  *
  * The `fingerprint` is a deterministic 8-char hex string suitable for
  * multiplayer session comparison.  Clients are considered mod-compatible iff
@@ -181,7 +181,7 @@ export function computeModManifest(catalogIds = []) {
     const fingerprint = fnv1a32(combined).toString(16).padStart(8, "0");
     return { dataIds, hookIds, behaviorIds, fingerprint };
 }
-/** Remove all hooks and behavior node factories. Does not affect the CE-12 catalog. */
+/** Remove all hooks and behaviour node factories. Does not affect the CE-12 catalog. */
 export function clearAllMods() {
     _hooks.clear();
     _behaviorNodes.clear();

package/dist/src/narrative-render.js

@@ -31,9 +31,9 @@ export function renderArcSummary(arc) {
         rise_of_hero: (a) => `The hero's journey of ${actorNames(a)} spans ${entryCount(a)} pivotal moments.`,
         tragic_fall: (a) => `${actorNames(a)}'s descent from grace, marked by betrayal and loss.`,
         rivalry: (a) => `An enduring rivalry between ${actorNames(a)} unfolding across ${entryCount(a)} confrontations.`,
-        great_migration: (a) => `A mass migration that reshaped the region.`,
-        settlement_growth: (a) => `The rise of a settlement from humble beginnings to prosperity.`,
-        fallen_settlement: (a) => `The tragic fall of a once-great settlement.`,
+        great_migration: (_a) => `A mass migration that reshaped the region.`,
+        settlement_growth: (_a) => `The rise of a settlement from humble beginnings to prosperity.`,
+        fallen_settlement: (_a) => `The tragic fall of a once-great settlement.`,
         legendary_craftsman: (a) => `${actorNames(a)}'s masterworks will be remembered for generations.`,
         notorious_villain: (a) => `The terrifying rise of ${actorNames(a)}.`,
         unlikely_friendship: (a) => `An unexpected bond formed between ${actorNames(a)} against all odds.`,

package/dist/src/quest-generators.js

@@ -40,7 +40,7 @@ const DELIVERY_TEMPLATE = {
         currency: 50,
     },
     objectiveGenerators: [
-        (ctx) => ({
+        (_ctx) => ({
             objectiveId: "collect_package",
             description: "Collect the package from the quest giver",
             type: "collect_item",
@@ -129,7 +129,7 @@ const INVESTIGATION_TEMPLATE = {
             state: "available",
             hidden: false,
         }),
-        (ctx) => ({
+        (_ctx) => ({
             objectiveId: "report_findings",
             description: "Return and report your findings",
             type: "dialogue_choice",
@@ -185,7 +185,7 @@ const COLLECTION_TEMPLATE = {
         currency: 60,
     },
     objectiveGenerators: [
-        (ctx) => ({
+        (_ctx) => ({
             objectiveId: "collect_items",
             description: "Collect the requested items",
             type: "collect_item",
@@ -224,7 +224,7 @@ const WAIT_TEMPLATE = {
             state: "available",
             hidden: false,
         }),
-        (ctx) => ({
+        (_ctx) => ({
             objectiveId: "stand_watch",
             description: "Stand watch for the required duration",
             type: "wait_duration",

package/dist/src/settlement-services.js

@@ -88,12 +88,12 @@ export function generateSettlementNeeds(settlement) {
             suggestedReward: 200,
         });
     }
-    // Recent raid → defense need
+    // Recent raid → defence need
     if (settlement.safetyStatus.ticksSinceLastRaid < 100) {
         needs.push({
             type: "defense",
             priority: 8,
-            description: "Recent raid requires improved defenses",
+            description: "Recent raid requires improved defences",
             suggestedReward: 300,
         });
     }

package/dist/src/settlement.d.ts

@@ -135,7 +135,7 @@ export interface AvailableServices {
 export declare function getAvailableServices(settlement: Settlement): AvailableServices;
 /** Record a raid/siege on a settlement. */
 export declare function recordRaid(settlement: Settlement, attackerFactionId: number, casualties: number, tick: number): void;
-/** Update settlement defenses. */
+/** Update settlement defences. */
 export declare function updateDefenses(settlement: Settlement, hasDefenses: boolean): void;
 /** Serialize settlement to JSON-friendly format. */
 export declare function serializeSettlement(settlement: Settlement): unknown;

package/dist/src/settlement.js

@@ -351,7 +351,7 @@ function getMedicalCareLevel(level) {
         default: return "none";
     }
 }
-// ── Settlement Defense ─────────────────────────────────────────────────────────
+// ── Settlement Defence ─────────────────────────────────────────────────────────
 /** Record a raid/siege on a settlement. */
 export function recordRaid(settlement, attackerFactionId, casualties, tick) {
     settlement.safetyStatus.ticksSinceLastRaid = 0;
@@ -367,7 +367,7 @@ export function recordRaid(settlement, attackerFactionId, casualties, tick) {
         settlement.population = Math.max(0, settlement.population - casualties);
     }
 }
-/** Update settlement defenses. */
+/** Update settlement defences. */
 export function updateDefenses(settlement, hasDefenses) {
     settlement.safetyStatus.hasDefenses = hasDefenses;
 }

package/dist/src/sim/ai/behavior-trees.d.ts

@@ -1,5 +1,5 @@
 /**
- * CE-10 — Pre-built AI Behavior Tree Library
+ * CE-10 — Pre-built AI Behaviour Tree Library
  *
  * A thin, composable layer over the existing AI decision system.  Each
  * `BehaviorNode` receives the ticking entity, the current world state, and
@@ -31,7 +31,7 @@ import type { KernelContext } from "../context.js";
 import type { Command } from "../commands.js";
 import { type Q } from "../../units.js";
 /**
- * A single node in a behavior tree.
+ * A single node in a behaviour tree.
  *
  * `tick` is called once per AI frame (typically once per `stepWorld` tick).
  * Returns a `Command` if this node produces an action, or `null` if the node's

package/dist/src/sim/ai/behavior-trees.js

@@ -1,5 +1,5 @@
 /**
- * CE-10 — Pre-built AI Behavior Tree Library
+ * CE-10 — Pre-built AI Behaviour Tree Library
  *
  * A thin, composable layer over the existing AI decision system.  Each
  * `BehaviorNode` receives the ticking entity, the current world state, and
@@ -302,7 +302,7 @@ export function WithProbability(probability_Q, inner, salt = 0) {
         },
     };
 }
-// ── Pre-built behavior tree presets ──────────────────────────────────────────
+// ── Pre-built behaviour tree presets ─────────────────────────────────────────
 /**
  * Standard aggressive attacker: attack `targetId` at full intensity.
  * Falls back to retreat if badly shocked (shock ≥ q(0.70)).

package/dist/src/sim/bodyplan.d.ts

@@ -81,7 +81,7 @@ export interface BodySegment {
      */
     regeneratesViaMolting?: boolean;
     /**
-     * Intrinsic structural armor resist (joules) — energy absorbed by the shell
+     * Intrinsic structural armour resist (joules) — energy absorbed by the shell
      * before damage channels are allocated.  Distinct from worn equipment armour.
      * Absent or 0 = no intrinsic resistance.
      */

package/dist/src/sim/kernel.js

@@ -1368,7 +1368,7 @@ export function applyImpactToInjury(target, wpn, energy_J, region, armoured, tra
         }
     }
     const armourShift = armoured ? q(0.75) : q(1.0);
-    // Phase 8C: intrinsic exoskeleton armor — absorbed before damage channels are allocated
+    // Phase 8C: intrinsic exoskeleton armour — absorbed before damage channels are allocated
     if (seg?.intrinsicArmor_J !== undefined && seg.intrinsicArmor_J > 0) {
         energy_J = Math.max(0, energy_J - seg.intrinsicArmor_J);
         if (energy_J === 0)

package/dist/src/sim/step/morale.js

@@ -48,7 +48,7 @@ export function stepMoraleForEntity(world, e, index, spatial, aliveBeforeTick, t
     }
     let fearQ = e.condition.fearQ;
     const wasRouting = isRouting(fearQ, distressTol);
-    // 1. Suppression ticks add fear per tick — scaled by caliber multiplier (Feature 1)
+    // 1. Suppression ticks add fear per tick — scaled by calibre multiplier (Feature 1)
     if (e.condition.suppressedTicks > 0) {
         const supMul = e.condition.suppressionFearMul ?? SCALE.Q;
         fearQ = clampQ(fearQ + qMul(FEAR_PER_SUPPRESSION_TICK, supMul), 0, SCALE.Q);

package/package.json

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