@mocoto/mahoraga 0.15.0 → 0.15.2

package/Docs/.obsidian/app.json

@@ -0,0 +1,7 @@
+{
+  "enabled": true,
+  "alwaysUpdateLinks": true,
+  "promptDelete": false,
+  "newFileLocation": "current",
+  "attachmentFolderPath": "./"
+}

package/Docs/.obsidian/appearance.json

@@ -0,0 +1,8 @@
+{
+  "theme": "system",
+  "accentColor": "#6b5bff",
+  "cssTheme": "",
+  "baseFontSize": 15,
+  "showViewHeader": false,
+  "nativeMenus": false
+}

package/Docs/.obsidian/community-plugins.json

@@ -0,0 +1,28 @@
+{
+  "enabled": [
+    "obsidian-dataview",
+    "templater-obsidian",
+    "obsidian-git"
+  ],
+  "plugins": {
+    "obsidian-dataview": {
+      "enableDataviewJs": false,
+      "renderNullAs": "\\-",
+      "taskLinkLocation": "end",
+      "taskLinkText": "🔗"
+    },
+    "templater-obsidian": {
+      "templatesFolder": "templates",
+      "dateFormat": "YYYY-MM-DD",
+      "timeFormat": "HH:mm"
+    },
+    "obsidian-git": {
+      "autoCommitMessage": "docs: auto-sync {{date}}",
+      "autoPullInterval": 30,
+      "autoPushInterval": 30,
+      "autoBackupAfterFileChange": true,
+      "gitRemote": "origin",
+      "syncMethod": "rebase"
+    }
+  }
+}

package/Docs/.obsidian/core-plugins-migration.json

@@ -0,0 +1,18 @@
+{
+  "mermaid": true,
+  "tagPane": true,
+  "graphView": true,
+  "pagePreview": true,
+  "backlink": true,
+  "outgoingLink": true,
+  "outline": true,
+  "starred": false,
+  "switcher": true,
+  "commandPalette": true,
+  "markdownImporter": false,
+  "wordCount": true,
+  "fileExplorer": true,
+  "search": true,
+  "bookmarks": true,
+  "properties": true
+}

package/Docs/.obsidian/core-plugins.json

@@ -0,0 +1,73 @@
+{
+  "core-plugin-list": [
+    "backlink",
+    "bookmarks",
+    "command-palette",
+    "daily-notes",
+    "file-explorer",
+    "file-recovery",
+    "global-search",
+    "graph-view",
+    "outgoing-link",
+    "outline",
+    "page-preview",
+    "properties",
+    "random-note",
+    "slash-command",
+    "switcher",
+    "tag-pane",
+    "templates",
+    "word-count"
+  ],
+  "enabled": [
+    "backlink",
+    "bookmarks",
+    "command-palette",
+    "daily-notes",
+    "file-explorer",
+    "file-recovery",
+    "global-search",
+    "graph-view",
+    "outgoing-link",
+    "outline",
+    "page-preview",
+    "properties",
+    "random-note",
+    "slash-command",
+    "switcher",
+    "tag-pane",
+    "templates",
+    "word-count"
+  ],
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": true,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "footnotes": false,
+  "properties": true,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": false,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": true,
+  "bases": true,
+  "webviewer": false
+}

package/Docs/.obsidian/graph.json

@@ -0,0 +1,22 @@
+{
+  "collapse-filter": true,
+  "search": "",
+  "showTags": false,
+  "showAttachments": false,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": true,
+  "colorGroups": [],
+  "collapse-display": true,
+  "showArrow": false,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 1,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": true,
+  "centerStrength": 0.518713248970312,
+  "repelStrength": 10,
+  "linkStrength": 1,
+  "linkDistance": 250,
+  "scale": 0.6666666666666666,
+  "close": true
+}

package/Docs/.obsidian/workspace.json

@@ -0,0 +1,196 @@
+{
+  "main": {
+    "id": "38cd0250b80f3c65",
+    "type": "split",
+    "children": [
+      {
+        "id": "f49eb26fe94f5853",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "8dedf7c146f5cebf",
+            "type": "leaf",
+            "state": {
+              "type": "empty",
+              "state": {},
+              "icon": "lucide-file",
+              "title": "Nova aba"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "vertical"
+  },
+  "left": {
+    "id": "57192ac9415d99df",
+    "type": "split",
+    "children": [
+      {
+        "id": "93e26a2b823d31a6",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "eec9025824b684fa",
+            "type": "leaf",
+            "state": {
+              "type": "file-explorer",
+              "state": {
+                "sortOrder": "alphabetical",
+                "autoReveal": false
+              },
+              "icon": "lucide-folder-closed",
+              "title": "Explorador de arquivos"
+            }
+          },
+          {
+            "id": "12c861fc6eed8790",
+            "type": "leaf",
+            "state": {
+              "type": "search",
+              "state": {
+                "query": "",
+                "matchingCase": false,
+                "explainSearch": false,
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical"
+              },
+              "icon": "lucide-search",
+              "title": "Procurar"
+            }
+          },
+          {
+            "id": "741d819feaded626",
+            "type": "leaf",
+            "state": {
+              "type": "bookmarks",
+              "state": {},
+              "icon": "lucide-bookmark",
+              "title": "Marcadores"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300
+  },
+  "right": {
+    "id": "a4b627412871651f",
+    "type": "split",
+    "children": [
+      {
+        "id": "e19dd6dbffcc1cd6",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "5009486718136ab8",
+            "type": "leaf",
+            "state": {
+              "type": "backlink",
+              "state": {
+                "file": "06-feedbacks/feedback.md",
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical",
+                "showSearch": false,
+                "searchQuery": "",
+                "backlinkCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-coming-in",
+              "title": "Links inversos para feedback"
+            }
+          },
+          {
+            "id": "2bbe7040a4c87fa6",
+            "type": "leaf",
+            "state": {
+              "type": "outgoing-link",
+              "state": {
+                "linksCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-going-out",
+              "title": "Links de saída"
+            }
+          },
+          {
+            "id": "4ea52f6f13c06874",
+            "type": "leaf",
+            "state": {
+              "type": "tag",
+              "state": {
+                "sortOrder": "frequency",
+                "useHierarchy": true,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-tags",
+              "title": "Etiquetas"
+            }
+          },
+          {
+            "id": "6d51f37d307431c8",
+            "type": "leaf",
+            "state": {
+              "type": "all-properties",
+              "state": {
+                "sortOrder": "frequency",
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-archive",
+              "title": "Todas as propriedades"
+            }
+          },
+          {
+            "id": "844a6214db033948",
+            "type": "leaf",
+            "state": {
+              "type": "outline",
+              "state": {
+                "followCursor": false,
+                "showSearch": false,
+                "searchQuery": ""
+              },
+              "icon": "lucide-list",
+              "title": "Sumário"
+            }
+          }
+        ]
+      }
+    ],
+    "direction": "horizontal",
+    "width": 300,
+    "collapsed": true
+  },
+  "left-ribbon": {
+    "hiddenItems": {
+      "switcher:Abrir a troca rápida": false,
+      "graph:Abrir visualização em gráfico": false,
+      "canvas:Criar novo canvas": false,
+      "daily-notes:Abrir a nota de hoje": false,
+      "templates:Inserir modelo": false,
+      "command-palette:Abrir paleta de comandos": false,
+      "bases:Criar nova base": false
+    }
+  },
+  "active": "eec9025824b684fa",
+  "lastOpenFiles": [
+    "Sem título.md",
+    "Sem título",
+    "Sem título.base",
+    "02-componentes/_index.md",
+    "templates/guia.md",
+    "templates/componente.md",
+    "templates/ADR.md",
+    "04-glossario/termos.md",
+    "03-guias/testes.md",
+    "03-guias/contribuindo.md",
+    "01-arquitetura/ADR-001-estrutura-testes.md",
+    "01-arquitetura/_index.md",
+    "_home.md"
+  ]
+}

package/Docs/01-arquitetura/ADR-001-estrutura-testes.md

@@ -0,0 +1,31 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [adr, testes]
+status: aceito
+created: 2026-07-24
+---
+
+# ADR-001: Estrutura de Testes com Vitest
+
+## Contexto
+
+O projeto precisava de uma estrutura de testes que suportasse mocking de módulos ES, coverage por diretório, e integração com TypeScript sem transpilação extra.
+
+## Decisão
+
+- **Framework:** Vitest v4 com v8 coverage
+- **Mocks globais:** `vi.hoisted()` + `vi.mock()` no topo dos testes
+- **Alias:** `@` → `src/types/index.ts` resolvido via `vitest.config.ts`
+- **Organização:** `tests/` espelha `src/` em estrutura de diretórios
+- **Comandos CLI:** `parseAsync([], { from: 'user' })` sem argv posicionais (Commander v15)
+
+## Consequências
+
+- Testes rodam em ~30s (full suite) e ~6s (parciais)
+- 238 test files, 3276 testes
+- Coverage total: ~48% (target: 56%+)
+
+## Alternativas Consideradas
+
+- **Jest**: maior ecossistema, mas mais lento e sem ESM nativo
+- **Mocha**: flexível, mas sem built-in coverage e mocking

package/Docs/01-arquitetura/_index.md

@@ -0,0 +1,152 @@
+---
+Proveniência e Autoria: Este documento integra o projeto @mocoto/mahoraga (licença MIT-0).
+tags: [moc, arquitetura]
+created: 2026-07-24
+updated: 2026-07-25
+---
+
+# Arquitetura
+
+## Visão Geral
+
+O Mahoraga é organizado em 6 camadas:
+
+### 1. Entry Point (`src/bin/index.ts`)
+
+Binário executável (`#!/usr/bin/env node`). Inicializa o loader ESM customizado (aliases em runtime), configura handlers globais de erro, carrega configuração, versão, memória de conversação, registra todos os comandos via `registrarComandos()` e executa `program.parseAsync()`.
+
+### 2. CLI Layer (`src/cli/`)
+
+Interface com o usuário via Commander.js. 27 comandos registrados em `commands.ts`, cada um implementado em um arquivo `command-*.ts`. Subcomandos para diagnóstico, guardian, CI/CD, licenças, compliance, manutenção, plugins.
+
+### 3. Core Layer (`src/core/`)
+
+Motor central do sistema:
+- **execution/**: Scanner, registry, workers, cache, ambiente, linguagens, schema
+- **config/**: Configuração default, scoring, paths, segurança, filtros
+- **parsing/**: Parsers baseados em Babel (AST) + parsers por linguagem
+- **messages/**: Sistema de i18n com suporte a pt (padrão), en, zh, ja
+- **workers/**: Worker pool para processamento paralelo
+- **corrections/**: Auto-fix engine
+
+### 4. Analysis Layer (`src/analysts/`)
+
+Analisadores especializados organizados por domínio:
+
+**Detectores gerais** (aplicáveis a qualquer projeto):
+- `detectors/`: 12 detectores: architecture, bugs-ml, code-fragile, dependencies, duplications, monorepo, performance, phantoms, recommendation, security, structure
+
+**Analisadores por linguagem** (cada um com analysts/, detectors/, corrections/, scorers/):
+- `js-ts/`, `react/`, `css/`, `css-in-js/`, `html/`, `svg/`, `xml/`, `tailwind/`, `python/`, `shell/`, `sql/`, `go/`, `rust/`, `php/`
+
+**Analisadores de CI/CD** (cada um com analysts/, detectors/, corrections/, reports/, scorers/):
+- `github-actions/`, `gitlab-ci/`, `circleci/`, `jenkins/`, `azure-pipelines/`
+
+**Infraestrutura:**
+- `registry/`: Autodiscovery de analistas
+- `plugins/`: Sistema de plugins (analyst-formatter, detector-documentation, detector-markdown, detector-node)
+- `corrections/`: Correções automáticas (quick-fixes, auto-fix, alias-imports, pruning, barrels, type-safety)
+- `converters/`: Conversão entre plataformas CI/CD
+- `scorers/`: Engine de pontuação
+- `strategists/`: Estratégias de análise (archetypes, suggestions)
+
+### 5. Service Layer
+
+| Módulo | Descrição |
+|--------|-----------|
+| `guardian/` | Pipeline de integridade com GPG (Ed25519). Baseline, snapshot, diff, sentinel, verifier |
+| `licenses/` | Gerenciamento de licenças SPDX. Scanner, normalizer, policy, disclaimer, notice generator |
+| `vulnerabilities/` | Scan de vulnerabilidades via npm audit |
+| `caretakers/` | Transformações automáticas: imports, barrels, pruning, map-reversion, scoring |
+| `reports/` | Relatórios: compliance (ISO 27001, SOC 2), advisor, archetypes, streaming NDJSON, fragments |
+
+### 6. Shared Layer (`src/shared/`)
+
+Utilitários compartilhados entre módulos:
+- `formatters/`: Motores de formatação (core, engines, formatters)
+- `persistence/`: Persistência de estado
+- `validation/`: Validação de dados
+- `marketplace/`: Marketplace de analistas
+- `plugins/`: Sistema de plugins
+- `helpers/`: Helpers diversos
+
+### 7. Types (`src/types/`)
+
+14 namespaces de tipos TypeScript: analysts, caretakers, common, core, guardian, licenses, processing, project, scripts, sdk, shared, structure, vulnerabilities.
+
+## Fluxo de Dados
+
+```mermaid
+sequenceDiagram
+    actor User
+    participant CLI as src/cli/
+    participant CORE as src/core/
+    participant REG as Registry
+    participant ANALYST as Analysts
+    participant SVC as Services
+
+    User->>CLI: mahoraga diagnosticar
+    CLI->>CORE: scanRepository()
+    CORE->>REG: autodiscover()
+    REG-->>CORE: analysts[]
+    CORE->>ANALYST: analyze(project)
+    ANALYST-->>CORE: results[]
+    CORE->>SVC: compliance/generate
+    SVC-->>CORE: report
+    CORE-->>CLI: aggregated results
+    CLI-->>User: formatted output
+```
+
+## Alias System
+
+O projeto usa path aliases estilo `@pasta/arquivo` para todos os imports internos, resolvidos em três níveis:
+
+1. **tsconfig.json**: paths mapping (~160+ entradas)
+2. **node.loader.ts**: Loader ESM customizado para runtime
+3. **vitest.config.ts**: Aliases para ambiente de teste
+
+## Decisões Arquiteturais
+
+- [[ADR-001-estrutura-testes|ADR-001: Estrutura de Testes com Vitest]]
+- Novos ADRs devem seguir o template em `templates/ADR.md`
+
+## Diagrama de Componentes
+
+```mermaid
+flowchart LR
+    subgraph CLI["CLI Layer"]
+        CMD[commands.ts]
+        GHA[github-actions]
+        DIAG[diagnosticar]
+        LIC[licencas]
+    end
+    subgraph CORE["Core"]
+        EXEC[execution]
+        CONF[config]
+        MSG[messages]
+        WRK[workers]
+    end
+    subgraph ANAL["Analysts"]
+        LANG[js-ts/react/css/...]
+        CICD[gha/gitlab/circle/...]
+        DET[detectores]
+        CORR[corrections]
+    end
+    subgraph SVC["Services"]
+        GRD[guardian]
+        CAR[caretakers]
+        RPT[reports]
+    end
+    CLI --> CORE
+    CORE --> ANAL
+    CORE --> SVC
+```
+
+## Temas Arquiteturais
+
+- **Modularidade**: Cada módulo tem barrel (`index.ts`) e tipos próprios
+- **Autodiscovery**: Novos analistas são detectados sem registro manual
+- **i18n first**: Mensagens em pt, en, zh, ja desde o design
+- **Plugin system**: Analistas e detectores podem ser estendidos via plugins
+- **Streaming**: NDJSON para projetos grandes (>10k arquivos)
+- **Worker pool**: Processamento paralelo para análise intensiva