@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/core/commits/split.d.ts

@@ -0,0 +1,45 @@
+/**
+ * D09 — Split-commit: agrupa los ficheros del índice POR TEMA (paquete/ámbito)
+ * y propone un commit separado por grupo, cada uno con su mensaje generado
+ * desde el diff REAL del grupo.
+ *
+ * El agrupado es determinista y local: no hace falta modelo para saber que
+ * `packages/uno/a.ts` y `packages/uno/b.ts` van juntos, que el lockfile
+ * huérfano pertenece al grupo de su manifiesto más cercano, y que la raíz es
+ * otro tema. El modelo solo escribe el mensaje de cada grupo, con las mismas
+ * garantías del pipeline agéntico (validación contra diff, sin inventar).
+ */
+import { generarMensajeAgentic, type PropuestaAgentic } from "./agentic.ts";
+/** Un commit propuesto: un tema, sus ficheros y su mensaje ya generado. */
+export interface CommitPropuesto {
+    tema: string;
+    ficheros: string[];
+    mensaje: string;
+    avisos: PropuestaAgentic["avisos"];
+    usedFallback: boolean;
+}
+/**
+ * El tema de una ruta: el paquete del monorepo (`packages/<x>/…`) o su primer
+ * segmento. La raíz (`package.json`, `README.md` en la cima) es el tema "raiz".
+ */
+export declare function temaDe(ruta: string): string;
+/**
+ * Agrupa rutas por tema. Los lockfiles HUÉRFANOS —un lockfile cuyo directorio
+ * no aporta ningún otro fichero al índice— se asignan al grupo de su
+ * manifiesto más cercano subiendo directorios; si no lo hay, a "raiz".
+ *
+ * Sin esto, `packages/x/package-lock.json` commiteado solo acabaría en un
+ * commit "chore" propio que no explica nada: el lockfile acompaña SIEMPRE al
+ * cambio de su paquete.
+ */
+export declare function agruparPorTema(rutas: string[]): Map<string, string[]>;
+/**
+ * Propone N commits separados desde el diff completo del índice.
+ *
+ * Cada grupo pasa por el MISMO generador agéntico que el commit único: la
+ * validación de «no inventes» se aplica por grupo, así que un mensaje que cite
+ * un fichero de OTRO grupo es un error estructurado, igual que citar uno que
+ * no existe.
+ */
+export declare function proponerCommitsSeparados(diff: string, deps: Parameters<typeof generarMensajeAgentic>[1]): Promise<CommitPropuesto[]>;
+//# sourceMappingURL=split.d.ts.map

package/dist/core/commits/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/core/commits/split.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG3F,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3C;AAKD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA0CrE;AAiBD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC7C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAC/C,OAAO,CAAC,eAAe,EAAE,CAAC,CA0B5B"}

package/dist/core/commits/split.js

@@ -0,0 +1,128 @@
+/**
+ * D09 — Split-commit: agrupa los ficheros del índice POR TEMA (paquete/ámbito)
+ * y propone un commit separado por grupo, cada uno con su mensaje generado
+ * desde el diff REAL del grupo.
+ *
+ * El agrupado es determinista y local: no hace falta modelo para saber que
+ * `packages/uno/a.ts` y `packages/uno/b.ts` van juntos, que el lockfile
+ * huérfano pertenece al grupo de su manifiesto más cercano, y que la raíz es
+ * otro tema. El modelo solo escribe el mensaje de cada grupo, con las mismas
+ * garantías del pipeline agéntico (validación contra diff, sin inventar).
+ */
+import { ErrorDeCommit, generarMensajeAgentic } from "./agentic.js";
+import { ordenarPorSustancia, trocearPorFichero } from "./diff.js";
+/**
+ * El tema de una ruta: el paquete del monorepo (`packages/<x>/…`) o su primer
+ * segmento. La raíz (`package.json`, `README.md` en la cima) es el tema "raiz".
+ */
+export function temaDe(ruta) {
+    const paquete = ruta.match(/^packages\/([^/]+)\//);
+    if (paquete)
+        return `packages/${paquete[1]}`;
+    const segmento = ruta.split("/")[0];
+    return ruta.includes("/") ? segmento : "raiz";
+}
+const ES_LOCKFILE = /(^|\/)(package-lock\.json|npm-shrinkwrap\.json|pnpm-lock\.yaml|yarn\.lock|bun\.lockb?|Cargo\.lock|go\.sum|composer\.lock|Gemfile\.lock|poetry\.lock|uv\.lock)$/;
+/**
+ * Agrupa rutas por tema. Los lockfiles HUÉRFANOS —un lockfile cuyo directorio
+ * no aporta ningún otro fichero al índice— se asignan al grupo de su
+ * manifiesto más cercano subiendo directorios; si no lo hay, a "raiz".
+ *
+ * Sin esto, `packages/x/package-lock.json` commiteado solo acabaría en un
+ * commit "chore" propio que no explica nada: el lockfile acompaña SIEMPRE al
+ * cambio de su paquete.
+ */
+export function agruparPorTema(rutas) {
+    const grupos = new Map();
+    for (const ruta of rutas) {
+        if (!ES_LOCKFILE.test(ruta)) {
+            const tema = temaDe(ruta);
+            const previo = grupos.get(tema) ?? [];
+            previo.push(ruta);
+            grupos.set(tema, previo);
+        }
+    }
+    for (const ruta of rutas) {
+        if (!ES_LOCKFILE.test(ruta))
+            continue;
+        // Del antecesor más profundo al más superficial: gana el manifiesto/hermano
+        // más cercano, y solo si no hay ninguno se va a "raiz".
+        const segmentos = ruta.split("/");
+        let asignado = false;
+        for (let n = segmentos.length - 1; n >= 1 && !asignado; n--) {
+            const antecesor = segmentos.slice(0, n).join("/");
+            if (grupos.has(antecesor)) {
+                grupos.get(antecesor)?.push(ruta);
+                asignado = true;
+                continue;
+            }
+            const hermano = rutas.find((otra) => otra !== ruta && !ES_LOCKFILE.test(otra) && otra.startsWith(`${antecesor}/`));
+            if (hermano !== undefined) {
+                const tema = temaDe(hermano);
+                const previo = grupos.get(tema) ?? [];
+                previo.push(ruta);
+                grupos.set(tema, previo);
+                asignado = true;
+            }
+        }
+        if (!asignado) {
+            const previo = grupos.get("raiz") ?? [];
+            previo.push(ruta);
+            grupos.set("raiz", previo);
+        }
+    }
+    for (const ficheros of grupos.values())
+        ficheros.sort();
+    return grupos;
+}
+/**
+ * Orden determinista de grupos: primero el de más sustancia total, empate
+ * alfabético. La raíz al final si empata: tocarla suele depender de los
+ * paquetes, nunca al revés.
+ */
+function ordenarGrupos(grupos) {
+    const sustanciaTotal = (trozos) => trozos.reduce((suma, t) => suma + t.sustancia, 0);
+    return [...grupos.entries()].sort(([temaA, trozosA], [temaB, trozosB]) => {
+        const diferencia = sustanciaTotal(trozosB) - sustanciaTotal(trozosA);
+        if (diferencia !== 0)
+            return diferencia;
+        if ((temaA === "raiz") !== (temaB === "raiz"))
+            return temaA === "raiz" ? 1 : -1;
+        return temaA.localeCompare(temaB);
+    });
+}
+/**
+ * Propone N commits separados desde el diff completo del índice.
+ *
+ * Cada grupo pasa por el MISMO generador agéntico que el commit único: la
+ * validación de «no inventes» se aplica por grupo, así que un mensaje que cite
+ * un fichero de OTRO grupo es un error estructurado, igual que citar uno que
+ * no existe.
+ */
+export async function proponerCommitsSeparados(diff, deps) {
+    const trozos = trocearPorFichero(diff);
+    if (trozos.length === 0) {
+        if (diff.trim() === "")
+            throw new ErrorDeCommit("diff-vacio", "El diff no contiene ningún fichero.");
+        throw new ErrorDeCommit("diff-ilegible", "El diff no contiene cabeceras 'diff --git' reconocibles.");
+    }
+    const porRuta = new Map(trozos.map((t) => [t.ruta, t]));
+    const gruposPorTema = new Map();
+    for (const [tema, rutas] of agruparPorTema([...porRuta.keys()])) {
+        gruposPorTema.set(tema, ordenarPorSustancia(rutas.map((ruta) => porRuta.get(ruta))));
+    }
+    const propuestas = [];
+    for (const [tema, trozosDelTema] of ordenarGrupos(gruposPorTema)) {
+        const diffDelTema = trozosDelTema.map((t) => t.diff).join("\n");
+        const generada = await generarMensajeAgentic(diffDelTema, deps);
+        propuestas.push({
+            tema,
+            ficheros: trozosDelTema.map((t) => t.ruta),
+            mensaje: generada.mensaje,
+            avisos: generada.avisos,
+            usedFallback: generada.usedFallback,
+        });
+    }
+    return propuestas;
+}
+//# sourceMappingURL=split.js.map

package/dist/core/commits/split.js.map

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

package/dist/core/compactacion/comandos.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Comandos de contexto (SLASH-01): la torre de compactación A04 expuesta como
+ * slash commands. Cada función es el handler del comando: ejecuta el MOTOR
+ * REAL (shake/pruneCacheAware/crearHandoff de este paquete, o AsidesBuffer de
+ * banco/asides.ts) y devuelve una respuesta textual en uno de tres estados:
+ * - "hecho": ejecutó el motor sobre el contexto.
+ * - "nada":  contexto válido pero nada que hacer (ya colapsado, vacío…).
+ * - "uso":   error de uso del comando (falta argumento requerido, etc.).
+ *
+ * Capa pura salvo JournalTree/AsidesBuffer en memoria: sin I/O ni TUI. La capa
+ * interactiva solo despacha y muestra `respuesta`.
+ */
+import type { AsidesBuffer } from "../banco/asides.ts";
+import { type HandoffResult, type OpcionesHandoff } from "./handoff.ts";
+import { type PruneConfig } from "./prune.ts";
+import { type ShakeConfig } from "./shake.ts";
+import type { Turno } from "./tipos.ts";
+export type EstadoComandoContexto = "hecho" | "nada" | "uso";
+export interface SalidaBase {
+    estado: EstadoComandoContexto;
+    /** Respuesta textual de lo que hizo (o de por qué no hizo nada). */
+    respuesta: string;
+}
+export interface SalidaShake extends SalidaBase {
+    turnos: Turno[];
+    colapsados: number;
+    tokensAhorrados: number;
+    anclasPreservadas: number;
+}
+export declare function comandoShake(turnos: readonly Turno[], config?: Partial<ShakeConfig>): SalidaShake;
+export interface SalidaHandoff extends SalidaBase {
+    /** Resultado del motor: journal nuevo con entrada handoff + contexto inicial. */
+    resultado?: HandoffResult;
+}
+/** /handoff — cierra la sesión actual: resumen mecánico completo + puntero al journal. */
+export declare function comandoHandoff(turnos: readonly Turno[], opciones?: OpcionesHandoff): SalidaHandoff;
+/**
+ * /fresh — sesión nueva conservando SOLO el resumen mínimo (objetivo +
+ * herramientas): sin la cola reciente del asistente, que pertenece a la
+ * sesión vieja. Mismo motor (crearHandoff), resumen deliberadamente más corto.
+ */
+export declare function comandoFresh(turnos: readonly Turno[], opciones?: OpcionesHandoff): SalidaHandoff;
+export interface SalidaDrop extends SalidaBase {
+    turnos: Turno[];
+    eliminados: number;
+    tokensAhorrados: number;
+}
+export declare function comandoDrop(turnos: readonly Turno[], arg: string | undefined, config?: Partial<PruneConfig>): SalidaDrop;
+export interface SalidaBtw extends SalidaBase {
+    pendientes: number;
+}
+export declare function comandoBtw(buffer: AsidesBuffer, nota: string | undefined): SalidaBtw;
+//# sourceMappingURL=comandos.d.ts.map

package/dist/core/compactacion/comandos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comandos.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/comandos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAsB,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAiB,KAAK,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAiB,KAAK,WAAW,EAAS,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAC7D,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC9C,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CA8BjG;AAMD,MAAM,WAAW,aAAc,SAAQ,UAAU;IAChD,iFAAiF;IACjF,SAAS,CAAC,EAAE,aAAa,CAAC;CAC1B;AAkBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,CAEtG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,GAAE,eAAoB,GAAG,aAAa,CAEpG;AAMD,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC7C,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACxB;AAKD,wBAAgB,WAAW,CAC1B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC3B,UAAU,CAiEZ;AAMD,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC5C,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAepF"}

package/dist/core/compactacion/comandos.js

@@ -0,0 +1,155 @@
+/**
+ * Comandos de contexto (SLASH-01): la torre de compactación A04 expuesta como
+ * slash commands. Cada función es el handler del comando: ejecuta el MOTOR
+ * REAL (shake/pruneCacheAware/crearHandoff de este paquete, o AsidesBuffer de
+ * banco/asides.ts) y devuelve una respuesta textual en uno de tres estados:
+ * - "hecho": ejecutó el motor sobre el contexto.
+ * - "nada":  contexto válido pero nada que hacer (ya colapsado, vacío…).
+ * - "uso":   error de uso del comando (falta argumento requerido, etc.).
+ *
+ * Capa pura salvo JournalTree/AsidesBuffer en memoria: sin I/O ni TUI. La capa
+ * interactiva solo despacha y muestra `respuesta`.
+ */
+import { crearHandoff, restaurarDeHandoff } from "./handoff.js";
+import { PRUNE_DEFECTO, pruneCacheAware } from "./prune.js";
+import { SHAKE_DEFECTO, shake } from "./shake.js";
+export function comandoShake(turnos, config) {
+    if (turnos.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: "Contexto vacío: no hay nada que colapsar.",
+            turnos: [],
+            colapsados: 0,
+            tokensAhorrados: 0,
+            anclasPreservadas: 0,
+        };
+    }
+    const r = shake(turnos, { ...SHAKE_DEFECTO, ...config });
+    if (r.colapsados.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: `Nada que colapsar: las anclas y la cola protegida (${SHAKE_DEFECTO.protegerUltimosTokens} tokens) ya cubren todo el contexto.`,
+            turnos: r.turnos,
+            colapsados: 0,
+            tokensAhorrados: 0,
+            anclasPreservadas: r.anclasPreservadas,
+        };
+    }
+    return {
+        estado: "hecho",
+        respuesta: `Colapsados ${r.colapsados.length} turnos antiguos (~${r.tokensAhorrados} tokens ahorrados); preservadas ${r.anclasPreservadas} anclas.`,
+        turnos: r.turnos,
+        colapsados: r.colapsados.length,
+        tokensAhorrados: r.tokensAhorrados,
+        anclasPreservadas: r.anclasPreservadas,
+    };
+}
+function cerrarEnResumen(turnos, verbo, opciones) {
+    if (turnos.length === 0) {
+        return {
+            estado: "nada",
+            respuesta: "No hay contexto que cerrar: la sesión no tiene turnos.",
+        };
+    }
+    const h = crearHandoff(turnos, opciones);
+    const idEntrada = restaurarDeHandoff(h.journal)?.idEntrada ?? "";
+    return {
+        estado: "hecho",
+        respuesta: `${verbo} ${h.info.turnosResumidos} turnos en un resumen mecánico (${h.info.herramientasUsadas.length} herramientas usadas). Journal nuevo "${idEntrada}" con puntero a la hoja "${h.info.hojaOrigen ?? ""}"; la sesión nueva abre solo con <handoff>.`,
+        resultado: h,
+    };
+}
+/** /handoff — cierra la sesión actual: resumen mecánico completo + puntero al journal. */
+export function comandoHandoff(turnos, opciones = {}) {
+    return cerrarEnResumen(turnos, "Sesión cerrada en handoff:", opciones);
+}
+/**
+ * /fresh — sesión nueva conservando SOLO el resumen mínimo (objetivo +
+ * herramientas): sin la cola reciente del asistente, que pertenece a la
+ * sesión vieja. Mismo motor (crearHandoff), resumen deliberadamente más corto.
+ */
+export function comandoFresh(turnos, opciones = {}) {
+    return cerrarEnResumen(turnos, "Sesión nueva lista:", { colaReciente: 0, ...opciones });
+}
+const USO_DROP = "Uso: /drop <n|tool-results> — elimina los últimos N turnos del contexto o poda los resultados antiguos de tools.";
+export function comandoDrop(turnos, arg, config) {
+    const a = arg?.trim();
+    if (!a) {
+        return { estado: "uso", respuesta: USO_DROP, turnos: [...turnos], eliminados: 0, tokensAhorrados: 0 };
+    }
+    if (a === "tool-results") {
+        if (turnos.length === 0) {
+            return {
+                estado: "nada",
+                respuesta: "Contexto vacío: no hay resultados de tools que podar.",
+                turnos: [],
+                eliminados: 0,
+                tokensAhorrados: 0,
+            };
+        }
+        // El slash poda explícitamente: se relaja la guardia de prompt-cache y
+        // el mínimo de ahorro (la decisión la toma el usuario, no la heurística).
+        const r = pruneCacheAware(turnos, {
+            ...PRUNE_DEFECTO,
+            sufijoCalienteTokens: Number.MAX_SAFE_INTEGER,
+            minimoAhorro: 1,
+            ...config,
+        });
+        if (r.podados === 0) {
+            return {
+                estado: "nada",
+                respuesta: "Nada que podar: no queda ningún resultado de tools con contenido.",
+                turnos: r.turnos,
+                eliminados: 0,
+                tokensAhorrados: 0,
+            };
+        }
+        return {
+            estado: "hecho",
+            respuesta: `Podados ${r.podados} resultados de tools (~${r.tokensAhorrados} tokens); quedan como placeholders con su emparejamiento toolCall intacto.`,
+            turnos: r.turnos,
+            eliminados: r.podados,
+            tokensAhorrados: r.tokensAhorrados,
+        };
+    }
+    const n = Number(a);
+    if (!Number.isInteger(n) || n <= 0) {
+        return { estado: "uso", respuesta: USO_DROP, turnos: [...turnos], eliminados: 0, tokensAhorrados: 0 };
+    }
+    const eliminados = Math.min(n, turnos.length);
+    const restantes = turnos.slice(0, turnos.length - eliminados);
+    if (eliminados === 0) {
+        return {
+            estado: "nada",
+            respuesta: "El contexto ya está vacío: no hay turnos que eliminar.",
+            turnos: restantes,
+            eliminados: 0,
+            tokensAhorrados: 0,
+        };
+    }
+    const aviso = restantes.length === 0 ? " Aviso: has eliminado TODO el contexto." : "";
+    return {
+        estado: "hecho",
+        respuesta: `Eliminados los últimos ${eliminados} turnos; quedan ${restantes.length}.${aviso}`,
+        turnos: restantes,
+        eliminados,
+        tokensAhorrados: 0,
+    };
+}
+export function comandoBtw(buffer, nota) {
+    const t = nota?.trim();
+    if (!t) {
+        return {
+            estado: "uso",
+            respuesta: "Uso: /btw <nota> — registra una nota lateral que se drena al final del turno sin interrumpir.",
+            pendientes: buffer.size,
+        };
+    }
+    buffer.push(t);
+    return {
+        estado: "hecho",
+        respuesta: `Nota lateral registrada (${buffer.size} pendiente${buffer.size === 1 ? "" : "s"}); se drenará al final del turno sin interrumpir ninguna tool.`,
+        pendientes: buffer.size,
+    };
+}
+//# sourceMappingURL=comandos.js.map

package/dist/core/compactacion/comandos.js.map

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

package/dist/core/compactacion/extension.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Extensión inline de comandos de contexto (SLASH-01).
+ *
+ * Expone la torre de compactación A04 como slash commands (/handoff, /shake,
+ * /fresh, /drop, /btw). Se registra como extensión inline por defecto desde
+ * `resource-loader.loadBuiltinExtensions` (bloque ya propiedad de Ada: no
+ * cuesta hunks contra el presupuesto de sync) y usa la API pública de
+ * extensiones, igual que `prompt-cache`.
+ *
+ * Contrato de cada comando:
+ * - El handler llama al MOTOR REAL vía ./comandos.ts y muestra `respuesta`
+ *   (tres estados: hecho / nada / uso).
+ * - /handoff y /fresh además persisten el journal del handoff bajo
+ *   `<agentDir>/handoff/` y arrancan una sesión nueva cuyo único contexto es
+ *   el resumen (`ctx.newSession` + `setup`).
+ * - /shake y /drop reescriben el contexto aplicando el motor y arrancan una
+ *   sesión cuyo historial es exactamente el resultado del motor.
+ * - /btw registra una nota lateral en el buffer de asides SIN interrumpir:
+ *   las notas viajan con la próxima operación de contexto (/handoff, /fresh,
+ *   /shake, /drop las siembran en la sesión nueva) y se listan con `/btw` sin
+ *   argumento.
+ */
+import type { ExtensionAPI } from "../extensions/types.ts";
+export interface ContextoExtensionOptions {
+    agentDir: string;
+}
+export declare function crearExtensionContexto(options: ContextoExtensionOptions): (pi: ExtensionAPI) => void;
+//# sourceMappingURL=extension.d.ts.map

package/dist/core/compactacion/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/core/compactacion/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AAcpF,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAgED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,IAC/D,IAAI,YAAY,KAAG,IAAI,CA+E/B"}

package/dist/core/compactacion/extension.js

@@ -0,0 +1,159 @@
+/**
+ * Extensión inline de comandos de contexto (SLASH-01).
+ *
+ * Expone la torre de compactación A04 como slash commands (/handoff, /shake,
+ * /fresh, /drop, /btw). Se registra como extensión inline por defecto desde
+ * `resource-loader.loadBuiltinExtensions` (bloque ya propiedad de Ada: no
+ * cuesta hunks contra el presupuesto de sync) y usa la API pública de
+ * extensiones, igual que `prompt-cache`.
+ *
+ * Contrato de cada comando:
+ * - El handler llama al MOTOR REAL vía ./comandos.ts y muestra `respuesta`
+ *   (tres estados: hecho / nada / uso).
+ * - /handoff y /fresh además persisten el journal del handoff bajo
+ *   `<agentDir>/handoff/` y arrancan una sesión nueva cuyo único contexto es
+ *   el resumen (`ctx.newSession` + `setup`).
+ * - /shake y /drop reescriben el contexto aplicando el motor y arrancan una
+ *   sesión cuyo historial es exactamente el resultado del motor.
+ * - /btw registra una nota lateral en el buffer de asides SIN interrumpir:
+ *   las notas viajan con la próxima operación de contexto (/handoff, /fresh,
+ *   /shake, /drop las siembran en la sesión nueva) y se listan con `/btw` sin
+ *   argumento.
+ */
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { AsidesBuffer } from "../banco/asides.js";
+import { comandoBtw, comandoDrop, comandoFresh, comandoHandoff, comandoShake, } from "./comandos.js";
+import { restaurarDeHandoff } from "./handoff.js";
+/** Buffer de notas laterales /btw, compartido por todas las sesiones del proceso. */
+const asidesPendientes = new AsidesBuffer();
+/** Turnos de la rama actual agrupados como la torre los espera (user abre turno). */
+function extraerTurnos(sessionManager) {
+    const turnos = [];
+    let actual;
+    for (const entry of sessionManager.getBranch()) {
+        if (entry.type !== "message")
+            continue;
+        const mensaje = entry.message;
+        if (mensaje.role === "user" || actual === undefined) {
+            actual = { id: entry.id, mensajes: [mensaje] };
+            turnos.push(actual);
+        }
+        else {
+            actual.mensajes.push(mensaje);
+        }
+    }
+    return turnos;
+}
+/** Siembra el historial resultado del motor (y las notas /btw pendientes) en una sesión. */
+async function sembrar(sessionManager, turnos, conAsides) {
+    for (const t of turnos) {
+        for (const m of t.mensajes)
+            sessionManager.appendMessage(m);
+    }
+    if (conAsides && !asidesPendientes.isEmpty()) {
+        const notas = asidesPendientes.drain();
+        const contenido = ["Notas laterales (/btw) pendientes de esta sesión:", ...notas.map((n) => `- ${n}`)].join("\n");
+        sessionManager.appendMessage({ role: "user", content: contenido, timestamp: Date.now() });
+    }
+}
+function notificar(ctx, salida) {
+    ctx.ui?.notify(salida.respuesta, salida.estado === "uso" ? "warning" : "info");
+}
+/**
+ * Arranca una sesión nueva sembrada con el contexto del motor; si se da
+ * `journalDir`, persiste antes el journal del handoff bajo ese directorio.
+ */
+async function reiniciarCon(ctx, salida, journalDir) {
+    const h = salida.resultado;
+    let rutaJournal;
+    if (journalDir) {
+        const idEntrada = restaurarDeHandoff(h.journal)?.idEntrada ?? "handoff";
+        mkdirSync(journalDir, { recursive: true });
+        rutaJournal = join(journalDir, `${idEntrada}.jsonl`);
+        h.journal.saveAtomic(rutaJournal);
+    }
+    await ctx.newSession({
+        setup: async (sm) => {
+            await sembrar(sm, h.sesionNueva, true);
+        },
+    });
+    notificar(ctx, {
+        estado: "hecho",
+        respuesta: rutaJournal ? `${salida.respuesta}\nJournal del handoff: ${rutaJournal}` : salida.respuesta,
+    });
+}
+export function crearExtensionContexto(options) {
+    return (pi) => {
+        const journalDir = join(options.agentDir, "handoff");
+        pi.registerCommand("handoff", {
+            description: "Cierra la sesión en un resumen mecánico y continúa en una sesión nueva (puntero al journal)",
+            handler: async (_args, ctx) => {
+                const salida = comandoHandoff(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho" || !salida.resultado) {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await reiniciarCon(ctx, salida, journalDir);
+            },
+        });
+        pi.registerCommand("fresh", {
+            description: "Arranca una sesión nueva conservando solo el resumen mínimo",
+            handler: async (_args, ctx) => {
+                const salida = comandoFresh(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho" || !salida.resultado) {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await reiniciarCon(ctx, salida);
+            },
+        });
+        pi.registerCommand("shake", {
+            description: "Colapsa tool calls/results antiguos en placeholders, preservando anclas",
+            handler: async (_args, ctx) => {
+                const salida = comandoShake(extraerTurnos(ctx.sessionManager));
+                if (salida.estado !== "hecho") {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await ctx.newSession({
+                    setup: async (sm) => {
+                        await sembrar(sm, salida.turnos, true);
+                    },
+                });
+                notificar(ctx, salida);
+            },
+        });
+        pi.registerCommand("drop", {
+            description: "Elimina los últimos N turnos o poda los resultados antiguos de tools",
+            handler: async (args, ctx) => {
+                const salida = comandoDrop(extraerTurnos(ctx.sessionManager), args.trim() || undefined);
+                if (salida.estado !== "hecho") {
+                    notificar(ctx, salida);
+                    return;
+                }
+                await ctx.newSession({
+                    setup: async (sm) => {
+                        await sembrar(sm, salida.turnos, true);
+                    },
+                });
+                notificar(ctx, salida);
+            },
+        });
+        pi.registerCommand("btw", {
+            description: "Registra una nota lateral que viaja con la próxima operación de contexto",
+            handler: async (args, ctx) => {
+                const nota = args.trim();
+                if (nota.length === 0 && !asidesPendientes.isEmpty()) {
+                    ctx.ui?.notify(`Notas /btw pendientes:\n${asidesPendientes
+                        .peek()
+                        .map((n) => `- ${n}`)
+                        .join("\n")}`, "info");
+                    return;
+                }
+                notificar(ctx, comandoBtw(asidesPendientes, nota || undefined));
+            },
+        });
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/core/compactacion/extension.js.map

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