@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/shared/helpers/suppressao.js

@@ -1,13 +1,32 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Sistema de supressão inline para o Mahoraga
+ * Permite desabilitar regras específicas usando comentários no código
+ *
+ * Formatos suportados (qualquer sintaxe de comentário inline, ex.: //, #, --, ;, <!-- -->, blocos /* ... * /):
+ * - @mahoraga-disable-next-line nome-da-regra
+ * - @mahoraga-disable nome-da-regra
+ * - @mahoraga-enable nome-da-regra
+ */
 import { config } from '../../core/config/index.js';
+// Cache de supressões por conteúdo (evita re-parse do mesmo arquivo para cada analista)
 const supressaoCache = new Map();
+/**
+ * Limpa o cache de supressões (útil entre execuções)
+ */
 export function limparCacheSupressao() {
     supressaoCache.clear();
 }
+/**
+ * Analisa comentários do código fonte para extrair diretivas de supressão
+ * Resultados são cacheados por hash do conteúdo para evitar re-parsing no mesmo arquivo
+ */
 export function extrairSupressoes(src) {
     if (config.ANALISE_CACHE_ENABLED) {
         const cached = supressaoCache.get(src);
-        if (cached)
+        if (cached) {
             return cached;
+        }
     }
     const resultado = extrairSupressoesInterno(src);
     if (config.ANALISE_CACHE_ENABLED && src.length < 1_000_000) {
@@ -21,12 +40,17 @@ function extrairSupressoesInterno(src) {
     const blocosAtivos = new Set();
     const normalizarLinha = (linha) => {
         let trimmed = linha.trim();
-        if (trimmed.startsWith('<!--'))
+        // Remove wrappers de comentários comuns (ordem importa para HTML -> bloco -> linha)
+        if (trimmed.startsWith('<!--')) {
             trimmed = trimmed.replace(/^<!--/, '').replace(/--!?>(\s*)?$/, '').trim();
-        if (trimmed.startsWith('/*'))
+        }
+        if (trimmed.startsWith('/*')) {
             trimmed = trimmed.replace(/^\/\*/, '').replace(/\*\/$/, '').trim();
-        if (trimmed.startsWith('*'))
+        }
+        if (trimmed.startsWith('*')) {
             trimmed = trimmed.replace(/^\*\s?/, '').trim();
+        } // linhas internas de bloco
+        // Comentários de linha: JS/TS, shell/Python, SQL, INI, outros
         trimmed = trimmed.replace(/^\/\//, '').trim();
         trimmed = trimmed.replace(/^#/, '').trim();
         trimmed = trimmed.replace(/^--/, '').trim();
@@ -37,6 +61,7 @@ function extrairSupressoesInterno(src) {
         const linha = linhas[indice];
         const linhaNorm = normalizarLinha(linha);
         const numeroLinha = indice + 1;
+        // @mahoraga-disable-next-line regra1 regra2
         const matchNextLine = linhaNorm.match(/@mahoraga-disable-next-line\s+(.+)/);
         if (matchNextLine) {
             const regras = matchNextLine[1].trim().split(/\s+/);
@@ -49,6 +74,7 @@ function extrairSupressoesInterno(src) {
             });
             continue;
         }
+        // @mahoraga-disable regra1 regra2
         const matchDisable = linhaNorm.match(/@mahoraga-disable\s+(.+)/);
         if (matchDisable) {
             const regras = matchDisable[1].trim().split(/\s+/);
@@ -63,6 +89,7 @@ function extrairSupressoesInterno(src) {
             });
             continue;
         }
+        // @mahoraga-enable regra1 regra2
         const matchEnable = linhaNorm.match(/@mahoraga-enable\s+(.+)/);
         if (matchEnable) {
             const regras = matchEnable[1].trim().split(/\s+/);
@@ -71,14 +98,17 @@ function extrairSupressoesInterno(src) {
             });
             continue;
         }
+        // @mahoraga-disable (desabilita todas as regras)
         if (linhaNorm.includes('@mahoraga-disable-all')) {
             blocosAtivos.add('*');
             continue;
         }
+        // @mahoraga-enable (reabilita todas as regras)
         if (linhaNorm.includes('@mahoraga-enable-all')) {
             blocosAtivos.clear();
             continue;
         }
+        // Se há blocos ativos, aplicar a esta linha
         if (blocosAtivos.size > 0) {
             if (!porLinha.has(numeroLinha)) {
                 porLinha.set(numeroLinha, new Set());
@@ -93,29 +123,38 @@ function extrairSupressoesInterno(src) {
         blocosAtivos
     };
 }
+/**
+ * Verifica se uma regra está suprimida em uma determinada linha
+ */
 export function isRegraSuprimida(regra, linha, supressoes) {
     const regrasDaLinha = supressoes.porLinha.get(linha);
     if (!regrasDaLinha) {
         return false;
     }
+    // Verifica supressão específica da regra
     if (regrasDaLinha.has(regra)) {
         return true;
     }
+    // Verifica supressão global (*)
     if (regrasDaLinha.has('*')) {
         return true;
     }
     return false;
 }
+/**
+ * Filtra ocorrências baseado em supressões inline
+ */
 export function filtrarOcorrenciasSuprimidas(ocorrencias, nomeAnalista, src) {
     const supressoes = extrairSupressoes(src);
     return ocorrencias.filter(ocorrencia => {
         if (!ocorrencia.linha) {
-            return true;
+            return true; // Mantém ocorrências sem linha (não podem ser suprimidas)
         }
-        const _identificadorRegra = ocorrencia.tipo || nomeAnalista || '';
+        // Prioriza tipo específico da ocorrência, depois nome do analista
+        const _identificadorRegra = (ocorrencia.tipo ?? nomeAnalista) || '';
+        // Verifica se está suprimida pelo tipo específico OU pelo nome do analista
         const suprimidaPorTipo = ocorrencia.tipo && isRegraSuprimida(ocorrencia.tipo, ocorrencia.linha, supressoes);
         const suprimidaPorAnalista = isRegraSuprimida(nomeAnalista, ocorrencia.linha, supressoes);
         return !suprimidaPorTipo && !suprimidaPorAnalista;
     });
 }
-//# sourceMappingURL=suppressao.js.map

package/dist/shared/helpers.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para helpers do shared
+ */
+export {};

package/dist/shared/impar.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export {};

package/dist/shared/imports.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para helpers de manipulação de imports
+ * Originalmente em: src/shared/helpers/imports.ts
+ */
+export {};

package/dist/shared/index.js

@@ -1,3 +1,14 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Shared utilities and helpers
+ */
 export * from './context-project.js';
+export * from './helpers.js';
+export * from './impar.js';
+export * from './imports.js';
 export * from './memory.js';
-//# sourceMappingURL=index.js.map
+export * from './persistence.js';
+export * from './structure.js';
+export * from './stylelint.js';
+export * from './validation.js';
+export * from './vitest-alias.js';

package/dist/shared/marketplace/index.js

@@ -1,4 +1,4 @@
+// SPDX-License-Identifier: MIT
 export * from './registry.js';
 export * from './remote.js';
 export * from './versionamento.js';
-//# sourceMappingURL=index.js.map

package/dist/shared/marketplace/registry.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { messages } from '../../core/messages/index.js';
 import { lerEstado, salvarEstado } from '../persistence/index.js';
@@ -5,11 +6,11 @@ const DIRETORIO_PADRAO = '.mahoraga/marketplace';
 const ARQUIVO_ESTADO = 'pacotes-instalados.json';
 const log = messages.log;
 function caminhoEstado() {
-    const dir = process.env.MAHORAGA_MARKETPLACE_DIR || DIRETORIO_PADRAO;
+    const dir = process.env.SUKUNA_MARKETPLACE_DIR ?? DIRETORIO_PADRAO;
     return path.join(process.cwd(), dir, ARQUIVO_ESTADO);
 }
 function caminhoPacote(nome) {
-    const dir = process.env.MAHORAGA_MARKETPLACE_DIR || DIRETORIO_PADRAO;
+    const dir = process.env.SUKUNA_MARKETPLACE_DIR ?? DIRETORIO_PADRAO;
     return path.join(process.cwd(), dir, 'packages', nome);
 }
 export async function listarPacotesInstalados() {
@@ -25,7 +26,7 @@ export async function salvarPacotesInstalados(pacotes) {
 }
 export async function pacoteEstaInstalado(nome) {
     const pacotes = await listarPacotesInstalados();
-    return pacotes?.find(p => p.nome === nome) || null;
+    return pacotes.find(p => p.nome === nome) ?? null;
 }
 export async function instalarPacote(analista, versao, _conteudo) {
     const pacotes = await listarPacotesInstalados();
@@ -81,4 +82,3 @@ export async function buscarPacotesInstalados(termo) {
         p.categoria.toLowerCase().includes(termoLower) ||
         p.tags.some((tag) => tag.toLowerCase().includes(termoLower)));
 }
-//# sourceMappingURL=registry.js.map

package/dist/shared/marketplace/remote.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../core/messages/index.js';
 import { lerEstado } from '../persistence/index.js';
 const log = messages.log;
@@ -5,7 +6,7 @@ const { MarketplaceRemoteMensagens } = messages;
 const DEFAULT_REGISTRIES = [
     {
         nome: 'comunidade',
-        url: 'https://raw.githubusercontent.com/um-atoa/mahoraga-marketplace/main/index.json',
+        url: 'https://raw.githubusercontent.com/o-atoa/mahoraga-marketplace/main/index.json',
         tipo: 'url',
         habilitado: true,
     },
@@ -14,8 +15,9 @@ const CONFIG_PATH = '.mahoraga/marketplace/registries.json';
 async function carregarRegistries() {
     try {
         const configs = await lerEstado(CONFIG_PATH);
-        if (!configs || configs.length === 0)
+        if (!configs || configs.length === 0) {
             return DEFAULT_REGISTRIES;
+        }
         return configs;
     }
     catch {
@@ -29,8 +31,9 @@ export async function buscarNoRegistry(termo, registry) {
     const registries = registry ? [registry] : await carregarRegistries();
     const resultados = [];
     for (const reg of registries) {
-        if (!reg.habilitado)
+        if (!reg.habilitado) {
             continue;
+        }
         try {
             const analistas = await fetchRegistry(reg);
             const filtrados = analistas.filter(a => a.nome.toLowerCase().includes(termo.toLowerCase()) ||
@@ -47,13 +50,15 @@ export async function buscarNoRegistry(termo, registry) {
 export async function obterAnalistaDoRegistry(nome, registry) {
     const registries = registry ? [registry] : await carregarRegistries();
     for (const reg of registries) {
-        if (!reg.habilitado)
+        if (!reg.habilitado) {
             continue;
+        }
         try {
             const analistas = await fetchRegistry(reg);
-            const encontrado = analistas?.find(a => a.nome === nome);
-            if (encontrado)
+            const encontrado = analistas.find(a => a.nome === nome);
+            if (encontrado) {
                 return encontrado;
+            }
         }
         catch {
             continue;
@@ -65,8 +70,9 @@ async function fetchRegistry(reg) {
     switch (reg.tipo) {
         case 'url': {
             const res = await fetch(reg.url);
-            if (!res.ok)
+            if (!res.ok) {
                 throw new Error(MarketplaceRemoteMensagens.httpStatus(res.status));
+            }
             const data = await res.json();
             return data.analistas || [];
         }
@@ -75,11 +81,15 @@ async function fetchRegistry(reg) {
             const res = await fetch(apiUrl, {
                 headers: { Accept: 'application/vnd.github.v3.raw' },
             });
-            if (!res.ok)
+            if (!res.ok) {
                 throw new Error(MarketplaceRemoteMensagens.githubApiHttpStatus(res.status));
+            }
             const data = await res.json();
             return data.analistas || [];
         }
+        case "npm": {
+            throw new Error('Not implemented yet: "npm" case');
+        }
         default:
             return [];
     }
@@ -91,4 +101,3 @@ export async function search(termo) {
 export async function info(nome) {
     return obterAnalistaDoRegistry(nome);
 }
-//# sourceMappingURL=remote.js.map

package/dist/shared/marketplace/versionamento.js

@@ -1,65 +1,85 @@
+// SPDX-License-Identifier: MIT
+/** Parseia string semver e retorna componentes ou null se inválido */
 function parseSemver(versao) {
     const re = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9.]+))?$/;
     const match = versao.match(re);
-    if (!match)
+    if (!match) {
         return null;
+    }
     return { major: parseInt(match[1]), minor: parseInt(match[2]), patch: parseInt(match[3]), pre: match[4] };
 }
+/** Compara duas versões semver. Retorna negativo se a < b, positivo se a > b, 0 se iguais */
 function compareSemver(a, b) {
     const pa = parseSemver(a);
     const pb = parseSemver(b);
-    if (!pa || !pb)
+    if (!pa || !pb) {
         return 0;
-    if (pa.major !== pb.major)
+    }
+    if (pa.major !== pb.major) {
         return pa.major - pb.major;
-    if (pa.minor !== pb.minor)
+    }
+    if (pa.minor !== pb.minor) {
         return pa.minor - pb.minor;
-    if (pa.patch !== pb.patch)
+    }
+    if (pa.patch !== pb.patch) {
         return pa.patch - pb.patch;
-    if (pa.pre && !pb.pre)
+    }
+    if (pa.pre && !pb.pre) {
         return -1;
-    if (!pa.pre && pb.pre)
+    }
+    if (!pa.pre && pb.pre) {
         return 1;
+    }
     return 0;
 }
+/** Verifica se uma versão satisfaz um requisito (^, ~, ou exato) */
 function satisfaz(versao, requisito) {
-    if (requisito === '*' || requisito === 'latest')
+    if (requisito === '*' || requisito === 'latest') {
         return true;
+    }
     if (requisito.startsWith('^')) {
         const base = requisito.slice(1);
         const parsed = parseSemver(base);
-        if (!parsed)
+        if (!parsed) {
             return false;
+        }
         const pv = parseSemver(versao);
-        if (!pv)
+        if (!pv) {
             return false;
+        }
         return pv.major === parsed.major && compareSemver(versao, base) >= 0;
     }
     if (requisito.startsWith('~')) {
         const base = requisito.slice(1);
         const parsed = parseSemver(base);
-        if (!parsed)
+        if (!parsed) {
             return false;
+        }
         const pv = parseSemver(versao);
-        if (!pv)
+        if (!pv) {
             return false;
+        }
         return pv.major === parsed.major && pv.minor === parsed.minor && compareSemver(versao, base) >= 0;
     }
     return versao === requisito;
 }
+/** Retorna a versão mais recente que satisfaz o requisito, ou null */
 export function resolverMelhorVersao(versoes, requisito) {
     const compativeis = versoes.filter(v => satisfaz(v.semver || v.version, requisito));
-    if (compativeis.length === 0)
+    if (compativeis.length === 0) {
         return null;
+    }
     compativeis.sort((a, b) => compareSemver(b.version, a.version));
     return compativeis[0];
 }
+/** Ordena versões da mais recente para a mais antiga */
 export function ordenarVersoes(versoes) {
     return [...versoes].sort((a, b) => compareSemver(b.version, a.version));
 }
+/** Retorna a versão mais recente da lista, ou null se vazia */
 export function versaoMaisRecente(versoes) {
-    if (versoes.length === 0)
+    if (versoes.length === 0) {
         return null;
+    }
     return ordenarVersoes(versoes)[0];
 }
-//# sourceMappingURL=versionamento.js.map

package/dist/shared/memory.js

@@ -1,5 +1,9 @@
+// SPDX-License-Identifier: MIT
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
+/**
+ * Manages conversation memory with persistent storage.
+ */
 export class ConversationMemory {
     maxHistory;
     persistCaminho;
@@ -9,8 +13,9 @@ export class ConversationMemory {
         this.persistCaminho = persistCaminho;
     }
     async init() {
-        if (!this.persistCaminho)
+        if (!this.persistCaminho) {
             return;
+        }
         try {
             const raw = await readFile(this.persistCaminho, 'utf-8');
             this.history = JSON.parse(raw);
@@ -27,8 +32,9 @@ export class ConversationMemory {
         await this.persist();
     }
     getContext(lastN) {
-        if (lastN)
+        if (lastN) {
             return this.history.slice(-lastN);
+        }
         return [...this.history];
     }
     getSummary() {
@@ -45,8 +51,9 @@ export class ConversationMemory {
         await this.persist();
     }
     async persist() {
-        if (!this.persistCaminho)
+        if (!this.persistCaminho) {
             return;
+        }
         const snapshot = [...this.history];
         try {
             await mkdir(dirname(this.persistCaminho), {
@@ -55,9 +62,13 @@ export class ConversationMemory {
             await writeFile(this.persistCaminho, JSON.stringify(snapshot, null, 2), 'utf-8');
         }
         catch {
+            // ignore persist errors
         }
     }
 }
+/**
+ * Manages persistent context memory for Mahoraga runs.
+ */
 export class MahoragaContextMemory {
     maxRuns;
     persistCaminho;
@@ -71,13 +82,15 @@ export class MahoragaContextMemory {
         this.persistCaminho = persistCaminho;
     }
     async init() {
-        if (!this.persistCaminho)
+        if (!this.persistCaminho) {
             return;
+        }
         try {
             const raw = await readFile(this.persistCaminho, 'utf-8');
             const parsed = JSON.parse(raw);
-            if (parsed && parsed.schemaVersion === 1) {
+            if (parsed.schemaVersion === 1) {
                 this.state = {
+                    // @mahoraga-disable: tipo-literal-inline-complexo
                     schemaVersion: 1,
                     lastRuns: Array.isArray(parsed.lastRuns) ? parsed.lastRuns : [],
                     preferences: parsed.preferences && typeof parsed.preferences === 'object' ? parsed.preferences : {}
@@ -85,10 +98,12 @@ export class MahoragaContextMemory {
             }
         }
         catch {
+            // mantém defaults
         }
     }
     getState() {
         return {
+            // @mahoraga-disable: tipo-literal-inline-complexo
             schemaVersion: 1,
             lastRuns: [...this.state.lastRuns],
             preferences: {
@@ -124,8 +139,9 @@ export class MahoragaContextMemory {
     }
     async recordRunEnd(id, update) {
         const idx = this.state.lastRuns.findIndex(raiz => raiz.id === id);
-        if (idx === -1)
+        if (idx === -1) {
             return;
+        }
         const prev = this.state.lastRuns[idx];
         this.state.lastRuns[idx] = {
             ...prev,
@@ -142,8 +158,9 @@ export class MahoragaContextMemory {
         await this.persist();
     }
     async persist() {
-        if (!this.persistCaminho)
+        if (!this.persistCaminho) {
             return;
+        }
         try {
             await mkdir(dirname(this.persistCaminho), {
                 recursive: true
@@ -151,10 +168,12 @@ export class MahoragaContextMemory {
             await writeFile(this.persistCaminho, JSON.stringify(this.state, null, 2), 'utf-8');
         }
         catch {
+            // ignore persist errors
         }
     }
 }
 export async function getDefaultMemory() {
+    // Preferimos memória por projeto (cwd) para evitar misturar repositórios.
     const persistCaminho = join(process.cwd(), '.mahoraga', 'history.json');
     const mem = new ConversationMemory(10, persistCaminho);
     await mem.init();
@@ -166,4 +185,3 @@ export async function getDefaultContextMemory() {
     await mem.init();
     return mem;
 }
-//# sourceMappingURL=memory.js.map

package/dist/shared/persistence/index.js

@@ -1,2 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Persistence utilities for data storage
+ */
 export * from './persistence.js';
-//# sourceMappingURL=index.js.map