@neuroverseos/nv-sim 0.1.7 → 0.1.10

package/dist/engine/cli.js

@@ -81,17 +81,12 @@ async function main() {
             console.log("  " + "=".repeat(60));
             let result;
             let worldId;
-            if (presetId === "trading" || presetId === "flash_crash") {
-                console.log(`  Scenario: Flash Crash — Algorithmic Cascade\n`);
-                worldId = "trading-flash-crash";
-                result = await (0, governedSimulation_1.runGovernedComparison)(governedSimulation_1.TRADING_DEMO.scenario, governedSimulation_1.TRADING_DEMO.world, governedSimulation_1.TRADING_DEMO.paths, narrativeEvents.length > 0 ? narrativeEvents : undefined);
-            }
-            else {
+            {
                 // Try to use an existing preset
-                const template = scenarioCapsule_1.SCENARIO_TEMPLATES[presetId];
+                const template = scenarioCapsule_1.SCENARIO_TEMPLATES[presetId] ?? scenarioCapsule_1.SCENARIO_TEMPLATES["social_simulation"];
                 if (!template) {
                     console.error(`  Unknown preset: ${presetId}`);
-                    console.error(`  Available: trading, flash_crash, ${Object.keys(scenarioCapsule_1.SCENARIO_TEMPLATES).join(", ")}`);
+                    console.error(`  Available: ${Object.keys(scenarioCapsule_1.SCENARIO_TEMPLATES).join(", ")}`);
                     process.exit(1);
                 }
                 if (!template.world?.inline_definition) {
@@ -285,7 +280,7 @@ async function main() {
                 process.exit(1);
             }
             console.log("\n  NV-SIM — Analyzing simulation...\n");
-            const result = await (0, analyzer_1.analyzeMiroFishSimulation)({
+            const result = await (0, analyzer_1.analyzeSimulation)({
                 simulation: input,
                 question: args[2],
             });
@@ -455,7 +450,7 @@ async function main() {
         }
         case "run": {
             // Run an external simulator with governance
-            const simId = args[1] ?? "mirofish";
+            const simId = args[1] ?? "nv-sim";
             const runPort = args.includes("--port") ? parseInt(args[args.indexOf("--port") + 1], 10) : 3456;
             const noViewer = args.includes("--no-viewer");
             console.log(`\n  NV-SIM — Governed Simulation Runner\n`);
@@ -551,85 +546,32 @@ async function main() {
                 }
                 docText = fs.readFileSync(resolved, "utf-8");
             }
-            console.log(`\n  NV-SIM — World File Generator\n`);
+            console.log(`\n  NV-SIM — World Generator\n`);
             console.log(`  Reading: ${docPath === "-" ? "stdin" : docPath}`);
             console.log("  " + "=".repeat(60));
-            // Parse the document into a world definition
-            const lines = docText.split("\n").map(l => l.trim()).filter(l => l.length > 0);
+            // Use the full policy engine to parse rules and generate a complete world
+            const { parseRulesFromText, policyToWorld } = await Promise.resolve().then(() => __importStar(require("./policyEngine")));
+            const parsed = parseRulesFromText(docText);
+            const worldDef = policyToWorld(parsed);
             const worldId = args.includes("--id") ? args[args.indexOf("--id") + 1] : path.basename(docPath, path.extname(docPath)).replace(/\s+/g, "_").toLowerCase();
-            // Extract thesis (first paragraph or heading)
-            let thesis = "";
-            const invariants = [];
-            const gates = [];
-            const stateVars = [];
-            let invCount = 0;
-            let gateCount = 0;
-            for (const line of lines) {
-                const lower = line.toLowerCase();
-                // Skip markdown headers but use them for context
-                if (line.startsWith("#")) {
-                    if (!thesis)
-                        thesis = line.replace(/^#+\s*/, "");
-                    continue;
-                }
-                // First non-header line as thesis if not set
-                if (!thesis && line.length > 10) {
-                    thesis = line;
-                    continue;
-                }
-                // Detect rules: lines starting with block/prevent/limit/require/allow etc
-                if (/^(block|prevent|prohibit|ban|stop|forbid|no\b|don.t|limit|cap|restrict)/i.test(lower)) {
-                    invCount++;
-                    invariants.push({
-                        id: `INV-${String(invCount).padStart(3, "0")}`,
-                        description: line.replace(/^[-*•]\s*/, ""),
-                        enforceable: true,
-                    });
-                }
-                else if (/^(require|must|shall|ensure|mandate)/i.test(lower)) {
-                    invCount++;
-                    invariants.push({
-                        id: `INV-${String(invCount).padStart(3, "0")}`,
-                        description: line.replace(/^[-*•]\s*/, ""),
-                        enforceable: true,
-                    });
-                }
-                else if (/^(allow|permit|enable)/i.test(lower)) {
-                    invCount++;
-                    invariants.push({
-                        id: `INV-${String(invCount).padStart(3, "0")}`,
-                        description: line.replace(/^[-*•]\s*/, ""),
-                        enforceable: false,
-                    });
-                }
-                else if (/^(warn|alert|flag|monitor|watch)/i.test(lower)) {
-                    gateCount++;
-                    gates.push({
-                        id: `GATE-${String(gateCount).padStart(3, "0")}`,
-                        label: line.replace(/^[-*•]\s*/, ""),
-                        condition: lower,
-                        severity: /critical|extreme|emergency/i.test(lower) ? "critical" : "warning",
-                    });
-                }
-                else if (/^[-*•]\s*/.test(line)) {
-                    // Bullet points are probably rules
-                    invCount++;
-                    invariants.push({
-                        id: `INV-${String(invCount).padStart(3, "0")}`,
-                        description: line.replace(/^[-*•]\s*/, ""),
-                        enforceable: true,
-                    });
-                }
+            console.log(`\n  Parsed ${parsed.summary.total} rules (${parsed.summary.enforced} enforced, ${parsed.summary.advisory} advisory)`);
+            console.log(`\n  GENERATED WORLD: "${worldId}"`);
+            console.log("  " + "-".repeat(60));
+            console.log(`  Thesis:          ${worldDef.thesis}`);
+            console.log(`  State Variables:  ${worldDef.state_variables.length}`);
+            for (const sv of worldDef.state_variables) {
+                const rangeStr = sv.type === "number" && sv.range ? ` (${sv.range.min}-${sv.range.max}, default: ${sv.default_value})` : ` (default: ${sv.default_value})`;
+                console.log(`    - ${sv.label}${rangeStr}`);
             }
-            if (!thesis)
-                thesis = "Governance rules from " + (docPath === "-" ? "document" : docPath);
-            const worldDef = {
-                thesis,
-                state_variables: stateVars,
-                invariants,
-                gates,
-            };
-            // Wrap in SavedWorld format so enforce can consume it directly
+            console.log(`  Invariants:       ${worldDef.invariants.length}`);
+            for (const inv of worldDef.invariants) {
+                console.log(`    - [${inv.id}] ${inv.description}${inv.enforceable ? "" : " (advisory)"}`);
+            }
+            console.log(`  Gates:            ${worldDef.gates?.length ?? 0}`);
+            for (const gate of worldDef.gates ?? []) {
+                console.log(`    - [${gate.id}] ${gate.label}: ${gate.condition} (${gate.severity})`);
+            }
+            // Wrap in SavedWorld format
             const { createSavedWorld: createWorld } = await Promise.resolve().then(() => __importStar(require("./worldStorage")));
             const savedWorld = createWorld(worldId, worldDef, "document", {
                 description: `Generated from ${docPath === "-" ? "stdin" : docPath}`,
@@ -639,22 +581,15 @@ async function main() {
             const json = JSON.stringify(savedWorld, null, 2);
             if (outputPath) {
                 fs.writeFileSync(outputPath, json, "utf-8");
-                console.log(`\n  Generated: ${outputPath}`);
+                console.log(`\n  Saved: ${outputPath}`);
             }
             else {
                 console.log("\n" + json);
             }
-            console.log(`\n  Summary:`);
-            console.log(`    Thesis:     ${thesis}`);
-            console.log(`    Invariants: ${invariants.length}`);
-            console.log(`    Gates:      ${gates.length}`);
-            console.log(`\n  This world file is saved for reuse.`);
-            console.log(`  You don't need this step — enforce accepts .txt directly:`);
-            console.log(`    npx nv-sim enforce trading ${docPath === "-" ? "policy.txt" : docPath}`);
-            if (outputPath) {
-                console.log(`\n  But since you saved it, you can also:`);
-                console.log(`    npx nv-sim enforce trading ${outputPath}`);
-            }
+            console.log(`\n  Your world is complete — same structure as the built-in templates.`);
+            console.log(`  Use it:`);
+            console.log(`    npx nv-sim serve --world ${outputPath ?? worldId + ".json"}`);
+            console.log(`    npx nv-sim enforce ${worldId} ${docPath === "-" ? "rules.txt" : docPath}`);
             console.log("");
             break;
         }
@@ -961,109 +896,6 @@ async function main() {
             break;
         }
         // ============================================
-        // MIROFISH — Governed Agent Simulation
-        // ============================================
-        case "mirofish": {
-            console.log(`\n  MIROFISH SIMULATION — Governed by NeuroVerse\n`);
-            console.log(`  MiroFish + NeuroVerse Governance Layer`);
-            console.log(`  MiroFish generates emergent agent behavior.`);
-            console.log(`  NeuroVerse enforces rules, constraints, and system stability in real time.\n`);
-            console.log("  " + "=".repeat(60));
-            const { runMiroFishComparison } = await Promise.resolve().then(() => __importStar(require("../adapters/mirofish")));
-            const mfMode = args.includes("--compare") ? "compare" : "governed";
-            if (mfMode === "compare") {
-                console.log(`  Mode: GOVERNED vs UNGOVERNED COMPARISON\n`);
-                console.log(`  Running simulation...`);
-                const comparison = runMiroFishComparison();
-                const gov = comparison.governed;
-                const ungov = comparison.ungoverned;
-                const gs = gov.metrics.systemState;
-                const us = ungov.metrics.systemState;
-                console.log(`\n  Scenario: ${comparison.scenario}`);
-                console.log("  " + "=".repeat(60));
-                // Metric comparison
-                console.log(`\n  ${"Metric".padEnd(30)} ${"Governed".padEnd(15)} ${"Ungoverned".padEnd(15)} ${"Delta"}`);
-                console.log("  " + "-".repeat(75));
-                const mfMetrics = [
-                    ["Trust", gs.trust, us.trust],
-                    ["Polarization", gs.polarization, us.polarization],
-                    ["Outrage", gs.outrage, us.outrage],
-                    ["Cascade Risk", gs.cascadeRisk, us.cascadeRisk],
-                    ["Amplification", gs.amplification, us.amplification],
-                ];
-                for (const [label, gv, uv] of mfMetrics) {
-                    const delta = gv - uv;
-                    const deltaStr = `${delta > 0 ? "+" : ""}${(delta * 100).toFixed(0)}`;
-                    console.log(`  ${label.padEnd(30)} ${(gv * 100).toFixed(0).padStart(5)}%         ${(uv * 100).toFixed(0).padStart(5)}%         ${deltaStr.padStart(5)}`);
-                }
-                console.log(`\n  ${"".padEnd(30)} ${"Governed".padEnd(15)} ${"Ungoverned"}`);
-                console.log("  " + "-".repeat(60));
-                console.log(`  ${"Verdict".padEnd(30)} ${gov.verdict.padEnd(15)} ${ungov.verdict}`);
-                console.log(`  ${"Actions Blocked".padEnd(30)} ${String(gov.totalBlocked).padEnd(15)} ${0}`);
-                console.log(`  ${"Actions Modified".padEnd(30)} ${String(gov.totalModified).padEnd(15)} ${0}`);
-                console.log(`  ${"Trajectory".padEnd(30)} ${gov.metrics.trajectory.padEnd(15)} ${ungov.metrics.trajectory}`);
-                // State timeline
-                console.log(`\n  STATE EVOLUTION (Trust)`);
-                console.log("  " + "-".repeat(60));
-                console.log(`  ${"Round".padEnd(8)} ${"Governed".padEnd(15)} ${"Ungoverned".padEnd(15)} ${"Gap"}`);
-                for (let i = 0; i < gov.timeline.length; i++) {
-                    const gt = gov.timeline[i].systemState.trust;
-                    const ut = ungov.timeline[i].systemState.trust;
-                    const gap = gt - ut;
-                    console.log(`  ${String(i + 1).padEnd(8)} ${(gt * 100).toFixed(0).padStart(5)}%         ${(ut * 100).toFixed(0).padStart(5)}%         ${(gap > 0 ? "+" : "") + (gap * 100).toFixed(0).padStart(4)}`);
-                }
-                // Science state comparison
-                const govSci = gov.metrics.scienceState;
-                const ungovSci = ungov.metrics.scienceState;
-                console.log(`\n  SYSTEM ASSESSMENT`);
-                console.log("  " + "-".repeat(60));
-                console.log(`  Governed:    ${govSci.overallAssessment}`);
-                console.log(`  Ungoverned:  ${ungovSci.overallAssessment}`);
-                console.log(`\n  This simulation was generated by MiroFish.`);
-                console.log(`  NeuroVerse governance altered the system trajectory in real time.`);
-            }
-            else {
-                // Single governed run
-                console.log(`  Mode: GOVERNED SIMULATION\n`);
-                const { createMiroFishWrapper, generateDemoSimulation } = await Promise.resolve().then(() => __importStar(require("../adapters/mirofish")));
-                const demo = generateDemoSimulation();
-                const wrapper = createMiroFishWrapper({ enabled: true });
-                console.log(`  Scenario: ${demo.scenario}\n`);
-                for (let i = 0; i < demo.rounds.length; i++) {
-                    const round = demo.rounds[i];
-                    let blocked = 0;
-                    let modified = 0;
-                    const approved = [];
-                    for (const action of round) {
-                        const result = wrapper.interceptAction(action);
-                        if (result.wasBlocked)
-                            blocked++;
-                        else if (result.wasModified)
-                            modified++;
-                        if (!result.wasBlocked)
-                            approved.push(result.governed ?? action);
-                    }
-                    const cycleResult = wrapper.completeCycle({ cycle: i + 1, actions: approved });
-                    const m = wrapper.getMetrics();
-                    const flags = blocked > 0 ? ` [${blocked} blocked]` : "";
-                    console.log(`  Round ${String(i + 1).padEnd(3)} | trust: ${(m.systemState.trust * 100).toFixed(0).padStart(3)}% | cascade: ${(m.systemState.cascadeRisk * 100).toFixed(0).padStart(3)}% | ${cycleResult.trajectory}${flags}`);
-                }
-                const final = wrapper.getMetrics();
-                console.log(`\n  FINAL STATE`);
-                console.log("  " + "=".repeat(50));
-                console.log(`  Trust:         ${(final.systemState.trust * 100).toFixed(0)}%`);
-                console.log(`  Cascade Risk:  ${(final.systemState.cascadeRisk * 100).toFixed(0)}%`);
-                console.log(`  Blocked:       ${final.actionStats.blocked}`);
-                console.log(`  Modified:      ${final.actionStats.modified}`);
-                console.log(`  Assessment:    ${final.scienceState.overallAssessment}`);
-            }
-            console.log(`\n  ${"=".repeat(60)}`);
-            console.log(`  Governed MiroFish Simulation  |  NeuroVerse Governance Layer`);
-            console.log(`  ${"=".repeat(60)}`);
-            console.log(`\n  neuroverse-simulations | @neuroverseos\n`);
-            break;
-        }
-        // ============================================
         // SCIENCE — Governed Scientific Discovery
         // ============================================
         case "science": {
@@ -1226,17 +1058,12 @@ async function main() {
             let basePaths;
             let baseWorldDef;
             let scenarioTitle;
-            if (presetArg === "trading" || presetArg === "flash_crash") {
-                baseRequest = governedSimulation_1.TRADING_DEMO.scenario;
-                basePaths = [...governedSimulation_1.TRADING_DEMO.paths];
-                baseWorldDef = governedSimulation_1.TRADING_DEMO.world;
-                scenarioTitle = "Flash Crash — Algorithmic Cascade";
-            }
-            else {
-                const template = scenarioCapsule_1.SCENARIO_TEMPLATES[presetArg];
+            {
+                const resolvedPreset = presetArg === "trading" || presetArg === "flash_crash" ? "social_simulation" : presetArg;
+                const template = scenarioCapsule_1.SCENARIO_TEMPLATES[resolvedPreset];
                 if (!template || !template.world?.inline_definition) {
                     console.error(`  Unknown preset: ${presetArg}`);
-                    console.error(`  Available: trading, ${Object.keys(scenarioCapsule_1.SCENARIO_TEMPLATES).join(", ")}`);
+                    console.error(`  Available: ${Object.keys(scenarioCapsule_1.SCENARIO_TEMPLATES).join(", ")}`);
                     process.exit(1);
                 }
                 baseRequest = {
@@ -1544,6 +1371,84 @@ async function main() {
             }
             break;
         }
+        // ============================================
+        // CONNECT — Connector setup instructions
+        // ============================================
+        case "connect": {
+            const connector = args[1]?.toLowerCase();
+            if (connector === "scienceclaw" || connector === "science") {
+                console.log(`
+  NV-SIM — ScienceClaw Connector Setup
+
+  WHAT THIS DOES:
+    Wraps ScienceClaw's entry point with NeuroVerse governance.
+    ScienceClaw runs unchanged. Governance happens automatically.
+
+  ${"=".repeat(60)}
+
+  OPTION 1: Python Wrapper (zero dependencies besides requests)
+
+    # Step 1: Start governance server
+    nv-sim serve
+
+    # Step 2: Run ScienceClaw through the wrapper
+    python connectors/nv_scienceclaw_wrapper.py --agent MyAgent --topic "CRISPR risks"
+
+    # Environment variables:
+    NEUROVERSE_URL=http://localhost:3456   # governance server
+    SCIENCECLAW_BIN=scienceclaw-post       # path to scienceclaw binary
+
+  ${"=".repeat(60)}
+
+  OPTION 2: Node.js CLI (installed via npm)
+
+    # Step 1: Start governance server
+    nv-sim serve
+
+    # Step 2: Use the drop-in replacement command
+    nv-scienceclaw-post --agent MyAgent --topic "CRISPR risks"
+
+    # Same args as scienceclaw-post — governance is transparent.
+
+  ${"=".repeat(60)}
+
+  OPTION 3: Live Process Adapter (real-time governance)
+
+    # Spawns ScienceClaw as a child process, governs each artifact cycle live
+    nv-sim run scienceclaw --args "--agent MyAgent --topic CRISPR"
+
+  ${"=".repeat(60)}
+
+  HOW IT WORKS:
+
+    User runs wrapper
+         |
+    Wrapper calls NeuroVerse /api/evaluate
+         |
+    ALLOW/REWARD -> execute scienceclaw-post
+    BLOCK/PENALIZE -> stop, print reason
+    MODIFY -> adjust parameters, then execute
+
+  ScienceClaw is NEVER modified. Governance is external.
+`);
+            }
+            else {
+                console.log(`
+  NV-SIM — Connectors
+
+  Available connectors:
+    scienceclaw    Govern ScienceClaw investigations
+
+  Usage:
+    nv-sim connect scienceclaw         # Setup instructions
+
+  Or run directly:
+    nv-sim run scienceclaw             # Live process adapter
+    nv-sim serve                       # Start governance server for any connector
+`);
+            }
+            break;
+        }
         case "help":
         case "--help":
         case "-h":
@@ -1572,14 +1477,12 @@ async function main() {
     serve | govern         Start local governance runtime
                            --port N (default: 3456)
     run <simulator>        Run external simulator with governance
-                           e.g., nv-sim run mirofish
+                           e.g., nv-sim run scienceclaw
     radiant [preset]       Prime Radiant — full policy enforcement system
                            Dual-layer: govern() + governDynamics()
                            --world     MODE 1: build & validate world
                            --compare   MODE 3: decision intelligence (N options)
                            (default)   MODE 2: governed simulation with comparison
-    mirofish               MiroFish agent simulation with governance
-                           --compare   Governed vs ungoverned comparison
     science                Science mode — governed autonomous discovery
                            --compare   Governed vs ungoverned comparison
     world-from-doc <file>  Generate world rules from a document
@@ -1609,7 +1512,7 @@ async function main() {
     npx nv-sim chaos --runs 500                 # Stress test (500 runs)
     npx nv-sim visualize                        # Live viewer in browser
     npx nv-sim serve                            # Start local governance runtime
-    npx nv-sim run mirofish                     # Run MiroFish with governance
+    npx nv-sim run scienceclaw                 # Run ScienceClaw with governance
     npx nv-sim compare strait_of_hormuz         # Geopolitical demo
     npx nv-sim compare --inject tanker_explosion@3  # With narrative shock
     npx nv-sim compare --inject rate_cut@3,sanctions@5
@@ -1638,16 +1541,18 @@ async function main() {
     npx nv-sim radiant geopolitical_crisis --world # World builder mode
     npx nv-sim radiant scientific_discovery        # Science discovery preset
 
-  MIROFISH MODE:
-
-    npx nv-sim mirofish                            # Governed agent simulation
-    npx nv-sim mirofish --compare                  # Governed vs ungoverned comparison
-
   SCIENCE MODE:
 
     npx nv-sim science                             # Governed investigation demo
     npx nv-sim science --compare                   # Governed vs ungoverned comparison
 
+  CONNECTORS (wrap external simulators with governance):
+
+    npx nv-sim connect scienceclaw                 # Setup instructions
+    npx nv-sim run scienceclaw                     # Live process adapter
+    nv-scienceclaw-post --agent X --topic "Y"      # Drop-in CLI wrapper
+    python connectors/nv_scienceclaw_wrapper.py    # Python wrapper
+
   Design rules. Run reality. See what changes.
 `);
             break;

package/dist/engine/dynamicsGovernance.js

@@ -188,6 +188,8 @@ function parseDynamicsRules(policyText) {
 // ============================================
 function createDynamicsGovernor(policyText, initialState, options) {
     const dynamicsRules = options?.skipRules ? [] : parseDynamicsRules(policyText);
+    // Per-agent incentive stats at the dynamics level
+    const agentIncentiveStats = new Map();
     let state = {
         polarization: 0.1,
         outrage: 0.1,
@@ -537,6 +539,7 @@ function createDynamicsGovernor(policyText, initialState, options) {
             history: [],
             ...initialState,
         };
+        agentIncentiveStats.clear();
         stats.totalRounds = 0;
         stats.totalInterventions = 0;
         stats.propagationLimits = 0;
@@ -555,6 +558,7 @@ function createDynamicsGovernor(policyText, initialState, options) {
         /** Mutate the internal state directly (used by adapters for governance feedback) */
         mutateState(fn) { fn(state); },
         get rules() { return [...dynamicsRules]; },
+        get agentIncentiveStats() { return agentIncentiveStats; },
         get stats() {
             return {
                 totalRounds: stats.totalRounds,

package/dist/engine/fullGovernedLoop.js

@@ -28,7 +28,7 @@ const narrativeInjection_1 = require("./narrativeInjection");
 /**
  * Convert a SwarmAgentReaction into an AgentAction for govern().
  *
- * This is the bridge between MiroFish/Swarm output and NeuroVerse governance.
+ * This is the bridge between Swarm output and NeuroVerse governance.
  * It infers action type, magnitude, and description from the reaction content.
  */
 function reactionToAction(reaction) {
@@ -91,6 +91,21 @@ function applyVerdictToReaction(reaction, verdict) {
             confidence: Number(reaction.confidence.toFixed(3)),
         };
     }
+    if (verdict.status === "PENALIZE") {
+        // Penalized agents get blocked AND frozen — stronger than BLOCK
+        return {
+            ...reaction,
+            impact: 0,
+            confidence: Number((Math.max(0.01, reaction.confidence * 0.1)).toFixed(3)),
+        };
+    }
+    if (verdict.status === "REWARD") {
+        // Rewarded agents get a confidence boost — positive reinforcement
+        return {
+            ...reaction,
+            confidence: Number((Math.min(1, reaction.confidence * 1.3)).toFixed(3)),
+        };
+    }
     // ALLOW — no change
     return reaction;
 }

package/dist/engine/goalEngine.js

@@ -8,7 +8,7 @@
  * from the goal to generate candidate strategies, then tests each one
  * against the swarm simulation to rank feasibility.
  *
- * Two modes of Mirotir:
+ * Two modes of NeuroVerse:
  *   EXPLORE: "What might happen?"  → forward simulation → discovery
  *   GOAL:    "How do I get here?"  → backward reasoning → strategy design
  *
@@ -32,7 +32,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runGoalReasoning = runGoalReasoning;
-const mirofish_1 = require("./mirofish");
+const swarmSimulation_1 = require("./swarmSimulation");
 // ============================================
 // LEVER INFERENCE
 // ============================================
@@ -409,8 +409,7 @@ async function testStrategyAgainstSwarm(strategy, scenario, goal, stakeholders,
         harms_stakeholders: strategy.likely_opponents,
     };
     // Run the simulation
-    const unified = await (0, mirofish_1.runUnifiedSimulation)(strategyScenario, stakeholders, [strategyPath], swarmConfig);
-    const result = unified.result;
+    const result = await (0, swarmSimulation_1.runSwarmSimulation)(strategyScenario, stakeholders, [strategyPath], swarmConfig);
     // Evaluate goal proximity from swarm results
     const avgImpact = result.rounds.length > 0
         ? result.rounds[result.rounds.length - 1].reactions.reduce((s, r) => s + r.impact, 0) / result.rounds[result.rounds.length - 1].reactions.length

package/dist/engine/governance.js

@@ -129,6 +129,24 @@ function runFullGovernanceChecks(request, worldLite) {
                 detail: `Guard paused: ${guardVerdict.reason ?? "Review recommended"}. Continuing in advisory mode.`,
             });
         }
+        // If guard penalizes, note it with consequence details
+        if (guardVerdict.status === "PENALIZE") {
+            results.push({
+                rule_id: "NV-PENALIZE",
+                rule: "NeuroverseOS guard issued PENALIZE — agent penalized",
+                passed: false,
+                detail: `Guard penalized: ${guardVerdict.consequence?.description ?? guardVerdict.reason ?? "Action penalized by guard"}. Agent frozen for ${guardVerdict.consequence?.rounds ?? 1} round(s). Continuing in advisory mode.`,
+            });
+        }
+        // If guard rewards, note it with reward details
+        if (guardVerdict.status === "REWARD") {
+            results.push({
+                rule_id: "NV-REWARD",
+                rule: "NeuroverseOS guard issued REWARD — agent rewarded",
+                passed: true,
+                detail: `Guard rewarded: ${guardVerdict.reward?.description ?? guardVerdict.reason ?? "Action rewarded by guard"}. Agent influence boosted.`,
+            });
+        }
     }
     catch (error) {
         // If NeuroverseOS evaluation fails, log and continue with Echelon checks

package/dist/engine/index.js

@@ -1,28 +1,27 @@
 "use strict";
 /**
- * Echelon Reason API — Public Exports
+ * NeuroVerse — Governed Discovery Engine
  *
- * The POST /reason API makes Echelon reasoning infrastructure.
- * This is the "Stripe for reasoning" layer that agents,
- * applications, and the Mirotir UI all consume.
+ * Public exports for the reasoning and governance infrastructure.
+ * Built on @neuroverseos/governance (open source).
  *
  * Architecture:
- *   Mirotir UI (showcase) ──→ POST /reason ──→ Echelon kernel (proprietary)
- *   Autonomous agents     ──→ POST /reason ──→ Echelon kernel
- *   Third-party apps      ──→ POST /reason ──→ Echelon kernel
- *                                    │
- *                                    ├── Governance traces (open, auditable)
- *                                    ├── MiroFish swarm simulation (when available)
- *                                    ├── Echelon-native simulation (fallback)
- *                                    ├── World files (reasoning models)
- *                                    └── Scenario capsules (shareable, portable)
+ *   NeuroVerse UI           ──→ POST /reason ──→ Echelon kernel (proprietary)
+ *   Autonomous agents       ──→ POST /reason ──→ Echelon kernel
+ *   Third-party apps        ──→ POST /reason ──→ Echelon kernel
+ *   ScienceClaw / any swarm ──→ POST /reason ──→ Echelon kernel
+ *                                      │
+ *                                      ├── Governance traces (open, auditable)
+ *                                      ├── Swarm simulation (native or external)
+ *                                      ├── World files (NeuroverseOS governance models)
+ *                                      ├── Intent translator (NL → rules)
+ *                                      └── Scenario capsules (shareable, portable)
  *
- * MiroFish shows WHAT might happen → the spectacle
- * Mirotir helps you decide WHAT TO DO → the brain
+ * Scientists define what matters → governance enforces it → agents operate within bounds.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.policyToWorld = exports.validatePolicy = exports.parseRulesFromText = exports.suggestExperiments = exports.formatPolicyDiagnostics = exports.formatGuidedNextSteps = exports.exportEnforcementReportJSON = exports.formatEnforcementReport = exports.createEnforcementSession = exports.formatCrossRunComparison = exports.formatBehavioralAnalysis = exports.compareBehaviorAcrossRuns = exports.detectBehavioralShifts = exports.computeActionDistributions = exports.buildAgentTrajectories = exports.classifyBehavior = exports.analyzeBehavior = exports.TRADING_DEMO = exports.runGovernedComparison = exports.analyzeMiroFishSimulation = exports.DEFAULT_MIROFISH_CONFIG = exports.buildMiroFishRequest = exports.miroFishResultToSwarmResult = exports.stakeholdersToMiroFishAgents = exports.runUnifiedSimulation = exports.getMiroFishClient = exports.configureMiroFish = exports.MiroFishError = exports.MiroFishClient = exports.runSwarmSimulation = exports.initNeuroverseModule = exports.validationToEnforcedConstraints = exports.simulationToGovernanceSignals = exports.verdictToConstitutionalChecks = exports.validateScenarioWorld = exports.runWorldSimulation = exports.evaluateScenarioGuard = exports.buildWorldFromScenario = exports.runFullGovernanceChecks = exports.runGovernanceChecks = exports.processReasonRequest = exports.SCENARIO_TEMPLATES = exports.getPresetCapsule = exports.extractCapsuleFromUrl = exports.buildShareableUrl = exports.decodeCapsule = exports.encodeCapsule = exports.capsuleToReasonRequest = exports.createCapsule = exports.runGoalReasoning = void 0;
-exports.EXAMPLE_WORLD_STATES = exports.EXAMPLE_ACTIONS = exports.createGovernor = exports.govern = exports.extractTrace = exports.generateGovernedReport = exports.formatAuditTrail = exports.searchAuditTrails = exports.loadAuditSession = exports.listAuditSessions = exports.AuditTrail = exports.evaluateAIAction = exports.listAIProviders = exports.getDefaultProviderName = exports.getAIProvider = exports.registerAIProvider = exports.generateAIReaction = exports.generateDeterministicReport = exports.OpenAICompatibleProvider = exports.AnthropicProvider = exports.DeterministicProvider = exports.AI_ROLES = exports.parseReasonRequestBody = exports.handleRunPreset = exports.handleGetPreset = exports.handleListPresets = exports.handleHealthCheck = exports.handleCreateCapsule = exports.handleReasonFromCapsule = exports.handleReasonRequest = exports.applyQuickFix = exports.runPolicyPipeline = void 0;
+exports.parseReasonRequestBody = exports.handleRunPreset = exports.handleGetPreset = exports.handleListPresets = exports.handleHealthCheck = exports.handleCreateCapsule = exports.handleReasonFromCapsule = exports.handleReasonRequest = exports.applyQuickFix = exports.runPolicyPipeline = exports.policyToWorld = exports.validatePolicy = exports.parseRulesFromText = exports.suggestExperiments = exports.formatPolicyDiagnostics = exports.formatGuidedNextSteps = exports.exportEnforcementReportJSON = exports.formatEnforcementReport = exports.createEnforcementSession = exports.formatCrossRunComparison = exports.formatBehavioralAnalysis = exports.compareBehaviorAcrossRuns = exports.detectBehavioralShifts = exports.computeActionDistributions = exports.buildAgentTrajectories = exports.classifyBehavior = exports.analyzeBehavior = exports.runGovernedComparison = exports.analyzeSimulation = exports.runSwarmSimulation = exports.initNeuroverseModule = exports.validationToEnforcedConstraints = exports.simulationToGovernanceSignals = exports.verdictToConstitutionalChecks = exports.validateScenarioWorld = exports.runWorldSimulation = exports.evaluateScenarioGuard = exports.buildWorldFromScenario = exports.runFullGovernanceChecks = exports.runGovernanceChecks = exports.processReasonRequest = exports.SCENARIO_TEMPLATES = exports.getPresetCapsule = exports.extractCapsuleFromUrl = exports.buildShareableUrl = exports.decodeCapsule = exports.encodeCapsule = exports.capsuleToReasonRequest = exports.createCapsule = exports.runGoalReasoning = void 0;
+exports.EXAMPLE_WORLD_STATES = exports.EXAMPLE_ACTIONS = exports.createGovernor = exports.govern = exports.extractTrace = exports.generateGovernedReport = exports.translateIntent = exports.formatAuditTrail = exports.searchAuditTrails = exports.loadAuditSession = exports.listAuditSessions = exports.AuditTrail = exports.evaluateAIAction = exports.listAIProviders = exports.getDefaultProviderName = exports.getAIProvider = exports.registerAIProvider = exports.generateAIReaction = exports.generateDeterministicReport = exports.OpenAICompatibleProvider = exports.AnthropicProvider = exports.DeterministicProvider = exports.AI_ROLES = void 0;
 // Goal-Directed Strategy Engine
 var goalEngine_1 = require("./goalEngine");
 Object.defineProperty(exports, "runGoalReasoning", { enumerable: true, get: function () { return goalEngine_1.runGoalReasoning; } });
@@ -56,21 +55,10 @@ Object.defineProperty(exports, "initNeuroverseModule", { enumerable: true, get:
 // Swarm Simulation (Echelon-native)
 var swarmSimulation_1 = require("./swarmSimulation");
 Object.defineProperty(exports, "runSwarmSimulation", { enumerable: true, get: function () { return swarmSimulation_1.runSwarmSimulation; } });
-var mirofish_1 = require("./mirofish");
-Object.defineProperty(exports, "MiroFishClient", { enumerable: true, get: function () { return mirofish_1.MiroFishClient; } });
-Object.defineProperty(exports, "MiroFishError", { enumerable: true, get: function () { return mirofish_1.MiroFishError; } });
-Object.defineProperty(exports, "configureMiroFish", { enumerable: true, get: function () { return mirofish_1.configureMiroFish; } });
-Object.defineProperty(exports, "getMiroFishClient", { enumerable: true, get: function () { return mirofish_1.getMiroFishClient; } });
-Object.defineProperty(exports, "runUnifiedSimulation", { enumerable: true, get: function () { return mirofish_1.runUnifiedSimulation; } });
-Object.defineProperty(exports, "stakeholdersToMiroFishAgents", { enumerable: true, get: function () { return mirofish_1.stakeholdersToMiroFishAgents; } });
-Object.defineProperty(exports, "miroFishResultToSwarmResult", { enumerable: true, get: function () { return mirofish_1.miroFishResultToSwarmResult; } });
-Object.defineProperty(exports, "buildMiroFishRequest", { enumerable: true, get: function () { return mirofish_1.buildMiroFishRequest; } });
-Object.defineProperty(exports, "DEFAULT_MIROFISH_CONFIG", { enumerable: true, get: function () { return mirofish_1.DEFAULT_MIROFISH_CONFIG; } });
 var analyzer_1 = require("./analyzer");
-Object.defineProperty(exports, "analyzeMiroFishSimulation", { enumerable: true, get: function () { return analyzer_1.analyzeMiroFishSimulation; } });
+Object.defineProperty(exports, "analyzeSimulation", { enumerable: true, get: function () { return analyzer_1.analyzeSimulation; } });
 var governedSimulation_1 = require("./governedSimulation");
 Object.defineProperty(exports, "runGovernedComparison", { enumerable: true, get: function () { return governedSimulation_1.runGovernedComparison; } });
-Object.defineProperty(exports, "TRADING_DEMO", { enumerable: true, get: function () { return governedSimulation_1.TRADING_DEMO; } });
 var behavioralAnalysis_1 = require("./behavioralAnalysis");
 Object.defineProperty(exports, "analyzeBehavior", { enumerable: true, get: function () { return behavioralAnalysis_1.analyzeBehavior; } });
 Object.defineProperty(exports, "classifyBehavior", { enumerable: true, get: function () { return behavioralAnalysis_1.classifyBehavior; } });
@@ -121,6 +109,8 @@ Object.defineProperty(exports, "listAuditSessions", { enumerable: true, get: fun
 Object.defineProperty(exports, "loadAuditSession", { enumerable: true, get: function () { return auditTrace_1.loadAuditSession; } });
 Object.defineProperty(exports, "searchAuditTrails", { enumerable: true, get: function () { return auditTrace_1.searchAuditTrails; } });
 Object.defineProperty(exports, "formatAuditTrail", { enumerable: true, get: function () { return auditTrace_1.formatAuditTrail; } });
+var intentTranslator_1 = require("./intentTranslator");
+Object.defineProperty(exports, "translateIntent", { enumerable: true, get: function () { return intentTranslator_1.translateIntent; } });
 var reportEngine_1 = require("./reportEngine");
 Object.defineProperty(exports, "generateGovernedReport", { enumerable: true, get: function () { return reportEngine_1.generateGovernedReport; } });
 Object.defineProperty(exports, "extractTrace", { enumerable: true, get: function () { return reportEngine_1.extractTrace; } });