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

package/CHANGELOG.md

@@ -6,6 +6,72 @@ 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
+
+- **Phase 101 · Currency & Monetary Policy** (`src/monetary.ts`)
+  - `CoinagePolicy`: `"stable" | "slight_debasement" | "heavy_debasement" | "emergency_printing"`.
+  - `MonetaryState { polityId, coinPurity_Q, inflationLevel_Q, monetaryCrisis }` — per-polity mutable tracker stored externally.
+  - `coinPurity_Q` [0, SCALE.Q]: intrinsic metal content; trade partners check this. Starts at SCALE.Q.
+  - `inflationLevel_Q` [0, SCALE.Q]: accumulated price inflation; drives purchasing power loss and unrest. Starts at 0.
+  - `monetaryCrisis`: activates when `inflationLevel_Q >= MONETARY_CRISIS_THRESHOLD_Q = q(0.60)`.
+  - `POLICY_PURITY_DELTA_PER_DAY`: stable +3 (recovery) → emergency_printing −40/day.
+  - `POLICY_INFLATION_DELTA_PER_DAY`: stable −3 (deflation) → emergency_printing +50/day.
+  - `POLICY_DAILY_MINT_FRAC_Q`: stable 0 → emergency_printing 30/SCALE.Q (+110%/year).
+  - `computePurchasingPower_Q(state)` → `coinPurity × (1 − inflation) / SCALE.Q`; floor q(0.05).
+  - `computeMonetaryTradeMultiplier_Q(state)` → `[MONETARY_TRADE_FLOOR_Q, SCALE.Q]`; based on purity; feeds Phase-92.
+  - `computeMonetaryUnrest_Q(state)` → `[0, MONETARY_MAX_UNREST_Q=q(0.25)]`; linear on inflation; feeds Phase-90.
+  - `computeDebasementGain_cu(polity, policy, elapsedDays)` → advisory preview of mint gain.
+  - `stepMonetary(polity, state, policy, elapsedDays)` — mints extra treasury, updates purity/inflation, sets crisis flag.
+  - `isMonetaryCrisis(state)` / `isCoinageSound(state, threshold_Q?)` — predicates.
+  - Added `./monetary` subpath export to `package.json`.
+  - 45 new tests; 5,261 total. Coverage: 100% statements/branches/functions/lines on `monetary.ts`.
+
+---
+
+## [0.1.45] — 2026-03-27
+
+### Added
+
+- **Phase 100 · Wonders & Monuments** (`src/wonders.ts`)
+  - `WonderType`: `"great_pyramid" | "colosseum" | "grand_library" | "great_wall" | "grand_harbour" | "aqueduct_system" | "grand_temple"`.
+  - `WonderProject { projectId, polityId, type, progress_Q, investedCost_cu, startTick }` — in-progress construction.
+  - `Wonder { wonderId, polityId, type, completedAtTick, damaged }` — completed monument.
+  - `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 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.
+  - `contributeToWonder(project, polity, contribution_cu)` — deducts treasury, advances progress_Q; capped by treasury and remaining cost; returns new progress.
+  - `isWonderProjectComplete(project)` → `progress_Q >= SCALE.Q`.
+  - `completeWonder(project, tick)` → `Wonder`.
+  - `damageWonder(wonder)` — set by Phase-96 earthquake or Phase-93 siege callers.
+  - `repairWonder(wonder, polity)` → `boolean` — spends repair cost; returns false if funds insufficient.
+  - `computeWonderEffects(wonder)` — full or half effects based on damage state.
+  - `aggregateWonderEffects(wonders)` — sums Q fields (clamped to SCALE.Q); sums researchPointBonus uncapped.
+  - `isWonderIntact(wonder)` / `computeRepairCost(type)` — helpers.
+  - Added `./wonders` subpath export to `package.json`.
+  - 43 new tests; 5,216 total. Coverage: 100% statements/branches/functions/lines on `wonders.ts`.
+
+---
+
 ## [0.1.44] — 2026-03-27
 
 ### Added
@@ -729,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**
@@ -832,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;