@fontdata/ai-harness 2.7.0 → 3.0.0

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "2.7.0",
+  "version": "3.0.0",
   "mcpServers": {
-    "banco": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@2.7.0", "banco-mcp"] }
+    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.0.0", "banco-dados-mcp"] }
   },
   "description": "Harness de engenharia com IA da Fontdata para Claude Code",
   "author": { "name": "Fontdata" },

package/README.md

@@ -96,7 +96,7 @@ npx @fontdata/ai-harness init --comandos resolver-bug,nova-tarefa --sem-harness
 | `--sem-harness` | Não inclui o comando-mestre `/harness` |
 | `--sem-hooks` / `--sem-agents` | Não instala hooks / agents |
 | `--sem-comentarios` | Não instala a rule de comentários, o hook e a catraca do legado |
-| `--sem-banco` | Não registra o servidor MCP de banco no `.mcp.json` e lembra a recusa no config |
+| `--sem-banco-dados` | Não registra o servidor MCP de banco no `.mcp.json` e lembra a recusa no config |
 | `--claude-md criar\|manter\|backup\|sobrescrever` | O que fazer com o `CLAUDE.md` (padrão: `criar`) |
 | `--conflito sobrescrever\|pular` | Arquivos que já existem (padrão: `pular`) |
 | `--yes` | Aplica; sem ele, só simula |
@@ -129,26 +129,26 @@ da conexão e o nome da variável de ambiente (`dsn_env`), e cada dev guarda o D
 `.claude/settings.local.json` (fora do git), no `.env` ou no ambiente:
 
 ```bash
-npx @fontdata/ai-harness banco adicionar erp --projeto   # pergunta os dados, testa e grava ERP_DATABASE_URL
-npx @fontdata/ai-harness banco testar
+npx @fontdata/ai-harness banco-dados adicionar erp --projeto   # pergunta os dados, testa e grava ERP_DATABASE_URL
+npx @fontdata/ai-harness banco-dados testar
 ```
 
-O `adicionar --projeto` grava `{ "nome": "erp", "dsn_env": "ERP_DATABASE_URL" }` em `banco.conexoes` e a variável
+O `adicionar --projeto` grava `{ "nome": "erp", "dsn_env": "ERP_DATABASE_URL" }` em `banco_dados.conexoes` e a variável
 no `.claude/settings.local.json`. Faça commit do `config.json`; cada colega roda o mesmo comando, que grava só a
 variável. `"producao": true` na entrada vale para a equipe toda. Quem prefere um cadastro por máquina
-(`~/.config/ai-harness/conexoes.json`) usa `banco adicionar erp-dev` sem `--projeto` e `banco usar erp-dev` no
+(`~/.config/ai-harness/conexoes.json`) usa `banco-dados adicionar erp-dev` sem `--projeto` e `banco-dados usar erp-dev` no
 projeto.
 
-O servidor MCP `banco` entrega ao Claude `listar_conexoes`, `listar_tabelas`, `descrever_tabela` e `consultar`,
-tudo somente leitura. Ele vem no plugin; sem plugin, o `init` e o `update` o registram no `.mcp.json` (`--sem-banco`
-pula). Conexão de produção nasce bloqueada. Use um usuário de banco só com leitura.
+O servidor MCP `banco_dados` entrega ao Claude `listar_conexoes`, `listar_tabelas`, `descrever_tabela` e
+`consultar`, tudo somente leitura. Ele vem no plugin; sem plugin, o `init` e o `update` o registram no `.mcp.json`
+(`--sem-banco-dados` pula). Conexão de produção nasce bloqueada. Use um usuário de banco só com leitura.
 
 Os dados pessoais (CPF, CNPJ, e-mail, telefone, nome, endereço e afins) saem com **mascaramento LGPD**, feito no
 servidor antes de a resposta chegar ao Claude; os filtros rodam sobre o dado real. Por isso a `consultar` fica
 liberada nas permissões, sem pedir aprovação. Falsos positivos e colunas extras se ajustam em
-`banco.lgpd.liberar_colunas` e `banco.lgpd.mascarar_colunas`; desligar, só no cadastro da máquina. Conexões do
+`banco_dados.lgpd.liberar_colunas` e `banco_dados.lgpd.mascarar_colunas`; desligar, só no cadastro da máquina. Conexões do
 projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas frequentes estão no
-[guia de banco de dados](docs/guias/banco-de-dados.md).
+[guia de banco de dados](docs/guias/banco-dados.md).
 
 ## Subcomandos do CLI
 
@@ -161,8 +161,8 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
 | `memoria [caminho]` | Índice de quem mexeu em cada arquivo (`--arquivo <caminho>`, `--regressao <id>`) |
 | `evento <evento>` | Grava no rastro do trabalho (usado por fluxos e agents) |
 | `conflitos <id>` | Aponta trabalhos em execução que mexem nos mesmos arquivos; `--aguardar` espera liberar (usado pelo `/executar-plan`) |
-| `banco <subcomando>` | Conexões de banco somente leitura: `adicionar`, `listar`, `testar`, `usar`, `remover` |
-| `banco-mcp` | Servidor MCP de leitura do banco, iniciado pelo Claude Code |
+| `banco-dados <subcomando>` | Conexões de banco somente leitura: `adicionar`, `listar`, `testar`, `usar`, `remover` |
+| `banco-dados-mcp` | Servidor MCP de leitura do banco, iniciado pelo Claude Code |
 | `comentarios [caminho]` | Instala o hook do padrão de comentários com a catraca do legado (`--yes`) |
 | `list` | Lista o catálogo |
 

package/dist/{banco → banco-dados}/command.js

@@ -2,23 +2,23 @@ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { EOL } from 'node:os';
 import { join, resolve } from 'node:path';
 import * as p from '@clack/prompts';
-import { CONFIG_PATH, gravarConexaoProjeto, readConfig, REGRA_DSN_ENV, REGRA_NOME_CONEXAO, validarConfigParaEscrita, writeDefaultConfig, } from '../config/config.js';
+import { comSecaoBanco, CONFIG_PATH, gravarConexaoProjeto, readConfig, REGRA_DSN_ENV, REGRA_NOME_CONEXAO, secaoBanco, validarConfigParaEscrita, writeDefaultConfig, } from '../config/config.js';
 import { suggestFlag } from '../install/flags.js';
 import { caminhoCadastro, lerCadastro, ocultarSenha, removerConexao, resumirConexao, salvarConexao, TIPOS_BANCO, } from './cadastro.js';
 import { gravarVariavelSettingsLocal, lerEnvSettingsLocal, lerVariavel, SETTINGS_LOCAL_PATH, validarSettingsLocal } from './ambiente.js';
 import { interpretarDsn, resolverConexoes } from './conexao.js';
 import { criarDriver as criarDriverPadrao } from './drivers/index.js';
 const AJUDA = [
-    'Uso: ai-harness banco <subcomando>',
+    'Uso: ai-harness banco-dados <subcomando>',
     '',
     '  adicionar <nome> [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
     '                     cadastra a conexão nesta máquina (sem --dsn, pergunta os dados)',
     '  adicionar <nome> --projeto [--env <VAR>] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
     '                     grava o DSN na variável <NOME>_DATABASE_URL (ou --env) do .claude/settings.local.json',
-    '                     e a conexão { nome, dsn_env } em banco.conexoes do .ai-harness/config.json',
+    '                     e a conexão { nome, dsn_env } em banco_dados.conexoes do .ai-harness/config.json',
     '  listar             mostra as conexões cadastradas e as do projeto, sem a senha',
     '  testar [nome]      testa a conexão pedida ou todas as do projeto',
-    '  usar <nome...>     grava banco.conexoes no .ai-harness/config.json (mantém as entradas { nome, dsn_env })',
+    '  usar <nome...>     grava banco_dados.conexoes no .ai-harness/config.json (mantém as entradas { nome, dsn_env })',
     '  remover <nome>     apaga a conexão do cadastro',
 ].join(EOL);
 const PORTA_PADRAO = { postgres: '5432', mariadb: '3306' };
@@ -121,7 +121,7 @@ async function adicionar(ctx, argv) {
     const { posicionais, marcadas, valores } = lerArgumentos(argv, ['--producao', '--sem-testar', '--substituir', '--projeto'], ['--dsn', '--env']);
     const [nome, ...sobra] = posicionais;
     if (!nome || sobra.length > 0)
-        throw new Error('Uso: ai-harness banco adicionar <nome> [--projeto [--env <VAR>]] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]');
+        throw new Error('Uso: ai-harness banco-dados adicionar <nome> [--projeto [--env <VAR>]] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]');
     if (marcadas.has('--projeto'))
         return adicionarNoProjeto(ctx, nome, marcadas, valores);
     if (valores['--env'] !== undefined)
@@ -144,25 +144,25 @@ async function adicionar(ctx, argv) {
     }
     salvarConexao(nome, conexao, { substituir, caminho: ctx.cadastro });
     ctx.log(`Conexão ${nome} gravada em ${ctx.cadastro}: ${resumirConexao(conexao)}${conexao.producao ? ' (produção)' : ''}.`);
-    ctx.log(`No projeto, rode: npx @fontdata/ai-harness banco usar ${nome}`);
+    ctx.log(`No projeto, rode: npx @fontdata/ai-harness banco-dados usar ${nome}`);
     return 0;
 }
-/** Procura o nome no JSON bruto de banco.conexoes; recusa lista inválida antes de qualquer gravação. */
+/** Procura o nome no JSON bruto de banco_dados.conexoes; recusa lista inválida antes de qualquer gravação. */
 function entradaDeclarada(cwd, nome) {
     validarConfigParaEscrita(cwd);
     const arquivo = join(cwd, CONFIG_PATH);
     if (!existsSync(arquivo))
         return { forma: 'ausente' };
     const dados = JSON.parse(readFileSync(arquivo, 'utf8'));
-    const banco = isObject(dados) && isObject(dados.banco) ? dados.banco : {};
+    const banco = isObject(dados) ? secaoBanco(dados) : {};
     if (banco.conexoes === undefined)
         return { forma: 'ausente' };
     if (!Array.isArray(banco.conexoes))
-        throw new Error(`banco.conexoes em ${CONFIG_PATH} não é uma lista; corrija-o antes de gravar a conexão ${nome}.`);
+        throw new Error(`banco_dados.conexoes em ${CONFIG_PATH} não é uma lista; corrija-o antes de gravar a conexão ${nome}.`);
     const achada = banco.conexoes.some((entrada) => (isObject(entrada) ? entrada.nome : entrada) === nome);
     if (!achada)
         return { forma: 'ausente' };
-    const conexao = readConfig(cwd).config.banco.projeto[nome];
+    const conexao = readConfig(cwd).config.banco_dados.projeto[nome];
     return conexao ? { forma: 'objeto', conexao } : { forma: 'outra' };
 }
 function variavelPadrao(nome) {
@@ -183,7 +183,7 @@ async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
     const declarada = entradaDeclarada(ctx.cwd, nome);
     let variavel = pedida ?? variavelPadrao(nome);
     if (declarada.forma === 'outra' && !substituir) {
-        ctx.erro(`A conexão ${nome} já está em banco.conexoes de ${CONFIG_PATH} sem dsn_env. Use --substituir para trocá-la pela conexão do projeto.`);
+        ctx.erro(`A conexão ${nome} já está em banco_dados.conexoes de ${CONFIG_PATH} sem dsn_env. Use --substituir para trocá-la pela conexão do projeto.`);
         return 1;
     }
     if (declarada.forma === 'objeto') {
@@ -234,7 +234,7 @@ async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
     const { changed } = gravarVariavelSettingsLocal(ctx.cwd, variavel, valor);
     ctx.log(changed ? `Variável ${variavel} gravada em ${SETTINGS_LOCAL_PATH}.` : `Variável ${variavel} já estava com esse valor em ${SETTINGS_LOCAL_PATH}.`);
     if (declarada.forma === 'objeto' && !promover) {
-        ctx.log(`Conexão ${nome} já declarada em banco.conexoes de ${CONFIG_PATH}; a entrada não foi alterada.`);
+        ctx.log(`Conexão ${nome} já declarada em banco_dados.conexoes de ${CONFIG_PATH}; a entrada não foi alterada.`);
         return 0;
     }
     const entrada = declarada.forma === 'objeto'
@@ -246,7 +246,7 @@ async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
             ...(producao ? { producao: true } : {}),
         };
     gravarConexaoProjeto(ctx.cwd, entrada, { substituir: declarada.forma !== 'ausente' });
-    ctx.log(`Conexão ${nome} gravada em banco.conexoes de ${CONFIG_PATH} (dsn_env ${variavel})${entrada.producao ? ', produção' : ''}.`);
+    ctx.log(`Conexão ${nome} gravada em banco_dados.conexoes de ${CONFIG_PATH} (dsn_env ${variavel})${entrada.producao ? ', produção' : ''}.`);
     if (declarada.forma === 'ausente')
         ctx.log(`Versione o ${CONFIG_PATH}; cada colega define ${variavel} no próprio ambiente.`);
     return 0;
@@ -257,10 +257,10 @@ function listar(ctx, argv) {
     for (const problema of problemas)
         ctx.erro(problema);
     const { config } = readConfig(ctx.cwd);
-    const doProjeto = config.banco.conexoes.flatMap((nome) => config.banco.projeto[nome] ?? []);
+    const doProjeto = config.banco_dados.conexoes.flatMap((nome) => config.banco_dados.projeto[nome] ?? []);
     const nomes = Object.keys(conexoes).sort();
     if (nomes.length === 0 && doProjeto.length === 0) {
-        ctx.log(`Nenhuma conexão cadastrada em ${ctx.cadastro}. Cadastre com: npx @fontdata/ai-harness banco adicionar <nome>`);
+        ctx.log(`Nenhuma conexão cadastrada em ${ctx.cadastro}. Cadastre com: npx @fontdata/ai-harness banco-dados adicionar <nome>`);
         return 0;
     }
     for (const nome of nomes) {
@@ -291,16 +291,16 @@ function listar(ctx, argv) {
 async function testar(ctx, argv) {
     const { posicionais } = lerArgumentos(argv, []);
     if (posicionais.length > 1)
-        throw new Error('Uso: ai-harness banco testar [nome]');
+        throw new Error('Uso: ai-harness banco-dados testar [nome]');
     const [nome] = posicionais;
     const cadastro = lerCadastro(ctx.cadastro);
-    const doProjeto = nome !== undefined && nome in readConfig(ctx.cwd).config.banco.projeto;
+    const doProjeto = nome !== undefined && nome in readConfig(ctx.cwd).config.banco_dados.projeto;
     let alvos;
     let ok = true;
     if (nome !== undefined && !doProjeto) {
         const conexao = cadastro.conexoes[nome];
         if (!conexao) {
-            ctx.erro(`Conexão ${nome} não encontrada em ${ctx.cadastro}; rode banco adicionar ${nome}.`);
+            ctx.erro(`Conexão ${nome} não encontrada em ${ctx.cadastro}; rode banco-dados adicionar ${nome}.`);
             return 1;
         }
         alvos = [{ nome, ...conexao }];
@@ -313,7 +313,7 @@ async function testar(ctx, argv) {
             for (const problema of resolvidas.problemas)
                 ctx.erro(problema);
         for (const faltando of resolvidas.faltando.filter((item) => nome === undefined || item === nome)) {
-            ctx.erro(`Conexão ${faltando} não encontrada nesta máquina; rode banco adicionar ${faltando}.`);
+            ctx.erro(`Conexão ${faltando} não encontrada nesta máquina; rode banco-dados adicionar ${faltando}.`);
             ok = false;
         }
         for (const ausente of resolvidas.variaveisAusentes.filter(pedida)) {
@@ -327,7 +327,7 @@ async function testar(ctx, argv) {
         }
         alvos = resolvidas.conexoes.filter(pedida);
         if (alvos.length === 0 && ok) {
-            ctx.erro('Nenhuma conexão de banco configurada neste projeto; rode npx @fontdata/ai-harness banco usar <nome>.');
+            ctx.erro('Nenhuma conexão de banco configurada neste projeto; rode npx @fontdata/ai-harness banco-dados usar <nome>.');
             return 1;
         }
     }
@@ -346,7 +346,7 @@ async function testar(ctx, argv) {
 function usar(ctx, argv) {
     const { posicionais: nomes } = lerArgumentos(argv, []);
     if (nomes.length === 0)
-        throw new Error('Uso: ai-harness banco usar <nome...>');
+        throw new Error('Uso: ai-harness banco-dados usar <nome...>');
     writeDefaultConfig(ctx.cwd);
     const arquivo = join(ctx.cwd, CONFIG_PATH);
     let dados;
@@ -354,11 +354,11 @@ function usar(ctx, argv) {
         dados = JSON.parse(readFileSync(arquivo, 'utf8'));
     }
     catch (erro) {
-        throw new Error(`${CONFIG_PATH} está com JSON inválido (${erro.message}); corrija antes de rodar banco usar.`);
+        throw new Error(`${CONFIG_PATH} está com JSON inválido (${erro.message}); corrija antes de rodar banco-dados usar.`);
     }
     if (!isObject(dados))
-        throw new Error(`${CONFIG_PATH} precisa ser um objeto JSON; corrija antes de rodar banco usar.`);
-    const banco = isObject(dados.banco) ? dados.banco : {};
+        throw new Error(`${CONFIG_PATH} precisa ser um objeto JSON; corrija antes de rodar banco-dados usar.`);
+    const banco = secaoBanco(dados);
     const objetos = new Map();
     for (const entrada of Array.isArray(banco.conexoes) ? banco.conexoes : []) {
         if (isObject(entrada) && typeof entrada.nome === 'string' && !objetos.has(entrada.nome))
@@ -366,12 +366,12 @@ function usar(ctx, argv) {
     }
     const unicos = [...new Set(nomes)];
     const proximas = unicos.map((nome) => objetos.get(nome) ?? nome);
-    writeFileSync(arquivo, `${JSON.stringify({ ...dados, banco: { ...banco, conexoes: proximas } }, null, 2)}\n`);
-    ctx.log(`banco.conexoes em ${CONFIG_PATH}: ${unicos.join(', ')}.`);
+    writeFileSync(arquivo, `${JSON.stringify(comSecaoBanco(dados, { ...banco, conexoes: proximas }), null, 2)}\n`);
+    ctx.log(`banco_dados.conexoes em ${CONFIG_PATH}: ${unicos.join(', ')}.`);
     const { conexoes } = lerCadastro(ctx.cadastro);
     const ausentes = unicos.filter((nome) => !(nome in conexoes) && !objetos.has(nome));
     if (ausentes.length > 0) {
-        ctx.erro(`Aviso: sem cadastro nesta máquina para ${ausentes.join(', ')}; rode banco adicionar <nome> para cada uma.`);
+        ctx.erro(`Aviso: sem cadastro nesta máquina para ${ausentes.join(', ')}; rode banco-dados adicionar <nome> para cada uma.`);
     }
     return 0;
 }
@@ -379,7 +379,7 @@ function remover(ctx, argv) {
     const { posicionais } = lerArgumentos(argv, []);
     const [nome, ...sobra] = posicionais;
     if (!nome || sobra.length > 0)
-        throw new Error('Uso: ai-harness banco remover <nome>');
+        throw new Error('Uso: ai-harness banco-dados remover <nome>');
     if (!removerConexao(nome, ctx.cadastro)) {
         ctx.erro(`Conexão ${nome} não existe em ${ctx.cadastro}.`);
         return 1;
@@ -387,7 +387,7 @@ function remover(ctx, argv) {
     ctx.log(`Conexão ${nome} removida de ${ctx.cadastro}.`);
     return 0;
 }
-/** `ai-harness banco <subcomando>`: cadastro de conexões da máquina e escolha das conexões do projeto. */
+/** `ai-harness banco-dados <subcomando>`: cadastro de conexões da máquina e escolha das conexões do projeto. */
 export async function runBancoCommand(argv, opcoes = {}) {
     const saida = opcoes.saida ?? { log: (texto) => console.log(texto), erro: (texto) => console.error(texto) };
     const cadastro = opcoes.caminhoCadastro ?? caminhoCadastro();
@@ -420,7 +420,7 @@ export async function runBancoCommand(argv, opcoes = {}) {
                 return 0;
             default:
                 if (subcomando !== undefined)
-                    ctx.erro(`Subcomando desconhecido: banco ${subcomando}`);
+                    ctx.erro(`Subcomando desconhecido: banco-dados ${subcomando}`);
                 ctx.erro(AJUDA);
                 return 1;
         }

package/dist/{banco → banco-dados}/conexao.js

@@ -72,7 +72,7 @@ function resolverDoProjeto(declarada, raiz, env, saida) {
     saida.descartadas.push({ nome, motivo });
     saida.problemas.push(`Conexão ${nome} descartada: ${motivo}.`);
 }
-/** Percorre banco.conexoes na ordem; sem a lista declarada no projeto, vale o DATABASE_URL do .env como a conexão `env`. */
+/** Percorre banco_dados.conexoes na ordem; sem a lista declarada no projeto, vale o DATABASE_URL do .env como a conexão `env`. */
 export function resolverConexoes(raiz, opcoes = {}) {
     const { config, problems } = readConfig(raiz);
     const saida = {
@@ -83,7 +83,7 @@ export function resolverConexoes(raiz, opcoes = {}) {
         problemas: [...problems],
         segredos: [],
     };
-    const { conexoes: nomes, projeto, declarado } = config.banco;
+    const { conexoes: nomes, projeto, declarado } = config.banco_dados;
     if (!declarado) {
         const url = lerDatabaseUrl(raiz);
         if (url) {
@@ -118,10 +118,10 @@ export function resolverConexoes(raiz, opcoes = {}) {
 }
 export function escolherConexao(resolvidas, nome) {
     if (resolvidas.length === 0) {
-        throw new Error('Nenhuma conexão de banco configurada neste projeto; rode npx @fontdata/ai-harness banco usar <nome>');
+        throw new Error('Nenhuma conexão de banco configurada neste projeto; rode npx @fontdata/ai-harness banco-dados usar <nome>');
     }
     const escolhida = nome === undefined ? resolvidas[0] : resolvidas.find((conexao) => conexao.nome === nome);
     if (!escolhida)
-        throw new Error(`Conexão ${nome} não está em banco.conexoes deste projeto`);
+        throw new Error(`Conexão ${nome} não está em banco_dados.conexoes deste projeto`);
     return escolhida;
 }

package/dist/{banco → banco-dados}/ferramentas.js

@@ -6,7 +6,7 @@ import { categoriaDaColuna, mascararResultado, mascararTexto } from './lgpd/apli
 import { validarLeitura } from './somente-leitura.js';
 const CONEXAO = {
     type: 'string',
-    description: 'Nome da conexão do projeto; sem ele vale a primeira de banco.conexoes.',
+    description: 'Nome da conexão do projeto; sem ele vale a primeira de banco_dados.conexoes.',
 };
 export const FERRAMENTAS = [
     {
@@ -42,7 +42,7 @@ export const FERRAMENTAS = [
                 limite: {
                     type: 'integer',
                     minimum: 1,
-                    description: 'Máximo de linhas devolvidas; nunca passa de banco.limite_linhas do projeto.',
+                    description: 'Máximo de linhas devolvidas; nunca passa de banco_dados.limite_linhas do projeto.',
                 },
                 conexao: CONEXAO,
             },
@@ -54,17 +54,17 @@ export const FERRAMENTAS = [
 export const INSTRUCOES = [
     'Use estas ferramentas para ler o banco de dados do projeto; o acesso é somente leitura.',
     'Nunca peça nem repita credenciais, senhas ou DSNs no chat.',
-    'As conexões vêm do cadastro da máquina ou do projeto: uma conexão do projeto é declarada em banco.conexoes do .ai-harness/config.json com dsn_env (o nome da variável), e o valor da variável fica no .claude/settings.local.json, no .env ou no ambiente.',
-    'Sem conexão configurada, oriente o usuário a rodar no terminal `npx @fontdata/ai-harness banco adicionar <nome>` e, no projeto, `npx @fontdata/ai-harness banco usar <nome>`.',
+    'As conexões vêm do cadastro da máquina ou do projeto: uma conexão do projeto é declarada em banco_dados.conexoes do .ai-harness/config.json com dsn_env (o nome da variável), e o valor da variável fica no .claude/settings.local.json, no .env ou no ambiente.',
+    'Sem conexão configurada, oriente o usuário a rodar no terminal `npx @fontdata/ai-harness banco-dados adicionar <nome>` e, no projeto, `npx @fontdata/ai-harness banco-dados usar <nome>`.',
     'Se a variável de uma conexão do projeto não estiver definida, oriente a defini-la no .claude/settings.local.json, no .env ou no ambiente.',
     'Antes de consultar, rode listar_tabelas e descrever_tabela para conhecer o esquema.',
     'Em consultar, selecione só as colunas necessárias e filtre as linhas; evite SELECT *.',
     'Somente leitura: comandos que alteram dados ou esquema são recusados.',
     'Os dados pessoais (CPF, e-mail, telefone, nome e afins) vêm mascarados, e o rodapé de consultar diz o que foi mascarado. Não tente contornar o mascaramento: não concatene, fatie, converta nem compare valores para reconstruir o original. Peça só as colunas necessárias.',
 ].join('\n');
-const ORIENTACAO_USAR = 'rode npx @fontdata/ai-harness banco usar <nome> no projeto';
+const ORIENTACAO_USAR = 'rode npx @fontdata/ai-harness banco-dados usar <nome> no projeto';
 function orientarAdicionar(nome) {
-    return `Conexão ${nome} não encontrada nesta máquina; rode npx @fontdata/ai-harness banco adicionar ${nome}`;
+    return `Conexão ${nome} não encontrada nesta máquina; rode npx @fontdata/ai-harness banco-dados adicionar ${nome}`;
 }
 function orientarVariavel(nome, variavel) {
     return `A variável ${variavel} da conexão ${nome} não está definida; defina-a no .claude/settings.local.json, no .env ou no ambiente`;
@@ -125,7 +125,7 @@ function lerLimite(valor, banco) {
     }
     return Math.min(valor, banco.limite_linhas);
 }
-/** Sem nome, vale a primeira declarada em banco.conexoes; se ela não estiver disponível, o erro é dela, nunca outra conexão. */
+/** Sem nome, vale a primeira declarada em banco_dados.conexoes; se ela não estiver disponível, o erro é dela, nunca outra conexão. */
 function escolher(resolvidas, banco, nome) {
     const alvo = nome ?? banco.conexoes[0];
     if (alvo !== undefined) {
@@ -173,7 +173,7 @@ async function executar(nome, args, contexto, banco, resolvidas) {
         if (descartadas.length > 0)
             dados.descartadas = descartadas;
         if (conexoes.length + faltando.length + variaveisAusentes.length + descartadas.length === 0) {
-            dados.orientacao = `Nenhuma conexão configurada; rode npx @fontdata/ai-harness banco adicionar <nome> e ${ORIENTACAO_USAR}`;
+            dados.orientacao = `Nenhuma conexão configurada; rode npx @fontdata/ai-harness banco-dados adicionar <nome> e ${ORIENTACAO_USAR}`;
         }
         if (resolvidas.problemas.length > 0)
             dados.problemas = resolvidas.problemas;
@@ -183,7 +183,7 @@ async function executar(nome, args, contexto, banco, resolvidas) {
         return erro(`Ferramenta desconhecida: ${nome}`);
     const conexao = escolher(resolvidas, banco, argumentoTexto(args, 'conexao', false));
     if (conexao.producao && banco.producao === 'bloqueio') {
-        return erro(`Conexão ${conexao.nome} é de produção e está bloqueada (banco.producao: "bloqueio"). Use uma cópia ou troque banco.producao para "aviso" em .ai-harness/config.json de propósito.`);
+        return erro(`Conexão ${conexao.nome} é de produção e está bloqueada (banco_dados.producao: "bloqueio"). Use uma cópia ou troque banco_dados.producao para "aviso" em .ai-harness/config.json de propósito.`);
     }
     let dados;
     let rodape = '';
@@ -229,7 +229,7 @@ export async function executarFerramenta(nome, args, contexto) {
         conexoes = resolvidas.conexoes;
         segredos = resolvidas.segredos;
         const argumentos = typeof args === 'object' && args !== null && !Array.isArray(args) ? args : {};
-        const resultado = await executar(nome, argumentos, contexto, config.banco, resolvidas);
+        const resultado = await executar(nome, argumentos, contexto, config.banco_dados, resolvidas);
         const texto = limpar(resultado.content[0].text, conexoes, segredos);
         resultado.content[0].text = resultado.isError ? mascararTexto(texto) : texto;
         return resultado;

package/dist/cli.js

@@ -5,6 +5,8 @@ import { fileURLToPath } from 'node:url';
 import { allCommands, loadCatalog } from './catalog.js';
 import { runCommand, runnableIds, suggestIds } from './run.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Comandos renomeados depois da 2.7.0: o nome antigo aponta o novo em vez de cair em "Comando desconhecido". */
+const RENAMED_COMMANDS = { banco: 'banco-dados', 'banco-mcp': 'banco-dados-mcp' };
 const RESERVED = new Set([
     'init',
     'doctor',
@@ -14,8 +16,8 @@ const RESERVED = new Set([
     'conflitos',
     'comentarios',
     'memoria',
-    'banco',
-    'banco-mcp',
+    'banco-dados',
+    'banco-dados-mcp',
     'list',
     'run',
     'help',
@@ -49,15 +51,15 @@ Gerenciar:
   init [caminho]  Instala os slash commands em .claude/commands do projeto (interativo)
   doctor [caminho]  Diagnostica a instalação (arquivos, lock, skills, agents, hooks, Node)
   update [caminho]  Atualiza o que foi instalado: --check só lista, --yes aplica, --forcar sobrescreve conflitos
-                    --sem-banco: não registra o MCP de banco no .mcp.json e lembra a recusa no config
+                    --sem-banco-dados: não registra o MCP de banco no .mcp.json e lembra a recusa no config
   migrar [caminho]  Move docs/specs, plans, bugs e investigacoes para docs/trabalhos/<id>/ (--yes aplica)
                     --reclassificar: planos já migrados em em-execucao viram concluido ou legado
   comentarios [caminho]  Instala o hook de comentários e a catraca do legado (--yes aplica)
   memoria [caminho]  Índice de quem mexeu em cada arquivo (--arquivo <caminho>, --regressao <id do bug>)
   evento <evento>   Grava no rastro do trabalho (--trabalho, --task, --nome, --resultado, --dados '{json}')
   conflitos <id>    Aponta trabalhos em execução que mexem nos mesmos arquivos (--aguardar espera liberar)
-  banco <subcomando>  Conexões de banco somente leitura: adicionar, listar, testar, usar, remover
-  banco-mcp         Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
+  banco-dados <subcomando>  Conexões de banco somente leitura: adicionar, listar, testar, usar, remover
+  banco-dados-mcp   Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
   list            Lista todos os comandos disponíveis no catálogo
 
 Init sem perguntas (CI):
@@ -66,7 +68,7 @@ Init sem perguntas (CI):
   --sem-hooks                          não instala os hooks do harness
   --sem-agents                         não instala os agents somente leitura
   --sem-comentarios                    não instala a rule, o hook e a catraca de comentários
-  --sem-banco                          não registra o servidor MCP de banco no .mcp.json
+  --sem-banco-dados                    não registra o servidor MCP de banco no .mcp.json
   --claude-md criar|manter|backup|sobrescrever   (padrão: criar)
   --conflito sobrescrever|pular        (padrão: pular)
   --yes                                aplica; sem ele o init só simula
@@ -152,12 +154,12 @@ async function main() {
         const { runConflictsCommand } = await import('./trabalhos/conflitos.js');
         process.exit(await runConflictsCommand(argv.slice(1)));
     }
-    if (cmd === 'banco') {
-        const { runBancoCommand } = await import('./banco/command.js');
+    if (cmd === 'banco-dados') {
+        const { runBancoCommand } = await import('./banco-dados/command.js');
         process.exit(await runBancoCommand(argv.slice(1)));
     }
-    if (cmd === 'banco-mcp') {
-        const { iniciarServidorMcp } = await import('./banco/mcp.js');
+    if (cmd === 'banco-dados-mcp') {
+        const { iniciarServidorMcp } = await import('./banco-dados/mcp.js');
         await iniciarServidorMcp({ entrada: process.stdin, saida: process.stdout });
         return;
     }
@@ -180,6 +182,11 @@ async function main() {
         const { args, claudeFlags } = splitArgs(argv.slice(1));
         process.exit(runCommand(cmd, args, claudeFlags));
     }
+    const renamed = RENAMED_COMMANDS[cmd];
+    if (renamed) {
+        console.error(`O comando ${cmd} mudou de nome: use ${renamed}.`);
+        process.exit(1);
+    }
     if (!RESERVED.has(cmd)) {
         const near = suggestIds(cmd.replace(/^\//, ''), ids);
         console.error(`Comando desconhecido: ${cmd}`);

package/dist/config/config.js

@@ -16,13 +16,53 @@ export const TIPOS_CONEXAO_PROJETO = ['postgres', 'mariadb', 'sqlite'];
 function isObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/** Seção do banco no config; até a 2.7.0 ela se chamava `banco`. */
+export const BANCO_CHAVE = 'banco_dados';
+export const BANCO_CHAVE_LEGADA = 'banco';
+/** Só a seção com o nome antigo existe: ela vale e o update a renomeia. */
+function soSecaoLegada(raw) {
+    return !(BANCO_CHAVE in raw) && BANCO_CHAVE_LEGADA in raw;
+}
+/** A seção do banco no JSON bruto: `banco_dados`, ou a `banco` antiga quando só ela existe. */
+export function secaoBanco(raw) {
+    const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
+    return isObject(secao) ? secao : {};
+}
+/** O JSON com a seção do banco gravada como `banco_dados`; a `banco` antiga é trocada na mesma posição. */
+export function comSecaoBanco(raw, secao) {
+    if (!soSecaoLegada(raw))
+        return { ...raw, [BANCO_CHAVE]: secao };
+    return Object.fromEntries(Object.entries(raw).map(([chave, valor]) => (chave === BANCO_CHAVE_LEGADA ? [BANCO_CHAVE, secao] : [chave, valor])));
+}
+function lerJsonBruto(root) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(root, CONFIG_PATH), 'utf8'));
+        return isObject(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** O config ainda tem a seção do banco com o nome antigo (`banco`), que o update renomeia. */
+export function temSecaoBancoLegada(root) {
+    const raw = lerJsonBruto(root);
+    return raw !== undefined && soSecaoLegada(raw);
+}
+/** Renomeia a seção `banco` para `banco_dados`, preservando o resto do JSON; devolve se mudou. */
+export function migrarSecaoBanco(root) {
+    const raw = lerJsonBruto(root);
+    if (!raw || !soSecaoLegada(raw))
+        return false;
+    writeFileSync(join(root, CONFIG_PATH), `${JSON.stringify(comSecaoBanco(raw, secaoBanco(raw)), null, 2)}\n`);
+    return true;
+}
 export function defaultConfig() {
     return {
         config_versao: CONFIG_VERSION,
         hooks: { ...DEFAULT_HOOK_MODES },
         rastro: { versionar: false },
         bloqueios: { dias_para_aviso: 7 },
-        banco: {
+        banco_dados: {
             conexoes: [],
             producao: 'bloqueio',
             limite_linhas: 200,
@@ -41,23 +81,23 @@ const SO_NO_CADASTRO = 'O mascaramento LGPD só pode ser desligado no cadastro d
 const REGRA_DE_COLUNA = /^[^.\s]+(\.[^.\s]+){0,2}$/;
 function lerLgpd(raw, lgpd, problems) {
     if (!isObject(raw)) {
-        problems.push(`banco.lgpd deve ser um objeto com mascarar_colunas e liberar_colunas em ${CONFIG_PATH}.`);
+        problems.push(`banco_dados.lgpd deve ser um objeto com mascarar_colunas e liberar_colunas em ${CONFIG_PATH}.`);
         return;
     }
     if ('desligar' in raw)
-        problems.push(`${SO_NO_CADASTRO}; banco.lgpd.desligar em ${CONFIG_PATH} foi ignorado.`);
+        problems.push(`${SO_NO_CADASTRO}; banco_dados.lgpd.desligar em ${CONFIG_PATH} foi ignorado.`);
     for (const chave of ['mascarar_colunas', 'liberar_colunas']) {
         if (!(chave in raw))
             continue;
         const lista = raw[chave];
         if (!Array.isArray(lista)) {
-            problems.push(`banco.lgpd.${chave} deve ser uma lista de colunas em ${CONFIG_PATH}.`);
+            problems.push(`banco_dados.lgpd.${chave} deve ser uma lista de colunas em ${CONFIG_PATH}.`);
             continue;
         }
         lgpd[chave] = lista.filter((regra) => {
             if (typeof regra === 'string' && REGRA_DE_COLUNA.test(regra))
                 return true;
-            problems.push(`Entrada ${JSON.stringify(regra)} ignorada em banco.lgpd.${chave} de ${CONFIG_PATH}; use coluna, tabela.coluna ou schema.tabela.coluna.`);
+            problems.push(`Entrada ${JSON.stringify(regra)} ignorada em banco_dados.lgpd.${chave} de ${CONFIG_PATH}; use coluna, tabela.coluna ou schema.tabela.coluna.`);
             return false;
         });
     }
@@ -83,7 +123,7 @@ function motivoConexaoInvalida(entrada) {
 function lerConexoes(conexoes, banco, problems) {
     banco.declarado = !(Array.isArray(conexoes) && conexoes.length === 0);
     if (!Array.isArray(conexoes)) {
-        problems.push(`banco.conexoes deve ser uma lista de nomes ou de objetos { nome, dsn_env } em ${CONFIG_PATH}.`);
+        problems.push(`banco_dados.conexoes deve ser uma lista de nomes ou de objetos { nome, dsn_env } em ${CONFIG_PATH}.`);
         return;
     }
     for (const entrada of conexoes) {
@@ -94,17 +134,17 @@ function lerConexoes(conexoes, banco, problems) {
         else if (isObject(entrada)) {
             const motivo = motivoConexaoInvalida(entrada);
             if (motivo) {
-                problems.push(`Entrada ${citada} descartada em banco.conexoes de ${CONFIG_PATH}: ${motivo}.`);
+                problems.push(`Entrada ${citada} descartada em banco_dados.conexoes de ${CONFIG_PATH}: ${motivo}.`);
                 continue;
             }
             nome = entrada.nome;
         }
         else {
-            problems.push(`Entrada ${citada} descartada em banco.conexoes de ${CONFIG_PATH}; use um nome (texto não vazio) ou um objeto { nome, dsn_env }.`);
+            problems.push(`Entrada ${citada} descartada em banco_dados.conexoes de ${CONFIG_PATH}; use um nome (texto não vazio) ou um objeto { nome, dsn_env }.`);
             continue;
         }
         if (banco.conexoes.includes(nome)) {
-            problems.push(`Entrada ${citada} descartada em banco.conexoes de ${CONFIG_PATH}: o nome "${nome}" já foi declarado antes.`);
+            problems.push(`Entrada ${citada} descartada em banco_dados.conexoes de ${CONFIG_PATH}: o nome "${nome}" já foi declarado antes.`);
             continue;
         }
         banco.conexoes.push(nome);
@@ -112,8 +152,8 @@ function lerConexoes(conexoes, banco, problems) {
             continue;
         for (const chave of Object.keys(entrada).filter((chave) => !CHAVES_CONEXAO_PROJETO.includes(chave))) {
             problems.push(chave === 'mascaramento'
-                ? `${SO_NO_CADASTRO}; mascaramento da entrada ${citada} em banco.conexoes de ${CONFIG_PATH} foi ignorado.`
-                : `Chave desconhecida ${chave} ignorada na entrada ${citada} de banco.conexoes em ${CONFIG_PATH}.`);
+                ? `${SO_NO_CADASTRO}; mascaramento da entrada ${citada} em banco_dados.conexoes de ${CONFIG_PATH} foi ignorado.`
+                : `Chave desconhecida ${chave} ignorada na entrada ${citada} de banco_dados.conexoes em ${CONFIG_PATH}.`);
         }
         banco.projeto[nome] = {
             nome,
@@ -130,28 +170,28 @@ function lerBanco(raw, banco, problems) {
         if (MODOS_PRODUCAO.includes(raw.producao))
             banco.producao = raw.producao;
         else
-            problems.push(`Modo "${String(raw.producao)}" inválido para banco.producao em ${CONFIG_PATH}; use aviso ou bloqueio.`);
+            problems.push(`Modo "${String(raw.producao)}" inválido para banco_dados.producao em ${CONFIG_PATH}; use aviso ou bloqueio.`);
     }
     if ('limite_linhas' in raw) {
         if (inteiroEntre(raw.limite_linhas, 1, 5000))
             banco.limite_linhas = raw.limite_linhas;
         else
-            problems.push(`banco.limite_linhas deve ser um inteiro de 1 a 5000 em ${CONFIG_PATH}.`);
+            problems.push(`banco_dados.limite_linhas deve ser um inteiro de 1 a 5000 em ${CONFIG_PATH}.`);
     }
     if ('timeout_segundos' in raw) {
         if (inteiroEntre(raw.timeout_segundos, 1, 600))
             banco.timeout_segundos = raw.timeout_segundos;
         else
-            problems.push(`banco.timeout_segundos deve ser um inteiro de 1 a 600 em ${CONFIG_PATH}.`);
+            problems.push(`banco_dados.timeout_segundos deve ser um inteiro de 1 a 600 em ${CONFIG_PATH}.`);
     }
     if ('registrar_mcp' in raw) {
         if (typeof raw.registrar_mcp === 'boolean')
             banco.registrar_mcp = raw.registrar_mcp;
         else
-            problems.push(`banco.registrar_mcp deve ser true ou false em ${CONFIG_PATH}.`);
+            problems.push(`banco_dados.registrar_mcp deve ser true ou false em ${CONFIG_PATH}.`);
     }
     if ('mascaramento' in raw)
-        problems.push(`${SO_NO_CADASTRO}; banco.mascaramento em ${CONFIG_PATH} foi ignorado.`);
+        problems.push(`${SO_NO_CADASTRO}; banco_dados.mascaramento em ${CONFIG_PATH} foi ignorado.`);
     if ('lgpd' in raw)
         lerLgpd(raw.lgpd, banco.lgpd, problems);
 }
@@ -192,17 +232,24 @@ export function readConfig(root) {
         else
             problems.push(`bloqueios.dias_para_aviso deve ser um inteiro positivo em ${CONFIG_PATH}.`);
     }
-    if (isObject(raw.banco))
-        lerBanco(raw.banco, config.banco, problems);
+    const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
+    if (isObject(secao))
+        lerBanco(secao, config.banco_dados, problems);
+    if (soSecaoLegada(raw)) {
+        problems.push(`A seção banco de ${CONFIG_PATH} agora se chama banco_dados; rode npx @fontdata/ai-harness update --yes para renomeá-la.`);
+    }
+    else if (BANCO_CHAVE_LEGADA in raw) {
+        problems.push(`A seção banco de ${CONFIG_PATH} foi ignorada: vale a banco_dados. Apague a banco.`);
+    }
     return { config, problems };
 }
-/** Cria a config com os padrões, sem a seção banco; retorna false se já existia (nunca sobrescreve). */
+/** Cria a config com os padrões, sem a seção banco_dados; retorna false se já existia (nunca sobrescreve). */
 export function writeDefaultConfig(root) {
     const file = join(root, CONFIG_PATH);
     if (existsSync(file))
         return false;
     mkdirSync(dirname(file), { recursive: true });
-    const { banco: _banco, ...gravada } = defaultConfig();
+    const { banco_dados: _banco, ...gravada } = defaultConfig();
     writeFileSync(file, `${JSON.stringify(gravada, null, 2)}\n`);
     return true;
 }
@@ -222,10 +269,10 @@ function lerJsonParaEscrita(file, chave) {
 export function validarConfigParaEscrita(root) {
     const file = join(root, CONFIG_PATH);
     if (existsSync(file))
-        lerJsonParaEscrita(file, 'banco.conexoes');
+        lerJsonParaEscrita(file, 'banco_dados.conexoes');
 }
 /**
- * Grava a conexão em `banco.conexoes`, preservando o resto do JSON; sem config, cria uma com os padrões.
+ * Grava a conexão em `banco_dados.conexoes`, preservando o resto do JSON; sem config, cria uma com os padrões.
  * Se o nome já existir (objeto ou string), lança, ou troca a entrada na mesma posição com `substituir`.
  * JSON inválido é recusado sem tocar no arquivo.
  */
@@ -234,14 +281,14 @@ export function gravarConexaoProjeto(root, conexao, { substituir = false } = {})
     if (motivo)
         throw new Error(`Conexão ${JSON.stringify(conexao.nome)} inválida: ${motivo}.`);
     const file = join(root, CONFIG_PATH);
-    const raw = existsSync(file) ? lerJsonParaEscrita(file, 'banco.conexoes') : undefined;
-    const banco = raw && isObject(raw.banco) ? raw.banco : {};
+    const raw = existsSync(file) ? lerJsonParaEscrita(file, 'banco_dados.conexoes') : undefined;
+    const banco = raw ? secaoBanco(raw) : {};
     const conexoes = banco.conexoes === undefined ? [] : banco.conexoes;
     if (!Array.isArray(conexoes))
-        throw new Error(`banco.conexoes em ${CONFIG_PATH} não é uma lista; corrija-o antes de gravar a conexão ${conexao.nome}.`);
+        throw new Error(`banco_dados.conexoes em ${CONFIG_PATH} não é uma lista; corrija-o antes de gravar a conexão ${conexao.nome}.`);
     const posicao = conexoes.findIndex((entrada) => (isObject(entrada) ? entrada.nome : entrada) === conexao.nome);
     if (posicao !== -1 && !substituir)
-        throw new Error(`A conexão ${conexao.nome} já está em banco.conexoes de ${CONFIG_PATH}.`);
+        throw new Error(`A conexão ${conexao.nome} já está em banco_dados.conexoes de ${CONFIG_PATH}.`);
     const entrada = {
         nome: conexao.nome,
         dsn_env: conexao.dsn_env,
@@ -251,28 +298,28 @@ export function gravarConexaoProjeto(root, conexao, { substituir = false } = {})
     const proximas = posicao === -1 ? [...conexoes, entrada] : conexoes.map((atual, i) => (i === posicao ? entrada : atual));
     if (!raw)
         writeDefaultConfig(root);
-    const base = raw ?? lerJsonParaEscrita(file, 'banco.conexoes');
-    writeFileSync(file, `${JSON.stringify({ ...base, banco: { ...banco, conexoes: proximas } }, null, 2)}\n`);
+    const base = raw ?? lerJsonParaEscrita(file, 'banco_dados.conexoes');
+    writeFileSync(file, `${JSON.stringify(comSecaoBanco(base, { ...banco, conexoes: proximas }), null, 2)}\n`);
 }
 /**
- * Grava só `banco.registrar_mcp`, preservando o resto do JSON; sem config, cria uma com os padrões
+ * Grava só `banco_dados.registrar_mcp`, preservando o resto do JSON; sem config, cria uma com os padrões
  * e essa chave. JSON inválido é recusado sem tocar no arquivo.
  */
 export function gravarRegistrarMcp(root, valor) {
     const file = join(root, CONFIG_PATH);
     let raw;
     if (existsSync(file)) {
-        raw = lerJsonParaEscrita(file, 'banco.registrar_mcp');
+        raw = lerJsonParaEscrita(file, 'banco_dados.registrar_mcp');
     }
     else {
-        const { banco: _banco, ...padrao } = defaultConfig();
+        const { banco_dados: _banco, ...padrao } = defaultConfig();
         raw = padrao;
     }
-    const banco = isObject(raw.banco) ? raw.banco : {};
+    const banco = secaoBanco(raw);
     if (banco.registrar_mcp === valor)
         return;
     mkdirSync(dirname(file), { recursive: true });
-    writeFileSync(file, `${JSON.stringify({ ...raw, banco: { ...banco, registrar_mcp: valor } }, null, 2)}\n`);
+    writeFileSync(file, `${JSON.stringify(comSecaoBanco(raw, { ...banco, registrar_mcp: valor }), null, 2)}\n`);
 }
 const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
 const BLOCK_END = '# /ai-harness';

package/dist/doctor/checks.js

@@ -1,8 +1,8 @@
 import { execFileSync, spawnSync } from 'node:child_process';
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
-import { lerEnvSettingsLocal, lerVariavel, SETTINGS_LOCAL_PATH } from '../banco/ambiente.js';
-import { caminhoCadastro, lerCadastro } from '../banco/cadastro.js';
+import { lerEnvSettingsLocal, lerVariavel, SETTINGS_LOCAL_PATH } from '../banco-dados/ambiente.js';
+import { caminhoCadastro, lerCadastro } from '../banco-dados/cadastro.js';
 import { allCommands, loadCatalog } from '../catalog.js';
 import { CONFIG_PATH, readConfig } from '../config/config.js';
 import { readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
@@ -414,7 +414,7 @@ function settingsLocalIgnorado(root, env) {
         .some((linha) => LINHAS_IGNORE_SETTINGS_LOCAL.has(linha));
 }
 function checkBancoProjeto(root, config, env) {
-    const conexoes = config.banco.conexoes.flatMap((nome) => config.banco.projeto[nome] ?? []);
+    const conexoes = config.banco_dados.conexoes.flatMap((nome) => config.banco_dados.projeto[nome] ?? []);
     if (!conexoes.length)
         return [];
     const findings = [];
@@ -424,8 +424,8 @@ function checkBancoProjeto(root, config, env) {
         findings.push({
             id: 'banco-variavel-ausente',
             severidade: 'aviso',
-            mensagem: `A conexão ${nome}, declarada em banco.conexoes de ${join(root, CONFIG_PATH)}, lê o DSN da variável ${dsn_env}, que não está definida no ambiente, em ${SETTINGS_LOCAL_PATH} nem no .env.`,
-            correcao: `Defina ${dsn_env} com \`npx @fontdata/ai-harness banco adicionar ${nome} --projeto\` ou no ambiente do terminal.`,
+            mensagem: `A conexão ${nome}, declarada em banco_dados.conexoes de ${join(root, CONFIG_PATH)}, lê o DSN da variável ${dsn_env}, que não está definida no ambiente, em ${SETTINGS_LOCAL_PATH} nem no .env.`,
+            correcao: `Defina ${dsn_env} com \`npx @fontdata/ai-harness banco-dados adicionar ${nome} --projeto\` ou no ambiente do terminal.`,
         });
     }
     const envLocal = lerEnvSettingsLocal(root);
@@ -453,12 +453,12 @@ function checkBancoProjeto(root, config, env) {
     }
     return findings;
 }
-/** Confere o cadastro desta máquina e as variáveis das conexões do projeto contra `banco.conexoes`, sem abrir conexão. */
+/** Confere o cadastro desta máquina e as variáveis das conexões do projeto contra `banco_dados.conexoes`, sem abrir conexão. */
 export function checkBanco(root, config, env = process.env) {
-    if (!config.banco.conexoes.length)
+    if (!config.banco_dados.conexoes.length)
         return [];
     const findings = checkBancoProjeto(root, config, env);
-    const doCadastro = config.banco.conexoes.filter((nome) => !(nome in config.banco.projeto));
+    const doCadastro = config.banco_dados.conexoes.filter((nome) => !(nome in config.banco_dados.projeto));
     if (!doCadastro.length)
         return findings;
     const caminho = caminhoCadastro(env);
@@ -486,8 +486,8 @@ export function checkBanco(root, config, env = process.env) {
         findings.push({
             id: 'banco-conexao-ausente',
             severidade: 'aviso',
-            mensagem: `A conexão ${nome}, citada em banco.conexoes de ${join(root, CONFIG_PATH)}, não está no cadastro desta máquina (${caminho}).`,
-            correcao: `Cadastre-a com \`npx @fontdata/ai-harness banco adicionar ${nome}\`.`,
+            mensagem: `A conexão ${nome}, citada em banco_dados.conexoes de ${join(root, CONFIG_PATH)}, não está no cadastro desta máquina (${caminho}).`,
+            correcao: `Cadastre-a com \`npx @fontdata/ai-harness banco-dados adicionar ${nome}\`.`,
         });
     }
     for (const nome of doCadastro.filter((nome) => conexoes[nome]?.mascaramento === false)) {

package/dist/init.js

@@ -14,7 +14,7 @@ const PLUGIN_HOOKS_NOTE = 'O plugin fontdata@ai-harness está habilitado: os hoo
 const PLUGIN_MCP_NOTE = 'O plugin fontdata@ai-harness está habilitado: o servidor MCP de banco já roda por ele e não foi registrado no .mcp.json, para não duplicar.';
 /** Registra o MCP de banco no .mcp.json quando não foi recusado (flag, wizard ou config) e o plugin não o fornece. */
 export function decidirRegistroMcp(options, root, home = homedir()) {
-    return options.mcpBanco && readConfig(root).config.banco.registrar_mcp && !isHarnessPluginEnabled(root, home);
+    return options.mcpBanco && readConfig(root).config.banco_dados.registrar_mcp && !isHarnessPluginEnabled(root, home);
 }
 function applyMcpDecision(plan, options, root) {
     plan.registerMcp = decidirRegistroMcp(options, root);

package/dist/install/flags.js

@@ -7,7 +7,7 @@ const CLAUDE_MD = {
 };
 const CONFLICTS = { sobrescrever: 'overwrite', pular: 'skip' };
 const VALUE_FLAGS = ['--escopo', '--comandos', '--claude-md', '--conflito'];
-const BOOLEAN_FLAGS = ['--sem-harness', '--sem-hooks', '--sem-agents', '--sem-comentarios', '--sem-banco', '--yes', '-y', '--sim'];
+const BOOLEAN_FLAGS = ['--sem-harness', '--sem-hooks', '--sem-agents', '--sem-comentarios', '--sem-banco-dados', '--yes', '-y', '--sim'];
 function pick(flag, value, options) {
     const chosen = options[value];
     if (chosen === undefined) {
@@ -28,8 +28,13 @@ function distance(a, b) {
     }
     return row[b.length] ?? 0;
 }
+/** Flags que mudaram de nome: o erro aponta a nova, que a distância de edição não alcança. */
+const RENAMED_FLAGS = { '--sem-banco': '--sem-banco-dados' };
 /** Flag conhecida mais parecida com a digitada, para sugerir em mensagens de erro. */
 export function suggestFlag(token, flags) {
+    const renamed = RENAMED_FLAGS[token];
+    if (renamed && flags.includes(renamed))
+        return renamed;
     const [best] = flags
         .map((flag) => ({ flag, d: distance(token, flag) }))
         .filter(({ d }) => d <= 2)
@@ -69,7 +74,7 @@ export function parseInitArgs(argv) {
                 args.agents = false;
             else if (token === '--sem-comentarios')
                 args.comments = false;
-            else if (token === '--sem-banco')
+            else if (token === '--sem-banco-dados')
                 args.mcpBanco = false;
             else
                 args.yes = true;

package/dist/install/mcp.js

@@ -2,13 +2,17 @@ import { copyFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { timestamp } from './settings.js';
 export const MCP_PATH = '.mcp.json';
+/** Nome do servidor de banco no `.mcp.json`; as ferramentas ficam `mcp__banco_dados__*`. */
+export const BANCO_MCP_NOME = 'banco_dados';
+/** Nome do servidor até a 2.7.0; a entrada gerenciada com ele é trocada pela nova no update. */
+export const BANCO_MCP_NOME_LEGADO = 'banco';
 const PIN_PREFIX = '@fontdata/ai-harness@';
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 /** Servidor MCP de banco com a versão do pacote fixada no npx, no mesmo formato do plugin. */
 export function bancoMcpServer(versao) {
-    return { command: 'npx', args: ['-y', `${PIN_PREFIX}${versao}`, 'banco-mcp'] };
+    return { command: 'npx', args: ['-y', `${PIN_PREFIX}${versao}`, 'banco-dados-mcp'] };
 }
 function pinOf(entrada) {
     if (!isPlainObject(entrada) || !Array.isArray(entrada.args))
@@ -22,9 +26,10 @@ export function ehEntradaGerenciada(entrada) {
 /**
  * Acrescenta os servidores ausentes em `mcpServers` do `.mcp.json`, preservando o resto. Com
  * `atualizarGerenciada`, regrava também a entrada gerenciada que fixa outra versão; entrada
- * personalizada nunca é tocada. Backup datado só quando muda; JSON inválido é recusado sem tocar.
+ * personalizada nunca é tocada. Os nomes de `removerGerenciadas` saem só quando a entrada é gerenciada. Backup
+ * datado só quando muda; JSON inválido é recusado sem tocar.
  */
-export function mergeMcpServers(root, servidores, now = new Date(), { atualizarGerenciada = false } = {}) {
+export function mergeMcpServers(root, servidores, now = new Date(), { atualizarGerenciada = false, removerGerenciadas = [] } = {}) {
     const file = join(root, MCP_PATH);
     const original = existsSync(file) ? readFileSync(file, 'utf8') : null;
     let config = {};
@@ -43,6 +48,12 @@ export function mergeMcpServers(root, servidores, now = new Date(), { atualizarG
     }
     const mcpServers = { ...(config.mcpServers ?? {}) };
     let changed = false;
+    for (const nome of removerGerenciadas) {
+        if (!ehEntradaGerenciada(mcpServers[nome]))
+            continue;
+        delete mcpServers[nome];
+        changed = true;
+    }
     for (const [nome, servidor] of Object.entries(servidores)) {
         const atual = mcpServers[nome];
         if (atual === undefined) {

package/dist/install/plan.js

@@ -6,10 +6,10 @@ import { applyAtomically } from './atomic.js';
 import { buildLockItem, LOCK_VERSION, readLock, writeLock } from './lock.js';
 import { HOOKS_ITEM_ID, PROJECT_HOOKS_DIR, projectHooksConfig } from './hooks.js';
 import { neededSkillsFor, resolveSelection } from './selection.js';
-import { bancoMcpServer, MCP_PATH, mergeMcpServers } from './mcp.js';
+import { BANCO_MCP_NOME, bancoMcpServer, MCP_PATH, mergeMcpServers } from './mcp.js';
 import { gravarRegistrarMcp } from '../config/config.js';
 import { COMMENTS_RULE_PATH, commentsHooksConfig, ensureCommentsBaseline } from '../comentarios/instalar.js';
-import { combineHooks, HARNESS_DENY, HARNESS_PERMISSIONS, mergeSettings } from './settings.js';
+import { combineHooks, HARNESS_DENY, harnessPermissions, mergeSettings } from './settings.js';
 /** Rule de convenção com o que é específico do projeto (D-38): é do projeto, então fica fora do lock. */
 export const PROJECT_RULE_PATH = '.claude/rules/harness-projeto.md';
 /** Esqueleto da rule de projeto; os comandos `-legado` renomeados pelo update entram na última seção. */
@@ -165,12 +165,12 @@ export function executePlan(root, plan, pkg, now = new Date()) {
     const permission = needsEventPermission(plan);
     const hooks = combineHooks(plan.registerHooks ? projectHooksConfig() : {}, plan.registerComments ? commentsHooksConfig() : {});
     if (Object.keys(hooks).length || permission) {
-        mergeSettings(root, { hooks, allow: permission ? HARNESS_PERMISSIONS : [], deny: permission ? HARNESS_DENY : [] }, now);
+        mergeSettings(root, { hooks, allow: permission ? harnessPermissions({ banco: bancoAtivo(plan) }) : [], deny: permission ? HARNESS_DENY : [] }, now);
     }
     if (plan.registerComments)
         ensureCommentsBaseline(root);
     if (plan.registerMcp)
-        mergeMcpServers(root, { banco: bancoMcpServer(pkg.versao) }, now);
+        mergeMcpServers(root, { [BANCO_MCP_NOME]: bancoMcpServer(pkg.versao) }, now);
     if (plan.mcpRecusado)
         gravarRegistrarMcp(root, false);
     const items = new Map();
@@ -193,6 +193,10 @@ export function executePlan(root, plan, pkg, now = new Date()) {
     writeLock(root, lock);
     return lock;
 }
+/** O banco não foi recusado (`--sem-banco-dados` ou `banco_dados.registrar_mcp: false`): as permissões do MCP entram. */
+function bancoAtivo(plan) {
+    return !plan.mcpRecusado && plan.mcpSkipReason !== 'config';
+}
 /** Skills e agents do harness registram o rastro com `npx @fontdata/ai-harness evento`. */
 function needsEventPermission(plan) {
     return plan.items.some((item) => item.tipo === 'skill' || item.tipo === 'agent');
@@ -209,7 +213,7 @@ export function describePlan(plan) {
     if (plan.registerHooks)
         lines.push('Hooks do harness registrados em .claude/settings.json (sem duplicar os existentes).');
     if (needsEventPermission(plan)) {
-        lines.push(`Permissões ${HARNESS_PERMISSIONS.join(', ')} em .claude/settings.json, para o rastro, a checagem de conflitos, ` +
+        lines.push(`Permissões ${harnessPermissions({ banco: bancoAtivo(plan) }).join(', ')} em .claude/settings.json, para o rastro, a checagem de conflitos, ` +
             'o /git-commit-push, os sub-agents e as consultas de leitura não pedirem aprovação (inclusive no modo auto); ' +
             'o push forçado fica bloqueado em permissions.deny.');
     }
@@ -217,13 +221,13 @@ export function describePlan(plan) {
         lines.push(`Servidor MCP de banco (somente leitura) registrado em ${MCP_PATH}, sem duplicar os servidores existentes.`);
     }
     else if (plan.mcpRecusado) {
-        lines.push(`Servidor MCP de banco não registrado (recusado); a escolha fica em banco.registrar_mcp: false no .ai-harness/config.json.`);
+        lines.push(`Servidor MCP de banco não registrado (recusado); a escolha fica em banco_dados.registrar_mcp: false no .ai-harness/config.json.`);
     }
     else if (plan.mcpSkipReason === 'plugin') {
         lines.push(`Servidor MCP de banco não registrado em ${MCP_PATH}: o plugin fontdata@ai-harness já o fornece.`);
     }
     else if (plan.mcpSkipReason === 'config') {
-        lines.push(`Servidor MCP de banco não registrado em ${MCP_PATH}: banco.registrar_mcp está false no .ai-harness/config.json.`);
+        lines.push(`Servidor MCP de banco não registrado em ${MCP_PATH}: banco_dados.registrar_mcp está false no .ai-harness/config.json.`);
     }
     if (plan.registerComments) {
         lines.push('Padrão de comentários: rule carregada em toda sessão, hook que bloqueia a violação e catraca do legado (gerada só na primeira instalação).');

package/dist/install/settings.js

@@ -33,11 +33,14 @@ export const READ_PERMISSIONS = [
     'Bash(gh pr diff:*)',
     'Bash(npm outdated:*)',
 ];
+const BANCO_TOOLS = ['listar_conexoes', 'listar_tabelas', 'descrever_tabela', 'consultar'];
 /**
- * Ferramentas de esquema do servidor MCP de banco, registrado pelo `.mcp.json` ou pelo plugin. A `consultar`
- * fica de fora: lê linhas das tabelas e continua pedindo aprovação.
+ * Ferramentas do servidor MCP de banco, registrado pelo `.mcp.json` (`banco_dados`) ou pelo plugin
+ * (`banco_dados`). A `consultar` também é liberada: os dados pessoais chegam mascarados.
  */
-export const BANCO_PERMISSIONS = ['mcp__banco__', 'mcp__plugin_fontdata_banco__'].flatMap((prefixo) => ['listar_conexoes', 'listar_tabelas', 'descrever_tabela', 'consultar'].map((ferramenta) => `${prefixo}${ferramenta}`));
+export const BANCO_PERMISSIONS = ['mcp__banco_dados__', 'mcp__plugin_fontdata_banco_dados__'].flatMap((prefixo) => BANCO_TOOLS.map((ferramenta) => `${prefixo}${ferramenta}`));
+/** As mesmas regras com o nome antigo do servidor (`banco`, até a 2.7.0); o update as remove. */
+export const BANCO_PERMISSIONS_LEGADAS = ['mcp__banco__', 'mcp__plugin_fontdata_banco__'].flatMap((prefixo) => BANCO_TOOLS.map((ferramenta) => `${prefixo}${ferramenta}`));
 /** Regras de `permissions.allow` que o init e o update gravam para as skills e os agents do harness. */
 export const HARNESS_PERMISSIONS = [
     EVENT_PERMISSION,
@@ -48,6 +51,10 @@ export const HARNESS_PERMISSIONS = [
     ...READ_PERMISSIONS,
     ...BANCO_PERMISSIONS,
 ];
+/** As regras do harness; sem o banco (recusado com `--sem-banco-dados` ou `banco_dados.registrar_mcp: false`), sem as do MCP. */
+export function harnessPermissions({ banco }) {
+    return banco ? HARNESS_PERMISSIONS : HARNESS_PERMISSIONS.filter((rule) => !BANCO_PERMISSIONS.includes(rule));
+}
 /** O push liberado não vale para reescrever o histórico remoto: `deny` vence o `allow`. */
 export const HARNESS_DENY = [
     'Bash(git push --force:*)',
@@ -92,7 +99,7 @@ export function mergeHooksIntoSettings(root, hooks, now = new Date()) {
  * Acrescenta hooks e regras de `permissions.allow` ao `.claude/settings.json` do projeto
  * sem perder o que já existe. Um hook é considerado presente quando algum grupo do mesmo
  * evento já tem o mesmo `command`, e uma regra quando já está na lista, o que torna a
- * operação idempotente. Tudo é gravado de uma vez, com um único backup datado do arquivo
+ * operação idempotente. As regras de `removeAllow` saem de `permissions.allow`. Tudo é gravado de uma vez, com um único backup datado do arquivo
  * original; JSON inválido é recusado sem tocar em nada.
  */
 export function mergeSettings(root, additions, now = new Date()) {
@@ -155,6 +162,12 @@ export function mergeSettings(root, additions, now = new Date()) {
         }
         next.permissions = { ...permissions, [key]: list };
     }
+    const remove = additions.removeAllow ?? [];
+    const currentAllow = next.permissions?.allow;
+    if (remove.length && currentAllow?.some((rule) => remove.includes(rule))) {
+        next.permissions = { ...next.permissions, allow: currentAllow.filter((rule) => !remove.includes(rule)) };
+        changed = true;
+    }
     if (!changed)
         return { changed: false, backup: null };
     let backup = null;

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.0.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": {