paracosm 0.0.1 → 0.2.0

package/dist/cli/types.d.ts

@@ -0,0 +1,73 @@
+import type { HexacoProfile } from '../engine/core/state.js';
+export type { HexacoProfile };
+export interface LeaderConfig {
+    name: string;
+    archetype: string;
+    colony: string;
+    hexaco: HexacoProfile;
+    instructions: string;
+}
+export interface Citation {
+    text: string;
+    url: string;
+    doi?: string;
+    context: string;
+}
+export interface ForgedToolRecord {
+    name: string;
+    mode: 'compose' | 'sandbox';
+    description: string;
+    confidence: number;
+    judgeVerdict: 'approved' | 'rejected';
+}
+export interface ColonySnapshot {
+    population: number;
+    waterLitersPerDay: number;
+    foodMonthsReserve: number;
+    powerKw: number;
+    morale: number;
+    infrastructureModules: number;
+    scienceOutput: number;
+    unplannedDeaths: number;
+    toolsForgedTotal: number;
+}
+export interface TurnResult {
+    turn: number;
+    year: number;
+    title: string;
+    crisis: string;
+    decision: string;
+    reasoning: string;
+    citations: Citation[];
+    toolsForged: ForgedToolRecord[];
+    snapshot: ColonySnapshot;
+    rawResponse: string;
+}
+export interface SimulationLog {
+    simulation: 'mars-genesis';
+    version: '1.0.0';
+    startedAt: string;
+    completedAt: string;
+    leader: Omit<LeaderConfig, 'instructions'>;
+    turns: TurnResult[];
+    finalAssessment: {
+        population: number;
+        toolsForged: number;
+        unplannedDeaths: number;
+        scienceOutput: number;
+        infrastructureModules: number;
+        morale: number;
+    };
+}
+export interface Scenario {
+    turn: number;
+    year: number;
+    title: string;
+    crisis: string;
+    researchKeywords: string[];
+    snapshotHints: Partial<ColonySnapshot>;
+    riskyOption: string;
+    riskSuccessProbability: number;
+    options?: import('../runtime/contracts.js').CrisisOption[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC3C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,yBAAyB,EAAE,YAAY,EAAE,CAAC;CAC5D"}

package/dist/cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":""}

package/dist/engine/_template/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SCENARIO TEMPLATE — Replace "my-scenario" with your scenario name.
+ *
+ * Copy this entire _template/ directory and fill in each file.
+ * See src/engine/mars/ and src/engine/lunar/ for complete examples.
+ */
+import type { ScenarioPackage } from '../types.js';
+export declare const myScenario: ScenarioPackage;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/_template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/_template/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAcnD,eAAO,MAAM,UAAU,EAAE,eAoFxB,CAAC"}

package/dist/engine/_template/index.js

@@ -0,0 +1,91 @@
+/**
+ * SCENARIO TEMPLATE — Replace "my-scenario" with your scenario name.
+ *
+ * Copy this entire _template/ directory and fill in each file.
+ * See src/engine/mars/ and src/engine/lunar/ for complete examples.
+ */
+// Import your scenario components:
+// import { MY_CATEGORY_EFFECTS } from './effects.js';
+// import { MY_WORLD_METRICS, MY_CAPACITY_METRICS } from './metrics.js';
+// import { MY_EVENT_DEFINITIONS } from './events.js';
+// import { myProgressionHook } from './progression-hooks.js';
+// import { myDepartmentPromptLines, myDirectorInstructions } from './prompts.js';
+// import { MY_KNOWLEDGE_BUNDLE } from './research-bundle.js';
+// import { MY_DEFAULT_KEY_PERSONNEL, MY_DEFAULT_LEADERS } from './presets.js';
+// import { myFingerprint } from './fingerprint.js';
+// import { myPoliticsHook } from './politics.js';
+// import { myReactionContext } from './reactions.js';
+// import { getMyMilestoneCrisis } from './milestones.js';
+export const myScenario = {
+    id: 'my-scenario',
+    version: '1.0.0',
+    engineArchetype: 'closed_turn_based_settlement',
+    labels: {
+        name: 'My Scenario',
+        shortName: 'my',
+        populationNoun: 'members',
+        settlementNoun: 'settlement',
+        currency: 'credits',
+    },
+    theme: {
+        primaryColor: '#22c55e',
+        accentColor: '#86efac',
+        cssVariables: {},
+    },
+    setup: {
+        defaultTurns: 8,
+        defaultSeed: 100,
+        defaultStartYear: 2040,
+        defaultPopulation: 50,
+        configurableSections: ['leaders', 'personnel', 'resources', 'departments', 'events', 'models', 'advanced'],
+    },
+    world: {
+        metrics: {},
+        capacities: {},
+        statuses: {},
+        politics: {},
+        environment: {},
+    },
+    departments: [
+    // { id: 'engineering', label: 'Engineering', role: 'Chief Engineer', icon: '⚙️', defaultModel: 'gpt-5.4-mini', instructions: '...' },
+    ],
+    metrics: [
+    // { id: 'population', label: 'Population', source: 'metrics.population', format: 'number' },
+    ],
+    events: [
+    // { id: 'crisis', label: 'Crisis', icon: '⚠️', color: '#ef4444' },
+    ],
+    effects: [
+    // { id: 'category_effects', type: 'category_outcome', label: 'Category Effects', categoryDefaults: MY_CATEGORY_EFFECTS },
+    ],
+    ui: {
+        headerMetrics: [],
+        tooltipFields: [],
+        reportSections: ['crisis', 'departments', 'decision', 'outcome'],
+        departmentIcons: {},
+        eventRenderers: {},
+        setupSections: ['leaders', 'personnel', 'resources', 'departments', 'events', 'models', 'advanced'],
+    },
+    knowledge: {
+        topics: {},
+        categoryMapping: {},
+    },
+    policies: {
+        toolForging: { enabled: true },
+        liveSearch: { enabled: false, mode: 'off' },
+        bulletin: { enabled: true },
+        characterChat: { enabled: true },
+        sandbox: { timeoutMs: 10000, memoryMB: 128 },
+    },
+    presets: [],
+    hooks: {
+    // progressionHook: myProgressionHook,
+    // departmentPromptHook: (ctx) => myDepartmentPromptLines(ctx.department, ctx.state),
+    // directorInstructions: myDirectorInstructions,
+    // fingerprintHook: myFingerprint,
+    // politicsHook: myPoliticsHook,
+    // reactionContextHook: myReactionContext,
+    // getMilestoneCrisis: getMyMilestoneCrisis,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/engine/_template/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/_template/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,mCAAmC;AACnC,sDAAsD;AACtD,wEAAwE;AACxE,sDAAsD;AACtD,8DAA8D;AAC9D,kFAAkF;AAClF,8DAA8D;AAC9D,+EAA+E;AAC/E,oDAAoD;AACpD,kDAAkD;AAClD,sDAAsD;AACtD,0DAA0D;AAE1D,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,8BAA8B;IAE/C,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,SAAS;QACzB,cAAc,EAAE,YAAY;QAC5B,QAAQ,EAAE,SAAS;KACpB;IAED,KAAK,EAAE;QACL,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,EAAE;KACjB;IAED,KAAK,EAAE;QACL,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,EAAE;QACrB,oBAAoB,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;KAC3G;IAED,KAAK,EAAE;QACL,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;KAChB;IAED,WAAW,EAAE;IACX,sIAAsI;KACvI;IAED,OAAO,EAAE;IACP,6FAA6F;KAC9F;IAED,MAAM,EAAE;IACN,mEAAmE;KACpE;IAED,OAAO,EAAE;IACP,0HAA0H;KAC3H;IAED,EAAE,EAAE;QACF,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,CAAC;QAChE,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;KACpG;IAED,SAAS,EAAE;QACT,MAAM,EAAE,EAAE;QACV,eAAe,EAAE,EAAE;KACpB;IAED,QAAQ,EAAE;QACR,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC9B,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;QAC3C,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAChC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE;KAC7C;IAED,OAAO,EAAE,EAAE;IAEX,KAAK,EAAE;IACL,sCAAsC;IACtC,qFAAqF;IACrF,gDAAgD;IAChD,kCAAkC;IAClC,gCAAgC;IAChC,0CAA0C;IAC1C,4CAA4C;KAC7C;CACF,CAAC"}

package/dist/engine/compiler/cache.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Disk cache for generated scenario hooks.
+ * Stores generated hook source alongside a manifest tracking
+ * the scenario hash, model used, and generation timestamp.
+ */
+/** SHA-256 hash of the scenario JSON, used for cache invalidation. */
+export declare function hashScenario(scenarioJson: Record<string, unknown>): string;
+/** Read a cached hook result. Returns null on cache miss. */
+export declare function readCache(scenarioJson: Record<string, unknown>, hookName: string, model: string, baseDir?: string): string | null;
+/** Write a hook result to disk cache. */
+export declare function writeCache(scenarioJson: Record<string, unknown>, hookName: string, content: string, model: string, baseDir?: string): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/engine/compiler/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK1E;AAOD,6DAA6D;AAC7D,wBAAgB,SAAS,CACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,SAAoB,GAC1B,MAAM,GAAG,IAAI,CAqBf;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,SAAoB,GAC1B,IAAI,CA0BN"}

package/dist/engine/compiler/cache.js

@@ -0,0 +1,75 @@
+/**
+ * Disk cache for generated scenario hooks.
+ * Stores generated hook source alongside a manifest tracking
+ * the scenario hash, model used, and generation timestamp.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_CACHE_DIR = '.paracosm/cache';
+/** SHA-256 hash of the scenario JSON, used for cache invalidation. */
+export function hashScenario(scenarioJson) {
+    return createHash('sha256')
+        .update(JSON.stringify(scenarioJson, null, 0))
+        .digest('hex')
+        .slice(0, 16);
+}
+/** Build the cache directory path for a scenario + version combo. */
+function cacheDir(scenarioId, version, baseDir) {
+    return join(baseDir, `${scenarioId}-v${version}`);
+}
+/** Read a cached hook result. Returns null on cache miss. */
+export function readCache(scenarioJson, hookName, model, baseDir = DEFAULT_CACHE_DIR) {
+    const id = scenarioJson.id ?? 'unknown';
+    const ver = scenarioJson.version ?? '0.0.0';
+    const dir = cacheDir(id, ver, baseDir);
+    const manifestPath = join(dir, 'manifest.json');
+    if (!existsSync(manifestPath))
+        return null;
+    try {
+        const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+        const currentHash = hashScenario(scenarioJson);
+        if (manifest.scenarioHash !== currentHash)
+            return null;
+        if (manifest.model !== model)
+            return null;
+        const hookFile = manifest.hooks[hookName];
+        if (!hookFile)
+            return null;
+        const hookPath = join(dir, hookFile);
+        if (!existsSync(hookPath))
+            return null;
+        return readFileSync(hookPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Write a hook result to disk cache. */
+export function writeCache(scenarioJson, hookName, content, model, baseDir = DEFAULT_CACHE_DIR) {
+    const id = scenarioJson.id ?? 'unknown';
+    const ver = scenarioJson.version ?? '0.0.0';
+    const dir = cacheDir(id, ver, baseDir);
+    mkdirSync(dir, { recursive: true });
+    const manifestPath = join(dir, 'manifest.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        manifest = {
+            scenarioHash: hashScenario(scenarioJson),
+            model,
+            timestamp: new Date().toISOString(),
+            hooks: {},
+        };
+    }
+    const fileName = `${hookName}.ts`;
+    writeFileSync(join(dir, fileName), content, 'utf-8');
+    manifest.hooks[hookName] = fileName;
+    manifest.scenarioHash = hashScenario(scenarioJson);
+    manifest.model = model;
+    manifest.timestamp = new Date().toISOString();
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+//# sourceMappingURL=cache.js.map

package/dist/engine/compiler/cache.js.map

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

package/dist/engine/compiler/generate-director.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate Crisis Director system instructions from scenario JSON via LLM.
+ */
+import type { GenerateTextFn } from './types.js';
+export declare function generateDirectorInstructions(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: () => string;
+    source: string;
+}>;
+//# sourceMappingURL=generate-director.d.ts.map

package/dist/engine/compiler/generate-director.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-director.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-director.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6BjD,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCjD"}

package/dist/engine/compiler/generate-director.js

@@ -0,0 +1,57 @@
+/**
+ * Generate Crisis Director system instructions from scenario JSON via LLM.
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const depts = (scenarioJson.departments ?? []).map((d) => `- ${d.id}: ${d.label} (${d.role})`).join('\n');
+    const effects = scenarioJson.effects ?? {};
+    const categories = typeof effects === 'object' && !Array.isArray(effects)
+        ? Object.keys(effects)
+        : effects.flatMap?.((e) => Object.keys(e.categoryDefaults ?? {})) ?? [];
+    return `You are generating system instructions for a Crisis Director agent in a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'}
+SETTLEMENT TYPE: ${labels.settlementNoun ?? 'settlement'}
+POPULATION NOUN: ${labels.populationNoun ?? 'members'}
+DEPARTMENTS:
+${depts}
+CRISIS CATEGORIES: ${categories.join(', ')}
+
+Generate complete Crisis Director system instructions. The instructions must:
+1. Explain the Director's role: observe ${labels.settlementNoun} state and generate crises
+2. List rules for crisis generation (exactly 2-3 options per crisis, one must be risky, reference real science/domain knowledge, escalate from prior decisions, calibrate to ${labels.settlementNoun} state)
+3. List ALL crisis categories with brief descriptions relevant to this scenario's domain
+4. List ALL available departments by exact ID name (use ONLY the department IDs listed above)
+5. Specify the JSON output format: {"title","crisis","options":[{"id","label","description","isRisky"}],"riskyOptionId","riskSuccessProbability","category","researchKeywords","relevantDepartments","turnSummary"}
+
+Return ONLY the instructions text. No markdown fences. No code. Just the system prompt text the Director agent will receive.`;
+}
+export async function generateDirectorInstructions(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const cleaned = text.trim().replace(/^```(?:text)?\n?/i, '').replace(/\n?```$/i, '').trim();
+        if (cleaned.length < 100) {
+            lastError = 'Instructions too short';
+            continue;
+        }
+        // Verify it mentions at least some departments
+        const deptIds = (scenarioJson.departments ?? []).map((d) => d.id);
+        const mentioned = deptIds.filter((id) => cleaned.toLowerCase().includes(id.toLowerCase()));
+        if (mentioned.length < Math.min(2, deptIds.length)) {
+            lastError = `Only mentions ${mentioned.length} of ${deptIds.length} departments`;
+            continue;
+        }
+        return {
+            hook: () => cleaned,
+            source: cleaned,
+        };
+    }
+    // Fallback: generic instructions
+    const deptList = (scenarioJson.departments ?? []).map((d) => d.id).join(', ');
+    const fallback = `You are the Crisis Director for a ${scenarioJson.labels?.settlementNoun ?? 'settlement'} simulation. Generate crises with 2-3 options (one risky). Available departments: ${deptList}. Return JSON with title, crisis, options, riskyOptionId, riskSuccessProbability, category, researchKeywords, relevantDepartments, turnSummary.`;
+    console.warn('[compiler] Director instructions generation failed. Using fallback.');
+    return { hook: () => fallback, source: fallback };
+}
+//# sourceMappingURL=generate-director.js.map

package/dist/engine/compiler/generate-director.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-director.js","sourceRoot":"","sources":["../../../src/engine/compiler/generate-director.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,SAAS,WAAW,CAAC,YAAiC;IACpD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/G,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACvE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC,CAAE,OAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1F,OAAO;;YAEG,MAAM,CAAC,IAAI,IAAI,SAAS;mBACjB,MAAM,CAAC,cAAc,IAAI,YAAY;mBACrC,MAAM,CAAC,cAAc,IAAI,SAAS;;EAEnD,KAAK;qBACc,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;0CAGA,MAAM,CAAC,cAAc;+KACgH,MAAM,CAAC,cAAc;;;;;6HAKvE,CAAC;AAC9H,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,YAAiC,EACjC,YAA4B,EAC5B,UAAU,GAAG,CAAC;IAEd,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAgC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5F,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACzB,SAAS,GAAG,wBAAwB,CAAC;YACrC,SAAS;QACX,CAAC;QAED,+CAA+C;QAC/C,MAAM,OAAO,GAAG,CAAC,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACnG,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,SAAS,GAAG,iBAAiB,SAAS,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,cAAc,CAAC;YACjF,SAAS;QACX,CAAC;QAED,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;YACnB,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,qCAAqC,YAAY,CAAC,MAAM,EAAE,cAAc,IAAI,YAAY,qFAAqF,QAAQ,iJAAiJ,CAAC;IACxV,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IACpF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC"}

package/dist/engine/compiler/generate-fingerprint.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a fingerprint hook from scenario JSON via LLM.
+ * The fingerprint classifies the final simulation timeline into
+ * scenario-relevant categories (resilience, governance style, etc.).
+ */
+import type { GenerateTextFn } from './types.js';
+export declare function parseResponse(text: string): ((finalState: any, outcomeLog: any[], leader: any, toolRegs: Record<string, string[]>, maxTurns: number) => Record<string, string>) | null;
+export declare function generateFingerprintHook(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (finalState: any, outcomeLog: any[], leader: any, toolRegs: Record<string, string[]>, maxTurns: number) => Record<string, string>;
+    source: string;
+}>;
+//# sourceMappingURL=generate-fingerprint.d.ts.map

package/dist/engine/compiler/generate-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-fingerprint.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA+BjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAYtL;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CtK"}

package/dist/engine/compiler/generate-fingerprint.js

@@ -0,0 +1,86 @@
+/**
+ * Generate a fingerprint hook from scenario JSON via LLM.
+ * The fingerprint classifies the final simulation timeline into
+ * scenario-relevant categories (resilience, governance style, etc.).
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const depts = (scenarioJson.departments ?? []).map((d) => d.id).join(', ');
+    return `You are generating a timeline fingerprint hook for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'} — ${labels.settlementNoun ?? 'settlement'} simulation
+DEPARTMENTS: ${depts}
+
+Generate a TypeScript arrow function that classifies a simulation timeline. The function receives:
+- finalState: { agents: array, colony: Record<string, number>, politics: Record<string, any>, metadata: { currentYear: number, startYear: number } }
+- outcomeLog: array of { turn: number, year: number, outcome: 'risky_success' | 'risky_failure' | 'conservative_success' | 'conservative_failure' }
+- leader: { name: string, archetype: string, hexaco: Record<string, number> }
+- toolRegs: Record<string, string[]> (department -> tool names)
+- maxTurns: number
+
+Return an object with string values for 5-7 classification dimensions relevant to this scenario domain, plus a "summary" key joining them with " · ".
+
+Rules:
+1. Use scenario-relevant classification names (not Mars-specific ones)
+2. Each dimension should have 2-3 possible values (e.g., "resilient" | "brittle" | "antifragile")
+3. Base classifications on final state data, outcome patterns, and leader personality
+4. Always include a "summary" key that joins all dimension values with " · "
+5. Do NOT use external imports
+6. Return the function as a TypeScript arrow function
+
+Return ONLY the function, no markdown fences, no explanation.`;
+}
+export function parseResponse(text) {
+    let cleaned = text.trim();
+    cleaned = cleaned.replace(/^```(?:typescript|ts)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    if (cleaned.endsWith(';'))
+        cleaned = cleaned.slice(0, -1).trim();
+    try {
+        const fn = new Function('return ' + cleaned)();
+        if (typeof fn === 'function')
+            return fn;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function generateFingerprintHook(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const fn = parseResponse(text);
+        if (!fn) {
+            lastError = 'Could not parse response into a function';
+            continue;
+        }
+        // Quick smoke test
+        try {
+            const result = fn({ agents: [], colony: { morale: 0.6, population: 80 }, politics: { earthDependencyPct: 50 }, metadata: { currentYear: 2070, startYear: 2035 } }, [{ turn: 1, year: 2035, outcome: 'conservative_success' }], { name: 'Test', archetype: 'test', hexaco: { openness: 0.5, conscientiousness: 0.5, extraversion: 0.5, agreeableness: 0.5, emotionality: 0.5, honestyHumility: 0.5 } }, { engineering: ['tool1'] }, 8);
+            if (typeof result !== 'object' || !result.summary) {
+                lastError = 'Fingerprint must return object with summary key';
+                continue;
+            }
+            return { hook: fn, source: text.trim() };
+        }
+        catch (err) {
+            lastError = String(err);
+        }
+    }
+    // Fallback: generic fingerprint
+    console.warn('[compiler] Fingerprint hook generation failed. Using fallback.');
+    const fallback = (finalState, outcomeLog, leader, toolRegs, maxTurns) => {
+        const riskyWins = outcomeLog.filter(o => o.outcome === 'risky_success').length;
+        const riskyLosses = outcomeLog.filter(o => o.outcome === 'risky_failure').length;
+        const conservativeWins = outcomeLog.filter(o => o.outcome === 'conservative_success').length;
+        const totalTools = Object.values(toolRegs).flat().length;
+        const riskProfile = riskyWins + riskyLosses > conservativeWins ? 'expansionist' : 'conservative';
+        const innovation = totalTools > maxTurns * 2 ? 'innovative' : totalTools > maxTurns ? 'adaptive' : 'conventional';
+        const leadership = leader.hexaco?.extraversion > 0.7 ? 'charismatic' : leader.hexaco?.conscientiousness > 0.7 ? 'methodical' : 'collaborative';
+        const summary = `${riskProfile} · ${innovation} · ${leadership}`;
+        return { riskProfile, innovation, leadership, summary };
+    };
+    return { hook: fallback, source: '// Fallback fingerprint' };
+}
+//# sourceMappingURL=generate-fingerprint.js.map

package/dist/engine/compiler/generate-fingerprint.js.map

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

package/dist/engine/compiler/generate-milestones.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate milestone crises (turn 1 founding + final turn assessment) from scenario JSON via LLM.
+ */
+import type { MilestoneEventDef } from '../types.js';
+import type { GenerateTextFn } from './types.js';
+export declare function parseMilestones(text: string): [MilestoneEventDef, MilestoneEventDef] | null;
+export declare function generateMilestones(scenarioJson: Record<string, any>, generateText: GenerateTextFn, maxRetries?: number): Promise<{
+    hook: (turn: number, maxTurns: number) => MilestoneEventDef | null;
+    source: string;
+}>;
+//# sourceMappingURL=generate-milestones.d.ts.map

package/dist/engine/compiler/generate-milestones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-milestones.d.ts","sourceRoot":"","sources":["../../../src/engine/compiler/generate-milestones.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuCjD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAa3F;AAED,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjC,YAAY,EAAE,cAAc,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,iBAAiB,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoEjG"}

package/dist/engine/compiler/generate-milestones.js

@@ -0,0 +1,121 @@
+/**
+ * Generate milestone crises (turn 1 founding + final turn assessment) from scenario JSON via LLM.
+ */
+function buildPrompt(scenarioJson) {
+    const labels = scenarioJson.labels ?? {};
+    const depts = (scenarioJson.departments ?? []).map((d) => d.id).join(', ');
+    return `You are generating milestone crises for a simulation engine.
+
+SCENARIO: ${labels.name ?? 'Unknown'}
+SETTLEMENT TYPE: ${labels.settlementNoun ?? 'settlement'}
+POPULATION NOUN: ${labels.populationNoun ?? 'members'}
+DEPARTMENTS: ${depts}
+DEFAULT TURNS: ${scenarioJson.setup?.defaultTurns ?? 12}
+
+Generate TWO milestone crises as a JSON array:
+
+1. FOUNDING CRISIS (turn 1): The ${labels.populationNoun} arrive at the ${labels.settlementNoun}. They must make their first major decision (site selection, initial strategy, resource allocation). Two options: safe/conservative vs risky/ambitious. Include domain-specific science and real-world references.
+
+2. LEGACY ASSESSMENT (final turn): The ${labels.settlementNoun} must submit a comprehensive status report. Asks the commander to evaluate population, infrastructure, self-sufficiency, science, culture, tools built, and legacy. Two options: honest assessment vs ambitious projection.
+
+Each milestone must have this exact JSON shape:
+{
+  "title": "string",
+  "crisis": "string (detailed description with specific domain references)",
+  "options": [
+    { "id": "option_a", "label": "string", "description": "string", "isRisky": false },
+    { "id": "option_b", "label": "string", "description": "string", "isRisky": true }
+  ],
+  "riskyOptionId": "option_b",
+  "riskSuccessProbability": 0.5-0.7,
+  "category": "string",
+  "researchKeywords": ["string"],
+  "relevantDepartments": ["string"],
+  "turnSummary": "string"
+}
+
+Return ONLY a JSON array of exactly 2 objects: [founding, legacy]. No markdown fences.`;
+}
+export function parseMilestones(text) {
+    let cleaned = text.trim();
+    cleaned = cleaned.replace(/^```(?:json)?\n?/i, '').replace(/\n?```$/i, '').trim();
+    try {
+        const arr = JSON.parse(cleaned);
+        if (!Array.isArray(arr) || arr.length < 2)
+            return null;
+        const [founding, legacy] = arr;
+        if (!founding.title || !founding.options || !legacy.title || !legacy.options)
+            return null;
+        return [founding, legacy];
+    }
+    catch {
+        return null;
+    }
+}
+export async function generateMilestones(scenarioJson, generateText, maxRetries = 3) {
+    let lastError = '';
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const retryHint = attempt > 0 ? `\n\nPrevious attempt failed: ${lastError}. Fix the issue and return valid JSON.` : '';
+        const text = await generateText(buildPrompt(scenarioJson) + retryHint);
+        const result = parseMilestones(text);
+        if (!result) {
+            lastError = 'Could not parse milestones JSON array';
+            continue;
+        }
+        const [founding, legacy] = result;
+        return {
+            hook: (turn, maxTurns) => {
+                if (turn === 1)
+                    return founding;
+                if (turn === maxTurns)
+                    return legacy;
+                return null;
+            },
+            source: JSON.stringify(result, null, 2),
+        };
+    }
+    // Fallback: generic milestones
+    const labels = scenarioJson.labels ?? {};
+    const fallbackFounding = {
+        title: 'Founding',
+        description: `The ${labels.populationNoun ?? 'members'} have arrived at the ${labels.settlementNoun ?? 'settlement'}. Choose your initial strategy.`,
+        crisis: `The ${labels.populationNoun ?? 'members'} have arrived at the ${labels.settlementNoun ?? 'settlement'}. Choose your initial strategy.`,
+        options: [
+            { id: 'option_a', label: 'Conservative Start', description: 'Establish a safe, stable foundation', isRisky: false },
+            { id: 'option_b', label: 'Ambitious Start', description: 'Push for rapid expansion with higher risk', isRisky: true },
+        ],
+        riskyOptionId: 'option_b',
+        riskSuccessProbability: 0.6,
+        category: 'infrastructure',
+        researchKeywords: [labels.settlementNoun ?? 'settlement'],
+        relevantDepartments: (scenarioJson.departments ?? []).slice(0, 2).map((d) => d.id),
+        turnSummary: `The ${labels.settlementNoun ?? 'settlement'} is founded. First decisions shape everything.`,
+    };
+    const fallbackLegacy = {
+        title: 'Legacy Assessment',
+        description: `Submit a comprehensive status report on the ${labels.settlementNoun ?? 'settlement'}.`,
+        crisis: `Submit a comprehensive status report on the ${labels.settlementNoun ?? 'settlement'}.`,
+        options: [
+            { id: 'option_a', label: 'Honest Assessment', description: 'Report factually, including failures', isRisky: false },
+            { id: 'option_b', label: 'Ambitious Projection', description: 'Emphasize achievements, propose bold vision', isRisky: true },
+        ],
+        riskyOptionId: 'option_b',
+        riskSuccessProbability: 0.5,
+        category: 'political',
+        researchKeywords: [],
+        relevantDepartments: (scenarioJson.departments ?? []).slice(0, 3).map((d) => d.id),
+        turnSummary: 'Time for a comprehensive assessment.',
+    };
+    console.warn('[compiler] Milestone generation failed. Using fallback milestones.');
+    return {
+        hook: (turn, maxTurns) => {
+            if (turn === 1)
+                return fallbackFounding;
+            if (turn === maxTurns)
+                return fallbackLegacy;
+            return null;
+        },
+        source: JSON.stringify([fallbackFounding, fallbackLegacy], null, 2),
+    };
+}
+//# sourceMappingURL=generate-milestones.js.map