oficina-opencode 0.0.0-stage → 2.0.0

package/dist/core/factory.js

@@ -0,0 +1,243 @@
+/**
+ * Factory: creación de roles que el catálogo no cubre.
+ *
+ * ## Por qué una factory y no un prompt genérico
+ *
+ * Un rol fabricado tiene que ser **indistinguible en calidad** de uno del
+ * catálogo. Si el catálogo de agency-agents tiene 306 agentes con briefing de
+ * 10 secciones, un rol fabricado con un prompt de 5 líneas se nota: es
+ * monótono, no tiene criterio propio, y el resto de la malla lo trata como
+ * un agente de segunda.
+ *
+ * Por eso la factory emite **exactamente la misma estructura** que agency-agents:
+ * Identity & Memory, Core Mission, Critical Rules, Technical Deliverables,
+ * Workflow Process, Communication Style, Learning & Memory, Success Metrics,
+ * Advanced Capabilities. El parser del catálogo no distingue el origen.
+ *
+ * ## Qué hace de un briefing bueno
+ *
+ * No es largo: es **específico**. Un briefing que dice "sos un experto en X"
+ * no sirve para nada. Uno que dice qué mirás primero, qué error típico cometés
+ * y qué entregás, sirve.
+ */
+import { capabilityTokens } from "./catalog.js";
+import { shortId } from "./fsx.js";
+export const FACTORY_DISPLAY_FALLBACK = "Especialista";
+/**
+ * Template de un agente fabricado.
+ *
+ * La estructura es la de agency-agents a propósito: mismo orden, mismas
+ * secciones, mismo nivel de especificidad.
+ */
+export const FACTORY_PROMPT_TEMPLATE = `# {{display_name}} Agent Personality
+
+You are **{{display_name}}**, {{role_phrase}} {{mission_phrase}}
+
+## Your Identity & Memory
+
+- **Role**: {{role_phrase}}
+- **Personality**: {{personality}}
+- **Memory**: {{memory}}
+- **Experience**: {{experience}}
+
+## Your Core Mission
+
+{{core_mission}}
+
+## Critical Rules You Must Follow
+
+{{critical_rules}}
+
+## Your Technical Deliverables
+
+{{technical_deliverables}}
+
+## Your Workflow Process
+
+### Step 1: Understand the Terrain
+{{step_1}}
+
+### Step 2: Decide the Approach
+{{step_2}}
+
+### Step 3: Execute Within Scope
+{{step_3}}
+
+### Step 4: Verify and Hand Off
+{{step_4}}
+
+## Your Communication Style
+
+{{communication_style}}
+
+## Learning & Memory
+
+Remember and build rigor in:
+{{learning}}
+
+## Your Success Metrics
+
+You're successful when:
+{{success_metrics}}
+
+## Advanced Capabilities
+
+{{advanced_capabilities}}
+
+## Context of This Run
+
+{{objective}}
+`;
+/** Reglas base que todos los agentes fabricados comparten. */
+const BASE_RULES = [
+    "**Scope is a hard boundary, not a suggestion.** Touch only what your card authorizes. The engine blocks the rest.",
+    "**No evidence, no work.** A claim without the real command output is a hypothesis.",
+    "**Never review your own work.** Another agent does that, and the engine will not let you.",
+    "**Ask before you guess.** If the context you need is not in your briefing, request it on the bus.",
+    "**Say what you did not do.** A handoff that hides its gaps is worse than one that names them.",
+];
+/**
+ * Fabrica una ficha a partir del template.
+ *
+ * El prompt generado no es genérico: incluye las capabilities concretas, el
+ * scope, el objetivo de la corrida y los modos de fallo del rol. Un agente
+ * fabricado con contexto es usable; uno con un prompt vacío no sirve.
+ */
+export function createFicha(input) {
+    const displayName = input.displayName ?? titleize(input.role);
+    const capabilities = input.capabilities.length > 0
+        ? input.capabilities
+        : [...capabilityTokens(input.role)];
+    const mission = input.mission ?? `Resolver el trabajo que se te asigne en esta corrida.`;
+    const failureModes = input.failureModes ?? defaultFailureModes(input.role);
+    const source = {
+        kind: "factory",
+        sourcePrompt: renderPrompt(input, displayName, capabilities, mission, failureModes),
+        vibe: `Rol fabricado para esta corrida: ${capabilities.slice(0, 3).join(", ")}.`,
+        missions: [mission],
+        deliverables: [
+            "Un entregable concreto con el detalle suficiente para que otro agente lo retome sin preguntar nada",
+            "Evidencia ejecutable de lo que se hizo",
+        ],
+        rules: BASE_RULES,
+    };
+    return {
+        id: shortId("e"),
+        role: input.role,
+        displayName,
+        source,
+        capabilities,
+        tools: ["read", "glob", "grep", "edit", "write", "bash", "task"],
+        scope: {
+            mayTouch: input.scope?.mayTouch ?? ["**"],
+            forbidden: input.scope?.forbidden ?? ["**/*.env", "**/*.env.*", "**/.env"],
+        },
+        canDelegate: input.canDelegate ?? false,
+        delegateBudget: input.delegateBudget ?? 0,
+        peers: input.peers ?? [],
+        mustNot: [
+            "no editar archivos fuera de may_touch",
+            "no tocar archivos de forbidden",
+            "no aprobar tu propio trabajo",
+            "no declarar DONE sin handoff.md y evidence.md",
+            "no editar otros agentes' artifacts",
+        ],
+        onFinish: "idle-join",
+        escalateTo: input.escalateTo ?? "integrator",
+    };
+}
+/** Cómo suena un agente con un rol mal definido. */
+function defaultFailureModes(role) {
+    return [
+        `Actuar sobre supuestos en vez de sobre lo que el briefing dice: el rol "${role}" tiene un alcance que no se negocia`,
+        "Reportar avance sin evidencia: la card vuelve al trabajo igual",
+    ];
+}
+function renderPrompt(input, displayName, capabilities, mission, failureModes) {
+    const rolePhrase = `un especialista en ${capabilities.join(", ") || input.role}`;
+    const missionPhrase = `que resuelve ${mission.toLowerCase()}.`;
+    return FACTORY_PROMPT_TEMPLATE.replaceAll("{{display_name}}", displayName)
+        .replaceAll("{{role_phrase}}", rolePhrase)
+        .replaceAll("{{mission_phrase}}", missionPhrase)
+        .replaceAll("{{personality}}", "Directo y sin rodeos. Preferís la solución más simple que cumple el requisito, y decís explícitamente cuando una regla no aplica.")
+        .replaceAll("{{memory}}", "Trackeás las decisiones ya tomadas en la corrida, los archivos que ya existen y las restricciones descubiertas, para no repetir trabajo ni contradecir lo anterior.")
+        .replaceAll("{{experience}}", `Trabajo de punta a punta en ${capabilities.join(", ") || input.role}: explorar, decidir, implementar y verificar, siempre dentro de un scope declarado.`)
+        .replaceAll("{{core_mission}}", [
+        `### ${titleize(input.role)}`,
+        `- Ejecutá la card asignada con foco en: ${capabilities.join(", ") || "el objetivo de la card"}`,
+        "- Dejá el resultado en el formato que el briefing pide: handoff y evidencia",
+        "- Pedí ayuda en el bus en cuanto detectes que la tarea se sale de tu dominio",
+    ].join("\n"))
+        .replaceAll("{{critical_rules}}", BASE_RULES.map((r, i) => `${i + 1}. ${r}`).join("\n"))
+        .replaceAll("{{technical_deliverables}}", [
+        "### Handoff",
+        "- Qué se hizo, en concreto y con paths de archivo",
+        "- Qué decisiones se tomaron y por qué",
+        "- Qué quedó afuera y qué necesita el siguiente",
+        "",
+        "### Evidencia",
+        "- La salida real de los comandos ejecutados, con su exit code",
+        "- Qué quedó sin verificar y por qué",
+    ].join("\n"))
+        .replaceAll("{{step_1}}", "Leé el briefing completo. Identificá lo que no sabés y pedilo por el bus antes de tocar nada.")
+        .replaceAll("{{step_2}}", "Decidí el enfoque más simple que cumple los criterios de aceptación. Anotá la decisión en el handoff.")
+        .replaceAll("{{step_3}}", "Implementá dentro del territorio declarado. Si el scope no alcanza para la solución, pedí ampliación — no te la-expiendas.")
+        .replaceAll("{{step_4}}", "Correr los comandos, pegar la salida real, escribir el handoff y entregar la card.")
+        .replaceAll("{{communication_style}}", [
+        '- Arrancás por lo concreto: qué vas a hacer, en qué archivos, y con qué criterio.',
+        "- Cuando algo no cierra, decís exactamente qué falta y a quién le corresponde, sin rodeos.",
+        "- No decís «está listo» sin el comando que lo demuestra.",
+    ].join("\n"))
+        .replaceAll("{{learning}}", [
+        `- Los patrones de ${capabilities.slice(0, 2).join(" y ") || input.role} que se repiten en este repo`,
+        "- Las trampas del codebase que ya te comieron una vez",
+        "- Las decisiones que funcionararon y las que no, para no repetir el experimento",
+    ].join("\n"))
+        .replaceAll("{{success_metrics}}", [
+        `- Los criterios de aceptación de la card se cumplen y están demostrados con evidencia`,
+        `- El control de calidad de la card pasa en verde`,
+        "- Nadie tiene que volver a preguntar lo que dejaste escrito en el handoff",
+        "- No tocaste nada fuera de tu scope",
+    ].join("\n"))
+        .replaceAll("{{advanced_capabilities}}", [
+        "### Deep Work",
+        `- Aplicar ${capabilities.join(", ") || "el dominio del rol"} más allá del caso obvio: detectar el problema de raíz en vez de parchear el síntoma`,
+        "",
+        "### Failure Modes",
+        ...failureModes.map((f) => `- ${f}`),
+    ].join("\n"))
+        .replaceAll("{{objective}}", input.objective
+        ? `**Objetivo de la corrida:** ${input.objective}\n\n**Misión de tu card:** ${mission}\n`
+        : `**Misión de tu card:** ${mission}\n`);
+}
+/** "frontend-developer" → "Frontend Developer". */
+export function titleize(slug) {
+    return slug
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((w) => w[0].toUpperCase() + w.slice(1).toLowerCase())
+        .join(" ");
+}
+export class CandidateRegistry {
+    candidates = new Map();
+    record(role, at) {
+        const existing = this.candidates.get(role);
+        if (existing) {
+            existing.uses += 1;
+            existing.lastUsed = at;
+        }
+        else {
+            this.candidates.set(role, { role, uses: 1, lastUsed: at });
+        }
+    }
+    /** Roles que se usaron lo suficiente para promoverlos. */
+    promotable(threshold = 3) {
+        return [...this.candidates.values()]
+            .filter((c) => c.uses >= threshold)
+            .sort((a, b) => b.uses - a.uses);
+    }
+    all() {
+        return [...this.candidates.values()].sort((a, b) => b.uses - a.uses);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/factory.js.map

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

package/dist/core/fsx.d.ts

@@ -0,0 +1,39 @@
+/**
+ * IO atómico.
+ *
+ * El bus es append-only y varios agentes leen y escriben a la vez. Un rename
+ * POSIX/Windows sobre un archivo temporal es atómico: un lector ve el archivo
+ * viejo completo o el nuevo completo, nunca un JSON partido. Ese detalle es la
+ * diferencia entre "el bus anda" y "el bus anda y de vez en cuando traga un
+ * error de parse que nadie entiende".
+ */
+/** Escribe un archivo de forma atómica: tmp + rename. */
+export declare function writeAtomic(filePath: string, contents: string): Promise<void>;
+/** Escribe JSON de forma atómica, con newline final. */
+export declare function writeJsonAtomic(filePath: string, value: unknown): Promise<void>;
+/**
+ * Lee JSON. Devuelve `undefined` si el archivo no existe o está corrupto.
+ *
+ * Un archivo corrupto no debe tumbar la corrida: se loguea y se sigue con lo
+ * que hubiera. Perder un artefacto es malo; perder la oficina entera es peor.
+ */
+export declare function readJson<T>(filePath: string): Promise<T | undefined>;
+/** Lee texto. Devuelve `undefined` si no existe. */
+export declare function readText(filePath: string): Promise<string | undefined>;
+/** Existe sin lanzar. */
+export declare function exists(filePath: string): boolean;
+/** Crea un directorio recursivamente (idempotente). */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/** Lista archivos de un directorio. Devuelve `[]` si no existe. */
+export declare function listFiles(dirPath: string): Promise<string[]>;
+/** Lista subdirectorios de un directorio. Devuelve `[]` si no existe. */
+export declare function listDirs(dirPath: string): Promise<string[]>;
+/** Elimina un archivo si existe. */
+export declare function removeIfExists(filePath: string): Promise<void>;
+/** Id corto y único, con prefijo. */
+export declare function shortId(prefix: string): string;
+/** Hash estable de un string, para claves de idempotencia. */
+export declare function stableHash(input: string): string;
+/** Timestamp ISO. Inyectable para tests. */
+export declare function nowIso(clock?: () => number): string;
+//# sourceMappingURL=fsx.d.ts.map

package/dist/core/fsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsx.d.ts","sourceRoot":"","sources":["../../src/core/fsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,yDAAyD;AACzD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnF;AAED,wDAAwD;AACxD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAe1E;AAED,oDAAoD;AACpD,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO5E;AAED,yBAAyB;AACzB,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,uDAAuD;AACvD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOlE;AAED,yEAAyE;AACzE,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQjE;AAED,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED,qCAAqC;AACrC,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,GAAE,MAAM,MAAiB,GAAG,MAAM,CAE7D"}

package/dist/core/fsx.js

@@ -0,0 +1,113 @@
+/**
+ * IO atómico.
+ *
+ * El bus es append-only y varios agentes leen y escriben a la vez. Un rename
+ * POSIX/Windows sobre un archivo temporal es atómico: un lector ve el archivo
+ * viejo completo o el nuevo completo, nunca un JSON partido. Ese detalle es la
+ * diferencia entre "el bus anda" y "el bus anda y de vez en cuando traga un
+ * error de parse que nadie entiende".
+ */
+import { createHash, randomBytes } from "node:crypto";
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import path from "node:path";
+/** Escribe un archivo de forma atómica: tmp + rename. */
+export async function writeAtomic(filePath, contents) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.${randomBytes(6).toString("hex")}.tmp`;
+    try {
+        await fs.writeFile(tmp, contents, "utf8");
+        await fs.rename(tmp, filePath);
+    }
+    catch (err) {
+        await fs.rm(tmp, { force: true }).catch(() => { });
+        throw err;
+    }
+}
+/** Escribe JSON de forma atómica, con newline final. */
+export async function writeJsonAtomic(filePath, value) {
+    await writeAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+/**
+ * Lee JSON. Devuelve `undefined` si el archivo no existe o está corrupto.
+ *
+ * Un archivo corrupto no debe tumbar la corrida: se loguea y se sigue con lo
+ * que hubiera. Perder un artefacto es malo; perder la oficina entera es peor.
+ */
+export async function readJson(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return undefined;
+        if (err instanceof SyntaxError) {
+            // Archivo corrupto o escritura a medio hacer. Se aparta y se sigue.
+            const quarantine = `${filePath}.corrupt-${Date.now()}`;
+            await fs.rename(filePath, quarantine).catch(() => { });
+            return undefined;
+        }
+        throw err;
+    }
+}
+/** Lee texto. Devuelve `undefined` si no existe. */
+export async function readText(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return undefined;
+        throw err;
+    }
+}
+/** Existe sin lanzar. */
+export function exists(filePath) {
+    return existsSync(filePath);
+}
+/** Crea un directorio recursivamente (idempotente). */
+export async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+/** Lista archivos de un directorio. Devuelve `[]` si no existe. */
+export async function listFiles(dirPath) {
+    try {
+        return await fs.readdir(dirPath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+/** Lista subdirectorios de un directorio. Devuelve `[]` si no existe. */
+export async function listDirs(dirPath) {
+    try {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+/** Elimina un archivo si existe. */
+export async function removeIfExists(filePath) {
+    await fs.rm(filePath, { force: true, recursive: true });
+}
+/** Id corto y único, con prefijo. */
+export function shortId(prefix) {
+    return `${prefix}-${randomBytes(4).toString("hex")}`;
+}
+/** Hash estable de un string, para claves de idempotencia. */
+export function stableHash(input) {
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/** Timestamp ISO. Inyectable para tests. */
+export function nowIso(clock = Date.now) {
+    return new Date(clock()).toISOString();
+}
+//# sourceMappingURL=fsx.js.map

package/dist/core/fsx.js.map

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

package/dist/core/gates.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Gates: verificación ejecutable, no opinada.
+ *
+ * Un gate que dice "debería compilar" no es un gate. Acá se corren comandos
+ * de verdad, se captura la salida real y se decide por exit code. La salida
+ * se pega en el artefacto para que un humano pueda auditarla.
+ *
+ * Las 6 fases vienen de la skill `verification-loop`:
+ * build → typecheck → lint → test → security grep → diff review.
+ *
+ * Reglas de honestidad (no negociables):
+ * - Nunca PASS en una fase que no se corrió.
+ * - Nunca output inventado.
+ * - N/A siempre con motivo explícito.
+ * - Una fase aplicable en FAIL = gate FAIL. No se promedia.
+ */
+import type { GatePhase, GatePhaseResult, GateResult } from "./types.js";
+/** Configuración de un gate. */
+export interface Tooling {
+    packageManager: "npm" | "pnpm" | "yarn" | "bun" | null;
+    hasBuild: boolean;
+    hasTypecheck: boolean;
+    hasLint: boolean;
+    hasTest: boolean;
+    isPython: boolean;
+    isGo: boolean;
+    isRust: boolean;
+    hasGit: boolean;
+    /** Descripción de qué se detect��, para el informe. */
+    detected: string[];
+}
+export interface CommandRunner {
+    (command: string, args: string[], cwd: string): Promise<{
+        code: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/** Runner real por defecto. */
+export declare const defaultRunner: CommandRunner;
+/** Detecta el tooling del proyecto leyendo sus manifiestos. */
+export declare function detectTooling(projectRoot: string): Promise<Tooling>;
+/** Ejecuta una fase y clasifica el resultado. */
+export declare function runPhase(phase: GatePhase, command: string, args: string[], cwd: string, runner?: CommandRunner, timeoutNote?: string): Promise<GatePhaseResult>;
+/** Ejecuta las 6 fases técnicas. */
+export declare function runTechnicalGates(projectRoot: string, tooling: Tooling, runner?: CommandRunner, scope?: string[]): Promise<GatePhaseResult[]>;
+/**
+ * Patrones de detección de secretos.
+ *
+ * Se aplican EN CÓDIGO, no shelling out a `grep`.
+ *
+ * Razón: `grep` no existe en Windows (viene con Git Bash, no con el sistema),
+ * y un gate de seguridad que depende de una tool opcional del SO es un gate
+ * que falla en Windows por razones equivocadas. Además, escanear en código
+ * permite manejar rutas con espacios, filtrar binarios y controlar el ruido.
+ */
+export declare const SECRET_PATTERNS: {
+    label: string;
+    pattern: RegExp;
+}[];
+export interface SecretHit {
+    file: string;
+    line: number;
+    label: string;
+    match: string;
+    /** El valor, redactado. Los secretos no se imprimen completos. */
+    redacted: string;
+}
+/** Redacta un valor: solo se ven los primeros y últimos 4 caracteres. */
+export declare function redact(value: string): string;
+/**
+ * Escanea un directorio en busca de secretos.
+ *
+ * Devuelve los hits con el valor redactado. El valor crudo no sale de acá:
+ * un log de gate que imprime la credencial completa la acaba de filtrar.
+ */
+export declare function scanForSecrets(root: string, scope: string[]): Promise<SecretHit[]>;
+/**
+ * Corre el gate de seguridad.
+ *
+ * Distinto del gate técnico: audita trust boundaries y secretos. Un FAIL acá
+ * bloquea la card aunque el técnico esté verde.
+ */
+export declare function runSecurityGate(projectRoot: string, scope: string[], _runner?: CommandRunner): Promise<GatePhaseResult[]>;
+/** Consolida los resultados en un veredicto. */
+export declare function consolidate(cardId: string, technical: GatePhaseResult[], security: GatePhaseResult[]): GateResult;
+/**
+ * ¿La fase de tests corrió y pasó con al menos un test?
+ *
+ * Un gate que pasa con cero tests es un gate verde vacío. Los runners
+ * imprimen el conteo en formatos distintos ("# tests 5", "5 passed",
+ * "Tests: 5"), así que se buscan ambos órdenes.
+ */
+export declare function testsActuallyRan(technical: GatePhaseResult[]): boolean;
+/** Renderiza el gate como markdown para el artefacto. */
+export declare function renderGate(result: GateResult): string;
+//# sourceMappingURL=gates.d.ts.map

package/dist/core/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../src/core/gates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAqB,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG3F,gCAAgC;AAChC,MAAM,WAAW,OAAO;IACtB,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAA;IACtD,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,OAAO,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1G;AAED,+BAA+B;AAC/B,eAAO,MAAM,aAAa,EAAE,aAexB,CAAA;AAEJ,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8DzE;AAgCD,iDAAiD;AACjD,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,aAA6B,EACrC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAe1B;AAOD,oCAAoC;AACpC,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,aAA6B,EACrC,KAAK,GAAE,MAAM,EAAO,GACnB,OAAO,CAAC,eAAe,EAAE,CAAC,CA+E5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAa/D,CAAA;AAeD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAqCxF;AAmBD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,aAA6B,GACrC,OAAO,CAAC,eAAe,EAAE,CAAC,CAqC5B;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,UAAU,CAqBjH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,OAAO,CActE;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2CrD"}