@mocoto/mahoraga 0.14.9 → 0.15.1

package/docs/05-referencias/_index.md

@@ -0,0 +1,87 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [moc, referencias]
+created: 2026-07-24
+updated: 2026-07-25
+---
+
+# Referências
+
+## Links Externos
+
+### Dependências Principais
+
+| Biblioteca | Uso | Link |
+|------------|-----|------|
+| Commander.js | CLI framework | https://github.com/tj/commander.js |
+| Vitest | Test framework | https://vitest.dev/ |
+| TypeScript | Linguagem | https://www.typescriptlang.org/ |
+| Babel | AST Parser | https://babel.dev/ |
+| postcss | CSS Parser | https://postcss.org/ |
+| htmlparser2 | HTML Parser | https://github.com/fb55/htmlparser2 |
+| fast-xml-parser | XML Parser | https://github.com/NaturalIntelligence/fast-xml-parser |
+| openpgp | GPG/Cryptography | https://openpgpjs.org/ |
+| chalk | Terminal colors | https://github.com/chalk/chalk |
+| ora | Terminal spinners | https://github.com/sindresorhus/ora |
+| p-limit | Concurrency | https://github.com/sindresorhus/p-limit |
+| micromatch | Glob matching | https://github.com/micromatch/micromatch |
+| yaml | YAML parser | https://eemeli.org/yaml/ |
+| xxhashjs | Hashing | https://github.com/pierrec/js-xxhash |
+| dotenv | Environment vars | https://github.com/motdotla/dotenv |
+
+### Convenções e Standards
+
+| Recurso | Link |
+|---------|------|
+| Conventional Commits | https://www.conventionalcommits.org/ |
+| MIT-0 License | https://opensource.org/license/mit-0 |
+| SPDX Specification | https://spdx.dev/ |
+| ISO 27001 | https://www.iso.org/standard/27001 |
+| SOC 2 | https://www.aicpa-cima.com/topic/audit-assurance/audit-and-assurance/soc-2 |
+| Obsidian | https://obsidian.md/ |
+
+## Recursos do Projeto
+
+| Arquivo | Conteúdo |
+|---------|----------|
+| `AGENTS.md` | Instruções mestre para agentes de IA |
+| `README.md` | README principal do projeto |
+| `package.json` | Dependências, scripts, configurações |
+| `tsconfig.json` | Configuração TypeScript (paths, strict, ES2024) |
+| `vitest.config.ts` | Configuração de testes e aliases |
+| `eslint.config.js` | Configuração ESLint |
+| `THIRD-PARTY-NOTICES.txt` | Atribuições de licenças |
+| `.github/workflows/ci.yml` | CI pipeline |
+| `.github/workflows/publish.yml` | Publicação no npm |
+| `LICENSE` | Licença MIT-0 |
+| `SKILLS.md` | Índice de skills para agentes de IA |
+
+## Arquivos de Configuração
+
+### tsconfig.json (destaques)
+
+- **target:** ES2024
+- **module:** NodeNext
+- **moduleResolution:** NodeNext
+- **strict:** true
+- **verbatimModuleSyntax:** true
+- **paths:** ~160+ aliases internos (`@core/*`, `@cli/*`, `@analysts/*`, etc.)
+
+### vitest.config.ts (destaques)
+
+- **provider:** v8 coverage
+- **aliases:** mesmos paths do tsconfig
+- **include:** `tests/**/*.test.ts`
+- **coverage exclude:** coverage, dist, `*.d.ts`, node_modules, tests
+
+## Comandos npm
+
+```bash
+npm run build          # compilar TypeScript
+npm run typecheck      # verificar tipos
+npm test               # rodar testes
+npm run coverage       # cobertura de testes
+npm run lint           # ESLint
+npm run formatar       # auto-formatação
+npm run diagnosticar   # auto-análise do mahoraga
+```

package/docs/_home.md

@@ -0,0 +1,140 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [moc, index]
+created: 2026-07-24
+updated: 2026-07-25
+---
+
+# @mocoto/mahoraga: Documentação Viva
+
+CLI modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript e multi-stack leve.
+
+## Navegação
+
+| Área                               | Descrição          |
+| ---------------------------------- | ------------------ | ------------------------------------------------------------ |
+| [[01-arquitetura/_index\           | Arquitetura]]      | Decisões arquiteturais, ADRs, diagramas, fluxos              |
+| [[02-componentes/_index\           | Componentes]]      | Documentação de todos os módulos do sistema                  |
+| [[02-componentes/supressao-inline\ | Supressão Inline]] | Sistema de `@mahoraga-disable` para analistas e formatadores |
+| [[03-guias/_index\                 | Guias]]            | Guias de contribuição, testes, CLI, debug                    |
+| [[04-glossario/_index\             | Glossário]]        | Termos do domínio e conceitos                                |
+| [[05-referencias/_index\           | Referências]]      | Links externos, specs, recursos                              |
+
+## Visão Geral
+
+Mahoraga é uma ferramenta CLI que funciona como "médico de projetos": analisa código fonte, detecta problemas de qualidade, segurança e arquitetura, e oferece correções automatizadas. Suporta múltiplas linguagens (JS, TS, React, CSS, HTML, Python, Shell, SQL, Go, Rust, PHP) e plataformas de CI/CD (GitHub Actions, GitLab CI, CircleCI, Jenkins, Azure Pipelines).
+
+## Stack
+
+- **Runtime:** Node.js >=24.16.0
+- **Linguagem:** TypeScript (ES2024, NodeNext)
+- **Build:** tsc + tsc-alias
+- **Testes:** Vitest v4 + v8 coverage
+- **CLI:** Commander.js
+- **Parser:** Babel (AST), postcss, htmlparser2, fast-xml-parser
+- **GPG:** openpgp (Ed25519)
+- **i18n:** pt, en, zh, ja
+- **Licença:** MIT-0
+
+## Snapshot do Projeto
+
+| Métrica | Valor |
+|---------|-------|
+| Versão | 0.15.1 |
+| Comandos CLI | 27 |
+| Arquivos de teste | ~230 |
+| Testes | ~3200 |
+| Cobertura (statements) | ~47% |
+| Source lines | ~22k |
+| Diretórios em `src/` | 15+ |
+| Analisadores de linguagem | 11 |
+| Analisadores de CI/CD | 5 |
+| Línguas suportadas | 4 (pt, en, zh, ja) |
+
+## Arquitetura em Camadas
+
+```mermaid
+flowchart TB
+    subgraph Entry
+        bin["src/bin/index.ts<br/>Entry Point"]
+    end
+    subgraph CLI["CLI Layer<br/>src/cli/"]
+        CMDS["27 comandos<br/>Commander.js"]
+        DIAG["Diagnóstico"]
+        HELP["Helpers"]
+    end
+    subgraph CORE["Core Layer<br/>src/core/"]
+        EXEC["Execução<br/>Scanner / Workers"]
+        CONF["Config"]
+        PARSE["Parsing<br/>Babel + langs"]
+        I18N["i18n<br/>pt/en/zh/ja"]
+        CORR["Correções"]
+    end
+    subgraph ANALYSTS["Analysis Layer<br/>src/analysts/"]
+        DETECT["Detectores<br/>15+ especializados"]
+        LANG["Analisadores<br/>11 linguagens"]
+        CICD["Analisadores<br/>5 plataformas CI/CD"]
+        PLUGINS["Plugins"]
+    end
+    subgraph SERVICES["Service Layer"]
+        GUARDIAN["Guardian<br/>Integridade GPG"]
+        LICENSES["Licenças<br/>SPDX + scanner"]
+        VULN["Vulnerabilidades<br/>npm audit"]
+        CARETAKERS["Caretakers<br/>Transformações"]
+        REPORTS["Relatórios<br/>Compliance + Advisor"]
+    end
+    subgraph SHARED["Shared Layer<br/>src/shared/"]
+        FORM["Formatters"]
+        PERSIST["Persistência"]
+        VAL["Validação"]
+        MP["Marketplace"]
+    end
+    subgraph TYPES["Types<br/>src/types/"]
+        TINDEX["14 namespaces"]
+    end
+
+    bin --> CLI
+    CLI --> CORE
+    CORE --> ANALYSTS
+    CORE --> SERVICES
+    SERVICES --> SHARED
+    ANALYSTS --> SHARED
+    CORE --> TYPES
+    ANALYSTS --> TYPES
+    SERVICES --> TYPES
+```
+
+## Comandos Rápidos
+
+```bash
+# Diagnóstico
+mahoraga diagnosticar                    # análise padrão
+mahoraga diagnosticar --full             # completa
+mahoraga diagnosticar --fast             # rápida
+mahoraga diagnosticar --json             # JSON output
+
+# Integridade
+mahoraga guardian                        # verificar integridade
+mahoraga guardian --accept-baseline      # aceitar baseline
+
+# CI/CD
+mahoraga github-actions scan
+mahoraga gitlab-ci scan
+mahoraga circleci scan
+mahoraga convert --from github --to gitlab
+
+# Licenças
+mahoraga licencas scan
+mahoraga licencas notices generate
+mahoraga licencas disclaimer add
+
+# Manutenção
+mahoraga formatar --write
+mahoraga podar
+mahoraga fix-types --target src
+mahoraga imports --scan
+
+# Compliance
+mahoraga compliance report iso-27001
+mahoraga compliance report soc2
+```

package/docs/partials/AVISO-PROVENIENCIA.md

@@ -0,0 +1,3 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+---

package/docs/templates/ADR.md

@@ -0,0 +1,24 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [adr]
+status: proposto | aceito | deprecated
+created: {{date}}
+---
+
+# ADR-NNN: Título da Decisão
+
+## Contexto
+
+<!-- Por que essa decisão foi necessária? Qual problema resolve? -->
+
+## Decisão
+
+<!-- O que foi decidido? Qual caminho foi escolhido? -->
+
+## Consequências
+
+<!-- Impactos positivos e negativos da decisão -->
+
+## Alternativas Consideradas
+
+<!-- Quais outras opções foram avaliadas e por que foram descartadas? -->

package/docs/templates/componente.md

@@ -0,0 +1,34 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [componente]
+status: rascunho
+created: {{date}}
+---
+
+# Nome do Componente
+
+## Propósito
+
+<!-- O que este componente faz? Qual problema resolve? -->
+
+## Dependências
+
+- Entrada: <!-- o que ele recebe -->
+- Saída: <!-- o que ele produz -->
+- Importa de: <!-- módulos que usa -->
+
+## API Pública
+
+```typescript
+// Assinaturas principais
+```
+
+## Exemplo de Uso
+
+```typescript
+
+```
+
+## Testes
+
+<!-- Onde estão os testes e como rodá-los -->

package/docs/templates/guia.md

@@ -0,0 +1,28 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [guia]
+status: rascunho
+created: {{date}}
+---
+
+# Título do Guia
+
+## Objetivo
+
+<!-- O que este guia ensina? -->
+
+## Passo a Passo
+
+1. <!-- passo 1 -->
+2. <!-- passo 2 -->
+3. <!-- passo 3 -->
+
+## Exemplos
+
+```bash
+# Comandos de exemplo
+```
+
+## Referências
+
+- Links para notas relacionadas

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mocoto/mahoraga",
-  "version": "0.14.9",
+  "version": "0.15.1",
   "type": "module",
   "description": "C.L.I modular para análise, diagnóstico e manutenção de projetos JavaScript/TypeScript e multi-stack leve",
   "author": "Italo Lopes",
@@ -23,59 +23,58 @@
     "start": "mahoraga",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint src",
+    "security:lint": "npm run lint",
+    "security-check": "npm audit --production --audit-level=moderate",
     "test": "vitest run --passWithNoTests",
     "coverage": "vitest run --coverage",
+
     "diagnosticar": "mahoraga diagnosticar",
+    "analistas": "mahoraga analistas",
+    "metricas": "mahoraga metricas",
+    "vulnerabilidades": "mahoraga vulnerabilidades scan",
+
     "imports": "mahoraga imports",
     "imports:scan": "mahoraga imports --scan",
     "imports:apply": "mahoraga imports --apply",
+    "names": "mahoraga names",
+    "names:scan": "mahoraga names --scan",
+    "names:apply": "mahoraga names --apply",
+    "barrels": "mahoraga barrels",
+
     "formatar": "mahoraga formatar --write",
     "format:check": "mahoraga formatar --check",
     "podar": "mahoraga podar",
     "fix-types": "mahoraga fix-types",
-    "name": "mahoraga names",
-    "names:scan": "mahoraga names --scan",
-    "names:apply": "mahoraga names --apply",
-    "barrels": "mahoraga barrels",
+    "otimizar-svg": "mahoraga otimizar-svg --write",
+    "atualizar": "mahoraga atualizar",
+    "convert": "mahoraga convert",
+
     "perf:baseline": "mahoraga perf snapshot --baseline || true",
     "perf:compare": "mahoraga perf compare",
     "perf:gate": "mahoraga perf compare --threshold 0",
+
     "scan": "mahoraga licencas scan",
     "scan:root": "mahoraga licencas scan --root .",
+    "licenses:json": "mahoraga licencas scan --json",
     "notices": "mahoraga licencas notices generate",
-    "disclaimer:add": "mahoraga licencas disclaimer add",
     "disclaimer:verify": "mahoraga licencas disclaimer verify",
     "add": "mahoraga licencas disclaimer add",
-    "verify": "mahoraga licencas disclaimer verify",
-    "audit": "mahoraga licencas scan",
-    "licenses:audit": "mahoraga licencas scan",
-    "licenses:json": "mahoraga licencas scan --json",
-    "json": "mahoraga licencas scan --json",
-    "guardian": "mahoraga guardian",
-    "otimizar-svg": "mahoraga otimizar-svg --write",
-    "atualizar": "mahoraga atualizar",
-    "convert": "mahoraga convert",
-    "analistas": "mahoraga analistas",
-    "metricas": "mahoraga metricas",
-    "vulnerabilidades": "mahoraga vulnerabilidades scan",
-    "security:deps": "mahoraga vulnerabilidades scan",
-    "security:lint": "npm run lint",
-    "security-check": "npm audit --production --audit-level=moderate",
+
     "gha:scan": "mahoraga github-actions scan",
     "gha:report": "mahoraga github-actions report",
     "gha:gate": "mahoraga github-actions gate",
-    "gha:app": "mahoraga github-actions app",
     "gitlab:scan": "mahoraga gitlab-ci scan",
     "circleci:scan": "mahoraga circleci scan",
     "jenkins:scan": "mahoraga jenkins scan",
     "azure:scan": "mahoraga azure scan",
+
     "plugins:list": "mahoraga plugins list",
     "marketplace:search": "mahoraga marketplace search",
     "marketplace:list": "mahoraga marketplace list",
+
+    "guardian": "mahoraga guardian",
     "reverter:listar": "mahoraga reverter listar",
-    "reverter:status": "mahoraga reverter status",
-    "headers:spdx": "find src -name \"*.ts\" -exec grep -L \"SPDX-License-Identifier\" {} \\; 2>/dev/null | head -20",
-    "license-check": "mahoraga licencas scan"
+    "reverter:status": "mahoraga reverter status"
   },
   "keywords": [
     "cli",
@@ -114,15 +113,15 @@
     "chalk": "^5.6.2",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",
-    "fast-xml-parser": "^5.10.0",
+    "fast-xml-parser": "^5.10.1",
     "htmlparser2": "^12.0.0",
-    "marked": "^18.0.6",
+    "marked": "^18.0.7",
     "micromatch": "^4.0.8",
     "minimatch": "^10.2.5",
     "openpgp": "^6.3.1",
     "ora": "^9.4.1",
-    "p-limit": "^7.3.0",
-    "postcss": "^8.5.18",
+    "p-limit": "^7.3.1",
+    "postcss": "^8.5.23",
     "postcss-sass": "^0.5.0",
     "postcss-scss": "^4.0.9",
     "xxhashjs": "^0.2.2",
@@ -133,12 +132,12 @@
     "@types/node": "^26.1.1",
     "@vitest/coverage-istanbul": "^4.1.8",
     "@vitest/coverage-v8": "^4.1.8",
-    "autoprefixer": "^10.5.2",
+    "autoprefixer": "^10.5.4",
     "husky": "^9.1.7",
     "license-checker-rseidelsohn": "^5.0.1",
-    "lint-staged": "^17.0.8",
+    "lint-staged": "^17.2.0",
     "rimraf": "^6.1.3",
-    "tsc-alias": "^1.9.0",
+    "tsc-alias": "^1.9.1",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.8"

package/dist/app/github.js

@@ -1,14 +0,0 @@
-import { createServer } from 'node:http';
-export async function iniciarServidorApp(opts) {
-    const server = createServer((_req, res) => {
-        res.writeHead(200, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ status: 'ok', appId: opts.appId }));
-    });
-    return new Promise((resolve, reject) => {
-        server.listen(opts.port, () => {
-            console.log(`GitHub App server running on port ${opts.port}`);
-            resolve();
-        });
-        server.on('error', reject);
-    });
-}

package/dist/app/index.js

@@ -1 +0,0 @@
-export * from './github.js';

package/dist/core/messages/en/github/github-app-messages.js

@@ -1,9 +0,0 @@
-export const GithubAppMensagens = {
-    servidorRodando: (port) => `[LAUNCH] Server running on port ${port}`,
-    webhooksEndpoint: (port) => `[DIRECT-LINK] Webhooks: http://localhost:${port}/api/github/webhooks`,
-    restApiEndpoint: (port) => `[DIRECT-LINK] REST API: http://localhost:${port}/api`,
-    healthEndpoint: (port) => `[DIRECT-LINK] Health: http://localhost:${port}/api/health`,
-    dashboardEndpoint: (port) => `[DIRECT-LINK] Dashboard: http://localhost:${port}/`,
-    statsEndpoint: (port) => `[DIRECT-LINK] Stats: http://localhost:${port}/api/github/stats`,
-    erroIniciarServidor: (erro) => `Failed to start server: ${erro}`,
-};

package/dist/core/messages/ja/github/github-app-messages.js

@@ -1,9 +0,0 @@
-export const GithubAppMensagens = {
-    servidorRodando: (port) => `[起動] ポート ${port} でサーバーが稼働中です`,
-    webhooksEndpoint: (port) => `[ダイレクトリンク] Webhooks: http://localhost:${port}/api/github/webhooks`,
-    restApiEndpoint: (port) => `[ダイレクトリンク] REST API: http://localhost:${port}/api`,
-    healthEndpoint: (port) => `[ダイレクトリンク] Health: http://localhost:${port}/api/health`,
-    dashboardEndpoint: (port) => `[ダイレクトリンク] Dashboard: http://localhost:${port}/`,
-    statsEndpoint: (port) => `[ダイレクトリンク] Stats: http://localhost:${port}/api/github/stats`,
-    erroIniciarServidor: (erro) => `サーバーの起動に失敗しました: ${erro}`,
-};

package/dist/core/messages/pt/github/github-app-messages.js

@@ -1,9 +0,0 @@
-export const GithubAppMensagens = {
-    servidorRodando: (port) => `[LANCAMENTO] Servidor rodando na porta ${port}`,
-    webhooksEndpoint: (port) => `[APONTAR-DIRETA] Webhooks: http://localhost:${port}/api/github/webhooks`,
-    restApiEndpoint: (port) => `[APONTAR-DIRETA] REST API: http://localhost:${port}/api`,
-    healthEndpoint: (port) => `[APONTAR-DIRETA] Health: http://localhost:${port}/api/health`,
-    dashboardEndpoint: (port) => `[APONTAR-DIRETA] Dashboard: http://localhost:${port}/`,
-    statsEndpoint: (port) => `[APONTAR-DIRETA] Stats: http://localhost:${port}/api/github/stats`,
-    erroIniciarServidor: (erro) => `Falha ao iniciar servidor: ${erro}`,
-};

package/dist/core/messages/zh/github/github-app-messages.js

@@ -1,9 +0,0 @@
-export const GithubAppMensagens = {
-    servidorRodando: (port) => `[启动] 服务器正在端口 ${port} 上运行`,
-    webhooksEndpoint: (port) => `[直接链接] Webhooks: http://localhost:${port}/api/github/webhooks`,
-    restApiEndpoint: (port) => `[直接链接] REST API: http://localhost:${port}/api`,
-    healthEndpoint: (port) => `[直接链接] Health: http://localhost:${port}/api/health`,
-    dashboardEndpoint: (port) => `[直接链接] Dashboard: http://localhost:${port}/`,
-    statsEndpoint: (port) => `[直接链接] Stats: http://localhost:${port}/api/github/stats`,
-    erroIniciarServidor: (erro) => `服务器启动失败: ${erro}`,
-};