@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/config/quarantine.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cuarentena de config corrupta (A05).
+ *
+ * Si un JSON es corrupto, se mueve a `.broken-<timestamp>-<pid>-<uuid>` bajo
+ * file-lock y nunca se sobreescribe la única copia. Espejo de
+ * `config/settings.ts:1305-1323` y `config/config-file.ts:29` de omp, adaptado
+ * a JSON (nuestro formato de settings) y a proper-lockfile / lock en memoria.
+ *
+ * Garantías:
+ *  - Bajo lock: re-valida antes de mover; si otro proceso ya lo movió, falla
+ *    con "invalid before locking and is now missing".
+ *  - Si el rename falla, no se trunca el original: se propaga "could not be
+ *    moved aside; refusing to overwrite".
+ *  - Cuarentena es atómica (rename), no copia+borrado.
+ */
+declare function isEnoent(err: unknown): boolean;
+export declare function withQuarantineLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+export interface QuarantineResult {
+    backupPath: string;
+    originalError: Error;
+}
+/**
+ * Mueve un fichero inválido a `.broken-…` bajo lock.
+ * Debe llamarse solo cuando ya se ha detectado que el contenido es inválido.
+ * Re-valida que el fichero sigue existiendo bajo el lock; si no, significa
+ * que otro proceso ya lo cuarentenó.
+ */
+export declare function quarantineInvalidJsonLocked(filePath: string, originalError: unknown): Promise<QuarantineResult>;
+/**
+ * Variante síncrona para callers con lock ya adquirido o contextos sync.
+ */
+export declare function quarantineInvalidJsonLockedSync(filePath: string, originalError: unknown): QuarantineResult;
+export interface ReadJsonWithQuarantineResult<T> {
+    data: T;
+    quarantinedPath?: string;
+    wasQuarantined: boolean;
+    error?: Error;
+}
+/**
+ * Lee un JSON. Si el fichero no existe, devuelve fallback sin cuarentena.
+ * Si el JSON es inválido, lo mueve a `.broken-…` bajo lock y devuelve fallback.
+ * Si el JSON es válido pero no es objeto/array esperado, también lo considera inválido.
+ *
+ * Nunca sobreescribe la única copia: el rename es atómico y si falla se propaga
+ * sin truncar el original.
+ */
+export declare function readJsonWithQuarantine<T>(filePath: string, fallback: T): Promise<ReadJsonWithQuarantineResult<T>>;
+/**
+ * Variante síncrona.
+ */
+export declare function readJsonWithQuarantineSync<T>(filePath: string, fallback: T): ReadJsonWithQuarantineResult<T>;
+export declare const __internalsForTesting: {
+    quarantineLocks: Map<string, Promise<void>>;
+    isEnoent: typeof isEnoent;
+};
+export {};
+//# sourceMappingURL=quarantine.d.ts.map

package/dist/core/config/quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine.d.ts","sourceRoot":"","sources":["../../../src/core/config/quarantine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,iBAAS,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvC;AAKD,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiB9F;AAED,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBrH;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,gBAAgB,CAqB1G;AAED,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC7C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,GACT,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAyB1C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAqB5G;AAED,eAAO,MAAM,qBAAqB;;;CAGjC,CAAC"}

package/dist/core/config/quarantine.js

@@ -0,0 +1,161 @@
+/**
+ * Cuarentena de config corrupta (A05).
+ *
+ * Si un JSON es corrupto, se mueve a `.broken-<timestamp>-<pid>-<uuid>` bajo
+ * file-lock y nunca se sobreescribe la única copia. Espejo de
+ * `config/settings.ts:1305-1323` y `config/config-file.ts:29` de omp, adaptado
+ * a JSON (nuestro formato de settings) y a proper-lockfile / lock en memoria.
+ *
+ * Garantías:
+ *  - Bajo lock: re-valida antes de mover; si otro proceso ya lo movió, falla
+ *    con "invalid before locking and is now missing".
+ *  - Si el rename falla, no se trunca el original: se propaga "could not be
+ *    moved aside; refusing to overwrite".
+ *  - Cuarentena es atómica (rename), no copia+borrado.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+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";
+}
+// Lock por fichero (intra-proceso) — equivalente a withRepoLock por repo pero por path
+const quarantineLocks = new Map();
+export async function withQuarantineLock(filePath, fn) {
+    const key = path.resolve(filePath);
+    const prev = quarantineLocks.get(key) ?? Promise.resolve();
+    let release;
+    const next = new Promise((r) => {
+        release = r;
+    });
+    quarantineLocks.set(key, prev.then(() => next));
+    await prev;
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+/**
+ * Mueve un fichero inválido a `.broken-…` bajo lock.
+ * Debe llamarse solo cuando ya se ha detectado que el contenido es inválido.
+ * Re-valida que el fichero sigue existiendo bajo el lock; si no, significa
+ * que otro proceso ya lo cuarentenó.
+ */
+export async function quarantineInvalidJsonLocked(filePath, originalError) {
+    const resolved = path.resolve(filePath);
+    return withQuarantineLock(resolved, async () => {
+        // Re-validar existencia bajo lock
+        try {
+            await fs.promises.access(resolved);
+        }
+        catch (err) {
+            if (isEnoent(err)) {
+                throw new Error(`Config file was invalid before locking and is now missing: ${filePath}; another process may have moved it aside`);
+            }
+            throw toError(err);
+        }
+        const backupPath = `${resolved}.broken-${Date.now()}-${process.pid}-${randomUUID()}`;
+        try {
+            await fs.promises.rename(resolved, backupPath);
+        }
+        catch (err) {
+            throw new Error(`Config file is invalid and could not be moved aside: ${filePath}; refusing to overwrite it: ${String(err)}`);
+        }
+        return { backupPath, originalError: toError(originalError) };
+    });
+}
+/**
+ * Variante síncrona para callers con lock ya adquirido o contextos sync.
+ */
+export function quarantineInvalidJsonLockedSync(filePath, originalError) {
+    const resolved = path.resolve(filePath);
+    try {
+        fs.accessSync(resolved);
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            throw new Error(`Config file was invalid before locking and is now missing: ${filePath}; another process may have moved it aside`);
+        }
+        throw toError(err);
+    }
+    const backupPath = `${resolved}.broken-${Date.now()}-${process.pid}-${randomUUID()}`;
+    try {
+        fs.renameSync(resolved, backupPath);
+    }
+    catch (err) {
+        throw new Error(`Config file is invalid and could not be moved aside: ${filePath}; refusing to overwrite it: ${String(err)}`);
+    }
+    return { backupPath, originalError: toError(originalError) };
+}
+/**
+ * Lee un JSON. Si el fichero no existe, devuelve fallback sin cuarentena.
+ * Si el JSON es inválido, lo mueve a `.broken-…` bajo lock y devuelve fallback.
+ * Si el JSON es válido pero no es objeto/array esperado, también lo considera inválido.
+ *
+ * Nunca sobreescribe la única copia: el rename es atómico y si falla se propaga
+ * sin truncar el original.
+ */
+export async function readJsonWithQuarantine(filePath, fallback) {
+    let raw;
+    try {
+        raw = await fs.promises.readFile(filePath, "utf-8");
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            return { data: fallback, wasQuarantined: false };
+        }
+        throw toError(err);
+    }
+    // Fichero vacío → tratar como missing (no cuarentenar)
+    if (raw.trim() === "") {
+        return { data: fallback, wasQuarantined: false };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (parseErr) {
+        const result = await quarantineInvalidJsonLocked(filePath, parseErr);
+        return { data: fallback, quarantinedPath: result.backupPath, wasQuarantined: true, error: result.originalError };
+    }
+    return { data: parsed, wasQuarantined: false };
+}
+/**
+ * Variante síncrona.
+ */
+export function readJsonWithQuarantineSync(filePath, fallback) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            return { data: fallback, wasQuarantined: false };
+        }
+        throw toError(err);
+    }
+    if (raw.trim() === "") {
+        return { data: fallback, wasQuarantined: false };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (parseErr) {
+        const result = quarantineInvalidJsonLockedSync(filePath, parseErr);
+        return { data: fallback, quarantinedPath: result.backupPath, wasQuarantined: true, error: result.originalError };
+    }
+    return { data: parsed, wasQuarantined: false };
+}
+export const __internalsForTesting = {
+    quarantineLocks,
+    isEnoent,
+};
+//# sourceMappingURL=quarantine.js.map

package/dist/core/config/quarantine.js.map

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

package/dist/core/config-viva/ambito.d.ts

@@ -0,0 +1,46 @@
+/**
+ * C05 — Settings con ámbito de ruta (AUDITORIA-OMP.md C05).
+ *
+ * Hoy `enabledModels` es `string[]` plano (settings-manager.ts) y vale igual
+ * en cualquier directorio. En monorepos eso obliga a elegir un único juego de
+ * modelos para todo el árbol. Aquí la misma clave acepta además entradas
+ * acotadas por prefijo de ruta:
+ *
+ *   "enabledModels": [ { "pathPrefix": "/repo/servicios", "values": [...] },
+ *                      { "pathPrefix": "/repo/web",       "values": [...] } ]
+ *
+ * Reglas de resolución (`resolverValorPorAmbito`):
+ *  1. Las capas van ordenadas de MÁS a MENOS prioritaria (proyecto antes que
+ *     global, como deepMergeSettings). La primera capa que responda gana.
+ *  2. Dentro de una capa: un valor plano siempre gana sobre entradas con
+ *     ámbito de esa misma capa (el formato acotado es opt-in por clave).
+ *  3. Entre entradas con ámbito que coinciden con el cwd, gana el prefijo
+ *     LARGO (el más específico).
+ *  4. Si ninguna entrada con ámbito coincide con el cwd, se cae a la capa
+ *     siguiente (fallback global).
+ *
+ * API pura: sin I/O, sin estado, inyectando las capas ya leídas.
+ */
+/** Una entrada de settings acotada a un prefijo de ruta. */
+export interface ValorConAmbito<T> {
+    /** Prefijo de ruta (se normaliza a absoluto); el cwd debe empezar por él. */
+    pathPrefix: string;
+    values: T;
+}
+/** Valor de una clave: plano o lista acotada por prefijos de ruta. */
+export type ValorAmbito<T> = T | Array<ValorConAmbito<T>>;
+/**
+ * Una capa de settings ya leída. `capas[0]` es la MÁS prioritaria
+ * (p.ej. proyecto); la última suele ser la global.
+ */
+export interface CapaAmbito {
+    /** Identificador opcional para diagnóstico (/status). */
+    id?: string;
+    settings: Record<string, unknown>;
+}
+/**
+ * Resuelve `clave` para `cwd` sobre capas ordenadas de más a menos
+ * prioritaria. Devuelve `undefined` si ninguna capa responde.
+ */
+export declare function resolverValorPorAmbito<T>(clave: string, cwd: string, capas: ReadonlyArray<CapaAmbito>): T | undefined;
+//# sourceMappingURL=ambito.d.ts.map

package/dist/core/config-viva/ambito.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambito.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/ambito.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,4DAA4D;AAC5D,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;CACV;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAaD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAsBrH"}

package/dist/core/config-viva/ambito.js

@@ -0,0 +1,62 @@
+/**
+ * C05 — Settings con ámbito de ruta (AUDITORIA-OMP.md C05).
+ *
+ * Hoy `enabledModels` es `string[]` plano (settings-manager.ts) y vale igual
+ * en cualquier directorio. En monorepos eso obliga a elegir un único juego de
+ * modelos para todo el árbol. Aquí la misma clave acepta además entradas
+ * acotadas por prefijo de ruta:
+ *
+ *   "enabledModels": [ { "pathPrefix": "/repo/servicios", "values": [...] },
+ *                      { "pathPrefix": "/repo/web",       "values": [...] } ]
+ *
+ * Reglas de resolución (`resolverValorPorAmbito`):
+ *  1. Las capas van ordenadas de MÁS a MENOS prioritaria (proyecto antes que
+ *     global, como deepMergeSettings). La primera capa que responda gana.
+ *  2. Dentro de una capa: un valor plano siempre gana sobre entradas con
+ *     ámbito de esa misma capa (el formato acotado es opt-in por clave).
+ *  3. Entre entradas con ámbito que coinciden con el cwd, gana el prefijo
+ *     LARGO (el más específico).
+ *  4. Si ninguna entrada con ámbito coincide con el cwd, se cae a la capa
+ *     siguiente (fallback global).
+ *
+ * API pura: sin I/O, sin estado, inyectando las capas ya leídas.
+ */
+import { resolve as resolverRuta } from "node:path";
+function esEntradaConAmbito(valor) {
+    if (typeof valor !== "object" || valor === null || !("pathPrefix" in valor))
+        return false;
+    const prefijo = valor.pathPrefix;
+    return typeof prefijo === "string";
+}
+function normalizarPrefijo(prefijo) {
+    const resuelto = resolverRuta(prefijo);
+    return resuelto.endsWith("/") && resuelto !== "/" ? resuelto.slice(0, -1) : resuelto;
+}
+/**
+ * Resuelve `clave` para `cwd` sobre capas ordenadas de más a menos
+ * prioritaria. Devuelve `undefined` si ninguna capa responde.
+ */
+export function resolverValorPorAmbito(clave, cwd, capas) {
+    const cwdNormalizado = normalizarPrefijo(cwd);
+    for (const capa of capas) {
+        const bruto = capa.settings?.[clave];
+        if (bruto === undefined || bruto === null)
+            continue;
+        if (!Array.isArray(bruto) || !bruto.every(esEntradaConAmbito)) {
+            // Valor plano: gana dentro de su capa sin mirar ámbitos.
+            return bruto;
+        }
+        let mejor;
+        for (const entrada of bruto) {
+            if (!cwdNormalizado.startsWith(normalizarPrefijo(entrada.pathPrefix)))
+                continue;
+            if (!mejor || entrada.pathPrefix.length > mejor.pathPrefix.length)
+                mejor = entrada;
+        }
+        if (mejor)
+            return mejor.values;
+        // Sin coincidencia en esta capa: fallback a la siguiente (global).
+    }
+    return undefined;
+}
+//# sourceMappingURL=ambito.js.map

package/dist/core/config-viva/ambito.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambito.js","sourceRoot":"","sources":["../../../src/core/config-viva/ambito.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAsBpD,SAAS,kBAAkB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1F,MAAM,OAAO,GAAY,KAAK,CAAC,UAAU,CAAC;IAC1C,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACzC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAI,KAAa,EAAE,GAAW,EAAE,KAAgC;IACrG,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAY,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/D,yDAAyD;YACzD,OAAO,KAAU,CAAC;QACnB,CAAC;QAED,IAAI,KAAoC,CAAC;QACzC,KAAK,MAAM,OAAO,IAAI,KAAiC,EAAE,CAAC;YACzD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAAE,SAAS;YAChF,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM;gBAAE,KAAK,GAAG,OAAO,CAAC;QACpF,CAAC;QACD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,MAAM,CAAC;QAE/B,mEAAmE;IACpE,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/core/config-viva/cache-negativa.d.ts

@@ -0,0 +1,50 @@
+/**
+ * C07 — Negative-cache con TTL para valores de config que son comandos
+ * (`!cmd`) (AUDITORIA-OMP.md C07).
+ *
+ * Problema en resolve-config-value.ts: `commandResultCache` guarda el
+ * resultado AUNQUE sea undefined y para SIEMPRE (vida del proceso). Un
+ * password manager bloqueado o una red caída en el momento de la primera
+ * lectura desactiva la clave para siempre, además sin límite de re-ejecuciones
+ * cuando se decide no cachear.
+ *
+ * Este envoltorio corrige la dirección que falta:
+ *  - éxito  → caché positiva permanente (misma semántica que upstream);
+ *  - fallo (undefined O throw) → caché NEGATIVA con TTL configurable
+ *    (30s por defecto): dentro del TTL no se re-ejecuta el comando; expirado,
+ *    la siguiente lectura vuelve a intentarlo.
+ *
+ * Pensado sobre `resolveConfigValueUncached` (que nunca cachea) para no
+ * depender del Map interno de upstream.
+ */
+/** TTL por defecto de los fallos: 30 s (C07). */
+export declare const TTL_CACHE_NEGATIVA_DEFECTO_MS = 30000;
+export interface OpcionesCacheNegativa {
+    /** TTL de los fallos cacheados, en ms. Default 30_000. */
+    ttlMs?: number;
+    /** Reloj inyectable (tests). Default Date.now. */
+    ahora?: () => number;
+}
+export interface EstadisticasCacheNegativa {
+    /** Veces que se ejecutó el resolver de verdad. */
+    ejecuciones: number;
+    /** Lecturas servidas por un éxito previo cacheado. */
+    aciertosPositivos: number;
+    /** Lecturas servidas por un fallo aún fresco en caché negativa. */
+    fallosServidosDeCache: number;
+    /** Fallos nuevos registrados en caché negativa. */
+    fallosCacheados: number;
+}
+export type ResolverConCacheNegativa = ((clave: string) => string | undefined) & {
+    /** Vacía ambas cachés (positiva y negativa). */
+    limpiar(): void;
+    /** Contadores desde la creación (o el último limpiar() no los toca). */
+    estadisticas(): EstadisticasCacheNegativa;
+};
+/**
+ * Envuelve `resolver` con caché positiva permanente + negativa con TTL.
+ * Un throw del resolver se trata como fallo cacheable (C07: "exit != 0 o
+ * throw"), no se propaga.
+ */
+export declare function resolverConCacheNegativa(resolver: (clave: string) => string | undefined, opciones?: OpcionesCacheNegativa): ResolverConCacheNegativa;
+//# sourceMappingURL=cache-negativa.d.ts.map

package/dist/core/config-viva/cache-negativa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-negativa.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/cache-negativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACzC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG;IAChF,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC;IAChB,wEAAwE;IACxE,YAAY,IAAI,yBAAyB,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAC/C,QAAQ,GAAE,qBAA0B,GAClC,wBAAwB,CAsD1B"}

package/dist/core/config-viva/cache-negativa.js

@@ -0,0 +1,78 @@
+/**
+ * C07 — Negative-cache con TTL para valores de config que son comandos
+ * (`!cmd`) (AUDITORIA-OMP.md C07).
+ *
+ * Problema en resolve-config-value.ts: `commandResultCache` guarda el
+ * resultado AUNQUE sea undefined y para SIEMPRE (vida del proceso). Un
+ * password manager bloqueado o una red caída en el momento de la primera
+ * lectura desactiva la clave para siempre, además sin límite de re-ejecuciones
+ * cuando se decide no cachear.
+ *
+ * Este envoltorio corrige la dirección que falta:
+ *  - éxito  → caché positiva permanente (misma semántica que upstream);
+ *  - fallo (undefined O throw) → caché NEGATIVA con TTL configurable
+ *    (30s por defecto): dentro del TTL no se re-ejecuta el comando; expirado,
+ *    la siguiente lectura vuelve a intentarlo.
+ *
+ * Pensado sobre `resolveConfigValueUncached` (que nunca cachea) para no
+ * depender del Map interno de upstream.
+ */
+/** TTL por defecto de los fallos: 30 s (C07). */
+export const TTL_CACHE_NEGATIVA_DEFECTO_MS = 30_000;
+/**
+ * Envuelve `resolver` con caché positiva permanente + negativa con TTL.
+ * Un throw del resolver se trata como fallo cacheable (C07: "exit != 0 o
+ * throw"), no se propaga.
+ */
+export function resolverConCacheNegativa(resolver, opciones = {}) {
+    const ttlMs = opciones.ttlMs ?? TTL_CACHE_NEGATIVA_DEFECTO_MS;
+    const ahora = opciones.ahora ?? Date.now;
+    const positivos = new Map();
+    // clave → timestamp de expiración del fallo.
+    const negativos = new Map();
+    const stats = {
+        ejecuciones: 0,
+        aciertosPositivos: 0,
+        fallosServidosDeCache: 0,
+        fallosCacheados: 0,
+    };
+    const resuelto = (clave) => {
+        const positivo = positivos.get(clave);
+        if (positivo !== undefined) {
+            stats.aciertosPositivos++;
+            return positivo;
+        }
+        const expiracion = negativos.get(clave);
+        if (expiracion !== undefined) {
+            if (ahora() < expiracion) {
+                stats.fallosServidosDeCache++;
+                return undefined;
+            }
+            negativos.delete(clave);
+        }
+        stats.ejecuciones++;
+        let valor;
+        try {
+            valor = resolver(clave);
+        }
+        catch {
+            valor = undefined;
+        }
+        if (valor !== undefined) {
+            positivos.set(clave, valor);
+        }
+        else {
+            negativos.set(clave, ahora() + ttlMs);
+            stats.fallosCacheados++;
+        }
+        return valor;
+    };
+    const conExtras = resuelto;
+    conExtras.limpiar = () => {
+        positivos.clear();
+        negativos.clear();
+    };
+    conExtras.estadisticas = () => ({ ...stats });
+    return conExtras;
+}
+//# sourceMappingURL=cache-negativa.js.map

package/dist/core/config-viva/cache-negativa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-negativa.js","sourceRoot":"","sources":["../../../src/core/config-viva/cache-negativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AA2BpD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACvC,QAA+C,EAC/C,WAAkC,EAAE;IAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,6BAA6B,CAAC;IAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,KAAK,GAA8B;QACxC,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,qBAAqB,EAAE,CAAC;QACxB,eAAe,EAAE,CAAC;KAClB,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAsB,EAAE;QACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACjB,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;gBAC1B,KAAK,CAAC,qBAAqB,EAAE,CAAC;gBAC9B,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,IAAI,KAAyB,CAAC;QAC9B,IAAI,CAAC;YACJ,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,KAAK,GAAG,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;YACtC,KAAK,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,QAAoC,CAAC;IACvD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;QACxB,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,SAAS,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC;IACF,SAAS,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9C,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/core/config-viva/headers-vivos.d.ts

@@ -0,0 +1,41 @@
+/**
+ * C07 — Headers vivos (AUDITORIA-OMP.md `createLiveConfigHeaders`).
+ *
+ * Algunos proveedores rotan tokens (vault, aws sigv4, scripts propios): sus
+ * headers de config son `!cmd` y el valor de hace 5 minutos ya no vale.
+ * Resolver en CADA lectura martilla el comando; resolver UNA vez congela un
+ * token muerto. Compromiso: snapshot re-resuelto como mucho cada TTL (5s).
+ *
+ * PUNTO EXACTO DE INTEGRACIÓN CON provider-composer (requiere hunk upstream;
+ * presupuesto agotado — patrón C01/D07, se documenta en vez de tocar):
+ *   src/core/provider-composer.ts, `composeApiKeyAuth` → `resolve()`
+ *   (línea ~361) y `composeOAuthAuth` → `toAuth()` (~382), hoy:
+ *       const headers = resolveHeadersOrThrow(rawHeaders, ...);
+ *   quedaría:
+ *       const headers = crearHeadersVivos(
+ *           () => resolveHeadersOrThrow(rawHeaders, `provider "${providerId}"`, headerEnv),
+ *           { ttlMs: 5000 },
+ *       ).get();
+ *   El `.get()` se evalúa por petición (resolve()/toAuth() corren por
+ *   request), así que el token rota con retardo máximo de ttlMs.
+ */
+/** TTL por defecto del snapshot: 5000 ms. */
+export declare const TTL_HEADERS_VIVOS_DEFECTO_MS = 5000;
+export interface OpcionesHeadersVivos {
+    /** Edad máxima del snapshot antes de re-resolver. Default 5000. */
+    ttlMs?: number;
+    /** Reloj inyectable (tests). Default Date.now. */
+    ahora?: () => number;
+}
+export interface HeadersVivos {
+    /**
+     * Devuelve el snapshot de headers, re-resolviendo si el anterior tiene más
+     * de ttlMs. Un fallo del resolver NO se cachea como éxito: devuelve lo que
+     * dé (posiblemente undefined) y la siguiente lectura fuera de TTL reintenta.
+     */
+    get(): Record<string, string> | undefined;
+    /** Descarta el snapshot: la próxima get() re-resuelve seguro. */
+    limpiar(): void;
+}
+export declare function crearHeadersVivos(resolver: () => Record<string, string> | undefined, opciones?: OpcionesHeadersVivos): HeadersVivos;
+//# sourceMappingURL=headers-vivos.d.ts.map

package/dist/core/config-viva/headers-vivos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers-vivos.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/headers-vivos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACpC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1C,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,GAAE,oBAAyB,GACjC,YAAY,CAmBd"}

package/dist/core/config-viva/headers-vivos.js

@@ -0,0 +1,43 @@
+/**
+ * C07 — Headers vivos (AUDITORIA-OMP.md `createLiveConfigHeaders`).
+ *
+ * Algunos proveedores rotan tokens (vault, aws sigv4, scripts propios): sus
+ * headers de config son `!cmd` y el valor de hace 5 minutos ya no vale.
+ * Resolver en CADA lectura martilla el comando; resolver UNA vez congela un
+ * token muerto. Compromiso: snapshot re-resuelto como mucho cada TTL (5s).
+ *
+ * PUNTO EXACTO DE INTEGRACIÓN CON provider-composer (requiere hunk upstream;
+ * presupuesto agotado — patrón C01/D07, se documenta en vez de tocar):
+ *   src/core/provider-composer.ts, `composeApiKeyAuth` → `resolve()`
+ *   (línea ~361) y `composeOAuthAuth` → `toAuth()` (~382), hoy:
+ *       const headers = resolveHeadersOrThrow(rawHeaders, ...);
+ *   quedaría:
+ *       const headers = crearHeadersVivos(
+ *           () => resolveHeadersOrThrow(rawHeaders, `provider "${providerId}"`, headerEnv),
+ *           { ttlMs: 5000 },
+ *       ).get();
+ *   El `.get()` se evalúa por petición (resolve()/toAuth() corren por
+ *   request), así que el token rota con retardo máximo de ttlMs.
+ */
+/** TTL por defecto del snapshot: 5000 ms. */
+export const TTL_HEADERS_VIVOS_DEFECTO_MS = 5_000;
+export function crearHeadersVivos(resolver, opciones = {}) {
+    const ttlMs = opciones.ttlMs ?? TTL_HEADERS_VIVOS_DEFECTO_MS;
+    const ahora = opciones.ahora ?? Date.now;
+    let snapshot;
+    let resueltoEn = Number.NEGATIVE_INFINITY;
+    return {
+        get() {
+            if (ahora() - resueltoEn < ttlMs)
+                return snapshot;
+            snapshot = resolver();
+            resueltoEn = ahora();
+            return snapshot;
+        },
+        limpiar() {
+            snapshot = undefined;
+            resueltoEn = Number.NEGATIVE_INFINITY;
+        },
+    };
+}
+//# sourceMappingURL=headers-vivos.js.map

package/dist/core/config-viva/headers-vivos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers-vivos.js","sourceRoot":"","sources":["../../../src/core/config-viva/headers-vivos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAoBlD,MAAM,UAAU,iBAAiB,CAChC,QAAkD,EAClD,WAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,4BAA4B,CAAC;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IAEzC,IAAI,QAA4C,CAAC;IACjD,IAAI,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAE1C,OAAO;QACN,GAAG;YACF,IAAI,KAAK,EAAE,GAAG,UAAU,GAAG,KAAK;gBAAE,OAAO,QAAQ,CAAC;YAClD,QAAQ,GAAG,QAAQ,EAAE,CAAC;YACtB,UAAU,GAAG,KAAK,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,OAAO;YACN,QAAQ,GAAG,SAAS,CAAC;YACrB,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACvC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/config-viva/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Config viva (C05+C07, AUDITORIA-OMP.md).
+ *
+ * - C05: settings con ámbito de ruta ({pathPrefix, values} por cwd).
+ * - C07: negative-cache TTL 30s para `!cmd` + headers vivos re-resueltos.
+ *
+ * Consumidor real mínimo: proveedor de capability "config-viva" (proveedor.ts)
+ * que combina ámbito + caché negativa. La integración con provider-composer
+ * para headers vivos está documentada en headers-vivos.ts (requeriría hunk
+ * upstream; presupuesto agotado — patrón C01/D07).
+ */
+export { type CapaAmbito, resolverValorPorAmbito, type ValorAmbito, type ValorConAmbito, } from "./ambito.ts";
+export { type EstadisticasCacheNegativa, type OpcionesCacheNegativa, type ResolverConCacheNegativa, resolverConCacheNegativa, TTL_CACHE_NEGATIVA_DEFECTO_MS, } from "./cache-negativa.ts";
+export { crearHeadersVivos, type HeadersVivos, type OpcionesHeadersVivos, TTL_HEADERS_VIVOS_DEFECTO_MS, } from "./headers-vivos.ts";
+export { CAPABILITY_CONFIG_VIVA, cacheComandosConfigViva, crearProveedorConfigViva, definirDefinitionConfigViva, type OpcionesProveedorConfigViva, reiniciarCacheComandos, type ValorConfigViva, } from "./proveedor.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/config-viva/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACN,KAAK,UAAU,EACf,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,4BAA4B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/core/config-viva/index.js

@@ -0,0 +1,16 @@
+/**
+ * Config viva (C05+C07, AUDITORIA-OMP.md).
+ *
+ * - C05: settings con ámbito de ruta ({pathPrefix, values} por cwd).
+ * - C07: negative-cache TTL 30s para `!cmd` + headers vivos re-resueltos.
+ *
+ * Consumidor real mínimo: proveedor de capability "config-viva" (proveedor.ts)
+ * que combina ámbito + caché negativa. La integración con provider-composer
+ * para headers vivos está documentada en headers-vivos.ts (requeriría hunk
+ * upstream; presupuesto agotado — patrón C01/D07).
+ */
+export { resolverValorPorAmbito, } from "./ambito.js";
+export { resolverConCacheNegativa, TTL_CACHE_NEGATIVA_DEFECTO_MS, } from "./cache-negativa.js";
+export { crearHeadersVivos, TTL_HEADERS_VIVOS_DEFECTO_MS, } from "./headers-vivos.js";
+export { CAPABILITY_CONFIG_VIVA, cacheComandosConfigViva, crearProveedorConfigViva, definirDefinitionConfigViva, reiniciarCacheComandos, } from "./proveedor.js";
+//# sourceMappingURL=index.js.map

package/dist/core/config-viva/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config-viva/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEN,sBAAsB,GAGtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIN,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,iBAAiB,EAGjB,4BAA4B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAE3B,sBAAsB,GAEtB,MAAM,gBAAgB,CAAC"}