pi-background-tasks 2.5.0 → 2.6.0

package/dist/src/core/pi-launch.js

@@ -0,0 +1,431 @@
+import { accessSync, constants, readFileSync, realpathSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { basename, delimiter, dirname, extname, isAbsolute, join, relative, resolve, sep, win32 as win32Path, } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export class PiLaunchResolutionError extends Error {
+    code = 'pi_executable_resolution_failed';
+    constructor(message) {
+        super(`pi_executable_resolution_failed: ${message}`);
+        this.name = 'PiLaunchResolutionError';
+    }
+}
+export class PiCommandLineLimitError extends Error {
+    code = 'pi_command_line_too_long';
+    stage;
+    measuredLength;
+    limit;
+    constructor(stage, measuredLength, limit) {
+        super(`pi_command_line_too_long: ${stage} measured UTF-16 command line length ${String(measuredLength)} exceeds limit ${String(limit)}`);
+        this.name = 'PiCommandLineLimitError';
+        this.stage = stage;
+        this.measuredLength = measuredLength;
+        this.limit = limit;
+    }
+}
+const PI_PACKAGE_NAME = '@earendil-works/pi-coding-agent';
+const PI_PACKAGE_MANIFEST = `${PI_PACKAGE_NAME}/package.json`;
+const WINDOWS_COMMAND_LINE_LIMIT = 32767;
+const JAVASCRIPT_EXTENSIONS = new Set(['.js', '.cjs', '.mjs']);
+const WINDOWS_NATIVE_EXTENSIONS = new Set(['.exe', '.com']);
+class HostIsNotPiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HostIsNotPiError';
+    }
+}
+class LaunchPathOperationError extends Error {
+    operation;
+    path;
+    pathCause;
+    constructor(operation, path, cause) {
+        super(`${operation} failed for ${path}: ${errorMessage(cause)}`, { cause });
+        this.name = 'LaunchPathOperationError';
+        this.operation = operation;
+        this.path = path;
+        this.pathCause = cause;
+    }
+}
+const nodeLaunchIo = {
+    readFile: (path) => readFileSync(path),
+    realpath: (path) => realpathSync(path),
+    stat: (path) => statSync(path),
+    access: (path, mode) => accessSync(path, mode),
+};
+function launchIo(deps) {
+    return {
+        readFile: deps.readFile ?? nodeLaunchIo.readFile,
+        realpath: deps.realpath ?? nodeLaunchIo.realpath,
+        stat: deps.stat ?? nodeLaunchIo.stat,
+        access: deps.access ?? nodeLaunchIo.access,
+    };
+}
+function failResolution(message) {
+    throw new PiLaunchResolutionError(message);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function pathOperation(label, path, action) {
+    try {
+        return action();
+    }
+    catch (error) {
+        throw new LaunchPathOperationError(label, path, error);
+    }
+}
+function isMissingPathError(error) {
+    if (typeof error !== 'object' || error === null)
+        return false;
+    const code = Reflect.get(error, 'code');
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+function isJsonRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseManifest(raw, manifestPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(Buffer.isBuffer(raw) ? raw.toString('utf8') : raw);
+    }
+    catch (error) {
+        throw new Error(`manifest JSON is invalid at ${manifestPath}: ${errorMessage(error)}`);
+    }
+    if (!isJsonRecord(parsed))
+        throw new Error(`manifest is not an object at ${manifestPath}`);
+    return parsed;
+}
+function packageName(manifest, manifestPath) {
+    const name = manifest['name'];
+    if (name === undefined)
+        return undefined;
+    if (typeof name !== 'string' || name.trim().length === 0) {
+        throw new Error(`manifest name is malformed at ${manifestPath}`);
+    }
+    return name;
+}
+function requirePiPackageName(manifest, manifestPath) {
+    const name = packageName(manifest, manifestPath);
+    if (name !== PI_PACKAGE_NAME) {
+        throw new Error(`manifest package name must be ${PI_PACKAGE_NAME} at ${manifestPath}; received ${name === undefined ? '<missing>' : name}`);
+    }
+}
+function readPiBin(manifest, manifestPath) {
+    const bin = manifest['bin'];
+    if (typeof bin === 'string' && bin.trim().length > 0)
+        return bin;
+    if (isJsonRecord(bin)) {
+        const pi = bin['pi'];
+        if (typeof pi === 'string' && pi.trim().length > 0)
+            return pi;
+    }
+    throw new Error(`manifest bin.pi is missing or malformed at ${manifestPath}`);
+}
+function pathInside(parent, child) {
+    const rel = relative(parent, child);
+    return rel === '' || (!isAbsolute(rel) && rel !== '..' && !rel.startsWith(`..${sep}`));
+}
+function findNearestNamedManifest(sourcePath, io) {
+    const sourceReal = pathOperation('source realpath', sourcePath, () => io.realpath(sourcePath));
+    let dir = dirname(sourceReal);
+    for (;;) {
+        const candidate = join(dir, 'package.json');
+        let candidateStat;
+        try {
+            candidateStat = io.stat(candidate);
+        }
+        catch (error) {
+            if (!isMissingPathError(error)) {
+                throw new Error(`manifest stat failed for ${candidate}: ${errorMessage(error)}`);
+            }
+            const parent = dirname(dir);
+            if (parent === dir) {
+                throw new HostIsNotPiError(`no named package manifest above ${sourceReal}`);
+            }
+            dir = parent;
+            continue;
+        }
+        if (!candidateStat.isFile()) {
+            throw new Error(`package boundary manifest is not a regular file at ${candidate}`);
+        }
+        const manifest = parseManifest(pathOperation('manifest read', candidate, () => io.readFile(candidate)), candidate);
+        const name = packageName(manifest, candidate);
+        if (name !== undefined)
+            return { manifestPath: candidate, sourceReal, name };
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new HostIsNotPiError(`no named package manifest above ${sourceReal}`);
+        }
+        dir = parent;
+    }
+}
+function findPiManifestFromHostScript(hostScript, io) {
+    if (!hostScript)
+        throw new HostIsNotPiError('host script path is unavailable');
+    let found;
+    try {
+        found = findNearestNamedManifest(hostScript, io);
+    }
+    catch (error) {
+        if (error instanceof HostIsNotPiError)
+            throw error;
+        if (error instanceof LaunchPathOperationError &&
+            error.operation === 'source realpath' &&
+            isMissingPathError(error.pathCause)) {
+            throw new HostIsNotPiError(error.message);
+        }
+        throw error;
+    }
+    if (found.name !== PI_PACKAGE_NAME) {
+        throw new HostIsNotPiError(`nearest named manifest above host script belongs to ${found.name}: ${found.manifestPath}`);
+    }
+    return found;
+}
+/**
+ * Resolve only a genuine running Pi package. This helper performs package-boundary
+ * discovery; resolvePiLaunch() additionally validates bin.pi and host/bin identity.
+ */
+export function resolvePiManifestFromHostScript(hostScript, deps = {}) {
+    return findPiManifestFromHostScript(hostScript, launchIo(deps)).manifestPath;
+}
+function normalizeResolvedModulePath(pathOrUrl) {
+    return pathOrUrl.startsWith('file:') ? fileURLToPath(pathOrUrl) : pathOrUrl;
+}
+function defaultResolveModule(specifier) {
+    if (specifier === PI_PACKAGE_MANIFEST) {
+        return createRequire(import.meta.url).resolve(specifier);
+    }
+    return normalizeResolvedModulePath(import.meta.resolve(specifier));
+}
+function resolvePiManifestFromModules(deps, io) {
+    if (deps.resolvePackageJson) {
+        return normalizeResolvedModulePath(deps.resolvePackageJson(PI_PACKAGE_MANIFEST));
+    }
+    const resolveModule = deps.resolveModule ?? defaultResolveModule;
+    let manifestError;
+    try {
+        return normalizeResolvedModulePath(resolveModule(PI_PACKAGE_MANIFEST));
+    }
+    catch (error) {
+        manifestError = error;
+    }
+    let packageEntry;
+    try {
+        packageEntry = normalizeResolvedModulePath(resolveModule(PI_PACKAGE_NAME));
+    }
+    catch (entryError) {
+        throw new Error(`package manifest resolve failed for ${PI_PACKAGE_MANIFEST}: ${errorMessage(manifestError)}; package entry resolve failed: ${errorMessage(entryError)}`);
+    }
+    let found;
+    try {
+        found = findNearestNamedManifest(packageEntry, io);
+    }
+    catch (searchError) {
+        throw new Error(`package manifest resolve failed for ${PI_PACKAGE_MANIFEST}: ${errorMessage(manifestError)}; package entry manifest search failed: ${errorMessage(searchError)}`);
+    }
+    if (found.name !== PI_PACKAGE_NAME) {
+        throw new Error(`package entry nearest named manifest belongs to ${found.name}: ${found.manifestPath}`);
+    }
+    return found.manifestPath;
+}
+function executableBasename(execPath, platform) {
+    return platform === 'win32' ? win32Path.basename(execPath) : basename(execPath);
+}
+function isGenericJavaScriptRuntime(execPath, platform) {
+    return /^(?:node|nodejs|bun)(?:\.exe)?$/i.test(executableBasename(execPath, platform));
+}
+function resolveCompiledHostLaunch(deps, io, platform) {
+    const execPath = deps.execPath ?? process.execPath;
+    const executableName = executableBasename(execPath, platform);
+    const isNamedPiExecutable = platform === 'win32' ? /^pi\.(?:exe|com)$/i.test(executableName) : executableName === 'pi';
+    // A Bun virtual script path describes packaging mechanics shared by every
+    // compiled SDK application; it is not Pi CLI authority. Retain the direct
+    // route only for the established Pi executable name.
+    if (isGenericJavaScriptRuntime(execPath, platform) || !isNamedPiExecutable)
+        return undefined;
+    const executableReal = pathOperation('compiled host realpath', execPath, () => io.realpath(execPath));
+    const executableStat = pathOperation('compiled host stat', executableReal, () => io.stat(executableReal));
+    if (!executableStat.isFile())
+        throw new Error('compiled Pi host is not a regular file');
+    if (platform === 'win32') {
+        if (!WINDOWS_NATIVE_EXTENSIONS.has(extname(executableReal).toLowerCase())) {
+            throw new Error('compiled Windows Pi host must be an .exe or .com file');
+        }
+    }
+    else {
+        pathOperation('compiled host execute access', executableReal, () => io.access(executableReal, constants.X_OK));
+    }
+    return { executable: executableReal, argvPrefix: [], kind: 'compiled-host' };
+}
+function resolvePackageLaunch(manifestPath, deps, io, platform, expectedHostReal) {
+    const manifestReal = pathOperation('manifest realpath', manifestPath, () => io.realpath(manifestPath));
+    if (basename(manifestReal).toLowerCase() !== 'package.json') {
+        throw new Error(`resolved Pi manifest is not package.json: ${manifestReal}`);
+    }
+    const manifestStat = pathOperation('manifest stat', manifestReal, () => io.stat(manifestReal));
+    if (!manifestStat.isFile())
+        throw new Error(`Pi package manifest is not a regular file: ${manifestReal}`);
+    const manifest = parseManifest(pathOperation('manifest read', manifestReal, () => io.readFile(manifestReal)), manifestReal);
+    requirePiPackageName(manifest, manifestReal);
+    const packageRootReal = pathOperation('package root realpath', dirname(manifestReal), () => io.realpath(dirname(manifestReal)));
+    if (!pathInside(packageRootReal, manifestReal)) {
+        throw new Error('Pi package manifest resolves outside the package root');
+    }
+    const bin = readPiBin(manifest, manifestReal);
+    if (isAbsolute(bin) ||
+        (platform === 'win32' && (win32Path.isAbsolute(bin) || /^[a-z]:/i.test(bin))))
+        throw new Error('Pi package bin target must not be absolute; it must be relative to the package root');
+    const targetCandidate = resolve(packageRootReal, bin);
+    if (!pathInside(packageRootReal, targetCandidate)) {
+        throw new Error('Pi package bin target path escapes the package root');
+    }
+    const targetReal = pathOperation('bin target realpath', targetCandidate, () => io.realpath(targetCandidate));
+    if (!pathInside(packageRootReal, targetReal)) {
+        throw new Error('Pi package bin target resolves outside the package root');
+    }
+    const targetStat = pathOperation('bin target stat', targetReal, () => io.stat(targetReal));
+    if (!targetStat.isFile())
+        throw new Error('Pi package bin target is not a regular file');
+    if (expectedHostReal !== undefined && targetReal !== expectedHostReal) {
+        throw new Error(`running host script does not match manifest bin.pi: host ${expectedHostReal}; bin ${targetReal}`);
+    }
+    const extension = extname(targetReal).toLowerCase();
+    if (JAVASCRIPT_EXTENSIONS.has(extension)) {
+        const execPath = deps.execPath ?? process.execPath;
+        if (!isGenericJavaScriptRuntime(execPath, platform)) {
+            throw new Error(`Pi package JavaScript bin cannot launch through a non-generic JavaScript runtime: ${execPath}`);
+        }
+        return { executable: execPath, argvPrefix: [targetReal], kind: 'package-node-cli' };
+    }
+    if (platform === 'win32' && WINDOWS_NATIVE_EXTENSIONS.has(extension)) {
+        // Keep the historical package launch kind for compatibility; argvPrefix
+        // distinguishes this direct native form from the JavaScript package form.
+        return { executable: targetReal, argvPrefix: [], kind: 'package-node-cli' };
+    }
+    throw new Error(`Pi package bin target extension is unsupported: ${extension || '<none>'}`);
+}
+function resolveExecutableOnPosixPath(deps, io) {
+    const rawPath = deps.path ?? process.env['PATH'] ?? '';
+    const diagnostics = [];
+    if (rawPath.length === 0)
+        diagnostics.push('PATH is empty');
+    for (const entry of rawPath.split(delimiter)) {
+        const directory = entry.length === 0 ? process.cwd() : entry;
+        const candidate = resolve(directory, 'pi');
+        let candidateReal;
+        try {
+            candidateReal = io.realpath(candidate);
+        }
+        catch (error) {
+            diagnostics.push(`${candidate}: ${errorMessage(error)}`);
+            continue;
+        }
+        try {
+            if (!io.stat(candidateReal).isFile()) {
+                diagnostics.push(`${candidateReal} is not a regular file`);
+                continue;
+            }
+            io.access(candidateReal, constants.X_OK);
+        }
+        catch (error) {
+            diagnostics.push(`${candidateReal} is not executable: ${errorMessage(error)}`);
+            continue;
+        }
+        return {
+            // Bind the launch plan to the exact canonical executable admitted above.
+            // A later cwd or environment/PATH change must not trigger a second lookup.
+            launch: { executable: candidateReal, argvPrefix: [], kind: 'path' },
+            diagnostics,
+        };
+    }
+    return { diagnostics };
+}
+export function resolvePiLaunch(deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const io = launchIo(deps);
+    try {
+        const compiled = resolveCompiledHostLaunch(deps, io, platform);
+        if (compiled)
+            return compiled;
+    }
+    catch (error) {
+        failResolution(errorMessage(error));
+    }
+    const hostScript = deps.hostScript ?? process.argv[1];
+    let pathDiagnostic;
+    if (platform !== 'win32') {
+        const pathResult = resolveExecutableOnPosixPath(deps, io);
+        if (pathResult.launch)
+            return pathResult.launch;
+        pathDiagnostic = `no executable pi on PATH (${pathResult.diagnostics.join('; ') || 'no candidates'})`;
+    }
+    let hostDiagnostic = 'host script was not inspected';
+    try {
+        const host = findPiManifestFromHostScript(hostScript, io);
+        // A manifest that identifies the running host as Pi is authoritative. Never
+        // hide its invalid bin/identity behind another module installation.
+        return resolvePackageLaunch(host.manifestPath, deps, io, platform, host.sourceReal);
+    }
+    catch (error) {
+        // Only genuine absence or a positively foreign package identity permits the
+        // exact installed-module route. I/O and integrity failures remain fatal.
+        if (!(error instanceof HostIsNotPiError))
+            failResolution(errorMessage(error));
+        hostDiagnostic = errorMessage(error);
+    }
+    let manifestPath;
+    try {
+        manifestPath = resolvePiManifestFromModules(deps, io);
+    }
+    catch (error) {
+        const prefix = pathDiagnostic === undefined ? '' : `${pathDiagnostic}; `;
+        failResolution(`${prefix}${errorMessage(error)}; running host lookup: ${hostDiagnostic}`);
+    }
+    try {
+        return resolvePackageLaunch(manifestPath, deps, io, platform);
+    }
+    catch (error) {
+        failResolution(errorMessage(error));
+    }
+}
+export function piLaunchArgv(launch, piArgs) {
+    return [...launch.argvPrefix, ...piArgs];
+}
+function renderWindowsArgument(value) {
+    if (value.length > 0 && !/[ \t"]/.test(value))
+        return value;
+    let rendered = '"';
+    let backslashes = 0;
+    for (const char of value) {
+        if (char === '\\') {
+            backslashes += 1;
+            continue;
+        }
+        if (char === '"') {
+            rendered += '\\'.repeat(backslashes * 2 + 1);
+            rendered += '"';
+            backslashes = 0;
+            continue;
+        }
+        if (backslashes > 0) {
+            rendered += '\\'.repeat(backslashes);
+            backslashes = 0;
+        }
+        rendered += char;
+    }
+    if (backslashes > 0)
+        rendered += '\\'.repeat(backslashes * 2);
+    rendered += '"';
+    return rendered;
+}
+function renderWindowsCommandLine(parts) {
+    return parts.map(renderWindowsArgument).join(' ');
+}
+export function assertWindowsCommandLineWithinLimit(launch, piArgs, platform, stage) {
+    if (platform !== 'win32')
+        return;
+    const measuredLength = renderWindowsCommandLine([launch.executable, ...launch.argvPrefix, ...piArgs]).length + 1;
+    if (measuredLength > WINDOWS_COMMAND_LINE_LIMIT) {
+        throw new PiCommandLineLimitError(stage, measuredLength, WINDOWS_COMMAND_LINE_LIMIT);
+    }
+}
+//# sourceMappingURL=pi-launch.js.map

package/dist/src/core/pi-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-launch.js","sourceRoot":"","sources":["../../../src/core/pi-launch.ts"],"names":[],"mappings":"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","sourcesContent":["import { accessSync, constants, readFileSync, realpathSync, statSync } from 'node:fs';\nimport type { Stats } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport {\n  basename,\n  delimiter,\n  dirname,\n  extname,\n  isAbsolute,\n  join,\n  relative,\n  resolve,\n  sep,\n  win32 as win32Path,\n} from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport interface PiLaunchSpec {\n  readonly executable: string;\n  readonly argvPrefix: readonly string[];\n  readonly kind: 'path' | 'package-node-cli' | 'compiled-host';\n}\n\nexport interface PiLaunchDependencies {\n  readonly platform?: NodeJS.Platform;\n  readonly execPath?: string;\n  readonly hostScript?: string;\n  readonly path?: string;\n  readonly resolvePackageJson?: (specifier: string) => string;\n  readonly resolveModule?: (specifier: string) => string;\n  readonly readFile?: (path: string) => string | Buffer;\n  readonly realpath?: (path: string) => string;\n  readonly stat?: (path: string) => Pick<Stats, 'isFile'>;\n  readonly access?: (path: string, mode?: number) => void;\n}\n\nexport class PiLaunchResolutionError extends Error {\n  readonly code = 'pi_executable_resolution_failed';\n\n  constructor(message: string) {\n    super(`pi_executable_resolution_failed: ${message}`);\n    this.name = 'PiLaunchResolutionError';\n  }\n}\n\nexport class PiCommandLineLimitError extends Error {\n  readonly code = 'pi_command_line_too_long';\n  readonly stage: string;\n  readonly measuredLength: number;\n  readonly limit: number;\n\n  constructor(stage: string, measuredLength: number, limit: number) {\n    super(\n      `pi_command_line_too_long: ${stage} measured UTF-16 command line length ${String(measuredLength)} exceeds limit ${String(limit)}`,\n    );\n    this.name = 'PiCommandLineLimitError';\n    this.stage = stage;\n    this.measuredLength = measuredLength;\n    this.limit = limit;\n  }\n}\n\nconst PI_PACKAGE_NAME = '@earendil-works/pi-coding-agent';\nconst PI_PACKAGE_MANIFEST = `${PI_PACKAGE_NAME}/package.json`;\nconst WINDOWS_COMMAND_LINE_LIMIT = 32767;\nconst JAVASCRIPT_EXTENSIONS = new Set(['.js', '.cjs', '.mjs']);\nconst WINDOWS_NATIVE_EXTENSIONS = new Set(['.exe', '.com']);\n\ninterface JsonRecord {\n  readonly [key: string]: unknown;\n}\n\ninterface LaunchIo {\n  readonly readFile: (path: string) => string | Buffer;\n  readonly realpath: (path: string) => string;\n  readonly stat: (path: string) => Pick<Stats, 'isFile'>;\n  readonly access: (path: string, mode?: number) => void;\n}\n\ninterface NamedManifest {\n  readonly manifestPath: string;\n  readonly sourceReal: string;\n  readonly name: string;\n}\n\nclass HostIsNotPiError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'HostIsNotPiError';\n  }\n}\n\nclass LaunchPathOperationError extends Error {\n  readonly operation: string;\n  readonly path: string;\n  readonly pathCause: unknown;\n\n  constructor(operation: string, path: string, cause: unknown) {\n    super(`${operation} failed for ${path}: ${errorMessage(cause)}`, { cause });\n    this.name = 'LaunchPathOperationError';\n    this.operation = operation;\n    this.path = path;\n    this.pathCause = cause;\n  }\n}\n\nconst nodeLaunchIo: LaunchIo = {\n  readFile: (path) => readFileSync(path),\n  realpath: (path) => realpathSync(path),\n  stat: (path) => statSync(path),\n  access: (path, mode) => accessSync(path, mode),\n};\n\nfunction launchIo(deps: PiLaunchDependencies): LaunchIo {\n  return {\n    readFile: deps.readFile ?? nodeLaunchIo.readFile,\n    realpath: deps.realpath ?? nodeLaunchIo.realpath,\n    stat: deps.stat ?? nodeLaunchIo.stat,\n    access: deps.access ?? nodeLaunchIo.access,\n  };\n}\n\nfunction failResolution(message: string): never {\n  throw new PiLaunchResolutionError(message);\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction pathOperation<T>(label: string, path: string, action: () => T): T {\n  try {\n    return action();\n  } catch (error) {\n    throw new LaunchPathOperationError(label, path, error);\n  }\n}\n\nfunction isMissingPathError(error: unknown): boolean {\n  if (typeof error !== 'object' || error === null) return false;\n  const code = Reflect.get(error, 'code');\n  return code === 'ENOENT' || code === 'ENOTDIR';\n}\n\nfunction isJsonRecord(value: unknown): value is JsonRecord {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction parseManifest(raw: string | Buffer, manifestPath: string): JsonRecord {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(Buffer.isBuffer(raw) ? raw.toString('utf8') : raw);\n  } catch (error) {\n    throw new Error(`manifest JSON is invalid at ${manifestPath}: ${errorMessage(error)}`);\n  }\n  if (!isJsonRecord(parsed)) throw new Error(`manifest is not an object at ${manifestPath}`);\n  return parsed;\n}\n\nfunction packageName(manifest: JsonRecord, manifestPath: string): string | undefined {\n  const name = manifest['name'];\n  if (name === undefined) return undefined;\n  if (typeof name !== 'string' || name.trim().length === 0) {\n    throw new Error(`manifest name is malformed at ${manifestPath}`);\n  }\n  return name;\n}\n\nfunction requirePiPackageName(manifest: JsonRecord, manifestPath: string): void {\n  const name = packageName(manifest, manifestPath);\n  if (name !== PI_PACKAGE_NAME) {\n    throw new Error(\n      `manifest package name must be ${PI_PACKAGE_NAME} at ${manifestPath}; received ${name === undefined ? '<missing>' : name}`,\n    );\n  }\n}\n\nfunction readPiBin(manifest: JsonRecord, manifestPath: string): string {\n  const bin = manifest['bin'];\n  if (typeof bin === 'string' && bin.trim().length > 0) return bin;\n  if (isJsonRecord(bin)) {\n    const pi = bin['pi'];\n    if (typeof pi === 'string' && pi.trim().length > 0) return pi;\n  }\n  throw new Error(`manifest bin.pi is missing or malformed at ${manifestPath}`);\n}\n\nfunction pathInside(parent: string, child: string): boolean {\n  const rel = relative(parent, child);\n  return rel === '' || (!isAbsolute(rel) && rel !== '..' && !rel.startsWith(`..${sep}`));\n}\n\nfunction findNearestNamedManifest(sourcePath: string, io: LaunchIo): NamedManifest {\n  const sourceReal = pathOperation('source realpath', sourcePath, () => io.realpath(sourcePath));\n  let dir = dirname(sourceReal);\n  for (;;) {\n    const candidate = join(dir, 'package.json');\n    let candidateStat: Pick<Stats, 'isFile'>;\n    try {\n      candidateStat = io.stat(candidate);\n    } catch (error) {\n      if (!isMissingPathError(error)) {\n        throw new Error(`manifest stat failed for ${candidate}: ${errorMessage(error)}`);\n      }\n      const parent = dirname(dir);\n      if (parent === dir) {\n        throw new HostIsNotPiError(`no named package manifest above ${sourceReal}`);\n      }\n      dir = parent;\n      continue;\n    }\n    if (!candidateStat.isFile()) {\n      throw new Error(`package boundary manifest is not a regular file at ${candidate}`);\n    }\n    const manifest = parseManifest(\n      pathOperation('manifest read', candidate, () => io.readFile(candidate)),\n      candidate,\n    );\n    const name = packageName(manifest, candidate);\n    if (name !== undefined) return { manifestPath: candidate, sourceReal, name };\n\n    const parent = dirname(dir);\n    if (parent === dir) {\n      throw new HostIsNotPiError(`no named package manifest above ${sourceReal}`);\n    }\n    dir = parent;\n  }\n}\n\nfunction findPiManifestFromHostScript(hostScript: string | undefined, io: LaunchIo): NamedManifest {\n  if (!hostScript) throw new HostIsNotPiError('host script path is unavailable');\n  let found: NamedManifest;\n  try {\n    found = findNearestNamedManifest(hostScript, io);\n  } catch (error) {\n    if (error instanceof HostIsNotPiError) throw error;\n    if (\n      error instanceof LaunchPathOperationError &&\n      error.operation === 'source realpath' &&\n      isMissingPathError(error.pathCause)\n    ) {\n      throw new HostIsNotPiError(error.message);\n    }\n    throw error;\n  }\n  if (found.name !== PI_PACKAGE_NAME) {\n    throw new HostIsNotPiError(\n      `nearest named manifest above host script belongs to ${found.name}: ${found.manifestPath}`,\n    );\n  }\n  return found;\n}\n\n/**\n * Resolve only a genuine running Pi package. This helper performs package-boundary\n * discovery; resolvePiLaunch() additionally validates bin.pi and host/bin identity.\n */\nexport function resolvePiManifestFromHostScript(\n  hostScript: string | undefined,\n  deps: Pick<PiLaunchDependencies, 'readFile' | 'realpath' | 'stat' | 'access'> = {},\n): string {\n  return findPiManifestFromHostScript(hostScript, launchIo(deps)).manifestPath;\n}\n\nfunction normalizeResolvedModulePath(pathOrUrl: string): string {\n  return pathOrUrl.startsWith('file:') ? fileURLToPath(pathOrUrl) : pathOrUrl;\n}\n\nfunction defaultResolveModule(specifier: string): string {\n  if (specifier === PI_PACKAGE_MANIFEST) {\n    return createRequire(import.meta.url).resolve(specifier);\n  }\n  return normalizeResolvedModulePath(import.meta.resolve(specifier));\n}\n\nfunction resolvePiManifestFromModules(deps: PiLaunchDependencies, io: LaunchIo): string {\n  if (deps.resolvePackageJson) {\n    return normalizeResolvedModulePath(deps.resolvePackageJson(PI_PACKAGE_MANIFEST));\n  }\n\n  const resolveModule = deps.resolveModule ?? defaultResolveModule;\n  let manifestError: unknown;\n  try {\n    return normalizeResolvedModulePath(resolveModule(PI_PACKAGE_MANIFEST));\n  } catch (error) {\n    manifestError = error;\n  }\n\n  let packageEntry: string;\n  try {\n    packageEntry = normalizeResolvedModulePath(resolveModule(PI_PACKAGE_NAME));\n  } catch (entryError) {\n    throw new Error(\n      `package manifest resolve failed for ${PI_PACKAGE_MANIFEST}: ${errorMessage(manifestError)}; package entry resolve failed: ${errorMessage(entryError)}`,\n    );\n  }\n\n  let found: NamedManifest;\n  try {\n    found = findNearestNamedManifest(packageEntry, io);\n  } catch (searchError) {\n    throw new Error(\n      `package manifest resolve failed for ${PI_PACKAGE_MANIFEST}: ${errorMessage(manifestError)}; package entry manifest search failed: ${errorMessage(searchError)}`,\n    );\n  }\n  if (found.name !== PI_PACKAGE_NAME) {\n    throw new Error(\n      `package entry nearest named manifest belongs to ${found.name}: ${found.manifestPath}`,\n    );\n  }\n  return found.manifestPath;\n}\n\nfunction executableBasename(execPath: string, platform: NodeJS.Platform): string {\n  return platform === 'win32' ? win32Path.basename(execPath) : basename(execPath);\n}\n\nfunction isGenericJavaScriptRuntime(execPath: string, platform: NodeJS.Platform): boolean {\n  return /^(?:node|nodejs|bun)(?:\\.exe)?$/i.test(executableBasename(execPath, platform));\n}\n\nfunction resolveCompiledHostLaunch(\n  deps: PiLaunchDependencies,\n  io: LaunchIo,\n  platform: NodeJS.Platform,\n): PiLaunchSpec | undefined {\n  const execPath = deps.execPath ?? process.execPath;\n  const executableName = executableBasename(execPath, platform);\n  const isNamedPiExecutable =\n    platform === 'win32' ? /^pi\\.(?:exe|com)$/i.test(executableName) : executableName === 'pi';\n  // A Bun virtual script path describes packaging mechanics shared by every\n  // compiled SDK application; it is not Pi CLI authority. Retain the direct\n  // route only for the established Pi executable name.\n  if (isGenericJavaScriptRuntime(execPath, platform) || !isNamedPiExecutable) return undefined;\n\n  const executableReal = pathOperation('compiled host realpath', execPath, () => io.realpath(execPath));\n  const executableStat = pathOperation('compiled host stat', executableReal, () =>\n    io.stat(executableReal),\n  );\n  if (!executableStat.isFile()) throw new Error('compiled Pi host is not a regular file');\n  if (platform === 'win32') {\n    if (!WINDOWS_NATIVE_EXTENSIONS.has(extname(executableReal).toLowerCase())) {\n      throw new Error('compiled Windows Pi host must be an .exe or .com file');\n    }\n  } else {\n    pathOperation('compiled host execute access', executableReal, () =>\n      io.access(executableReal, constants.X_OK),\n    );\n  }\n  return { executable: executableReal, argvPrefix: [], kind: 'compiled-host' };\n}\n\nfunction resolvePackageLaunch(\n  manifestPath: string,\n  deps: PiLaunchDependencies,\n  io: LaunchIo,\n  platform: NodeJS.Platform,\n  expectedHostReal?: string,\n): PiLaunchSpec {\n  const manifestReal = pathOperation('manifest realpath', manifestPath, () => io.realpath(manifestPath));\n  if (basename(manifestReal).toLowerCase() !== 'package.json') {\n    throw new Error(`resolved Pi manifest is not package.json: ${manifestReal}`);\n  }\n  const manifestStat = pathOperation('manifest stat', manifestReal, () => io.stat(manifestReal));\n  if (!manifestStat.isFile()) throw new Error(`Pi package manifest is not a regular file: ${manifestReal}`);\n\n  const manifest = parseManifest(\n    pathOperation('manifest read', manifestReal, () => io.readFile(manifestReal)),\n    manifestReal,\n  );\n  requirePiPackageName(manifest, manifestReal);\n  const packageRootReal = pathOperation('package root realpath', dirname(manifestReal), () =>\n    io.realpath(dirname(manifestReal)),\n  );\n  if (!pathInside(packageRootReal, manifestReal)) {\n    throw new Error('Pi package manifest resolves outside the package root');\n  }\n\n  const bin = readPiBin(manifest, manifestReal);\n  if (\n    isAbsolute(bin) ||\n    (platform === 'win32' && (win32Path.isAbsolute(bin) || /^[a-z]:/i.test(bin)))\n  )\n    throw new Error('Pi package bin target must not be absolute; it must be relative to the package root');\n  const targetCandidate = resolve(packageRootReal, bin);\n  if (!pathInside(packageRootReal, targetCandidate)) {\n    throw new Error('Pi package bin target path escapes the package root');\n  }\n  const targetReal = pathOperation('bin target realpath', targetCandidate, () =>\n    io.realpath(targetCandidate),\n  );\n  if (!pathInside(packageRootReal, targetReal)) {\n    throw new Error('Pi package bin target resolves outside the package root');\n  }\n  const targetStat = pathOperation('bin target stat', targetReal, () => io.stat(targetReal));\n  if (!targetStat.isFile()) throw new Error('Pi package bin target is not a regular file');\n  if (expectedHostReal !== undefined && targetReal !== expectedHostReal) {\n    throw new Error(\n      `running host script does not match manifest bin.pi: host ${expectedHostReal}; bin ${targetReal}`,\n    );\n  }\n\n  const extension = extname(targetReal).toLowerCase();\n  if (JAVASCRIPT_EXTENSIONS.has(extension)) {\n    const execPath = deps.execPath ?? process.execPath;\n    if (!isGenericJavaScriptRuntime(execPath, platform)) {\n      throw new Error(\n        `Pi package JavaScript bin cannot launch through a non-generic JavaScript runtime: ${execPath}`,\n      );\n    }\n    return { executable: execPath, argvPrefix: [targetReal], kind: 'package-node-cli' };\n  }\n  if (platform === 'win32' && WINDOWS_NATIVE_EXTENSIONS.has(extension)) {\n    // Keep the historical package launch kind for compatibility; argvPrefix\n    // distinguishes this direct native form from the JavaScript package form.\n    return { executable: targetReal, argvPrefix: [], kind: 'package-node-cli' };\n  }\n  throw new Error(`Pi package bin target extension is unsupported: ${extension || '<none>'}`);\n}\n\nfunction resolveExecutableOnPosixPath(\n  deps: PiLaunchDependencies,\n  io: LaunchIo,\n): { readonly launch?: PiLaunchSpec; readonly diagnostics: readonly string[] } {\n  const rawPath = deps.path ?? process.env['PATH'] ?? '';\n  const diagnostics: string[] = [];\n  if (rawPath.length === 0) diagnostics.push('PATH is empty');\n  for (const entry of rawPath.split(delimiter)) {\n    const directory = entry.length === 0 ? process.cwd() : entry;\n    const candidate = resolve(directory, 'pi');\n    let candidateReal: string;\n    try {\n      candidateReal = io.realpath(candidate);\n    } catch (error) {\n      diagnostics.push(`${candidate}: ${errorMessage(error)}`);\n      continue;\n    }\n    try {\n      if (!io.stat(candidateReal).isFile()) {\n        diagnostics.push(`${candidateReal} is not a regular file`);\n        continue;\n      }\n      io.access(candidateReal, constants.X_OK);\n    } catch (error) {\n      diagnostics.push(`${candidateReal} is not executable: ${errorMessage(error)}`);\n      continue;\n    }\n    return {\n      // Bind the launch plan to the exact canonical executable admitted above.\n      // A later cwd or environment/PATH change must not trigger a second lookup.\n      launch: { executable: candidateReal, argvPrefix: [], kind: 'path' },\n      diagnostics,\n    };\n  }\n  return { diagnostics };\n}\n\nexport function resolvePiLaunch(deps: PiLaunchDependencies = {}): PiLaunchSpec {\n  const platform = deps.platform ?? process.platform;\n  const io = launchIo(deps);\n\n  try {\n    const compiled = resolveCompiledHostLaunch(deps, io, platform);\n    if (compiled) return compiled;\n  } catch (error) {\n    failResolution(errorMessage(error));\n  }\n\n  const hostScript = deps.hostScript ?? process.argv[1];\n  let pathDiagnostic: string | undefined;\n  if (platform !== 'win32') {\n    const pathResult = resolveExecutableOnPosixPath(deps, io);\n    if (pathResult.launch) return pathResult.launch;\n    pathDiagnostic = `no executable pi on PATH (${pathResult.diagnostics.join('; ') || 'no candidates'})`;\n  }\n\n  let hostDiagnostic = 'host script was not inspected';\n  try {\n    const host = findPiManifestFromHostScript(hostScript, io);\n    // A manifest that identifies the running host as Pi is authoritative. Never\n    // hide its invalid bin/identity behind another module installation.\n    return resolvePackageLaunch(host.manifestPath, deps, io, platform, host.sourceReal);\n  } catch (error) {\n    // Only genuine absence or a positively foreign package identity permits the\n    // exact installed-module route. I/O and integrity failures remain fatal.\n    if (!(error instanceof HostIsNotPiError)) failResolution(errorMessage(error));\n    hostDiagnostic = errorMessage(error);\n  }\n\n  let manifestPath: string;\n  try {\n    manifestPath = resolvePiManifestFromModules(deps, io);\n  } catch (error) {\n    const prefix = pathDiagnostic === undefined ? '' : `${pathDiagnostic}; `;\n    failResolution(`${prefix}${errorMessage(error)}; running host lookup: ${hostDiagnostic}`);\n  }\n  try {\n    return resolvePackageLaunch(manifestPath, deps, io, platform);\n  } catch (error) {\n    failResolution(errorMessage(error));\n  }\n}\n\nexport function piLaunchArgv(launch: PiLaunchSpec, piArgs: readonly string[]): string[] {\n  return [...launch.argvPrefix, ...piArgs];\n}\n\nfunction renderWindowsArgument(value: string): string {\n  if (value.length > 0 && !/[ \\t\"]/.test(value)) return value;\n  let rendered = '\"';\n  let backslashes = 0;\n  for (const char of value) {\n    if (char === '\\\\') {\n      backslashes += 1;\n      continue;\n    }\n    if (char === '\"') {\n      rendered += '\\\\'.repeat(backslashes * 2 + 1);\n      rendered += '\"';\n      backslashes = 0;\n      continue;\n    }\n    if (backslashes > 0) {\n      rendered += '\\\\'.repeat(backslashes);\n      backslashes = 0;\n    }\n    rendered += char;\n  }\n  if (backslashes > 0) rendered += '\\\\'.repeat(backslashes * 2);\n  rendered += '\"';\n  return rendered;\n}\n\nfunction renderWindowsCommandLine(parts: readonly string[]): string {\n  return parts.map(renderWindowsArgument).join(' ');\n}\n\nexport function assertWindowsCommandLineWithinLimit(\n  launch: PiLaunchSpec,\n  piArgs: readonly string[],\n  platform: NodeJS.Platform,\n  stage: string,\n): void {\n  if (platform !== 'win32') return;\n  const measuredLength =\n    renderWindowsCommandLine([launch.executable, ...launch.argvPrefix, ...piArgs]).length + 1;\n  if (measuredLength > WINDOWS_COMMAND_LINE_LIMIT) {\n    throw new PiCommandLineLimitError(stage, measuredLength, WINDOWS_COMMAND_LINE_LIMIT);\n  }\n}\n"]}