@neuroverseos/governance 0.3.1 → 0.3.3

package/dist/cli/run.d.cts

@@ -0,0 +1,20 @@
+/**
+ * neuroverse run — Governed Runtime
+ *
+ * Modes:
+ *   --pipe          Pipe mode: JSON lines in → verdicts out (default if stdin is piped)
+ *   --interactive   Interactive chat session with a model
+ *
+ * Usage:
+ *   # Pipe mode — works with any language/framework
+ *   my_agent | neuroverse run --world ./world/ --plan plan.json
+ *
+ *   # Interactive mode — governed chat session
+ *   neuroverse run --world ./world/ --plan plan.json --provider openai
+ *
+ *   # Quick start — auto-detect world and plan
+ *   neuroverse run
+ */
+declare function main(args: string[]): Promise<void>;
+
+export { main };

package/dist/cli/run.d.ts

@@ -0,0 +1,20 @@
+/**
+ * neuroverse run — Governed Runtime
+ *
+ * Modes:
+ *   --pipe          Pipe mode: JSON lines in → verdicts out (default if stdin is piped)
+ *   --interactive   Interactive chat session with a model
+ *
+ * Usage:
+ *   # Pipe mode — works with any language/framework
+ *   my_agent | neuroverse run --world ./world/ --plan plan.json
+ *
+ *   # Interactive mode — governed chat session
+ *   neuroverse run --world ./world/ --plan plan.json --provider openai
+ *
+ *   # Quick start — auto-detect world and plan
+ *   neuroverse run
+ */
+declare function main(args: string[]): Promise<void>;
+
+export { main };

package/dist/cli/run.js

@@ -0,0 +1,143 @@
+import {
+  describeActiveWorld,
+  resolveWorldPath
+} from "../chunk-AKW5YVCE.js";
+import "../chunk-QWGCMQQD.js";
+
+// src/cli/run.ts
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join } from "path";
+function parseArg(args, flag) {
+  const idx = args.indexOf(flag);
+  return idx >= 0 && idx + 1 < args.length ? args[idx + 1] : void 0;
+}
+function hasFlag(args, flag) {
+  return args.includes(flag);
+}
+function autoDetectPlan() {
+  const nvDir = ".neuroverse/plans";
+  if (!existsSync(nvDir)) return void 0;
+  const entries = readdirSync(nvDir).filter((e) => e.endsWith(".json"));
+  if (entries.length === 1) {
+    try {
+      return JSON.parse(readFileSync(join(nvDir, entries[0]), "utf-8"));
+    } catch {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function loadPlan(path) {
+  return JSON.parse(readFileSync(path, "utf-8"));
+}
+var RUN_USAGE = `
+neuroverse run \u2014 Governed runtime for AI agents.
+
+Modes:
+  --pipe            JSON lines in \u2192 verdicts out (default if stdin is piped)
+  --interactive     Chat session with model + governance
+
+Options:
+  --world <path>    Path to world directory
+  --plan <path>     Path to plan.json
+  --level <level>   Enforcement level (basic|standard|strict)
+  --trace           Include evaluation trace in verdicts
+  --provider <name> Model provider (openai|anthropic|ollama)
+  --model <name>    Model name override
+  --api-key <key>   API key (or set via env var)
+
+Usage:
+  # Pipe mode \u2014 works with any agent
+  my_agent | neuroverse run --world ./world/ --plan plan.json
+
+  # Interactive mode \u2014 governed chat session
+  neuroverse run --interactive --world ./world/ --provider openai
+
+  # Auto-detect world and plan
+  neuroverse run
+`.trim();
+async function main(args) {
+  if (hasFlag(args, "--help") || hasFlag(args, "-h")) {
+    process.stdout.write(RUN_USAGE + "\n");
+    process.exit(0);
+    return;
+  }
+  const worldPath = resolveWorldPath(parseArg(args, "--world"));
+  if (!worldPath) {
+    process.stderr.write(
+      "Error: No world found.\nUse --world <path>, set NEUROVERSE_WORLD, or run `neuroverse world use <name>`\n"
+    );
+    process.exit(1);
+    return;
+  }
+  const explicitWorld = parseArg(args, "--world");
+  const worldInfo = describeActiveWorld(explicitWorld);
+  if (worldInfo) {
+    process.stderr.write(`Using world: ${worldInfo.name}
+`);
+  }
+  const planPath = parseArg(args, "--plan");
+  const plan = planPath ? loadPlan(planPath) : autoDetectPlan();
+  const level = parseArg(args, "--level");
+  const trace = hasFlag(args, "--trace");
+  const isPipeMode = hasFlag(args, "--pipe") || !process.stdin.isTTY;
+  const isInteractive = hasFlag(args, "--interactive");
+  if (isInteractive) {
+    const providerName = parseArg(args, "--provider");
+    if (!providerName) {
+      process.stderr.write(
+        "Error: Interactive mode requires --provider (openai|anthropic|ollama)\n"
+      );
+      process.exit(1);
+      return;
+    }
+    const { resolveProvider, ModelAdapter } = await import("../model-adapter-VXEKB4LS.js");
+    const { runInteractiveMode } = await import("../session-JYOARW54.js");
+    const modelConfig = resolveProvider(providerName, {
+      model: parseArg(args, "--model"),
+      apiKey: parseArg(args, "--api-key")
+    });
+    const model = new ModelAdapter(modelConfig);
+    await runInteractiveMode(
+      {
+        worldPath,
+        plan,
+        level,
+        trace,
+        onVerdict: (verdict, event) => {
+          if (verdict.status !== "ALLOW") {
+            process.stderr.write(
+              `  [${verdict.status}] ${event.intent} \u2014 ${verdict.reason ?? verdict.ruleId ?? "governance rule"}
+`
+            );
+          }
+        },
+        onPlanProgress: (progress) => {
+          process.stderr.write(
+            `  [plan] ${progress.completed}/${progress.total} (${progress.percentage}%)
+`
+          );
+        },
+        onPlanComplete: () => {
+          process.stderr.write(`  [plan] Complete!
+`);
+        }
+      },
+      model
+    );
+  } else if (isPipeMode) {
+    const { runPipeMode } = await import("../session-JYOARW54.js");
+    await runPipeMode({
+      worldPath,
+      plan,
+      level,
+      trace
+    });
+  } else {
+    process.stdout.write(RUN_USAGE + "\n");
+    process.exit(0);
+  }
+}
+export {
+  main
+};

package/dist/configure-ai-6TZ3MCSI.js

@@ -0,0 +1,132 @@
+import {
+  CONFIGURE_AI_EXIT_CODES,
+  createProvider
+} from "./chunk-Q6O7ZLO2.js";
+import {
+  getConfigPath,
+  loadConfig,
+  redactConfig,
+  saveConfig
+} from "./chunk-OT6PXH54.js";
+import "./chunk-QWGCMQQD.js";
+
+// src/cli/configure-ai.ts
+function parseArgs(argv) {
+  let provider;
+  let model;
+  let apiKey;
+  let endpoint;
+  let show = false;
+  let test = false;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--provider" && i + 1 < argv.length) {
+      provider = argv[++i];
+    } else if (arg === "--model" && i + 1 < argv.length) {
+      model = argv[++i];
+    } else if (arg === "--api-key" && i + 1 < argv.length) {
+      apiKey = argv[++i];
+    } else if (arg === "--endpoint" && i + 1 < argv.length) {
+      endpoint = argv[++i];
+    } else if (arg === "--show") {
+      show = true;
+    } else if (arg === "--test") {
+      test = true;
+    }
+  }
+  return { provider, model, apiKey, endpoint, show, test };
+}
+async function main(argv = process.argv.slice(2)) {
+  try {
+    const args = parseArgs(argv);
+    if (args.show) {
+      const config2 = await loadConfig();
+      if (!config2) {
+        process.stdout.write(JSON.stringify({
+          configured: false,
+          configPath: getConfigPath()
+        }, null, 2) + "\n");
+      } else {
+        process.stdout.write(JSON.stringify({
+          configured: true,
+          configPath: getConfigPath(),
+          ...redactConfig(config2)
+        }, null, 2) + "\n");
+      }
+      process.exit(CONFIGURE_AI_EXIT_CODES.SUCCESS);
+      return;
+    }
+    if (args.test) {
+      const config2 = await loadConfig();
+      if (!config2) {
+        process.stderr.write(JSON.stringify({
+          error: "No configuration found. Run: neuroverse configure-ai --provider ... --model ... --api-key ..."
+        }, null, 2) + "\n");
+        process.exit(CONFIGURE_AI_EXIT_CODES.VALIDATION_FAIL);
+        return;
+      }
+      try {
+        const provider = createProvider(config2);
+        await provider.complete("You are a test. Respond with only: OK", "Test connection.");
+        process.stdout.write(JSON.stringify({
+          success: true,
+          message: "Connection test passed",
+          ...redactConfig(config2)
+        }, null, 2) + "\n");
+        process.exit(CONFIGURE_AI_EXIT_CODES.SUCCESS);
+      } catch (e) {
+        process.stderr.write(JSON.stringify({
+          success: false,
+          error: `Connection test failed: ${e instanceof Error ? e.message : String(e)}`
+        }, null, 2) + "\n");
+        process.exit(CONFIGURE_AI_EXIT_CODES.VALIDATION_FAIL);
+      }
+      return;
+    }
+    if (!args.provider && !args.model && !args.apiKey && !args.endpoint) {
+      process.stderr.write(JSON.stringify({
+        error: "Provide at least one of: --provider, --model, --api-key, --endpoint",
+        usage: "neuroverse configure-ai --provider openai --model gpt-4.1-mini --api-key sk-..."
+      }, null, 2) + "\n");
+      process.exit(CONFIGURE_AI_EXIT_CODES.VALIDATION_FAIL);
+      return;
+    }
+    const existing = await loadConfig();
+    const config = {
+      provider: args.provider ?? existing?.provider ?? "openai",
+      model: args.model ?? existing?.model ?? "",
+      apiKey: args.apiKey ?? existing?.apiKey ?? "",
+      endpoint: args.endpoint ?? existing?.endpoint ?? null
+    };
+    if (!config.model) {
+      process.stderr.write(JSON.stringify({
+        error: "Model is required. Use --model <name>"
+      }, null, 2) + "\n");
+      process.exit(CONFIGURE_AI_EXIT_CODES.VALIDATION_FAIL);
+      return;
+    }
+    if (!config.apiKey) {
+      process.stderr.write(JSON.stringify({
+        error: "API key is required. Use --api-key <key>"
+      }, null, 2) + "\n");
+      process.exit(CONFIGURE_AI_EXIT_CODES.VALIDATION_FAIL);
+      return;
+    }
+    await saveConfig(config);
+    process.stdout.write(JSON.stringify({
+      success: true,
+      configPath: getConfigPath(),
+      ...redactConfig(config)
+    }, null, 2) + "\n");
+    process.exit(CONFIGURE_AI_EXIT_CODES.SUCCESS);
+  } catch (e) {
+    process.stderr.write(JSON.stringify({
+      error: "Configuration failed",
+      detail: e instanceof Error ? e.message : String(e)
+    }, null, 2) + "\n");
+    process.exit(CONFIGURE_AI_EXIT_CODES.ERROR);
+  }
+}
+export {
+  main
+};

package/dist/decision-flow-M63D47LO.js

@@ -0,0 +1,61 @@
+import {
+  readAuditLog
+} from "./chunk-A7GKPPU7.js";
+import {
+  generateDecisionFlow,
+  renderDecisionFlow
+} from "./chunk-D2UCV5AK.js";
+import "./chunk-W7LLXRGY.js";
+import "./chunk-QLPTHTVB.js";
+import "./chunk-QWGCMQQD.js";
+
+// src/cli/decision-flow.ts
+async function main(args) {
+  let logPath = ".neuroverse/audit.ndjson";
+  let jsonOutput = false;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--log" && args[i + 1]) {
+      logPath = args[++i];
+    }
+    if (args[i] === "--json") {
+      jsonOutput = true;
+    }
+    if (args[i] === "--help" || args[i] === "-h") {
+      process.stdout.write(`
+neuroverse decision-flow \u2014 Visualize Intent \u2192 Rule \u2192 Outcome
+
+Usage:
+  neuroverse decision-flow [--log <path>] [--json]
+
+Options:
+  --log <path>   Path to audit log (default: .neuroverse/audit.ndjson)
+  --json         Output as JSON instead of text
+
+Shows:
+  - What agents WANTED to do (Intent Pool)
+  - What rules INTERCEPTED (Rule Obstacles)
+  - What actually HAPPENED (Outcome Pool)
+  - Behavioral economy (penalties vs rewards)
+
+Headline metric: "X% of agent intent was redirected by governance"
+`.trim() + "\n");
+      return;
+    }
+  }
+  const events = await readAuditLog(logPath);
+  if (events.length === 0) {
+    process.stderr.write("No audit events found. Run governed actions first.\n");
+    process.stderr.write(`Looking in: ${logPath}
+`);
+    process.exit(1);
+  }
+  const flow = generateDecisionFlow(events);
+  if (jsonOutput) {
+    process.stdout.write(JSON.stringify(flow, null, 2) + "\n");
+  } else {
+    process.stdout.write(renderDecisionFlow(flow) + "\n");
+  }
+}
+export {
+  main
+};