@justmpm/ai-tool 0.3.1 → 0.4.0

package/dist/cli.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 import {
   VERSION,
+  area,
+  areas,
+  areasInit,
   context,
   dead,
   deadFix,
   impact,
   map,
   suggest
-} from "./chunk-4HXWM7PK.js";
+} from "./chunk-33DHCY2H.js";
 
 // src/cli.ts
 var HELP = `
@@ -21,6 +24,14 @@ COMANDOS:
   suggest <arquivo>      Sugere arquivos para ler antes de modificar
   context <arquivo>      Extrai assinaturas de um arquivo (funcoes, tipos)
 
+AREAS (NOVO):
+  areas                  Lista todas as areas/dominios do projeto
+  areas init             Gera arquivo de configuracao .analyze/areas.config.json
+  areas init --force     Sobrescreve configuracao existente
+  area <nome>            Mostra arquivos de uma area especifica
+  area <nome> --type=hook   Filtra por categoria
+  area <nome> --full     Mostra todos os arquivos
+
 MODOS:
   --mcp                  Inicia servidor MCP para integracao com Claude Desktop
 
@@ -29,6 +40,8 @@ OPCOES:
   --cwd=<path>           Diretorio do projeto (default: cwd)
   --no-cache             Ignora cache e forca regeneracao
   --limit=<n>            Limite de sugestoes (default: 10, apenas suggest)
+  --type=<categoria>     Filtra por categoria (apenas area)
+  --full                 Mostra todos os arquivos (apenas area)
   --help, -h             Mostra esta ajuda
   --version, -v          Mostra versao
 
@@ -40,16 +53,16 @@ CACHE:
 EXEMPLOS:
   ai-tool map
   ai-tool map --format=json
-  ai-tool map --no-cache
   ai-tool dead
   ai-tool dead --fix
   ai-tool impact Button
-  ai-tool impact src/hooks/useAuth.ts
-  ai-tool impact src/components/Header.tsx --format=json
-  ai-tool suggest Button
-  ai-tool suggest src/hooks/useAuth.ts --limit=5
+  ai-tool suggest Button --limit=5
   ai-tool context Button
-  ai-tool context src/hooks/useAuth.ts --format=json
+  ai-tool areas
+  ai-tool areas init
+  ai-tool area meus-pets
+  ai-tool area meus-pets --type=hook
+  ai-tool area firebase --full
   ai-tool --mcp
 
 SOBRE:
@@ -72,7 +85,7 @@ async function main() {
     }
   }
   if (flags.mcp) {
-    const { startMcpServer } = await import("./server-YV4BWISA.js");
+    const { startMcpServer } = await import("./server-62WVGNJD.js");
     await startMcpServer();
     return;
   }
@@ -134,6 +147,27 @@ async function main() {
         }
         result = await context(target, { format, cwd });
         break;
+      case "areas":
+        if (target === "init") {
+          result = await areasInit({ cwd, force: !!flags.force });
+        } else {
+          result = await areas({ format, cwd });
+        }
+        break;
+      case "area":
+        if (!target) {
+          console.error("\u274C Erro: nome da \xE1rea \xE9 obrigat\xF3rio para o comando area");
+          console.error("   Exemplo: ai-tool area meus-pets");
+          console.error("   Use 'ai-tool areas' para listar \xE1reas dispon\xEDveis");
+          process.exit(1);
+        }
+        result = await area(target, {
+          format,
+          cwd,
+          type: flags.type,
+          full: !!flags.full
+        });
+        break;
       default:
         console.error(`\u274C Comando desconhecido: ${command}`);
         console.error("   Use 'ai-tool --help' para ver comandos dispon\xEDveis.");

package/dist/index.d.ts

@@ -66,6 +66,14 @@ interface DeadResult {
         export: string;
     }>;
     dependencies: string[];
+    /** Informações sobre filtros aplicados (ex: Cloud Functions excluídas) */
+    filters?: {
+        firebase: {
+            detected: boolean;
+            excludedCount: number;
+        };
+        excludedFiles: string[];
+    };
 }
 interface ImpactFile {
     path: string;
@@ -150,6 +158,64 @@ interface ContextResult {
     functions: FunctionInfo[];
     types: TypeInfo[];
 }
+interface AreaConfig {
+    name: string;
+    description?: string;
+    patterns: string[];
+    keywords?: string[];
+    exclude?: string[];
+}
+interface AreasConfigFile {
+    $schema?: string;
+    version: string;
+    areas: Record<string, AreaConfig>;
+    descriptions?: Record<string, string>;
+    settings?: {
+        autoDetect?: boolean;
+        inferDescriptions?: boolean;
+        groupByCategory?: boolean;
+    };
+}
+interface AreaFile {
+    path: string;
+    category: FileCategory;
+    description?: string;
+}
+interface DetectedArea {
+    id: string;
+    name: string;
+    description?: string;
+    files: AreaFile[];
+    fileCount: number;
+    categories: Partial<Record<FileCategory, number>>;
+    isAutoDetected: boolean;
+}
+interface AreasResult {
+    version: string;
+    timestamp: string;
+    cwd: string;
+    areas: DetectedArea[];
+    unmapped: AreaFile[];
+    summary: {
+        totalAreas: number;
+        totalFiles: number;
+        unmappedCount: number;
+    };
+}
+interface AreaDetailResult {
+    version: string;
+    timestamp: string;
+    area: DetectedArea;
+    byCategory: Partial<Record<FileCategory, AreaFile[]>>;
+}
+interface AreasOptions extends CommandOptions {
+    full?: boolean;
+    type?: FileCategory;
+}
+interface AreaOptions extends CommandOptions {
+    full?: boolean;
+    type?: FileCategory;
+}
 
 /**
  * Comando MAP - Mapa do projeto usando Skott
@@ -162,6 +228,9 @@ declare function map(options?: MapOptions): Promise<string>;
 
 /**
  * Comando DEAD - Detecção de código morto usando Knip
+ *
+ * Inclui filtro inteligente para Firebase Cloud Functions que elimina
+ * falsos positivos de arquivos exportados via functions/src/index.ts
  */
 
 /**
@@ -200,12 +269,51 @@ declare function suggest(target: string, options?: SuggestOptions): Promise<stri
  */
 declare function context(target: string, options?: ContextOptions): Promise<string>;
 
+/**
+ * Comando AREAS - Lista todas as áreas do projeto
+ */
+
+/**
+ * Executa o comando AREAS
+ */
+declare function areas(options?: AreasOptions): Promise<string>;
+
+/**
+ * Comando AREA - Mostra detalhes de uma área específica
+ */
+
+/**
+ * Executa o comando AREA
+ */
+declare function area(target: string, options?: AreaOptions): Promise<string>;
+
+/**
+ * Comando AREAS INIT - Gera configuração inicial de áreas
+ */
+interface InitOptions {
+    cwd?: string;
+    force?: boolean;
+}
+/**
+ * Executa o comando AREAS INIT
+ */
+declare function areasInit(options?: InitOptions): Promise<string>;
+
 /**
  * Utilitários para detecção e classificação de arquivos
  */
 
 /**
  * Detecta a categoria de um arquivo baseado no path
+ *
+ * Suporta múltiplos frameworks:
+ * - Next.js (App Router e Pages Router)
+ * - Vite (React, Vue, Svelte)
+ * - Create React App
+ * - Remix
+ * - Nuxt
+ * - SvelteKit
+ * - Astro
  */
 declare function detectCategory(filePath: string): FileCategory;
 /**
@@ -221,6 +329,41 @@ declare function isEntryPoint(filePath: string): boolean;
  */
 declare function isCodeFile(filePath: string): boolean;
 
+/**
+ * Utilitários para detecção de Firebase Cloud Functions
+ *
+ * Resolve falsos positivos onde arquivos em functions/src/ são marcados
+ * como "órfãos" pelo Knip, mas na verdade são exportados via index.ts
+ * e deployados como Cloud Functions.
+ */
+/**
+ * Detecta se é um projeto Firebase (via .firebaserc ou firebase.json)
+ */
+declare function isFirebaseProject(cwd: string): boolean;
+/**
+ * Detecta se o projeto tem Firebase Cloud Functions
+ */
+declare function hasFirebaseFunctions(cwd: string): boolean;
+/**
+ * Verifica se um arquivo é uma Cloud Function exportada no index.ts
+ */
+declare function isExportedCloudFunction(filePath: string, cwd: string): boolean;
+/**
+ * Filtra arquivos órfãos removendo falsos positivos de Cloud Functions
+ *
+ * @param files - Lista de arquivos marcados como órfãos pelo Knip
+ * @param cwd - Diretório do projeto
+ * @returns Lista filtrada sem os falsos positivos
+ */
+declare function filterCloudFunctionsFalsePositives(files: string[], cwd: string): {
+    filtered: string[];
+    excluded: string[];
+};
+/**
+ * Limpa o cache (útil para testes ou quando o index.ts muda)
+ */
+declare function clearFirebaseCache(): void;
+
 /**
  * Obtém o caminho da pasta de cache
  */
@@ -234,6 +377,110 @@ declare function isCacheValid(cwd: string): boolean;
  */
 declare function invalidateCache(cwd: string): void;
 
+/**
+ * Gerenciamento de configuração de áreas
+ *
+ * Lê e escreve o arquivo areas.config.json
+ */
+
+/**
+ * Verifica se o arquivo de configuração existe
+ */
+declare function configExists(cwd: string): boolean;
+/**
+ * Lê o arquivo de configuração
+ */
+declare function readConfig(cwd: string): AreasConfigFile;
+/**
+ * Escreve o arquivo de configuração
+ */
+declare function writeConfig(cwd: string, config: AreasConfigFile): void;
+/**
+ * Adiciona ou atualiza uma área na configuração
+ */
+declare function setArea(cwd: string, id: string, area: AreaConfig): void;
+/**
+ * Remove uma área da configuração
+ */
+declare function removeArea(cwd: string, id: string): void;
+/**
+ * Define descrição manual para um arquivo
+ */
+declare function setFileDescription(cwd: string, filePath: string, description: string): void;
+/**
+ * Obtém descrição manual de um arquivo (se existir)
+ */
+declare function getFileDescription(cwd: string, filePath: string): string | undefined;
+
+/**
+ * Detector de áreas
+ *
+ * Detecta automaticamente a área de cada arquivo baseado em:
+ * 1. Configuração manual (areas.config.json)
+ * 2. Padrões de pasta
+ * 3. Keywords no nome
+ */
+
+/**
+ * Detecta a(s) área(s) de um arquivo
+ * Retorna array porque um arquivo pode pertencer a múltiplas áreas
+ */
+declare function detectFileAreas(filePath: string, config: AreasConfigFile): string[];
+/**
+ * Obtém o nome amigável de uma área
+ */
+declare function getAreaName(areaId: string, config: AreasConfigFile): string;
+/**
+ * Obtém a descrição de uma área
+ */
+declare function getAreaDescription(areaId: string, config: AreasConfigFile): string | undefined;
+/**
+ * Infere descrição de um arquivo baseado em seu nome e categoria
+ */
+declare function inferFileDescription(filePath: string, category: FileCategory): string | undefined;
+
+/**
+ * Padrões de detecção automática de áreas
+ *
+ * Define regras para detectar áreas baseado em:
+ * - Padrões de pasta (glob)
+ * - Keywords no nome do arquivo
+ *
+ * Suporta múltiplos frameworks:
+ * - Next.js (App Router e Pages Router)
+ * - Vite (React, Vue)
+ * - Create React App
+ * - Remix
+ * - Nuxt
+ * - SvelteKit
+ * - Astro
+ */
+/**
+ * Padrões de pasta → área
+ * Ordem importa: mais específico primeiro
+ */
+declare const FOLDER_PATTERNS: Array<{
+    pattern: RegExp;
+    area: string;
+    priority: number;
+}>;
+/**
+ * Keywords no nome do arquivo → área
+ */
+declare const KEYWORD_PATTERNS: Array<{
+    keyword: RegExp;
+    area: string;
+    priority: number;
+}>;
+/**
+ * Nomes amigáveis das áreas
+ */
+declare const AREA_NAMES: Record<string, string>;
+/**
+ * Descrições padrão das áreas
+ */
+declare const AREA_DESCRIPTIONS: Record<string, string>;
+
 /**
  * ai-tool - Ferramenta de análise de dependências e impacto
  *
@@ -254,6 +501,6 @@ declare function invalidateCache(cwd: string): void;
  * ```
  */
 
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.4.0";
 
-export { type CommandOptions, type ContextOptions, type ContextResult, type DeadFile, type DeadOptions, type DeadResult, type FileCategory, type FileInfo, type FolderStats, type FunctionInfo, type ImpactFile, type ImpactOptions, type ImpactResult, type ImportInfo, type MapOptions, type MapResult, type OutputFormat, type ParamInfo, type RiskInfo, type SuggestOptions, type SuggestResult, type Suggestion, type SuggestionPriority, type TypeInfo, type TypeKind, VERSION, categoryIcons, context, dead, deadFix, detectCategory, getCacheDir, impact, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, map, suggest };
+export { AREA_DESCRIPTIONS, AREA_NAMES, type AreaConfig, type AreaDetailResult, type AreaFile, type AreaOptions, type AreasConfigFile, type AreasOptions, type AreasResult, type CommandOptions, type ContextOptions, type ContextResult, type DeadFile, type DeadOptions, type DeadResult, type DetectedArea, FOLDER_PATTERNS, type FileCategory, type FileInfo, type FolderStats, type FunctionInfo, type ImpactFile, type ImpactOptions, type ImpactResult, type ImportInfo, KEYWORD_PATTERNS, type MapOptions, type MapResult, type OutputFormat, type ParamInfo, type RiskInfo, type SuggestOptions, type SuggestResult, type Suggestion, type SuggestionPriority, type TypeInfo, type TypeKind, VERSION, area, areas, areasInit, categoryIcons, clearFirebaseCache, configExists, context, dead, deadFix, detectCategory, detectFileAreas, filterCloudFunctionsFalsePositives, getAreaDescription, getAreaName, getCacheDir, getFileDescription, hasFirebaseFunctions, impact, inferFileDescription, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, isExportedCloudFunction, isFirebaseProject, map, readConfig, removeArea, setArea, setFileDescription, suggest, writeConfig };

package/dist/index.js

@@ -1,32 +1,78 @@
 import {
+  AREA_DESCRIPTIONS,
+  AREA_NAMES,
+  FOLDER_PATTERNS,
+  KEYWORD_PATTERNS,
   VERSION,
+  area,
+  areas,
+  areasInit,
   categoryIcons,
+  clearFirebaseCache,
+  configExists,
   context,
   dead,
   deadFix,
   detectCategory,
+  detectFileAreas,
+  filterCloudFunctionsFalsePositives,
+  getAreaDescription,
+  getAreaName,
   getCacheDir,
+  getFileDescription,
+  hasFirebaseFunctions,
   impact,
+  inferFileDescription,
   invalidateCache,
   isCacheValid,
   isCodeFile,
   isEntryPoint,
+  isExportedCloudFunction,
+  isFirebaseProject,
   map,
-  suggest
-} from "./chunk-4HXWM7PK.js";
+  readConfig,
+  removeArea,
+  setArea,
+  setFileDescription,
+  suggest,
+  writeConfig
+} from "./chunk-33DHCY2H.js";
 export {
+  AREA_DESCRIPTIONS,
+  AREA_NAMES,
+  FOLDER_PATTERNS,
+  KEYWORD_PATTERNS,
   VERSION,
+  area,
+  areas,
+  areasInit,
   categoryIcons,
+  clearFirebaseCache,
+  configExists,
   context,
   dead,
   deadFix,
   detectCategory,
+  detectFileAreas,
+  filterCloudFunctionsFalsePositives,
+  getAreaDescription,
+  getAreaName,
   getCacheDir,
+  getFileDescription,
+  hasFirebaseFunctions,
   impact,
+  inferFileDescription,
   invalidateCache,
   isCacheValid,
   isCodeFile,
   isEntryPoint,
+  isExportedCloudFunction,
+  isFirebaseProject,
   map,
-  suggest
+  readConfig,
+  removeArea,
+  setArea,
+  setFileDescription,
+  suggest,
+  writeConfig
 };