@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.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.5.1",
3
+ "version": "4.5.2",
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.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
- - `--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
 
@@ -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
  ];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.5.1",
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": {