@neuroverseos/governance 0.9.0 → 0.11.0

package/dist/cli/neuroverse.cjs

@@ -6332,6 +6332,24 @@ function isExternalScope(scope) {
   return !internalPatterns.some((p) => p.test(scope));
 }
 function evaluateGuard(event, world, options = {}) {
+  const verdict = evaluateGuardCore(event, world, options);
+  return options.mode === "observe" ? toShadowVerdict(verdict) : verdict;
+}
+function toShadowVerdict(verdict) {
+  if (verdict.status === "ALLOW") return verdict;
+  return {
+    ...verdict,
+    status: "ALLOW",
+    shadowStatus: verdict.status,
+    shadowReason: verdict.reason,
+    // Preserve the original reason as shadowReason and wipe the
+    // top-level reason so callers that display `reason` for BLOCK/PAUSE
+    // don't accidentally surface an enforcement message.
+    reason: void 0,
+    warning: verdict.reason ? `Observe mode: would have ${verdict.status.toLowerCase()} \u2014 ${verdict.reason}` : `Observe mode: would have ${verdict.status.toLowerCase()}`
+  };
+}
+function evaluateGuardCore(event, world, options = {}) {
   const startTime = performance.now();
   const level = options.level ?? "standard";
   const includeTrace = options.trace ?? false;
@@ -7647,10 +7665,99 @@ var init_guard = __esm({
   }
 });
 
+// src/cli/audit.ts
+var audit_exports = {};
+__export(audit_exports, {
+  main: () => main12
+});
+function parseArgs12(argv) {
+  let worldPath = "";
+  let trace = false;
+  let level;
+  let multi = false;
+  let crossingsOnly = false;
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--world") worldPath = argv[++i] ?? "";
+    else if (a === "--trace") trace = true;
+    else if (a === "--level") {
+      const v = argv[++i];
+      if (v === "basic" || v === "standard" || v === "strict") level = v;
+    } else if (a === "--multi") multi = true;
+    else if (a === "--crossings-only") crossingsOnly = true;
+  }
+  return { worldPath, trace, level, multi, crossingsOnly };
+}
+function usage() {
+  process.stderr.write(
+    "Usage: neuroverse audit --world <path> [--trace] [--level basic|standard|strict] [--multi] [--crossings-only]\n\nReads GuardEvent JSON from stdin. With --multi, reads a JSON array.\nEvaluates in observe mode \u2014 no enforcement. Verdicts carry\nshadowStatus/shadowReason for any event that would have crossed.\n"
+  );
+}
+async function main12(argv = process.argv.slice(2)) {
+  const args = parseArgs12(argv);
+  if (!args.worldPath) {
+    usage();
+    process.exit(1);
+  }
+  let world;
+  try {
+    const resolved = resolveWorldPath(args.worldPath);
+    world = await loadWorld(resolved);
+  } catch (err) {
+    process.stderr.write(`Failed to load world: ${err instanceof Error ? err.message : err}
+`);
+    process.exit(1);
+  }
+  let raw = "";
+  try {
+    raw = await readStdin();
+  } catch (err) {
+    process.stderr.write(`Failed to read stdin: ${err instanceof Error ? err.message : err}
+`);
+    process.exit(1);
+  }
+  if (!raw.trim()) {
+    process.stderr.write("No input on stdin. Pipe a GuardEvent or a JSON array with --multi.\n");
+    process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    process.stderr.write(`Invalid JSON on stdin: ${err instanceof Error ? err.message : err}
+`);
+    process.exit(1);
+  }
+  const options = { trace: args.trace, level: args.level, mode: "observe" };
+  if (args.multi) {
+    if (!Array.isArray(parsed)) {
+      process.stderr.write("--multi expects a JSON array on stdin.\n");
+      process.exit(1);
+    }
+    const verdicts = parsed.map(
+      (e) => evaluateGuard(e, world, options)
+    );
+    const out = args.crossingsOnly ? verdicts.filter((v) => v.shadowStatus && v.shadowStatus !== "ALLOW") : verdicts;
+    process.stdout.write(JSON.stringify(out, null, 2) + "\n");
+    return;
+  }
+  const verdict = evaluateGuard(parsed, world, options);
+  process.stdout.write(JSON.stringify(verdict, null, 2) + "\n");
+}
+var init_audit = __esm({
+  "src/cli/audit.ts"() {
+    "use strict";
+    init_guard_engine();
+    init_world_loader();
+    init_world_resolver();
+    init_cli_utils();
+  }
+});
+
 // src/cli/test.ts
 var test_exports = {};
 __export(test_exports, {
-  main: () => main12
+  main: () => main13
 });
 function generateFuzzEvent() {
   const verb = FUZZ_VERBS[Math.floor(Math.random() * FUZZ_VERBS.length)];
@@ -7668,7 +7775,7 @@ function generateFuzzEvent() {
     }
   };
 }
-function parseArgs12(argv) {
+function parseArgs13(argv) {
   let worldPath;
   let fuzz = false;
   let count = 20;
@@ -7684,8 +7791,8 @@ function parseArgs12(argv) {
   }
   return { worldPath, fuzz, count, json, level };
 }
-async function main12(argv) {
-  const args = parseArgs12(argv);
+async function main13(argv) {
+  const args = parseArgs13(argv);
   if (!args.worldPath) {
     process.stderr.write("Usage: neuroverse test --world <dir> [--fuzz] [--count N] [--json]\n");
     process.exit(1);
@@ -7868,9 +7975,9 @@ var init_test = __esm({
 // src/cli/redteam.ts
 var redteam_exports = {};
 __export(redteam_exports, {
-  main: () => main13
+  main: () => main14
 });
-function parseArgs13(argv) {
+function parseArgs14(argv) {
   let worldPath;
   let level = "standard";
   let json = false;
@@ -7882,8 +7989,8 @@ function parseArgs13(argv) {
   }
   return { worldPath, level, json };
 }
-async function main13(argv) {
-  const args = parseArgs13(argv);
+async function main14(argv) {
+  const args = parseArgs14(argv);
   if (!args.worldPath) {
     process.stderr.write("Usage: neuroverse redteam --world <dir> [--level basic|standard|strict] [--json]\n");
     process.exit(1);
@@ -8585,9 +8692,9 @@ var init_behavioral_engine = __esm({
 // src/cli/demo.ts
 var demo_exports = {};
 __export(demo_exports, {
-  main: () => main14
+  main: () => main15
 });
-async function main14(args) {
+async function main15(args) {
   let port = 3456;
   let worldName;
   let noBrowser = false;
@@ -11425,9 +11532,9 @@ var init_ = __esm({
 // src/cli/doctor.ts
 var doctor_exports = {};
 __export(doctor_exports, {
-  main: () => main15
+  main: () => main16
 });
-async function main15(argv) {
+async function main16(argv) {
   const json = argv.includes("--json");
   let worldPath;
   for (let i = 0; i < argv.length; i++) {
@@ -11589,7 +11696,7 @@ var init_doctor = __esm({
 // src/cli/playground.ts
 var playground_exports = {};
 __export(playground_exports, {
-  main: () => main16
+  main: () => main17
 });
 function buildPlaygroundHtml(world, healthSummary) {
   const worldName = world.world.name;
@@ -12015,7 +12122,7 @@ function esc(s) {
 function esc(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function parseArgs14(argv) {
+function parseArgs15(argv) {
   let worldPath;
   let port = 4242;
   for (let i = 0; i < argv.length; i++) {
@@ -12025,8 +12132,8 @@ function parseArgs14(argv) {
   }
   return { worldPath, port };
 }
-async function main16(argv) {
-  const args = parseArgs14(argv);
+async function main17(argv) {
+  const args = parseArgs15(argv);
   let world;
   if (args.worldPath) {
     try {
@@ -12317,7 +12424,7 @@ var init_plan_contract = __esm({
 // src/cli/plan.ts
 var plan_exports = {};
 __export(plan_exports, {
-  main: () => main17
+  main: () => main18
 });
 function parseArg(args, flag) {
   const idx = args.indexOf(flag);
@@ -12549,8 +12656,8 @@ async function deriveCommand(args) {
     return;
   }
   const plan = result.plan;
-  const { mkdirSync: mkdirSync7 } = await import("fs");
-  mkdirSync7(outputDir, { recursive: true });
+  const { mkdirSync: mkdirSync8 } = await import("fs");
+  mkdirSync8(outputDir, { recursive: true });
   const worldJson = {
     world_id: `plan_${plan.plan_id}`,
     name: `Derived: ${plan.objective}`,
@@ -12607,7 +12714,7 @@ async function deriveCommand(args) {
   process.stdout.write(`  Invariants: ${plan.constraints.length} (one per constraint)
 `);
 }
-async function main17(args) {
+async function main18(args) {
   const subcommand = args[0];
   const subArgs = args.slice(1);
   switch (subcommand) {
@@ -13502,7 +13609,7 @@ var init_session = __esm({
 // src/cli/run.ts
 var run_exports = {};
 __export(run_exports, {
-  main: () => main18
+  main: () => main19
 });
 function parseArg2(args, flag) {
   const idx = args.indexOf(flag);
@@ -13527,7 +13634,7 @@ function autoDetectPlan() {
 function loadPlan(path) {
   return JSON.parse((0, import_fs5.readFileSync)(path, "utf-8"));
 }
-async function main18(args) {
+async function main19(args) {
   if (hasFlag(args, "--help") || hasFlag(args, "-h")) {
     process.stdout.write(RUN_USAGE + "\n");
     process.exit(0);
@@ -14280,9 +14387,9 @@ Progress: ${progress.completed}/${progress.total} (${progress.percentage}%)`;
 // src/cli/world.ts
 var world_exports = {};
 __export(world_exports, {
-  main: () => main19
+  main: () => main20
 });
-function parseArgs15(argv) {
+function parseArgs16(argv) {
   const subcommand = argv[0];
   const paths = [];
   const flags = {};
@@ -14560,8 +14667,8 @@ function worldCurrent(json) {
   process.stdout.write(`Source: ${info2.source}
 `);
 }
-async function main19(argv = process.argv.slice(2)) {
-  const { subcommand, paths, flags } = parseArgs15(argv);
+async function main20(argv = process.argv.slice(2)) {
+  const { subcommand, paths, flags } = parseArgs16(argv);
   if (flags.help || !subcommand) {
     process.stdout.write(USAGE + "\n");
     process.exit(0);
@@ -14652,9 +14759,9 @@ Options:
 // src/cli/trace.ts
 var trace_exports = {};
 __export(trace_exports, {
-  main: () => main20
+  main: () => main21
 });
-function parseArgs16(argv) {
+function parseArgs17(argv) {
   const args = {};
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -14738,8 +14845,8 @@ function formatSummary(events) {
   }
   return lines.join("\n");
 }
-async function main20(argv = process.argv.slice(2)) {
-  const args = parseArgs16(argv);
+async function main21(argv = process.argv.slice(2)) {
+  const args = parseArgs17(argv);
   if (args.help) {
     process.stdout.write(USAGE2 + "\n");
     process.exit(0);
@@ -15058,9 +15165,9 @@ var init_impact_report = __esm({
 // src/cli/impact.ts
 var impact_exports = {};
 __export(impact_exports, {
-  main: () => main21
+  main: () => main22
 });
-function parseArgs17(argv) {
+function parseArgs18(argv) {
   const args = {};
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -15070,8 +15177,8 @@ function parseArgs17(argv) {
   }
   return args;
 }
-async function main21(argv = process.argv.slice(2)) {
-  const args = parseArgs17(argv);
+async function main22(argv = process.argv.slice(2)) {
+  const args = parseArgs18(argv);
   if (args.help) {
     process.stdout.write(USAGE3 + "\n");
     process.exit(0);
@@ -15116,9 +15223,9 @@ repeat violations, and actor behavior patterns.
 // src/cli/behavioral.ts
 var behavioral_exports = {};
 __export(behavioral_exports, {
-  main: () => main22
+  main: () => main23
 });
-function parseArgs18(argv) {
+function parseArgs19(argv) {
   const args = {};
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -15128,8 +15235,8 @@ function parseArgs18(argv) {
   }
   return args;
 }
-async function main22(argv = process.argv.slice(2)) {
-  const args = parseArgs18(argv);
+async function main23(argv = process.argv.slice(2)) {
+  const args = parseArgs19(argv);
   if (args.help) {
     process.stdout.write(USAGE4 + "\n");
     process.exit(0);
@@ -15232,9 +15339,9 @@ and generates a human-readable narrative.
 // src/cli/derive.ts
 var derive_exports = {};
 __export(derive_exports, {
-  main: () => main23
+  main: () => main24
 });
-function parseArgs19(argv) {
+function parseArgs20(argv) {
   let inputPath = "";
   let outputPath = "./derived.nv-world.md";
   let validate = true;
@@ -15268,9 +15375,9 @@ function parseArgs19(argv) {
   if (!inputPath) throw new DeriveInputError("--input <path> is required");
   return { inputPath, outputPath, validate, dryRun, bootstrapDir, provider, model, endpoint };
 }
-async function main23(argv = process.argv.slice(2)) {
+async function main24(argv = process.argv.slice(2)) {
   try {
-    const args = parseArgs19(argv);
+    const args = parseArgs20(argv);
     const { result, exitCode, dryRunOutput } = await deriveWorld({
       inputPath: args.inputPath,
       outputPath: args.outputPath,
@@ -15380,9 +15487,9 @@ var init_derive = __esm({
 // src/cli/decision-flow.ts
 var decision_flow_exports = {};
 __export(decision_flow_exports, {
-  main: () => main24
+  main: () => main25
 });
-async function main24(args) {
+async function main25(args) {
   let logPath = ".neuroverse/audit.ndjson";
   let jsonOutput = false;
   for (let i = 0; i < args.length; i++) {
@@ -15439,7 +15546,7 @@ var init_decision_flow = __esm({
 // src/cli/equity-penalties.ts
 var equity_penalties_exports = {};
 __export(equity_penalties_exports, {
-  main: () => main25
+  main: () => main26
 });
 function generateActionsForRound(agents, round2) {
   const actions = [];
@@ -15496,7 +15603,7 @@ function generateActionsForRound(agents, round2) {
   }
   return actions;
 }
-async function main25(args) {
+async function main26(args) {
   let worldPath = "";
   let agentCount = 8;
   let rounds = 5;
@@ -15675,9 +15782,9 @@ var init_equity_penalties = __esm({
 // src/cli/keygen.ts
 var keygen_exports = {};
 __export(keygen_exports, {
-  main: () => main26
+  main: () => main27
 });
-function parseArgs20(argv) {
+function parseArgs21(argv) {
   let output = (0, import_path8.join)((0, import_os2.homedir)(), ".neuroverse", "keys");
   let name = "neuroverse";
   let force = false;
@@ -15696,8 +15803,8 @@ function parseArgs20(argv) {
   }
   return { output, name, force, help };
 }
-async function main26(argv = process.argv.slice(2)) {
-  const args = parseArgs20(argv);
+async function main27(argv = process.argv.slice(2)) {
+  const args = parseArgs21(argv);
   if (args.help) {
     process.stdout.write(USAGE5 + "\n");
     return;
@@ -15760,9 +15867,9 @@ var sign_exports = {};
 __export(sign_exports, {
   buildManifest: () => buildManifest,
   canonicalManifest: () => canonicalManifest,
-  main: () => main27
+  main: () => main28
 });
-function parseArgs21(argv) {
+function parseArgs22(argv) {
   let worldPath = "";
   let keyPath = (0, import_path9.join)((0, import_os3.homedir)(), ".neuroverse", "keys", "neuroverse.key");
   let help = false;
@@ -15806,8 +15913,8 @@ function canonicalManifest(files) {
   const sorted = Object.keys(files).sort();
   return sorted.map((k) => `${k}:${files[k]}`).join("\n");
 }
-async function main27(argv = process.argv.slice(2)) {
-  const args = parseArgs21(argv);
+async function main28(argv = process.argv.slice(2)) {
+  const args = parseArgs22(argv);
   if (args.help) {
     process.stdout.write(USAGE6 + "\n");
     return;
@@ -15872,9 +15979,9 @@ Examples:
 // src/cli/verify.ts
 var verify_exports = {};
 __export(verify_exports, {
-  main: () => main28
+  main: () => main29
 });
-function parseArgs22(argv) {
+function parseArgs23(argv) {
   let worldPath = "";
   let keyPath = (0, import_path10.join)((0, import_os4.homedir)(), ".neuroverse", "keys", "neuroverse.pub");
   let json = false;
@@ -15893,8 +16000,8 @@ function parseArgs22(argv) {
   }
   return { worldPath, keyPath, json, help };
 }
-async function main28(argv = process.argv.slice(2)) {
-  const args = parseArgs22(argv);
+async function main29(argv = process.argv.slice(2)) {
+  const args = parseArgs23(argv);
   if (args.help) {
     process.stdout.write(USAGE7 + "\n");
     return;
@@ -16027,7 +16134,7 @@ Examples:
 var migrate_exports = {};
 __export(migrate_exports, {
   LATEST_VERSION: () => LATEST_VERSION,
-  main: () => main29
+  main: () => main30
 });
 function detectVersion(worldPath) {
   const metaPath = (0, import_path11.join)(worldPath, "metadata.json");
@@ -16060,7 +16167,7 @@ function findMigrationPath(from, to) {
   }
   return path;
 }
-function parseArgs23(argv) {
+function parseArgs24(argv) {
   let worldPath = "";
   let dryRun = false;
   let backup = false;
@@ -16085,8 +16192,8 @@ function parseArgs23(argv) {
   }
   return { worldPath, dryRun, backup, target, json, help };
 }
-async function main29(argv = process.argv.slice(2)) {
-  const args = parseArgs23(argv);
+async function main30(argv = process.argv.slice(2)) {
+  const args = parseArgs24(argv);
   if (args.help) {
     process.stdout.write(USAGE8 + "\n");
     return;
@@ -16253,9 +16360,9 @@ Examples:
 // src/cli/configure-ai.ts
 var configure_ai_exports = {};
 __export(configure_ai_exports, {
-  main: () => main30
+  main: () => main31
 });
-function parseArgs24(argv) {
+function parseArgs25(argv) {
   let provider;
   let model;
   let apiKey;
@@ -16280,9 +16387,9 @@ function parseArgs24(argv) {
   }
   return { provider, model, apiKey, endpoint, show, test };
 }
-async function main30(argv = process.argv.slice(2)) {
+async function main31(argv = process.argv.slice(2)) {
   try {
-    const args = parseArgs24(argv);
+    const args = parseArgs25(argv);
     if (args.show) {
       const config2 = await loadConfig();
       if (!config2) {
@@ -16483,7 +16590,7 @@ var init_prompt_utils = __esm({
 // src/cli/configure-world.ts
 var configure_world_exports = {};
 __export(configure_world_exports, {
-  main: () => main31
+  main: () => main32
 });
 function metricToStateVariable(metric) {
   const id = metric.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "");
@@ -16901,13 +17008,13 @@ function generateWorld(state) {
   return { worldJson, stateSchema, guardsJson, rules, gatesJson, invariants, outcomes, metadata };
 }
 async function writeWorld(outputDir, world) {
-  const { mkdirSync: mkdirSync7, existsSync: existsSync17 } = await import("fs");
+  const { mkdirSync: mkdirSync8, existsSync: existsSync17 } = await import("fs");
   const { writeFile: writeFile6 } = await import("fs/promises");
   const { join: join21 } = await import("path");
   const files = [];
-  if (!existsSync17(outputDir)) mkdirSync7(outputDir, { recursive: true });
+  if (!existsSync17(outputDir)) mkdirSync8(outputDir, { recursive: true });
   const rulesDir = join21(outputDir, "rules");
-  if (!existsSync17(rulesDir)) mkdirSync7(rulesDir, { recursive: true });
+  if (!existsSync17(rulesDir)) mkdirSync8(rulesDir, { recursive: true });
   const writeJson = async (name, data) => {
     const path = join21(outputDir, name);
     await writeFile6(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
@@ -16927,7 +17034,7 @@ async function writeWorld(outputDir, world) {
   }
   return files;
 }
-function parseArgs25(argv) {
+function parseArgs26(argv) {
   let outputDir = "./world/";
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i];
@@ -16937,9 +17044,9 @@ function parseArgs25(argv) {
   }
   return { outputDir };
 }
-async function main31(argv = process.argv.slice(2)) {
+async function main32(argv = process.argv.slice(2)) {
   try {
-    const args = parseArgs25(argv);
+    const args = parseArgs26(argv);
     const context = await phaseContext();
     const guardState = await phaseGuard(context.domain);
     const systemState = await phaseSystem(context.domain);
@@ -17155,7 +17262,7 @@ function previewLens(lens) {
   const DIM4 = "\x1B[2m";
   const CYAN3 = "\x1B[36m";
   const YELLOW4 = "\x1B[33m";
-  const GREEN3 = "\x1B[32m";
+  const GREEN4 = "\x1B[32m";
   const RESET4 = "\x1B[0m";
   const lines = [];
   lines.push("");
@@ -17166,7 +17273,7 @@ function previewLens(lens) {
     if (d.example) {
       lines.push(`  ${BOLD4}${d.id}${RESET4}`);
       lines.push(`  ${YELLOW4}Without:${RESET4} ${DIM4}${d.example.without}${RESET4}`);
-      lines.push(`  ${GREEN3}With:${RESET4}    ${d.example.with}`);
+      lines.push(`  ${GREEN4}With:${RESET4}    ${d.example.with}`);
       lines.push("");
     }
   }
@@ -17840,7 +17947,7 @@ var init_lens = __esm({
 // src/cli/lens.ts
 var lens_exports = {};
 __export(lens_exports, {
-  main: () => main32
+  main: () => main33
 });
 async function cmdList(argv) {
   let worldPath = "";
@@ -18173,7 +18280,7 @@ async function cmdAdd(argv) {
 
 `);
 }
-async function main32(argv = process.argv.slice(2)) {
+async function main33(argv = process.argv.slice(2)) {
   const subcommand = argv[0];
   const subArgs = argv.slice(1);
   try {
@@ -19341,9 +19448,9 @@ var init_worldmodel_create = __esm({
 // src/cli/worldmodel.ts
 var worldmodel_exports = {};
 __export(worldmodel_exports, {
-  main: () => main33
+  main: () => main34
 });
-function parseArgs26(argv) {
+function parseArgs27(argv) {
   const args = {
     inputPath: "",
     output: "",
@@ -19396,7 +19503,7 @@ async function loadAndParse(inputPath) {
   return { model: result.model, issues: result.issues };
 }
 async function cmdInit(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help) {
     process.stdout.write(
       'neuroverse worldmodel init \u2014 Create a new behavioral model\n\nWith ANTHROPIC_API_KEY set:\n  Interactive \u2014 answers questions, AI structures your worldmodel.\n  Your natural process: talk \u2192 structure \u2192 refine.\n\nWithout ANTHROPIC_API_KEY:\n  Template \u2014 generates a scaffold you fill in manually.\n\nOptions:\n  --name <name>      Model name (default: "My Behavioral Model")\n  --output <path>    Output path (default: ./model.worldmodel.md)\n  --template         Force template mode even with API key set\n'
@@ -19718,7 +19825,7 @@ Examples:
 `;
 }
 async function cmdValidate(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel validate <source.worldmodel.md> [--json]\n"
@@ -19775,7 +19882,7 @@ async function cmdValidate(argv) {
   process.exit(errors.length > 0 ? 1 : 0);
 }
 async function cmdExplain(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel explain <source.worldmodel.md> [--json]\n"
@@ -19941,7 +20048,7 @@ function buildExplainData(model) {
   };
 }
 async function cmdBuild(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel build <source.worldmodel.md> [--output <dir>] [--json]\n"
@@ -20038,7 +20145,7 @@ async function cmdBuild(argv) {
   }
 }
 async function cmdEmitWorld(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write("neuroverse worldmodel emit-world <source.worldmodel.md>\n");
     return;
@@ -20056,7 +20163,7 @@ async function cmdEmitWorld(argv) {
   }
 }
 async function cmdEmitSignals(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel emit-signals <source.worldmodel.md> [--json]\n"
@@ -20068,7 +20175,7 @@ async function cmdEmitSignals(argv) {
   process.stdout.write(JSON.stringify(schema, null, 2) + "\n");
 }
 async function cmdEmitLenses(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel emit-lenses <source.worldmodel.md> [--json]\n"
@@ -20080,7 +20187,7 @@ async function cmdEmitLenses(argv) {
   process.stdout.write(JSON.stringify(lenses, null, 2) + "\n");
 }
 async function cmdEmitContexts(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel emit-contexts <source.worldmodel.md> [--json]\n"
@@ -20092,7 +20199,7 @@ async function cmdEmitContexts(argv) {
   process.stdout.write(JSON.stringify(contexts, null, 2) + "\n");
 }
 async function cmdEmitOverlaps(argv) {
-  const args = parseArgs26(argv);
+  const args = parseArgs27(argv);
   if (args.help || !args.inputPath) {
     process.stdout.write(
       "neuroverse worldmodel emit-overlaps <source.worldmodel.md> [--json]\n"
@@ -20103,7 +20210,7 @@ async function cmdEmitOverlaps(argv) {
   const overlaps = emitOverlapMap(model);
   process.stdout.write(JSON.stringify(overlaps, null, 2) + "\n");
 }
-async function main33(argv = process.argv.slice(2)) {
+async function main34(argv = process.argv.slice(2)) {
   const subcommand = argv[0] ?? "";
   const subArgs = argv.slice(1);
   switch (subcommand) {
@@ -21832,6 +21939,262 @@ var init_notion = __esm({
   }
 });
 
+// src/radiant/adapters/linear.ts
+async function fetchLinearActivity(apiKey, options = {}) {
+  const windowDays = options.windowDays ?? 14;
+  const maxIssues = options.maxIssues ?? 200;
+  const since = new Date(Date.now() - windowDays * 24 * 60 * 60 * 1e3);
+  const sinceIso = since.toISOString();
+  const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+  const teamFilter = options.teamIds && options.teamIds.length > 0 ? `team: { id: { in: [${options.teamIds.map((t) => JSON.stringify(t)).join(", ")}] } }` : "";
+  const issuesQuery = `
+    query RadiantIssues($since: DateTimeOrDuration!, $first: Int!) {
+      issues(
+        filter: {
+          updatedAt: { gte: $since }
+          ${teamFilter}
+        }
+        first: $first
+        orderBy: updatedAt
+      ) {
+        nodes {
+          id
+          identifier
+          title
+          url
+          createdAt
+          updatedAt
+          completedAt
+          canceledAt
+          state { name type }
+          assignee { id name email }
+          creator { id name }
+          team { id name }
+          project { id name }
+          cycle { id number startsAt endsAt }
+          comments(first: 20) {
+            nodes { id body createdAt user { id name } }
+          }
+        }
+      }
+    }
+  `;
+  const cyclesQuery = `
+    query RadiantCycles($since: DateTimeOrDuration!, $now: DateTimeOrDuration!) {
+      cycles(
+        filter: { endsAt: { gte: $since, lte: $now } }
+        first: 20
+      ) {
+        nodes {
+          id
+          number
+          startsAt
+          endsAt
+          issueCountHistory
+          completedIssueCountHistory
+          team { id name }
+        }
+      }
+    }
+  `;
+  const [issuesResponse, cyclesResponse] = await Promise.all([
+    fetchLinearGraphQL(apiKey, issuesQuery, {
+      since: sinceIso,
+      first: maxIssues
+    }),
+    fetchLinearGraphQL(apiKey, cyclesQuery, {
+      since: sinceIso,
+      now: nowIso
+    })
+  ]);
+  const rawIssues = issuesResponse.issues?.nodes ?? [];
+  const rawCycles = cyclesResponse.cycles?.nodes ?? [];
+  const events = [];
+  const assignees = /* @__PURE__ */ new Set();
+  const projects = /* @__PURE__ */ new Map();
+  let issuesCreated = 0;
+  let issuesCompleted = 0;
+  let issuesOpen = 0;
+  let issuesStalled = 0;
+  let commentsTotal = 0;
+  const now = Date.now();
+  const stallThresholdMs = 14 * 24 * 60 * 60 * 1e3;
+  for (const issue of rawIssues) {
+    const created = new Date(issue.createdAt);
+    const updated = new Date(issue.updatedAt);
+    const completed = issue.completedAt ? new Date(issue.completedAt) : null;
+    const assigneeId = issue.assignee?.id ?? "unassigned";
+    if (assigneeId !== "unassigned") assignees.add(assigneeId);
+    if (issue.project) {
+      projects.set(issue.project.name, (projects.get(issue.project.name) ?? 0) + 1);
+    }
+    const actor = {
+      id: assigneeId,
+      kind: "human",
+      name: issue.assignee?.name ?? "unassigned"
+    };
+    if (created >= since) {
+      issuesCreated++;
+      events.push({
+        id: `linear-created-${issue.id}`,
+        timestamp: issue.createdAt,
+        actor: {
+          id: issue.creator?.id ?? "unknown",
+          kind: "human",
+          name: issue.creator?.name ?? "unknown"
+        },
+        kind: "issue_created",
+        content: `[${issue.identifier}] ${issue.title}`,
+        metadata: {
+          issueId: issue.id,
+          url: issue.url,
+          team: issue.team?.name,
+          project: issue.project?.name,
+          state: issue.state?.name
+        }
+      });
+    }
+    if (completed && completed >= since) {
+      issuesCompleted++;
+      events.push({
+        id: `linear-completed-${issue.id}`,
+        timestamp: issue.completedAt,
+        actor,
+        kind: "issue_completed",
+        content: `[${issue.identifier}] ${issue.title}`,
+        metadata: {
+          issueId: issue.id,
+          url: issue.url,
+          team: issue.team?.name,
+          project: issue.project?.name,
+          cycleDays: issue.cycle?.startsAt && issue.completedAt ? Math.round(
+            (new Date(issue.completedAt).getTime() - new Date(issue.cycle.startsAt).getTime()) / (24 * 60 * 60 * 1e3)
+          ) : null
+        }
+      });
+    }
+    if (!completed && !issue.canceledAt) {
+      issuesOpen++;
+      const isInProgress = issue.state?.type === "started";
+      const idleMs = now - updated.getTime();
+      if (isInProgress && idleMs > stallThresholdMs) issuesStalled++;
+    }
+    for (const comment of issue.comments?.nodes ?? []) {
+      const commentedAt = new Date(comment.createdAt);
+      if (commentedAt < since) continue;
+      commentsTotal++;
+      events.push({
+        id: `linear-comment-${comment.id}`,
+        timestamp: comment.createdAt,
+        actor: {
+          id: comment.user?.id ?? "unknown",
+          kind: "human",
+          name: comment.user?.name ?? "unknown"
+        },
+        kind: "issue_comment",
+        content: comment.body.slice(0, 280),
+        metadata: {
+          issueId: issue.id,
+          issueIdentifier: issue.identifier,
+          url: issue.url
+        }
+      });
+    }
+  }
+  let cycleCompletionRate = null;
+  if (rawCycles.length > 0) {
+    const rates = [];
+    for (const cycle of rawCycles) {
+      const committed = cycle.issueCountHistory?.at(0) ?? 0;
+      const completed = cycle.completedIssueCountHistory?.at(-1) ?? 0;
+      if (committed > 0) rates.push(completed / committed);
+    }
+    if (rates.length > 0) {
+      cycleCompletionRate = Math.round(rates.reduce((a, b) => a + b, 0) / rates.length * 100) / 100;
+    }
+  }
+  const topProjects = [...projects.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5).map(([name]) => name);
+  const signals = {
+    issuesCreated,
+    issuesCompleted,
+    issuesOpen,
+    issuesStalled,
+    cycleCompletionRate,
+    uniqueAssignees: assignees.size,
+    commentsTotal,
+    topProjects
+  };
+  events.sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+  return { events, signals };
+}
+function formatLinearSignalsForPrompt(signals) {
+  if (signals.issuesCreated === 0 && signals.issuesCompleted === 0 && signals.issuesOpen === 0) {
+    return "";
+  }
+  const lines = [
+    "## Linear Activity (planned work vs. shipped outcome)",
+    "",
+    `${signals.issuesCreated} issues created, ${signals.issuesCompleted} completed in window.`,
+    `${signals.issuesOpen} issues still open.`
+  ];
+  if (signals.issuesStalled > 0) {
+    lines.push(
+      `${signals.issuesStalled} in-progress issues haven't moved in 14+ days (stalled).`
+    );
+  }
+  if (signals.cycleCompletionRate !== null) {
+    const pct = Math.round(signals.cycleCompletionRate * 100);
+    lines.push(`Cycles ended in window completed ${pct}% of what was committed.`);
+  }
+  if (signals.uniqueAssignees > 0) {
+    lines.push(`${signals.uniqueAssignees} unique assignees active.`);
+  }
+  if (signals.commentsTotal > 0) {
+    lines.push(`${signals.commentsTotal} comments across issues in window.`);
+  }
+  if (signals.topProjects.length > 0) {
+    lines.push(`Most active projects: ${signals.topProjects.join(", ")}.`);
+  }
+  lines.push("");
+  lines.push("Linear is where the team states what it will build.");
+  lines.push("GitHub is where the team reveals what actually got built.");
+  lines.push("Low completion rate + high creation rate = planning faster than shipping.");
+  lines.push("High stalled count = commitments made but not honored.");
+  lines.push("Compare Linear signals against GitHub to find the stated-vs-shipped gap.");
+  return lines.join("\n");
+}
+async function fetchLinearGraphQL(apiKey, query, variables) {
+  const res = await fetch("https://api.linear.app/graphql", {
+    method: "POST",
+    headers: {
+      // Linear accepts the raw API key in Authorization with no "Bearer" prefix.
+      Authorization: apiKey,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ query, variables })
+  });
+  if (!res.ok) {
+    throw new Error(
+      `Linear API error ${res.status}: ${(await res.text()).slice(0, 300)}`
+    );
+  }
+  const json = await res.json();
+  if (json.errors && json.errors.length > 0) {
+    throw new Error(
+      `Linear GraphQL errors: ${json.errors.map((e) => e.message).join("; ")}`
+    );
+  }
+  if (!json.data) {
+    throw new Error("Linear API returned no data");
+  }
+  return json.data;
+}
+var init_linear = __esm({
+  "src/radiant/adapters/linear.ts"() {
+    "use strict";
+  }
+});
+
 // src/radiant/core/git-remote.ts
 function resolveGitConfigPath(repoDir) {
   const dotGit = (0, import_path14.join)(repoDir, ".git");
@@ -22485,6 +22848,7 @@ async function auditGovernance(events, worldPath) {
     return emptyAudit(events.length, "Could not load compiled worldmodel for governance audit.");
   }
   const verdicts = [];
+  const crossings = [];
   for (const ce of events) {
     const intent = ce.event.content?.slice(0, 500) || ce.event.kind || "activity";
     const scope = ce.event.metadata?.scope || void 0;
@@ -22495,16 +22859,32 @@ async function auditGovernance(events, worldPath) {
           scope,
           actionCategory: mapKindToCategory(ce.event.kind)
         },
-        world
+        world,
+        { mode: "observe" }
       );
+      const shadow = result.shadowStatus ?? "ALLOW";
       verdicts.push({
         eventId: ce.event.id,
         domain: ce.domain,
-        status: result.status,
-        reason: result.reason,
+        status: shadow,
+        reason: result.shadowReason,
         ruleId: result.ruleId,
         warning: result.warning
       });
+      if (shadow !== "ALLOW") {
+        crossings.push({
+          eventId: ce.event.id,
+          timestamp: ce.event.timestamp,
+          kind: ce.event.kind,
+          actorId: ce.event.actor.id,
+          shadowStatus: shadow,
+          shadowReason: result.shadowReason,
+          ruleId: result.ruleId,
+          excerpt: intent.length > 280 ? intent.slice(0, 279) + "\u2026" : intent,
+          wouldHaveBlocked: true,
+          verdict: result
+        });
+      }
     } catch {
       verdicts.push({
         eventId: ce.event.id,
@@ -22523,6 +22903,7 @@ async function auditGovernance(events, worldPath) {
     human,
     cyber,
     joint,
+    crossings,
     summary: summary2
   };
 }
@@ -22578,6 +22959,7 @@ function emptyAudit(total, reason) {
     human: { allow: 0, modify: 0, block: 0, details: [] },
     cyber: { allow: 0, modify: 0, block: 0, details: [] },
     joint: { allow: 0, modify: 0, block: 0, details: [] },
+    crossings: [],
     summary: reason
   };
 }
@@ -22761,6 +23143,144 @@ var init_signals = __esm({
   }
 });
 
+// src/radiant/core/vocabulary.ts
+function extractDeclaredVocabulary(worldmodelContent) {
+  const aligned = extractSection(worldmodelContent, "Aligned Behaviors").map(
+    (b) => parseBehavior(b, "aligned")
+  );
+  const drift = extractSection(worldmodelContent, "Drift Behaviors").map(
+    (b) => parseBehavior(b, "drift")
+  );
+  const allNames = [...aligned, ...drift].map((p) => p.name);
+  return { aligned, drift, allNames };
+}
+function extractSection(content, header) {
+  const escaped = header.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const pattern = new RegExp(
+    `##\\s+${escaped}\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`,
+    "i"
+  );
+  const match = content.match(pattern);
+  if (!match) return [];
+  const body = match[1];
+  const bullets = body.match(/^[-*]\s+.+$/gm);
+  if (!bullets) return [];
+  return bullets.map((b) => b.replace(/^[-*]\s+/, "").trim()).filter((b) => b.length > 0 && !b.startsWith("<!--"));
+}
+function parseBehavior(bullet, kind) {
+  const explicit = bullet.match(
+    /^`?([a-z][a-z0-9_]*)`?\s+[—\u2014-]\s+(.+)$/i
+  );
+  if (explicit && isSnakeCase(explicit[1])) {
+    return {
+      name: explicit[1].toLowerCase(),
+      prose: explicit[2].trim(),
+      kind
+    };
+  }
+  return { name: snakeCaseName(bullet), prose: bullet, kind };
+}
+function isSnakeCase(s) {
+  return /^[a-z][a-z0-9_]*$/.test(s);
+}
+function snakeCaseName(s) {
+  const base = s.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  if (base.length <= 60) return base;
+  const truncated = base.slice(0, 60);
+  const lastUnderscore = truncated.lastIndexOf("_");
+  return lastUnderscore > 20 ? truncated.slice(0, lastUnderscore) : truncated;
+}
+function matchDeclaredPattern(candidateName, candidateDescription, vocabulary) {
+  const candidateText = `${candidateName.replace(/_/g, " ")} ${candidateDescription}`;
+  const candidateWords = contentWords(candidateText);
+  if (candidateWords.size === 0) return null;
+  let best = null;
+  for (const pattern of [...vocabulary.aligned, ...vocabulary.drift]) {
+    const proseWords = contentWords(pattern.prose);
+    if (proseWords.size === 0) continue;
+    let shared = 0;
+    for (const w of proseWords) {
+      if (candidateWords.has(w)) shared++;
+    }
+    const coverage = shared / proseWords.size;
+    if (shared >= 2 && coverage >= 0.3) {
+      if (!best || coverage > best.score) {
+        best = { pattern, score: coverage };
+      }
+    }
+  }
+  return best?.pattern ?? null;
+}
+function contentWords(text) {
+  const words = text.toLowerCase().match(/[a-z][a-z0-9_]+/g) ?? [];
+  return new Set(words.filter((w) => w.length > 3 && !STOPWORDS.has(w)));
+}
+var STOPWORDS;
+var init_vocabulary = __esm({
+  "src/radiant/core/vocabulary.ts"() {
+    "use strict";
+    STOPWORDS = /* @__PURE__ */ new Set([
+      "about",
+      "after",
+      "against",
+      "among",
+      "around",
+      "because",
+      "been",
+      "before",
+      "being",
+      "between",
+      "both",
+      "could",
+      "does",
+      "doing",
+      "during",
+      "each",
+      "from",
+      "further",
+      "have",
+      "having",
+      "into",
+      "itself",
+      "most",
+      "nor",
+      "only",
+      "other",
+      "over",
+      "same",
+      "should",
+      "some",
+      "such",
+      "than",
+      "that",
+      "their",
+      "them",
+      "then",
+      "there",
+      "these",
+      "they",
+      "this",
+      "those",
+      "through",
+      "under",
+      "until",
+      "very",
+      "were",
+      "what",
+      "when",
+      "where",
+      "which",
+      "while",
+      "will",
+      "with",
+      "without",
+      "would",
+      "your",
+      "yours"
+    ]);
+  }
+});
+
 // src/radiant/types.ts
 function isScored(s) {
   return typeof s === "number";
@@ -22812,7 +23332,11 @@ var init_math = __esm({
 async function interpretPatterns(input) {
   const prompt = buildInterpretationPrompt(input);
   const raw = await input.ai.complete(prompt, "Analyze the activity and produce the read.");
-  const parsed = parseInterpretation(raw, input.canonicalPatterns ?? []);
+  const canonicalNames = [
+    ...input.canonicalPatterns ?? [],
+    ...input.declaredVocabulary?.allNames ?? []
+  ];
+  const parsed = parseInterpretation(raw, canonicalNames, input.declaredVocabulary);
   return {
     patterns: parsed.patterns,
     meaning: parsed.meaning,
@@ -22823,8 +23347,10 @@ async function interpretPatterns(input) {
 function buildInterpretationPrompt(input) {
   const signalSummary = formatSignalSummary(input.signals);
   const eventSample = formatEventSample(input.events, 30);
-  const canonicalList = (input.canonicalPatterns ?? []).length > 0 ? `Patterns the organization has already named (use these names if you see them):
-${input.canonicalPatterns.map((p) => `- ${p}`).join("\n")}` : "No patterns have been named yet. Everything you observe is new.";
+  const canonicalList = formatDeclaredVocabulary(
+    input.declaredVocabulary,
+    input.canonicalPatterns ?? []
+  );
   const compressedWorld = compressWorldmodel(input.worldmodelContent);
   const cl = compressLens(input.lens);
   const frame = input.lens.primary_frame;
@@ -22935,6 +23461,44 @@ Only recommend a move when the evidence actually calls for one.
 Do NOT use these phrases anywhere in your output:
 ${forbiddenList}`;
 }
+function formatDeclaredVocabulary(vocabulary, extraNames) {
+  const aligned = vocabulary?.aligned ?? [];
+  const drift = vocabulary?.drift ?? [];
+  if (aligned.length === 0 && drift.length === 0 && extraNames.length === 0) {
+    return 'No patterns have been named yet. Everything you observe is new \u2014 mark it type: "candidate".';
+  }
+  const parts = [];
+  parts.push("## Declared vocabulary (use these names when you see matching evidence)");
+  parts.push("");
+  parts.push(
+    'The worldmodel declares the patterns below. If your observation matches one of these, use the EXACT snake_case name shown and mark type: "canonical" \u2014 do not invent a new name for something that already has one.'
+  );
+  parts.push("");
+  if (aligned.length > 0) {
+    parts.push("### Aligned behaviors (positive patterns)");
+    for (const p of aligned) {
+      parts.push(`- \`${p.name}\` \u2014 ${p.prose}`);
+    }
+    parts.push("");
+  }
+  if (drift.length > 0) {
+    parts.push("### Drift behaviors (negative patterns)");
+    for (const p of drift) {
+      parts.push(`- \`${p.name}\` \u2014 ${p.prose}`);
+    }
+    parts.push("");
+  }
+  if (extraNames.length > 0) {
+    parts.push(
+      `Additional canonical names (from prior runs or caller): ${extraNames.join(", ")}`
+    );
+    parts.push("");
+  }
+  parts.push(
+    'If you observe something genuinely new that matches NO declared pattern, mark it type: "candidate" with a freshly-invented snake_case name.'
+  );
+  return parts.join("\n");
+}
 function formatSignalSummary(signals) {
   const lines = [];
   const domains = ["life", "cyber", "joint"];
@@ -22960,7 +23524,7 @@ function formatEventSample(events, maxEvents) {
   "${content}"`;
   }).join("\n");
 }
-function parseInterpretation(raw, canonicalNames) {
+function parseInterpretation(raw, canonicalNames, vocabulary) {
   let meaning = "";
   let move = "";
   let patternsArray = [];
@@ -22990,14 +23554,23 @@ function parseInterpretation(raw, canonicalNames) {
   const patterns = [];
   for (const item of patternsArray) {
     if (!isPatternLike(item)) continue;
-    const nameStr = String(item.name ?? "unnamed");
+    const rawName = String(item.name ?? "unnamed");
+    const description = String(item.description ?? "");
     const ev = item.evidence;
-    const isCanonical = item.type === "canonical" || canonicalSet.has(nameStr.toLowerCase());
+    let name = rawName;
+    let isCanonical = item.type === "canonical" || canonicalSet.has(rawName.toLowerCase());
+    if (!isCanonical && vocabulary) {
+      const matched = matchDeclaredPattern(rawName, description, vocabulary);
+      if (matched) {
+        name = matched.name;
+        isCanonical = true;
+      }
+    }
     patterns.push({
-      name: nameStr,
+      name,
       type: isCanonical ? "canonical" : "candidate",
-      declaredAs: isCanonical ? nameStr : void 0,
-      description: String(item.description ?? ""),
+      declaredAs: isCanonical ? name : void 0,
+      description,
       evidence: {
         signals: Array.isArray(ev?.signals) ? ev.signals.map(String) : [],
         events: Array.isArray(ev?.events) ? ev.events.map(String) : [],
@@ -23015,6 +23588,7 @@ var init_patterns = __esm({
   "src/radiant/core/patterns.ts"() {
     "use strict";
     init_compress();
+    init_vocabulary();
   }
 });
 
@@ -23333,10 +23907,24 @@ Compare stated intent against actual GitHub activity. Gaps = drift.`;
     } catch {
     }
   }
+  const linearKey = process.env.LINEAR_API_KEY;
+  if (linearKey) {
+    try {
+      const linear = await fetchLinearActivity(linearKey, { windowDays });
+      events.push(...linear.events);
+      adapterSignals += "\n\n" + formatLinearSignalsForPrompt(linear.signals);
+      activeAdapters.push("linear");
+    } catch {
+    }
+  }
   events.sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+  if (input.personalUser) {
+    events = filterEventsByUser(events, input.personalUser);
+  }
   const classified = classifyEvents(events);
   const signals = extractSignals(classified);
   const scores = computeScores(signals, input.worldmodelContent !== "");
+  const declaredVocabulary = extractDeclaredVocabulary(worldmodelContent);
   const { patterns, meaning, move } = await interpretPatterns({
     signals,
     events: classified,
@@ -23344,6 +23932,7 @@ Compare stated intent against actual GitHub activity. Gaps = drift.`;
     lens,
     ai: input.ai,
     canonicalPatterns: input.canonicalPatterns,
+    declaredVocabulary,
     statedIntent: [statedIntent, adapterSignals, priorReadContext].filter(Boolean).join("\n\n") || void 0
   });
   const rewrittenPatterns = patterns.map((p) => lens.rewrite(p));
@@ -23395,9 +23984,14 @@ Compare stated intent against actual GitHub activity. Gaps = drift.`;
     scores,
     eventCount: events.length,
     activeAdapters,
-    worldStack
+    worldStack,
+    governance
   };
 }
+function filterEventsByUser(events, username) {
+  const target = username.toLowerCase();
+  return events.filter((e) => e.actor.id.toLowerCase() === target);
+}
 function computeScores(signals, worldmodelLoaded) {
   const gate = DEFAULT_EVIDENCE_GATE;
   const lifeSignals = signals.filter((s) => s.domain === "life");
@@ -23453,12 +24047,14 @@ var init_emergent = __esm({
     init_discord();
     init_slack();
     init_notion();
+    init_linear();
     init_discovery();
     init_exocortex();
     init_palace();
     init_compress();
     init_governance();
     init_signals();
+    init_vocabulary();
     init_math();
     init_patterns();
     init_renderer();
@@ -23780,9 +24376,11 @@ var init_server = __esm({
 // src/cli/radiant.ts
 var radiant_exports = {};
 __export(radiant_exports, {
-  main: () => main34
+  checkScopeConsent: () => checkScopeConsent,
+  main: () => main35,
+  parseArgs: () => parseArgs28
 });
-function parseArgs27(argv) {
+function parseArgs28(argv) {
   const result = {
     subcommand: void 0,
     lens: void 0,
@@ -23792,8 +24390,12 @@ function parseArgs27(argv) {
     exocortex: void 0,
     teamExocortex: void 0,
     view: void 0,
+    user: void 0,
+    personal: false,
+    entireOrg: false,
     json: false,
     help: false,
+    force: false,
     rest: []
   };
   let i = 0;
@@ -23825,9 +24427,22 @@ function parseArgs27(argv) {
       case "--view":
         result.view = argv[++i];
         break;
+      case "--user":
+        result.user = argv[++i];
+        break;
+      case "--personal":
+        result.personal = true;
+        break;
+      case "--entire-org":
+        result.entireOrg = true;
+        break;
       case "--json":
         result.json = true;
         break;
+      case "--force":
+      case "-f":
+        result.force = true;
+        break;
       case "--help":
       case "-h":
         result.help = true;
@@ -23985,6 +24600,15 @@ ${DIM3}Model:  ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET3}
     process.exit(2);
   }
 }
+function checkScopeConsent(input) {
+  if (input.personal && !input.resolvedUser) {
+    return { ok: false, reason: "personal_requires_user" };
+  }
+  if (input.scope.type === "org" && !input.entireOrg && !input.personal) {
+    return { ok: false, reason: "org_requires_opt_in" };
+  }
+  return { ok: true };
+}
 async function cmdEmergent(args) {
   const scopeStr = args.rest[0];
   if (!scopeStr) {
@@ -23995,6 +24619,43 @@ async function cmdEmergent(args) {
     process.exit(1);
   }
   const scope = parseScope(scopeStr);
+  const personalUser = args.user ?? process.env.RADIANT_USER;
+  const consent = checkScopeConsent({
+    scope,
+    personal: args.personal,
+    entireOrg: args.entireOrg,
+    resolvedUser: personalUser
+  });
+  if (!consent.ok) {
+    if (consent.reason === "personal_requires_user") {
+      process.stderr.write(
+        `${RED2}Error:${RESET3} --personal requires a GitHub username.
+${DIM3}Pass --user <login> or set RADIANT_USER. Radiant will read
+only that user's activity \u2014 no one else is observed.${RESET3}
+`
+      );
+    } else {
+      process.stderr.write(
+        `${YELLOW3}\u26A0${RESET3}  ${BOLD3}"${scope.owner}" is an org-wide scope.${RESET3}
+
+${DIM3}This reads activity across ALL repos in the org \u2014 a global-observer
+pattern that some teams consider offside with decentralization and
+cognitive-liberty principles. It's opt-in for that reason.${RESET3}
+
+Three ways forward:
+  ${GREEN3}1.${RESET3} Scope to a single repo (recommended default):
+       radiant emergent ${scope.owner}/<repo>
+
+  ${GREEN3}2.${RESET3} Read only your own activity (personal mode):
+       radiant emergent ${scope.owner}/ --personal --user <your-login>
+
+  ${GREEN3}3.${RESET3} Explicitly opt in to org-wide observation:
+       radiant emergent ${scope.owner}/ --entire-org
+`
+      );
+    }
+    process.exit(1);
+  }
   const lensId = args.lens ?? process.env.RADIANT_LENS;
   if (!lensId) {
     process.stderr.write(
@@ -24043,8 +24704,11 @@ ${DIM3}Set it to a GitHub PAT with repo read access.${RESET3}
     const ctx = readExocortex(exocortexPath);
     exocortexStatus = summarizeExocortex(ctx);
   }
+  const scopeLabel = scope.type === "org" ? scope.owner + " (entire org)" : scope.owner + "/" + scope.repo;
+  const modeLabel = args.personal ? `personal \u2014 only ${personalUser}'s activity` : "team \u2014 all contributors";
   process.stderr.write(
-    `${DIM3}Scope:      ${scope.type === "org" ? scope.owner + " (entire org)" : scope.owner + "/" + scope.repo}${RESET3}
+    `${DIM3}Scope:      ${scopeLabel}${RESET3}
+${DIM3}Mode:       ${modeLabel}${RESET3}
 ${DIM3}View:       ${view}${RESET3}
 ${DIM3}Lens:       ${lensId}${RESET3}
 ${DIM3}Model:      ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET3}
@@ -24060,7 +24724,8 @@ ${DIM3}Fetching activity...${RESET3}
     lensId,
     ai,
     windowDays: 14,
-    exocortexPath: exocortexPath || void 0
+    exocortexPath: exocortexPath || void 0,
+    personalUser: args.personal ? personalUser : void 0
   });
   if (!result.voiceClean) {
     process.stderr.write(
@@ -24162,13 +24827,52 @@ ${DIM3}Use: lenses list | lenses describe <id>${RESET3}
   );
   process.exit(1);
 }
-async function main34(argv) {
-  const args = parseArgs27(argv);
+async function cmdInit2(args) {
+  const targetDir = (0, import_path20.resolve)(args.rest[0] ?? "./mind-palace");
+  const existed = (0, import_fs19.existsSync)(targetDir);
+  if (existed && !args.force) {
+    const entries = (0, import_fs19.readdirSync)(targetDir);
+    if (entries.length > 0) {
+      process.stderr.write(
+        `${RED2}Error:${RESET3} ${targetDir} already exists and is not empty.
+${DIM3}Use --force to write into it anyway (existing files will be overwritten).${RESET3}
+`
+      );
+      process.exit(1);
+    }
+  }
+  (0, import_fs19.mkdirSync)(targetDir, { recursive: true });
+  (0, import_fs19.mkdirSync)((0, import_path20.join)(targetDir, "reads"), { recursive: true });
+  (0, import_fs19.mkdirSync)((0, import_path20.join)(targetDir, "worldmodels"), { recursive: true });
+  for (const [relPath, content] of Object.entries(MIND_PALACE_FILES)) {
+    const fullPath = (0, import_path20.join)(targetDir, relPath);
+    (0, import_fs19.mkdirSync)((0, import_path20.resolve)(fullPath, ".."), { recursive: true });
+    (0, import_fs19.writeFileSync)(fullPath, content, "utf-8");
+  }
+  process.stdout.write(
+    `${GREEN3}\u2713${RESET3} Mind Palace scaffolded at ${BOLD3}${targetDir}${RESET3}
+
+${DIM3}Next steps:${RESET3}
+  1. Edit ${targetDir}/attention.md \u2014 what you're focused on right now
+  2. Edit ${targetDir}/worldmodels/starter.worldmodel.md \u2014 add a few
+     aligned and drift behaviors
+  3. Run: neuroverse radiant emergent <owner/repo> \\
+           --worlds ${targetDir}/worldmodels \\
+           --exocortex ${targetDir}
+
+${DIM3}Files are yours. Edit freely.${RESET3}
+`
+  );
+}
+async function main35(argv) {
+  const args = parseArgs28(argv);
   if (args.help || !args.subcommand) {
     process.stdout.write(USAGE10 + "\n");
     return;
   }
   switch (args.subcommand) {
+    case "init":
+      return cmdInit2(args);
     case "think":
       return cmdThink(args);
     case "lenses":
@@ -24199,7 +24903,7 @@ async function main34(argv) {
       process.exit(1);
   }
 }
-var import_fs19, import_path20, RED2, DIM3, BOLD3, YELLOW3, RESET3, USAGE10;
+var import_fs19, import_path20, RED2, GREEN3, DIM3, BOLD3, YELLOW3, RESET3, USAGE10, MIND_PALACE_FILES;
 var init_radiant = __esm({
   "src/cli/radiant.ts"() {
     "use strict";
@@ -24213,6 +24917,7 @@ var init_radiant = __esm({
     init_lenses();
     init_discovery();
     RED2 = "\x1B[31m";
+    GREEN3 = "\x1B[32m";
     DIM3 = "\x1B[2m";
     BOLD3 = "\x1B[1m";
     YELLOW3 = "\x1B[33m";
@@ -24220,6 +24925,9 @@ var init_radiant = __esm({
     USAGE10 = `
 ${BOLD3}neuroverse radiant${RESET3} \u2014 behavioral intelligence for collaboration systems
 
+${BOLD3}Setup:${RESET3}
+  init           Scaffold a Mind Palace in the current directory
+
 ${BOLD3}Stage A (voice layer):${RESET3}
   think          Send a query through the worldmodel + lens \u2192 AI-framed response
 
@@ -24230,13 +24938,27 @@ ${BOLD3}Stage B (behavioral analysis, coming soon):${RESET3}
   lenses         List or describe available rendering lenses
 
 ${BOLD3}Usage:${RESET3}
+  neuroverse radiant init                      (scaffolds ./mind-palace/)
+  neuroverse radiant init ./my-palace          (custom path)
   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 emergent aukilabs/posemesh --personal --user alice
+  neuroverse radiant emergent aukilabs/ --entire-org --lens auki-builder --worlds ./worlds/
   neuroverse radiant lenses list
   neuroverse radiant lenses describe auki-builder
 
+${BOLD3}Read modes:${RESET3}
+  ${BOLD3}Default (team):${RESET3} reads all contributors in the given scope.
+  ${BOLD3}--personal --user <login>:${RESET3} reads ONLY that user's activity.
+    A local, private facilitator \u2014 no one else is observed. Works against
+    any scope; an org scope with --personal is fine.
+  ${BOLD3}--entire-org (gated):${RESET3} org-wide scope observes every contributor
+    across every repo. This is a global-observer stance and is opt-in.
+    \`radiant emergent <org>/\` without --entire-org will refuse and show
+    you the three choices (single repo, --personal, or explicit opt-in).
+
 ${BOLD3}Auto-discovery:${RESET3}
   You do not need to clone the target repo.
 
@@ -24255,7 +24977,169 @@ ${BOLD3}Environment:${RESET3}
   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)
+  RADIANT_USER         Default personal-mode user (overridden by --user)
 `.trim();
+    MIND_PALACE_FILES = {
+      "README.md": `# Mind Palace
+
+This is your Mind Palace \u2014 structured external memory that gives Radiant
+(and any agent you wire into it) persistent context about who you are,
+what you're working on, and what "on track" means for you.
+
+Radiant reads these files before every run and writes each read back into
+\`reads/\`. Over time, \`knowledge.md\` accumulates what's persisted and what
+hasn't \u2014 the feedback loop that turns raw activity into named behavior.
+
+## Files
+
+- \`attention.md\` \u2014 what you're focused on **right now**
+- \`goals.md\` \u2014 what you're working toward
+- \`sprint.md\` \u2014 this week's focus
+- \`identity.md\` \u2014 who you are, what you value
+- \`worldmodels/\` \u2014 your thinking constitutions (drift + aligned behaviors)
+- \`reads/\` \u2014 dated Radiant reads (written by \`radiant emergent\`)
+- \`knowledge.md\` \u2014 accumulated pattern persistence across reads
+
+## How to use
+
+1. Fill in \`attention.md\`, \`goals.md\`, \`sprint.md\`, \`identity.md\` with
+   your own words. A sentence each is enough to start \u2014 the files grow
+   with you.
+2. Edit \`worldmodels/starter.worldmodel.md\`: add a few aligned behaviors
+   (what on-track looks like) and drift behaviors (what off-track looks
+   like). The sharper these are, the sharper Radiant's reads.
+3. Run \`neuroverse radiant emergent <owner/repo> --mind-palace .\` against
+   the repo you want read. Radiant compares your stated intent (these
+   files) to your observed activity (GitHub) and names the gap.
+
+Edit freely. These files are yours.
+`,
+      "attention.md": `# Attention
+
+<!--
+What are you focused on RIGHT NOW? One paragraph. Updated as you shift.
+This is the file an AI agent reads at the start of a session to know
+what to help with today.
+-->
+
+`,
+      "goals.md": `# Goals
+
+<!--
+What are you working toward? Bullet points welcome.
+Longer horizon than attention \u2014 months, not days.
+-->
+
+-
+`,
+      "sprint.md": `# Sprint
+
+<!--
+This week's focus. What do you want to ship or finish?
+Keep it short \u2014 five bullets max.
+-->
+
+-
+`,
+      "identity.md": `# Identity
+
+<!--
+Who are you, what do you value, how do you work?
+This is the context an agent needs to not treat you like a stranger
+every time. Write it in your own voice.
+-->
+
+`,
+      "knowledge.md": `# Knowledge
+
+<!--
+Radiant writes accumulated pattern persistence here across reads.
+Leave this file empty on day one \u2014 it fills up as \`radiant emergent\`
+runs accumulate.
+-->
+
+`,
+      "reads/.gitkeep": "",
+      "worldmodels/starter.worldmodel.md": `# Starter Worldmodel
+
+<!--
+Your thinking constitution. Radiant reads this to understand what
+"aligned" and "drift" mean for your work.
+
+The sharper the Aligned/Drift Behaviors, the sharper Radiant's reads.
+When Radiant detects something matching a drift behavior below, it
+labels it with THAT name \u2014 it doesn't invent new ones.
+-->
+
+## Mission
+
+<!-- One sentence. What are you doing in the world? -->
+
+
+## Invariants
+
+<!--
+Non-negotiable rules. If a decision violates one, it's blocked.
+Keep this list short \u2014 3 to 6 items. Each should be a hard no.
+-->
+
+-
+
+## Aligned Behaviors
+
+<!--
+What "on track" looks like. One per line, phrased as a behavior.
+Radiant will use these as canonical pattern names when it sees
+matching evidence in your activity.
+
+Example:
+  - ships partial-but-working features rather than waiting for the full stack
+  - writes decisions down before acting on them
+-->
+
+-
+
+## Drift Behaviors
+
+<!--
+What "off track" looks like. Same format as Aligned.
+When Radiant detects drift, it will label it with these names \u2014 not
+make up new ones.
+
+Example:
+  - shipping pace outruns strategic decision-making
+  - architecture decisions surface without context about why
+-->
+
+-
+
+## Signals
+
+<!--
+Observable quantities you care about. Radiant scores activity
+against these \u2014 5 to 7 is the sweet spot.
+
+Example:
+  - shipping_velocity
+  - decision_ownership
+  - storytelling_cadence
+-->
+
+-
+
+## Decision Priorities
+
+<!--
+When tradeoffs appear, these resolve them. Format: "A > B".
+
+Example:
+  - correctness > speed
+  - clarity > cleverness
+-->
+
+-
+`
+    };
   }
 });
 
@@ -24308,7 +25192,7 @@ Governance:
   neuroverse mcp --world ./world/ --plan plan.json
   neuroverse test --world ./world/ --fuzz --count 50
 `.trim();
-async function main35() {
+async function main36() {
   const args = process.argv.slice(2);
   const command = args[0];
   const subArgs = args.slice(1);
@@ -24359,6 +25243,10 @@ async function main35() {
       const { main: guardMain } = await Promise.resolve().then(() => (init_guard(), guard_exports));
       return guardMain(subArgs);
     }
+    case "audit": {
+      const { main: auditMain } = await Promise.resolve().then(() => (init_audit(), audit_exports));
+      return auditMain(subArgs);
+    }
     case "test": {
       const { main: testMain } = await Promise.resolve().then(() => (init_test(), test_exports));
       return testMain(subArgs);
@@ -24478,7 +25366,7 @@ async function main35() {
     }
   }
 }
-main35().catch((e) => {
+main36().catch((e) => {
   process.stderr.write(`Fatal: ${e}
 `);
   process.exit(3);