@fontdata/ai-harness 4.5.1 → 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.1",
3
+ "version": "4.6.0",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.1", "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" },
package/README.md CHANGED
@@ -243,8 +243,13 @@ fontes guarda o nome de cada unit e o `sha256` do conteúdo, sem caminho, então
243
243
  `.dproj`, do sufixo mais longo ao mais curto, com pelo menos 2 segmentos. Por exemplo, `D:\DESEN\Delphi\Bibliotecas\Utils`
244
244
  casa com `~/Documents/DESEN/Delphi/Bibliotecas/Utils` quando o `.dproj` fica dentro de `~/Documents/DESEN`. O
245
245
  caminho que não casa com nada fica sem resolver, e o absoluto com `$(...)` nunca é resolvido.
246
- - `--pasta <dir>`, que pode se repetir, troca o search path pelas pastas informadas.
247
- - `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais.
246
+ - `--pasta <dir>`, que pode se repetir, troca o search path pelas pastas informadas. Ao gerar o catálogo, as pastas
247
+ ficam guardadas em `delphi.catalogo.pastas` no `.ai-harness/config.json`, relativas à raiz do projeto e com `/`
248
+ (`../../Bibliotecas/Utils`), ou absolutas quando não há relativo possível, como numa outra unidade do Windows.
249
+ Depois disso, o comando sem `--pasta`, o `--check` e o `doctor` usam as pastas guardadas no lugar do search path.
250
+ Para voltar ao search path, apague a chave; para trocar as pastas, rode `--pasta` de novo.
251
+ - `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais. Se alguma pasta
252
+ guardada não existe nesta máquina, ele não compara nada e sai com código 1, citando as pastas que faltam.
248
253
 
249
254
  Nenhuma unit encontrada é erro: o comando lista os caminhos absolutos do Windows que não foram encontrados nesta
250
255
  máquina e pede `--pasta` com o caminho das Bibliotecas Fontdata. Num projeto com o perfil Delphi e units `Fontdata.*`
@@ -252,7 +257,9 @@ no search path, o `doctor` avisa `catalogo-fontdata-ausente` quando o catálogo
252
257
  `catalogo-fontdata-desatualizado` quando ele não bate com as units. Quando nenhuma unit é achada, há caminho absoluto
253
258
  sem resolver e alguma `.pas` ou `.dpr` usa uma unit `Fontdata.*` na cláusula `uses` (pelos mesmos arquivos e o mesmo
254
259
  `delphi.ignorar` da detecção do ACBr), o `doctor` avisa `catalogo-fontdata-caminho-nao-resolvido`, lista os caminhos
255
- e sugere `delphi catalogo --pasta <dir>`. Fora desses casos, não há aviso de catálogo.
260
+ e sugere `delphi catalogo --pasta <dir>`; esse aviso só vale sem pastas guardadas. Com uma pasta de
261
+ `delphi.catalogo.pastas` ausente nesta máquina, o `doctor` não confere o catálogo e avisa
262
+ `catalogo-fontdata-pastas-ausentes`, com as pastas que faltam. Fora desses casos, não há aviso de catálogo.
256
263
 
257
264
  ## Conexões de banco de dados
258
265
 
@@ -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
+ }
@@ -78,7 +78,7 @@ export function defaultConfig() {
78
78
  comentarios: { instalar: true },
79
79
  perfis: { delphi: true, 'delphi-fiscal': true },
80
80
  perfisExplicitos: {},
81
- delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
81
+ delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO], catalogo: {} },
82
82
  };
83
83
  }
84
84
  function inteiroEntre(value, min, max) {
@@ -263,6 +263,14 @@ export function readConfig(root) {
263
263
  else
264
264
  problems.push(`delphi.ignorar deve ser uma lista de globs (texto) em ${CONFIG_PATH}; valem os padrões.`);
265
265
  }
266
+ if (isObject(raw.delphi) && 'catalogo' in raw.delphi) {
267
+ const catalogo = raw.delphi.catalogo;
268
+ const pastas = isObject(catalogo) ? catalogo.pastas : null;
269
+ if (Array.isArray(pastas) && pastas.every((pasta) => typeof pasta === 'string' && pasta !== ''))
270
+ config.delphi.catalogo.pastas = pastas;
271
+ else if (pastas !== undefined)
272
+ problems.push(`delphi.catalogo.pastas deve ser uma lista de pastas (texto) em ${CONFIG_PATH}; vale o search path dos .dproj.`);
273
+ }
266
274
  const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
267
275
  if (isObject(secao))
268
276
  lerBanco(secao, config.banco_dados, problems);
@@ -418,6 +426,21 @@ export function gravarPerfil(root, perfil, valor) {
418
426
  export function gravarPerfilDelphi(root, valor) {
419
427
  gravarPerfil(root, 'delphi', valor);
420
428
  }
429
+ /**
430
+ * Grava `delphi.catalogo.pastas`, preservando o resto do JSON; sem config, cria uma com os padrões e essa chave.
431
+ * Não escreve se a lista já é a mesma. JSON inválido é recusado sem tocar no arquivo.
432
+ */
433
+ export function gravarPastasCatalogo(root, pastas) {
434
+ const file = join(root, CONFIG_PATH);
435
+ const raw = existsSync(file) ? lerJsonParaEscrita(file, 'delphi.catalogo.pastas') : configGravada();
436
+ const delphi = isObject(raw.delphi) ? raw.delphi : {};
437
+ const catalogo = isObject(delphi.catalogo) ? delphi.catalogo : {};
438
+ if (JSON.stringify(catalogo.pastas) === JSON.stringify(pastas))
439
+ return;
440
+ const proxima = { ...raw, delphi: { ...delphi, catalogo: { ...catalogo, pastas } } };
441
+ mkdirSync(dirname(file), { recursive: true });
442
+ writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
443
+ }
421
444
  const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
422
445
  const BLOCK_END = '# /ai-harness';
423
446
  /**
@@ -1,4 +1,4 @@
1
- import { existsSync, readdirSync, readFileSync } from 'node:fs';
1
+ import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
2
2
  import path, { join } from 'node:path';
3
3
  import { hashContent } from '../install/lock.js';
4
4
  import { semComentariosPascal } from '../mapa/extratores/pascal.js';
@@ -89,6 +89,39 @@ export function resolverSearchPath(raiz, opcoes = {}) {
89
89
  export function pastasDoSearchPath(raiz) {
90
90
  return resolverSearchPath(raiz).pastas;
91
91
  }
92
+ /** A pasta como vai para `delphi.catalogo.pastas`: relativa à raiz com `/`, ou absoluta quando não há relativo (outra unidade). */
93
+ export function pastaParaGuardar(raiz, pastaAbs, opcoes = {}) {
94
+ const { caminho = path } = opcoes;
95
+ const relativa = caminho.relative(raiz, pastaAbs);
96
+ if (caminho.isAbsolute(relativa))
97
+ return caminho.normalize(pastaAbs);
98
+ return relativa === '' ? '.' : relativa.split(caminho.sep).join('/');
99
+ }
100
+ function caminhoReal(pasta) {
101
+ try {
102
+ return realpathSync(pasta);
103
+ }
104
+ catch {
105
+ return pasta;
106
+ }
107
+ }
108
+ /**
109
+ * Resolve `delphi.catalogo.pastas` sobre o caminho real da raiz, o mesmo de onde a gravação calcula o relativo;
110
+ * sem pastas guardadas, as duas listas vêm vazias.
111
+ */
112
+ export function pastasGuardadas(raiz, config, opcoes = {}) {
113
+ const { caminho = path, existe = existsSync } = opcoes;
114
+ const base = caminhoReal(raiz);
115
+ const resultado = { pastas: [], ausentes: [] };
116
+ for (const guardada of config.delphi.catalogo.pastas ?? []) {
117
+ const pasta = caminho.isAbsolute(guardada) ? caminho.normalize(guardada) : caminho.resolve(base, guardada);
118
+ if (existe(pasta))
119
+ resultado.pastas.push(pasta);
120
+ else
121
+ resultado.ausentes.push(guardada);
122
+ }
123
+ return resultado;
124
+ }
92
125
  export function acharUnitsFontdata(pastas) {
93
126
  const units = new Map();
94
127
  for (const pasta of pastas) {
@@ -1,9 +1,9 @@
1
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
1
+ import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
2
2
  import { basename, dirname, extname, join, resolve } from 'node:path';
3
- import { readConfig } from '../config/config.js';
3
+ import { CONFIG_PATH, gravarPastasCatalogo, readConfig } from '../config/config.js';
4
4
  import { acharRaiz } from '../raiz.js';
5
5
  import { git } from '../trabalhos/arquivar.js';
6
- import { acharUnitsFontdata, CAMINHO_CATALOGO, estadoDoCatalogo, gerarCatalogo, resolverSearchPath } from './catalogo.js';
6
+ import { acharUnitsFontdata, CAMINHO_CATALOGO, estadoDoCatalogo, gerarCatalogo, pastaParaGuardar, pastasGuardadas, resolverSearchPath, } from './catalogo.js';
7
7
  import { classificarRes, detectarDelphi, emRepositorioGit } from './classificar.js';
8
8
  import { casaGlob, checarArquivo, converterParaUtf8Bom, detectarEncoding, detectarEol, EXTENSOES_CONVERTER, EXTENSOES_DELPHI, } from './encoding.js';
9
9
  import { extrairIcone } from './icone.js';
@@ -181,10 +181,19 @@ function catalogo(args) {
181
181
  }
182
182
  }
183
183
  const raiz = acharRaiz();
184
- const searchPath = pastas.length > 0 ? { pastas, naoResolvidas: [] } : resolverSearchPath(raiz);
184
+ const { config } = readConfig(raiz);
185
+ const guardadas = pastasGuardadas(raiz, config);
186
+ if (pastas.length === 0 && guardadas.ausentes.length > 0) {
187
+ console.error(`Estas pastas de delphi.catalogo.pastas em ${CONFIG_PATH} não existem nesta máquina:`);
188
+ for (const ausente of guardadas.ausentes)
189
+ console.error(` ${ausente}`);
190
+ console.error('Nada foi comparado. Crie as pastas, rode delphi catalogo --pasta <dir> para trocar as pastas guardadas, ou apague delphi.catalogo.pastas para voltar ao search path.');
191
+ return 1;
192
+ }
193
+ const searchPath = pastas.length > 0 ? { pastas, naoResolvidas: [] } : guardadas.pastas.length > 0 ? { pastas: guardadas.pastas, naoResolvidas: [] } : resolverSearchPath(raiz);
185
194
  const units = acharUnitsFontdata(searchPath.pastas);
186
195
  if (units.length === 0) {
187
- const onde = pastas.length > 0 ? 'nas pastas informadas' : 'no DCC_UnitSearchPath dos .dproj do projeto';
196
+ const onde = pastas.length > 0 ? 'nas pastas informadas' : guardadas.pastas.length > 0 ? 'nas pastas de delphi.catalogo.pastas' : 'no DCC_UnitSearchPath dos .dproj do projeto';
188
197
  console.error(`Nenhuma unit Fontdata.*.pas encontrada ${onde}.`);
189
198
  if (searchPath.naoResolvidas.length > 0) {
190
199
  console.error('Estes caminhos absolutos do Windows não foram encontrados nesta máquina:');
@@ -205,6 +214,16 @@ function catalogo(args) {
205
214
  console.error(`O catálogo ${CAMINHO_CATALOGO} ${motivo}: rode npx @fontdata/ai-harness delphi catalogo.`);
206
215
  return 1;
207
216
  }
217
+ if (pastas.length > 0) {
218
+ const raizReal = realpathSync(raiz);
219
+ try {
220
+ gravarPastasCatalogo(raiz, pastas.map((pasta) => pastaParaGuardar(raizReal, existsSync(pasta) ? realpathSync(pasta) : pasta)));
221
+ }
222
+ catch (erro) {
223
+ console.error(erro instanceof Error ? erro.message : String(erro));
224
+ return 1;
225
+ }
226
+ }
208
227
  mkdirSync(dirname(destino), { recursive: true });
209
228
  writeFileSync(destino, gerarCatalogo(units));
210
229
  console.log(`Catálogo de ${units.length} unit(s) Fontdata gravado em ${CAMINHO_CATALOGO}.`);
@@ -8,7 +8,7 @@ import { COMMENTS_HOOK_PATH, hookProprioRegistrado } from '../comentarios/instal
8
8
  import { CONFIG_PATH, readConfig } from '../config/config.js';
9
9
  import { ARCHIVE_DIR_NAME, ARTIFACT_TYPES, listWorkFiles, readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
10
10
  import { validateEventLog } from '../contratos/eventos.js';
11
- import { CAMINHO_CATALOGO, checarCatalogo, resolverSearchPath } from '../delphi/catalogo.js';
11
+ import { CAMINHO_CATALOGO, checarCatalogo, pastasGuardadas, resolverSearchPath } from '../delphi/catalogo.js';
12
12
  import { classificarRes } from '../delphi/classificar.js';
13
13
  import { algumUsesCasa } from '../delphi/uses.js';
14
14
  import { hashContent, LOCK_PATH, LOCK_VERSION } from '../install/lock.js';
@@ -283,19 +283,32 @@ function checkCaminhoNaoResolvido(root, naoResolvidas, config) {
283
283
  function checkCatalogoFontdata(root, lock, config) {
284
284
  if (!lock.itens.some((item) => item.tipo === 'perfil' && item.id === 'delphi'))
285
285
  return [];
286
- const { pastas, naoResolvidas } = resolverSearchPath(root);
286
+ const guardadas = pastasGuardadas(root, config);
287
+ if (guardadas.ausentes.length > 0) {
288
+ return [
289
+ {
290
+ id: 'catalogo-fontdata-pastas-ausentes',
291
+ severidade: 'aviso',
292
+ mensagem: `Estas pastas de delphi.catalogo.pastas em ${CONFIG_PATH} não existem nesta máquina, e o catálogo não foi conferido: ${guardadas.ausentes.join(', ')}.`,
293
+ correcao: 'Crie as pastas, rode `npx @fontdata/ai-harness delphi catalogo --pasta <dir>` para trocar as pastas guardadas, ou apague delphi.catalogo.pastas para voltar ao search path.',
294
+ },
295
+ ];
296
+ }
297
+ const comGuardadas = guardadas.pastas.length > 0;
298
+ const { pastas, naoResolvidas } = comGuardadas ? { pastas: guardadas.pastas, naoResolvidas: [] } : resolverSearchPath(root);
287
299
  const estado = checarCatalogo(root, pastas);
288
300
  if (estado === 'sem-units')
289
301
  return checkCaminhoNaoResolvido(root, naoResolvidas, config);
290
302
  if (estado !== 'ausente' && estado !== 'desatualizado')
291
303
  return [];
304
+ const origem = comGuardadas ? 'das pastas de delphi.catalogo.pastas' : 'do search path';
292
305
  return [
293
306
  {
294
307
  id: `catalogo-fontdata-${estado}`,
295
308
  severidade: 'aviso',
296
309
  mensagem: estado === 'ausente'
297
- ? `O search path do projeto tem units Fontdata.*, mas o catálogo ${CAMINHO_CATALOGO} não existe.`
298
- : `O catálogo ${CAMINHO_CATALOGO} não bate com as units Fontdata.* do search path.`,
310
+ ? `${comGuardadas ? 'As pastas de delphi.catalogo.pastas têm' : 'O search path do projeto tem'} units Fontdata.*, mas o catálogo ${CAMINHO_CATALOGO} não existe.`
311
+ : `O catálogo ${CAMINHO_CATALOGO} não bate com as units Fontdata.* ${origem}.`,
299
312
  correcao: 'Rode `npx @fontdata/ai-harness delphi catalogo` para gerar o catálogo de novo.',
300
313
  },
301
314
  ];
@@ -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.1",
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": {