nexus-agents 2.59.0 → 2.61.0

package/dist/cli.js

@@ -16,7 +16,7 @@ import "./chunk-6QU4DJYW.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-ZOQQGA3L.js";
+} from "./chunk-KNAPTURC.js";
 import "./chunk-QGZBCD2A.js";
 import {
   AuthHandler,
@@ -142,7 +142,8 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-V2Z7EHSY.js";
+} from "./chunk-TRWIEUI2.js";
+import "./chunk-ED6VQWNG.js";
 import {
   resolveToken
 } from "./chunk-EZXOJZYE.js";
@@ -150,6 +151,7 @@ import {
   CATEGORY_DISPLAY_NAMES,
   DEFAULT_PR_REVIEW_CONFIG
 } from "./chunk-X2M7OF27.js";
+import "./chunk-JKDHWOQL.js";
 import {
   DEFAULT_VOTE_TIMEOUT_MS,
   THRESHOLD_MAP,
@@ -161,7 +163,7 @@ import {
   registerConsensusVoteTool,
   shutdownToolMemory,
   validateTimeout
-} from "./chunk-L3NHOUEX.js";
+} from "./chunk-FEWWXGFE.js";
 import "./chunk-YU4NABXM.js";
 import {
   loadPapersRegistry,
@@ -181,9 +183,9 @@ import "./chunk-V5CGWMYL.js";
 import "./chunk-BC3M4VLP.js";
 import "./chunk-AP2FD37C.js";
 import "./chunk-BQ4YXGGQ.js";
-import "./chunk-ED6VQWNG.js";
 import {
   CustomExpertDefinitionSchema,
+  DATA_SUBDIRECTORIES,
   MAX_SYSTEM_PROMPT_LENGTH,
   VALID_EXPERT_DOMAINS,
   VALID_EXPERT_TIERS,
@@ -199,11 +201,15 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-7USAZET2.js";
+} from "./chunk-NB6IYTMN.js";
 import {
   DEFAULTS
 } from "./chunk-H43PABG4.js";
 import "./chunk-NUBSJGQZ.js";
+import {
+  getNexusDataDir,
+  nexusDataPath
+} from "./chunk-FDNWRZNJ.js";
 import "./chunk-GJVHRJO2.js";
 import "./chunk-7Y36JLES.js";
 import {
@@ -216,7 +222,6 @@ import {
 } from "./chunk-633WH2ML.js";
 import "./chunk-EDGG3RQE.js";
 import "./chunk-PTGBJFSD.js";
-import "./chunk-JKDHWOQL.js";
 import {
   createAllAdapters,
   getAvailableClis,
@@ -1454,14 +1459,14 @@ ${colors.dim}Session ended.${colors.reset}
     });
   });
   rl.prompt();
-  return new Promise((resolve14) => {
+  return new Promise((resolve15) => {
     rl.on("line", (line) => {
       void (async () => {
         try {
           const shouldExit = await processLine(line, session, logger17);
           if (shouldExit) {
             rl.close();
-            resolve14();
+            resolve15();
             return;
           }
         } catch (error) {
@@ -1473,7 +1478,7 @@ ${colors.dim}Session ended.${colors.reset}
       })();
     });
     rl.on("close", () => {
-      resolve14();
+      resolve15();
     });
   });
 }
@@ -4384,7 +4389,6 @@ async function orchestrateCommand(options) {
 // src/cli/session-commands.ts
 import * as fs3 from "fs";
 import * as path2 from "path";
-import * as os from "os";
 
 // src/cli/session-storage-types.ts
 import { z } from "zod";
@@ -4827,7 +4831,7 @@ function createSessionStorage(config) {
 
 // src/cli/session-commands.ts
 function getDefaultDbPath() {
-  return path2.join(os.homedir(), ".nexus-agents", "sessions.db");
+  return nexusDataPath("sessions.db");
 }
 function ensureDbDirectory(dbPath) {
   const dir = path2.dirname(dbPath);
@@ -10674,7 +10678,7 @@ function parseValidationArgs(positionals, format, verbose) {
 }
 
 // src/cli/swe-bench-command.ts
-import * as os2 from "os";
+import * as os from "os";
 import * as path18 from "path";
 function runInfo(options) {
   console.log(`
@@ -10896,7 +10900,7 @@ function parseVariant(arg) {
   if (v === "lite" || v === "verified" || v === "full") return v;
   return "lite";
 }
-var MAX_WORKERS_CAP = Math.min(Math.floor(os2.cpus().length * 0.75), 24);
+var MAX_WORKERS_CAP = Math.min(Math.floor(os.cpus().length * 0.75), 24);
 var VALID_CACHE_LEVELS = /* @__PURE__ */ new Set(["none", "base", "env", "instance"]);
 var BOOLEAN_FLAGS = {
   "--resume": "resume",
@@ -12825,7 +12829,7 @@ function writeResultAndExit(result) {
 
 // src/cli/hooks/hook-router.ts
 async function readStdin() {
-  return new Promise((resolve14, reject) => {
+  return new Promise((resolve15, reject) => {
     let data = "";
     process.stdin.setEncoding("utf8");
     process.stdin.on("readable", () => {
@@ -12836,24 +12840,24 @@ async function readStdin() {
       }
     });
     process.stdin.on("end", () => {
-      resolve14(data);
+      resolve15(data);
     });
     process.stdin.on("error", (err2) => {
       reject(err2);
     });
     if (process.stdin.isTTY) {
-      resolve14("");
+      resolve15("");
     }
   });
 }
 async function readStdinWithTimeout(timeoutMs = 5e3) {
-  return new Promise((resolve14, reject) => {
+  return new Promise((resolve15, reject) => {
     const timeout2 = setTimeout(() => {
       reject(new Error(`Stdin read timeout after ${String(timeoutMs)}ms`));
     }, timeoutMs);
     readStdin().then((data) => {
       clearTimeout(timeout2);
-      resolve14(data);
+      resolve15(data);
     }).catch((err2) => {
       clearTimeout(timeout2);
       reject(err2 instanceof Error ? err2 : new Error(String(err2)));
@@ -12984,10 +12988,8 @@ function setStringOption(options, key, value) {
 }
 
 // src/cli/hooks/handlers/handler-utils.ts
-import { homedir as homedir2 } from "os";
-import { join as join13 } from "path";
 function getDefaultDbPath2() {
-  return join13(homedir2(), ".nexus-agents", "sessions.db");
+  return nexusDataPath("sessions.db");
 }
 var HookEnvVars = {
   /** Override the default database path */
@@ -14171,23 +14173,23 @@ async function demoCommand(subcommand, args, options) {
 
 // src/governance/fitness-score.ts
 import { existsSync as existsSync12, readFileSync as readFileSync6, readdirSync, statSync } from "fs";
-import { join as join14 } from "path";
+import { join as join12 } from "path";
 function findPkgRoot() {
   let dir = import.meta.dirname;
   for (let i = 0; i < 10; i++) {
-    const pkgPath = join14(dir, "package.json");
+    const pkgPath = join12(dir, "package.json");
     if (existsSync12(pkgPath)) {
       const content = readFileSync6(pkgPath, "utf-8");
       if (content.includes('"nexus-agents"')) return dir;
     }
-    dir = join14(dir, "..");
+    dir = join12(dir, "..");
   }
-  return join14(import.meta.dirname, "../..");
+  return join12(import.meta.dirname, "../..");
 }
 var PKG_ROOT = findPkgRoot();
-var SRC_ROOT = join14(PKG_ROOT, "src");
-var REPO_ROOT = join14(PKG_ROOT, "../..");
-var DOCS_ROOT = join14(REPO_ROOT, "docs");
+var SRC_ROOT = join12(PKG_ROOT, "src");
+var REPO_ROOT = join12(PKG_ROOT, "../..");
+var DOCS_ROOT = join12(REPO_ROOT, "docs");
 var DETERMINISM_EXCLUDES = [
   /\.test\.ts$/,
   /\.spec\.ts$/,
@@ -14198,7 +14200,7 @@ function countFiles(dir, pattern) {
   if (!existsSync12(dir)) return 0;
   let count = 0;
   for (const entry of readdirSync(dir)) {
-    const fullPath = join14(dir, entry);
+    const fullPath = join12(dir, entry);
     const stat2 = statSync(fullPath);
     if (stat2.isDirectory() && !entry.startsWith(".")) {
       count += countFiles(fullPath, pattern);
@@ -14223,7 +14225,7 @@ function countPatternInDir(dir, filePattern, contentPattern, excludePatterns) {
   if (!existsSync12(dir)) return 0;
   let count = 0;
   for (const entry of readdirSync(dir)) {
-    const fullPath = join14(dir, entry);
+    const fullPath = join12(dir, entry);
     const stat2 = statSync(fullPath);
     if (stat2.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
       count += countPatternInDir(fullPath, filePattern, contentPattern, excludePatterns);
@@ -14313,7 +14315,7 @@ var FitnessScoreCalculator = class {
   checkCanonicalPaths() {
     const findings = [];
     let score = 20;
-    const routerCount = countFiles(join14(SRC_ROOT, "cli-adapters"), /router\.ts$/);
+    const routerCount = countFiles(join12(SRC_ROOT, "cli-adapters"), /router\.ts$/);
     const ROUTER_COUNT_THRESHOLD = 6;
     if (routerCount > ROUTER_COUNT_THRESHOLD) {
       const excess = routerCount - ROUTER_COUNT_THRESHOLD;
@@ -14329,7 +14331,7 @@ var FitnessScoreCalculator = class {
         )
       );
     }
-    if (existsSync12(join14(SRC_ROOT, "cli-adapters/composite-router.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "cli-adapters/composite-router.ts"))) {
       score += 2;
     } else {
       score -= 3;
@@ -14347,7 +14349,7 @@ var FitnessScoreCalculator = class {
   }
   /** Sub-check for IOrchestrator interface and adapter wiring. */
   checkOrchestratorInterface(score, findings) {
-    const orchPath = join14(SRC_ROOT, "core/types/orchestrator.ts");
+    const orchPath = join12(SRC_ROOT, "core/types/orchestrator.ts");
     if (existsSync12(orchPath) && fileContains(orchPath, /interface IOrchestrator/)) {
       score += 3;
     } else {
@@ -14356,7 +14358,7 @@ var FitnessScoreCalculator = class {
         this.finding("canonicalPaths", "warning", "No IOrchestrator interface in core/types", 2)
       );
     }
-    const adapterPath = join14(SRC_ROOT, "orchestration/orchestrator-adapters.ts");
+    const adapterPath = join12(SRC_ROOT, "orchestration/orchestrator-adapters.ts");
     if (existsSync12(adapterPath) && fileContains(adapterPath, /TechLeadAdapter|PuppeteerAdapter/)) {
       score += 2;
     }
@@ -14446,7 +14448,7 @@ var FitnessScoreCalculator = class {
     } else if (randomCount === 0) {
       score += 2;
     }
-    if (existsSync12(join14(SRC_ROOT, "core/random-provider.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "core/random-provider.ts"))) {
       score += 1;
     }
     const randomUsage = countPatternInDir(
@@ -14480,7 +14482,7 @@ var FitnessScoreCalculator = class {
         )
       );
     }
-    if (existsSync12(join14(SRC_ROOT, "core/time-provider.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "core/time-provider.ts"))) {
       score += 1;
     }
     const timeUsage = countPatternInDir(
@@ -14498,7 +14500,7 @@ var FitnessScoreCalculator = class {
   checkObservability() {
     const findings = [];
     let score = 15;
-    if (existsSync12(join14(SRC_ROOT, "observability/swarm-observer.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "observability/swarm-observer.ts"))) {
       score += 3;
     } else {
       score -= 3;
@@ -14512,7 +14514,7 @@ var FitnessScoreCalculator = class {
         )
       );
     }
-    if (existsSync12(join14(SRC_ROOT, "core/trace.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "core/trace.ts"))) {
       score += 2;
     }
     const loggerCount = countPatternInDir(SRC_ROOT, /\.ts$/, /createLogger\(/g);
@@ -14528,7 +14530,7 @@ var FitnessScoreCalculator = class {
         )
       );
     }
-    if (existsSync12(join14(SRC_ROOT, "audit"))) {
+    if (existsSync12(join12(SRC_ROOT, "audit"))) {
       score += 2;
     }
     return { score: clamp2(score, 15), findings };
@@ -14537,7 +14539,7 @@ var FitnessScoreCalculator = class {
   checkConfigSimplicity() {
     const findings = [];
     let score = 10;
-    const schemaCount = countFiles(join14(SRC_ROOT, "config"), /schema.*\.ts$/);
+    const schemaCount = countFiles(join12(SRC_ROOT, "config"), /schema.*\.ts$/);
     if (schemaCount > 10) {
       score -= 2;
       findings.push(
@@ -14552,10 +14554,10 @@ var FitnessScoreCalculator = class {
     } else {
       score += 1;
     }
-    if (existsSync12(join14(SRC_ROOT, "config/config-loader.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "config/config-loader.ts"))) {
       score += 2;
     }
-    if (existsSync12(join14(SRC_ROOT, "config/config-manager.ts"))) {
+    if (existsSync12(join12(SRC_ROOT, "config/config-manager.ts"))) {
       score += 1;
     }
     return { score: clamp2(score, 10), findings };
@@ -14565,7 +14567,7 @@ var FitnessScoreCalculator = class {
     const findings = [];
     let score = 10;
     const adapterAgentImports = countPatternInDir(
-      join14(SRC_ROOT, "adapters"),
+      join12(SRC_ROOT, "adapters"),
       /\.ts$/,
       /from ['"]\.\.\/agents\//g
     );
@@ -14585,7 +14587,7 @@ var FitnessScoreCalculator = class {
       score += 2;
     }
     const coreMcpImports = countPatternInDir(
-      join14(SRC_ROOT, "core"),
+      join12(SRC_ROOT, "core"),
       /\.ts$/,
       /from ['"]\.\.\/mcp\//g
     );
@@ -14610,7 +14612,7 @@ var FitnessScoreCalculator = class {
   checkOperatorErgonomics() {
     const findings = [];
     let score = 10;
-    const commandCount = countFiles(join14(SRC_ROOT, "cli"), /\.ts$/);
+    const commandCount = countFiles(join12(SRC_ROOT, "cli"), /\.ts$/);
     if (commandCount >= 20) {
       score += 3;
     } else {
@@ -14635,7 +14637,7 @@ var FitnessScoreCalculator = class {
       ["cli/config-command.ts", "Config command", 1]
     ];
     for (const [path23, name, bonus] of commands) {
-      if (existsSync12(join14(SRC_ROOT, path23))) {
+      if (existsSync12(join12(SRC_ROOT, path23))) {
         score += bonus;
       } else {
         findings.push(this.finding("operatorErgonomics", "info", `Missing ${name} (${path23})`, 0));
@@ -14653,7 +14655,7 @@ var FitnessScoreCalculator = class {
   }
   /** Sub-check for governance documentation artifacts. */
   checkGovernanceDocs(score, findings) {
-    if (!existsSync12(join14(REPO_ROOT, "CLAUDE.md"))) {
+    if (!existsSync12(join12(REPO_ROOT, "CLAUDE.md"))) {
       score -= 3;
       findings.push(
         this.finding("governanceIntegration", "critical", "No CLAUDE.md governance document", 3)
@@ -14661,10 +14663,10 @@ var FitnessScoreCalculator = class {
     } else {
       score += 1;
     }
-    if (existsSync12(join14(DOCS_ROOT, "architecture/wiring-graph.json"))) {
+    if (existsSync12(join12(DOCS_ROOT, "architecture/wiring-graph.json"))) {
       score += 1;
     }
-    if (existsSync12(join14(DOCS_ROOT, "adr"))) {
+    if (existsSync12(join12(DOCS_ROOT, "adr"))) {
       score += 1;
     } else {
       findings.push(this.finding("governanceIntegration", "info", "No ADR directory", 0));
@@ -14673,7 +14675,7 @@ var FitnessScoreCalculator = class {
   }
   /** Sub-check for governance runtime infrastructure. */
   checkGovernanceInfra(score, findings) {
-    const hasPolicyFirewall = countPatternInDir(join14(SRC_ROOT, "security"), /\.ts$/, /PolicyGate|policyFirewall/g) > 0;
+    const hasPolicyFirewall = countPatternInDir(join12(SRC_ROOT, "security"), /\.ts$/, /PolicyGate|policyFirewall/g) > 0;
     if (hasPolicyFirewall) {
       score += 1;
     } else {
@@ -17652,66 +17654,212 @@ var PARSE_ARGS_CONFIG = {
     },
     source: {
       type: "string"
+    },
+    // init --portable command options (#2305)
+    portable: {
+      type: "boolean",
+      default: false
+    },
+    gitignore: {
+      type: "boolean",
+      default: false
     }
   },
   allowPositionals: true,
   strict: true
 };
+var VALID_COMMANDS = [
+  "server",
+  "help",
+  "version",
+  "hello",
+  "config",
+  "expert",
+  "workflow",
+  "doctor",
+  "verify",
+  "review",
+  "routing-audit",
+  "orchestrate",
+  "system-review",
+  "vote",
+  "index",
+  "research",
+  "validation",
+  "learning-metrics",
+  "swe-bench",
+  "atbench",
+  "setup",
+  "hooks",
+  "demo",
+  "sprint",
+  "session",
+  "evaluate",
+  "issue",
+  "fitness-audit",
+  "release-notes",
+  "release-validate",
+  "release-announce",
+  "scaffold",
+  "visualize",
+  "capabilities",
+  "status",
+  "memory-benchmark",
+  "auth",
+  "scenario",
+  "warm-up",
+  "e2e-eval",
+  "routing-ab",
+  "memory-eval",
+  "health",
+  "init",
+  "validate",
+  "registry"
+];
 function isValidCommand(value) {
-  const validCommands = [
-    "server",
-    "help",
-    "version",
-    "hello",
-    "config",
-    "expert",
-    "workflow",
-    "doctor",
-    "verify",
-    "review",
-    "routing-audit",
-    "orchestrate",
-    "system-review",
-    "vote",
-    "index",
-    "research",
-    "validation",
-    "learning-metrics",
-    "swe-bench",
-    "atbench",
-    "setup",
-    "hooks",
-    "demo",
-    "sprint",
-    "session",
-    "evaluate",
-    "issue",
-    "fitness-audit",
-    "release-notes",
-    "release-validate",
-    "release-announce",
-    "scaffold",
-    "visualize",
-    "capabilities",
-    "status",
-    "memory-benchmark",
-    "auth",
-    "scenario",
-    "warm-up",
-    "e2e-eval",
-    "routing-ab",
-    "memory-eval",
-    "health",
-    "validate",
-    "registry"
-  ];
-  return validCommands.includes(value);
+  return VALID_COMMANDS.includes(value);
 }
 
 // src/cli-commands-handlers.ts
-import { existsSync as existsSync18 } from "fs";
-import { join as join16 } from "path";
-import { homedir as homedir4 } from "os";
+import { existsSync as existsSync19 } from "fs";
+
+// src/cli/init-portable.ts
+import {
+  existsSync as existsSync17,
+  mkdirSync as mkdirSync3,
+  readdirSync as readdirSync2,
+  statSync as statSync3,
+  appendFileSync,
+  readFileSync as readFileSync10
+} from "fs";
+import { resolve as resolve11, join as join13, isAbsolute as isAbsolute2 } from "path";
+var DEFAULT_PORTABLE_DIRNAME = ".nexus-agents";
+var RESTRICTED_SUBDIRS = /* @__PURE__ */ new Set(["auth"]);
+function resolveTargetPath(rawPath) {
+  if (rawPath === void 0 || rawPath === "") {
+    return resolve11(process.cwd(), DEFAULT_PORTABLE_DIRNAME);
+  }
+  return isAbsolute2(rawPath) ? rawPath : resolve11(process.cwd(), rawPath);
+}
+function isNonEmpty(dir) {
+  if (!existsSync17(dir)) return false;
+  const stat2 = statSync3(dir);
+  if (!stat2.isDirectory()) return true;
+  return readdirSync2(dir).length > 0;
+}
+function ensureDir(path23, dryRun, created, alreadyExisted, mode) {
+  if (existsSync17(path23)) {
+    alreadyExisted.push(path23);
+    return;
+  }
+  if (!dryRun) {
+    mkdirSync3(path23, { recursive: true, ...mode !== void 0 ? { mode } : {} });
+  }
+  created.push(path23);
+}
+function maybeUpdateGitignore(workspaceDir, portableDirName, dryRun) {
+  const gitDir = join13(workspaceDir, ".git");
+  if (!existsSync17(gitDir)) return false;
+  const gitignorePath = join13(workspaceDir, ".gitignore");
+  const entry = `${portableDirName}/`;
+  let existing = "";
+  if (existsSync17(gitignorePath)) {
+    existing = readFileSync10(gitignorePath, "utf-8");
+    if (existing.split("\n").some((l) => l.trim() === entry || l.trim() === portableDirName)) {
+      return false;
+    }
+  }
+  if (!dryRun) {
+    const sep3 = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    appendFileSync(gitignorePath, `${sep3}${entry}
+`, "utf-8");
+  }
+  return true;
+}
+function inspectTarget(target) {
+  const exists = existsSync17(target);
+  if (!exists) return { exists: false, nonEmpty: false, isExistingNexusDir: false };
+  const nonEmpty = isNonEmpty(target);
+  const stat2 = statSync3(target);
+  const isExistingNexusDir = stat2.isDirectory() && existsSync17(join13(target, "audit"));
+  return { exists, nonEmpty, isExistingNexusDir };
+}
+function createDataLayout(target, dryRun, created, alreadyExisted) {
+  ensureDir(target, dryRun, created, alreadyExisted);
+  for (const subdir of DATA_SUBDIRECTORIES) {
+    const mode = RESTRICTED_SUBDIRS.has(subdir) ? 448 : void 0;
+    ensureDir(join13(target, subdir), dryRun, created, alreadyExisted, mode);
+  }
+}
+function makeResult(opts) {
+  return {
+    success: opts.success,
+    absolutePath: opts.absolutePath,
+    created: opts.created,
+    alreadyExisted: opts.alreadyExisted,
+    skipped: opts.skipped ?? false,
+    gitignoreUpdated: opts.gitignoreUpdated ?? false,
+    error: opts.error ?? null
+  };
+}
+function applyGitignoreOption(target, options, dryRun) {
+  if (options.gitignore !== true) return false;
+  const workspaceDir = resolve11(target, "..");
+  const portableName = target.slice(workspaceDir.length + 1);
+  return maybeUpdateGitignore(workspaceDir, portableName, dryRun);
+}
+function initPortable(options = {}) {
+  const created = [];
+  const alreadyExisted = [];
+  const dryRun = options.dryRun === true;
+  const force = options.force === true;
+  const target = resolveTargetPath(options.path);
+  const base = { absolutePath: target, created, alreadyExisted };
+  try {
+    const state = inspectTarget(target);
+    if (state.isExistingNexusDir && !force) {
+      createDataLayout(target, dryRun, created, alreadyExisted);
+      return makeResult({ ...base, success: true, skipped: true });
+    }
+    if (state.nonEmpty && !state.isExistingNexusDir && !force) {
+      const error = `target ${target} already exists and is not empty; pass --force to use anyway`;
+      return makeResult({ ...base, success: false, error });
+    }
+    createDataLayout(target, dryRun, created, alreadyExisted);
+    const gitignoreUpdated = applyGitignoreOption(target, options, dryRun);
+    return makeResult({ ...base, success: true, gitignoreUpdated });
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return makeResult({ ...base, success: false, error: msg });
+  }
+}
+function formatInitPortableMessage(result, dryRun) {
+  if (!result.success) {
+    return `init --portable failed: ${result.error ?? "unknown error"}
+`;
+  }
+  const lines = [];
+  if (dryRun) {
+    lines.push(`(dry-run) would create ${String(result.created.length)} entries under:`);
+    lines.push(`  ${result.absolutePath}`);
+    return lines.join("\n") + "\n";
+  }
+  if (result.skipped) {
+    lines.push(`\u2713 Already initialized: ${result.absolutePath}`);
+  } else {
+    lines.push(`\u2713 Created: ${result.absolutePath}`);
+  }
+  if (result.gitignoreUpdated) {
+    lines.push(`\u2713 Added entry to .gitignore`);
+  }
+  lines.push("");
+  lines.push("Activate by exporting:");
+  lines.push(`  export NEXUS_DATA_DIR=${result.absolutePath}`);
+  lines.push("");
+  lines.push("Or one-off:");
+  lines.push(`  NEXUS_DATA_DIR=${result.absolutePath} nexus-agents <cmd>`);
+  return lines.join("\n") + "\n";
+}
 
 // src/mcp/tools/dev-pipeline-tool.ts
 import { z as z9 } from "zod";
@@ -18669,7 +18817,7 @@ function logFinalEventBusStats(logger17) {
 // src/cli-orchestrator.ts
 import * as readline2 from "readline";
 function runOrchestratorRepl(options, logger17) {
-  return new Promise((resolve14) => {
+  return new Promise((resolve15) => {
     const rl = readline2.createInterface({
       input: process.stdin,
       output: process.stdout,
@@ -18705,7 +18853,7 @@ function runOrchestratorRepl(options, logger17) {
     });
     rl.on("close", () => {
       logger17.info("Orchestrator REPL closed");
-      resolve14();
+      resolve15();
     });
   });
 }
@@ -19894,9 +20042,7 @@ function initializeAuth(config, logger17) {
 }
 
 // src/cli-server-audit.ts
-import { join as join15 } from "path";
-import { homedir as homedir3 } from "os";
-var DEFAULT_AUDIT_DIR = join15(homedir3(), ".nexus-agents", "audit");
+var DEFAULT_AUDIT_DIR = nexusDataPath("audit");
 function initializeAuditLogger(securityConfig, logger17) {
   if (securityConfig?.audit?.enabled !== true) {
     logger17.debug("Audit logging disabled (set security.audit.enabled: true to enable)");
@@ -20525,9 +20671,9 @@ function buildOrchestratorOptions(args) {
 function printFirstRunHint() {
   const isTTY = process.stderr.isTTY;
   if (!isTTY) return;
-  const dataDir = join16(homedir4(), ".nexus-agents");
-  const hasConfig = existsSync18("./nexus-agents.yaml") || existsSync18("./nexus-agents.yml");
-  if (existsSync18(dataDir) || hasConfig) return;
+  const dataDir = getNexusDataDir();
+  const hasConfig = existsSync19("./nexus-agents.yaml") || existsSync19("./nexus-agents.yml");
+  if (existsSync19(dataDir) || hasConfig) return;
   process.stderr.write(
     "\n\x1B[36mnexus-agents\x1B[0m: First time? Run \x1B[1mnexus-agents setup\x1B[0m to configure.\n\n"
   );
@@ -20639,7 +20785,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-S46JJ2SX.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-TTXAUCOK.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20693,6 +20839,23 @@ async function handleDoctorCommand(args) {
   }
   process.exit(exitCode === 0 ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
+function handleInitCommand(args) {
+  if (args.options.portable !== true) {
+    process.stderr.write(
+      "Usage: nexus-agents init --portable [path] [--force] [--dry-run] [--gitignore]\nBootstraps a workspace-local nexus-agents data directory.\n"
+    );
+    process.exit(EXIT_CODES.INVALID_ARGS);
+  }
+  const targetPath = args.positionals[1];
+  const result = initPortable({
+    ...targetPath !== void 0 && targetPath !== "" ? { path: targetPath } : {},
+    force: args.options.force,
+    dryRun: args.options.dryRun,
+    gitignore: args.options.gitignore ?? false
+  });
+  process.stdout.write(formatInitPortableMessage(result, args.options.dryRun));
+  process.exit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
+}
 async function handleSetupCommandAsync(args) {
   if (args.options.customApi !== void 0 && args.options.customApi !== "") {
     const exitCode2 = await runCustomApiSetup(args);
@@ -22166,7 +22329,7 @@ function handleStatusCommand2(args) {
 
 // src/cli/scenario-command.ts
 import { readdir as readdir4 } from "fs/promises";
-import { join as join18, resolve as resolve13 } from "path";
+import { join as join15, resolve as resolve14 } from "path";
 
 // src/testing/e2e/scenario-runner.ts
 import { readFile as readFile7 } from "fs/promises";
@@ -22326,7 +22489,7 @@ function checkCircularDependencies(workflow) {
 var defaultStubFactory = {
   createAgentStub(agentType, action) {
     return async (inputs) => {
-      await new Promise((resolve14) => setTimeout(resolve14, 10));
+      await new Promise((resolve15) => setTimeout(resolve15, 10));
       return {
         stepId: `${agentType}-${action}`,
         status: "success",
@@ -22485,7 +22648,7 @@ function createScenarioRunner(stubFactory) {
 }
 
 // src/cli/scenario-command.ts
-var FIXTURES_DIR = resolve13(import.meta.dirname, "../testing/e2e/fixtures");
+var FIXTURES_DIR = resolve14(import.meta.dirname, "../testing/e2e/fixtures");
 var SCENARIO_SUFFIX = ".scenario.yaml";
 async function listScenarios() {
   try {
@@ -22536,7 +22699,7 @@ async function handleRun(args) {
     process.exit(EXIT_CODES.SERVER_START_FAILED);
   }
   const runner = createScenarioRunner();
-  const fixturePath = join18(FIXTURES_DIR, `${name}${SCENARIO_SUFFIX}`);
+  const fixturePath = join15(FIXTURES_DIR, `${name}${SCENARIO_SUFFIX}`);
   try {
     const fixture = await runner.loadFixture(fixturePath);
     const result = await runner.run(fixture);
@@ -22799,6 +22962,8 @@ var SYNC_COMMAND_HANDLERS = {
   status: handleStatusCommand2,
   // Issue #1023: Warm-Up Command
   "warm-up": handleWarmUpCommand,
+  // #2305: Init Portable Command
+  init: handleInitCommand,
   "e2e-eval": handleE2EEvalCommand,
   "routing-ab": handleRoutingABCommand,
   "memory-eval": handleMemoryEvalCommand,