@fontdata/ai-harness 3.2.0 → 3.2.1

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "mcpServers": {
-    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.2.0", "banco-dados-mcp"] }
+    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.2.1", "banco-dados-mcp"] }
   },
   "description": "Harness de engenharia com IA da Fontdata para Claude Code",
   "author": { "name": "Fontdata" },

package/dist/contratos/eventos.js

@@ -81,6 +81,10 @@ function validateLine(event, line) {
     }
     return problems;
 }
+/** Valida um evento já montado (o mesmo contrato do doctor), para recusá-lo antes de gravar. */
+export function validateEvent(event) {
+    return validateLine(event, 1);
+}
 /** Valida o conteúdo de um arquivo de rastro; a última linha sem `\n` é ignorada (escrita em andamento). */
 export function validateEventLog(content) {
     const complete = content.split('\n').slice(0, -1);

package/dist/rastro/command.js

@@ -1,6 +1,7 @@
 import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { templatesDir } from '../catalog.js';
+import { validateEvent } from '../contratos/eventos.js';
 import { suggestFlag } from '../install/flags.js';
 import { acharRaiz } from '../raiz.js';
 /** O CLI grava pela mesma biblioteca dos hooks, para as duas formas produzirem o mesmo formato. */
@@ -42,6 +43,12 @@ export async function runEventCommand(argv) {
             }
         }
     }
-    (await loadRastroLib()).recordEvent(acharRaiz(), fields);
+    // Recusa antes de gravar o que o doctor apontaria como rastro-formato-invalido: o rastro é append-only.
+    const lib = await loadRastroLib();
+    const problems = validateEvent(lib.buildEvent(fields));
+    if (problems.length) {
+        throw new Error(`Evento fora do contrato (docs/contratos/EVENTOS.md); nada foi gravado.\n${problems.map((p) => `- ${p.mensagem}`).join('\n')}`);
+    }
+    lib.recordEvent(acharRaiz(), fields);
     return 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fontdata/ai-harness",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "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.",
   "type": "module",
   "bin": {

package/templates/agents/qa.md

@@ -42,3 +42,6 @@ npx @fontdata/ai-harness evento agent_veredito --trabalho <id> --task <T-SS.NN>
 Com falhas, use `suite_vermelha` e `--resultado falha`. Na verificação manual, registre `suite_verde` com
 `"comando":"manual"`, `total` igual ao número de itens do roteiro e `falhas` igual a 0; com item reprovado,
 `suite_vermelha`.
+
+O CLI recusa valor fora do contrato: `--resultado` aceita só `ok`, `aviso`, `bloqueio` ou `falha` (o veredito
+`aprovado`/`reprovado` vai em `--dados`), e `--task` leva só o id `T-SS.NN`, sem sufixo.

package/templates/skills/executar-plan/references/delegacao.md

@@ -47,6 +47,8 @@ sabendo para que a task serve, o sub-agent decide melhor o que a lista de campos
 2. **qa** recebe a task, os critérios de aceite e o comando da suíte completa. Ele registra a suíte no rastro:
    - `suite_verde` com `--resultado ok` e `{"comando", "total", "falhas": 0}`;
    - `suite_vermelha` com `--resultado falha` e o número de falhas.
+   - `--resultado` aceita só `ok`, `aviso`, `bloqueio` ou `falha`, e `--task` só o id `T-SS.NN`; o CLI recusa
+     outro valor (o veredito `aprovado`/`reprovado` vai em `--dados`).
 3. **Voltas:** no máximo 2 retornos ao implementador por task. Na terceira reprovação, a task vira bloqueio.
 
 ## Fechamento