ai-first-cli 1.2.2 → 1.3.0

package/install.sh

@@ -1,21 +1,91 @@
 #!/usr/bin/env bash
-# af (AI-First) Installer - curl -fsSL https://raw.githubusercontent.com/julianperezpesce/ai-first/master/install.sh | bash
+# af (AI-First) Installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/julianperezpesce/ai-first/master/install.sh | bash
 set -e
 
-AF_VERSION="${AF_VERSION:-1.2.1}"
+AF_VERSION="${AF_VERSION:-1.2.2}"
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
 NC='\033[0m'
 
 log_info() { echo -e "${GREEN}✓${NC} $1"; }
 log_warn() { echo -e "${YELLOW}⚠${NC} $1"; }
 log_error() { echo -e "${RED}✗${NC} $1"; }
+log_step() { echo -e "${BLUE}→${NC} $1"; }
+
+# Detect npm's global bin directory
+get_npm_global_bin() {
+    npm config get prefix --global 2>/dev/null
+}
+
+# Try to create symlink in a PATH directory
+setup_symlink() {
+    local src="$1"
+    local name="af"
+    
+    # Try /usr/local/bin first (standard)
+    if [ -w /usr/local/bin ] 2>/dev/null; then
+        ln -sf "$src" /usr/local/bin/$name
+        echo "/usr/local/bin/$name"
+        return 0
+    fi
+    
+    # Try ~/.local/bin (Freedesktop standard)
+    if [ -w "$HOME/.local/bin" ] 2>/dev/null || mkdir -p "$HOME/.local/bin" 2>/dev/null; then
+        ln -sf "$src" "$HOME/.local/bin/$name"
+        echo "$HOME/.local/bin/$name"
+        return 0
+    fi
+    
+    # Try ~/bin (legacy)
+    if [ -w "$HOME/bin" ] 2>/dev/null || mkdir -p "$HOME/bin" 2>/dev/null; then
+        ln -sf "$src" "$HOME/bin/$name"
+        echo "$HOME/bin/$name"
+        return 0
+    fi
+    
+    return 1
+}
+
+# Add directory to PATH in shell RC if not already present
+ensure_path() {
+    local dir="$1"
+    local rcfile=""
+    
+    # Find the active shell RC file
+    if [ -n "$ZSH_VERSION" ]; then
+        rcfile="$HOME/.zshrc"
+    elif [ -n "$BASH_VERSION" ]; then
+        rcfile="$HOME/.bashrc"
+    else
+        rcfile="$HOME/.profile"
+    fi
+    
+    # Check if dir is already in PATH
+    if echo "$PATH" | tr ':' '\n' | grep -qx "$dir"; then
+        return 0
+    fi
+    
+    # Check if already added in RC
+    if [ -f "$rcfile" ] && grep -q "$dir" "$rcfile" 2>/dev/null; then
+        return 0
+    fi
+    
+    # Add to RC
+    echo "" >> "$rcfile"
+    echo "# Added by ai-first-cli installer" >> "$rcfile"
+    echo "export PATH=\"$dir:\$PATH\"" >> "$rcfile"
+    
+    log_warn "Added $dir to PATH in $rcfile"
+    log_warn "Run: source $rcfile"
+}
 
 check_node() {
     if ! command -v node &> /dev/null; then
-        log_error "Node.js not installed. Install Node.js 18+ first."
+        log_error "Node.js not installed. Install Node.js 18+ first: https://nodejs.org"
         exit 1
     fi
     NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
@@ -27,24 +97,80 @@ check_node() {
 }
 
 install_af() {
-    log_info "Installing af@${AF_VERSION}..."
-    npm install -g "af@${AF_VERSION}"
-    log_info "af installed successfully!"
+    log_step "Installing af@${AF_VERSION}..."
+    npm install -g "ai-first-cli@${AF_VERSION}" 2>&1
+    log_info "npm install completed"
+}
+
+find_af_binary() {
+    # Find the af binary in npm's global bin directory
+    local prefix
+    prefix=$(npm config get prefix --global 2>/dev/null || npm config get prefix 2>/dev/null)
+    
+    if [ -n "$prefix" ] && [ -f "$prefix/bin/af" ]; then
+        echo "$prefix/bin/af"
+        return 0
+    fi
+    
+    if [ -n "$prefix" ] && [ -f "$prefix/bin/ai-first" ]; then
+        echo "$prefix/bin/ai-first"
+        return 0
+    fi
+    
+    # Try common locations
+    for dir in "$prefix/bin" "$HOME/.npm-global/bin" "/usr/local/bin" "$HOME/.local/bin" "$HOME/bin"; do
+        if [ -f "$dir/af" ]; then
+            echo "$dir/af"
+            return 0
+        fi
+        if [ -f "$dir/ai-first" ]; then
+            echo "$dir/ai-first"
+            return 0
+        fi
+    done
+    
+    return 1
 }
 
 verify_install() {
-    if command -v af &> /dev/null; then
-        echo ""
-        echo "  af init          Initialize AI context"
-        echo "  af index         Generate SQLite index"
-        echo "  af doctor        Check repository health"
-        echo "  af --help        Show all commands"
-        echo ""
-        log_info "Installation complete!"
-    else
-        log_error "Installation failed - af not in PATH"
+    log_step "Verifying installation..."
+    
+    local af_path
+    af_path=$(find_af_binary) || {
+        log_error "Could not find af binary after installation"
+        log_error "npm prefix: $(npm config get prefix 2>/dev/null)"
         exit 1
+    }
+    
+    log_info "Found af at: $af_path"
+    
+    # Try to create symlink in PATH
+    local symlink
+    if symlink=$(setup_symlink "$af_path"); then
+        log_info "Created symlink: $symlink"
+    else
+        log_warn "Could not create symlink in standard PATH location"
+        # Try adding the binary's directory to PATH
+        local bindir
+        bindir=$(dirname "$af_path")
+        ensure_path "$bindir"
     fi
+    
+    echo ""
+    echo "  ╔══════════════════════════════════════╗"
+    echo "  ║       af installation complete!     ║"
+    echo "  ╚══════════════════════════════════════╝"
+    echo ""
+    echo "  Commands:"
+    echo "    af init          Initialize AI context"
+    echo "    af index         Generate SQLite index"
+    echo "    af doctor        Check repository health"
+    echo "    af --help        Show all commands"
+    echo ""
+    echo "  Quick start:"
+    echo "    af init          # Generate context files"
+    echo "    af doctor        # Check repository health"
+    echo ""
 }
 
 echo ""
@@ -54,7 +180,7 @@ echo "  ███████║██║   ██║   ██║   ████
 echo "  ██╔══██║██║   ██║   ██║   ██╔══╝  "
 echo "  ██║  ██║╚██████╔╝   ██║   ███████╗"
 echo "  ╚═╝  ╚═╝ ╚═════╝    ╚═╝   ╚══════╝"
-echo "  AI-First CLI Installer"
+echo "  AI-First CLI Installer v${AF_VERSION}"
 echo ""
 
 check_node

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-first-cli",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "CLI tool that prepares any repository to be used effectively by AI coding agents",
   "main": "dist/index.js",
   "type": "module",

package/run-all-tests.sh

@@ -0,0 +1,184 @@
+#!/bin/bash
+#
+# MASTER TEST SCRIPT - ai-first-cli
+# Ejecuta TODOS los tests: unitarios + funcionales + integracion
+# 
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"
+DIST_DIR="$PROJECT_ROOT/dist"
+CLI="$DIST_DIR/commands/ai-first.js"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+TESTS_PASSED=0
+TESTS_FAILED=0
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[PASS]${NC} $1"
+    ((TESTS_PASSED++))
+}
+
+log_error() {
+    echo -e "${RED}[FAIL]${NC} $1"
+    ((TESTS_FAILED++))
+}
+
+# ============================================
+# PHASE 1: BUILD
+# ============================================
+echo ""
+echo "==================================================="
+echo "PHASE 1: BUILD"
+echo "==================================================="
+echo ""
+
+log_info "Building TypeScript..."
+if npm run build > /dev/null 2>&1; then
+    log_success "TypeScript build"
+else
+    log_error "TypeScript build FAILED"
+    exit 1
+fi
+
+# ============================================
+# PHASE 2: UNIT TESTS (Vitest)
+# ============================================
+echo ""
+echo "==================================================="
+echo "PHASE 2: UNIT TESTS (Vitest)"
+echo "==================================================="
+echo ""
+
+log_info "Running vitest..."
+if npx vitest run 2>&1 | grep -q "passed"; then
+    # Extract test count
+    VITEST_OUTPUT=$(npx vitest run 2>&1)
+    TEST_COUNT=$(echo "$VITEST_OUTPUT" | grep -oE '[0-9]+ passed' | head -1 | grep -oE '[0-9]+')
+    log_success "Unit tests: $TEST_COUNT passed"
+else
+    log_error "Unit tests FAILED"
+fi
+
+# ============================================
+# PHASE 3: FUNCTIONAL TESTS
+# ============================================
+echo ""
+echo "==================================================="
+echo "PHASE 3: FUNCTIONAL TESTS (11 Adapters)"
+echo "==================================================="
+echo ""
+
+ADAPTERS="django-app laravel-app fastapi-app flask-app rails-app spring-boot-app nestjs-backend express-api react-app salesforce-cli python-cli"
+SYMBOLS_OK=0
+
+log_info "Testing symbol extraction..."
+for adapter in $ADAPTERS; do
+    PROJECT_DIR="$PROJECT_ROOT/test-projects/$adapter"
+    if [ -f "$PROJECT_DIR/ai-context/symbols.json" ]; then
+        SYMBOL_COUNT=$(cat "$PROJECT_DIR/ai-context/symbols.json" | grep -o '"id"' | wc -l)
+        if [ "$SYMBOL_COUNT" -gt 0 ]; then
+            ((SYMBOLS_OK++))
+            log_success "$adapter: $SYMBOL_COUNT symbols"
+        else
+            log_error "$adapter: 0 symbols"
+        fi
+    else
+        log_error "$adapter: symbols.json not found"
+    fi
+done
+
+if [ "$SYMBOLS_OK" -eq 11 ]; then
+    log_success "All 11 adapters have symbols > 0"
+else
+    log_error "Only $SYMBOLS_OK/11 adapters have symbols"
+fi
+
+# ============================================
+# PHASE 4: INTEGRATION TESTS
+# ============================================
+echo ""
+echo "==================================================="
+echo "PHASE 4: INTEGRATION TESTS"
+echo "==================================================="
+echo ""
+
+COMMANDS="init map index doctor"
+TOTAL_TESTS=0
+PASSED_TESTS=0
+
+for adapter in $ADAPTERS; do
+    PROJECT_DIR="$PROJECT_ROOT/test-projects/$adapter"
+    
+    for cmd in $COMMANDS; do
+        ((TOTAL_TESTS++))
+        
+        case $cmd in
+            "init")
+                if [ -d "$PROJECT_DIR/ai-context" ] && [ -f "$PROJECT_DIR/ai-context/symbols.json" ]; then
+                    ((PASSED_TESTS++))
+                else
+                    log_error "$adapter: init failed"
+                fi
+                ;;
+            "map")
+                if [ -f "$PROJECT_DIR/ai-context/graph/module-graph.json" ]; then
+                    ((PASSED_TESTS++))
+                else
+                    log_error "$adapter: map failed"
+                fi
+                ;;
+            "index")
+                if [ -f "$PROJECT_DIR/ai-context/index.db" ]; then
+                    ((PASSED_TESTS++))
+                else
+                    log_error "$adapter: index failed"
+                fi
+                ;;
+            "doctor")
+                if [ -f "$PROJECT_DIR/ai-context/repo_map.json" ]; then
+                    ((PASSED_TESTS++))
+                else
+                    log_error "$adapter: doctor failed"
+                fi
+                ;;
+        esac
+    done
+done
+
+log_info "Integration tests: $PASSED_TESTS/$TOTAL_TESTS passed"
+if [ "$PASSED_TESTS" -eq "$TOTAL_TESTS" ]; then
+    log_success "All integration tests passed"
+else
+    log_error "Some integration tests failed"
+fi
+
+# ============================================
+# FINAL SUMMARY
+# ============================================
+echo ""
+echo "==================================================="
+echo "FINAL SUMMARY"
+echo "==================================================="
+echo ""
+echo "Tests Passed: $TESTS_PASSED"
+echo "Tests Failed: $TESTS_FAILED"
+echo ""
+
+if [ "$TESTS_FAILED" -eq 0 ]; then
+    echo -e "${GREEN}ALL TESTS PASSED!${NC}"
+    exit 0
+else
+    echo -e "${RED}SOME TESTS FAILED!${NC}"
+    exit 1
+fi

package/src/analyzers/symbols.ts

@@ -1,5 +1,6 @@
 import { FileInfo } from "../core/repoScanner.js";
 import { readFile } from "../utils/fileUtils.js";
+import { parserRegistry, createSymbolFromParsed } from "../core/parsers/index.js";
 
 export interface Symbol {
   id: string;  // Unique ID: filePath#symbolName (e.g., src/auth/login.ts#loginUser)
@@ -61,16 +62,20 @@ export function extractSymbols(files: FileInfo[]): SymbolsAnalysis {
  */
 function parseFileForSymbols(file: FileInfo): Symbol[] {
   const symbols: Symbol[] = [];
-  
+
   try {
     const content = readFile(file.path);
+
+    const ext = "." + file.extension;
+    if (parserRegistry.hasParser(ext)) {
+      const parsed = parserRegistry.parse(file.relativePath, content, ext);
+      if (parsed) {
+        return createSymbolFromParsed(parsed, file.relativePath);
+      }
+    }
+
     const lines = content.split("\n");
-    
-    if (file.extension === "ts" || file.extension === "tsx" || file.extension === "js" || file.extension === "jsx") {
-      parseJavaScriptTypeScript(file, content, lines, symbols);
-    } else if (file.extension === "py") {
-      parsePython(file, content, lines, symbols);
-    } else if (file.extension === "go") {
+    if (file.extension === "go") {
       parseGo(file, content, lines, symbols);
     } else if (file.extension === "rs") {
       parseRust(file, content, lines, symbols);

package/src/analyzers/techStack.ts

@@ -1,6 +1,7 @@
 import { FileInfo } from "../core/repoScanner.js";
 import { readFile, readJsonFile } from "../utils/fileUtils.js";
 import path from "path";
+import fs from "fs";
 
 export interface TechStack {
   languages: string[];
@@ -155,9 +156,9 @@ function detectFrameworks(files: FileInfo[], fileNames: Set<string>, rootDir: st
 }
 
 /**
- * Detect libraries
+ * Detect Node.js libraries from package.json
  */
-function detectLibraries(files: FileInfo[], rootDir: string): string[] {
+function detectNodeLibraries(rootDir: string): string[] {
   const libraries: string[] = [];
   
   try {
@@ -185,7 +186,69 @@ function detectLibraries(files: FileInfo[], rootDir: string): string[] {
     }
   } catch {}
   
-  return [...new Set(libraries)];
+  return libraries;
+}
+
+function detectSwiftLibraries(rootDir: string): string[] {
+  const libraries: string[] = [];
+  const packagePath = path.join(rootDir, "Package.swift");
+
+  try {
+    const content = readFile(packagePath);
+    const libMap: Record<string, string> = {
+      "Vapor": "Vapor",
+      "Fluent": "Fluent ORM",
+      "FluentPostgresDriver": "Fluent PostgreSQL",
+      "FluentMySQLDriver": "Fluent MySQL",
+      "FluentSQLiteDriver": "Fluent SQLite",
+      "FluentMongoDriver": "Fluent MongoDB",
+      "Leaf": "Leaf",
+      "APNS": "APNS",
+      "Queues": "Queues",
+      "QueuesRedisDriver": "Queues Redis",
+      "QueuesFluentDriver": "Queues Fluent",
+      "Mailgun": "Mailgun",
+      "SendGrid": "SendGrid",
+      "JWTKit": "JWTKit",
+      "Crypto": "Apple CryptoKit",
+      "NIO": "SwiftNIO",
+      "NIOSSL": "SwiftNIO SSL",
+      "NIOHTTP1": "SwiftNIO HTTP",
+      "NIOWebSocket": "SwiftNIO WebSocket",
+      "NIOTransportServices": "SwiftNIO Transport Services",
+      "AsyncHTTPClient": "AsyncHTTPClient",
+      "Alamofire": "Alamofire",
+      "Moya": "Moya",
+      "RxSwift": "RxSwift",
+      "PromiseKit": "PromiseKit",
+      "SwiftyJSON": "SwiftyJSON",
+      "ObjectMapper": "ObjectMapper",
+      "SnapKit": "SnapKit",
+      "Kingfisher": "Kingfisher",
+      "SDWebImage": "SDWebImage Swift",
+      "Lottie": "Lottie",
+      "SwiftLint": "SwiftLint",
+      "SwiftFormat": "SwiftFormat",
+    };
+
+    const depPattern = /\.package\s*\(\s*url:\s*"[^"]+"\s*,\s*(?:from|\.upToNextMajor|\.upToNextMinor|\.exact):\s*"[^"]+"\s*\)/g;
+    let match;
+
+    while ((match = depPattern.exec(content)) !== null) {
+      const depString = match[0];
+      const urlMatch = depString.match(/url:\s*"([^"]+)"/);
+      if (urlMatch) {
+        const url = urlMatch[1];
+        const depName = url.split("/").pop()?.replace(".git", "") || "";
+        const libName = libMap[depName] || depName;
+        if (!libraries.includes(libName)) {
+          libraries.push(libName);
+        }
+      }
+    }
+  } catch {}
+
+  return libraries;
 }
 
 /**
@@ -386,6 +449,143 @@ function generateTechStackDescription(
   return lines.join("\n\n");
 }
 
+function detectGradleLibraries(_files: FileInfo[], rootDir: string): string[] {
+  const libraries: string[] = [];
+  const gradleFiles: string[] = [];
+
+  function findGradleFiles(dir: string, depth: number = 0) {
+    if (depth > 3) return;
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+          findGradleFiles(fullPath, depth + 1);
+        } else if (entry.isFile() && (entry.name === 'build.gradle' || entry.name === 'build.gradle.kts')) {
+          gradleFiles.push(fullPath);
+        }
+      }
+    } catch {}
+  }
+
+  findGradleFiles(rootDir);
+
+  const libMap: Record<string, string> = {
+    "androidx.core": "AndroidX Core", "androidx.appcompat": "AppCompat",
+    "com.google.android.material": "Material Design",
+    "androidx.constraintlayout": "ConstraintLayout",
+    "androidx.navigation": "Navigation", "androidx.room": "Room",
+    "org.jetbrains.kotlin": "Kotlin", "kotlinx.coroutines": "Kotlin Coroutines",
+    "com.squareup.retrofit2": "Retrofit", "com.squareup.okhttp3": "OkHttp",
+    "com.google.dagger": "Dagger", "junit": "JUnit",
+    "org.mockito": "Mockito", "com.jakewharton.timber": "Timber",
+    "com.github.bumptech.glide": "Glide", "io.coil-kt": "Coil",
+    "com.google.code.gson": "Gson",
+  };
+
+  for (const gf of gradleFiles) {
+    try {
+      const content = readFile(gf);
+      const depPattern = /(?:implementation|api|compileOnly|runtimeOnly|testImplementation|androidTestImplementation|kapt|annotationProcessor)\s*(?:\(|\s)?['"]([^'"]+)['"](?:\))?/g;
+      let match;
+      while ((match = depPattern.exec(content)) !== null) {
+        const parts = match[1].split(':');
+        if (parts.length >= 2) {
+          const libName = libMap[parts[0]] || `${parts[0]}:${parts[1]}`;
+          if (!libraries.includes(libName)) libraries.push(libName);
+        }
+      }
+      if (content.includes("com.android.application") && !libraries.includes("Android Gradle Plugin")) {
+        libraries.push("Android Gradle Plugin");
+      }
+    } catch {}
+  }
+
+  return libraries;
+}
+
+function detectCargoLibraries(rootDir: string): string[] {
+  const libraries: string[] = [];
+  try {
+    const content = readFile(path.join(rootDir, "Cargo.toml"));
+    const libMap: Record<string, string> = {
+      tokio: "Tokio", serde: "Serde", "serde_json": "Serde JSON",
+      reqwest: "Reqwest", actix_web: "Actix Web", axum: "Axum",
+      sqlx: "SQLx", diesel: "Diesel", mongodb: "MongoDB",
+      redis: "Redis", chrono: "Chrono", regex: "Regex",
+      clap: "Clap", log: "Log", tracing: "Tracing",
+      anyhow: "Anyhow", thiserror: "ThisError", rayon: "Rayon",
+      uuid: "UUID", rand: "Rand", hyper: "Hyper",
+    };
+    const depSection = content.match(/\[dependencies\]([^\[]*)/);
+    if (depSection) {
+      const depPattern = /^(\w+)\s*=/gm;
+      let match;
+      while ((match = depPattern.exec(depSection[1])) !== null) {
+        const libName = libMap[match[1]] || match[1];
+        if (!libraries.includes(libName)) libraries.push(libName);
+      }
+    }
+  } catch {}
+  return libraries;
+}
+
+function detectGoLibraries(rootDir: string): string[] {
+  const libraries: string[] = [];
+  try {
+    const content = readFile(path.join(rootDir, "go.mod"));
+    const libMap: Record<string, string> = {
+      "gin-gonic/gin": "Gin", "labstack/echo": "Echo",
+      "gorilla/mux": "Gorilla Mux", "go-chi/chi": "Chi",
+      "gofiber/fiber": "Fiber", "gorm.io/gorm": "GORM",
+      "github.com/jmoiron/sqlx": "SQLx",
+      "github.com/lib/pq": "PostgreSQL Driver",
+      "github.com/spf13/cobra": "Cobra", "github.com/spf13/viper": "Viper",
+    };
+    const requirePattern = /^\s*(\S+)\s+v?[\d\.]+/gm;
+    let match;
+    while ((match = requirePattern.exec(content)) !== null) {
+      const libName = libMap[match[1]] || match[1];
+      if (!libraries.includes(libName)) libraries.push(libName);
+    }
+  } catch {}
+  return libraries;
+}
+
+function detectMavenLibraries(rootDir: string): string[] {
+  const libraries: string[] = [];
+  try {
+    const content = readFile(path.join(rootDir, "pom.xml"));
+    const libMap: Record<string, string> = {
+      "org.springframework.boot": "Spring Boot",
+      "org.springframework": "Spring Framework",
+      "org.springframework.data": "Spring Data",
+      "org.springframework.security": "Spring Security",
+      "org.springframework.cloud": "Spring Cloud",
+    };
+    const depPattern = /<dependency>\s*<groupId>([^<]+)<\/groupId>\s*<artifactId>([^<]+)<\/artifactId>/g;
+    let match;
+    while ((match = depPattern.exec(content)) !== null) {
+      const libName = libMap[match[1]] || `${match[1]}:${match[2]}`;
+      if (!libraries.includes(libName)) libraries.push(libName);
+    }
+  } catch {}
+  return libraries;
+}
+
+function detectLibraries(files: FileInfo[], rootDir: string): string[] {
+  const libraries: string[] = [];
+
+  libraries.push(...detectNodeLibraries(rootDir));
+  libraries.push(...detectGradleLibraries(files, rootDir));
+  libraries.push(...detectCargoLibraries(rootDir));
+  libraries.push(...detectGoLibraries(rootDir));
+  libraries.push(...detectMavenLibraries(rootDir));
+  libraries.push(...detectSwiftLibraries(rootDir));
+
+  return [...new Set(libraries)];
+}
+
 /**
  * Generate tech_stack.md content
  */