@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/broker/broker.d.ts

@@ -0,0 +1,54 @@
+import { ManagedTimers } from "../higiene/managed-timers.ts";
+import type { DaemonHandle, PsEntry, ReapResult } from "./types.ts";
+/** Por defecto, un daemon sin latido más de 60 s se considera caducado. */
+export declare const DEFAULT_HEARTBEAT_TTL_MS = 60000;
+export declare class Broker {
+    private readonly daemons;
+    private readonly ttlMs;
+    private readonly timers;
+    /** Inyectable para tests: decide si un pid vive. Por defecto usa kill(0). */
+    private readonly isAlive;
+    /** Inyectable para tests: startId. Por defecto lee /proc o ps. */
+    private readonly resolveStartId;
+    constructor(opts?: {
+        heartbeatTtlMs?: number;
+        isAlive?: (pid: number) => boolean;
+        resolveStartId?: (pid: number) => string | undefined;
+    });
+    /** Registra o re-registra un daemon para el proyecto. Devuelve el handle. */
+    register(projectRoot: string, pid?: number): DaemonHandle;
+    /** Refresca el latido de un proyecto. false = no existía. */
+    heartbeat(projectRoot: string): boolean;
+    /** Devuelve el handle crudo o undefined. */
+    get(projectRoot: string): DaemonHandle | undefined;
+    /** ¿Cuántos daemons hay registrados? */
+    get size(): number;
+    /** Lista inspeccionable para `ada ps` — pid, proyecto, uptime, estado. */
+    list(): PsEntry[];
+    /** Quita el registro del proyecto, si existe. true = había algo. */
+    unregister(projectRoot: string): boolean;
+    /**
+     * Mata un huérfano por proyecto: verifica identidad antes de señal.
+     * Devuelve narrativa de lo hecho.
+     */
+    killOrphan(projectRoot: string): {
+        killed: boolean;
+        narrativa: string;
+    };
+    /**
+     * Barre todos los huérfanos (pid muerto) y devuelve narrativa agregada.
+     * Los caducados NO se borran automáticamente: requieren `killOrphan` explícito
+     * o re-registro — borrar por timeout silencioso es perder trabajo a medias.
+     */
+    reapOrphans(): ReapResult;
+    private estadoPara;
+    /** Solo para tests / inspección: vacía todo. */
+    clear(): void;
+    /** Higiene B06: acceso al pool de timers para tests/inspección. */
+    getTimers(): ManagedTimers;
+    /** Programa un callback vía ManagedTimers (unref, disposeAll lo limpia). */
+    scheduleReap(callback: () => void, delayMs: number): ReturnType<typeof setTimeout>;
+    /** Limpia todos los timers pendientes (p. ej. al cerrar proyecto). */
+    disposeTimers(): void;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/core/broker/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/core/broker/broker.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAgB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElF,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,QAAS,CAAC;AA0C/C,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;gBAEzD,IAAI,CAAC,EAAE;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QACnC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;KACrD;IAMD,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY;IAqBzD,6DAA6D;IAC7D,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQvC,4CAA4C;IAC5C,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKlD,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0EAA0E;IAC1E,IAAI,IAAI,OAAO,EAAE;IA4BjB,oEAAoE;IACpE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKxC;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAevE;;;;OAIG;IACH,WAAW,IAAI,UAAU;IAezB,OAAO,CAAC,UAAU;IAMlB,gDAAgD;IAChD,KAAK,IAAI,IAAI;IAIb,mEAAmE;IACnE,SAAS,IAAI,aAAa;IAI1B,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC;IAIlF,sEAAsE;IACtE,aAAa,IAAI,IAAI;CAGrB"}

package/dist/core/broker/broker.js

@@ -0,0 +1,216 @@
+/**
+ * Broker de daemons por proyecto — mapea projectRoot -> daemon handle.
+ *
+ * Por qué existe: cada proyecto necesita a lo sumo un daemon vivo (LSP mux,
+ * watcher, etc). Sin broker, dos `ada` en el mismo proyecto arrancan dos y
+ * pelean por puertos / ficheros. Con broker, el segundo reutiliza el primero.
+ *
+ * Diseño ponytail: un Map en memoria + heartbeat explícito + verificación de
+ * pid por startId. Nada de sockets, locks de fichero ni de redis. El `ps`
+ * inspecciona ESE Map; la recolección narra lo que quita. Si hace falta
+ * persistir entre procesos, se añade un journal JSONL encima —pero el contrato
+ * de `ps` y de `reap` no cambia, así que LSP puede avanzar en modo
+ * file-level writethrough sin broker residente y luego integrarse sin reescribir
+ * tests.
+ */
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { ManagedTimers } from "../higiene/managed-timers.js";
+/** Por defecto, un daemon sin latido más de 60 s se considera caducado. */
+export const DEFAULT_HEARTBEAT_TTL_MS = 60_000;
+/** Identidad de arranque del proceso, para no matar un pid reciclado. */
+function startIdForPid(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return undefined;
+    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 sin /proc
+    }
+    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;
+    }
+}
+function pidVivo(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        const err = e;
+        // EPERM = existe pero no tenemos permiso; ESRCH = no existe
+        if (err.code === "EPERM")
+            return true;
+        return false;
+    }
+}
+function normalizaRoot(root) {
+    const trimmed = root.trim();
+    if (!trimmed)
+        throw new Error("projectRoot vacío");
+    return resolve(trimmed);
+}
+export class Broker {
+    daemons = new Map();
+    ttlMs;
+    timers = new ManagedTimers();
+    /** Inyectable para tests: decide si un pid vive. Por defecto usa kill(0). */
+    isAlive;
+    /** Inyectable para tests: startId. Por defecto lee /proc o ps. */
+    resolveStartId;
+    constructor(opts) {
+        this.ttlMs = opts?.heartbeatTtlMs ?? DEFAULT_HEARTBEAT_TTL_MS;
+        this.isAlive = opts?.isAlive ?? pidVivo;
+        this.resolveStartId = opts?.resolveStartId ?? startIdForPid;
+    }
+    /** Registra o re-registra un daemon para el proyecto. Devuelve el handle. */
+    register(projectRoot, pid) {
+        const root = normalizaRoot(projectRoot);
+        const resolvedPid = pid ?? process.pid;
+        const now = Date.now();
+        const existing = this.daemons.get(root);
+        // Re-registro: si el pid es el mismo, se conserva startedAt y se refresca latido.
+        if (existing && existing.pid === resolvedPid) {
+            existing.lastHeartbeat = now;
+            return existing;
+        }
+        const handle = {
+            projectRoot: root,
+            pid: resolvedPid,
+            startedAt: now,
+            lastHeartbeat: now,
+            startId: this.resolveStartId(resolvedPid),
+        };
+        this.daemons.set(root, handle);
+        return handle;
+    }
+    /** Refresca el latido de un proyecto. false = no existía. */
+    heartbeat(projectRoot) {
+        const root = normalizaRoot(projectRoot);
+        const handle = this.daemons.get(root);
+        if (!handle)
+            return false;
+        handle.lastHeartbeat = Date.now();
+        return true;
+    }
+    /** Devuelve el handle crudo o undefined. */
+    get(projectRoot) {
+        const root = normalizaRoot(projectRoot);
+        return this.daemons.get(root);
+    }
+    /** ¿Cuántos daemons hay registrados? */
+    get size() {
+        return this.daemons.size;
+    }
+    /** Lista inspeccionable para `ada ps` — pid, proyecto, uptime, estado. */
+    list() {
+        const now = Date.now();
+        const out = [];
+        for (const handle of this.daemons.values()) {
+            const uptimeMs = now - handle.startedAt;
+            const idleMs = now - handle.lastHeartbeat;
+            let estado;
+            if (!this.isAlive(handle.pid)) {
+                estado = "huerfano";
+            }
+            else if (idleMs > this.ttlMs) {
+                estado = "caducado";
+            }
+            else {
+                estado = "activo";
+            }
+            out.push({
+                projectRoot: handle.projectRoot,
+                pid: handle.pid,
+                startedAt: handle.startedAt,
+                uptimeMs,
+                idleMs,
+                estado,
+            });
+        }
+        // Orden estable por projectRoot para que `ps` no baile.
+        out.sort((a, b) => a.projectRoot.localeCompare(b.projectRoot));
+        return out;
+    }
+    /** Quita el registro del proyecto, si existe. true = había algo. */
+    unregister(projectRoot) {
+        const root = normalizaRoot(projectRoot);
+        return this.daemons.delete(root);
+    }
+    /**
+     * Mata un huérfano por proyecto: verifica identidad antes de señal.
+     * Devuelve narrativa de lo hecho.
+     */
+    killOrphan(projectRoot) {
+        const root = normalizaRoot(projectRoot);
+        const handle = this.daemons.get(root);
+        if (!handle)
+            return { killed: false, narrativa: `no hay daemon para ${root}` };
+        if (this.isAlive(handle.pid)) {
+            return { killed: false, narrativa: `daemon ${root} (pid ${handle.pid}) sigue vivo — no se toca` };
+        }
+        this.daemons.delete(root);
+        const idle = Date.now() - handle.lastHeartbeat;
+        return {
+            killed: true,
+            narrativa: `huérfano recolectado: ${root} (pid ${handle.pid}, ${Math.round(idle / 1000)}s sin latido, estado ${this.estadoPara(handle)})`,
+        };
+    }
+    /**
+     * Barre todos los huérfanos (pid muerto) y devuelve narrativa agregada.
+     * Los caducados NO se borran automáticamente: requieren `killOrphan` explícito
+     * o re-registro — borrar por timeout silencioso es perder trabajo a medias.
+     */
+    reapOrphans() {
+        const entries = this.list();
+        const toReap = entries.filter((e) => e.estado === "huerfano");
+        const detalle = [];
+        const reaped = [];
+        for (const entry of toReap) {
+            this.daemons.delete(entry.projectRoot);
+            reaped.push(entry);
+            const linea = `huérfano recolectado: ${entry.projectRoot} (pid ${entry.pid}, ${Math.round(entry.idleMs / 1000)}s sin latido)`;
+            detalle.push(linea);
+        }
+        const narrativa = reaped.length === 0 ? "no hay huérfanos que recolectar" : detalle.join("\n");
+        return { reaped, narrativa, detalle };
+    }
+    estadoPara(handle) {
+        if (!this.isAlive(handle.pid))
+            return "huerfano";
+        if (Date.now() - handle.lastHeartbeat > this.ttlMs)
+            return "caducado";
+        return "activo";
+    }
+    /** Solo para tests / inspección: vacía todo. */
+    clear() {
+        this.daemons.clear();
+    }
+    /** Higiene B06: acceso al pool de timers para tests/inspección. */
+    getTimers() {
+        return this.timers;
+    }
+    /** Programa un callback vía ManagedTimers (unref, disposeAll lo limpia). */
+    scheduleReap(callback, delayMs) {
+        return this.timers.registerTimeout(callback, delayMs);
+    }
+    /** Limpia todos los timers pendientes (p. ej. al cerrar proyecto). */
+    disposeTimers() {
+        this.timers.disposeAll();
+    }
+}
+//# sourceMappingURL=broker.js.map

package/dist/core/broker/broker.js.map

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

package/dist/core/broker/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Barrel del broker por proyecto.
+ *
+ * API pública:
+ *   getBroker(projectRoot?) -> Broker | DaemonHandle | undefined
+ *   getBroker()             -> singleton Broker del proceso
+ *   getBroker(root)         -> handle del proyecto (o undefined si no existe)
+ *   createBroker(opts)      -> broker aislado (para tests / LSP sin singleton)
+ */
+import { Broker } from "./broker.ts";
+import type { DaemonHandle } from "./types.ts";
+export { Broker, DEFAULT_HEARTBEAT_TTL_MS } from "./broker.ts";
+export { formatPsHuman, formatPsJson, runPs } from "./ps.ts";
+export type { DaemonHandle, EstadoDaemon, PsEntry, ReapResult } from "./types.ts";
+/** Crea un broker aislado (no singleton). Útil para tests. */
+export declare function createBroker(opts?: ConstructorParameters<typeof Broker>[0]): Broker;
+/** Resetea el singleton (solo tests). */
+export declare function resetBrokerForTests(): void;
+export declare function getBroker(): Broker;
+export declare function getBroker(projectRoot: string): DaemonHandle | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/broker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/broker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASlF,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAEnF;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAGD,wBAAgB,SAAS,IAAI,MAAM,CAAC;AACpC,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC"}

package/dist/core/broker/index.js

@@ -0,0 +1,33 @@
+/**
+ * Barrel del broker por proyecto.
+ *
+ * API pública:
+ *   getBroker(projectRoot?) -> Broker | DaemonHandle | undefined
+ *   getBroker()             -> singleton Broker del proceso
+ *   getBroker(root)         -> handle del proyecto (o undefined si no existe)
+ *   createBroker(opts)      -> broker aislado (para tests / LSP sin singleton)
+ */
+import { Broker } from "./broker.js";
+export { Broker, DEFAULT_HEARTBEAT_TTL_MS } from "./broker.js";
+export { formatPsHuman, formatPsJson, runPs } from "./ps.js";
+let singleton;
+function getSingleton() {
+    if (!singleton)
+        singleton = new Broker();
+    return singleton;
+}
+/** Crea un broker aislado (no singleton). Útil para tests. */
+export function createBroker(opts) {
+    return new Broker(opts);
+}
+/** Resetea el singleton (solo tests). */
+export function resetBrokerForTests() {
+    singleton = undefined;
+}
+export function getBroker(projectRoot) {
+    const broker = getSingleton();
+    if (projectRoot === undefined)
+        return broker;
+    return broker.get(projectRoot);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/broker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/broker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAG7D,IAAI,SAA6B,CAAC;AAElC,SAAS,YAAY;IACpB,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,IAAI,MAAM,EAAE,CAAC;IACzC,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,IAA8C;IAC1E,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,mBAAmB;IAClC,SAAS,GAAG,SAAS,CAAC;AACvB,CAAC;AAKD,MAAM,UAAU,SAAS,CAAC,WAAoB;IAC7C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAChC,CAAC"}

package/dist/core/broker/ps.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Formateo inspeccionable para `ada ps`.
+ *
+ * Dos salidas: humana (tabla alineada para terminal) y JSON (para scripts y
+ * tests). La humana es la que narra huérfanos; la JSON es la que LSP mux
+ * consumirá después sin parsear texto.
+ */
+import type { Broker } from "./broker.ts";
+import type { PsEntry } from "./types.ts";
+export declare function formatPsHuman(entries: readonly PsEntry[]): string;
+export declare function formatPsJson(entries: readonly PsEntry[]): string;
+export interface RunPsOptions {
+    json?: boolean;
+}
+/**
+ * Ejecuta `ps` contra un broker y devuelve el texto para imprimir.
+ * No hace console.log: el caller decide dónde va.
+ */
+export declare function runPs(broker: Broker, opts?: RunPsOptions): string;
+//# sourceMappingURL=ps.d.ts.map

package/dist/core/broker/ps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps.d.ts","sourceRoot":"","sources":["../../../src/core/broker/ps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAc1C,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAWjE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAahE;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAIjE"}

package/dist/core/broker/ps.js

@@ -0,0 +1,55 @@
+/**
+ * Formateo inspeccionable para `ada ps`.
+ *
+ * Dos salidas: humana (tabla alineada para terminal) y JSON (para scripts y
+ * tests). La humana es la que narra huérfanos; la JSON es la que LSP mux
+ * consumirá después sin parsear texto.
+ */
+function formatUptime(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    const remS = s % 60;
+    if (m < 60)
+        return `${m}m ${remS}s`;
+    const h = Math.floor(m / 60);
+    const remM = m % 60;
+    return `${h}h ${remM}m`;
+}
+export function formatPsHuman(entries) {
+    if (entries.length === 0)
+        return "no hay daemons activos";
+    const header = `${"PID".padEnd(8)}  ${"ESTADO".padEnd(10)}  ${"UPTIME".padEnd(10)}  PROYECTO`;
+    const lines = [header, "-".repeat(header.length)];
+    for (const e of entries) {
+        const pid = String(e.pid).padEnd(8);
+        const estado = e.estado.padEnd(10);
+        const uptime = formatUptime(e.uptimeMs).padEnd(10);
+        lines.push(`${pid}  ${estado}  ${uptime}  ${e.projectRoot}`);
+    }
+    return lines.join("\n");
+}
+export function formatPsJson(entries) {
+    return JSON.stringify(entries.map((e) => ({
+        pid: e.pid,
+        projectRoot: e.projectRoot,
+        uptimeMs: e.uptimeMs,
+        idleMs: e.idleMs,
+        estado: e.estado,
+        startedAt: new Date(e.startedAt).toISOString(),
+    })), null, 2);
+}
+/**
+ * Ejecuta `ps` contra un broker y devuelve el texto para imprimir.
+ * No hace console.log: el caller decide dónde va.
+ */
+export function runPs(broker, opts) {
+    const entries = broker.list();
+    if (opts?.json)
+        return formatPsJson(entries);
+    return formatPsHuman(entries);
+}
+//# sourceMappingURL=ps.js.map

package/dist/core/broker/ps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps.js","sourceRoot":"","sources":["../../../src/core/broker/ps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,SAAS,YAAY,CAAC,EAAU;IAC/B,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IACpB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IACpB,OAAO,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA2B;IACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IAC1D,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC;IAC9F,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAA2B;IACvD,OAAO,IAAI,CAAC,SAAS,CACpB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;KAC9C,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACD,CAAC;AACH,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,IAAmB;IACxD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,EAAE,IAAI;QAAE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/broker/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tipos del broker de daemons por proyecto.
+ *
+ * Tres estados —no dos, no cuatro— porque son los que de verdad aparecen en
+ * producción y los que `ada ps` tiene que enseñar sin mentir:
+ *
+ *   activo   = el proceso vive y el latido llegó a tiempo. Todo bien.
+ *   caducado = el proceso puede vivir, pero hace demasiado que no late.
+ *              No se mata: puede ser una pausa larga de GC o un SIGSTOP.
+ *   huerfano = el pid ya no existe (o nevera reciclada verificada por startId).
+ *              Este sí se recoge.
+ *
+ * Ambos halves cubiertos: el half de registro (activo/caducado) y el half de
+ * recolección (huerfano) pasan por la misma estructura, sin capacidad
+ * desenchufada — todo lo que se registra es inspeccionable por `ps` y todo lo
+ * huérfano es narrable al recolectar.
+ */
+export type EstadoDaemon = "activo" | "caducado" | "huerfano";
+export interface DaemonHandle {
+    readonly projectRoot: string;
+    readonly pid: number;
+    readonly startedAt: number;
+    lastHeartbeat: number;
+    /** Identidad de arranque para no matar un pid reciclado. */
+    readonly startId?: string;
+}
+export interface PsEntry {
+    readonly projectRoot: string;
+    readonly pid: number;
+    readonly startedAt: number;
+    /** ms desde startedAt hasta ahora */
+    readonly uptimeMs: number;
+    /** ms desde lastHeartbeat hasta ahora */
+    readonly idleMs: number;
+    readonly estado: EstadoDaemon;
+}
+export interface ReapResult {
+    /** Entradas que se quitaron del broker */
+    readonly reaped: readonly PsEntry[];
+    /** Narrativa humana, una línea por huérfano recolectado. Vacía si no hubo. */
+    readonly narrativa: string;
+    /** Detalle estructurado para tests / telemetría */
+    readonly detalle: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/broker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/broker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}

package/dist/core/broker/types.js

@@ -0,0 +1,19 @@
+/**
+ * Tipos del broker de daemons por proyecto.
+ *
+ * Tres estados —no dos, no cuatro— porque son los que de verdad aparecen en
+ * producción y los que `ada ps` tiene que enseñar sin mentir:
+ *
+ *   activo   = el proceso vive y el latido llegó a tiempo. Todo bien.
+ *   caducado = el proceso puede vivir, pero hace demasiado que no late.
+ *              No se mata: puede ser una pausa larga de GC o un SIGSTOP.
+ *   huerfano = el pid ya no existe (o nevera reciclada verificada por startId).
+ *              Este sí se recoge.
+ *
+ * Ambos halves cubiertos: el half de registro (activo/caducado) y el half de
+ * recolección (huerfano) pasan por la misma estructura, sin capacidad
+ * desenchufada — todo lo que se registra es inspeccionable por `ps` y todo lo
+ * huérfano es narrable al recolectar.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/broker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/broker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/core/browser/cdp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Cliente mínimo del Chrome DevTools Protocol.
+ *
+ * Sin Playwright ni Puppeteer a propósito. Playwright son cientos de megas y
+ * se descarga sus propios navegadores; el mismo coste de cadena de suministro
+ * que ya rechazamos dos veces en este repo. CDP es un WebSocket con JSON, y
+ * Node trae `WebSocket` nativo desde la 22.
+ *
+ * Solo cubre lo que necesitan las tools: conectar, pedir y escuchar. No
+ * pretende ser una librería.
+ */
+export interface OpcionesCdp {
+    /** Tope por petición. Una página colgada no puede colgar el turno. */
+    timeoutMs?: number;
+    /** Inyectable para poder probar el enmarcado sin un navegador. */
+    crearSocket?: (url: string) => WebSocketLike;
+}
+/** Lo mínimo que usamos de un WebSocket, para poder falsearlo en pruebas. */
+export interface WebSocketLike {
+    send(datos: string): void;
+    close(): void;
+    addEventListener(tipo: "message" | "open" | "close" | "error", handler: (evento: unknown) => void): void;
+}
+export declare class ClienteCdp {
+    private socket;
+    private siguienteId;
+    private pendientes;
+    private oyentes;
+    private cerrado;
+    private timeoutMs;
+    private constructor();
+    static conectar(url: string, opciones?: OpcionesCdp): Promise<ClienteCdp>;
+    /** Para pruebas: cliente sobre un socket ya "abierto". */
+    static sobreSocket(socket: WebSocketLike, timeoutMs?: number): ClienteCdp;
+    private recibir;
+    private alCerrar;
+    enviar<T = unknown>(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<T>;
+    escuchar(method: string, handler: (params: unknown) => void): () => void;
+    cerrar(): void;
+}
+//# sourceMappingURL=cdp.d.ts.map

package/dist/core/browser/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../../src/core/browser/cdp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,WAAW;IAC3B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;CAC7C;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACzG;AAID,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;WAUM,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBnF,0DAA0D;IAC1D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,SAAsB,GAAG,UAAU;IAItF,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,QAAQ;IAaV,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAc/G,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxE,MAAM,IAAI,IAAI;CAQd"}