ai-first-cli 1.1.5 → 1.2.0

package/README.es.md

@@ -24,12 +24,12 @@
 
 ```
 $ npx ai-first init
-✅ Generated ai/ai_context.md (0.3s)
-✅ Generated ai/symbols.json (0.1s)  
-✅ Generated ai/dependencies.json (0.1s)
+✅ Generated ai-context/ai_context.md (0.3s)
+✅ Generated ai-context/symbols.json (0.1s)  
+✅ Generated ai-context/dependencies.json (0.1s)
 ✅ Generated 11 context files
 
-🎉 Ready! Give ai/ai_context.md to your AI assistant.
+🎉 Ready! Give ai-context/ai_context.md to your AI assistant.
 ```
 
 **Resultado:** La IA comprende tu proyecto en ~500 tokens en lugar de 50,000.
@@ -114,13 +114,13 @@ ai-first init
 ### 1. Agentes de Código IA (OpenCode, Cursor, Claude Code)
 ```bash
 ai-first init
-# Luego pregunta a la IA: "Lee ai/ai_context.md y ayúdame a agregar una característica"
+# Luego pregunta a la IA: "Lee ai-context/ai_context.md y ayúdame a agregar una característica"
 ```
 
 ### 2. Incorporación de Nuevos Desarrolladores
 ```bash
 ai-first init
-# El nuevo desarrollador lee ai/ai_context.md → comprende el proyecto en 2 minutos
+# El nuevo desarrollador lee ai-context/ai_context.md → comprende el proyecto en 2 minutos
 ```
 
 ### 3. Documentación del Proyecto
@@ -148,7 +148,7 @@ Resultado: Código roto, tokens desperdiciados
 ```
 $ ai-first init
 
-Tú: "Lee ai/ai_context.md, luego agrega autenticación"
+Tú: "Lee ai-context/ai_context.md, luego agrega autenticación"
 IA: *lee 1 archivo (0.5s)*
 IA: "Veo que usas Express + JWT con auth en src/middleware/auth.ts"
 IA: "Agregaré autenticación siguiendo tus convenciones..."
@@ -238,7 +238,7 @@ AI-First CLI
 ## 📁 Archivos Generados
 
 ```
-ai/
+ai-context/
 ├── ai_context.md      # ⭐ Empieza aquí — vista general unificada
 ├── repo_map.json      # Estructura legible por máquina
 ├── symbols.json       # Funciones/clases extraídas
@@ -268,7 +268,7 @@ ai/
 | Agente | Cómo Usarlo |
 |--------|-------------|
 | **OpenCode** | `~/.config/opencode/commands/ai-first.md` |
-| **Cursor** | Referencia `ai/ai_context.md` en prompts |
+| **Cursor** | Referencia `ai-context/ai_context.md` en prompts |
 | **Claude Code** | Incluye contexto en el prompt del sistema |
 | **Windsurf** | Comprensión del proyecto |
 | **GitHub Copilot** | Sugerencias conscientes del contexto |
@@ -289,60 +289,25 @@ ai-first init --output ./docs/ai
 
 # Directorio raíz personalizado
 ai-first init --root ./my-project
-TH|```
-TH|
-TH|## 📦 Context Control Packs (CCP)
-TH|
-TH|CCP (Context Control Packs) te permite crear contextos reutilizables y específicos para diferentes flujos de trabajo de IA.
-TH|
-TH|### Cómo Funciona
-TH|
-TH|1. **Generar Módulos de Contexto**: `ai-first init` crea módulos en `ai/context/`
-TH|2. **Crear un CCP**: Define qué módulos incluir para una tarea específica
-TH|3. **Usar en IA**: Referencia el CCP al trabajar con agentes de IA
-TH|
-TH|### Comandos CCP
-TH|
-TH|```bash
-TH|# Crear un nuevo CCP con módulos de contexto específicos
-TH|ai-first ccp create tarea-auth --include repo,auth,api --description "Trabajo en autenticación"
-TH|
-TH|# Listar todos los CCPs disponibles
-TH|ai-first ccp list
-TH|
-TH|# Mostrar detalles del CCP
-TH|ai-first ccp show tarea-auth
-TH|```
-TH|
-TH|### Estructura CCP
-TH|
-TH|```
-TH|ai/
-TH|├── context/           # Módulos de contexto (auto-generados)
-TH|│   ├── repo.json      # Contexto base del repositorio
-TH|│   ├── auth.json      # Contexto de autenticación
-TH|│   └── <feature>.json
-TH|│
-TH|└── ccp/              # Definiciones de CCP
-TH|    └── <nombre>/
-TH|        └── context.json
-TH|```
-TH|
-TH|Ejemplo CCP (context.json)
-TH|
-TH|```json
-TH|{
-TH|  "task": "auth-feature",
-TH|  "description": "Trabajo en autenticación",
-TH|  "includes": [
-TH|    "../../context/repo.json",
-TH|    "../../context/auth.json",
-TH|    "../../context/api.json"
-TH|  ]
-TH|}
-TH|```
-TH|
-Caso de uso: Crea contextos específicos como `"fix-bug"`, `"add-feature"`, `"refactor"`, etc.
+```
+
+---
+
+## 📦 Context Control Packs (CCP)
+
+CCP (Context Control Packs) te permite crear contextos reutilizables y específicos para diferentes flujos de trabajo de IA.
+
+### Cómo Funciona
+
+1. **Generar Módulos de Contexto**: `ai-first init` crea módulos en `ai-context/context/`
+2. **Crear un CCP**: Define qué módulos incluir para una tarea específica
+3. **Usar en IA**: Referencia el CCP al trabajar con agentes de IA
+
+### Ejemplo
+
+```bash
+ai-first ccp create tarea-auth --include repo,auth,api --description "Trabajo en autenticación"
+```
 
 ---
 
@@ -360,7 +325,7 @@ Los features representan módulos de negocio detectados desde la estructura del
 - Excluidos: utils, helpers, types, interfaces, constants, config, models, dto, common
 
 ```json
-// ai/context/features/<modulo>.json
+// ai-context/context/features/<modulo>.json
 {
   "feature": "auth",
   "files": ["src/auth/controller.js", "src/auth/service.js"],
@@ -378,7 +343,7 @@ Los flows representan cadenas de ejecución de negocio desde entrypoints.
 - Debe iniciar desde un entrypoint (Controller, Route, Command, Handler)
 
 ```json
-// ai/context/flows/<nombre>.json
+// ai-context/context/flows/<nombre>.json
 {
   "name": "login",
   "entrypoint": "src/auth/controller.js",
@@ -392,35 +357,50 @@ Los flows representan cadenas de ejecución de negocio desde entrypoints.
 
 ---
 
-## 🌎 Idiomas
-TH|
-TH|---
+## 🤖 Soporte Android/Kotlin
 
----
+ai-first detecta e indexa automáticamente proyectos Android/Kotlin:
 
-## 🌎 Idiomas
+- **Detección de lenguaje**: Kotlin (.kt)
+- **Detección de framework**: Android (vía build.gradle, AndroidManifest.xml)
+- **Análisis de dependencias**: Dependencias Gradle (implementation, api, compile)
+- **Puntos de entrada**: Activities, Services, BroadcastReceivers desde AndroidManifest.xml
+- **Recursos**: Indexa res/layout, res/drawable, res/values
+- **Multi-módulo**: Detecta módulos Gradle desde settings.gradle
 
-Esta documentación está disponible en:
+### Archivos generados para proyectos Android
 
-* English (por defecto)
-* Español
+- `ai-context/tech_stack.md` - Muestra Android con versiones de SDK
+- `ai-context/dependencies.json` - Dependencias Gradle en formato group:artifact:version
+- `ai-context/entrypoints.md` - Activities, services, permisos de Android
+- `ai-context/android-resources.json` - Layouts, drawables, values (si existe res/)
+- `ai-context/gradle-modules.json` - Estructura multi-módulo (si existe settings.gradle)
 
 ---
 
 ## 📋 Roadmap
 
-### v1.1 (Próximamente)
-- [ ] Modo watch para auto-regeneración
-- [ ] Integración con Git (analizar cambios recientes)
+### Phase 1 ✅ (Completado)
+- Infraestructura de testing con 11 proyectos de prueba
+
+### Phase 2 ✅ (Completado)
+- Fixes de calidad: extracción de símbolos, sanitización de nombres de flows
+- Soporte para parsers PHP y Ruby agregado
+- 11 adapters funcionando (100% cobertura)
 
-### v1.2 (Planificado)
-- [ ] Integración LSP para símbolos más ricos
-- [ ] Plugins de analizadores personalizados
+### Phase 3 (Planificado)
+- [ ] Indexación semántica mejorada
+- [ ] Sistema de plugins para analizadores custom
+- [ ] Soporte Scala
+- [ ] Soporte de archivo de configuración (`ai-first.config.json`)
+- [ ] Sistema de reglas/plugins custom
+- [ ] Plantillas de integración CI/CD
 
-### v2.0 (Futuro)
-- [ ] Análisis multi-repositorio
-- [ ] Extensiones de IDE (VS Code, JetBrains)
-- [ ] Integración CI/CD
+### Phase 4 (Futuro)
+- [ ] Integración con Git (analizar cambios recientes)
+- [ ] Contexto aware de diff (qué cambió desde última ejecución)
+- [ ] Modo interactivo
+- [ ] Extensión de VS Code
 
 ---
 
@@ -460,27 +440,30 @@ Ver [docs/architecture.md](./docs/architecture.md) para arquitectura interna.
 ¡Danos una ⭐ si este proyecto te ayudó!
 
 ---
-KP|
-VT|## 🤖 Soporte Android/Kotlin
-HB|
-XZ|ai-first detecta e indexa automáticamente proyectos Android/Kotlin:
-HB|
-RV|- **Detección de lenguaje**: Kotlin (.kt)
+
+## 🤖 Soporte Android/Kotlin
+
+ai-first detecta e indexa automáticamente proyectos Android/Kotlin:
+
+- **Detección de lenguaje**: Kotlin (.kt)
 - **Detección de framework**: Android (vía build.gradle, AndroidManifest.xml)
 - **Análisis de dependencias**: Dependencias Gradle (implementation, api, compile)
 - **Puntos de entrada**: Activities, Services, BroadcastReceivers desde AndroidManifest.xml
 - **Recursos**: Indexa res/layout, res/drawable, res/values
 - **Multi-módulo**: Detecta módulos Gradle desde settings.gradle
-HB|
-XZ|### Archivos generados para proyectos Android
-HB|
-XZ|- `ai/tech_stack.md` - Muestra Android con versiones de SDK
-- `ai/dependencies.json` - Dependencias Gradle en formato group:artifact:version
-- `ai/entrypoints.md` - Activities, services, permisos de Android
-- `ai/android-resources.json` - Layouts, drawables, values (si existe res/)
-- `ai/gradle-modules.json` - Estructura multi-módulo (si existe settings.gradle)
-HB|
-VT|---
+
+### Archivos generados para proyectos Android
+
+- `ai-context/tech_stack.md` - Muestra Android con versiones de SDK
+- `ai-context/dependencies.json` - Dependencias Gradle en formato group:artifact:version
+- `ai-context/entrypoints.md` - Activities, services, permisos de Android
+- `ai-context/android-resources.json` - Layouts, drawables, values (si existe res/)
+- `ai-context/gradle-modules.json` - Estructura multi-módulo (si existe settings.gradle)
+
+---
+
 ## 📄 Licencia
 
 MIT © [Julian Perez Pesce](https://github.com/julianperezpesce)
+
+MIT © [Julian Perez Pesce](https://github.com/julianperezpesce)

package/README.md

@@ -22,12 +22,12 @@
 
 ```
 $ npx ai-first init
-✅ Generated ai/ai_context.md (0.3s)
-✅ Generated ai/symbols.json (0.1s)  
-✅ Generated ai/dependencies.json (0.1s)
+✅ Generated ai-context/ai_context.md (0.3s)
+✅ Generated ai-context/symbols.json (0.1s)  
+✅ Generated ai-context/dependencies.json (0.1s)
 ✅ Generated 11 context files
 
-🎉 Ready! Give ai/ai_context.md to your AI assistant.
+🎉 Ready! Give ai-context/ai_context.md to your AI assistant.
 ```
 
 **Result:** AI understands your project in ~500 tokens instead of 50,000.
@@ -113,13 +113,13 @@ ai-first init
 ### 1. AI Coding Agents (OpenCode, Cursor, Claude Code)
 ```bash
 ai-first init
-# Then ask AI: "Read ai/ai_context.md and help me add a feature"
+# Then ask AI: "Read ai-context/ai_context.md and help me add a feature"
 ```
 
 ### 2. Onboarding New Developers
 ```bash
 ai-first init
-# New dev reads ai/ai_context.md → understands project in 2 minutes
+# New dev reads ai-context/ai_context.md → understands project in 2 minutes
 ```
 
 ### 3. Project Documentation
@@ -147,7 +147,7 @@ Result: Broken code, wasted tokens
 ```
 $ ai-first init
 
-You: "Read ai/ai_context.md, then add authentication"
+You: "Read ai-context/ai_context.md, then add authentication"
 AI: *reads 1 file (0.5s)*
 AI: "I see you're using Express + JWT with auth in src/middleware/auth.ts"
 AI: "I'll add authentication following your conventions..."
@@ -239,9 +239,9 @@ AI-First CLI
 ## 📁 Generated Files
 
 ```
-ai/
+ai-context/
 ├── ai_context.md      # ⭐ Start here — unified overview
-├── repo_map.json      # Machine-readable structure
+├── repo_map.json     # Machine-readable structure
 ├── symbols.json       # Extracted functions/classes with unique IDs
 ├── dependencies.json  # Import relationships
 ├── architecture.md    # Architecture pattern
@@ -276,7 +276,7 @@ ai/
 | Agent | How to Use |
 |-------|------------|
 | **OpenCode** | `~/.config/opencode/commands/ai-first.md` |
-| **Cursor** | Reference `ai/ai_context.md` in prompts |
+| **Cursor** | Reference `ai-context/ai_context.md` in prompts |
 | **Claude Code** | Include context in system prompt |
 | **Windsurf** | Project understanding |
 | **GitHub Copilot** | Context-aware suggestions |
@@ -351,62 +351,10 @@ ai-first explore src
 ```
 
 The explore command generates a module dependency graph based on imports.
-QB|---
-QB|
-QB|## 📦 Context Control Packs (CCP)
-QB|
-QB|CCP (Context Control Packs) allow you to create reusable, task-specific contexts for different AI workflows.
-QB|
-QB|### How It Works
-QB|
-QB|1. **Generate Context Modules**: `ai-first init` creates context modules in `ai/context/`
-QB|2. **Create a CCP**: Define which modules to include for a specific task
-QB|3. **Use in AI**: Reference the CCP when working with AI agents
-QB|
-QB|### CCP Commands
-QB|
-QB|```bash
-QB|# Create a new CCP with specific context modules
-QB|ai-first ccp create auth-task --include repo,auth,api --description "Authentication feature work"
-QB|
-QB|# List all available CCPs
-QB|ai-first ccp list
-QB|
-QB|# Show CCP details
-QB|ai-first ccp show auth-task
-QB|```
-QB|
-QB|### CCP Structure
-QB|
-QB|```
-QB|ai/
-QB|├── context/           # Context modules (auto-generated)
-QB|│   ├── repo.json      # Base repository context
-QB|│   ├── auth.json      # Auth feature context
-QB|│   └── <feature>.json
-QB|│
-QB|└── ccp/              # CCP definitions
-QB|    └── <name>/
-QB|        └── context.json
-QB|```
-QB|
-QB|### Example CCP (context.json)
-QB|
-QB|```json
-QB|{
-QB|  "task": "auth-feature",
-QB|  "description": "Work on authentication feature",
-QB|  "includes": [
-QB|    "../../context/repo.json",
-QB|    "../../context/auth.json",
-QB|    "../../context/api.json"
-QB|  ]
-QB|}
-QB|```
-QB|
-QB|Use case: Create task-specific contexts like `"fix-bug"`, `"add-feature"`, `"refactor"`, etc.
-QB|
-QB|---
+
+---
+
+## 📦 Context Control Packs (CCP)
 QB|
 ---
 
@@ -419,7 +367,14 @@ For large repositories (>2000 files), semantic indexing is automatically enabled
 ai-first index --semantic
 ```
 
-NP|---
+For large repositories (>2000 files), semantic indexing is automatically enabled:
+
+```bash
+# Force semantic indexing
+ai-first index --semantic
+```
+
+---
 
 ## 🎯 Semantic Contexts (Features & Flows)
 
@@ -435,7 +390,7 @@ Features represent real business modules detected from your project structure.
 - Excluded: utils, helpers, types, interfaces, constants, config, models, dto, common
 
 ```json
-// ai/context/features/<module>.json
+// ai-context/context/features/<module>.json
 {
   "feature": "auth",
   "files": ["src/auth/controller.js", "src/auth/service.js"],
@@ -453,7 +408,7 @@ Flows represent business execution chains starting from entrypoints.
 - Must start from an entrypoint (Controller, Route, Command, Handler)
 
 ```json
-// ai/context/flows/<name>.json
+// ai-context/context/flows/<name>.json
 {
   "name": "login",
   "entrypoint": "src/auth/controller.js",
@@ -471,43 +426,69 @@ Flows represent business execution chains starting from entrypoints.
 
 ---
 
-## 🌍 Multi-Language Support
+## 🌍 Multi-Language & Framework Support
+
+### Languages
 
 | Category | Languages |
 |----------|-----------|
 | **Web** | JavaScript, TypeScript, Python, Go, Rust |
 | **Backend** | Java, C#, PHP, Ruby, Go, Rust, Kotlin |
-NW|| **Mobile** | Swift, Kotlin, Android |
+| **Mobile** | Swift, Kotlin, Android |
 | **Frontend** | Vue, Svelte, React, HTML, CSS, SCSS |
-TK|  Testing | Jest, Vitest, pytest, Mocha, RSpec |
-MV|
-NM|## 🤖 Android/Kotlin Support
-HM|
-XZ|ai-first automatically detects and indexes Android/Kotlin projects:
-HM|
-RV|- **Language Detection**: Kotlin (.kt files)
+| **Testing** | Jest, Vitest, pytest, Mocha, RSpec |
+
+### Frameworks (Tested)
+
+| Framework | Language | Test Project |
+|-----------|----------|-------------|
+| **Django** | Python | `test-projects/django-app` |
+| **FastAPI** | Python | `test-projects/fastapi-app` |
+| **Flask** | Python | `test-projects/flask-app` |
+| **Laravel** | PHP | `test-projects/laravel-app` |
+| **Rails** | Ruby | `test-projects/rails-app` |
+| **Spring Boot** | Java | `test-projects/spring-boot-app` |
+| Express.js | JavaScript | `test-projects/express-api` |
+| NestJS | TypeScript | `test-projects/nestjs-backend` |
+| React | JavaScript | `test-projects/react-app` |
+| Python CLI | Python | `test-projects/python-cli` |
+| Salesforce DX | Apex | `test-projects/salesforce-cli` |
+
+ai-first automatically detects and indexes Android/Kotlin projects:
+
+- **Language Detection**: Kotlin (.kt files)
 - **Framework Detection**: Android (via build.gradle, AndroidManifest.xml)
 - **Dependency Parsing**: Gradle dependencies (implementation, api, compile)
 - **Entry Points**: Activities, Services, BroadcastReceivers from AndroidManifest.xml
 - **Resources**: Indexes res/layout, res/drawable, res/values
 - **Multi-module**: Detects Gradle modules from settings.gradle
-HM|
-XZ|### Generated Files for Android Projects
-HM|
-XZ|- `ai/tech_stack.md` - Shows Android framework with SDK versions
-- `ai/dependencies.json` - Gradle dependencies with group:artifact:version
-- `ai/entrypoints.md` - Android activities, services, permissions
-- `ai/android-resources.json` - Layouts, drawables, values (if res/ exists)
-- `ai/gradle-modules.json` - Multi-module structure (if settings.gradle exists)
-HM|
-NM|---
+
+### Generated Files for Android Projects
+
+- `ai-context/tech_stack.md` - Shows Android framework with SDK versions
+- `ai-context/dependencies.json` - Gradle dependencies with group:artifact:version
+- `ai-context/entrypoints.md` - Android activities, services, permissions
+- `ai-context/android-resources.json` - Layouts, drawables, values (if res/ exists)
+- `ai-context/gradle-modules.json` - Multi-module structure (if settings.gradle exists)
 
 ---
 
 ## 📋 Roadmap
 
+### Phase 1 ✅ (Completed)
+- Testing infrastructure with 11 test projects
+
+### Phase 2 ✅ (Completed)
+- Code quality fixes: symbol extraction, flow name sanitization
+- PHP and Ruby parser support added
+- All 11 adapters now working (100% coverage)
+
 ### Phase 3 (Planned)
-- [ ] Support for more languages (PHP, Ruby, Scala)
+- [ ] Enhanced semantic indexing
+- [ ] Plugin system for custom analyzers
+- [ ] PHP support (Laravel test project)
+- [ ] Ruby support (Rails test project)
+- [ ] Scala support
 - [ ] Configuration file support (`ai-first.config.json`)
 - [ ] Custom rules/plugins system
 - [ ] CI/CD integration templates

package/STATUS_ADAPTADORES

@@ -0,0 +1,126 @@
+# 📊 ESTADO DE ADAPTADORES - Phase 2 Completado
+
+## ✅ PROGRESO PHASE 2 - COMPLETADO ✅
+
+---
+
+## 📋 Test Results - Symbol Extraction (11/11 PASS)
+
+| # | Adapter | Extension | Test File | Symbols | Status |
+|---|---------|-----------|-----------|---------|--------|
+| 1 | Django | .py | blog/models.py | 10 | ✅ PASS |
+| 2 | Laravel | .php | Controller.php | 1 | ✅ PASS |
+| 3 | FastAPI | .py | app/main.py | 2 | ✅ PASS |
+| 4 | Flask | .py | app/models.py | 17 | ✅ PASS |
+| 5 | Rails | .rb | app/models/user.rb | 4 | ✅ PASS |
+| 6 | Spring Boot | .java | DemoApplication.java | 2 | ✅ PASS |
+| 7 | NestJS | .ts | src/main.ts | 2 | ✅ PASS |
+| 8 | Express | .js | index.js | 7 | ✅ PASS |
+| 9 | React | .tsx | src/App.tsx | 1 | ✅ PASS |
+| 10 | Salesforce | .cls | AccountController.cls | 3 | ✅ PASS |
+| 11 | Python CLI | .py | main.py | 1 | ✅ PASS |
+
+**Total: 11/11 Adapters Passing (100%)** ✅
+
+---
+
+## 🐛 Bugs Fixed in Phase 2
+
+### 1. PHP Parser - Laravel Adapter ✅
+**Previously:** 0 symbols extracted
+**Fixed:** Added `parsePHP()` function in `src/analyzers/symbols.ts`
+**Test:** Controller.php now extracts 1 symbol (Controller class)
+
+### 2. Ruby Parser - Rails Adapter ✅
+**Previously:** 0 symbols extracted
+**Fixed:** Added `parseRuby()` function in `src/analyzers/symbols.ts`
+**Test:** user.rb now extracts 4 symbols (User, full_name, deactivate, activate)
+
+### 3. Extension Format Bug ✅
+**Previously:** Extension checks used `"js"` instead of `".js"`
+**Fixed:** All extension checks now use format with dot
+**Impact:** All JS/TS symbol extraction was broken
+
+---
+
+## 📊 Cobertura Total de Adapters: 11/16 (68.75%)
+
+| Adapter | Test Project | Status | Notes |
+|---------|--------------|--------|-------|
+| JavaScript/TypeScript | express-api, react-app | ✅ | |
+| NestJS | nestjs-backend | ✅ | |
+| Python | python-cli, django-app, fastapi-app, flask-app | ✅ | |
+| Django | django-app | ✅ | |
+| FastAPI | fastapi-app | ✅ | |
+| Flask | flask-app | ✅ | |
+| Laravel | laravel-app | ✅ | Fixed PHP parser |
+| Rails | rails-app | ✅ | Fixed Ruby parser |
+| Spring Boot | spring-boot-app | ✅ | |
+| Salesforce | salesforce-cli | ✅ | |
+| PHP | laravel-app | ✅ | |
+| Ruby | rails-app | ✅ | |
+| Elixir Phoenix | - | ❌ | |
+| .NET | - | ❌ | |
+| ASP.NET Core | - | ❌ | |
+| Blazor | - | ❌ | |
+
+---
+
+## 🔧 Test Projects
+
+| # | Framework | Path | AI Context Status |
+|---|-----------|------|-------------------|
+| 1 | Django | test-projects/django-app | ✅ |
+| 2 | Laravel | test-projects/laravel-app | ✅ |
+| 3 | FastAPI | test-projects/fastapi-app | ✅ |
+| 4 | Flask | test-projects/flask-app | ✅ |
+| 5 | Rails | test-projects/rails-app | ✅ |
+| 6 | Spring Boot | test-projects/spring-boot-app | ✅ |
+| 7 | NestJS | test-projects/nestjs-backend | ✅ |
+| 8 | Express | test-projects/express-api | ✅ |
+| 9 | React | test-projects/react-app | ✅ |
+| 10 | Salesforce | test-projects/salesforce-cli | ✅ |
+| 11 | Python CLI | test-projects/python-cli | ✅ |
+
+---
+
+## 📁 Scripts de Prueba
+
+### test_adapters.mjs
+Ejecuta pruebas de extracción de símbolos para todos los adapters:
+```bash
+node test_adapters.mjs
+```
+
+### tests/phase2-fixes.test.ts
+Pruebas funcionales para los fixes de Phase 2:
+- Symbol extraction con extensiones correctas
+- Flow name sanitization
+- repo_map.json consolidation
+
+---
+
+## ✅ Criterios de Éxito - Phase 2
+
+- [x] 11/11 adapters extraen símbolos correctamente
+- [x] No hay archivos duplicados (repo-map vs repo_map)
+- [x] Nombres de flows sanitizados (sin .. o _)
+- [x] Tests funcionales pasando
+- [x] Documentación actualizada
+
+---
+
+## 📝 Commits Realizados
+
+- `b9d50bc` - fix: Add PHP and Ruby parsers for symbol extraction
+- `9fb4196` - test: Add functional tests for Phase 2 fixes
+- `c6a8a31` - chore: Regenerate main project AI context with sanitized flow names
+- `a9bf9df` - chore: Regenerate test project AI contexts and clean up malformed files
+- `2b4f1a2` - fix(Phase 2): Core code fixes for symbol extraction and flow names
+- `0559783` - fix(Phase 2): Multiple code quality improvements
+
+---
+
+*Estado actualizado: 2026-03-18*
+*Phase 2: ✅ COMPLETADO*
+*Branch: feature/phase-2-code-quality*