@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.
- package/.claude-plugin/plugin.json +2 -2
- package/dist/banco-dados/command.js +58 -14
- package/dist/banco-dados/conexao.js +10 -4
- package/dist/banco-dados/drivers/mariadb.js +4 -0
- package/dist/banco-dados/drivers/postgres.js +4 -0
- package/dist/banco-dados/drivers/sqlite.js +3 -0
- package/dist/banco-dados/ferramentas.js +42 -9
- package/dist/banco-dados/modelo-banco.js +31 -0
- package/dist/install/settings.js +3 -2
- package/package.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.6.0",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.
|
|
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]
|
|
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
|
-
|
|
143
|
-
|
|
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
|
-
|
|
236
|
-
|
|
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
|
|
344
|
-
ctx.sensiveis.push(
|
|
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
|
|
193
|
-
if (
|
|
194
|
-
return erro(`Conexão ${
|
|
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
|
+
}
|
package/dist/install/settings.js
CHANGED
|
@@ -34,14 +34,15 @@ export const READ_PERMISSIONS = [
|
|
|
34
34
|
'Bash(gh pr diff:*)',
|
|
35
35
|
'Bash(npm outdated:*)',
|
|
36
36
|
];
|
|
37
|
-
const
|
|
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) =>
|
|
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.
|
|
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": {
|