@jmanuelcorral/openteam 0.2.1 → 0.9.0

package/dist/orchestrator/worktreeDispatch.d.ts

@@ -1,25 +1,25 @@
 import type { WorktreeBinding } from "../storage/graph/worktreeRegistry";
 /**
- * Seam de despacho al worktree del run (GE-073, D-W3).
+ * Dispatch seam to the run's worktree (GE-073, D-W3).
  *
- * Decide, para un efecto del runtime de Graph, el `directory` con el que se crea
- * la sub-sesión hija (`query.directory`) y verifica la correlación del contrato
- * `PluginInput.directory`/`worktree` (GE-005). Es lógica pura y determinista:
- * sin I/O, SDK, reloj ni estado global; el probe de salud del worktree y la
- * consulta al registro (GE-072) los hace el llamante y entrega sus resultados
- * como datos.
+ * Decides, for a Graph runtime effect, the `directory` used to create the
+ * child sub-session (`query.directory`) and verifies the correlation of the
+ * `PluginInput.directory`/`worktree` contract (GE-005). It is pure and
+ * deterministic logic: no I/O, SDK, clock, or global state; the worktree
+ * health probe and the registry lookup (GE-072) are done by the caller, which
+ * provides their results as data.
  *
- * Invariante de UX-neutralidad: con el aislamiento **desactivado**
- * (`graph.worktrees.enabled` = `false`, el default) el directorio resuelto es
- * exactamente el del workspace actual, de modo que el despacho es idéntico al
- * de hoy. Con el aislamiento activo se exige un worktree sano vinculado al run
- * y se cierra en falso (`WorktreeDispatchError`) si falta la vinculación, el
- * directorio desapareció (`missing`) o está sucio (`unclean`). Ninguna ruta viva
- * llama todavía a este seam; lo consumirá la integración del executor.
+ * UX-neutrality invariant: with isolation **disabled**
+ * (`graph.worktrees.enabled` = `false`, the default), the resolved directory is
+ * exactly the current workspace, so dispatch is identical to today's behavior.
+ * With isolation enabled, a healthy worktree bound to the run is required, and
+ * it fails closed (`WorktreeDispatchError`) if the binding is missing, the
+ * directory disappeared (`missing`), or it is dirty (`unclean`). No live path
+ * calls this seam yet; the executor integration will consume it.
  */
-/** Salud observada del worktree de un run (resultado del probe del llamante). */
+/** Observed health of a run's worktree (result of the caller's probe). */
 export type WorktreeHealth = "ready" | "missing" | "unclean";
-/** Estado del despacho respecto al aislamiento por worktree del run. */
+/** Dispatch state with respect to the run's per-worktree isolation. */
 export type WorktreeDispatchState = {
     readonly kind: "disabled";
 } | {
@@ -34,33 +34,33 @@ export type WorktreeDispatchState = {
     readonly kind: "ready";
     readonly worktreePath: string;
 };
-/** Taxonomía cerrada de fallos al vincular el despacho a un worktree. */
+/** Closed taxonomy of failures when binding dispatch to a worktree. */
 export type WorktreeDispatchErrorCode = "unbound" | "missing" | "unclean" | "mismatch";
-/** Error tipado de un despacho que no puede vincularse a un worktree sano. */
+/** Typed error for a dispatch that cannot be bound to a healthy worktree. */
 export declare class WorktreeDispatchError extends Error {
     readonly code: WorktreeDispatchErrorCode;
     readonly detail: string;
     constructor(code: WorktreeDispatchErrorCode, detail: string);
 }
-/** Directorio efectivo del despacho de un efecto. */
+/** Effective dispatch directory for an effect. */
 export type DispatchDirectory = {
     /**
-     * Directorio a pasar como `query.directory`. `undefined` = raíz del workspace
-     * (comportamiento actual cuando el aislamiento está desactivado).
+     * Directory to pass as `query.directory`. `undefined` = workspace root
+     * (current behavior when isolation is disabled).
      */
     readonly directory: string | undefined;
-    /** Worktree correlacionado; `undefined` salvo con aislamiento activo. */
+    /** Correlated worktree; `undefined` except with active isolation. */
     readonly worktree: string | undefined;
 };
-/** Correlación observada del contrato `PluginInput` de una sub-sesión. */
+/** Observed correlation of a sub-session's `PluginInput` contract. */
 export type ObservedWorktreeCorrelation = {
     readonly directory: string;
     readonly worktree: string;
 };
 /**
- * Combina el flag de aislamiento, la vinculación del registro (GE-072) y la
- * salud observada del worktree en un estado de despacho. Cierra en falso por
- * defecto: una salud ausente o desconocida se trata como `missing`.
+ * Combines the isolation flag, the registry binding (GE-072), and observed
+ * worktree health into a dispatch state. Fails closed by default: absent or
+ * unknown health is treated as `missing`.
  */
 export declare function worktreeDispatchState(input: {
     readonly enabled: boolean;
@@ -68,17 +68,17 @@ export declare function worktreeDispatchState(input: {
     readonly health: WorktreeHealth | undefined;
 }): WorktreeDispatchState;
 /**
- * Resuelve el directorio efectivo del despacho. Con el aislamiento desactivado
- * devuelve el `workspaceDirectory` tal cual (idéntico al comportamiento actual);
- * con un worktree sano devuelve su ruta como `directory` y `worktree`; en
- * cualquier otro estado cierra en falso con `WorktreeDispatchError`.
+ * Resolves the effective dispatch directory. With isolation disabled, returns
+ * the `workspaceDirectory` unchanged (identical to the current behavior); with
+ * a healthy worktree, returns its path as `directory` and `worktree`; in any
+ * other state, fails closed with `WorktreeDispatchError`.
  */
 export declare function resolveDispatchDirectory(state: WorktreeDispatchState, workspaceDirectory: string | undefined): DispatchDirectory;
 /**
- * Verifica la correlación del contrato `PluginInput` (GE-005): el
- * `directory`/`worktree` observado de la sub-sesión debe coincidir con el
- * worktree leaseado del run. Lanza `WorktreeDispatchError("mismatch")` si
- * alguno difiere; comparación de rutas normalizada por plataforma.
+ * Verifies the correlation of the `PluginInput` contract (GE-005): the
+ * sub-session's observed `directory`/`worktree` must match the run's leased
+ * worktree. Throws `WorktreeDispatchError("mismatch")` if either differs;
+ * platform-normalized path comparison.
  */
 export declare function assertWorktreeCorrelation(observed: ObservedWorktreeCorrelation, leasedWorktree: string): void;
 //# sourceMappingURL=worktreeDispatch.d.ts.map

package/dist/orchestrator/worktreeDispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktreeDispatch.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktreeDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf,8EAA8E;AAC9E,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAK1D;CACF;AAED,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAUF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7C,GAAG,qBAAqB,CAgBxB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,iBAAiB,CAanB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,2BAA2B,EACrC,cAAc,EAAE,MAAM,GACrB,IAAI,CAaN"}
+{"version":3,"file":"worktreeDispatch.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktreeDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;;;;;;;;;;;;;;;GAiBG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,uEAAuE;AACvE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf,6EAA6E;AAC7E,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAK1D;CACF;AAED,kDAAkD;AAClD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAUF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7C,GAAG,qBAAqB,CAgBxB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,iBAAiB,CAanB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,2BAA2B,EACrC,cAAc,EAAE,MAAM,GACrB,IAAI,CAaN"}

package/dist/orchestrator/worktreeReconciler.d.ts

@@ -1,61 +1,62 @@
 /**
- * Reconciliador de worktrees huérfanos tras un crash (GE-074, D-W4).
+ * Orphaned worktree reconciler after a crash (GE-074, D-W4).
  *
- * Sigue el mismo contrato dry-run que los comandos de operador (GE-045,
- * `src/commands/graph.ts`): es **lógica pura y determinista** que recibe un
- * snapshot ya observado (worktrees listados por el adapter GE-071, qué runs
- * siguen activos según el registro de runs GE-025, y el estado de merge-back
- * probado por el llamante) y decide, sin ejecutar, qué acción es segura para
- * cada worktree. La ejecución real (`prune`/merge-back) vive en la capa de
- * wiring y sólo cuando el plan la autoriza.
+ * It follows the same dry-run contract as the operator commands (GE-045,
+ * `src/commands/graph.ts`): it is **pure and deterministic logic** that
+ * receives an already-observed snapshot (worktrees listed by the GE-071
+ * adapter, which runs remain active according to the GE-025 run registry, and
+ * the merge-back state probed by the caller) and decides, without executing
+ * anything, which action is safe for each worktree. Actual execution
+ * (`prune`/merge-back) lives in the wiring layer and only runs when the plan
+ * authorizes it.
  *
- * Política de reconciliación:
- * - **Run activo** → `retain`: nunca se toca un worktree cuyo run sigue vivo.
- * - **Huérfano limpio y sin commits** → `prune`: eliminación segura y reportada.
- * - **Huérfano limpio con commits** → `merge-back`: explícito e idempotente;
- *   nunca descarta en silencio la rama del run. Una segunda pasada, cuando la
- *   rama ya está integrada (`alreadyMerged`), planifica `prune` en vez de
- *   volver a fusionar.
- * - **Sucio o ambiguo** → `block`: se detiene para una decisión del operador.
+ * Reconciliation policy:
+ * - **Active run** → `retain`: never touch a worktree whose run is still alive.
+ * - **Clean orphan with no commits** → `prune`: safe and reported removal.
+ * - **Clean orphan with commits** → `merge-back`: explicit and idempotent;
+ *   never silently discards the run branch. A second pass, when the branch is
+ *   already integrated (`alreadyMerged`), plans `prune` instead of merging
+ *   again.
+ * - **Dirty or ambiguous** → `block`: stop for an operator decision.
  *
- * Invariante de UX-neutralidad (D-W4): con `graph.worktrees.enabled` = `false`
- * (el default) el reconciliador es un **no-op** — devuelve un informe vacío, no
- * planifica ni crea ni poda ningún worktree. Ninguna ruta viva lo llama todavía.
+ * UX-neutrality invariant (D-W4): with `graph.worktrees.enabled` = `false`
+ * (the default), the reconciler is a **no-op** — it returns an empty report,
+ * and plans, creates, or prunes no worktree. No live path calls it yet.
  */
-/** Estado de merge-back observado de un worktree (probe de git del llamante). */
+/** Observed merge-back state of a worktree (the caller's git probe). */
 export type WorktreeMergeState = "clean-empty" | "clean-ahead" | "dirty";
-/** Snapshot observado de un worktree candidato a reconciliar. */
+/** Observed snapshot of a worktree candidate for reconciliation. */
 export type WorktreeObservation = {
     readonly runID: string;
     readonly path: string;
-    /** El run sigue activo según el registro de runs (lease vigente). */
+    /** The run is still active according to the run registry (valid lease). */
     readonly runActive: boolean;
-    /** Estado de merge-back observado. */
+    /** Observed merge-back state. */
     readonly mergeState: WorktreeMergeState;
     /**
-     * Sólo relevante con `mergeState: "clean-ahead"`: la rama del run ya está
-     * integrada en la base, de modo que la reconciliación es idempotente y puede
-     * podar en vez de volver a fusionar.
+     * Only relevant with `mergeState: "clean-ahead"`: the run branch is already
+     * integrated into the base, so reconciliation is idempotent and can prune
+     * instead of merging again.
      */
     readonly alreadyMerged?: boolean;
 };
-/** Acción planificada para un worktree, decidida sin ejecutarla. */
+/** Planned action for a worktree, decided without executing it. */
 export type WorktreeReconcileAction = "retain" | "prune" | "merge-back" | "block";
-/** Plan de reconciliación de un worktree concreto. */
+/** Reconciliation plan for a specific worktree. */
 export type WorktreeReconcilePlan = {
     readonly runID: string;
     readonly path: string;
     readonly action: WorktreeReconcileAction;
-    /** Razón estable y machine-readable de la decisión. */
+    /** Stable, machine-readable reason for the decision. */
     readonly reason: string;
-    /** `true` cuando la acción preserva invariantes sin override del operador. */
+    /** `true` when the action preserves invariants without an operator override. */
     readonly safe: boolean;
 };
-/** Informe agregado de la reconciliación. */
+/** Aggregate reconciliation report. */
 export type WorktreeReconcileReport = {
-    /** Estado del flag de aislamiento en el momento de reconciliar. */
+    /** State of the isolation flag at reconciliation time. */
     readonly enabled: boolean;
-    /** Plan por worktree, en el orden observado. */
+    /** Plan per worktree, in observed order. */
     readonly plans: readonly WorktreeReconcilePlan[];
     readonly retained: number;
     readonly pruned: number;
@@ -63,9 +64,9 @@ export type WorktreeReconcileReport = {
     readonly blocked: number;
 };
 /**
- * Planifica la reconciliación de un conjunto de worktrees observados. Con el
- * aislamiento desactivado devuelve un informe vacío (no-op). Puro: no ejecuta
- * git ni toca I/O.
+ * Plans reconciliation for a set of observed worktrees. With isolation
+ * disabled, returns an empty report (no-op). Pure: does not execute git or
+ * touch I/O.
  */
 export declare function planWorktreeReconciliation(input: {
     readonly enabled: boolean;

package/dist/orchestrator/worktreeReconciler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktreeReconciler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktreeReconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC;AAEzE,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,CAAC;AAEZ,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,uBAAuB,GAAG;IACpC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAkCF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD,GAAG,uBAAuB,CAwB1B"}
+{"version":3,"file":"worktreeReconciler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktreeReconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC;AAEzE,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,CAAC;AAEZ,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAkCF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD,GAAG,uBAAuB,CAwB1B"}

package/dist/plugin/availability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/plugin/availability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG,MAAM,cAAc,EAAE,CAAC;AAE1D,KAAK,aAAa,GAAG;IACnB,KAAK,CACH,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,GAC5C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,IAAI,cAAc,EAAE,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,CAAC;AA2EF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,oBAAoB,EAAE,EACjC,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CA6BlB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAyBnB"}
+{"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../../src/plugin/availability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG,MAAM,cAAc,EAAE,CAAC;AAE1D,KAAK,aAAa,GAAG;IACnB,KAAK,CACH,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,GAC5C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,IAAI,cAAc,EAAE,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,CAAC;AAiFF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,oBAAoB,EAAE,EACjC,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAkClB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAyBnB"}

package/dist/plugin/capture.d.ts

@@ -1,9 +1,9 @@
 import { type ActivityEvent, type MessageEvent, type SessionEndpointEvent } from "../telemetry/events";
 /**
- * Mapeo **puro** de eventos de opencode a `OpenTeamEvent` redactados. Sin I/O,
- * red, reloj (se inyecta `now`), random ni env vars.
+ * **Pure** mapping of opencode events to redacted `OpenTeamEvent`s. No I/O,
+ * network, clock (`now` is injected), randomness, or env vars.
  */
-/** Forma estructural mínima de un `AssistantMessage` de opencode. */
+/** Minimal structural shape of an opencode `AssistantMessage`. */
 export type AssistantInfoLike = {
     role?: string;
     sessionID?: string;
@@ -27,15 +27,15 @@ export type AssistantInfoLike = {
     };
 };
 /**
- * Construye un `message` event a partir de un mensaje de asistente **completado**
- * (coste y tokens reales). Devuelve `undefined` si el mensaje no es de asistente,
- * no ha terminado, o le falta sesión/modelo.
+ * Builds a `message` event from a **completed** assistant message
+ * (real cost and tokens). Returns `undefined` if the message is not from the assistant,
+ * has not finished, or is missing session/model.
  */
 export declare function messageEventFrom(info: AssistantInfoLike, now: () => number): MessageEvent | undefined;
 /**
- * Construye un `session-endpoint` event para anunciar el servidor opencode de una
- * sesión. `url` se normaliza a solo el **origen** (`protocol//host:port`): nunca
- * rutas, query ni credenciales. Devuelve `undefined` si `url` no es parseable.
+ * Builds a `session-endpoint` event to announce the opencode server for a
+ * session. `url` is normalized to only the **origin** (`protocol//host:port`): never
+ * paths, query strings, or credentials. Returns `undefined` if `url` is not parseable.
  */
 export declare function sessionEndpointEventFrom(sessionID: string, url: string | URL, now: () => number, meta?: {
     directory?: string;
@@ -48,9 +48,9 @@ type OpencodeEventLike = {
 };
 export declare function sessionIDFromEvent(event: OpencodeEventLike): string | undefined;
 /**
- * Construye un `activity` event redactado (solo el tipo de evento, nunca
- * contenido) a partir de un evento de ciclo de vida de sesión. Devuelve
- * `undefined` fuera de la allow-list o si falta `sessionID`.
+ * Builds a redacted `activity` event (only the event type, never
+ * content) from a session lifecycle event. Returns
+ * `undefined` outside the allow-list or if `sessionID` is missing.
  */
 export declare function activityEventFrom(event: OpencodeEventLike, now: () => number): ActivityEvent | undefined;
 export {};

package/dist/plugin/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/plugin/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AAEH,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;CACH,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,MAAM,GAChB,YAAY,GAAG,SAAS,CA0C1B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,GAAG,EAAE,MAAM,MAAM,EACjB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,oBAAoB,GAAG,SAAS,CA4BlC;AAQD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,MAAM,MAAM,GAChB,aAAa,GAAG,SAAS,CAiB3B"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/plugin/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AAEH,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;CACH,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,MAAM,GAChB,YAAY,GAAG,SAAS,CA0C1B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,GAAG,EAAE,MAAM,MAAM,EACjB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,oBAAoB,GAAG,SAAS,CA4BlC;AAQD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,MAAM,MAAM,GAChB,aAAa,GAAG,SAAS,CAiB3B"}

package/dist/plugin/commandTool.d.ts

@@ -1,6 +1,6 @@
 import { type ToolDefinition } from "@opencode-ai/plugin";
 import { type CliDeps } from "../commands/dispatch";
-export type CommandAction = "show" | "set" | "auto" | "doctor" | "report" | "agents" | "console";
+export type CommandAction = "show" | "set" | "auto" | "doctor" | "report" | "agents" | "console" | "clear-cache";
 /**
  * Map a tool action (+ optional model) to the argv understood by {@link runCli}.
  * Pure so it can be unit-tested without the opencode runtime.

package/dist/plugin/commandTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commandTool.d.ts","sourceRoot":"","sources":["../../src/plugin/commandTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB3E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAkB/D"}
+{"version":3,"file":"commandTool.d.ts","sourceRoot":"","sources":["../../src/plugin/commandTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,aAAa,CAAC;AAElB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB3E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CA2B/D"}

package/dist/plugin/graphShadowIngress.d.ts

@@ -1,41 +1,42 @@
 import { z } from "zod";
 import type { GraphMode } from "../config/schema";
 /**
- * **Ingesta shadow productiva** (GE-042): observa **una** ejecución legacy real
- * y la proyecta a un `LegacyExecutionTraceV1` **reference-only**, sin duplicar
- * trabajo.
+ * **Production shadow ingestion** (GE-042): observes **one** real legacy
+ * execution and projects it to a **reference-only** `LegacyExecutionTraceV1`,
+ * without duplicating work.
  *
- * El trace es el input que el espejo sin efectos (GE-043) compila para que el
- * comparador de paridad (GE-044) lo contraste. Por eso transporta exactamente
- * las dimensiones que el comparador normaliza —estado terminal, orden de nodos,
- * roles, modelos, nº de fixes y outcome— y **nada de contenido crudo**: ni
- * brief, ni prompt, ni argumentos de tool, ni salida del modelo. Solo ids,
- * roles, referencias de modelo/sesión, clases de error y contadores.
+ * The trace is the input that the effect-free mirror (GE-043) compiles for the
+ * parity comparator (GE-044) to compare. That is why it carries exactly the
+ * dimensions the comparator normalizes —terminal state, node order, roles,
+ * models, number of fixes, and outcome— and **no raw content**: no brief, no
+ * prompt, no tool arguments, no model output. Only ids, roles, model/session
+ * references, error classes, and counters.
  *
- * Garantías estructurales del boundary:
- *   - **Sin efectos ni LLM:** este módulo solo mapea una observación ya
- *     producida; nunca despacha una tool, ejecuta un efecto ni llama al modelo,
- *     así que no puede duplicar la ejecución legacy que observa.
- *   - **Sin trace sintético:** una observación que no ejecutó de verdad
- *     (reanudada o `skipped`) o sin nodos es **inelegible de forma explícita**;
- *     el builder nunca fabrica un run.
- *   - **Gate dormant:** solo observa con `graph.mode` en `shadow`/`active` y sin
- *     `killSwitch`; con `off` (o sección ausente) o kill-switch, inelegible.
- *   - **Reference-only:** un guard final rechaza cualquier campo crudo y el
- *     parser de boundary rechaza además claves desconocidas.
+ * Structural guarantees of the boundary:
+ *   - **No effects or LLM:** this module only maps an observation that has
+ *     already been produced; it never dispatches a tool, executes an effect, or
+ *     calls the model, so it cannot duplicate the legacy execution it observes.
+ *   - **No synthetic trace:** an observation that did not truly execute
+ *     (resumed or `skipped`) or has no nodes is **explicitly ineligible**; the
+ *     builder never fabricates a run.
+ *   - **Gate dormant:** observes only with `graph.mode` in `shadow`/`active` and
+ *     without `killSwitch`; with `off` (or an absent section) or kill-switch,
+ *     ineligible.
+ *   - **Reference-only:** a final guard rejects any raw field and the boundary
+ *     parser also rejects unknown keys.
  *
- * Módulo **puro y determinista**: sin I/O, red, reloj, random ni env vars.
+ * **Pure and deterministic** module: no I/O, network, clock, random, or env vars.
  */
-/** Versión del trace de ejecución legacy. */
+/** Version of the legacy execution trace. */
 export declare const LEGACY_EXECUTION_TRACE_VERSION: 1;
-/** Estado terminal normalizado de la ejecución legacy observada. */
+/** Normalized terminal status of the observed legacy execution. */
 export declare const LegacyExecutionStatusSchema: z.ZodEnum<{
     cancelled: "cancelled";
     completed: "completed";
     failed: "failed";
 }>;
 export type LegacyExecutionStatus = z.infer<typeof LegacyExecutionStatusSchema>;
-/** Outcome normalizado del review de la ejecución legacy observada. */
+/** Normalized outcome of the observed legacy execution review. */
 export declare const LegacyReviewOutcomeSchema: z.ZodEnum<{
     approved: "approved";
     inconclusive: "inconclusive";
@@ -43,10 +44,10 @@ export declare const LegacyReviewOutcomeSchema: z.ZodEnum<{
 }>;
 export type LegacyReviewOutcome = z.infer<typeof LegacyReviewOutcomeSchema>;
 /**
- * Nodo del trace: solo referencias y etiquetas acotadas. `model` es la
- * referencia normalizada del modelo (p. ej. `provider/model`); `sessionRef` es
- * el id de la subsesión de opencode, nunca su contenido; `errorClass` es la
- * taxonomía acotada de fallo que comparte el runtime del grafo.
+ * Trace node: only references and bounded tags. `model` is the normalized
+ * model reference (e.g. `provider/model`); `sessionRef` is the opencode
+ * subsession id, never its content; `errorClass` is the bounded failure
+ * taxonomy shared by the graph runtime.
  */
 export declare const LegacyTraceNodeV1Schema: z.ZodObject<{
     id: z.ZodString;
@@ -66,9 +67,9 @@ export declare const LegacyTraceNodeV1Schema: z.ZodObject<{
 }, z.core.$strict>;
 export type LegacyTraceNodeV1 = z.infer<typeof LegacyTraceNodeV1Schema>;
 /**
- * Trace versionado y reference-only de una única ejecución legacy productiva.
- * `nodes` conserva el **orden** de despacho (implementer, reviewer, fixes...),
- * que es una de las dimensiones de paridad.
+ * Versioned and reference-only trace of a single productive legacy execution.
+ * `nodes` preserves the dispatch **order** (implementer, reviewer, fixes...),
+ * which is one of the parity dimensions.
  */
 export declare const LegacyExecutionTraceV1Schema: z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -103,27 +104,27 @@ export declare const LegacyExecutionTraceV1Schema: z.ZodObject<{
     parentSessionRef: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type LegacyExecutionTraceV1 = z.infer<typeof LegacyExecutionTraceV1Schema>;
-/** Gate de elegibilidad: subconjunto observado de la config `graph`. */
+/** Eligibility gate: observed subset of the `graph` config. */
 export type ShadowIngressGate = {
     readonly mode: GraphMode;
     readonly killSwitch: boolean;
 };
-/** Motivo **explícito** por el que una observación no produce trace. */
+/** **Explicit** reason why an observation does not produce a trace. */
 export type ShadowIngressIneligibleReason = "graph-disabled" | "kill-switch" | "not-executed" | "no-observation";
-/** Nodo observado de la ejecución legacy real (puerto de entrada acotado). */
+/** Observed node from the real legacy execution (bounded input port). */
 export type ObservedLegacyNode = {
     readonly id: string;
     readonly role: LegacyTraceNodeV1["role"];
     readonly model: string;
-    /** Éxito terminal del nodo; deriva el outcome cuando el nodo es reviewer. */
+    /** Terminal success of the node; derives the outcome when the node is reviewer. */
     readonly ok: boolean;
     readonly sessionRef?: string;
     readonly errorClass?: LegacyTraceNodeV1["errorClass"];
 };
 /**
- * Observación de **una** ejecución legacy real, correlada por el orquestador a
- * partir de los hooks de evento/tool. `executed: false` marca una reanudación o
- * un `skipped` (sin ejecución real): inelegible explícito.
+ * Observation of **one** real legacy execution, correlated by the orchestrator
+ * from the event/tool hooks. `executed: false` marks a resumption or a
+ * `skipped` (no real execution): explicitly ineligible.
  */
 export type ObservedLegacyRun = {
     readonly runID: string;
@@ -133,7 +134,7 @@ export type ObservedLegacyRun = {
     readonly nodes: readonly ObservedLegacyNode[];
     readonly parentSessionRef?: string;
 };
-/** Resultado de la ingesta: trace elegible o inelegibilidad explícita. */
+/** Ingestion result: eligible trace or explicit ineligibility. */
 export type ShadowIngressResult = {
     readonly eligible: true;
     readonly trace: LegacyExecutionTraceV1;
@@ -141,25 +142,26 @@ export type ShadowIngressResult = {
     readonly eligible: false;
     readonly reason: ShadowIngressIneligibleReason;
 };
-/** El gate está abierto cuando la observación shadow es elegible. */
+/** The gate is open when the shadow observation is eligible. */
 export declare function shadowIngressGateOpen(gate: ShadowIngressGate | undefined): boolean;
 /**
- * Ingesta la observación de una ejecución legacy real y devuelve un
- * `LegacyExecutionTraceV1` reference-only, o la inelegibilidad explícita. No
- * ejecuta efectos, no llama al modelo y no fabrica traces: solo proyecta lo
- * observado cuando el gate está abierto y la ejecución fue real.
+ * Ingests the observation of a real legacy execution and returns a
+ * reference-only `LegacyExecutionTraceV1`, or the explicit ineligibility. Does
+ * not execute effects, does not call the model, and does not fabricate traces:
+ * it only projects what was observed when the gate is open and the execution was
+ * real.
  */
 export declare function ingestLegacyExecution(observation: ObservedLegacyRun, gate: ShadowIngressGate | undefined): ShadowIngressResult;
-/** Error tipado de validación del trace legacy en el boundary. */
+/** Typed validation error for the legacy trace at the boundary. */
 export declare class LegacyTraceError extends Error {
     readonly code: "invalid-legacy-trace";
     readonly issues: string[];
     constructor(error: z.ZodError);
 }
 /**
- * Valida y parsea un trace legacy en el boundary (lo consume GE-043). Lanza
- * `LegacyTraceError` si la forma es inválida o transporta claves desconocidas,
- * incluidos los campos de contenido crudo.
+ * Validates and parses a legacy trace at the boundary (consumed by GE-043).
+ * Throws `LegacyTraceError` if the shape is invalid or carries unknown keys,
+ * including raw content fields.
  */
 export declare function parseLegacyExecutionTrace(input: unknown): LegacyExecutionTraceV1;
 //# sourceMappingURL=graphShadowIngress.d.ts.map

package/dist/plugin/graphShadowIngress.d.ts.map

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