@fontdata/ai-harness 3.2.0 → 3.2.2

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "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.2", "banco-dados-mcp"] }
   },
   "description": "Harness de engenharia com IA da Fontdata para Claude Code",
   "author": { "name": "Fontdata" },

package/README.md

@@ -95,7 +95,7 @@ npx @fontdata/ai-harness init --comandos resolver-bug,nova-tarefa --sem-harness
 | `--comandos a,b,c` | Seleção manual |
 | `--sem-harness` | Não inclui o comando-mestre `/harness` |
 | `--sem-hooks` / `--sem-agents` | Não instala hooks / agents |
-| `--sem-comentarios` | Não instala a rule de comentários, o hook e a catraca do legado |
+| `--sem-comentarios` | Não instala a rule de comentários, o hook e a catraca do legado e lembra a recusa no config |
 | `--sem-banco-dados` | Não registra o servidor MCP de banco no `.mcp.json` e lembra a recusa no config |
 | `--claude-md criar\|manter\|backup\|sobrescrever` | O que fazer com o `CLAUDE.md` (padrão: `criar`) |
 | `--conflito sobrescrever\|pular` | Arquivos que já existem (padrão: `pular`) |
@@ -157,7 +157,7 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
 |---|---|
 | `init [caminho]` | Instala comandos, skills, agents e hooks no projeto |
 | `doctor [caminho]` | Diagnostica instalação, contrato dos documentos, rastro, bloqueios antigos, citações às pastas antigas de `docs/` no código e versão do Node |
-| `update [caminho]` | Atualiza o que foi instalado sem sobrescrever alterações locais (`--check`, `--yes`, `--forcar`) |
+| `update [caminho]` | Atualiza o que foi instalado sem sobrescrever alterações locais (`--check`, `--yes`, `--forcar`, `--sem-banco-dados`, `--sem-comentarios`) |
 | `migrar [caminho]` | Move os documentos do layout anterior para `docs/trabalhos/<id>/` (`--yes`); `--reclassificar` corrige planos migrados que ficaram em execução |
 | `memoria [caminho]` | Índice de quem mexeu em cada arquivo (`--arquivo <caminho>`, `--regressao <id>`) |
 | `evento <evento>` | Grava no rastro do trabalho (usado por fluxos e agents) |
@@ -248,7 +248,11 @@ também acionado pelo modelo quando o pedido combina.
 ### Setup guiado
 - `/harness` **(skill)** — conduz o setup em etapas (ideia, contexto, ignores, plano do start, scaffold, peças do harness, auto-tag e execução); `/harness <etapa>` roda uma etapa isolada
 
-O padrão de comentários não é um comando: a rule, o hook e a catraca do legado vêm do `init` e do `update`.
+O padrão de comentários não é um comando: a rule, o hook e a catraca do legado vêm do `init` e do `update`. O
+`update` também o instala em projetos cujo lock é anterior a ele. Para recusar, use `--sem-comentarios` no `init` ou
+no `update`: a escolha fica em `comentarios.instalar: false` no `.ai-harness/config.json`, e o `update` a respeita.
+Para reativar, apague a chave e rode `update --yes` (ou `npx @fontdata/ai-harness comentarios --yes`). Sem o padrão
+e sem a recusa, o `doctor` avisa com `comentarios-ausente`.
 
 A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendorizada de
 [bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja

package/dist/cli.js

@@ -52,6 +52,7 @@ Gerenciar:
   init [caminho]  Instala os slash commands em .claude/commands do projeto (interativo)
   doctor [caminho]  Diagnostica a instalação (arquivos, lock, skills, agents, hooks, Node)
   update [caminho]  Atualiza o que foi instalado: --check só lista, --yes aplica, --forcar sobrescreve conflitos
+                    --sem-comentarios recusa o padrão de comentários (grava comentarios.instalar: false)
                     --sem-banco-dados: não registra o MCP de banco no .mcp.json e lembra a recusa no config
   migrar [caminho]  Move docs/specs, plans, bugs e investigacoes para docs/trabalhos/<id>/ (--yes aplica)
                     --reclassificar: planos já migrados em em-execucao viram concluido ou legado

package/dist/comentarios/command.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { EOL } from 'node:os';
 import { join, resolve } from 'node:path';
 import { templatesDir } from '../catalog.js';
+import { gravarInstalarComentarios } from '../config/config.js';
 import { suggestFlag } from '../install/flags.js';
 import { hashContent } from '../install/lock.js';
 import { executePlan, packageInfo } from '../install/plan.js';
@@ -66,6 +67,8 @@ export function runCommentsCommand(argv) {
     };
     executePlan(root, plan, packageInfo());
     mergeSettings(root, { hooks: commentsHooksConfig() });
+    // Instalar pelo comando desfaz uma recusa guardada pelo `--sem-comentarios`.
+    gravarInstalarComentarios(root, true);
     const legacy = ensureCommentsBaseline(root);
     if (legacy !== null) {
         console.log(`${EOL}Catraca gerada: ${legacy} arquivo(s) legado(s) com violações toleradas. Eles não precisam ser limpos de uma vez, só não podem piorar.`);

package/dist/config/config.js

@@ -72,6 +72,7 @@ export function defaultConfig() {
             projeto: {},
             declarado: false,
         },
+        comentarios: { instalar: true },
     };
 }
 function inteiroEntre(value, min, max) {
@@ -232,6 +233,12 @@ export function readConfig(root) {
         else
             problems.push(`bloqueios.dias_para_aviso deve ser um inteiro positivo em ${CONFIG_PATH}.`);
     }
+    if (isObject(raw.comentarios) && 'instalar' in raw.comentarios) {
+        if (typeof raw.comentarios.instalar === 'boolean')
+            config.comentarios.instalar = raw.comentarios.instalar;
+        else
+            problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
+    }
     const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
     if (isObject(secao))
         lerBanco(secao, config.banco_dados, problems);
@@ -243,14 +250,18 @@ export function readConfig(root) {
     }
     return { config, problems };
 }
-/** Cria a config com os padrões, sem a seção banco_dados; retorna false se já existia (nunca sobrescreve). */
+/** Os padrões que vão para o arquivo: sem as seções banco_dados e comentarios, que só entram quando mudam. */
+function configGravada() {
+    const { banco_dados: _banco, comentarios: _comentarios, ...gravada } = defaultConfig();
+    return gravada;
+}
+/** Cria a config com os padrões, sem as seções banco_dados e comentarios; retorna false se já existia (nunca sobrescreve). */
 export function writeDefaultConfig(root) {
     const file = join(root, CONFIG_PATH);
     if (existsSync(file))
         return false;
     mkdirSync(dirname(file), { recursive: true });
-    const { banco_dados: _banco, ...gravada } = defaultConfig();
-    writeFileSync(file, `${JSON.stringify(gravada, null, 2)}\n`);
+    writeFileSync(file, `${JSON.stringify(configGravada(), null, 2)}\n`);
     return true;
 }
 function lerJsonParaEscrita(file, chave) {
@@ -336,8 +347,7 @@ export function gravarRegistrarMcp(root, valor) {
         raw = lerJsonParaEscrita(file, 'banco_dados.registrar_mcp');
     }
     else {
-        const { banco_dados: _banco, ...padrao } = defaultConfig();
-        raw = padrao;
+        raw = configGravada();
     }
     const banco = secaoBanco(raw);
     if (banco.registrar_mcp === valor)
@@ -345,6 +355,24 @@ export function gravarRegistrarMcp(root, valor) {
     mkdirSync(dirname(file), { recursive: true });
     writeFileSync(file, `${JSON.stringify(comSecaoBanco(raw, { ...banco, registrar_mcp: valor }), null, 2)}\n`);
 }
+/**
+ * Grava a recusa do padrão de comentários (`comentarios.instalar: false`), preservando o resto do JSON; sem config,
+ * cria uma com os padrões e essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido
+ * é recusado sem tocar no arquivo.
+ */
+export function gravarInstalarComentarios(root, valor) {
+    const file = join(root, CONFIG_PATH);
+    if (!existsSync(file) && valor)
+        return;
+    const raw = existsSync(file) ? lerJsonParaEscrita(file, 'comentarios.instalar') : configGravada();
+    const { instalar: atual, ...resto } = isObject(raw.comentarios) ? raw.comentarios : {};
+    if (valor ? atual === undefined || atual === true : atual === false)
+        return;
+    const { comentarios: _comentarios, ...semSecao } = raw;
+    const proxima = valor ? (Object.keys(resto).length ? { ...raw, comentarios: resto } : semSecao) : { ...raw, comentarios: { ...resto, instalar: false } };
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
+}
 const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
 const BLOCK_END = '# /ai-harness';
 /**

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/doctor/checks.js

@@ -390,6 +390,19 @@ function checkOldCommentsBlock(root) {
         },
     ];
 }
+/** Lock anterior ao padrão de comentários e sem a recusa no config: o update o instala. */
+function checkComments(lock, config) {
+    if (!config.comentarios.instalar || lock.itens.some((item) => item.tipo === 'hook' && item.id === 'comentarios'))
+        return [];
+    return [
+        {
+            id: 'comentarios-ausente',
+            severidade: 'aviso',
+            mensagem: 'O padrão de comentários (rule, hook e catraca do legado) não está instalado, e a recusa não está registrada.',
+            correcao: `Instale com \`npx @fontdata/ai-harness update --yes\`, ou recuse com \`update --sem-comentarios --yes\`, que grava comentarios.instalar: false no ${CONFIG_PATH}.`,
+        },
+    ];
+}
 function checkConfig(problems) {
     return problems.map((mensagem) => ({
         id: 'config-invalida',
@@ -507,7 +520,7 @@ export function runDoctor(root, options = {}) {
     return [
         ...checkNode(options.nodeVersion ?? process.versions.node),
         ...lockFindings,
-        ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock)] : []),
+        ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock), ...checkComments(lock, config)] : []),
         ...checkShadowedCommands(root),
         ...checkOldCommentsBlock(root),
         ...checkAgents(root),

package/dist/install/plan.js

@@ -7,7 +7,7 @@ import { buildLockItem, LOCK_VERSION, readLock, writeLock } from './lock.js';
 import { HOOKS_ITEM_ID, PROJECT_HOOKS_DIR, projectHooksConfig } from './hooks.js';
 import { neededSkillsFor, resolveSelection } from './selection.js';
 import { BANCO_MCP_NOME, bancoMcpServer, MCP_PATH, mergeMcpServers } from './mcp.js';
-import { gravarRegistrarMcp } from '../config/config.js';
+import { gravarInstalarComentarios, gravarRegistrarMcp } from '../config/config.js';
 import { COMMENTS_RULE_PATH, commentsHooksConfig, ensureCommentsBaseline } from '../comentarios/instalar.js';
 import { combineHooks, HARNESS_DENY, harnessPermissions, mergeSettings } from './settings.js';
 /** Rule de convenção com o que é específico do projeto (D-38): é do projeto, então fica fora do lock. */
@@ -107,6 +107,7 @@ export function planInstall(catalog, root, options) {
         claudeMdBackup: false,
         registerHooks: Boolean(options.hooks),
         registerComments: Boolean(options.comments),
+        comentariosRecusados: !options.comments,
     };
     const add = (tipo, id) => {
         const paths = [];
@@ -173,6 +174,10 @@ export function executePlan(root, plan, pkg, now = new Date()) {
         mergeMcpServers(root, { [BANCO_MCP_NOME]: bancoMcpServer(pkg.versao) }, now);
     if (plan.mcpRecusado)
         gravarRegistrarMcp(root, false);
+    if (plan.comentariosRecusados)
+        gravarInstalarComentarios(root, false);
+    else if (plan.registerComments)
+        gravarInstalarComentarios(root, true);
     const items = new Map();
     for (const item of previous?.itens ?? [])
         items.set(`${item.tipo}:${item.id}`, item);
@@ -232,5 +237,8 @@ export function describePlan(plan) {
     if (plan.registerComments) {
         lines.push('Padrão de comentários: rule carregada em toda sessão, hook que bloqueia a violação e catraca do legado (gerada só na primeira instalação).');
     }
+    else if (plan.comentariosRecusados) {
+        lines.push(`Padrão de comentários não instalado (recusado); a escolha fica em comentarios.instalar: false no .ai-harness/config.json, e o update a respeita.`);
+    }
     return lines.join('\n');
 }

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/dist/update/update.js

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync
 import { dirname, join, resolve } from 'node:path';
 import { allCommands, loadCatalog } from '../catalog.js';
 import { commentsHooksConfig, ensureCommentsBaseline } from '../comentarios/instalar.js';
-import { CONFIG_PATH, gravarRegistrarMcp, migrarSecaoBanco, readConfig, syncGitignore, temSecaoBancoLegada, writeDefaultConfig, } from '../config/config.js';
+import { CONFIG_PATH, gravarInstalarComentarios, gravarRegistrarMcp, migrarSecaoBanco, readConfig, syncGitignore, temSecaoBancoLegada, writeDefaultConfig, } from '../config/config.js';
 import { applyAtomically } from '../install/atomic.js';
 import { suggestFlag } from '../install/flags.js';
 import { HOOKS_ITEM_ID, isHarnessPluginEnabled, projectHooksConfig } from '../install/hooks.js';
@@ -50,7 +50,7 @@ function legacyPath(root, path) {
             return candidate;
     }
 }
-export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBanco = false } = {}) {
+export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBanco = false, semComentarios = false } = {}) {
     const recorded = readLock(root);
     const lock = recorded ?? adoptLegacyInstall(root, legacy);
     if (!lock) {
@@ -127,6 +127,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
                 addItem('skill', skill.id, false);
         }
     }
+    const { config } = readConfig(root);
     // Na adoção, a instalação antiga ganha o que a 2.1 instala e ela não tinha.
     const adotada = !recorded;
     const pluginHooks = adotada && isHarnessPluginEnabled(root, home);
@@ -135,10 +136,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
             addItem('agent', agent.id, true);
         if (!pluginHooks)
             addItem('hook', HOOKS_ITEM_ID, true);
+    }
+    // O padrão de comentários também chega ao lock anterior a ele, salvo com a recusa no config ou na flag. O hook é a
+    // referência: o comando `comentarios` não registra a rule quando o projeto já tem uma própria.
+    const registrarComentarios = !semComentarios && config.comentarios.instalar && (adotada || !trackedItems.has('hook:comentarios'));
+    if (registrarComentarios) {
         addItem('rule', 'comentarios', true);
         addItem('hook', 'comentarios', true);
     }
-    const registrarMcpConfig = readConfig(root).config.banco_dados.registrar_mcp;
+    const registrarMcpConfig = config.banco_dados.registrar_mcp;
     const permissoesBanco = !semBanco && registrarMcpConfig;
     const permissoesFaltando = [
         ...harnessPermissions({ banco: permissoesBanco }).filter((rule) => !hasAllowRule(root, rule)),
@@ -152,7 +158,8 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
         stale,
         adotada,
         registrarHooks: adotada && !pluginHooks,
-        registrarComentarios: adotada,
+        registrarComentarios,
+        recusarComentarios: semComentarios && config.comentarios.instalar,
         permissaoAusente: permissoesFaltando.length > 0,
         permissoesFaltando,
         permissoesLegadas,
@@ -238,6 +245,10 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
         gravarRegistrarMcp(root, false);
         ajustes.push(`banco_dados.registrar_mcp: false gravado em ${CONFIG_PATH}.`);
     }
+    if (report.recusarComentarios) {
+        gravarInstalarComentarios(root, false);
+        ajustes.push(`comentarios.instalar: false gravado em ${CONFIG_PATH}.`);
+    }
     const itemOf = new Map(report.changes.map((change) => [change.caminho, change.item]));
     const writtenHash = new Map(write.map((file) => [file.path, hashContent(file.content)]));
     const dropped = new Set([...remove, ...report.stale, ...legacy]);
@@ -294,7 +305,7 @@ export function describeUpdate(report) {
     const adopted = report.adotada
         ? [
             `Instalação ${report.lock.pacote.versao} sem lock, reconhecida pelos arquivos em .claude/. ` +
-                `O --yes grava o ${LOCK_PATH}, a configuração do harness${report.registrarHooks ? ', os hooks' : ''}, o padrão de comentários, ` +
+                `O --yes grava o ${LOCK_PATH}, a configuração do harness${report.registrarHooks ? ', os hooks' : ''}${report.registrarComentarios ? ', o padrão de comentários' : ''}, ` +
                 'a rule de projeto e a permissão do `ai-harness evento`.',
         ]
         : [];
@@ -303,6 +314,15 @@ export function describeUpdate(report) {
             `Faltam permissões do harness em .claude/settings.json (${report.permissoesFaltando.join(', ')}); o --yes as acrescenta.`,
         ]
         : [];
+    const comentarios = [
+        ...(report.registrarComentarios && !report.adotada
+            ? [
+                'O padrão de comentários não está instalado: o --yes grava a rule e o hook, registra o hook em .claude/settings.json e gera a catraca do legado. ' +
+                    `Para recusar, rode com --sem-comentarios, que grava comentarios.instalar: false em ${CONFIG_PATH}.`,
+            ]
+            : []),
+        ...(report.recusarComentarios ? [`--sem-comentarios: o --yes grava comentarios.instalar: false em ${CONFIG_PATH} e não instala o padrão de comentários.`] : []),
+    ];
     const legadas = report.permissoesLegadas.length
         ? [`Permissões do MCP de banco com o nome antigo em .claude/settings.json (${report.permissoesLegadas.join(', ')}); o --yes as remove.`]
         : [];
@@ -316,11 +336,14 @@ export function describeUpdate(report) {
         ...(report.recusarMcp ? [`--sem-banco-dados: o --yes grava banco_dados.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
     ];
     if (!report.changes.length) {
-        const status = adopted.length || permission.length || legadas.length || mcp.length ? 'Nenhum arquivo a atualizar.' : 'A instalação está em dia: nenhum arquivo a atualizar.';
-        return [...adopted, ...permission, ...legadas, ...mcp, status].join('\n');
+        const status = adopted.length || comentarios.length || permission.length || legadas.length || mcp.length
+            ? 'Nenhum arquivo a atualizar.'
+            : 'A instalação está em dia: nenhum arquivo a atualizar.';
+        return [...adopted, ...comentarios, ...permission, ...legadas, ...mcp, status].join('\n');
     }
     return [
         ...adopted,
+        ...comentarios,
         ...permission,
         ...legadas,
         ...mcp,
@@ -328,9 +351,9 @@ export function describeUpdate(report) {
         ...report.changes.map((change) => `  ${change.tipo.padEnd(16)} ${change.caminho}${change.destino ? ` → ${change.destino}` : ''}  (${DESCRIPTIONS[change.tipo]})`),
     ].join('\n');
 }
-const UPDATE_FLAGS = ['--check', '--yes', '-y', '--sim', '--forcar', '--sem-banco-dados'];
+const UPDATE_FLAGS = ['--check', '--yes', '-y', '--sim', '--forcar', '--sem-banco-dados', '--sem-comentarios'];
 export function parseUpdateArgs(argv) {
-    const args = { path: undefined, check: false, yes: false, force: false, semBanco: false };
+    const args = { path: undefined, check: false, yes: false, force: false, semBanco: false, semComentarios: false };
     for (const token of argv) {
         if (!token.startsWith('-')) {
             if (args.path !== undefined)
@@ -343,6 +366,8 @@ export function parseUpdateArgs(argv) {
             args.force = true;
         else if (token === '--sem-banco-dados')
             args.semBanco = true;
+        else if (token === '--sem-comentarios')
+            args.semComentarios = true;
         else if (token === '--yes' || token === '-y' || token === '--sim')
             args.yes = true;
         else {
@@ -352,16 +377,16 @@ export function parseUpdateArgs(argv) {
     }
     return args;
 }
-/** `ai-harness update [caminho] [--check] [--yes] [--forcar] [--sem-banco-dados]`; sem `--yes` só simula. */
+/** `ai-harness update [caminho] [--check] [--yes] [--forcar] [--sem-banco-dados] [--sem-comentarios]`; sem `--yes` só simula. */
 export function runUpdateCommand(argv) {
     const args = parseUpdateArgs(argv);
     const root = resolve(process.cwd(), args.path ?? '.');
     if (!existsSync(root))
         throw new Error(`Pasta não encontrada: ${root}`);
-    const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco });
+    const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco, semComentarios: args.semComentarios });
     console.log(describeUpdate(report));
     // Sem arquivo a atualizar, a adoção ainda grava o lock, e a permissão e o MCP ainda são acrescentados.
-    const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.renomearSecaoBanco;
+    const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.renomearSecaoBanco;
     if (args.check || (!report.changes.length && !pendente))
         return 0;
     if (!args.yes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fontdata/ai-harness",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "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