@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.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +8 -0
- 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/cli.js +7 -0
- package/dist/config/config.js +47 -5
- package/dist/doctor/checks.js +2 -0
- package/dist/doctor/seguranca.js +101 -0
- package/dist/init.js +1 -1
- package/dist/install/plan.js +16 -3
- package/dist/install/settings.js +86 -15
- package/dist/seguranca/checar-comando.js +90 -0
- package/dist/update/update.js +17 -13
- package/package.json +1 -1
- package/templates/hooks/arquivo-sensivel.mjs +83 -0
- package/templates/hooks/comando-destrutivo.mjs +74 -0
- package/templates/hooks/hooks.json +9 -2
- package/templates/hooks/lib/comando-texto.mjs +386 -0
- package/templates/hooks/lib/config.mjs +43 -0
- package/templates/hooks/lib/hook.mjs +22 -12
- package/templates/hooks/lib/regras/apagar.mjs +100 -0
- package/templates/hooks/lib/regras/git.mjs +131 -0
- package/templates/hooks/lib/regras/remoto.mjs +228 -0
- package/templates/hooks/lib/regras/sql.mjs +63 -0
- package/templates/hooks/lib/segredos.mjs +1 -1
- package/templates/rules/seguranca.md +83 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.7.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.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]
|
|
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/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) {
|
package/dist/config/config.js
CHANGED
|
@@ -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
|
|
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
|
|
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
|
-
|
|
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) {
|
package/dist/doctor/checks.js
CHANGED
|
@@ -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()),
|