@jmanuelcorral/openteam 0.2.2 → 0.9.0

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

@@ -1 +1 @@
-{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAEV,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQrD,OAAO,EACL,KAAK,qBAAqB,EAG1B,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACpC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAiLF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,SAAS,CAAC;AAEd,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,qBAAqB,CAmBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,oBAAoB,GAC3B,UAAU,CA4BZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,SAAS,CAkB1B;AA4DD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAIzB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;IACnC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,aAAa,EAAE,EAAE,CA2BnB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CA2D1B"}
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/coordinator.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/graphCancellation.d.ts

@@ -1,71 +1,74 @@
 import type { GraphState, NodeStatus, RunStatus } from "../graph/types";
 /**
- * Políticas puras de cancelación, timeout y compleción tardía (GE-034).
+ * Pure policies for cancellation, timeout, and late completion (GE-034).
  *
- * Deciden, sin I/O ni reloj, qué hacer ante tres situaciones del runtime de
- * Graph. El runtime les inyecta la evidencia ya observada (estado del nodo, si
- * ya se pidió el abort, si expiró la ventana de gracia) y aplica el resultado:
+ * They decide, without I/O or a clock, what to do in three Graph runtime
+ * situations. The runtime injects the already observed evidence (node state,
+ * whether the abort was already requested, whether the grace window expired)
+ * and applies the result:
  *
- * - `timeoutAction`: en un timeout se pide **primero** el abort y solo se
- *   reconcilia tras agotar una ventana de gracia acotada; un nodo no `running`
- *   no tiene nada que expirar.
- * - `planCancellation`: cancelar un run en curso cancela sus nodos `pending` y
- *   `running` (así los `pending` no llegan a despacharse) y pide abort de los
- *   `running`; cancelar un run ya terminal es un no-op idempotente.
- * - `classifyLateCompletion`: un resultado que llega tarde se **audita** pero no
- *   puede revivir un intento cancelado, superado (otro `attemptID`/`operationID`)
- *   ni de un run ya terminal.
+ * - `timeoutAction`: on a timeout, request abort **first** and only reconcile
+ *   after exhausting a bounded grace window; a non-`running` node has nothing to
+ *   expire.
+ * - `planCancellation`: cancelling an in-progress run cancels its `pending` and
+ *   `running` nodes (so `pending` ones are never dispatched) and requests abort
+ *   for the `running` ones; cancelling an already terminal run is an idempotent
+ *   no-op.
+ * - `classifyLateCompletion`: a result that arrives late is **audited** but
+ *   cannot revive an attempt that was cancelled, superseded (another
+ *   `attemptID`/`operationID`), or belongs to an already terminal run.
  *
- * Todo es determinista: la misma evidencia produce la misma decisión, de modo
- * que se reproduce igual tras un reinicio.
+ * Everything is deterministic: the same evidence produces the same decision, so
+ * it is reproduced the same way after a restart.
  */
-/** Acción de timeout sobre el nodo en vuelo. */
+/** Timeout action for the in-flight node. */
 export type TimeoutAction = "noop" | "request-abort" | "awaiting-grace" | "reconcile";
-/** Evidencia inyectada para decidir el timeout de un nodo. */
+/** Injected evidence for deciding a node timeout. */
 export type TimeoutInput = {
     readonly nodeStatus: NodeStatus;
-    /** `true` si el runtime ya solicitó el abort de este intento. */
+    /** `true` if the runtime has already requested the abort for this attempt. */
     readonly abortRequested: boolean;
-    /** `true` si la ventana de gracia acotada ya expiró. */
+    /** `true` if the bounded grace window has already expired. */
     readonly graceExceeded: boolean;
 };
 /**
- * Decide la acción de timeout. Solo un nodo `running` puede expirar: si aún no
- * se pidió el abort, se pide; si ya se pidió, se espera hasta agotar la gracia y
- * entonces se reconcilia. Un nodo no `running` es un no-op.
+ * Decides the timeout action. Only a `running` node can expire: if abort has not
+ * been requested yet, request it; if it has already been requested, wait until
+ * grace is exhausted and then reconcile. A non-`running` node is a no-op.
  */
 export declare function timeoutAction(input: TimeoutInput): TimeoutAction;
-/** Plan determinista de cancelación de un run. */
+/** Deterministic plan for cancelling a run. */
 export type CancellationPlan = {
-    /** `true` si el run sigue en curso y debe marcarse `cancelled`. */
+    /** `true` if the run is still in progress and should be marked `cancelled`. */
     readonly cancelRun: boolean;
-    /** Nodos a marcar `cancelled` (los `pending` y `running`), en orden estable. */
+    /** Nodes to mark `cancelled` (the `pending` and `running` ones), in stable order. */
     readonly cancelNodeIDs: readonly string[];
-    /** Nodos `running` cuyo efecto debe abortarse, en orden estable. */
+    /** `running` nodes whose effect should be aborted, in stable order. */
     readonly abortNodeIDs: readonly string[];
 };
 /**
- * Planifica la cancelación del run. Cancela los nodos `pending` (para que no
- * lleguen a despacharse) y `running`, y pide abort de los `running`. Un run ya
- * terminal no vuelve a cancelarse y no deja nodos por cancelar (idempotente).
+ * Plans cancellation of the run. Cancels `pending` nodes (so they never get
+ * dispatched) and `running` nodes, and requests abort for the `running` ones. An
+ * already terminal run is not cancelled again and leaves no nodes to cancel
+ * (idempotent).
  */
 export declare function planCancellation(state: GraphState): CancellationPlan;
-/** Motivo por el que una compleción tardía se descarta. */
+/** Reason why a late completion is discarded. */
 export type LateCompletionReason = "run-terminal" | "unknown-node" | "not-running" | "superseded";
-/** Veredicto sobre un recibo que llega tarde. */
+/** Verdict for a receipt that arrives late. */
 export type LateCompletionVerdict = {
     readonly kind: "apply";
 } | {
     readonly kind: "stale";
     readonly reason: LateCompletionReason;
 };
-/** Estado mínimo del nodo destino del recibo tardío. */
+/** Minimum state of the target node for the late receipt. */
 export type LateCompletionNode = {
     readonly status: NodeStatus;
     readonly operationID?: string;
     readonly attemptID?: string;
 };
-/** Entrada para clasificar una compleción tardía. */
+/** Input for classifying a late completion. */
 export type LateCompletionInput = {
     readonly runStatus: RunStatus;
     readonly node: LateCompletionNode | undefined;
@@ -75,10 +78,10 @@ export type LateCompletionInput = {
     };
 };
 /**
- * Clasifica un recibo tardío. Solo se aplica al intento `running` vigente con
- * `operationID`/`attemptID` coincidentes; en cualquier otro caso (run terminal,
- * nodo desconocido, nodo no `running`, intento superado) se marca `stale` para
- * auditarlo sin mutar el estado.
+ * Classifies a late receipt. It applies only to the current `running` attempt
+ * with matching `operationID`/`attemptID`; in any other case (terminal run,
+ * unknown node, non-`running` node, superseded attempt) it is marked `stale` so
+ * it can be audited without mutating state.
  */
 export declare function classifyLateCompletion(input: LateCompletionInput): LateCompletionVerdict;
 //# sourceMappingURL=graphCancellation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphCancellation.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphCancellation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,gDAAgD;AAChD,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQhE;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAiBpE;AAED,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEtE,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,qBAAqB,CAkBvB"}
+{"version":3,"file":"graphCancellation.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphCancellation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAEhB,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAQhE;AAED,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAiBpE;AAED,iDAAiD;AACjD,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,aAAa,GACb,YAAY,CAAC;AAEjB,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GACzB,qBAAqB,CAkBvB"}

package/dist/orchestrator/graphEffects.d.ts

@@ -2,24 +2,25 @@ import type { ContextRef, PrivacyClass } from "../context/schema";
 import { type PrivacyMode, type RouteKind } from "../graph/privacyPolicy";
 import type { ErrorClass, GraphNode } from "../graph/schema";
 /**
- * `GraphEffectExecutor` — puerto del único efecto que el runtime de Graph
- * (GE-031) ejecuta por nodo. El runtime commitea la intención (`node.dispatched`)
- * en el journal **antes** de invocar `execute`, y el recibo (`node.succeeded` o
- * `node.failed`) **después**; el executor solo produce el resultado del efecto.
+ * `GraphEffectExecutor` — port for the only effect that the Graph runtime
+ * (GE-031) executes per node. The runtime commits the intention
+ * (`node.dispatched`) to the journal **before** invoking `execute`, and the
+ * receipt (`node.succeeded` or `node.failed`) **after**; the executor only
+ * produces the effect result.
  *
- * Este módulo es solo tipos: sin I/O, SDK, storage ni estado global. El runtime
- * recibe un executor inyectado; en producción lo implementará el adaptador de
- * sesión de opencode (GE-030), y en tests un doble determinista. Mantener el
- * seam como puerto permite probar el runtime sin red ni SDK reales.
+ * This module is types only: no I/O, SDK, storage, or global state. The runtime
+ * receives an injected executor; in production the opencode session adapter
+ * (GE-030) will implement it, and in tests a deterministic double. Keeping the
+ * seam as a port allows testing the runtime without real network or SDK.
  */
-/** Solicitud de ejecución de un efecto para un nodo e intento concretos. */
+/** Request to execute an effect for a specific node and attempt. */
 export type EffectRequest = {
     readonly runID: string;
     readonly node: GraphNode;
     readonly operationID: string;
     readonly attemptID: string;
 };
-/** Recibo de un efecto: éxito con artefacto referenciado, o fallo clasificado. */
+/** Effect receipt: success with a referenced artifact, or classified failure. */
 export type EffectReceipt = {
     readonly outcome: "succeeded";
     readonly artifact: ContextRef;
@@ -27,14 +28,14 @@ export type EffectReceipt = {
     readonly outcome: "failed";
     readonly errorClass: ErrorClass;
 };
-/** Ejecutor inyectable del efecto de un nodo. Determinista dado el request. */
+/** Injectable executor for a node effect. Deterministic for a given request. */
 export interface GraphEffectExecutor {
     execute(request: EffectRequest): Promise<EffectReceipt>;
 }
 /**
- * Contexto de privacidad de un despacho: clase de privacidad del nodo, modo
- * efectivo de la config y ruta preferida por el router. Deja al seam de efectos
- * la decisión reference-only/frontier antes y después de invocar al executor.
+ * Privacy context for a dispatch: node privacy class, effective config mode,
+ * and the route preferred by the router. Leaves the reference-only/frontier
+ * decision to the effects seam before and after invoking the executor.
  */
 export type EffectDispatchContext = {
     readonly privacyClass: PrivacyClass;
@@ -42,22 +43,21 @@ export type EffectDispatchContext = {
     readonly routeKind: RouteKind;
 };
 /**
- * Resuelve la ruta **efectiva** de un despacho (GE-037). Si la política prohíbe
- * frontier para la clase de privacidad bajo el modo activo, degrada a `local`
- * en vez de lanzar: un nodo `sensitive` con `forceLocalOnSensitive` produce
- * **cero** despachos a frontier. Puro y determinista.
+ * Resolves the **effective** route for a dispatch (GE-037). If policy forbids
+ * frontier for the privacy class under the active mode, degrades to `local`
+ * instead of throwing: a `sensitive` node with `forceLocalOnSensitive` produces
+ * **zero** frontier dispatches. Pure and deterministic.
  */
 export declare function resolveDispatchRoute(privacyClass: PrivacyClass, mode: PrivacyMode, preferred: RouteKind): RouteKind;
 /**
- * Gate de privacidad **antes** de invocar al executor: lanza
- * `PrivacyPolicyError` si un nodo `sensitive` bajo `forceLocalOnSensitive`
- * intenta una ruta frontier.
+ * Privacy gate **before** invoking the executor: throws `PrivacyPolicyError` if
+ * a `sensitive` node under `forceLocalOnSensitive` attempts a frontier route.
  */
 export declare function assertDispatchAllowed(ctx: EffectDispatchContext): void;
 /**
- * Gate reference-only **después** del executor: el recibo solo puede llevar una
- * `ContextRef` (éxito) o una clase de error (fallo); lanza `RedactionError` si
- * alguna estructura transporta un campo de contenido crudo.
+ * Reference-only gate **after** the executor: the receipt may only carry a
+ * `ContextRef` (success) or an error class (failure); throws `RedactionError` if
+ * any structure carries a raw content field.
  */
 export declare function assertReceiptReferenceOnly(receipt: EffectReceipt): void;
 //# sourceMappingURL=graphEffects.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphEffects.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphEffects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;;;GAUG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS,GACnB,SAAS,CAIX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"graphEffects.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphEffects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;;;;;;;GAWG;AAEH,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEpE,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,SAAS,GACnB,SAAS,CAIX;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEvE"}

package/dist/orchestrator/graphFacade.d.ts

@@ -1,16 +1,16 @@
 import { type ShadowMirror, type ShadowMirrorErrorCode } from "./graphShadow";
 /**
- * **Fachada de contención del espejo shadow** (GE-043).
+ * **Shadow mirror containment facade** (GE-043).
  *
- * El espejo observa al camino legacy; nunca lo gobierna. Esta frontera hace esa
- * garantía estructural en vez de disciplinaria: `mirrorLegacyTrace` es
- * **total** —no lanza para ningún valor de entrada, ni siquiera para objetos
- * hostiles cuyos accesores exploten— y `mirrorAlongsideLegacy` devuelve el
- * resultado legacy **por identidad**, sin copiarlo ni inspeccionarlo. Un fallo
- * del espejo degrada a un resultado tipado que el llamante puede ignorar; no
- * hay camino por el que altere el desenlace productivo.
+ * The mirror observes the legacy path; it never governs it. This boundary makes
+ * that guarantee structural rather than disciplinary: `mirrorLegacyTrace` is
+ * **total** —it does not throw for any input value, not even hostile objects
+ * whose accessors explode— and `mirrorAlongsideLegacy` returns the legacy result
+ * **by identity**, without copying or inspecting it. A mirror failure degrades
+ * to a typed result that the caller can ignore; there is no path by which it
+ * alters the production outcome.
  */
-/** Resultado contenido del espejo: éxito con evidencia, o fallo tipado. */
+/** Contained mirror result: success with evidence, or typed failure. */
 export type ShadowMirrorResult = {
     readonly ok: true;
     readonly mirror: ShadowMirror;
@@ -19,21 +19,21 @@ export type ShadowMirrorResult = {
     readonly code: ShadowMirrorErrorCode;
     readonly detail: string;
 };
-/** Resultado productivo con su espejo adjunto, nunca fusionados. */
+/** Production result with its mirror attached, never merged. */
 export type LegacyWithShadow<T> = {
     readonly legacy: T;
     readonly shadow: ShadowMirrorResult;
 };
 /**
- * Construye el espejo de un trace de procedencia no confiable. Cualquier fallo
- * —trace inválido, grafo irrepresentable, secuencia ilegal o error inesperado—
- * se devuelve como valor.
+ * Builds the mirror from an untrusted trace. Any failure — invalid trace,
+ * unrepresentable graph, illegal sequence, or unexpected error — is returned as
+ * a value.
  */
 export declare function mirrorLegacyTrace(trace: unknown): ShadowMirrorResult;
 /**
- * Adjunta el espejo a un desenlace legacy ya calculado. El valor legacy se
- * devuelve tal cual llegó: la identidad referencial es la prueba de que el
- * espejo no lo pudo tocar.
+ * Attaches the mirror to an already computed legacy outcome. The legacy value is
+ * returned exactly as it arrived: referential identity is the proof that the
+ * mirror could not touch it.
  */
 export declare function mirrorAlongsideLegacy<T>(legacy: T, trace: unknown): LegacyWithShadow<T>;
 //# sourceMappingURL=graphFacade.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"graphFacade.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphFacade.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuBpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,CAErB"}
+{"version":3,"file":"graphFacade.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphFacade.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAuBpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,CAErB"}

package/dist/orchestrator/graphIngress.d.ts

@@ -1,22 +1,22 @@
 /**
- * GE-050 — ingress activo de SDD detrás de una puerta cerrada por defecto.
+ * GE-050 — active SDD ingress behind a gate closed by default.
  *
- * R1 entrega el punto de entrada de producción que el runtime activo nunca tuvo
- * y lo deja **inalcanzable**. La propiedad central es que "inalcanzable por
- * configuración soportada" es ESTRUCTURAL, no una promesa: la puerta es una
- * capability que el parser de config no puede construir (su marca es un símbolo
- * privado de este módulo), así que ningún `.opencode/openteam.json` — se escriba
- * como se escriba — puede abrirla. Solo `unsafeGrantActiveIngress` la produce, y
- * ningún módulo de producción lo llama.
+ * R1 delivers the production entry point that the active runtime never had and
+ * leaves it **unreachable**. The central property is that "unreachable by
+ * supported configuration" is STRUCTURAL, not a promise: the gate is a
+ * capability that the config parser cannot construct (its brand is a symbol
+ * private to this module), so no `.opencode/openteam.json` — no matter how it
+ * is written — can open it. Only `unsafeGrantActiveIngress` produces it, and no
+ * production module calls it.
  *
- * El motivo devuelto es siempre el bloqueo **más externo necesario**, para que
- * un diagnóstico nunca sugiera un remedio que no funcionaría: en R1, apagar el
- * kill switch o ampliar la allow-list no cambia nada mientras la puerta esté
- * cerrada, y el ingress lo dice.
+ * The returned reason is always the **outermost necessary** block, so a
+ * diagnostic never suggests a remedy that would not work: in R1, turning off
+ * the kill switch or broadening the allow-list changes nothing while the gate
+ * remains closed, and ingress says so.
  *
- * Este módulo es una capa de **composición**: no reimplementa el runtime, la
- * revisión ni la cancelación; los orquesta y traduce sus resultados a un
- * resultado total (nunca lanza) y reference-only.
+ * This module is a **composition** layer: it does not reimplement the runtime,
+ * review, or cancellation; it orchestrates them and translates their results
+ * into a total (never throws) and reference-only result.
  */
 import type { ResolvedGraphConfig } from "../config/resolve";
 import type { GraphJournal } from "../storage/graph/provider";
@@ -25,54 +25,58 @@ import type { GraphEffectExecutor } from "./graphEffects";
 import type { RevisionPlan } from "./graphReview";
 import { type RuntimeStepOutcome } from "./graphRuntime";
 import { type SddTask } from "./sddCompiler";
-/** Marca privada del módulo: nada fuera de aquí puede fabricarla. */
+/** Module-private brand: nothing outside here can manufacture it. */
 declare const ACTIVE_INGRESS_BRAND: unique symbol;
 /**
- * Permiso interno para el ingress activo. Es opaco a propósito: al llevar una
- * marca de símbolo privado, ningún objeto derivado de JSON (y por tanto ninguna
- * config de usuario) es asignable a este tipo.
+ * Internal permission for active ingress. It is intentionally opaque: because
+ * it carries a private symbol brand, no JSON-derived object (and therefore no
+ * user config) is assignable to this type.
  */
 export type ActiveIngressCapability = {
     readonly [ACTIVE_INGRESS_BRAND]: true;
-    /** Motivo declarado de la concesión; solo para trazas internas. */
+    /** Declared reason for the grant; only for internal traces. */
     readonly grantedFor: string;
 };
 /**
- * Único productor de la capability. No se invoca desde ningún módulo de
- * producción; existe para que tests y futuros pilotos (R2+) puedan abrir la
- * puerta explícitamente, dejando la concesión visible en el código que la usa.
+ * Sole producer of the capability. It is not invoked from any production
+ * module; it exists so tests and future pilots (R2+) can open the gate
+ * explicitly, leaving the grant visible in the code that uses it.
  */
 export declare function unsafeGrantActiveIngress(grantedFor: string): ActiveIngressCapability;
-/** Motivo por el que una petición se queda en la ruta legacy. */
-export type IngressLegacyReason = "gate-closed" | "kill-switch" | "graph-disabled" | "not-allow-listed";
-/** Decisión de enrutado de una tarea SDD. */
+/** Reason why a request remains on the legacy path. */
+export type IngressLegacyReason = "gate-closed" | "kill-switch" | "cutover-gate-denied" | "graph-disabled" | "not-allow-listed";
+export type IngressGateViolations = NonNullable<ResolvedGraphConfig["gateViolations"]>;
+type IngressLegacyBlock = {
+    readonly reason: IngressLegacyReason;
+    readonly gateViolations?: IngressGateViolations;
+};
+/** Routing decision for an SDD task. */
 export type IngressDecision = {
     readonly route: "graph";
     readonly taskID: string;
-} | {
+} | ({
     readonly route: "legacy";
-    readonly reason: IngressLegacyReason;
-};
-/** Política de admisión: config resuelta, allow-list y puerta interna. */
+} & IngressLegacyBlock);
+/** Admission policy: resolved config, allow-list, and internal gate. */
 export type IngressPolicy = {
     readonly graph: ResolvedGraphConfig;
     readonly allowList: readonly string[];
     readonly capability?: ActiveIngressCapability;
 };
 /**
- * Decide la ruta de una tarea. Pura y determinista.
+ * Decides the route for a task. Pure and deterministic.
  *
- * Precedencia: `gate-closed` → `kill-switch` → `graph-disabled` →
- * `not-allow-listed`, es decir, el bloqueo más externo primero.
+ * Precedence: `gate-closed` → `kill-switch` →
+ * `cutover-gate-denied` → `graph-disabled` → `not-allow-listed`, that is, the
+ * outermost block first.
  */
 export declare function decideIngress(policy: IngressPolicy, taskID: string): IngressDecision;
-/** Clase de fallo del ingress. Nunca transporta payload del usuario. */
+/** Ingress failure class. It never carries user payload. */
 export type IngressErrorCode = "compile-failed" | "unknown-run" | "no-reviewer" | "lease-held" | "journal-failed";
-/** Resultado total de una operación del ingress. Reference-only. */
-export type IngressOutcome = {
+/** Total outcome of an ingress operation. Reference-only. */
+export type IngressOutcome = ({
     readonly kind: "legacy";
-    readonly reason: IngressLegacyReason;
-} | {
+} & IngressLegacyBlock) | {
     readonly kind: "accepted";
     readonly runID: string;
     readonly step: RuntimeStepOutcome;
@@ -95,21 +99,21 @@ export type IngressOutcome = {
     readonly code: IngressErrorCode;
     readonly detail: string;
 };
-/** Petición de rechazo de revisión: ancla la revisión en curso. */
+/** Review rejection request: anchors the in-progress review. */
 export type IngressRejectRequest = {
     readonly runID: string;
     readonly nodeID: string;
     readonly currentRevision: number;
     readonly currentOperationID: string;
 };
-/** Petición de reasignación de reviewer tras un fallo técnico. */
+/** Reviewer reassignment request after a technical failure. */
 export type IngressReassignRequest = {
     readonly runID: string;
     readonly authorID: string;
     readonly failedReviewers: readonly string[];
     readonly candidates: readonly string[];
 };
-/** Dependencias inyectadas del ingress. Todo el I/O entra por aquí. */
+/** Injected ingress dependencies. All I/O enters here. */
 export type GraphIngressDeps = {
     readonly policy: IngressPolicy;
     readonly journal: GraphJournal;
@@ -119,10 +123,10 @@ export type GraphIngressDeps = {
     readonly revisionLimit?: number;
 };
 /**
- * Superficie del ingress activo. Total para los fallos de infraestructura
- * clasificados (compilación, journal, lease), que se devuelven como resultado.
- * Un error no clasificado **sí** se propaga: un bug no debe disfrazarse de
- * decisión de enrutado, porque entonces sería indistinguible de una política.
+ * Active ingress surface. Total for classified infrastructure failures
+ * (compilation, journal, lease), which are returned as a result. An
+ * unclassified error **does** propagate: a bug must not masquerade as a routing
+ * decision, because then it would be indistinguishable from a policy.
  */
 export interface GraphIngress {
     start(task: SddTask): Promise<IngressOutcome>;

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

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