@skip-ai/scanner 0.2.0

package/README.md

@@ -0,0 +1,81 @@
+# @skip-ai/scanner
+
+Scanner CLI da plataforma **Skip AI Accessibility Layer**.
+
+Em uma única linha, o scanner detecta o framework do projeto, extrai rotas,
+componentes, eventos e chamadas de API, mascara secrets e envia o relatório
+para a API web da Skip, aguardando o enriquecimento com IA.
+
+## Uso (npx)
+
+```bash
+npx @skip-ai/scanner --token=SEU_TOKEN_AQUI
+```
+
+Não requer instalação prévia — o `npx` baixa e executa na hora.
+
+## Opções
+
+| Flag | Descrição | Padrão |
+|------|-----------|--------|
+| `-t, --token <token>` | Token do projeto (obrigatório) | — |
+| `-u, --url <url>` | URL da plataforma Skip | `https://app.goskip.dev` |
+| `-d, --dir <dir>` | Diretório raiz do projeto | `process.cwd()` |
+| `-i, --ignore <patterns...>` | Padrões extras a ignorar (glob) | `[]` |
+| `--dry-run` | Apenas escaneia, sem enviar para a API | `false` |
+| `-v, --verbose` | Exibe o payload JSON no terminal | `false` |
+
+## Desenvolvimento
+
+```bash
+npm install
+npm run build     # gera dist/
+npm test          # roda os testes com vitest
+npm run dev       # executa via tsx (sem build)
+node dist/index.js --token=TEST --dir=./tests/fixtures/nextjs-app --dry-run --verbose
+```
+
+## Segurança
+
+Antes do envio, o scanner mascara automaticamente possíveis secrets
+(OpenAI/AWS/GitHub/Slack keys, JWTs, senhas em env). O payload é limitado
+a 5 MB (HTTP 413 caso exceda).
+
+## Mapa de navegação (núcleo do produto)
+
+O scanner não envia apenas um JSON — ele constrói um **mapa de navegação agrupado por tela**, onde cada tela tem suas próprias ações (botões, links e inputs), com seletor CSS e `anchorId` para o widget **emular o clique** e **preencher campos** em runtime.
+
+Além do mapa estruturado, o payload inclui:
+
+- **`briefing`**: resumo em linguagem natural das telas e ações, pronto para a IA interpretar intenções de voz (ex.: "quero ir pra configurações").
+- **`widgetSnippet`**: snippet JS que o widget carrega no site do cliente para auto-injetar `data-skip-anchor` nos elementos mapeados — funciona mesmo sem o desenvolvedor marcar nada.
+- **`navigationGraph`**: arestas de navegação (de → para) para a IA planejar caminhos entre telas, incluindo navegação global de sidebar/navbar.
+
+### Como o widget usa (exemplo)
+
+```jsonc
+// navigationMap.screens[rotaAtual].actions → só as ações da tela em que o usuário está
+{
+  "label": "Entrar", "kind": "submit",
+  "selector": "#btn-entrar", "anchorId": "btn-entrar"
+}
+```
+
+O widget clica via `document.querySelector('[data-skip-anchor=btn-entrar]').click()`.
+
+### Escape para navegação dinâmica
+
+Botões cuja navegação depende de runtime não são resolúveis estaticamente. Nestes casos, o desenvolvedor pode marcar manualmente:
+
+```tsx
+<button data-skip-action="navigate:/checkout">Finalizar</button>
+```
+
+O scanner lê esse atributo com prioridade.
+
+## Frameworks suportados
+
+- Next.js App Router (`src/app/**/page.tsx`)
+- Next.js Pages Router (`src/pages/**`)
+- Vite + React/Vue (componentes)
+- NestJS, Django, FastAPI (detecção)

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+export interface CliOptions {
+    token?: string;
+    url: string;
+    dir: string;
+    ignore: string[];
+    verbose: boolean;
+    dryRun: boolean;
+}
+export declare const DEFAULT_BASE_URL = "https://app.goskip.dev";
+export declare function parseCli(argv?: string[]): CliOptions;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAEzD,wBAAgB,QAAQ,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,UAAU,CAuBlE"}

package/dist/cli.js

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+export const DEFAULT_BASE_URL = 'https://app.goskip.dev';
+export function parseCli(argv = process.argv) {
+    const program = new Command()
+        .name('skip-scanner')
+        .description('Scanner de código para a plataforma Skip AI Accessibility Layer')
+        .option('-t, --token <token>', 'Token do projeto (obtido no Dashboard). Obrigatório salvo em --dry-run.')
+        .option('-u, --url <url>', 'URL da plataforma Skip', DEFAULT_BASE_URL)
+        .option('-d, --dir <dir>', 'Diretório raiz do projeto', process.cwd())
+        .option('-i, --ignore <patterns...>', 'Padrões a ignorar além do padrão', [])
+        .option('--dry-run', 'Executa o scan sem enviar para a plataforma', false)
+        .option('-v, --verbose', 'Exibir detalhes do scan no terminal', false)
+        .parse(argv);
+    const opts = program.opts();
+    // Token só é obrigatório fora do dry-run (no dry-run nada é enviado à API).
+    if (!opts.dryRun && !opts.token) {
+        program.error("erro: a opção '-t, --token <token>' é obrigatória (ou use --dry-run para testar sem enviar).", { exitCode: 1 });
+    }
+    return opts;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,MAAM,UAAU,QAAQ,CAAC,OAAiB,OAAO,CAAC,IAAI;IACpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,cAAc,CAAC;SACpB,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,qBAAqB,EAAE,yEAAyE,CAAC;SACxG,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,CAAC;SACrE,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACrE,MAAM,CAAC,4BAA4B,EAAE,kCAAkC,EAAE,EAAE,CAAC;SAC5E,MAAM,CAAC,WAAW,EAAE,6CAA6C,EAAE,KAAK,CAAC;SACzE,MAAM,CAAC,eAAe,EAAE,qCAAqC,EAAE,KAAK,CAAC;SACrE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAgB,CAAC;IAE1C,4EAA4E;IAC5E,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CACX,8FAA8F,EAC9F,EAAE,QAAQ,EAAE,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/detector.d.ts

@@ -0,0 +1,14 @@
+export type Framework = 'nextjs' | 'vite-react' | 'nestjs' | 'django' | 'fastapi' | 'unknown';
+export interface ProjectSignature {
+    framework: Framework;
+    language: 'TypeScript' | 'JavaScript' | 'Python';
+    hasAppRouter: boolean;
+    srcDir: string;
+    packageCount: number;
+}
+/**
+ * Detecta o framework e a linguagem do projeto a partir da raiz informada.
+ * Lê package.json e pyproject.toml quando existentes.
+ */
+export declare function detectProject(rootDir: string): ProjectSignature;
+//# sourceMappingURL=detector.d.ts.map

package/dist/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IACjD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAsE/D"}

package/dist/detector.js

@@ -0,0 +1,72 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Detecta o framework e a linguagem do projeto a partir da raiz informada.
+ * Lê package.json e pyproject.toml quando existentes.
+ */
+export function detectProject(rootDir) {
+    const pkgPath = path.join(rootDir, 'package.json');
+    const pyprojectPath = path.join(rootDir, 'pyproject.toml');
+    if (fs.existsSync(pkgPath)) {
+        let pkg = {};
+        try {
+            pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        }
+        catch {
+            pkg = {};
+        }
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (deps['next']) {
+            const hasAppDir = fs.existsSync(path.join(rootDir, 'src/app')) || fs.existsSync(path.join(rootDir, 'app'));
+            const srcDir = fs.existsSync(path.join(rootDir, 'src/app'))
+                ? 'src/app'
+                : fs.existsSync(path.join(rootDir, 'app'))
+                    ? 'app'
+                    : 'src/pages';
+            return {
+                framework: 'nextjs',
+                language: fs.existsSync(path.join(rootDir, 'tsconfig.json')) ? 'TypeScript' : 'JavaScript',
+                hasAppRouter: hasAppDir,
+                srcDir,
+                packageCount: Object.keys(deps).length,
+            };
+        }
+        if (deps['vite'] && (deps['react'] || deps['vue'])) {
+            return {
+                framework: 'vite-react',
+                language: fs.existsSync(path.join(rootDir, 'tsconfig.json')) ? 'TypeScript' : 'JavaScript',
+                hasAppRouter: false,
+                srcDir: 'src',
+                packageCount: Object.keys(deps).length,
+            };
+        }
+        if (deps['@nestjs/core']) {
+            return {
+                framework: 'nestjs',
+                language: fs.existsSync(path.join(rootDir, 'tsconfig.json')) ? 'TypeScript' : 'JavaScript',
+                hasAppRouter: false,
+                srcDir: 'src',
+                packageCount: Object.keys(deps).length,
+            };
+        }
+    }
+    if (fs.existsSync(pyprojectPath)) {
+        const content = fs.readFileSync(pyprojectPath, 'utf-8');
+        const framework = content.includes('fastapi') ? 'fastapi' : 'django';
+        return {
+            framework,
+            language: 'Python',
+            hasAppRouter: false,
+            srcDir: '.',
+            packageCount: 0,
+        };
+    }
+    return {
+        framework: 'unknown',
+        language: fs.existsSync(path.join(rootDir, 'tsconfig.json')) ? 'TypeScript' : 'JavaScript',
+        hasAppRouter: false,
+        srcDir: 'src',
+        packageCount: 0,
+    };
+}
+//# sourceMappingURL=detector.js.map

package/dist/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import path from 'path';
+import chalk from 'chalk';
+import { parseCli } from './cli.js';
+import { detectProject } from './detector.js';
+import { extractRoutes } from './scanner/routes.js';
+import { extractComponents } from './scanner/components.js';
+import { extractApiCalls } from './scanner/api-calls.js';
+import { extractNavigation } from './scanner/navigation.js';
+import { buildBriefing } from './scanner/briefing.js';
+import { buildWidgetSnippet } from './scanner/widget-snippet.js';
+import { buildReport, maskReportSecrets, CLI_VERSION } from './reporter.js';
+import { uploadReport, pollStatus } from './uploader.js';
+import { banner, spinner, printSummary, fail } from './ui.js';
+import { DEFAULT_IGNORE_PATTERNS } from './scanner/ignore.js';
+async function main() {
+    const opts = parseCli();
+    const rootDir = path.resolve(opts.dir);
+    console.log(banner(CLI_VERSION));
+    console.log(chalk.dim(`   Diretório: ${rootDir}`));
+    console.log(chalk.dim(`   Plataforma: ${opts.url}\n`));
+    const ignorePatterns = [...DEFAULT_IGNORE_PATTERNS, ...opts.ignore];
+    // 1. Detectar framework
+    const detectSpinner = spinner('Detectando projeto...');
+    const signature = detectProject(rootDir);
+    detectSpinner.succeed(`Framework detectado: ${chalk.cyan(signature.framework)} (${signature.language})`);
+    // 2. Extrair rotas (necessárias para mapear page.tsx -> rota lógica)
+    const routeSpinner = spinner('Extraindo rotas...');
+    const routes = await extractRoutes(rootDir, signature.srcDir, ignorePatterns);
+    routeSpinner.succeed(`${routes.length} rotas encontradas`);
+    // 3. Extrair componentes e eventos (inventário)
+    const compSpinner = spinner('Extraindo componentes e eventos...');
+    const { components, events } = await extractComponents(rootDir, opts.ignore);
+    compSpinner.succeed(`${components.length} componentes, ${events.length} eventos`);
+    // 4. Extrair chamadas de API
+    const apiSpinner = spinner('Extraindo chamadas de API...');
+    const apiCalls = await extractApiCalls(rootDir, opts.ignore);
+    apiSpinner.succeed(`${apiCalls.length} chamadas de API detectadas`);
+    // 5. Extrair mapa de navegação (telas, botões, links, inputs) — núcleo do produto
+    const navSpinner = spinner('Construindo mapa de navegação...');
+    const navigationMap = await extractNavigation(rootDir, opts.ignore, {
+        pagesRoutes: routes.map((r) => ({ physicalPath: r.physicalPath, logicalRoute: r.logicalRoute })),
+        srcDir: signature.srcDir,
+    });
+    const totalActions = navigationMap.screens.reduce((acc, s) => acc + s.actions.length, 0);
+    navSpinner.succeed(`${navigationMap.screens.length} telas mapeadas, ${totalActions} ações, ${navigationMap.navigationGraph.length} arestas de navegação`);
+    // 6. Gerar briefing em linguagem natural + snippet do widget
+    const briefing = buildBriefing(navigationMap);
+    const widgetSnippet = buildWidgetSnippet();
+    // 7. Contagem fiel de arquivos físicos lidos
+    const uniqueFiles = new Set([
+        ...routes.map((r) => r.physicalPath),
+        ...components.map((c) => c.filepath),
+        ...apiCalls.map((a) => a.filepath),
+        ...navigationMap.screens.map((s) => s.filePath),
+    ]);
+    const filesScanned = uniqueFiles.size;
+    // 8. Montar payload e mascarar secrets
+    const projectName = path.basename(rootDir);
+    const rawReport = buildReport({
+        signature,
+        routes,
+        components,
+        events,
+        apiCalls,
+        navigationMap,
+        widgetSnippet,
+        briefing,
+        filesScanned,
+        projectName,
+    });
+    const { report, secretsFound } = maskReportSecrets(rawReport);
+    if (secretsFound > 0) {
+        console.log(chalk.yellow(`⚠ ${secretsFound} possível(eis) secret(s) mascarado(s) antes do envio.`));
+    }
+    if (opts.verbose) {
+        console.log('\n' + chalk.dim('Briefing (resumo para IA):'));
+        console.log(chalk.dim(briefing));
+        console.log('\n' + chalk.dim('Navigation Map:'));
+        console.log(chalk.dim(JSON.stringify(report.navigationMap, null, 2)));
+    }
+    if (opts.dryRun) {
+        console.log(chalk.bold.cyan('\n🏃 Modo dry-run: pulando envio para a plataforma.\n'));
+        console.log(`   Arquivos escaneados: ${chalk.bold(filesScanned)}`);
+        console.log(`   Telas mapeadas:      ${chalk.bold(navigationMap.screens.length)}`);
+        console.log(`   Ações (botões/inputs): ${chalk.bold(totalActions)}`);
+        console.log(`   Arestas de navegação: ${chalk.bold(navigationMap.navigationGraph.length)}`);
+        console.log(`   Rotas:               ${chalk.bold(routes.length)}`);
+        console.log(`   Componentes:         ${chalk.bold(components.length)}`);
+        console.log(`   Eventos:             ${chalk.bold(events.length)}`);
+        console.log(`   Chamadas de API:     ${chalk.bold(apiCalls.length)}`);
+        console.log(`   Secrets mascarados:  ${chalk.bold(secretsFound)}\n`);
+        return;
+    }
+    // 9. Enviar para a plataforma
+    const uploadSpinner = spinner('Enviando para a plataforma Skip...');
+    const scanId = await uploadReport(report, opts.token, opts.url);
+    uploadSpinner.succeed(`Scan enviado! ID: ${chalk.yellow(scanId)}`);
+    // 10. Aguardar enriquecimento com IA
+    const status = await pollStatus(scanId, opts.token, opts.url);
+    printSummary({
+        scanId,
+        entitiesCount: status.entitiesCount,
+        baseUrl: opts.url,
+        status: status.status,
+    });
+    if (status.status !== 'COMPLETED')
+        process.exitCode = 1;
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(fail(`Erro: ${msg}\n`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/reporter.d.ts

@@ -0,0 +1,55 @@
+import type { ProjectSignature } from './detector.js';
+import type { RouteEntry } from './scanner/routes.js';
+import type { ComponentEntry, EventEntry } from './scanner/components.js';
+import type { ApiCallEntry } from './scanner/api-calls.js';
+import type { NavigationMap } from './scanner/navigation.js';
+export declare const CLI_VERSION = "0.2.0";
+export interface ScanMetadata {
+    framework: string;
+    language: string;
+    packageCount: number;
+    typescript: boolean;
+    scannedAt: string;
+    cliVersion: string;
+}
+export interface ScanReport {
+    projectName: string;
+    filesScanned: number;
+    routes: RouteEntry[];
+    components: ComponentEntry[];
+    events: EventEntry[];
+    apiCalls: ApiCallEntry[];
+    /** Mapa de navegação agrupado por tela — principal insumo para a IA e o widget. */
+    navigationMap: NavigationMap;
+    /** Snippet JS que o widget carrega em runtime para auto-injetar data-skip-anchor. */
+    widgetSnippet: string;
+    /** Resumo em linguagem natural das telas e ações (pronto para a IA ler). */
+    briefing: string;
+    secretsFound: number;
+    metadata: ScanMetadata;
+}
+export interface BuildReportInput {
+    signature: ProjectSignature;
+    routes: RouteEntry[];
+    components: ComponentEntry[];
+    events: EventEntry[];
+    apiCalls: ApiCallEntry[];
+    navigationMap: NavigationMap;
+    widgetSnippet: string;
+    briefing: string;
+    filesScanned: number;
+    projectName: string;
+}
+/**
+ * Monta o payload final (ScanReport) enviado para a API.
+ */
+export declare function buildReport(input: BuildReportInput): ScanReport;
+/**
+ * Aplica mascaramento de secrets ao relatório antes do envio.
+ * Retorna um novo relatório (com `secretsFound` preenchido) e a contagem.
+ */
+export declare function maskReportSecrets(report: ScanReport): {
+    report: ScanReport;
+    secretsFound: number;
+};
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,mFAAmF;IACnF,aAAa,EAAE,aAAa,CAAC;IAC7B,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAwB/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAGlG"}

package/dist/reporter.js

@@ -0,0 +1,38 @@
+import { maskObject } from './scanner/secrets.js';
+export const CLI_VERSION = '0.2.0';
+/**
+ * Monta o payload final (ScanReport) enviado para a API.
+ */
+export function buildReport(input) {
+    const { signature, routes, components, events, apiCalls, navigationMap, widgetSnippet, briefing, filesScanned, projectName } = input;
+    const report = {
+        projectName,
+        filesScanned,
+        routes,
+        components,
+        events,
+        apiCalls,
+        navigationMap,
+        widgetSnippet,
+        briefing,
+        secretsFound: 0,
+        metadata: {
+            framework: signature.framework,
+            language: signature.language,
+            packageCount: signature.packageCount,
+            typescript: signature.language === 'TypeScript',
+            scannedAt: new Date().toISOString(),
+            cliVersion: CLI_VERSION,
+        },
+    };
+    return report;
+}
+/**
+ * Aplica mascaramento de secrets ao relatório antes do envio.
+ * Retorna um novo relatório (com `secretsFound` preenchido) e a contagem.
+ */
+export function maskReportSecrets(report) {
+    const { result, count } = maskObject(report);
+    return { report: { ...result, secretsFound: count }, secretsFound: count };
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAyCnC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAErI,MAAM,MAAM,GAAe;QACzB,WAAW;QACX,YAAY;QACZ,MAAM;QACN,UAAU;QACV,MAAM;QACN,QAAQ;QACR,aAAa;QACb,aAAa;QACb,QAAQ;QACR,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE;YACR,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,UAAU,EAAE,SAAS,CAAC,QAAQ,KAAK,YAAY;YAC/C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE,WAAW;SACxB;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAC7E,CAAC"}

package/dist/scanner/api-calls.d.ts

@@ -0,0 +1,11 @@
+export interface ApiCallEntry {
+    method: string;
+    endpoint: string;
+    filepath: string;
+}
+/**
+ * Extrai chamadas de API (fetch / axios) dentro do projeto.
+ * Captura endpoints internos (/api/...) e externos (http/https).
+ */
+export declare function extractApiCalls(rootDir: string, ignorePatterns?: string[]): Promise<ApiCallEntry[]>;
+//# sourceMappingURL=api-calls.d.ts.map

package/dist/scanner/api-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-calls.d.ts","sourceRoot":"","sources":["../../src/scanner/api-calls.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC,CA0CzB"}

package/dist/scanner/api-calls.js

@@ -0,0 +1,45 @@
+import { glob } from 'glob';
+import fs from 'fs';
+import { DEFAULT_IGNORE_PATTERNS, toRelative } from './ignore.js';
+/**
+ * Extrai chamadas de API (fetch / axios) dentro do projeto.
+ * Captura endpoints internos (/api/...) e externos (http/https).
+ */
+export async function extractApiCalls(rootDir, ignorePatterns = []) {
+    const files = await glob('src/**/*.{ts,tsx,js,jsx}', {
+        cwd: rootDir,
+        absolute: true,
+        ignore: [...DEFAULT_IGNORE_PATTERNS, ...ignorePatterns],
+    });
+    const calls = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const relative = toRelative(rootDir, file);
+        // Padrão 1: fetch('/api/...', { method: 'POST' })
+        const fetchMatches = [
+            ...content.matchAll(/fetch\s*\(\s*['"`]([^'"`]+)['"`]\s*(?:,\s*\{[^}]*?method\s*:\s*['"`](\w+)['"`][^}]*?\})?/gs),
+        ];
+        for (const m of fetchMatches) {
+            const endpoint = m[1];
+            const method = m[2]?.toUpperCase() ?? 'GET';
+            if (endpoint.startsWith('/api') || endpoint.startsWith('http')) {
+                calls.push({ method, endpoint, filepath: relative });
+            }
+        }
+        // Padrão 2: axios.post('/api/...') — também cobre instâncias nomeadas (api.get, http.post)
+        const axiosMatches = [
+            ...content.matchAll(/(?:axios|(?:api|http|client|request))\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/g),
+        ];
+        for (const m of axiosMatches) {
+            calls.push({ method: m[1].toUpperCase(), endpoint: m[2], filepath: relative });
+        }
+    }
+    return calls;
+}
+//# sourceMappingURL=api-calls.js.map

package/dist/scanner/api-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-calls.js","sourceRoot":"","sources":["../../src/scanner/api-calls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQlE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,iBAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,0BAA0B,EAAE;QACnD,GAAG,EAAE,OAAO;QACZ,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,GAAG,uBAAuB,EAAE,GAAG,cAAc,CAAC;KACxD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAE3C,kDAAkD;QAClD,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO,CAAC,QAAQ,CACjB,4FAA4F,CAC7F;SACF,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;YAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,2FAA2F;QAC3F,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO,CAAC,QAAQ,CAAC,gGAAgG,CAAC;SACtH,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/scanner/briefing.d.ts

@@ -0,0 +1,7 @@
+import type { NavigationMap } from './navigation.js';
+/**
+ * Gera um briefing em linguagem natural do mapa de navegação,
+ * uma linha por tela. Pronto para a IA ler e entender sem parsing.
+ */
+export declare function buildBriefing(map: NavigationMap): string;
+//# sourceMappingURL=briefing.d.ts.map

package/dist/scanner/briefing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../../src/scanner/briefing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAiBvE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAwCxD"}

package/dist/scanner/briefing.js

@@ -0,0 +1,50 @@
+/** Descreve uma ação em linguagem natural curta. */
+function describeAction(a) {
+    switch (a.kind) {
+        case 'fill':
+            return `input '${a.label}' (${a.inputType ?? 'text'}${a.inputName ? `, name=${a.inputName}` : ''})`;
+        case 'navigation':
+            return `link '${a.label}' navega para ${a.targetRoute ?? '?'}`;
+        case 'submit':
+            return `botão '${a.label}' (submit)`;
+        case 'click':
+        default:
+            return `botão '${a.label}'`;
+    }
+}
+/**
+ * Gera um briefing em linguagem natural do mapa de navegação,
+ * uma linha por tela. Pronto para a IA ler e entender sem parsing.
+ */
+export function buildBriefing(map) {
+    if (map.screens.length === 0) {
+        return 'Nenhuma tela foi mapeada neste projeto.';
+    }
+    const lines = [];
+    // Cabeçalho com a visão geral de telas
+    const rotaTitulos = map.screens.map((s) => `'${s.title}' (${s.route})`).join(', ');
+    lines.push(`Projeto com ${map.screens.length} tela(s): ${rotaTitulos}.`);
+    lines.push('');
+    // Uma linha por tela descrevendo suas ações
+    for (const screen of map.screens) {
+        const parts = [];
+        for (const a of screen.actions) {
+            parts.push(describeAction(a));
+        }
+        // Navegação global disponível nesta tela
+        for (const g of screen.globalActions) {
+            parts.push(`menu '${g.label}' navega para ${g.targetRoute}`);
+        }
+        const acoesTxt = parts.length > 0 ? parts.join('; ') : 'sem ações mapeadas';
+        lines.push(`Tela ${screen.title} (${screen.route}): ${acoesTxt}.`);
+    }
+    // Avisos de baixa confidence (úteis para o dev corrigir)
+    const warnings = map.screens.flatMap((s) => s.actions.filter((a) => a.confidence === 'low' && a.warning).map((a) => `- ${s.route}: ${a.warning}`));
+    if (warnings.length > 0) {
+        lines.push('');
+        lines.push('Avisos de confiabilidade:');
+        lines.push(...warnings);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=briefing.js.map

package/dist/scanner/briefing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing.js","sourceRoot":"","sources":["../../src/scanner/briefing.ts"],"names":[],"mappings":"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"}

package/dist/scanner/components.d.ts

@@ -0,0 +1,24 @@
+export interface ComponentEntry {
+    name: string;
+    filepath: string;
+    props: string[];
+    events: string[];
+    hasForm: boolean;
+}
+export interface EventEntry {
+    type: string;
+    handler: string;
+    filepath: string;
+    elementTag: string;
+    elementId: string | null;
+}
+/**
+ * Extrai componentes React (TSX/JSX) com suas props e eventos,
+ * além dos eventos DOM vinculados a handlers no código.
+ * Inclui também layouts e componentes compartilhados (sidebar, navbar...).
+ */
+export declare function extractComponents(rootDir: string, ignorePatterns?: string[]): Promise<{
+    components: ComponentEntry[];
+    events: EventEntry[];
+}>;
+//# sourceMappingURL=components.d.ts.map

package/dist/scanner/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/scanner/components.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC;IAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAuEjE"}