@mocoto/mahoraga 0.14.9 → 0.15.1

package/dist/core/messages/ja/github/index.js

@@ -1,4 +1,3 @@
-export * from './github-app-messages.js';
 export * from './github-push-report-messages.js';
 export * from './github-repo-downloader-messages.js';
 export * from './github-webhook-messages.js';

package/dist/core/messages/pt/cli/cli-command-github-actions-messages.js

@@ -3,7 +3,6 @@ export const CliComandoGithubActionsMensagens = {
     descricaoScan: 'Analisa workflows do GitHub Actions',
     descricaoReport: 'Gera relatório de análise de workflows',
     descricaoGate: 'Gate de qualidade para CI/CD - falha se score abaixo do threshold',
-    descricaoApp: 'Inicia o servidor para atuar como GitHub App',
     optPath: 'Caminho para o repositório',
     optWorkflow: 'Analisar workflow específico',
     optFix: 'Aplica correções automaticamente quando possível',
@@ -35,8 +34,4 @@ export const CliComandoGithubActionsMensagens = {
     gatePassou: (score, threshold) => `[OK] Gate passou! Score: ${score}/100 (threshold: ${threshold})`,
     gateFalhou: (score, threshold) => `[ERRO] Gate falhou! Score: ${score}/100 (threshold: ${threshold})`,
     gateFalhaMotivo: (motivo) => `  - ${motivo}`,
-    appSetupRequired: 'Para iniciar o GitHub App, você precisa configurar as variáveis de ambiente:',
-    appSetupEnvList: '  - GITHUB_APP_ID\n  - GITHUB_PRIVATE_KEY\n  - GITHUB_WEBHOOK_SECRET',
-    appDicaEnv: '\nDica: Crie um arquivo .env na raiz com essas variáveis.',
-    erroIniciarServidor: (msg) => `Erro ao iniciar servidor: ${msg}`,
 };

package/dist/core/messages/pt/github/index.js

@@ -1,4 +1,3 @@
-export * from './github-app-messages.js';
 export * from './github-push-report-messages.js';
 export * from './github-repo-downloader-messages.js';
 export * from './github-webhook-messages.js';

package/dist/core/messages/zh/cli/cli-command-github-actions-messages.js

@@ -3,7 +3,6 @@ export const CliComandoGithubActionsMensagens = {
     descricaoScan: '分析 GitHub Actions 工作流',
     descricaoReport: '生成工作流分析报告',
     descricaoGate: 'CI/CD 质量门 - 分数低于阈值则失败',
-    descricaoApp: '启动服务器以作为 GitHub App 运行',
     optPath: '仓库路径',
     optWorkflow: '分析特定工作流',
     optFix: '自动应用修复（如可能）',
@@ -35,8 +34,4 @@ export const CliComandoGithubActionsMensagens = {
     gatePassou: (score, threshold) => `[OK] 质量门通过! 分数: ${score}/100 (阈值: ${threshold})`,
     gateFalhou: (score, threshold) => `[错误] 质量门失败! 分数: ${score}/100 (阈值: ${threshold})`,
     gateFalhaMotivo: (motivo) => `  - ${motivo}`,
-    appSetupRequired: '要启动 GitHub App，您需要配置以下环境变量:',
-    appSetupEnvList: '  - GITHUB_APP_ID\n  - GITHUB_PRIVATE_KEY\n  - GITHUB_WEBHOOK_SECRET',
-    appDicaEnv: '\n提示: 在根目录创建一个 .env 文件并设置这些变量。',
-    erroIniciarServidor: (msg) => `启动服务器错误: ${msg}`,
 };

package/dist/core/messages/zh/github/index.js

@@ -1,4 +1,3 @@
-export * from './github-app-messages.js';
 export * from './github-push-report-messages.js';
 export * from './github-repo-downloader-messages.js';
 export * from './github-webhook-messages.js';

package/dist/core/registry/file-registry.js

@@ -1,7 +1,7 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { messages } from '../messages/index.js';
-import { MIGRACAO_MAPA, MAHORAGA_ARQUIVOS, MAHORAGA_DIRS } from './paths.js';
+import { MAHORAGA_ARQUIVOS, MAHORAGA_DIRS, MIGRACAO_MAPA } from './paths.js';
 async function fileExists(fileCaminho) {
     try {
         await fs.stat(fileCaminho);

package/dist/node.loader.js

@@ -109,8 +109,6 @@ const aliases = {
     "@analysts/xml/corrections": "./src/analysts/xml/corrections/index",
     "@analysts/xml/detectors": "./src/analysts/xml/detectors/index",
     "@analysts/xml/scorers": "./src/analysts/xml/scorers/index",
-    "@app": "./src/app/index",
-    "@app/github": "./src/app/github",
     "@caretakers": "./src/caretakers/index",
     "@cli": "./src/cli/index",
     "@cli/commands": "./src/cli/commands/index",

package/dist/shared/formatters/formatters/commons.js

@@ -1,3 +1,20 @@
+import { extrairSupressoes, isRegraSuprimida } from '../../helpers/index.js';
+const REGRAS_SUPRESSAO_FORMATADOR = ['pontuacao-repetida', 'espacamento-incorreto', 'formatador', 'analista-formatador', '*'];
+export function extrairLinhasProtegidasFormatador(src) {
+    const supressoes = extrairSupressoes(src);
+    const lines = src.split('\n');
+    const protegidas = new Set();
+    for (let indice = 0; indice < lines.length; indice++) {
+        const lineNo = indice + 1;
+        for (const regra of REGRAS_SUPRESSAO_FORMATADOR) {
+            if (isRegraSuprimida(regra, lineNo, supressoes)) {
+                protegidas.add(lineNo);
+                break;
+            }
+        }
+    }
+    return protegidas;
+}
 export function normalizarFimDeLinha(code) {
     return code.replace(/\r\n?/g, '\n');
 }
@@ -88,7 +105,7 @@ export function corrigirEspacamentoBasicoCodigo(code) {
         count
     };
 }
-const REPEATABLE_TO_SINGLE = new Set([',', '.', '!', '?', ';']);
+const REPEATABLE_TO_SINGLE = new Set([',', '.', '!', '?']);
 const REPEATABLE_KEEP_UP_TO_3 = new Set(['.', '!', '?']);
 const MULTI_PUNCT_RE = /([,\.!?:;_\-])\1+/g;
 const SPACE_BEFORE_PUNCT_RE = /\s+([,.:;!?])/g;
@@ -214,11 +231,14 @@ function shouldSkipLineForPunctuation(line, lineIndex, lines) {
     }
     return false;
 }
-function collapseRepeatedPunct(code) {
+function collapseRepeatedPunct(code, protectedLines) {
     const lines = code.split('\n');
     let totalCount = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
+        if (protectedLines?.has(idx + 1)) {
+            return line;
+        }
         if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
         }
@@ -280,12 +300,15 @@ function fixDotPunct(match, offset, fullLine) {
     }
     return '. ';
 }
-function fixSpacingAroundPunct(code) {
+function fixSpacingAroundPunct(code, protectedLines) {
     const { text: protected_code, placeholders } = protectSequences(code);
     const lines = protected_code.split('\n');
     let totalChanges = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
+        if (protectedLines?.has(idx + 1)) {
+            return line;
+        }
         if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
         }
@@ -329,11 +352,14 @@ const RELATIONAL_OPS = [{
         pattern: /->/g,
         replacement: '→'
     }];
-function normalizeRelationalOperators(code) {
+function normalizeRelationalOperators(code, protectedLines) {
     const lines = code.split('\n');
     let totalCount = 0;
     let changed = false;
     const out = lines.map((line, idx) => {
+        if (protectedLines?.has(idx + 1)) {
+            return line;
+        }
         if (shouldSkipLineForPunctuation(line, idx, lines)) {
             return line;
         }
@@ -377,24 +403,24 @@ function restoreHtmlComments(code, placeholders) {
 function skipJsonYamlResult(code) {
     return { text: code, changed: false, stats: { pontuacaoRepetida: 0, espacamentoIncorreto: 0, operadoresRelacionais: 0 } };
 }
-export function corrigirPontuacaoECodigo(code) {
+export function corrigirPontuacaoECodigo(code, protectedLines) {
     if (isJsonOrYaml(code)) {
         return skipJsonYamlResult(code);
     }
     const { text: semHtml, placeholders } = extractHtmlComments(code);
-    const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml);
-    const { text: spaced, count: espacamentoIncorreto } = fixSpacingAroundPunct(collapsed);
-    const { text: normalized, count: operadoresRelacionais } = normalizeRelationalOperators(spaced);
+    const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml, protectedLines);
+    const { text: spaced, count: espacamentoIncorreto } = fixSpacingAroundPunct(collapsed, protectedLines);
+    const { text: normalized, count: operadoresRelacionais } = normalizeRelationalOperators(spaced, protectedLines);
     const restored = restoreHtmlComments(normalized, placeholders);
     const changed = pontuacaoRepetida > 0 || espacamentoIncorreto > 0 || operadoresRelacionais > 0;
     return { text: restored, changed, stats: { pontuacaoRepetida, espacamentoIncorreto, operadoresRelacionais } };
 }
-export function corrigirPontuacaoECodigoConservador(code) {
+export function corrigirPontuacaoECodigoConservador(code, protectedLines) {
     if (isJsonOrYaml(code)) {
         return skipJsonYamlResult(code);
     }
     const { text: semHtml, placeholders } = extractHtmlComments(code);
-    const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml);
+    const { text: collapsed, count: pontuacaoRepetida } = collapseRepeatedPunct(semHtml, protectedLines);
     const { text: spaced, count: espacamentoIncorreto } = corrigirEspacamentoBasicoCodigo(collapsed);
     const restored = restoreHtmlComments(spaced, placeholders);
     const changed = pontuacaoRepetida > 0 || espacamentoIncorreto > 0;

package/dist/shared/formatters/formatters/shell.js

@@ -136,13 +136,15 @@ function isIndexInQuotes(line, index) {
             continue;
         }
         if (inSingle) {
-            if (ch === "'")
+            if (ch === "'") {
                 inSingle = false;
+            }
             continue;
         }
         if (inDouble) {
-            if (ch === '"')
+            if (ch === '"') {
                 inDouble = false;
+            }
             continue;
         }
         if (ch === "'") {
@@ -157,8 +159,9 @@ function isIndexInQuotes(line, index) {
     return inSingle || inDouble;
 }
 function isRealShellPipe(line, index) {
-    if (isIndexInQuotes(line, index))
+    if (isIndexInQuotes(line, index)) {
         return false;
+    }
     const before = line.slice(0, index);
     return true;
 }

package/dist/types/analysts/index.js

@@ -5,6 +5,7 @@ export * from './strategists.js';
 export * from './azure-pipelines.js';
 export {} from './circleci.js';
 export * from './corrections.js';
+export * from './css-in-js.js';
 export * from './dynamic-modules.js';
 export * from './github-actions-plugins.js';
 export {} from './github-actions-reports.js';
@@ -14,5 +15,4 @@ export {} from './jenkins.js';
 export * from './metrics.js';
 export * from './plugins.js';
 export * from './scoring.js';
-export * from './css-in-js.js';
 export * from './svg-plugins.js';

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": 1,
+  "close": true
+}

package/docs/.obsidian/workspace.json

@@ -0,0 +1,196 @@
+{
+  "main": {
+    "id": "38cd0250b80f3c65",
+    "type": "split",
+    "children": [
+      {
+        "id": "2dae1c0919723f46",
+        "type": "tabs",
+        "children": [
+          {
+            "id": "d13e1d2e479b3201",
+            "type": "leaf",
+            "state": {
+              "type": "markdown",
+              "state": {
+                "file": "02-componentes/_index.md",
+                "mode": "source",
+                "source": false
+              },
+              "icon": "lucide-file",
+              "title": "_index"
+            }
+          }
+        ]
+      }
+    ],
+    "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": {
+                "collapseAll": false,
+                "extraContext": false,
+                "sortOrder": "alphabetical",
+                "showSearch": false,
+                "searchQuery": "",
+                "backlinkCollapsed": false,
+                "unlinkedCollapsed": true
+              },
+              "icon": "links-coming-in",
+              "title": "Links inversos"
+            }
+          },
+          {
+            "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": "d13e1d2e479b3201",
+  "lastOpenFiles": [
+    "templates/guia.md",
+    "templates/componente.md",
+    "templates/ADR.md",
+    "04-glossario/termos.md",
+    "03-guias/testes.md",
+    "03-guias/contribuindo.md",
+    "02-componentes/_index.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)
+- 222 test files, 3116 testes
+- Coverage total: ~47% (target: 56%+)
+
+## Alternativas Consideradas
+
+- **Jest**: maior ecossistema, mas mais lento e sem ESM nativo
+- **Mocha**: flexível, mas sem built-in coverage e mocking