paracosm 0.4.346 → 0.4.377

package/dist/cli/custom-scenarios.js

@@ -0,0 +1,93 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function hasString(value, key) {
+    return typeof value[key] === 'string' && value[key].length > 0;
+}
+function hasNumber(value, key) {
+    return typeof value[key] === 'number' && Number.isFinite(value[key]);
+}
+export function isRunnableScenarioPackage(value) {
+    if (!isRecord(value))
+        return false;
+    if (!hasString(value, 'id') || !hasString(value, 'version'))
+        return false;
+    if (value.engineArchetype !== 'closed_turn_based_settlement')
+        return false;
+    const labels = value.labels;
+    const theme = value.theme;
+    const setup = value.setup;
+    const world = value.world;
+    const ui = value.ui;
+    const policies = value.policies;
+    const hooks = value.hooks;
+    if (!isRecord(labels))
+        return false;
+    if (!hasString(labels, 'name') || !hasString(labels, 'shortName') || !hasString(labels, 'populationNoun') || !hasString(labels, 'settlementNoun') || !hasString(labels, 'currency'))
+        return false;
+    if (!isRecord(theme))
+        return false;
+    if (!hasString(theme, 'primaryColor') || !hasString(theme, 'accentColor') || !isRecord(theme.cssVariables))
+        return false;
+    if (!isRecord(setup))
+        return false;
+    if (!hasNumber(setup, 'defaultTurns') || !hasNumber(setup, 'defaultSeed') || !hasNumber(setup, 'defaultStartYear') || !hasNumber(setup, 'defaultPopulation') || !Array.isArray(setup.configurableSections))
+        return false;
+    if (!isRecord(world) || !isRecord(world.metrics) || !isRecord(world.capacities) || !isRecord(world.statuses) || !isRecord(world.politics) || !isRecord(world.environment))
+        return false;
+    if (!Array.isArray(value.departments) || !Array.isArray(value.metrics) || !Array.isArray(value.events) || !Array.isArray(value.effects) || !Array.isArray(value.presets))
+        return false;
+    if (!isRecord(ui))
+        return false;
+    if (!Array.isArray(ui.headerMetrics) || !Array.isArray(ui.tooltipFields) || !Array.isArray(ui.reportSections) || !isRecord(ui.departmentIcons) || !isRecord(ui.eventRenderers) || !Array.isArray(ui.setupSections))
+        return false;
+    if (!isRecord(policies))
+        return false;
+    if (!isRecord(policies.toolForging) || typeof policies.toolForging.enabled !== 'boolean')
+        return false;
+    if (!isRecord(policies.liveSearch) || typeof policies.liveSearch.enabled !== 'boolean' || typeof policies.liveSearch.mode !== 'string')
+        return false;
+    if (!isRecord(policies.bulletin) || typeof policies.bulletin.enabled !== 'boolean')
+        return false;
+    if (!isRecord(policies.characterChat) || typeof policies.characterChat.enabled !== 'boolean')
+        return false;
+    if (!isRecord(policies.sandbox) || !hasNumber(policies.sandbox, 'timeoutMs') || !hasNumber(policies.sandbox, 'memoryMB'))
+        return false;
+    if (!isRecord(value.knowledge) || !isRecord(value.knowledge.topics) || !isRecord(value.knowledge.categoryMapping))
+        return false;
+    if (!isRecord(hooks))
+        return false;
+    return true;
+}
+export function loadDiskCustomScenarios(scenarioDir) {
+    const catalog = new Map();
+    if (!existsSync(scenarioDir))
+        return catalog;
+    for (const entry of readdirSync(scenarioDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith('.json'))
+            continue;
+        const filePath = resolve(scenarioDir, entry.name);
+        try {
+            const parsed = JSON.parse(readFileSync(filePath, 'utf-8'));
+            if (!isRunnableScenarioPackage(parsed))
+                continue;
+            catalog.set(parsed.id, { scenario: parsed, source: 'disk' });
+        }
+        catch {
+            // Ignore unreadable or invalid custom scenario files at boot.
+        }
+    }
+    return catalog;
+}
+export function describeCustomScenarioSource(source) {
+    if (source === 'builtin')
+        return 'Built-in scenario';
+    if (source === 'disk')
+        return 'Custom scenario (disk)';
+    if (source === 'compiled')
+        return 'Custom compiled scenario';
+    return 'Custom scenario (memory)';
+}
+//# sourceMappingURL=custom-scenarios.js.map

package/dist/cli/custom-scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-scenarios.js","sourceRoot":"","sources":["../../src/cli/custom-scenarios.ts"],"names":[],"mappings":"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"}

package/dist/cli/leaders-resolver.d.ts

@@ -0,0 +1,26 @@
+import type { LeaderConfig } from './types.js';
+export interface ResolvedLeaders {
+    leaders: LeaderConfig[];
+    /** Absolute path of the file the leaders were read from. Surfaces
+     *  in CLI output so users know which file is actually in use. */
+    sourcePath: string;
+    /** Marker for whether the source was the shipped example (we
+     *  want to print a hint nudging users to create their own). */
+    isExample: boolean;
+}
+/**
+ * Walks the candidate paths and loads the first `leaders.json` that
+ * exists. Throws only when nothing (not even the bundled example)
+ * is available — which would indicate a broken install.
+ */
+export declare function resolveLeaders(options?: {
+    explicitPath?: string;
+}): ResolvedLeaders;
+/**
+ * Pulls `--leaders <path>` out of argv WITHOUT mutating the array.
+ * Returns undefined when the flag isn't present. Kept separate from
+ * the main CLI parser so run.ts / serve.ts can resolve leaders the
+ * same way without duplicating flag logic.
+ */
+export declare function parseLeadersFlag(args: readonly string[]): string | undefined;
+//# sourceMappingURL=leaders-resolver.d.ts.map

package/dist/cli/leaders-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaders-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/leaders-resolver.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;qEACiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB;mEAC+D;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CAwBvF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAM5E"}

package/dist/cli/leaders-resolver.js

@@ -0,0 +1,66 @@
+/**
+ * Resolve the active `leaders.json` for a paracosm CLI invocation.
+ *
+ * Search order (first match wins):
+ *   1. --leaders <path> CLI flag (explicit path)
+ *   2. $CWD/leaders.json          (user's project root)
+ *   3. $CWD/config/leaders.json   (user's config dir)
+ *   4. <package>/config/leaders.json        (paracosm-shipped fallback)
+ *   5. <package>/config/leaders.example.json (last-resort default)
+ *
+ * Covers three consumer shapes:
+ *   - Repo clone: users edit config/leaders.json at the repo root.
+ *   - npm install: users drop leaders.json (or config/leaders.json)
+ *     into their project CWD.
+ *   - npx one-off: falls back to the bundled example so `npx
+ *     paracosm` Just Works even before the user writes any config.
+ *
+ * @module paracosm/cli/leaders-resolver
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Walks the candidate paths and loads the first `leaders.json` that
+ * exists. Throws only when nothing (not even the bundled example)
+ * is available — which would indicate a broken install.
+ */
+export function resolveLeaders(options = {}) {
+    const cwd = process.cwd();
+    const packageRoot = resolve(__dirname, '..', '..');
+    const candidates = [];
+    if (options.explicitPath) {
+        candidates.push({ path: resolve(cwd, options.explicitPath), isExample: false });
+    }
+    candidates.push({ path: resolve(cwd, 'leaders.json'), isExample: false });
+    candidates.push({ path: resolve(cwd, 'config', 'leaders.json'), isExample: false });
+    candidates.push({ path: resolve(packageRoot, 'config', 'leaders.json'), isExample: false });
+    candidates.push({ path: resolve(packageRoot, 'config', 'leaders.example.json'), isExample: true });
+    for (const { path, isExample } of candidates) {
+        if (!existsSync(path))
+            continue;
+        const raw = JSON.parse(readFileSync(path, 'utf-8'));
+        const leaders = Array.isArray(raw.leaders) ? raw.leaders : [];
+        return { leaders, sourcePath: path, isExample };
+    }
+    throw new Error(`paracosm: no leaders.json found. Create one at ${resolve(cwd, 'config', 'leaders.json')} ` +
+        `or pass --leaders <path>. A starter template lives at ${resolve(packageRoot, 'config', 'leaders.example.json')}.`);
+}
+/**
+ * Pulls `--leaders <path>` out of argv WITHOUT mutating the array.
+ * Returns undefined when the flag isn't present. Kept separate from
+ * the main CLI parser so run.ts / serve.ts can resolve leaders the
+ * same way without duplicating flag logic.
+ */
+export function parseLeadersFlag(args) {
+    const idx = args.indexOf('--leaders');
+    if (idx < 0)
+        return undefined;
+    const next = args[idx + 1];
+    if (!next || next.startsWith('--'))
+        return undefined;
+    return next;
+}
+//# sourceMappingURL=leaders-resolver.js.map

package/dist/cli/leaders-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaders-resolver.js","sourceRoot":"","sources":["../../src/cli/leaders-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAYtC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAqC,EAAE;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAgD,EAAE,CAAC;IAEnE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,sBAAsB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnG,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiC,CAAC;QACpF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,kDAAkD,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,GAAG;QAC3F,yDAAyD,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CACnH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/pair-runner.d.ts

@@ -0,0 +1,23 @@
+import { type NormalizedSimulationConfig } from './sim-config.js';
+import type { ScenarioPackage } from '../engine/types.js';
+export type BroadcastFn = (event: string, data: unknown) => void;
+export declare function runPairSimulations(simConfig: NormalizedSimulationConfig, broadcast: BroadcastFn, 
+/**
+ * Optional cancellation signal. When the server's disconnect watchdog
+ * trips (all SSE clients gone + grace period expired), it aborts this
+ * signal. Both leaders' runSimulation calls check it at turn
+ * boundaries and short-circuit cleanly, emitting a `sim_aborted`
+ * event and returning partial results. The event buffer is preserved
+ * so a returning user sees everything up to the cancel point.
+ */
+signal?: AbortSignal, 
+/**
+ * Scenario to run. Defaults to Mars Genesis when omitted so CLI
+ * callers that don't thread a scenario still work. The server path
+ * passes the currently-active scenario (set by /compile or
+ * /scenario/switch) so custom-compiled scenarios (e.g. "Brain Sim")
+ * actually get their own hooks + labels run instead of silently
+ * falling back to Mars while the page title shows the custom name.
+ */
+scenario?: ScenarioPackage): Promise<void>;
+//# sourceMappingURL=pair-runner.d.ts.map

package/dist/cli/pair-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-runner.d.ts","sourceRoot":"","sources":["../../src/cli/pair-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAIzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAyBjE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,WAAW;AACtB;;;;;;;GAOG;AACH,MAAM,CAAC,EAAE,WAAW;AACpB;;;;;;;GAOG;AACH,QAAQ,GAAE,eAA8B,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Lf"}

package/dist/cli/pair-runner.js

@@ -0,0 +1,225 @@
+import { DEFAULT_KEY_PERSONNEL } from './sim-config.js';
+import { marsScenario } from '../engine/mars/index.js';
+import { generateValidatedObject } from '../runtime/llm-invocations/generateValidatedObject.js';
+import { VerdictSchema } from '../runtime/schemas/verdict.js';
+function resolveVerdictModel(provider, economics) {
+    switch (economics.verdict.mode) {
+        case 'skip':
+            return null;
+        case 'cheap':
+            return provider === 'anthropic'
+                ? 'claude-haiku-4-5-20251001'
+                : 'gpt-5.4-mini';
+        case 'flagship':
+            return provider === 'anthropic'
+                ? 'claude-opus-4-7'
+                : 'gpt-5.4-pro';
+        case 'balanced':
+        default:
+            return provider === 'anthropic'
+                ? 'claude-sonnet-4-6'
+                : 'gpt-5.4';
+    }
+}
+export async function runPairSimulations(simConfig, broadcast, 
+/**
+ * Optional cancellation signal. When the server's disconnect watchdog
+ * trips (all SSE clients gone + grace period expired), it aborts this
+ * signal. Both leaders' runSimulation calls check it at turn
+ * boundaries and short-circuit cleanly, emitting a `sim_aborted`
+ * event and returning partial results. The event buffer is preserved
+ * so a returning user sees everything up to the cancel point.
+ */
+signal, 
+/**
+ * Scenario to run. Defaults to Mars Genesis when omitted so CLI
+ * callers that don't thread a scenario still work. The server path
+ * passes the currently-active scenario (set by /compile or
+ * /scenario/switch) so custom-compiled scenarios (e.g. "Brain Sim")
+ * actually get their own hooks + labels run instead of silently
+ * falling back to Mars while the page title shows the custom name.
+ */
+scenario = marsScenario) {
+    const { leaders, turns, seed, startYear, liveSearch, customEvents } = simConfig;
+    broadcast('status', { phase: 'starting', maxTurns: turns, customEvents });
+    const { runSimulation } = await import('../runtime/orchestrator.js');
+    const onEvent = (event) => broadcast('sim', event);
+    broadcast('status', {
+        phase: 'parallel',
+        leaders: leaders.map(leader => ({
+            name: leader.name,
+            archetype: leader.archetype,
+            colony: leader.colony,
+            hexaco: leader.hexaco,
+        })),
+    });
+    console.log(`  Running: ${leaders[0].name} vs ${leaders[1].name} | ${turns} turns | seed ${seed}\n`);
+    const results = await Promise.allSettled(leaders.map((leader, index) => {
+        const tag = leader.archetype.toLowerCase().replace(/^the\s+/, '').replace(/\s+/g, '-') || `leader-${index}`;
+        return runSimulation(leader, simConfig.keyPersonnel ?? DEFAULT_KEY_PERSONNEL, {
+            maxTurns: turns,
+            seed,
+            startYear,
+            yearsPerTurn: simConfig.yearsPerTurn,
+            liveSearch,
+            activeDepartments: simConfig.activeDepartments,
+            onEvent,
+            customEvents,
+            provider: simConfig.provider,
+            models: simConfig.models,
+            economics: simConfig.economics,
+            initialPopulation: simConfig.initialPopulation,
+            startingResources: simConfig.startingResources,
+            startingPolitics: simConfig.startingPolitics,
+            execution: simConfig.execution,
+            scenario,
+            signal,
+        }).then(result => {
+            broadcast('result', {
+                leader: tag,
+                summary: {
+                    population: result.finalState?.colony?.population,
+                    morale: result.finalState?.colony?.morale,
+                    toolsForged: result.totalToolsForged,
+                    citations: result.totalCitations,
+                },
+                fingerprint: result.fingerprint || null,
+            });
+            return { tag, leader, result };
+        }, error => {
+            broadcast('sim_error', { leader: tag, error: String(error) });
+            throw error;
+        });
+    }));
+    // Generate final verdict comparing both leaders
+    const settled = results.filter(r => r.status === 'fulfilled').map(r => r.value);
+    // Skip verdict generation when EITHER leader was cancelled externally
+    // (user navigated away → server pulled the plug) or hit a terminal
+    // provider error. Running the verdict LLM call on partial data would
+    // burn an extra flagship call for a comparison that doesn't mean
+    // anything on incomplete runs. The dashboard shows the "Unfinished"
+    // badge in place of the verdict card.
+    const anyAborted = settled.some(v => v.result?.aborted === true || v.result?.providerError);
+    if (anyAborted) {
+        broadcast('complete', { timestamp: new Date().toISOString(), aborted: true });
+        return;
+    }
+    if (settled.length === 2) {
+        try {
+            const [a, b] = settled;
+            const colA = a.result.finalState?.colony;
+            const colB = b.result.finalState?.colony;
+            const verdictModel = resolveVerdictModel(simConfig.provider || 'openai', simConfig.economics);
+            if (!verdictModel) {
+                broadcast('complete', {
+                    timestamp: new Date().toISOString(),
+                    verdictSkipped: true,
+                    economicsProfile: simConfig.economics.id,
+                });
+                return;
+            }
+            // Build a richer per-leader summary including innovation telemetry
+            // (forged toolbox details, fingerprint classification) so the LLM
+            // verdict actually reasons about emergent tool use, not just final
+            // colony numbers.
+            const formatLeader = (label, v, col) => {
+                const fp = v.result.fingerprint || {};
+                const toolbox = v.result.forgedToolbox || [];
+                const topTools = toolbox.slice(0, 5).map((t) => `${t.name}(${t.firstForgedDepartment}, reused ${t.reuseCount}x)`).join('; ');
+                // Cause-of-death breakdown. Each death in the event log carries
+                // an attributed cause (natural, radiation cancer, starvation,
+                // despair, fatal fracture, accident). Roll up for the verdict
+                // prompt so the LLM can reason about HOW colonists died, not
+                // just how many — a Mars colony losing 5 to radiation reads
+                // very differently from losing 5 to accidents.
+                const deathEvents = (v.result.finalState?.eventLog ?? []).filter((e) => e.type === 'death');
+                const causeCounts = {};
+                for (const d of deathEvents) {
+                    const raw = d.cause ?? 'unknown';
+                    const key = raw.startsWith('accident:') ? 'accident' : raw;
+                    causeCounts[key] = (causeCounts[key] ?? 0) + 1;
+                }
+                const causeSummary = Object.keys(causeCounts).length > 0
+                    ? Object.entries(causeCounts).sort((a, b) => b[1] - a[1]).map(([k, n]) => `${n} ${k}`).join(', ')
+                    : 'no deaths';
+                return [
+                    `${label}: ${v.leader.name} "${v.leader.archetype}" (${v.leader.colony})`,
+                    `  HEXACO: O${v.leader.hexaco.openness.toFixed(2)} C${v.leader.hexaco.conscientiousness.toFixed(2)} E${v.leader.hexaco.extraversion.toFixed(2)} A${v.leader.hexaco.agreeableness.toFixed(2)} Em${v.leader.hexaco.emotionality.toFixed(2)} HH${v.leader.hexaco.honestyHumility.toFixed(2)}`,
+                    `  Final: Pop ${col?.population ?? '?'}, Morale ${Math.round((col?.morale ?? 0) * 100)}%, Food ${col?.foodMonthsReserve?.toFixed(1) ?? '?'}mo, Power ${col?.powerKw?.toFixed(0) ?? '?'}kW, Modules ${col?.infrastructureModules?.toFixed(1) ?? '?'}, Science ${col?.scienceOutput ?? '?'}`,
+                    `  Mortality: ${deathEvents.length} total (${causeSummary})`,
+                    `  Innovation: ${toolbox.length} unique tools forged (${fp.innovation || 'n/a'}), citations ${v.result.totalCitations}`,
+                    topTools ? `  Top tools: ${topTools}` : '  No tools forged',
+                    `  Fingerprint: ${fp.summary || 'n/a'}`,
+                    `  Cost: $${v.result.cost?.totalCostUSD?.toFixed(4) ?? '?'} over ${v.result.cost?.llmCalls ?? '?'} LLM calls`,
+                ].join('\n');
+            };
+            // Verdict runs once per completed sim and is the single most
+            // user-facing synthesis call in the pipeline: it reads both
+            // final states, the per-leader cause-of-death breakdown, the
+            // forged toolbox, and writes the headline + summary that the
+            // user sees first when the run finishes. Cheap-tier output on
+            // this call was noticeably flatter than flagship output, so
+            // pay the ~$0.02-0.05 per run for the better read.
+            try {
+                const { object: verdict, fromFallback } = await generateValidatedObject({
+                    provider: simConfig.provider || 'openai',
+                    model: verdictModel,
+                    schema: VerdictSchema,
+                    schemaName: 'Verdict',
+                    prompt: `You are judging a colony simulation. Two AI commanders with opposing HEXACO personality profiles led identical colonies through ${turns} turns from the same starting conditions and deterministic seed. Your job is to write a verdict that explains WHY the runs diverged the way they did, not just WHO won.
+
+${formatLeader('LEADER A', a, colA)}
+
+${formatLeader('LEADER B', b, colB)}
+
+TRADEOFFS TO WEIGH
+Tool forging is a cost / capability tradeoff: every forged tool spent a judge LLM call and ate analyst attention; failed forges hurt morale and produced no reusable capability; successful tools let later decisions reason about concrete numbers. A leader who built few tools and reused them many times has a disciplined, cost-efficient signature. A leader who forged many novel tools has an exploratory signature with broader capability surface. Both are valid strategies and your scoring should reflect that trade, not punish either extreme.
+
+Mortality is a cause-specific signal, not a number. The "Mortality" line above names HOW each colonist died. A leader who lost 5 to starvation made different resource-allocation decisions than a leader who lost 5 to radiation cancer; a leader with despair deaths presided over a colony in psychological freefall. Reference the specific causes when they shape the story.
+
+REASONING — populate the "reasoning" field of your JSON response with a numbered list covering:
+  (1) Population trajectory — how did each colony's population evolve, and which tradeoffs produced that shape?
+  (2) Morale + psychological state — which leader's colony held together emotionally, and what does that say about HEXACO + decision style?
+  (3) Resource efficiency — food, power, infrastructure — which side ran leaner, which hit crises?
+  (4) Innovation signature — tools forged vs reused, breadth vs depth. What does each leader's toolbox say about their cognition?
+  (5) Mortality story — which causes dominated each side, and what does THAT say about the leader's priorities?
+  (6) The single most impactful divergence — resource decision, crisis response, tool strategy, or emergent behavior. Name it precisely.
+  (7) Weighing the tradeoffs, who won and why.
+
+Then fill out:
+  winner: "A" or "B" or "tie"
+  winnerName: the winning leader's name, or "Tie" for a tie
+  headline: one-line verdict grounded in the key divergence (max 80 chars)
+  summary: 2-3 sentences naming the personality + tool-use + mortality pattern that drove the divergence
+  keyDivergence: the single most impactful difference between the two runs
+  scores: { a: { survival, prosperity, morale, innovation }, b: { survival, prosperity, morale, innovation } } — each 0-10`,
+                });
+                if (fromFallback) {
+                    console.log('  Verdict schema fallback; skipping broadcast');
+                }
+                else {
+                    broadcast('verdict', {
+                        ...verdict,
+                        leaderA: { name: a.leader.name, archetype: a.leader.archetype, colony: a.leader.colony },
+                        leaderB: { name: b.leader.name, archetype: b.leader.archetype, colony: b.leader.colony },
+                        finalStats: {
+                            a: { population: colA?.population, morale: colA?.morale, food: colA?.foodMonthsReserve, power: colA?.powerKw, modules: colA?.infrastructureModules, science: colA?.scienceOutput, tools: a.result.totalToolsForged },
+                            b: { population: colB?.population, morale: colB?.morale, food: colB?.foodMonthsReserve, power: colB?.powerKw, modules: colB?.infrastructureModules, science: colB?.scienceOutput, tools: b.result.totalToolsForged },
+                        },
+                    });
+                    console.log(`\n  VERDICT: ${verdict.headline}`);
+                    console.log(`  Winner: ${verdict.winnerName} (${verdict.winner})`);
+                    console.log(`  ${verdict.summary}\n`);
+                }
+            }
+            catch (verdictErr) {
+                console.log('  Verdict generation failed:', verdictErr);
+            }
+        }
+        catch (outerErr) {
+            console.log('  Verdict outer failure:', outerErr);
+        }
+    }
+    broadcast('complete', { timestamp: new Date().toISOString() });
+}
+//# sourceMappingURL=pair-runner.js.map

package/dist/cli/pair-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-runner.js","sourceRoot":"","sources":["../../src/cli/pair-runner.ts"],"names":[],"mappings":"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"}

package/dist/cli/rate-limiter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * IP-based rate limiter with optional JSON-file persistence.
+ *
+ * Extracted from server-app.ts so the quota machinery can be unit-tested
+ * without spinning up the whole HTTP server and so createMarsServer reads
+ * more like a route file. Behavior is unchanged.
+ *
+ * Three buckets keyed by IP:
+ *   - simStore / maxPerDay:        /setup (most expensive action, daily)
+ *   - compileStore / maxCompilePerDay: /compile (~$0.10 per call, daily)
+ *   - chatStore / maxChatPerHour:  /chat (hourly, users legitimately
+ *                                  burst but scripts/loops flatten the
+ *                                  budget if unlimited)
+ *
+ * When a persistencePath is supplied, state is loaded on construct and
+ * flushed on every mutation via a 500ms-debounced atomic write
+ * (tmp + rename). pm2 restarts preserve user quotas. Missing or corrupt
+ * files self-heal at next mutation.
+ *
+ * @module paracosm/cli/rate-limiter
+ */
+import type { IncomingMessage } from 'node:http';
+export interface RateLimitDecision {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+    limit: number;
+}
+export declare class IpRateLimiter {
+    private simStore;
+    private compileStore;
+    private chatStore;
+    private maxPerDay;
+    private maxCompilePerDay;
+    private maxChatPerHour;
+    private cleanupTimer;
+    private persistencePath;
+    private persistTimer;
+    constructor(maxPerDay?: number, maxCompilePerDay?: number, maxChatPerHour?: number, persistencePath?: string | null);
+    /** Load persisted state from disk. Silently tolerates missing/corrupt files. */
+    private load;
+    /** Debounced flush to disk. Writes atomically via tmp+rename. */
+    private persist;
+    /** Extract client IP, respecting reverse proxy headers (nginx, Cloudflare, etc.) */
+    static getIp(req: IncomingMessage): string;
+    private nextReset;
+    private bump;
+    /** Check the simulation-per-day quota without consuming it. */
+    check(ip: string): RateLimitDecision;
+    /** Record a simulation start. Prefer `check` + `record` for legacy callers. */
+    record(ip: string): void;
+    /** Check AND consume a slot for /compile (daily bucket, ~$0.10/call). */
+    consumeCompile(ip: string): RateLimitDecision;
+    /** Check AND consume a slot for /chat (hourly bucket). */
+    consumeChat(ip: string): RateLimitDecision;
+    /** Get stats for monitoring endpoints. */
+    stats(): {
+        totalIps: number;
+        sim: Array<{
+            ip: string;
+            count: number;
+            resetAt: string;
+        }>;
+        compile: Array<{
+            ip: string;
+            count: number;
+            resetAt: string;
+        }>;
+        chat: Array<{
+            ip: string;
+            count: number;
+            resetAt: string;
+        }>;
+    };
+    private cleanup;
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/cli/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/cli/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAcjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAA8C;gBAGhE,SAAS,GAAE,MAAU,EACrB,gBAAgB,GAAE,MAAU,EAC5B,cAAc,GAAE,MAAY,EAC5B,eAAe,GAAE,MAAM,GAAG,IAAW;IAUvC,gFAAgF;IAChF,OAAO,CAAC,IAAI;IAyBZ,iEAAiE;IACjE,OAAO,CAAC,OAAO;IA0Bf,oFAAoF;IACpF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM;IAa1C,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,IAAI;IAyBZ,+DAA+D;IAC/D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB;IAIpC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB;IAI7C,0DAA0D;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB;IAI1C,0CAA0C;IAC1C,KAAK,IAAI;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7D;IAWD,OAAO,CAAC,OAAO;IAcf,OAAO,IAAI,IAAI;CAIhB"}