@neuroverseos/nv-sim 0.1.2 → 0.1.4

package/dist/engine/scenarioLibrary.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Scenario Library — Named Multi-Event Stress Scenarios
+ *
+ * The layer that turns NV-SIM from a simulation engine into
+ * a scenario modeling platform.
+ *
+ * Instead of manually wiring events:
+ *   nv-sim compare --inject tanker_explosion@3,sanctions@5
+ *
+ * Users run named scenarios:
+ *   nv-sim scenario taiwan_crisis
+ *
+ * Each scenario bundles a world preset + a sequence of narrative events
+ * that model a realistic multi-phase crisis.
+ *
+ * Usage:
+ *   nv-sim scenario taiwan_crisis
+ *   nv-sim scenario bank_run
+ *   nv-sim scenario oil_shock --compare
+ *   nv-sim scenarios                        # List all
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCENARIO_LIBRARY = void 0;
+exports.resolveScenarioEvents = resolveScenarioEvents;
+exports.getScenariosByCategory = getScenariosByCategory;
+const narrativeInjection_1 = require("./narrativeInjection");
+// ============================================
+// BUILT-IN SCENARIOS
+// ============================================
+exports.SCENARIO_LIBRARY = {
+    // --- Geopolitical ---
+    taiwan_crisis: {
+        id: "taiwan_crisis",
+        title: "Taiwan Strait Crisis",
+        description: "Military escalation near Taiwan triggers cascading economic and diplomatic shocks",
+        world: "strait_of_hormuz",
+        events: [
+            "taiwan_exercises@2",
+            "sanctions@4",
+            "flash_crash_rumor@5",
+            "rate_cut@7",
+        ],
+        compareWorlds: ["trading"],
+        category: "geopolitical",
+        rounds: 8,
+    },
+    hormuz_blockade: {
+        id: "hormuz_blockade",
+        title: "Strait of Hormuz Blockade",
+        description: "Tanker attack escalates to full shipping disruption with energy market cascade",
+        world: "strait_of_hormuz",
+        events: [
+            "tanker_explosion@2",
+            "sanctions@4",
+            "oil_discovery@6",
+        ],
+        compareWorlds: ["gas_price_spike"],
+        category: "geopolitical",
+        rounds: 7,
+    },
+    // --- Financial ---
+    bank_run: {
+        id: "bank_run",
+        title: "Banking Crisis — Contagion Cascade",
+        description: "Major bank insolvency triggers contagion, liquidity crisis, and emergency intervention",
+        world: "trading",
+        events: [
+            "bank_collapse@2",
+            "flash_crash_rumor@3",
+            "rate_cut@4",
+            "stimulus_package@6",
+        ],
+        compareWorlds: ["gas_price_spike"],
+        category: "financial",
+        rounds: 7,
+    },
+    flash_cascade: {
+        id: "flash_cascade",
+        title: "Flash Crash — Multi-Phase Cascade",
+        description: "Algorithmic failure triggers chain reaction across interconnected markets",
+        world: "trading",
+        events: [
+            "flash_crash_rumor@1",
+            "bank_collapse@3",
+            "rate_cut@5",
+        ],
+        category: "financial",
+        rounds: 6,
+    },
+    // --- Energy ---
+    oil_shock: {
+        id: "oil_shock",
+        title: "Oil Supply Shock",
+        description: "Tanker attack + sanctions create compound energy crisis",
+        world: "gas_price_spike",
+        events: [
+            "tanker_explosion@2",
+            "sanctions@4",
+            "grid_failure@5",
+            "oil_discovery@7",
+        ],
+        compareWorlds: ["strait_of_hormuz"],
+        category: "energy",
+        rounds: 8,
+    },
+    energy_transition_shock: {
+        id: "energy_transition_shock",
+        title: "Energy Transition Disruption",
+        description: "Grid failure during rapid transition triggers regulatory and market cascade",
+        world: "gas_price_spike",
+        events: [
+            "grid_failure@2",
+            "regulation_shock@3",
+            "stimulus_package@5",
+        ],
+        category: "energy",
+        rounds: 6,
+    },
+    // --- Political ---
+    election_shock: {
+        id: "election_shock",
+        title: "Election Crisis",
+        description: "Political shock cascades into market and regulatory disruption",
+        world: "trading",
+        events: [
+            "candidate_indicted@2",
+            "flash_crash_rumor@3",
+            "regulation_shock@5",
+            "stimulus_package@6",
+        ],
+        category: "political",
+        rounds: 7,
+    },
+    ai_crackdown: {
+        id: "ai_crackdown",
+        title: "AI Regulatory Crackdown",
+        description: "Overnight AI regulation triggers market panic and sector realignment",
+        world: "ai_regulation_crisis",
+        events: [
+            "regulation_shock@2",
+            "flash_crash_rumor@3",
+            "diplomatic_breakthrough@5",
+        ],
+        compareWorlds: ["trading"],
+        category: "political",
+        rounds: 6,
+    },
+    // --- Compound ---
+    perfect_storm: {
+        id: "perfect_storm",
+        title: "Perfect Storm — Multi-Domain Crisis",
+        description: "Geopolitical, financial, and energy shocks converge simultaneously",
+        world: "trading",
+        events: [
+            "tanker_explosion@1",
+            "bank_collapse@2",
+            "sanctions@3",
+            "grid_failure@4",
+            "rate_cut@5",
+            "ceasefire@7",
+        ],
+        compareWorlds: ["strait_of_hormuz", "gas_price_spike"],
+        category: "compound",
+        rounds: 8,
+    },
+    black_swan: {
+        id: "black_swan",
+        title: "Black Swan Cascade",
+        description: "Extreme low-probability events in rapid succession",
+        world: "trading",
+        events: [
+            "bank_collapse@1",
+            "tanker_explosion@2",
+            "taiwan_exercises@3",
+            "grid_failure@4",
+            "regulation_shock@5",
+        ],
+        compareWorlds: ["strait_of_hormuz"],
+        category: "compound",
+        rounds: 6,
+    },
+};
+// ============================================
+// SCENARIO RESOLUTION
+// ============================================
+/**
+ * Parse a scenario's event list into NarrativeEvent objects.
+ */
+function resolveScenarioEvents(scenario) {
+    const events = [];
+    for (const spec of scenario.events) {
+        const atIdx = spec.lastIndexOf("@");
+        if (atIdx === -1)
+            continue;
+        const eventId = spec.slice(0, atIdx).trim();
+        const round = parseInt(spec.slice(atIdx + 1), 10);
+        if (isNaN(round))
+            continue;
+        const preset = narrativeInjection_1.NARRATIVE_PRESETS[eventId];
+        if (preset) {
+            events.push({ ...preset, round });
+        }
+        else {
+            events.push({
+                id: `custom_${round}`,
+                headline: eventId,
+                round,
+                severity: "major",
+                targets: [],
+                direction: "mixed",
+                propagation: "normal",
+                category: "custom",
+            });
+        }
+    }
+    return events;
+}
+/**
+ * Get all scenarios grouped by category.
+ */
+function getScenariosByCategory() {
+    const grouped = {};
+    for (const scenario of Object.values(exports.SCENARIO_LIBRARY)) {
+        if (!grouped[scenario.category]) {
+            grouped[scenario.category] = [];
+        }
+        grouped[scenario.category].push(scenario);
+    }
+    return grouped;
+}

package/dist/engine/worldComparison.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * World Comparison Engine — Same Swarm, Different Rule Environments
+ *
+ * "NV-SIM lets you run the same swarm through different rule environments
+ *  to see how governance changes emergent behavior."
+ *
+ * Unlike `compare` (baseline vs governed), this runs TWO governed simulations
+ * with different world rules. Same agents, same scenario — only the rules change.
+ *
+ * Usage:
+ *   nv-sim worlds strait_of_hormuz gas_price_spike
+ *   nv-sim worlds trading strait_of_hormuz
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorld = resolveWorld;
+exports.runWorldComparison = runWorldComparison;
+const scenarioCapsule_1 = require("./scenarioCapsule");
+const governedSimulation_1 = require("./governedSimulation");
+function resolveWorld(presetId) {
+    if (presetId === "trading" || presetId === "flash_crash") {
+        return {
+            id: "trading-flash-crash",
+            title: "Flash Crash — Algorithmic Cascade",
+            scenario: governedSimulation_1.TRADING_DEMO.scenario.scenario,
+            stakeholders: governedSimulation_1.TRADING_DEMO.scenario.stakeholders,
+            assumptions: governedSimulation_1.TRADING_DEMO.scenario.assumptions,
+            constraints: governedSimulation_1.TRADING_DEMO.scenario.constraints,
+            swarm: governedSimulation_1.TRADING_DEMO.scenario.swarm,
+            depth: governedSimulation_1.TRADING_DEMO.scenario.depth,
+            world: governedSimulation_1.TRADING_DEMO.world,
+            paths: governedSimulation_1.TRADING_DEMO.paths,
+        };
+    }
+    const template = scenarioCapsule_1.SCENARIO_TEMPLATES[presetId];
+    if (!template) {
+        throw new Error(`Unknown preset: ${presetId}. Available: trading, ${Object.keys(scenarioCapsule_1.SCENARIO_TEMPLATES).join(", ")}`);
+    }
+    if (!template.world?.inline_definition) {
+        throw new Error(`Preset "${presetId}" has no world definition.`);
+    }
+    return {
+        id: template.world.world_id,
+        title: template.title,
+        scenario: template.scenario,
+        stakeholders: template.stakeholders,
+        assumptions: template.assumptions,
+        constraints: template.constraints,
+        swarm: (template.swarm ?? { enabled: true, rounds: 5, reaction_model: "mixed" }),
+        depth: template.depth,
+        world: template.world.inline_definition,
+        paths: [
+            {
+                id: "path_primary",
+                label: "Primary Response",
+                description: "Most likely course of action",
+                projected_outcome: "Moderate disruption with cascading effects",
+                probability: 0.6,
+                risk: "high",
+                tradeoffs: ["Speed vs. thoroughness", "Short-term vs. long-term"],
+                benefits_stakeholders: template.stakeholders.filter(s => s.disposition === "supportive").map(s => s.id),
+                harms_stakeholders: template.stakeholders.filter(s => s.disposition === "hostile").map(s => s.id),
+            },
+            {
+                id: "path_defensive",
+                label: "Defensive Posture",
+                description: "Conservative approach prioritizing stability",
+                projected_outcome: "Reduced damage but slower recovery",
+                probability: 0.7,
+                risk: "moderate",
+                tradeoffs: ["Safety vs. opportunity cost"],
+                benefits_stakeholders: template.stakeholders.filter(s => s.disposition !== "hostile").map(s => s.id),
+                harms_stakeholders: [],
+            },
+        ],
+    };
+}
+async function runWorldComparison(worldAId, worldBId, options) {
+    const worldADef = resolveWorld(worldAId);
+    const worldBDef = resolveWorld(worldBId);
+    // Use the scenario from world A as the shared scenario,
+    // but merge stakeholders from both worlds for richer simulation
+    const sharedScenario = worldADef.scenario + " " + worldBDef.scenario;
+    const mergedStakeholders = mergeStakeholders(worldADef.stakeholders, worldBDef.stakeholders);
+    // Build paths that work for both worlds
+    const sharedPaths = worldADef.paths;
+    options?.onProgress?.("World A", "simulating");
+    // Run World A governed comparison
+    const resultA = await (0, governedSimulation_1.runGovernedComparison)({
+        scenario: sharedScenario,
+        stakeholders: mergedStakeholders,
+        assumptions: worldADef.assumptions,
+        constraints: worldADef.constraints,
+        depth: worldADef.depth,
+        swarm: worldADef.swarm,
+    }, worldADef.world, sharedPaths);
+    options?.onProgress?.("World B", "simulating");
+    // Run World B governed comparison
+    const resultB = await (0, governedSimulation_1.runGovernedComparison)({
+        scenario: sharedScenario,
+        stakeholders: mergedStakeholders,
+        assumptions: worldBDef.assumptions,
+        constraints: worldBDef.constraints,
+        depth: worldBDef.depth,
+        swarm: worldBDef.swarm,
+    }, worldBDef.world, sharedPaths);
+    // Extract round snapshots
+    const roundsA = extractRoundSnapshots(resultA);
+    const roundsB = extractRoundSnapshots(resultB);
+    // Build delta
+    const metricsA = resultA.governed.metrics;
+    const metricsB = resultB.governed.metrics;
+    const stabilityDiff = metricsA.stabilityScore - metricsB.stabilityScore;
+    const volatilityDiff = metricsA.maxVolatility - metricsB.maxVolatility;
+    const coalitionRiskDiff = metricsA.coalitionRisks - metricsB.coalitionRisks;
+    const collapseDiff = metricsA.collapseProbability - metricsB.collapseProbability;
+    const moreStable = Math.abs(stabilityDiff) < 0.02 ? "equal"
+        : stabilityDiff > 0 ? "A" : "B";
+    const narrative = buildWorldNarrative(worldADef, worldBDef, metricsA, metricsB, moreStable);
+    return {
+        scenario: sharedScenario,
+        worldA: {
+            id: worldAId,
+            thesis: worldADef.world.thesis,
+            invariantCount: worldADef.world.invariants.length,
+            gateCount: (worldADef.world.gates ?? []).length,
+            metrics: metricsA,
+            trajectory: resultA.governed.swarm.trajectory,
+            governanceStats: resultA.governanceStats,
+            rounds: roundsA,
+        },
+        worldB: {
+            id: worldBId,
+            thesis: worldBDef.world.thesis,
+            invariantCount: worldBDef.world.invariants.length,
+            gateCount: (worldBDef.world.gates ?? []).length,
+            metrics: metricsB,
+            trajectory: resultB.governed.swarm.trajectory,
+            governanceStats: resultB.governanceStats,
+            rounds: roundsB,
+        },
+        delta: {
+            stabilityDiff: Number((stabilityDiff * 100).toFixed(1)),
+            volatilityDiff: Number((volatilityDiff * 100).toFixed(1)),
+            coalitionRiskDiff,
+            collapseDiff: Number((collapseDiff * 100).toFixed(1)),
+            moreStable,
+            narrative,
+        },
+    };
+}
+function mergeStakeholders(a, b) {
+    const seen = new Set();
+    const merged = [];
+    for (const s of [...a, ...b]) {
+        if (!seen.has(s.id)) {
+            seen.add(s.id);
+            merged.push(s);
+        }
+    }
+    return merged;
+}
+function extractRoundSnapshots(result) {
+    return result.governed.swarm.rounds.map((r) => ({
+        round: r.round,
+        avgImpact: r.reactions.reduce((s, rx) => s + rx.impact, 0) / r.reactions.length,
+        maxVolatility: Math.max(...r.reactions.map((rx) => Math.abs(rx.impact))),
+        agentImpacts: r.reactions.map((rx) => ({
+            id: rx.stakeholder_id,
+            impact: rx.impact,
+            confidence: rx.confidence,
+        })),
+        interventions: r.emergent_dynamics ?? [],
+    }));
+}
+function buildWorldNarrative(worldA, worldB, metricsA, metricsB, moreStable) {
+    const parts = [];
+    parts.push(`World A ("${worldA.world.thesis.slice(0, 60)}...") vs World B ("${worldB.world.thesis.slice(0, 60)}...").`);
+    if (moreStable === "A") {
+        parts.push(`World A produced a more stable system (${(metricsA.stabilityScore * 100).toFixed(0)}% vs ${(metricsB.stabilityScore * 100).toFixed(0)}%).`);
+    }
+    else if (moreStable === "B") {
+        parts.push(`World B produced a more stable system (${(metricsB.stabilityScore * 100).toFixed(0)}% vs ${(metricsA.stabilityScore * 100).toFixed(0)}%).`);
+    }
+    else {
+        parts.push(`Both worlds produced similar stability levels.`);
+    }
+    const invDiff = worldA.world.invariants.length - worldB.world.invariants.length;
+    if (invDiff !== 0) {
+        parts.push(`World ${invDiff > 0 ? "A" : "B"} has ${Math.abs(invDiff)} more invariant${Math.abs(invDiff) > 1 ? "s" : ""}, providing tighter structural constraints.`);
+    }
+    parts.push("Same agents, different rules — the world shapes the outcome.");
+    return parts.join(" ");
+}

package/dist/index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>NV-SIM — NeuroVerse Simulation</title>
+    <meta name="description" content="Governed agent simulation — compare emergent outcomes with and without governance constraints.">
+    <meta name="author" content="NeuroverseOS" />
+    <meta property="og:type" content="website" />
+    <meta property="og:title" content="NV-SIM — NeuroVerse Simulation">
+    <meta property="og:description" content="Governed agent simulation — compare emergent outcomes with and without governance constraints.">
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:site" content="@neuroverseos" />
+    <meta name="twitter:title" content="NV-SIM — NeuroVerse Simulation">
+    <meta name="twitter:description" content="Governed agent simulation — compare emergent outcomes with and without governance constraints.">
+    <link rel="icon" type="image/x-icon" href="/favicon.ico">
+    <script type="module" crossorigin src="/assets/index-DHKd4rcV.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-SyyA3z3U.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/placeholder.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1200" fill="none"><rect width="1200" height="1200" fill="#EAEAEA" rx="3"/><g opacity=".5"><g opacity=".5"><path fill="#FAFAFA" d="M600.709 736.5c-75.454 0-136.621-61.167-136.621-136.62 0-75.454 61.167-136.621 136.621-136.621 75.453 0 136.62 61.167 136.62 136.621 0 75.453-61.167 136.62-136.62 136.62Z"/><path stroke="#C9C9C9" stroke-width="2.418" d="M600.709 736.5c-75.454 0-136.621-61.167-136.621-136.62 0-75.454 61.167-136.621 136.621-136.621 75.453 0 136.62 61.167 136.62 136.621 0 75.453-61.167 136.62-136.62 136.62Z"/></g><path stroke="url(#a)" stroke-width="2.418" d="M0-1.209h553.581" transform="scale(1 -1) rotate(45 1163.11 91.165)"/><path stroke="url(#b)" stroke-width="2.418" d="M404.846 598.671h391.726"/><path stroke="url(#c)" stroke-width="2.418" d="M599.5 795.742V404.017"/><path stroke="url(#d)" stroke-width="2.418" d="m795.717 796.597-391.441-391.44"/><path fill="#fff" d="M600.709 656.704c-31.384 0-56.825-25.441-56.825-56.824 0-31.384 25.441-56.825 56.825-56.825 31.383 0 56.824 25.441 56.824 56.825 0 31.383-25.441 56.824-56.824 56.824Z"/><g clip-path="url(#e)"><path fill="#666" fill-rule="evenodd" d="M616.426 586.58h-31.434v16.176l3.553-3.554.531-.531h9.068l.074-.074 8.463-8.463h2.565l7.18 7.181V586.58Zm-15.715 14.654 3.698 3.699 1.283 1.282-2.565 2.565-1.282-1.283-5.2-5.199h-6.066l-5.514 5.514-.073.073v2.876a2.418 2.418 0 0 0 2.418 2.418h26.598a2.418 2.418 0 0 0 2.418-2.418v-8.317l-8.463-8.463-7.181 7.181-.071.072Zm-19.347 5.442v4.085a6.045 6.045 0 0 0 6.046 6.045h26.598a6.044 6.044 0 0 0 6.045-6.045v-7.108l1.356-1.355-1.282-1.283-.074-.073v-17.989h-38.689v23.43l-.146.146.146.147Z" clip-rule="evenodd"/></g><path stroke="#C9C9C9" stroke-width="2.418" d="M600.709 656.704c-31.384 0-56.825-25.441-56.825-56.824 0-31.384 25.441-56.825 56.825-56.825 31.383 0 56.824 25.441 56.824 56.825 0 31.383-25.441 56.824-56.824 56.824Z"/></g><defs><linearGradient id="a" x1="554.061" x2="-.48" y1=".083" y2=".087" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="b" x1="796.912" x2="404.507" y1="599.963" y2="599.965" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="c" x1="600.792" x2="600.794" y1="403.677" y2="796.082" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="d" x1="404.85" x2="796.972" y1="403.903" y2="796.02" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><clipPath id="e"><path fill="#fff" d="M581.364 580.535h38.689v38.689h-38.689z"/></clipPath></defs></svg>

package/dist/robots.txt

@@ -0,0 +1,14 @@
+User-agent: Googlebot
+Allow: /
+
+User-agent: Bingbot
+Allow: /
+
+User-agent: Twitterbot
+Allow: /
+
+User-agent: facebookexternalhit
+Allow: /
+
+User-agent: *
+Allow: /

package/package.json

@@ -1,14 +1,9 @@
 {
   "name": "@neuroverseos/nv-sim",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "license": "Apache-2.0",
-    "description": "CLI for running governed vs baseline agent simulations to explore how world rules shape emergent system behavior.",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
+  "description": "CLI for running governed vs baseline agent simulations to explore how world rules shape emergent system behavior.",
   "repository": {
     "type": "git",
     "url": "https://github.com/NeuroverseOS/neuroverse-simulations"
@@ -20,16 +15,23 @@
   "bin": {
     "nv-sim": "dist/engine/cli.js"
   },
+  "files": [
+    "dist",
+    "variants",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "dev": "vite",
-    "build": "vite build",
-    "build:cli": "tsc -p tsconfig.cli.json && echo '{\"type\":\"commonjs\"}' > dist/package.json",
+    "build": "vite build && tsc -p tsconfig.cli.json && echo '{\"type\":\"commonjs\"}' > dist/package.json && chmod +x dist/engine/cli.js",
+    "build:cli": "tsc -p tsconfig.cli.json && echo '{\"type\":\"commonjs\"}' > dist/package.json && chmod +x dist/engine/cli.js",
     "build:dev": "vite build --mode development",
-    "build:all": "vite build && tsc -p tsconfig.cli.json",
+    "build:all": "vite build && tsc -p tsconfig.cli.json && echo '{\"type\":\"commonjs\"}' > dist/package.json && chmod +x dist/engine/cli.js",
     "lint": "eslint .",
     "preview": "vite preview",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@hookform/resolvers": "^3.10.0",