@fontdata/ai-harness 4.0.0 → 4.0.1
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/dist/install/plan.js +25 -5
- package/dist/update/update.js +1 -1
- package/package.json +1 -1
- package/templates/skills/resolver-bug/SKILL.md +3 -1
- package/templates/skills/resolver-bug/templates/BLOQUEIOS.md +30 -0
- package/templates/skills/resolver-bug/templates/DECISOES.md +20 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.0.
|
|
3
|
+
"version": "4.0.1",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.0.
|
|
5
|
+
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.0.1", "banco-dados-mcp"] }
|
|
6
6
|
},
|
|
7
7
|
"description": "Harness de engenharia com IA da Fontdata para Claude Code",
|
|
8
8
|
"author": { "name": "Fontdata" },
|
package/dist/install/plan.js
CHANGED
|
@@ -3,7 +3,7 @@ import { join, sep } from 'node:path';
|
|
|
3
3
|
import { allCommands, recommendedCommands, templatesDir } from '../catalog.js';
|
|
4
4
|
import { runnableIds, suggestIds } from '../run.js';
|
|
5
5
|
import { applyAtomically } from './atomic.js';
|
|
6
|
-
import { buildLockItem, LOCK_VERSION, readLock, writeLock } from './lock.js';
|
|
6
|
+
import { buildLockItem, hashContent, LOCK_VERSION, readLock, writeLock } from './lock.js';
|
|
7
7
|
import { HOOKS_ITEM_ID, PROJECT_HOOKS_DIR, projectHooksConfig } from './hooks.js';
|
|
8
8
|
import { neededSkillsFor, resolveSelection } from './selection.js';
|
|
9
9
|
import { BANCO_MCP_NOME, bancoMcpServer, MCP_PATH, mergeMcpServers } from './mcp.js';
|
|
@@ -99,6 +99,7 @@ function selectCommands(catalog, options) {
|
|
|
99
99
|
export function planInstall(catalog, root, options) {
|
|
100
100
|
const wantMaster = options.includeMaster || options.commands.includes(catalog.master.id);
|
|
101
101
|
const { selected, autoAdded } = resolveSelection(catalog, selectCommands(catalog, options), wantMaster);
|
|
102
|
+
const alteradosLocalmente = [];
|
|
102
103
|
const plan = {
|
|
103
104
|
files: [],
|
|
104
105
|
skipped: [],
|
|
@@ -108,15 +109,30 @@ export function planInstall(catalog, root, options) {
|
|
|
108
109
|
registerHooks: Boolean(options.hooks),
|
|
109
110
|
registerComments: Boolean(options.comments),
|
|
110
111
|
comentariosRecusados: !options.comments,
|
|
112
|
+
alteradosLocalmente,
|
|
111
113
|
};
|
|
114
|
+
const hashNoLock = new Map((readLock(root)?.itens ?? []).flatMap((item) => item.arquivos.map((a) => [a.caminho, a.sha256])));
|
|
112
115
|
const add = (tipo, id) => {
|
|
113
116
|
const paths = [];
|
|
114
117
|
for (const entry of itemSources(catalog, tipo, id) ?? []) {
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
+
const content = readFileSync(entry.source);
|
|
119
|
+
const target = join(root, entry.path);
|
|
120
|
+
if (existsSync(target)) {
|
|
121
|
+
const local = hashContent(readFileSync(target));
|
|
122
|
+
if (local === hashContent(content)) {
|
|
123
|
+
paths.push(entry.path);
|
|
124
|
+
continue;
|
|
125
|
+
}
|
|
126
|
+
if (local !== hashNoLock.get(entry.path)) {
|
|
127
|
+
alteradosLocalmente.push(entry.path);
|
|
128
|
+
continue;
|
|
129
|
+
}
|
|
130
|
+
if (options.conflict === 'skip') {
|
|
131
|
+
plan.skipped.push(entry.path);
|
|
132
|
+
continue;
|
|
133
|
+
}
|
|
118
134
|
}
|
|
119
|
-
plan.files.push({ path: entry.path, content
|
|
135
|
+
plan.files.push({ path: entry.path, content });
|
|
120
136
|
paths.push(entry.path);
|
|
121
137
|
}
|
|
122
138
|
if (paths.length)
|
|
@@ -211,6 +227,10 @@ export function describePlan(plan) {
|
|
|
211
227
|
if (plan.skipped.length) {
|
|
212
228
|
lines.push(`Já existentes, mantidos (${plan.skipped.length}):`, ...plan.skipped.map((path) => ` = ${path}`));
|
|
213
229
|
}
|
|
230
|
+
const alterados = plan.alteradosLocalmente ?? [];
|
|
231
|
+
if (alterados.length) {
|
|
232
|
+
lines.push(`Alterados localmente, mantidos (${alterados.length}); para usar a versão do pacote, apague o arquivo e rode o comando de novo:`, ...alterados.map((path) => ` ! ${path}`));
|
|
233
|
+
}
|
|
214
234
|
if (plan.autoAdded.length)
|
|
215
235
|
lines.push(`Adicionados como dependência: ${plan.autoAdded.join(', ')}`);
|
|
216
236
|
if (plan.claudeMdBackup)
|
package/dist/update/update.js
CHANGED
|
@@ -293,7 +293,7 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
|
|
|
293
293
|
for (const added of addedItems.values()) {
|
|
294
294
|
itens.push({ ...added, arquivos: added.arquivos.sort((a, b) => a.caminho.localeCompare(b.caminho)) });
|
|
295
295
|
}
|
|
296
|
-
// Com o hash do template, o arquivo do projeto aparece como modificado-local
|
|
296
|
+
// Com o hash do template, o arquivo do projeto aparece como modificado-local, que o update nunca regrava.
|
|
297
297
|
if (report.registrarHookComentarios) {
|
|
298
298
|
itens.push({ tipo: 'hook', id: 'comentarios', arquivos: [{ caminho: COMMENTS_HOOK_PATH, sha256: hashContent(readFileSync(COMMENTS_HOOK_TEMPLATE)) }] });
|
|
299
299
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fontdata/ai-harness",
|
|
3
|
-
"version": "4.0.
|
|
3
|
+
"version": "4.0.1",
|
|
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": {
|
|
@@ -34,7 +34,9 @@ Se o relato não veio, peça os detalhes antes de começar: o que acontece, o qu
|
|
|
34
34
|
- plano **condensado** para correção simples, com `auditoria_plano: pendente` (ele não passa pelo
|
|
35
35
|
`auditor-plano`); plano completo quando houver mais de uma fase, auditado pelo `auditor-plano`, cujo veredito
|
|
36
36
|
grava `auditoria_plano: aprovado` ou `reprovado`. Não há outros valores.
|
|
37
|
-
3.
|
|
37
|
+
3. Quando o trabalho registrar uma decisão ou um bloqueio, crie `DECISOES.md` a partir de `templates/DECISOES.md`
|
|
38
|
+
e `BLOQUEIOS.md` a partir de `templates/BLOQUEIOS.md`, sempre com o frontmatter. Nunca os escreva do zero.
|
|
39
|
+
4. Registre o início:
|
|
38
40
|
|
|
39
41
|
```bash
|
|
40
42
|
npx @fontdata/ai-harness evento trabalho_iniciado --trabalho <id> --nome resolver-bug --dados '{"trabalho_tipo":"bug"}'
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
---
|
|
2
|
+
schema_versao: 1
|
|
3
|
+
tipo: bloqueios
|
|
4
|
+
id: "{{id}}"
|
|
5
|
+
trabalho_tipo: bug
|
|
6
|
+
titulo: "Bloqueios — {{titulo}}"
|
|
7
|
+
status: aberto
|
|
8
|
+
criado_em: "{{data}}"
|
|
9
|
+
atualizado_em: "{{data}}"
|
|
10
|
+
arquivos: []
|
|
11
|
+
bloqueios:
|
|
12
|
+
- id: B-01
|
|
13
|
+
task: T-01.02
|
|
14
|
+
status: aberto
|
|
15
|
+
aberto_em: "{{data}}"
|
|
16
|
+
resolvido_em: null
|
|
17
|
+
decisao: null
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
# Bloqueios — {{titulo}}
|
|
21
|
+
|
|
22
|
+
Dúvidas que pararam uma task durante a correção. Cada bloqueio é resolvido por uma decisão registrada em
|
|
23
|
+
`DECISOES.md`; depois disso, a task volta para `pendente`.
|
|
24
|
+
|
|
25
|
+
## B-01 — Pergunta objetiva que precisa de resposta
|
|
26
|
+
|
|
27
|
+
- **Task:** T-01.02
|
|
28
|
+
- **Contexto:** o que foi encontrado e por que a task não pode seguir.
|
|
29
|
+
- **Opções:** as alternativas possíveis, com a consequência de cada uma.
|
|
30
|
+
- **O que destrava:** a informação ou a escolha necessária.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
schema_versao: 1
|
|
3
|
+
tipo: decisoes
|
|
4
|
+
id: "{{id}}"
|
|
5
|
+
trabalho_tipo: bug
|
|
6
|
+
titulo: "Decisões — {{titulo}}"
|
|
7
|
+
status: ativo
|
|
8
|
+
criado_em: "{{data}}"
|
|
9
|
+
atualizado_em: "{{data}}"
|
|
10
|
+
arquivos: []
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Decisões — {{titulo}}
|
|
14
|
+
|
|
15
|
+
Decisões tomadas durante a investigação e a correção. Uma decisão que muda não é apagada: registre uma nova
|
|
16
|
+
dizendo qual ela substitui.
|
|
17
|
+
|
|
18
|
+
| # | Data | Decisão | Motivo | Alternativas descartadas |
|
|
19
|
+
|---|---|---|---|---|
|
|
20
|
+
| D-01 | {{data}} | Como a causa raiz é corrigida | Por que, com a correção mais conservadora | Que outra correção não foi escolhida |
|