@fontdata/ai-harness 4.7.1 → 4.8.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 +9 -8
- package/dist/config/config.js +10 -4
- package/dist/delphi/classificar.js +11 -6
- package/dist/doctor/checks.js +39 -7
- package/dist/update/update.js +17 -6
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.8.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.8.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
|
@@ -145,14 +145,15 @@ rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com voc
|
|
|
145
145
|
### Perfil `delphi-fiscal`
|
|
146
146
|
|
|
147
147
|
Quando o projeto recebe o perfil Delphi e usa ACBr, o `init` e o `update` instalam também o perfil `delphi-fiscal`,
|
|
148
|
-
como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin. O ACBr é detectado
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
148
|
+
como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin. O ACBr é detectado só pela
|
|
149
|
+
cláusula `uses`: alguma `.pas` ou `.dpr` tem uma unit `ACBr...` (como `ACBrNFe`) nos `uses`, fora de comentário e de
|
|
150
|
+
string. Componente ACBr num form também põe a unit no `uses`, e o projeto que usa ACBr por DCU pré-compilada é pego do
|
|
151
|
+
mesmo jeito. Num repositório git, só contam os arquivos versionados (`git ls-files`); fora dele, os encontrados até 4
|
|
152
|
+
níveis de pasta. Nos dois casos, o que casa com `delphi.ignorar` fica de fora.
|
|
153
|
+
|
|
154
|
+
Citar ACBr num `.dproj` (como pacote `ACBr_*` em `DCC_UsePackage`) ou no `boss.json` não liga o perfil. Nesse caso,
|
|
155
|
+
sem unit ACBr nos `uses`, o `doctor` avisa com `delphi-fiscal-sem-uses`; um projeto que tinha o perfil no lock só por
|
|
156
|
+
essa citação perde o item no próximo `update`.
|
|
156
157
|
|
|
157
158
|
Se a detecção não pegar o seu caso, grave `"perfis": { "delphi-fiscal": true }` no `.ai-harness/config.json` e rode
|
|
158
159
|
`npx @fontdata/ai-harness update --yes`: o `true` gravado no arquivo liga o perfil mesmo sem ACBr detectado. Sem a
|
package/dist/config/config.js
CHANGED
|
@@ -486,14 +486,20 @@ export function gravarPastasCatalogo(root, pastas) {
|
|
|
486
486
|
const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
|
|
487
487
|
const BLOCK_END = '# /ai-harness';
|
|
488
488
|
/**
|
|
489
|
-
* Mantém no .gitignore um bloco próprio: a memória gerada
|
|
490
|
-
*
|
|
491
|
-
* Linhas fora do bloco não são tocadas.
|
|
489
|
+
* Mantém no .gitignore um bloco próprio: a memória gerada, o estado local da sessão (`estado.json`) e os
|
|
490
|
+
* backups `.claude/settings.json.bak-*` e `.mcp.json.bak-*` são sempre ignorados, e o rastro só quando
|
|
491
|
+
* `rastro.versionar` é false. Linhas fora do bloco não são tocadas.
|
|
492
492
|
*/
|
|
493
493
|
export function syncGitignore(root, config) {
|
|
494
494
|
const file = join(root, '.gitignore');
|
|
495
495
|
const current = existsSync(file) ? readFileSync(file, 'utf8') : '';
|
|
496
|
-
const entries = [
|
|
496
|
+
const entries = [
|
|
497
|
+
'.ai-harness/memoria/',
|
|
498
|
+
'.ai-harness/estado.json',
|
|
499
|
+
'.claude/settings.json.bak-*',
|
|
500
|
+
'.mcp.json.bak-*',
|
|
501
|
+
...(config.rastro.versionar ? [] : ['docs/eventos/']),
|
|
502
|
+
];
|
|
497
503
|
const block = [BLOCK_START, ...entries, BLOCK_END].join('\n');
|
|
498
504
|
const start = current.indexOf(BLOCK_START);
|
|
499
505
|
const end = start === -1 ? -1 : current.indexOf(BLOCK_END, start);
|
|
@@ -32,15 +32,20 @@ function citaAcbr(arquivo) {
|
|
|
32
32
|
return false;
|
|
33
33
|
}
|
|
34
34
|
}
|
|
35
|
-
/**
|
|
36
|
-
* Algum `.dproj` ou o `boss.json` da raiz cita ACBr, sem diferenciar maiúsculas; sem achado, alguma `.pas`/`.dpr`
|
|
37
|
-
* fora de `ignorar` tem uma unit `ACBr[A-Z]...` na cláusula `uses`.
|
|
38
|
-
*/
|
|
35
|
+
/** Alguma `.pas`/`.dpr` fora de `ignorar` tem uma unit `ACBr[A-Z]...` na cláusula `uses`; `.dproj` e `boss.json` não contam. */
|
|
39
36
|
export function detectarAcbr(raiz, ignorar) {
|
|
40
|
-
if (citaAcbr(join(raiz, 'boss.json')) || arquivosDproj(raiz).some((rel) => citaAcbr(join(raiz, rel))))
|
|
41
|
-
return true;
|
|
42
37
|
return algumUsesCasa(raiz, (unit) => /^ACBr[A-Z]/.test(unit), ignorar);
|
|
43
38
|
}
|
|
39
|
+
/**
|
|
40
|
+
* Caminhos relativos que citam ACBr sem unit ACBr nos `uses`: o `boss.json` da raiz primeiro, depois os `.dproj`
|
|
41
|
+
* de `arquivosDproj`. Com `detectarAcbr` verdadeiro, `[]`.
|
|
42
|
+
*/
|
|
43
|
+
export function acbrCitadoSemUses(raiz, ignorar) {
|
|
44
|
+
const citados = ['boss.json', ...arquivosDproj(raiz)].filter((rel) => citaAcbr(join(raiz, rel)));
|
|
45
|
+
if (citados.length === 0 || detectarAcbr(raiz, ignorar))
|
|
46
|
+
return [];
|
|
47
|
+
return citados;
|
|
48
|
+
}
|
|
44
49
|
function mesmoNome(nome, esperado) {
|
|
45
50
|
return typeof nome === 'string' && nome.toUpperCase() === esperado;
|
|
46
51
|
}
|
package/dist/doctor/checks.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { execFileSync, spawnSync } from 'node:child_process';
|
|
2
2
|
import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
|
|
3
|
+
import { homedir } from 'node:os';
|
|
3
4
|
import { join } from 'node:path';
|
|
4
5
|
import { lerEnvSettingsLocal, lerVariavel, SETTINGS_LOCAL_PATH } from '../banco-dados/ambiente.js';
|
|
5
6
|
import { caminhoCadastro, lerCadastro } from '../banco-dados/cadastro.js';
|
|
@@ -9,8 +10,10 @@ import { CONFIG_PATH, readConfig } from '../config/config.js';
|
|
|
9
10
|
import { ARCHIVE_DIR_NAME, ARTIFACT_TYPES, listWorkFiles, readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
|
|
10
11
|
import { validateEventLog } from '../contratos/eventos.js';
|
|
11
12
|
import { CAMINHO_CATALOGO, checarCatalogo, pastasGuardadas, resolverSearchPath } from '../delphi/catalogo.js';
|
|
12
|
-
import { classificarRes } from '../delphi/classificar.js';
|
|
13
|
+
import { acbrCitadoSemUses, classificarRes } from '../delphi/classificar.js';
|
|
13
14
|
import { algumUsesCasa } from '../delphi/uses.js';
|
|
15
|
+
import { isHarnessPluginEnabled } from '../install/hooks.js';
|
|
16
|
+
import { perfisDoProjeto } from '../install/perfis.js';
|
|
14
17
|
import { hashContent, LOCK_PATH, LOCK_VERSION } from '../install/lock.js';
|
|
15
18
|
import { agentsForaDoLock, itemSources } from '../install/plan.js';
|
|
16
19
|
import { hookCommands, SETTINGS_PATH } from '../install/settings.js';
|
|
@@ -257,14 +260,42 @@ function checkGitIgnore(root) {
|
|
|
257
260
|
},
|
|
258
261
|
];
|
|
259
262
|
}
|
|
260
|
-
function
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
263
|
+
function correcaoDelphiRes(root, home) {
|
|
264
|
+
const etapa = (skill) => `Rode a etapa \`${skill} ignores\` para classificar, extrair o ícone se preciso e tirar o .res do versionamento com aprovação.`;
|
|
265
|
+
if (existsSync(join(root, '.claude', 'skills', 'harness', 'SKILL.md')))
|
|
266
|
+
return etapa('/harness');
|
|
267
|
+
if (isHarnessPluginEnabled(root, home))
|
|
268
|
+
return etapa('/fontdata:harness');
|
|
269
|
+
return 'Rode `npx @fontdata/ai-harness delphi classificar` para classificar o .res e, se ele não precisar ser versionado, `git rm --cached <arquivo>` e acrescente-o ao .gitignore.';
|
|
270
|
+
}
|
|
271
|
+
function checkDelphiFiscalSemUses(root, config) {
|
|
272
|
+
if (config.perfisExplicitos['delphi-fiscal'] !== undefined)
|
|
273
|
+
return [];
|
|
274
|
+
const perfis = perfisDoProjeto(root, config);
|
|
275
|
+
if (perfis.length !== 1 || perfis[0] !== 'delphi')
|
|
276
|
+
return [];
|
|
277
|
+
const citados = acbrCitadoSemUses(root, config.delphi.ignorar);
|
|
278
|
+
if (citados.length === 0)
|
|
279
|
+
return [];
|
|
280
|
+
return [
|
|
281
|
+
{
|
|
282
|
+
id: 'delphi-fiscal-sem-uses',
|
|
283
|
+
severidade: 'aviso',
|
|
284
|
+
mensagem: `\`${citados.join(', ')}\` cita ACBr, mas nenhuma unit ACBr aparece nos uses: o perfil delphi-fiscal não é instalado.`,
|
|
285
|
+
correcao: 'Se o projeto usa ACBr, grave "perfis": { "delphi-fiscal": true } no .ai-harness/config.json e rode `npx @fontdata/ai-harness update --yes`; se não usa, grave "delphi-fiscal": false para silenciar este aviso.',
|
|
286
|
+
},
|
|
287
|
+
];
|
|
288
|
+
}
|
|
289
|
+
function checkDelphiRes(root, home) {
|
|
290
|
+
const achados = classificarRes(root).filter((res) => res.classe !== 'manter');
|
|
291
|
+
if (achados.length === 0)
|
|
292
|
+
return [];
|
|
293
|
+
const correcao = correcaoDelphiRes(root, home);
|
|
294
|
+
return achados.map((res) => ({
|
|
264
295
|
id: 'delphi-res-versionado',
|
|
265
296
|
severidade: 'aviso',
|
|
266
297
|
mensagem: `${res.caminho} está versionado e é ${res.classe}: ${res.motivo}`,
|
|
267
|
-
correcao
|
|
298
|
+
correcao,
|
|
268
299
|
}));
|
|
269
300
|
}
|
|
270
301
|
function checkCaminhoNaoResolvido(root, naoResolvidas, config) {
|
|
@@ -711,7 +742,8 @@ export function runDoctor(root, options = {}) {
|
|
|
711
742
|
...checkAgents(root),
|
|
712
743
|
...checkSettings(root),
|
|
713
744
|
...checkGitIgnore(root),
|
|
714
|
-
...checkDelphiRes(root),
|
|
745
|
+
...checkDelphiRes(root, options.home ?? homedir()),
|
|
746
|
+
...checkDelphiFiscalSemUses(root, config),
|
|
715
747
|
...checkConfig(configProblems),
|
|
716
748
|
...checkBanco(root, config),
|
|
717
749
|
...checkSeguranca(root, config),
|
package/dist/update/update.js
CHANGED
|
@@ -101,9 +101,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
101
101
|
const stale = [];
|
|
102
102
|
const { config } = readConfig(root);
|
|
103
103
|
const itemDoPerfil = (perfil) => lock.itens.find((item) => item.tipo === 'perfil' && item.id === perfil);
|
|
104
|
+
const perfisDetectados = perfisDoProjeto(root, config);
|
|
104
105
|
const perfisRecusados = PERFIS.flatMap((perfil) => {
|
|
105
106
|
const item = itemDoPerfil(perfil);
|
|
106
|
-
|
|
107
|
+
if (!item)
|
|
108
|
+
return [];
|
|
109
|
+
if (perfilRecusadoNoConfig(perfil, config))
|
|
110
|
+
return [{ perfil, pastas: pastasDoItem(root, item) }];
|
|
111
|
+
const semUses = perfil === 'delphi-fiscal' && perfisDetectados.includes('delphi') && !perfisDetectados.includes(perfil);
|
|
112
|
+
return semUses ? [{ perfil, pastas: pastasDoItem(root, item), semUses }] : [];
|
|
107
113
|
});
|
|
108
114
|
const recusados = itensRecusados(perfisRecusados);
|
|
109
115
|
for (const item of lock.itens) {
|
|
@@ -219,7 +225,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
219
225
|
addItem('rule', 'comentarios', true);
|
|
220
226
|
addItem('hook', 'comentarios', true);
|
|
221
227
|
}
|
|
222
|
-
const instalarPerfis =
|
|
228
|
+
const instalarPerfis = perfisDetectados.filter((perfil) => !itemDoPerfil(perfil));
|
|
223
229
|
for (const perfil of instalarPerfis)
|
|
224
230
|
addItem('perfil', perfil, true);
|
|
225
231
|
const registrarPerfilDelphi = instalarPerfis.includes('delphi') || (!!itemDoPerfil('delphi') && !recusados.has(PERFIL_DELPHI_ITEM) && !perfilDelphiRegistrado(root));
|
|
@@ -489,12 +495,17 @@ export function describeUpdate(report) {
|
|
|
489
495
|
arquivosMantidos(delphiRecusado.pastas),
|
|
490
496
|
]
|
|
491
497
|
: []),
|
|
492
|
-
...(fiscalRecusado
|
|
498
|
+
...(fiscalRecusado?.semUses
|
|
493
499
|
? [
|
|
494
|
-
`
|
|
495
|
-
`perfil delphi-fiscal
|
|
500
|
+
`Nenhuma unit ACBr nos uses do projeto: o --yes tira o perfil delphi-fiscal do ${LOCK_PATH}. ${arquivosMantidos(fiscalRecusado.pastas)} ` +
|
|
501
|
+
`Para manter o perfil, grave perfis["delphi-fiscal"]: true em ${CONFIG_PATH}.`,
|
|
496
502
|
]
|
|
497
|
-
:
|
|
503
|
+
: fiscalRecusado
|
|
504
|
+
? [
|
|
505
|
+
`Perfil delphi-fiscal recusado em ${CONFIG_PATH} (perfis["delphi-fiscal"]: false ou perfis.delphi: false): o --yes tira o ` +
|
|
506
|
+
`perfil delphi-fiscal do ${LOCK_PATH}. ${arquivosMantidos(fiscalRecusado.pastas)}`,
|
|
507
|
+
]
|
|
508
|
+
: []),
|
|
498
509
|
];
|
|
499
510
|
if (!report.changes.length) {
|
|
500
511
|
const status = adopted.length || comentarios.length || perfil.length || nucleo.length || permission.length || legadas.length || mcp.length
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fontdata/ai-harness",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.8.0",
|
|
4
4
|
"description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/templates/CLAUDE.md
CHANGED
|
@@ -77,7 +77,8 @@ Cada limite vem com o motivo, para valer também nos casos que a regra não cita
|
|
|
77
77
|
esconde a origem do erro.
|
|
78
78
|
- Alterar `SPEC.md`, `CLAUDE.md` e planos só a pedido: são o contrato que o usuário aprovou, e mudança de escopo vira
|
|
79
79
|
decisão registrada.
|
|
80
|
-
- Pedir confirmação antes de
|
|
80
|
+
- Pedir confirmação antes de comando destrutivo: ele apaga trabalho que não se recupera. Com os hooks do harness
|
|
81
|
+
instalados, o que é bloqueado está em `.claude/rules/seguranca-harness.md`.
|
|
81
82
|
- Deixar o código sem comentário de passo a passo, sem banner de seção e sem task/fase/plano/data/hash de commit:
|
|
82
83
|
isso envelhece no código e já está na mensagem de commit e em `docs/trabalhos/`. O padrão completo está em
|
|
83
84
|
`.claude/rules/comentarios.md`, instalada pelo `init`, e o hook de comentários bloqueia a violação.
|
package/templates/catalog.json
CHANGED
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
],
|
|
30
30
|
"perfis": [
|
|
31
31
|
{ "id": "delphi", "dir": "perfis/delphi", "title": "Perfil Delphi", "description": "Rules de Delphi, a skill conhecimento-delphi e o hook de encoding, instalados quando o projeto tem .dpr ou .dproj." },
|
|
32
|
-
{ "id": "delphi-fiscal", "dir": "perfis/delphi-fiscal", "title": "Perfil Delphi fiscal", "description": "Rules de documento fiscal com ACBr e as skills patch-acbr e diagnosticar-rejeicao-nfse, instalados com o perfil Delphi quando
|
|
32
|
+
{ "id": "delphi-fiscal", "dir": "perfis/delphi-fiscal", "title": "Perfil Delphi fiscal", "description": "Rules de documento fiscal com ACBr e as skills patch-acbr e diagnosticar-rejeicao-nfse, instalados com o perfil Delphi quando os uses de alguma unit .pas ou .dpr trazem uma unit ACBr; citar ACBr no .dproj ou no boss.json não liga o perfil e o doctor avisa (delphi-fiscal-sem-uses)." }
|
|
33
33
|
],
|
|
34
34
|
"groups": [
|
|
35
35
|
{
|