@its-not-rocket-science/ananke 0.1.0

package/dist/src/archetypes.js

@@ -0,0 +1,285 @@
+import { q, to } from "./units.js";
+export const HUMAN_BASE = {
+    stature_m: to.m(1.75),
+    mass_kg: to.kg(75.0),
+    visionRange_m: to.m(200), // ~200m reliable visual identification
+    visionArcDeg: 120, // ~120° binocular forward arc
+    hearingRange_m: to.m(50), // ~50m reliable sound detection
+    decisionLatency_s: to.s(0.5), // ~500ms to revise tactical plan
+    attentionDepth: 4, // track up to 4 threats simultaneously
+    threatHorizon_m: to.m(40), // process threats within 40m
+    statureVar: q(0.04),
+    massVar: q(0.09),
+    reachVar: q(0.10),
+    actuatorScaleVar: q(0.005),
+    structureScaleVar: q(0.14),
+    actuatorMassFrac: q(0.40),
+    actuatorMassVar: q(0.025),
+    peakForce_N: to.N(1840),
+    peakForceVar: q(0.74),
+    peakPower_W: to.W(1200),
+    peakPowerVar: q(0.30),
+    continuousPower_W: to.W(200),
+    continuousPowerVar: q(0.25),
+    reserveEnergy_J: to.J(20_000),
+    reserveEnergyVar: q(0.35),
+    conversionEfficiency: q(0.85),
+    efficiencyVar: q(0.10),
+    reactionTime_s: to.s(0.20),
+    reactionTimeVar: q(0.25),
+    controlQuality: q(0.75),
+    controlVar: q(0.20),
+    stability: q(0.70),
+    stabilityVar: q(0.22),
+    fineControl: q(0.70),
+    fineControlVar: q(0.25),
+    surfaceIntegrity: q(1.0), surfaceVar: q(0.18),
+    bulkIntegrity: q(1.0), bulkVar: q(0.18),
+    structureIntegrity: q(1.0), structVar: q(0.18),
+    distressTolerance: q(0.50), distressVar: q(0.30),
+    shockTolerance: q(0.50), shockVar: q(0.30),
+    concussionTolerance: q(0.50), concVar: q(0.30),
+    heatTolerance: q(0.50), heatVar: q(0.30),
+    coldTolerance: q(0.50), coldVar: q(0.30),
+    fatigueRate: q(1.0), fatigueVar: q(0.25),
+    recoveryRate: q(1.0), recoveryVar: q(0.25),
+    cognition: {
+        linguistic: q(0.65), logicalMathematical: q(0.60), spatial: q(0.60),
+        bodilyKinesthetic: q(0.60), musical: q(0.50),
+        interpersonal: q(0.60), intrapersonal: q(0.55), naturalist: q(0.50), interSpecies: q(0.35),
+    },
+};
+// ─── Phase 15: validated real-world archetypes ────────────────────────────────
+/**
+ * Amateur boxer — British Journal of Sports Medicine, Walilko et al.
+ * Amateur punch force: 2,500–4,000 N (nominal 2,800 N used).
+ */
+export const AMATEUR_BOXER = {
+    stature_m: to.m(1.78), mass_kg: to.kg(75),
+    visionRange_m: to.m(200), visionArcDeg: 120, hearingRange_m: to.m(50),
+    decisionLatency_s: to.s(0.45), attentionDepth: 4, threatHorizon_m: to.m(30),
+    statureVar: q(0.06), massVar: q(0.10),
+    reachVar: q(0.08), actuatorScaleVar: q(0.15), structureScaleVar: q(0.12),
+    actuatorMassFrac: q(0.44), actuatorMassVar: q(0.15),
+    peakForce_N: to.N(2800), peakForceVar: q(0.18),
+    peakPower_W: to.W(1500), peakPowerVar: q(0.20),
+    continuousPower_W: to.W(300), continuousPowerVar: q(0.20),
+    reserveEnergy_J: to.J(25_000), reserveEnergyVar: q(0.25),
+    conversionEfficiency: q(0.88), efficiencyVar: q(0.08),
+    reactionTime_s: to.s(0.18), reactionTimeVar: q(0.18),
+    controlQuality: q(0.82), controlVar: q(0.15),
+    stability: q(0.75), stabilityVar: q(0.18),
+    fineControl: q(0.78), fineControlVar: q(0.18),
+    surfaceIntegrity: q(1.0), surfaceVar: q(0.15),
+    bulkIntegrity: q(1.0), bulkVar: q(0.15),
+    structureIntegrity: q(1.0), structVar: q(0.15),
+    distressTolerance: q(0.65), distressVar: q(0.22),
+    shockTolerance: q(0.65), shockVar: q(0.22),
+    concussionTolerance: q(0.55), concVar: q(0.22),
+    heatTolerance: q(0.55), heatVar: q(0.25),
+    coldTolerance: q(0.50), coldVar: q(0.25),
+    fatigueRate: q(0.85), fatigueVar: q(0.20),
+    recoveryRate: q(1.10), recoveryVar: q(0.20),
+    cognition: {
+        linguistic: q(0.55), logicalMathematical: q(0.50), spatial: q(0.60),
+        bodilyKinesthetic: q(0.75), musical: q(0.45),
+        interpersonal: q(0.50), intrapersonal: q(0.60), naturalist: q(0.40), interSpecies: q(0.25),
+    },
+};
+/**
+ * Pro boxer — biomechanics studies on elite boxers.
+ * Elite punch force: 4,000–7,000 N (nominal 5,000 N, cruiserweight/light-heavy).
+ */
+export const PRO_BOXER = {
+    stature_m: to.m(1.82), mass_kg: to.kg(85),
+    visionRange_m: to.m(200), visionArcDeg: 120, hearingRange_m: to.m(50),
+    decisionLatency_s: to.s(0.40), attentionDepth: 4, threatHorizon_m: to.m(30),
+    statureVar: q(0.05), massVar: q(0.08),
+    reachVar: q(0.06), actuatorScaleVar: q(0.12), structureScaleVar: q(0.10),
+    actuatorMassFrac: q(0.46), actuatorMassVar: q(0.12),
+    peakForce_N: to.N(5000), peakForceVar: q(0.15),
+    peakPower_W: to.W(2200), peakPowerVar: q(0.18),
+    continuousPower_W: to.W(400), continuousPowerVar: q(0.18),
+    reserveEnergy_J: to.J(40_000), reserveEnergyVar: q(0.20),
+    conversionEfficiency: q(0.90), efficiencyVar: q(0.06),
+    reactionTime_s: to.s(0.16), reactionTimeVar: q(0.15),
+    controlQuality: q(0.88), controlVar: q(0.12),
+    stability: q(0.80), stabilityVar: q(0.15),
+    fineControl: q(0.85), fineControlVar: q(0.14),
+    surfaceIntegrity: q(1.0), surfaceVar: q(0.12),
+    bulkIntegrity: q(1.0), bulkVar: q(0.12),
+    structureIntegrity: q(1.0), structVar: q(0.12),
+    distressTolerance: q(0.75), distressVar: q(0.18),
+    shockTolerance: q(0.75), shockVar: q(0.18),
+    concussionTolerance: q(0.70), concVar: q(0.18),
+    heatTolerance: q(0.55), heatVar: q(0.22),
+    coldTolerance: q(0.50), coldVar: q(0.22),
+    fatigueRate: q(0.80), fatigueVar: q(0.18),
+    recoveryRate: q(1.20), recoveryVar: q(0.18),
+    cognition: {
+        linguistic: q(0.55), logicalMathematical: q(0.58), spatial: q(0.65),
+        bodilyKinesthetic: q(0.82), musical: q(0.50),
+        interpersonal: q(0.55), intrapersonal: q(0.72), naturalist: q(0.40), interSpecies: q(0.25),
+    },
+};
+/**
+ * Greco-Roman wrestler — Olympic grappling literature.
+ * Grip ~500 N forearm; whole-body throw ~2,000 N.
+ */
+export const GRECO_WRESTLER = {
+    stature_m: to.m(1.76), mass_kg: to.kg(80),
+    visionRange_m: to.m(200), visionArcDeg: 120, hearingRange_m: to.m(50),
+    decisionLatency_s: to.s(0.45), attentionDepth: 4, threatHorizon_m: to.m(20),
+    statureVar: q(0.06), massVar: q(0.10),
+    reachVar: q(0.08), actuatorScaleVar: q(0.15), structureScaleVar: q(0.12),
+    actuatorMassFrac: q(0.45), actuatorMassVar: q(0.15),
+    peakForce_N: to.N(2000), peakForceVar: q(0.18),
+    peakPower_W: to.W(1400), peakPowerVar: q(0.22),
+    continuousPower_W: to.W(280), continuousPowerVar: q(0.20),
+    reserveEnergy_J: to.J(28_000), reserveEnergyVar: q(0.25),
+    conversionEfficiency: q(0.88), efficiencyVar: q(0.08),
+    reactionTime_s: to.s(0.20), reactionTimeVar: q(0.20),
+    controlQuality: q(0.82), controlVar: q(0.15),
+    stability: q(0.85), stabilityVar: q(0.14),
+    fineControl: q(0.80), fineControlVar: q(0.16),
+    surfaceIntegrity: q(1.0), surfaceVar: q(0.15),
+    bulkIntegrity: q(1.0), bulkVar: q(0.15),
+    structureIntegrity: q(1.0), structVar: q(0.15),
+    distressTolerance: q(0.68), distressVar: q(0.22),
+    shockTolerance: q(0.70), shockVar: q(0.22),
+    concussionTolerance: q(0.55), concVar: q(0.22),
+    heatTolerance: q(0.55), heatVar: q(0.25),
+    coldTolerance: q(0.50), coldVar: q(0.25),
+    fatigueRate: q(0.82), fatigueVar: q(0.20),
+    recoveryRate: q(1.15), recoveryVar: q(0.20),
+    cognition: {
+        linguistic: q(0.52), logicalMathematical: q(0.55), spatial: q(0.65),
+        bodilyKinesthetic: q(0.80), musical: q(0.40),
+        interpersonal: q(0.55), intrapersonal: q(0.65), naturalist: q(0.42), interSpecies: q(0.25),
+    },
+};
+/**
+ * Medieval knight infantry — trained warrior; armour applied via preset loadout.
+ */
+export const KNIGHT_INFANTRY = {
+    stature_m: to.m(1.75), mass_kg: to.kg(80),
+    visionRange_m: to.m(200), visionArcDeg: 120, hearingRange_m: to.m(50),
+    decisionLatency_s: to.s(0.50), attentionDepth: 4, threatHorizon_m: to.m(40),
+    statureVar: q(0.07), massVar: q(0.12),
+    reachVar: q(0.10), actuatorScaleVar: q(0.16), structureScaleVar: q(0.14),
+    actuatorMassFrac: q(0.43), actuatorMassVar: q(0.16),
+    peakForce_N: to.N(2200), peakForceVar: q(0.20),
+    peakPower_W: to.W(1300), peakPowerVar: q(0.25),
+    continuousPower_W: to.W(220), continuousPowerVar: q(0.22),
+    reserveEnergy_J: to.J(22_000), reserveEnergyVar: q(0.28),
+    conversionEfficiency: q(0.87), efficiencyVar: q(0.09),
+    reactionTime_s: to.s(0.22), reactionTimeVar: q(0.22),
+    controlQuality: q(0.78), controlVar: q(0.18),
+    stability: q(0.76), stabilityVar: q(0.20),
+    fineControl: q(0.75), fineControlVar: q(0.20),
+    surfaceIntegrity: q(1.0), surfaceVar: q(0.16),
+    bulkIntegrity: q(1.0), bulkVar: q(0.16),
+    structureIntegrity: q(1.0), structVar: q(0.16),
+    distressTolerance: q(0.72), distressVar: q(0.22),
+    shockTolerance: q(0.70), shockVar: q(0.22),
+    concussionTolerance: q(0.55), concVar: q(0.25),
+    heatTolerance: q(0.55), heatVar: q(0.28),
+    coldTolerance: q(0.55), coldVar: q(0.28),
+    fatigueRate: q(0.90), fatigueVar: q(0.22),
+    recoveryRate: q(1.05), recoveryVar: q(0.22),
+    cognition: {
+        linguistic: q(0.58), logicalMathematical: q(0.55), spatial: q(0.62),
+        bodilyKinesthetic: q(0.72), musical: q(0.48),
+        interpersonal: q(0.60), intrapersonal: q(0.68), naturalist: q(0.45), interSpecies: q(0.25),
+    },
+};
+/**
+ * Large Pacific Octopus (Enteroctopus dofleini).
+ * Arm muscle force ~150 N × 8 arms ≈ 1,200 N total burst.
+ * ~2,000 suckers → extremely high controlQuality + grappling skill in presets.
+ * Distributed nervous system → high concussionTolerance, low structureIntegrity (no skeleton).
+ */
+export const LARGE_PACIFIC_OCTOPUS = {
+    stature_m: to.m(1.0), // effective size; mantle ~0.3 m, arms ~2 m
+    mass_kg: to.kg(15),
+    visionRange_m: to.m(20), visionArcDeg: 300, hearingRange_m: to.m(5),
+    decisionLatency_s: to.s(0.30), attentionDepth: 3, threatHorizon_m: to.m(10),
+    statureVar: q(0.10), massVar: q(0.20),
+    reachVar: q(0.08), actuatorScaleVar: q(0.12), structureScaleVar: q(0.10),
+    actuatorMassFrac: q(0.55), // arms are almost entirely muscle
+    actuatorMassVar: q(0.12),
+    peakForce_N: to.N(1200), peakForceVar: q(0.15),
+    peakPower_W: to.W(400), peakPowerVar: q(0.18),
+    continuousPower_W: to.W(80), continuousPowerVar: q(0.20),
+    reserveEnergy_J: to.J(6_000), reserveEnergyVar: q(0.25),
+    conversionEfficiency: q(0.80), efficiencyVar: q(0.08),
+    reactionTime_s: to.s(0.25), reactionTimeVar: q(0.15),
+    controlQuality: q(0.95), controlVar: q(0.05), // 8 independently controlled arms
+    stability: q(0.98), stabilityVar: q(0.03), // distributed on substrate
+    fineControl: q(0.92), fineControlVar: q(0.05),
+    surfaceIntegrity: q(0.60), surfaceVar: q(0.15), // soft-bodied
+    bulkIntegrity: q(0.70), bulkVar: q(0.15),
+    structureIntegrity: q(0.40), structVar: q(0.10), // no skeleton
+    distressTolerance: q(0.70), distressVar: q(0.20),
+    shockTolerance: q(0.80), shockVar: q(0.15), // distributed nervous system
+    concussionTolerance: q(0.90), concVar: q(0.08), // no enclosed brain cavity
+    heatTolerance: q(0.35), heatVar: q(0.20),
+    coldTolerance: q(0.75), coldVar: q(0.15),
+    fatigueRate: q(1.20), fatigueVar: q(0.20),
+    recoveryRate: q(0.80), recoveryVar: q(0.20),
+    cognition: {
+        linguistic: q(0.05), logicalMathematical: q(0.70), spatial: q(0.90),
+        bodilyKinesthetic: q(0.95), musical: q(0.25),
+        interpersonal: q(0.40), intrapersonal: q(0.65), naturalist: q(0.80), interSpecies: q(0.50),
+    },
+};
+export const SERVICE_ROBOT = {
+    stature_m: to.m(1.60),
+    mass_kg: to.kg(55),
+    visionRange_m: to.m(500), // sensor suite: longer visual range
+    visionArcDeg: 360, // omnidirectional cameras
+    hearingRange_m: to.m(100), // acoustic arrays
+    decisionLatency_s: to.s(0.05), // 50ms: near-instant decision cycle
+    attentionDepth: 16, // broad multi-target tracking
+    threatHorizon_m: to.m(150), // process threats within 150m
+    statureVar: q(0.03),
+    massVar: q(0.06),
+    reachVar: q(0.05),
+    actuatorScaleVar: q(0.12),
+    structureScaleVar: q(0.20),
+    actuatorMassFrac: q(0.22),
+    actuatorMassVar: q(0.12),
+    peakForce_N: to.N(2500),
+    peakForceVar: q(0.10),
+    peakPower_W: to.W(900),
+    peakPowerVar: q(0.12),
+    continuousPower_W: to.W(350),
+    continuousPowerVar: q(0.10),
+    reserveEnergy_J: to.J(60_000),
+    reserveEnergyVar: q(0.15),
+    conversionEfficiency: q(0.92),
+    efficiencyVar: q(0.03),
+    reactionTime_s: to.s(0.08),
+    reactionTimeVar: q(0.10),
+    controlQuality: q(0.88),
+    controlVar: q(0.08),
+    stability: q(0.80),
+    stabilityVar: q(0.12),
+    fineControl: q(0.85),
+    fineControlVar: q(0.10),
+    surfaceIntegrity: q(1.6), surfaceVar: q(0.10),
+    bulkIntegrity: q(1.2), bulkVar: q(0.10),
+    structureIntegrity: q(1.8), structVar: q(0.12),
+    distressTolerance: q(0.95), distressVar: q(0.05),
+    shockTolerance: q(0.85), shockVar: q(0.08),
+    concussionTolerance: q(0.95), concVar: q(0.05),
+    heatTolerance: q(0.70), heatVar: q(0.12),
+    coldTolerance: q(0.90), coldVar: q(0.08),
+    fatigueRate: q(0.70), fatigueVar: q(0.10),
+    recoveryRate: q(1.20), recoveryVar: q(0.10),
+    cognition: {
+        linguistic: q(0.60), logicalMathematical: q(0.90), spatial: q(0.80),
+        bodilyKinesthetic: q(0.85), musical: q(0.10),
+        interpersonal: q(0.10), intrapersonal: q(0.30), naturalist: q(0.10), interSpecies: q(0.15),
+    },
+};

package/dist/src/arena.d.ts

@@ -0,0 +1,173 @@
+import type { Archetype } from "./archetypes.js";
+import { type Vec3 } from "./sim/vec3.js";
+import type { Entity } from "./sim/entity.js";
+import type { Loadout } from "./equipment.js";
+import type { SkillMap } from "./sim/skills.js";
+import type { AIPolicy } from "./sim/ai/types.js";
+import type { KernelContext } from "./sim/context.js";
+import type { NarrativeConfig } from "./narrative.js";
+import { type CareLevel, type EntityRecoveryReport as DowntimeReport } from "./downtime.js";
+import type { TerrainGrid, ObstacleGrid, ElevationGrid, HazardGrid } from "./sim/terrain.js";
+export type { CareLevel };
+export interface ArenaCombatant {
+    id: number;
+    teamId: number;
+    archetype: Archetype;
+    /** If omitted, derived from trial seed × 1000 + id. */
+    seed?: number;
+    loadout: Loadout;
+    skills?: SkillMap;
+    position_m: Vec3;
+    aiPolicy?: AIPolicy;
+    /**
+     * Optional post-creation mutation — called after entity is built from archetype.
+     * Use to inject pre-set wounds for recovery-focused calibration scenarios.
+     */
+    mutateOnCreate?: (entity: Entity) => void;
+}
+export interface ArenaScenario {
+    name: string;
+    description?: string;
+    combatants: ArenaCombatant[];
+    terrain?: {
+        terrainGrid?: TerrainGrid;
+        obstacleGrid?: ObstacleGrid;
+        elevationGrid?: ElevationGrid;
+        hazardGrid?: HazardGrid;
+        cellSize_m?: number;
+    };
+    /** Per-trial tick limit (default: 30 s × TICK_HZ = 600 ticks). */
+    maxTicks?: number;
+    /** Post-combat recovery phase. */
+    recovery?: {
+        careLevel: CareLevel;
+        /** Override care level per team (e.g. victors get better care). */
+        careByTeam?: Map<number, CareLevel>;
+        /** How many hours of downtime to simulate per trial. */
+        recoveryHours: number;
+        /** Shared item pool — copied independently to each combatant's schedule. */
+        inventory?: Map<string, number>;
+        /** If true, rest multiplier applied (×1.50 healing rates). Default false. */
+        rest?: boolean;
+    };
+    /** Statistical expectations checked against aggregate results. */
+    expectations?: ArenaExpectation[];
+}
+export interface ArenaExpectation {
+    description: string;
+    check: (result: ArenaResult) => boolean;
+}
+export declare function expectWinRate(teamId: number, min: number, max?: number): ArenaExpectation;
+export declare function expectSurvivalRate(entityId: number, min: number): ArenaExpectation;
+export declare function expectMeanDuration(minSeconds: number, maxSeconds: number): ArenaExpectation;
+export declare function expectRecovery(entityId: number, maxDays: number, _careLevel: CareLevel): ArenaExpectation;
+export declare function expectResourceCost(teamId: number, maxCostUnits: number): ArenaExpectation;
+export interface InjurySummary {
+    entityId: number;
+    dead: boolean;
+    unconscious: boolean;
+    consciousness: number;
+    fluidLoss: number;
+    shock: number;
+    activeBleedingRegions: string[];
+    fracturedRegions: string[];
+    infectedRegions: string[];
+    maxStructuralDamage: number;
+}
+export interface RecoveryOutcome {
+    entityId: number;
+    died: boolean;
+    combatReadyAt_s: number | null;
+    fullRecoveryAt_s: number | null;
+    resourcesUsed: DowntimeReport["resourcesUsed"];
+    totalCostUnits: number;
+}
+export interface CombatLogEntry {
+    tick: number;
+    text: string;
+}
+export interface ArenaTrialResult {
+    trialIndex: number;
+    seed: number;
+    ticks: number;
+    outcome: "team1_wins" | "team2_wins" | "draw" | "timeout";
+    survivors: number[];
+    injuries: InjurySummary[];
+    recoveryOutcomes?: RecoveryOutcome[];
+    combatLog?: CombatLogEntry[];
+}
+export interface ArenaResult {
+    scenario: ArenaScenario;
+    trials: number;
+    trialResults: ArenaTrialResult[];
+    winRateByTeam: Map<number, number>;
+    drawRate: number;
+    timeoutRate: number;
+    meanCombatDuration_s: number;
+    p50CombatDuration_s: number;
+    survivalRateByEntity: Map<number, number>;
+    meanTTI_s: Map<number, number>;
+    injuryDistribution: {
+        entityId: number;
+        meanFluidLoss: number;
+        fractureProbability: number;
+        deathProbability: number;
+    }[];
+    recoveryStats?: {
+        entityId: number;
+        survivalRatePostRecovery: number;
+        meanCombatReadyDays: number | null;
+        meanFullRecoveryDays: number | null;
+        meanResourceCostUnits: number;
+        p90ResourceCostUnits: number;
+    }[];
+    expectationResults: {
+        description: string;
+        passed: boolean;
+        detail?: string;
+    }[];
+}
+export declare function runArena(scenario: ArenaScenario, trials: number, options?: {
+    narrativeCfg?: NarrativeConfig;
+    ctx?: KernelContext;
+    seedOffset?: number;
+}): ArenaResult;
+/** Machine-readable summary (JSON-safe — no Maps or Functions). */
+export declare function summariseArena(result: ArenaResult): object;
+/** Human-readable statistical report. */
+export declare function formatArenaReport(result: ArenaResult): string;
+/**
+ * Full narrative of the median-duration trial (representative fight).
+ * Falls back to first trial if no narrative was collected.
+ */
+export declare function narrateRepresentativeTrial(result: ArenaResult): string;
+/**
+ * Armed trained human vs. unarmed untrained human.
+ * Source: criminal assault literature, self-defence training studies.
+ */
+export declare const CALIBRATION_ARMED_VS_UNARMED: ArenaScenario;
+/**
+ * Post-combat entity with severe knife wound, no treatment, 60 min downtime.
+ * Source: Sperry (2013) untreated penetrating abdominal trauma mortality.
+ */
+export declare const CALIBRATION_UNTREATED_KNIFE_WOUND: ArenaScenario;
+/**
+ * Same severe knife wound, first_aid applied within onset delay = 0.
+ * Source: TCCC tourniquet outcome data.
+ */
+export declare const CALIBRATION_FIRST_AID_SAVES_LIVES: ArenaScenario;
+/**
+ * Fresh long-bone fracture, field_medicine care, extended downtime.
+ * Source: orthopaedic rehabilitation literature.
+ */
+export declare const CALIBRATION_FRACTURE_RECOVERY: ArenaScenario;
+/**
+ * Moderate internal wound with active infection, no antibiotics, 24h downtime.
+ * Source: pre-antibiotic era wound infection mortality (Ogston, Lister era data).
+ */
+export declare const CALIBRATION_INFECTION_UNTREATED: ArenaScenario;
+/**
+ * Armoured knight vs. unarmoured swordsman, matched skill and archetype.
+ * Source: HEMA literature on plate armour effectiveness.
+ */
+export declare const CALIBRATION_PLATE_ARMOUR: ArenaScenario;