ai-first-cli 1.1.3 → 1.2.0

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*