ai-first-cli 1.2.3 → 1.3.0

package/dist/utils/constants.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Constantes centralizadas para rutas del sistema ai-first-cli
+ *
+ * Esta migración de ai/ a ai-context/ fue realizada para estandarizar
+ * la arquitectura y evitar inconsistencias entre comandos.
+ */
+export declare const AI_CONTEXT_DIR = "ai-context";
+export declare const AI_LEGACY_DIR = "ai";
+/**
+ * Obtiene la ruta completa al directorio ai-context/
+ */
+export declare function getAiContextDir(rootDir: string): string;
+/**
+ * Obtiene la ruta completa al archivo index.db
+ */
+export declare function getIndexDbPath(rootDir: string): string;
+/**
+ * Obtiene la ruta completa al archivo hierarchy.json
+ */
+export declare function getHierarchyPath(rootDir: string): string;
+/**
+ * Obtiene la ruta al directorio ccp/
+ */
+export declare function getCcpDir(rootDir: string): string;
+/**
+ * Obtiene la ruta completa a un archivo CCP específico
+ */
+export declare function getCcpPath(rootDir: string, name: string): string;
+/**
+ * Obtiene la ruta al directorio de features
+ */
+export declare function getFeaturesDir(rootDir: string): string;
+/**
+ * Obtiene la ruta al directorio de flows
+ */
+export declare function getFlowsDir(rootDir: string): string;
+/**
+ * Obtiene la ruta al directorio graph/
+ */
+export declare function getGraphDir(rootDir: string): string;
+/**
+ * Verifica si una ruta corresponde al directorio ai-context/ o ai/ legacy
+ * Util para excluir estos directorios del análisis
+ */
+export declare function isAiDirectory(dirName: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAGH,eAAO,MAAM,cAAc,eAAe,CAAC;AAG3C,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/utils/constants.js

@@ -0,0 +1,67 @@
+import path from "path";
+/**
+ * Constantes centralizadas para rutas del sistema ai-first-cli
+ *
+ * Esta migración de ai/ a ai-context/ fue realizada para estandarizar
+ * la arquitectura y evitar inconsistencias entre comandos.
+ */
+// Directorio principal de contexto (arquitectura nueva)
+export const AI_CONTEXT_DIR = "ai-context";
+// Directorio legacy (para compatibilidad hacia atrás)
+export const AI_LEGACY_DIR = "ai";
+/**
+ * Obtiene la ruta completa al directorio ai-context/
+ */
+export function getAiContextDir(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR);
+}
+/**
+ * Obtiene la ruta completa al archivo index.db
+ */
+export function getIndexDbPath(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "index.db");
+}
+/**
+ * Obtiene la ruta completa al archivo hierarchy.json
+ */
+export function getHierarchyPath(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "hierarchy.json");
+}
+/**
+ * Obtiene la ruta al directorio ccp/
+ */
+export function getCcpDir(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "ccp");
+}
+/**
+ * Obtiene la ruta completa a un archivo CCP específico
+ */
+export function getCcpPath(rootDir, name) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "ccp", name, "context.json");
+}
+/**
+ * Obtiene la ruta al directorio de features
+ */
+export function getFeaturesDir(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "context", "features");
+}
+/**
+ * Obtiene la ruta al directorio de flows
+ */
+export function getFlowsDir(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "context", "flows");
+}
+/**
+ * Obtiene la ruta al directorio graph/
+ */
+export function getGraphDir(rootDir) {
+    return path.join(rootDir, AI_CONTEXT_DIR, "graph");
+}
+/**
+ * Verifica si una ruta corresponde al directorio ai-context/ o ai/ legacy
+ * Util para excluir estos directorios del análisis
+ */
+export function isAiDirectory(dirName) {
+    return dirName === AI_CONTEXT_DIR || dirName === AI_LEGACY_DIR;
+}
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;GAKG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO,KAAK,cAAc,IAAI,OAAO,KAAK,aAAa,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-first-cli",
-  "version": "1.2.3",
+  "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
  */