@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/prompt-optimizer.js

@@ -0,0 +1,138 @@
+/**
+ * Optimizador de prompt autónomo (Ada Intelligence Engine).
+ *
+ * Antes de procesar la petición del usuario, el sistema la analiza contra las
+ * mejores prácticas de ingeniería de prompts (basadas en las guías de Claude —
+ * claridad, contexto, ejemplos, estructura XML, rol, formato de salida, criterios
+ * de éxito, alcance) y decide:
+ *
+ *   1. CLARIFY  — hay gaps de información críticos → genera preguntas de
+ *                 clarificación (máx. 3) para dejar el prompt sin huecos.
+ *   2. ENHANCE  — la petición es suficiente → la reescribe como un prompt
+ *                 estructurado y sin ambigüedad.
+ *
+ * El resultado es un JSON estructurado (never free-text) para consumo fiable
+ * por la sesión, el CLI y el desktop.
+ */
+/** Guías de ingeniería de prompts que codifica el optimizador. */
+const OPTIMIZER_SYSTEM_PROMPT = `Eres un experto en ingeniería de prompts. Tu trabajo es tomar la petición de un usuario y producir una versión perfecta, sin huecos, que maximice la calidad de la respuesta de cualquier modelo LLM.
+
+Aplica estas mejores prácticas (basadas en las guías de referencia de Anthropic):
+
+1. CLARIDAD: sé específico sobre qué se quiere, el formato de salida deseado y las restricciones. Instrucciones como pasos numerados o bullets cuando el orden importa.
+2. CONTEXTO: añade el contexto o motivación detrás de la petición ("por qué es importante") para que el modelo entienda el objetivo.
+3. ROL: da al modelo un rol claro y enfocado ("Actúa como un ingeniero de software senior especializado en X").
+4. ESTRUCTURA XML: organiza el prompt con etiquetas descriptivas (<context>, <instructions>, <input>, <constraints>, <output_format>) para eliminar ambigüedad de parseo.
+5. EJEMPLOS: incluye 1-3 ejemplos concretos (few-shot) cuando el formato de salida no sea obvio.
+6. FORMATO DE SALIDA: especifica exactamente el formato esperado (JSON, markdown, resumen de N líneas, código con tests...).
+7. CRITERIOS DE ÉXITO: define qué constituye un resultado correcto y verificación (por ejemplo, "ejecuta los tests antes de terminar").
+8. ALCANCE: limita el trabajo ("no añadas features fuera de lo pedido", "solo modifica estos archivos").
+9. ACCIÓN vs SUGERENCIA: si el usuario pide un cambio, sé explícito sobre que debe IMPLEMENTARLO, no solo sugerirlo ("Implementa X" en vez de "¿podrías sugerir cambios a X?").
+10. SIN GAPS: identifica la información que falta y que cambiaría materialmente el resultado.
+
+RUTINA:
+Paso 1 — Analiza la petición del usuario contra las 10 prácticas.
+Paso 2 — Decide si hay gaps CRÍTICOS (falta de contexto, ambigüedad sobre alcance/formato/destino que cambiaría el resultado):
+  - Si SÍ: decision = "clarify". Genera como máximo ${"{{MAX_QUESTIONS}}"} preguntas, cada una específica y accionable, que el usuario pueda responder en una línea. No hagas preguntas triviales.
+  - Si NO (o los gaps son menores): decision = "enhance". Reescribe el prompt completo como un prompt estructurado y profesional, SIN preguntar nada.
+Paso 3 — summary: una frase corta (máx. 12 palabras, en el idioma del usuario) sobre lo que se mejoró (o que se necesitan aclaraciones).
+
+REGLAS DE SALIDA:
+- Responde SOLO JSON válido con esta forma exacta:
+  {"decision":"clarify"|"enhance","questions":[...],"enhanced":"...","summary":"..."}
+- questions vacío si decision es enhance. enhanced vacío si decision es clarify.
+- Si el prompt ya es excelente, enhance puede devolverlo casi igual (solo estructura) — no inflar.
+- Preserva el idioma del usuario en el prompt mejorado y en summary.`;
+/**
+ * Optimiza (o solicita clarificación para) la petición del usuario.
+ * Usa el callback LLM inyectado. Nunca lanza: en fallo devuelve la petición
+ * original sin cambios con decision "enhance".
+ */
+export async function optimizeUserPrompt(input, complete) {
+    const maxQuestions = input.maxQuestions ?? 3;
+    const userContent = [
+        "<user_request>",
+        input.text,
+        "</user_request>",
+        input.context?.projectDir ? `<project_dir>${input.context.projectDir}</project_dir>` : "",
+        input.context?.activeGoal ? `<active_goal>${input.context.activeGoal}</active_goal>` : "",
+        input.context?.recentMessages?.length
+            ? `<conversation_context>\n${input.context.recentMessages.slice(-4).join("\n---\n")}\n</conversation_context>`
+            : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const systemPrompt = OPTIMIZER_SYSTEM_PROMPT.replace("{{MAX_QUESTIONS}}", String(maxQuestions));
+    try {
+        const raw = await complete(systemPrompt, userContent);
+        const parsed = parseOptimizerJson(raw);
+        if (!parsed)
+            return fallbackEnhance(input.text);
+        if (parsed.decision === "clarify" && input.forceEnhance) {
+            // Segunda pasada: mejorar sin preguntar (modo auto).
+            const forcedRaw = await complete(systemPrompt, userContent +
+                "\n\nIMPORTANTE: modo automático — NO hagas preguntas. " +
+                "Resuelve los gaps con supuestos razonables y devuelve SOLO un " +
+                'prompt mejorado con decision "enhance".');
+            const forced = parseOptimizerJson(forcedRaw);
+            if (forced && forced.decision === "enhance" && typeof forced.enhanced === "string" && forced.enhanced.trim()) {
+                return {
+                    decision: "enhance",
+                    questions: [],
+                    enhanced: forced.enhanced.trim(),
+                    summary: typeof forced.summary === "string" ? forced.summary : "",
+                };
+            }
+            return fallbackEnhance(input.text);
+        }
+        if (parsed.decision === "clarify") {
+            const questions = Array.isArray(parsed.questions)
+                ? parsed.questions
+                    .filter((q) => typeof q === "string" && q.trim().length > 0)
+                    .slice(0, maxQuestions)
+                : [];
+            if (questions.length === 0)
+                return fallbackEnhance(input.text);
+            return {
+                decision: "clarify",
+                questions,
+                enhanced: "",
+                summary: typeof parsed.summary === "string" && parsed.summary ? parsed.summary : "",
+            };
+        }
+        const enhanced = typeof parsed.enhanced === "string" && parsed.enhanced.trim() ? parsed.enhanced.trim() : input.text;
+        return {
+            decision: "enhance",
+            questions: [],
+            enhanced,
+            summary: typeof parsed.summary === "string" ? parsed.summary : "",
+        };
+    }
+    catch {
+        return fallbackEnhance(input.text);
+    }
+}
+/** Extrae JSON robusto de la salida del LLM (tolera texto alrededor y fences). */
+function parseOptimizerJson(raw) {
+    const cleaned = raw
+        .trim()
+        .replace(/^```(?:json)?/i, "")
+        .replace(/```$/, "")
+        .trim();
+    // Buscar el primer objeto JSON balanceado.
+    const start = cleaned.indexOf("{");
+    const end = cleaned.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start)
+        return null;
+    try {
+        return JSON.parse(cleaned.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+/** Fallback seguro: devuelve la petición tal cual (nunca degrada la experiencia). */
+function fallbackEnhance(text) {
+    return { decision: "enhance", questions: [], enhanced: text, summary: "" };
+}
+//# sourceMappingURL=prompt-optimizer.js.map

package/dist/core/prompt-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-optimizer.js","sourceRoot":"","sources":["../../src/core/prompt-optimizer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Optimizador de prompt autónomo (Ada Intelligence Engine).\n *\n * Antes de procesar la petición del usuario, el sistema la analiza contra las\n * mejores prácticas de ingeniería de prompts (basadas en las guías de Claude —\n * claridad, contexto, ejemplos, estructura XML, rol, formato de salida, criterios\n * de éxito, alcance) y decide:\n *\n *   1. CLARIFY  — hay gaps de información críticos → genera preguntas de\n *                 clarificación (máx. 3) para dejar el prompt sin huecos.\n *   2. ENHANCE  — la petición es suficiente → la reescribe como un prompt\n *                 estructurado y sin ambigüedad.\n *\n * El resultado es un JSON estructurado (never free-text) para consumo fiable\n * por la sesión, el CLI y el desktop.\n */\n\nexport type PromptOptimizerDecision = \"clarify\" | \"enhance\";\n\nexport interface PromptOptimizerInput {\n\t/** La petición original del usuario. */\n\ttext: string;\n\t/** Contexto disponible: proyecto, objetivo activo, mensajes recientes. */\n\tcontext?: {\n\t\tprojectDir?: string;\n\t\tactiveGoal?: string;\n\t\trecentMessages?: string[];\n\t};\n\t/** Máximo de preguntas de clarificación (default 3). */\n\tmaxQuestions?: number;\n\t/**\n\t * Modo \"auto\": si el LLM pide clarificar, NO preguntar al usuario —\n\t * hacer una segunda pasada que fuerza un prompt mejorado con supuestos\n\t * razonables (mejora sin interrumpir).\n\t */\n\tforceEnhance?: boolean;\n}\n\nexport interface PromptOptimizerResult {\n\tdecision: PromptOptimizerDecision;\n\t/** Preguntas de clarificación (solo si decision === \"clarify\"). */\n\tquestions: string[];\n\t/** Prompt mejorado y estructurado (solo si decision === \"enhance\"). */\n\tenhanced: string;\n\t/** Resumen breve de qué se mejoró (para mostrar al usuario). */\n\tsummary: string;\n}\n\n/** Callback que ejecuta una llamada LLM (inyectado por la sesión). */\nexport type PromptOptimizerComplete = (systemPrompt: string, userContent: string) => Promise<string>;\n\n/** Guías de ingeniería de prompts que codifica el optimizador. */\nconst OPTIMIZER_SYSTEM_PROMPT = `Eres un experto en ingeniería de prompts. Tu trabajo es tomar la petición de un usuario y producir una versión perfecta, sin huecos, que maximice la calidad de la respuesta de cualquier modelo LLM.\n\nAplica estas mejores prácticas (basadas en las guías de referencia de Anthropic):\n\n1. CLARIDAD: sé específico sobre qué se quiere, el formato de salida deseado y las restricciones. Instrucciones como pasos numerados o bullets cuando el orden importa.\n2. CONTEXTO: añade el contexto o motivación detrás de la petición (\"por qué es importante\") para que el modelo entienda el objetivo.\n3. ROL: da al modelo un rol claro y enfocado (\"Actúa como un ingeniero de software senior especializado en X\").\n4. ESTRUCTURA XML: organiza el prompt con etiquetas descriptivas (<context>, <instructions>, <input>, <constraints>, <output_format>) para eliminar ambigüedad de parseo.\n5. EJEMPLOS: incluye 1-3 ejemplos concretos (few-shot) cuando el formato de salida no sea obvio.\n6. FORMATO DE SALIDA: especifica exactamente el formato esperado (JSON, markdown, resumen de N líneas, código con tests...).\n7. CRITERIOS DE ÉXITO: define qué constituye un resultado correcto y verificación (por ejemplo, \"ejecuta los tests antes de terminar\").\n8. ALCANCE: limita el trabajo (\"no añadas features fuera de lo pedido\", \"solo modifica estos archivos\").\n9. ACCIÓN vs SUGERENCIA: si el usuario pide un cambio, sé explícito sobre que debe IMPLEMENTARLO, no solo sugerirlo (\"Implementa X\" en vez de \"¿podrías sugerir cambios a X?\").\n10. SIN GAPS: identifica la información que falta y que cambiaría materialmente el resultado.\n\nRUTINA:\nPaso 1 — Analiza la petición del usuario contra las 10 prácticas.\nPaso 2 — Decide si hay gaps CRÍTICOS (falta de contexto, ambigüedad sobre alcance/formato/destino que cambiaría el resultado):\n  - Si SÍ: decision = \"clarify\". Genera como máximo ${\"{{MAX_QUESTIONS}}\"} preguntas, cada una específica y accionable, que el usuario pueda responder en una línea. No hagas preguntas triviales.\n  - Si NO (o los gaps son menores): decision = \"enhance\". Reescribe el prompt completo como un prompt estructurado y profesional, SIN preguntar nada.\nPaso 3 — summary: una frase corta (máx. 12 palabras, en el idioma del usuario) sobre lo que se mejoró (o que se necesitan aclaraciones).\n\nREGLAS DE SALIDA:\n- Responde SOLO JSON válido con esta forma exacta:\n  {\"decision\":\"clarify\"|\"enhance\",\"questions\":[...],\"enhanced\":\"...\",\"summary\":\"...\"}\n- questions vacío si decision es enhance. enhanced vacío si decision es clarify.\n- Si el prompt ya es excelente, enhance puede devolverlo casi igual (solo estructura) — no inflar.\n- Preserva el idioma del usuario en el prompt mejorado y en summary.`;\n\n/**\n * Optimiza (o solicita clarificación para) la petición del usuario.\n * Usa el callback LLM inyectado. Nunca lanza: en fallo devuelve la petición\n * original sin cambios con decision \"enhance\".\n */\nexport async function optimizeUserPrompt(\n\tinput: PromptOptimizerInput,\n\tcomplete: PromptOptimizerComplete,\n): Promise<PromptOptimizerResult> {\n\tconst maxQuestions = input.maxQuestions ?? 3;\n\n\tconst userContent = [\n\t\t\"<user_request>\",\n\t\tinput.text,\n\t\t\"</user_request>\",\n\t\tinput.context?.projectDir ? `<project_dir>${input.context.projectDir}</project_dir>` : \"\",\n\t\tinput.context?.activeGoal ? `<active_goal>${input.context.activeGoal}</active_goal>` : \"\",\n\t\tinput.context?.recentMessages?.length\n\t\t\t? `<conversation_context>\\n${input.context.recentMessages.slice(-4).join(\"\\n---\\n\")}\\n</conversation_context>`\n\t\t\t: \"\",\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\");\n\n\tconst systemPrompt = OPTIMIZER_SYSTEM_PROMPT.replace(\"{{MAX_QUESTIONS}}\", String(maxQuestions));\n\n\ttry {\n\t\tconst raw = await complete(systemPrompt, userContent);\n\t\tconst parsed = parseOptimizerJson(raw);\n\t\tif (!parsed) return fallbackEnhance(input.text);\n\t\tif (parsed.decision === \"clarify\" && input.forceEnhance) {\n\t\t\t// Segunda pasada: mejorar sin preguntar (modo auto).\n\t\t\tconst forcedRaw = await complete(\n\t\t\t\tsystemPrompt,\n\t\t\t\tuserContent +\n\t\t\t\t\t\"\\n\\nIMPORTANTE: modo automático — NO hagas preguntas. \" +\n\t\t\t\t\t\"Resuelve los gaps con supuestos razonables y devuelve SOLO un \" +\n\t\t\t\t\t'prompt mejorado con decision \"enhance\".',\n\t\t\t);\n\t\t\tconst forced = parseOptimizerJson(forcedRaw);\n\t\t\tif (forced && forced.decision === \"enhance\" && typeof forced.enhanced === \"string\" && forced.enhanced.trim()) {\n\t\t\t\treturn {\n\t\t\t\t\tdecision: \"enhance\",\n\t\t\t\t\tquestions: [],\n\t\t\t\t\tenhanced: forced.enhanced.trim(),\n\t\t\t\t\tsummary: typeof forced.summary === \"string\" ? forced.summary : \"\",\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn fallbackEnhance(input.text);\n\t\t}\n\t\tif (parsed.decision === \"clarify\") {\n\t\t\tconst questions = Array.isArray(parsed.questions)\n\t\t\t\t? parsed.questions\n\t\t\t\t\t\t.filter((q): q is string => typeof q === \"string\" && q.trim().length > 0)\n\t\t\t\t\t\t.slice(0, maxQuestions)\n\t\t\t\t: [];\n\t\t\tif (questions.length === 0) return fallbackEnhance(input.text);\n\t\t\treturn {\n\t\t\t\tdecision: \"clarify\",\n\t\t\t\tquestions,\n\t\t\t\tenhanced: \"\",\n\t\t\t\tsummary: typeof parsed.summary === \"string\" && parsed.summary ? parsed.summary : \"\",\n\t\t\t};\n\t\t}\n\t\tconst enhanced =\n\t\t\ttypeof parsed.enhanced === \"string\" && parsed.enhanced.trim() ? parsed.enhanced.trim() : input.text;\n\t\treturn {\n\t\t\tdecision: \"enhance\",\n\t\t\tquestions: [],\n\t\t\tenhanced,\n\t\t\tsummary: typeof parsed.summary === \"string\" ? parsed.summary : \"\",\n\t\t};\n\t} catch {\n\t\treturn fallbackEnhance(input.text);\n\t}\n}\n\n/** Extrae JSON robusto de la salida del LLM (tolera texto alrededor y fences). */\nfunction parseOptimizerJson(raw: string): {\n\tdecision?: string;\n\tquestions?: unknown;\n\tenhanced?: unknown;\n\tsummary?: unknown;\n} | null {\n\tconst cleaned = raw\n\t\t.trim()\n\t\t.replace(/^```(?:json)?/i, \"\")\n\t\t.replace(/```$/, \"\")\n\t\t.trim();\n\t// Buscar el primer objeto JSON balanceado.\n\tconst start = cleaned.indexOf(\"{\");\n\tconst end = cleaned.lastIndexOf(\"}\");\n\tif (start === -1 || end === -1 || end <= start) return null;\n\ttry {\n\t\treturn JSON.parse(cleaned.slice(start, end + 1)) as {\n\t\t\tdecision?: string;\n\t\t\tquestions?: unknown;\n\t\t\tenhanced?: unknown;\n\t\t\tsummary?: unknown;\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/** Fallback seguro: devuelve la petición tal cual (nunca degrada la experiencia). */\nfunction fallbackEnhance(text: string): PromptOptimizerResult {\n\treturn { decision: \"enhance\", questions: [], enhanced: text, summary: \"\" };\n}\n"]}

package/dist/core/prompts/montar.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Monta el prompt del sistema desde `sistema.md`.
+ *
+ * DE DÓNDE VIENE ESTO. El prompt de Ada era una cadena dentro de
+ * `system-prompt.ts` con dos directrices —«Be concise» y «Show file paths
+ * clearly»— más un bloque sobre dónde vive la documentación de Ada. Es decir:
+ * le explicábamos al modelo dónde están NUESTROS documentos y no le
+ * explicábamos cómo programar bien.
+ *
+ * Y había un dato peor, medido: de las TRECE capacidades construidas en cuatro
+ * tandas de trabajo (`lsp`, `ast_edit`, `hashline`, `remoto`, `web_search`,
+ * `computer`, `browser`, `audit`, `banco`, `cleanse`, `discover`, `review`,
+ * `ast_search`), **ninguna aparecía en el prompt**. De nuestras tools, solo UNA
+ * definía `promptSnippet`. El modelo veía el nombre y nada más: ni cuándo usar
+ * `lsp_references` antes de renombrar, ni que `ast_edit` es para codemods.
+ *
+ * Es capacidad construida y desenchufada en su forma más difícil de ver: la
+ * herramienta está registrada, así que NADA FALLA. Solo hay un agente peor de
+ * lo que debería, sin error que investigar.
+ *
+ * DOS DECISIONES QUE NO SON DE ESTILO:
+ *
+ * 1. **Si falta el `.md`, se LANZA.** Un `catch` que devolviera cadena vacía
+ *    dejaría al agente sin prompt del sistema —sin doctrina, sin contrato de
+ *    entrega, sin las reglas de cumplimiento— y arrancaría igual. Sería el
+ *    fallo que se lee como éxito en el sitio más caro posible. Como `dist/` es
+ *    superficie ciega para vitest (las pruebas leen `src/`, el paquete
+ *    publicado lee `dist/`), esto además convierte un `copy-assets` olvidado en
+ *    un arranque roto y visible en vez de en un agente silenciosamente tonto.
+ *
+ * 2. **Los nombres de herramienta salen del registro, no de la plantilla.** Si
+ *    alguien renombra `ast_search`, la línea del prompt que lo menciona se
+ *    queda mintiendo, y un prompt que nombra una tool inexistente le enseña al
+ *    modelo a desconfiar de sus instrucciones. Aquí la lista se construye desde
+ *    los nombres reales que recibe `montarPromptDelSistema`.
+ */
+import { type Contexto } from "./plantilla.ts";
+/** Qué sabe el montador sobre la sesión. Todo opcional salvo las tools. */
+export interface EntradaDelPrompt {
+    /** Los nombres de tool REALES y activos de esta sesión. */
+    nombresDeHerramienta: readonly string[];
+    /** Frases de una línea por tool, si la tool las aporta. */
+    frasesDeHerramienta?: Readonly<Record<string, string>>;
+    personalidad?: string;
+    /**
+     * `true` cuando la política de aprobación está en modo plan.
+     *
+     * Existe porque el modo plan estaba impuesto SOLO en código: `decidir()`
+     * devuelve `denegada` con política `modo-plan` para toda escritura y toda
+     * ejecución, y el prompt no lo mencionaba. El modelo intentaba editar, se
+     * llevaba un rechazo que no esperaba, y gastaba turnos aprendiendo por
+     * golpes una regla que se le podía haber dicho: el guardián estaba
+     * construido y el modelo no lo conocía.
+     */
+    modoPlan?: boolean;
+    /**
+     * Tools que el usuario ha denegado (`permissions.denied`).
+     *
+     * No es lo mismo que «no activa»: una tool denegada SIGUE en el inventario y
+     * en el conjunto activo, y lo que la para es `decidir()`, que consulta el
+     * `deny` del usuario en el paso 3 —antes del modo— y contesta `denegada` con
+     * política `deny-de-usuario`. Filtrar solo por `nivelDe` dejaba a la sección
+     * de modo plan prometiendo, por ejemplo, `web_fetch` con `permissions.denied:
+     * ["web_fetch"]` en settings: el rechazo inesperado que esta sección existe
+     * para evitar, servido por la propia sección.
+     */
+    toolsDenegadas?: readonly string[];
+}
+/** El contexto que ve la plantilla. Público porque las pruebas lo comprueban. */
+export declare function contextoDelPrompt(entrada: EntradaDelPrompt): Contexto;
+/** Solo para pruebas: olvida la plantilla cacheada. */
+export declare function __olvidarPlantillaParaPruebas(): void;
+/** El prompt del sistema de Ada, con las secciones que la sesión merece. */
+export declare function montarPromptDelSistema(entrada: EntradaDelPrompt): string;
+//# sourceMappingURL=montar.d.ts.map

package/dist/core/prompts/montar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"montar.d.ts","sourceRoot":"","sources":["../../../src/core/prompts/montar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAI3D,6EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAChC,4DAA2D;IAC3D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,4DAA2D;IAC3D,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAgDD,kFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAgCrE;AAsBD,uDAAuD;AACvD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,6EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIxE","sourcesContent":["/**\n * Monta el prompt del sistema desde `sistema.md`.\n *\n * DE DÓNDE VIENE ESTO. El prompt de Ada era una cadena dentro de\n * `system-prompt.ts` con dos directrices —«Be concise» y «Show file paths\n * clearly»— más un bloque sobre dónde vive la documentación de Ada. Es decir:\n * le explicábamos al modelo dónde están NUESTROS documentos y no le\n * explicábamos cómo programar bien.\n *\n * Y había un dato peor, medido: de las TRECE capacidades construidas en cuatro\n * tandas de trabajo (`lsp`, `ast_edit`, `hashline`, `remoto`, `web_search`,\n * `computer`, `browser`, `audit`, `banco`, `cleanse`, `discover`, `review`,\n * `ast_search`), **ninguna aparecía en el prompt**. De nuestras tools, solo UNA\n * definía `promptSnippet`. El modelo veía el nombre y nada más: ni cuándo usar\n * `lsp_references` antes de renombrar, ni que `ast_edit` es para codemods.\n *\n * Es capacidad construida y desenchufada en su forma más difícil de ver: la\n * herramienta está registrada, así que NADA FALLA. Solo hay un agente peor de\n * lo que debería, sin error que investigar.\n *\n * DOS DECISIONES QUE NO SON DE ESTILO:\n *\n * 1. **Si falta el `.md`, se LANZA.** Un `catch` que devolviera cadena vacía\n *    dejaría al agente sin prompt del sistema —sin doctrina, sin contrato de\n *    entrega, sin las reglas de cumplimiento— y arrancaría igual. Sería el\n *    fallo que se lee como éxito en el sitio más caro posible. Como `dist/` es\n *    superficie ciega para vitest (las pruebas leen `src/`, el paquete\n *    publicado lee `dist/`), esto además convierte un `copy-assets` olvidado en\n *    un arranque roto y visible en vez de en un agente silenciosamente tonto.\n *\n * 2. **Los nombres de herramienta salen del registro, no de la plantilla.** Si\n *    alguien renombra `ast_search`, la línea del prompt que lo menciona se\n *    queda mintiendo, y un prompt que nombra una tool inexistente le enseña al\n *    modelo a desconfiar de sus instrucciones. Aquí la lista se construye desde\n *    los nombres reales que recibe `montarPromptDelSistema`.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { nivelDe } from \"../aprobacion/politica.ts\";\nimport { type Contexto, renderizar } from \"./plantilla.ts\";\n\nconst NOMBRE = \"sistema.md\";\n\n/** Qué sabe el montador sobre la sesión. Todo opcional salvo las tools. */\nexport interface EntradaDelPrompt {\n\t/** Los nombres de tool REALES y activos de esta sesión. */\n\tnombresDeHerramienta: readonly string[];\n\t/** Frases de una línea por tool, si la tool las aporta. */\n\tfrasesDeHerramienta?: Readonly<Record<string, string>>;\n\tpersonalidad?: string;\n\t/**\n\t * `true` cuando la política de aprobación está en modo plan.\n\t *\n\t * Existe porque el modo plan estaba impuesto SOLO en código: `decidir()`\n\t * devuelve `denegada` con política `modo-plan` para toda escritura y toda\n\t * ejecución, y el prompt no lo mencionaba. El modelo intentaba editar, se\n\t * llevaba un rechazo que no esperaba, y gastaba turnos aprendiendo por\n\t * golpes una regla que se le podía haber dicho: el guardián estaba\n\t * construido y el modelo no lo conocía.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * No es lo mismo que «no activa»: una tool denegada SIGUE en el inventario y\n\t * en el conjunto activo, y lo que la para es `decidir()`, que consulta el\n\t * `deny` del usuario en el paso 3 —antes del modo— y contesta `denegada` con\n\t * política `deny-de-usuario`. Filtrar solo por `nivelDe` dejaba a la sección\n\t * de modo plan prometiendo, por ejemplo, `web_fetch` con `permissions.denied:\n\t * [\"web_fetch\"]` en settings: el rechazo inesperado que esta sección existe\n\t * para evitar, servido por la propia sección.\n\t */\n\ttoolsDenegadas?: readonly string[];\n}\n\n/**\n * Una línea por herramienta especializada, construida desde los nombres reales.\n *\n * Solo se listan las que el modelo confunde con `bash` — es donde la guía paga.\n * Enumerar `read` junto a veinte más diluye las que importan.\n */\nconst GUIA: ReadonlyArray<{ tool: string; linea: (n: string) => string }> = [\n\t{ tool: \"read\", linea: (n) => `File and directory reads → \\`${n}\\`, never \\`cat\\` or \\`ls\\` through the shell.` },\n\t{ tool: \"grep\", linea: (n) => `Regex search → \\`${n}\\`, never shell \\`grep\\`, \\`rg\\` or \\`awk\\`.` },\n\t{ tool: \"find\", linea: (n) => `Locating files by name or glob → \\`${n}\\`, never \\`find\\` or \\`fd\\`.` },\n\t{ tool: \"edit\", linea: (n) => `Surgical edits → \\`${n}\\`. Never rewrite a whole file to change a few lines.` },\n\t{ tool: \"write\", linea: (n) => `Creating or fully replacing a file → \\`${n}\\`.` },\n\t{\n\t\ttool: \"web_search\",\n\t\tlinea: (n) => `Anything you do not know and cannot read locally → \\`${n}\\`. Do not guess an API from memory.`,\n\t},\n];\n\n/**\n * La línea del modo plan que dice qué tools SIGUEN valiendo.\n *\n * Los nombres salen del conjunto REAL de tools activas filtrado por `nivelDe`,\n * el mismo clasificador que usa la política de aprobación: si alguien mueve una\n * tool de `LECTURA` a `ESCRITURA`, esta línea se mueve con ella. Escribirlos a\n * mano en la plantilla sería prometerle al modelo tools que quizá no tiene, y\n * un prompt que nombra una tool inexistente le enseña a desconfiar de sus\n * instrucciones.\n *\n * El filtro son las DOS condiciones que `decidir()` aplica antes de dejar pasar\n * una lectura en modo plan: nivel de lectura (paso 4) y no estar en el `deny`\n * del usuario (paso 3). Con solo la primera, `permissions.denied: [\"web_fetch\"]`\n * dejaba la línea prometiendo `web_fetch`.\n *\n * El caso vacío (`ada-cli --tools bash` en modo plan) no es decorativo: ahí el\n * agente no puede ni leer, y decirlo es mejor que dejar una lista en blanco que\n * el modelo interpretará como que puede con todo. Se calcula aquí en vez de con\n * un `{{#si}}` dentro del `{{#si modoPlan}}` porque anidar dos bloques del\n * mismo tipo borraba el resto de la sección en silencio (ver `plantilla.ts`).\n */\nfunction lineaDePlan(lectura: readonly string[]): string {\n\tif (lectura.length === 0) {\n\t\treturn \"No read-only tool is active in this session, so you cannot investigate either. Say exactly that and stop.\";\n\t}\n\treturn `Still available in this mode: ${lectura.map((n) => `\\`${n}\\``).join(\", \")}. Nothing else is.`;\n}\n\n/** El contexto que ve la plantilla. Público porque las pruebas lo comprueban. */\nexport function contextoDelPrompt(entrada: EntradaDelPrompt): Contexto {\n\tconst activas = new Set(entrada.nombresDeHerramienta);\n\tconst denegadas = new Set(entrada.toolsDenegadas ?? []);\n\tconst tiene = (prefijo: string) => [...activas].some((n) => n === prefijo || n.startsWith(`${prefijo}_`));\n\n\tconst herramientas: string[] = [];\n\tfor (const { tool, linea } of GUIA) {\n\t\tif (activas.has(tool)) herramientas.push(linea(tool));\n\t}\n\t// Y las que aportan su propia frase, que nadie más conoce.\n\tfor (const [nombre, frase] of Object.entries(entrada.frasesDeHerramienta ?? {})) {\n\t\tif (activas.has(nombre) && !GUIA.some((g) => g.tool === nombre)) {\n\t\t\therramientas.push(`\\`${nombre}\\`: ${frase}`);\n\t\t}\n\t}\n\n\treturn {\n\t\therramientas,\n\t\tpersonalidad: entrada.personalidad,\n\t\tmodoPlan: entrada.modoPlan === true,\n\t\tlineaHerramientasDePlan: lineaDePlan(\n\t\t\t[...activas].filter((n) => nivelDe(n) === \"lectura\" && !denegadas.has(n)).sort(),\n\t\t),\n\t\ttieneLsp: tiene(\"lsp\"),\n\t\ttieneEstructural: activas.has(\"ast_search\") || activas.has(\"ast_edit\"),\n\t\ttieneBash: activas.has(\"bash\"),\n\t\ttieneNavegador: tiene(\"browser\"),\n\t\ttieneEscritorio: tiene(\"computer\"),\n\t\t// El libro de auditoría no es una tool: es una propiedad del arnés, y\n\t\t// siempre está. Se declara explícito para que la plantilla no adivine.\n\t\ttieneAudit: true,\n\t};\n}\n\nlet cacheDeLaPlantilla: string | undefined;\n\n/** Lee `sistema.md` de junto a este módulo. Lanza si no está. */\nfunction leerPlantilla(): string {\n\tif (cacheDeLaPlantilla !== undefined) return cacheDeLaPlantilla;\n\tconst ruta = join(dirname(fileURLToPath(import.meta.url)), NOMBRE);\n\ttry {\n\t\tcacheDeLaPlantilla = readFileSync(ruta, \"utf-8\");\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`No se ha podido leer el prompt del sistema (${ruta}).\\n` +\n\t\t\t\t\"Arrancar sin él dejaría al agente sin doctrina, sin contrato de entrega y sin\\n\" +\n\t\t\t\t\"las reglas de cumplimiento, y lo haría en silencio. Si esto sale desde el\\n\" +\n\t\t\t\t\"paquete compilado, falta el paso `copy-assets` que lleva los .md a dist/.\\n\" +\n\t\t\t\t`Causa: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\treturn cacheDeLaPlantilla;\n}\n\n/** Solo para pruebas: olvida la plantilla cacheada. */\nexport function __olvidarPlantillaParaPruebas(): void {\n\tcacheDeLaPlantilla = undefined;\n}\n\n/** El prompt del sistema de Ada, con las secciones que la sesión merece. */\nexport function montarPromptDelSistema(entrada: EntradaDelPrompt): string {\n\treturn renderizar(leerPlantilla(), contextoDelPrompt(entrada), NOMBRE)\n\t\t.replace(/\\n{3,}/g, \"\\n\\n\")\n\t\t.trim();\n}\n"]}

package/dist/core/prompts/montar.js

@@ -0,0 +1,146 @@
+/**
+ * Monta el prompt del sistema desde `sistema.md`.
+ *
+ * DE DÓNDE VIENE ESTO. El prompt de Ada era una cadena dentro de
+ * `system-prompt.ts` con dos directrices —«Be concise» y «Show file paths
+ * clearly»— más un bloque sobre dónde vive la documentación de Ada. Es decir:
+ * le explicábamos al modelo dónde están NUESTROS documentos y no le
+ * explicábamos cómo programar bien.
+ *
+ * Y había un dato peor, medido: de las TRECE capacidades construidas en cuatro
+ * tandas de trabajo (`lsp`, `ast_edit`, `hashline`, `remoto`, `web_search`,
+ * `computer`, `browser`, `audit`, `banco`, `cleanse`, `discover`, `review`,
+ * `ast_search`), **ninguna aparecía en el prompt**. De nuestras tools, solo UNA
+ * definía `promptSnippet`. El modelo veía el nombre y nada más: ni cuándo usar
+ * `lsp_references` antes de renombrar, ni que `ast_edit` es para codemods.
+ *
+ * Es capacidad construida y desenchufada en su forma más difícil de ver: la
+ * herramienta está registrada, así que NADA FALLA. Solo hay un agente peor de
+ * lo que debería, sin error que investigar.
+ *
+ * DOS DECISIONES QUE NO SON DE ESTILO:
+ *
+ * 1. **Si falta el `.md`, se LANZA.** Un `catch` que devolviera cadena vacía
+ *    dejaría al agente sin prompt del sistema —sin doctrina, sin contrato de
+ *    entrega, sin las reglas de cumplimiento— y arrancaría igual. Sería el
+ *    fallo que se lee como éxito en el sitio más caro posible. Como `dist/` es
+ *    superficie ciega para vitest (las pruebas leen `src/`, el paquete
+ *    publicado lee `dist/`), esto además convierte un `copy-assets` olvidado en
+ *    un arranque roto y visible en vez de en un agente silenciosamente tonto.
+ *
+ * 2. **Los nombres de herramienta salen del registro, no de la plantilla.** Si
+ *    alguien renombra `ast_search`, la línea del prompt que lo menciona se
+ *    queda mintiendo, y un prompt que nombra una tool inexistente le enseña al
+ *    modelo a desconfiar de sus instrucciones. Aquí la lista se construye desde
+ *    los nombres reales que recibe `montarPromptDelSistema`.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { nivelDe } from "../aprobacion/politica.js";
+import { renderizar } from "./plantilla.js";
+const NOMBRE = "sistema.md";
+/**
+ * Una línea por herramienta especializada, construida desde los nombres reales.
+ *
+ * Solo se listan las que el modelo confunde con `bash` — es donde la guía paga.
+ * Enumerar `read` junto a veinte más diluye las que importan.
+ */
+const GUIA = [
+    { tool: "read", linea: (n) => `File and directory reads → \`${n}\`, never \`cat\` or \`ls\` through the shell.` },
+    { tool: "grep", linea: (n) => `Regex search → \`${n}\`, never shell \`grep\`, \`rg\` or \`awk\`.` },
+    { tool: "find", linea: (n) => `Locating files by name or glob → \`${n}\`, never \`find\` or \`fd\`.` },
+    { tool: "edit", linea: (n) => `Surgical edits → \`${n}\`. Never rewrite a whole file to change a few lines.` },
+    { tool: "write", linea: (n) => `Creating or fully replacing a file → \`${n}\`.` },
+    {
+        tool: "web_search",
+        linea: (n) => `Anything you do not know and cannot read locally → \`${n}\`. Do not guess an API from memory.`,
+    },
+];
+/**
+ * La línea del modo plan que dice qué tools SIGUEN valiendo.
+ *
+ * Los nombres salen del conjunto REAL de tools activas filtrado por `nivelDe`,
+ * el mismo clasificador que usa la política de aprobación: si alguien mueve una
+ * tool de `LECTURA` a `ESCRITURA`, esta línea se mueve con ella. Escribirlos a
+ * mano en la plantilla sería prometerle al modelo tools que quizá no tiene, y
+ * un prompt que nombra una tool inexistente le enseña a desconfiar de sus
+ * instrucciones.
+ *
+ * El filtro son las DOS condiciones que `decidir()` aplica antes de dejar pasar
+ * una lectura en modo plan: nivel de lectura (paso 4) y no estar en el `deny`
+ * del usuario (paso 3). Con solo la primera, `permissions.denied: ["web_fetch"]`
+ * dejaba la línea prometiendo `web_fetch`.
+ *
+ * El caso vacío (`ada-cli --tools bash` en modo plan) no es decorativo: ahí el
+ * agente no puede ni leer, y decirlo es mejor que dejar una lista en blanco que
+ * el modelo interpretará como que puede con todo. Se calcula aquí en vez de con
+ * un `{{#si}}` dentro del `{{#si modoPlan}}` porque anidar dos bloques del
+ * mismo tipo borraba el resto de la sección en silencio (ver `plantilla.ts`).
+ */
+function lineaDePlan(lectura) {
+    if (lectura.length === 0) {
+        return "No read-only tool is active in this session, so you cannot investigate either. Say exactly that and stop.";
+    }
+    return `Still available in this mode: ${lectura.map((n) => `\`${n}\``).join(", ")}. Nothing else is.`;
+}
+/** El contexto que ve la plantilla. Público porque las pruebas lo comprueban. */
+export function contextoDelPrompt(entrada) {
+    const activas = new Set(entrada.nombresDeHerramienta);
+    const denegadas = new Set(entrada.toolsDenegadas ?? []);
+    const tiene = (prefijo) => [...activas].some((n) => n === prefijo || n.startsWith(`${prefijo}_`));
+    const herramientas = [];
+    for (const { tool, linea } of GUIA) {
+        if (activas.has(tool))
+            herramientas.push(linea(tool));
+    }
+    // Y las que aportan su propia frase, que nadie más conoce.
+    for (const [nombre, frase] of Object.entries(entrada.frasesDeHerramienta ?? {})) {
+        if (activas.has(nombre) && !GUIA.some((g) => g.tool === nombre)) {
+            herramientas.push(`\`${nombre}\`: ${frase}`);
+        }
+    }
+    return {
+        herramientas,
+        personalidad: entrada.personalidad,
+        modoPlan: entrada.modoPlan === true,
+        lineaHerramientasDePlan: lineaDePlan([...activas].filter((n) => nivelDe(n) === "lectura" && !denegadas.has(n)).sort()),
+        tieneLsp: tiene("lsp"),
+        tieneEstructural: activas.has("ast_search") || activas.has("ast_edit"),
+        tieneBash: activas.has("bash"),
+        tieneNavegador: tiene("browser"),
+        tieneEscritorio: tiene("computer"),
+        // El libro de auditoría no es una tool: es una propiedad del arnés, y
+        // siempre está. Se declara explícito para que la plantilla no adivine.
+        tieneAudit: true,
+    };
+}
+let cacheDeLaPlantilla;
+/** Lee `sistema.md` de junto a este módulo. Lanza si no está. */
+function leerPlantilla() {
+    if (cacheDeLaPlantilla !== undefined)
+        return cacheDeLaPlantilla;
+    const ruta = join(dirname(fileURLToPath(import.meta.url)), NOMBRE);
+    try {
+        cacheDeLaPlantilla = readFileSync(ruta, "utf-8");
+    }
+    catch (error) {
+        throw new Error(`No se ha podido leer el prompt del sistema (${ruta}).\n` +
+            "Arrancar sin él dejaría al agente sin doctrina, sin contrato de entrega y sin\n" +
+            "las reglas de cumplimiento, y lo haría en silencio. Si esto sale desde el\n" +
+            "paquete compilado, falta el paso `copy-assets` que lleva los .md a dist/.\n" +
+            `Causa: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return cacheDeLaPlantilla;
+}
+/** Solo para pruebas: olvida la plantilla cacheada. */
+export function __olvidarPlantillaParaPruebas() {
+    cacheDeLaPlantilla = undefined;
+}
+/** El prompt del sistema de Ada, con las secciones que la sesión merece. */
+export function montarPromptDelSistema(entrada) {
+    return renderizar(leerPlantilla(), contextoDelPrompt(entrada), NOMBRE)
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+//# sourceMappingURL=montar.js.map

package/dist/core/prompts/montar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"montar.js","sourceRoot":"","sources":["../../../src/core/prompts/montar.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Monta el prompt del sistema desde `sistema.md`.\n *\n * DE DÓNDE VIENE ESTO. El prompt de Ada era una cadena dentro de\n * `system-prompt.ts` con dos directrices —«Be concise» y «Show file paths\n * clearly»— más un bloque sobre dónde vive la documentación de Ada. Es decir:\n * le explicábamos al modelo dónde están NUESTROS documentos y no le\n * explicábamos cómo programar bien.\n *\n * Y había un dato peor, medido: de las TRECE capacidades construidas en cuatro\n * tandas de trabajo (`lsp`, `ast_edit`, `hashline`, `remoto`, `web_search`,\n * `computer`, `browser`, `audit`, `banco`, `cleanse`, `discover`, `review`,\n * `ast_search`), **ninguna aparecía en el prompt**. De nuestras tools, solo UNA\n * definía `promptSnippet`. El modelo veía el nombre y nada más: ni cuándo usar\n * `lsp_references` antes de renombrar, ni que `ast_edit` es para codemods.\n *\n * Es capacidad construida y desenchufada en su forma más difícil de ver: la\n * herramienta está registrada, así que NADA FALLA. Solo hay un agente peor de\n * lo que debería, sin error que investigar.\n *\n * DOS DECISIONES QUE NO SON DE ESTILO:\n *\n * 1. **Si falta el `.md`, se LANZA.** Un `catch` que devolviera cadena vacía\n *    dejaría al agente sin prompt del sistema —sin doctrina, sin contrato de\n *    entrega, sin las reglas de cumplimiento— y arrancaría igual. Sería el\n *    fallo que se lee como éxito en el sitio más caro posible. Como `dist/` es\n *    superficie ciega para vitest (las pruebas leen `src/`, el paquete\n *    publicado lee `dist/`), esto además convierte un `copy-assets` olvidado en\n *    un arranque roto y visible en vez de en un agente silenciosamente tonto.\n *\n * 2. **Los nombres de herramienta salen del registro, no de la plantilla.** Si\n *    alguien renombra `ast_search`, la línea del prompt que lo menciona se\n *    queda mintiendo, y un prompt que nombra una tool inexistente le enseña al\n *    modelo a desconfiar de sus instrucciones. Aquí la lista se construye desde\n *    los nombres reales que recibe `montarPromptDelSistema`.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { nivelDe } from \"../aprobacion/politica.ts\";\nimport { type Contexto, renderizar } from \"./plantilla.ts\";\n\nconst NOMBRE = \"sistema.md\";\n\n/** Qué sabe el montador sobre la sesión. Todo opcional salvo las tools. */\nexport interface EntradaDelPrompt {\n\t/** Los nombres de tool REALES y activos de esta sesión. */\n\tnombresDeHerramienta: readonly string[];\n\t/** Frases de una línea por tool, si la tool las aporta. */\n\tfrasesDeHerramienta?: Readonly<Record<string, string>>;\n\tpersonalidad?: string;\n\t/**\n\t * `true` cuando la política de aprobación está en modo plan.\n\t *\n\t * Existe porque el modo plan estaba impuesto SOLO en código: `decidir()`\n\t * devuelve `denegada` con política `modo-plan` para toda escritura y toda\n\t * ejecución, y el prompt no lo mencionaba. El modelo intentaba editar, se\n\t * llevaba un rechazo que no esperaba, y gastaba turnos aprendiendo por\n\t * golpes una regla que se le podía haber dicho: el guardián estaba\n\t * construido y el modelo no lo conocía.\n\t */\n\tmodoPlan?: boolean;\n\t/**\n\t * Tools que el usuario ha denegado (`permissions.denied`).\n\t *\n\t * No es lo mismo que «no activa»: una tool denegada SIGUE en el inventario y\n\t * en el conjunto activo, y lo que la para es `decidir()`, que consulta el\n\t * `deny` del usuario en el paso 3 —antes del modo— y contesta `denegada` con\n\t * política `deny-de-usuario`. Filtrar solo por `nivelDe` dejaba a la sección\n\t * de modo plan prometiendo, por ejemplo, `web_fetch` con `permissions.denied:\n\t * [\"web_fetch\"]` en settings: el rechazo inesperado que esta sección existe\n\t * para evitar, servido por la propia sección.\n\t */\n\ttoolsDenegadas?: readonly string[];\n}\n\n/**\n * Una línea por herramienta especializada, construida desde los nombres reales.\n *\n * Solo se listan las que el modelo confunde con `bash` — es donde la guía paga.\n * Enumerar `read` junto a veinte más diluye las que importan.\n */\nconst GUIA: ReadonlyArray<{ tool: string; linea: (n: string) => string }> = [\n\t{ tool: \"read\", linea: (n) => `File and directory reads → \\`${n}\\`, never \\`cat\\` or \\`ls\\` through the shell.` },\n\t{ tool: \"grep\", linea: (n) => `Regex search → \\`${n}\\`, never shell \\`grep\\`, \\`rg\\` or \\`awk\\`.` },\n\t{ tool: \"find\", linea: (n) => `Locating files by name or glob → \\`${n}\\`, never \\`find\\` or \\`fd\\`.` },\n\t{ tool: \"edit\", linea: (n) => `Surgical edits → \\`${n}\\`. Never rewrite a whole file to change a few lines.` },\n\t{ tool: \"write\", linea: (n) => `Creating or fully replacing a file → \\`${n}\\`.` },\n\t{\n\t\ttool: \"web_search\",\n\t\tlinea: (n) => `Anything you do not know and cannot read locally → \\`${n}\\`. Do not guess an API from memory.`,\n\t},\n];\n\n/**\n * La línea del modo plan que dice qué tools SIGUEN valiendo.\n *\n * Los nombres salen del conjunto REAL de tools activas filtrado por `nivelDe`,\n * el mismo clasificador que usa la política de aprobación: si alguien mueve una\n * tool de `LECTURA` a `ESCRITURA`, esta línea se mueve con ella. Escribirlos a\n * mano en la plantilla sería prometerle al modelo tools que quizá no tiene, y\n * un prompt que nombra una tool inexistente le enseña a desconfiar de sus\n * instrucciones.\n *\n * El filtro son las DOS condiciones que `decidir()` aplica antes de dejar pasar\n * una lectura en modo plan: nivel de lectura (paso 4) y no estar en el `deny`\n * del usuario (paso 3). Con solo la primera, `permissions.denied: [\"web_fetch\"]`\n * dejaba la línea prometiendo `web_fetch`.\n *\n * El caso vacío (`ada-cli --tools bash` en modo plan) no es decorativo: ahí el\n * agente no puede ni leer, y decirlo es mejor que dejar una lista en blanco que\n * el modelo interpretará como que puede con todo. Se calcula aquí en vez de con\n * un `{{#si}}` dentro del `{{#si modoPlan}}` porque anidar dos bloques del\n * mismo tipo borraba el resto de la sección en silencio (ver `plantilla.ts`).\n */\nfunction lineaDePlan(lectura: readonly string[]): string {\n\tif (lectura.length === 0) {\n\t\treturn \"No read-only tool is active in this session, so you cannot investigate either. Say exactly that and stop.\";\n\t}\n\treturn `Still available in this mode: ${lectura.map((n) => `\\`${n}\\``).join(\", \")}. Nothing else is.`;\n}\n\n/** El contexto que ve la plantilla. Público porque las pruebas lo comprueban. */\nexport function contextoDelPrompt(entrada: EntradaDelPrompt): Contexto {\n\tconst activas = new Set(entrada.nombresDeHerramienta);\n\tconst denegadas = new Set(entrada.toolsDenegadas ?? []);\n\tconst tiene = (prefijo: string) => [...activas].some((n) => n === prefijo || n.startsWith(`${prefijo}_`));\n\n\tconst herramientas: string[] = [];\n\tfor (const { tool, linea } of GUIA) {\n\t\tif (activas.has(tool)) herramientas.push(linea(tool));\n\t}\n\t// Y las que aportan su propia frase, que nadie más conoce.\n\tfor (const [nombre, frase] of Object.entries(entrada.frasesDeHerramienta ?? {})) {\n\t\tif (activas.has(nombre) && !GUIA.some((g) => g.tool === nombre)) {\n\t\t\therramientas.push(`\\`${nombre}\\`: ${frase}`);\n\t\t}\n\t}\n\n\treturn {\n\t\therramientas,\n\t\tpersonalidad: entrada.personalidad,\n\t\tmodoPlan: entrada.modoPlan === true,\n\t\tlineaHerramientasDePlan: lineaDePlan(\n\t\t\t[...activas].filter((n) => nivelDe(n) === \"lectura\" && !denegadas.has(n)).sort(),\n\t\t),\n\t\ttieneLsp: tiene(\"lsp\"),\n\t\ttieneEstructural: activas.has(\"ast_search\") || activas.has(\"ast_edit\"),\n\t\ttieneBash: activas.has(\"bash\"),\n\t\ttieneNavegador: tiene(\"browser\"),\n\t\ttieneEscritorio: tiene(\"computer\"),\n\t\t// El libro de auditoría no es una tool: es una propiedad del arnés, y\n\t\t// siempre está. Se declara explícito para que la plantilla no adivine.\n\t\ttieneAudit: true,\n\t};\n}\n\nlet cacheDeLaPlantilla: string | undefined;\n\n/** Lee `sistema.md` de junto a este módulo. Lanza si no está. */\nfunction leerPlantilla(): string {\n\tif (cacheDeLaPlantilla !== undefined) return cacheDeLaPlantilla;\n\tconst ruta = join(dirname(fileURLToPath(import.meta.url)), NOMBRE);\n\ttry {\n\t\tcacheDeLaPlantilla = readFileSync(ruta, \"utf-8\");\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`No se ha podido leer el prompt del sistema (${ruta}).\\n` +\n\t\t\t\t\"Arrancar sin él dejaría al agente sin doctrina, sin contrato de entrega y sin\\n\" +\n\t\t\t\t\"las reglas de cumplimiento, y lo haría en silencio. Si esto sale desde el\\n\" +\n\t\t\t\t\"paquete compilado, falta el paso `copy-assets` que lleva los .md a dist/.\\n\" +\n\t\t\t\t`Causa: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\treturn cacheDeLaPlantilla;\n}\n\n/** Solo para pruebas: olvida la plantilla cacheada. */\nexport function __olvidarPlantillaParaPruebas(): void {\n\tcacheDeLaPlantilla = undefined;\n}\n\n/** El prompt del sistema de Ada, con las secciones que la sesión merece. */\nexport function montarPromptDelSistema(entrada: EntradaDelPrompt): string {\n\treturn renderizar(leerPlantilla(), contextoDelPrompt(entrada), NOMBRE)\n\t\t.replace(/\\n{3,}/g, \"\\n\\n\")\n\t\t.trim();\n}\n"]}

package/dist/core/prompts/plantilla.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Motor de plantillas mínimo para los prompts de Ada.
+ *
+ * POR QUÉ EXISTE. Nuestro prompt del sistema era una cadena dentro de
+ * `system-prompt.ts` con dos directrices («sé conciso», «enseña las rutas») y
+ * un bloque fijo sobre dónde está la documentación de Ada. oh-my-pi tiene 3.379
+ * líneas de prompt en ~40 ficheros `.md` montadas con condicionales, y esa
+ * diferencia se nota: cada sección suya existe SOLO si la capacidad de la que
+ * habla está disponible.
+ *
+ * Eso es lo que hay que copiar. Un prompt que explica el LSP a un agente sin
+ * LSP no es solo ruido: le enseña a pedir algo que no existe, y cuando falla el
+ * modelo aprende a desconfiar de sus propias instrucciones.
+ *
+ * POR QUÉ PROPIO Y NO HANDLEBARS. Son ~130 líneas frente a una dependencia
+ * nueva con su puerta de versión clavada, su `npm-shrinkwrap` y su superficie.
+ * Y necesitamos una cosa que Handlebars NO hace por defecto y que aquí es
+ * innegociable: fallar ante lo desconocido.
+ *
+ * LA DECISIÓN QUE IMPORTA. Una variable no declarada LANZA. No se sustituye por
+ * cadena vacía.
+ *
+ * Es la lección de esta casa aplicada al prompt: una sustitución vacía en
+ * silencio es «no lo he mirado» leído como «no hay». Un `{{herramientas}}` mal
+ * escrito borraría el inventario entero de tools del prompt, el agente perdería
+ * la mitad de sus capacidades y nadie vería un error — solo un agente
+ * misteriosamente peor. Con un `throw` te enteras al arrancar, y hay prueba.
+ */
+/** Lo que se le pasa a una plantilla. Nada más existe dentro. */
+export interface Contexto {
+    [clave: string]: string | number | boolean | null | undefined | readonly Contexto[] | readonly string[];
+}
+/** Un fallo de plantilla es un fallo de programación, no del usuario. */
+export declare class ErrorDePlantilla extends Error {
+    readonly nombreDeLaPlantilla?: string;
+    constructor(mensaje: string, nombreDeLaPlantilla?: string);
+}
+/**
+ * Renderiza `plantilla` con `contexto`.
+ *
+ * Directivas, en español como todo lo nuestro:
+ *
+ *   {{clave}}                  sustitución; LANZA si `clave` no está declarada
+ *   {{#si clave}}…{{/si}}      solo si es verdadera
+ *   {{#noSi clave}}…{{/noSi}}  solo si es falsa — para el «no tienes X, haz Y»
+ *   {{#cada lista}}…{{/cada}}  una vez por elemento; dentro, `{{esto}}` es el
+ *                              elemento si es cadena, y sus campos si es objeto
+ *
+ * Anidar un bloque dentro de otro del MISMO tipo LANZA, y eso es una guarda, no
+ * una nota: en cuanto un prompt necesita eso, lo que necesita de verdad es
+ * precalcular el trozo variable en el contexto o partirse en dos ficheros.
+ */
+export declare function renderizar(plantilla: string, contexto: Contexto, nombre?: string): string;
+//# sourceMappingURL=plantilla.d.ts.map

package/dist/core/prompts/plantilla.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plantilla.d.ts","sourceRoot":"","sources":["../../../src/core/prompts/plantilla.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,kEAAiE;AACjE,MAAM,WAAW,QAAQ;IACxB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,QAAQ,EAAE,GAAG,SAAS,MAAM,EAAE,CAAC;CACxG;AAED,0EAAyE;AACzE,qBAAa,gBAAiB,SAAQ,KAAK;IAI1C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,EAIxD;CACD;AAiBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgEzF","sourcesContent":["/**\n * Motor de plantillas mínimo para los prompts de Ada.\n *\n * POR QUÉ EXISTE. Nuestro prompt del sistema era una cadena dentro de\n * `system-prompt.ts` con dos directrices («sé conciso», «enseña las rutas») y\n * un bloque fijo sobre dónde está la documentación de Ada. oh-my-pi tiene 3.379\n * líneas de prompt en ~40 ficheros `.md` montadas con condicionales, y esa\n * diferencia se nota: cada sección suya existe SOLO si la capacidad de la que\n * habla está disponible.\n *\n * Eso es lo que hay que copiar. Un prompt que explica el LSP a un agente sin\n * LSP no es solo ruido: le enseña a pedir algo que no existe, y cuando falla el\n * modelo aprende a desconfiar de sus propias instrucciones.\n *\n * POR QUÉ PROPIO Y NO HANDLEBARS. Son ~130 líneas frente a una dependencia\n * nueva con su puerta de versión clavada, su `npm-shrinkwrap` y su superficie.\n * Y necesitamos una cosa que Handlebars NO hace por defecto y que aquí es\n * innegociable: fallar ante lo desconocido.\n *\n * LA DECISIÓN QUE IMPORTA. Una variable no declarada LANZA. No se sustituye por\n * cadena vacía.\n *\n * Es la lección de esta casa aplicada al prompt: una sustitución vacía en\n * silencio es «no lo he mirado» leído como «no hay». Un `{{herramientas}}` mal\n * escrito borraría el inventario entero de tools del prompt, el agente perdería\n * la mitad de sus capacidades y nadie vería un error — solo un agente\n * misteriosamente peor. Con un `throw` te enteras al arrancar, y hay prueba.\n */\n\n/** Lo que se le pasa a una plantilla. Nada más existe dentro. */\nexport interface Contexto {\n\t[clave: string]: string | number | boolean | null | undefined | readonly Contexto[] | readonly string[];\n}\n\n/** Un fallo de plantilla es un fallo de programación, no del usuario. */\nexport class ErrorDePlantilla extends Error {\n\t// Campo declarado y asignado en el cuerpo, no en la firma: el proyecto va con\n\t// `erasableSyntaxOnly`, que prohíbe las propiedades de constructor porque no\n\t// se pueden borrar con solo quitar los tipos.\n\treadonly nombreDeLaPlantilla?: string;\n\n\tconstructor(mensaje: string, nombreDeLaPlantilla?: string) {\n\t\tsuper(nombreDeLaPlantilla ? `${nombreDeLaPlantilla}: ${mensaje}` : mensaje);\n\t\tthis.name = \"ErrorDePlantilla\";\n\t\tthis.nombreDeLaPlantilla = nombreDeLaPlantilla;\n\t}\n}\n\n/** Falso, cadena vacía, cero, lista vacía y ausente. Todo lo demás es cierto. */\nfunction esVerdadero(valor: unknown): boolean {\n\tif (valor === undefined || valor === null || valor === false) return false;\n\tif (valor === \"\" || valor === 0) return false;\n\tif (Array.isArray(valor)) return valor.length > 0;\n\treturn true;\n}\n\nfunction aTexto(valor: unknown): string {\n\tif (valor === undefined || valor === null) return \"\";\n\treturn String(valor);\n}\n\nconst APERTURA = /\\{\\{#(si|noSi|cada)\\s+([A-Za-z0-9_.]+)\\s*\\}\\}/;\n\n/**\n * Renderiza `plantilla` con `contexto`.\n *\n * Directivas, en español como todo lo nuestro:\n *\n *   {{clave}}                  sustitución; LANZA si `clave` no está declarada\n *   {{#si clave}}…{{/si}}      solo si es verdadera\n *   {{#noSi clave}}…{{/noSi}}  solo si es falsa — para el «no tienes X, haz Y»\n *   {{#cada lista}}…{{/cada}}  una vez por elemento; dentro, `{{esto}}` es el\n *                              elemento si es cadena, y sus campos si es objeto\n *\n * Anidar un bloque dentro de otro del MISMO tipo LANZA, y eso es una guarda, no\n * una nota: en cuanto un prompt necesita eso, lo que necesita de verdad es\n * precalcular el trozo variable en el contexto o partirse en dos ficheros.\n */\nexport function renderizar(plantilla: string, contexto: Contexto, nombre?: string): string {\n\tlet texto = plantilla;\n\n\t// Bloques primero: dentro pueden vivir sustituciones que solo existen ahí.\n\tlet guarda = 0;\n\twhile (true) {\n\t\tif (++guarda > 500) throw new ErrorDePlantilla(\"demasiados bloques anidados o sin cerrar\", nombre);\n\t\tconst apertura = texto.match(APERTURA);\n\t\tif (!apertura || apertura.index === undefined) break;\n\t\tconst [etiqueta, tipo, clave] = apertura;\n\t\tconst cierre = `{{/${tipo}}}`;\n\t\tconst inicioCuerpo = apertura.index + etiqueta.length;\n\t\tconst inicioCierre = texto.indexOf(cierre, inicioCuerpo);\n\t\tif (inicioCierre === -1) {\n\t\t\tthrow new ErrorDePlantilla(`bloque {{#${tipo} ${clave}}} sin su ${cierre}`, nombre);\n\t\t}\n\t\t// Anidar dos bloques del MISMO tipo estaba «no soportado» solo en el\n\t\t// comentario de la cabecera, y el resultado era una precondición escrita\n\t\t// en un comentario: nadie la imponía y se rompió a la primera. Medido con\n\t\t// `{{#si a}}A1{{#si b}}B{{/si}}A2{{/si}}` y b falso, esto rendía \"A1\" —el\n\t\t// `{{/si}}` interior cerraba el bloque exterior y A2 desaparecía sin\n\t\t// error. En un prompt eso borra media sección y deja al modelo sin la\n\t\t// regla, que es el fallo que se lee como éxito en el sitio más caro.\n\t\tconst dentro = texto.slice(inicioCuerpo, inicioCierre);\n\t\tconst anidado = dentro.match(new RegExp(`\\\\{\\\\{#${tipo}\\\\s`));\n\t\tif (anidado) {\n\t\t\tthrow new ErrorDePlantilla(\n\t\t\t\t`{{#${tipo} ${clave}}} contiene otro {{#${tipo}}} antes de su ${cierre}. ` +\n\t\t\t\t\t\"Anidar dos bloques del mismo tipo NO está soportado: el cierre interior \" +\n\t\t\t\t\t\"cerraría el exterior y el resto de la sección desaparecería en silencio. \" +\n\t\t\t\t\t\"Precalcula el trozo variable en el contexto, o parte la plantilla en dos.\",\n\t\t\t\tnombre,\n\t\t\t);\n\t\t}\n\t\tconst cuerpo = dentro;\n\t\tconst valor = leer(contexto, clave, nombre);\n\n\t\tlet sustitucion: string;\n\t\tif (tipo === \"si\") {\n\t\t\tsustitucion = esVerdadero(valor) ? cuerpo : \"\";\n\t\t} else if (tipo === \"noSi\") {\n\t\t\tsustitucion = esVerdadero(valor) ? \"\" : cuerpo;\n\t\t} else {\n\t\t\tif (!Array.isArray(valor)) {\n\t\t\t\tthrow new ErrorDePlantilla(\n\t\t\t\t\t`{{#cada ${clave}}} necesita una lista, y \"${clave}\" es ${typeof valor}`,\n\t\t\t\t\tnombre,\n\t\t\t\t);\n\t\t\t}\n\t\t\tsustitucion = valor\n\t\t\t\t.map((elemento) =>\n\t\t\t\t\trenderizar(\n\t\t\t\t\t\tcuerpo,\n\t\t\t\t\t\ttypeof elemento === \"string\" ? { esto: elemento } : { ...elemento, esto: \"\" },\n\t\t\t\t\t\tnombre,\n\t\t\t\t\t),\n\t\t\t\t)\n\t\t\t\t.join(\"\");\n\t\t}\n\t\ttexto = texto.slice(0, apertura.index) + sustitucion + texto.slice(inicioCierre + cierre.length);\n\t}\n\n\t// Y ahora las sustituciones sueltas.\n\treturn texto.replace(/\\{\\{([A-Za-z0-9_.]+)\\}\\}/g, (_todo, clave: string) => aTexto(leer(contexto, clave, nombre)));\n}\n\n/**\n * Lee `clave` del contexto. LANZA si no está DECLARADA.\n *\n * Declarada y `undefined` es válido —significa «esta capacidad no está»— y\n * rinde vacío o falso. Lo que no vale es que la clave no exista: eso es una\n * errata en la plantilla, y borrar una sección del prompt por una errata es\n * exactamente el fallo que este módulo existe para no tener.\n */\nfunction leer(contexto: Contexto, clave: string, nombre?: string): unknown {\n\tconst partes = clave.split(\".\");\n\tlet actual: unknown = contexto;\n\tfor (const parte of partes) {\n\t\tif (actual === null || actual === undefined) return undefined;\n\t\tif (typeof actual !== \"object\") {\n\t\t\tthrow new ErrorDePlantilla(`\"${clave}\" atraviesa \"${parte}\", que no es un objeto`, nombre);\n\t\t}\n\t\tif (!(parte in (actual as Record<string, unknown>))) {\n\t\t\tconst disponibles = Object.keys(actual as Record<string, unknown>)\n\t\t\t\t.sort()\n\t\t\t\t.join(\", \");\n\t\t\tthrow new ErrorDePlantilla(\n\t\t\t\t`\"${clave}\" no está declarada (falta \"${parte}\"). Declaradas: ${disponibles || \"ninguna\"}`,\n\t\t\t\tnombre,\n\t\t\t);\n\t\t}\n\t\tactual = (actual as Record<string, unknown>)[parte];\n\t}\n\treturn actual;\n}\n"]}