@girardelli/architect 4.0.0 → 6.0.0

package/src/project-summarizer.ts

@@ -1,347 +0,0 @@
-import { readFileSync, existsSync } from 'fs';
-import { join, basename, dirname } from 'path';
-import { AnalysisReport, ProjectSummary, FileNode } from './types.js';
-
-/**
- * ProjectSummarizer — infers what a project does from its metadata,
- * structure, README, package.json, and file naming conventions.
- */
-export class ProjectSummarizer {
-  summarize(projectPath: string, report: AnalysisReport): ProjectSummary {
-    const packageInfo = this.readPackageJson(projectPath);
-    const readmeContent = this.readReadme(projectPath);
-    const modules = this.inferModules(report);
-    const entryPoints = this.findEntryPoints(report);
-    const keywords = this.extractKeywords(packageInfo, readmeContent, modules, report);
-    const techStack = this.buildTechStack(report, packageInfo);
-    const description = this.buildDescription(packageInfo, readmeContent, report);
-    const purpose = this.inferPurpose(keywords, modules, report);
-
-    return {
-      description,
-      purpose,
-      modules,
-      techStack,
-      entryPoints,
-      keywords,
-    };
-  }
-
-  // ── Package.json ──
-
-  private readPackageJson(projectPath: string): Record<string, unknown> {
-    const candidates = [
-      join(projectPath, 'package.json'),
-      join(projectPath, 'pyproject.toml'),
-      join(projectPath, 'pubspec.yaml'),
-      join(projectPath, 'Cargo.toml'),
-      join(projectPath, 'pom.xml'),
-      join(projectPath, 'build.gradle'),
-    ];
-
-    for (const candidate of candidates) {
-      if (existsSync(candidate)) {
-        try {
-          if (candidate.endsWith('.json')) {
-            return JSON.parse(readFileSync(candidate, 'utf-8'));
-          }
-          // For non-JSON, return raw content as 'raw' field
-          return { raw: readFileSync(candidate, 'utf-8'), type: basename(candidate) };
-        } catch {
-          // ignore
-        }
-      }
-    }
-    return {};
-  }
-
-  private readReadme(projectPath: string): string {
-    const candidates = ['README.md', 'readme.md', 'README.txt', 'README', 'README.rst'];
-    for (const name of candidates) {
-      const path = join(projectPath, name);
-      if (existsSync(path)) {
-        try {
-          // Read first 3000 chars — enough for description, skip excessive content
-          return readFileSync(path, 'utf-8').slice(0, 3000);
-        } catch {
-          // ignore
-        }
-      }
-    }
-    return '';
-  }
-
-  // ── Module Inference ──
-
-  private inferModules(report: AnalysisReport): ProjectSummary['modules'] {
-    const modules: Map<string, { files: Set<string>; hints: Set<string> }> = new Map();
-
-    for (const node of report.dependencyGraph.nodes) {
-      const parts = node.split('/');
-      // Skip root-level files
-      if (parts.length < 2) continue;
-
-      // Get the module directory (2nd level, or 1st level for flat projects)
-      let moduleName: string;
-      const firstDir = parts[0];
-
-      // Common source directories — go one level deeper
-      if (['src', 'lib', 'app', 'packages', 'modules', 'features', 'apps'].includes(firstDir)) {
-        moduleName = parts.length > 2 ? parts[1] : firstDir;
-      } else if (firstDir === 'tests' || firstDir === 'test' || firstDir === '__tests__') {
-        continue; // Skip test directories for module inference
-      } else {
-        moduleName = firstDir;
-      }
-
-      if (!modules.has(moduleName)) {
-        modules.set(moduleName, { files: new Set(), hints: new Set() });
-      }
-      const mod = modules.get(moduleName)!;
-      mod.files.add(node);
-
-      // Extract hints from filenames
-      const filename = basename(node).replace(/\.(ts|js|py|dart|go|java|rb|php|cs|tsx|jsx)$/, '');
-      if (filename !== 'index' && filename !== 'main' && filename !== '__init__') {
-        mod.hints.add(filename.toLowerCase());
-      }
-    }
-
-    return [...modules.entries()]
-      .filter(([, data]) => data.files.size > 0)
-      .sort((a, b) => b[1].files.size - a[1].files.size)
-      .slice(0, 15) // Top 15 modules
-      .map(([name, data]) => ({
-        name,
-        files: data.files.size,
-        description: this.describeModule(name, data.hints),
-      }));
-  }
-
-  private describeModule(name: string, hints: Set<string>): string {
-    const n = name.toLowerCase();
-    const h = [...hints].join(' ');
-
-    // Known module patterns
-    const patterns: [RegExp, string][] = [
-      [/auth/, 'Autenticação e autorização'],
-      [/user/, 'Gestão de usuários'],
-      [/payment|billing|charge|invoice/, 'Pagamentos e faturamento'],
-      [/order|cart|checkout/, 'Pedidos e checkout'],
-      [/product|catalog|item/, 'Catálogo de produtos'],
-      [/notif/, 'Sistema de notificações'],
-      [/email|mail|smtp/, 'Envio de emails'],
-      [/report|analytics|dashboard/, 'Relatórios e analytics'],
-      [/config|setting/, 'Configuração do sistema'],
-      [/util|helper|common|shared/, 'Utilitários compartilhados'],
-      [/middleware|interceptor|guard|pipe/, 'Middleware e interceptors'],
-      [/database|db|migration|seed/, 'Banco de dados e migrations'],
-      [/api|controller|route|endpoint/, 'API endpoints'],
-      [/service|business|domain/, 'Lógica de negócio'],
-      [/model|entity|schema/, 'Modelos de dados'],
-      [/test|spec|fixture/, 'Testes'],
-      [/validator|validation|sanitiz/, 'Validação de dados'],
-      [/security|crypto|encrypt/, 'Segurança e criptografia'],
-      [/cache|redis/, 'Cache e performance'],
-      [/queue|worker|job|task/, 'Processamento assíncrono'],
-      [/log|monitor|trace|metric/, 'Logging e monitoramento'],
-      [/file|upload|storage|s3/, 'Armazenamento de arquivos'],
-      [/search|elastic|index/, 'Busca e indexação'],
-      [/chat|message|websocket|socket/, 'Comunicação em tempo real'],
-      [/i18n|locale|translation/, 'Internacionalização'],
-      [/theme|style|design/, 'Design system e temas'],
-      [/component|widget|ui/, 'Componentes de UI'],
-      [/page|screen|view/, 'Páginas/telas'],
-      [/hook|composable/, 'Hooks/composables reutilizáveis'],
-      [/store|state|redux|bloc/, 'Gerenciamento de estado'],
-      [/navigation|router|routing/, 'Navegação e rotas'],
-    ];
-
-    const combined = `${n} ${h}`;
-    for (const [regex, desc] of patterns) {
-      if (regex.test(combined)) return desc;
-    }
-
-    return `Módulo ${name}`;
-  }
-
-  // ── Entry Points ──
-
-  private findEntryPoints(report: AnalysisReport): string[] {
-    const entryPatterns = [
-      /^(src\/)?(main|index|app|server|cli)\.(ts|js|py|dart|go|java)$/,
-      /^(src\/)?bin\//,
-      /manage\.py$/,
-      /^main\.go$/,
-    ];
-
-    return report.dependencyGraph.nodes
-      .filter(node => entryPatterns.some(p => p.test(node)))
-      .slice(0, 5);
-  }
-
-  // ── Keywords ──
-
-  private extractKeywords(
-    packageInfo: Record<string, unknown>,
-    readme: string,
-    modules: ProjectSummary['modules'],
-    report: AnalysisReport,
-  ): string[] {
-    const keywords = new Set<string>();
-
-    // From package.json keywords
-    if (Array.isArray(packageInfo.keywords)) {
-      for (const kw of packageInfo.keywords) {
-        if (typeof kw === 'string') keywords.add(kw.toLowerCase());
-      }
-    }
-
-    // From module names
-    for (const mod of modules) {
-      keywords.add(mod.name.toLowerCase());
-    }
-
-    // From frameworks detected
-    for (const fw of report.projectInfo.frameworks) {
-      keywords.add(fw.toLowerCase());
-    }
-
-    // From languages
-    for (const lang of report.projectInfo.primaryLanguages) {
-      keywords.add(lang.toLowerCase());
-    }
-
-    // Filter out generic words
-    const generic = new Set(['src', 'lib', 'app', 'utils', 'common', 'shared', 'core', 'index', 'main', 'dist', 'build']);
-    return [...keywords].filter(kw => !generic.has(kw) && kw.length > 1).slice(0, 20);
-  }
-
-  // ── Tech Stack ──
-
-  private buildTechStack(report: AnalysisReport, packageInfo: Record<string, unknown>): string[] {
-    const stack: string[] = [];
-
-    // Languages
-    stack.push(...report.projectInfo.primaryLanguages);
-
-    // Frameworks from report
-    stack.push(...report.projectInfo.frameworks);
-
-    // Dependencies from package.json
-    const deps = { ...(packageInfo.dependencies as Record<string, string> || {}), ...(packageInfo.devDependencies as Record<string, string> || {}) };
-    const notable = [
-      'express', 'fastify', 'nestjs', '@nestjs/core', 'koa', 'hapi',
-      'react', 'next', 'angular', 'vue', 'svelte',
-      'prisma', '@prisma/client', 'typeorm', 'sequelize', 'mongoose', 'knex',
-      'jest', 'mocha', 'vitest', 'cypress', 'playwright',
-      'tailwindcss', 'styled-components', 'emotion',
-      'redis', 'ioredis', 'bull', 'bullmq',
-      'graphql', 'apollo', '@apollo/server',
-      'socket.io', 'ws',
-      'passport', 'jsonwebtoken', 'bcrypt',
-      'winston', 'pino',
-      'swagger', '@nestjs/swagger',
-      'docker', 'kubernetes',
-      'aws-sdk', '@aws-sdk',
-      'stripe', 'paypal',
-    ];
-
-    for (const dep of Object.keys(deps)) {
-      const cleaned = dep.replace('@', '').split('/')[0];
-      if (notable.some(n => dep.includes(n))) {
-        if (!stack.some(s => s.toLowerCase() === cleaned.toLowerCase())) {
-          stack.push(dep);
-        }
-      }
-    }
-
-    return [...new Set(stack)].slice(0, 15);
-  }
-
-  // ── Description Builder ──
-
-  private buildDescription(packageInfo: Record<string, unknown>, readme: string, report: AnalysisReport): string {
-    // Priority 1: package.json description
-    if (typeof packageInfo.description === 'string' && packageInfo.description.trim()) {
-      return packageInfo.description.trim();
-    }
-
-    // Priority 2: First paragraph of README (skip badges, titles)
-    if (readme) {
-      const lines = readme.split('\n');
-      for (const line of lines) {
-        const trimmed = line.trim();
-        // Skip empty lines, headers, badges, links, HTML tags
-        if (!trimmed) continue;
-        if (trimmed.startsWith('#')) continue;
-        if (trimmed.startsWith('[!') || trimmed.startsWith('[![')) continue;
-        if (trimmed.startsWith('<')) continue;
-        if (trimmed.startsWith('---') || trimmed.startsWith('===')) continue;
-        if (trimmed.startsWith('![')) continue;
-        if (trimmed.length < 20) continue;
-
-        // Found a real text paragraph
-        return trimmed.slice(0, 300);
-      }
-    }
-
-    // Priority 3: Infer from project name and structure
-    const name = report.projectInfo.name || 'Unknown';
-    const langs = report.projectInfo.primaryLanguages.join(', ');
-    const files = report.projectInfo.totalFiles;
-    return `Projeto ${name} — ${files} arquivos em ${langs}`;
-  }
-
-  // ── Purpose Inference ──
-
-  private inferPurpose(
-    keywords: string[],
-    modules: ProjectSummary['modules'],
-    report: AnalysisReport,
-  ): string {
-    const allSignals = [
-      ...keywords,
-      ...modules.map(m => m.name.toLowerCase()),
-      ...modules.map(m => m.description.toLowerCase()),
-      ...report.dependencyGraph.nodes.map(n => n.toLowerCase()),
-    ].join(' ');
-
-    // Infer project type from signals
-    const types: [RegExp, string][] = [
-      [/api.*(rest|graph|endpoint)|controller.*route|swagger|openapi/, 'API Backend'],
-      [/cli|command.*line|bin\/|yargs|commander/, 'CLI Tool'],
-      [/component.*ui|react|angular|vue|frontend|page.*screen/, 'Frontend Application'],
-      [/mobile|flutter|dart|react.native|ionic/, 'Mobile App'],
-      [/library|lib|package|npm|pub|sdk|module/, 'Library / Package'],
-      [/test|spec|validator|lint|analyz|check/, 'Tool de Análise / Validação'],
-      [/microservice|service|worker|queue/, 'Microservice'],
-      [/monorepo|workspace|packages\//, 'Monorepo'],
-      [/bot|scraper|crawler|automation/, 'Bot / Automação'],
-      [/game|canvas|webgl|three/, 'Game / Visualização'],
-      [/e-?commerce|shop|cart|product|catalog/, 'E-commerce'],
-      [/blog|cms|content|post|article/, 'CMS / Blog'],
-      [/auth|login|oauth|sso|identity/, 'Sistema de Autenticação'],
-      [/chat|message|realtime|socket/, 'Comunicação Real-time'],
-      [/dashboard|admin|panel|analytics/, 'Dashboard / Admin Panel'],
-      [/payment|billing|fintech|finance|bank/, 'Fintech / Pagamentos'],
-      [/health|medical|patient|clinic/, 'Healthcare'],
-      [/education|course|learn|student/, 'EdTech'],
-    ];
-
-    const matched: string[] = [];
-    for (const [regex, type] of types) {
-      if (regex.test(allSignals)) {
-        matched.push(type);
-      }
-    }
-
-    if (matched.length > 0) {
-      return matched.slice(0, 3).join(' + ');
-    }
-
-    // Fallback
-    const langs = report.projectInfo.primaryLanguages.join('/');
-    return `Projeto ${langs}`;
-  }
-}

package/src/scanner.ts

@@ -1,298 +0,0 @@
-import { globSync } from 'glob';
-import { readFileSync, lstatSync } from 'fs';
-import { join, relative, extname } from 'path';
-import { FileNode, ProjectInfo, ArchitectConfig } from './types.js';
-
-export class ProjectScanner {
-  private projectPath: string;
-  private config: ArchitectConfig;
-  private frameworks: Set<string> = new Set();
-
-  constructor(projectPath: string, config: ArchitectConfig) {
-    this.projectPath = projectPath;
-    this.config = config;
-  }
-
-  scan(): ProjectInfo {
-    const files = this.scanDirectory();
-    const fileTree = this.buildFileTree(files);
-
-    // Detect frameworks from scanned files AND parent package.json
-    const parentPackageJsons = this.findParentPackageJsons();
-    const allFilesForDetection = [...files, ...parentPackageJsons];
-    const frameworks = this.detectFrameworks(allFilesForDetection);
-
-    const languages = this.detectLanguages(files);
-    const totalLines = this.countTotalLines(files);
-    const projectName = this.resolveProjectName(parentPackageJsons);
-
-    return {
-      path: this.projectPath,
-      name: projectName,
-      frameworks: Array.from(frameworks),
-      totalFiles: files.length,
-      totalLines,
-      primaryLanguages: languages,
-      fileTree,
-    };
-  }
-
-  /**
-   * Walk up directory tree to find package.json files for project name and framework detection
-   */
-  private findParentPackageJsons(): string[] {
-    const found: string[] = [];
-    let dir = this.projectPath;
-    const root = '/';
-    let depth = 0;
-
-    while (dir !== root && depth < 5) {
-      const pkgPath = join(dir, 'package.json');
-      try {
-        readFileSync(pkgPath, 'utf-8');
-        found.push(pkgPath);
-      } catch {
-        // no package.json here
-      }
-      dir = join(dir, '..');
-      depth++;
-    }
-
-    return found;
-  }
-
-  /**
-   * Resolve project name from nearest package.json or directory name
-   */
-  private resolveProjectName(packageJsonPaths: string[]): string {
-    for (const pkgPath of packageJsonPaths) {
-      try {
-        const content = readFileSync(pkgPath, 'utf-8');
-        const parsed = JSON.parse(content);
-        if (parsed.name) {
-          return parsed.name;
-        }
-      } catch {
-        // skip
-      }
-    }
-    return this.projectPath.split('/').pop() || 'project';
-  }
-
-  private scanDirectory(): string[] {
-    const ignorePatterns = this.config.ignore || [];
-    const negatedPatterns = ignorePatterns.map((p) => `!**/${p}/**`);
-
-    const files = globSync('**/*', {
-      cwd: this.projectPath,
-      ignore: ignorePatterns,
-      absolute: true,
-      nodir: true,
-    });
-
-    return files.filter(
-      (f) =>
-        !lstatSync(f).isDirectory() && this.isSourceFile(f)
-    );
-  }
-
-  private isSourceFile(filePath: string): boolean {
-    const ext = extname(filePath).toLowerCase();
-    const sourceExtensions = [
-      '.js',
-      '.ts',
-      '.tsx',
-      '.jsx',
-      '.py',
-      '.java',
-      '.go',
-      '.rb',
-      '.php',
-      '.cs',
-      '.cpp',
-      '.c',
-      '.h',
-      '.rs',
-      '.kt',
-      '.scala',
-      '.groovy',
-      '.sql',
-      '.graphql',
-      '.json',
-      '.yaml',
-      '.yml',
-      '.xml',
-    ];
-    return sourceExtensions.includes(ext);
-  }
-
-  private buildFileTree(files: string[]): FileNode {
-    const root: FileNode = {
-      path: this.projectPath,
-      name: this.projectPath.split('/').pop() || 'root',
-      type: 'directory',
-    };
-
-    for (const file of files) {
-      const relativePath = relative(this.projectPath, file);
-      const parts = relativePath.split('/');
-      let current = root;
-
-      for (let i = 0; i < parts.length; i++) {
-        const part = parts[i];
-        const isFile = i === parts.length - 1;
-
-        let child = (current.children || []).find((c) => c.name === part);
-        if (!child) {
-          child = {
-            path: join(current.path, part),
-            name: part,
-            type: isFile ? 'file' : 'directory',
-            extension: isFile ? extname(part) : undefined,
-          };
-
-          if (isFile) {
-            child.lines = this.countLines(file);
-            child.language = this.detectLanguage(file);
-          }
-
-          if (!current.children) current.children = [];
-          current.children.push(child);
-        }
-
-        current = child;
-      }
-    }
-
-    return root;
-  }
-
-  private detectFrameworks(files: string[]): Set<string> {
-    const frameworks = new Set<string>();
-
-    for (const file of files) {
-      if (file.endsWith('package.json')) {
-        try {
-          const content = readFileSync(file, 'utf-8');
-          const parsed = JSON.parse(content);
-          const allDeps = {
-            ...parsed.dependencies,
-            ...parsed.devDependencies,
-          };
-
-          // Detect from actual dependency keys
-          if (allDeps['@nestjs/core'] || allDeps['@nestjs/common']) frameworks.add('NestJS');
-          if (allDeps['react'] || allDeps['react-dom']) frameworks.add('React');
-          if (allDeps['@angular/core']) frameworks.add('Angular');
-          if (allDeps['vue'] || allDeps['@vue/core']) frameworks.add('Vue.js');
-          if (allDeps['express']) frameworks.add('Express.js');
-          if (allDeps['next']) frameworks.add('Next.js');
-          if (allDeps['fastify']) frameworks.add('Fastify');
-          if (allDeps['typeorm']) frameworks.add('TypeORM');
-          if (allDeps['prisma'] || allDeps['@prisma/client']) frameworks.add('Prisma');
-          if (allDeps['sequelize']) frameworks.add('Sequelize');
-          if (allDeps['mongoose']) frameworks.add('Mongoose');
-        } catch {
-          // Fallback: simple string matching
-          try {
-            const content = readFileSync(file, 'utf-8');
-            if (content.includes('@nestjs')) frameworks.add('NestJS');
-            if (content.includes('react')) frameworks.add('React');
-            if (content.includes('angular')) frameworks.add('Angular');
-            if (content.includes('vue')) frameworks.add('Vue.js');
-            if (content.includes('express')) frameworks.add('Express.js');
-            if (content.includes('next')) frameworks.add('Next.js');
-          } catch {
-            // skip
-          }
-        }
-      }
-
-      if (file.includes('pom.xml')) {
-        try {
-          const content = readFileSync(file, 'utf-8');
-          if (content.includes('spring-boot')) frameworks.add('Spring Boot');
-          if (content.includes('spring')) frameworks.add('Spring');
-        } catch {
-          // skip
-        }
-      }
-
-      if (file.includes('requirements.txt')) {
-        try {
-          const content = readFileSync(file, 'utf-8');
-          if (content.includes('django')) frameworks.add('Django');
-          if (content.includes('flask')) frameworks.add('Flask');
-          if (content.includes('fastapi')) frameworks.add('FastAPI');
-        } catch {
-          // skip
-        }
-      }
-
-      if (file.includes('Gemfile')) {
-        try {
-          const content = readFileSync(file, 'utf-8');
-          if (content.includes('rails')) frameworks.add('Ruby on Rails');
-        } catch {
-          // skip
-        }
-      }
-
-      if (file.includes('go.mod')) {
-        frameworks.add('Go');
-      }
-    }
-
-    return frameworks;
-  }
-
-  private detectLanguages(files: string[]): string[] {
-    const languages = new Set<string>();
-
-    for (const file of files) {
-      const lang = this.detectLanguage(file);
-      if (lang && lang !== 'Unknown') languages.add(lang);
-    }
-
-    return Array.from(languages);
-  }
-
-  private detectLanguage(filePath: string): string {
-    const ext = extname(filePath).toLowerCase();
-
-    const languageMap: Record<string, string> = {
-      '.js': 'JavaScript',
-      '.ts': 'TypeScript',
-      '.tsx': 'TypeScript',
-      '.jsx': 'JavaScript',
-      '.py': 'Python',
-      '.java': 'Java',
-      '.go': 'Go',
-      '.rb': 'Ruby',
-      '.php': 'PHP',
-      '.cs': 'C#',
-      '.cpp': 'C++',
-      '.c': 'C',
-      '.rs': 'Rust',
-      '.kt': 'Kotlin',
-      '.scala': 'Scala',
-      '.sql': 'SQL',
-      '.graphql': 'GraphQL',
-    };
-
-    return languageMap[ext] || 'Unknown';
-  }
-
-  private countLines(filePath: string): number {
-    try {
-      const content = readFileSync(filePath, 'utf-8');
-      return content.split('\n').length;
-    } catch {
-      return 0;
-    }
-  }
-
-  private countTotalLines(files: string[]): number {
-    return files.reduce((total, file) => total + this.countLines(file), 0);
-  }
-}