@fontdata/ai-harness 4.5.2 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.5.2",
3
+ "version": "4.6.0",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.2", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.6.0", "banco-dados-mcp"] }
6
6
  },
7
7
  "description": "Harness de engenharia com IA da Fontdata para Claude Code",
8
8
  "author": { "name": "Fontdata" },
@@ -7,18 +7,21 @@ import { suggestFlag } from '../install/flags.js';
7
7
  import { caminhoCadastro, lerCadastro, ocultarSenha, removerConexao, resumirConexao, salvarConexao, TIPOS_BANCO, } from './cadastro.js';
8
8
  import { gravarVariavelSettingsLocal, lerEnvSettingsLocal, lerVariavel, removerVariavelSettingsLocal, SETTINGS_LOCAL_PATH, validarSettingsLocal, } from './ambiente.js';
9
9
  import { interpretarDsn, resolverConexoes } from './conexao.js';
10
+ import { ehModelo, MARCADOR_BANCO_DADOS, validarNomeBancoDados } from './modelo-banco.js';
10
11
  import { criarDriver as criarDriverPadrao } from './drivers/index.js';
11
12
  const AJUDA = [
12
13
  'Uso: ai-harness banco-dados <subcomando>',
13
14
  '',
14
- ' adicionar <nome> [--env <VAR>] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
15
+ ' adicionar <nome> [--env <VAR>] [--dsn <dsn>] [--banco-dados <banco>] [--producao] [--sem-testar] [--substituir]',
15
16
  ' grava no projeto: o DSN na variável <NOME>_DATABASE_URL (ou --env) do .claude/settings.local.json',
16
17
  ' e a conexão { nome, dsn_env } em banco_dados.conexoes do .ai-harness/config.json',
17
18
  ' (sem --dsn, pergunta os dados)',
18
- ' adicionar <nome> --global [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]',
19
+ ' adicionar <nome> --global [--dsn <dsn>] [--banco-dados <banco>] [--producao] [--sem-testar] [--substituir]',
19
20
  ' cadastra a conexão nesta máquina',
21
+ ` DSN com ${MARCADOR_BANCO_DADOS} é modelo: sem --banco-dados grava sem testar; com ele, testa nesse banco`,
20
22
  ' listar mostra as conexões cadastradas e as do projeto, sem a senha',
21
- ' testar [nome] testa a conexão pedida ou todas as do projeto',
23
+ ' testar [nome] [--banco-dados <banco>]',
24
+ ' testa a conexão pedida ou todas as do projeto; conexão modelo exige --banco-dados',
22
25
  ' usar <nome...> grava banco_dados.conexoes no .ai-harness/config.json, para conexões do cadastro global',
23
26
  ' (mantém as entradas { nome, dsn_env })',
24
27
  ' remover <nome> [--global]',
@@ -39,6 +42,24 @@ function isObject(valor) {
39
42
  function alvoDe(conexao, cwd) {
40
43
  return conexao.tipo === 'sqlite' ? resolve(cwd, conexao.caminho ?? '') : (conexao.dsn ?? '');
41
44
  }
45
+ function comBanco(conexao, banco) {
46
+ const valido = validarNomeBancoDados(banco);
47
+ const trocar = (texto) => texto?.split(MARCADOR_BANCO_DADOS).join(valido);
48
+ return { ...conexao, ...(conexao.dsn === undefined ? {} : { dsn: trocar(conexao.dsn) }), ...(conexao.caminho === undefined ? {} : { caminho: trocar(conexao.caminho) }) };
49
+ }
50
+ function avisoModelo(nome) {
51
+ return `Conexão modelo (${MARCADOR_BANCO_DADOS}): gravada sem testar; teste com banco-dados testar ${nome} --banco-dados <banco>.`;
52
+ }
53
+ /** null quando não há o que testar: conexão modelo sem banco escolhido. */
54
+ function alvoDoTeste(ctx, conexao, banco) {
55
+ if (!ehModelo(conexao))
56
+ return conexao;
57
+ if (banco === undefined)
58
+ return null;
59
+ const aplicada = comBanco(conexao, banco);
60
+ ctx.sensiveis.push(aplicada);
61
+ return aplicada;
62
+ }
42
63
  async function testarConexao(ctx, conexao) {
43
64
  let driver;
44
65
  try {
@@ -122,7 +143,9 @@ function conexaoDoDsn(dsn, cwd, producao) {
122
143
  return conexao;
123
144
  }
124
145
  async function adicionar(ctx, argv) {
125
- const { posicionais, marcadas, valores } = lerArgumentos(argv, ['--producao', '--sem-testar', '--substituir', '--global'], ['--dsn', '--env']);
146
+ const { posicionais, marcadas, valores } = lerArgumentos(argv, ['--producao', '--sem-testar', '--substituir', '--global'], ['--dsn', '--env', '--banco-dados']);
147
+ if (valores['--banco-dados'] !== undefined)
148
+ validarNomeBancoDados(valores['--banco-dados']);
126
149
  const [nome, ...sobra] = posicionais;
127
150
  if (!nome || sobra.length > 0) {
128
151
  throw new Error('Uso: ai-harness banco-dados adicionar <nome> [--global | --env <VAR>] [--dsn <dsn>] [--producao] [--sem-testar] [--substituir]');
@@ -139,8 +162,9 @@ async function adicionar(ctx, argv) {
139
162
  const dsn = valores['--dsn'];
140
163
  const conexao = dsn === undefined ? await perguntarConexao() : conexaoDoDsn(dsn, ctx.cwd, marcadas.has('--producao'));
141
164
  ctx.sensiveis.push(conexao);
142
- if (!marcadas.has('--sem-testar')) {
143
- const falha = await testarConexao(ctx, conexao);
165
+ const testavel = alvoDoTeste(ctx, conexao, valores['--banco-dados']);
166
+ if (testavel !== null && !marcadas.has('--sem-testar')) {
167
+ const falha = await testarConexao(ctx, testavel);
144
168
  if (falha !== null) {
145
169
  ctx.erro(`Falha ao conectar em ${nome} (${resumirConexao(conexao)}): ${falha}`);
146
170
  ctx.erro('Nada foi gravado. Confira os dados ou use --sem-testar para gravar mesmo assim.');
@@ -149,6 +173,8 @@ async function adicionar(ctx, argv) {
149
173
  }
150
174
  salvarConexao(nome, conexao, { substituir, caminho: ctx.cadastro });
151
175
  ctx.log(`Conexão ${nome} gravada em ${ctx.cadastro}: ${resumirConexao(conexao)}${conexao.producao ? ' (produção)' : ''}.`);
176
+ if (testavel === null && !marcadas.has('--sem-testar'))
177
+ ctx.log(avisoModelo(nome));
152
178
  ctx.log(`No projeto, rode: npx @fontdata/ai-harness banco-dados usar ${nome}`);
153
179
  return 0;
154
180
  }
@@ -232,8 +258,9 @@ async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
232
258
  ctx.erro(`A variável ${variavel} já está definida em ${SETTINGS_LOCAL_PATH} com outro valor. Use --substituir para trocá-la.`);
233
259
  return 1;
234
260
  }
235
- if (!marcadas.has('--sem-testar')) {
236
- const falha = await testarConexao(ctx, alvo);
261
+ const testavel = alvoDoTeste(ctx, alvo, valores['--banco-dados']);
262
+ if (testavel !== null && !marcadas.has('--sem-testar')) {
263
+ const falha = await testarConexao(ctx, testavel);
237
264
  if (falha !== null) {
238
265
  ctx.erro(`Falha ao conectar em ${nome} (${resumirConexao(conexaoDoDsn(valor, ctx.cwd, false))}): ${falha}`);
239
266
  ctx.erro('Nada foi gravado. Confira os dados ou use --sem-testar para gravar mesmo assim.');
@@ -241,6 +268,8 @@ async function adicionarNoProjeto(ctx, nome, marcadas, valores) {
241
268
  }
242
269
  }
243
270
  const { changed } = gravarVariavelSettingsLocal(ctx.cwd, variavel, valor);
271
+ if (testavel === null && !marcadas.has('--sem-testar'))
272
+ ctx.log(avisoModelo(nome));
244
273
  ctx.log(changed ? `Variável ${variavel} gravada em ${SETTINGS_LOCAL_PATH}.` : `Variável ${variavel} já estava com esse valor em ${SETTINGS_LOCAL_PATH}.`);
245
274
  if (declarada.forma === 'objeto' && !promover) {
246
275
  ctx.log(`Conexão ${nome} já declarada em banco_dados.conexoes de ${CONFIG_PATH}; a entrada não foi alterada.`);
@@ -274,14 +303,17 @@ function listar(ctx, argv) {
274
303
  }
275
304
  for (const nome of nomes) {
276
305
  const conexao = conexoes[nome];
277
- ctx.log(`${nome} ${conexao.tipo} ${resumirConexao(conexao)} ${conexao.producao ? 'produção' : 'não produção'}`);
306
+ ctx.log(`${nome} ${conexao.tipo} ${resumirConexao(conexao)} ${conexao.producao ? 'produção' : 'não produção'}${ehModelo(conexao) ? ' modelo' : ''}`);
278
307
  }
279
308
  if (doProjeto.length > 0)
280
309
  ctx.log(`Conexões do projeto em ${CONFIG_PATH}:`);
281
310
  for (const declarada of doProjeto) {
282
311
  const lida = lerVariavel(declarada.dsn_env, ctx.cwd);
283
312
  let tipo = declarada.tipo ?? '?';
313
+ let modelo = '';
284
314
  if (lida) {
315
+ if (lida.valor.includes(MARCADOR_BANCO_DADOS))
316
+ modelo = ' modelo';
285
317
  ctx.sensiveis.push(sensivel(lida.valor));
286
318
  if (declarada.tipo === undefined) {
287
319
  try {
@@ -293,14 +325,17 @@ function listar(ctx, argv) {
293
325
  }
294
326
  }
295
327
  const fonte = lida ? `(${lida.fonte})` : 'ausente';
296
- ctx.log(`${declarada.nome} ${tipo} ${declarada.dsn_env} ${fonte} ${declarada.producao ? 'produção' : 'não produção'}`);
328
+ ctx.log(`${declarada.nome} ${tipo} ${declarada.dsn_env} ${fonte} ${declarada.producao ? 'produção' : 'não produção'}${modelo}`);
297
329
  }
298
330
  return 0;
299
331
  }
300
332
  async function testar(ctx, argv) {
301
- const { posicionais } = lerArgumentos(argv, []);
333
+ const { posicionais, valores } = lerArgumentos(argv, [], ['--banco-dados']);
302
334
  if (posicionais.length > 1)
303
- throw new Error('Uso: ai-harness banco-dados testar [nome]');
335
+ throw new Error('Uso: ai-harness banco-dados testar [nome] [--banco-dados <banco>]');
336
+ const banco = valores['--banco-dados'];
337
+ if (banco !== undefined)
338
+ validarNomeBancoDados(banco);
304
339
  const [nome] = posicionais;
305
340
  const cadastro = lerCadastro(ctx.cadastro);
306
341
  const doProjeto = nome !== undefined && nome in readConfig(ctx.cwd).config.banco_dados.projeto;
@@ -340,8 +375,17 @@ async function testar(ctx, argv) {
340
375
  return 1;
341
376
  }
342
377
  }
343
- for (const alvo of alvos) {
344
- ctx.sensiveis.push(alvo);
378
+ for (const original of alvos) {
379
+ ctx.sensiveis.push(original);
380
+ const alvo = alvoDoTeste(ctx, original, banco);
381
+ if (alvo === null) {
382
+ if (nome === undefined) {
383
+ ctx.log(`${original.nome} modelo: exige --banco-dados para testar`);
384
+ continue;
385
+ }
386
+ ctx.erro(`A conexão ${original.nome} é um modelo e exige --banco-dados <banco>.`);
387
+ return 1;
388
+ }
345
389
  const falha = await testarConexao(ctx, alvo);
346
390
  if (falha === null)
347
391
  ctx.log(`ok ${alvo.nome} ${resumirConexao(alvo)}`);
@@ -2,6 +2,12 @@ import { resolve } from 'node:path';
2
2
  import { readConfig } from '../config/config.js';
3
3
  import { lerVariavel, lerVariavelDotEnv } from './ambiente.js';
4
4
  import { lerCadastro } from './cadastro.js';
5
+ import { ehModelo } from './modelo-banco.js';
6
+ function marcarModelo(conexao) {
7
+ if (ehModelo(conexao))
8
+ conexao.modelo = true;
9
+ return conexao;
10
+ }
5
11
  const EXTENSAO_SQLITE = /\.(db|sqlite|sqlite3)$/i;
6
12
  export function raizDoProjeto(env = process.env, cwd = process.cwd()) {
7
13
  return env.CLAUDE_PROJECT_DIR || cwd;
@@ -39,7 +45,7 @@ function daConexaoCadastrada(nome, conexao, raiz) {
39
45
  resolvida.caminho = resolve(raiz, conexao.caminho ?? '');
40
46
  else if (conexao.dsn)
41
47
  resolvida.dsn = conexao.dsn;
42
- return resolvida;
48
+ return marcarModelo(resolvida);
43
49
  }
44
50
  function resolverDoProjeto(declarada, raiz, env, saida) {
45
51
  const { nome, dsn_env: variavel } = declarada;
@@ -53,7 +59,7 @@ function resolverDoProjeto(declarada, raiz, env, saida) {
53
59
  try {
54
60
  const interpretado = interpretarDsn(lida.valor, raiz);
55
61
  if (declarada.tipo === undefined || declarada.tipo === interpretado.tipo) {
56
- saida.conexoes.push({
62
+ saida.conexoes.push(marcarModelo({
57
63
  nome,
58
64
  producao: declarada.producao,
59
65
  mascaramento: true,
@@ -61,7 +67,7 @@ function resolverDoProjeto(declarada, raiz, env, saida) {
61
67
  origem: 'projeto',
62
68
  variavel,
63
69
  fonte: lida.fonte,
64
- });
70
+ }));
65
71
  return;
66
72
  }
67
73
  motivo = `o DSN da variável ${variavel} é do tipo ${interpretado.tipo}, mas a conexão declara tipo ${declarada.tipo}`;
@@ -89,7 +95,7 @@ export function resolverConexoes(raiz, opcoes = {}) {
89
95
  if (url) {
90
96
  saida.segredos.push(url);
91
97
  try {
92
- saida.conexoes.push({ nome: 'env', producao: false, mascaramento: true, ...interpretarDsn(url, raiz), origem: 'env' });
98
+ saida.conexoes.push(marcarModelo({ nome: 'env', producao: false, mascaramento: true, ...interpretarDsn(url, raiz), origem: 'env' }));
93
99
  }
94
100
  catch (erro) {
95
101
  saida.problemas.push(`DATABASE_URL do .env ignorado: ${erro.message}`);
@@ -46,6 +46,10 @@ export function criarDriverMariadb(dsn, opcoes = {}) {
46
46
  async testar() {
47
47
  await executar('SELECT 1');
48
48
  },
49
+ async listarBancos() {
50
+ const linhas = await executar('SHOW DATABASES');
51
+ return linhas.map((b) => String(Object.values(b)[0]));
52
+ },
49
53
  async listarTabelas() {
50
54
  const linhas = await executar(`SELECT table_name AS nome, table_type AS tipo
51
55
  FROM information_schema.tables
@@ -71,6 +71,10 @@ export function criarDriverPostgres(dsn, opcoes = {}) {
71
71
  async testar() {
72
72
  await linhas('SELECT 1');
73
73
  },
74
+ async listarBancos() {
75
+ const resultado = await linhas('SELECT datname FROM pg_database WHERE NOT datistemplate ORDER BY 1');
76
+ return resultado.map((b) => b.datname);
77
+ },
74
78
  async listarTabelas() {
75
79
  const resultado = await linhas(`SELECT table_schema AS schema, table_name AS nome, table_type AS tipo
76
80
  FROM information_schema.tables
@@ -48,6 +48,9 @@ export async function criarDriverSqlite(caminho) {
48
48
  async testar() {
49
49
  todas('SELECT count(*) FROM sqlite_master');
50
50
  },
51
+ async listarBancos() {
52
+ throw new Error('listar_bancos não vale para SQLite');
53
+ },
51
54
  async listarTabelas() {
52
55
  const linhas = todas(`SELECT name AS nome, type AS tipo FROM sqlite_master
53
56
  WHERE type IN ('table', 'view') AND name NOT LIKE 'sqlite_%'
@@ -3,11 +3,16 @@ import { ocultarSenha } from './cadastro.js';
3
3
  import { escolherConexao, resolverConexoes } from './conexao.js';
4
4
  import { criarDriver } from './drivers/index.js';
5
5
  import { categoriaDaColuna, mascararResultado, mascararTexto } from './lgpd/aplicar.js';
6
+ import { aplicarBancoDados, dsnDoServidor, MARCADOR_BANCO_DADOS } from './modelo-banco.js';
6
7
  import { validarLeitura } from './somente-leitura.js';
7
8
  const CONEXAO = {
8
9
  type: 'string',
9
10
  description: 'Nome da conexão do projeto; sem ele vale a primeira de banco_dados.conexoes.',
10
11
  };
12
+ const BANCO_DADOS = {
13
+ type: 'string',
14
+ description: `Nome do banco; obrigatório na conexão modelo (DSN com ${MARCADOR_BANCO_DADOS}) e recusado nas outras.`,
15
+ };
11
16
  export const FERRAMENTAS = [
12
17
  {
13
18
  name: 'listar_conexoes',
@@ -17,7 +22,7 @@ export const FERRAMENTAS = [
17
22
  {
18
23
  name: 'listar_tabelas',
19
24
  description: 'Lista as tabelas e views do banco, com o schema no Postgres.',
20
- inputSchema: { type: 'object', properties: { conexao: CONEXAO }, additionalProperties: false },
25
+ inputSchema: { type: 'object', properties: { conexao: CONEXAO, banco_dados: BANCO_DADOS }, additionalProperties: false },
21
26
  },
22
27
  {
23
28
  name: 'descrever_tabela',
@@ -27,6 +32,7 @@ export const FERRAMENTAS = [
27
32
  properties: {
28
33
  tabela: { type: 'string', description: 'Nome da tabela, com o schema quando preciso (schema.tabela).' },
29
34
  conexao: CONEXAO,
35
+ banco_dados: BANCO_DADOS,
30
36
  },
31
37
  required: ['tabela'],
32
38
  additionalProperties: false,
@@ -45,11 +51,17 @@ export const FERRAMENTAS = [
45
51
  description: 'Máximo de linhas devolvidas; nunca passa de banco_dados.limite_linhas do projeto.',
46
52
  },
47
53
  conexao: CONEXAO,
54
+ banco_dados: BANCO_DADOS,
48
55
  },
49
56
  required: ['sql'],
50
57
  additionalProperties: false,
51
58
  },
52
59
  },
60
+ {
61
+ name: 'listar_bancos',
62
+ description: 'Lista os bancos do servidor da conexão (Postgres e MariaDB); no SQLite não vale, porque os bancos são os arquivos.',
63
+ inputSchema: { type: 'object', properties: { conexao: CONEXAO }, additionalProperties: false },
64
+ },
53
65
  ];
54
66
  export const INSTRUCOES = [
55
67
  'Use estas ferramentas para ler o banco de dados do projeto; o acesso é somente leitura.',
@@ -57,6 +69,7 @@ export const INSTRUCOES = [
57
69
  '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.',
58
70
  'Sem conexão configurada, oriente o usuário a rodar na raiz do projeto `npx @fontdata/ai-harness banco-dados adicionar <nome>`.',
59
71
  '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.',
72
+ `Numa conexão modelo ("modelo": true em listar_conexoes, DSN com ${MARCADOR_BANCO_DADOS}), passe o nome do banco em banco_dados. Se o usuário não disse qual banco usar, pergunte ao usuário; nunca chute o nome. Use listar_bancos para mostrar as opções e repita o mesmo banco_dados em todas as chamadas do mesmo problema.`,
60
73
  'Antes de consultar, rode listar_tabelas e descrever_tabela para conhecer o esquema.',
61
74
  'Em consultar, selecione só as colunas necessárias e filtre as linhas; evite SELECT *.',
62
75
  'Somente leitura: comandos que alteram dados ou esquema são recusados.',
@@ -148,8 +161,10 @@ function escolher(resolvidas, banco, nome) {
148
161
  }
149
162
  return escolherConexao(resolvidas.conexoes, alvo);
150
163
  }
151
- function descreverConexao({ nome, tipo, producao, origem, variavel, fonte }) {
164
+ function descreverConexao({ nome, tipo, producao, origem, variavel, fonte, modelo }) {
152
165
  const dados = { nome, tipo, producao, origem };
166
+ if (modelo)
167
+ dados.modelo = true;
153
168
  if (origem === 'projeto')
154
169
  Object.assign(dados, { dsn_env: variavel, fonte });
155
170
  return dados;
@@ -164,7 +179,7 @@ async function comDriver(conexao, contexto, acao) {
164
179
  await driver.fechar().catch(() => { });
165
180
  }
166
181
  }
167
- async function executar(nome, args, contexto, banco, resolvidas) {
182
+ async function executar(nome, args, contexto, banco, resolvidas, segredos) {
168
183
  if (nome === 'listar_conexoes') {
169
184
  const { conexoes, faltando, variaveisAusentes, descartadas } = resolvidas;
170
185
  const dados = { conexoes: conexoes.map(descreverConexao) };
@@ -187,12 +202,30 @@ async function executar(nome, args, contexto, banco, resolvidas) {
187
202
  dados.problemas = resolvidas.problemas;
188
203
  return { content: [{ type: 'text', text: paraJson(dados) }] };
189
204
  }
190
- if (!['listar_tabelas', 'descrever_tabela', 'consultar'].includes(nome))
205
+ if (!['listar_tabelas', 'descrever_tabela', 'consultar', 'listar_bancos'].includes(nome))
191
206
  return erro(`Ferramenta desconhecida: ${nome}`);
192
- const conexao = escolher(resolvidas, banco, argumentoTexto(args, 'conexao', false));
193
- if (conexao.producao && banco.producao === 'bloqueio') {
194
- 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.`);
207
+ const escolhida = escolher(resolvidas, banco, argumentoTexto(args, 'conexao', false));
208
+ if (escolhida.producao && banco.producao === 'bloqueio') {
209
+ return erro(`Conexão ${escolhida.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.`);
210
+ }
211
+ if (nome === 'listar_bancos') {
212
+ const dsn = dsnDoServidor(escolhida);
213
+ const servidor = dsn === undefined ? escolhida : { ...escolhida, dsn };
214
+ if (dsn)
215
+ segredos.push(dsn);
216
+ const bancos = await comDriver(servidor, contexto, (driver) => driver.listarBancos());
217
+ return { content: [{ type: 'text', text: paraJson({ conexao: escolhida.nome, bancos }) }] };
218
+ }
219
+ const bancoDados = argumentoTexto(args, 'banco_dados', false);
220
+ if (escolhida.modelo && bancoDados === undefined) {
221
+ return erro(`A conexão ${escolhida.nome} é um modelo e exige o parâmetro banco_dados (o nome do banco); pergunte ao usuário qual banco usar.`);
222
+ }
223
+ if (!escolhida.modelo && bancoDados !== undefined) {
224
+ return erro(`A conexão ${escolhida.nome} não tem o marcador ${MARCADOR_BANCO_DADOS} no DSN; o parâmetro banco_dados não vale para ela.`);
195
225
  }
226
+ const conexao = bancoDados === undefined ? escolhida : aplicarBancoDados(escolhida, bancoDados);
227
+ if (bancoDados !== undefined && conexao.dsn)
228
+ segredos.push(conexao.dsn);
196
229
  let dados;
197
230
  let rodape = '';
198
231
  if (nome === 'listar_tabelas') {
@@ -235,9 +268,9 @@ export async function executarFerramenta(nome, args, contexto) {
235
268
  const { config } = readConfig(contexto.raiz);
236
269
  const resolvidas = resolverConexoes(contexto.raiz, contexto.cadastro ? { cadastro: contexto.cadastro } : {});
237
270
  conexoes = resolvidas.conexoes;
238
- segredos = resolvidas.segredos;
271
+ segredos = [...resolvidas.segredos];
239
272
  const argumentos = typeof args === 'object' && args !== null && !Array.isArray(args) ? args : {};
240
- const resultado = await executar(nome, argumentos, contexto, config.banco_dados, resolvidas);
273
+ const resultado = await executar(nome, argumentos, contexto, config.banco_dados, resolvidas, segredos);
241
274
  const texto = limpar(resultado.content[0].text, conexoes, segredos);
242
275
  resultado.content[0].text = resultado.isError ? mascararTexto(texto) : texto;
243
276
  return resultado;
@@ -0,0 +1,31 @@
1
+ export const MARCADOR_BANCO_DADOS = '<BANCO_DADOS>';
2
+ const NOME_BANCO_DADOS = /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,62}$/;
3
+ export function ehModelo(conexao) {
4
+ return Boolean(conexao.dsn?.includes(MARCADOR_BANCO_DADOS) || conexao.caminho?.includes(MARCADOR_BANCO_DADOS));
5
+ }
6
+ /** Devolve o nome se for válido; o erro nunca ecoa o valor recebido. */
7
+ export function validarNomeBancoDados(nome) {
8
+ if (typeof nome !== 'string' || !NOME_BANCO_DADOS.test(nome)) {
9
+ throw new Error('Nome de banco inválido em banco_dados: use letras, dígitos, _, - e ., sem começar por ponto.');
10
+ }
11
+ return nome;
12
+ }
13
+ /** Cópia da conexão com o marcador do dsn ou do caminho trocado pelo nome validado. */
14
+ export function aplicarBancoDados(conexao, nome) {
15
+ const valido = validarNomeBancoDados(nome);
16
+ const aplicada = { ...conexao };
17
+ if (aplicada.dsn !== undefined)
18
+ aplicada.dsn = aplicada.dsn.split(MARCADOR_BANCO_DADOS).join(valido);
19
+ if (aplicada.caminho !== undefined)
20
+ aplicada.caminho = aplicada.caminho.split(MARCADOR_BANCO_DADOS).join(valido);
21
+ return aplicada;
22
+ }
23
+ /** DSN para falar com o servidor sem escolher banco: Postgres usa `postgres`, MariaDB fica sem o segmento do banco. */
24
+ export function dsnDoServidor(conexao) {
25
+ const { dsn } = conexao;
26
+ if (!dsn?.includes(MARCADOR_BANCO_DADOS))
27
+ return dsn;
28
+ if (conexao.tipo === 'mariadb')
29
+ return dsn.split(`/${MARCADOR_BANCO_DADOS}`).join('');
30
+ return dsn.split(MARCADOR_BANCO_DADOS).join('postgres');
31
+ }
@@ -34,14 +34,15 @@ export const READ_PERMISSIONS = [
34
34
  'Bash(gh pr diff:*)',
35
35
  'Bash(npm outdated:*)',
36
36
  ];
37
- const BANCO_TOOLS = ['listar_conexoes', 'listar_tabelas', 'descrever_tabela', 'consultar'];
37
+ const BANCO_TOOLS_LEGADAS = ['listar_conexoes', 'listar_tabelas', 'descrever_tabela', 'consultar'];
38
+ const BANCO_TOOLS = [...BANCO_TOOLS_LEGADAS, 'listar_bancos'];
38
39
  /**
39
40
  * Ferramentas do servidor MCP de banco, registrado pelo `.mcp.json` (`banco_dados`) ou pelo plugin
40
41
  * (`banco_dados`). A `consultar` também é liberada: os dados pessoais chegam mascarados.
41
42
  */
42
43
  export const BANCO_PERMISSIONS = ['mcp__banco_dados__', 'mcp__plugin_fontdata_banco_dados__'].flatMap((prefixo) => BANCO_TOOLS.map((ferramenta) => `${prefixo}${ferramenta}`));
43
44
  /** As mesmas regras com o nome antigo do servidor (`banco`, até a 2.7.0); o update as remove. */
44
- export const BANCO_PERMISSIONS_LEGADAS = ['mcp__banco__', 'mcp__plugin_fontdata_banco__'].flatMap((prefixo) => BANCO_TOOLS.map((ferramenta) => `${prefixo}${ferramenta}`));
45
+ export const BANCO_PERMISSIONS_LEGADAS = ['mcp__banco__', 'mcp__plugin_fontdata_banco__'].flatMap((prefixo) => BANCO_TOOLS_LEGADAS.map((ferramenta) => `${prefixo}${ferramenta}`));
45
46
  /** Regras de `permissions.allow` que o init e o update gravam para as skills e os agents do harness. */
46
47
  export const HARNESS_PERMISSIONS = [
47
48
  EVENT_PERMISSION,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.5.2",
3
+ "version": "4.6.0",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "bin": {