nexus-agents 4.11.0 → 4.11.1

package/dist/chunk-WPLXWTUK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/cli-detection-error.ts","../src/cli/setup-cli-detection.ts"],"sourcesContent":["/**\n * nexus-agents/cli - CLI detection error classification (#2152)\n *\n * Small helper shared by `setup-codex.ts`, `setup-gemini.ts`, `setup-opencode.ts`\n * (and later `setup-cli-detection.ts` once #2155 consolidates them) so that a\n * `which`/`where` or `<cli> --version` failure is classified instead of\n * silently collapsed into `installed: false`.\n *\n * Before this file, all three setup modules did `catch { return { installed: false } }`,\n * treating `ENOENT` (genuinely not installed), `ETIMEDOUT` (PATH lookup hung),\n * `EACCES` (binary present but not executable), and arbitrary other exec\n * failures identically. That made doctor/verify diagnostics unactionable.\n *\n * @module cli/cli-detection-error\n */\n\n/**\n * Stable classification of why a CLI-detection exec failed.\n *\n * - `not-found`: binary is not on PATH (`ENOENT`). User action: install the CLI.\n * - `timeout`: the exec hung past the configured timeout (`ETIMEDOUT`,\n *   `exit code null with signal`). User action: investigate PATH for hung\n *   filesystems (NFS mounts, dead autofs entries).\n * - `permission`: binary is present but the current user can't execute it\n *   (`EACCES`, `EPERM`). User action: fix mode bits or ownership.\n * - `other`: any other exec failure. User action: re-run with verbose\n *   logging or inspect stderr directly.\n */\nexport type DetectionError = 'not-found' | 'timeout' | 'permission' | 'other';\n\n/**\n * Human-readable explanation for each detection-error class. Intended for\n * `doctor`/`verify` output — short enough to fit on one line next to the CLI\n * name.\n */\nexport const DETECTION_ERROR_MESSAGES: Record<DetectionError, string> = {\n  'not-found': 'binary not on PATH',\n  timeout: 'detection timed out (hung PATH?)',\n  permission: 'binary present but not executable',\n  other: 'detection failed — check verbose logs',\n};\n\n/**\n * Formats a user-facing \"not installed\" message that incorporates the\n * detection-error class. Called by setup runners to replace the flat\n * \"<cli> not installed\" message when the underlying cause is more specific.\n *\n * - `not-found` or undefined → \"<cli> not installed\"\n * - other classes → \"<cli> detection failed: <class-message>\"\n */\nexport function formatDetectionMessage(cliName: string, detectionError?: DetectionError): string {\n  if (detectionError === undefined || detectionError === 'not-found') {\n    return `${cliName} not installed`;\n  }\n  return `${cliName} detection failed: ${DETECTION_ERROR_MESSAGES[detectionError]}`;\n}\n\n/**\n * Actionable recovery step for each detection-error class (#3213). Each takes\n * the CLI's **binary** name (e.g. `opencode`, not the display name) so the\n * suggested command is runnable verbatim. Intended to be shown alongside the\n * `formatDetectionMessage` line on setup/doctor failures.\n */\nexport const DETECTION_ERROR_SOLUTIONS: Record<DetectionError, (cliBinary: string) => string> = {\n  'not-found': (cli) =>\n    `Install ${cli} and make sure it is on your PATH — see docs/getting-started/INSTALLATION.md.`,\n  permission: (cli) =>\n    `The ${cli} binary is present but not executable. Run: chmod +x \"$(command -v ${cli})\"`,\n  timeout: (cli) =>\n    `${cli} detection timed out. Check PATH for hung mounts (e.g. NFS); re-run with --verbose to see where detection hangs.`,\n  other: (cli) => `Re-run with --verbose for detailed ${cli} detection logs.`,\n};\n\n/**\n * One-line actionable recovery hint for a detection error, with a docs pointer.\n * `cliBinary` is the runnable binary name (e.g. `gemini`); defaults the class to\n * `not-found` when unclassified.\n */\nexport function detectionRecoveryHint(cliBinary: string, detectionError?: DetectionError): string {\n  const cls: DetectionError = detectionError ?? 'not-found';\n  return `${DETECTION_ERROR_SOLUTIONS[cls](cliBinary)} (more: docs/TROUBLESHOOTING.md)`;\n}\n\n/**\n * Classifies a thrown error from `execFileSync('which'|'where', ...)` or\n * `execFileSync(cli, ['--version'])`.\n *\n * Node's `execFileSync` throws with a `code` property on the error object\n * (string like `'ENOENT'`) for most OS-level failures. Timeouts additionally\n * set `signal: 'SIGTERM'` and may have `code: undefined`. We probe both.\n */\nexport function classifyExecError(err: unknown): DetectionError {\n  if (typeof err !== 'object' || err === null) return 'other';\n\n  // Duck-type rather than instanceof — execFileSync errors aren't always\n  // `Error` instances across Node versions and test harnesses.\n  const e = err as { code?: unknown; signal?: unknown; killed?: unknown };\n\n  if (e.code === 'ENOENT') return 'not-found';\n  if (e.code === 'ETIMEDOUT') return 'timeout';\n  if (e.killed === true || e.signal === 'SIGTERM' || e.signal === 'SIGKILL') {\n    // execFileSync sets `killed: true` + SIGTERM when its own timeout fires.\n    return 'timeout';\n  }\n  if (e.code === 'EACCES' || e.code === 'EPERM') return 'permission';\n\n  return 'other';\n}\n","/**\n * Shared CLI binary detection helpers (#2155, child of #2151).\n *\n * Consolidates the near-identical detection logic that previously lived in\n * `setup-codex.ts`, `setup-gemini.ts`, and `setup-opencode.ts`. Each setup\n * file now delegates to `detectCliBinary(name)` instead of carrying its\n * own copy of the platform-aware locator + version-extraction logic.\n *\n * The per-CLI `ConfigResult` interfaces remain separate because they\n * legitimately differ (Codex writes via MCP, Gemini and OpenCode write to\n * config files with paths).\n *\n * @module cli/setup-cli-detection\n */\n\nimport { execFileSync } from 'node:child_process';\nimport { platform } from 'node:os';\n\nimport { classifyExecError, type DetectionError } from './cli-detection-error.js';\n\n/** Generic CLI detection result. Consumed by every `setup-*.ts` detector. */\nexport interface CliDetectionInfo {\n  readonly installed: boolean;\n  readonly version: string | undefined;\n  /**\n   * Classification of why detection failed. Set when `installed` is `false`\n   * OR when the binary was located but `--version` failed (#2152).\n   */\n  readonly detectionError?: DetectionError;\n}\n\n/** Returns the platform-appropriate command for locating an executable. */\nexport function getCliLocatorCommand(): 'where' | 'which' {\n  return platform() === 'win32' ? 'where' : 'which';\n}\n\n/**\n * Extracts a semver triple (`X.Y.Z`) from CLI `--version` output.\n *\n * Pure helper — exported for direct unit testing. Returns the matched\n * version string or undefined when no semver-shaped substring is present.\n */\nexport function extractSemver(output: string): string | undefined {\n  const match = /(\\d+\\.\\d+\\.\\d+)/.exec(output);\n  return match?.[1];\n}\n\n/**\n * Detects whether a CLI binary is installed and reports its version.\n *\n * Two-phase detection:\n *   1. Locate via `which` / `where` — fast PATH check (3s timeout).\n *   2. If located, run `<name> --version` and extract semver (5s timeout).\n *\n * Both phases trap `execFileSync` exceptions and return a `CliDetectionInfo`\n * with a classified `detectionError`. Callers never see exceptions from\n * this function.\n */\nexport function detectCliBinary(name: string): CliDetectionInfo {\n  try {\n    execFileSync(getCliLocatorCommand(), [name], { timeout: 3000, stdio: 'pipe' });\n  } catch (err: unknown) {\n    return { installed: false, version: undefined, detectionError: classifyExecError(err) };\n  }\n\n  try {\n    const output = execFileSync(name, ['--version'], {\n      timeout: 5000,\n      stdio: 'pipe',\n      encoding: 'utf-8',\n    });\n    return { installed: true, version: extractSemver(output) };\n  } catch (err: unknown) {\n    return { installed: true, version: undefined, detectionError: classifyExecError(err) };\n  }\n}\n"],"mappings":";AAmCO,IAAM,2BAA2D;AAAA,EACtE,aAAa;AAAA,EACb,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,OAAO;AACT;AAUO,SAAS,uBAAuB,SAAiB,gBAAyC;AAC/F,MAAI,mBAAmB,UAAa,mBAAmB,aAAa;AAClE,WAAO,GAAG,OAAO;AAAA,EACnB;AACA,SAAO,GAAG,OAAO,sBAAsB,yBAAyB,cAAc,CAAC;AACjF;AAQO,IAAM,4BAAmF;AAAA,EAC9F,aAAa,CAAC,QACZ,WAAW,GAAG;AAAA,EAChB,YAAY,CAAC,QACX,OAAO,GAAG,sEAAsE,GAAG;AAAA,EACrF,SAAS,CAAC,QACR,GAAG,GAAG;AAAA,EACR,OAAO,CAAC,QAAQ,sCAAsC,GAAG;AAC3D;AAOO,SAAS,sBAAsB,WAAmB,gBAAyC;AAChG,QAAM,MAAsB,kBAAkB;AAC9C,SAAO,GAAG,0BAA0B,GAAG,EAAE,SAAS,CAAC;AACrD;AAUO,SAAS,kBAAkB,KAA8B;AAC9D,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO;AAIpD,QAAM,IAAI;AAEV,MAAI,EAAE,SAAS,SAAU,QAAO;AAChC,MAAI,EAAE,SAAS,YAAa,QAAO;AACnC,MAAI,EAAE,WAAW,QAAQ,EAAE,WAAW,aAAa,EAAE,WAAW,WAAW;AAEzE,WAAO;AAAA,EACT;AACA,MAAI,EAAE,SAAS,YAAY,EAAE,SAAS,QAAS,QAAO;AAEtD,SAAO;AACT;;;AC5FA,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AAgBlB,SAAS,uBAA0C;AACxD,SAAO,SAAS,MAAM,UAAU,UAAU;AAC5C;AAQO,SAAS,cAAc,QAAoC;AAChE,QAAM,QAAQ,kBAAkB,KAAK,MAAM;AAC3C,SAAO,QAAQ,CAAC;AAClB;AAaO,SAAS,gBAAgB,MAAgC;AAC9D,MAAI;AACF,iBAAa,qBAAqB,GAAG,CAAC,IAAI,GAAG,EAAE,SAAS,KAAM,OAAO,OAAO,CAAC;AAAA,EAC/E,SAAS,KAAc;AACrB,WAAO,EAAE,WAAW,OAAO,SAAS,QAAW,gBAAgB,kBAAkB,GAAG,EAAE;AAAA,EACxF;AAEA,MAAI;AACF,UAAM,SAAS,aAAa,MAAM,CAAC,WAAW,GAAG;AAAA,MAC/C,SAAS;AAAA,MACT,OAAO;AAAA,MACP,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,EAAE,WAAW,MAAM,SAAS,cAAc,MAAM,EAAE;AAAA,EAC3D,SAAS,KAAc;AACrB,WAAO,EAAE,WAAW,MAAM,SAAS,QAAW,gBAAgB,kBAAkB,GAAG,EAAE;AAAA,EACvF;AACF;","names":[]}

package/dist/cli.js

@@ -18,7 +18,8 @@ import "./chunk-H7C3YEVA.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-PDAD3S2X.js";
+} from "./chunk-HSWOBNVW.js";
+import "./chunk-WPLXWTUK.js";
 import "./chunk-IW3G6WVW.js";
 import {
   AuthHandler,
@@ -139,7 +140,7 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-OBNQCC5R.js";
+} from "./chunk-EZYPUUIK.js";
 import "./chunk-2A664K4J.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
@@ -166,7 +167,7 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-IGKDZXNU.js";
+} from "./chunk-EKEK2YEU.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
@@ -20895,7 +20896,7 @@ async function handleDoctorCommand(args) {
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
   if (args.options.live) {
-    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-2WD3BRLP.js");
+    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-EYAUDVPS.js");
     const report = await runLiveReadiness();
     process.stdout.write(formatLiveReadiness(report) + "\n");
     if (report.some((r) => r.levels.serves.status === "failed")) {