@nac3/forge-cli 1.16.0 → 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/relay/in_flight_turn.d.ts

@@ -33,23 +33,56 @@ export interface InFlightTurn {
     started_at: string;
 }
 /**
- * Tope de edad. Un turno mas viejo que esto se considera muerto y deja de
- * anunciarse, aunque nadie lo haya limpiado.
+ * Cada cuanto el turno da senal de vida. Es el periodo del latido de actividad
+ * del servidor (`startRelayHeartbeat`), que corre SOLO entre el arranque y el
+ * cierre del turno.
  *
- * No es decoracion: `clearInFlightTurn` corre al final del handler, y un
- * proceso que muere a mitad de turno (o una excepcion por un camino que no
- * pasa por ahi) dejaria al telefono con una burbuja "pensando" para siempre.
- * Mentir sobre lo que el sistema esta haciendo es peor que no decir nada.
+ * Vive aca y no en server.ts a proposito: es la mitad de un par acoplado, y la
+ * otra mitad es `SILENCIO_MAX_MS`. El bug anterior nacio de tener dos numeros
+ * acoplados en dos archivos distintos sin nada que los ligara.
  */
-export declare const IN_FLIGHT_MAX_AGE_MS: number;
-export declare function setInFlightTurn(t: InFlightTurn): void;
+export declare const PULSO_DE_PROGRESO_MS: number;
+/**
+ * Tope de SILENCIO. Un turno que no da senal de vida por mas que esto se
+ * considera muerto y deja de anunciarse, aunque nadie lo haya limpiado.
+ *
+ * ANTES ERA UN TOPE DE EDAD, y eso estaba mal (Pablo, 13-oct-2026: "hay turnos
+ * de mas de 3 horas en un desarrollo"). La proteccion que se queria es contra
+ * un turno COLGADO -- un proceso que muere a mitad de camino, o una excepcion
+ * por un camino que no pasa por `clearInFlightTurn` -- porque mentir sobre lo
+ * que el sistema esta haciendo es peor que no decir nada. Pero "colgado" no es
+ * "viejo": es "sin progreso". Un tope de edad confunde las dos cosas y castiga
+ * justo al turno largo, que es el que mas necesita anunciarse.
+ *
+ * Medido: un turno de 29 minutos en ADIP-Kikan dejaba al telefono diciendo que
+ * no habia nada corriendo durante sus ultimos 19 minutos. Con turnos de 3 horas
+ * el anuncio serviria para el 5% del turno.
+ *
+ * Diez pulsos de margen: tolera que se pierdan nueve latidos seguidos antes de
+ * dar por muerto un turno que esta vivo.
+ */
+export declare const SILENCIO_MAX_MS: number;
+export declare function setInFlightTurn(t: InFlightTurn, now?: number): void;
+/**
+ * Senal de vida del turno en curso. La llama el latido de actividad del
+ * servidor, que corre solo mientras hay turno.
+ *
+ * No crea nada: si no hay turno registrado, no hace nada. Asi un latido
+ * rezagado no puede resucitar un turno ya cerrado.
+ */
+export declare function touchInFlightTurn(now?: number): void;
 /**
  * Limpia el turno en vuelo. Con `id`, SOLO si coincide: dos turnos encadenados
  * pueden cerrar fuera de orden, y un cierre tardio del viejo no tiene que
  * borrar el anuncio del que recien arranco.
  */
 export declare function clearInFlightTurn(id?: string): void;
-/** El turno en vuelo, o null si no hay o si ya es demasiado viejo. */
+/**
+ * El turno en vuelo, o null si no hay o si se quedo CALLADO.
+ *
+ * La edad del turno no entra en la decision: un turno de tres horas que sigue
+ * latiendo es un turno vivo y se anuncia. Lo que lo saca es el silencio.
+ */
 export declare function inFlightTurn(now?: number): InFlightTurn | null;
 /** Solo para tests. */
 export declare function _resetInFlightTurn(): void;

package/dist/relay/in_flight_turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in_flight_turn.d.ts","sourceRoot":"","sources":["../../src/relay/in_flight_turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAInD,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAInD;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAmB,GAAG,YAAY,GAAG,IAAI,CAQ1E;AAED,uBAAuB;AACvB,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"in_flight_turn.d.ts","sourceRoot":"","sources":["../../src/relay/in_flight_turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,QAA4B,CAAC;AASzD,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAQ/E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAmB,GAAG,YAAY,GAAG,IAAI,CAU1E;AAED,uBAAuB;AACvB,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/relay/in_flight_turn.js

@@ -27,20 +27,57 @@
  * ASCII puro.
  */
 /**
- * Tope de edad. Un turno mas viejo que esto se considera muerto y deja de
- * anunciarse, aunque nadie lo haya limpiado.
+ * Cada cuanto el turno da senal de vida. Es el periodo del latido de actividad
+ * del servidor (`startRelayHeartbeat`), que corre SOLO entre el arranque y el
+ * cierre del turno.
  *
- * No es decoracion: `clearInFlightTurn` corre al final del handler, y un
- * proceso que muere a mitad de turno (o una excepcion por un camino que no
- * pasa por ahi) dejaria al telefono con una burbuja "pensando" para siempre.
- * Mentir sobre lo que el sistema esta haciendo es peor que no decir nada.
+ * Vive aca y no en server.ts a proposito: es la mitad de un par acoplado, y la
+ * otra mitad es `SILENCIO_MAX_MS`. El bug anterior nacio de tener dos numeros
+ * acoplados en dos archivos distintos sin nada que los ligara.
  */
-export const IN_FLIGHT_MAX_AGE_MS = 10 * 60 * 1000;
+export const PULSO_DE_PROGRESO_MS = 60 * 1000;
+/**
+ * Tope de SILENCIO. Un turno que no da senal de vida por mas que esto se
+ * considera muerto y deja de anunciarse, aunque nadie lo haya limpiado.
+ *
+ * ANTES ERA UN TOPE DE EDAD, y eso estaba mal (Pablo, 13-oct-2026: "hay turnos
+ * de mas de 3 horas en un desarrollo"). La proteccion que se queria es contra
+ * un turno COLGADO -- un proceso que muere a mitad de camino, o una excepcion
+ * por un camino que no pasa por `clearInFlightTurn` -- porque mentir sobre lo
+ * que el sistema esta haciendo es peor que no decir nada. Pero "colgado" no es
+ * "viejo": es "sin progreso". Un tope de edad confunde las dos cosas y castiga
+ * justo al turno largo, que es el que mas necesita anunciarse.
+ *
+ * Medido: un turno de 29 minutos en ADIP-Kikan dejaba al telefono diciendo que
+ * no habia nada corriendo durante sus ultimos 19 minutos. Con turnos de 3 horas
+ * el anuncio serviria para el 5% del turno.
+ *
+ * Diez pulsos de margen: tolera que se pierdan nueve latidos seguidos antes de
+ * dar por muerto un turno que esta vivo.
+ */
+export const SILENCIO_MAX_MS = PULSO_DE_PROGRESO_MS * 10;
 let current = null;
-export function setInFlightTurn(t) {
+export function setInFlightTurn(t, now = Date.now()) {
     if (!t || !t.id)
         return;
-    current = { id: String(t.id), user: String(t.user || ''), started_at: String(t.started_at || new Date().toISOString()) };
+    current = {
+        id: String(t.id),
+        user: String(t.user || ''),
+        started_at: String(t.started_at || new Date(now).toISOString()),
+        visto: now,
+    };
+}
+/**
+ * Senal de vida del turno en curso. La llama el latido de actividad del
+ * servidor, que corre solo mientras hay turno.
+ *
+ * No crea nada: si no hay turno registrado, no hace nada. Asi un latido
+ * rezagado no puede resucitar un turno ya cerrado.
+ */
+export function touchInFlightTurn(now = Date.now()) {
+    if (!current)
+        return;
+    current.visto = now;
 }
 /**
  * Limpia el turno en vuelo. Con `id`, SOLO si coincide: dos turnos encadenados
@@ -54,16 +91,23 @@ export function clearInFlightTurn(id) {
         return;
     current = null;
 }
-/** El turno en vuelo, o null si no hay o si ya es demasiado viejo. */
+/**
+ * El turno en vuelo, o null si no hay o si se quedo CALLADO.
+ *
+ * La edad del turno no entra en la decision: un turno de tres horas que sigue
+ * latiendo es un turno vivo y se anuncia. Lo que lo saca es el silencio.
+ */
 export function inFlightTurn(now = Date.now()) {
     if (!current)
         return null;
-    const started = Date.parse(current.started_at);
-    if (Number.isFinite(started) && now - started > IN_FLIGHT_MAX_AGE_MS) {
+    /* Un reloj que salta hacia atras da silencio negativo: no vence. Preferible
+     * anunciar un turno de mas que descartar uno vivo por un salto de NTP. */
+    if (now - current.visto > SILENCIO_MAX_MS) {
         current = null;
         return null;
     }
-    return current;
+    const { id, user, started_at } = current;
+    return { id, user, started_at };
 }
 /** Solo para tests. */
 export function _resetInFlightTurn() {

package/dist/relay/in_flight_turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"in_flight_turn.js","sourceRoot":"","sources":["../../src/relay/in_flight_turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnD,IAAI,OAAO,GAAwB,IAAI,CAAC;AAExC,MAAM,UAAU,eAAe,CAAC,CAAe;IAC7C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO;IACxB,OAAO,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;AAC3H,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAW;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,EAAE,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO;IACpC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,GAAG,oBAAoB,EAAE,CAAC;QACrE,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,kBAAkB;IAChC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}
+{"version":3,"file":"in_flight_turn.js","sourceRoot":"","sources":["../../src/relay/in_flight_turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,GAAG,EAAE,CAAC;AAOzD,IAAI,OAAO,GAAoB,IAAI,CAAC;AAEpC,MAAM,UAAU,eAAe,CAAC,CAAe,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACvE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO;IACxB,OAAO,GAAG;QACR,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/D,KAAK,EAAE,GAAG;KACX,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IACxD,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAW;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,EAAE,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE;QAAE,OAAO;IACpC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B;8EAC0E;IAC1E,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG,eAAe,EAAE,CAAC;QAC1C,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,kBAAkB;IAChC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

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.0";
+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.0';
+export const VERSION = '1.17.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.16.0",
+  "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>",