@justmpm/ai-tool 0.3.2 → 0.4.2

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-EONUMGCN.js";
+} from "./chunk-WN7FTU6M.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-K55EXKYX.js");
+    const { startMcpServer } = await import("./server-SPVMWDEO.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

@@ -158,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
@@ -211,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;
 /**
@@ -280,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
  *
@@ -300,6 +501,6 @@ declare function invalidateCache(cwd: string): void;
  * ```
  */
 
-declare const VERSION = "0.3.2";
+declare const VERSION: string;
 
-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, clearFirebaseCache, context, dead, deadFix, detectCategory, filterCloudFunctionsFalsePositives, getCacheDir, hasFirebaseFunctions, impact, invalidateCache, isCacheValid, isCodeFile, isEntryPoint, isExportedCloudFunction, isFirebaseProject, 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,15 +1,28 @@
 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,
@@ -17,20 +30,38 @@ import {
   isExportedCloudFunction,
   isFirebaseProject,
   map,
-  suggest
-} from "./chunk-EONUMGCN.js";
+  readConfig,
+  removeArea,
+  setArea,
+  setFileDescription,
+  suggest,
+  writeConfig
+} from "./chunk-WN7FTU6M.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,
@@ -38,5 +69,10 @@ export {
   isExportedCloudFunction,
   isFirebaseProject,
   map,
-  suggest
+  readConfig,
+  removeArea,
+  setArea,
+  setFileDescription,
+  suggest,
+  writeConfig
 };

package/dist/{server-K55EXKYX.js → server-SPVMWDEO.js}

@@ -1,11 +1,14 @@
 import {
   VERSION,
+  area,
+  areas,
+  areasInit,
   context,
   dead,
   impact,
   map,
   suggest
-} from "./chunk-EONUMGCN.js";
+} from "./chunk-WN7FTU6M.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -333,6 +336,248 @@ Eficiente: retorna apenas assinaturas, nao o codigo completo.`,
     }
   }
 );
+server.registerTool(
+  "aitool_list_areas",
+  {
+    title: "List Project Areas",
+    description: `Lista todas as areas/dominios funcionais do projeto.
+
+IMPORTANTE - AREAS vs CATEGORIAS:
+- CATEGORIA = tipo tecnico (hook, component, page, service...)
+  \u2192 Use aitool_project_map para ver categorias
+- AREA = dominio funcional (auth, meus-pets, stripe, dashboard...)
+  \u2192 Use ESTA tool para ver areas
+  \u2192 Use aitool_area_detail para ver arquivos de uma area especifica
+
+Um arquivo pode pertencer a MULTIPLAS areas!
+
+FUNCIONALIDADES:
+- Detecta areas automaticamente baseado em padroes de pasta e keywords
+- Agrupa arquivos por dominio funcional
+- Mostra distribuicao de categorias por area
+- Identifica arquivos sem area definida
+
+PARAMETROS:
+- format: "text" (legivel) ou "json" (estruturado)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+RETORNA:
+- Lista de areas com nome, descricao e contagem
+- Distribuicao de categorias por area
+- Lista de arquivos sem area (para configurar manualmente)
+
+EXEMPLO DE USO:
+Chamar no inicio da sessao para entender os dominios do projeto.
+Usar antes de trabalhar em uma feature especifica.
+
+CONFIGURACAO MANUAL:
+Se houver arquivos sem area ou areas incorretas, use aitool_areas_init
+para gerar .analyze/areas.config.json e edite manualmente.`,
+    inputSchema: {
+      format: z.enum(["text", "json"]).default("text").describe("Formato de saida: text (legivel) ou json (estruturado)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "List Project Areas",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await areas({
+        format: params.format,
+        cwd: params.cwd
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar areas: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_area_detail",
+  {
+    title: "Area Detail",
+    description: `Mostra todos os arquivos de uma area/dominio especifica.
+
+USE ESTA TOOL QUANDO:
+- Usuario pedir para trabalhar em uma feature (ex: "vou mexer em auth")
+- Precisar listar todos os arquivos de um dominio
+- Quiser ver apenas hooks, components, etc de uma area especifica
+
+FUNCIONALIDADES:
+- Lista arquivos agrupados por categoria (page, component, hook...)
+- Mostra descricao de cada arquivo (inferida ou manual)
+- Permite filtrar por categoria especifica (type="hook")
+- Mostra resumo de distribuicao
+
+PARAMETROS:
+- target: Nome da area (OBRIGATORIO - ex: "meus-pets", "auth", "stripe")
+- type: Filtrar por categoria (opcional - ex: "hook", "component")
+- full: Mostrar todos os arquivos (default: false = resumido)
+- cwd: Diretorio do projeto
+
+RETORNA:
+- Nome e descricao da area
+- Lista de arquivos por categoria
+- Descricao de cada arquivo
+
+EXEMPLOS DE USO:
+- Ver tudo de auth: target="auth"
+- Ver apenas hooks de auth: target="auth", type="hook"
+- Ver todos os arquivos de stripe: target="stripe", full=true
+
+DICA: Use aitool_list_areas primeiro para ver quais areas existem.`,
+    inputSchema: {
+      target: z.string().min(1).describe("Nome da area: meus-pets, auth, stripe, etc"),
+      type: z.enum([
+        "page",
+        "layout",
+        "route",
+        "component",
+        "hook",
+        "service",
+        "store",
+        "util",
+        "type",
+        "config",
+        "test",
+        "other"
+      ]).optional().describe("Filtrar por categoria especifica"),
+      full: z.boolean().default(false).describe("Mostrar todos os arquivos (default: resumido)"),
+      cwd: z.string().optional().describe("Diretorio do projeto a analisar")
+    },
+    annotations: {
+      title: "Area Detail",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await area(params.target, {
+        type: params.type,
+        full: params.full,
+        cwd: params.cwd,
+        format: "text"
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar area: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
+server.registerTool(
+  "aitool_areas_init",
+  {
+    title: "Initialize Areas Config",
+    description: `Gera arquivo de configuracao de areas (.analyze/areas.config.json).
+
+QUANDO USAR:
+- Quando aitool_list_areas mostrar arquivos sem area definida
+- Quando precisar personalizar deteccao de areas
+- Quando quiser adicionar areas que nao sao detectadas automaticamente
+
+O QUE FAZ:
+- Escaneia o projeto e detecta areas automaticamente
+- Infere patterns glob para cada area detectada
+- Gera arquivo editavel em .analyze/areas.config.json
+- NAO sobrescreve config existente (use force=true para sobrescrever)
+
+PARAMETROS:
+- force: Sobrescrever config existente (default: false)
+- cwd: Diretorio do projeto (default: diretorio atual)
+
+RETORNA:
+- Confirmacao do arquivo criado
+- Lista de areas detectadas com contagem
+- Arquivos sem area (para configurar manualmente)
+- Instrucoes de como editar o arquivo
+
+ESTRUTURA DO ARQUIVO GERADO:
+{
+  "areas": {
+    "auth": {
+      "name": "Autenticacao",
+      "description": "Sistema de login e sessao",
+      "patterns": ["components/auth/**", "hooks/useAuth.ts"],
+      "keywords": ["auth", "login", "session"]
+    }
+  },
+  "descriptions": {
+    "components/pets/PetForm.tsx": "Formulario multi-step de pets"
+  },
+  "settings": {
+    "autoDetect": true,
+    "inferDescriptions": true
+  }
+}
+
+COMO EDITAR MANUALMENTE:
+1. Adicionar areas nao detectadas: adicione entrada em "areas"
+2. Renomear areas: altere "name" da area
+3. Ajustar deteccao: modifique "patterns" e "keywords"
+4. Excluir arquivos: adicione "exclude" com patterns
+5. Descrever arquivos: adicione entrada em "descriptions"
+
+EXEMPLO DE USO:
+1. Rode aitool_list_areas para ver areas atuais
+2. Se houver arquivos sem area, rode aitool_areas_init
+3. Edite .analyze/areas.config.json conforme necessario
+4. Rode aitool_list_areas novamente para ver mudancas`,
+    inputSchema: {
+      force: z.boolean().default(false).describe("Sobrescrever config existente"),
+      cwd: z.string().optional().describe("Diretorio do projeto")
+    },
+    annotations: {
+      title: "Initialize Areas Config",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
+    }
+  },
+  async (params) => {
+    try {
+      const result = await areasInit({
+        force: params.force,
+        cwd: params.cwd
+      });
+      return { content: [{ type: "text", text: result }] };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Erro ao executar areas init: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+);
 async function startMcpServer() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justmpm/ai-tool",
-  "version": "0.3.2",
+  "version": "0.4.2",
   "description": "Ferramenta de análise de dependências e impacto para projetos TypeScript/JavaScript. Usa Skott + Knip internamente.",
   "keywords": [
     "dependency-analysis",
@@ -45,6 +45,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
     "knip": "^5.44.0",
+    "minimatch": "^10.0.1",
     "skott": "^0.35.2",
     "ts-morph": "^27.0.2",
     "zod": "^3.25.76"