@neuroverseos/governance 0.3.1 → 0.3.3

package/dist/cli/neuroverse.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/neuroverse.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/neuroverse.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+
+// src/cli/neuroverse.ts
+var USAGE = `
+neuroverse \u2014 Turn ideas into worlds.
+
+Commands:
+  add            Add a guard, rule, or invariant to a world
+  build          Build a world from markdown (derive + compile in one step)
+  explain        Human-readable summary of a compiled world
+  simulate       Step-by-step state evolution
+  improve        Actionable suggestions for strengthening a world
+  init           Scaffold a new .nv-world.md template
+  init-world     Generate a governed world from a template (e.g., autoresearch)
+  infer-world    Scan a repo and infer a governance world from its structure
+  validate       Static analysis on world files
+  guard          Runtime governance evaluation (stdin \u2192 stdout)
+  test           Run guard simulation suite against a world
+  redteam        Adversarial containment testing (agent escape detection)
+  demo           Interactive governance demo (flow viz + simulation)
+  doctor         Environment sanity check
+  playground     Interactive web demo (opens in browser)
+  plan           Plan enforcement (compile, check, status, advance, derive)
+  run            Governed runtime (pipe mode or interactive chat)
+  mcp            MCP governance server (for Claude, Cursor, etc.)
+  worlds         List available worlds (alias for world list)
+  trace          Runtime action audit log
+  impact         Counterfactual governance impact report
+  decision-flow  Intent \u2192 Rule \u2192 Outcome visualization (behavioral governance)
+  equity-penalties  Fortune 500 equity PENALIZE/REWARD simulation
+  world          World management (status, diff, snapshot, rollback)
+  derive         AI-assisted synthesis of .nv-world.md from markdown
+  bootstrap      Compile .nv-world.md \u2192 world JSON files
+  configure-ai   Configure AI provider credentials
+
+Usage:
+  neuroverse add "Block dairy orders" --world <dir>
+  neuroverse add guard --world <dir> --label "Block dairy" --pattern "*dairy*"
+  neuroverse add rule --world <dir> --label "Cost overrun" --trigger "cost > 100" --effect "viability *= 0.5"
+  neuroverse add invariant --world <dir> --label "Budget must never exceed 1000"
+  neuroverse build <input.md> [--output <dir>]
+  neuroverse explain <world-path-or-id> [--json]
+  neuroverse simulate <world-path-or-id> [--steps N] [--set key=value] [--profile name]
+  neuroverse improve <world-path-or-id> [--json]
+  neuroverse init [--name "World Name"] [--output path]
+  neuroverse init-world autoresearch [--context "topic"] [--dataset "name"] [--goal "goal"]
+  neuroverse infer-world ./repo [--output path] [--json] [--dry-run]
+  neuroverse validate --world <dir> [--format full|summary|findings]
+  neuroverse guard --world <dir> [--trace] [--level basic|standard|strict]
+  neuroverse test --world <dir> [--fuzz] [--count N]
+  neuroverse redteam --world <dir> [--level basic|standard|strict]
+  neuroverse demo [--world social-media] [--port 3456] [--no-browser]
+  neuroverse doctor [--world <dir>] [--json]
+  neuroverse playground --world <dir> [--port 4242]
+  neuroverse trace [--log <path>] [--summary] [--filter BLOCK] [--last 20]
+  neuroverse impact [--log <path>] [--json]
+  neuroverse world status <path>
+  neuroverse world diff <path1> <path2>
+  neuroverse world snapshot <path>
+  neuroverse world rollback <path>
+  neuroverse derive --input <path> [--output <path>] [--dry-run]
+  neuroverse bootstrap --input <.md> --output <dir> [--validate]
+  neuroverse decision-flow [--log <path>] [--json]
+  neuroverse equity-penalties --world <dir> [--agents N] [--rounds N] [--json]
+  neuroverse configure-ai --provider <name> --model <name> --api-key <key>
+
+Examples:
+  neuroverse build horror-notes.md
+  neuroverse explain inherited_silence
+  neuroverse simulate inherited_silence --steps 5
+  neuroverse improve inherited_silence
+  neuroverse build ./docs/ --output ./my-world/
+  neuroverse init --name "Customer Service Governance"
+  neuroverse validate --world ./world/ --format summary
+  echo '{"intent":"delete user data"}' | neuroverse guard --world ./world/ --trace
+  neuroverse plan compile plan.md --output plan.json
+  echo '{"intent":"write blog"}' | neuroverse plan check --plan plan.json
+  neuroverse plan status --plan plan.json
+  neuroverse plan advance write_blog_post --plan plan.json
+  neuroverse plan derive plan.md --output ./derived-world/
+  neuroverse run --pipe --world ./world/ --plan plan.json
+  neuroverse run --interactive --world ./world/ --provider openai
+  neuroverse mcp --world ./world/ --plan plan.json
+  neuroverse test --world ./world/ --fuzz --count 50
+  neuroverse redteam --world ./world/ --level strict
+  neuroverse doctor
+  neuroverse playground --world ./world/
+`.trim();
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const subArgs = args.slice(1);
+  switch (command) {
+    case "add": {
+      const { main: addMain } = await import("../add-ROOZLU62.js");
+      return addMain(subArgs);
+    }
+    case "build": {
+      const { main: buildMain } = await import("../build-QKOBBC23.js");
+      return buildMain(subArgs);
+    }
+    case "explain": {
+      const { main: explainMain } = await import("../explain-RHBU2GBR.js");
+      return explainMain(subArgs);
+    }
+    case "simulate": {
+      const { main: simulateMain } = await import("../simulate-LJXYBC6M.js");
+      return simulateMain(subArgs);
+    }
+    case "improve": {
+      const { main: improveMain } = await import("../improve-TQP4ECSY.js");
+      return improveMain(subArgs);
+    }
+    case "init": {
+      const { main: initMain } = await import("../init-FYPV4SST.js");
+      return initMain(subArgs);
+    }
+    case "init-world": {
+      const { main: initWorldMain } = await import("../init-world-TI7ARHBT.js");
+      return initWorldMain(subArgs);
+    }
+    case "infer-world": {
+      const { main: inferWorldMain } = await import("../infer-world-IFXCACJ5.js");
+      return inferWorldMain(subArgs);
+    }
+    case "bootstrap": {
+      const { main: bootstrapMain } = await import("../bootstrap-CQRZVOXK.js");
+      return bootstrapMain(subArgs);
+    }
+    case "validate": {
+      const { main: validateMain } = await import("../validate-RALX7CZS.js");
+      return validateMain(subArgs);
+    }
+    case "guard": {
+      const { main: guardMain } = await import("../guard-AJCCGZMF.js");
+      return guardMain(subArgs);
+    }
+    case "test": {
+      const { main: testMain } = await import("../test-BOOR4A5F.js");
+      return testMain(subArgs);
+    }
+    case "redteam": {
+      const { main: redteamMain } = await import("../redteam-MZPZD3EF.js");
+      return redteamMain(subArgs);
+    }
+    case "demo": {
+      const { main: demoMain } = await import("../demo-G43RLCPK.js");
+      return demoMain(subArgs);
+    }
+    case "doctor": {
+      const { main: doctorMain } = await import("../doctor-6BC6X2VO.js");
+      return doctorMain(subArgs);
+    }
+    case "playground": {
+      const { main: playgroundMain } = await import("../playground-VZBNPPBO.js");
+      return playgroundMain(subArgs);
+    }
+    case "plan": {
+      const { main: planMain } = await import("./plan.js");
+      return planMain(subArgs);
+    }
+    case "run": {
+      const { main: runMain } = await import("./run.js");
+      return runMain(subArgs);
+    }
+    case "mcp": {
+      const { startMcpServer } = await import("../mcp-server-5Y3ZM7TV.js");
+      return startMcpServer(subArgs);
+    }
+    case "worlds": {
+      const { main: worldMain } = await import("../world-BIP4GZBZ.js");
+      return worldMain(["list", ...subArgs]);
+    }
+    case "trace": {
+      const { main: traceMain } = await import("../trace-PKV4KX56.js");
+      return traceMain(subArgs);
+    }
+    case "impact": {
+      const { main: impactMain } = await import("../impact-3XVDSCBU.js");
+      return impactMain(subArgs);
+    }
+    case "behavioral": {
+      const { main: behavioralMain } = await import("../behavioral-MJO34S6Q.js");
+      return behavioralMain(subArgs);
+    }
+    case "world": {
+      const { main: worldMain } = await import("../world-BIP4GZBZ.js");
+      return worldMain(subArgs);
+    }
+    case "derive": {
+      const { main: deriveMain } = await import("../derive-FJZVIPUZ.js");
+      return deriveMain(subArgs);
+    }
+    case "decision-flow": {
+      const { main: decisionFlowMain } = await import("../decision-flow-M63D47LO.js");
+      return decisionFlowMain(subArgs);
+    }
+    case "equity-penalties": {
+      const { main: equityPenaltiesMain } = await import("../equity-penalties-SG5IZQ7I.js");
+      return equityPenaltiesMain(subArgs);
+    }
+    case "configure-ai": {
+      const { main: configureAiMain } = await import("../configure-ai-6TZ3MCSI.js");
+      return configureAiMain(subArgs);
+    }
+    case "--help":
+    case "-h":
+    case "help":
+    case void 0: {
+      process.stdout.write(USAGE + "\n");
+      process.exit(0);
+      break;
+    }
+    default: {
+      process.stderr.write(`Unknown command: "${command}"
+
+`);
+      process.stdout.write(USAGE + "\n");
+      process.exit(1);
+    }
+  }
+}
+main().catch((e) => {
+  process.stderr.write(`Fatal: ${e}
+`);
+  process.exit(3);
+});