@fontdata/ai-harness 4.5.1 → 4.5.2
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 +10 -3
- package/dist/config/config.js +24 -1
- package/dist/delphi/catalogo.js +34 -1
- package/dist/delphi/command.js +24 -5
- package/dist/doctor/checks.js +17 -4
- package/package.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.5.
|
|
3
|
+
"version": "4.5.2",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.
|
|
5
|
+
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.2", "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
|
-
|
|
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
|
|
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
|
|
package/dist/config/config.js
CHANGED
|
@@ -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
|
/**
|
package/dist/delphi/catalogo.js
CHANGED
|
@@ -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) {
|
package/dist/delphi/command.js
CHANGED
|
@@ -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
|
|
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}.`);
|
package/dist/doctor/checks.js
CHANGED
|
@@ -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
|
|
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
|
-
?
|
|
298
|
-
: `O catálogo ${CAMINHO_CATALOGO} não bate com as units Fontdata.*
|
|
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
|
];
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fontdata/ai-harness",
|
|
3
|
-
"version": "4.5.
|
|
3
|
+
"version": "4.5.2",
|
|
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": {
|