@nac3/forge-cli 1.16.1 → 1.17.0

package/dist/chat/session_restore.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Reatar el panel a la sesion viva.
+ *
+ * POR QUE EXISTE (Pablo, 13-oct-2026): se le cerro por error la ventana de
+ * Chrome del panel con un turno de E7.5 corriendo. El turno NO se perdio -- el
+ * servidor es un proceso aparte y siguio hasta el final -- pero al reabrir el
+ * panel estaba VACIO, y la pestana Coding tampoco volvio.
+ *
+ * Las dos perdidas tienen la misma causa: el panel guardaba en el navegador
+ * solo `yf-lang` y `yf_coding_mode`, el transcript renderizado era estado en
+ * memoria de ESA ventana, y no habia ningun endpoint que lo reconstruyera
+ * (medido: ninguno de los 25 que el panel consume sirve historial). Y el
+ * lienzo Coding se abre cuando LLEGAN eventos de actividad, asi que una
+ * ventana nueva, que no esta enganchada al stream SSE del turno en vuelo, no
+ * tiene de donde enterarse de que hay algo corriendo.
+ *
+ * O sea que no era "el historial no persiste": era "la ventana nueva no se
+ * reata a la sesion". Un solo endpoint arregla las dos cosas, porque las dos
+ * necesitan el mismo dato: que dijo la conversacion, y si hay un turno en
+ * vuelo ahora.
+ *
+ * Lo que este modulo NO hace: inventar durabilidad. El transcript ya se
+ * persiste en `.yujin-forge/cache/chat/` desde la primera version (SPEC 5) y
+ * el turno en vuelo ya es un estado consultable (`in_flight_turn.ts`). Lo que
+ * faltaba era servirlos.
+ *
+ * ASCII-only.
+ */
+import type { ChatMessage } from './claude.js';
+import type { InFlightTurn } from '../relay/in_flight_turn.js';
+/**
+ * Cuantos mensajes se devuelven, desde el final.
+ *
+ * Por que un tope y no la sesion entera: una sesion de un dia entero son
+ * megabytes, y el panel ya recorta lo que PINTA. Devolver todo haria del
+ * arranque del panel la peticion mas cara del producto para mostrar lo mismo.
+ * 60 es el mismo numero que usa el espejo del telefono, por consistencia.
+ */
+export declare const TOPE_MENSAJES = 60;
+/**
+ * Tope de bytes del payload. El tope de mensajes no alcanza: un solo turno con
+ * un volcado de consola pegado adentro puede ser de megabytes (hoy mismo hubo
+ * uno de 11.870 caracteres). Se recorta desde el final -- lo mas nuevo es lo
+ * que el usuario quiere ver.
+ */
+export declare const TOPE_BYTES: number;
+export interface MensajeRestaurado {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface TurnoEnVuelo {
+    id: string;
+    user: string;
+    started_at: string;
+    /** Segundos que lleva corriendo, para que el panel pueda decir "3h en curso"
+     *  sin tener que calcularlo contra un reloj que puede no coincidir. */
+    elapsed_s: number;
+}
+export interface PayloadRestore {
+    ok: true;
+    /** Los mensajes, del mas viejo al mas nuevo, ya recortados. */
+    messages: MensajeRestaurado[];
+    /** True cuando se dejaron mensajes afuera por alguno de los dos topes. */
+    truncated: boolean;
+    /** Cuantos mensajes tiene la sesion en total. */
+    total: number;
+    /** El turno en vuelo, o null. Es lo que hace que el panel reabierto muestre
+     *  la burbuja pendiente Y vuelva a abrir el lienzo Coding. */
+    in_flight: TurnoEnVuelo | null;
+    project_root: string;
+    session_started_at: string | null;
+}
+/**
+ * Arma el payload. Pura: toda la entrada es argumento, y por eso se puede
+ * probar el recorte sin levantar un servidor.
+ *
+ * `redactar` entra como funcion y no se importa adentro para que el test pueda
+ * afirmar QUE SE LLAMO. El transcript en disco ya se escribe redactado, pero
+ * los mensajes en MEMORIA no pasaron por ahi todavia, y este endpoint los
+ * sirve: redactar aca no es ceremonia, es el unico lugar donde pasa.
+ */
+export declare function construirRestore(args: {
+    messages: readonly ChatMessage[];
+    inFlight: InFlightTurn | null;
+    projectRoot: string;
+    sessionStartedAt?: string | null;
+    now?: number;
+    redactar?: (s: string) => string;
+}): PayloadRestore;
+//# sourceMappingURL=session_restore.d.ts.map

package/dist/chat/session_restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_restore.d.ts","sourceRoot":"","sources":["../../src/chat/session_restore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAAa,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB;2EACuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,+DAA+D;IAC/D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd;kEAC8D;IAC9D,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAOD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC,GAAG,cAAc,CA8CjB"}

package/dist/chat/session_restore.js

@@ -0,0 +1,71 @@
+/**
+ * Cuantos mensajes se devuelven, desde el final.
+ *
+ * Por que un tope y no la sesion entera: una sesion de un dia entero son
+ * megabytes, y el panel ya recorta lo que PINTA. Devolver todo haria del
+ * arranque del panel la peticion mas cara del producto para mostrar lo mismo.
+ * 60 es el mismo numero que usa el espejo del telefono, por consistencia.
+ */
+export const TOPE_MENSAJES = 60;
+/**
+ * Tope de bytes del payload. El tope de mensajes no alcanza: un solo turno con
+ * un volcado de consola pegado adentro puede ser de megabytes (hoy mismo hubo
+ * uno de 11.870 caracteres). Se recorta desde el final -- lo mas nuevo es lo
+ * que el usuario quiere ver.
+ */
+export const TOPE_BYTES = 512 * 1024;
+/** Cuantos bytes ocupa en el payload (UTF-8, mas el envoltorio JSON). */
+function pesa(m) {
+    return Buffer.byteLength(m.content, 'utf8') + Buffer.byteLength(m.role, 'utf8') + 24;
+}
+/**
+ * Arma el payload. Pura: toda la entrada es argumento, y por eso se puede
+ * probar el recorte sin levantar un servidor.
+ *
+ * `redactar` entra como funcion y no se importa adentro para que el test pueda
+ * afirmar QUE SE LLAMO. El transcript en disco ya se escribe redactado, pero
+ * los mensajes en MEMORIA no pasaron por ahi todavia, y este endpoint los
+ * sirve: redactar aca no es ceremonia, es el unico lugar donde pasa.
+ */
+export function construirRestore(args) {
+    const { messages, inFlight, projectRoot } = args;
+    const now = args.now ?? Date.now();
+    const redactar = args.redactar ?? ((s) => s);
+    /* Solo lo que el panel pinta como conversacion. Un mensaje sin contenido no
+     * aporta una burbuja: aporta una vacia. */
+    const utiles = messages.filter((m) => (m.role === 'user' || m.role === 'assistant') && typeof m.content === 'string' && m.content !== '');
+    const porTope = utiles.slice(-TOPE_MENSAJES);
+    /* El recorte por bytes va desde el final hacia atras. */
+    const elegidos = [];
+    let bytes = 0;
+    for (let i = porTope.length - 1; i >= 0; i--) {
+        const m = porTope[i];
+        const item = { role: m.role, content: redactar(m.content) };
+        const b = pesa(item);
+        if (bytes + b > TOPE_BYTES && elegidos.length > 0)
+            break;
+        elegidos.unshift(item);
+        bytes += b;
+    }
+    let enVuelo = null;
+    if (inFlight && inFlight.id) {
+        const desde = Date.parse(inFlight.started_at);
+        const elapsed = Number.isFinite(desde) ? Math.max(0, Math.round((now - desde) / 1000)) : 0;
+        enVuelo = {
+            id: inFlight.id,
+            user: redactar(inFlight.user),
+            started_at: inFlight.started_at,
+            elapsed_s: elapsed,
+        };
+    }
+    return {
+        ok: true,
+        messages: elegidos,
+        truncated: elegidos.length < utiles.length,
+        total: utiles.length,
+        in_flight: enVuelo,
+        project_root: projectRoot,
+        session_started_at: args.sessionStartedAt ?? null,
+    };
+}
+//# sourceMappingURL=session_restore.js.map

package/dist/chat/session_restore.js.map

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

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export declare const VERSION = "1.16.1";
+export declare const VERSION = "1.17.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export const VERSION = '1.16.1';
+export const VERSION = '1.17.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",