@neuroverseos/nv-sim 0.1.10 → 0.1.11

package/dist/assets/{reportEngine-CYSZfooa.js → reportEngine-Bu8bB5Yq.js}

@@ -1 +1 @@
-import{g as d,A as m,e as u,a as v}from"./index-CdghpsS8.js";function p(s){const e=s.governed,i=s.governanceStats,c=e.swarm.rounds.map((a,t)=>{var o;return{round:a.round,reactions:a.reactions.map(n=>({agent:n.stakeholder_id,action:n.reaction,impact:n.impact,verdict:void 0})),interventions:((o=a.emergent_dynamics)==null?void 0:o.filter(n=>n.includes("[BLOCK]")||n.includes("[PAUSE]")||n.includes("CIRCUIT BREAKER")||n.includes("intervention")))??[]}}),r=e.swarm.rounds.flatMap(a=>(a.emergent_dynamics??[]).filter(t=>t.includes("[BLOCK]")||t.includes("[PAUSE]")||t.includes("GATE")||t.includes("Rebalanced")||t.includes("Capped"))),l={avgImpact:e.metrics.avgImpact,collapseProbability:e.metrics.collapseProbability,stabilityScore:e.metrics.stabilityScore,maxVolatility:e.metrics.maxVolatility,peakNegativeSentiment:e.metrics.peakNegativeSentiment};return{scenario:s.scenario,rounds:c,metrics:l,interventions:r,governanceStats:{totalEvaluations:i.totalEvaluations,blocks:i.verdicts.block,pauses:i.verdicts.pause,allows:i.verdicts.allow,rulesFired:i.rulesFired}}}async function y(s,e={}){const i=p(s),c=e.aiEnabled??!1,r=c?e.provider??"deterministic":"deterministic",l=d(r),a=m.find(o=>o.id==="ai_analyst"),t=await u(a,"generate_report",async()=>c&&r!=="deterministic"?l.summarize(i):v(i));return{report:t.result,governance:t,aiUsed:c&&r!=="deterministic",provider:r}}export{p as extractTrace,y as generateGovernedReport};
+import{g as d,A as m,e as u,a as v}from"./index-sT4b_z7w.js";function p(s){const e=s.governed,i=s.governanceStats,c=e.swarm.rounds.map((a,t)=>{var o;return{round:a.round,reactions:a.reactions.map(n=>({agent:n.stakeholder_id,action:n.reaction,impact:n.impact,verdict:void 0})),interventions:((o=a.emergent_dynamics)==null?void 0:o.filter(n=>n.includes("[BLOCK]")||n.includes("[PAUSE]")||n.includes("CIRCUIT BREAKER")||n.includes("intervention")))??[]}}),r=e.swarm.rounds.flatMap(a=>(a.emergent_dynamics??[]).filter(t=>t.includes("[BLOCK]")||t.includes("[PAUSE]")||t.includes("GATE")||t.includes("Rebalanced")||t.includes("Capped"))),l={avgImpact:e.metrics.avgImpact,collapseProbability:e.metrics.collapseProbability,stabilityScore:e.metrics.stabilityScore,maxVolatility:e.metrics.maxVolatility,peakNegativeSentiment:e.metrics.peakNegativeSentiment};return{scenario:s.scenario,rounds:c,metrics:l,interventions:r,governanceStats:{totalEvaluations:i.totalEvaluations,blocks:i.verdicts.block,pauses:i.verdicts.pause,allows:i.verdicts.allow,rulesFired:i.rulesFired}}}async function y(s,e={}){const i=p(s),c=e.aiEnabled??!1,r=c?e.provider??"deterministic":"deterministic",l=d(r),a=m.find(o=>o.id==="ai_analyst"),t=await u(a,"generate_report",async()=>c&&r!=="deterministic"?l.summarize(i):v(i));return{report:t.result,governance:t,aiUsed:c&&r!=="deterministic",provider:r}}export{p as extractTrace,y as generateGovernedReport};

package/dist/connectors/nv-scienceclaw-post.js

@@ -5,22 +5,23 @@
  *
  * Drop-in replacement for `scienceclaw-post` that adds governance.
  *
- * Governance layers:
- *   Level 1 (entry gate):  Evaluates the invocation BEFORE ScienceClaw starts
- *   Level 2 (streaming):   Parses stdout, evaluates each artifact/cycle via /api/evaluate
- *   Level 3 (completion):  Reports final state back to governance server
+ * How it works:
+ *   1. Entry gate: evaluates the investigation BEFORE ScienceClaw starts
+ *   2. Runs scienceclaw-post as a child process (stdout/stderr pass through)
+ *   3. Watches ~/.scienceclaw/artifacts/{agent}/store.jsonl for new artifacts
+ *   4. Each new artifact line is sent to /api/evaluate for governance
+ *   5. Reports final stats when ScienceClaw exits
  *
- * Instead of:
- *   scienceclaw-post --agent MyAgent --topic "CRISPR risks"
+ * ScienceClaw does NOT print JSON to stdout — it writes JSONL to files.
+ * So we watch the file, not stdout.
  *
- * Run:
+ * Usage:
  *   nv-scienceclaw-post --agent MyAgent --topic "CRISPR risks"
  *
  * Environment variables:
  *   NEUROVERSE_URL      — Governance server URL (default: http://localhost:3456)
  *   SCIENCECLAW_BIN     — Path to scienceclaw-post binary (default: scienceclaw-post)
  *   NV_VERBOSE          — Set to "1" for verbose output
- *   NV_ENFORCE_STREAMING — Set to "0" to disable streaming governance (entry gate only)
  *
  * Zero edits to ScienceClaw required.
  */
@@ -29,6 +30,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
 const http_1 = __importDefault(require("http"));
 const https_1 = __importDefault(require("https"));
 // ============================================
@@ -37,7 +41,6 @@ const https_1 = __importDefault(require("https"));
 const NEUROVERSE_URL = process.env.NEUROVERSE_URL ?? "http://localhost:3456";
 const SCIENCECLAW_BIN = process.env.SCIENCECLAW_BIN ?? "scienceclaw-post";
 const VERBOSE = process.env.NV_VERBOSE === "1";
-const ENFORCE_STREAMING = process.env.NV_ENFORCE_STREAMING !== "0";
 // ============================================
 // STATS
 // ============================================
@@ -48,7 +51,6 @@ const stats = {
     penalized: 0,
     rewarded: 0,
     modified: 0,
-    cyclesSeen: 0,
     artifactsSeen: 0,
 };
 function parseArgs(argv) {
@@ -57,9 +59,7 @@ function parseArgs(argv) {
         agent: "unknown",
         topic: "",
         skill: null,
-        confidence: null,
         passthroughArgs: [],
-        noStream: false,
     };
     const nvArgIndices = new Set();
     let i = 0;
@@ -77,10 +77,6 @@ function parseArgs(argv) {
                 parsed.skill = args[++i] ?? null;
                 i++;
                 break;
-            case "--confidence":
-                parsed.confidence = parseFloat(args[++i] ?? "0.5");
-                i++;
-                break;
             case "--nv-url":
                 nvArgIndices.add(i);
                 nvArgIndices.add(i + 1);
@@ -90,11 +86,6 @@ function parseArgs(argv) {
                 nvArgIndices.add(i);
                 i++;
                 break;
-            case "--nv-no-stream":
-                nvArgIndices.add(i);
-                parsed.noStream = true;
-                i++;
-                break;
             default:
                 i++;
         }
@@ -103,7 +94,7 @@ function parseArgs(argv) {
     return parsed;
 }
 // ============================================
-// GOVERNANCE EVALUATION (zero dependencies)
+// GOVERNANCE EVALUATION
 // ============================================
 function evaluate(actionType, agent, extra) {
     return new Promise((resolve) => {
@@ -111,7 +102,7 @@ function evaluate(actionType, agent, extra) {
             actor: agent,
             action: actionType,
             payload: {
-                description: `Agent ${agent} executing ${actionType}`,
+                description: extra?.description ?? `Agent ${agent} executing ${actionType}`,
                 ...extra,
             },
             world: "science_research",
@@ -158,7 +149,7 @@ function evaluate(actionType, agent, extra) {
         req.on("error", () => {
             if (stats.evaluated === 0) {
                 console.log(`  [NV] WARNING: NeuroVerse server not reachable at ${NEUROVERSE_URL}`);
-                console.log(`  [NV] Start it with: nv-sim serve`);
+                console.log(`  [NV] Start it with: npx tsx src/server/index.ts`);
                 console.log(`  [NV] Falling back to ALLOW (ungoverned mode)\n`);
             }
             resolve({ decision: "ALLOW", reason: "Governance server unavailable" });
@@ -172,79 +163,111 @@ function evaluate(actionType, agent, extra) {
     });
 }
 // ============================================
-// STREAMING GOVERNANCE — parse + evaluate
-//
-// Schema-gated: only strict JSON lines are governed.
-// Non-JSON output is passed through without evaluation (by design).
-// No regex or heuristic parsing — safety and determinism over flexibility.
+// JSONL FILE WATCHER
 // ============================================
-async function governLine(line, agent, killFn) {
-    const trimmed = line.trim();
-    if (!trimmed)
-        return false;
-    if (!trimmed.startsWith("{")) {
-        if (VERBOSE)
-            console.log(`  [NV] [ungoverned: not_json] ${trimmed.slice(0, 120)}`);
-        return false;
-    }
-    let data;
+/**
+ * Watch a JSONL file for new lines appended by ScienceClaw.
+ * Each new line is parsed and sent to governance.
+ *
+ * ScienceClaw writes artifacts to:
+ *   ~/.scienceclaw/artifacts/{agent}/store.jsonl
+ *
+ * Each line is a JSON artifact with fields:
+ *   artifact_id, artifact_type, producer_agent, skill_used,
+ *   payload, investigation_id, content_hash, parent_artifact_ids,
+ *   result_quality, needs, timestamp
+ */
+function watchArtifactFile(filePath, agent) {
+    let fileSize = 0;
+    // Get initial file size (skip existing content)
     try {
-        data = JSON.parse(trimmed);
-    }
-    catch {
-        if (VERBOSE)
-            console.log(`  [NV] [ungoverned: invalid_json] ${trimmed.slice(0, 120)}`);
-        return false;
+        if ((0, fs_1.existsSync)(filePath)) {
+            fileSize = (0, fs_1.statSync)(filePath).size;
+        }
     }
-    const cycle = data.cycle ?? data.step ?? data.round;
-    const artifacts = data.artifacts ?? data.agent_actions ?? [];
-    if (cycle == null) {
-        if (VERBOSE)
-            console.log(`  [NV] [ungoverned: missing_cycle] ${trimmed.slice(0, 120)}`);
-        return false;
+    catch { /* file doesn't exist yet */ }
+    if (VERBOSE)
+        console.log(`  [NV] Watching: ${filePath}`);
+    if (VERBOSE)
+        console.log(`  [NV] Starting from byte offset: ${fileSize}`);
+    // Poll for changes (fs.watch is unreliable across platforms for appends)
+    const interval = setInterval(() => {
+        try {
+            if (!(0, fs_1.existsSync)(filePath))
+                return;
+            const currentSize = (0, fs_1.statSync)(filePath).size;
+            if (currentSize <= fileSize)
+                return;
+            // Read only the new bytes
+            const fd = (0, fs_1.readFileSync)(filePath, "utf-8");
+            const newContent = fd.slice(fileSize);
+            fileSize = currentSize;
+            // Parse each new line
+            const lines = newContent.split("\n").filter((l) => l.trim());
+            for (const line of lines) {
+                try {
+                    const artifact = JSON.parse(line);
+                    governArtifact(artifact, agent);
+                }
+                catch {
+                    if (VERBOSE)
+                        console.log(`  [NV] [skip] non-JSON line in artifact file`);
+                }
+            }
+        }
+        catch (err) {
+            if (VERBOSE)
+                console.log(`  [NV] [watch error] ${err}`);
+        }
+    }, 500); // Check every 500ms
+    return {
+        stop: () => clearInterval(interval),
+    };
+}
+/**
+ * Send a ScienceClaw artifact to governance.
+ */
+async function governArtifact(artifact, agent) {
+    stats.artifactsSeen++;
+    const artifactType = artifact.artifact_type ?? artifact.type ?? "unknown";
+    const skillUsed = artifact.skill_used ?? "unknown";
+    const quality = artifact.result_quality ?? "ok";
+    const producer = artifact.producer_agent ?? agent;
+    const description = artifact.payload?.title
+        ?? artifact.payload?.query
+        ?? `${artifactType} via ${skillUsed}`;
+    const verdict = await evaluate(`publish_${artifactType}`, producer, {
+        description,
+        artifact_type: artifactType,
+        skill_used: skillUsed,
+        result_quality: quality,
+        artifact_id: artifact.artifact_id,
+        investigation_id: artifact.investigation_id,
+        parent_artifacts: artifact.parent_artifact_ids?.length ?? 0,
+        has_needs: Array.isArray(artifact.needs) && artifact.needs.length > 0,
+    });
+    const decision = (verdict.decision ?? verdict.status ?? "ALLOW").toUpperCase();
+    if (decision === "BLOCK" || decision === "PENALIZE") {
+        console.log(`\n  [NV] BLOCKED: ${artifactType} by ${producer}`);
+        console.log(`        Skill:    ${skillUsed}`);
+        console.log(`        Reason:   ${verdict.reason ?? "policy violation"}`);
+        if (verdict.consequence) {
+            console.log(`        Consequence: ${verdict.consequence.description ?? verdict.consequence.type}`);
+        }
     }
-    if (artifacts.length === 0) {
+    else if (decision === "ALLOW") {
         if (VERBOSE)
-            console.log(`  [NV] [ungoverned: no_artifacts] cycle=${cycle}`);
-        return false;
+            console.log(`  [NV] ALLOWED: ${artifactType} by ${producer} (${skillUsed})`);
     }
-    // ── Schema-valid: cycle + artifacts present ──
-    stats.cyclesSeen++;
-    for (const art of artifacts) {
-        stats.artifactsSeen++;
-        const artAgent = art.agent_id ?? art.id ?? art.agent ?? agent;
-        const artType = art.type ?? art.action ?? "publish";
-        const verdict = await evaluate(`publish_${artType}`, artAgent, {
-            description: art.description ?? `${artType} artifact`,
-            artifact_type: artType,
-            confidence: art.confidence,
-            reproduced: art.reproduced ?? false,
-            citations: art.citations ?? 0,
-            cycle,
-        });
-        const decision = (verdict.decision ?? verdict.status ?? "ALLOW").toUpperCase();
-        if ((decision === "BLOCK" || decision === "PENALIZE") && ENFORCE_STREAMING) {
-            console.log(`\n  [NV] GOVERNANCE HALT at cycle ${cycle}`);
-            console.log(`        Artifact: ${art.description ?? artType}`);
-            console.log(`        Agent:    ${artAgent}`);
-            console.log(`        Decision: ${decision}`);
-            console.log(`        Reason:   ${verdict.reason ?? "policy violation"}`);
-            if (decision === "PENALIZE" && verdict.consequence) {
-                console.log(`        Consequence: ${verdict.consequence.type} for ${verdict.consequence.rounds ?? 1} round(s)`);
-            }
-            console.log(`        Terminating ScienceClaw process...\n`);
-            killFn();
-            return true; // halted
-        }
+    else if (decision === "REWARD") {
+        console.log(`  [NV] REWARDED: ${artifactType} by ${producer} — ${verdict.reward?.description ?? ""}`);
     }
-    return false;
 }
 // ============================================
 // MAIN
 // ============================================
 async function main() {
     const parsed = parseArgs(process.argv);
-    const streamingEnabled = ENFORCE_STREAMING && !parsed.noStream;
     console.log(`\n  NeuroVerse ScienceClaw Connector`);
     console.log(`  ${"=".repeat(50)}`);
     console.log(`  Agent:     ${parsed.agent}`);
@@ -252,122 +275,86 @@ async function main() {
     if (parsed.skill)
         console.log(`  Skill:     ${parsed.skill}`);
     console.log(`  Server:    ${NEUROVERSE_URL}`);
-    console.log(`  Streaming: ${streamingEnabled ? "ON — each artifact evaluated" : "OFF — entry gate only"}`);
     console.log(`  ${"=".repeat(50)}\n`);
     // ── Level 1: Entry gate ──
-    console.log(`  [1/4] Evaluating launch governance...`);
+    console.log(`  [1/3] Evaluating launch governance...`);
     const actionType = parsed.skill ? `execute_skill:${parsed.skill}` : "run_investigation";
     const verdict = await evaluate(actionType, parsed.agent, {
         topic: parsed.topic,
         skill: parsed.skill,
-        confidence: parsed.confidence,
         description: `Agent ${parsed.agent}: ${actionType}${parsed.topic ? ` on '${parsed.topic}'` : ""}`,
     });
     const decision = (verdict.decision ?? verdict.status ?? "ALLOW").toUpperCase();
     if (decision === "BLOCK" || decision === "PENALIZE") {
         const label = decision === "BLOCK" ? "BLOCKED" : "PENALIZED";
-        console.log(`  [2/4] ${label} by NeuroVerse governance`);
+        console.log(`        ${label} by NeuroVerse governance`);
         console.log(`        Reason: ${verdict.reason ?? ""}`);
-        if (decision === "PENALIZE" && verdict.consequence) {
-            console.log(`        Consequence: ${verdict.consequence.type} for ${verdict.consequence.rounds ?? 1} round(s)`);
-        }
         console.log(`\n  ScienceClaw execution SKIPPED`);
         console.log(`  ${"=".repeat(50)}\n`);
         process.exit(1);
     }
-    if (decision === "REWARD") {
-        console.log(`  [2/4] REWARDED — proceeding with boosted priority`);
-    }
-    else if (decision === "PAUSE") {
-        console.log(`  [2/4] PAUSED — waiting 3s before proceeding`);
-        await new Promise((r) => setTimeout(r, 3000));
-    }
-    else {
-        console.log(`  [2/4] ALLOWED — proceeding`);
-    }
-    // ── Level 2: Streaming governance ──
+    console.log(`        ${decision} — proceeding\n`);
+    // ── Level 2: Run ScienceClaw + watch artifact file ──
+    const artifactDir = (0, path_1.join)((0, os_1.homedir)(), ".scienceclaw", "artifacts", parsed.agent);
+    const storePath = (0, path_1.join)(artifactDir, "store.jsonl");
+    const globalPath = (0, path_1.join)((0, os_1.homedir)(), ".scienceclaw", "artifacts", "global_index.jsonl");
+    // Watch both the agent store and global index
+    console.log(`  [2/3] Running ScienceClaw + watching artifacts...`);
+    console.log(`        Agent store: ${storePath}`);
+    console.log(`        Global index: ${globalPath}\n`);
+    const storeWatcher = watchArtifactFile(storePath, parsed.agent);
+    const globalWatcher = watchArtifactFile(globalPath, parsed.agent);
     const cmd = SCIENCECLAW_BIN;
     const cmdArgs = parsed.passthroughArgs;
-    console.log(`  [3/4] Executing: ${cmd} ${cmdArgs.join(" ")}`);
-    if (streamingEnabled) {
-        console.log(`        Streaming governance active — each artifact will be evaluated\n`);
-    }
-    else {
-        console.log();
-    }
-    console.log(`  ${"=".repeat(50)}`);
+    console.log(`  Executing: ${cmd} ${cmdArgs.join(" ")}`);
+    console.log(`  ${"=".repeat(50)}\n`);
     const child = (0, child_process_1.spawn)(cmd, cmdArgs, {
         stdio: ["inherit", "pipe", "pipe"],
         shell: process.platform === "win32",
     });
-    let haltedByGovernance = false;
-    const killChild = () => {
-        haltedByGovernance = true;
-        try {
-            child.kill();
-        }
-        catch { /* ignore */ }
-    };
-    // Pipe stderr through
+    // Pass through stdout and stderr so user sees ScienceClaw's normal output
+    child.stdout?.on("data", (chunk) => {
+        process.stdout.write(chunk);
+    });
     child.stderr?.on("data", (chunk) => {
         process.stderr.write(chunk);
     });
-    // Pipe stdout through AND evaluate each line
-    let lineBuffer = "";
-    child.stdout?.on("data", (chunk) => {
-        const text = chunk.toString();
-        process.stdout.write(text); // always pass through
-        if (!streamingEnabled)
-            return;
-        lineBuffer += text;
-        const lines = lineBuffer.split("\n");
-        lineBuffer = lines.pop() ?? ""; // keep incomplete line
-        for (const line of lines) {
-            if (line.trim() && !haltedByGovernance) {
-                // Fire and forget — evaluate in background
-                governLine(line, parsed.agent, killChild);
-            }
-        }
-    });
     child.on("error", (err) => {
+        storeWatcher.stop();
+        globalWatcher.stop();
         if (err.code === "ENOENT") {
             console.log(`\n  ERROR: '${cmd}' not found on PATH`);
-            console.log(`  Install ScienceClaw or set SCIENCECLAW_BIN=/path/to/scienceclaw-post`);
+            console.log(`  Install ScienceClaw: git clone https://github.com/lamm-mit/scienceclaw && cd scienceclaw && pip install -e .`);
+            console.log(`  Or set SCIENCECLAW_BIN=/path/to/scienceclaw-post`);
         }
         else {
             console.log(`\n  ERROR: Failed to start ScienceClaw: ${err.message}`);
         }
         process.exit(127);
     });
-    child.on("close", (code) => {
+    child.on("close", async (code) => {
+        // Wait a moment for final file writes to flush
+        await new Promise((r) => setTimeout(r, 1000));
+        storeWatcher.stop();
+        globalWatcher.stop();
         // ── Level 3: Completion report ──
         console.log(`\n  ${"=".repeat(50)}`);
-        console.log(`  [4/4] Session complete\n`);
-        if (haltedByGovernance) {
-            console.log(`        Status:      HALTED by governance mid-execution`);
-        }
-        else if (code === 0) {
-            console.log(`        Status:      Completed successfully`);
-        }
-        else {
-            console.log(`        Status:      Exited with code ${code}`);
-        }
-        console.log(`        Evaluations: ${stats.evaluated}`);
-        console.log(`        Cycles:      ${stats.cyclesSeen}`);
+        console.log(`  [3/3] Session complete\n`);
+        console.log(`        Status:      ${code === 0 ? "Completed successfully" : `Exited with code ${code}`}`);
         console.log(`        Artifacts:   ${stats.artifactsSeen}`);
+        console.log(`        Evaluations: ${stats.evaluated}`);
         console.log(`        Allowed:     ${stats.allowed}`);
         console.log(`        Blocked:     ${stats.blocked}`);
         console.log(`        Penalized:   ${stats.penalized}`);
         console.log(`        Rewarded:    ${stats.rewarded}`);
-        // Report to governance server (fire and forget)
+        // Report to governance server
         evaluate("investigation_complete", parsed.agent, {
-            description: `Agent ${parsed.agent} investigation ${haltedByGovernance ? "halted by governance" : "completed"}`,
+            description: `Agent ${parsed.agent} investigation completed`,
             exit_code: code,
-            halted_by_governance: haltedByGovernance,
             stats,
         }).catch(() => { });
         console.log(`\n  ${"=".repeat(50)}\n`);
-        process.exit(haltedByGovernance ? 1 : (code ?? 0));
+        process.exit(code ?? 0);
     });
 }
 main().catch((err) => {