@fontdata/ai-harness 4.3.0 → 4.3.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.3.0",
3
+ "version": "4.3.1",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.3.0", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.3.1", "banco-dados-mcp"] }
6
6
  },
7
7
  "description": "Harness de engenharia com IA da Fontdata para Claude Code",
8
8
  "author": { "name": "Fontdata" },
@@ -45,14 +45,22 @@ function isData(value) {
45
45
  function isStringList(value) {
46
46
  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
47
47
  }
48
+ function frontmatterAusente(file, content) {
49
+ const linhas = content.replace(/^/, '').split(/\r?\n/);
50
+ if (linhas[0] !== '---') {
51
+ return { arquivo: file, regra: 'frontmatter-ausente', mensagem: 'O artefato não começa com um frontmatter YAML entre ---.', linha: 1 };
52
+ }
53
+ const colada = linhas.findIndex((linha, i) => i > 0 && linha.trim() !== '---' && linha.trimEnd().endsWith('---'));
54
+ const mensagem = 'O frontmatter abre com --- na linha 1, mas falta o --- de fechamento em linha própria';
55
+ return colada > 0
56
+ ? { arquivo: file, regra: 'frontmatter-ausente', mensagem: `${mensagem}: a linha ${colada + 1} termina com --- colado ao texto.`, linha: colada + 1 }
57
+ : { arquivo: file, regra: 'frontmatter-ausente', mensagem: `${mensagem}.`, linha: 1 };
58
+ }
48
59
  /** Lê o frontmatter de um artefato; `data` ausente quando há problema de leitura. */
49
60
  export function readArtifact(file, content) {
50
61
  const match = /^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
51
- if (!match) {
52
- return {
53
- problems: [{ arquivo: file, regra: 'frontmatter-ausente', mensagem: 'O artefato não começa com um frontmatter YAML entre ---.', linha: 1 }],
54
- };
55
- }
62
+ if (!match)
63
+ return { problems: [frontmatterAusente(file, content)] };
56
64
  let data;
57
65
  try {
58
66
  data = parse(match[1] ?? '');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.3.0",
3
+ "version": "4.3.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": {
@@ -45,11 +45,15 @@ Se o relato não veio, peça os detalhes antes de começar: o que acontece, o qu
45
45
 
46
46
  ## Passo 3 — 🚦 GATE de aprovação
47
47
 
48
- Mostre: sintoma, causa raiz e evidência, o plano de correção e os riscos. Com `causa_raiz: hipotese`, deixe
49
- explícito que a primeira task confirma ou derruba a hipótese. **Não altere nada sem o "ok".**
48
+ 1. Grave `status: aguardando-aprovacao` no `PLAN.md` (e `atualizado_em`), rode `npx @fontdata/ai-harness doctor` e
49
+ confirme que não há achado `contrato-*` neste trabalho.
50
+ 2. Mostre: sintoma, causa raiz e evidência, o plano de correção e os riscos. Com `causa_raiz: hipotese`, deixe
51
+ explícito que a primeira task confirma ou derruba a hipótese. **Não altere nada sem o "ok".**
50
52
 
51
53
  ## Passo 4 — Corrigir com TDD
52
54
 
55
+ Com o "ok", antes de alterar qualquer código, grave `status: em-execucao` no `PLAN.md` (e `atualizado_em`).
56
+
53
57
  1. **Regressão primeiro (T-01.01):** escreva o teste de regressão, rode e **confirme que falha** pelo motivo do bug.
54
58
  Com hipótese, o teste falhando pelo motivo esperado torna a causa `comprovada` — atualize o frontmatter.
55
59
 
@@ -75,6 +79,8 @@ explícito que a primeira task confirma ou derruba a hipótese. **Não altere na
75
79
 
76
80
  5. No frontmatter do `PLAN.md`, cada task vai de `pendente` para `em-andamento` e, com `suite_verde` registrado, para
77
81
  `concluida`, no feminino. Os outros valores aceitos são `bloqueada` e `pulada`.
82
+ `em-andamento` é status de task, nunca do plano: o `status` do topo só passa por `rascunho`,
83
+ `aguardando-aprovacao`, `em-execucao`, `concluido` ou `cancelado`.
78
84
 
79
85
  ## Passo 5 — Evitar que volte: a rule é mesmo necessária?
80
86