@neuroverseos/governance 0.3.0 → 0.3.1

package/dist/cli/run.d.cts

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1,143 +0,0 @@
-import {
-  describeActiveWorld,
-  resolveWorldPath
-} from "../chunk-AKW5YVCE.js";
-import "../chunk-YZFATT7X.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-BB7G4MFI.js");
-    const { runInteractiveMode } = await import("../session-EKTRSR7C.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-EKTRSR7C.js");
-    await runPipeMode({
-      worldPath,
-      plan,
-      level,
-      trace
-    });
-  } else {
-    process.stdout.write(RUN_USAGE + "\n");
-    process.exit(0);
-  }
-}
-export {
-  main
-};

package/dist/configure-ai-TK67ZWZL.js

@@ -1,132 +0,0 @@
-import {
-  CONFIGURE_AI_EXIT_CODES,
-  createProvider
-} from "./chunk-Q6O7ZLO2.js";
-import {
-  getConfigPath,
-  loadConfig,
-  redactConfig,
-  saveConfig
-} from "./chunk-OT6PXH54.js";
-import "./chunk-YZFATT7X.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/derive-TLIV4OOU.js

@@ -1,152 +0,0 @@
-import {
-  DeriveInputError,
-  DeriveProviderError,
-  deriveWorld
-} from "./chunk-NF5POFCI.js";
-import {
-  DERIVE_EXIT_CODES
-} from "./chunk-Q6O7ZLO2.js";
-import "./chunk-OT6PXH54.js";
-import "./chunk-XPDMYECO.js";
-import "./chunk-7P3S7MAY.js";
-import "./chunk-YZFATT7X.js";
-
-// src/cli/derive.ts
-function parseArgs(argv) {
-  let inputPath = "";
-  let outputPath = "./derived.nv-world.md";
-  let validate = true;
-  let dryRun = false;
-  let bootstrapDir;
-  let provider;
-  let model;
-  let endpoint;
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === "--input" && i + 1 < argv.length) {
-      inputPath = argv[++i];
-    } else if (arg === "--output" && i + 1 < argv.length) {
-      outputPath = argv[++i];
-    } else if (arg === "--validate") {
-      validate = true;
-    } else if (arg === "--no-validate") {
-      validate = false;
-    } else if (arg === "--dry-run") {
-      dryRun = true;
-    } else if (arg === "--bootstrap" && i + 1 < argv.length) {
-      bootstrapDir = argv[++i];
-    } else if (arg === "--provider" && i + 1 < argv.length) {
-      provider = argv[++i];
-    } else if (arg === "--model" && i + 1 < argv.length) {
-      model = argv[++i];
-    } else if (arg === "--endpoint" && i + 1 < argv.length) {
-      endpoint = argv[++i];
-    }
-  }
-  if (!inputPath) throw new DeriveInputError("--input <path> is required");
-  return { inputPath, outputPath, validate, dryRun, bootstrapDir, provider, model, endpoint };
-}
-async function main(argv = process.argv.slice(2)) {
-  try {
-    const args = parseArgs(argv);
-    const { result, exitCode, dryRunOutput } = await deriveWorld({
-      inputPath: args.inputPath,
-      outputPath: args.outputPath,
-      validate: args.validate,
-      dryRun: args.dryRun,
-      providerOverride: args.provider || args.model || args.endpoint ? {
-        provider: args.provider,
-        model: args.model,
-        endpoint: args.endpoint
-      } : void 0
-    });
-    if (dryRunOutput) {
-      process.stdout.write(JSON.stringify({
-        dryRun: true,
-        systemPrompt: dryRunOutput.systemPrompt,
-        userPrompt: dryRunOutput.userPrompt,
-        durationMs: result.durationMs
-      }, null, 2) + "\n");
-      process.exit(DERIVE_EXIT_CODES.SUCCESS);
-      return;
-    }
-    process.stderr.write(`
-Derived world written to: ${result.outputPath}
-`);
-    process.stderr.write(`Derivation Gate: ${result.gate}
-`);
-    if (result.normalization) {
-      const n = result.normalization;
-      const details = [];
-      if (n.invariantIds > 0) details.push(`${n.invariantIds} invariant ID(s) wrapped`);
-      if (n.gateThresholds > 0) details.push(`${n.gateThresholds} gate threshold(s) converted`);
-      if (n.triggerTags > 0) details.push(`${n.triggerTags} trigger(s) tagged with [state]`);
-      process.stderr.write(`
-Normalization: ${n.fixCount} fix(es) applied
-`);
-      for (const d of details) process.stderr.write(`  - ${d}
-`);
-    }
-    if (result.findings.length > 0) {
-      process.stderr.write(`
-`);
-      const errs = result.findings.filter((f) => f.severity === "error");
-      const warns = result.findings.filter((f) => f.severity === "warning");
-      if (errs.length > 0) {
-        process.stderr.write(`Errors (${errs.length}):
-`);
-        for (const f of errs) {
-          process.stderr.write(`  ERROR [${f.section}]: ${f.message}
-`);
-        }
-      }
-      if (warns.length > 0) {
-        process.stderr.write(`Warnings (${warns.length}):
-`);
-        for (const f of warns) {
-          process.stderr.write(`  WARN  [${f.section}]: ${f.message}
-`);
-        }
-      }
-      process.stderr.write(`
-`);
-    }
-    if (result.gate === "SUSPECT" || result.gate === "DERIVATION_REJECTED") {
-      process.stderr.write(`The file has been written. Open ${result.outputPath} to review and fix.
-`);
-    }
-    if (args.bootstrapDir && exitCode === 0) {
-      process.stderr.write(`
-Bootstrapping to ${args.bootstrapDir}...
-`);
-      const { main: bootstrapMain } = await import("./bootstrap-GXVDZNF7.js");
-      await bootstrapMain([
-        "--input",
-        result.outputPath,
-        "--output",
-        args.bootstrapDir,
-        ...args.validate ? ["--validate"] : []
-      ]);
-      return;
-    }
-    process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-    process.exit(exitCode);
-  } catch (e) {
-    if (e instanceof DeriveInputError) {
-      process.stderr.write(JSON.stringify({ error: e.message }, null, 2) + "\n");
-      process.exit(DERIVE_EXIT_CODES.INPUT_ERROR);
-    } else if (e instanceof DeriveProviderError) {
-      process.stderr.write(JSON.stringify({ error: e.message }, null, 2) + "\n");
-      process.exit(DERIVE_EXIT_CODES.PROVIDER_ERROR);
-    } else {
-      process.stderr.write(JSON.stringify({
-        error: "Derive failed",
-        detail: e instanceof Error ? e.message : String(e)
-      }, null, 2) + "\n");
-      process.exit(DERIVE_EXIT_CODES.PROVIDER_ERROR);
-    }
-  }
-}
-export {
-  main
-};

package/dist/doctor-XPDLEYXN.js

@@ -1,171 +0,0 @@
-import {
-  loadConfig
-} from "./chunk-OT6PXH54.js";
-import {
-  __glob
-} from "./chunk-YZFATT7X.js";
-
-// import("../adapters/**/*") in src/cli/doctor.ts
-var globImport_adapters = __glob({
-  "../adapters/autoresearch.ts": () => import("./adapters/autoresearch.js"),
-  "../adapters/express.ts": () => import("./adapters/express.js"),
-  "../adapters/index.ts": () => import("./adapters/index.js"),
-  "../adapters/langchain.ts": () => import("./adapters/langchain.js"),
-  "../adapters/openai.ts": () => import("./adapters/openai.js"),
-  "../adapters/openclaw.ts": () => import("./adapters/openclaw.js")
-});
-
-// src/cli/doctor.ts
-var PACKAGE_VERSION = "0.2.0";
-var MIN_NODE_VERSION = 18;
-async function main(argv) {
-  const json = argv.includes("--json");
-  let worldPath;
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === "--world" && i + 1 < argv.length) {
-      worldPath = argv[++i];
-    }
-  }
-  const checks = [];
-  const nodeVersion = process.version;
-  const major = parseInt(nodeVersion.slice(1), 10);
-  checks.push({
-    label: "Node version",
-    status: major >= MIN_NODE_VERSION ? "pass" : "fail",
-    value: nodeVersion,
-    detail: major < MIN_NODE_VERSION ? `Requires Node >= ${MIN_NODE_VERSION}` : void 0
-  });
-  checks.push({
-    label: "NeuroVerse version",
-    status: "pass",
-    value: PACKAGE_VERSION
-  });
-  try {
-    const config = await loadConfig();
-    if (config?.provider && config?.apiKey) {
-      checks.push({
-        label: "AI provider configured",
-        status: "pass",
-        value: `${config.provider}${config.model ? ` (${config.model})` : ""}`
-      });
-    } else {
-      checks.push({
-        label: "AI provider configured",
-        status: "warn",
-        value: "not configured",
-        detail: "Run: neuroverse configure-ai --provider openai --model gpt-4.1-mini --api-key <key>"
-      });
-    }
-  } catch {
-    checks.push({
-      label: "AI provider configured",
-      status: "warn",
-      value: "not configured",
-      detail: "Run: neuroverse configure-ai"
-    });
-  }
-  if (worldPath) {
-    try {
-      const { existsSync } = await import("fs");
-      const { join } = await import("path");
-      const hasWorld = existsSync(join(worldPath, "world.json"));
-      checks.push({
-        label: "World file detected",
-        status: hasWorld ? "pass" : "fail",
-        value: hasWorld ? worldPath : "not found",
-        detail: hasWorld ? void 0 : `No world.json found in ${worldPath}`
-      });
-    } catch {
-      checks.push({
-        label: "World file detected",
-        status: "fail",
-        value: "error reading path"
-      });
-    }
-  } else {
-    const { existsSync } = await import("fs");
-    const { join } = await import("path");
-    const candidates = ["./world", "./.neuroverse", "./worlds"];
-    let found;
-    for (const dir of candidates) {
-      if (existsSync(join(dir, "world.json"))) {
-        found = dir;
-        break;
-      }
-    }
-    checks.push({
-      label: "World file detected",
-      status: found ? "pass" : "warn",
-      value: found ?? "none found",
-      detail: found ? void 0 : "Build a world: neuroverse build <input.md>"
-    });
-  }
-  try {
-    const { evaluateGuard } = await import("./guard-engine-JLTUARGU.js");
-    checks.push({
-      label: "Guard engine",
-      status: typeof evaluateGuard === "function" ? "pass" : "fail",
-      value: "loaded"
-    });
-  } catch {
-    checks.push({ label: "Guard engine", status: "fail", value: "failed to load" });
-  }
-  try {
-    const { validateWorld } = await import("./validate-engine-UIABSIHD.js");
-    checks.push({
-      label: "Validation engine",
-      status: typeof validateWorld === "function" ? "pass" : "fail",
-      value: "loaded"
-    });
-  } catch {
-    checks.push({ label: "Validation engine", status: "fail", value: "failed to load" });
-  }
-  const adapterNames = ["openai", "express", "langchain", "openclaw"];
-  const loadedAdapters = [];
-  for (const name of adapterNames) {
-    try {
-      await globImport_adapters(`../adapters/${name}`);
-      loadedAdapters.push(name);
-    } catch {
-    }
-  }
-  checks.push({
-    label: "Adapters",
-    status: loadedAdapters.length > 0 ? "pass" : "warn",
-    value: loadedAdapters.length > 0 ? loadedAdapters.join(", ") : "none"
-  });
-  if (json) {
-    const hasFailure2 = checks.some((c) => c.status === "fail");
-    process.stdout.write(JSON.stringify({
-      status: hasFailure2 ? "fail" : "pass",
-      checks
-    }, null, 2) + "\n");
-    process.exit(hasFailure2 ? 1 : 0);
-    return;
-  }
-  process.stderr.write("\nNeuroVerse Environment Check\n");
-  process.stderr.write("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
-  const maxLabel = Math.max(...checks.map((c) => c.label.length));
-  for (const check of checks) {
-    const icon = check.status === "pass" ? "ok" : check.status === "warn" ? "!!" : "FAIL";
-    const pad = " ".repeat(maxLabel - check.label.length);
-    process.stderr.write(`  ${check.label}${pad}  ${icon}  ${check.value}
-`);
-    if (check.detail) {
-      process.stderr.write(`  ${" ".repeat(maxLabel)}      ${check.detail}
-`);
-    }
-  }
-  const hasFailure = checks.some((c) => c.status === "fail");
-  process.stderr.write("\n");
-  if (hasFailure) {
-    process.stderr.write("Some checks failed. Fix the issues above and re-run.\n");
-  } else {
-    process.stderr.write("System ready.\n");
-  }
-  process.stderr.write("\n");
-  process.exit(hasFailure ? 1 : 0);
-}
-export {
-  main
-};