@mocoto/mahoraga 0.14.6 → 0.14.8

package/README.md

@@ -1,135 +1,153 @@
 ---
-Proveniência e Autoria: Este documento integra o projeto Mahoraga (licença MIT-0).
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
 ---
 
 <div align="center">
 
-<p><b>CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript com suporte multi-linguagem</b><p>
+<p><b>@mocoto/mahoraga</b>: CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript com suporte multi-linguagem<p>
 
 </div>
 
-<p> Desisti de desistir do projeto, até parece que vou aceitar perder pra vocês ...</p>
-
-<p> caso tenha interesse em ajudar no projeto o E-mail é esse ai em baixo o **lint que me aguarde 😜 </p>
+Caso tenha receio em ajudar com codigo você pode me ajudar ao usar e encontrar falsos postivos/negativos e me mandar relatorios por meio desse e-mail ai em baixo, me ajudaria muito, pois nem todos os erros e bugs eu consigo resolver em ambiente de desenvolvimento sendo preciso uso em produção para serem encontrados
 
 [Gmail](mailto:mocoto.persona@gmail.com)
 
-<h5> Alias!! ignora o sugestoes-00*.json ainda esta em ajustes.</h5>
+---
 
 ## Começar Rápido (30 segundos)
 
 ```bash
-# 1. Instalar
+# 1. Instalar globalmente
 npm install -g @mocoto/mahoraga
 
 # 2. Analisar seu projeto
 cd meu-projeto
 mahoraga diagnosticar
 
-# 3. Ver problemas críticos
-mahoraga diagnosticar --gravidade critic
-
-# 4. Exportar relatório
-mahoraga diagnosticar --relatorio json --saida relatorio.json
-```
-
-**Próximos passos imediatos:**
-
-```bash
-# Revisar correções disponíveis
-mahoraga corrigir --revisar
-
-# Aplicar correções automáticas seguras
-mahoraga corrigir --auto
-
-# Estabelecer baseline de saúde (assinatura GPG)
-mahoraga guardian --accept-baseline
+# 3. Ver análise completa
+mahoraga diagnosticar --full
 
-# Verificar mudanças
-mahoraga guardian
+# 4. Exportar relatório em JSON
+mahoraga diagnosticar --json > relatorio.json
 ```
 
 ---
 
-## Fluxo Passo a Passo
-
-O Mahoraga foi projetado para guiar você por um fluxo completo de análise e manutenção do seu projeto:
+## Comandos da CLI
 
-### Passo 1: Diagnóstico Inicial
+### Comandos Principais
 
-Analise todo o projeto para identificar problemas de qualidade, segurança e arquitetura:
+| Comando | Descrição | Exemplo |
+|---------|-----------|---------|
+| `diagnosticar` (ou `diag`) | Análise completa do projeto | `mahoraga diagnosticar --full` |
+| `guardian` | Monitoramento de integridade com GPG | `mahoraga guardian --accept-baseline` |
+| `fix-types` | Corrigir tipos inseguros (`any`/`unknown`) | `mahoraga fix-types --target src` |
+| `formatar` | Formatação automática de código | `mahoraga formatar --write` |
+| `podar` | Remover arquivos órfãos e código morto | `mahoraga podar` |
+| `names` | Extração e renomeação em massa de variáveis | `mahoraga names --scan` |
+| `imports` | Gerenciar aliases de import (`@/`) | `mahoraga imports --scan` |
+| `barrels` | Gerenciar barrels (`index.ts`) | `mahoraga barrels --generate` |
+| `analistas` | Listar analistas e detectores disponíveis | `mahoraga analistas --json` |
+| `metricas` | Ver métricas de execução | `mahoraga metricas --analistas` |
+| `perf` | Snapshots e comparação de performance | `mahoraga perf baseline` |
+| `atualizar` | Auto-update do Mahoraga | `mahoraga atualizar --global` |
+| `convert` (ou `conv`) | Converter CI/CD templates | `mahoraga convert --from github --to gitlab` |
+| `reverter` | Reverter movimentações de arquivos | `mahoraga reverter listar` |
+| `compliance` | Relatórios de compliance | `mahoraga compliance report iso-27001` |
+
+### Diagnóstico
 
 ```bash
-# Análise completa
-mahoraga diagnosticar
-
-# Mais detalhes
-mahoraga diagnosticar --verbose
-
-# Apenas críticos
-mahoraga diagnosticar --gravidade critic
-
-# Exportar resultados
-mahoraga diagnosticar --relatorio json --saida analise.json
-mahoraga diagnosticar --relatorio markdown --saida RELATORIO.md
+mahoraga diagnosticar                      # análise padrão
+mahoraga diagnosticar --full               # análise completa
+mahoraga diagnosticar --fast               # modo rápido
+mahoraga diagnosticar --compact            # saída compacta
+mahoraga diagnosticar --json               # saída JSON
+mahoraga diagnosticar --detalhado          # saída detalhada
+mahoraga diagnosticar --executive          # relatório executivo
+mahoraga diagnosticar --monorepo           # análise de monorepo
+mahoraga diagnosticar --guardian-check     # verificar Guardian junto
+mahoraga diagnosticar --stream             # streaming para projetos grandes
+mahoraga diagnosticar --verbose            # log detalhado
+mahoraga diagnosticar --debug              # modo debug
+mahoraga diagnosticar --include "src/**" --exclude "**/*.test.ts"
+mahoraga diagnosticar --path ./frontend --path ./backend
+mahoraga diagnosticar --auto-fix           # corrigir automaticamente
 ```
 
-### Passo 2: Estabelecer Baseline
+### Guardian (Integridade com GPG)
 
-Crie um baseline criptográfico com assinaturas GPG do projeto para monitorar mudanças:
+O Guardian utiliza **assinatura GPG (Ed25519)** em vez de hashes convencionais para garantir a integridade dos arquivos.
 
 ```bash
-mahoraga guardian --accept-baseline
+mahoraga guardian                      # verificar integridade
+mahoraga guardian --accept-baseline    # aceitar estado atual como baseline
+mahoraga guardian --diff               # mostrar diferenças
+mahoraga guardian --full-scan          # scan completo
+mahoraga guardian --json               # saída JSON estruturada
 ```
 
-### Passo 3: Corrigir Problemas
-
-Aplique correções automáticas com segurança:
+### CI/CD
 
 ```bash
-# Revisar o que pode ser corrigido
-mahoraga corrigir
-
-# Aplicar correções automáticas
-mahoraga corrigir --auto
-
-# Corrigir tipos inseguros
-mahoraga fix-types --auto
+mahoraga github-actions scan           # GitHub Actions
+mahoraga github-actions gate --threshold 80  # quality gate
+mahoraga github-actions app --port 3000      # servidor GitHub App
+mahoraga gitlab-ci scan                # GitLab CI
+mahoraga circleci scan                 # CircleCI
+mahoraga jenkins scan                  # Jenkins
+mahoraga azure scan                    # Azure Pipelines
+mahoraga convert --from github --to gitlab   # converter templates
 ```
 
-### Passo 4: Organizar com Sugestões e Barrels
-
-Revise sugestões estruturais e organize os barrels do projeto:
+### Licenças e Compliance
 
 ```bash
-# Ver sugestões de reorganização (apenas sugestões, sem modificações)
-mahoraga diagnosticar --export --export-to ./sugestoes
+mahoraga licencas scan                 # scan de dependências
+mahoraga licencas notices generate     # gerar THIRD-PARTY-NOTICES
+mahoraga licencas disclaimer add       # adicionar disclaimer
+mahoraga licencas disclaimer verify    # verificar disclaimers
+mahoraga compliance report iso-27001   # relatório ISO 27001
+mahoraga compliance report soc2 --json # relatório SOC 2
+```
 
-# Gerar barrels estruturados (index.ts)
-mahoraga barrels --scan          # preview do que será criado
-mahoraga barrels --generate      # criar/atualizar barrels
+### Manutenção
 
-# Remover arquivos órfãos
-mahoraga podar
+```bash
+mahoraga fix-types --target src        # corrigir tipos inseguros
+mahoraga fix-types --dry-run           # simular correção
+mahoraga fix-types --interactive       # modo interativo
+mahoraga formatar --write              # formatar código
+mahoraga formatar --check              # apenas verificar
+mahoraga podar                         # remover arquivos órfãos
+mahoraga names --scan                  # extrair nomes de variáveis
+mahoraga names --apply                 # aplicar renomeações
+mahoraga reverter listar               # listar reversões disponíveis
+mahoraga reverter move <id>            # reverter movimento específico
 ```
 
-### Passo 5: Monitoramento Contínuo
-
-Mantenha a saúde do projeto ao longo do tempo:
+### Plugins e Marketplace
 
 ```bash
-# Verificar integridade contra baseline
-mahoraga guardian
-
-# Mostrar diferenças detalhadas
-mahoraga guardian --diff
+mahoraga plugins list                  # listar plugins instalados
+mahoraga plugins install <pacote>      # instalar plugin
+mahoraga plugins remove <pacote>       # remover plugin
+mahoraga marketplace search <termo>    # buscar analistas
+mahoraga marketplace install <nome>    # instalar do marketplace
+mahoraga marketplace list              # listar instalados
+```
 
-# Comparar performance
-mahoraga perf snapshot --baseline
-mahoraga perf compare
+### Utilitários
 
-# Ver histórico de métricas
-mahoraga metricas
+```bash
+mahoraga otimizar-svg --write          # otimizar SVGs
+mahoraga imports --scan                # escanear aliases de import
+mahoraga imports --apply               # aplicar correções de import
+mahoraga barrels --scan                # preview de barrels
+mahoraga barrels --generate            # gerar barrels
+mahoraga metricas --json               # métricas em JSON
+mahoraga vulnerabilidades scan         # scan de vulnerabilidades
+mahoraga atualizar --global            # auto-update
 ```
 
 ---
@@ -138,48 +156,41 @@ mahoraga metricas
 
 ### Análise Inteligente
 
-- **Diagnóstico completo** — qualidade, segurança e arquitetura
-- **15+ detectores especializados** — código frágil, duplicação, complexidade, performance, vazamentos de memória, tipos inseguros
-- **18+ plugins multi-linguagem** — React, CSS, HTML, Python, Shell, SQL, Tailwind, XML, SVG
-- **Detecção de bugs via ML** — 8 padrões com pontuação Bayesiana (v0.10.0)
-- **Registro inteligente** — descoberta automática de analistas built-in e customizados
-- **Análise de monorepos** — pnpm-workspace, lerna, nx, turbo (v0.10.0)
+- **Diagnóstico completo**: qualidade, segurança e arquitetura
+- **15+ detectores especializados**: código frágil, duplicação, complexidade, performance, vazamentos de memória, tipos inseguros
+- **18+ plugins multi-linguagem**: React, CSS, HTML, Python, Shell, SQL, Tailwind, XML, SVG
+- **Detecção de bugs via ML**: 8 padrões com pontuação Bayesiana
+- **Registro inteligente**: descoberta automática de analistas built-in e customizados
+- **Análise de monorepos**: pnpm-workspace, lerna, nx, turbo
 
 ### Manutenção Assistida
 
-- **Auto-fix seguro** — correções automáticas com validação (`corrigir`)
-- **Guardian** — monitoramento contínuo com assinatura GPG, baselines criptográficos e verificação de integridade
-- **Reestruturação** — reorganização automática seguindo padrões arquiteturais
-- **Poda inteligente** — identificação e remoção de arquivos órfãos e código morto
-- **Fix Types** — correção automática de `any` e `unknown`
-- **Formatação** — formatação automática do código
-- **Names/Rename** — extração e renomeação em massa de variáveis
-- **Reverter** — rollback de movimentações aplicadas
+- **Guardian**: monitoramento contínuo com assinatura GPG (Ed25519), baselines criptográficos e verificação de integridade
+- **Fix Types**: correção automática de `any` e `unknown`
+- **Poda inteligente**: identificação e remoção de arquivos órfãos e código morto
+- **Formatação**: formatação automática do código
+- **Names/Rename**: extração e renomeação em massa de variáveis
+- **Reverter**: rollback de movimentações aplicadas
+- **Imports**: gerenciamento de aliases de import
 
 ### Relatórios Profissionais
 
-- **Múltiplos formatos** — JSON, Markdown, HTML, CSV com sharded export
-- **Métricas detalhadas** — complexidade ciclomática, duplicação, cobertura, performance com histórico
-- **Baseline de performance** — snapshots e comparação ao longo do tempo
-- **Scan de licenças** — verificação de dependências e geração de THIRD-PARTY-NOTICES
-- **Relatórios de compliance** — ISO 27001, SOC 2
-- **Streaming** — NDJSON sharded com gzip para projetos grandes (v0.10.0)
+- **Métricas detalhadas**: complexidade ciclomática, duplicação, cobertura, performance com histórico
+- **Baseline de performance**: snapshots e comparação ao longo do tempo
+- **Scan de licenças**: verificação de dependências e geração de THIRD-PARTY-NOTICES
+- **Relatórios de compliance**: ISO 27001, SOC 2
+- **Streaming**: NDJSON para projetos grandes
 
-### Extensível
+### Integrações CI/CD
 
-- **Plugin system** — crie analistas customizados com autodiscovery
-- **API modular** — use como biblioteca (`mahoraga/sdk`)
-- **REST API** — servidor HTTP com Swagger UI
-- **Worker pool** — processamento paralelo para projetos grandes
-- **Marketplace** — analistas comunitários
+- **GitLab CI / CircleCI / Jenkins / Azure Pipelines**: análise de pipelines
+- **Conversão** entre plataformas de CI/CD
 
-### Integrações
+### Extensível
 
-- **GitHub App** — análise automática de workflows em PRs e pushes
-- **GitHub Actions** — scan de workflows, score 0-100, check runs
-- **GitLab CI / CircleCI / Jenkins / Azure Pipelines** — análise de pipelines
-- **LSP** — diagnóstico em tempo real para editores
-- **VSCode Extension** — análise ao salvar/abrir arquivos
+- **Plugin system**: crie analistas customizados com autodiscovery
+- **API modular**: use como biblioteca (`@mocoto/mahoraga`)
+- **Marketplace**: analistas comunitários
 
 ---
 
@@ -199,27 +210,19 @@ npm install --save-dev @mocoto/mahoraga
 npx mahoraga --help
 ```
 
-
-### Docker
-
-```bash
-docker build -t mahoraga .
-docker run --rm -v $(pwd):/project mahoraga diagnosticar
-```
-
 ### Verificar Instalação
 
 ```bash
-mahoraga --version       # v0.10.2
-mahoraga --help          # lista todos os comandos
-mahoraga analistas --listar  # analistas disponíveis
+mahoraga --version                    # v0.14.6
+mahoraga --help                       # lista todos os comandos
+mahoraga analistas --json             # analistas disponíveis
 ```
 
 ---
 
 ## Configuração
 
-O Mahoraga lê um arquivo `mahoraga.config.json` na raiz do seu projeto. Se não existir, usa configurações padrão sensatas.
+O Mahoraga lê um arquivo `mahoraga.config.json` na raiz do seu projeto (ou variáveis de ambiente).
 
 ### Configuração Mínima
 
@@ -237,427 +240,80 @@ O Mahoraga lê um arquivo `mahoraga.config.json` na raiz do seu projeto. Se não
 }
 ```
 
-### Blocos Principais
-
-| Bloco | Descrição |
-|-------|-----------|
-| `locale` | Idioma (`pt`, `en`, `zh`, `ja`) |
-| `verbose` | Saída detalhada |
-| `logLevel` | Nível de log (`debug`, `info`, `warn`, `error`) |
-| `safeMode` | Modo seguro (sem operações destrutivas) |
-| `exclude` | Glob patterns para exclusão |
-| `INCLUDE_EXCLUDE_RULES` | Regras globais de inclusão/exclusão |
-| `languageSupport` | Configuração por linguagem |
-| `rules` | Customização de severidade por regra |
-| `suppress` | Supressão de avisos por regra/caminho |
-| `testPatterns` | Padrões para detecção de testes |
-| `analystsExclude` | Analistas a desabilitar |
-| `GUARDIAN_*` | Configurações do Guardian (assinatura GPG) |
-| `REPORT_*` | Configurações de relatórios |
-| `WORKER_POOL_*` | Pool de workers paralelos |
-| `PLUGINS` | Sistema de plugins |
-| `CACHE_STRATEGY` | Estratégia de cache |
-
 ### Variáveis de Ambiente
 
 | Variável | Descrição | Padrão |
 |----------|-----------|--------|
-| `SUKUNA_API_PORT` | Porta da API | `3100` |
-| `SUKUNA_API_CORS_ORIGINS` | Origens CORS | `localhost: 00` |
 | `LOG_LEVEL` | Nível de log | `info` |
 | `LOG_ESTRUTURADO` | Logs em JSON | `false` |
-| `SUKUNA_DEBUG` | Modo debug | — |
-| `GITHUB_APP_ID` | ID do GitHub App | — |
-| `GITHUB_PRIVATE_KEY` | Chave RSA do GitHub App | — |
-| `GITHUB_WEBHOOK_SECRET` | Webhook secret | — |
-
-> [BOOK] [Guia de Configuração Completo →](./docs/guias/GUIA-CONFIGURACAO.md)
-
----
-
-## Comandos da CLI
-
-### Comandos Principais
-
-| Comando | Descrição | Exemplo |
-|---------|-----------|---------|
-| `diagnosticar` | Análise completa do projeto | `mahoraga diagnosticar --verbose` |
-| `corrigir` | Auto-fix com validação | `mahoraga corrigir --auto` |
-| `guardian` | Monitoramento contínuo | `mahoraga guardian --baseline` |
-| `reestruturar` | Reorganizar estrutura do código | `mahoraga reestruturar --auto` |
-| `podar` | Remover código morto | `mahoraga podar` |
-| `fix-types` | Corrigir tipos inseguros | `mahoraga fix-types --auto` |
-| `formatar` | Formatação automática | `mahoraga formatar --write` |
-| `analistas` | Listar analistas | `mahoraga analistas --listar` |
-
-### Diagnóstico Avançado
-
-```bash
-mahoraga diagnosticar --full               # análise completa
-mahoraga diagnosticar --fast               # modo rápido
-mahoraga diagnosticar --compact            # saída compacta
-mahoraga diagnosticar --json               # saída JSON
-mahoraga diagnosticar --stream             # streaming para projetos grandes
-mahoraga diagnosticar --executive          # relatório executivo
-mahoraga diagnosticar --monorepo           # análise de monorepo
-mahoraga diagnosticar --guardian-check     # verificar Guardian
-mahoraga diagnosticar --include "src/**"   # incluir padrão
-mahoraga diagnosticar --exclude "**/*.test.ts"  # excluir padrão
-mahoraga diagnosticar --path ./frontend --path ./backend  # múltiplos diretórios
-```
-
-### Correção e Manutenção
-
-```bash
-mahoraga corrigir --revisar        # revisar antes de aplicar
-mahoraga corrigir --auto           # aplicar automaticamente
-mahoraga corrigir --tipo variavel-nao-usada  # tipo específico
-mahoraga fix-types --dry-run       # simular correção
-mahoraga fix-types --target src    # diretório alvo
-```
-
-### Guardian (Monitoramento com GPG)
-
-O Guardian utiliza **assinatura GPG** (Ed25519) em vez de hashes convencionais para garantir a integridade dos arquivos. Cada baseline armazena assinaturas criptográficas individuais, permitindo autenticação e não-repúdio.
-
-```bash
-mahoraga guardian                   # verificar integridade
-mahoraga guardian --accept-baseline # aceitar estado atual como baseline
-mahoraga guardian --diff            # mostrar diferenças
-mahoraga guardian --full-scan       # scan completo sem ignorar padrões
-mahoraga guardian --json            # saída JSON estruturada
-```
-
-**Como funciona:**
-1. **Chaves** — um par de chaves GPG (Ed25519) é gerado automaticamente em `.mahoraga/`
-2. **Baseline** — cada arquivo é assinado com a chave privada; a assinatura é armazenada no baseline
-3. **Verificação** — a assinatura armazenada é verificada contra o conteúdo atual usando a chave pública
-4. **Drift** — arquivos adicionados, removidos ou com assinatura inválida são detectados
-
-> As chaves GPG ficam em `.mahoraga/` e são automaticamente excluídas do versionamento (`.gitignore`).
-
-### Nomes e Renomeação
-
-```bash
-mahoraga names                     # extrair nomes de variáveis
-mahoraga rename --apply            # aplicar renomeações
-mahoraga reverter listar           # listar reversões
-mahoraga reverter move <id>        # reverter movimento específico
-```
-
-### Licenças e Compliance
-
-```bash
-mahoraga licencas scan                          # scan de licenças
-mahoraga licencas notices generate              # gerar THIRD-PARTY-NOTICES
-mahoraga licencas disclaimer add                # adicionar disclaimer
-mahoraga licencas disclaimer verify             # verificar disclaimers
-mahoraga compliance report iso-27001            # relatório ISO 27001
-mahoraga compliance report soc2 --json          # relatório SOC 2
-```
-
-### CI/CD
-
-```bash
-mahoraga github-actions scan                    # scan de workflows
-mahoraga github-actions report --format html    # relatório HTML
-mahoraga github-actions gate --threshold 80     # quality gate
-mahoraga gitlab-ci scan                         # scan GitLab CI
-mahoraga circleci scan                          # scan CircleCI
-mahoraga jenkins scan                           # scan Jenkins
-mahoraga azure scan                             # scan Azure Pipelines
-```
-
-### Métricas e Performance
-
-```bash
-mahoraga metricas                               # histórico de métricas
-mahoraga metricas --analistas                   # métricas por analista
-mahoraga perf snapshot --baseline               # baseline de performance
-mahoraga perf compare                           # comparar performance
-```
-
-### Utilitários
-
-```bash
-mahoraga otimizar-svg --write                   # otimizar SVGs
-mahoraga atualizar                              # atualizar Mahoraga
-mahoraga plugins list                           # listar plugins
-mahoraga marketplace search                     # buscar analistas
-mahoraga vulnerabilidades scan                  # scan de vulnerabilidades
-mahoraga formatters list                        # listar formatadores
-mahoraga lsp                                    # iniciar servidor LSP
-mahoraga serve --port 3100                      # iniciar REST API
-mahoraga convert                                # converter projeto
-mahoraga imports --scan                         # gerenciar imports
-```
-
-> [BOOK] [Guia de Comandos Completo →](./docs/guias/GUIA-COMANDOS.md)
-
----
-
-## REST API
-
-O Mahoraga pode ser executado como um servidor HTTP RESTful para integração com outras ferramentas.
-
-```bash
-# Iniciar servidor
-mahoraga serve --port 3100
-```
-
-**Base URL:** `http://localhost:3100/api/v1`
-**Swagger UI:** `http://localhost:3100/api/docs`
-
-### Endpoints
-
-| Endpoint | Método | Descrição |
-|----------|--------|-----------|
-| `/api/health` | GET | Health check |
-| `/api/v1/analistas` | GET | Listar analistas |
-| `/api/v1/analistas/stats` | GET | Estatísticas |
-| `/api/v1/diagnosticar` | POST | Executar diagnóstico |
-| `/api/v1/diagnosticar/jobs` | GET | Listar jobs |
-| `/api/v1/diagnosticar/jobs/:id` | GET | Status do job |
-| `/api/v1/guardian` | GET | Status do Guardian |
-| `/api/v1/guardian/baseline` | POST | Criar baseline |
-| `/api/v1/guardian/diff` | GET | Comparar baseline |
-| `/api/v1/metricas` | GET | Métricas históricas |
-
-### Exemplo
-
-```bash
-# Diagnóstico assíncrono
-curl -X POST http://localhost:3100/api/v1/diagnosticar \
-  -H "Content-Type: application/json" \
-  -d '{"async": true, "fast": true}'
-```
-
-> [BOOK] [Documentação da API →](./docs/api/REST-API.md)
-
----
-
-## SDK Programático
-
-Use o Mahoraga como biblioteca no seu código:
-
-```bash
-npm install mahoraga
-```
-
-```typescript
-import { analyzeFile, analyzeProject } from 'mahoraga/sdk'
-
-// Analisar um arquivo
-const result = await analyzeFile('/caminho/arquivo.ts', conteudo)
-
-// Analisar projeto inteiro
-const projeto = await analyzeProject('/caminho/projeto')
-```
-
-```typescript
-import { MahoragaSDK } from 'mahoraga/sdk'
-
-const sdk = new MahoragaSDK()
-await sdk.analisarGithubActions('./.github/workflows')
-sdk.registrarDetector('meu-detector', meuDetector)
-```
-
-**Subpath exports:**
-
-| Import Path | Descrição |
-|-------------|-----------|
-| `mahoraga` | Entry principal |
-| `mahoraga/sdk` | SDK programático |
-| `mahoraga/api` | REST API server |
-| `mahoraga/types` | Typescript types |
-| `mahoraga/bin` | CLI binary |
+| `MAHORAGA_DEBUG` | Modo debug | não definido |
+| `MAHORAGA_STATE_DIR` | Diretório de estado | `.mahoraga` |
+| `MAHORAGA_API_PORT` | Porta do GitHub App | `3100` |
+| `GITHUB_APP_ID` | ID do GitHub App | não definido |
+| `GITHUB_PRIVATE_KEY` | Chave RSA do GitHub App | não definido |
+| `GITHUB_WEBHOOK_SECRET` | Webhook secret | não definido |
 
 ---
 
-## GitHub App
-
-O Mahoraga pode operar como um **GitHub App** que analisa automaticamente workflows do GitHub Actions em PRs, pushes e issues.
-
-### Funcionalidades
-
-- **Análise automática** de workflows em PRs e pushes
-- **Score de qualidade** 0-100 para cada workflow
-- **Detecção** de script injection, secrets hardcoded, permissões excessivas
-- **Comentários automáticos** em PRs e issues
-- **Check runs** com annotations no código
-- **Análise sob demanda** via `@mahoraga analyze` em reviews
-- **Scan sob demanda** via `@mahoraga scan` em issues
-
-### Eventos Suportados
-
-| Evento | Comportamento |
-|--------|---------------|
-| Check Suite | Cria check run com análise completa |
-| Pull Request | Posta comentário detalhado |
-| Push | Análise silenciosa |
-| Review | Responde a `@mahoraga analyze` |
-| Issues | Responde a `@mahoraga scan` |
-
-### Comandos
+## Scripts
 
 ```bash
-mahoraga github-actions scan                    # scan local
-mahoraga github-actions report --format html    # relatório
-mahoraga github-actions gate --threshold 80     # quality gate
-mahoraga github-actions app --port 3000         # iniciar servidor
-```
-
-> [BOOK] [Guia do GitHub App →](./docs/guias/GITHUB-APP.md)
-
----
-
-## Editor (LSP / VSCode)
-
-### LSP Server
-
-```bash
-mahoraga lsp
-```
-
-Suporta `textDocument/didOpen`, `didChange`, `didSave` para diagnóstico em tempo real.
-
-### VSCode Extension
-
-Uma extensão VSCode está disponível em `extensions/vscode/` com:
-- Análise ao salvar (`mahoraga.runOnSave`)
-- Análise ao abrir (`mahoraga.runOnOpen`)
-- Painel de resultados
-- Comandos: Analyze File, Analyze Project, Show Panel, Clear Diagnostics
-
-> [BOOK] [Guia VSCode →](./docs/guias/GUIA-VSCODE.md)
-
----
-
-## CI/CD
-
-O Mahoraga analisa pipelines de CI/CD para detectar problemas de segurança, performance e boas práticas.
-
-| Plataforma | Comando |
-|------------|---------|
-| GitHub Actions | `mahoraga github-actions scan` |
-| GitLab CI | `mahoraga gitlab-ci scan` |
-| CircleCI | `mahoraga circleci scan` |
-| Jenkins | `mahoraga jenkins scan` |
-| Azure Pipelines | `mahoraga azure scan` |
-
-```bash
-# Quality gate para CI (falha se score < 80)
-mahoraga github-actions gate --threshold 80 --fail-on erro
+npm run build          # compilar TypeScript (tsc nativo)
+npm run typecheck      # verificar tipos
+npm run test           # testes (Vitest)
+npm run coverage       # cobertura de testes
+npm run diagnosticar   # auto-análise
+npm run lint           # ESLint
 ```
 
 ---
 
 ## Linguagens Suportadas
 
-| Linguagem | Parser | Status |
-|-----------|--------|--------|
+| Linguagem | Parser | Suporte |
+|-----------|--------|---------|
 | JavaScript | Babel | Nativo |
 | TypeScript | Babel | Nativo |
 | HTML | htmlparser2 | Nativo |
-| CSS | css-tree | Nativo |
+| CSS | postcss | Nativo |
 | XML | fast-xml-parser | Nativo |
 | Python | Heurístico | Nativo |
 | PHP | Heurístico | Nativo |
-| Shell | Heurístico | Plugin |
-| SQL | Heurístico | Plugin |
-| Go | Heurístico | Nativo (v0.8.0) |
-| Rust | Heurístico | Nativo (v0.8.0) |
+| Shell | Heurístico | Nativo |
+| SQL | Heurístico | Nativo |
+| Go | Heurístico | Nativo |
+| Rust | Heurístico | Nativo |
 | Java | java-parser | Disponível |
 | Kotlin | Heurístico | Disponível |
 
 ---
 
-## Documentação Completa
-
-### Guias
-
-- [Guia de Início Rápido](./docs/guias/GUIA-INICIO-RAPIDO.md) — tutorial de 10 minutos
-- [Guia de Configuração](./docs/guias/GUIA-CONFIGURACAO.md) — personalizar setup
-- [Guia de Comandos](./docs/guias/GUIA-COMANDOS.md) — referência completa
-- [Guia Marketplace](./docs/guias/GUIA-MARKETPLACE.md) — analistas comunitários
-- [Guia VSCode](./docs/guias/GUIA-VSCODE.md) — extensão VSCode
-- [Guia Compliance](./docs/guias/GUIA-COMPLIANCE.md) — ISO 27001, SOC 2
-- [Guia Formatters](./docs/guias/GUIA-FORMATTERS.md) — plugins de saída
-
-### Arquitetura
+## Qualidade
 
-- [Árvore Arquitetural](./docs/arquitetura/ARVORE-ARQUITETURAL.md) — estrutura visual
-- [Type Safety](./docs/arquitetura/TYPE-SAFETY.md) — garantias de tipo
-- [Segurança](./docs/arquitetura/SEGURANCA.md) — práticas de segurança
-- [Sistema de Erros](./docs/arquitetura/SISTEMA-ERROS.md) — tratamento de erros
-
-### Desenvolvimento
-
-- [Criar Analistas](./docs/desenvolvimento/analistas/CRIAR-ANALISTA.md) — guia de 6 passos
-- [Estrutura do Código](./docs/desenvolvimento/estrutura-codigo/README.md) — mapa do src/
-- [Padrões de Desenvolvimento](./docs/desenvolvimento/PADROES.md) — convenções
-- [Sistema de Plugins](./docs/desenvolvimento/SISTEMA-PLUGINS.md) — como estender
-
-### Referência
-
-- [REST API](./docs/api/REST-API.md) — documentação da API v1
-- [Exemplos de Uso](./docs/exemplos/EXEMPLOS-USO.md) — casos reais e CI/CD
-- [Roadmap](./docs/roadmap/ROADMAP.md) — futuro do projeto
-- [Índice Completo](./docs/INDICE.md) — navegação por tópico
-
----
-
-### Scripts
-
-```bash
-npm run build          # compilar TypeScript
-npm run typecheck      # verificar tipos
-npm run lint           # ESLint
-npm run test           # testes (Vitest)
-npm run coverage       # cobertura de testes
-npm run start          # executar Mahoraga
-npm run diagnosticar   # auto-análise
-```
-
-### Qualidade
-
-- TypeScript 6.0+ — type-safe, sem `any` desnecessários
-- Testes com Vitest — cobertura target > 90%
-- ESLint 9.x — configuração strict
-- Worker Pool — processamento paralelo
-- Schema Versioning — relatórios versionados
-- i18n — PT, EN, ZH, JA
-- CodeQL — segurança auditada
-
-### Padrões
-
-- TypeScript type-safe (sem `any` ou `unknown` sem necessidade)
-- Nomes descritivos em camelCase/PascalCase
-- Testes com cobertura > 90%
-- Sem `console.log` em produção (use sistema de mensagens)
-- Imports organizados e ordenados
-- Padrões arquiteturais (Registry, Strategy, Singleton)
+- TypeScript 7.0+ (compilador nativo Go/Corsa): type-safe
+- Testes com Vitest: cobertura target > 90%
+- ESLint 10.x: configuração strict
+- Worker pool: processamento paralelo
+- i18n: PT, EN, ZH, JA
+- Schema versioning: relatórios versionados
 
 ---
 
 ## Contribuir
 
-1. Leia [CONTRIBUTING.md](./CONTRIBUTING.md)
-2. Fork o repositório
-3. Crie branch: `git checkout -b feature/sua-feature`
-4. Commit: `git commit -m 'Add: sua feature'`
-5. Push: `git push origin feature/sua-feature`
-6. Abra Pull Request
+Contribuições são bem-vindas! Como o projeto não está mais no GitHub:
 
-### Áreas para Contribuir
+1. Entre em contato pelo e-mail: **mocoto.persona@gmail.com**
+2. Envie patches ou sugestões por e-mail
+3. Reporte bugs com descrição detalhada e exemplo mínimo
 
-- **Bug fixes** — reportar e corrigir bugs
-- **Novas features** — analistas, comandos, plugins
-- **Documentação** — guias, exemplos
-- **Testes** — aumentar cobertura
-- **Analisadores** — criar detectores e plugins
+### Áreas para Contribuir
 
-> [BOOK] [Guia: Como Criar Analistas →](./docs/desenvolvimento/analistas/CRIAR-ANALISTA.md)
+- **Bug fixes**: reportar e corrigir bugs
+- **Novas features**: analistas, comandos, plugins
+- **Documentação**: guias, exemplos
+- **Testes**: aumentar cobertura
+- **Analisadores**: criar detectores e plugins
 
 ---
 
@@ -674,5 +330,3 @@ Dependências de terceiros listadas em [THIRD-PARTY-NOTICES.txt](./THIRD-PARTY-N
 ---
 
 **Feito para os iniciantes**
-
-</div>