@fontdata/ai-harness 3.2.2 → 3.2.3

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "mcpServers": {
-    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.2.2", "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

@@ -249,7 +249,8 @@ também acionado pelo modelo quando o pedido combina.
 - `/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
-`update` também o instala em projetos cujo lock é anterior a ele. Para recusar, use `--sem-comentarios` no `init` ou
+`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`.

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,9 +391,14 @@ 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'))
+/**
+ * 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 [
         {
@@ -520,7 +526,7 @@ export function runDoctor(root, options = {}) {
     return [
         ...checkNode(options.nodeVersion ?? process.versions.node),
         ...lockFindings,
-        ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock), ...checkComments(lock, config)] : []),
+        ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock), ...checkComments(root, lock, config)] : []),
         ...checkShadowedCommands(root),
         ...checkOldCommentsBlock(root),
         ...checkAgents(root),

package/dist/update/update.js

@@ -1,7 +1,7 @@
 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 { 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';
@@ -50,6 +50,12 @@ function legacyPath(root, path) {
             return candidate;
     }
 }
+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);
@@ -139,7 +145,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
     }
     // 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'));
+    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);
@@ -159,6 +168,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
         adotada,
         registrarHooks: adotada && !pluginHooks,
         registrarComentarios,
+        registrarHookComentarios,
         recusarComentarios: semComentarios && config.comentarios.instalar,
         permissaoAusente: permissoesFaltando.length > 0,
         permissoesFaltando,
@@ -281,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 };
 }
@@ -321,6 +335,12 @@ export function describeUpdate(report) {
                     `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
@@ -386,7 +406,7 @@ export function runUpdateCommand(argv) {
     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.recusarComentarios || 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.2",
+  "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": {