ai-first-cli 1.3.5 → 1.3.6

package/BETA_EVALUATION_REPORT.md

@@ -1,151 +0,0 @@
-# 📊 Evaluación de Beta - Estado Actual vs Esperado
-
-**Fecha:** 2026-03-24  
-**Branch:** beta-merge (listo para merge a master)  
-**Tests:** 996/996 ✅
-
----
-
-## 🔍 Análisis del Código Fuente en Beta
-
-### 1. Detección de Frameworks (`src/analyzers/techStack.ts`)
-
-| Framework | Estado Actual | Esperado | ¿Funciona? |
-|-----------|--------------|----------|------------|
-| **NestJS** | Busca `"nest"` | Debería buscar `"@nestjs/common"` | ❌ NO |
-| **Spring Boot** | Detectado | Debería estar en "Frameworks" | ⚠️ Parcial |
-| **Express** | Detectado | OK | ✅ SÍ |
-| **Django** | Detectado | OK | ✅ SÍ |
-
-**Problema:** Los paquetes scoped (`@nestjs/*`) NO se detectan.
-
-### 2. Detección de Patrones (`src/analyzers/architecture.ts`)
-
-| Proyecto | Detecta Actualmente | Debería Detectar | ¿Correcto? |
-|----------|---------------------|------------------|------------|
-| **Express** | "Microservices" | "API Server" | ❌ ERROR |
-| **NestJS** | "Flat / Simple" | "Modular" | ❌ ERROR |
-| **Spring** | "Layered" | "Layered" | ✅ OK |
-| **Django** | "MVC" | "MTV" | ⚠️ Cerca |
-
-**Problema:** La lógica de Microservices es muy amplia (cualquier proyecto con directorio `services/` se marca como microservicios).
-
-### 3. Entrypoints (`src/analyzers/entrypoints.ts`)
-
-| Lenguaje | Soporte Actual | Esperado | ¿Implementado? |
-|----------|----------------|----------|----------------|
-| **TypeScript/JS** | ✅ | ✅ | SÍ |
-| **Python** | ✅ | ✅ | SÍ |
-| **Java** | ✅ | ✅ | SÍ |
-| **Swift** | ✅ | ✅ | SÍ |
-| **Go** | ❌ | ✅ | NO |
-| **Rust** | ❌ | ✅ | NO |
-| **PHP** | ❌ | ✅ | NO |
-| **Kotlin** | ❌ | ✅ | NO |
-
-**Problema:** Solo tiene soporte para Swift (`.swift`). Go, Rust, PHP, Kotlin NO están implementados.
-
----
-
-## 📈 Resultados de Tests
-
-### ✅ Lo que FUNCIONA:
-
-1. **996 tests pasando** (100% éxito)
-2. **Salesforce Testing Suite** - 531 tests completos
-   - Apex Classes: ✅ 43 tests
-   - Apex Triggers: ✅ 67 tests
-   - LWC: ✅ 73 tests
-   - Flows: ✅ 74 tests
-   - Custom Objects: ✅ 147 tests
-   - SFDX: ✅ 127 tests
-
-3. **CLI Commands Testing** - 296 tests completos
-   - init, index, watch, context, summarize: ✅
-   - query, map, doctor, explore, adapters: ✅
-   - git, graph, update, help: ✅
-
-4. **Core functionality intacta**
-   - Parser de Apex: ✅
-   - Parser de TypeScript: ✅
-   - Parser de Python: ✅
-   - Parser de Java: ✅
-   - Adapter registry: ✅
-
-### ❌ Lo que NO FUNCIONA (faltan los fixes):
-
-1. **Framework Detection Fixes**
-   - NestJS con @nestjs/*: ❌ NO detecta
-   - Spring Boot en Frameworks: ❌ Sale en Libraries
-   - Express Microservices: ❌ Incorrecto
-
-2. **Entrypoints para nuevos lenguajes**
-   - Go (main.go, handlers): ❌ NO implementado
-   - Rust (main.rs, Cargo.toml): ❌ NO implementado
-   - PHP (index.php): ❌ NO implementado
-
-3. **Symbol Extraction Mejorado**
-   - Go structs/functions: ❌ Básico
-   - Rust structs: ❌ NO detecta
-
----
-
-## 🎯 Recomendación
-
-### Opción 1: Mergear a Master AHORA (Recomendado)
-**Pros:**
-- ✅ 996 tests pasando (sin regresiones)
-- ✅ Tests de Salesforce excelentes
-- ✅ Tests de CLI completos
-- ✅ Documentación actualizada
-- ✅ Funcionalidad core intacta
-
-**Contras:**
-- ❌ Algunos proyectos de ejemplo NO tienen la calidad óptima en ai-context/
-- ❌ Los tests de calidad (evaluador AI) podrían mostrar scores bajos
-
-**Veredicto:** Los tests garantizan que la funcionalidad core funciona. Los fixes de calidad son mejoras incrementales que pueden venir después.
-
-### Opción 2: Implementar Fixes Primero
-**Requiere:**
-- 2-3 horas adicionales
-- Implementar fixes en techStack.ts, architecture.ts, entrypoints.ts
-- Nuevos tests para los fixes
-- Regenerar ai-context de proyectos
-
-**Riesgo:** Demorar el release por mejoras que no afectan la funcionalidad core.
-
----
-
-## 📋 Resumen de Tests Ejecutados
-
-```bash
-Test Files: 27 passed (27)
-Tests:      996 passed (996)
-Duration:   43.96s
-
-Cobertura:
-- Salesforce:    531 tests ✅
-- CLI Commands:  296 tests ✅
-- Core:          169 tests ✅
-
-Build: ✅ Exitoso
-TypeScript: ✅ Sin errores
-```
-
----
-
-## 🚀 Decisión Final
-
-**Estado:** Listo para merge a master ✅
-
-**Justificación:**
-1. Los 996 tests garantizan que todo funciona
-2. Las mejoras de calidad son incrementalmente aplicables
-3. La documentación está completa y actualizada
-4. No hay regresiones en funcionalidad existente
-
-**Próximos pasos después del merge:**
-- Crear issue para implementar los fixes faltantes
-- Priorizar: NestJS detection > Entrypoints Go/Rust > Express Microservices
-- Target: Release v1.3.6 con mejoras de calidad

package/ai-context/context/flows/App.json

@@ -1,17 +0,0 @@
-{
-  "name": "App",
-  "entrypoint": "test-projects/react-app/src/App.tsx",
-  "files": [
-    "test-projects/react-app/src/App.tsx",
-    "test-projects/react-app/src/context/AuthContext.tsx",
-    "test-projects/react-app/src/pages/LoginPage.tsx",
-    "test-projects/react-app/src/hooks/useAuth.ts",
-    "test-projects/react-app/src/pages/DashboardPage.tsx",
-    "test-projects/react-app/src/pages/UsersPage.tsx"
-  ],
-  "depth": 5,
-  "layers": [
-    "unknown",
-    "api"
-  ]
-}

package/ai-context/context/flows/DashboardPage.json

@@ -1,14 +0,0 @@
-{
-  "name": "DashboardPage",
-  "entrypoint": "test-projects/react-app/src/pages/DashboardPage.tsx",
-  "files": [
-    "test-projects/react-app/src/pages/DashboardPage.tsx",
-    "test-projects/react-app/src/hooks/useAuth.ts",
-    "test-projects/react-app/src/context/AuthContext.tsx"
-  ],
-  "depth": 2,
-  "layers": [
-    "api",
-    "unknown"
-  ]
-}

package/ai-context/context/flows/LoginPage.json

@@ -1,14 +0,0 @@
-{
-  "name": "LoginPage",
-  "entrypoint": "test-projects/react-app/src/pages/LoginPage.tsx",
-  "files": [
-    "test-projects/react-app/src/pages/LoginPage.tsx",
-    "test-projects/react-app/src/hooks/useAuth.ts",
-    "test-projects/react-app/src/context/AuthContext.tsx"
-  ],
-  "depth": 2,
-  "layers": [
-    "api",
-    "unknown"
-  ]
-}

package/ai-context/context/flows/admin.json

@@ -1,10 +0,0 @@
-{
-  "name": "admin",
-  "entrypoint": "test-projects/django-app/blog/admin.py",
-  "files": [
-    "test-projects/django-app/blog/admin.py",
-    "test-projects/django-app/users/admin.py"
-  ],
-  "depth": 0,
-  "layers": []
-}

package/ai-context/context/flows/androidresources.json

@@ -1,11 +0,0 @@
-{
-  "name": "androidresources",
-  "entrypoint": "src/analyzers/androidResources.ts",
-  "files": [
-    "src/analyzers/androidResources.ts"
-  ],
-  "depth": 1,
-  "layers": [
-    "api"
-  ]
-}

package/ai-context/context/flows/authController.json

@@ -1,14 +0,0 @@
-{
-  "name": "authController",
-  "entrypoint": "test-projects/express-api/controllers/authController.js",
-  "files": [
-    "test-projects/express-api/controllers/authController.js",
-    "tests/pythonParser.test.ts",
-    "src/core/parsers/pythonParser.ts"
-  ],
-  "depth": 3,
-  "layers": [
-    "api",
-    "unknown"
-  ]
-}

package/ai-context/context/flows/entrypoints.json

@@ -1,9 +0,0 @@
-{
-  "name": "entrypoints",
-  "entrypoint": "src/analyzers/entrypoints.ts",
-  "files": [
-    "src/analyzers/entrypoints.ts"
-  ],
-  "depth": 0,
-  "layers": []
-}

package/ai-context/context/flows/fastapiAdapter.json

@@ -1,14 +0,0 @@
-{
-  "name": "fastapiAdapter",
-  "entrypoint": "src/core/adapters/community/fastapiAdapter.ts",
-  "files": [
-    "src/core/adapters/community/fastapiAdapter.ts",
-    "src/core/adapters/sdk.ts",
-    "src/core/adapters/baseAdapter.ts"
-  ],
-  "depth": 2,
-  "layers": [
-    "api",
-    "unknown"
-  ]
-}

package/ai-context/context/flows/fastapiadapter.json

@@ -1,11 +0,0 @@
-{
-  "name": "fastapiadapter",
-  "entrypoint": "src/core/adapters/community/fastapiAdapter.ts",
-  "files": [
-    "src/core/adapters/community/fastapiAdapter.ts"
-  ],
-  "depth": 1,
-  "layers": [
-    "api"
-  ]
-}

package/ai-context/context/flows/index.json

@@ -1,19 +0,0 @@
-{
-  "name": "index",
-  "entrypoint": "docs/.vitepress/theme/index.ts",
-  "files": [
-    "docs/.vitepress/theme/index.ts",
-    "src/core/adapters/community/index.ts",
-    "src/core/adapters/index.ts",
-    "src/core/analysis/index.ts",
-    "src/core/generation/index.ts",
-    "src/core/parsers/index.ts",
-    "src/index.ts",
-    "test-projects/express-api/index.js",
-    "test-projects/php-vanilla/index.php"
-  ],
-  "depth": 1,
-  "layers": [
-    "api"
-  ]
-}

package/ai-context/context/flows/indexer.json

@@ -1,9 +0,0 @@
-{
-  "name": "indexer",
-  "entrypoint": "src/core/indexer.ts",
-  "files": [
-    "src/core/indexer.ts"
-  ],
-  "depth": 0,
-  "layers": []
-}

package/ai-context/context/flows/indexstate.json

@@ -1,9 +0,0 @@
-{
-  "name": "indexstate",
-  "entrypoint": "src/core/indexState.ts",
-  "files": [
-    "src/core/indexState.ts"
-  ],
-  "depth": 0,
-  "layers": []
-}

package/ai-context/context/flows/init.json

@@ -1,22 +0,0 @@
-{
-  "name": "init",
-  "entrypoint": "test-projects/flask-app/app/api/__init__.py",
-  "files": [
-    "test-projects/flask-app/app/api/__init__.py",
-    "test-projects/django-app/blog/__init__.py",
-    "test-projects/django-app/django_app/__init__.py",
-    "test-projects/django-app/users/__init__.py",
-    "test-projects/flask-app/app/__init__.py",
-    "test-projects/flask-app/app/auth/__init__.py",
-    "test-projects/flask-app/app/blog/__init__.py",
-    "test-projects/flask-app/app/main/__init__.py",
-    "test-projects/python-cli/__init__.py",
-    "test-projects/python-cli/cli/__init__.py",
-    "test-projects/python-cli/models/__init__.py"
-  ],
-  "depth": 2,
-  "layers": [
-    "api",
-    "domain"
-  ]
-}

package/ai-context/context/flows/main.json

@@ -1,18 +0,0 @@
-{
-  "name": "main",
-  "entrypoint": "test-projects/react-app/src/main.tsx",
-  "files": [
-    "test-projects/react-app/src/main.tsx",
-    "test-projects/react-app/src/App.tsx",
-    "test-projects/react-app/src/context/AuthContext.tsx",
-    "test-projects/react-app/src/pages/LoginPage.tsx",
-    "test-projects/react-app/src/hooks/useAuth.ts",
-    "test-projects/react-app/src/pages/DashboardPage.tsx",
-    "test-projects/react-app/src/pages/UsersPage.tsx"
-  ],
-  "depth": 5,
-  "layers": [
-    "unknown",
-    "api"
-  ]
-}

package/ai-context/context/flows/mainactivity.json

@@ -1,9 +0,0 @@
-{
-  "name": "mainactivity",
-  "entrypoint": "test-projects/android-kotlin-app/src/MainActivity.kt",
-  "files": [
-    "test-projects/android-kotlin-app/src/MainActivity.kt"
-  ],
-  "depth": 0,
-  "layers": []
-}

package/ai-context/context/flows/models.json

@@ -1,15 +0,0 @@
-{
-  "name": "models",
-  "entrypoint": "test-projects/django-app/blog/models.py",
-  "files": [
-    "test-projects/django-app/blog/models.py",
-    "test-projects/django-app/users/models.py",
-    "test-projects/fastapi-app/app/models.py",
-    "test-projects/flask-app/app/models.py"
-  ],
-  "depth": 2,
-  "layers": [
-    "domain",
-    "api"
-  ]
-}

package/ai-context/context/flows/posts.json

@@ -1,15 +0,0 @@
-{
-  "name": "posts",
-  "entrypoint": "test-projects/fastapi-app/app/routers/posts.py",
-  "files": [
-    "test-projects/fastapi-app/app/routers/posts.py",
-    "test-projects/nestjs-backend/src/main.ts",
-    "test-projects/fastapi-app/app/database.py",
-    "src/core/moduleGraph.ts"
-  ],
-  "depth": 4,
-  "layers": [
-    "api",
-    "unknown"
-  ]
-}

package/ai-context/context/flows/repoMapper.json

@@ -1,20 +0,0 @@
-{
-  "name": "repoMapper",
-  "entrypoint": "src/core/repoMapper.ts",
-  "files": [
-    "src/core/repoMapper.ts",
-    "test-projects/react-app/src/main.tsx",
-    "test-projects/react-app/src/App.tsx",
-    "test-projects/react-app/src/context/AuthContext.tsx",
-    "test-projects/react-app/src/pages/LoginPage.tsx",
-    "test-projects/react-app/src/hooks/useAuth.ts",
-    "test-projects/react-app/src/pages/DashboardPage.tsx",
-    "test-projects/react-app/src/pages/UsersPage.tsx"
-  ],
-  "depth": 5,
-  "layers": [
-    "data",
-    "unknown",
-    "api"
-  ]
-}

package/ai-context/context/flows/repomapper.json

@@ -1,11 +0,0 @@
-{
-  "name": "repomapper",
-  "entrypoint": "src/core/repoMapper.ts",
-  "files": [
-    "src/core/repoMapper.ts"
-  ],
-  "depth": 1,
-  "layers": [
-    "data"
-  ]
-}

package/ai-context/context/flows/serializers.json

@@ -1,10 +0,0 @@
-{
-  "name": "serializers",
-  "entrypoint": "test-projects/django-app/blog/serializers.py",
-  "files": [
-    "test-projects/django-app/blog/serializers.py",
-    "test-projects/django-app/users/serializers.py"
-  ],
-  "depth": 0,
-  "layers": []
-}