@xopcai/xopc 0.0.8 → 0.0.11

package/dist/src/gateway/workspace-fs-file-list.js

@@ -0,0 +1,56 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { join, relative } from "node:path";
+import { readdir } from "node:fs/promises";
+//#region src/gateway/workspace-fs-file-list.ts
+init_logger();
+const log = createLogger("WorkspaceFsFileList");
+/** Match ripgrep `--glob` excludes in `runRipgrepListFiles` (keep list aligned where possible). */
+const SKIP_DIR_NAMES = new Set(["node_modules", ".git"]);
+/**
+* Recursive workspace file list (relative POSIX paths). Used when ripgrep `--files` yields nothing
+* (missing binary, spawn failure, or environment quirks) but the tree should still be searchable.
+*/
+async function listWorkspaceRelativeFilesFsFallback(workspaceRootAbs, maxFiles) {
+	const cap = Math.min(Math.max(maxFiles, 1), 2e5);
+	const out = [];
+	async function walk(dirAbs) {
+		if (out.length >= cap) return;
+		let entries;
+		try {
+			entries = await readdir(dirAbs, { withFileTypes: true });
+		} catch (err) {
+			log.debug({
+				err,
+				dirAbs
+			}, "fs list: readdir failed");
+			return;
+		}
+		for (const e of entries) {
+			if (out.length >= cap) return;
+			if (e.name.startsWith(".")) continue;
+			const full = join(dirAbs, e.name);
+			if (e.isDirectory()) {
+				if (SKIP_DIR_NAMES.has(e.name)) continue;
+				await walk(full);
+			} else if (e.isFile()) {
+				const rel = relative(workspaceRootAbs, full);
+				if (!rel || rel.startsWith("..")) continue;
+				out.push(rel.split("\\").join("/"));
+			}
+		}
+	}
+	try {
+		await walk(workspaceRootAbs);
+	} catch (err) {
+		log.warn({
+			err,
+			workspaceRootAbs
+		}, "fs list: walk failed");
+	}
+	return out;
+}
+//#endregion
+export { listWorkspaceRelativeFilesFsFallback };
+
+//# sourceMappingURL=workspace-fs-file-list.js.map

package/dist/src/gateway/workspace-fs-file-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-fs-file-list.js","names":[],"sources":["../../../src/gateway/workspace-fs-file-list.ts"],"sourcesContent":["import { readdir } from 'node:fs/promises';\nimport { join, relative } from 'node:path';\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('WorkspaceFsFileList');\n\n/** Match ripgrep `--glob` excludes in `runRipgrepListFiles` (keep list aligned where possible). */\nconst SKIP_DIR_NAMES = new Set(['node_modules', '.git']);\n\n/**\n * Recursive workspace file list (relative POSIX paths). Used when ripgrep `--files` yields nothing\n * (missing binary, spawn failure, or environment quirks) but the tree should still be searchable.\n */\nexport async function listWorkspaceRelativeFilesFsFallback(\n  workspaceRootAbs: string,\n  maxFiles: number,\n): Promise<string[]> {\n  const cap = Math.min(Math.max(maxFiles, 1), 200_000);\n  const out: string[] = [];\n\n  async function walk(dirAbs: string): Promise<void> {\n    if (out.length >= cap) return;\n    let entries;\n    try {\n      entries = await readdir(dirAbs, { withFileTypes: true });\n    } catch (err) {\n      log.debug({ err, dirAbs }, 'fs list: readdir failed');\n      return;\n    }\n    for (const e of entries) {\n      if (out.length >= cap) return;\n      if (e.name.startsWith('.')) continue;\n      const full = join(dirAbs, e.name);\n      if (e.isDirectory()) {\n        if (SKIP_DIR_NAMES.has(e.name)) continue;\n        await walk(full);\n      } else if (e.isFile()) {\n        const rel = relative(workspaceRootAbs, full);\n        if (!rel || rel.startsWith('..')) continue;\n        out.push(rel.split('\\\\').join('/'));\n      }\n    }\n  }\n\n  try {\n    await walk(workspaceRootAbs);\n  } catch (err) {\n    log.warn({ err, workspaceRootAbs }, 'fs list: walk failed');\n  }\n  return out;\n}\n"],"mappings":";;;;;aAGkD;AAElD,MAAM,MAAM,aAAa,sBAAsB;;AAG/C,MAAM,iBAAiB,IAAI,IAAI,CAAC,gBAAgB,OAAO,CAAC;;;;;AAMxD,eAAsB,qCACpB,kBACA,UACmB;CACnB,MAAM,MAAM,KAAK,IAAI,KAAK,IAAI,UAAU,EAAE,EAAE,IAAQ;CACpD,MAAM,MAAgB,EAAE;CAExB,eAAe,KAAK,QAA+B;AACjD,MAAI,IAAI,UAAU,IAAK;EACvB,IAAI;AACJ,MAAI;AACF,aAAU,MAAM,QAAQ,QAAQ,EAAE,eAAe,MAAM,CAAC;WACjD,KAAK;AACZ,OAAI,MAAM;IAAE;IAAK;IAAQ,EAAE,0BAA0B;AACrD;;AAEF,OAAK,MAAM,KAAK,SAAS;AACvB,OAAI,IAAI,UAAU,IAAK;AACvB,OAAI,EAAE,KAAK,WAAW,IAAI,CAAE;GAC5B,MAAM,OAAO,KAAK,QAAQ,EAAE,KAAK;AACjC,OAAI,EAAE,aAAa,EAAE;AACnB,QAAI,eAAe,IAAI,EAAE,KAAK,CAAE;AAChC,UAAM,KAAK,KAAK;cACP,EAAE,QAAQ,EAAE;IACrB,MAAM,MAAM,SAAS,kBAAkB,KAAK;AAC5C,QAAI,CAAC,OAAO,IAAI,WAAW,KAAK,CAAE;AAClC,QAAI,KAAK,IAAI,MAAM,KAAK,CAAC,KAAK,IAAI,CAAC;;;;AAKzC,KAAI;AACF,QAAM,KAAK,iBAAiB;UACrB,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK;GAAkB,EAAE,uBAAuB;;AAE7D,QAAO"}

package/dist/src/gateway/workspace-heartbeat-path.js

@@ -1,6 +1,6 @@
 import { init_agent_scope, resolveAgentBootstrapDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { getWorkspacePath, init_schema } from "../config/schema.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
+import { getWorkspacePath, init_schema } from "../config/schema.js";
 import { join } from "node:path";
 //#region src/gateway/workspace-heartbeat-path.ts
 init_schema();

package/dist/src/gateway/workspace-ripgrep.d.ts

@@ -7,3 +7,8 @@ export interface WorkspaceSearchHit {
 }
 /** Run ripgrep in a directory (absolute path). Returns empty array if rg fails to start. */
 export declare function runRipgrepInDirectory(query: string, dirAbsPath: string): Promise<WorkspaceSearchHit[]>;
+/**
+ * List workspace-relative file paths via ripgrep `--files` (respects .gitignore; fast on large trees).
+ * Returns POSIX paths relative to `dirAbsPath`.
+ */
+export declare function runRipgrepListFiles(dirAbsPath: string): Promise<string[]>;

package/dist/src/gateway/workspace-ripgrep.js

@@ -1,11 +1,28 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";
 //#region src/gateway/workspace-ripgrep.ts
+init_logger();
+const log = createLogger("WorkspaceRipgrep");
+function isEnoent(err) {
+	return err !== null && typeof err === "object" && err.code === "ENOENT";
+}
+let cachedRipgrepBin;
+/**
+* Prefer `@vscode/ripgrep` when its postinstall placed `bin/rg`; otherwise use `rg` on PATH.
+* (Bundled path can be ENOENT if postinstall was skipped or the binary was never downloaded.)
+*/
 async function resolveRipgrepBinary() {
+	if (cachedRipgrepBin) return cachedRipgrepBin;
+	let bin = "rg";
 	try {
 		const { rgPath } = await import("@vscode/ripgrep");
-		if (typeof rgPath === "string" && rgPath.length > 0) return rgPath;
+		if (typeof rgPath === "string" && rgPath.length > 0 && existsSync(rgPath)) bin = rgPath;
+		else if (typeof rgPath === "string" && rgPath.length > 0) log.debug({ rgPath }, "@vscode/ripgrep binary not on disk; will try rg on PATH");
 	} catch {}
-	return "rg";
+	cachedRipgrepBin = bin;
+	return bin;
 }
 /** Run ripgrep in a directory (absolute path). Returns empty array if rg fails to start. */
 function runRipgrepInDirectory(query, dirAbsPath) {
@@ -52,11 +69,78 @@ function runRipgrepInDirectory(query, dirAbsPath) {
 				}
 			});
 			rg.on("close", () => resolve(results));
-			rg.on("error", () => resolve([]));
+			rg.on("error", (err) => {
+				if (!isEnoent(err)) log.warn({
+					err,
+					query,
+					dir: dirAbsPath,
+					rg: rgExecutable
+				}, "ripgrep in-directory: spawn failed");
+				else log.debug({
+					dir: dirAbsPath,
+					rg: rgExecutable
+				}, "ripgrep not on PATH; skipping in-directory search");
+				resolve([]);
+			});
+		});
+	})();
+}
+/**
+* List workspace-relative file paths via ripgrep `--files` (respects .gitignore; fast on large trees).
+* Returns POSIX paths relative to `dirAbsPath`.
+*/
+function runRipgrepListFiles(dirAbsPath) {
+	return (async () => {
+		const rgExecutable = await resolveRipgrepBinary();
+		return await new Promise((resolve) => {
+			const rg = spawn(rgExecutable, [
+				"--files",
+				"--glob",
+				"!**/node_modules/**",
+				"--glob",
+				"!.git/**",
+				"."
+			], {
+				shell: false,
+				cwd: dirAbsPath
+			});
+			const lines = [];
+			let buffer = "";
+			rg.stdout.on("data", (data) => {
+				buffer += data.toString();
+				const parts = buffer.split(/\r?\n/);
+				buffer = parts.pop() ?? "";
+				for (const line of parts) {
+					const t = line.trim();
+					if (t) lines.push(t.replace(/\\/g, "/"));
+				}
+			});
+			rg.on("close", (code) => {
+				const tail = buffer.trim();
+				if (tail) lines.push(tail.replace(/\\/g, "/"));
+				if (code !== 0 && lines.length === 0) log.debug({
+					code,
+					cwd: dirAbsPath,
+					rg: rgExecutable
+				}, "ripgrep --files: non-zero exit, no output (using fs fallback if any)");
+				resolve(lines);
+			});
+			rg.on("error", (err) => {
+				if (isEnoent(err)) log.debug({
+					cwd: dirAbsPath,
+					rg: rgExecutable
+				}, "ripgrep binary not found; workspace file search will use fs fallback when needed");
+				else log.warn({
+					err,
+					cwd: dirAbsPath,
+					rg: rgExecutable
+				}, "ripgrep --files failed to start");
+				resolve([]);
+			});
 		});
 	})();
 }
 //#endregion
-export { runRipgrepInDirectory };
+export { runRipgrepInDirectory, runRipgrepListFiles };
 
 //# sourceMappingURL=workspace-ripgrep.js.map

package/dist/src/gateway/workspace-ripgrep.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-ripgrep.js","names":[],"sources":["../../../src/gateway/workspace-ripgrep.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\n\nexport interface WorkspaceSearchHit {\n  filePath: string;\n  lineNumber: number;\n  lineContent: string;\n  matchStart: number;\n  matchEnd: number;\n}\n\nasync function resolveRipgrepBinary(): Promise<string | null> {\n  try {\n    const { rgPath } = await import('@vscode/ripgrep');\n    if (typeof rgPath === 'string' && rgPath.length > 0) {\n      return rgPath;\n    }\n  } catch {\n    // pnpm may skip @vscode/ripgrep postinstall; package dir can be missing.\n  }\n  return 'rg';\n}\n\n/** Run ripgrep in a directory (absolute path). Returns empty array if rg fails to start. */\nexport function runRipgrepInDirectory(query: string, dirAbsPath: string): Promise<WorkspaceSearchHit[]> {\n  return (async () => {\n    const rgExecutable = await resolveRipgrepBinary();\n\n    return await new Promise<WorkspaceSearchHit[]>((resolve) => {\n      const args = [\n        '--json',\n        '--smart-case',\n        '--max-count',\n        '50',\n        '--glob',\n        '*.md',\n        '--glob',\n        '*.txt',\n        query,\n        dirAbsPath,\n      ];\n\n      const rg = spawn(rgExecutable, args, { shell: false });\n      const results: WorkspaceSearchHit[] = [];\n      let buffer = '';\n\n      rg.stdout.on('data', (data: Buffer) => {\n        buffer += data.toString();\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (!line.trim()) continue;\n          try {\n            const parsed = JSON.parse(line) as {\n              type?: string;\n              data?: {\n                path?: { text?: string };\n                lines?: { text?: string };\n                line_number?: number;\n                submatches?: Array<{ start?: number; end?: number }>;\n              };\n            };\n            if (parsed.type === 'match' && parsed.data) {\n              const d = parsed.data;\n              const pathText = d.path?.text ?? '';\n              const lineContent = d.lines?.text ?? '';\n              const lineNumber = d.line_number ?? 0;\n              const sm = d.submatches?.[0];\n              results.push({\n                filePath: pathText,\n                lineNumber,\n                lineContent: lineContent.trimEnd(),\n                matchStart: sm?.start ?? 0,\n                matchEnd: sm?.end ?? 0,\n              });\n            }\n          } catch {\n            /* skip */\n          }\n        }\n      });\n\n      rg.on('close', () => resolve(results));\n      rg.on('error', () => resolve([]));\n    });\n  })();\n}\n"],"mappings":";;AAUA,eAAe,uBAA+C;AAC5D,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,MAAI,OAAO,WAAW,YAAY,OAAO,SAAS,EAChD,QAAO;SAEH;AAGR,QAAO;;;AAIT,SAAgB,sBAAsB,OAAe,YAAmD;AACtG,SAAQ,YAAY;EAClB,MAAM,eAAe,MAAM,sBAAsB;AAEjD,SAAO,MAAM,IAAI,SAA+B,YAAY;GAc1D,MAAM,KAAK,MAAM,cAbJ;IACX;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACD,EAEoC,EAAE,OAAO,OAAO,CAAC;GACtD,MAAM,UAAgC,EAAE;GACxC,IAAI,SAAS;AAEb,MAAG,OAAO,GAAG,SAAS,SAAiB;AACrC,cAAU,KAAK,UAAU;IACzB,MAAM,QAAQ,OAAO,MAAM,KAAK;AAChC,aAAS,MAAM,KAAK,IAAI;AAExB,SAAK,MAAM,QAAQ,OAAO;AACxB,SAAI,CAAC,KAAK,MAAM,CAAE;AAClB,SAAI;MACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAS/B,UAAI,OAAO,SAAS,WAAW,OAAO,MAAM;OAC1C,MAAM,IAAI,OAAO;OACjB,MAAM,WAAW,EAAE,MAAM,QAAQ;OACjC,MAAM,cAAc,EAAE,OAAO,QAAQ;OACrC,MAAM,aAAa,EAAE,eAAe;OACpC,MAAM,KAAK,EAAE,aAAa;AAC1B,eAAQ,KAAK;QACX,UAAU;QACV;QACA,aAAa,YAAY,SAAS;QAClC,YAAY,IAAI,SAAS;QACzB,UAAU,IAAI,OAAO;QACtB,CAAC;;aAEE;;KAIV;AAEF,MAAG,GAAG,eAAe,QAAQ,QAAQ,CAAC;AACtC,MAAG,GAAG,eAAe,QAAQ,EAAE,CAAC,CAAC;IACjC;KACA"}
+{"version":3,"file":"workspace-ripgrep.js","names":[],"sources":["../../../src/gateway/workspace-ripgrep.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('WorkspaceRipgrep');\n\nfunction isEnoent(err: unknown): boolean {\n  return err !== null && typeof err === 'object' && (err as NodeJS.ErrnoException).code === 'ENOENT';\n}\n\nlet cachedRipgrepBin: string | undefined;\n\n/**\n * Prefer `@vscode/ripgrep` when its postinstall placed `bin/rg`; otherwise use `rg` on PATH.\n * (Bundled path can be ENOENT if postinstall was skipped or the binary was never downloaded.)\n */\nasync function resolveRipgrepBinary(): Promise<string> {\n  if (cachedRipgrepBin) return cachedRipgrepBin;\n  let bin = 'rg';\n  try {\n    const { rgPath } = await import('@vscode/ripgrep');\n    if (typeof rgPath === 'string' && rgPath.length > 0 && existsSync(rgPath)) {\n      bin = rgPath;\n    } else if (typeof rgPath === 'string' && rgPath.length > 0) {\n      log.debug({ rgPath }, '@vscode/ripgrep binary not on disk; will try rg on PATH');\n    }\n  } catch {\n    // pnpm may skip @vscode/ripgrep postinstall; package dir can be missing.\n  }\n  cachedRipgrepBin = bin;\n  return bin;\n}\n\nexport interface WorkspaceSearchHit {\n  filePath: string;\n  lineNumber: number;\n  lineContent: string;\n  matchStart: number;\n  matchEnd: number;\n}\n\n/** Run ripgrep in a directory (absolute path). Returns empty array if rg fails to start. */\nexport function runRipgrepInDirectory(query: string, dirAbsPath: string): Promise<WorkspaceSearchHit[]> {\n  return (async () => {\n    const rgExecutable = await resolveRipgrepBinary();\n\n    return await new Promise<WorkspaceSearchHit[]>((resolve) => {\n      const args = [\n        '--json',\n        '--smart-case',\n        '--max-count',\n        '50',\n        '--glob',\n        '*.md',\n        '--glob',\n        '*.txt',\n        query,\n        dirAbsPath,\n      ];\n\n      const rg = spawn(rgExecutable, args, { shell: false });\n      const results: WorkspaceSearchHit[] = [];\n      let buffer = '';\n\n      rg.stdout.on('data', (data: Buffer) => {\n        buffer += data.toString();\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (!line.trim()) continue;\n          try {\n            const parsed = JSON.parse(line) as {\n              type?: string;\n              data?: {\n                path?: { text?: string };\n                lines?: { text?: string };\n                line_number?: number;\n                submatches?: Array<{ start?: number; end?: number }>;\n              };\n            };\n            if (parsed.type === 'match' && parsed.data) {\n              const d = parsed.data;\n              const pathText = d.path?.text ?? '';\n              const lineContent = d.lines?.text ?? '';\n              const lineNumber = d.line_number ?? 0;\n              const sm = d.submatches?.[0];\n              results.push({\n                filePath: pathText,\n                lineNumber,\n                lineContent: lineContent.trimEnd(),\n                matchStart: sm?.start ?? 0,\n                matchEnd: sm?.end ?? 0,\n              });\n            }\n          } catch {\n            /* skip */\n          }\n        }\n      });\n\n      rg.on('close', () => resolve(results));\n      rg.on('error', (err) => {\n        if (!isEnoent(err)) {\n          log.warn({ err, query, dir: dirAbsPath, rg: rgExecutable }, 'ripgrep in-directory: spawn failed');\n        } else {\n          log.debug({ dir: dirAbsPath, rg: rgExecutable }, 'ripgrep not on PATH; skipping in-directory search');\n        }\n        resolve([]);\n      });\n    });\n  })();\n}\n\n/**\n * List workspace-relative file paths via ripgrep `--files` (respects .gitignore; fast on large trees).\n * Returns POSIX paths relative to `dirAbsPath`.\n */\nexport function runRipgrepListFiles(dirAbsPath: string): Promise<string[]> {\n  return (async () => {\n    const rgExecutable = await resolveRipgrepBinary();\n\n    return await new Promise<string[]>((resolve) => {\n      const args = ['--files', '--glob', '!**/node_modules/**', '--glob', '!.git/**', '.'];\n      const rg = spawn(rgExecutable, args, { shell: false, cwd: dirAbsPath });\n      const lines: string[] = [];\n      let buffer = '';\n\n      rg.stdout.on('data', (data: Buffer) => {\n        buffer += data.toString();\n        const parts = buffer.split(/\\r?\\n/);\n        buffer = parts.pop() ?? '';\n        for (const line of parts) {\n          const t = line.trim();\n          if (t) lines.push(t.replace(/\\\\/g, '/'));\n        }\n      });\n\n      rg.on('close', (code) => {\n        const tail = buffer.trim();\n        if (tail) lines.push(tail.replace(/\\\\/g, '/'));\n        if (code !== 0 && lines.length === 0) {\n          log.debug({ code, cwd: dirAbsPath, rg: rgExecutable }, 'ripgrep --files: non-zero exit, no output (using fs fallback if any)');\n        }\n        resolve(lines);\n      });\n      rg.on('error', (err) => {\n        if (isEnoent(err)) {\n          log.debug(\n            { cwd: dirAbsPath, rg: rgExecutable },\n            'ripgrep binary not found; workspace file search will use fs fallback when needed',\n          );\n        } else {\n          log.warn({ err, cwd: dirAbsPath, rg: rgExecutable }, 'ripgrep --files failed to start');\n        }\n        resolve([]);\n      });\n    });\n  })();\n}\n"],"mappings":"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"}

package/dist/src/infra/update-channels.d.ts

@@ -0,0 +1,14 @@
+export type UpdateChannel = 'stable' | 'beta' | 'dev';
+export declare const DEFAULT_PACKAGE_CHANNEL: UpdateChannel;
+export declare const DEFAULT_GIT_CHANNEL: UpdateChannel;
+/**
+ * Map update channel to the npm dist-tag used for querying registry.
+ * stable → latest, beta → beta, dev → dev
+ */
+export declare function channelToNpmTag(channel: UpdateChannel): string;
+/** Normalize a user-provided string to a valid UpdateChannel, or null. */
+export declare function normalizeUpdateChannel(value?: string | null): UpdateChannel | null;
+/** Return true if a version/tag string contains a beta prerelease identifier. */
+export declare function isBetaVersion(version: string): boolean;
+/** Return true if a version string is a stable release (no beta marker in this heuristic). */
+export declare function isStableVersion(version: string): boolean;

package/dist/src/infra/update-channels.js

@@ -0,0 +1,30 @@
+//#region src/infra/update-channels.ts
+const DEFAULT_PACKAGE_CHANNEL = "stable";
+const DEFAULT_GIT_CHANNEL = "dev";
+/**
+* Map update channel to the npm dist-tag used for querying registry.
+* stable → latest, beta → beta, dev → dev
+*/
+function channelToNpmTag(channel) {
+	if (channel === "beta") return "beta";
+	if (channel === "dev") return "dev";
+	return "latest";
+}
+/** Normalize a user-provided string to a valid UpdateChannel, or null. */
+function normalizeUpdateChannel(value) {
+	const normalized = value?.trim().toLowerCase();
+	if (normalized === "stable" || normalized === "beta" || normalized === "dev") return normalized;
+	return null;
+}
+/** Return true if a version/tag string contains a beta prerelease identifier. */
+function isBetaVersion(version) {
+	return /(?:^|[.-])beta(?:[.-]|$)/i.test(version);
+}
+/** Return true if a version string is a stable release (no beta marker in this heuristic). */
+function isStableVersion(version) {
+	return !isBetaVersion(version);
+}
+//#endregion
+export { DEFAULT_GIT_CHANNEL, DEFAULT_PACKAGE_CHANNEL, channelToNpmTag, isBetaVersion, isStableVersion, normalizeUpdateChannel };
+
+//# sourceMappingURL=update-channels.js.map

package/dist/src/infra/update-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-channels.js","names":[],"sources":["../../../src/infra/update-channels.ts"],"sourcesContent":["// src/infra/update-channels.ts\n\nexport type UpdateChannel = 'stable' | 'beta' | 'dev';\n\nexport const DEFAULT_PACKAGE_CHANNEL: UpdateChannel = 'stable';\nexport const DEFAULT_GIT_CHANNEL: UpdateChannel = 'dev';\n\n/**\n * Map update channel to the npm dist-tag used for querying registry.\n * stable → latest, beta → beta, dev → dev\n */\nexport function channelToNpmTag(channel: UpdateChannel): string {\n  if (channel === 'beta') return 'beta';\n  if (channel === 'dev') return 'dev';\n  return 'latest';\n}\n\n/** Normalize a user-provided string to a valid UpdateChannel, or null. */\nexport function normalizeUpdateChannel(value?: string | null): UpdateChannel | null {\n  const normalized = value?.trim().toLowerCase();\n  if (normalized === 'stable' || normalized === 'beta' || normalized === 'dev') {\n    return normalized;\n  }\n  return null;\n}\n\n/** Return true if a version/tag string contains a beta prerelease identifier. */\nexport function isBetaVersion(version: string): boolean {\n  return /(?:^|[.-])beta(?:[.-]|$)/i.test(version);\n}\n\n/** Return true if a version string is a stable release (no beta marker in this heuristic). */\nexport function isStableVersion(version: string): boolean {\n  return !isBetaVersion(version);\n}\n"],"mappings":";AAIA,MAAa,0BAAyC;AACtD,MAAa,sBAAqC;;;;;AAMlD,SAAgB,gBAAgB,SAAgC;AAC9D,KAAI,YAAY,OAAQ,QAAO;AAC/B,KAAI,YAAY,MAAO,QAAO;AAC9B,QAAO;;;AAIT,SAAgB,uBAAuB,OAA6C;CAClF,MAAM,aAAa,OAAO,MAAM,CAAC,aAAa;AAC9C,KAAI,eAAe,YAAY,eAAe,UAAU,eAAe,MACrE,QAAO;AAET,QAAO;;;AAIT,SAAgB,cAAc,SAA0B;AACtD,QAAO,4BAA4B,KAAK,QAAQ;;;AAIlD,SAAgB,gBAAgB,SAA0B;AACxD,QAAO,CAAC,cAAc,QAAQ"}

package/dist/src/infra/update-check.d.ts

@@ -0,0 +1,53 @@
+import { type UpdateChannel } from './update-channels.js';
+export type InstallKind = 'git' | 'package' | 'unknown';
+export type NpmTagResult = {
+    tag: string;
+    version: string | null;
+    error?: string;
+};
+export type UpdateCheckResult = {
+    installKind: InstallKind;
+    root: string | null;
+};
+export type UpdateAvailable = {
+    currentVersion: string;
+    latestVersion: string;
+    channel: string;
+};
+/**
+ * Fetch the version published under a specific npm dist-tag.
+ * Uses the abbreviated packument endpoint: `GET /<pkg>/<tag>`.
+ */
+export declare function fetchNpmTagVersion(params: {
+    tag: string;
+    timeoutMs?: number;
+}): Promise<NpmTagResult>;
+/**
+ * Resolve the best version for the given update channel.
+ * For beta channel: if the beta tag version is older than latest, return latest instead.
+ */
+export declare function resolveNpmChannelTag(params: {
+    channel: UpdateChannel;
+    timeoutMs?: number;
+}): Promise<{
+    tag: string;
+    version: string | null;
+}>;
+/**
+ * Compare two semver strings. Returns:
+ * -1 if a < b, 0 if equal, 1 if a > b, null if either is unparseable.
+ * Prerelease versions are considered older than the same version without prerelease.
+ */
+export declare function compareSemver(a: string | null, b: string | null): number | null;
+/**
+ * Detect whether the current process is running from a git checkout or npm-installed package.
+ * Checks for `.git` directory in the package root.
+ */
+export declare function detectInstallKind(packageRoot: string): Promise<InstallKind>;
+/**
+ * Resolve the xopc package root directory.
+ * Walks up from this file to find package.json with name @xopcai/xopc.
+ */
+export declare function resolvePackageRoot(): Promise<string | null>;
+/** Get the current running version from package.json. */
+export declare function getCurrentVersion(): string;

package/dist/src/infra/update-check.js

@@ -0,0 +1,155 @@
+import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
+import { channelToNpmTag } from "./update-channels.js";
+import { dirname, join } from "node:path";
+import { access, readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+//#region src/infra/update-check.ts
+init_package_version();
+const REGISTRY_BASE = "https://registry.npmjs.org";
+const PACKAGE_NAME = "@xopcai/xopc";
+const REGISTRY_TIMEOUT_MS = 3500;
+/**
+* Fetch the version published under a specific npm dist-tag.
+* Uses the abbreviated packument endpoint: `GET /<pkg>/<tag>`.
+*/
+async function fetchNpmTagVersion(params) {
+	const timeoutMs = params.timeoutMs ?? REGISTRY_TIMEOUT_MS;
+	const url = `${REGISTRY_BASE}/${encodeURIComponent(PACKAGE_NAME).replace("%40", "@")}/${encodeURIComponent(params.tag)}`;
+	try {
+		const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+		if (!response.ok) return {
+			tag: params.tag,
+			version: null,
+			error: `HTTP ${response.status}`
+		};
+		const json = await response.json();
+		const version = typeof json?.version === "string" ? json.version : null;
+		return {
+			tag: params.tag,
+			version
+		};
+	} catch (err) {
+		return {
+			tag: params.tag,
+			version: null,
+			error: String(err)
+		};
+	}
+}
+/**
+* Resolve the best version for the given update channel.
+* For beta channel: if the beta tag version is older than latest, return latest instead.
+*/
+async function resolveNpmChannelTag(params) {
+	const channelTag = channelToNpmTag(params.channel);
+	const channelResult = await fetchNpmTagVersion({
+		tag: channelTag,
+		timeoutMs: params.timeoutMs
+	});
+	if (params.channel !== "beta") return {
+		tag: channelTag,
+		version: channelResult.version
+	};
+	const latestResult = await fetchNpmTagVersion({
+		tag: "latest",
+		timeoutMs: params.timeoutMs
+	});
+	if (!latestResult.version) return {
+		tag: channelTag,
+		version: channelResult.version
+	};
+	if (!channelResult.version) return {
+		tag: "latest",
+		version: latestResult.version
+	};
+	const comparison = compareSemver(channelResult.version, latestResult.version);
+	if (comparison !== null && comparison < 0) return {
+		tag: "latest",
+		version: latestResult.version
+	};
+	return {
+		tag: channelTag,
+		version: channelResult.version
+	};
+}
+/**
+* Parse a version string into comparable numeric parts.
+* Handles formats like "1.2.3", "1.2.3-beta.1".
+* Returns null for unparseable strings.
+*/
+function parseSemverParts(version) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-(.+))?$/.exec(version.trim());
+	if (!match) return null;
+	return {
+		major: parseInt(match[1], 10),
+		minor: parseInt(match[2], 10),
+		patch: parseInt(match[3], 10),
+		prerelease: match[4] ?? null
+	};
+}
+/**
+* Compare two semver strings. Returns:
+* -1 if a < b, 0 if equal, 1 if a > b, null if either is unparseable.
+* Prerelease versions are considered older than the same version without prerelease.
+*/
+function compareSemver(a, b) {
+	if (!a || !b) return null;
+	const parsedA = parseSemverParts(a);
+	const parsedB = parseSemverParts(b);
+	if (!parsedA || !parsedB) return null;
+	for (const field of [
+		"major",
+		"minor",
+		"patch"
+	]) if (parsedA[field] !== parsedB[field]) return parsedA[field] < parsedB[field] ? -1 : 1;
+	if (parsedA.prerelease === null && parsedB.prerelease === null) return 0;
+	if (parsedA.prerelease !== null && parsedB.prerelease === null) return -1;
+	if (parsedA.prerelease === null && parsedB.prerelease !== null) return 1;
+	if (parsedA.prerelease < parsedB.prerelease) return -1;
+	if (parsedA.prerelease > parsedB.prerelease) return 1;
+	return 0;
+}
+/**
+* Detect whether the current process is running from a git checkout or npm-installed package.
+* Checks for `.git` directory in the package root.
+*/
+async function detectInstallKind(packageRoot) {
+	try {
+		await access(join(packageRoot, ".git"));
+		return "git";
+	} catch {
+		try {
+			await access(join(packageRoot, "package.json"));
+			return "package";
+		} catch {
+			return "unknown";
+		}
+	}
+}
+/**
+* Resolve the xopc package root directory.
+* Walks up from this file to find package.json with name @xopcai/xopc.
+*/
+async function resolvePackageRoot() {
+	let current = dirname(fileURLToPath(import.meta.url));
+	for (let depth = 0; depth < 20; depth++) {
+		const pkgPath = join(current, "package.json");
+		try {
+			const raw = await readFile(pkgPath, "utf-8");
+			const parsed = JSON.parse(raw);
+			if (typeof parsed.name === "string" && parsed.name === PACKAGE_NAME) return current;
+		} catch {}
+		const parent = dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+	return null;
+}
+/** Get the current running version from package.json. */
+function getCurrentVersion() {
+	return PACKAGE_VERSION;
+}
+//#endregion
+export { compareSemver, detectInstallKind, fetchNpmTagVersion, getCurrentVersion, resolveNpmChannelTag, resolvePackageRoot };
+
+//# sourceMappingURL=update-check.js.map

package/dist/src/infra/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","names":[],"sources":["../../../src/infra/update-check.ts"],"sourcesContent":["// src/infra/update-check.ts\n\nimport { access, readFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { PACKAGE_VERSION } from '../package-version.js';\n\nimport { channelToNpmTag, type UpdateChannel } from './update-channels.js';\n\n// --- Types ---\n\nexport type InstallKind = 'git' | 'package' | 'unknown';\n\nexport type NpmTagResult = {\n  tag: string;\n  version: string | null;\n  error?: string;\n};\n\nexport type UpdateCheckResult = {\n  installKind: InstallKind;\n  root: string | null;\n};\n\nexport type UpdateAvailable = {\n  currentVersion: string;\n  latestVersion: string;\n  channel: string;\n};\n\n// --- npm Registry ---\n\nconst REGISTRY_BASE = 'https://registry.npmjs.org';\nconst PACKAGE_NAME = '@xopcai/xopc';\nconst REGISTRY_TIMEOUT_MS = 3500;\n\n/**\n * Fetch the version published under a specific npm dist-tag.\n * Uses the abbreviated packument endpoint: `GET /<pkg>/<tag>`.\n */\nexport async function fetchNpmTagVersion(params: {\n  tag: string;\n  timeoutMs?: number;\n}): Promise<NpmTagResult> {\n  const timeoutMs = params.timeoutMs ?? REGISTRY_TIMEOUT_MS;\n  const encodedName = encodeURIComponent(PACKAGE_NAME).replace('%40', '@');\n  const url = `${REGISTRY_BASE}/${encodedName}/${encodeURIComponent(params.tag)}`;\n  try {\n    const response = await fetch(url, {\n      signal: AbortSignal.timeout(timeoutMs),\n    });\n    if (!response.ok) {\n      return { tag: params.tag, version: null, error: `HTTP ${response.status}` };\n    }\n    const json = (await response.json()) as { version?: unknown };\n    const version = typeof json?.version === 'string' ? json.version : null;\n    return { tag: params.tag, version };\n  } catch (err) {\n    return { tag: params.tag, version: null, error: String(err) };\n  }\n}\n\n/**\n * Resolve the best version for the given update channel.\n * For beta channel: if the beta tag version is older than latest, return latest instead.\n */\nexport async function resolveNpmChannelTag(params: {\n  channel: UpdateChannel;\n  timeoutMs?: number;\n}): Promise<{ tag: string; version: string | null }> {\n  const channelTag = channelToNpmTag(params.channel);\n  const channelResult = await fetchNpmTagVersion({ tag: channelTag, timeoutMs: params.timeoutMs });\n\n  if (params.channel !== 'beta') {\n    return { tag: channelTag, version: channelResult.version };\n  }\n\n  // For beta: also check latest, return whichever is newer\n  const latestResult = await fetchNpmTagVersion({ tag: 'latest', timeoutMs: params.timeoutMs });\n  if (!latestResult.version) {\n    return { tag: channelTag, version: channelResult.version };\n  }\n  if (!channelResult.version) {\n    return { tag: 'latest', version: latestResult.version };\n  }\n  const comparison = compareSemver(channelResult.version, latestResult.version);\n  if (comparison !== null && comparison < 0) {\n    return { tag: 'latest', version: latestResult.version };\n  }\n  return { tag: channelTag, version: channelResult.version };\n}\n\n// --- Semver comparison ---\n\n/**\n * Parse a version string into comparable numeric parts.\n * Handles formats like \"1.2.3\", \"1.2.3-beta.1\".\n * Returns null for unparseable strings.\n */\nfunction parseSemverParts(\n  version: string,\n): { major: number; minor: number; patch: number; prerelease: string | null } | null {\n  const match = /^v?(\\d+)\\.(\\d+)\\.(\\d+)(?:-(.+))?$/.exec(version.trim());\n  if (!match) return null;\n  return {\n    major: parseInt(match[1], 10),\n    minor: parseInt(match[2], 10),\n    patch: parseInt(match[3], 10),\n    prerelease: match[4] ?? null,\n  };\n}\n\n/**\n * Compare two semver strings. Returns:\n * -1 if a < b, 0 if equal, 1 if a > b, null if either is unparseable.\n * Prerelease versions are considered older than the same version without prerelease.\n */\nexport function compareSemver(a: string | null, b: string | null): number | null {\n  if (!a || !b) return null;\n  const parsedA = parseSemverParts(a);\n  const parsedB = parseSemverParts(b);\n  if (!parsedA || !parsedB) return null;\n\n  for (const field of ['major', 'minor', 'patch'] as const) {\n    if (parsedA[field] !== parsedB[field]) {\n      return parsedA[field] < parsedB[field] ? -1 : 1;\n    }\n  }\n\n  // Both have same major.minor.patch — compare prerelease\n  if (parsedA.prerelease === null && parsedB.prerelease === null) return 0;\n  if (parsedA.prerelease !== null && parsedB.prerelease === null) return -1; // pre < release\n  if (parsedA.prerelease === null && parsedB.prerelease !== null) return 1;\n\n  // Both have prerelease — lexicographic fallback\n  if (parsedA.prerelease! < parsedB.prerelease!) return -1;\n  if (parsedA.prerelease! > parsedB.prerelease!) return 1;\n  return 0;\n}\n\n// --- Install kind detection ---\n\n/**\n * Detect whether the current process is running from a git checkout or npm-installed package.\n * Checks for `.git` directory in the package root.\n */\nexport async function detectInstallKind(packageRoot: string): Promise<InstallKind> {\n  try {\n    await access(join(packageRoot, '.git'));\n    return 'git';\n  } catch {\n    // No .git directory — likely installed via npm\n    try {\n      await access(join(packageRoot, 'package.json'));\n      return 'package';\n    } catch {\n      return 'unknown';\n    }\n  }\n}\n\n/**\n * Resolve the xopc package root directory.\n * Walks up from this file to find package.json with name @xopcai/xopc.\n */\nexport async function resolvePackageRoot(): Promise<string | null> {\n  let current = dirname(fileURLToPath(import.meta.url));\n  for (let depth = 0; depth < 20; depth++) {\n    const pkgPath = join(current, 'package.json');\n    try {\n      const raw = await readFile(pkgPath, 'utf-8');\n      const parsed = JSON.parse(raw) as { name?: unknown };\n      if (typeof parsed.name === 'string' && parsed.name === PACKAGE_NAME) {\n        return current;\n      }\n    } catch {\n      // continue\n    }\n    const parent = dirname(current);\n    if (parent === current) return null;\n    current = parent;\n  }\n  return null;\n}\n\n/** Get the current running version from package.json. */\nexport function getCurrentVersion(): string {\n  return PACKAGE_VERSION;\n}\n"],"mappings":"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"}

package/dist/src/infra/update-runner.d.ts

@@ -0,0 +1,18 @@
+import type { UpdateChannel } from './update-channels.js';
+export type AutoUpdateResult = {
+    ok: boolean;
+    exitCode: number | null;
+    reason?: string;
+    stdout?: string;
+    stderr?: string;
+};
+/**
+ * Spawn a child process to execute `xopc update --yes --channel <channel> --json`.
+ * Uses the current runtime (process.execPath) and entry point (process.argv[1]) to
+ * ensure the correct Node.js version and binary path are used.
+ */
+export declare function runAutoUpdateCommand(params: {
+    channel: UpdateChannel;
+    root?: string | null;
+    timeoutMs?: number;
+}): Promise<AutoUpdateResult>;

package/dist/src/infra/update-runner.js

@@ -0,0 +1,112 @@
+import { join } from "node:path";
+import { access } from "node:fs/promises";
+import { spawn } from "node:child_process";
+//#region src/infra/update-runner.ts
+const AUTO_UPDATE_TIMEOUT_MS = 2700 * 1e3;
+/**
+* Spawn a child process to execute `xopc update --yes --channel <channel> --json`.
+* Uses the current runtime (process.execPath) and entry point (process.argv[1]) to
+* ensure the correct Node.js version and binary path are used.
+*/
+async function runAutoUpdateCommand(params) {
+	const timeoutMs = params.timeoutMs ?? AUTO_UPDATE_TIMEOUT_MS;
+	const argv = await resolveUpdateCommandArgv([
+		"update",
+		"--yes",
+		"--channel",
+		params.channel,
+		"--json"
+	], params.root ?? null);
+	return new Promise((resolve) => {
+		const child = spawn(argv[0], argv.slice(1), {
+			env: {
+				...process.env,
+				XOPC_AUTO_UPDATE: "1"
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			detached: false
+		});
+		let stdout = "";
+		let stderr = "";
+		const timeoutId = setTimeout(() => {
+			child.kill("SIGTERM");
+		}, timeoutMs);
+		const finish = (result) => {
+			clearTimeout(timeoutId);
+			resolve(result);
+		};
+		child.stdout?.on("data", (chunk) => {
+			stdout += chunk.toString();
+			if (stdout.length > 64e3) stdout = stdout.slice(-32e3);
+		});
+		child.stderr?.on("data", (chunk) => {
+			stderr += chunk.toString();
+			if (stderr.length > 64e3) stderr = stderr.slice(-32e3);
+		});
+		child.on("error", (err) => {
+			finish({
+				ok: false,
+				exitCode: null,
+				reason: String(err),
+				stdout,
+				stderr
+			});
+		});
+		child.on("exit", (code, signal) => {
+			if (signal === "SIGTERM" || code === 143) {
+				finish({
+					ok: false,
+					exitCode: code,
+					reason: "timeout",
+					stdout,
+					stderr
+				});
+				return;
+			}
+			finish({
+				ok: code === 0,
+				exitCode: code,
+				reason: code === 0 ? void 0 : "non-zero-exit",
+				stdout,
+				stderr
+			});
+		});
+	});
+}
+/**
+* Resolve the argv array for spawning the update command.
+*
+* Priority:
+* 1. process.execPath + process.argv[1] (current runtime + entry point)
+* 2. process.execPath + known dist entry points in root
+* 3. Fallback to bare `xopc` (assumes global install)
+*/
+async function resolveUpdateCommandArgv(baseArgs, root) {
+	const execPath = process.execPath?.trim();
+	const argv1 = process.argv[1]?.trim();
+	if (execPath && argv1) return [
+		execPath,
+		argv1,
+		...baseArgs
+	];
+	if (execPath && root) {
+		const candidates = [join(root, "dist/src/cli/index.js"), join(root, "dist/index.js")];
+		for (const candidate of candidates) try {
+			await access(candidate);
+			return [
+				execPath,
+				candidate,
+				...baseArgs
+			];
+		} catch {}
+	}
+	return ["xopc", ...baseArgs];
+}
+//#endregion
+export { runAutoUpdateCommand };
+
+//# sourceMappingURL=update-runner.js.map

package/dist/src/infra/update-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-runner.js","names":[],"sources":["../../../src/infra/update-runner.ts"],"sourcesContent":["// src/infra/update-runner.ts\n\nimport { spawn } from 'node:child_process';\nimport { access } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nimport type { UpdateChannel } from './update-channels.js';\n\nconst AUTO_UPDATE_TIMEOUT_MS = 45 * 60 * 1000; // 45 minutes\n\nexport type AutoUpdateResult = {\n  ok: boolean;\n  exitCode: number | null;\n  reason?: string;\n  stdout?: string;\n  stderr?: string;\n};\n\n/**\n * Spawn a child process to execute `xopc update --yes --channel <channel> --json`.\n * Uses the current runtime (process.execPath) and entry point (process.argv[1]) to\n * ensure the correct Node.js version and binary path are used.\n */\nexport async function runAutoUpdateCommand(params: {\n  channel: UpdateChannel;\n  root?: string | null;\n  timeoutMs?: number;\n}): Promise<AutoUpdateResult> {\n  const timeoutMs = params.timeoutMs ?? AUTO_UPDATE_TIMEOUT_MS;\n  const baseArgs = ['update', '--yes', '--channel', params.channel, '--json'];\n\n  const argv = await resolveUpdateCommandArgv(baseArgs, params.root ?? null);\n\n  return new Promise<AutoUpdateResult>((resolve) => {\n    const child = spawn(argv[0], argv.slice(1), {\n      env: {\n        ...process.env,\n        XOPC_AUTO_UPDATE: '1',\n      },\n      stdio: ['ignore', 'pipe', 'pipe'],\n      detached: false,\n    });\n\n    let stdout = '';\n    let stderr = '';\n\n    const timeoutId = setTimeout(() => {\n      child.kill('SIGTERM');\n    }, timeoutMs);\n\n    const finish = (result: AutoUpdateResult) => {\n      clearTimeout(timeoutId);\n      resolve(result);\n    };\n\n    child.stdout?.on('data', (chunk: Buffer) => {\n      stdout += chunk.toString();\n      if (stdout.length > 64_000) stdout = stdout.slice(-32_000);\n    });\n    child.stderr?.on('data', (chunk: Buffer) => {\n      stderr += chunk.toString();\n      if (stderr.length > 64_000) stderr = stderr.slice(-32_000);\n    });\n\n    child.on('error', (err) => {\n      finish({ ok: false, exitCode: null, reason: String(err), stdout, stderr });\n    });\n\n    child.on('exit', (code, signal) => {\n      if (signal === 'SIGTERM' || code === 143) {\n        finish({ ok: false, exitCode: code, reason: 'timeout', stdout, stderr });\n        return;\n      }\n      finish({\n        ok: code === 0,\n        exitCode: code,\n        reason: code === 0 ? undefined : 'non-zero-exit',\n        stdout,\n        stderr,\n      });\n    });\n  });\n}\n\n/**\n * Resolve the argv array for spawning the update command.\n *\n * Priority:\n * 1. process.execPath + process.argv[1] (current runtime + entry point)\n * 2. process.execPath + known dist entry points in root\n * 3. Fallback to bare `xopc` (assumes global install)\n */\nasync function resolveUpdateCommandArgv(\n  baseArgs: string[],\n  root: string | null,\n): Promise<string[]> {\n  const execPath = process.execPath?.trim();\n  const argv1 = process.argv[1]?.trim();\n\n  // Best case: we know both the runtime and the entry point\n  if (execPath && argv1) {\n    return [execPath, argv1, ...baseArgs];\n  }\n\n  // Try known entry points in the package root\n  if (execPath && root) {\n    const candidates = [join(root, 'dist/src/cli/index.js'), join(root, 'dist/index.js')];\n    for (const candidate of candidates) {\n      try {\n        await access(candidate);\n        return [execPath, candidate, ...baseArgs];\n      } catch {\n        // try next\n      }\n    }\n  }\n\n  // Fallback: rely on global PATH\n  return ['xopc', ...baseArgs];\n}\n"],"mappings":";;;;AAQA,MAAM,yBAAyB,OAAU;;;;;;AAezC,eAAsB,qBAAqB,QAIb;CAC5B,MAAM,YAAY,OAAO,aAAa;CAGtC,MAAM,OAAO,MAAM,yBAFF;EAAC;EAAU;EAAS;EAAa,OAAO;EAAS;EAAS,EAErB,OAAO,QAAQ,KAAK;AAE1E,QAAO,IAAI,SAA2B,YAAY;EAChD,MAAM,QAAQ,MAAM,KAAK,IAAI,KAAK,MAAM,EAAE,EAAE;GAC1C,KAAK;IACH,GAAG,QAAQ;IACX,kBAAkB;IACnB;GACD,OAAO;IAAC;IAAU;IAAQ;IAAO;GACjC,UAAU;GACX,CAAC;EAEF,IAAI,SAAS;EACb,IAAI,SAAS;EAEb,MAAM,YAAY,iBAAiB;AACjC,SAAM,KAAK,UAAU;KACpB,UAAU;EAEb,MAAM,UAAU,WAA6B;AAC3C,gBAAa,UAAU;AACvB,WAAQ,OAAO;;AAGjB,QAAM,QAAQ,GAAG,SAAS,UAAkB;AAC1C,aAAU,MAAM,UAAU;AAC1B,OAAI,OAAO,SAAS,KAAQ,UAAS,OAAO,MAAM,MAAQ;IAC1D;AACF,QAAM,QAAQ,GAAG,SAAS,UAAkB;AAC1C,aAAU,MAAM,UAAU;AAC1B,OAAI,OAAO,SAAS,KAAQ,UAAS,OAAO,MAAM,MAAQ;IAC1D;AAEF,QAAM,GAAG,UAAU,QAAQ;AACzB,UAAO;IAAE,IAAI;IAAO,UAAU;IAAM,QAAQ,OAAO,IAAI;IAAE;IAAQ;IAAQ,CAAC;IAC1E;AAEF,QAAM,GAAG,SAAS,MAAM,WAAW;AACjC,OAAI,WAAW,aAAa,SAAS,KAAK;AACxC,WAAO;KAAE,IAAI;KAAO,UAAU;KAAM,QAAQ;KAAW;KAAQ;KAAQ,CAAC;AACxE;;AAEF,UAAO;IACL,IAAI,SAAS;IACb,UAAU;IACV,QAAQ,SAAS,IAAI,KAAA,IAAY;IACjC;IACA;IACD,CAAC;IACF;GACF;;;;;;;;;;AAWJ,eAAe,yBACb,UACA,MACmB;CACnB,MAAM,WAAW,QAAQ,UAAU,MAAM;CACzC,MAAM,QAAQ,QAAQ,KAAK,IAAI,MAAM;AAGrC,KAAI,YAAY,MACd,QAAO;EAAC;EAAU;EAAO,GAAG;EAAS;AAIvC,KAAI,YAAY,MAAM;EACpB,MAAM,aAAa,CAAC,KAAK,MAAM,wBAAwB,EAAE,KAAK,MAAM,gBAAgB,CAAC;AACrF,OAAK,MAAM,aAAa,WACtB,KAAI;AACF,SAAM,OAAO,UAAU;AACvB,UAAO;IAAC;IAAU;IAAW,GAAG;IAAS;UACnC;;AAOZ,QAAO,CAAC,QAAQ,GAAG,SAAS"}