ajustes

mcp-server/tools/docs/read_doc.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { handleToolError, validateRequired } from "../helpers/errorHandler.js";
+import { readDoc } from "./_docsReader.js";
+
+export function registerReadDocTool(server) {
+    server.tool(
+        "read_doc",
+        `Lee un documento del knowledge base de Acai bajo demanda.
+
+Cuándo usarlo:
+- El doc no se cargó completo en el contexto (aparece en "Other Available Docs" del knowledge_base).
+- Necesitas una sección concreta con detalle sin cargar todo el doc.
+- Vas a hacer una operación delicada y quieres releer las reglas exactas (e.g. crear una tabla, escribir un hook, editar el header).
+
+Parámetros:
+- name: id del doc (sin extensión). Ejemplos: '01-builder-fields', '05-tables-and-fields', '09-mcp-tools-reference'. Usa 'list_docs' si dudas del id.
+- section: opcional. Match case-insensitive y parcial sobre headings H2 ('## ...'). Devuelve desde el heading hasta el siguiente H2.
+
+Si la sección no existe, la respuesta incluye 'available_sections' para que reintentes con un nombre válido.
+
+Docs disponibles (resumen):
+- 01-builder-fields — Campos editables (data-field-type), atributos Acai (c-if, c-for, c-class), c-form, componentes built-in.
+- 02-twig — Filtros Twig (get, queryDB, hook, module, imagec, translate, raw).
+- 03-modules-and-sections — Módulos vs secciones generales, thisrecord, multiv2, custom-{tableName}.
+- 04-pages-and-records — Builder vs Standard, menuType, apartados, reglas sobre enlace/controlador.
+- 05-tables-and-fields — Schema, create_table, create_field, tipos de campo, casos destructivos.
+- 06-hooks-and-cmsapi — Hooks PHP, CmsApi/CocoDB, hook middleware.
+- 07-css-js-conventions — Tailwind+BEM, scoping, Vue 3, componentes nativos.
+- 08-layout-and-libraries — get/set_layout_field, librerías globales, regla de no editar layout.json.
+- 09-mcp-tools-reference — Inventario completo + workflows canónicos.
+- 10-production-patterns — Patrones reales (cabecera, zigzag, FAQ, formulario, detalle).
+- 11-quick-reference — Cheat sheet con todas las reglas y formatos.`,
+        {
+            name: z.string().describe("ID del doc sin extensión (e.g. '05-tables-and-fields')"),
+            section: z.string().optional().describe("Heading H2 a extraer (case-insensitive, parcial). Omitir para leer el doc completo."),
+        },
+        { readOnlyHint: true, destructiveHint: false },
+        async ({ name, section }) => {
+            try {
+                const validationError = validateRequired({ name }, ["name"], "read_doc");
+                if (validationError) return validationError;
+
+                const data = await readDoc(name, section);
+                return {
+                    content: [{
+                        type: "text",
+                        text: JSON.stringify(data, null, 2),
+                    }],
+                };
+            } catch (error) {
+                if (error?.code === "DOC_NOT_FOUND") {
+                    return {
+                        content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: error.message,
+                                hint: "Usa 'list_docs' para ver los ids disponibles. Los ids tienen prefijo numérico (e.g. '05-tables-and-fields').",
+                            }, null, 2),
+                        }],
+                        isError: true,
+                    };
+                }
+                return handleToolError(error, "read_doc", { name, section });
+            }
+        }
+    );
+}