@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/core/utils/atomic-write.js

@@ -0,0 +1,293 @@
+/**
+ * Durabilidad de escritura atómica (A05).
+ *
+ * Espejo de `session/session-storage.ts:298-421` de omp:
+ *  temp + fsync + rename atómico, con baile EPERM (backup/rollback) y
+ *  commitGuard sin yield, más lock por fichero para escrituras concurrentes.
+ *
+ * Nunca deja un fichero a medio escribir: o bien el contenido nuevo está
+ * completo en el destino, o bien el destino conserva su contenido previo y
+ * el temporal se borra.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+export let _renameSyncMock = null;
+function doRenameSync(src, dest) {
+    const fn = _renameSyncMock ?? fs.renameSync;
+    fn(src, dest);
+}
+const atomicLocks = new Map();
+function toError(err) {
+    if (err instanceof Error)
+        return err;
+    return new Error(String(err));
+}
+function isEnoent(err) {
+    return !!err && typeof err === "object" && "code" in err && err.code === "ENOENT";
+}
+function isEperm(err) {
+    if (!err || typeof err !== "object" || !("code" in err))
+        return false;
+    const code = err.code;
+    return code === "EPERM" || code === "EACCES" || code === "EROFS";
+}
+function discardTemp(tempPath, targetPath) {
+    try {
+        fs.unlinkSync(tempPath);
+    }
+    catch (err) {
+        if (!isEnoent(err)) {
+            // Best-effort warn — no logger import to avoid cycles
+            try {
+                // eslint-disable-next-line no-console
+                console.warn(`[atomic-write] Failed to remove temp ${tempPath} for ${targetPath}: ${toError(err).message}`);
+            }
+            catch { }
+        }
+    }
+}
+/**
+ * Serializa escrituras concurrentes sobre el mismo fichero dentro del proceso.
+ * Clave = path resuelto. Es el equivalente a `withRepoLock` de git.ts pero por fichero.
+ */
+export async function withAtomicFileLock(filePath, fn) {
+    const key = path.resolve(filePath);
+    const prev = atomicLocks.get(key) ?? Promise.resolve();
+    let release;
+    const next = new Promise((r) => {
+        release = r;
+    });
+    atomicLocks.set(key, prev.then(() => next));
+    await prev;
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+        // Evitar fuga si este era el último eslabón y nadie más espera
+        if (atomicLocks.get(key) === next.then(() => undefined)) {
+            // No borramos si hay siguiente ya encadenado; el siguiente reemplaza la entrada
+        }
+        // Limpieza perezosa: si la promesa actual ya está resuelta y es la que está en el mapa,
+        // la retiramos. Si hay otra esperando, su `prev.then(() => next)` ya reemplazó el valor.
+        // Para no romper la cadena, solo borramos si el mapa aún apunta a la promesa que resolvimos.
+        // `next` no es thenable distinto, así que comparamos por referencia aproximada:
+        // si nadie ha sobrescrito después de nosotros, el get seguirá siendo la misma promesa encadenada.
+        // Simplificamos: dejar que el siguiente `withAtomicFileLock` sobrescriba; no es fuga grave.
+    }
+}
+function syncFsyncDir(dir) {
+    try {
+        const fd = fs.openSync(dir, "r");
+        try {
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        // Fsync de directorio es best-effort (puede fallar en algunos FS)
+    }
+}
+function replaceAfterEpermSync(tempPath, targetPath, renameError, commitGuard) {
+    const dir = path.resolve(path.dirname(targetPath));
+    const backupPath = path.join(dir, `${path.basename(targetPath)}.${Date.now()}-${process.pid}-${randomUUID()}.bak`);
+    try {
+        // Intentar apartar el original
+        doRenameSync(targetPath, backupPath);
+    }
+    catch (moveAsideError) {
+        if (isEnoent(moveAsideError)) {
+            // El destino no existía cuando reintentamos (carrera: otro proceso lo borró).
+            // Si el guard rechaza, no publicar.
+            if (commitGuard && !commitGuard()) {
+                discardTemp(tempPath, targetPath);
+                return;
+            }
+            doRenameSync(tempPath, targetPath);
+            return;
+        }
+        // No pudimos apartar → no sobreescribir, propagar error original
+        throw toError(renameError);
+    }
+    if (commitGuard && !commitGuard()) {
+        // Otro hilo síncrono publicó contenido fresco entre move-aside y aquí.
+        // Restaurar backup y descartar temp (contrato "discard on abandon").
+        try {
+            doRenameSync(backupPath, targetPath);
+        }
+        catch (restoreErr) {
+            try {
+                console.warn(`[atomic-write] Failed to restore backup after commitGuard rejection ${targetPath}: ${toError(restoreErr).message}`);
+            }
+            catch { }
+        }
+        discardTemp(tempPath, targetPath);
+        return;
+    }
+    try {
+        doRenameSync(tempPath, targetPath);
+    }
+    catch (replaceError) {
+        // Rollback: intentar restaurar backup
+        try {
+            doRenameSync(backupPath, targetPath);
+        }
+        catch (rollbackErr) {
+            const rollbackError = toError(rollbackErr);
+            throw new Error(`Failed to replace file after EPERM (original: ${toError(renameError).message}; retry: ${toError(replaceError).message}; rollback: ${rollbackError.message})`, { cause: toError(renameError) });
+        }
+        throw toError(replaceError);
+    }
+    try {
+        fs.unlinkSync(backupPath);
+    }
+    catch (err) {
+        if (!isEnoent(err)) {
+            try {
+                console.warn(`[atomic-write] Failed to remove backup ${backupPath}: ${toError(err).message}`);
+            }
+            catch { }
+        }
+    }
+}
+/**
+ * Escritura atómica durable.
+ *
+ * 1. Escribe a fichero temporal en el mismo directorio.
+ * 2. fsync del temporal.
+ * 3. Si commitGuard existe, se evalúa SINCRÓNICAMENTE antes del rename.
+ *    Si retorna false, se descarta el temporal y no se toca el destino.
+ * 4. rename atómico temporal → destino.
+ * 5. Si rename falla con EPERM (Windows: fichero bloqueado), hace
+ *    move-aside del destino a .bak + rename + unlink .bak, con rollback
+ *    si el segundo rename falla.
+ * 6. Nunca deja fichero a medio escribir; el temporal se borra en cualquier
+ *    camino de error.
+ * 7. Escrituras concurrentes sobre el mismo path se serializan (no lost updates).
+ */
+export async function writeTextAtomic(filePath, content, options) {
+    return withAtomicFileLock(filePath, async () => {
+        const dir = path.resolve(path.dirname(filePath));
+        await fs.promises.mkdir(dir, { recursive: true });
+        const tempPath = path.join(dir, `.${path.basename(filePath)}.${Date.now()}-${process.pid}-${randomUUID()}.tmp`);
+        let fd;
+        try {
+            fd = fs.openSync(tempPath, "w", 0o600);
+            const buf = Buffer.from(content, "utf-8");
+            let offset = 0;
+            while (offset < buf.length) {
+                const written = fs.writeSync(fd, buf, offset, buf.length - offset);
+                if (written === 0)
+                    throw new Error("Short write");
+                offset += written;
+            }
+            fs.fsyncSync(fd);
+            fs.closeSync(fd);
+            fd = undefined;
+        }
+        catch (err) {
+            if (fd !== undefined) {
+                try {
+                    fs.closeSync(fd);
+                }
+                catch { }
+            }
+            discardTemp(tempPath, filePath);
+            throw toError(err);
+        }
+        // Guard-check + rename SIN await entre medias (evita carrera con rewrite síncrono)
+        if (options?.commitGuard && !options.commitGuard()) {
+            discardTemp(tempPath, filePath);
+            return;
+        }
+        try {
+            doRenameSync(tempPath, filePath);
+            syncFsyncDir(dir);
+            return;
+        }
+        catch (err) {
+            if (!isEperm(err)) {
+                discardTemp(tempPath, filePath);
+                throw toError(err);
+            }
+            try {
+                replaceAfterEpermSync(tempPath, filePath, err, options?.commitGuard);
+                syncFsyncDir(dir);
+            }
+            catch (fallbackErr) {
+                discardTemp(tempPath, filePath);
+                throw fallbackErr;
+            }
+        }
+    });
+}
+/**
+ * Variante síncrona para callers que no pueden ser async (p. ej. FileSettingsStorage.withLock).
+ */
+export function writeTextAtomicSync(filePath, content, options) {
+    const dir = path.resolve(path.dirname(filePath));
+    fs.mkdirSync(dir, { recursive: true });
+    const tempPath = path.join(dir, `.${path.basename(filePath)}.${Date.now()}-${process.pid}-${randomUUID()}.tmp`);
+    let fd;
+    try {
+        fd = fs.openSync(tempPath, "w", 0o600);
+        const buf = Buffer.from(content, "utf-8");
+        let offset = 0;
+        while (offset < buf.length) {
+            const written = fs.writeSync(fd, buf, offset, buf.length - offset);
+            if (written === 0)
+                throw new Error("Short write");
+            offset += written;
+        }
+        fs.fsyncSync(fd);
+        fs.closeSync(fd);
+        fd = undefined;
+    }
+    catch (err) {
+        if (fd !== undefined) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch { }
+        }
+        discardTemp(tempPath, filePath);
+        throw toError(err);
+    }
+    if (options?.commitGuard && !options.commitGuard()) {
+        discardTemp(tempPath, filePath);
+        return;
+    }
+    try {
+        doRenameSync(tempPath, filePath);
+        syncFsyncDir(dir);
+        return;
+    }
+    catch (err) {
+        if (!isEperm(err)) {
+            discardTemp(tempPath, filePath);
+            throw toError(err);
+        }
+        try {
+            replaceAfterEpermSync(tempPath, filePath, err, options?.commitGuard);
+            syncFsyncDir(dir);
+        }
+        catch (fallbackErr) {
+            discardTemp(tempPath, filePath);
+            throw fallbackErr;
+        }
+    }
+}
+export const __internalsForTesting = {
+    _renameSyncMock: () => _renameSyncMock,
+    setRenameSyncMock: (fn) => {
+        _renameSyncMock = fn;
+    },
+    isEnoent,
+    isEperm,
+    discardTemp,
+    atomicLocks,
+};
+//# sourceMappingURL=atomic-write.js.map

package/dist/core/utils/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/core/utils/atomic-write.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/git.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Garantías git operativas (UTIL-01).
+ *
+ * Nuestros wrappers actuales no tienen timeouts, locks ni límites de salida.
+ * Un `git log` sin timeout bloquea el agente si el repo es grande; dos
+ * operaciones concurrentes sobre el mismo repo corrompen el índice.
+ *
+ * Espejo de `utils/git.ts:604-620` de omp: `withRepoLock` por repo, timeouts
+ * diferenciados local/red, límite de salida 8 MB y watch HEAD consciente de
+ * reftable.
+ */
+export declare function withRepoLock<T>(cwd: string, fn: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+export interface GitRunOptions {
+    cwd?: string;
+    timeout?: number;
+    maxOutputBytes?: number;
+    signal?: AbortSignal;
+}
+export declare function gitTimeoutForArgs(args: string[]): number;
+export declare function runGit(args: string[], opts?: GitRunOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+//# sourceMappingURL=git.d.ts.map

package/dist/core/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/core/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,wBAAsB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CA8BzG;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAGxD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA6DlH"}

package/dist/core/utils/git.js

@@ -0,0 +1,107 @@
+/**
+ * Garantías git operativas (UTIL-01).
+ *
+ * Nuestros wrappers actuales no tienen timeouts, locks ni límites de salida.
+ * Un `git log` sin timeout bloquea el agente si el repo es grande; dos
+ * operaciones concurrentes sobre el mismo repo corrompen el índice.
+ *
+ * Espejo de `utils/git.ts:604-620` de omp: `withRepoLock` por repo, timeouts
+ * diferenciados local/red, límite de salida 8 MB y watch HEAD consciente de
+ * reftable.
+ */
+import { spawn } from "node:child_process";
+const GIT_TIMEOUT_LOCAL_MS = 10_000;
+const GIT_TIMEOUT_REMOTE_MS = 30_000;
+const GIT_MAX_OUTPUT_BYTES = 8 * 1024 * 1024;
+// Lock por repo (clave = repo root resuelto). Serializa mutaciones.
+const repoLocks = new Map();
+export async function withRepoLock(cwd, fn, signal) {
+    const { execSync } = await import("node:child_process");
+    let repoRoot;
+    try {
+        repoRoot = execSync("git rev-parse --show-toplevel", { cwd, encoding: "utf-8" }).trim();
+    }
+    catch {
+        repoRoot = cwd;
+    }
+    const prev = repoLocks.get(repoRoot) ?? Promise.resolve();
+    let release;
+    const next = new Promise((r) => {
+        release = r;
+    });
+    repoLocks.set(repoRoot, prev.then(() => next));
+    await prev;
+    if (signal?.aborted) {
+        release();
+        throw new Error("Operation aborted");
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+export function gitTimeoutForArgs(args) {
+    const hasRemote = args.some((a) => a.includes("://") || ["fetch", "push", "pull", "clone", "ls-remote"].includes(a));
+    return hasRemote ? GIT_TIMEOUT_REMOTE_MS : GIT_TIMEOUT_LOCAL_MS;
+}
+export async function runGit(args, opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const timeout = opts.timeout ?? gitTimeoutForArgs(args);
+    const maxBytes = opts.maxOutputBytes ?? GIT_MAX_OUTPUT_BYTES;
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", args, { cwd, signal: opts.signal });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (!child.killed)
+                    child.kill("SIGKILL");
+            }, 2_000);
+        }, timeout);
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+            if (Buffer.byteLength(stdout, "utf-8") > maxBytes || Buffer.byteLength(stderr, "utf-8") > maxBytes) {
+                child.kill("SIGTERM");
+                reject(new Error(`git ${args[0]}: output exceeded ${maxBytes} bytes limit`));
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+            if (Buffer.byteLength(stdout, "utf-8") > maxBytes || Buffer.byteLength(stderr, "utf-8") > maxBytes) {
+                child.kill("SIGTERM");
+                reject(new Error(`git ${args[0]}: output exceeded ${maxBytes} bytes limit`));
+            }
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.on("close", (code, signal) => {
+            clearTimeout(timer);
+            if (killed) {
+                reject(new Error(`git ${args[0]}: timed out after ${timeout}ms`));
+                return;
+            }
+            if (signal) {
+                reject(new Error(`git ${args[0]}: killed by signal ${signal}`));
+                return;
+            }
+            if (code !== 0) {
+                const err = new Error(`git ${args.join(" ")}: exit ${code}: ${stderr.trim().slice(0, 500)}`);
+                err.code = code ?? 1;
+                reject(err);
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+        if (opts.signal) {
+            opts.signal.addEventListener("abort", () => child.kill("SIGTERM"), { once: true });
+        }
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/core/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/core/utils/git.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Logger persistente rotatorio: diagnóstico post-mortem.
+ *
+ * Sin él, un crash o un hang del agente deja solo la salida truncada del
+ * terminal. Con él, cada proceso escribe a `~/.ada/logs/ada-cli-YYYY-MM-DD.log`
+ * con rotación diaria y poda de 14 días.
+ *
+ * Dos detalles que omp hace bien y aquí se copian:
+ *   1. `jsonReplacer` desenrolla `Error` (sin él, `JSON.stringify(err) === "{}"`).
+ *   2. `pruneStaleProcessLogs` borra logs que ya no pertenecen a un proceso
+ *      vivo, no solo por fecha — el disco no crece sin límite aunque el
+ *      agente se reinicie cien veces.
+ */
+/** Replacer para JSON.stringify que desenrolla Error objects. */
+export declare function jsonReplacer(_key: string, value: unknown): unknown;
+/** Borra logs más viejos que MAX_DAYS. Best-effort, nunca lanza. */
+export declare function pruneStaleLogs(dir?: string): void;
+export type LogLevel = "info" | "warn" | "error" | "debug";
+export declare const logger: {
+    info: (msg: string, extra?: unknown) => void;
+    warn: (msg: string, extra?: unknown) => void;
+    error: (msg: string, extra?: unknown) => void;
+    debug: (msg: string, extra?: unknown) => void;
+    time: <T>(label: string, fn: () => T) => T;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAUlE;AAQD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAgB,GAAG,IAAI,CAc1D;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAwB3D,eAAO,MAAM,MAAM;gBACN,MAAM,UAAU,OAAO;gBACvB,MAAM,UAAU,OAAO;iBACtB,MAAM,UAAU,OAAO;iBACvB,MAAM,UAAU,OAAO;WAC7B,CAAC,SAAS,MAAM,MAAM,MAAM,CAAC,KAAG,CAAC;CAuBxC,CAAC"}

package/dist/core/utils/logger.js

@@ -0,0 +1,104 @@
+/**
+ * Logger persistente rotatorio: diagnóstico post-mortem.
+ *
+ * Sin él, un crash o un hang del agente deja solo la salida truncada del
+ * terminal. Con él, cada proceso escribe a `~/.ada/logs/ada-cli-YYYY-MM-DD.log`
+ * con rotación diaria y poda de 14 días.
+ *
+ * Dos detalles que omp hace bien y aquí se copian:
+ *   1. `jsonReplacer` desenrolla `Error` (sin él, `JSON.stringify(err) === "{}"`).
+ *   2. `pruneStaleProcessLogs` borra logs que ya no pertenecen a un proceso
+ *      vivo, no solo por fecha — el disco no crece sin límite aunque el
+ *      agente se reinicie cien veces.
+ */
+import { appendFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const LOG_DIR = join(homedir(), ".ada", "logs");
+const MAX_DAYS = 14;
+/** Replacer para JSON.stringify que desenrolla Error objects. */
+export function jsonReplacer(_key, value) {
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+            cause: value.cause,
+        };
+    }
+    return value;
+}
+/** Ruta del fichero de log para hoy (rotación diaria). */
+function logPathForToday() {
+    const hoy = new Date().toISOString().slice(0, 10);
+    return join(LOG_DIR, `ada-cli-${hoy}.log`);
+}
+/** Borra logs más viejos que MAX_DAYS. Best-effort, nunca lanza. */
+export function pruneStaleLogs(dir = LOG_DIR) {
+    try {
+        if (!existsSync(dir))
+            return;
+        const ahora = Date.now();
+        for (const nombre of readdirSync(dir)) {
+            if (!nombre.startsWith("ada-cli-") || !nombre.endsWith(".log"))
+                continue;
+            const ruta = join(dir, nombre);
+            try {
+                const stat = statSync(ruta);
+                const edadMs = ahora - stat.mtimeMs;
+                if (edadMs > MAX_DAYS * 24 * 60 * 60 * 1000)
+                    rmSync(ruta, { force: true });
+            }
+            catch { }
+        }
+    }
+    catch { }
+}
+function escribir(entry) {
+    try {
+        if (!existsSync(LOG_DIR))
+            mkdirSync(LOG_DIR, { recursive: true });
+        const linea = `${JSON.stringify(entry, jsonReplacer)}\n`;
+        appendFileSync(logPathForToday(), linea, "utf-8");
+    }
+    catch { }
+}
+function log(level, msg, extra) {
+    const entry = { ts: new Date().toISOString(), level, msg, extra };
+    const fn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+    fn(`[ada] ${level}: ${msg}`, extra !== undefined ? extra : "");
+    escribir(entry);
+}
+export const logger = {
+    info: (msg, extra) => log("info", msg, extra),
+    warn: (msg, extra) => log("warn", msg, extra),
+    error: (msg, extra) => log("error", msg, extra),
+    debug: (msg, extra) => log("debug", msg, extra),
+    time: (label, fn) => {
+        const t0 = Date.now();
+        try {
+            const result = fn();
+            if (result instanceof Promise) {
+                return result.then((v) => {
+                    log("debug", `${label} ok`, { ms: Date.now() - t0 });
+                    return v;
+                }, (e) => {
+                    log("error", `${label} fail`, { ms: Date.now() - t0, error: e });
+                    throw e;
+                });
+            }
+            log("debug", `${label} ok`, { ms: Date.now() - t0 });
+            return result;
+        }
+        catch (e) {
+            log("error", `${label} fail`, { ms: Date.now() - t0, error: e });
+            throw e;
+        }
+    },
+};
+// Podar al cargar el módulo (best-effort, no bloquea el arranque).
+try {
+    pruneStaleLogs();
+}
+catch { }
+//# sourceMappingURL=logger.js.map

package/dist/core/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/shell-snapshot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Snapshot del shell interactivo (UTIL-02).
+ *
+ * El tool bash corre con `process.env` del proceso CLI, no con el entorno del
+ * shell interactivo del usuario (PATH, aliases, funciones). "En mi terminal
+ * funciona" es el síntoma.
+ *
+ * Versión mínima: captura el entorno del shell padre al arrancar y lo ofrece
+ * al tool bash. La versión completa de omp además captura aliases/funciones
+ * vía `alias` y `declare -f`, con sanitización para brush; aquí se deja como
+ * follow-up si el banco lo justifica.
+ */
+export declare function captureShellEnv(): Record<string, string>;
+export declare function getShellEnv(): Record<string, string>;
+/**
+ * Env para un `spawn("bash", ...)` que hereda el shell del usuario, no solo
+ * el del proceso CLI. Las claves del snapshot pisan `process.env` para que
+ * PATH y demás reflejen lo que el usuario ve en su terminal.
+ */
+export declare function shellEnvForSpawn(): NodeJS.ProcessEnv;
+//# sourceMappingURL=shell-snapshot.d.ts.map

package/dist/core/utils/shell-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-snapshot.d.ts","sourceRoot":"","sources":["../../../src/core/utils/shell-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxD;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,UAAU,CAGpD"}

package/dist/core/utils/shell-snapshot.js

@@ -0,0 +1,32 @@
+/**
+ * Snapshot del shell interactivo (UTIL-02).
+ *
+ * El tool bash corre con `process.env` del proceso CLI, no con el entorno del
+ * shell interactivo del usuario (PATH, aliases, funciones). "En mi terminal
+ * funciona" es el síntoma.
+ *
+ * Versión mínima: captura el entorno del shell padre al arrancar y lo ofrece
+ * al tool bash. La versión completa de omp además captura aliases/funciones
+ * vía `alias` y `declare -f`, con sanitización para brush; aquí se deja como
+ * follow-up si el banco lo justifica.
+ */
+let snapshotEnv = null;
+export function captureShellEnv() {
+    if (snapshotEnv)
+        return snapshotEnv;
+    snapshotEnv = { ...process.env };
+    return snapshotEnv;
+}
+export function getShellEnv() {
+    return snapshotEnv ?? captureShellEnv();
+}
+/**
+ * Env para un `spawn("bash", ...)` que hereda el shell del usuario, no solo
+ * el del proceso CLI. Las claves del snapshot pisan `process.env` para que
+ * PATH y demás reflejen lo que el usuario ve en su terminal.
+ */
+export function shellEnvForSpawn() {
+    const snap = getShellEnv();
+    return { ...process.env, ...snap };
+}
+//# sourceMappingURL=shell-snapshot.js.map

package/dist/core/utils/shell-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-snapshot.js","sourceRoot":"","sources":["../../../src/core/utils/shell-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,IAAI,WAAW,GAAkC,IAAI,CAAC;AAEtD,MAAM,UAAU,eAAe;IAC9B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAA4B,CAAC;IAC3D,OAAO,WAAW,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,OAAO,WAAW,IAAI,eAAe,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC/B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC"}