@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/muestreo-restringido.d.ts

@@ -0,0 +1,49 @@
+/**
+ * La decodificación restringida, con su propio interruptor.
+ *
+ * QUÉ ES. Cuando el proveedor lo admite, el esquema de cada herramienta se le
+ * pasa en modo estricto, de forma que el modelo **no puede** emitir una llamada
+ * que no encaje: no es que la rechacemos después, es que no llega a generarse.
+ *
+ * POR QUÉ IMPORTA AQUÍ. El fallo más caro que medimos contra un modelo
+ * gratuito fue exactamente de esa clase: mandó `edits` como cadena de JSON con
+ * tabuladores crudos dentro, y el turno entero se perdió. Con decodificación
+ * restringida ese estado no existe. La tolerancia de
+ * `parsearJsonTolerante` repara el daño; esto lo evita.
+ *
+ * POR QUÉ NO VIENE ENCENDIDA. Porque no está medida de punta a punta, y en
+ * este proyecto encender algo por lo bien que suena es como se llega a una
+ * casilla verde que no protege de nada. Lo que SÍ está medido, ejecutándolo:
+ *
+ *   - las cuatro herramientas que la declaran —`edit`, `write`, `read`,
+ *     `bash`— admiten esquema estricto, así que la palanca está conectada y
+ *     no es decorativa;
+ *   - la comparación con el modelo real no se pudo completar: el nivel
+ *     gratuito de OpenRouter contesta a un ping de cinco tokens pero no
+ *     sostiene un turno de trece mil, y dos intentos se agotaron.
+ *
+ * Así que se deja apagada y se dice por qué, en vez de encenderla a ciegas o
+ * fingir que la decisión está tomada.
+ *
+ * LO QUE SÍ CAMBIA. Antes solo se activaba con `PI_EXPERIMENTAL=1`, que
+ * enciende TODO lo experimental a la vez. Quien quiera probar solo esto tenía
+ * que aceptar lo demás, y en un equipo con control de cambios eso significa no
+ * probarlo nunca. Ahora tiene su propio interruptor.
+ */
+/** Cómo quedó activada, o por qué no lo está. Tres estados y no dos. */
+export interface EstadoDelMuestreo {
+    activo: boolean;
+    /**
+     * `propio`      — encendida por su variable, sin arrastrar lo demás.
+     * `experimental`— encendida de rebote por `PI_EXPERIMENTAL=1`.
+     * `apagada`     — ninguna de las dos.
+     */
+    origen: "propio" | "experimental" | "apagada";
+    motivo: string;
+}
+/** La variable dedicada. No hay ajuste en `settings.json` todavía, a propósito:
+ * un ajuste persistido para algo sin medir invita a olvidarlo encendido. */
+export declare const VARIABLE = "ADA_MUESTREO_RESTRINGIDO";
+export declare function estadoDelMuestreo(env?: NodeJS.ProcessEnv): EstadoDelMuestreo;
+export declare function muestreoRestringidoActivo(env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=muestreo-restringido.d.ts.map

package/dist/core/muestreo-restringido.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"muestreo-restringido.d.ts","sourceRoot":"","sources":["../../src/core/muestreo-restringido.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,4EAAwE;AACxE,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;CACf;AAED;4EAC4E;AAC5E,eAAO,MAAM,QAAQ,6BAA6B,CAAC;AAMnD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAsBzF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEvF","sourcesContent":["/**\n * La decodificación restringida, con su propio interruptor.\n *\n * QUÉ ES. Cuando el proveedor lo admite, el esquema de cada herramienta se le\n * pasa en modo estricto, de forma que el modelo **no puede** emitir una llamada\n * que no encaje: no es que la rechacemos después, es que no llega a generarse.\n *\n * POR QUÉ IMPORTA AQUÍ. El fallo más caro que medimos contra un modelo\n * gratuito fue exactamente de esa clase: mandó `edits` como cadena de JSON con\n * tabuladores crudos dentro, y el turno entero se perdió. Con decodificación\n * restringida ese estado no existe. La tolerancia de\n * `parsearJsonTolerante` repara el daño; esto lo evita.\n *\n * POR QUÉ NO VIENE ENCENDIDA. Porque no está medida de punta a punta, y en\n * este proyecto encender algo por lo bien que suena es como se llega a una\n * casilla verde que no protege de nada. Lo que SÍ está medido, ejecutándolo:\n *\n *   - las cuatro herramientas que la declaran —`edit`, `write`, `read`,\n *     `bash`— admiten esquema estricto, así que la palanca está conectada y\n *     no es decorativa;\n *   - la comparación con el modelo real no se pudo completar: el nivel\n *     gratuito de OpenRouter contesta a un ping de cinco tokens pero no\n *     sostiene un turno de trece mil, y dos intentos se agotaron.\n *\n * Así que se deja apagada y se dice por qué, en vez de encenderla a ciegas o\n * fingir que la decisión está tomada.\n *\n * LO QUE SÍ CAMBIA. Antes solo se activaba con `PI_EXPERIMENTAL=1`, que\n * enciende TODO lo experimental a la vez. Quien quiera probar solo esto tenía\n * que aceptar lo demás, y en un equipo con control de cambios eso significa no\n * probarlo nunca. Ahora tiene su propio interruptor.\n */\n\n/** Cómo quedó activada, o por qué no lo está. Tres estados y no dos. */\nexport interface EstadoDelMuestreo {\n\tactivo: boolean;\n\t/**\n\t * `propio`      — encendida por su variable, sin arrastrar lo demás.\n\t * `experimental`— encendida de rebote por `PI_EXPERIMENTAL=1`.\n\t * `apagada`     — ninguna de las dos.\n\t */\n\torigen: \"propio\" | \"experimental\" | \"apagada\";\n\tmotivo: string;\n}\n\n/** La variable dedicada. No hay ajuste en `settings.json` todavía, a propósito:\n * un ajuste persistido para algo sin medir invita a olvidarlo encendido. */\nexport const VARIABLE = \"ADA_MUESTREO_RESTRINGIDO\";\n\nfunction encendidaPor(valor: string | undefined): boolean {\n\treturn valor === \"1\" || valor === \"true\" || valor === \"yes\";\n}\n\nexport function estadoDelMuestreo(env: NodeJS.ProcessEnv = process.env): EstadoDelMuestreo {\n\tconst propia = env[VARIABLE];\n\tif (propia !== undefined) {\n\t\t// Un valor explícito manda sobre `PI_EXPERIMENTAL`, incluso para APAGARLA:\n\t\t// quien enciende todo lo experimental pero apaga esto a mano ha tomado una\n\t\t// decisión, y respetarla es lo contrario de un defecto silencioso.\n\t\treturn encendidaPor(propia)\n\t\t\t? { activo: true, origen: \"propio\", motivo: `${VARIABLE}=${propia}` }\n\t\t\t: { activo: false, origen: \"apagada\", motivo: `${VARIABLE}=${propia} la apaga explícitamente` };\n\t}\n\t// Se lee del `env` recibido y no de `process.env` a través de\n\t// `areExperimentalFeaturesEnabled()`: esa función lee el entorno del proceso\n\t// directamente, así que la rama de compatibilidad no se podía probar sin\n\t// ensuciar el proceso entero. Lo cazó la propia prueba.\n\tif (env.PI_EXPERIMENTAL === \"1\") {\n\t\treturn { activo: true, origen: \"experimental\", motivo: \"PI_EXPERIMENTAL=1 enciende todo lo experimental\" };\n\t}\n\treturn {\n\t\tactivo: false,\n\t\torigen: \"apagada\",\n\t\tmotivo: `apagada por defecto: no está medida de punta a punta. Enciéndela con ${VARIABLE}=1`,\n\t};\n}\n\nexport function muestreoRestringidoActivo(env: NodeJS.ProcessEnv = process.env): boolean {\n\treturn estadoDelMuestreo(env).activo;\n}\n"]}

package/dist/core/muestreo-restringido.js

@@ -0,0 +1,65 @@
+/**
+ * La decodificación restringida, con su propio interruptor.
+ *
+ * QUÉ ES. Cuando el proveedor lo admite, el esquema de cada herramienta se le
+ * pasa en modo estricto, de forma que el modelo **no puede** emitir una llamada
+ * que no encaje: no es que la rechacemos después, es que no llega a generarse.
+ *
+ * POR QUÉ IMPORTA AQUÍ. El fallo más caro que medimos contra un modelo
+ * gratuito fue exactamente de esa clase: mandó `edits` como cadena de JSON con
+ * tabuladores crudos dentro, y el turno entero se perdió. Con decodificación
+ * restringida ese estado no existe. La tolerancia de
+ * `parsearJsonTolerante` repara el daño; esto lo evita.
+ *
+ * POR QUÉ NO VIENE ENCENDIDA. Porque no está medida de punta a punta, y en
+ * este proyecto encender algo por lo bien que suena es como se llega a una
+ * casilla verde que no protege de nada. Lo que SÍ está medido, ejecutándolo:
+ *
+ *   - las cuatro herramientas que la declaran —`edit`, `write`, `read`,
+ *     `bash`— admiten esquema estricto, así que la palanca está conectada y
+ *     no es decorativa;
+ *   - la comparación con el modelo real no se pudo completar: el nivel
+ *     gratuito de OpenRouter contesta a un ping de cinco tokens pero no
+ *     sostiene un turno de trece mil, y dos intentos se agotaron.
+ *
+ * Así que se deja apagada y se dice por qué, en vez de encenderla a ciegas o
+ * fingir que la decisión está tomada.
+ *
+ * LO QUE SÍ CAMBIA. Antes solo se activaba con `PI_EXPERIMENTAL=1`, que
+ * enciende TODO lo experimental a la vez. Quien quiera probar solo esto tenía
+ * que aceptar lo demás, y en un equipo con control de cambios eso significa no
+ * probarlo nunca. Ahora tiene su propio interruptor.
+ */
+/** La variable dedicada. No hay ajuste en `settings.json` todavía, a propósito:
+ * un ajuste persistido para algo sin medir invita a olvidarlo encendido. */
+export const VARIABLE = "ADA_MUESTREO_RESTRINGIDO";
+function encendidaPor(valor) {
+    return valor === "1" || valor === "true" || valor === "yes";
+}
+export function estadoDelMuestreo(env = process.env) {
+    const propia = env[VARIABLE];
+    if (propia !== undefined) {
+        // Un valor explícito manda sobre `PI_EXPERIMENTAL`, incluso para APAGARLA:
+        // quien enciende todo lo experimental pero apaga esto a mano ha tomado una
+        // decisión, y respetarla es lo contrario de un defecto silencioso.
+        return encendidaPor(propia)
+            ? { activo: true, origen: "propio", motivo: `${VARIABLE}=${propia}` }
+            : { activo: false, origen: "apagada", motivo: `${VARIABLE}=${propia} la apaga explícitamente` };
+    }
+    // Se lee del `env` recibido y no de `process.env` a través de
+    // `areExperimentalFeaturesEnabled()`: esa función lee el entorno del proceso
+    // directamente, así que la rama de compatibilidad no se podía probar sin
+    // ensuciar el proceso entero. Lo cazó la propia prueba.
+    if (env.PI_EXPERIMENTAL === "1") {
+        return { activo: true, origen: "experimental", motivo: "PI_EXPERIMENTAL=1 enciende todo lo experimental" };
+    }
+    return {
+        activo: false,
+        origen: "apagada",
+        motivo: `apagada por defecto: no está medida de punta a punta. Enciéndela con ${VARIABLE}=1`,
+    };
+}
+export function muestreoRestringidoActivo(env = process.env) {
+    return estadoDelMuestreo(env).activo;
+}
+//# sourceMappingURL=muestreo-restringido.js.map

package/dist/core/muestreo-restringido.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"muestreo-restringido.js","sourceRoot":"","sources":["../../src/core/muestreo-restringido.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAcH;4EAC4E;AAC5E,MAAM,CAAC,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAEnD,SAAS,YAAY,CAAC,KAAyB,EAAW;IACzD,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAAA,CAC5D;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAqB;IAC1F,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,4EAA2E;QAC3E,2EAA2E;QAC3E,oEAAmE;QACnE,OAAO,YAAY,CAAC,MAAM,CAAC;YAC1B,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,MAAM,EAAE,EAAE;YACrE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,MAAM,2BAA0B,EAAE,CAAC;IAClG,CAAC;IACD,+DAA8D;IAC9D,8EAA6E;IAC7E,2EAAyE;IACzE,yDAAwD;IACxD,IAAI,GAAG,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,iDAAiD,EAAE,CAAC;IAC5G,CAAC;IACD,OAAO;QACN,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,0EAAwE,QAAQ,IAAI;KAC5F,CAAC;AAAA,CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAW;IACxF,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AAAA,CACrC","sourcesContent":["/**\n * La decodificación restringida, con su propio interruptor.\n *\n * QUÉ ES. Cuando el proveedor lo admite, el esquema de cada herramienta se le\n * pasa en modo estricto, de forma que el modelo **no puede** emitir una llamada\n * que no encaje: no es que la rechacemos después, es que no llega a generarse.\n *\n * POR QUÉ IMPORTA AQUÍ. El fallo más caro que medimos contra un modelo\n * gratuito fue exactamente de esa clase: mandó `edits` como cadena de JSON con\n * tabuladores crudos dentro, y el turno entero se perdió. Con decodificación\n * restringida ese estado no existe. La tolerancia de\n * `parsearJsonTolerante` repara el daño; esto lo evita.\n *\n * POR QUÉ NO VIENE ENCENDIDA. Porque no está medida de punta a punta, y en\n * este proyecto encender algo por lo bien que suena es como se llega a una\n * casilla verde que no protege de nada. Lo que SÍ está medido, ejecutándolo:\n *\n *   - las cuatro herramientas que la declaran —`edit`, `write`, `read`,\n *     `bash`— admiten esquema estricto, así que la palanca está conectada y\n *     no es decorativa;\n *   - la comparación con el modelo real no se pudo completar: el nivel\n *     gratuito de OpenRouter contesta a un ping de cinco tokens pero no\n *     sostiene un turno de trece mil, y dos intentos se agotaron.\n *\n * Así que se deja apagada y se dice por qué, en vez de encenderla a ciegas o\n * fingir que la decisión está tomada.\n *\n * LO QUE SÍ CAMBIA. Antes solo se activaba con `PI_EXPERIMENTAL=1`, que\n * enciende TODO lo experimental a la vez. Quien quiera probar solo esto tenía\n * que aceptar lo demás, y en un equipo con control de cambios eso significa no\n * probarlo nunca. Ahora tiene su propio interruptor.\n */\n\n/** Cómo quedó activada, o por qué no lo está. Tres estados y no dos. */\nexport interface EstadoDelMuestreo {\n\tactivo: boolean;\n\t/**\n\t * `propio`      — encendida por su variable, sin arrastrar lo demás.\n\t * `experimental`— encendida de rebote por `PI_EXPERIMENTAL=1`.\n\t * `apagada`     — ninguna de las dos.\n\t */\n\torigen: \"propio\" | \"experimental\" | \"apagada\";\n\tmotivo: string;\n}\n\n/** La variable dedicada. No hay ajuste en `settings.json` todavía, a propósito:\n * un ajuste persistido para algo sin medir invita a olvidarlo encendido. */\nexport const VARIABLE = \"ADA_MUESTREO_RESTRINGIDO\";\n\nfunction encendidaPor(valor: string | undefined): boolean {\n\treturn valor === \"1\" || valor === \"true\" || valor === \"yes\";\n}\n\nexport function estadoDelMuestreo(env: NodeJS.ProcessEnv = process.env): EstadoDelMuestreo {\n\tconst propia = env[VARIABLE];\n\tif (propia !== undefined) {\n\t\t// Un valor explícito manda sobre `PI_EXPERIMENTAL`, incluso para APAGARLA:\n\t\t// quien enciende todo lo experimental pero apaga esto a mano ha tomado una\n\t\t// decisión, y respetarla es lo contrario de un defecto silencioso.\n\t\treturn encendidaPor(propia)\n\t\t\t? { activo: true, origen: \"propio\", motivo: `${VARIABLE}=${propia}` }\n\t\t\t: { activo: false, origen: \"apagada\", motivo: `${VARIABLE}=${propia} la apaga explícitamente` };\n\t}\n\t// Se lee del `env` recibido y no de `process.env` a través de\n\t// `areExperimentalFeaturesEnabled()`: esa función lee el entorno del proceso\n\t// directamente, así que la rama de compatibilidad no se podía probar sin\n\t// ensuciar el proceso entero. Lo cazó la propia prueba.\n\tif (env.PI_EXPERIMENTAL === \"1\") {\n\t\treturn { activo: true, origen: \"experimental\", motivo: \"PI_EXPERIMENTAL=1 enciende todo lo experimental\" };\n\t}\n\treturn {\n\t\tactivo: false,\n\t\torigen: \"apagada\",\n\t\tmotivo: `apagada por defecto: no está medida de punta a punta. Enciéndela con ${VARIABLE}=1`,\n\t};\n}\n\nexport function muestreoRestringidoActivo(env: NodeJS.ProcessEnv = process.env): boolean {\n\treturn estadoDelMuestreo(env).activo;\n}\n"]}

package/dist/core/orphan-process-journal.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Journal de procesos huérfanos — no dejar dev servers colgados tras un crash.
+ *
+ * `utils/shell.ts` guarda los pids detached en un `Set` en memoria y los mata en
+ * las señales de apagado limpio. En SIGKILL, OOM o un force-quit de la app de
+ * escritorio ese Set se evapora, y el watcher, el dev server o el test runner
+ * siguen vivos ocupando puertos hasta que alguien los encuentra a mano.
+ *
+ * Esto persiste los pids a disco para poder barrerlos en el siguiente arranque.
+ *
+ * LA VERIFICACIÓN DE IDENTIDAD NO ES OPCIONAL. Los pids se reciclan: matar por
+ * pid a secas puede matar un proceso ajeno que heredó el número, que es
+ * estrictamente peor que la fuga que arreglamos. Por eso se guarda además un
+ * identificador de arranque del proceso (hora de inicio) y solo se mata si
+ * coincide.
+ */
+export interface OrphanRecord {
+    pid: number;
+    /** Identidad del arranque: distingue un pid reciclado del original. */
+    startId?: string;
+    active: boolean;
+    ts: string;
+}
+/**
+ * Identificador del arranque de un proceso. `undefined` si no existe o no se
+ * puede determinar — y en ese caso NO se mata nada.
+ */
+export declare function processStartId(pid: number): string | undefined;
+export declare class OrphanProcessJournal {
+    private path;
+    /** La ruta deriva de agentDir, NO de una variable de entorno: un subagente
+     * que hereda el entorno no debe appendear en el journal de su padre. */
+    constructor(agentDir: string);
+    track(pid: number): Promise<void>;
+    untrack(pid: number): Promise<void>;
+    private write;
+    /** Último estado conocido de cada pid; solo los que quedaron activos. */
+    pending(): Promise<Array<{
+        pid: number;
+        startId: string;
+    }>>;
+    /**
+     * Mata los huérfanos cuya identidad AÚN coincide y limpia el journal.
+     * Devuelve los pids realmente matados.
+     */
+    reap(kill: (pid: number) => void): Promise<number[]>;
+}
+//# sourceMappingURL=orphan-process-journal.d.ts.map

package/dist/core/orphan-process-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-process-journal.d.ts","sourceRoot":"","sources":["../../src/core/orphan-process-journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmB9D;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,IAAI,CAAS;IAErB;4EACwE;IACxE,YAAY,QAAQ,EAAE,MAAM,EAE3B;IAEK,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtC;IAEK,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;YAEa,KAAK;IASnB,0EAAyE;IACnE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAmBhE;IAED;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAczD;CACD","sourcesContent":["/**\n * Journal de procesos huérfanos — no dejar dev servers colgados tras un crash.\n *\n * `utils/shell.ts` guarda los pids detached en un `Set` en memoria y los mata en\n * las señales de apagado limpio. En SIGKILL, OOM o un force-quit de la app de\n * escritorio ese Set se evapora, y el watcher, el dev server o el test runner\n * siguen vivos ocupando puertos hasta que alguien los encuentra a mano.\n *\n * Esto persiste los pids a disco para poder barrerlos en el siguiente arranque.\n *\n * LA VERIFICACIÓN DE IDENTIDAD NO ES OPCIONAL. Los pids se reciclan: matar por\n * pid a secas puede matar un proceso ajeno que heredó el número, que es\n * estrictamente peor que la fuga que arreglamos. Por eso se guarda además un\n * identificador de arranque del proceso (hora de inicio) y solo se mata si\n * coincide.\n */\n\nimport { execFileSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { appendFile, mkdir, readFile, rm } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nexport interface OrphanRecord {\n\tpid: number;\n\t/** Identidad del arranque: distingue un pid reciclado del original. */\n\tstartId?: string;\n\tactive: boolean;\n\tts: string;\n}\n\n/**\n * Identificador del arranque de un proceso. `undefined` si no existe o no se\n * puede determinar — y en ese caso NO se mata nada.\n */\nexport function processStartId(pid: number): string | undefined {\n\tif (!Number.isInteger(pid) || pid <= 0) return undefined;\n\t// Linux: campo 22 de /proc/<pid>/stat es starttime en jiffies.\n\ttry {\n\t\tconst stat = readFileSync(`/proc/${pid}/stat`, \"utf8\");\n\t\tconst fields = stat.slice(stat.lastIndexOf(\")\") + 2).split(\" \");\n\t\tif (fields[19]) return `proc:${fields[19]}`;\n\t} catch {\n\t\t// macOS/BSD no tienen /proc: se usa ps.\n\t}\n\ttry {\n\t\tconst out = execFileSync(\"ps\", [\"-p\", String(pid), \"-o\", \"lstart=\"], {\n\t\t\tencoding: \"utf-8\",\n\t\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\t}).trim();\n\t\treturn out ? `ps:${out}` : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport class OrphanProcessJournal {\n\tprivate path: string;\n\n\t/** La ruta deriva de agentDir, NO de una variable de entorno: un subagente\n\t * que hereda el entorno no debe appendear en el journal de su padre. */\n\tconstructor(agentDir: string) {\n\t\tthis.path = join(agentDir, \"orphan-processes.jsonl\");\n\t}\n\n\tasync track(pid: number): Promise<void> {\n\t\tawait this.write({ pid, startId: processStartId(pid), active: true, ts: new Date().toISOString() });\n\t}\n\n\tasync untrack(pid: number): Promise<void> {\n\t\tawait this.write({ pid, active: false, ts: new Date().toISOString() });\n\t}\n\n\tprivate async write(record: OrphanRecord): Promise<void> {\n\t\ttry {\n\t\t\tawait mkdir(dirname(this.path), { recursive: true });\n\t\t\tawait appendFile(this.path, `${JSON.stringify(record)}\\n`, \"utf-8\");\n\t\t} catch {\n\t\t\t// El journal nunca debe romper el lanzamiento de un proceso.\n\t\t}\n\t}\n\n\t/** Último estado conocido de cada pid; solo los que quedaron activos. */\n\tasync pending(): Promise<Array<{ pid: number; startId: string }>> {\n\t\tlet raw: string;\n\t\ttry {\n\t\t\traw = await readFile(this.path, \"utf-8\");\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t\tconst latest = new Map<number, OrphanRecord>();\n\t\tfor (const line of raw.split(\"\\n\").filter(Boolean)) {\n\t\t\ttry {\n\t\t\t\tconst record = JSON.parse(line) as OrphanRecord;\n\t\t\t\tlatest.set(record.pid, record);\n\t\t\t} catch {\n\t\t\t\t// Un crash puede truncar el último append; el resto sigue siendo válido.\n\t\t\t}\n\t\t}\n\t\treturn [...latest.values()]\n\t\t\t.filter((r): r is OrphanRecord & { startId: string } => r.active && typeof r.startId === \"string\")\n\t\t\t.map((r) => ({ pid: r.pid, startId: r.startId }));\n\t}\n\n\t/**\n\t * Mata los huérfanos cuya identidad AÚN coincide y limpia el journal.\n\t * Devuelve los pids realmente matados.\n\t */\n\tasync reap(kill: (pid: number) => void): Promise<number[]> {\n\t\tconst killed: number[] = [];\n\t\tfor (const orphan of await this.pending()) {\n\t\t\t// Si el pid se recicló, el startId ya no coincide: no es nuestro.\n\t\t\tif (processStartId(orphan.pid) !== orphan.startId) continue;\n\t\t\ttry {\n\t\t\t\tkill(orphan.pid);\n\t\t\t\tkilled.push(orphan.pid);\n\t\t\t} catch {\n\t\t\t\t// ya muerto / sin permisos\n\t\t\t}\n\t\t}\n\t\tawait rm(this.path, { force: true }).catch(() => {});\n\t\treturn killed;\n\t}\n}\n"]}

package/dist/core/orphan-process-journal.js

@@ -0,0 +1,116 @@
+/**
+ * Journal de procesos huérfanos — no dejar dev servers colgados tras un crash.
+ *
+ * `utils/shell.ts` guarda los pids detached en un `Set` en memoria y los mata en
+ * las señales de apagado limpio. En SIGKILL, OOM o un force-quit de la app de
+ * escritorio ese Set se evapora, y el watcher, el dev server o el test runner
+ * siguen vivos ocupando puertos hasta que alguien los encuentra a mano.
+ *
+ * Esto persiste los pids a disco para poder barrerlos en el siguiente arranque.
+ *
+ * LA VERIFICACIÓN DE IDENTIDAD NO ES OPCIONAL. Los pids se reciclan: matar por
+ * pid a secas puede matar un proceso ajeno que heredó el número, que es
+ * estrictamente peor que la fuga que arreglamos. Por eso se guarda además un
+ * identificador de arranque del proceso (hora de inicio) y solo se mata si
+ * coincide.
+ */
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { appendFile, mkdir, readFile, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/**
+ * Identificador del arranque de un proceso. `undefined` si no existe o no se
+ * puede determinar — y en ese caso NO se mata nada.
+ */
+export function processStartId(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return undefined;
+    // Linux: campo 22 de /proc/<pid>/stat es starttime en jiffies.
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+        const fields = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
+        if (fields[19])
+            return `proc:${fields[19]}`;
+    }
+    catch {
+        // macOS/BSD no tienen /proc: se usa ps.
+    }
+    try {
+        const out = execFileSync("ps", ["-p", String(pid), "-o", "lstart="], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return out ? `ps:${out}` : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class OrphanProcessJournal {
+    path;
+    /** La ruta deriva de agentDir, NO de una variable de entorno: un subagente
+     * que hereda el entorno no debe appendear en el journal de su padre. */
+    constructor(agentDir) {
+        this.path = join(agentDir, "orphan-processes.jsonl");
+    }
+    async track(pid) {
+        await this.write({ pid, startId: processStartId(pid), active: true, ts: new Date().toISOString() });
+    }
+    async untrack(pid) {
+        await this.write({ pid, active: false, ts: new Date().toISOString() });
+    }
+    async write(record) {
+        try {
+            await mkdir(dirname(this.path), { recursive: true });
+            await appendFile(this.path, `${JSON.stringify(record)}\n`, "utf-8");
+        }
+        catch {
+            // El journal nunca debe romper el lanzamiento de un proceso.
+        }
+    }
+    /** Último estado conocido de cada pid; solo los que quedaron activos. */
+    async pending() {
+        let raw;
+        try {
+            raw = await readFile(this.path, "utf-8");
+        }
+        catch {
+            return [];
+        }
+        const latest = new Map();
+        for (const line of raw.split("\n").filter(Boolean)) {
+            try {
+                const record = JSON.parse(line);
+                latest.set(record.pid, record);
+            }
+            catch {
+                // Un crash puede truncar el último append; el resto sigue siendo válido.
+            }
+        }
+        return [...latest.values()]
+            .filter((r) => r.active && typeof r.startId === "string")
+            .map((r) => ({ pid: r.pid, startId: r.startId }));
+    }
+    /**
+     * Mata los huérfanos cuya identidad AÚN coincide y limpia el journal.
+     * Devuelve los pids realmente matados.
+     */
+    async reap(kill) {
+        const killed = [];
+        for (const orphan of await this.pending()) {
+            // Si el pid se recicló, el startId ya no coincide: no es nuestro.
+            if (processStartId(orphan.pid) !== orphan.startId)
+                continue;
+            try {
+                kill(orphan.pid);
+                killed.push(orphan.pid);
+            }
+            catch {
+                // ya muerto / sin permisos
+            }
+        }
+        await rm(this.path, { force: true }).catch(() => { });
+        return killed;
+    }
+}
+//# sourceMappingURL=orphan-process-journal.js.map

package/dist/core/orphan-process-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-process-journal.js","sourceRoot":"","sources":["../../src/core/orphan-process-journal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Journal de procesos huérfanos — no dejar dev servers colgados tras un crash.\n *\n * `utils/shell.ts` guarda los pids detached en un `Set` en memoria y los mata en\n * las señales de apagado limpio. En SIGKILL, OOM o un force-quit de la app de\n * escritorio ese Set se evapora, y el watcher, el dev server o el test runner\n * siguen vivos ocupando puertos hasta que alguien los encuentra a mano.\n *\n * Esto persiste los pids a disco para poder barrerlos en el siguiente arranque.\n *\n * LA VERIFICACIÓN DE IDENTIDAD NO ES OPCIONAL. Los pids se reciclan: matar por\n * pid a secas puede matar un proceso ajeno que heredó el número, que es\n * estrictamente peor que la fuga que arreglamos. Por eso se guarda además un\n * identificador de arranque del proceso (hora de inicio) y solo se mata si\n * coincide.\n */\n\nimport { execFileSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { appendFile, mkdir, readFile, rm } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nexport interface OrphanRecord {\n\tpid: number;\n\t/** Identidad del arranque: distingue un pid reciclado del original. */\n\tstartId?: string;\n\tactive: boolean;\n\tts: string;\n}\n\n/**\n * Identificador del arranque de un proceso. `undefined` si no existe o no se\n * puede determinar — y en ese caso NO se mata nada.\n */\nexport function processStartId(pid: number): string | undefined {\n\tif (!Number.isInteger(pid) || pid <= 0) return undefined;\n\t// Linux: campo 22 de /proc/<pid>/stat es starttime en jiffies.\n\ttry {\n\t\tconst stat = readFileSync(`/proc/${pid}/stat`, \"utf8\");\n\t\tconst fields = stat.slice(stat.lastIndexOf(\")\") + 2).split(\" \");\n\t\tif (fields[19]) return `proc:${fields[19]}`;\n\t} catch {\n\t\t// macOS/BSD no tienen /proc: se usa ps.\n\t}\n\ttry {\n\t\tconst out = execFileSync(\"ps\", [\"-p\", String(pid), \"-o\", \"lstart=\"], {\n\t\t\tencoding: \"utf-8\",\n\t\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\t}).trim();\n\t\treturn out ? `ps:${out}` : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport class OrphanProcessJournal {\n\tprivate path: string;\n\n\t/** La ruta deriva de agentDir, NO de una variable de entorno: un subagente\n\t * que hereda el entorno no debe appendear en el journal de su padre. */\n\tconstructor(agentDir: string) {\n\t\tthis.path = join(agentDir, \"orphan-processes.jsonl\");\n\t}\n\n\tasync track(pid: number): Promise<void> {\n\t\tawait this.write({ pid, startId: processStartId(pid), active: true, ts: new Date().toISOString() });\n\t}\n\n\tasync untrack(pid: number): Promise<void> {\n\t\tawait this.write({ pid, active: false, ts: new Date().toISOString() });\n\t}\n\n\tprivate async write(record: OrphanRecord): Promise<void> {\n\t\ttry {\n\t\t\tawait mkdir(dirname(this.path), { recursive: true });\n\t\t\tawait appendFile(this.path, `${JSON.stringify(record)}\\n`, \"utf-8\");\n\t\t} catch {\n\t\t\t// El journal nunca debe romper el lanzamiento de un proceso.\n\t\t}\n\t}\n\n\t/** Último estado conocido de cada pid; solo los que quedaron activos. */\n\tasync pending(): Promise<Array<{ pid: number; startId: string }>> {\n\t\tlet raw: string;\n\t\ttry {\n\t\t\traw = await readFile(this.path, \"utf-8\");\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t\tconst latest = new Map<number, OrphanRecord>();\n\t\tfor (const line of raw.split(\"\\n\").filter(Boolean)) {\n\t\t\ttry {\n\t\t\t\tconst record = JSON.parse(line) as OrphanRecord;\n\t\t\t\tlatest.set(record.pid, record);\n\t\t\t} catch {\n\t\t\t\t// Un crash puede truncar el último append; el resto sigue siendo válido.\n\t\t\t}\n\t\t}\n\t\treturn [...latest.values()]\n\t\t\t.filter((r): r is OrphanRecord & { startId: string } => r.active && typeof r.startId === \"string\")\n\t\t\t.map((r) => ({ pid: r.pid, startId: r.startId }));\n\t}\n\n\t/**\n\t * Mata los huérfanos cuya identidad AÚN coincide y limpia el journal.\n\t * Devuelve los pids realmente matados.\n\t */\n\tasync reap(kill: (pid: number) => void): Promise<number[]> {\n\t\tconst killed: number[] = [];\n\t\tfor (const orphan of await this.pending()) {\n\t\t\t// Si el pid se recicló, el startId ya no coincide: no es nuestro.\n\t\t\tif (processStartId(orphan.pid) !== orphan.startId) continue;\n\t\t\ttry {\n\t\t\t\tkill(orphan.pid);\n\t\t\t\tkilled.push(orphan.pid);\n\t\t\t} catch {\n\t\t\t\t// ya muerto / sin permisos\n\t\t\t}\n\t\t}\n\t\tawait rm(this.path, { force: true }).catch(() => {});\n\t\treturn killed;\n\t}\n}\n"]}