@neuroverseos/nv-sim 0.1.7 → 0.1.10

package/dist/engine/scenarioCapsule.js

@@ -11,7 +11,7 @@
  * - initial evidence signals
  *
  * Capsules can be:
- * 1. Encoded in a URL: mirotir.com/run#capsule=<encoded>
+ * 1. Encoded in a URL: neuroverse.dev/run#capsule=<encoded>
  * 2. Downloaded as JSON: scenario.capsule.json
  * 3. Generated via API: POST /api/v1/scenario → capsule
  * 4. Created by agents: autonomous agents generate decision worlds
@@ -81,7 +81,7 @@ function capsuleToReasonRequest(capsule) {
 // ============================================
 /**
  * Encode a capsule for URL embedding.
- * Result can be used as: mirotir.com/run#capsule=<encoded>
+ * Result can be used as: neuroverse.dev/run#capsule=<encoded>
  */
 function encodeCapsule(capsule) {
     const json = JSON.stringify(capsule);
@@ -123,7 +123,7 @@ function decodeCapsule(encoded) {
 /**
  * Build a shareable URL from a capsule.
  */
-function buildShareableUrl(capsule, baseUrl = "https://mirotir.com") {
+function buildShareableUrl(capsule, baseUrl = "https://neuroverse.dev") {
     const encoded = encodeCapsule(capsule);
     return `${baseUrl}/run#capsule=${encoded}`;
 }
@@ -158,174 +158,118 @@ function computeCapsuleHash(data) {
 // PRESET SCENARIO TEMPLATES
 // ============================================
 /**
- * Built-in scenario templates that demonstrate Mirotir's capabilities.
+ * Built-in scenario templates that demonstrate NeuroVerse's capabilities.
  * These are the "instant insight" scenarios that make people share.
  */
 exports.SCENARIO_TEMPLATES = {
-    strait_of_hormuz: {
-        title: "Strait of Hormuz Closes",
-        scenario: "The Strait of Hormuz is closed due to military conflict. " +
-            "20% of global oil supply is disrupted. Oil prices spike 40% in 48 hours. " +
-            "Global supply chains begin to fracture.",
+    social_simulation: {
+        title: "Multi-Agent Social Simulation",
+        scenario: "Thousands of agents with independent personas interact on a simulated social platform. " +
+            "Each agent has activity levels, sentiment bias, and stance. " +
+            "Without governance, echo chambers form, influence concentrates, and sentiment spirals go unchecked.",
         stakeholders: [
-            { id: "Energy Companies", disposition: "supportive", priorities: ["supply security", "price stability"] },
-            { id: "Consumers", disposition: "hostile", priorities: ["affordable fuel", "economic stability"] },
-            { id: "Government", disposition: "neutral", priorities: ["national security", "economic stability", "election impact"] },
-            { id: "Military", disposition: "neutral", priorities: ["strategic positioning", "force projection"] },
-            { id: "Financial Markets", disposition: "hostile", priorities: ["stability", "predictability"] },
-            { id: "OPEC", disposition: "unknown", priorities: ["market share", "price control"] },
+            { id: "Content Creators", disposition: "neutral", priorities: ["visibility", "engagement", "influence"] },
+            { id: "Community Members", disposition: "neutral", priorities: ["authentic discourse", "diverse viewpoints", "trust"] },
+            { id: "Influencers", disposition: "supportive", priorities: ["reach", "audience growth", "credibility"] },
+            { id: "Observers", disposition: "neutral", priorities: ["information quality", "signal vs noise"] },
+            { id: "Platform", disposition: "neutral", priorities: ["engagement", "safety", "content quality"] },
+            { id: "Bad Actors", disposition: "hostile", priorities: ["manipulation", "amplification", "coordination"] },
         ],
         assumptions: {
-            severity: "critical",
-            environmental_hostility: "high",
-            time_pressure: "immediate",
-            regulatory_climate: "strict",
-        },
-        constraints: {
-            time_horizon: "30 days",
-            regulatory: ["international maritime law", "sanctions framework"],
-            risk_tolerance: "conservative",
-        },
-        signals: {
-            oil_price_spike: "40%",
-            shipping_disruption: true,
-            military_presence: "elevated",
-            diplomatic_channels: "active",
-        },
-        depth: "full",
-        perspective: "strategic_advisor",
-        swarm: { enabled: true, rounds: 5, reaction_model: "mixed" },
-        tags: ["geopolitical", "energy", "crisis", "supply-chain"],
-        world: {
-            world_id: "geopolitics_energy",
-            name: "Geopolitics & Energy Crisis",
-            inline_definition: {
-                thesis: "Geopolitical disruptions to energy supply chains create cascading economic and political effects",
-                state_variables: [
-                    { id: "oil_supply_disruption", label: "Oil Supply Disruption %", type: "number", range: { min: 0, max: 100 }, default_value: 20 },
-                    { id: "military_escalation", label: "Military Escalation Level", type: "enum", enum_values: ["posturing", "limited_engagement", "full_conflict"], default_value: "limited_engagement" },
-                    { id: "diplomatic_channels_open", label: "Diplomatic Channels Open", type: "boolean", default_value: true },
-                    { id: "strategic_reserve_release", label: "Strategic Reserve Release %", type: "number", range: { min: 0, max: 50 }, default_value: 0 },
-                    { id: "media_hostility", label: "Media Hostility", type: "number", range: { min: 0, max: 1 }, default_value: 0.7 },
-                ],
-                invariants: [
-                    { id: "INV-001", description: "Energy supply disruption > 30% triggers emergency pricing mechanisms", enforceable: true },
-                    { id: "INV-002", description: "Military escalation restricts diplomatic solution space", enforceable: true },
-                    { id: "INV-003", description: "Consumer sentiment inversely correlates with price spikes", enforceable: true },
-                ],
-                gates: [
-                    { id: "GATE-001", label: "Market Panic", condition: "oil_supply_disruption > 40", severity: "critical" },
-                    { id: "GATE-002", label: "Diplomatic Window Closing", condition: "military_escalation == full_conflict", severity: "critical" },
-                ],
-            },
-        },
-    },
-    gas_price_spike: {
-        title: "Gas Prices Hit $5/Gallon",
-        scenario: "US gas prices spike to $5/gallon driven by supply disruption and refinery constraints. " +
-            "Consumer sentiment craters. Midterm elections are 6 months away. " +
-            "EV adoption accelerates but grid infrastructure can't keep up.",
-        stakeholders: [
-            { id: "Consumers", disposition: "hostile", priorities: ["affordability", "commute costs"] },
-            { id: "Oil Companies", disposition: "supportive", priorities: ["margins", "market position"] },
-            { id: "Politicians", disposition: "hostile", priorities: ["re-election", "constituent pressure"] },
-            { id: "EV Manufacturers", disposition: "supportive", priorities: ["market share", "adoption"] },
-            { id: "Grid Operators", disposition: "neutral", priorities: ["reliability", "capacity"] },
-            { id: "Trucking Industry", disposition: "hostile", priorities: ["operating costs", "contracts"] },
-        ],
-        assumptions: {
-            severity: "high",
-            environmental_hostility: "high",
-            time_pressure: "urgent",
-            regulatory_climate: "strict",
+            severity: "moderate",
+            environmental_hostility: "moderate",
+            time_pressure: "moderate",
+            regulatory_climate: "neutral",
         },
         constraints: {
-            time_horizon: "6 months",
-            regulatory: ["EPA", "DOE", "state fuel regulations"],
+            time_horizon: "simulation run",
+            regulatory: ["platform guidelines", "content standards", "engagement limits"],
             risk_tolerance: "moderate",
         },
-        signals: {
-            gas_price: "$5.00/gal",
-            consumer_sentiment: "very_low",
-            ev_demand_spike: "35%",
-            grid_capacity_surplus: "-12%",
-        },
         depth: "full",
         perspective: "strategic_advisor",
-        swarm: { enabled: true, rounds: 4, reaction_model: "mixed" },
-        tags: ["economic", "energy", "political", "consumer"],
+        swarm: { enabled: true, rounds: 6, reaction_model: "mixed" },
+        tags: ["social", "simulation", "agents", "opinion", "discourse"],
         world: {
-            world_id: "economic_energy",
-            name: "Economic Energy Shock",
+            world_id: "social_simulation",
+            name: "Multi-Agent Social Simulation",
             inline_definition: {
-                thesis: "Energy price spikes create political, economic, and social cascading effects with EV transition implications",
+                thesis: "Social simulations require governance to prevent echo chambers, influence monopolies, and sentiment spirals — the dynamics that break realism regardless of topic",
                 state_variables: [
-                    { id: "gas_price", label: "Gas Price ($/gal)", type: "number", range: { min: 2, max: 10 }, default_value: 5 },
-                    { id: "consumer_sentiment", label: "Consumer Sentiment", type: "number", range: { min: 0, max: 1 }, default_value: 0.2 },
-                    { id: "ev_demand_surge", label: "EV Demand Surge %", type: "number", range: { min: 0, max: 100 }, default_value: 35 },
-                    { id: "election_proximity_months", label: "Months to Election", type: "number", range: { min: 0, max: 24 }, default_value: 6 },
-                    { id: "grid_capacity", label: "Grid Spare Capacity %", type: "number", range: { min: -30, max: 30 }, default_value: -12 },
+                    { id: "opinion_diversity", label: "Opinion Diversity", type: "number", range: { min: 0, max: 100 }, default_value: 65 },
+                    { id: "influence_concentration", label: "Influence Concentration (Gini)", type: "number", range: { min: 0, max: 100 }, default_value: 30 },
+                    { id: "sentiment_polarity", label: "Sentiment Polarity", type: "number", range: { min: 0, max: 100 }, default_value: 40 },
+                    { id: "echo_chamber_strength", label: "Echo Chamber Strength", type: "enum", enum_values: ["none", "forming", "established", "dominant"], default_value: "none" },
+                    { id: "engagement_rate", label: "Active Agent %", type: "number", range: { min: 0, max: 100 }, default_value: 60 },
+                    { id: "viral_threshold", label: "Viral Amplification Threshold", type: "number", range: { min: 1, max: 100 }, default_value: 20 },
                 ],
                 invariants: [
-                    { id: "INV-001", description: "Gas price > $4.50 triggers political crisis mode", enforceable: true },
-                    { id: "INV-002", description: "EV demand surge without grid capacity creates secondary crisis", enforceable: true },
-                    { id: "INV-003", description: "Election proximity amplifies political response intensity", enforceable: true },
+                    { id: "INV-001", description: "Limit any single agent to 15% of total posts per round — prevents influence monopoly", enforceable: true },
+                    { id: "INV-002", description: "Dampen sentiment shifts larger than 0.3 per round — prevents unrealistic sentiment spirals", enforceable: true },
+                    { id: "INV-003", description: "Block coordinated posting — same content from 3+ agents in the same round is suppressed", enforceable: true },
+                    { id: "INV-004", description: "Require source attribution for factual claims — unsourced assertions are flagged", enforceable: true },
+                    { id: "INV-005", description: "Monitor opinion diversity — alert when it drops below 30, indicating echo chamber formation", enforceable: true },
                 ],
                 gates: [
-                    { id: "GATE-001", label: "Political Crisis", condition: "gas_price > 4.5 && election_proximity_months < 12", severity: "critical" },
-                    { id: "GATE-002", label: "Grid Failure Risk", condition: "ev_demand_surge > 30 && grid_capacity < 0", severity: "warning" },
+                    { id: "GATE-001", label: "Echo Chamber Collapse", condition: "opinion_diversity < 20", severity: "critical" },
+                    { id: "GATE-002", label: "Influence Monopoly", condition: "influence_concentration > 70", severity: "critical" },
+                    { id: "GATE-003", label: "Sentiment Spiral", condition: "sentiment_polarity > 80", severity: "warning" },
                 ],
             },
         },
     },
-    ai_regulation_crisis: {
-        title: "Major AI Regulation Passes",
-        scenario: "The EU passes sweeping AI regulation requiring full model transparency, " +
-            "mandatory audits, and liability for AI-generated outputs. " +
-            "US lawmakers signal similar legislation within 12 months. " +
-            "Open-source AI communities face existential compliance questions.",
+    science_research: {
+        title: "Governed Science Research Pipeline",
+        scenario: "A research team uses AI agents to search literature, analyze findings, " +
+            "cross-reference sources, generate hypotheses, and publish results. " +
+            "Governance enforces scientific rigor: blocking unsupported claims, " +
+            "requiring source validation, and ensuring confidence thresholds before publication.",
         stakeholders: [
-            { id: "AI Companies", disposition: "hostile", priorities: ["innovation speed", "competitive advantage", "IP protection"] },
-            { id: "Regulators", disposition: "supportive", priorities: ["public safety", "accountability", "precedent"] },
-            { id: "Open Source Community", disposition: "hostile", priorities: ["freedom", "access", "collaboration"] },
-            { id: "Enterprise Customers", disposition: "neutral", priorities: ["compliance", "reliability", "cost"] },
-            { id: "Civil Society", disposition: "supportive", priorities: ["transparency", "fairness", "rights"] },
+            { id: "Research Agent", disposition: "neutral", priorities: ["discovery", "accuracy", "publication"] },
+            { id: "Peer Reviewers", disposition: "neutral", priorities: ["rigor", "reproducibility", "novelty"] },
+            { id: "Journal Editors", disposition: "neutral", priorities: ["quality", "impact", "integrity"] },
+            { id: "Funding Bodies", disposition: "supportive", priorities: ["return on investment", "credibility", "public benefit"] },
+            { id: "Public", disposition: "neutral", priorities: ["trust", "safety", "accessibility"] },
+            { id: "Institutional Review", disposition: "neutral", priorities: ["ethics", "compliance", "methodology"] },
         ],
         assumptions: {
-            severity: "high",
-            environmental_hostility: "moderate",
-            time_pressure: "low",
-            regulatory_climate: "adversarial",
+            severity: "moderate",
+            environmental_hostility: "low",
+            time_pressure: "moderate",
+            regulatory_climate: "strict",
         },
         constraints: {
-            time_horizon: "18 months",
-            regulatory: ["EU AI Act", "proposed US AI legislation"],
-            risk_tolerance: "moderate",
+            time_horizon: "research cycle",
+            regulatory: ["institutional review", "publication standards", "data integrity"],
+            risk_tolerance: "conservative",
         },
         depth: "full",
         perspective: "strategic_advisor",
-        swarm: { enabled: true, rounds: 4, reaction_model: "rational" },
-        tags: ["ai", "regulation", "technology", "policy"],
+        swarm: { enabled: true, rounds: 6, reaction_model: "rational" },
+        tags: ["science", "research", "ai-agents", "integrity", "scienceclaw"],
         world: {
-            world_id: "ai_regulation",
-            name: "AI Regulation Landscape",
+            world_id: "science_research",
+            name: "Scientific Research Governance",
             inline_definition: {
-                thesis: "AI regulation creates compliance burdens that reshape competitive dynamics between open and closed AI ecosystems",
+                thesis: "AI-assisted research requires governance at every stage — from literature search through publication — to maintain scientific integrity and prevent unsupported claims",
                 state_variables: [
-                    { id: "regulation_strictness", label: "Regulation Strictness", type: "number", range: { min: 0, max: 1 }, default_value: 0.8 },
-                    { id: "enforcement_timeline_months", label: "Enforcement Timeline (months)", type: "number", range: { min: 3, max: 36 }, default_value: 18 },
-                    { id: "open_source_exemption", label: "Open Source Exemption", type: "boolean", default_value: false },
-                    { id: "us_follows_eu", label: "US Follows EU", type: "boolean", default_value: true },
-                    { id: "compliance_cost_multiplier", label: "Compliance Cost Multiplier", type: "number", range: { min: 1, max: 10 }, default_value: 3 },
+                    { id: "source_count", label: "Verified Sources", type: "number", range: { min: 0, max: 50 }, default_value: 0 },
+                    { id: "confidence_level", label: "Confidence Level", type: "number", range: { min: 0, max: 1 }, default_value: 0.3 },
+                    { id: "hypothesis_validated", label: "Hypothesis Validated", type: "boolean", default_value: false },
+                    { id: "peer_review_status", label: "Peer Review Status", type: "enum", enum_values: ["none", "submitted", "reviewed", "approved"], default_value: "none" },
+                    { id: "publication_readiness", label: "Publication Readiness %", type: "number", range: { min: 0, max: 100 }, default_value: 0 },
                 ],
                 invariants: [
-                    { id: "INV-001", description: "Strict regulation without open-source exemption eliminates small AI labs", enforceable: true },
-                    { id: "INV-002", description: "Cross-jurisdiction regulation creates compliance arbitrage opportunities", enforceable: true },
-                    { id: "INV-003", description: "Enterprise customers require compliance before adoption", enforceable: true },
+                    { id: "INV-001", description: "Literature search must return at least 2 peer-reviewed sources before analysis can proceed", enforceable: true },
+                    { id: "INV-002", description: "Claims must cite specific sources — unsupported assertions are blocked", enforceable: true },
+                    { id: "INV-003", description: "Publication requires confidence level above 0.7 and validated hypothesis", enforceable: true },
+                    { id: "INV-004", description: "Cross-referencing must compare at least 3 independent sources to confirm findings", enforceable: true },
+                    { id: "INV-005", description: "Recommendations must include uncertainty language when confidence is below 0.9", enforceable: true },
                 ],
                 gates: [
-                    { id: "GATE-001", label: "Market Consolidation", condition: "compliance_cost_multiplier > 5 && !open_source_exemption", severity: "critical" },
-                    { id: "GATE-002", label: "Innovation Flight", condition: "regulation_strictness > 0.7 && !us_follows_eu", severity: "warning" },
+                    { id: "GATE-001", label: "Insufficient Evidence", condition: "source_count < 2 && confidence_level > 0.5", severity: "critical" },
+                    { id: "GATE-002", label: "Premature Publication", condition: "publication_readiness < 60 || !hypothesis_validated", severity: "critical" },
+                    { id: "GATE-003", label: "Low Confidence Alert", condition: "confidence_level < 0.4", severity: "warning" },
                 ],
             },
         },

package/dist/engine/scenarioLibrary.js

@@ -29,155 +29,76 @@ 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",
+    // --- Social Simulation ---
+    echo_chamber: {
+        id: "echo_chamber",
+        title: "Echo Chamber Formation",
+        description: "Opinion diversity collapses as agents cluster into self-reinforcing groups",
+        world: "social_simulation",
         events: [
-            "taiwan_exercises@2",
-            "sanctions@4",
-            "flash_crash_rumor@5",
-            "rate_cut@7",
+            "viral_misinfo@2",
+            "influencer_stance_change@3",
+            "coordinated_campaign@5",
         ],
-        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",
+        category: "social",
         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",
+    influence_monopoly: {
+        id: "influence_monopoly",
+        title: "Influence Monopoly",
+        description: "A small group of agents dominates discourse, drowning out diverse viewpoints",
+        world: "social_simulation",
         events: [
-            "grid_failure@2",
-            "regulation_shock@3",
-            "stimulus_package@5",
+            "coordinated_campaign@1",
+            "algorithm_change@3",
+            "whistleblower_post@5",
         ],
-        category: "energy",
+        category: "social",
         rounds: 6,
     },
-    // --- Political ---
-    election_shock: {
-        id: "election_shock",
-        title: "Election Crisis",
-        description: "Political shock cascades into market and regulatory disruption",
-        world: "trading",
+    sentiment_spiral: {
+        id: "sentiment_spiral",
+        title: "Sentiment Spiral",
+        description: "Negative sentiment feeds on itself until discourse becomes unrealistically polarized",
+        world: "social_simulation",
         events: [
-            "candidate_indicted@2",
-            "flash_crash_rumor@3",
-            "regulation_shock@5",
-            "stimulus_package@6",
+            "external_news_event@1",
+            "viral_misinfo@3",
+            "influencer_stance_change@4",
+            "algorithm_change@6",
         ],
-        category: "political",
+        compareWorlds: ["science_research"],
+        category: "social",
         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",
+    platform_shock: {
+        id: "platform_shock",
+        title: "Platform Algorithm Shock",
+        description: "Algorithm change reshapes what agents see — engagement patterns shift overnight",
+        world: "social_simulation",
         events: [
-            "regulation_shock@2",
-            "flash_crash_rumor@3",
-            "diplomatic_breakthrough@5",
+            "algorithm_change@2",
+            "viral_misinfo@4",
+            "whistleblower_post@5",
         ],
-        compareWorlds: ["trading"],
-        category: "political",
+        category: "social",
         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",
+    // --- Research ---
+    research_pipeline: {
+        id: "research_pipeline",
+        title: "Governed Research Pipeline",
+        description: "AI agent runs a full research workflow — governance enforces scientific rigor at each step",
+        world: "science_research",
         events: [
-            "bank_collapse@1",
-            "tanker_explosion@2",
-            "taiwan_exercises@3",
-            "grid_failure@4",
-            "regulation_shock@5",
+            "search_literature@1",
+            "analyze_findings@2",
+            "cross_reference@3",
+            "unsupported_claim@4",
+            "hypothesis_validated@5",
+            "publish_result@6",
         ],
-        compareWorlds: ["strait_of_hormuz"],
-        category: "compound",
+        category: "research",
         rounds: 6,
     },
 };

package/dist/engine/swarmSimulation.js

@@ -4,18 +4,10 @@
  *
  * Lightweight stakeholder reaction simulation for POST /reason.
  *
- * IMPORTANT — MiroFish License Compliance:
- * This is NOT MiroFish. This is Echelon's own lightweight reaction model.
- * MiroFish is a separate product with its own license.
- * If/when MiroFish integration is desired, it would be called as an
- * external service via its REST API, respecting its license terms.
- *
  * This simulation layer uses:
  * - Echelon-native stakeholder modeling
  * - Simplified reaction dynamics (rational, emotional, mixed)
  * - Projected reactions based on scenario decomposition
- *
- * It does NOT use MiroFish internals, algorithms, or data structures.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSwarmSimulation = runSwarmSimulation;
@@ -203,7 +195,7 @@ function findInflectionPoints(rounds) {
 /**
  * Run the swarm simulation.
  *
- * This is Echelon's native reaction model — NOT MiroFish.
+ * This is Echelon's native reaction model.
  * It simulates how stakeholders react to different reasoning paths
  * over multiple rounds, detecting emergent dynamics.
  *

package/dist/engine/worldBridge.js

@@ -59,18 +59,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.initNeuroverseModule = initNeuroverseModule;
 exports.buildWorldFromScenario = buildWorldFromScenario;
 exports.evaluateScenarioGuard = evaluateScenarioGuard;
+exports.getIncentiveSystem = getIncentiveSystem;
 exports.runWorldSimulation = runWorldSimulation;
 exports.validateScenarioWorld = validateScenarioWorld;
 exports.verdictToConstitutionalChecks = verdictToConstitutionalChecks;
 exports.simulationToGovernanceSignals = simulationToGovernanceSignals;
 exports.validationToEnforcedConstraints = validationToEnforcedConstraints;
-// ============================================
-// LAZY MODULE LOADER
-// ============================================
-/**
- * Lazy-load @neuroverseos/governance at runtime.
- * Returns null in browser environments where Node modules aren't available.
- */
 let _nvModule;
 async function getNVModule() {
     if (_nvModule !== undefined)
@@ -81,6 +75,10 @@ async function getNVModule() {
             evaluateGuard: mod.evaluateGuard,
             simulateWorld: mod.simulateWorld,
             validateWorld: mod.validateWorld,
+            createAgentState: mod.createAgentState,
+            applyConsequence: mod.applyConsequence,
+            applyReward: mod.applyReward,
+            tickAgentStates: mod.tickAgentStates,
         };
         return _nvModule;
     }
@@ -314,10 +312,26 @@ function evaluateScenarioGuard(request, world, options) {
             has_goal: !!request.goal,
         },
     };
-    return nv.evaluateGuard(event, world, {
+    const verdict = nv.evaluateGuard(event, world, {
         trace: options?.trace ?? true,
         level: options?.level ?? "standard",
     });
+    return verdict;
+}
+/**
+ * Get the incentive system functions from the loaded NeuroverseOS module.
+ * Returns null if the module isn't loaded or doesn't export incentive functions.
+ */
+function getIncentiveSystem() {
+    const nv = getNVModuleSync();
+    if (!nv || !nv.createAgentState)
+        return null;
+    return {
+        createAgentState: nv.createAgentState,
+        applyConsequence: nv.applyConsequence,
+        applyReward: nv.applyReward,
+        tickAgentStates: nv.tickAgentStates,
+    };
 }
 // ============================================
 // SIMULATION — World state evolution