@girardelli/architect 2.2.0 → 5.0.0

package/src/agent-generator/framework-detector.ts

@@ -0,0 +1,669 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { AnalysisReport } from '../types.js';
+import { FrameworkInfo, DetectedToolchain } from './types.js';
+
+/**
+ * FrameworkDetector — Detects actual frameworks and toolchain from dependency files.
+ *
+ * Reads requirements.txt, pyproject.toml, package.json, pom.xml, build.gradle,
+ * composer.json, go.mod, Gemfile, pubspec.yaml, Cargo.toml, Makefile, etc.
+ *
+ * Returns structured framework info with versions, categories, and
+ * auto-detected toolchain commands (build, test, lint, run).
+ */
+export class FrameworkDetector {
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // FRAMEWORK PATTERNS — Maps dependency names to framework metadata
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private static readonly FRAMEWORK_MAP: Record<string, { name: string; category: FrameworkInfo['category'] }> = {
+    // Python Web
+    'fastapi': { name: 'FastAPI', category: 'web' },
+    'django': { name: 'Django', category: 'web' },
+    'flask': { name: 'Flask', category: 'web' },
+    'starlette': { name: 'Starlette', category: 'web' },
+    'tornado': { name: 'Tornado', category: 'web' },
+    'sanic': { name: 'Sanic', category: 'web' },
+    'aiohttp': { name: 'aiohttp', category: 'web' },
+    'litestar': { name: 'Litestar', category: 'web' },
+    // Python ORM
+    'sqlalchemy': { name: 'SQLAlchemy', category: 'orm' },
+    'tortoise-orm': { name: 'Tortoise ORM', category: 'orm' },
+    'peewee': { name: 'Peewee', category: 'orm' },
+    'sqlmodel': { name: 'SQLModel', category: 'orm' },
+    'prisma': { name: 'Prisma', category: 'orm' },
+    'django-rest-framework': { name: 'DRF', category: 'web' },
+    'djangorestframework': { name: 'DRF', category: 'web' },
+    // Python Test
+    'pytest': { name: 'pytest', category: 'test' },
+    'unittest': { name: 'unittest', category: 'test' },
+    'hypothesis': { name: 'Hypothesis', category: 'test' },
+    // Python Lint
+    'ruff': { name: 'Ruff', category: 'lint' },
+    'flake8': { name: 'Flake8', category: 'lint' },
+    'pylint': { name: 'Pylint', category: 'lint' },
+    'black': { name: 'Black', category: 'lint' },
+    'mypy': { name: 'mypy', category: 'lint' },
+    // Node.js Web
+    '@nestjs/core': { name: 'NestJS', category: 'web' },
+    'express': { name: 'Express', category: 'web' },
+    'fastify': { name: 'Fastify', category: 'web' },
+    'koa': { name: 'Koa', category: 'web' },
+    'hapi': { name: 'Hapi', category: 'web' },
+    '@hapi/hapi': { name: 'Hapi', category: 'web' },
+    'next': { name: 'Next.js', category: 'web' },
+    'nuxt': { name: 'Nuxt', category: 'web' },
+    // Node.js ORM
+    'typeorm': { name: 'TypeORM', category: 'orm' },
+    '@prisma/client': { name: 'Prisma', category: 'orm' },
+    'sequelize': { name: 'Sequelize', category: 'orm' },
+    'mongoose': { name: 'Mongoose', category: 'orm' },
+    'knex': { name: 'Knex', category: 'orm' },
+    'drizzle-orm': { name: 'Drizzle', category: 'orm' },
+    // Node.js Test
+    'jest': { name: 'Jest', category: 'test' },
+    'vitest': { name: 'Vitest', category: 'test' },
+    'mocha': { name: 'Mocha', category: 'test' },
+    // Node.js Lint
+    'eslint': { name: 'ESLint', category: 'lint' },
+    'biome': { name: 'Biome', category: 'lint' },
+    '@biomejs/biome': { name: 'Biome', category: 'lint' },
+    'prettier': { name: 'Prettier', category: 'lint' },
+    // Java/Kotlin
+    'spring-boot-starter-web': { name: 'Spring Boot', category: 'web' },
+    'spring-boot-starter': { name: 'Spring Boot', category: 'web' },
+    'quarkus': { name: 'Quarkus', category: 'web' },
+    'micronaut': { name: 'Micronaut', category: 'web' },
+    'ktor': { name: 'Ktor', category: 'web' },
+    // PHP
+    'laravel/framework': { name: 'Laravel', category: 'web' },
+    'symfony/framework-bundle': { name: 'Symfony', category: 'web' },
+    'slim/slim': { name: 'Slim', category: 'web' },
+    // Ruby
+    'rails': { name: 'Ruby on Rails', category: 'web' },
+    // Go — detected from imports
+    'gin-gonic/gin': { name: 'Gin', category: 'web' },
+    'labstack/echo': { name: 'Echo', category: 'web' },
+    'gofiber/fiber': { name: 'Fiber', category: 'web' },
+    'gorilla/mux': { name: 'Gorilla Mux', category: 'web' },
+    'go-chi/chi': { name: 'Chi', category: 'web' },
+    // Dart/Flutter
+    'flutter': { name: 'Flutter', category: 'web' },
+    'shelf': { name: 'Shelf', category: 'web' },
+    'dart_frog': { name: 'Dart Frog', category: 'web' },
+    // Rust
+    'actix-web': { name: 'Actix Web', category: 'web' },
+    'rocket': { name: 'Rocket', category: 'web' },
+    'axum': { name: 'Axum', category: 'web' },
+  };
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // DETECTION — Main entry point
+  // ═══════════════════════════════════════════════════════════════════════
+
+  /**
+   * Detect frameworks and toolchain from project path and report.
+   */
+  detect(projectPath: string, report: AnalysisReport): {
+    frameworks: FrameworkInfo[];
+    primaryFramework: FrameworkInfo | null;
+    toolchain: DetectedToolchain;
+    projectStructure: 'clean-architecture' | 'mvc' | 'modular' | 'flat' | 'monorepo' | 'unknown';
+  } {
+    const frameworks: FrameworkInfo[] = [];
+
+    // Try each dependency source
+    this.detectFromPython(projectPath, frameworks);
+    this.detectFromNodejs(projectPath, frameworks);
+    this.detectFromJava(projectPath, frameworks);
+    this.detectFromPhp(projectPath, frameworks);
+    this.detectFromGo(projectPath, frameworks);
+    this.detectFromRuby(projectPath, frameworks);
+    this.detectFromDart(projectPath, frameworks);
+    this.detectFromRust(projectPath, frameworks);
+
+    // Deduplicate by name
+    const seen = new Set<string>();
+    const unique = frameworks.filter(f => {
+      if (seen.has(f.name)) return false;
+      seen.add(f.name);
+      return true;
+    });
+
+    // Sort: web frameworks first, then by confidence
+    unique.sort((a, b) => {
+      if (a.category === 'web' && b.category !== 'web') return -1;
+      if (a.category !== 'web' && b.category === 'web') return 1;
+      return b.confidence - a.confidence;
+    });
+
+    const primaryFramework = unique.find(f => f.category === 'web') || null;
+    const toolchain = this.detectToolchain(projectPath, report, primaryFramework, unique);
+    const projectStructure = this.detectProjectStructure(report);
+
+    return { frameworks: unique, primaryFramework, toolchain, projectStructure };
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // PYTHON
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromPython(projectPath: string, out: FrameworkInfo[]): void {
+    // requirements.txt
+    const reqFiles = ['requirements.txt', 'requirements/base.txt', 'requirements/prod.txt'];
+    for (const reqFile of reqFiles) {
+      const path = join(projectPath, reqFile);
+      if (existsSync(path)) {
+        const content = this.safeReadFile(path);
+        this.parsePythonRequirements(content, out);
+      }
+    }
+
+    // pyproject.toml
+    const pyproject = join(projectPath, 'pyproject.toml');
+    if (existsSync(pyproject)) {
+      const content = this.safeReadFile(pyproject);
+      this.parsePyprojectToml(content, out);
+    }
+
+    // setup.py / setup.cfg
+    const setupPy = join(projectPath, 'setup.py');
+    if (existsSync(setupPy)) {
+      const content = this.safeReadFile(setupPy);
+      this.parsePythonRequirements(content, out);
+    }
+
+    // Pipfile
+    const pipfile = join(projectPath, 'Pipfile');
+    if (existsSync(pipfile)) {
+      const content = this.safeReadFile(pipfile);
+      this.parsePythonRequirements(content, out);
+    }
+  }
+
+  private parsePythonRequirements(content: string, out: FrameworkInfo[]): void {
+    const lines = content.toLowerCase().split('\n');
+    for (const line of lines) {
+      const cleaned = line.replace(/#.*$/, '').trim();
+      if (!cleaned) continue;
+
+      // Match: package==1.0.0, package>=1.0, package~=1.0, package[extras]
+      const match = cleaned.match(/^([a-z0-9_-]+)(?:\[.*?\])?\s*(?:[=<>~!]+\s*([0-9][0-9.]*\S*))?/);
+      if (match) {
+        const pkg = match[1].replace(/-/g, '-');
+        const version = match[2] || null;
+        const fwInfo = FrameworkDetector.FRAMEWORK_MAP[pkg];
+        if (fwInfo) {
+          out.push({ name: fwInfo.name, version, category: fwInfo.category, confidence: 0.95 });
+        }
+      }
+    }
+  }
+
+  private parsePyprojectToml(content: string, out: FrameworkInfo[]): void {
+    // Strategy 1: [project.dependencies] section (legacy format)
+    const depSection = content.match(/\[(?:project\.)?dependencies\]([\s\S]*?)(?:\n\[|$)/);
+    if (depSection) {
+      this.parsePythonRequirements(depSection[1], out);
+    }
+
+    // Strategy 2: [project] section with inline `dependencies = [...]` (PEP 621 format)
+    // This is the standard pyproject.toml format used by most modern Python projects
+    const projectSection = content.match(/\[project\]\s*\n([\s\S]*?)(?:\n\[(?!project\.)|$)/);
+    if (projectSection) {
+      // Extract the dependencies array: dependencies = [ "pkg>=1.0", ... ]
+      const depsArrayMatch = projectSection[1].match(/dependencies\s*=\s*\[([\s\S]*?)\]/);
+      if (depsArrayMatch) {
+        // Extract quoted strings from the array
+        const deps = depsArrayMatch[1].match(/"([^"]+)"/g);
+        if (deps) {
+          const depsAsLines = deps.map(d => d.replace(/"/g, '')).join('\n');
+          this.parsePythonRequirements(depsAsLines, out);
+        }
+      }
+    }
+
+    // Strategy 3: [project.optional-dependencies] sections (dev, test, etc.)
+    const optionalDeps = content.match(/\[project\.optional-dependencies\]\s*\n([\s\S]*?)(?:\n\[(?!project\.)|$)/);
+    if (optionalDeps) {
+      // Parse each group: dev = ["pkg>=1.0", ...], test = [...]
+      const groupMatches = optionalDeps[1].matchAll(/\w+\s*=\s*\[([\s\S]*?)\]/g);
+      for (const groupMatch of groupMatches) {
+        const deps = groupMatch[1].match(/"([^"]+)"/g);
+        if (deps) {
+          const depsAsLines = deps.map(d => d.replace(/"/g, '')).join('\n');
+          this.parsePythonRequirements(depsAsLines, out);
+        }
+      }
+    }
+
+    // Strategy 4: tool.poetry.dependencies
+    const poetrySection = content.match(/\[tool\.poetry\.dependencies\]([\s\S]*?)(?:\n\[|$)/);
+    if (poetrySection) {
+      const lines = poetrySection[1].split('\n');
+      for (const line of lines) {
+        const match = line.match(/^([a-z0-9_-]+)\s*=\s*"?([^"]*)"?/i);
+        if (match) {
+          const pkg = match[1].toLowerCase();
+          const fwInfo = FrameworkDetector.FRAMEWORK_MAP[pkg];
+          if (fwInfo) {
+            const versionMatch = match[2].match(/([0-9][0-9.]*)/);
+            out.push({ name: fwInfo.name, version: versionMatch?.[1] || null, category: fwInfo.category, confidence: 0.95 });
+          }
+        }
+      }
+    }
+
+    // Deduplicate by framework name (keep highest confidence)
+    const seen = new Map<string, number>();
+    for (let i = out.length - 1; i >= 0; i--) {
+      const key = out[i].name;
+      if (seen.has(key)) {
+        out.splice(i, 1);
+      } else {
+        seen.set(key, i);
+      }
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // NODE.JS / TypeScript
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromNodejs(projectPath: string, out: FrameworkInfo[]): void {
+    const pkgPath = join(projectPath, 'package.json');
+    if (!existsSync(pkgPath)) return;
+
+    const content = this.safeReadFile(pkgPath);
+    try {
+      const pkg = JSON.parse(content);
+      const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+      for (const [name, version] of Object.entries(allDeps)) {
+        const fwInfo = FrameworkDetector.FRAMEWORK_MAP[name];
+        if (fwInfo) {
+          const vStr = typeof version === 'string' ? version : '';
+          const vMatch = vStr.match(/([0-9][0-9.]*)/);
+          out.push({ name: fwInfo.name, version: vMatch?.[1] || null, category: fwInfo.category, confidence: 0.95 });
+        }
+      }
+    } catch {
+      // Invalid JSON
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // JAVA / Kotlin
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromJava(projectPath: string, out: FrameworkInfo[]): void {
+    // pom.xml
+    const pomPath = join(projectPath, 'pom.xml');
+    if (existsSync(pomPath)) {
+      const content = this.safeReadFile(pomPath);
+      const deps = content.match(/<artifactId>([^<]+)<\/artifactId>/gi) || [];
+      for (const dep of deps) {
+        const match = dep.match(/<artifactId>([^<]+)<\/artifactId>/i);
+        if (match) {
+          const artifact = match[1].toLowerCase();
+          const fwInfo = FrameworkDetector.FRAMEWORK_MAP[artifact];
+          if (fwInfo) {
+            out.push({ name: fwInfo.name, version: null, category: fwInfo.category, confidence: 0.85 });
+          }
+        }
+      }
+    }
+
+    // build.gradle / build.gradle.kts
+    for (const gradleFile of ['build.gradle', 'build.gradle.kts']) {
+      const gradlePath = join(projectPath, gradleFile);
+      if (existsSync(gradlePath)) {
+        const content = this.safeReadFile(gradlePath);
+        if (content.includes('spring-boot')) {
+          out.push({ name: 'Spring Boot', version: null, category: 'web', confidence: 0.9 });
+        }
+        if (content.includes('quarkus')) {
+          out.push({ name: 'Quarkus', version: null, category: 'web', confidence: 0.9 });
+        }
+        if (content.includes('micronaut')) {
+          out.push({ name: 'Micronaut', version: null, category: 'web', confidence: 0.9 });
+        }
+        if (content.includes('ktor')) {
+          out.push({ name: 'Ktor', version: null, category: 'web', confidence: 0.9 });
+        }
+      }
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // PHP
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromPhp(projectPath: string, out: FrameworkInfo[]): void {
+    const composerPath = join(projectPath, 'composer.json');
+    if (!existsSync(composerPath)) return;
+
+    const content = this.safeReadFile(composerPath);
+    try {
+      const pkg = JSON.parse(content);
+      const allDeps = { ...pkg.require, ...pkg['require-dev'] };
+      for (const [name, version] of Object.entries(allDeps)) {
+        const fwInfo = FrameworkDetector.FRAMEWORK_MAP[name];
+        if (fwInfo) {
+          const vStr = typeof version === 'string' ? version : '';
+          const vMatch = vStr.match(/([0-9][0-9.]*)/);
+          out.push({ name: fwInfo.name, version: vMatch?.[1] || null, category: fwInfo.category, confidence: 0.9 });
+        }
+      }
+    } catch {
+      // Invalid JSON
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // Go
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromGo(projectPath: string, out: FrameworkInfo[]): void {
+    const goModPath = join(projectPath, 'go.mod');
+    if (!existsSync(goModPath)) return;
+
+    const content = this.safeReadFile(goModPath);
+    const lines = content.split('\n');
+    for (const line of lines) {
+      const match = line.match(/^\s*(github\.com\/[^\s]+)/);
+      if (match) {
+        const modPath = match[1].toLowerCase();
+        for (const [key, fwInfo] of Object.entries(FrameworkDetector.FRAMEWORK_MAP)) {
+          if (modPath.includes(key.toLowerCase())) {
+            out.push({ name: fwInfo.name, version: null, category: fwInfo.category, confidence: 0.9 });
+          }
+        }
+      }
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // Ruby
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromRuby(projectPath: string, out: FrameworkInfo[]): void {
+    const gemfilePath = join(projectPath, 'Gemfile');
+    if (!existsSync(gemfilePath)) return;
+
+    const content = this.safeReadFile(gemfilePath);
+    if (content.includes("'rails'") || content.includes('"rails"')) {
+      const vMatch = content.match(/['"]rails['"],\s*['"]~?>\s*([0-9.]+)['"]/);
+      out.push({ name: 'Ruby on Rails', version: vMatch?.[1] || null, category: 'web', confidence: 0.95 });
+    }
+    if (content.includes("'sinatra'") || content.includes('"sinatra"')) {
+      out.push({ name: 'Sinatra', category: 'web', version: null, confidence: 0.9 });
+    }
+    if (content.includes("'rspec'") || content.includes('"rspec"')) {
+      out.push({ name: 'RSpec', category: 'test', version: null, confidence: 0.9 });
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // Dart / Flutter
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromDart(projectPath: string, out: FrameworkInfo[]): void {
+    const pubspecPath = join(projectPath, 'pubspec.yaml');
+    if (!existsSync(pubspecPath)) return;
+
+    const content = this.safeReadFile(pubspecPath);
+    if (content.includes('flutter:')) {
+      out.push({ name: 'Flutter', version: null, category: 'web', confidence: 0.95 });
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // Rust
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectFromRust(projectPath: string, out: FrameworkInfo[]): void {
+    const cargoPath = join(projectPath, 'Cargo.toml');
+    if (!existsSync(cargoPath)) return;
+
+    const content = this.safeReadFile(cargoPath);
+    for (const [key, fwInfo] of Object.entries(FrameworkDetector.FRAMEWORK_MAP)) {
+      if (content.includes(`"${key}"`) || content.includes(`'${key}'`) || content.includes(`${key} =`)) {
+        out.push({ name: fwInfo.name, version: null, category: fwInfo.category, confidence: 0.85 });
+      }
+    }
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // TOOLCHAIN DETECTION
+  // ═══════════════════════════════════════════════════════════════════════
+
+  /**
+   * Detect build/test/lint/run commands based on project files.
+   */
+  private detectToolchain(
+    projectPath: string,
+    report: AnalysisReport,
+    primaryFw: FrameworkInfo | null,
+    allFrameworks: FrameworkInfo[],
+  ): DetectedToolchain {
+    const lang = report.projectInfo.primaryLanguages[0] || 'Unknown';
+    const hasMakefile = existsSync(join(projectPath, 'Makefile'));
+    const hasDockerCompose = existsSync(join(projectPath, 'docker-compose.yml')) || existsSync(join(projectPath, 'docker-compose.yaml'));
+
+    const hasTest = (name: string) => allFrameworks.some(f => f.name === name);
+    const hasLint = (name: string) => allFrameworks.some(f => f.name === name && f.category === 'lint');
+
+    // Python
+    if (lang === 'Python') {
+      const fwName = primaryFw?.name || 'Python';
+      const hasPytest = hasTest('pytest');
+      const hasRuff = hasLint('Ruff');
+      const hasPoetry = existsSync(join(projectPath, 'poetry.lock'));
+      const hasPipenv = existsSync(join(projectPath, 'Pipfile.lock'));
+
+      let runCmd = 'python -m main';
+      if (fwName === 'FastAPI') runCmd = 'uvicorn app.main:app --reload';
+      else if (fwName === 'Django') runCmd = 'python manage.py runserver';
+      else if (fwName === 'Flask') runCmd = 'flask run --debug';
+
+      let installCmd = 'pip install -r requirements.txt';
+      if (hasPoetry) installCmd = 'poetry install';
+      else if (hasPipenv) installCmd = 'pipenv install';
+
+      return {
+        buildCmd: hasMakefile ? 'make build' : (fwName === 'Django' ? 'python manage.py check' : 'python -m py_compile main.py'),
+        testCmd: hasPytest ? 'pytest' : 'python -m unittest discover',
+        lintCmd: hasRuff ? 'ruff check .' : (hasLint('Flake8') ? 'flake8 .' : (hasLint('Pylint') ? 'pylint src/' : 'ruff check .')),
+        runCmd,
+        coverageCmd: hasPytest ? 'pytest --cov' : 'coverage run -m pytest',
+        installCmd,
+        migrateCmd: fwName === 'Django' ? 'python manage.py migrate' : (fwName === 'FastAPI' ? 'alembic upgrade head' : null),
+        depsFile: hasPoetry ? 'pyproject.toml' : (hasPipenv ? 'Pipfile' : 'requirements.txt'),
+      };
+    }
+
+    // TypeScript / JavaScript
+    if (lang === 'TypeScript' || lang === 'JavaScript') {
+      const hasYarn = existsSync(join(projectPath, 'yarn.lock'));
+      const hasPnpm = existsSync(join(projectPath, 'pnpm-lock.yaml'));
+      const pm = hasPnpm ? 'pnpm' : (hasYarn ? 'yarn' : 'npm');
+
+      return {
+        buildCmd: `${pm} run build`,
+        testCmd: hasTest('Vitest') ? `${pm} run test` : (hasTest('Jest') ? `${pm} test` : `${pm} test`),
+        lintCmd: hasLint('Biome') ? `${pm} run lint` : (hasLint('ESLint') ? `${pm} run lint` : 'npx eslint .'),
+        runCmd: `${pm} run dev`,
+        coverageCmd: `${pm} run test -- --coverage`,
+        installCmd: `${pm} install`,
+        migrateCmd: primaryFw?.name === 'NestJS' ? 'npx typeorm migration:run' : null,
+        depsFile: 'package.json',
+      };
+    }
+
+    // Java / Kotlin
+    if (lang === 'Java' || lang === 'Kotlin') {
+      const hasMaven = existsSync(join(projectPath, 'pom.xml'));
+      const hasGradle = existsSync(join(projectPath, 'build.gradle')) || existsSync(join(projectPath, 'build.gradle.kts'));
+
+      if (hasMaven) {
+        return {
+          buildCmd: 'mvn clean package',
+          testCmd: 'mvn test',
+          lintCmd: 'mvn checkstyle:check',
+          runCmd: 'mvn spring-boot:run',
+          coverageCmd: 'mvn jacoco:report',
+          installCmd: 'mvn install',
+          migrateCmd: 'mvn flyway:migrate',
+          depsFile: 'pom.xml',
+        };
+      }
+      if (hasGradle) {
+        return {
+          buildCmd: './gradlew build',
+          testCmd: './gradlew test',
+          lintCmd: './gradlew check',
+          runCmd: './gradlew bootRun',
+          coverageCmd: './gradlew jacocoTestReport',
+          installCmd: './gradlew dependencies',
+          migrateCmd: './gradlew flywayMigrate',
+          depsFile: existsSync(join(projectPath, 'build.gradle.kts')) ? 'build.gradle.kts' : 'build.gradle',
+        };
+      }
+    }
+
+    // PHP
+    if (lang === 'PHP') {
+      return {
+        buildCmd: 'composer install --no-dev',
+        testCmd: primaryFw?.name === 'Laravel' ? 'php artisan test' : 'vendor/bin/phpunit',
+        lintCmd: 'vendor/bin/phpstan analyse',
+        runCmd: primaryFw?.name === 'Laravel' ? 'php artisan serve' : 'php -S localhost:8000',
+        coverageCmd: 'vendor/bin/phpunit --coverage-text',
+        installCmd: 'composer install',
+        migrateCmd: primaryFw?.name === 'Laravel' ? 'php artisan migrate' : null,
+        depsFile: 'composer.json',
+      };
+    }
+
+    // Go
+    if (lang === 'Go') {
+      return {
+        buildCmd: 'go build ./...',
+        testCmd: 'go test ./...',
+        lintCmd: 'golangci-lint run',
+        runCmd: 'go run .',
+        coverageCmd: 'go test -coverprofile=coverage.out ./...',
+        installCmd: 'go mod download',
+        migrateCmd: null,
+        depsFile: 'go.mod',
+      };
+    }
+
+    // Ruby
+    if (lang === 'Ruby') {
+      return {
+        buildCmd: 'bundle exec rake build',
+        testCmd: hasTest('RSpec') ? 'bundle exec rspec' : 'bundle exec rake test',
+        lintCmd: 'bundle exec rubocop',
+        runCmd: primaryFw?.name === 'Ruby on Rails' ? 'rails server' : 'ruby app.rb',
+        coverageCmd: 'bundle exec rspec --format documentation',
+        installCmd: 'bundle install',
+        migrateCmd: primaryFw?.name === 'Ruby on Rails' ? 'rails db:migrate' : null,
+        depsFile: 'Gemfile',
+      };
+    }
+
+    // Dart
+    if (lang === 'Dart') {
+      return {
+        buildCmd: 'flutter build',
+        testCmd: 'flutter test',
+        lintCmd: 'dart analyze',
+        runCmd: 'flutter run',
+        coverageCmd: 'flutter test --coverage',
+        installCmd: 'flutter pub get',
+        migrateCmd: null,
+        depsFile: 'pubspec.yaml',
+      };
+    }
+
+    // Rust
+    if (lang === 'Rust') {
+      return {
+        buildCmd: 'cargo build',
+        testCmd: 'cargo test',
+        lintCmd: 'cargo clippy',
+        runCmd: 'cargo run',
+        coverageCmd: 'cargo tarpaulin',
+        installCmd: 'cargo build',
+        migrateCmd: null,
+        depsFile: 'Cargo.toml',
+      };
+    }
+
+    // Fallback
+    return {
+      buildCmd: hasMakefile ? 'make build' : 'echo "No build command detected"',
+      testCmd: hasMakefile ? 'make test' : 'echo "No test command detected"',
+      lintCmd: hasMakefile ? 'make lint' : 'echo "No lint command detected"',
+      runCmd: hasMakefile ? 'make run' : 'echo "No run command detected"',
+      coverageCmd: 'echo "No coverage command detected"',
+      installCmd: 'echo "No install command detected"',
+      migrateCmd: null,
+      depsFile: 'unknown',
+    };
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // PROJECT STRUCTURE DETECTION
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private detectProjectStructure(report: AnalysisReport): 'clean-architecture' | 'mvc' | 'modular' | 'flat' | 'monorepo' | 'unknown' {
+    const paths = report.dependencyGraph.nodes.map(n => n.toLowerCase());
+
+    // Clean Architecture / DDD
+    const hasDomain = paths.some(p => p.includes('/domain/'));
+    const hasApplication = paths.some(p => p.includes('/application/'));
+    const hasInfrastructure = paths.some(p => p.includes('/infrastructure/'));
+    const hasPresentation = paths.some(p => p.includes('/presentation/'));
+    if ((hasDomain && hasInfrastructure) || (hasDomain && hasApplication && hasPresentation)) {
+      return 'clean-architecture';
+    }
+
+    // MVC
+    const hasModels = paths.some(p => p.includes('/models/'));
+    const hasViews = paths.some(p => p.includes('/views/'));
+    const hasControllers = paths.some(p => p.includes('/controllers/'));
+    if (hasModels && hasViews && hasControllers) return 'mvc';
+
+    // Modular (NestJS, feature-based)
+    const hasModules = paths.some(p => p.includes('/modules/'));
+    const hasFeatures = paths.some(p => p.includes('/features/'));
+    if (hasModules || hasFeatures) return 'modular';
+
+    // Monorepo
+    const hasPackages = paths.some(p => p.includes('/packages/'));
+    const hasApps = paths.some(p => p.includes('/apps/'));
+    if (hasPackages || hasApps) return 'monorepo';
+
+    // Flat
+    const maxDepth = Math.max(...paths.map(p => p.split('/').length));
+    if (maxDepth <= 3) return 'flat';
+
+    return 'unknown';
+  }
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // UTILS
+  // ═══════════════════════════════════════════════════════════════════════
+
+  private safeReadFile(path: string): string {
+    try {
+      return readFileSync(path, 'utf-8');
+    } catch {
+      return '';
+    }
+  }
+}