@neuroverseos/governance 0.8.1 → 0.10.0

package/dist/cli/radiant.d.cts

@@ -20,6 +20,49 @@
  *   RADIANT_WORLDS    — default worlds directory (overridden by --worlds)
  *   RADIANT_LENS      — default lens id (overridden by --lens)
  */
+interface ParsedArgs {
+    subcommand: string | undefined;
+    lens: string | undefined;
+    worlds: string | undefined;
+    query: string | undefined;
+    model: string | undefined;
+    exocortex: string | undefined;
+    teamExocortex: string | undefined;
+    view: string | undefined;
+    user: string | undefined;
+    personal: boolean;
+    entireOrg: boolean;
+    json: boolean;
+    help: boolean;
+    force: boolean;
+    rest: string[];
+}
+declare function parseArgs(argv: string[]): ParsedArgs;
+interface ScopeConsentInput {
+    scope: {
+        type: 'org' | 'repo';
+        owner: string;
+    };
+    personal: boolean;
+    entireOrg: boolean;
+    resolvedUser: string | undefined;
+}
+type ScopeConsentResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'personal_requires_user' | 'org_requires_opt_in';
+};
+/**
+ * Consent-first gate. Org-wide scopes observe every contributor across
+ * every repo — a global-observer stance that's opt-in, not the default.
+ * Personal mode requires a user to filter to.
+ *
+ *   personal without user  → reject (need --user or RADIANT_USER)
+ *   org scope without --entire-org and without --personal → reject
+ *   everything else → pass
+ */
+declare function checkScopeConsent(input: ScopeConsentInput): ScopeConsentResult;
 declare function main(argv: string[]): Promise<void>;
 
-export { main };
+export { type ScopeConsentInput, type ScopeConsentResult, checkScopeConsent, main, parseArgs };

package/dist/cli/radiant.d.ts

@@ -20,6 +20,49 @@
  *   RADIANT_WORLDS    — default worlds directory (overridden by --worlds)
  *   RADIANT_LENS      — default lens id (overridden by --lens)
  */
+interface ParsedArgs {
+    subcommand: string | undefined;
+    lens: string | undefined;
+    worlds: string | undefined;
+    query: string | undefined;
+    model: string | undefined;
+    exocortex: string | undefined;
+    teamExocortex: string | undefined;
+    view: string | undefined;
+    user: string | undefined;
+    personal: boolean;
+    entireOrg: boolean;
+    json: boolean;
+    help: boolean;
+    force: boolean;
+    rest: string[];
+}
+declare function parseArgs(argv: string[]): ParsedArgs;
+interface ScopeConsentInput {
+    scope: {
+        type: 'org' | 'repo';
+        owner: string;
+    };
+    personal: boolean;
+    entireOrg: boolean;
+    resolvedUser: string | undefined;
+}
+type ScopeConsentResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'personal_requires_user' | 'org_requires_opt_in';
+};
+/**
+ * Consent-first gate. Org-wide scopes observe every contributor across
+ * every repo — a global-observer stance that's opt-in, not the default.
+ * Personal mode requires a user to filter to.
+ *
+ *   personal without user  → reject (need --user or RADIANT_USER)
+ *   org scope without --entire-org and without --personal → reject
+ *   everything else → pass
+ */
+declare function checkScopeConsent(input: ScopeConsentInput): ScopeConsentResult;
 declare function main(argv: string[]): Promise<void>;
 
-export { main };
+export { type ScopeConsentInput, type ScopeConsentResult, checkScopeConsent, main, parseArgs };

package/dist/cli/radiant.js

@@ -1,23 +1,26 @@
 import {
   createAnthropicAI,
+  discoverWorlds,
   emergent,
+  formatActiveWorlds,
   parseScope,
   readExocortex,
   summarizeExocortex,
   think
-} from "../chunk-ETDIEVAX.js";
+} from "../chunk-BZYQHJDM.js";
 import {
   listLenses
-} from "../chunk-F2LWMOM5.js";
+} from "../chunk-TCGGED4G.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 { readFileSync, readdirSync, statSync, existsSync, mkdirSync, writeFileSync } from "fs";
 import { resolve, join, extname } from "path";
 var RED = "\x1B[31m";
+var GREEN = "\x1B[32m";
 var DIM = "\x1B[2m";
 var BOLD = "\x1B[1m";
 var YELLOW = "\x1B[33m";
@@ -25,6 +28,9 @@ var RESET = "\x1B[0m";
 var USAGE = `
 ${BOLD}neuroverse radiant${RESET} \u2014 behavioral intelligence for collaboration systems
 
+${BOLD}Setup:${RESET}
+  init           Scaffold a Mind Palace in the current directory
+
 ${BOLD}Stage A (voice layer):${RESET}
   think          Send a query through the worldmodel + lens \u2192 AI-framed response
 
@@ -35,19 +41,46 @@ ${BOLD}Stage B (behavioral analysis, coming soon):${RESET}
   lenses         List or describe available rendering lenses
 
 ${BOLD}Usage:${RESET}
+  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
 
+${BOLD}Read modes:${RESET}
+  ${BOLD}Default (team):${RESET} reads all contributors in the given scope.
+  ${BOLD}--personal --user <login>:${RESET} 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.
+  ${BOLD}--entire-org (gated):${RESET} 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).
+
+${BOLD}Auto-discovery:${RESET}
+  You do not need to clone the target repo.
+
+    radiant emergent NeuroverseOS/       \u2192 probes github.com/NeuroverseOS/worlds
+    radiant emergent aukiverse/posemesh  \u2192 probes github.com/aukiverse/worlds
+
+  The scope argument itself is enough. Discovery also picks up
+  ~/.neuroverse/worlds/ (personal), the org from your current clone's
+  .git/config (if any), and ./worlds/ (this repo).
+
+  Set NEUROVERSE_NO_ORG=1 to disable org probing for a single run.
+
 ${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)
+  RADIANT_USER         Default personal-mode user (overridden by --user)
 `.trim();
 function parseArgs(argv) {
   const result = {
@@ -59,8 +92,12 @@ function parseArgs(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;
@@ -92,9 +129,22 @@ function parseArgs(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;
@@ -133,20 +183,48 @@ ${content}`;
   }
   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) {
+function resolveWorldmodelContent(explicitPath, scopeOwner) {
+  if (explicitPath) {
+    return loadWorldmodelContent(explicitPath);
+  }
+  const stack = discoverWorlds({
+    repoDir: process.cwd(),
+    scopeOwner
+  });
+  if (stack.worlds.length === 0) {
+    const scopeLine = scopeOwner ? `  3. github:${scopeOwner}/worlds (from scope arg)
+` : "";
+    const ext = scopeOwner ? 4 : 3;
+    const repo = scopeOwner ? 5 : 4;
     process.stderr.write(
-      `${RED}Error:${RESET} --lens <id> or RADIANT_LENS required.
-${DIM}Available lenses: ${listLenses().join(", ")}${RESET}
+      `${RED}Error:${RESET} No worldmodel found.
+${DIM}Tried (in order):
+  1. ~/.neuroverse/worlds/              (user tier)
+  2. github:<owner>/worlds              (org auto-detect from git remote)
+` + scopeLine + `  ${ext}. .neuroverse/config.json extends    (explicit shared worlds)
+  ${repo}. ./worlds/ or ./.neuroverse/worlds/ (repo tier)
+
+Pass --worlds <dir> or set RADIANT_WORLDS to specify explicitly.
+Or run against a <scope>/ where github.com/<scope>/worlds exists.${RESET}
 `
     );
     process.exit(1);
   }
-  const worldsPath = args.worlds ?? process.env.RADIANT_WORLDS;
-  if (!worldsPath) {
+  process.stderr.write(`${DIM}${formatActiveWorlds(stack)}${RESET}
+
+`);
+  for (const warning of stack.warnings) {
+    process.stderr.write(`${YELLOW}\u26A0${RESET}  ${warning}
+`);
+  }
+  return stack.combinedContent;
+}
+async function cmdThink(args) {
+  const lensId = args.lens ?? process.env.RADIANT_LENS;
+  if (!lensId) {
     process.stderr.write(
-      `${RED}Error:${RESET} --worlds <dir> or RADIANT_WORLDS required.
+      `${RED}Error:${RESET} --lens <id> or RADIANT_LENS required.
+${DIM}Available lenses: ${listLenses().join(", ")}${RESET}
 `
     );
     process.exit(1);
@@ -175,12 +253,12 @@ ${DIM}Use --query "...", pass as trailing args, or pipe via stdin.${RESET}
     );
     process.exit(1);
   }
-  const worldmodelContent = loadWorldmodelContent(worldsPath);
+  const explicitWorldsPath = args.worlds ?? process.env.RADIANT_WORLDS;
+  const worldmodelContent = resolveWorldmodelContent(explicitWorldsPath);
   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}Lens:   ${lensId}${RESET}
 ${DIM}Model:  ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET}
 
 `
@@ -224,6 +302,15 @@ ${DIM}Model:  ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET}
     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) {
@@ -234,19 +321,48 @@ 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(
+        `${RED}Error:${RESET} --personal requires a GitHub username.
+${DIM}Pass --user <login> or set RADIANT_USER. Radiant will read
+only that user's activity \u2014 no one else is observed.${RESET}
+`
+      );
+    } else {
+      process.stderr.write(
+        `${YELLOW}\u26A0${RESET}  ${BOLD}"${scope.owner}" is an org-wide scope.${RESET}
+
+${DIM}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.${RESET}
+
+Three ways forward:
+  ${GREEN}1.${RESET} Scope to a single repo (recommended default):
+       radiant emergent ${scope.owner}/<repo>
+
+  ${GREEN}2.${RESET} Read only your own activity (personal mode):
+       radiant emergent ${scope.owner}/ --personal --user <your-login>
+
+  ${GREEN}3.${RESET} 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(
       `${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);
@@ -268,7 +384,11 @@ ${DIM}Set it to a GitHub PAT with repo read access.${RESET}
     );
     process.exit(1);
   }
-  const worldmodelContent = loadWorldmodelContent(worldsPath);
+  const explicitWorldsPath = args.worlds ?? process.env.RADIANT_WORLDS;
+  const worldmodelContent = resolveWorldmodelContent(
+    explicitWorldsPath,
+    scope.owner
+  );
   const model = args.model ?? process.env.RADIANT_MODEL;
   const ai = createAnthropicAI(anthropicKey, model || void 0);
   const view = args.view ?? process.env.RADIANT_VIEW ?? "community";
@@ -286,8 +406,11 @@ ${DIM}Set it to a GitHub PAT with repo read access.${RESET}
     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(
-    `${DIM}Scope:      ${scope.type === "org" ? scope.owner + " (entire org)" : scope.owner + "/" + scope.repo}${RESET}
+    `${DIM}Scope:      ${scopeLabel}${RESET}
+${DIM}Mode:       ${modeLabel}${RESET}
 ${DIM}View:       ${view}${RESET}
 ${DIM}Lens:       ${lensId}${RESET}
 ${DIM}Model:      ${model ?? "claude-sonnet-4-20250514 (default)"}${RESET}
@@ -303,7 +426,8 @@ ${DIM}Fetching activity...${RESET}
     lensId,
     ai,
     windowDays: 14,
-    exocortexPath: exocortexPath || void 0
+    exocortexPath: exocortexPath || void 0,
+    personalUser: args.personal ? personalUser : void 0
   });
   if (!result.voiceClean) {
     process.stderr.write(
@@ -351,7 +475,7 @@ async function cmdLenses(args) {
     return;
   }
   if (subSub === "describe") {
-    const { getLens } = await import("../lenses-YDMKSXDL.js");
+    const { getLens } = await import("../lenses-XDWK6ZKI.js");
     const id = args.rest[1];
     if (!id) {
       process.stderr.write(`${RED}Error:${RESET} Lens id required.
@@ -405,6 +529,204 @@ ${DIM}Use: lenses list | lenses describe <id>${RESET}
   );
   process.exit(1);
 }
+var 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
+-->
+
+-
+`
+};
+async function cmdInit(args) {
+  const targetDir = resolve(args.rest[0] ?? "./mind-palace");
+  const existed = existsSync(targetDir);
+  if (existed && !args.force) {
+    const entries = readdirSync(targetDir);
+    if (entries.length > 0) {
+      process.stderr.write(
+        `${RED}Error:${RESET} ${targetDir} already exists and is not empty.
+${DIM}Use --force to write into it anyway (existing files will be overwritten).${RESET}
+`
+      );
+      process.exit(1);
+    }
+  }
+  mkdirSync(targetDir, { recursive: true });
+  mkdirSync(join(targetDir, "reads"), { recursive: true });
+  mkdirSync(join(targetDir, "worldmodels"), { recursive: true });
+  for (const [relPath, content] of Object.entries(MIND_PALACE_FILES)) {
+    const fullPath = join(targetDir, relPath);
+    mkdirSync(resolve(fullPath, ".."), { recursive: true });
+    writeFileSync(fullPath, content, "utf-8");
+  }
+  process.stdout.write(
+    `${GREEN}\u2713${RESET} Mind Palace scaffolded at ${BOLD}${targetDir}${RESET}
+
+${DIM}Next steps:${RESET}
+  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}
+
+${DIM}Files are yours. Edit freely.${RESET}
+`
+  );
+}
 async function main(argv) {
   const args = parseArgs(argv);
   if (args.help || !args.subcommand) {
@@ -412,6 +734,8 @@ async function main(argv) {
     return;
   }
   switch (args.subcommand) {
+    case "init":
+      return cmdInit(args);
     case "think":
       return cmdThink(args);
     case "lenses":
@@ -419,7 +743,7 @@ async function main(argv) {
     case "emergent":
       return cmdEmergent(args);
     case "mcp": {
-      const { startRadiantMcp } = await import("../server-ZSQ6DRSN.js");
+      const { startRadiantMcp } = await import("../server-EI5JCIBU.js");
       return startRadiantMcp(argv);
     }
     case "decision":
@@ -443,5 +767,7 @@ async function main(argv) {
   }
 }
 export {
-  main
+  checkScopeConsent,
+  main,
+  parseArgs
 };