@fontdata/ai-harness 3.2.1 → 3.2.3

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "mcpServers": {
-    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.2.1", "banco-dados-mcp"] }
+    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.2.3", "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,12 @@ 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; um hook próprio que já existe, de versão antiga ou
+adaptado, é mantido e só entra no lock. 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/doctor/checks.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import { lerEnvSettingsLocal, lerVariavel, SETTINGS_LOCAL_PATH } from '../banco-dados/ambiente.js';
 import { caminhoCadastro, lerCadastro } from '../banco-dados/cadastro.js';
 import { allCommands, loadCatalog } from '../catalog.js';
+import { COMMENTS_HOOK_PATH } from '../comentarios/instalar.js';
 import { CONFIG_PATH, readConfig } from '../config/config.js';
 import { readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
 import { validateEventLog } from '../contratos/eventos.js';
@@ -390,6 +391,24 @@ function checkOldCommentsBlock(root) {
         },
     ];
 }
+/**
+ * Lock anterior ao padrão de comentários e sem a recusa no config: o update o instala. Hook no disco fora do lock é
+ * instalação antiga ou adaptada, que o update só registra no lock.
+ */
+function checkComments(root, lock, config) {
+    if (!config.comentarios.instalar || existsSync(join(root, COMMENTS_HOOK_PATH)))
+        return [];
+    if (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 +526,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(root, 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/update/update.js

@@ -1,8 +1,8 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
 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 { allCommands, loadCatalog, templatesDir } from '../catalog.js';
+import { COMMENTS_HOOK_PATH, commentsHooksConfig, ensureCommentsBaseline } from '../comentarios/instalar.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,13 @@ function legacyPath(root, path) {
             return candidate;
     }
 }
-export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBanco = false } = {}) {
+const COMMENTS_HOOK_TEMPLATE = join(templatesDir, 'hooks', 'comentarios', 'check.mjs');
+/** O hook de comentários existe no projeto com conteúdo diferente do template do pacote. */
+function hookProprio(root) {
+    const local = join(root, COMMENTS_HOOK_PATH);
+    return existsSync(local) && hashContent(readFileSync(local)) !== hashContent(readFileSync(COMMENTS_HOOK_TEMPLATE));
+}
+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 +133,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 +142,18 @@ 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 querComentarios = !semComentarios && config.comentarios.instalar;
+    const hookNoLock = trackedItems.has('hook:comentarios');
+    const registrarHookComentarios = querComentarios && !hookNoLock && hookProprio(root);
+    const registrarComentarios = querComentarios && !registrarHookComentarios && (adotada || !hookNoLock);
+    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 +167,9 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
         stale,
         adotada,
         registrarHooks: adotada && !pluginHooks,
-        registrarComentarios: adotada,
+        registrarComentarios,
+        registrarHookComentarios,
+        recusarComentarios: semComentarios && config.comentarios.instalar,
         permissaoAusente: permissoesFaltando.length > 0,
         permissoesFaltando,
         permissoesLegadas,
@@ -238,6 +255,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]);
@@ -270,6 +291,10 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
     for (const added of addedItems.values()) {
         itens.push({ ...added, arquivos: added.arquivos.sort((a, b) => a.caminho.localeCompare(b.caminho)) });
     }
+    // Com o hash do template, o arquivo do projeto aparece como modificado-local e nunca é regravado sem --forcar.
+    if (report.registrarHookComentarios) {
+        itens.push({ tipo: 'hook', id: 'comentarios', arquivos: [{ caminho: COMMENTS_HOOK_PATH, sha256: hashContent(readFileSync(COMMENTS_HOOK_TEMPLATE)) }] });
+    }
     writeLock(root, { lock_versao: LOCK_VERSION, pacote: pkg, gerado_em: now.toISOString(), itens });
     return { written: write.map((file) => file.path), removed: remove, kept, renamed, avisos, ajustes };
 }
@@ -294,7 +319,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 +328,21 @@ 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.registrarHookComentarios
+            ? [
+                `O hook de comentários ${COMMENTS_HOOK_PATH} é do projeto (instalado por versão antiga ou adaptado) e não está no lock: ` +
+                    'o --yes o deixa registrado no lock como alterado localmente, sem tocar no arquivo.',
+            ]
+            : []),
+        ...(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 +356,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 +371,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 +386,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 +397,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.registrarHookComentarios || 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.1",
+  "version": "3.2.3",
   "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": {