@fontdata/ai-harness 2.7.0 → 3.1.0

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "2.7.0",
+  "version": "3.1.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.1.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,27 @@ 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   # na raiz do 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
-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
-projeto.
+O `adicionar` grava `{ "nome": "erp", "dsn_env": "ERP_DATABASE_URL" }` em `banco_dados.conexoes` e a variável no
+`.claude/settings.local.json`; fora da raiz de um projeto (sem `.git` nem `.ai-harness/config.json`), ele recusa sem
+gravar nada. 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, e `banco-dados remover erp` tira a conexão do projeto. Quem
+prefere um cadastro por máquina (`~/.config/ai-harness/conexoes.json`) usa `banco-dados adicionar erp-dev --global` 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 +162,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}/ambiente.js

@@ -81,12 +81,27 @@ export function gravarVariavelSettingsLocal(raiz, nome, valor) {
     const envAtual = ehObjeto(dados.env) ? dados.env : {};
     if (envAtual[nome] === valor)
         return { changed: false };
-    const novo = { ...dados, env: { ...envAtual, [nome]: valor } };
     const modo = leitura.existe ? statSync(caminho).mode & 0o777 : 0o600;
     mkdirSync(dirname(caminho), { recursive: true });
+    gravarAtomico(caminho, { ...dados, env: { ...envAtual, [nome]: valor } }, modo);
+    return { changed: true };
+}
+/** Tira a variável do env do settings.local.json com a mesma gravação atômica; arquivo ou chave ausente não escreve. */
+export function removerVariavelSettingsLocal(raiz, nome) {
+    const caminho = join(raiz, SETTINGS_LOCAL_PATH);
+    const leitura = lerSettings(caminho);
+    if ('erro' in leitura)
+        throw new Error(leitura.erro);
+    if (!leitura.existe || !ehObjeto(leitura.dados.env) || !Object.hasOwn(leitura.dados.env, nome))
+        return { changed: false };
+    const { [nome]: _removida, ...envRestante } = leitura.dados.env;
+    gravarAtomico(caminho, { ...leitura.dados, env: envRestante }, statSync(caminho).mode & 0o777);
+    return { changed: true };
+}
+function gravarAtomico(caminho, dados, modo) {
     const temporario = `${caminho}.${process.pid}.${Date.now()}.tmp`;
     try {
-        writeFileSync(temporario, `${JSON.stringify(novo, null, 2)}\n`, { mode: modo });
+        writeFileSync(temporario, `${JSON.stringify(dados, null, 2)}\n`, { mode: modo });
         chmodSync(temporario, modo);
         renameSync(temporario, caminho);
     }
@@ -94,5 +109,4 @@ export function gravarVariavelSettingsLocal(raiz, nome, valor) {
         rmSync(temporario, { force: true });
         throw erro;
     }
-    return { changed: true };
 }

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

@@ -2,24 +2,28 @@ 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, removerConexaoProjeto, 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 { gravarVariavelSettingsLocal, lerEnvSettingsLocal, lerVariavel, removerVariavelSettingsLocal, 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',
+    '  adicionar <nome> [--env <VAR>] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
+    '                     grava no projeto: o DSN na variável <NOME>_DATABASE_URL (ou --env) do .claude/settings.local.json',
+    '                     e a conexão { nome, dsn_env } em banco_dados.conexoes do .ai-harness/config.json',
+    '                     (sem --dsn, pergunta os dados)',
+    '  adicionar <nome> --global [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
+    '                     cadastra a conexão nesta máquina',
     '  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 })',
-    '  remover <nome>     apaga a conexão do cadastro',
+    '  usar <nome...>     grava banco_dados.conexoes no .ai-harness/config.json, para conexões do cadastro global',
+    '                     (mantém as entradas { nome, dsn_env })',
+    '  remover <nome> [--global]',
+    '                     tira a conexão do projeto e a variável dela do .claude/settings.local.json;',
+    '                     com --global, apaga a conexão do cadastro desta máquina',
 ].join(EOL);
 const PORTA_PADRAO = { postgres: '5432', mariadb: '3306' };
 const ESQUEMA = { postgres: 'postgres', mariadb: 'mysql' };
@@ -118,14 +122,15 @@ function conexaoDoDsn(dsn, cwd, producao) {
     return conexao;
 }
 async function adicionar(ctx, argv) {
-    const { posicionais, marcadas, valores } = lerArgumentos(argv, ['--producao', '--sem-testar', '--substituir', '--projeto'], ['--dsn', '--env']);
+    const { posicionais, marcadas, valores } = lerArgumentos(argv, ['--producao', '--sem-testar', '--substituir', '--global'], ['--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]');
-    if (marcadas.has('--projeto'))
+    if (!nome || sobra.length > 0) {
+        throw new Error('Uso: ai-harness banco-dados adicionar <nome> [--global | --env <VAR>] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]');
+    }
+    if (!marcadas.has('--global'))
         return adicionarNoProjeto(ctx, nome, marcadas, valores);
     if (valores['--env'] !== undefined)
-        throw new Error('--env só vale com --projeto.');
+        throw new Error('--env não vale com --global.');
     const substituir = marcadas.has('--substituir');
     if (!substituir && nome in lerCadastro(ctx.cadastro).conexoes) {
         ctx.erro(`A conexão ${nome} já existe em ${ctx.cadastro}. Use --substituir para trocá-la.`);
@@ -144,31 +149,35 @@ 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) {
     return `${nome.toUpperCase().replace(/-/g, '_')}_DATABASE_URL`;
 }
 async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
+    if (!existsSync(join(ctx.cwd, '.git')) && !existsSync(join(ctx.cwd, CONFIG_PATH))) {
+        ctx.erro(`Nenhum projeto em ${ctx.cwd} (sem .git nem ${CONFIG_PATH}). Rode na raiz do projeto ou use --global para cadastrar nesta máquina.`);
+        return 1;
+    }
     const substituir = marcadas.has('--substituir');
     if (!REGRA_NOME_CONEXAO.test(nome)) {
         ctx.erro(`Nome de conexão inválido: ${JSON.stringify(nome)}; use só minúsculas, dígitos, - e _, começando por minúscula ou dígito.`);
@@ -183,7 +192,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 +243,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 +255,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 +266,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. Na raiz do projeto, rode: npx @fontdata/ai-harness banco-dados adicionar <nome>');
         return 0;
     }
     for (const nome of nomes) {
@@ -291,16 +300,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 +322,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} --global.`);
             ok = false;
         }
         for (const ausente of resolvidas.variaveisAusentes.filter(pedida)) {
@@ -327,7 +336,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 adicionar <nome>.');
             return 1;
         }
     }
@@ -346,7 +355,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 +363,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,20 +375,22 @@ 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> --global para cada uma.`);
     }
     return 0;
 }
 function remover(ctx, argv) {
-    const { posicionais } = lerArgumentos(argv, []);
+    const { posicionais, marcadas } = lerArgumentos(argv, ['--global']);
     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> [--global]');
+    if (!marcadas.has('--global'))
+        return removerDoProjeto(ctx, nome);
     if (!removerConexao(nome, ctx.cadastro)) {
         ctx.erro(`Conexão ${nome} não existe em ${ctx.cadastro}.`);
         return 1;
@@ -387,7 +398,34 @@ 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. */
+function removerDoProjeto(ctx, nome) {
+    validarSettingsLocal(ctx.cwd);
+    validarConfigParaEscrita(ctx.cwd);
+    const removida = removerConexaoProjeto(ctx.cwd, nome);
+    if (removida === null) {
+        const noCadastro = nome in lerCadastro(ctx.cadastro).conexoes;
+        ctx.erro(`Conexão ${nome} não está em banco_dados.conexoes de ${CONFIG_PATH}.${noCadastro ? ` Para o cadastro desta máquina, use remover ${nome} --global.` : ''}`);
+        return 1;
+    }
+    ctx.log(`Conexão ${nome} removida de banco_dados.conexoes de ${CONFIG_PATH}.`);
+    const variavel = typeof removida === 'string' ? undefined : removida.dsn_env;
+    if (variavel === undefined)
+        return 0;
+    const atual = lerEnvSettingsLocal(ctx.cwd)[variavel];
+    if (atual !== undefined)
+        ctx.sensiveis.push(sensivel(atual));
+    const outra = Object.values(readConfig(ctx.cwd).config.banco_dados.projeto).find((conexao) => conexao.dsn_env === variavel);
+    if (outra)
+        ctx.log(`Variável ${variavel} mantida em ${SETTINGS_LOCAL_PATH}: a conexão ${outra.nome} também a usa.`);
+    else if (removerVariavelSettingsLocal(ctx.cwd, variavel).changed)
+        ctx.log(`Variável ${variavel} removida de ${SETTINGS_LOCAL_PATH}.`);
+    ctx.log(`Se ${variavel} estiver definida no .env ou no ambiente, ela não foi tocada.`);
+    return 0;
+}
+/**
+ * `ai-harness banco-dados <subcomando>`: conexões do projeto (padrão), cadastro global de conexões da máquina
+ * (`--global`) e escolha das conexões do cadastro que o projeto usa.
+ */
 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 +458,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 adicionar <nome> na raiz do projeto');
     }
     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,16 @@ 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 na raiz do projeto `npx @fontdata/ai-harness banco-dados adicionar <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';
 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} --global`;
 }
 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 +124,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 +172,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> na raiz do projeto';
         }
         if (resolvidas.problemas.length > 0)
             dados.problemas = resolvidas.problemas;
@@ -183,7 +182,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 +228,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}`);