autoform-mcp-server 1.7.2 → 1.7.4

package/dist/index.js

@@ -13,7 +13,7 @@ import { handleGenerateBatch, generateBatchSchema } from './tools/generateBatch.
 import { handleListTemplates, listTemplatesSchema } from './tools/manageTemplates.js';
 import { handleImportTemplate, importTemplateSchema } from './tools/importTemplate.js';
 import { withMetrics } from './services/metricsLogger.js';
-const server = new Server({ name: 'autoform', version: '1.7.2' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'autoform', version: '1.7.4' }, { capabilities: { tools: {} } });
 // Register all tools
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [

package/dist/tools/fillBatchAtCoordinates.js

@@ -13,6 +13,7 @@ IMPORTANTE — Codificación de texto:
 IMPORTANTE — Casillas de verificación (checkboxes) en PDFs estaticos:
 - Si detectas opciones tipo checkbox, SOLO marcalas si puedes VER el PDF visualmente (adjuntado al chat). Si no puedes verlo, pide al usuario que lo adjunte.
 - Para marcar: text="X", fontSize=10, en las coordenadas exactas del cuadrado.
+- CHECKBOXES MUTUAMENTE EXCLUYENTES: si el formulario tiene opciones donde solo una puede estar marcada (ej: ALUMNO / DOCENTE / ADMINISTRATIVO), cada fila de data_rows debe tener "X" en EXACTAMENTE UN campo checkbox y "" en los demas. NUNCA pongas "X" en multiples checkboxes de la misma fila.
 
 IMPORTANTE — Verificación visual:
 - Si el usuario adjunto el PDF al chat Y tambien dio la ruta, APROVECHA la imagen visual para verificar que tus coordenadas son correctas antes de generar.

package/dist/tools/generateBatch.js

@@ -9,9 +9,20 @@ NO USAR SI: No tienes template guardado → usa autoform_fill_batch_at_coordinat
 
 DATOS: Pasa los datos como array de objetos JSON en el parametro "data". Si el usuario tiene un archivo (Excel, CSV, etc.), leelo primero y convierte a JSON.
 
-Modos de distribucion:
-- "sequential": campos repetidos consumen filas diferentes (para tablas/listas)
-- "repeat": una fila se repite en todos los campos con el mismo nombre (para certificados)`,
+CHECKBOXES MUTUAMENTE EXCLUYENTES:
+- Si el template tiene campos tipo checkbox (ej: es_alumno, es_docente, es_administrativo) donde SOLO UNO debe marcarse por documento, asegurate de que CADA fila de data tenga "X" en EXACTAMENTE UN campo de checkbox y "" (string vacio) en todos los demas.
+- NUNCA pongas "X" en multiples checkboxes de la misma fila.
+- Si un error produce checkboxes mal marcados, el error esta en tus datos, NO en el MCP. Revisa y corrige los datos antes de culpar al sistema.
+
+DIRECTORIO DE SALIDA: Si no se especifica output_dir, guarda en el mismo directorio del PDF base del template.
+
+NO GENERES PDF DE PRUEBA: Genera el batch completo directamente.
+
+Modos de distribucion (DEFAULT: "repeat"):
+- "repeat" (DEFAULT, recomendado para la mayoria de formularios): cada fila de datos genera UN documento completo. Todos los campos del template reciben sus valores de ESA fila. Usa este modo siempre que cada campo del template tenga un nombre UNICO (formularios normales, certificados, constancias).
+- "sequential": SOLO usar cuando el template tiene campos REPETIDOS con el mismo nombre (ej: una tabla con 10 campos "nombre" donde cada uno debe llenarse con una fila diferente). Si no estas seguro, usa "repeat".
+
+REGLA SIMPLE: si cada campo del template aparece solo 1 vez → "repeat". Si hay campos repetidos con el mismo fieldName → "sequential".`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -30,7 +41,7 @@ Modos de distribucion:
             distribution_mode: {
                 type: 'string',
                 enum: ['sequential', 'repeat'],
-                description: 'Modo de distribucion: "sequential" o "repeat". Default: sequential.'
+                description: 'Modo de distribucion. Default: "repeat" (cada fila = 1 documento). Usar "sequential" SOLO si el template tiene campos repetidos con el mismo nombre.'
             },
             merge_into_single: {
                 type: 'boolean',
@@ -54,7 +65,7 @@ Modos de distribucion:
     }
 };
 export async function handleGenerateBatch(args) {
-    const { template_name, distribution_mode = 'sequential', merge_into_single = false, output_dir } = args;
+    const { template_name, distribution_mode = 'repeat', merge_into_single = false, output_dir } = args;
     // data puede llegar como string JSON o como array
     let data = args.data;
     if (typeof data === 'string') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoform-mcp-server",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "MCP server for bulk PDF form filling. Detect fields, fill templates, and generate hundreds of PDFs from data — directly from Claude.",
   "type": "module",
   "main": "dist/index.js",