@hoilab/ada-cli 0.84.21 → 0.84.22

package/dist/core/workflows/agent-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/core/workflows/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AgentRunner — subagente del Ada Intelligence Engine.\n *\n * Un subagente es una sesión del SDK (AgentSessionRuntime via createAgentSession)\n * con: modelo resuelto (spec/tier/fallback), tools configuradas, cwd (base o\n * worktree), instructions opcionales y límites (timeout, retries). El runner\n * captura la respuesta final, el structured output (schema typebox con fallback\n * a extracción de prosa) y el usage real (tokens/coste).\n *\n * La creación de la sesión es inyectable (createSession) para tests con fakes.\n */\n\nimport { createHash } from \"node:crypto\";\nimport type { TextContent } from \"@earendil-works/pi-ai\";\nimport type { TSchema } from \"typebox\";\nimport type { AgentSession, AgentSessionEvent } from \"../agent-session.ts\";\nimport type { ToolDefinition } from \"../extensions/types.ts\";\nimport type { AgentRunOptions, AgentRunResult, AgentUsage, WorkflowErrorCode } from \"./types.ts\";\nimport { WorkflowError } from \"./types.ts\";\nimport { createWorktree, finalizeWorktree, type Worktree } from \"./worktree.ts\";\n\nexport interface SubagentSession {\n\tsession: AgentSession;\n\tdispose(): void;\n\tgetUsage(): AgentUsage;\n}\n\nexport type CreateSubagentSession = (options: {\n\tcwd: string;\n\tagentDir: string;\n\tmodelSpec?: string;\n\ttools?: string[];\n\tcustomTools?: ToolDefinition[];\n\tsessionName?: string;\n\tinstructions?: string;\n}) => Promise<SubagentSession>;\n\nexport interface AgentRunnerOptions {\n\tagentDir: string;\n\tcreateSession: CreateSubagentSession;\n\t/** Limiter compartido del run (concurrency). */\n\tlimiter: <T>(fn: () => Promise<T>) => Promise<T>;\n\t/** Contador global de agentes del run (maxAgents). */\n\tagentCounter: { count: number };\n\t/** Techo de agentes por run (`workflows.maxAgentsPerRun`). */\n\tmaxAgents: number;\n\tretries?: number;\n\tagentTimeoutMs?: number | null;\n}\n\n/** Hash de identidad del agente para el journal (prompt+model+phase+schema+stableKey). */\nexport function agentIdentityHash(options: {\n\tprompt: string;\n\tmodel?: string;\n\ttier?: string;\n\tphase?: string;\n\tstableKey?: string;\n\tschema?: TSchema | undefined;\n}): string {\n\tconst canonical = JSON.stringify({\n\t\tprompt: options.prompt,\n\t\tmodel: options.model ?? null,\n\t\ttier: options.tier ?? null,\n\t\tphase: options.phase ?? null,\n\t\tstableKey: options.stableKey ?? null,\n\t\tschema: options.schema ? JSON.stringify(options.schema) : null,\n\t});\n\treturn createHash(\"sha256\").update(canonical).digest(\"hex\");\n}\n\n/** Extraer el texto de una respuesta (string o content array). */\nexport function messageText(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.filter((b): b is TextContent => typeof b === \"object\" && b !== null && (b as { type?: string }).type === \"text\")\n\t\t.map((b) => b.text ?? \"\")\n\t\t.join(\"\\n\")\n\t\t.trim();\n}\n\n/** Extraer JSON del texto (para structured output fallback). */\nexport function extractJson(text: string): unknown | undefined {\n\tconst cleaned = text\n\t\t.replace(/```json\\s*/g, \"\")\n\t\t.replace(/```/g, \"\")\n\t\t.trim();\n\tconst start = cleaned.indexOf(\"{\");\n\tconst end = cleaned.lastIndexOf(\"}\");\n\tif (start === -1 || end === -1) return undefined;\n\ttry {\n\t\treturn JSON.parse(cleaned.slice(start, end + 1));\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** Tools por defecto de un subagente (espejo de sdk.ts:263). */\nconst SUBAGENT_DEFAULT_TOOLS = [\"read\", \"bash\", \"edit\", \"write\"];\n/** Mínimo privilegio: leer y buscar, nada de escribir ni ejecutar. */\nconst SUBAGENT_READONLY_TOOLS = [\"read\", \"grep\", \"find\", \"ls\"];\n\n/**\n * Allowlist de tools del subagente.\n *\n * Desenreda un bug latente: `options.tools` son tools EXTRA (web_search…) y se\n * pasaban a la vez como `customTools` y como allowlist, de modo que pedir una\n * tool extra ESTRECHABA el permiso en silencio a solo esa — un agente que pedía\n * `web_search` perdía `read`/`bash`/`edit`/`write` sin que nadie lo notara.\n * Ahora las extra se SUMAN a la base, que es lo que el nombre siempre prometió.\n */\nexport function resolveAllowedTools(options: { readOnly?: boolean; tools?: Array<{ name: string }> }): string[] {\n\tconst base = options.readOnly ? SUBAGENT_READONLY_TOOLS : SUBAGENT_DEFAULT_TOOLS;\n\tconst extras = (options.tools ?? []).map((t) => t.name);\n\treturn [...new Set([...base, ...extras])];\n}\n\nexport class AgentRunner {\n\tprivate agentDir: string;\n\tprivate createSession: CreateSubagentSession;\n\tprivate limiter: AgentRunnerOptions[\"limiter\"];\n\tprivate agentCounter: AgentRunnerOptions[\"agentCounter\"];\n\tprivate maxAgents: number;\n\tprivate retries: number;\n\tprivate agentTimeoutMs: number | null;\n\n\tconstructor(options: AgentRunnerOptions) {\n\t\tthis.agentDir = options.agentDir;\n\t\tthis.createSession = options.createSession;\n\t\tthis.limiter = options.limiter;\n\t\tthis.agentCounter = options.agentCounter;\n\t\tthis.maxAgents = options.maxAgents;\n\t\tthis.retries = options.retries ?? 3;\n\t\tthis.agentTimeoutMs = options.agentTimeoutMs ?? null;\n\t}\n\n\tasync run<T = unknown>(options: AgentRunOptions): Promise<AgentRunResult<T> | null> {\n\t\treturn this.limiter(async () => {\n\t\t\tif (this.agentCounter.count >= this.maxAgents) {\n\t\t\t\tthrow new WorkflowError(\n\t\t\t\t\t\"WORKFLOW_MAX_AGENTS\",\n\t\t\t\t\t`Límite de agentes del run alcanzado (${this.maxAgents}). Súbelo con el ajuste workflows.maxAgentsPerRun.`,\n\t\t\t\t\t{ recoverable: false },\n\t\t\t\t);\n\t\t\t}\n\t\t\tthis.agentCounter.count++;\n\n\t\t\tlet attempt = 0;\n\t\t\tlet lastError: Error | undefined;\n\t\t\tfor (; attempt <= this.retries; attempt++) {\n\t\t\t\tconst signal = options.signal;\n\t\t\t\tif (signal?.aborted) return null;\n\t\t\t\ttry {\n\t\t\t\t\treturn await this.runOnce<T>(options, signal);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (signal?.aborted) return null;\n\t\t\t\t\tif (isAbortError(error) || isTimeoutError(error)) throw error;\n\t\t\t\t\tlastError = error instanceof Error ? error : new Error(String(error));\n\t\t\t\t\tif (attempt >= this.retries) break;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (lastError) throw lastError;\n\t\t\treturn null;\n\t\t});\n\t}\n\n\tprivate async runOnce<T>(options: AgentRunOptions, signal?: AbortSignal): Promise<AgentRunResult<T> | null> {\n\t\t// Timeout combinado: el del agente + el del run.\n\t\tconst timeoutMs = options.timeoutMs ?? this.agentTimeoutMs;\n\t\tlet timeoutTimer: ReturnType<typeof setTimeout> | undefined;\n\t\tconst timeout = new Promise<never>((_resolve, reject) => {\n\t\t\tif (timeoutMs === null) return;\n\t\t\ttimeoutTimer = setTimeout(() => {\n\t\t\t\treject(\n\t\t\t\t\tnew WorkflowError(\"WORKFLOW_AGENT_TIMEOUT\", `Agent timed out after ${timeoutMs}ms`, {\n\t\t\t\t\t\trecoverable: false,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}, timeoutMs);\n\t\t});\n\n\t\tconst baseCwd = options.cwd ?? process.cwd();\n\t\t// Aislamiento git: los agentes con escritura que corren en paralelo\n\t\t// editaban el MISMO checkout y se pisaban en silencio. El nombre es\n\t\t// determinista (isolationKey = runId:callIndex) para que un resume\n\t\t// reencuentre el mismo worktree. Fuera de un repo git hace no-op.\n\t\tlet worktree: Worktree | null = null;\n\t\tlet finalized: { branch?: string; kept: boolean } | undefined;\n\t\tconst worktreeMessage = `ada: ${options.label ?? options.isolationKey ?? \"agent\"}`;\n\t\tif (options.isolation === \"worktree\") {\n\t\t\tworktree = await createWorktree(baseCwd, options.isolationKey ?? options.label ?? \"agent\");\n\t\t}\n\n\t\tlet subagent: SubagentSession | null = null;\n\t\ttry {\n\t\t\tsubagent = await this.createSession({\n\t\t\t\tcwd: worktree?.cwd ?? baseCwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tmodelSpec: options.model ?? (options.tier ? `tier:${options.tier}` : undefined),\n\t\t\t\ttools: resolveAllowedTools(options),\n\t\t\t\tcustomTools: options.tools,\n\t\t\t\tsessionName: options.label ? `workflow:${options.label}` : undefined,\n\t\t\t\tinstructions: options.instructions,\n\t\t\t});\n\t\t\tconst session = subagent.session;\n\n\t\t\tconst lastAssistantText: string[] = [];\n\t\t\tconst unsubscribe = session.subscribe((event: AgentSessionEvent) => {\n\t\t\t\tif (event.type === \"message_end\" && event.message.role === \"assistant\") {\n\t\t\t\t\tconst text = messageText(event.message.content);\n\t\t\t\t\tif (text) lastAssistantText.push(text);\n\t\t\t\t}\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\tawait Promise.race([session.sendUserMessage(options.prompt), timeout]);\n\t\t\t\tawait Promise.race([session.waitForIdle(), timeout]);\n\t\t\t} finally {\n\t\t\t\tunsubscribe();\n\t\t\t}\n\n\t\t\tif (signal?.aborted) return null;\n\n\t\t\tconst text = lastAssistantText.length > 0 ? lastAssistantText[lastAssistantText.length - 1] : \"\";\n\t\t\tlet result: T | null = null;\n\t\t\tlet _origin: \"structured\" | \"recovered\" = \"structured\";\n\n\t\t\tif (options.schema) {\n\t\t\t\tconst parsed = extractJson(text);\n\t\t\t\tif (parsed !== undefined) {\n\t\t\t\t\tresult = parsed as T;\n\t\t\t\t} else {\n\t\t\t\t\t_origin = \"recovered\";\n\t\t\t\t\t// Fallback: devolver la prosa (el caller decide si sirve).\n\t\t\t\t\tresult = text as unknown as T;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tresult = (text.length > 0 ? text : null) as unknown as T;\n\t\t\t}\n\n\t\t\t// Consolidar el worktree ANTES de devolver: si solo lo retirásemos, los\n\t\t\t// cambios sin commitear del agente se perderían y el aislamiento no\n\t\t\t// habría servido de nada. La rama sobrevive para que un humano la\n\t\t\t// mergee; no hay auto-merge a propósito.\n\t\t\tif (worktree && !finalized) {\n\t\t\t\tfinalized = await finalizeWorktree(worktree, worktreeMessage);\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tresult,\n\t\t\t\ttext,\n\t\t\t\tusage: subagent.getUsage(),\n\t\t\t\tsessionId: (\n\t\t\t\t\tsession as { sessionManager?: { getSessionId?: () => string } }\n\t\t\t\t).sessionManager?.getSessionId?.(),\n\t\t\t\tworktreeBranch: finalized?.branch,\n\t\t\t} as AgentRunResult<T>;\n\t\t} finally {\n\t\t\tif (timeoutTimer) clearTimeout(timeoutTimer);\n\t\t\tsubagent?.dispose();\n\t\t\t// Camino de error/abort/timeout: el return no llegó a consolidar, pero\n\t\t\t// el trabajo parcial del agente también merece sobrevivir para poder\n\t\t\t// inspeccionarlo — y hay que soltar el worktree igualmente.\n\t\t\tif (worktree && !finalized) {\n\t\t\t\tfinalized = await finalizeWorktree(worktree, worktreeMessage);\n\t\t\t}\n\t\t}\n\t}\n}\n\nfunction isAbortError(error: unknown): boolean {\n\treturn error instanceof Error && error.name === \"AbortError\";\n}\n\nfunction isTimeoutError(error: unknown): boolean {\n\treturn error instanceof WorkflowError && error.code === \"WORKFLOW_AGENT_TIMEOUT\";\n}\n\n/** Tipos re-exportados para el index. */\nexport type { WorkflowErrorCode };\n"]}

package/dist/core/workflows/builtins.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Builtins — generadores de scripts de workflow (deep-research, code-review,
+ * product-build, codebase-audit, multi-perspective).
+ *
+ * Los builtins son versionados con el SDK y TESTEADOS — no scripts sueltos
+ * del usuario. Devuelven el script que ejecuta el runtime.
+ *
+ * Regla de oro: TODO fragmento estático de prompt se emite con q()
+ * (JSON.stringify) — el escapado queda garantizado por construcción y el
+ * script generado SIEMPRE es JS válido (verificado por tests vm-parse).
+ */
+/** Deep-research: plan → gather (parallel, con web tools) → verify → report. */
+export declare function generateDeepResearchScript(options?: {
+    angles?: number;
+    minSupport?: number;
+}): string;
+/** Code-review: diff por módulo → reviewers paralelos → síntesis con severidad. */
+export declare function generateCodeReviewScript(options?: {
+    reviewers?: number;
+}): string;
+/**
+ * Product-build (Ada Intelligence, §4): acceptance criteria → fases TDD →
+ * verify ejecuta los tests → done con verified_by y evidencia.
+ */
+export declare function generateProductBuildScript(): string;
+/**
+ * Codebase-audit (§4): módulos → auditoría paralela (seguridad, deuda, bugs,
+ * compliance) → informe + (opcional) nodos QA_FINDING/RISK del grafo.
+ */
+export declare function generateCodebaseAuditScript(options?: {
+    angles?: number;
+    graph?: boolean;
+}): string;
+/**
+ * Multi-perspective (§4): el mismo problema desde N ángulos → síntesis con
+ * desacuerdos explícitos (no consenso falso).
+ */
+export declare function generateMultiPerspectiveScript(options?: {
+    perspectives?: number;
+}): string;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/core/workflows/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/core/workflows/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,sFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAsDzG;AAED,yFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA8CrF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CA2DnD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAiDtG;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAuC9F","sourcesContent":["/**\n * Builtins — generadores de scripts de workflow (deep-research, code-review,\n * product-build, codebase-audit, multi-perspective).\n *\n * Los builtins son versionados con el SDK y TESTEADOS — no scripts sueltos\n * del usuario. Devuelven el script que ejecuta el runtime.\n *\n * Regla de oro: TODO fragmento estático de prompt se emite con q()\n * (JSON.stringify) — el escapado queda garantizado por construcción y el\n * script generado SIEMPRE es JS válido (verificado por tests vm-parse).\n */\n\n/** Emite un literal string JS correctamente escapado. */\nfunction q(s: string): string {\n\treturn JSON.stringify(s);\n}\n\n/** Deep-research: plan → gather (parallel, con web tools) → verify → report. */\nexport function generateDeepResearchScript(options: { angles?: number; minSupport?: number } = {}): string {\n\tconst angles = Math.min(Math.max(options.angles ?? 4, 1), 12);\n\tconst minSupport = options.minSupport ?? 2;\n\treturn `export const meta = {\n  \"name\": \"deep_research\",\n  \"description\": \"Deep research con búsqueda web y verificación cruzada\",\n  \"phases\": [\n    { \"title\": \"Queries\" },\n    { \"title\": \"Gather\" },\n    { \"title\": \"Verify\" },\n    { \"title\": \"Report\" }\n  ]\n}\n\nphase(\"Queries\")\nconst plan = await agent({\n  prompt: ${q(\"Planifica la investigación web para esta pregunta: \")} + (args.question ?? \"\") +\n    ${q(`\\n\\nProduce ${angles} consultas diversas y específicas. Devuelve JSON {\"queries\": [\"...\"]}.`)},\n  label: \"planificar consultas\",\n  schema: { type: \"object\", properties: { queries: { type: \"array\", items: { type: \"string\" } } }, required: [\"queries\"] }\n})\nconst planned = plan && Array.isArray(plan.queries) ? plan.queries.filter((q) => typeof q === \"string\" && q.trim().length > 0) : []\nconst queries = (planned.length > 0 ? planned : [args.question ?? \"\"]).slice(0, ${angles})\n\nphase(\"Gather\")\nconst gathered = await parallel(queries.map((q, i) => () =>\n  agent({\n    prompt: ${q(\"Investiga esta consulta usando las tools web_search y web_fetch.\\nConsulta: \")} + q +\n      ${q('\\n\\nPasos: (1) web_search; (2) web_fetch de las 2 URLs más relevantes; (3) extrae claims verificables, cada uno con su URL exacta. NO inventes fuentes. Devuelve JSON {\"sources\": [{\"url\": string, \"claims\": [string]}]}.')},\n    label: \"investigar: \" + String(q).slice(0, 60),\n    readOnly: true,\n    schema: { type: \"object\", properties: { sources: { type: \"array\", items: { type: \"object\", properties: { url: { type: \"string\" }, claims: { type: \"array\", items: { type: \"string\" } } }, required: [\"url\", \"claims\"] } } }, required: [\"sources\"] }\n  })\n))\nconst allSources = gathered.filter(Boolean).flatMap((g) => (g && g.sources) || [])\n\nphase(\"Verify\")\nconst verified = await agent({\n  prompt: ${q(`Verifica los claims recopilados. Para cada claim, comprueba que tenga al menos ${minSupport} fuentes independientes que lo respalden. Devuelve JSON {\"verifiedClaims\": [{ \"claim\": string, \"sources\": [string] }], \"uncertain\": [string]}.`)},\n  label: \"verificar claims (\" + allSources.length + \" fuentes)\",\n  readOnly: true,\n  schema: { type: \"object\", properties: { verifiedClaims: { type: \"array\", items: { type: \"object\", properties: { claim: { type: \"string\" }, sources: { type: \"array\", items: { type: \"string\" } } }, required: [\"claim\", \"sources\"] } }, uncertain: { type: \"array\", items: { type: \"string\" } } }, required: [\"verifiedClaims\", \"uncertain\"] }\n})\n\nphase(\"Report\")\nconst report = await agent({\n  prompt: ${q(\"Escribe un informe en Markdown sobre: \")} + (args.question ?? \"\") +\n    ${q('\\n\\nUsa SOLO los claims verificados, citando las fuentes como [1], [2]... con la lista de fuentes al final. Marca explícitamente lo incierto. Devuelve el informe en JSON {\"report\": string}.')},\n  label: \"redactar informe\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn report ? report.report : null\n`;\n}\n\n/** Code-review: diff por módulo → reviewers paralelos → síntesis con severidad. */\nexport function generateCodeReviewScript(options: { reviewers?: number } = {}): string {\n\tconst reviewers = Math.min(Math.max(options.reviewers ?? 3, 1), 6);\n\tconst perspectives = [\n\t\t\"bugs y errores lógicos\",\n\t\t\"seguridad y límites de confianza\",\n\t\t\"mantenibilidad y deuda técnica\",\n\t].slice(0, reviewers);\n\treturn `export const meta = {\n  \"name\": \"code_review\",\n  \"description\": \"Revisión de código con reviewers paralelos y síntesis por severidad\",\n  \"phases\": [\n    { \"title\": \"Diff\" },\n    { \"title\": \"Review\" },\n    { \"title\": \"Synthesize\" }\n  ]\n}\n\nphase(\"Diff\")\nconst diff = await agent({\n  prompt: ${q('Obtén el diff del cambio (git diff HEAD~1 o el rango indicado en args.diff). Devuelve JSON {\"diff\": string} con el diff completo (máx 10000 chars).')},\n  label: \"obtener diff\",\n  schema: { type: \"object\", properties: { diff: { type: \"string\" } }, required: [\"diff\"] }\n})\n\nphase(\"Review\")\nconst perspectives = ${JSON.stringify(perspectives)}\nconst reviews = await parallel(perspectives.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Revisa el siguiente diff desde la perspectiva: \")} + p +\n      ${q(\"\\n\\nDIFF:\\n\")} + (diff ? diff.diff : \"(sin diff)\") +\n      ${q('\\n\\nPara cada hallazgo cita archivo:línea. NO inventes. Devuelve JSON {\"findings\": [{\"severity\": \"critical|major|minor\", \"file\": string, \"line\": number, \"issue\": string, \"suggestion\": string}]}.')},\n    label: \"revisar: \" + p,\n    readOnly: true,\n    schema: { type: \"object\", properties: { findings: { type: \"array\", items: { type: \"object\", properties: { severity: { type: \"string\" }, file: { type: \"string\" }, line: { type: \"number\" }, issue: { type: \"string\" }, suggestion: { type: \"string\" } }, required: [\"severity\", \"file\", \"issue\"] } } }, required: [\"findings\"] }\n  })\n))\n\nphase(\"Synthesize\")\nconst synthesis = await agent({\n  prompt: ${q('Sintetiza estos hallazgos de revisión en un informe final Markdown ordenado por severidad (crítico primero), sin duplicados y con las citas archivo:línea. Devuelve JSON {\"report\": string}.')},\n  label: \"sintetizar hallazgos\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn synthesis ? synthesis.report : null\n`;\n}\n\n/**\n * Product-build (Ada Intelligence, §4): acceptance criteria → fases TDD →\n * verify ejecuta los tests → done con verified_by y evidencia.\n */\nexport function generateProductBuildScript(): string {\n\treturn `export const meta = {\n  \"name\": \"product_build\",\n  \"description\": \"Construcción de producto con acceptance criteria y verify con evidencia\",\n  \"phases\": [\n    { \"title\": \"Frame\" },\n    { \"title\": \"Plan\" },\n    { \"title\": \"Build\" },\n    { \"title\": \"Verify\" },\n    { \"title\": \"Done\" }\n  ]\n}\n\nphase(\"Frame\")\nconst framed = await agent({\n  prompt: ${q(\"Enmarca el producto para este brief: \")} + ((args.brief ?? args.acceptanceCriteria) ?? \"\") +\n    ${q('\\n\\nDefine acceptance criteria observables y medibles. Devuelve JSON {\"criteria\": [{\"id\": string, \"description\": string}]} (máx 6).')},\n  label: \"definir criterios\",\n  schema: { type: \"object\", properties: { criteria: { type: \"array\", items: { type: \"object\", properties: { id: { type: \"string\" }, description: { type: \"string\" } }, required: [\"id\", \"description\"] } } }, required: [\"criteria\"] }\n})\nconst criteria = (framed && framed.criteria) || []\n\nphase(\"Plan\")\nconst planned = await agent({\n  prompt: ${q('Planifica las tareas para cumplir estos criterios. Por cada criterio indica el test que lo verifica. Devuelve JSON {\"tasks\": [{\"title\": string, \"criterion\": string, \"test\": string}]}.\\n\\nCriterios:\\n')} +\n    JSON.stringify(criteria),\n  label: \"planificar tareas\",\n  schema: { type: \"object\", properties: { tasks: { type: \"array\", items: { type: \"object\", properties: { title: { type: \"string\" }, criterion: { type: \"string\" }, test: { type: \"string\" } }, required: [\"title\", \"criterion\"] } } }, required: [\"tasks\"] }\n})\n\nphase(\"Build\")\nconst built = await parallel((planned && planned.tasks || []).map((t, i) => () =>\n  agent({\n    prompt: ${q(\"Tarea: \")} + t.title + ${q(\"\\nCriterio que resuelve: \")} + t.criterion +\n      ${q(\"\\nImplementa el mínimo y escribe el test: \")} + (t.test ?? \"\") +\n      ${q('\\nEjecuta el test y confirma. Devuelve el archivo que cambiaste en {\"file\": string, \"verified\": boolean}.')},\n    label: \"construir: \" + t.title,\n    isolation: \"worktree\",\n    schema: { type: \"object\", properties: { file: { type: \"string\" }, verified: { type: \"boolean\" } }, required: [\"file\", \"verified\"] }\n  })\n))\nconst artifacts = built.filter(Boolean).filter((b) => b && b.verified)\n\nphase(\"Verify\")\nconst verification = await agent({\n  prompt: ${q('Ejecuta el/los comando(s) de verificación del proyecto (args.verifyCommand o el test runner default). Para cada criterio, confirma con evidencia archivo:línea o salida de test. Devuelve JSON {\"results\": [{\"criterion\": string, \"verified_by\": string, \"evidence\": string}]}.')},\n  label: \"verificar criterios (\" + criteria.length + \")\",\n  schema: { type: \"object\", properties: { results: { type: \"array\", items: { type: \"object\", properties: { criterion: { type: \"string\" }, verified_by: { type: \"string\" }, evidence: { type: \"string\" } }, required: [\"criterion\", \"verified_by\", \"evidence\"] } } }, required: [\"results\"] }\n})\n\nphase(\"Done\")\nconst done = await agent({\n  prompt: ${q('Redacta el informe final de build. Solo declara done si CADA criterio tiene verified_by y evidencia. Devuelve JSON {\"report\": string, \"done\": boolean, \"gaps\": [string]}.')},\n  label: \"informe final\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" }, done: { type: \"boolean\" }, gaps: { type: \"array\", items: { type: \"string\" } } }, required: [\"report\", \"done\"] }\n})\n\nreturn done ? done.report || JSON.stringify(done) : null\n`;\n}\n\n/**\n * Codebase-audit (§4): módulos → auditoría paralela (seguridad, deuda, bugs,\n * compliance) → informe + (opcional) nodos QA_FINDING/RISK del grafo.\n */\nexport function generateCodebaseAuditScript(options: { angles?: number; graph?: boolean } = {}): string {\n\tconst angles = Math.min(Math.max(options.angles ?? 4, 1), 8);\n\tconst perspectives = [\n\t\t\"seguridad (injection, secrets, límites de confianza)\",\n\t\t\"deuda técnica y arquitectura\",\n\t\t\"bugs y correctitud\",\n\t\t\"cumplimiento / RGPD / datos personales\",\n\t].slice(0, angles);\n\tconst graphHooks = options.graph\n\t\t? \"\\n\\nTras el informe, usa la tool graph_add_nodes para registrar QA_FINDING y RISK con sus citas.\"\n\t\t: \"\";\n\treturn `export const meta = {\n  \"name\": \"codebase_audit\",\n  \"description\": \"Auditoría del codebase con ángulos paralelos y síntesis\",\n  \"phases\": [\n    { \"title\": \"Walk\" },\n    { \"title\": \"Audit\" },\n    { \"title\": \"Report\" }\n  ]\n}\n\nphase(\"Walk\")\nconst modules = await agent({\n  prompt: ${q(`Audita este repo: (args.path ?? \".\"). En qué módulos se dividiría la auditoría. Devuelve JSON {\"modules\": [string]} (máx ${angles}).`)},\n  label: \"identificar módulos\",\n  schema: { type: \"object\", properties: { modules: { type: \"array\", items: { type: \"string\" } } }, required: [\"modules\"] }\n})\n\nphase(\"Audit\")\nconst perspectives = ${JSON.stringify(perspectives)}\nconst audits = await parallel(perspectives.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Audita el módulo(s) desde la perspectiva: \")} + p +\n      ${q(\"\\nMódulos: \")} + JSON.stringify((modules && modules.modules) || []) +\n      ${q(`\\nPara cada hallazgo cita archivo:línea. Devuelve JSON {\"findings\": [{\"type\": \"RISK|QA_FINDING\", \"severity\": string, \"file\": string, \"line\": number, \"issue\": string}]}.${graphHooks}`)},\n    label: \"auditar: \" + p,\n    schema: { type: \"object\", properties: { findings: { type: \"array\", items: { type: \"object\", properties: { type: { type: \"string\" }, severity: { type: \"string\" }, file: { type: \"string\" }, issue: { type: \"string\" } }, required: [\"type\", \"severity\", \"file\", \"issue\"] } } }, required: [\"findings\"] }\n  })\n))\n\nphase(\"Report\")\nconst report = await agent({\n  prompt: ${q('Sintetiza los hallazgos de auditoría en un informe Markdown ordenado por severidad, agrupado por perspectiva, con citas archivo:línea y recomendaciones priorizadas. Devuelve JSON {\"report\": string}.')},\n  label: \"sintetizar auditoría\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn report ? report.report : null\n`;\n}\n\n/**\n * Multi-perspective (§4): el mismo problema desde N ángulos → síntesis con\n * desacuerdos explícitos (no consenso falso).\n */\nexport function generateMultiPerspectiveScript(options: { perspectives?: number } = {}): string {\n\tconst n = Math.min(Math.max(options.perspectives ?? 4, 2), 8);\n\tconst list = [\n\t\t\"correctitud e invariantes\",\n\t\t\"rendimiento y escalabilidad\",\n\t\t\"seguridad y confianza\",\n\t\t\"mantenibilidad y claridad\",\n\t\t\"producto y UX\",\n\t\t\"coste de operación\",\n\t].slice(0, n);\n\treturn `export const meta = {\n  \"name\": \"multi_perspective\",\n  \"description\": \"Análisis del mismo problema desde N perspectivas con desacuerdos explícitos\",\n  \"phases\": [\n    { \"title\": \"Perspectives\" },\n    { \"title\": \"Synthesize\" }\n  ]\n}\n\nphase(\"Perspectives\")\nconst views = await parallel(${JSON.stringify(list)}.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Analiza este problema: \")} + (args.problem ?? \"\") +\n      ${q(\"\\nDesde la perspectiva: \")} + p +\n      ${q('\\nDa tu análisis, recomendación y riesgos. Devuelve JSON {\"perspective\": string, \"recommendation\": string, \"risks\": [string]}.')},\n    label: \"perspectiva: \" + p,\n    schema: { type: \"object\", properties: { perspective: { type: \"string\" }, recommendation: { type: \"string\" }, risks: { type: \"array\", items: { type: \"string\" } } }, required: [\"perspective\", \"recommendation\"] }\n  })\n))\n\nphase(\"Synthesize\")\nconst synthesis = await agent({\n  prompt: ${q('Sintetiza los análisis. SEÑALA EXPLÍCITAMENTE los desacuerdos entre perspectivas (no creas consenso falso). Devuelve JSON {\"summary\": string, \"disagreements\": [string], \"recommended\": string}.')},\n  label: \"sintetizar análisis\",\n  schema: { type: \"object\", properties: { summary: { type: \"string\" }, disagreements: { type: \"array\", items: { type: \"string\" } }, recommended: { type: \"string\" } }, required: [\"summary\", \"recommended\"] }\n})\n\nreturn synthesis ? synthesis.summary || JSON.stringify(synthesis) : null\n`;\n}\n"]}

package/dist/core/workflows/builtins.js

@@ -0,0 +1,282 @@
+/**
+ * Builtins — generadores de scripts de workflow (deep-research, code-review,
+ * product-build, codebase-audit, multi-perspective).
+ *
+ * Los builtins son versionados con el SDK y TESTEADOS — no scripts sueltos
+ * del usuario. Devuelven el script que ejecuta el runtime.
+ *
+ * Regla de oro: TODO fragmento estático de prompt se emite con q()
+ * (JSON.stringify) — el escapado queda garantizado por construcción y el
+ * script generado SIEMPRE es JS válido (verificado por tests vm-parse).
+ */
+/** Emite un literal string JS correctamente escapado. */
+function q(s) {
+    return JSON.stringify(s);
+}
+/** Deep-research: plan → gather (parallel, con web tools) → verify → report. */
+export function generateDeepResearchScript(options = {}) {
+    const angles = Math.min(Math.max(options.angles ?? 4, 1), 12);
+    const minSupport = options.minSupport ?? 2;
+    return `export const meta = {
+  "name": "deep_research",
+  "description": "Deep research con búsqueda web y verificación cruzada",
+  "phases": [
+    { "title": "Queries" },
+    { "title": "Gather" },
+    { "title": "Verify" },
+    { "title": "Report" }
+  ]
+}
+
+phase("Queries")
+const plan = await agent({
+  prompt: ${q("Planifica la investigación web para esta pregunta: ")} + (args.question ?? "") +
+    ${q(`\n\nProduce ${angles} consultas diversas y específicas. Devuelve JSON {"queries": ["..."]}.`)},
+  label: "planificar consultas",
+  schema: { type: "object", properties: { queries: { type: "array", items: { type: "string" } } }, required: ["queries"] }
+})
+const planned = plan && Array.isArray(plan.queries) ? plan.queries.filter((q) => typeof q === "string" && q.trim().length > 0) : []
+const queries = (planned.length > 0 ? planned : [args.question ?? ""]).slice(0, ${angles})
+
+phase("Gather")
+const gathered = await parallel(queries.map((q, i) => () =>
+  agent({
+    prompt: ${q("Investiga esta consulta usando las tools web_search y web_fetch.\nConsulta: ")} + q +
+      ${q('\n\nPasos: (1) web_search; (2) web_fetch de las 2 URLs más relevantes; (3) extrae claims verificables, cada uno con su URL exacta. NO inventes fuentes. Devuelve JSON {"sources": [{"url": string, "claims": [string]}]}.')},
+    label: "investigar: " + String(q).slice(0, 60),
+    readOnly: true,
+    schema: { type: "object", properties: { sources: { type: "array", items: { type: "object", properties: { url: { type: "string" }, claims: { type: "array", items: { type: "string" } } }, required: ["url", "claims"] } } }, required: ["sources"] }
+  })
+))
+const allSources = gathered.filter(Boolean).flatMap((g) => (g && g.sources) || [])
+
+phase("Verify")
+const verified = await agent({
+  prompt: ${q(`Verifica los claims recopilados. Para cada claim, comprueba que tenga al menos ${minSupport} fuentes independientes que lo respalden. Devuelve JSON {"verifiedClaims": [{ "claim": string, "sources": [string] }], "uncertain": [string]}.`)},
+  label: "verificar claims (" + allSources.length + " fuentes)",
+  readOnly: true,
+  schema: { type: "object", properties: { verifiedClaims: { type: "array", items: { type: "object", properties: { claim: { type: "string" }, sources: { type: "array", items: { type: "string" } } }, required: ["claim", "sources"] } }, uncertain: { type: "array", items: { type: "string" } } }, required: ["verifiedClaims", "uncertain"] }
+})
+
+phase("Report")
+const report = await agent({
+  prompt: ${q("Escribe un informe en Markdown sobre: ")} + (args.question ?? "") +
+    ${q('\n\nUsa SOLO los claims verificados, citando las fuentes como [1], [2]... con la lista de fuentes al final. Marca explícitamente lo incierto. Devuelve el informe en JSON {"report": string}.')},
+  label: "redactar informe",
+  schema: { type: "object", properties: { report: { type: "string" } }, required: ["report"] }
+})
+
+return report ? report.report : null
+`;
+}
+/** Code-review: diff por módulo → reviewers paralelos → síntesis con severidad. */
+export function generateCodeReviewScript(options = {}) {
+    const reviewers = Math.min(Math.max(options.reviewers ?? 3, 1), 6);
+    const perspectives = [
+        "bugs y errores lógicos",
+        "seguridad y límites de confianza",
+        "mantenibilidad y deuda técnica",
+    ].slice(0, reviewers);
+    return `export const meta = {
+  "name": "code_review",
+  "description": "Revisión de código con reviewers paralelos y síntesis por severidad",
+  "phases": [
+    { "title": "Diff" },
+    { "title": "Review" },
+    { "title": "Synthesize" }
+  ]
+}
+
+phase("Diff")
+const diff = await agent({
+  prompt: ${q('Obtén el diff del cambio (git diff HEAD~1 o el rango indicado en args.diff). Devuelve JSON {"diff": string} con el diff completo (máx 10000 chars).')},
+  label: "obtener diff",
+  schema: { type: "object", properties: { diff: { type: "string" } }, required: ["diff"] }
+})
+
+phase("Review")
+const perspectives = ${JSON.stringify(perspectives)}
+const reviews = await parallel(perspectives.map((p, i) => () =>
+  agent({
+    prompt: ${q("Revisa el siguiente diff desde la perspectiva: ")} + p +
+      ${q("\n\nDIFF:\n")} + (diff ? diff.diff : "(sin diff)") +
+      ${q('\n\nPara cada hallazgo cita archivo:línea. NO inventes. Devuelve JSON {"findings": [{"severity": "critical|major|minor", "file": string, "line": number, "issue": string, "suggestion": string}]}.')},
+    label: "revisar: " + p,
+    readOnly: true,
+    schema: { type: "object", properties: { findings: { type: "array", items: { type: "object", properties: { severity: { type: "string" }, file: { type: "string" }, line: { type: "number" }, issue: { type: "string" }, suggestion: { type: "string" } }, required: ["severity", "file", "issue"] } } }, required: ["findings"] }
+  })
+))
+
+phase("Synthesize")
+const synthesis = await agent({
+  prompt: ${q('Sintetiza estos hallazgos de revisión en un informe final Markdown ordenado por severidad (crítico primero), sin duplicados y con las citas archivo:línea. Devuelve JSON {"report": string}.')},
+  label: "sintetizar hallazgos",
+  schema: { type: "object", properties: { report: { type: "string" } }, required: ["report"] }
+})
+
+return synthesis ? synthesis.report : null
+`;
+}
+/**
+ * Product-build (Ada Intelligence, §4): acceptance criteria → fases TDD →
+ * verify ejecuta los tests → done con verified_by y evidencia.
+ */
+export function generateProductBuildScript() {
+    return `export const meta = {
+  "name": "product_build",
+  "description": "Construcción de producto con acceptance criteria y verify con evidencia",
+  "phases": [
+    { "title": "Frame" },
+    { "title": "Plan" },
+    { "title": "Build" },
+    { "title": "Verify" },
+    { "title": "Done" }
+  ]
+}
+
+phase("Frame")
+const framed = await agent({
+  prompt: ${q("Enmarca el producto para este brief: ")} + ((args.brief ?? args.acceptanceCriteria) ?? "") +
+    ${q('\n\nDefine acceptance criteria observables y medibles. Devuelve JSON {"criteria": [{"id": string, "description": string}]} (máx 6).')},
+  label: "definir criterios",
+  schema: { type: "object", properties: { criteria: { type: "array", items: { type: "object", properties: { id: { type: "string" }, description: { type: "string" } }, required: ["id", "description"] } } }, required: ["criteria"] }
+})
+const criteria = (framed && framed.criteria) || []
+
+phase("Plan")
+const planned = await agent({
+  prompt: ${q('Planifica las tareas para cumplir estos criterios. Por cada criterio indica el test que lo verifica. Devuelve JSON {"tasks": [{"title": string, "criterion": string, "test": string}]}.\n\nCriterios:\n')} +
+    JSON.stringify(criteria),
+  label: "planificar tareas",
+  schema: { type: "object", properties: { tasks: { type: "array", items: { type: "object", properties: { title: { type: "string" }, criterion: { type: "string" }, test: { type: "string" } }, required: ["title", "criterion"] } } }, required: ["tasks"] }
+})
+
+phase("Build")
+const built = await parallel((planned && planned.tasks || []).map((t, i) => () =>
+  agent({
+    prompt: ${q("Tarea: ")} + t.title + ${q("\nCriterio que resuelve: ")} + t.criterion +
+      ${q("\nImplementa el mínimo y escribe el test: ")} + (t.test ?? "") +
+      ${q('\nEjecuta el test y confirma. Devuelve el archivo que cambiaste en {"file": string, "verified": boolean}.')},
+    label: "construir: " + t.title,
+    isolation: "worktree",
+    schema: { type: "object", properties: { file: { type: "string" }, verified: { type: "boolean" } }, required: ["file", "verified"] }
+  })
+))
+const artifacts = built.filter(Boolean).filter((b) => b && b.verified)
+
+phase("Verify")
+const verification = await agent({
+  prompt: ${q('Ejecuta el/los comando(s) de verificación del proyecto (args.verifyCommand o el test runner default). Para cada criterio, confirma con evidencia archivo:línea o salida de test. Devuelve JSON {"results": [{"criterion": string, "verified_by": string, "evidence": string}]}.')},
+  label: "verificar criterios (" + criteria.length + ")",
+  schema: { type: "object", properties: { results: { type: "array", items: { type: "object", properties: { criterion: { type: "string" }, verified_by: { type: "string" }, evidence: { type: "string" } }, required: ["criterion", "verified_by", "evidence"] } } }, required: ["results"] }
+})
+
+phase("Done")
+const done = await agent({
+  prompt: ${q('Redacta el informe final de build. Solo declara done si CADA criterio tiene verified_by y evidencia. Devuelve JSON {"report": string, "done": boolean, "gaps": [string]}.')},
+  label: "informe final",
+  schema: { type: "object", properties: { report: { type: "string" }, done: { type: "boolean" }, gaps: { type: "array", items: { type: "string" } } }, required: ["report", "done"] }
+})
+
+return done ? done.report || JSON.stringify(done) : null
+`;
+}
+/**
+ * Codebase-audit (§4): módulos → auditoría paralela (seguridad, deuda, bugs,
+ * compliance) → informe + (opcional) nodos QA_FINDING/RISK del grafo.
+ */
+export function generateCodebaseAuditScript(options = {}) {
+    const angles = Math.min(Math.max(options.angles ?? 4, 1), 8);
+    const perspectives = [
+        "seguridad (injection, secrets, límites de confianza)",
+        "deuda técnica y arquitectura",
+        "bugs y correctitud",
+        "cumplimiento / RGPD / datos personales",
+    ].slice(0, angles);
+    const graphHooks = options.graph
+        ? "\n\nTras el informe, usa la tool graph_add_nodes para registrar QA_FINDING y RISK con sus citas."
+        : "";
+    return `export const meta = {
+  "name": "codebase_audit",
+  "description": "Auditoría del codebase con ángulos paralelos y síntesis",
+  "phases": [
+    { "title": "Walk" },
+    { "title": "Audit" },
+    { "title": "Report" }
+  ]
+}
+
+phase("Walk")
+const modules = await agent({
+  prompt: ${q(`Audita este repo: (args.path ?? "."). En qué módulos se dividiría la auditoría. Devuelve JSON {"modules": [string]} (máx ${angles}).`)},
+  label: "identificar módulos",
+  schema: { type: "object", properties: { modules: { type: "array", items: { type: "string" } } }, required: ["modules"] }
+})
+
+phase("Audit")
+const perspectives = ${JSON.stringify(perspectives)}
+const audits = await parallel(perspectives.map((p, i) => () =>
+  agent({
+    prompt: ${q("Audita el módulo(s) desde la perspectiva: ")} + p +
+      ${q("\nMódulos: ")} + JSON.stringify((modules && modules.modules) || []) +
+      ${q(`\nPara cada hallazgo cita archivo:línea. Devuelve JSON {"findings": [{"type": "RISK|QA_FINDING", "severity": string, "file": string, "line": number, "issue": string}]}.${graphHooks}`)},
+    label: "auditar: " + p,
+    schema: { type: "object", properties: { findings: { type: "array", items: { type: "object", properties: { type: { type: "string" }, severity: { type: "string" }, file: { type: "string" }, issue: { type: "string" } }, required: ["type", "severity", "file", "issue"] } } }, required: ["findings"] }
+  })
+))
+
+phase("Report")
+const report = await agent({
+  prompt: ${q('Sintetiza los hallazgos de auditoría en un informe Markdown ordenado por severidad, agrupado por perspectiva, con citas archivo:línea y recomendaciones priorizadas. Devuelve JSON {"report": string}.')},
+  label: "sintetizar auditoría",
+  schema: { type: "object", properties: { report: { type: "string" } }, required: ["report"] }
+})
+
+return report ? report.report : null
+`;
+}
+/**
+ * Multi-perspective (§4): el mismo problema desde N ángulos → síntesis con
+ * desacuerdos explícitos (no consenso falso).
+ */
+export function generateMultiPerspectiveScript(options = {}) {
+    const n = Math.min(Math.max(options.perspectives ?? 4, 2), 8);
+    const list = [
+        "correctitud e invariantes",
+        "rendimiento y escalabilidad",
+        "seguridad y confianza",
+        "mantenibilidad y claridad",
+        "producto y UX",
+        "coste de operación",
+    ].slice(0, n);
+    return `export const meta = {
+  "name": "multi_perspective",
+  "description": "Análisis del mismo problema desde N perspectivas con desacuerdos explícitos",
+  "phases": [
+    { "title": "Perspectives" },
+    { "title": "Synthesize" }
+  ]
+}
+
+phase("Perspectives")
+const views = await parallel(${JSON.stringify(list)}.map((p, i) => () =>
+  agent({
+    prompt: ${q("Analiza este problema: ")} + (args.problem ?? "") +
+      ${q("\nDesde la perspectiva: ")} + p +
+      ${q('\nDa tu análisis, recomendación y riesgos. Devuelve JSON {"perspective": string, "recommendation": string, "risks": [string]}.')},
+    label: "perspectiva: " + p,
+    schema: { type: "object", properties: { perspective: { type: "string" }, recommendation: { type: "string" }, risks: { type: "array", items: { type: "string" } } }, required: ["perspective", "recommendation"] }
+  })
+))
+
+phase("Synthesize")
+const synthesis = await agent({
+  prompt: ${q('Sintetiza los análisis. SEÑALA EXPLÍCITAMENTE los desacuerdos entre perspectivas (no creas consenso falso). Devuelve JSON {"summary": string, "disagreements": [string], "recommended": string}.')},
+  label: "sintetizar análisis",
+  schema: { type: "object", properties: { summary: { type: "string" }, disagreements: { type: "array", items: { type: "string" } }, recommended: { type: "string" } }, required: ["summary", "recommended"] }
+})
+
+return synthesis ? synthesis.summary || JSON.stringify(synthesis) : null
+`;
+}
+//# sourceMappingURL=builtins.js.map

package/dist/core/workflows/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../../src/core/workflows/builtins.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Builtins — generadores de scripts de workflow (deep-research, code-review,\n * product-build, codebase-audit, multi-perspective).\n *\n * Los builtins son versionados con el SDK y TESTEADOS — no scripts sueltos\n * del usuario. Devuelven el script que ejecuta el runtime.\n *\n * Regla de oro: TODO fragmento estático de prompt se emite con q()\n * (JSON.stringify) — el escapado queda garantizado por construcción y el\n * script generado SIEMPRE es JS válido (verificado por tests vm-parse).\n */\n\n/** Emite un literal string JS correctamente escapado. */\nfunction q(s: string): string {\n\treturn JSON.stringify(s);\n}\n\n/** Deep-research: plan → gather (parallel, con web tools) → verify → report. */\nexport function generateDeepResearchScript(options: { angles?: number; minSupport?: number } = {}): string {\n\tconst angles = Math.min(Math.max(options.angles ?? 4, 1), 12);\n\tconst minSupport = options.minSupport ?? 2;\n\treturn `export const meta = {\n  \"name\": \"deep_research\",\n  \"description\": \"Deep research con búsqueda web y verificación cruzada\",\n  \"phases\": [\n    { \"title\": \"Queries\" },\n    { \"title\": \"Gather\" },\n    { \"title\": \"Verify\" },\n    { \"title\": \"Report\" }\n  ]\n}\n\nphase(\"Queries\")\nconst plan = await agent({\n  prompt: ${q(\"Planifica la investigación web para esta pregunta: \")} + (args.question ?? \"\") +\n    ${q(`\\n\\nProduce ${angles} consultas diversas y específicas. Devuelve JSON {\"queries\": [\"...\"]}.`)},\n  label: \"planificar consultas\",\n  schema: { type: \"object\", properties: { queries: { type: \"array\", items: { type: \"string\" } } }, required: [\"queries\"] }\n})\nconst planned = plan && Array.isArray(plan.queries) ? plan.queries.filter((q) => typeof q === \"string\" && q.trim().length > 0) : []\nconst queries = (planned.length > 0 ? planned : [args.question ?? \"\"]).slice(0, ${angles})\n\nphase(\"Gather\")\nconst gathered = await parallel(queries.map((q, i) => () =>\n  agent({\n    prompt: ${q(\"Investiga esta consulta usando las tools web_search y web_fetch.\\nConsulta: \")} + q +\n      ${q('\\n\\nPasos: (1) web_search; (2) web_fetch de las 2 URLs más relevantes; (3) extrae claims verificables, cada uno con su URL exacta. NO inventes fuentes. Devuelve JSON {\"sources\": [{\"url\": string, \"claims\": [string]}]}.')},\n    label: \"investigar: \" + String(q).slice(0, 60),\n    readOnly: true,\n    schema: { type: \"object\", properties: { sources: { type: \"array\", items: { type: \"object\", properties: { url: { type: \"string\" }, claims: { type: \"array\", items: { type: \"string\" } } }, required: [\"url\", \"claims\"] } } }, required: [\"sources\"] }\n  })\n))\nconst allSources = gathered.filter(Boolean).flatMap((g) => (g && g.sources) || [])\n\nphase(\"Verify\")\nconst verified = await agent({\n  prompt: ${q(`Verifica los claims recopilados. Para cada claim, comprueba que tenga al menos ${minSupport} fuentes independientes que lo respalden. Devuelve JSON {\"verifiedClaims\": [{ \"claim\": string, \"sources\": [string] }], \"uncertain\": [string]}.`)},\n  label: \"verificar claims (\" + allSources.length + \" fuentes)\",\n  readOnly: true,\n  schema: { type: \"object\", properties: { verifiedClaims: { type: \"array\", items: { type: \"object\", properties: { claim: { type: \"string\" }, sources: { type: \"array\", items: { type: \"string\" } } }, required: [\"claim\", \"sources\"] } }, uncertain: { type: \"array\", items: { type: \"string\" } } }, required: [\"verifiedClaims\", \"uncertain\"] }\n})\n\nphase(\"Report\")\nconst report = await agent({\n  prompt: ${q(\"Escribe un informe en Markdown sobre: \")} + (args.question ?? \"\") +\n    ${q('\\n\\nUsa SOLO los claims verificados, citando las fuentes como [1], [2]... con la lista de fuentes al final. Marca explícitamente lo incierto. Devuelve el informe en JSON {\"report\": string}.')},\n  label: \"redactar informe\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn report ? report.report : null\n`;\n}\n\n/** Code-review: diff por módulo → reviewers paralelos → síntesis con severidad. */\nexport function generateCodeReviewScript(options: { reviewers?: number } = {}): string {\n\tconst reviewers = Math.min(Math.max(options.reviewers ?? 3, 1), 6);\n\tconst perspectives = [\n\t\t\"bugs y errores lógicos\",\n\t\t\"seguridad y límites de confianza\",\n\t\t\"mantenibilidad y deuda técnica\",\n\t].slice(0, reviewers);\n\treturn `export const meta = {\n  \"name\": \"code_review\",\n  \"description\": \"Revisión de código con reviewers paralelos y síntesis por severidad\",\n  \"phases\": [\n    { \"title\": \"Diff\" },\n    { \"title\": \"Review\" },\n    { \"title\": \"Synthesize\" }\n  ]\n}\n\nphase(\"Diff\")\nconst diff = await agent({\n  prompt: ${q('Obtén el diff del cambio (git diff HEAD~1 o el rango indicado en args.diff). Devuelve JSON {\"diff\": string} con el diff completo (máx 10000 chars).')},\n  label: \"obtener diff\",\n  schema: { type: \"object\", properties: { diff: { type: \"string\" } }, required: [\"diff\"] }\n})\n\nphase(\"Review\")\nconst perspectives = ${JSON.stringify(perspectives)}\nconst reviews = await parallel(perspectives.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Revisa el siguiente diff desde la perspectiva: \")} + p +\n      ${q(\"\\n\\nDIFF:\\n\")} + (diff ? diff.diff : \"(sin diff)\") +\n      ${q('\\n\\nPara cada hallazgo cita archivo:línea. NO inventes. Devuelve JSON {\"findings\": [{\"severity\": \"critical|major|minor\", \"file\": string, \"line\": number, \"issue\": string, \"suggestion\": string}]}.')},\n    label: \"revisar: \" + p,\n    readOnly: true,\n    schema: { type: \"object\", properties: { findings: { type: \"array\", items: { type: \"object\", properties: { severity: { type: \"string\" }, file: { type: \"string\" }, line: { type: \"number\" }, issue: { type: \"string\" }, suggestion: { type: \"string\" } }, required: [\"severity\", \"file\", \"issue\"] } } }, required: [\"findings\"] }\n  })\n))\n\nphase(\"Synthesize\")\nconst synthesis = await agent({\n  prompt: ${q('Sintetiza estos hallazgos de revisión en un informe final Markdown ordenado por severidad (crítico primero), sin duplicados y con las citas archivo:línea. Devuelve JSON {\"report\": string}.')},\n  label: \"sintetizar hallazgos\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn synthesis ? synthesis.report : null\n`;\n}\n\n/**\n * Product-build (Ada Intelligence, §4): acceptance criteria → fases TDD →\n * verify ejecuta los tests → done con verified_by y evidencia.\n */\nexport function generateProductBuildScript(): string {\n\treturn `export const meta = {\n  \"name\": \"product_build\",\n  \"description\": \"Construcción de producto con acceptance criteria y verify con evidencia\",\n  \"phases\": [\n    { \"title\": \"Frame\" },\n    { \"title\": \"Plan\" },\n    { \"title\": \"Build\" },\n    { \"title\": \"Verify\" },\n    { \"title\": \"Done\" }\n  ]\n}\n\nphase(\"Frame\")\nconst framed = await agent({\n  prompt: ${q(\"Enmarca el producto para este brief: \")} + ((args.brief ?? args.acceptanceCriteria) ?? \"\") +\n    ${q('\\n\\nDefine acceptance criteria observables y medibles. Devuelve JSON {\"criteria\": [{\"id\": string, \"description\": string}]} (máx 6).')},\n  label: \"definir criterios\",\n  schema: { type: \"object\", properties: { criteria: { type: \"array\", items: { type: \"object\", properties: { id: { type: \"string\" }, description: { type: \"string\" } }, required: [\"id\", \"description\"] } } }, required: [\"criteria\"] }\n})\nconst criteria = (framed && framed.criteria) || []\n\nphase(\"Plan\")\nconst planned = await agent({\n  prompt: ${q('Planifica las tareas para cumplir estos criterios. Por cada criterio indica el test que lo verifica. Devuelve JSON {\"tasks\": [{\"title\": string, \"criterion\": string, \"test\": string}]}.\\n\\nCriterios:\\n')} +\n    JSON.stringify(criteria),\n  label: \"planificar tareas\",\n  schema: { type: \"object\", properties: { tasks: { type: \"array\", items: { type: \"object\", properties: { title: { type: \"string\" }, criterion: { type: \"string\" }, test: { type: \"string\" } }, required: [\"title\", \"criterion\"] } } }, required: [\"tasks\"] }\n})\n\nphase(\"Build\")\nconst built = await parallel((planned && planned.tasks || []).map((t, i) => () =>\n  agent({\n    prompt: ${q(\"Tarea: \")} + t.title + ${q(\"\\nCriterio que resuelve: \")} + t.criterion +\n      ${q(\"\\nImplementa el mínimo y escribe el test: \")} + (t.test ?? \"\") +\n      ${q('\\nEjecuta el test y confirma. Devuelve el archivo que cambiaste en {\"file\": string, \"verified\": boolean}.')},\n    label: \"construir: \" + t.title,\n    isolation: \"worktree\",\n    schema: { type: \"object\", properties: { file: { type: \"string\" }, verified: { type: \"boolean\" } }, required: [\"file\", \"verified\"] }\n  })\n))\nconst artifacts = built.filter(Boolean).filter((b) => b && b.verified)\n\nphase(\"Verify\")\nconst verification = await agent({\n  prompt: ${q('Ejecuta el/los comando(s) de verificación del proyecto (args.verifyCommand o el test runner default). Para cada criterio, confirma con evidencia archivo:línea o salida de test. Devuelve JSON {\"results\": [{\"criterion\": string, \"verified_by\": string, \"evidence\": string}]}.')},\n  label: \"verificar criterios (\" + criteria.length + \")\",\n  schema: { type: \"object\", properties: { results: { type: \"array\", items: { type: \"object\", properties: { criterion: { type: \"string\" }, verified_by: { type: \"string\" }, evidence: { type: \"string\" } }, required: [\"criterion\", \"verified_by\", \"evidence\"] } } }, required: [\"results\"] }\n})\n\nphase(\"Done\")\nconst done = await agent({\n  prompt: ${q('Redacta el informe final de build. Solo declara done si CADA criterio tiene verified_by y evidencia. Devuelve JSON {\"report\": string, \"done\": boolean, \"gaps\": [string]}.')},\n  label: \"informe final\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" }, done: { type: \"boolean\" }, gaps: { type: \"array\", items: { type: \"string\" } } }, required: [\"report\", \"done\"] }\n})\n\nreturn done ? done.report || JSON.stringify(done) : null\n`;\n}\n\n/**\n * Codebase-audit (§4): módulos → auditoría paralela (seguridad, deuda, bugs,\n * compliance) → informe + (opcional) nodos QA_FINDING/RISK del grafo.\n */\nexport function generateCodebaseAuditScript(options: { angles?: number; graph?: boolean } = {}): string {\n\tconst angles = Math.min(Math.max(options.angles ?? 4, 1), 8);\n\tconst perspectives = [\n\t\t\"seguridad (injection, secrets, límites de confianza)\",\n\t\t\"deuda técnica y arquitectura\",\n\t\t\"bugs y correctitud\",\n\t\t\"cumplimiento / RGPD / datos personales\",\n\t].slice(0, angles);\n\tconst graphHooks = options.graph\n\t\t? \"\\n\\nTras el informe, usa la tool graph_add_nodes para registrar QA_FINDING y RISK con sus citas.\"\n\t\t: \"\";\n\treturn `export const meta = {\n  \"name\": \"codebase_audit\",\n  \"description\": \"Auditoría del codebase con ángulos paralelos y síntesis\",\n  \"phases\": [\n    { \"title\": \"Walk\" },\n    { \"title\": \"Audit\" },\n    { \"title\": \"Report\" }\n  ]\n}\n\nphase(\"Walk\")\nconst modules = await agent({\n  prompt: ${q(`Audita este repo: (args.path ?? \".\"). En qué módulos se dividiría la auditoría. Devuelve JSON {\"modules\": [string]} (máx ${angles}).`)},\n  label: \"identificar módulos\",\n  schema: { type: \"object\", properties: { modules: { type: \"array\", items: { type: \"string\" } } }, required: [\"modules\"] }\n})\n\nphase(\"Audit\")\nconst perspectives = ${JSON.stringify(perspectives)}\nconst audits = await parallel(perspectives.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Audita el módulo(s) desde la perspectiva: \")} + p +\n      ${q(\"\\nMódulos: \")} + JSON.stringify((modules && modules.modules) || []) +\n      ${q(`\\nPara cada hallazgo cita archivo:línea. Devuelve JSON {\"findings\": [{\"type\": \"RISK|QA_FINDING\", \"severity\": string, \"file\": string, \"line\": number, \"issue\": string}]}.${graphHooks}`)},\n    label: \"auditar: \" + p,\n    schema: { type: \"object\", properties: { findings: { type: \"array\", items: { type: \"object\", properties: { type: { type: \"string\" }, severity: { type: \"string\" }, file: { type: \"string\" }, issue: { type: \"string\" } }, required: [\"type\", \"severity\", \"file\", \"issue\"] } } }, required: [\"findings\"] }\n  })\n))\n\nphase(\"Report\")\nconst report = await agent({\n  prompt: ${q('Sintetiza los hallazgos de auditoría en un informe Markdown ordenado por severidad, agrupado por perspectiva, con citas archivo:línea y recomendaciones priorizadas. Devuelve JSON {\"report\": string}.')},\n  label: \"sintetizar auditoría\",\n  schema: { type: \"object\", properties: { report: { type: \"string\" } }, required: [\"report\"] }\n})\n\nreturn report ? report.report : null\n`;\n}\n\n/**\n * Multi-perspective (§4): el mismo problema desde N ángulos → síntesis con\n * desacuerdos explícitos (no consenso falso).\n */\nexport function generateMultiPerspectiveScript(options: { perspectives?: number } = {}): string {\n\tconst n = Math.min(Math.max(options.perspectives ?? 4, 2), 8);\n\tconst list = [\n\t\t\"correctitud e invariantes\",\n\t\t\"rendimiento y escalabilidad\",\n\t\t\"seguridad y confianza\",\n\t\t\"mantenibilidad y claridad\",\n\t\t\"producto y UX\",\n\t\t\"coste de operación\",\n\t].slice(0, n);\n\treturn `export const meta = {\n  \"name\": \"multi_perspective\",\n  \"description\": \"Análisis del mismo problema desde N perspectivas con desacuerdos explícitos\",\n  \"phases\": [\n    { \"title\": \"Perspectives\" },\n    { \"title\": \"Synthesize\" }\n  ]\n}\n\nphase(\"Perspectives\")\nconst views = await parallel(${JSON.stringify(list)}.map((p, i) => () =>\n  agent({\n    prompt: ${q(\"Analiza este problema: \")} + (args.problem ?? \"\") +\n      ${q(\"\\nDesde la perspectiva: \")} + p +\n      ${q('\\nDa tu análisis, recomendación y riesgos. Devuelve JSON {\"perspective\": string, \"recommendation\": string, \"risks\": [string]}.')},\n    label: \"perspectiva: \" + p,\n    schema: { type: \"object\", properties: { perspective: { type: \"string\" }, recommendation: { type: \"string\" }, risks: { type: \"array\", items: { type: \"string\" } } }, required: [\"perspective\", \"recommendation\"] }\n  })\n))\n\nphase(\"Synthesize\")\nconst synthesis = await agent({\n  prompt: ${q('Sintetiza los análisis. SEÑALA EXPLÍCITAMENTE los desacuerdos entre perspectivas (no creas consenso falso). Devuelve JSON {\"summary\": string, \"disagreements\": [string], \"recommended\": string}.')},\n  label: \"sintetizar análisis\",\n  schema: { type: \"object\", properties: { summary: { type: \"string\" }, disagreements: { type: \"array\", items: { type: \"string\" } }, recommended: { type: \"string\" } }, required: [\"summary\", \"recommended\"] }\n})\n\nreturn synthesis ? synthesis.summary || JSON.stringify(synthesis) : null\n`;\n}\n"]}

package/dist/core/workflows/goal-engine/engine.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Ada Intelligence Engine — GoalEngine (modelo contenedor, estilo Claude Code).
+ *
+ * El goal es un CONTENEDOR de alto nivel: objetivo + doneCriteria + estado +
+ * frenos. NO tiene pasos propios — los pasos viven en los workflows dinámicos
+ * que desencadena. Cada sub-tarea del goal (tasks) lanza un workflow
+ * (`launchWorkflow` inyectable → WorkflowManager). Cuando todas las sub-tareas
+ * terminan, el juez verifica los doneCriteria y decide done/continue.
+ *
+ * Diseño: agnóstico del LLM — `launchWorkflow` (lanza el flujo dinámico de una
+ * sub-tarea) y `judge` (juez) son inyectables. Frenos integrados: maxTurns,
+ * repeat detector, stop-file (~/.ada-stop), budget, pausa ante decisiones
+ * irreversibles.
+ */
+import type { AskUserQuestion, EvidenceItem, GoalEventListener, GoalFrenos, GoalJudgeFn, GoalPersistence, GoalReplanFn, GoalState, Task } from "./types.ts";
+export interface GoalEngineOptions {
+    persistence: GoalPersistence;
+    /** Lanza el workflow dinámico de una sub-tarea → runId (goal-contenedor). */
+    launchWorkflow: (input: {
+        goalId: string;
+        goal: string;
+        taskId: string;
+        taskTitle: string;
+        doneCriteria: string[];
+        verifyCommand: string;
+        sessionId?: string;
+    }) => Promise<{
+        runId: string;
+    }>;
+    judge: GoalJudgeFn;
+    /** P1: re-planificación completa tras veredicto continue (opcional). */
+    replanFn?: GoalReplanFn;
+    frenos?: Partial<GoalFrenos>;
+    onEvent?: GoalEventListener;
+    /** Comprobador del stop-file (inyectable para tests). */
+    stopFileExists?: (path: string) => boolean;
+    /** P5: modo plan-only — no lanzar workflows hasta approve del plan. */
+    planOnly?: boolean;
+    /** Raíz del proyecto para la huella anti-cheat. Default: process.cwd(). */
+    cwd?: string;
+    /** Huella del árbol de trabajo (inyectable para tests). */
+    fingerprint?: (cwd: string) => Promise<string | undefined>;
+    now?: () => string;
+}
+export declare class GoalEngine {
+    private persistence;
+    /** Lock por-goal: nunca dos ticks concurrentes del mismo goal. */
+    private _tickInFlight;
+    /** Auto-continuación en vuelo tras `onWorkflowFinished` (ver `settle`). */
+    private _autoTick;
+    private launchWorkflow;
+    private judge;
+    private replanFn?;
+    private frenos;
+    private onEvent?;
+    private stopFileExists;
+    private planOnly;
+    private cwd;
+    private fingerprint;
+    private now;
+    /** cache en memoria: id → estado (el disco es la fuente de verdad). */
+    private cache;
+    constructor(options: GoalEngineOptions);
+    /** Crea un goal en estado setup (contrato). Devuelve el id para aprobar. */
+    createGoal(input: {
+        goal: string;
+        doneCriteria: string[];
+        verifyCommand: string;
+        sessionId?: string;
+    }): Promise<GoalState>;
+    /** Añade una tarea al TODO del goal sin reemplazar el plan. */
+    addTask(goalId: string, title: string): Promise<GoalState>;
+    /** Aprueba el contrato → el bucle puede arrancar. */
+    approve(goalId: string): Promise<GoalState>;
+    /**
+     * Un tick del bucle: se llama cuando el agente principal se ha settleado.
+     * Solo avanza si: status active, sin waiting, sin stop-file, bajo los
+     * límites (maxTurns, budget, repeat tolerance).
+     */
+    tick(goalId: string): Promise<{
+        advanced: boolean;
+        state: GoalState;
+        reason?: string;
+    }>;
+    private _tickInner;
+    /**
+     * Evento del WorkflowManager: una sub-tarea terminó su workflow.
+     * Marca la task done/failed, acumula tokens/coste del run en el presupuesto
+     * del goal (freno budgetTokens/costBudget), y aplica el repeat detector
+     * (sub-tareas fallidas consecutivas → pause). El siguiente tick decide.
+     */
+    onWorkflowFinished(workflowRunId: string, ok: boolean, summary?: string, usage?: {
+        tokens?: number;
+        cost?: number;
+    }): Promise<GoalState | null>;
+    /**
+     * Espera a la auto-continuación en vuelo. Pensado para tests, que necesitan
+     * un punto determinista tras `onWorkflowFinished`; en producción el tick es
+     * fire-and-forget y nadie lo espera.
+     */
+    settle(): Promise<void>;
+    /** Juez obligatorio: revisa SOLO goal + criteria + evidencia citada. */
+    runJudge(state: GoalState): Promise<GoalState>;
+    /** Completa el goal con evidencia — exige juez done y evidencia citada. */
+    complete(goalId: string, summary: string, evidence: EvidenceItem[]): Promise<GoalState>;
+    /** Reemplaza la checklist completa (tool `todo`). */
+    replaceTasks(goalId: string, tasks: Task[]): Promise<GoalState>;
+    /**
+     * P1: re-planificación completa. Genera un nuevo plan con el LLM
+     * (replanFn) aprendiendo de la evidencia y del último veredicto del juez,
+     * y arranca la iteración N+1. Sin replanFn → error suave (GoalError).
+     */
+    replan(goalId: string): Promise<GoalState>;
+    private autoReplanAfterContinue;
+    pause(goalId: string, reason?: string): Promise<GoalState>;
+    resume(goalId: string): Promise<GoalState>;
+    blocked(goalId: string, reason: string): Promise<GoalState>;
+    askUser(goalId: string, reason: string, questions: AskUserQuestion[]): Promise<GoalState>;
+    answerQuestions(goalId: string, answers: Record<string, string[]>): Promise<GoalState>;
+    get(goalId: string): Promise<GoalState | null>;
+    list(): Promise<Array<{
+        id: string;
+        goal: string;
+        status: GoalState["status"];
+        phase: GoalState["phase"];
+        updatedAt: string;
+    }>>;
+    private checkBrakes;
+    private mustLoad;
+    private commit;
+    private emit;
+}
+export declare function isBrakeRelevant(reason: string): boolean;
+//# sourceMappingURL=engine.d.ts.map