@fontdata/ai-harness 4.5.2 → 4.7.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.7.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.7.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
@@ -313,6 +313,7 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
313
313
  | `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
314
314
  | `delphi encoding detectar\|converter\|checar` | Encoding e EOL dos fontes Delphi: diagnóstico, conversão para UTF-8 com BOM e checagem (veja [Comando `delphi encoding`](#comando-delphi-encoding)) |
315
315
  | `delphi catalogo` | Catálogo das units `Fontdata.*.pas` do search path dos `.dproj` (`--pasta <dir>`, `--check`; veja [Comando `delphi catalogo`](#comando-delphi-catalogo)) |
316
+ | `checar-comando "<comando>"` | Diz se o hook `comando-destrutivo` negaria, perguntaria ou liberaria o comando, sem gravar nada (sai com 2, 3 ou 0) |
316
317
  | `list` | Lista o catálogo |
317
318
 
318
319
  O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
@@ -372,11 +373,18 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
372
373
  | `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
373
374
  | `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
374
375
  | `padroes-proibidos` | `Edit`, `MultiEdit` ou `Write` que introduz um padrão declarado em `.ai-harness/padroes.json` | aviso |
376
+ | `comando-destrutivo` | `Bash` ou `PowerShell` que apaga em massa, descarta mudança do git, roda DDL/DML pelo terminal, joga texto num shell ou lê/envia segredo: nega o catastrófico e pede aprovação para o resto | **bloqueio** |
377
+ | `arquivo-sensivel` | Gravação em `.git/`, em pasta de credenciais ou no lock (nega), fora da raiz ou nos arquivos de config e settings (pergunta) | **bloqueio** |
375
378
 
376
379
  O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
377
380
  internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
378
381
  hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
379
382
 
383
+ O `comando-destrutivo` e o `arquivo-sensivel` seguem a rule `.claude/rules/seguranca.md`, instalada com os hooks.
384
+ Para saber antes se um comando seria barrado, rode `npx @fontdata/ai-harness checar-comando "<comando>"`. A seção
385
+ `seguranca` do `.ai-harness/config.json` ajusta as `pastas_descartaveis` que podem ser apagadas sem aprovação, o deny
386
+ de leitura de segredos (`negar_leitura_segredos`, padrão `true`) e o `desligar_bypass` (padrão `false`).
387
+
380
388
  O `padroes-proibidos` vale para qualquer stack e só age no projeto que cria o `.ai-harness/padroes.json`; sem o
381
389
  arquivo, ou com a lista vazia, ele não faz nada. Cada entrada traz as extensões, a regex, os flags e o motivo
382
390
  mostrado ao agente. Só o padrão **introduzido** é acusado: o hook conta as ocorrências no texto antigo e no novo
@@ -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
+ }
package/dist/cli.js CHANGED
@@ -24,6 +24,7 @@ const RESERVED = new Set([
24
24
  'delphi',
25
25
  'mapa',
26
26
  'atalhos',
27
+ 'checar-comando',
27
28
  'list',
28
29
  'run',
29
30
  'help',
@@ -75,6 +76,8 @@ Gerenciar:
75
76
  delphi catalogo Catálogo da API das units Fontdata.*.pas do search path (--pasta <dir>, --check)
76
77
  mapa [caminho] Símbolos públicos por pasta, compartilhadas primeiro (--limite <n>, padrão 4000 caracteres)
77
78
  atalhos [caminho] TODO:/FIXME: do código-fonte, marcando os sem gatilho (--sem-gatilho, --json)
79
+ checar-comando "<comando>" Diz se o hook comando-destrutivo negaria, perguntaria ou liberaria, sem executar
80
+ (sai com 0 liberado, 2 negado, 3 pergunta)
78
81
  list Lista todos os comandos disponíveis no catálogo
79
82
 
80
83
  Init sem perguntas (CI):
@@ -202,6 +205,10 @@ async function main() {
202
205
  const { runShortcutsCommand } = await import('./atalhos/atalhos.js');
203
206
  process.exit(runShortcutsCommand(argv.slice(1)));
204
207
  }
208
+ if (cmd === 'checar-comando') {
209
+ const { runCheckCommandCommand } = await import('./seguranca/checar-comando.js');
210
+ process.exit(runCheckCommandCommand(argv.slice(1)));
211
+ }
205
212
  if (cmd === 'run') {
206
213
  const id = argv[1];
207
214
  if (!id) {
@@ -7,6 +7,8 @@ export const HOOK_MODES = ['aviso', 'bloqueio', 'desligado'];
7
7
  export const DEFAULT_HOOK_MODES = {
8
8
  lembrete: 'aviso',
9
9
  'segredo-no-commit': 'bloqueio',
10
+ 'comando-destrutivo': 'bloqueio',
11
+ 'arquivo-sensivel': 'bloqueio',
10
12
  'task-so-fecha-verde': 'aviso',
11
13
  'proteger-contratos': 'aviso',
12
14
  'sem-jargao': 'aviso',
@@ -15,6 +17,21 @@ export const DEFAULT_HOOK_MODES = {
15
17
  export const MODOS_PRODUCAO = ['aviso', 'bloqueio'];
16
18
  export const TIPOS_CONEXAO_PROJETO = ['postgres', 'mariadb', 'sqlite'];
17
19
  export const PERFIS_DO_CONFIG = ['delphi', 'delphi-fiscal'];
20
+ export const PASTAS_DESCARTAVEIS_PADRAO = [
21
+ 'node_modules',
22
+ 'dist',
23
+ 'build',
24
+ 'out',
25
+ 'coverage',
26
+ '.next',
27
+ '.turbo',
28
+ '.cache',
29
+ '.vite',
30
+ 'tmp',
31
+ 'temp',
32
+ '__history',
33
+ '__recovery',
34
+ ];
18
35
  export const DELPHI_IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
19
36
  function isObject(value) {
20
37
  return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -79,6 +96,7 @@ export function defaultConfig() {
79
96
  perfis: { delphi: true, 'delphi-fiscal': true },
80
97
  perfisExplicitos: {},
81
98
  delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO], catalogo: {} },
99
+ seguranca: { pastas_descartaveis: [...PASTAS_DESCARTAVEIS_PADRAO], negar_leitura_segredos: true, desligar_bypass: false },
82
100
  };
83
101
  }
84
102
  function inteiroEntre(value, min, max) {
@@ -202,6 +220,27 @@ function lerBanco(raw, banco, problems) {
202
220
  if ('lgpd' in raw)
203
221
  lerLgpd(raw.lgpd, banco.lgpd, problems);
204
222
  }
223
+ function lerSeguranca(raw, seguranca, problems) {
224
+ if (!isObject(raw)) {
225
+ problems.push(`seguranca deve ser um objeto com pastas_descartaveis, negar_leitura_segredos e desligar_bypass em ${CONFIG_PATH}; valem os padrões.`);
226
+ return;
227
+ }
228
+ if ('pastas_descartaveis' in raw) {
229
+ const pastas = raw.pastas_descartaveis;
230
+ if (Array.isArray(pastas) && pastas.every((pasta) => typeof pasta === 'string' && pasta !== ''))
231
+ seguranca.pastas_descartaveis = pastas;
232
+ else
233
+ problems.push(`seguranca.pastas_descartaveis deve ser uma lista de pastas (texto) em ${CONFIG_PATH}; vale a lista padrão.`);
234
+ }
235
+ for (const chave of ['negar_leitura_segredos', 'desligar_bypass']) {
236
+ if (!(chave in raw))
237
+ continue;
238
+ if (typeof raw[chave] === 'boolean')
239
+ seguranca[chave] = raw[chave];
240
+ else
241
+ problems.push(`seguranca.${chave} deve ser true ou false em ${CONFIG_PATH}; vale o padrão.`);
242
+ }
243
+ }
205
244
  /** Lê a config sobre os padrões; valores inválidos são ignorados e viram problema, nunca erro. */
206
245
  export function readConfig(root) {
207
246
  const config = defaultConfig();
@@ -271,6 +310,8 @@ export function readConfig(root) {
271
310
  else if (pastas !== undefined)
272
311
  problems.push(`delphi.catalogo.pastas deve ser uma lista de pastas (texto) em ${CONFIG_PATH}; vale o search path dos .dproj.`);
273
312
  }
313
+ if ('seguranca' in raw)
314
+ lerSeguranca(raw.seguranca, config.seguranca, problems);
274
315
  const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
275
316
  if (isObject(secao))
276
317
  lerBanco(secao, config.banco_dados, problems);
@@ -282,18 +323,19 @@ export function readConfig(root) {
282
323
  }
283
324
  return { config, problems };
284
325
  }
285
- /** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
326
+ /** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis, delphi e seguranca, que só entram quando mudam. */
286
327
  function configGravada() {
287
- const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, perfisExplicitos: _perfisExplicitos, delphi: _delphi, ...gravada } = defaultConfig();
328
+ const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, perfisExplicitos: _perfisExplicitos, delphi: _delphi, seguranca: _seguranca, ...gravada } = defaultConfig();
288
329
  return gravada;
289
330
  }
290
- /** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
291
- export function writeDefaultConfig(root) {
331
+ /** Cria a config com os padrões (com `seguranca`, só no `init`, inclui essa seção); retorna false se já existia (nunca sobrescreve). */
332
+ export function writeDefaultConfig(root, { seguranca = false } = {}) {
292
333
  const file = join(root, CONFIG_PATH);
293
334
  if (existsSync(file))
294
335
  return false;
295
336
  mkdirSync(dirname(file), { recursive: true });
296
- writeFileSync(file, `${JSON.stringify(configGravada(), null, 2)}\n`);
337
+ const gravada = seguranca ? { ...configGravada(), seguranca: defaultConfig().seguranca } : configGravada();
338
+ writeFileSync(file, `${JSON.stringify(gravada, null, 2)}\n`);
297
339
  return true;
298
340
  }
299
341
  function lerJsonParaEscrita(file, chave) {
@@ -19,6 +19,7 @@ import { ARCHIVE_DEFAULT_DAYS } from '../trabalhos/command.js';
19
19
  import { ARCHIVE_INDEX, readArchiveIndex } from '../trabalhos/indice-arquivo.js';
20
20
  import { adoptLegacyInstall } from '../update/legado.js';
21
21
  import { checkLegacyDocsCitations, checkMigratedPlansRunning } from './migracao.js';
22
+ import { checkSeguranca } from './seguranca.js';
22
23
  const MIN_NODE_MAJOR = 22;
23
24
  const PLUGIN_ID = 'fontdata@ai-harness';
24
25
  const HARNESS_HOOKS_DIR = '.claude/hooks/ai-harness/';
@@ -713,6 +714,7 @@ export function runDoctor(root, options = {}) {
713
714
  ...checkDelphiRes(root),
714
715
  ...checkConfig(configProblems),
715
716
  ...checkBanco(root, config),
717
+ ...checkSeguranca(root, config),
716
718
  ...checkWorks(root),
717
719
  ...checkArchiveIndex(root),
718
720
  ...checkStaleDraftPlans(root, options.now ?? new Date()),