@neuroverseos/governance 0.6.0 → 0.7.0

package/dist/cli/radiant.d.cts

@@ -0,0 +1,25 @@
+/**
+ * CLI: neuroverse radiant <subcommand>
+ *
+ * Radiant — behavioral intelligence for collaboration systems.
+ * Subcommand family for the Radiant module of @neuroverseos/governance.
+ *
+ * Stage A (voice layer):
+ *   neuroverse radiant think --lens <id> --worlds <dir> --query <query>
+ *
+ * Stage B (behavioral analysis, future):
+ *   neuroverse radiant emergent <scope> --lens <id> --worlds <dir>
+ *   neuroverse radiant decision <scope> <ref> --lens <id> --worlds <dir>
+ *   neuroverse radiant signals <scope> --worlds <dir>
+ *   neuroverse radiant drift <scope>
+ *   neuroverse radiant evolve <scope>
+ *   neuroverse radiant lenses list|describe <id>
+ *
+ * Environment:
+ *   ANTHROPIC_API_KEY — required for commands that call the AI
+ *   RADIANT_WORLDS    — default worlds directory (overridden by --worlds)
+ *   RADIANT_LENS      — default lens id (overridden by --lens)
+ */
+declare function main(argv: string[]): Promise<void>;
+
+export { main };

package/dist/cli/radiant.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI: neuroverse radiant <subcommand>
+ *
+ * Radiant — behavioral intelligence for collaboration systems.
+ * Subcommand family for the Radiant module of @neuroverseos/governance.
+ *
+ * Stage A (voice layer):
+ *   neuroverse radiant think --lens <id> --worlds <dir> --query <query>
+ *
+ * Stage B (behavioral analysis, future):
+ *   neuroverse radiant emergent <scope> --lens <id> --worlds <dir>
+ *   neuroverse radiant decision <scope> <ref> --lens <id> --worlds <dir>
+ *   neuroverse radiant signals <scope> --worlds <dir>
+ *   neuroverse radiant drift <scope>
+ *   neuroverse radiant evolve <scope>
+ *   neuroverse radiant lenses list|describe <id>
+ *
+ * Environment:
+ *   ANTHROPIC_API_KEY — required for commands that call the AI
+ *   RADIANT_WORLDS    — default worlds directory (overridden by --worlds)
+ *   RADIANT_LENS      — default lens id (overridden by --lens)
+ */
+declare function main(argv: string[]): Promise<void>;
+
+export { main };

package/dist/cli/radiant.js

@@ -0,0 +1,429 @@
+import {
+  createAnthropicAI,
+  emergent,
+  parseRepoScope,
+  readExocortex,
+  summarizeExocortex,
+  think
+} from "../chunk-T6EQ7ZBG.js";
+import {
+  listLenses
+} from "../chunk-VGFDMPVB.js";
+import "../chunk-I4RTIMLX.js";
+import "../chunk-ZAF6JH23.js";
+import "../chunk-QLPTHTVB.js";
+import "../chunk-QWGCMQQD.js";
+
+// src/cli/radiant.ts
+import { readFileSync, readdirSync, statSync, existsSync } from "fs";
+import { resolve, join, extname } from "path";
+var RED = "\x1B[31m";
+var DIM = "\x1B[2m";
+var BOLD = "\x1B[1m";
+var YELLOW = "\x1B[33m";
+var RESET = "\x1B[0m";
+var USAGE = `
+${BOLD}neuroverse radiant${RESET} \u2014 behavioral intelligence for collaboration systems
+
+${BOLD}Stage A (voice layer):${RESET}
+  think          Send a query through the worldmodel + lens \u2192 AI-framed response
+
+${BOLD}Stage B (behavioral analysis, coming soon):${RESET}
+  emergent       Pattern read on recent activity
+  decision       Evaluate a specific artifact against the worldmodel
+  signals        Extract signal matrix (debug)
+  lenses         List or describe available rendering lenses
+
+${BOLD}Usage:${RESET}
+  neuroverse radiant think --lens auki-builder --worlds ./worlds/ --query "What is our biggest risk?"
+  neuroverse radiant think --lens auki-builder --worlds ./worlds/ < prompt.txt
+  neuroverse radiant emergent aukiverse/posemesh --lens auki-builder --worlds ./worlds/
+  neuroverse radiant emergent aukiverse/posemesh --lens auki-builder --worlds ./worlds/ --exocortex ~/exocortex/
+  neuroverse radiant lenses list
+  neuroverse radiant lenses describe auki-builder
+
+${BOLD}Environment:${RESET}
+  ANTHROPIC_API_KEY    Required for AI commands (think, emergent, decision)
+  RADIANT_WORLDS       Default worlds directory (overridden by --worlds)
+  RADIANT_LENS         Default lens id (overridden by --lens)
+  RADIANT_MODEL        AI model override (default: claude-sonnet-4-20250514)
+  RADIANT_EXOCORTEX    Default exocortex directory (overridden by --exocortex)
+`.trim();
+function parseArgs(argv) {
+  const result = {
+    subcommand: void 0,
+    lens: void 0,
+    worlds: void 0,
+    query: void 0,
+    model: void 0,
+    exocortex: void 0,
+    json: false,
+    help: false,
+    rest: []
+  };
+  let i = 0;
+  if (argv.length > 0 && !argv[0].startsWith("-")) {
+    result.subcommand = argv[0];
+    i = 1;
+  }
+  while (i < argv.length) {
+    const arg = argv[i];
+    switch (arg) {
+      case "--lens":
+        result.lens = argv[++i];
+        break;
+      case "--worlds":
+        result.worlds = argv[++i];
+        break;
+      case "--query":
+        result.query = argv[++i];
+        break;
+      case "--model":
+        result.model = argv[++i];
+        break;
+      case "--exocortex":
+        result.exocortex = argv[++i];
+        break;
+      case "--json":
+        result.json = true;
+        break;
+      case "--help":
+      case "-h":
+        result.help = true;
+        break;
+      default:
+        result.rest.push(arg);
+        break;
+    }
+    i++;
+  }
+  return result;
+}
+function loadWorldmodelContent(worldsPath) {
+  const resolved = resolve(worldsPath);
+  if (!existsSync(resolved)) {
+    throw new Error(`Worlds path not found: ${resolved}`);
+  }
+  const stat = statSync(resolved);
+  if (stat.isFile()) {
+    return readFileSync(resolved, "utf-8");
+  }
+  if (stat.isDirectory()) {
+    const files = readdirSync(resolved).filter(
+      (f) => extname(f) === ".md" && (f.endsWith(".worldmodel.md") || f.endsWith(".nv-world.md"))
+    ).sort();
+    if (files.length === 0) {
+      throw new Error(
+        `No .worldmodel.md or .nv-world.md files found in ${resolved}`
+      );
+    }
+    return files.map((f) => {
+      const content = readFileSync(join(resolved, f), "utf-8");
+      return `<!-- worldmodel: ${f} -->
+${content}`;
+    }).join("\n\n---\n\n");
+  }
+  throw new Error(`Worlds path is neither a file nor a directory: ${resolved}`);
+}
+async function cmdThink(args) {
+  const lensId = args.lens ?? process.env.RADIANT_LENS;
+  if (!lensId) {
+    process.stderr.write(
+      `${RED}Error:${RESET} --lens <id> or RADIANT_LENS required.
+${DIM}Available lenses: ${listLenses().join(", ")}${RESET}
+`
+    );
+    process.exit(1);
+  }
+  const worldsPath = args.worlds ?? process.env.RADIANT_WORLDS;
+  if (!worldsPath) {
+    process.stderr.write(
+      `${RED}Error:${RESET} --worlds <dir> or RADIANT_WORLDS required.
+`
+    );
+    process.exit(1);
+  }
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) {
+    process.stderr.write(
+      `${RED}Error:${RESET} ANTHROPIC_API_KEY environment variable not set.
+${DIM}Set it to your Anthropic API key to use Radiant's AI features.${RESET}
+`
+    );
+    process.exit(1);
+  }
+  let query = args.query;
+  if (!query && args.rest.length > 0) {
+    query = args.rest.join(" ");
+  }
+  if (!query && !process.stdin.isTTY) {
+    query = readFileSync(0, "utf-8").trim();
+  }
+  if (!query) {
+    process.stderr.write(
+      `${RED}Error:${RESET} No query provided.
+${DIM}Use --query "...", pass as trailing args, or pipe via stdin.${RESET}
+`
+    );
+    process.exit(1);
+  }
+  const worldmodelContent = loadWorldmodelContent(worldsPath);
+  const model = args.model ?? process.env.RADIANT_MODEL;
+  const ai = createAnthropicAI(apiKey, model || void 0);
+  process.stderr.write(
+    `${DIM}Worlds: ${worldsPath}${RESET}
+${DIM}Lens:   ${lensId}${RESET}
+${DIM}Model:  ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET}
+
+`
+  );
+  const result = await think({
+    worldmodelContent,
+    lensId,
+    query,
+    ai
+  });
+  if (!result.voiceClean) {
+    process.stderr.write(
+      `${YELLOW}Voice violations detected (${result.voiceViolations.length}):${RESET}
+`
+    );
+    for (const v of result.voiceViolations) {
+      process.stderr.write(
+        `  ${YELLOW}\u26A0${RESET}  "${v.phrase}" at offset ${v.offset}
+`
+      );
+    }
+    process.stderr.write("\n");
+  }
+  if (args.json) {
+    process.stdout.write(
+      JSON.stringify(
+        {
+          response: result.response,
+          lens: result.lens,
+          voiceClean: result.voiceClean,
+          voiceViolations: result.voiceViolations
+        },
+        null,
+        2
+      ) + "\n"
+    );
+  } else {
+    process.stdout.write(result.response + "\n");
+  }
+  if (!result.voiceClean) {
+    process.exit(2);
+  }
+}
+async function cmdEmergent(args) {
+  const scopeStr = args.rest[0];
+  if (!scopeStr) {
+    process.stderr.write(
+      `${RED}Error:${RESET} Scope required. Usage: neuroverse radiant emergent <owner/repo>
+`
+    );
+    process.exit(1);
+  }
+  const scope = parseRepoScope(scopeStr);
+  const lensId = args.lens ?? process.env.RADIANT_LENS;
+  if (!lensId) {
+    process.stderr.write(
+      `${RED}Error:${RESET} --lens <id> or RADIANT_LENS required.
+${DIM}Available lenses: ${listLenses().join(", ")}${RESET}
+`
+    );
+    process.exit(1);
+  }
+  const worldsPath = args.worlds ?? process.env.RADIANT_WORLDS;
+  if (!worldsPath) {
+    process.stderr.write(
+      `${RED}Error:${RESET} --worlds <dir> or RADIANT_WORLDS required.
+`
+    );
+    process.exit(1);
+  }
+  const anthropicKey = process.env.ANTHROPIC_API_KEY;
+  if (!anthropicKey) {
+    process.stderr.write(
+      `${RED}Error:${RESET} ANTHROPIC_API_KEY environment variable not set.
+`
+    );
+    process.exit(1);
+  }
+  const githubToken = process.env.GITHUB_TOKEN;
+  if (!githubToken) {
+    process.stderr.write(
+      `${RED}Error:${RESET} GITHUB_TOKEN environment variable not set.
+${DIM}Set it to a GitHub PAT with repo read access.${RESET}
+`
+    );
+    process.exit(1);
+  }
+  const worldmodelContent = loadWorldmodelContent(worldsPath);
+  const model = args.model ?? process.env.RADIANT_MODEL;
+  const ai = createAnthropicAI(anthropicKey, model || void 0);
+  const exocortexPath = args.exocortex ?? process.env.RADIANT_EXOCORTEX;
+  let exocortexStatus = "not loaded";
+  if (exocortexPath) {
+    const ctx = readExocortex(exocortexPath);
+    exocortexStatus = summarizeExocortex(ctx);
+  }
+  process.stderr.write(
+    `${DIM}Scope:      ${scope.owner}/${scope.repo}${RESET}
+${DIM}Lens:       ${lensId}${RESET}
+${DIM}Model:      ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET}
+${DIM}ExoCortex:  ${exocortexStatus}${RESET}
+${DIM}Fetching activity...${RESET}
+
+`
+  );
+  const result = await emergent({
+    scope,
+    githubToken,
+    worldmodelContent,
+    lensId,
+    ai,
+    windowDays: 14,
+    exocortexPath: exocortexPath || void 0
+  });
+  if (!result.voiceClean) {
+    process.stderr.write(
+      `${YELLOW}Voice violations (${result.voiceViolations.length}):${RESET}
+`
+    );
+    for (const v of result.voiceViolations) {
+      process.stderr.write(
+        `  ${YELLOW}\u26A0${RESET}  "${v.phrase}" at offset ${v.offset}
+`
+      );
+    }
+    process.stderr.write("\n");
+  }
+  if (args.json) {
+    process.stdout.write(
+      JSON.stringify(
+        {
+          text: result.text,
+          frontmatter: result.frontmatter,
+          scores: result.scores,
+          eventCount: result.eventCount,
+          voiceClean: result.voiceClean
+        },
+        null,
+        2
+      ) + "\n"
+    );
+  } else {
+    process.stdout.write(result.text + "\n");
+  }
+}
+async function cmdLenses(args) {
+  const subSub = args.rest[0];
+  if (!subSub || subSub === "list") {
+    const ids = listLenses();
+    if (ids.length === 0) {
+      process.stdout.write("No lenses registered.\n");
+    } else {
+      for (const id of ids) {
+        process.stdout.write(`${id}
+`);
+      }
+    }
+    return;
+  }
+  if (subSub === "describe") {
+    const { getLens } = await import("../lenses-K5FVSALR.js");
+    const id = args.rest[1];
+    if (!id) {
+      process.stderr.write(`${RED}Error:${RESET} Lens id required.
+`);
+      process.exit(1);
+    }
+    const lens = getLens(id);
+    if (!lens) {
+      process.stderr.write(
+        `${RED}Error:${RESET} Lens "${id}" not found.
+${DIM}Available: ${listLenses().join(", ")}${RESET}
+`
+      );
+      process.exit(1);
+    }
+    process.stdout.write(`${BOLD}${lens.name}${RESET}
+`);
+    process.stdout.write(`${lens.description}
+
+`);
+    process.stdout.write(
+      `${BOLD}Domains:${RESET} ${lens.primary_frame.domains.join(", ")}
+`
+    );
+    process.stdout.write(
+      `${BOLD}Overlaps:${RESET} ${lens.primary_frame.overlaps.map((o) => o.emergent_state).join(", ")}
+`
+    );
+    process.stdout.write(
+      `${BOLD}Center:${RESET} ${lens.primary_frame.center_identity}
+`
+    );
+    process.stdout.write(
+      `${BOLD}Forbidden phrases:${RESET} ${lens.forbidden_phrases.length}
+`
+    );
+    process.stdout.write(
+      `${BOLD}Vocabulary terms:${RESET} ${lens.vocabulary.proper_nouns.length} proper nouns, ${Object.keys(lens.vocabulary.preferred).length} substitutions
+`
+    );
+    process.stdout.write(
+      `${BOLD}Exemplars:${RESET} ${lens.exemplar_refs.length}
+`
+    );
+    return;
+  }
+  process.stderr.write(
+    `${RED}Error:${RESET} Unknown lenses subcommand "${subSub}".
+${DIM}Use: lenses list | lenses describe <id>${RESET}
+`
+  );
+  process.exit(1);
+}
+async function main(argv) {
+  const args = parseArgs(argv);
+  if (args.help || !args.subcommand) {
+    process.stdout.write(USAGE + "\n");
+    return;
+  }
+  switch (args.subcommand) {
+    case "think":
+      return cmdThink(args);
+    case "lenses":
+      return cmdLenses(args);
+    case "emergent":
+      return cmdEmergent(args);
+    case "mcp": {
+      const { startRadiantMcp } = await import("../server-BXMC5NOE.js");
+      return startRadiantMcp(argv);
+    }
+    case "decision":
+    case "signals":
+    case "drift":
+    case "evolve":
+      process.stderr.write(
+        `${DIM}neuroverse radiant ${args.subcommand} is not yet implemented.${RESET}
+`
+      );
+      process.exit(1);
+      break;
+    default:
+      process.stderr.write(
+        `${RED}Unknown radiant subcommand: "${args.subcommand}"${RESET}
+
+`
+      );
+      process.stdout.write(USAGE + "\n");
+      process.exit(1);
+  }
+}
+export {
+  main
+};

package/dist/{derive-42IJW7JI.js → derive-7Y7YWVLU.js}

@@ -2,12 +2,12 @@ import {
   DeriveInputError,
   DeriveProviderError,
   deriveWorld
-} from "./chunk-735Z3HA4.js";
+} from "./chunk-FHXXD2TI.js";
 import {
   DERIVE_EXIT_CODES
 } from "./chunk-FMSTRBBS.js";
-import "./chunk-OT6PXH54.js";
 import "./chunk-INWQHLPS.js";
+import "./chunk-OT6PXH54.js";
 import "./chunk-7P3S7MAY.js";
 import "./chunk-YPCVY4GS.js";
 import "./chunk-3NZMMSOW.js";

package/dist/index.js

@@ -1,3 +1,17 @@
+import {
+  generateImpactReport,
+  generateImpactReportFromFile,
+  renderImpactReport
+} from "./chunk-OQU65525.js";
+import {
+  VALIDATE_EXIT_CODES
+} from "./chunk-I3RRAYK2.js";
+import {
+  GUARD_EXIT_CODES,
+  classifyIntentWithAI,
+  evaluateGuardWithAI,
+  extractContentFields
+} from "./chunk-6CV4XG3J.js";
 import {
   actionToGuardEvent,
   createGovernor,
@@ -15,10 +29,20 @@ import {
   generateAdaptationNarrative
 } from "./chunk-CNSO6XW5.js";
 import {
-  generateImpactReport,
-  generateImpactReportFromFile,
-  renderImpactReport
-} from "./chunk-OQU65525.js";
+  deriveWorld,
+  extractWorldMarkdown,
+  normalizeWorldMarkdown
+} from "./chunk-FHXXD2TI.js";
+import {
+  CONFIGURE_AI_EXIT_CODES,
+  DERIVE_EXIT_CODES
+} from "./chunk-FMSTRBBS.js";
+import "./chunk-INWQHLPS.js";
+import "./chunk-OT6PXH54.js";
+import {
+  explainWorld,
+  renderExplainText
+} from "./chunk-ZJTDUCC2.js";
 import {
   improveWorld,
   renderImproveText
@@ -26,15 +50,6 @@ import {
 import {
   BOOTSTRAP_EXIT_CODES
 } from "./chunk-4NGDRRQH.js";
-import {
-  VALIDATE_EXIT_CODES
-} from "./chunk-I3RRAYK2.js";
-import {
-  GUARD_EXIT_CODES,
-  classifyIntentWithAI,
-  evaluateGuardWithAI,
-  extractContentFields
-} from "./chunk-6CV4XG3J.js";
 import {
   SessionManager,
   runInteractiveMode,
@@ -63,24 +78,9 @@ import {
   classifyIntent,
   parseGuardDescription
 } from "./chunk-FS2UUJJO.js";
-import {
-  deriveWorld,
-  extractWorldMarkdown,
-  normalizeWorldMarkdown
-} from "./chunk-735Z3HA4.js";
-import {
-  CONFIGURE_AI_EXIT_CODES,
-  DERIVE_EXIT_CODES
-} from "./chunk-FMSTRBBS.js";
-import "./chunk-OT6PXH54.js";
-import "./chunk-INWQHLPS.js";
 import {
   validateWorld
 } from "./chunk-7P3S7MAY.js";
-import {
-  explainWorld,
-  renderExplainText
-} from "./chunk-ZJTDUCC2.js";
 import {
   emitWorldDefinition
 } from "./chunk-YPCVY4GS.js";

package/dist/lenses-K5FVSALR.js

@@ -0,0 +1,13 @@
+import {
+  LENSES,
+  aukiBuilderLens,
+  getLens,
+  listLenses
+} from "./chunk-VGFDMPVB.js";
+import "./chunk-QWGCMQQD.js";
+export {
+  LENSES,
+  aukiBuilderLens,
+  getLens,
+  listLenses
+};