@fontdata/ai-harness 2.7.0 → 3.1.0

package/dist/update/update.js

@@ -2,15 +2,15 @@ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync
 import { dirname, join, resolve } from 'node:path';
 import { allCommands, loadCatalog } from '../catalog.js';
 import { commentsHooksConfig, ensureCommentsBaseline } from '../comentarios/instalar.js';
-import { CONFIG_PATH, gravarRegistrarMcp, readConfig, syncGitignore, writeDefaultConfig } from '../config/config.js';
+import { CONFIG_PATH, gravarRegistrarMcp, migrarSecaoBanco, readConfig, syncGitignore, temSecaoBancoLegada, writeDefaultConfig, } from '../config/config.js';
 import { applyAtomically } from '../install/atomic.js';
 import { suggestFlag } from '../install/flags.js';
 import { HOOKS_ITEM_ID, isHarnessPluginEnabled, projectHooksConfig } from '../install/hooks.js';
-import { bancoMcpServer, ehEntradaGerenciada, MCP_PATH, mergeMcpServers } from '../install/mcp.js';
+import { BANCO_MCP_NOME, BANCO_MCP_NOME_LEGADO, bancoMcpServer, ehEntradaGerenciada, MCP_PATH, mergeMcpServers } from '../install/mcp.js';
 import { hashContent, LOCK_PATH, LOCK_VERSION, readLock, writeLock } from '../install/lock.js';
 import { itemSources, packageInfo, PROJECT_RULE_PATH, projectRuleContent } from '../install/plan.js';
 import { neededSkillsFor } from '../install/selection.js';
-import { combineHooks, HARNESS_DENY, HARNESS_PERMISSIONS, hasAllowRule, mergeSettings } from '../install/settings.js';
+import { BANCO_PERMISSIONS_LEGADAS, combineHooks, HARNESS_DENY, harnessPermissions, hasAllowRule, mergeSettings, SETTINGS_PATH, } from '../install/settings.js';
 import { adoptLegacyInstall } from './legado.js';
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -32,7 +32,9 @@ function mcpChange(root, versao) {
     const servers = parsed.mcpServers === undefined ? {} : parsed.mcpServers;
     if (!isPlainObject(servers))
         return 'invalido';
-    const atual = servers.banco;
+    if (ehEntradaGerenciada(servers[BANCO_MCP_NOME_LEGADO]))
+        return 'renomear';
+    const atual = servers[BANCO_MCP_NOME];
     if (atual === undefined)
         return 'faltando';
     const pin = bancoMcpServer(versao).args.find((arg) => arg.startsWith('@fontdata/'));
@@ -136,11 +138,13 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
         addItem('rule', 'comentarios', true);
         addItem('hook', 'comentarios', true);
     }
+    const registrarMcpConfig = readConfig(root).config.banco_dados.registrar_mcp;
+    const permissoesBanco = !semBanco && registrarMcpConfig;
     const permissoesFaltando = [
-        ...HARNESS_PERMISSIONS.filter((rule) => !hasAllowRule(root, rule)),
+        ...harnessPermissions({ banco: permissoesBanco }).filter((rule) => !hasAllowRule(root, rule)),
         ...HARNESS_DENY.filter((rule) => !hasAllowRule(root, rule, 'deny')).map((rule) => `deny ${rule}`),
     ];
-    const registrarMcpConfig = readConfig(root).config.banco.registrar_mcp;
+    const permissoesLegadas = BANCO_PERMISSIONS_LEGADAS.filter((rule) => hasAllowRule(root, rule));
     const registrarMcp = !semBanco && registrarMcpConfig && !isHarnessPluginEnabled(root, home);
     return {
         changes,
@@ -151,9 +155,12 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
         registrarComentarios: adotada,
         permissaoAusente: permissoesFaltando.length > 0,
         permissoesFaltando,
+        permissoesLegadas,
+        permissoesBanco,
         registrarMcp,
         mudancaMcp: registrarMcp ? mcpChange(root, packageInfo().versao) : null,
         recusarMcp: semBanco && registrarMcpConfig,
+        renomearSecaoBanco: temSecaoBancoLegada(root),
     };
 }
 /**
@@ -192,7 +199,10 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
         return { de: path, para };
     });
     const hooks = combineHooks(report.registrarHooks ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {});
-    mergeSettings(root, { hooks, allow: HARNESS_PERMISSIONS, deny: HARNESS_DENY }, now);
+    const ajustes = [];
+    const settings = mergeSettings(root, { hooks, allow: harnessPermissions({ banco: report.permissoesBanco }), deny: HARNESS_DENY, removeAllow: BANCO_PERMISSIONS_LEGADAS }, now);
+    if (settings.changed)
+        ajustes.push(`${SETTINGS_PATH} atualizado${settings.backup ? ` (backup em ${settings.backup})` : ''}.`);
     if (report.registrarComentarios)
         ensureCommentsBaseline(root);
     if (report.adotada) {
@@ -211,14 +221,23 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
     else if (report.registrarMcp) {
         // Uma falha no .mcp.json nunca deixa o update pela metade, sem lock.
         try {
-            mergeMcpServers(root, { banco: bancoMcpServer(pkg.versao) }, now, { atualizarGerenciada: true });
+            const mcp = mergeMcpServers(root, { [BANCO_MCP_NOME]: bancoMcpServer(pkg.versao) }, now, {
+                atualizarGerenciada: true,
+                removerGerenciadas: [BANCO_MCP_NOME_LEGADO],
+            });
+            if (mcp.changed)
+                ajustes.push(`${MCP_PATH} com mcpServers.${BANCO_MCP_NOME} na versão ${pkg.versao}${mcp.backup ? ` (backup em ${mcp.backup})` : ''}.`);
         }
         catch (error) {
             avisos.push(error instanceof Error ? error.message : String(error));
         }
     }
-    if (report.recusarMcp)
+    if (report.renomearSecaoBanco && migrarSecaoBanco(root))
+        ajustes.push(`seção banco renomeada para banco_dados em ${CONFIG_PATH}.`);
+    if (report.recusarMcp) {
         gravarRegistrarMcp(root, false);
+        ajustes.push(`banco_dados.registrar_mcp: false gravado em ${CONFIG_PATH}.`);
+    }
     const itemOf = new Map(report.changes.map((change) => [change.caminho, change.item]));
     const writtenHash = new Map(write.map((file) => [file.path, hashContent(file.content)]));
     const dropped = new Set([...remove, ...report.stale, ...legacy]);
@@ -252,13 +271,14 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
         itens.push({ ...added, arquivos: added.arquivos.sort((a, b) => a.caminho.localeCompare(b.caminho)) });
     }
     writeLock(root, { lock_versao: LOCK_VERSION, pacote: pkg, gerado_em: now.toISOString(), itens });
-    return { written: write.map((file) => file.path), removed: remove, kept, renamed, avisos };
+    return { written: write.map((file) => file.path), removed: remove, kept, renamed, avisos, ajustes };
 }
 const MCP_INVALIDO = `O ${MCP_PATH} está com JSON inválido: o registro do MCP de banco foi pulado e o arquivo não foi tocado. Corrija-o e rode o update de novo.`;
 const MCP_DESCRIPTIONS = {
     ausente: 'não existe',
-    faltando: 'não tem a entrada banco',
-    versao: 'fixa outra versão do servidor banco',
+    faltando: `não tem a entrada ${BANCO_MCP_NOME}`,
+    versao: `fixa outra versão do servidor ${BANCO_MCP_NOME}`,
+    renomear: `tem a entrada ${BANCO_MCP_NOME_LEGADO} do harness, com o nome antigo; ela é trocada pela ${BANCO_MCP_NOME}`,
 };
 const DESCRIPTIONS = {
     novo: 'novo no pacote, será gravado',
@@ -283,27 +303,32 @@ export function describeUpdate(report) {
             `Faltam permissões do harness em .claude/settings.json (${report.permissoesFaltando.join(', ')}); o --yes as acrescenta.`,
         ]
         : [];
+    const legadas = report.permissoesLegadas.length
+        ? [`Permissões do MCP de banco com o nome antigo em .claude/settings.json (${report.permissoesLegadas.join(', ')}); o --yes as remove.`]
+        : [];
     const mcp = [
         ...(report.mudancaMcp === 'invalido'
             ? [`O ${MCP_PATH} está com JSON inválido; o --yes pula o registro do MCP de banco e não toca no arquivo.`]
             : report.mudancaMcp
-                ? [`O ${MCP_PATH} ${MCP_DESCRIPTIONS[report.mudancaMcp]}; o --yes grava mcpServers.banco na versão ${packageInfo().versao}.`]
+                ? [`O ${MCP_PATH} ${MCP_DESCRIPTIONS[report.mudancaMcp]}; o --yes grava mcpServers.${BANCO_MCP_NOME} na versão ${packageInfo().versao}.`]
                 : []),
-        ...(report.recusarMcp ? [`--sem-banco: o --yes grava banco.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
+        ...(report.renomearSecaoBanco ? [`A seção banco de ${CONFIG_PATH} agora se chama banco_dados; o --yes a renomeia.`] : []),
+        ...(report.recusarMcp ? [`--sem-banco-dados: o --yes grava banco_dados.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
     ];
     if (!report.changes.length) {
-        const status = adopted.length || permission.length || mcp.length ? 'Nenhum arquivo a atualizar.' : 'A instalação está em dia: nenhum arquivo a atualizar.';
-        return [...adopted, ...permission, ...mcp, status].join('\n');
+        const status = adopted.length || permission.length || legadas.length || mcp.length ? 'Nenhum arquivo a atualizar.' : 'A instalação está em dia: nenhum arquivo a atualizar.';
+        return [...adopted, ...permission, ...legadas, ...mcp, status].join('\n');
     }
     return [
         ...adopted,
         ...permission,
+        ...legadas,
         ...mcp,
         `Mudanças em relação ao pacote ${packageInfo().versao} (instalado: ${report.lock.pacote.versao}):`,
         ...report.changes.map((change) => `  ${change.tipo.padEnd(16)} ${change.caminho}${change.destino ? ` → ${change.destino}` : ''}  (${DESCRIPTIONS[change.tipo]})`),
     ].join('\n');
 }
-const UPDATE_FLAGS = ['--check', '--yes', '-y', '--sim', '--forcar', '--sem-banco'];
+const UPDATE_FLAGS = ['--check', '--yes', '-y', '--sim', '--forcar', '--sem-banco-dados'];
 export function parseUpdateArgs(argv) {
     const args = { path: undefined, check: false, yes: false, force: false, semBanco: false };
     for (const token of argv) {
@@ -316,7 +341,7 @@ export function parseUpdateArgs(argv) {
             args.check = true;
         else if (token === '--forcar')
             args.force = true;
-        else if (token === '--sem-banco')
+        else if (token === '--sem-banco-dados')
             args.semBanco = true;
         else if (token === '--yes' || token === '-y' || token === '--sim')
             args.yes = true;
@@ -327,7 +352,7 @@ export function parseUpdateArgs(argv) {
     }
     return args;
 }
-/** `ai-harness update [caminho] [--check] [--yes] [--forcar] [--sem-banco]`; sem `--yes` só simula. */
+/** `ai-harness update [caminho] [--check] [--yes] [--forcar] [--sem-banco-dados]`; sem `--yes` só simula. */
 export function runUpdateCommand(argv) {
     const args = parseUpdateArgs(argv);
     const root = resolve(process.cwd(), args.path ?? '.');
@@ -336,7 +361,7 @@ export function runUpdateCommand(argv) {
     const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco });
     console.log(describeUpdate(report));
     // Sem arquivo a atualizar, a adoção ainda grava o lock, e a permissão e o MCP ainda são acrescentados.
-    const pendente = report.adotada || report.permissaoAusente || report.mudancaMcp !== null || report.recusarMcp;
+    const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.renomearSecaoBanco;
     if (args.check || (!report.changes.length && !pendente))
         return 0;
     if (!args.yes) {
@@ -347,6 +372,8 @@ export function runUpdateCommand(argv) {
     const result = applyUpdate(root, report, { force: args.force }, packageInfo());
     console.log(`\nAtualização aplicada: ${result.written.length} gravado(s), ${result.removed.length} apagado(s), ` +
         `${result.renamed.length} renomeado(s), ${result.kept.length} preservado(s).`);
+    for (const ajuste of result.ajustes)
+        console.log(`Gravado: ${ajuste}`);
     for (const aviso of result.avisos)
         console.log(`Aviso: ${aviso}`);
     if (result.renamed.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fontdata/ai-harness",
-  "version": "2.7.0",
+  "version": "3.1.0",
   "description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
   "type": "module",
   "bin": {