ai-first-cli 1.3.5 → 1.3.8

package/dist/mcp/server.js

@@ -0,0 +1,154 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { runAIFirst } from '../commands/ai-first.js';
+import { generateIndex } from '../core/indexer.js';
+export function startMCPServer(options = {}) {
+    const rootDir = options.rootDir || process.cwd();
+    const aiDir = options.aiDir || `${rootDir}/ai-context`;
+    const server = new Server({
+        name: 'ai-first-cli',
+        version: '1.4.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'generate_context',
+                    description: 'Generate AI context for the repository or a specific module',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            module: {
+                                type: 'string',
+                                description: 'Optional module path to generate context for (e.g., "src/auth")',
+                            },
+                            preset: {
+                                type: 'string',
+                                enum: ['full', 'quick', 'api', 'docs'],
+                                description: 'Preset to use for context generation',
+                            },
+                        },
+                    },
+                },
+                {
+                    name: 'query_symbols',
+                    description: 'Query symbols (functions, classes, interfaces) in the indexed repository',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'Search query for symbols',
+                            },
+                            type: {
+                                type: 'string',
+                                enum: ['function', 'class', 'interface', 'variable', 'all'],
+                                description: 'Type of symbol to search for',
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+                {
+                    name: 'get_architecture',
+                    description: 'Get the architecture analysis of the project',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            format: {
+                                type: 'string',
+                                enum: ['summary', 'detailed'],
+                                description: 'Level of detail for the architecture report',
+                            },
+                        },
+                    },
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'generate_context': {
+                    const result = await runAIFirst({
+                        rootDir,
+                        outputDir: aiDir,
+                    });
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: result.success,
+                                    filesCreated: result.filesCreated,
+                                    message: result.success
+                                        ? `Generated context in ${aiDir}`
+                                        : `Error: ${result.error}`,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'query_symbols': {
+                    const query = args?.query;
+                    const symbolType = args?.type || 'all';
+                    const index = generateIndex(rootDir, aiDir);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    query,
+                                    type: symbolType,
+                                    results: [],
+                                    message: `Symbol query executed for "${query}"`,
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                case 'get_architecture': {
+                    const format = args?.format || 'summary';
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    format,
+                                    rootDir,
+                                    message: 'Architecture analysis available',
+                                }, null, 2),
+                            },
+                        ],
+                    };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    server.connect(transport);
+    console.error('AI-First MCP Server running on stdio');
+}
+export { startMCPServer as startMCP };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,MAAM,UAAU,cAAc,CAAC,UAA4B,EAAE;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,aAAa,CAAC;IAEvD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO;YACL,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EAAE,6DAA6D;oBAC1E,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,iEAAiE;6BAC/E;4BACD,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC;gCACtC,WAAW,EAAE,sCAAsC;6BACpD;yBACF;qBACF;iBACF;gBACD;oBACE,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,0EAA0E;oBACvF,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,0BAA0B;6BACxC;4BACD,IAAI,EAAE;gCACJ,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC;gCAC3D,WAAW,EAAE,8BAA8B;6BAC5C;yBACF;wBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;qBACpB;iBACF;gBACD;oBACE,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EAAE,8CAA8C;oBAC3D,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,MAAM,EAAE;gCACN,IAAI,EAAE,QAAQ;gCACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;gCAC7B,WAAW,EAAE,6CAA6C;6BAC3D;yBACF;qBACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,kBAAkB,CAAC,CAAC,CAAC;oBACxB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;wBAC9B,OAAO;wBACP,SAAS,EAAE,KAAK;qBACjB,CAAC,CAAC;oBACH,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oCACnB,OAAO,EAAE,MAAM,CAAC,OAAO;oCACvB,YAAY,EAAE,MAAM,CAAC,YAAY;oCACjC,OAAO,EAAE,MAAM,CAAC,OAAO;wCACrB,CAAC,CAAC,wBAAwB,KAAK,EAAE;wCACjC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE;iCAC7B,EAAE,IAAI,EAAE,CAAC,CAAC;6BACZ;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,KAAK,eAAe,CAAC,CAAC,CAAC;oBACrB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;oBACpC,MAAM,UAAU,GAAI,IAAI,EAAE,IAAe,IAAI,KAAK,CAAC;oBAEnD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBAE5C,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oCACnB,KAAK;oCACL,IAAI,EAAE,UAAU;oCAChB,OAAO,EAAE,EAAE;oCACX,OAAO,EAAE,8BAA8B,KAAK,GAAG;iCAChD,EAAE,IAAI,EAAE,CAAC,CAAC;6BACZ;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;oBACxB,MAAM,MAAM,GAAI,IAAI,EAAE,MAAiB,IAAI,SAAS,CAAC;oBAErD,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oCACnB,MAAM;oCACN,OAAO;oCACP,OAAO,EAAE,iCAAiC;iCAC3C,EAAE,IAAI,EAAE,CAAC,CAAC;6BACZ;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED;oBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1B,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,CAAC"}

package/dist/utils/fileUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAkBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,UA6BtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,MAAM,EAA6B,EACpD,iBAAiB,GAAE,MAAM,EAA+B,GACvD,MAAM,EAAE,CAgCV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGtE"}
+{"version":3,"file":"fileUtils.d.ts","sourceRoot":"","sources":["../../src/utils/fileUtils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAuBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,UA6BtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,eAAe,GAAE,MAAM,EAA6B,EACpD,iBAAiB,GAAE,MAAM,EAA+B,GACvD,MAAM,EAAE,CAgCV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGtE"}

package/dist/utils/fileUtils.js

@@ -21,6 +21,11 @@ export const DEFAULT_EXCLUDE_PATTERNS = [
     "target",
     ".cache",
     ".DS_Store",
+    "test-projects",
+    ".ai-dev",
+    ".ai-dev-out",
+    "ai-context",
+    ".ai-first-ignore",
 ];
 /**
  * File extensions to include in scanning

package/dist/utils/fileUtils.js.map

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

package/docs/planning/evaluator-v1.0.0/README.md

@@ -0,0 +1,112 @@
+# Evaluator v1.0.0 - Planes de Mejora
+
+Este directorio contiene los planes de mejora generados por el AI-First Evaluator v1.0.0.
+
+## Estructura de Archivos
+
+```
+evaluator-v1.0.0/
+├── README.md                              # Este archivo
+├── improvements_plan_YYYY-MM-DD.md        # Plan de mejoras específico
+└── [futuros planes...]
+```
+
+## Convención de Nombres
+
+Los archivos de plan de mejoras siguen el formato:
+```
+improvements_plan_<fecha>.md
+```
+
+Ejemplos:
+- `improvements_plan_2026-03-28.md`
+- `improvements_plan_2026-04-15.md`
+- `improvements_plan_2026-05-01.md`
+
+## Template para Nuevas Evaluaciones
+
+Para crear un nuevo plan de mejoras:
+
+1. **Ejecutar el evaluator:**
+   ```bash
+   npm run evaluate:quick
+   ```
+
+2. **Copiar el template:**
+   ```bash
+   cp improvements_plan_2026-03-28.md improvements_plan_$(date +%Y-%m-%d).md
+   ```
+
+3. **Actualizar campos marcados:**
+   - Fecha de evaluación
+   - Proyecto evaluado
+   - Score obtenido
+   - Hallazgos específicos
+   - Owners y deadlines
+
+## Contenido del Plan de Mejoras
+
+Cada documento incluye:
+
+1. **Resumen Ejecutivo**
+   - Score total y métricas
+   - Distribución de puntos por perspectiva
+   - Estado general (PASS/FAIL)
+
+2. **Fortalezas**
+   - Qué se está haciendo bien
+   - Qué mantener
+
+3. **Áreas de Mejora**
+   - Priorizadas por impacto
+   - Con categorías (IMPLEMENTED, USER_ACTION, etc.)
+   - Incluyen templates de solución
+
+4. **Plan de Acción**
+   - Tablas con tareas, owners y deadlines
+   - Separadas por prioridad
+
+5. **Proyección de Mejora**
+   - Score actual vs proyectado
+   - ROI estimado
+
+6. **Checklist de Seguimiento**
+   - Implementación
+   - Verificación
+   - Documentación
+
+## Versionado
+
+Cuando se actualice el evaluator a una nueva versión (ej: v1.1.0, v2.0.0):
+
+1. Crear nuevo directorio: `evaluator-v1.1.0/`
+2. Copiar template actualizado
+3. Documentar cambios en el nuevo formato
+
+## Ejemplo de Uso
+
+```bash
+# 1. Evaluar proyecto
+npm run evaluate:quick
+
+# 2. Crear plan de mejoras
+cp docs/planning/evaluator-v1.0.0/improvements_plan_2026-03-28.md \
+   docs/planning/evaluator-v1.0.0/improvements_plan_$(date +%Y-%m-%d).md
+
+# 3. Editar con resultados específicos
+# [Abrir en editor y completar]
+
+# 4. Commit
+git add docs/planning/evaluator-v1.0.0/
+git commit -m "docs: add improvements plan for $(date +%Y-%m-%d)"
+```
+
+## Historial
+
+| Fecha | Proyecto | Score | Estado | Archivo |
+|-------|----------|-------|--------|---------|
+| 2026-03-28 | express-api | 3.88/5.0 | PASS | improvements_plan_2026-03-28.md |
+
+---
+
+**Nota:** Mantener este README actualizado con cada nueva versión del evaluator.

package/docs/planning/evaluator-v1.0.0/improvements_plan_2026-03-28.md

@@ -0,0 +1,237 @@
+# AI-First Evaluator - Plan de Mejoras
+
+**Template Version:** 1.0  
+**Evaluator Version:** 1.0.0  
+**Evaluation Date:** 2026-03-28  
+**Project:** express-api  
+**Current Score:** 3.88/5.0  
+**Status:** PASS
+
+---
+
+## Instrucciones de Uso
+
+Este documento es un TEMPLATE para registrar resultados de evaluación y planificar mejoras.
+
+### Para nuevas evaluaciones:
+1. Copiar este archivo como improvements_plan_YYYY-MM-DD.md
+2. Actualizar los campos marcados con [ACTUALIZAR]
+3. Documentar hallazgos específicos del proyecto
+4. Crear issues/tickets para acciones identificadas
+
+### Estructura del documento:
+- Resumen: Métricas principales y estado general
+- Hallazgos: Fortalezas y áreas de mejora
+- Plan de Acción: Tareas priorizadas con owners y deadlines
+- Seguimiento: Checklist de implementación
+
+---
+
+## Resumen Ejecutivo
+
+### Métricas Principales [ACTUALIZAR]
+
+- Score Total: 3.88/5.0
+- Umbral Mínimo: 3.5
+- Ahorro de Costos AI: 100%
+- Duración: 3ms
+- Estado: PASS
+
+### Distribución de Puntos
+
+| Perspectiva | Peso | Score | Estado |
+|-------------|------|-------|--------|
+| Local Structure | 40 pts | 40/40 | Pass |
+| Content Quality | 80 pts | 62/80 | Warning |
+| AI Assessment | 10 pts | N/A | Skipped |
+| Total | 130 pts | 102/130 | 78% |
+
+### Análisis por Categoría
+
+- IMPLEMENTED: 0 issues
+- USER_ACTION: 1 issue
+- KNOWN_LIMITATION: 0 issues
+- IMPROVEMENT: 4 issues
+
+---
+
+## Fortalezas (Mantener)
+
+1. Estructura Local Completa
+   - Archivos requeridos presentes
+   - JSON válidos
+   - Formato markdown consistente
+
+2. Features Opcionales Utilizadas
+   - API Contracts generados
+   - Framework Instructions presentes
+
+---
+
+## Áreas de Mejora (Priorizadas)
+
+### Alta Prioridad
+
+#### 1. Documentation Completeness
+Issue: Faltan secciones requeridas en summary.md  
+Categoría: IMPROVEMENT  
+Severidad: HIGH  
+Impacto: +8 pts
+
+Checklist:
+- [ ] Agregar sección Overview
+- [ ] Agregar sección Purpose
+- [ ] Agregar sección Features
+
+Template para fix:
+```
+## Overview
+[Breve descripción del proyecto]
+
+## Purpose  
+[Propósito principal]
+
+## Features
+- Feature 1: [descripción]
+- Feature 2: [descripción]
+```
+
+Owner: [ASIGNAR]  
+Deadline: [FECHA]
+
+---
+
+#### 2. Entry Point Documentation
+Issue: Entry points sin descripciones detalladas  
+Categoría: IMPROVEMENT  
+Severidad: MEDIUM  
+Impacto: +10 pts
+
+Checklist:
+- [ ] Usar headers para cada entry point
+- [ ] Agregar descripción de propósito
+- [ ] Documentar parámetros
+- [ ] Listar dependencias
+
+Template para fix:
+```
+### server.js
+Purpose: Punto de entrada principal
+Parameters: PORT, NODE_ENV
+Dependencies: express, cors
+```
+
+Owner: [ASIGNAR]  
+Deadline: [FECHA]
+
+---
+
+### Media Prioridad
+
+#### 3. Generic Phrases
+Issue: Descripciones contienen frases genéricas  
+Categoría: IMPROVEMENT  
+Severidad: MEDIUM  
+Impacto: +5 pts
+
+Ejemplos a corregir:
+- Antes: This project contains API endpoints
+- Después: REST API providing user authentication
+
+Owner: [ASIGNAR]  
+Deadline: [FECHA]
+
+---
+
+### Baja Prioridad
+
+#### 4. Freshness Tracking
+Issue: No hay tracking de freshness  
+Categoría: USER_ACTION  
+Severidad: LOW  
+Impacto: Mejor mantenibilidad
+
+Acción:
+```
+af init  # Re-generar contexto periódicamente
+```
+
+Frecuencia recomendada: Semanal o al inicio de cada sprint
+
+---
+
+## Plan de Acción
+
+### Inmediato (Esta semana)
+
+| # | Tarea | Impacto | Owner | Deadline | Status |
+|---|-------|---------|-------|----------|--------|
+| 1 | Completar summary.md | +8 pts | TBD | TBD | Pending |
+| 2 | Mejorar entrypoints.md | +10 pts | TBD | TBD | Pending |
+
+### Corto Plazo (Próximo sprint)
+
+| # | Tarea | Impacto | Owner | Deadline | Status |
+|---|-------|---------|-------|----------|--------|
+| 3 | Revisar frases genéricas | +5 pts | TBD | TBD | Pending |
+| 4 | Habilitar freshness tracking | N/A | TBD | TBD | Pending |
+
+---
+
+## Proyección de Mejora
+
+### Escenarios
+
+| Escenario | Score Actual | Score Proyectado | Cambio |
+|-----------|--------------|------------------|--------|
+| Conservador | 3.88 | 4.05 | +0.17 |
+| Completo | 3.88 | 4.20 | +0.32 |
+
+### ROI Esperado
+
+- Tiempo estimado: 2-3 horas
+- Mejora en score: +0.32 puntos
+- Impacto en calidad de AI: Mayor comprensión
+- Ahorro continuo: Mantiene 100% ahorro
+
+---
+
+## Checklist de Seguimiento
+
+### Implementación
+- [ ] Mejora #1 implementada
+- [ ] Mejora #2 implementada
+- [ ] Mejora #3 implementada (opcional)
+- [ ] Mejora #4 implementada (opcional)
+
+### Verificación
+- [ ] Re-ejecutar evaluator
+- [ ] Validar nuevo score >= 4.0
+- [ ] Confirmar que no hay regresiones
+- [ ] Actualizar este documento
+
+### Documentación
+- [ ] Actualizar CHANGELOG
+- [ ] Crear PR con cambios
+- [ ] Revisión de código
+- [ ] Merge a main
+
+---
+
+## Notas Adicionales
+
+### Lecciones Aprendidas
+[ESPACIO PARA NOTAS]
+
+### Bloqueos Identificados
+[DOCUMENTAR SI HAY BLOQUEOS]
+
+### Recursos Útiles
+- Guía de escritura: [LINK]
+- Template summary.md: [LINK]
+- Ejemplos entry points: [LINK]
+
+---
+
+Documento generado por: AI-First Evaluator v1.0.0  
+Última actualización: 2026-03-28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-first-cli",
-  "version": "1.3.5",
+  "version": "1.3.8",
   "description": "CLI tool that prepares any repository to be used effectively by AI coding agents",
   "main": "dist/index.js",
   "type": "module",
@@ -16,7 +16,11 @@
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "if [ -d node_modules/ai-first-evaluator ]; then cd node_modules/ai-first-evaluator && npm install && npm run build 2>/dev/null || true; fi",
+    "evaluate": "node node_modules/ai-first-evaluator/dist/core/evaluation/run-evaluation.js --config evaluator.config.json 2>/dev/null || echo 'Evaluator not installed'",
+    "evaluate:ci": "node node_modules/ai-first-evaluator/dist/core/evaluation/run-evaluation.js --config evaluator.config.json --compare-baseline --save-baseline 2>/dev/null || echo 'Evaluator not installed'",
+    "evaluate:quick": "node node_modules/ai-first-evaluator/dist/core/evaluation/run-evaluation.js --config evaluator.config.json --skip-ai 2>/dev/null || echo 'Evaluator not installed'"
   },
   "keywords": [
     "ai",
@@ -27,7 +31,9 @@
     "development",
     "tool",
     "code-analysis",
-    "indexing"
+    "indexing",
+    "mcp",
+    "model-context-protocol"
   ],
   "author": "Julian Perez Pesce <julian@example.com> (https://github.com/julianperezpesce)",
   "license": "MIT",
@@ -47,7 +53,11 @@
     "vitest": "^4.1.0",
     "vue": "^3.5.30"
   },
+  "optionalDependencies": {
+    "ai-first-evaluator": "git+https://github.com/julianperezpesce/ai-first-evaluator.git"
+  },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
     "chokidar": "^5.0.0",
     "ora": "^9.3.0",
     "sql.js": "^1.10.0"