@jmanuelcorral/openteam 0.1.41 → 0.2.0

package/dist/local/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/local/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,KAAK,EACV,KAAK,EACL,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;gBAEpD,OAAO,EAAE,sBAAsB;IAYrC,KAAK,CACT,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6BlC,OAAO,CAAC,kBAAkB;CAuB3B;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GACzC,cAAc,EAAE,CAWlB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/local/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,KAAK,EACV,KAAK,EACL,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;CAC5D,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;IAEhE,YAAY,OAAO,EAAE,sBAAsB,EAU1C;IAEK,KAAK,CACT,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA2BjC;IAED,OAAO,CAAC,kBAAkB;CAuB3B;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,oBAAoB,EAAE,GACzC,cAAc,EAAE,CAWlB"}

package/dist/memory/types.d.ts

@@ -25,9 +25,9 @@ export declare const MEMORY_SCHEMA_VERSION: 1;
 export declare const SHARED_OWNER_KEY: "*";
 export declare const OwnerKeySchema: z.ZodString;
 export declare const MemoryKindSchema: z.ZodEnum<{
+    entity: "entity";
     fact: "fact";
     preference: "preference";
-    entity: "entity";
 }>;
 /** Hecho estructurado como triple sujeto-predicado-objeto (dueño-scoped). */
 export declare const FactSchema: z.ZodObject<{
@@ -130,9 +130,9 @@ export declare const MemoryRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 export declare const RecallQuerySchema: z.ZodObject<{
     ownerKey: z.ZodString;
     kinds: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        entity: "entity";
         fact: "fact";
         preference: "preference";
-        entity: "entity";
     }>>>;
     asOf: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     limit: z.ZodDefault<z.ZodNumber>;

package/dist/orchestrator/graphFacade.d.ts

@@ -0,0 +1,39 @@
+import { type ShadowMirror, type ShadowMirrorErrorCode } from "./graphShadow";
+/**
+ * **Fachada de contención del espejo shadow** (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.
+ */
+/** Resultado contenido del espejo: éxito con evidencia, o fallo tipado. */
+export type ShadowMirrorResult = {
+    readonly ok: true;
+    readonly mirror: ShadowMirror;
+} | {
+    readonly ok: false;
+    readonly code: ShadowMirrorErrorCode;
+    readonly detail: string;
+};
+/** Resultado productivo con su espejo adjunto, nunca fusionados. */
+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.
+ */
+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.
+ */
+export declare function mirrorAlongsideLegacy<T>(legacy: T, trace: unknown): LegacyWithShadow<T>;
+//# sourceMappingURL=graphFacade.d.ts.map

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

@@ -0,0 +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"}

package/dist/orchestrator/graphIngress.d.ts

@@ -0,0 +1,136 @@
+/**
+ * GE-050 — ingress activo de SDD detrás de una puerta cerrada por defecto.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * 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.
+ */
+import type { ResolvedGraphConfig } from "../config/resolve";
+import type { GraphJournal } from "../storage/graph/provider";
+import type { WorkspaceLease } from "../storage/graph/workspaceLease";
+import type { GraphEffectExecutor } from "./graphEffects";
+import type { RevisionPlan } from "./graphReview";
+import { type RuntimeStepOutcome } from "./graphRuntime";
+import type { SddTask } from "./sdd";
+/** Marca privada del módulo: nada fuera de aquí puede fabricarla. */
+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.
+ */
+export type ActiveIngressCapability = {
+    readonly [ACTIVE_INGRESS_BRAND]: true;
+    /** Motivo declarado de la concesión; solo para trazas internas. */
+    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.
+ */
+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. */
+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. */
+export type IngressPolicy = {
+    readonly graph: ResolvedGraphConfig;
+    readonly allowList: readonly string[];
+    readonly capability?: ActiveIngressCapability;
+};
+/**
+ * Decide la ruta de una tarea. Pura y determinista.
+ *
+ * Precedencia: `gate-closed` → `kill-switch` → `graph-disabled` →
+ * `not-allow-listed`, es decir, el bloqueo más externo primero.
+ */
+export declare function decideIngress(policy: IngressPolicy, taskID: string): IngressDecision;
+/** Clase de fallo del ingress. Nunca transporta payload del usuario. */
+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 = {
+    readonly kind: "legacy";
+    readonly reason: IngressLegacyReason;
+} | {
+    readonly kind: "accepted";
+    readonly runID: string;
+    readonly step: RuntimeStepOutcome;
+} | {
+    readonly kind: "revision";
+    readonly runID: string;
+    readonly plan: RevisionPlan;
+} | {
+    readonly kind: "reassigned";
+    readonly runID: string;
+    readonly reviewerID: string;
+    readonly rerunImplementation: false;
+} | {
+    readonly kind: "cancelled";
+    readonly runID: string;
+    readonly cancelledNodeIDs: readonly string[];
+    readonly abortNodeIDs: readonly string[];
+} | {
+    readonly kind: "error";
+    readonly code: IngressErrorCode;
+    readonly detail: string;
+};
+/** Petición de rechazo de revisión: ancla la revisión en curso. */
+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. */
+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í. */
+export type GraphIngressDeps = {
+    readonly policy: IngressPolicy;
+    readonly journal: GraphJournal;
+    readonly lease: WorkspaceLease;
+    readonly effects: GraphEffectExecutor;
+    readonly holder: string;
+    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.
+ */
+export interface GraphIngress {
+    start(task: SddTask): Promise<IngressOutcome>;
+    resume(runID: string): Promise<IngressOutcome>;
+    reject(request: IngressRejectRequest): Promise<IngressOutcome>;
+    reassign(request: IngressReassignRequest): Promise<IngressOutcome>;
+    cancel(runID: string): Promise<IngressOutcome>;
+}
+export declare function createGraphIngress(deps: GraphIngressDeps): GraphIngress;
+export {};
+//# sourceMappingURL=graphIngress.d.ts.map

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

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

package/dist/orchestrator/graphShadow.d.ts

@@ -0,0 +1,121 @@
+import { type GraphEventV1, type GraphSpecV1 } from "../graph/schema";
+import type { GraphState } from "../graph/types";
+import type { LegacyExecutionTraceV1 } from "../plugin/graphShadowIngress";
+import type { ShadowRunSummary } from "./shadowComparator";
+/**
+ * **Espejo shadow sin efectos** (GE-043): compila el trace productivo de
+ * GE-042 a un `GraphSpecV1` validado, sintetiza el journal que ese run habría
+ * escrito y lo pliega con el **reducer real** para producir el
+ * `ShadowRunSummary` que consume el comparador de paridad (GE-044).
+ *
+ * El run legacy se ejecuta **una sola vez**: este módulo no tiene superficie de
+ * ejecución. No importa el puerto `GraphEffectExecutor`, ni el adaptador de
+ * sesión de opencode, ni el runtime, ni ningún origen de I/O, reloj o azar; el
+ * único builtin alcanzable es `node:crypto` para el cómputo de digests. Por eso
+ * el espejo no puede duplicar el trabajo que observa: no tiene con qué.
+ *
+ * **Qué prueba realmente cada dimensión de paridad** está declarado en
+ * `SHADOW_MIRROR_PROVENANCE`, y esa distinción es deliberada: certificar
+ * paridad sobre dimensiones que el espejo se limita a copiar del trace no
+ * probaría nada. Solo el nº de fixes se **recomputa** desde el grafo compilado
+ * (divergencia demostrable); el orden de nodos y los roles pasan por el
+ * compilador y validador del spec —que rechaza traces irrepresentables como
+ * `invalid-spec`— pero la compilación preserva ambos valores literalmente, así
+ * que la comparación no puede divergir (**compiled**); el estado terminal lo
+ * **valida** el reducer; el modelo y el outcome se **transportan** sin
+ * inspección.
+ *
+ * Los artefactos del journal espejo son **placeholders sintéticos y
+ * deterministas** (`shadow://<run>/<node>`): el espejo no tiene contenido que
+ * digerir y el comparador no contrasta artefactos. El esquema `shadow://` los
+ * hace inconfundibles con evidencia real.
+ *
+ * Módulo **puro y determinista**: el mismo trace produce el mismo spec, el
+ * mismo journal y el mismo resumen.
+ */
+/** Qué prueba el espejo sobre una dimensión de paridad concreta. */
+export type ShadowParityProvenance = "recomputed" | "compiled" | "validated" | "carried";
+/**
+ * Procedencia **demostrada** de cada dimensión que compara GE-044. Acota qué
+ * puede afirmar la certificación de shadow (GE-046) y qué no.
+ *
+ * - "recomputed": el espejo calcula el valor de forma independiente desde el
+ *   spec compilado. La comparación PUEDE divergir → apta para conjunto crítico.
+ *   Un test de alcanzabilidad en `demonstrated-divergence-provenance.test.ts`
+ *   DEMUESTRA la divergencia atravesando el pipeline completo para cada código
+ *   así clasificado. Si no se puede producir, no es "recomputed".
+ * - "compiled": la dimensión pasa por `GraphSpecV1Schema.parse` y
+ *   `validateGraphSpec`, que rechazan traces irrepresentables (ids duplicados,
+ *   reviewer sin implementer, ciclos → `invalid-spec`). La comparación NO
+ *   puede divergir porque la compilación preserva el valor idéntico, pero un
+ *   trace irrepresentable impide el espejo por completo. Esta es la
+ *   **representabilidad** sobre la que se apoya R6.
+ * - "validated": el reducer valida la secuencia, pero ambos lados proyectan el
+ *   mismo campo del trace. La comparación NO puede divergir.
+ * - "carried": ambos lados copian el mismo campo del trace sin que nadie lo
+ *   inspeccione. La comparación NO puede divergir.
+ *
+ * Invariante: solo los códigos con procedencia "recomputed" pueden incluirse
+ * en `criticalDivergenceCodes` de la política soak, porque solo esos producen
+ * una comparación independiente. Los códigos "compiled", "validated" o
+ * "carried" no pueden divergir en la comparación; incluirlos inflaría la
+ * cobertura declarada sin medir nada real.
+ */
+export declare const SHADOW_MIRROR_PROVENANCE: {
+    readonly status: "validated";
+    readonly order: "compiled";
+    readonly roles: "compiled";
+    readonly models: "carried";
+    readonly fixes: "recomputed";
+    readonly outcome: "carried";
+};
+/** Motivo tipado por el que un trace no produce espejo. */
+export type ShadowMirrorErrorCode = "invalid-trace" | "invalid-spec" | "illegal-sequence" | "mirror-error";
+/** Error tipado del espejo. Nunca escapa de la fachada (`graphFacade`). */
+export declare class ShadowMirrorError extends Error {
+    readonly code: ShadowMirrorErrorCode;
+    readonly detail: string;
+    constructor(code: ShadowMirrorErrorCode, detail: string);
+}
+/** Espejo completo: evidencia intermedia más el resumen comparable. */
+export type ShadowMirror = {
+    readonly spec: GraphSpecV1;
+    readonly specDigest: string;
+    readonly journal: readonly GraphEventV1[];
+    readonly state: GraphState;
+    readonly summary: ShadowRunSummary;
+};
+/**
+ * Compila el trace a un DAG lineal: cada nodo depende del anterior y cada
+ * reviewer revisa el implementer que le precede. Un trace que el grafo no puede
+ * representar (reviewer sin implementer previo, ids duplicados, ciclo) es
+ * rechazado por el validador real como `invalid-spec`, antes de reducir nada.
+ */
+export declare function compileShadowSpec(trace: LegacyExecutionTraceV1): GraphSpecV1;
+/**
+ * Sintetiza el journal que el run observado habría escrito: apertura, despacho
+ * y recibo por nodo en orden, y el evento terminal reclamado. `errorClass`
+ * distingue el recibo: ausente es éxito, `cancelled` cancela y el resto falla.
+ */
+export declare function mirrorJournal(spec: GraphSpecV1, trace: LegacyExecutionTraceV1): GraphEventV1[];
+/**
+ * Pliega el journal espejo con el reducer real. Una secuencia que el reducer
+ * rechaza —un run que se dice completado con un nodo fallido, un despacho sobre
+ * una dependencia no satisfecha— es `illegal-sequence`: el grafo no pudo haber
+ * producido esa ejecución, y esa es justamente la evidencia que aporta.
+ */
+export declare function reduceMirror(spec: GraphSpecV1, journal: readonly GraphEventV1[]): GraphState;
+/**
+ * Proyección 1:1 del **lado legacy**: lo que el run observado afirma de sí
+ * mismo, sin pasar por el grafo. Es el término que el comparador contrasta
+ * contra el espejo.
+ */
+export declare function projectLegacySummary(trace: LegacyExecutionTraceV1): ShadowRunSummary;
+/**
+ * Construye el espejo sin efectos de una ejecución legacy observada. Lanza
+ * `ShadowMirrorError` cuando el grafo no puede representar o reproducir el
+ * trace; la fachada (`graphFacade`) contiene ese fallo para que nunca alcance
+ * al camino legacy.
+ */
+export declare function mirrorLegacyExecution(trace: LegacyExecutionTraceV1): ShadowMirror;
+//# sourceMappingURL=graphShadow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphShadow.d.ts","sourceRoot":"","sources":["../../src/orchestrator/graphShadow.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,oEAAoE;AACpE,MAAM,MAAM,sBAAsB,GAC9B,YAAY,GACZ,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,wBAAwB;qBAC3B,WAAW;oBACZ,UAAU;oBACV,UAAU;qBACT,SAAS;oBACV,YAAY;sBACV,SAAS;CAGnB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,cAAc,GACd,kBAAkB,GAClB,cAAc,CAAC;AAEnB,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAKtD;CACF;AAED,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAaF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,WAAW,CAqC5E;AAkBD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,sBAAsB,GAC5B,YAAY,EAAE,CAmEhB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,UAAU,CAeZ;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAYlB;AA8BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,GAC5B,YAAY,CAcd"}

package/dist/orchestrator/ledger.d.ts

@@ -40,8 +40,20 @@ export declare function latestStatuses(entries: readonly LedgerEntry[]): Map<str
 export declare function isTaskComplete(entries: readonly LedgerEntry[], taskID: string): boolean;
 /** Conjunto de `taskID` cuyo estado más reciente es `complete`. Puro. */
 export declare function completedTaskIDs(entries: readonly LedgerEntry[]): Set<string>;
-/** Lee y parsea el ledger; `[]` si el fichero no existe. */
+/**
+ * Lee y parsea el ledger; `[]` si el fichero no existe.
+ *
+ * @deprecated As authority source — legacy SDD authority (progress.md as the
+ * task-completion ledger) will be removed in v1.0.0. The pure parsing
+ * functions (`parseLedger`, `parseLedgerLine`, etc.) remain available for
+ * terminal import into graph authority. See docs/guide/graph-migration.md.
+ */
 export declare function readLedger(storage: StorageProvider, path?: string): Promise<LedgerEntry[]>;
-/** Añade una entrada al ledger (crea el fichero si no existe). */
+/**
+ * Añade una entrada al ledger (crea el fichero si no existe).
+ *
+ * @deprecated Legacy SDD authority (progress.md as the task-completion ledger)
+ * will be removed in v1.0.0. See docs/guide/graph-migration.md.
+ */
 export declare function appendLedgerEntry(storage: StorageProvider, entry: LedgerEntry, path?: string): Promise<void>;
 //# sourceMappingURL=ledger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ledger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AAEH,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,mCAAmC,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAM5D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAgBrE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CASvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAM3B;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAET;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ7E;AAED,4DAA4D;AAC5D,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;AAED,kEAAkE;AAClE,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ledger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AAEH,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,mCAAmC,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAM5D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAgBrE;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CASvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAM3B;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAET;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ7E;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,MAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf"}

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

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

package/dist/orchestrator/roles.d.ts

@@ -16,10 +16,10 @@ export declare const AgentRoleProfileSchema: z.ZodObject<{
     roleID: z.ZodString;
     opencodeAgent: z.ZodOptional<z.ZodString>;
     defaultTier: z.ZodEnum<{
-        trivial: "trivial";
-        simple: "simple";
-        moderate: "moderate";
         hard: "hard";
+        moderate: "moderate";
+        simple: "simple";
+        trivial: "trivial";
     }>;
     minReasoningTier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
     minCodeQualityTier: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;

package/dist/orchestrator/sdd.d.ts

@@ -3,6 +3,41 @@ import { type ArtifactManifest, type ContextRef, type PrivacyClass } from "../co
 import type { TaskSignals } from "../router/types";
 import type { StorageProvider } from "../storage/provider";
 import { type CoordinatorDeps, type RoleTaskResult } from "./coordinator";
+/**
+ * Operator-facing deprecation notice for legacy SDD authority.
+ *
+ * Legacy authority means using `progress.md` as the authoritative ledger for
+ * task completion in the SDD loop (`runSddTask` / `runSddPlan`). The ability
+ * to **import** an existing `progress.md` into graph authority is NOT
+ * deprecated and will remain available after v1.0.0.
+ *
+ * **Reachability note (2026-08-23):** As of this date, neither `runSddTask`
+ * nor `runSddPlan` has a production caller — the two entry points
+ * (`src/index.ts`, `src/cli.ts`) do not import them. No operator will see
+ * this warning today. The warning exists as defence-in-depth: if a future
+ * change wires the SDD loop back into a production path, reachability and
+ * operator notification arrive together. An invariant test in
+ * `tests/orchestrator/sdd-unreachability.test.ts` enforces this.
+ */
+export declare const LEGACY_AUTHORITY_DEPRECATION_WARNING: string;
+/**
+ * Emits the deprecation warning once per process when legacy SDD authority is
+ * exercised. The `warn` callback defaults to `console.warn`; tests inject a
+ * spy to verify the seam reaches the operator channel.
+ *
+ * Currently no production code path calls this function — it is defence-in-
+ * depth so that if `runSddTask` / `runSddPlan` are wired back into a
+ * production caller, the operator is immediately notified of the deprecation.
+ *
+ * @returns `true` if the warning was emitted on this call, `false` if it was
+ * already emitted in a prior call (once-only guard).
+ */
+export declare function emitLegacyAuthorityWarning(warn?: (message: string) => void): boolean;
+/**
+ * Resets the once-only deprecation state. **Test-only** — production code must
+ * never call this; the flag is per-process by design.
+ */
+export declare function _resetLegacyAuthorityWarning(): void;
 /**
  * Loop de **subagent-driven-development** (SDD), adaptado de obra/superpowers al
  * boundary de openteam. Por cada tarea:
@@ -59,6 +94,11 @@ export type SddDeps = CoordinatorDeps & {
     maxFixRounds?: number;
     parentSessionID?: string;
     directory?: string;
+    /**
+     * Callback for operator-facing warnings (defaults to `console.warn`).
+     * Used by the legacy authority deprecation to reach the operator channel.
+     */
+    onWarning?: (message: string) => void;
 };
 export type SddTaskStatus = "complete" | "failed" | "skipped";
 export type SddTaskOutcome = {
@@ -115,12 +155,26 @@ export declare function extractResponseText(response: unknown): string;
  * propio intérprete vía `deps.interpretReview`.
  */
 export declare function defaultReviewVerdict(review: RoleTaskResult): ReviewVerdict;
-/** Ejecuta una única tarea del loop SDD (con reanudación desde el ledger). */
+/**
+ * Ejecuta una única tarea del loop SDD (con reanudación desde el ledger).
+ *
+ * @deprecated Legacy SDD authority (progress.md as task-completion ledger)
+ * will be removed in v1.0.0. Use graph authority instead.
+ * See docs/guide/graph-migration.md.
+ * **Note:** This function currently has no production caller — it is only
+ * invoked by tests. The deprecation warning is defence-in-depth.
+ */
 export declare function runSddTask(task: SddTask, deps: SddDeps): Promise<SddTaskOutcome>;
 /**
  * Ejecuta un plan SDD **en orden** (las tareas son secuenciales por diseño; la
  * paralelización de tareas independientes es otra capa). Reanuda saltando las ya
  * completas y resume el resultado por estado.
+ *
+ * @deprecated Legacy SDD authority (progress.md as task-completion ledger)
+ * will be removed in v1.0.0. Use graph authority instead.
+ * See docs/guide/graph-migration.md.
+ * **Note:** This function currently has no production caller — it is only
+ * invoked by tests. The deprecation warning is defence-in-depth.
  */
 export declare function runSddPlan(tasks: readonly SddTask[], deps: SddDeps): Promise<SddPlanResult>;
 //# sourceMappingURL=sdd.d.ts.map

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

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

package/dist/orchestrator/sddCompiler.d.ts

@@ -33,8 +33,12 @@ export type SddCompileOptions = {
     /** Rondas de revisión revise/re-review a expandir (def: 1). */
     revisionRounds?: number;
 };
-/** Digest SHA-256 estable del spec compilado (reproducible). */
-export declare function graphSpecDigest(spec: GraphSpecV1): string;
+/**
+ * Digest canónico del spec. Reexportado desde `graph/ids` para no romper a los
+ * consumidores del compilador; la implementación vive en la capa de grafo
+ * porque el espejo shadow la necesita sin alcanzar este módulo.
+ */
+export { graphSpecDigest } from "../graph/ids";
 /**
  * Compila una tarea SDD legacy a un `GraphSpecV1` validado. Lanza
  * `SddCompileError` ante rol/autor/spec inválidos, siempre **antes** de

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

@@ -1 +1 @@
-{"version":3,"file":"sddCompiler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/sddCompiler.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,oBAAoB,GACpB,cAAc,CAAC;AAEnB,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM;CAMtD;AAED,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAuCF,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA0Db"}
+{"version":3,"file":"sddCompiler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/sddCompiler.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,oBAAoB,GACpB,cAAc,CAAC;AAEnB,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAKpD;CACF;AAED,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAwBF;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA0Db"}

package/dist/orchestrator/worktreeAdapter.d.ts

@@ -0,0 +1,39 @@
+import type { ExecLike } from "../local/foundry-local";
+/** Taxonomía cerrada de errores del adapter de worktrees. */
+export type WorktreeErrorCode = "invalid-run" | "git-failed" | "corrupt-list";
+/** Error tipado de una operación inválida del ciclo de vida del worktree. */
+export declare class WorktreeError extends Error {
+    readonly code: WorktreeErrorCode;
+    readonly detail: string;
+    constructor(code: WorktreeErrorCode, detail: string);
+}
+/** Información observada de un worktree del namespace de openteam. */
+export type WorktreeInfo = {
+    readonly runID: string;
+    /** Ruta reportada por git (separadores `/`, usable por `node:fs`). */
+    readonly path: string;
+    readonly head: string | undefined;
+    readonly detached: boolean;
+    readonly locked: boolean;
+};
+/** Configuración inyectada del adapter. */
+export type WorktreeAdapterConfig = {
+    readonly exec: ExecLike;
+    /** Working tree principal del repositorio (destino de `git -C`). */
+    readonly repoRoot: string;
+    /** Directorio raíz del namespace de worktrees por run. */
+    readonly worktreesDir: string;
+};
+/** Contrato del ciclo de vida idempotente y crash-safe de worktrees. */
+export interface WorktreeAdapter {
+    /** Crea (o adopta) el worktree del run; reconstruye tras crash. */
+    create(runID: string): Promise<WorktreeInfo>;
+    /** Lista los worktrees del namespace de openteam. */
+    list(): Promise<WorktreeInfo[]>;
+    /** Elimina el worktree del run (idempotente). */
+    remove(runID: string): Promise<void>;
+    /** Poda entradas administrativas huérfanas (idempotente). */
+    prune(): Promise<void>;
+}
+export declare function createWorktreeAdapter(config: WorktreeAdapterConfig): WorktreeAdapter;
+//# sourceMappingURL=worktreeAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktreeAdapter.d.ts","sourceRoot":"","sources":["../../src/orchestrator/worktreeAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAqCvD,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,YAAY,GAAG,cAAc,CAAC;AAE9E,6EAA6E;AAC7E,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAKlD;CACF;AAED,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,6DAA6D;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAuFD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CA8IjB"}