@jmanuelcorral/openteam 0.2.0 → 0.2.2

package/dist/orchestrator/sdd.d.ts

@@ -1,180 +0,0 @@
-import type { OpenTeamConfig } from "../config/schema";
-import { type ArtifactManifest, type ContextRef, type PrivacyClass } from "../context/schema";
-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:
- *
- *   1. Reanuda desde el ledger: si la tarea ya está `complete`, la salta.
- *   2. Persiste un **manifiesto redactado** de inputs del brief (referencia +
- *      digest, nunca el brief crudo) y entrega el brief íntegro al implementer
- *      **en memoria** vía el prompt (higiene de contexto: el implementer recibe
- *      solo su tarea, no el historial acumulado).
- *   3. Despacha el **implementer** con el brief.
- *   4. Despacha el **reviewer** (rol con alto code-quality) para revisar el
- *      cambio; la generación del diff vive en el propio agente reviewer.
- *   5. Si el veredicto pide arreglos, despacha **UN** fix subagent con TODOS los
- *      findings (no uno por finding), con un número de rondas acotado.
- *   6. Escribe el resultado en el ledger durable.
- *
- * Es una capa de orquestación **inyectable y determinista**: cliente opencode,
- * storage, reloj, generadores de id y el intérprete de review se inyectan, así
- * que se prueba con fakes/memory provider. No hace I/O de git ni shell: los
- * artefactos persistidos son metadatos **redactados** (nunca prompts ni la
- * respuesta cruda del modelo).
- */
-/** Directorio de artefactos del loop SDD (estado derivado). */
-export declare const DEFAULT_SDD_WORKSPACE_DIR = ".opencode/openteam/sdd";
-/** Rol reviewer por defecto. */
-export declare const DEFAULT_REVIEWER_ROLE_ID = "reviewer";
-export type SddTask = {
-    /** Id estable y sin `:` (kebab-case) usado para ledger y artefactos. */
-    id: string;
-    /** Rol que implementa (y arregla) la tarea. */
-    implementerRoleID: string;
-    /** Título humano corto. */
-    title: string;
-    /** Brief accionable de la tarea (cuerpo del prompt del implementer). */
-    brief: string;
-    /** Señales de routing para la tarea. */
-    task: TaskSignals;
-    /** Rol reviewer específico (sobreescribe `deps.reviewerRoleID`). */
-    reviewerRoleID?: string;
-};
-export type ReviewVerdict = {
-    needsFix: boolean;
-    /** Resumen redactado de findings para el fix dispatch. */
-    findings?: string;
-};
-export type SddDeps = CoordinatorDeps & {
-    storage: StorageProvider;
-    config: OpenTeamConfig;
-    workspaceDir?: string;
-    ledgerPath?: string;
-    reviewerRoleID?: string;
-    interpretReview?: (review: RoleTaskResult) => ReviewVerdict;
-    /** Máximo de rondas de fix+re-review (def: 1). */
-    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 = {
-    taskID: string;
-    status: SddTaskStatus;
-    implement?: RoleTaskResult;
-    review?: RoleTaskResult;
-    fixes: RoleTaskResult[];
-};
-export type SddPlanResult = {
-    outcomes: SddTaskOutcome[];
-    completed: string[];
-    failed: string[];
-    skipped: string[];
-};
-/**
- * Texto **completo** del brief en memoria para el prompt del implementer.
- *
- * GE-007 congela que el brief íntegro es un input de dispatch **en memoria**
- * (byte a byte), nunca solo una ruta a fichero; un prompt path-only es una
- * regresión funcional. GE-038 lo cablea al text part de `session.prompt`. Puro:
- * no persiste nada.
- */
-export declare function implementerBriefInput(task: SddTask): string;
-/** Opciones del manifiesto redactado de inputs del brief. */
-export type BriefManifestOptions = {
-    /** Clase de privacidad del manifiesto (def: `internal`). */
-    privacyClass?: PrivacyClass;
-    /** Referencia estable del brief cuando persiste como artefacto revalidable. */
-    briefRef?: ContextRef;
-};
-/** Manifiesto redactado del brief más su elegibilidad para shadow. */
-export type BriefManifestResult = {
-    manifest: ArtifactManifest;
-    /** Solo elegible si **cada** input seleccionado tiene referencia estable. */
-    shadowEligible: boolean;
-};
-/**
- * Construye el manifiesto **redactado** de inputs del brief (GE-007).
- *
- * Sustituye el fichero de brief crudo por una referencia/digest ordenada:
- * versión, taskID, clase de privacidad y una entrada por input con digest
- * SHA-256 y tamaño en bytes; nunca título, extracto, prompt ni salida del
- * modelo. Un brief sin referencia estable produce una entrada solo-digest y
- * queda **inelegible** para shadow (no se fabrica una referencia). Puro y
- * determinista: solo cómputo de digest, sin I/O.
- */
-export declare function briefInputManifest(task: SddTask, options?: BriefManifestOptions): BriefManifestResult;
-/** Extrae texto de una respuesta opaca del modelo (best-effort). Puro. */
-export declare function extractResponseText(response: unknown): string;
-/**
- * Veredicto por defecto: escanea el texto de la review en busca de marcadores de
- * severidad. Conservador y determinista; los llamadores pueden inyectar su
- * 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).
- *
- * @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 +0,0 @@
-{"version":3,"file":"sdd.d.ts","sourceRoot":"","sources":["../../src/orchestrator/sdd.ts"],"names":[],"mappings":"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"}

package/dist/storage/graph/migrateLegacyBriefs.d.ts

@@ -1,32 +0,0 @@
-import type { StorageProvider } from "../provider";
-/** Plan (dry-run) de migración: solo rutas y conteo, nunca contenido. */
-export type BriefMigrationPlan = {
-    readonly workspaceDir: string;
-    readonly briefPaths: readonly string[];
-    readonly count: number;
-};
-/** Resultado de aplicar la migración: manifiestos escritos y conteo. */
-export type BriefMigrationReport = {
-    readonly workspaceDir: string;
-    readonly migrated: readonly string[];
-    readonly count: number;
-};
-/** Código de fallo fail-closed de la migración. */
-export type MigrationErrorCode = "unreadable" | "unknown-schema";
-/** Error tipado de una migración abortada (deja el crudo intacto). */
-export declare class MigrationError extends Error {
-    readonly code: MigrationErrorCode;
-    readonly path: string;
-    constructor(code: MigrationErrorCode, path: string);
-}
-/**
- * Planifica la migración (dry-run). Lista los briefs crudos y devuelve sus
- * rutas y conteo; **no** lee ni transporta el cuerpo de ningún brief.
- */
-export declare function planLegacyBriefMigration(storage: StorageProvider, workspaceDir: string): Promise<BriefMigrationPlan>;
-/**
- * Aplica la migración: por cada brief crudo escribe el manifiesto redactado y
- * borra el crudo (sin backup). Idempotente y fail-closed.
- */
-export declare function applyLegacyBriefMigration(storage: StorageProvider, workspaceDir: string): Promise<BriefMigrationReport>;
-//# sourceMappingURL=migrateLegacyBriefs.d.ts.map

package/dist/storage/graph/migrateLegacyBriefs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrateLegacyBriefs.d.ts","sourceRoot":"","sources":["../../../src/storage/graph/migrateLegacyBriefs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA4BnD,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEjE,sEAAsE;AACtE,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAKjD;CACF;AA6CD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAuB/B"}