@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/core/extensions/version-compat.js

@@ -1,217 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="849502d0-2616-500c-96de-228c0759459d")}catch(e){}}();
-function formatVersionBoundValue(value) {
-    return typeof value === "string" ? value : String(value);
-}
-/**
- * Parse a comparable release string into numeric segments, or `null` when it is
- * not an interpretable dotted-numeric version.
- *
- * Leniently strips a leading inclusive-minimum `>=` and an optional `v` prefix
- * (so `engines.pm`-style `">=2026.5.31"` and `"v1.2.3"` both parse), then drops
- * any build/pre-release suffix and keeps the leading dotted-numeric release.
- */
-export function parseComparableVersion(value) {
-    const normalized = value
-        .trim()
-        .replace(/^>=\s*/, "")
-        .replace(/^v/i, "");
-    const release = normalized.split(/[+-]/, 1)[0];
-    if (!/^\d+(?:[.-]\d+)*$/.test(release)) {
-        return null;
-    }
-    return release.split(/[.-]/).map((part) => Number(part));
-}
-/**
- * Compare two comparable version strings segment by segment.
- *
- * Returns `1` when `currentVersion` is greater, `-1` when it is smaller, `0` when
- * equal, and `null` when either side is not an interpretable version (so callers
- * can classify the comparison as `unchecked`). Missing trailing segments are
- * treated as `0`, so `1.2` and `1.2.0` compare equal.
- */
-export function compareComparableVersions(currentVersion, otherVersion) {
-    const currentParts = parseComparableVersion(currentVersion);
-    const otherParts = parseComparableVersion(otherVersion);
-    if (!currentParts || !otherParts) {
-        return null;
-    }
-    const width = Math.max(currentParts.length, otherParts.length);
-    for (let index = 0; index < width; index += 1) {
-        const current = currentParts[index] ?? 0;
-        const other = otherParts[index] ?? 0;
-        if (current > other) {
-            return 1;
-        }
-        if (current < other) {
-            return -1;
-        }
-    }
-    return 0;
-}
-/**
- * Evaluate a manifest `pm_min_version` inclusive lower bound against the current
- * pm version.
- *
- * An omitted bound is `absent`; a blank, non-string, or unparseable bound is
- * `invalid`; an unknown or incomparable current version is `unchecked`; a current
- * version below the bound is `unmet`; otherwise the bound is satisfied (`ok`).
- * `currentVersion` is `null` when the loader could not resolve the running CLI
- * version.
- */
-export function evaluatePmMinVersionBound(required, currentVersion) {
-    if (required === undefined || required === null) {
-        return {
-            kind: "pm_min_version",
-            status: "absent",
-            allowed: true,
-            required: "",
-            current: currentVersion,
-        };
-    }
-    const declared = formatVersionBoundValue(required);
-    if (typeof required !== "string" || declared.trim().length === 0) {
-        return {
-            kind: "pm_min_version",
-            status: "invalid",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (!parseComparableVersion(declared)) {
-        return {
-            kind: "pm_min_version",
-            status: "invalid",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (currentVersion === null) {
-        return {
-            kind: "pm_min_version",
-            status: "unchecked",
-            allowed: true,
-            required: declared,
-            current: null,
-        };
-    }
-    const comparison = compareComparableVersions(currentVersion, declared);
-    if (comparison === null) {
-        return {
-            kind: "pm_min_version",
-            status: "unchecked",
-            allowed: true,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (comparison < 0) {
-        return {
-            kind: "pm_min_version",
-            status: "unmet",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    return {
-        kind: "pm_min_version",
-        status: "ok",
-        allowed: true,
-        required: declared,
-        current: currentVersion,
-    };
-}
-/**
- * Evaluate a manifest `pm_max_version` inclusive upper bound against the current
- * pm version.
- *
- * An omitted bound is `absent`. A blank or non-string bound is `invalid`. The
- * upper bound must be an exact version: a range prefix (`<`/`>`/`=`/`~`/`^`) is
- * rejected as `invalid`, because
- * {@link parseComparableVersion} leniently strips a leading `>=` for
- * `engines.pm` min-version compatibility and would otherwise turn a range-like
- * `">=2026.6.1"` into an inclusive max and wrongly block newer CLIs. An
- * unparseable bound is `invalid`; an unknown or incomparable current version is
- * `unchecked`; a current version above the bound is `exceeded` (or
- * `exceeded_warn` when `exceededMode` is `warn`, so the extension still loads
- * during a controlled upgrade window); otherwise the bound is satisfied (`ok`).
- */
-export function evaluatePmMaxVersionBound(required, currentVersion, exceededMode) {
-    if (required === undefined || required === null) {
-        return {
-            kind: "pm_max_version",
-            status: "absent",
-            allowed: true,
-            required: "",
-            current: currentVersion,
-        };
-    }
-    const declared = formatVersionBoundValue(required);
-    if (typeof required !== "string" || declared.trim().length === 0) {
-        return {
-            kind: "pm_max_version",
-            status: "invalid",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (/^[<>=~^]/.test(declared.trim()) || !parseComparableVersion(declared)) {
-        return {
-            kind: "pm_max_version",
-            status: "invalid",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (currentVersion === null) {
-        return {
-            kind: "pm_max_version",
-            status: "unchecked",
-            allowed: true,
-            required: declared,
-            current: null,
-        };
-    }
-    const comparison = compareComparableVersions(currentVersion, declared);
-    if (comparison === null) {
-        return {
-            kind: "pm_max_version",
-            status: "unchecked",
-            allowed: true,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    if (comparison > 0) {
-        if (exceededMode === "warn") {
-            return {
-                kind: "pm_max_version",
-                status: "exceeded_warn",
-                allowed: true,
-                required: declared,
-                current: currentVersion,
-            };
-        }
-        return {
-            kind: "pm_max_version",
-            status: "exceeded",
-            allowed: false,
-            required: declared,
-            current: currentVersion,
-        };
-    }
-    return {
-        kind: "pm_max_version",
-        status: "ok",
-        allowed: true,
-        required: declared,
-        current: currentVersion,
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d2feae50-9a1e-54fa-98a3-df529be63069")}catch(e2){}})();function formatVersionBoundValue(value){return typeof value==="string"?value:String(value)}function parseComparableVersion(value){const normalized=value.trim().replace(/^>=\s*/,"").replace(/^v/i,"");const release=normalized.split(/[+-]/,1)[0];if(!/^\d+(?:[.-]\d+)*$/.test(release)){return null}return release.split(/[.-]/).map(part=>Number(part))}function compareComparableVersions(currentVersion,otherVersion){const currentParts=parseComparableVersion(currentVersion);const otherParts=parseComparableVersion(otherVersion);if(!currentParts||!otherParts){return null}const width=Math.max(currentParts.length,otherParts.length);for(let index=0;index<width;index+=1){const current=currentParts[index]??0;const other=otherParts[index]??0;if(current>other){return 1}if(current<other){return-1}}return 0}function evaluatePmMinVersionBound(required,currentVersion){if(required===void 0||required===null){return{kind:"pm_min_version",status:"absent",allowed:true,required:"",current:currentVersion}}const declared=formatVersionBoundValue(required);if(typeof required!=="string"||declared.trim().length===0){return{kind:"pm_min_version",status:"invalid",allowed:false,required:declared,current:currentVersion}}if(!parseComparableVersion(declared)){return{kind:"pm_min_version",status:"invalid",allowed:false,required:declared,current:currentVersion}}if(currentVersion===null){return{kind:"pm_min_version",status:"unchecked",allowed:true,required:declared,current:null}}const comparison=compareComparableVersions(currentVersion,declared);if(comparison===null){return{kind:"pm_min_version",status:"unchecked",allowed:true,required:declared,current:currentVersion}}if(comparison<0){return{kind:"pm_min_version",status:"unmet",allowed:false,required:declared,current:currentVersion}}return{kind:"pm_min_version",status:"ok",allowed:true,required:declared,current:currentVersion}}function evaluatePmMaxVersionBound(required,currentVersion,exceededMode){if(required===void 0||required===null){return{kind:"pm_max_version",status:"absent",allowed:true,required:"",current:currentVersion}}const declared=formatVersionBoundValue(required);if(typeof required!=="string"||declared.trim().length===0){return{kind:"pm_max_version",status:"invalid",allowed:false,required:declared,current:currentVersion}}if(/^[<>=~^]/.test(declared.trim())||!parseComparableVersion(declared)){return{kind:"pm_max_version",status:"invalid",allowed:false,required:declared,current:currentVersion}}if(currentVersion===null){return{kind:"pm_max_version",status:"unchecked",allowed:true,required:declared,current:null}}const comparison=compareComparableVersions(currentVersion,declared);if(comparison===null){return{kind:"pm_max_version",status:"unchecked",allowed:true,required:declared,current:currentVersion}}if(comparison>0){if(exceededMode==="warn"){return{kind:"pm_max_version",status:"exceeded_warn",allowed:true,required:declared,current:currentVersion}}return{kind:"pm_max_version",status:"exceeded",allowed:false,required:declared,current:currentVersion}}return{kind:"pm_max_version",status:"ok",allowed:true,required:declared,current:currentVersion}}export{compareComparableVersions,evaluatePmMaxVersionBound,evaluatePmMinVersionBound,parseComparableVersion};
 //# sourceMappingURL=version-compat.js.map
-//# debugId=849502d0-2616-500c-96de-228c0759459d

package/dist/core/fs/fs-utils.js

@@ -1,159 +1,3 @@
-/**
- * @module core/fs/fs-utils
- *
- * Provides filesystem helpers for Fs Utils.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="23fc5fcb-5c80-57ab-8d91-8d15ee35ab53")}catch(e){}}();
-import * as fs from "node:fs/promises";
-import path from "node:path";
-import crypto from "node:crypto";
-const WINDOWS_RENAME_RETRY_DELAYS_MS = [10, 25, 50, 100];
-/** Implements ensure dir for the public runtime surface of this module. */
-export async function ensureDir(dirPath) {
-    await fs.mkdir(dirPath, { recursive: true });
-}
-/** Implements path exists for the public runtime surface of this module. */
-export async function pathExists(targetPath) {
-    try {
-        await fs.access(targetPath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Report whether an error means "this file is not there".
- *
- * `ENOENT` is the common case. `ENOTDIR` is the same answer reached from a
- * different direction: a path component is a regular file, so the target
- * cannot exist under it either. Absence-tolerant readers must accept both,
- * otherwise a misdirected root turns a graceful default into an unclassified
- * runtime fault instead of reaching the caller's own root validation.
- */
-export function isFileAbsentError(error) {
-    return isFileMissingError(error) || isErrno(error, "ENOTDIR");
-}
-/** Report an exact missing-entry race while preserving ENOTDIR as structural corruption. */
-export function isFileMissingError(error) {
-    return isErrno(error, "ENOENT");
-}
-/** Implements read file if exists for the public runtime surface of this module. */
-export async function readFileIfExists(targetPath) {
-    try {
-        return await fs.readFile(targetPath, "utf8");
-    }
-    catch (error) {
-        if (isFileAbsentError(error)) {
-            return null;
-        }
-        throw error;
-    }
-}
-/** Implements write file atomic for the public runtime surface of this module. */
-export async function writeFileAtomic(targetPath, contents) {
-    const dirPath = path.dirname(targetPath);
-    await ensureDir(dirPath);
-    const tempPath = path.join(dirPath, `.${path.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto.randomBytes(4).toString("hex")}.tmp`);
-    await fs.writeFile(tempPath, contents, "utf8");
-    try {
-        await fs.rename(tempPath, targetPath);
-    }
-    catch (error) {
-        if (process.platform === "win32" &&
-            (isErrno(error, "EPERM") || isErrno(error, "EBUSY"))) {
-            let lastError = error;
-            for (const delayMs of WINDOWS_RENAME_RETRY_DELAYS_MS) {
-                await new Promise((resolve) => setTimeout(resolve, delayMs));
-                try {
-                    await fs.rename(tempPath, targetPath);
-                    return;
-                }
-                catch (retryError) {
-                    lastError = retryError;
-                    if (!isErrno(retryError, "EPERM") && !isErrno(retryError, "EBUSY")) {
-                        break;
-                    }
-                }
-            }
-            try {
-                await fs.unlink(tempPath);
-            }
-            catch {
-                // Best-effort cleanup only.
-            }
-            throw lastError;
-        }
-        if (isErrno(error, "EXDEV")) {
-            try {
-                await fs.copyFile(tempPath, targetPath);
-            }
-            finally {
-                try {
-                    await fs.unlink(tempPath);
-                }
-                catch {
-                    // Best-effort cleanup only.
-                }
-            }
-            return;
-        }
-        try {
-            await fs.unlink(tempPath);
-        }
-        catch {
-            // Best-effort cleanup only.
-        }
-        throw error;
-    }
-}
-/**
- * Append a single newline-terminated line to a file, opened with `O_APPEND`.
- *
- * Concurrency contract: `O_APPEND` makes the seek-to-EOF that precedes each
- * `write(2)` atomic, so independent appenders never overwrite each other's
- * bytes. For the common case the whole `${line}\n` buffer is handed to the
- * kernel in one `write(2)`, which mainstream filesystems (ext4/xfs/apfs) commit
- * atomically under the inode lock — concurrent multi-process appends of small
- * records (e.g. the telemetry and OTLP-span queues) therefore stay
- * line-coherent without an external lock.
- *
- * The guarantee weakens only for a single record large enough that the OS
- * splits it across multiple `write(2)` calls (multi-KiB lines), where another
- * process's append could interleave between fragments. History JSONL — the only
- * caller that can produce large lines — is always written while the per-item
- * store lock is held (see core/store/item-store.ts), so those appends are
- * serialized regardless. Callers writing large records concurrently from
- * multiple processes must hold an equivalent lock.
- */
-export async function appendLineAtomic(targetPath, line) {
-    const dirPath = path.dirname(targetPath);
-    await ensureDir(dirPath);
-    const handle = await fs.open(targetPath, "a");
-    try {
-        await handle.writeFile(`${line}\n`, "utf8");
-    }
-    finally {
-        await handle.close();
-    }
-}
-/** Implements remove file if exists for the public runtime surface of this module. */
-export async function removeFileIfExists(targetPath) {
-    try {
-        await fs.unlink(targetPath);
-    }
-    catch (error) {
-        if (!isFileAbsentError(error)) {
-            throw error;
-        }
-    }
-}
-function isErrno(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === code);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1240aa49-b3fa-57d3-b6e1-7f911005a757")}catch(e2){}})();import*as fs from"node:fs/promises";import path from"node:path";import crypto from"node:crypto";const WINDOWS_RENAME_RETRY_DELAYS_MS=[10,25,50,100];async function ensureDir(dirPath){await fs.mkdir(dirPath,{recursive:true})}async function pathExists(targetPath){try{await fs.access(targetPath);return true}catch{return false}}function isFileAbsentError(error){return isFileMissingError(error)||isErrno(error,"ENOTDIR")}function isFileMissingError(error){return isErrno(error,"ENOENT")}async function readFileIfExists(targetPath){try{return await fs.readFile(targetPath,"utf8")}catch(error){if(isFileAbsentError(error)){return null}throw error}}async function writeFileAtomic(targetPath,contents){const dirPath=path.dirname(targetPath);await ensureDir(dirPath);const tempPath=path.join(dirPath,`.${path.basename(targetPath)}.${process.pid}.${Date.now()}.${crypto.randomBytes(4).toString("hex")}.tmp`);await fs.writeFile(tempPath,contents,"utf8");try{await fs.rename(tempPath,targetPath)}catch(error){if(process.platform==="win32"&&(isErrno(error,"EPERM")||isErrno(error,"EBUSY"))){let lastError=error;for(const delayMs of WINDOWS_RENAME_RETRY_DELAYS_MS){await new Promise(resolve=>setTimeout(resolve,delayMs));try{await fs.rename(tempPath,targetPath);return}catch(retryError){lastError=retryError;if(!isErrno(retryError,"EPERM")&&!isErrno(retryError,"EBUSY")){break}}}try{await fs.unlink(tempPath)}catch{}throw lastError}if(isErrno(error,"EXDEV")){try{await fs.copyFile(tempPath,targetPath)}finally{try{await fs.unlink(tempPath)}catch{}}return}try{await fs.unlink(tempPath)}catch{}throw error}}async function appendLineAtomic(targetPath,line){const dirPath=path.dirname(targetPath);await ensureDir(dirPath);const handle=await fs.open(targetPath,"a");try{await handle.writeFile(`${line}
+`,"utf8")}finally{await handle.close()}}async function removeFileIfExists(targetPath){try{await fs.unlink(targetPath)}catch(error){if(!isFileAbsentError(error)){throw error}}}function isErrno(error,code){return typeof error==="object"&&error!==null&&"code"in error&&error.code===code}export{appendLineAtomic,ensureDir,isFileAbsentError,isFileMissingError,pathExists,readFileIfExists,removeFileIfExists,writeFileAtomic};
 //# sourceMappingURL=fs-utils.js.map
-//# debugId=23fc5fcb-5c80-57ab-8d91-8d15ee35ab53

package/dist/core/fs/host-environment-errors.js

@@ -1,142 +1,2 @@
-/**
- * @module core/fs/host-environment-errors
- *
- * Classifies host filesystem/resource failures at SDK boundaries without
- * leaking local paths or swallowing genuine implementation defects.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1262c682-2b8a-506f-a3e1-155ad682d763")}catch(e){}}();
-import { constants as osConstants } from "node:os";
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-const HOST_ENVIRONMENT_FAULTS = new Map([
-    [
-        "EACCES",
-        {
-            summary: "was denied filesystem permission",
-            recovery: "Grant the required filesystem access, then retry.",
-            category: "permission",
-        },
-    ],
-    [
-        "EDQUOT",
-        {
-            summary: "exceeded the filesystem quota",
-            recovery: "Raise or reclaim the filesystem quota, then retry.",
-            category: "capacity",
-        },
-    ],
-    [
-        "EMFILE",
-        {
-            summary: "exhausted the process file-descriptor limit",
-            recovery: "Close unused file handles or raise the process limit, then retry.",
-            category: "resource",
-        },
-    ],
-    [
-        "ENFILE",
-        {
-            summary: "exhausted the host file-descriptor limit",
-            recovery: "Free host file descriptors or raise the host limit, then retry.",
-            category: "resource",
-        },
-    ],
-    [
-        "ENOMEM",
-        {
-            summary: "ran out of available memory",
-            recovery: "Free memory or reduce concurrent work, then retry.",
-            category: "resource",
-        },
-    ],
-    [
-        "ENOSPC",
-        {
-            summary: "ran out of storage space",
-            recovery: "Free storage on the filesystem holding the project, then retry.",
-            category: "capacity",
-        },
-    ],
-    [
-        "EPERM",
-        {
-            summary: "was denied by the host permission policy",
-            recovery: "Grant the required filesystem permission, then retry.",
-            category: "permission",
-        },
-    ],
-    [
-        "EROFS",
-        {
-            summary: "targeted a read-only filesystem",
-            recovery: "Use a writable project filesystem or remount it read-write, then retry.",
-            category: "permission",
-        },
-    ],
-]);
-const OPERATION_PATTERN = /^[a-z][a-z0-9_]{0,63}$/u;
-const HOST_ENVIRONMENT_ERRNO_NAMES = new Map([
-    [osConstants.errno.EACCES, "EACCES"],
-    [osConstants.errno.EDQUOT, "EDQUOT"],
-    [osConstants.errno.EMFILE, "EMFILE"],
-    [osConstants.errno.ENFILE, "ENFILE"],
-    [osConstants.errno.ENOMEM, "ENOMEM"],
-    [osConstants.errno.ENOSPC, "ENOSPC"],
-    [osConstants.errno.EPERM, "EPERM"],
-    [osConstants.errno.EROFS, "EROFS"],
-].filter(([errno]) => Number.isInteger(errno)));
-const HOST_ENVIRONMENT_FAULT_CODES = {
-    capacity: { code: "host_environment_capacity_fault" },
-    permission: { code: "host_environment_permission_fault" },
-    resource: { code: "host_environment_resource_fault" },
-};
-/** Return a declared host errno only when it represents recoverable environment state. */
-export function classifyHostEnvironmentFault(error) {
-    if (typeof error !== "object" || error === null) {
-        return null;
-    }
-    const errorRecord = error;
-    if (typeof errorRecord.code === "string" &&
-        HOST_ENVIRONMENT_FAULTS.has(errorRecord.code)) {
-        return errorRecord.code;
-    }
-    if (typeof errorRecord.errno !== "number" ||
-        !Number.isInteger(errorRecord.errno)) {
-        return null;
-    }
-    return HOST_ENVIRONMENT_ERRNO_NAMES.get(Math.abs(errorRecord.errno)) ?? null;
-}
-/** Translate one known host fault into a stable path-redacted SDK refusal. */
-export function translateHostEnvironmentFault(error, operation, options = {}) {
-    const errno = classifyHostEnvironmentFault(error);
-    if (errno === null)
-        return null;
-    if (!OPERATION_PATTERN.test(operation)) {
-        throw new PmCliError("Host environment operation labels must be bounded identifiers.", EXIT_CODE.USAGE, { code: "host_environment_operation_invalid", field: "operation" });
-    }
-    const fault = HOST_ENVIRONMENT_FAULTS.get(errno);
-    return new PmCliError(`Host filesystem operation ${operation} ${fault.summary}.`, EXIT_CODE.GENERIC_FAILURE, {
-        code: options.codes?.[fault.category] ??
-            HOST_ENVIRONMENT_FAULT_CODES[fault.category].code,
-        reason: errno,
-        required: fault.recovery,
-        why: options.why ??
-            "The operating system refused a required project filesystem operation.",
-        nextSteps: [fault.recovery, ...(options.nextSteps ?? [])],
-        ...(options.suggestedRetry
-            ? { recovery: { suggested_retry: options.suggestedRetry } }
-            : {}),
-    });
-}
-/** Run one SDK filesystem stage and translate only declared host faults. */
-export async function withHostEnvironmentBoundary(operation, run, options = {}) {
-    try {
-        return await run();
-    }
-    catch (error) {
-        throw translateHostEnvironmentFault(error, operation, options) ?? error;
-    }
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="aaf1c6ce-1bc9-5974-a38f-7daf8e4e63cc")}catch(e2){}})();import{constants as osConstants}from"node:os";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";const HOST_ENVIRONMENT_FAULTS=new Map([["EACCES",{summary:"was denied filesystem permission",recovery:"Grant the required filesystem access, then retry.",category:"permission"}],["EDQUOT",{summary:"exceeded the filesystem quota",recovery:"Raise or reclaim the filesystem quota, then retry.",category:"capacity"}],["EMFILE",{summary:"exhausted the process file-descriptor limit",recovery:"Close unused file handles or raise the process limit, then retry.",category:"resource"}],["ENFILE",{summary:"exhausted the host file-descriptor limit",recovery:"Free host file descriptors or raise the host limit, then retry.",category:"resource"}],["ENOMEM",{summary:"ran out of available memory",recovery:"Free memory or reduce concurrent work, then retry.",category:"resource"}],["ENOSPC",{summary:"ran out of storage space",recovery:"Free storage on the filesystem holding the project, then retry.",category:"capacity"}],["EPERM",{summary:"was denied by the host permission policy",recovery:"Grant the required filesystem permission, then retry.",category:"permission"}],["EROFS",{summary:"targeted a read-only filesystem",recovery:"Use a writable project filesystem or remount it read-write, then retry.",category:"permission"}]]);const OPERATION_PATTERN=/^[a-z][a-z0-9_]{0,63}$/u;const HOST_ENVIRONMENT_ERRNO_NAMES=new Map([[osConstants.errno.EACCES,"EACCES"],[osConstants.errno.EDQUOT,"EDQUOT"],[osConstants.errno.EMFILE,"EMFILE"],[osConstants.errno.ENFILE,"ENFILE"],[osConstants.errno.ENOMEM,"ENOMEM"],[osConstants.errno.ENOSPC,"ENOSPC"],[osConstants.errno.EPERM,"EPERM"],[osConstants.errno.EROFS,"EROFS"]].filter(([errno])=>Number.isInteger(errno)));const HOST_ENVIRONMENT_FAULT_CODES={capacity:{code:"host_environment_capacity_fault"},permission:{code:"host_environment_permission_fault"},resource:{code:"host_environment_resource_fault"}};function classifyHostEnvironmentFault(error){if(typeof error!=="object"||error===null){return null}const errorRecord=error;if(typeof errorRecord.code==="string"&&HOST_ENVIRONMENT_FAULTS.has(errorRecord.code)){return errorRecord.code}if(typeof errorRecord.errno!=="number"||!Number.isInteger(errorRecord.errno)){return null}return HOST_ENVIRONMENT_ERRNO_NAMES.get(Math.abs(errorRecord.errno))??null}function translateHostEnvironmentFault(error,operation,options={}){const errno=classifyHostEnvironmentFault(error);if(errno===null)return null;if(!OPERATION_PATTERN.test(operation)){throw new PmCliError("Host environment operation labels must be bounded identifiers.",EXIT_CODE.USAGE,{code:"host_environment_operation_invalid",field:"operation"})}const fault=HOST_ENVIRONMENT_FAULTS.get(errno);return new PmCliError(`Host filesystem operation ${operation} ${fault.summary}.`,EXIT_CODE.GENERIC_FAILURE,{code:options.codes?.[fault.category]??HOST_ENVIRONMENT_FAULT_CODES[fault.category].code,reason:errno,required:fault.recovery,why:options.why??"The operating system refused a required project filesystem operation.",nextSteps:[fault.recovery,...options.nextSteps??[]],...options.suggestedRetry?{recovery:{suggested_retry:options.suggestedRetry}}:{}})}async function withHostEnvironmentBoundary(operation,run,options={}){try{return await run()}catch(error){throw translateHostEnvironmentFault(error,operation,options)??error}}export{classifyHostEnvironmentFault,translateHostEnvironmentFault,withHostEnvironmentBoundary};
 //# sourceMappingURL=host-environment-errors.js.map
-//# debugId=1262c682-2b8a-506f-a3e1-155ad682d763

package/dist/core/fs/index.js

@@ -1,10 +1,2 @@
-/**
- * @module core/fs/index
- *
- * Provides filesystem helpers for Index.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="141337ab-9bf6-57cc-adac-43cfddd67e64")}catch(e){}}();
-export * from "./fs-utils.js";
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c24aeefc-5ee2-5a06-9a16-941d89b10cd7")}catch(e2){}})();export*from"./fs-utils.js";
 //# sourceMappingURL=index.js.map
-//# debugId=141337ab-9bf6-57cc-adac-43cfddd67e64

package/dist/core/fs/path-utils.js

@@ -1,18 +1,2 @@
-/**
- * @module core/fs/path-utils
- *
- * Provides filesystem helpers for Path Utils.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="624aced5-552c-5354-9e34-b96e267d34d1")}catch(e){}}();
-import path from "path";
-/** Implements check whether path within directory for the public runtime surface of this module. */
-export function isPathWithinDirectory(directory, targetPath) {
-    const relative = path.relative(directory, targetPath);
-    if (relative.length === 0) {
-        return true;
-    }
-    return !relative.startsWith("..") && !path.isAbsolute(relative);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="83a29a06-1b0b-52e6-9617-2fc03861cb18")}catch(e2){}})();import path from"path";function isPathWithinDirectory(directory,targetPath){const relative=path.relative(directory,targetPath);if(relative.length===0){return true}return!relative.startsWith("..")&&!path.isAbsolute(relative)}export{isPathWithinDirectory};
 //# sourceMappingURL=path-utils.js.map
-//# debugId=624aced5-552c-5354-9e34-b96e267d34d1