@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.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.0.0",
3
+ "version": "4.0.1",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.0.0", "banco-dados-mcp"] }
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" },
@@ -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
- if (options.conflict === 'skip' && existsSync(join(root, entry.path))) {
116
- plan.skipped.push(entry.path);
117
- continue;
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: readFileSync(entry.source) });
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)
@@ -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 e nunca é regravado sem --forcar.
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.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. Registre o início:
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 |