wizz-method 2.18.0 → 2.19.1

package/tools/installer/core/doctor.js

@@ -23,13 +23,15 @@
 const path = require('node:path');
 const { HOOK_DEFS, SUPPORT_FILES, isOurHookCommand } = require('./hooks-settings');
 const { classifyPython, PYTHON_ONLY_SKILLS } = require('./python-check');
+const { checkHooksRun } = require('./hooks-smoke');
+const { it } = require('../install-text');
 
 // Piso de versão do rtk que o hook rtk-rewrite.sh exige para `rtk rewrite`
 // (o registry pin do CLI é mais alto, 0.50.0, e é aplicado pelo detectClis
 // no install; aqui reportamos o piso que quebra o hook hoje).
 const RTK_HOOK_FLOOR = '0.23.0';
 
-const CHECKS = ['hooks', 'rtk', 'jq', 'python', 'drift', 'resolved'];
+const CHECKS = ['hooks', 'hooks-run', 'rtk', 'jq', 'python', 'drift', 'resolved'];
 
 /**
  * Versão numérica comparável a partir de texto de `rtk --version` etc.
@@ -177,7 +179,7 @@ function checkHooks({ wizzDir, settingsFile, globalSettingsFile, fileExists, rea
     return {
       check: 'hooks',
       status: 'error',
-      detail: `Faltam arquivos de hook em _wizz/hooks/: ${missingFiles.join(', ')}. Execute wizz update para repor.`,
+      detail: it('docHooksMissingFiles', { list: missingFiles.join(', ') }),
     };
   }
 
@@ -185,18 +187,19 @@ function checkHooks({ wizzDir, settingsFile, globalSettingsFile, fileExists, rea
     return {
       check: 'hooks',
       status: 'warn',
-      detail:
-        `Arquivos ok, mas sem registro no settings do PROJETO (${settingsFile}): ${missingSettings.join(', ')}. ` +
-        `Também não estão no settings GLOBAL (${globalSettingsFile || '~/.claude/settings.json'}). ` +
-        `Rode wizz install para registrar no projeto, ou registre no global.`,
+      detail: it('docHooksNotRegistered', {
+        settings: settingsFile,
+        list: missingSettings.join(', '),
+        global: globalSettingsFile || '~/.claude/settings.json',
+      }),
     };
   }
 
   const skippedNote =
     skippedGlobal.length > 0
-      ? ` (${skippedGlobal.length} já registrado(s) no settings global ${globalSettingsFile || '~/.claude/settings.json'}, ok)`
+      ? it('docHooksSkippedNote', { n: skippedGlobal.length, global: globalSettingsFile || '~/.claude/settings.json' })
       : '';
-  return { check: 'hooks', status: 'ok', detail: `${HOOK_DEFS.length} hooks verificados${skippedNote}.` };
+  return { check: 'hooks', status: 'ok', detail: it('docHooksOk', { n: HOOK_DEFS.length, note: skippedNote }) };
 }
 
 /**
@@ -214,7 +217,7 @@ function checkCli({ check, version, floor }) {
       return {
         check,
         status: 'warn',
-        detail: `rtk não encontrado no PATH. Opcional, mas sem ele o hook rtk-rewrite.sh não é registrado e a economia de tokens não roda. Instale: cargo install rtk`,
+        detail: it('docRtkMissing'),
       };
     }
     const installed = extractVersion(version);
@@ -222,10 +225,10 @@ function checkCli({ check, version, floor }) {
       return {
         check,
         status: 'warn',
-        detail: `rtk ${installed} é mais antigo que o piso do hook (${RTK_HOOK_FLOOR}); o rewrite falha em warn. Atualize: cargo install rtk`,
+        detail: it('docRtkOld', { installed, floor: RTK_HOOK_FLOOR }),
       };
     }
-    return { check, status: 'ok', detail: `rtk ${installed || '(versão não informada)'} no PATH.` };
+    return { check, status: 'ok', detail: it('docRtkOk', { version: installed || it('docVersionUnknown') }) };
   }
 
   // jq — sem verificação de versão, o hook só precisa dele presente.
@@ -233,11 +236,10 @@ function checkCli({ check, version, floor }) {
     return {
       check: 'jq',
       status: 'warn',
-      detail:
-        'jq não encontrado no PATH. O hook rtk-rewrite.sh precisa dele; sem jq o rewrite de Bash avisa e segue sem reescrever. Instale: brew install jq',
+      detail: it('docJqMissing'),
     };
   }
-  return { check: 'jq', status: 'ok', detail: 'jq no PATH.' };
+  return { check: 'jq', status: 'ok', detail: it('docJqOk') };
 }
 
 /**
@@ -266,20 +268,13 @@ function checkPython({ detected }) {
  * @returns {string}
  */
 function pythonDetail(status, detected) {
-  const optional = `Opcional: o núcleo roda só com Node; Python só habilita as skills com script próprio (${PYTHON_ONLY_SKILLS}).`;
-  if (status === 'full' && detected.isRuntimeCommand) {
-    return `Python ${detected.version.raw} via ${detected.command} (tomllib ok): as skills Python também rodam.`;
-  }
-  if (status === 'full') {
-    return `Python ${detected.version.raw} existe via ${detected.command}, mas os scripts chamam python3, que não está no PATH. ${optional}`;
-  }
-  if (status === 'partial') {
-    return `Python ${detected.version.raw} no PATH, sem tomllib (as skills com script próprio pedem 3.11+). ${optional}`;
-  }
-  if (status === 'unsupported') {
-    return `Python ${detected.version.raw} é antigo demais (as skills com script próprio pedem 3.11+). ${optional}`;
-  }
-  return `python3 não encontrado no PATH. ${optional} Para tê-las: brew install python3 (macOS).`;
+  const optional = it('docPyOptional', { skills: PYTHON_ONLY_SKILLS });
+  const vars = detected ? { version: detected.version.raw, command: detected.command, optional } : { optional };
+  if (status === 'full' && detected.isRuntimeCommand) return it('docPyFull', vars);
+  if (status === 'full') return it('docPyFullNoPython3', vars);
+  if (status === 'partial') return it('docPyPartial', vars);
+  if (status === 'unsupported') return it('docPyUnsupported', vars);
+  return it('docPyNone', vars);
 }
 
 /**
@@ -301,7 +296,7 @@ async function checkDrift({ wizzDir, manifestContent, hashFile, fileExists }) {
     return {
       check: 'drift',
       status: 'warn',
-      detail: 'files-manifest.csv não encontrado em _wizz/_config/. Sem ele não dá para detectar drift; rode wizz update para gerar.',
+      detail: it('docDriftNoManifest'),
     };
   }
 
@@ -312,7 +307,7 @@ async function checkDrift({ wizzDir, manifestContent, hashFile, fileExists }) {
     .map(parseCsvLine)
     .filter((f) => f.length >= 5 && f[3] && f[4]);
   if (rows.length === 0) {
-    return { check: 'drift', status: 'ok', detail: 'files-manifest.csv vazio, nada a comparar.' };
+    return { check: 'drift', status: 'ok', detail: it('docDriftEmpty') };
   }
 
   const drifted = [];
@@ -332,16 +327,16 @@ async function checkDrift({ wizzDir, manifestContent, hashFile, fileExists }) {
   }
 
   if (drifted.length === 0 && missing.length === 0) {
-    return { check: 'drift', status: 'ok', detail: `${rows.length} arquivos batem com o files-manifest.csv.` };
+    return { check: 'drift', status: 'ok', detail: it('docDriftOk', { n: rows.length }) };
   }
 
   const parts = [];
-  if (drifted.length > 0) parts.push(`${drifted.length} alterado(s)`);
-  if (missing.length > 0) parts.push(`${missing.length} ausente(s)`);
+  if (drifted.length > 0) parts.push(it('docDriftChanged', { n: drifted.length }));
+  if (missing.length > 0) parts.push(it('docDriftMissing', { n: missing.length }));
   return {
     check: 'drift',
     status: 'warn',
-    detail: `Drift em _wizz/: ${parts.join(' e ')} contra o files-manifest.csv (ex.: ${[...drifted, ...missing].slice(0, 3).join(', ')}). Edita manuais em _wizz/ são perdidos no próximo update — mova para _wizz/custom/ e rode wizz update.`,
+    detail: it('docDriftWarn', { parts: parts.join(it('docDriftAnd')), examples: [...drifted, ...missing].slice(0, 3).join(', ') }),
   };
 }
 
@@ -380,14 +375,14 @@ async function checkResolved({ projectDir, skillSources, index, fileExists, hash
   const sources = skillSources instanceof Map ? skillSources : new Map(Object.entries(skillSources || {}));
   const skills = [...sources.keys()].sort();
   if (skills.length === 0) {
-    return { check: 'resolved', status: 'ok', detail: 'Nenhuma skill com customize.toml instalada; nada a resolver.' };
+    return { check: 'resolved', status: 'ok', detail: it('docResolvedNone') };
   }
 
   if (!index || typeof index !== 'object' || !index.skills || typeof index.skills !== 'object') {
     return {
       check: 'resolved',
       status: 'warn',
-      detail: `Índice ${path.join(resolvedDir, '.index.json')} ausente ou ilegível: não dá para saber se os ${skills.length} snapshots estão atualizados. Rode wizz resolve.`,
+      detail: it('docResolvedNoIndex', { file: path.join(resolvedDir, '.index.json'), n: skills.length }),
     };
   }
 
@@ -426,14 +421,14 @@ async function checkResolved({ projectDir, skillSources, index, fileExists, hash
     return {
       check: 'resolved',
       status: 'ok',
-      detail: `${skills.length} snapshots em _wizz/_resolved/ batem com as entradas que os geraram.`,
+      detail: it('docResolvedOk', { n: skills.length }),
     };
   }
 
   const parts = [];
-  if (missing.length > 0) parts.push(`${missing.length} sem snapshot (${missing.slice(0, 3).join(', ')})`);
-  if (stale.length > 0) parts.push(`${stale.length} com snapshot obsoleto (${stale.slice(0, 3).join(', ')})`);
-  const prefix = stale.length > 0 ? 'snapshot obsoleto: rode wizz resolve' : 'rode wizz resolve';
+  if (missing.length > 0) parts.push(it('docResolvedMissing', { n: missing.length, list: missing.slice(0, 3).join(', ') }));
+  if (stale.length > 0) parts.push(it('docResolvedStale', { n: stale.length, list: stale.slice(0, 3).join(', ') }));
+  const prefix = stale.length > 0 ? it('docResolvedPrefixStale') : it('docResolvedPrefix');
   return { check: 'resolved', status: 'warn', detail: `${prefix} — ${parts.join('; ')}.` };
 }
 
@@ -482,11 +477,11 @@ async function checkProjectInstructions({ projectDir, fileExists, readFile }) {
     if (!(await fileExists(file))) continue;
     seen += 1;
     const text = await readFile(file);
-    if (!text.includes(BLOCK_BEGIN)) problems.push(`${name} sem o bloco Wizz no topo (rode wizz install)`);
-    for (const f of scanLegacy(text)) problems.push(`${name}:${f.line} ${f.why}: ${f.snippet}`);
+    if (!text.includes(BLOCK_BEGIN)) problems.push(it('docInstrNoBlock', { file: name }));
+    for (const f of scanLegacy(text)) problems.push(`${name}:${f.line} ${it(`docLegacy.${f.id}`)}: ${f.snippet}`);
   }
-  if (seen === 0) return { check: 'instructions', status: 'ok', detail: 'Sem CLAUDE.md/AGENTS.md no projeto.' };
-  if (problems.length === 0) return { check: 'instructions', status: 'ok', detail: 'Bloco Wizz presente, nenhuma regra legada.' };
+  if (seen === 0) return { check: 'instructions', status: 'ok', detail: it('docInstrNone') };
+  if (problems.length === 0) return { check: 'instructions', status: 'ok', detail: it('docInstrOk') };
   return { check: 'instructions', status: 'warn', detail: problems.join('\n') };
 }
 
@@ -508,6 +503,8 @@ async function runDoctor(options = {}) {
       require('./resolved-customizations').discoverSkillCustomizeTomls({ projectRoot: root, wizzDir: dir }),
     readResolvedIndex = (dir) => require('./resolved-customizations').readIndex(dir),
     rtkOnPath = () => hasCommand('rtk'),
+    runHookProcess,
+    platform = process.platform,
     skip = [],
   } = deps;
 
@@ -519,7 +516,7 @@ async function runDoctor(options = {}) {
 
   // 1) hooks — só faz sentido com _wizz/ presente.
   if (skip.includes('hooks')) {
-    results.push({ check: 'hooks', status: 'ok', detail: 'pulado.' });
+    results.push({ check: 'hooks', status: 'ok', detail: it('docSkipped') });
   } else if (wizzDir) {
     results.push(
       checkHooks({
@@ -536,14 +533,22 @@ async function runDoctor(options = {}) {
     results.push({
       check: 'hooks',
       status: 'warn',
-      detail: 'Sem instalação Wizz neste diretório (_wizz/ ausente); hooks do projeto não verificados. Rode wizz install.',
+      detail: it('docNoInstallHooks'),
     });
   }
 
-  // 2) rtk (com piso de versão do hook) e 3) jq (presença).
-  for (const cli of ['rtk', 'jq']) {
+  // 1b) hooks-run — executa cada hook instalado com payload mínimo (smoke).
+  if (skip.includes('hooks-run')) {
+    results.push({ check: 'hooks-run', status: 'ok', detail: it('docSkipped') });
+  } else if (wizzDir) {
+    results.push(checkHooksRun({ wizzDir, projectDir, fileExists, rtkOnPath: rtkOnPath(), runHookProcess }));
+  }
+
+  // 2) rtk (com piso de versão do hook) e 3) jq (presença). No Windows o hook
+  // registrado é o rtk-rewrite.js, que não usa jq: não cobrar.
+  for (const cli of platform === 'win32' ? ['rtk'] : ['rtk', 'jq']) {
     if (skip.includes(cli)) {
-      results.push({ check: cli, status: 'ok', detail: 'pulado.' });
+      results.push({ check: cli, status: 'ok', detail: it('docSkipped') });
       continue;
     }
     const onPath = hasCommand(cli);
@@ -561,14 +566,14 @@ async function runDoctor(options = {}) {
 
   // 4) python — detector stubável (mesmo padrão de checkPythonEnvironment).
   if (skip.includes('python')) {
-    results.push({ check: 'python', status: 'ok', detail: 'pulado.' });
+    results.push({ check: 'python', status: 'ok', detail: it('docSkipped') });
   } else {
     results.push(checkPython({ detected: detectPy() }));
   }
 
   // 5) drift — só com _wizz/ presente; sem instalação, skip informado.
   if (skip.includes('drift')) {
-    results.push({ check: 'drift', status: 'ok', detail: 'pulado.' });
+    results.push({ check: 'drift', status: 'ok', detail: it('docSkipped') });
   } else if (wizzDir) {
     const manifestPath = path.join(wizzDir, '_config', 'files-manifest.csv');
     const manifestContent = (await fileExists(manifestPath)) ? await readFile(manifestPath) : null;
@@ -577,13 +582,13 @@ async function runDoctor(options = {}) {
     results.push({
       check: 'drift',
       status: 'warn',
-      detail: 'Sem instalação Wizz neste diretório; drift não verificado. Rode wizz install.',
+      detail: it('docNoInstallDrift'),
     });
   }
 
   // 6) resolved — snapshots de customização contra o hash das entradas.
   if (skip.includes('resolved')) {
-    results.push({ check: 'resolved', status: 'ok', detail: 'pulado.' });
+    results.push({ check: 'resolved', status: 'ok', detail: it('docSkipped') });
   } else if (wizzDir) {
     const resolvedDir = path.join(wizzDir, '_resolved');
     results.push(
@@ -600,13 +605,13 @@ async function runDoctor(options = {}) {
     results.push({
       check: 'resolved',
       status: 'warn',
-      detail: 'Sem instalação Wizz neste diretório; snapshots de _wizz/_resolved/ não verificados. Rode wizz install.',
+      detail: it('docNoInstallResolved'),
     });
   }
 
   // 7) instructions — CLAUDE.md/AGENTS.md com bloco Wizz e sem regra legada.
   if (skip.includes('instructions')) {
-    results.push({ check: 'instructions', status: 'ok', detail: 'pulado.' });
+    results.push({ check: 'instructions', status: 'ok', detail: it('docSkipped') });
   } else if (wizzDir) {
     results.push(await checkProjectInstructions({ projectDir, fileExists, readFile }));
   }

package/tools/installer/core/hooks-settings.js

@@ -22,24 +22,53 @@ const HOOKS_DIR = '_wizz/hooks';
 // event/matcher/timeout replicam 1:1 o que tools/hooks/README.md documenta e
 // o que já roda hoje na máquina do mantenedor (npm run sync:global + registro
 // manual em ~/.claude/settings.json) — nenhum formato novo foi inventado.
-const HOOK_DEFS = [
-  { id: 'session-rules.js', event: 'SessionStart', kind: 'node' },
-  { id: 'wizz-router-enforce.js', event: 'UserPromptSubmit', kind: 'node' },
-  { id: 'security-defensive-context.js', event: 'PreToolUse', matcher: 'Skill', kind: 'node' },
-  // rtk é opcional (item 4 da decisão RT-C1): só entra em hookEntries quando
-  // `rtkOnPath` é true — ver buildHookEntries abaixo.
-  { id: 'rtk-rewrite.sh', event: 'PreToolUse', matcher: 'Bash', kind: 'shell', requires: 'rtk' },
-  { id: 'wizz-decision-trace.js', event: 'Stop', kind: 'node' },
-  // Avisa artefato fora da pasta da feature e arquivo solto na raiz (2026-10-02).
-  // Nunca bloqueia: PostToolUse só devolve contexto para o agente corrigir.
-  { id: 'wizz-artifact-guard.js', event: 'PostToolUse', matcher: 'Write', kind: 'node' },
-];
+// rtk-rewrite: o .sh precisa de bash e jq, que o Windows não garante. Lá entra
+// a versão Node, com o mesmo comportamento (test/test-rtk-hook-node.js), desde
+// 2026-10-15. Os dois arquivos são copiados; só o da plataforma é registrado.
+function rtkHookDef(platform) {
+  return platform === 'win32'
+    ? { id: 'rtk-rewrite.js', event: 'PreToolUse', matcher: 'Bash', kind: 'node', requires: 'rtk' }
+    : { id: 'rtk-rewrite.sh', event: 'PreToolUse', matcher: 'Bash', kind: 'shell', requires: 'rtk' };
+}
+
+/**
+ * Hooks registrados nesta plataforma.
+ * @param {string} platform - process.platform
+ */
+function hookDefsFor(platform) {
+  return [
+    { id: 'session-rules.js', event: 'SessionStart', kind: 'node' },
+    { id: 'wizz-router-enforce.js', event: 'UserPromptSubmit', kind: 'node' },
+    { id: 'security-defensive-context.js', event: 'PreToolUse', matcher: 'Skill', kind: 'node' },
+    // rtk é opcional (item 4 da decisão RT-C1): só entra em hookEntries quando
+    // `rtkOnPath` é true — ver buildHookEntries abaixo.
+    rtkHookDef(platform),
+    { id: 'wizz-decision-trace.js', event: 'Stop', kind: 'node' },
+    // Aviso (systemMessage, nunca bloqueia) de feature entregue com fechamento
+    // pendente (2026-10-15). Sem subprocesso; silencioso fora de projeto Wizz.
+    { id: 'wizz-close-reminder.js', event: 'Stop', kind: 'node' },
+    // Avisa artefato fora da pasta da feature e arquivo solto na raiz (2026-10-02).
+    // Nunca bloqueia: PostToolUse só devolve contexto para o agente corrigir.
+    // Edit/MultiEdit desde 2026-10-15: frontmatter quebrado por edição também avisa.
+    { id: 'wizz-artifact-guard.js', event: 'PostToolUse', matcher: 'Write|Edit|MultiEdit', kind: 'node' },
+  ];
+}
+
+const HOOK_DEFS = hookDefsFor(process.platform);
+const RTK_HOOK_ID = rtkHookDef(process.platform).id;
 
 // Arquivos de apoio copiados junto com os hooks, mas NUNCA registrados em
 // settings.json: bibliotecas que os hooks importam e as CLIs que os agentes
 // rodam (`node _wizz/hooks/wizz-feature.js definir <slug>`). Sem eles a
 // organização automática cala em silêncio (fail-open), então o doctor cobra.
-const SUPPORT_FILES = ['wizz-feature-lib.js', 'wizz-layout-lib.js', 'wizz-feature.js', 'wizz-arrumar.js'];
+const SUPPORT_FILES = [
+  'wizz-feature-lib.js',
+  'wizz-layout-lib.js',
+  'wizz-cerebro-lib.js',
+  'wizz-debug-lib.js',
+  'wizz-feature.js',
+  'wizz-arrumar.js',
+];
 
 const DEFAULT_TIMEOUT = 5;
 
@@ -138,8 +167,16 @@ function mergeHooksIntoSettings(existingSettings, hookEntries) {
 
   for (const entry of hookEntries || []) {
     const { event, matcher, id, command, timeout } = entry;
-    const blocks = Array.isArray(hooks[event]) ? hooks[event] : [];
     const sameMatcher = (block) => (matcher ? block.matcher === matcher : block.matcher === undefined);
+    // 0) Matcher mudou entre versões (ex.: Write → Write|Edit|MultiEdit): tira
+    // o nosso hook do bloco com o matcher antigo, senão ele roda 2x. Bloco que
+    // fica vazio sai; hook de terceiro no mesmo bloco fica.
+    const blocks = (Array.isArray(hooks[event]) ? hooks[event] : []).flatMap((block) => {
+      if (sameMatcher(block) || !Array.isArray(block.hooks)) return [block];
+      const rest = block.hooks.filter((h) => !isOurHookCommand(h && h.command, id));
+      if (rest.length === block.hooks.length) return [block];
+      return rest.length > 0 ? [{ ...block, hooks: rest }] : [];
+    });
 
     // 1) Já presente, idêntico — nada a fazer (idempotência).
     const alreadyPresent = blocks.some(
@@ -177,12 +214,49 @@ function mergeHooksIntoSettings(existingSettings, hookEntries) {
   return { ...settings, hooks };
 }
 
+/**
+ * Inverso de mergeHooksIntoSettings (uninstall): tira de `settings.hooks` todo
+ * comando que aponta para `_wizz/hooks/<hook nosso>`. Hook de terceiro, blocos
+ * com hook de terceiro e as demais chaves ficam; bloco, evento e a chave
+ * `hooks` que ficarem vazios saem. Função pura (não muta a entrada).
+ * @param {object} existingSettings - conteúdo de .claude/settings.json
+ * @returns {{settings: object, removed: number}}
+ */
+function removeHooksFromSettings(existingSettings) {
+  const settings = cloneJson(existingSettings);
+  if (!settings.hooks || typeof settings.hooks !== 'object' || Array.isArray(settings.hooks)) {
+    return { settings, removed: 0 };
+  }
+  const isOurs = (h) => HOOK_DEFS.some((def) => isOurHookCommand(h && h.command, def.id));
+  let removed = 0;
+  const hooks = {};
+  for (const [event, blocks] of Object.entries(settings.hooks)) {
+    if (!Array.isArray(blocks)) {
+      hooks[event] = blocks;
+      continue;
+    }
+    const kept = blocks.flatMap((block) => {
+      if (!block || !Array.isArray(block.hooks)) return [block];
+      const rest = block.hooks.filter((h) => !isOurs(h));
+      removed += block.hooks.length - rest.length;
+      if (rest.length === block.hooks.length) return [block];
+      return rest.length > 0 ? [{ ...block, hooks: rest }] : [];
+    });
+    if (kept.length > 0 || blocks.length === 0) hooks[event] = kept;
+  }
+  const { hooks: _old, ...others } = settings;
+  return { settings: Object.keys(hooks).length > 0 ? { ...others, hooks } : others, removed };
+}
+
 module.exports = {
   SUPPORT_FILES,
   HOOKS_DIR,
   HOOK_DEFS,
+  RTK_HOOK_ID,
+  hookDefsFor,
   buildHookEntries,
   filterHooksRegisteredGlobally,
   mergeHooksIntoSettings,
+  removeHooksFromSettings,
   isOurHookCommand,
 };

package/tools/installer/core/hooks-smoke.js

@@ -0,0 +1,134 @@
+// hooks-smoke.js — o `wizz doctor` EXECUTA cada hook instalado em
+// `_wizz/hooks/` com um payload mínimo válido (por evento) e reporta o que
+// quebrou. Existe porque os hooks são fail-open: uma cópia parcial (lib
+// faltando, arquivo corrompido) faz a feature sumir em silêncio, e checar só
+// "o arquivo existe" não pega isso.
+//
+// Roda com WIZZ_DEBUG=1, então os erros que o hook engole (ver
+// tools/hooks/wizz-debug-lib.js) chegam em stderr e entram no relatório.
+// Nada é gravado: WIZZ_DEBUG_FILE aponta para o null device, WIZZ_TRACE fica
+// vazio e o payload do artifact-guard usa um arquivo que não existe.
+//
+// Rápido de propósito: ~40 ms por hook, timeout curto, sem rede.
+
+const os = require('node:os');
+const path = require('node:path');
+const { it } = require('../install-text');
+const { HOOK_DEFS } = require('./hooks-settings');
+
+const HOOK_TIMEOUT_MS = 4000;
+
+// Falha ao carregar o código do próprio hook = feature morta. É o caso que o
+// smoke existe para pegar, então vira error (o resto é warn).
+const LOAD_FAILURE_RE = /require |Cannot find module|MODULE_NOT_FOUND|SyntaxError/;
+
+/**
+ * Payload mínimo válido por hook (formato real que o Claude Code envia).
+ * @param {string} id - basename do hook
+ * @param {string} projectDir
+ * @returns {object}
+ */
+function probePayload(id, projectDir) {
+  const base = { cwd: projectDir };
+  switch (id) {
+    case 'session-rules.js': {
+      return { ...base, hook_event_name: 'SessionStart', source: 'startup' };
+    }
+    case 'wizz-router-enforce.js': {
+      return { ...base, hook_event_name: 'UserPromptSubmit', prompt: 'implementa a feature de login com testes e validação' };
+    }
+    case 'security-defensive-context.js': {
+      return { ...base, hook_event_name: 'PreToolUse', tool_name: 'Skill', tool_input: { skill: 'security-review' } };
+    }
+    case 'rtk-rewrite.sh':
+    case 'rtk-rewrite.js': {
+      return { ...base, hook_event_name: 'PreToolUse', tool_name: 'Bash', tool_input: { command: 'echo wizz-doctor' } };
+    }
+    case 'wizz-artifact-guard.js': {
+      return {
+        ...base,
+        hook_event_name: 'PostToolUse',
+        tool_name: 'Write',
+        tool_input: { file_path: path.join(projectDir, '__wizz-doctor-probe__.txt'), content: '' },
+      };
+    }
+    case 'wizz-decision-trace.js':
+    case 'wizz-close-reminder.js': {
+      return { ...base, hook_event_name: 'Stop', stop_hook_active: false };
+    }
+    default: {
+      return base;
+    }
+  }
+}
+
+/**
+ * Execução real de um hook. Injetável em `deps.runHookProcess` nos testes.
+ * @param {{file: string, kind: 'node'|'shell', payload: object, cwd: string}} args
+ * @returns {{status: number|null, stderr: string, error: string|null}}
+ */
+function defaultRunHookProcess({ file, kind, payload, cwd }) {
+  const { spawnSync } = require('node:child_process');
+  const [cmd, args] = kind === 'shell' ? ['bash', [file]] : [process.execPath, [file]];
+  const res = spawnSync(cmd, args, {
+    cwd,
+    input: JSON.stringify(payload),
+    encoding: 'utf8',
+    timeout: HOOK_TIMEOUT_MS,
+    env: { ...process.env, WIZZ_DEBUG: '1', WIZZ_DEBUG_FILE: os.devNull, WIZZ_TRACE: '', CLAUDE_PROJECT_DIR: cwd },
+  });
+  return { status: res.status, stderr: res.stderr || '', error: res.error ? res.error.message : null };
+}
+
+function debugLines(stderr) {
+  return String(stderr)
+    .split('\n')
+    .filter((line) => line.startsWith('[wizz-debug]'));
+}
+
+/**
+ * Executa cada hook instalado e classifica o resultado.
+ * @param {object} deps
+ * @param {string} deps.wizzDir
+ * @param {string} deps.projectDir
+ * @param {(p: string) => boolean} deps.fileExists
+ * @param {boolean} deps.rtkOnPath - sem rtk no PATH o rtk-rewrite.sh é pulado
+ * @param {Function} [deps.runHookProcess]
+ * @returns {{check: 'hooks-run', status: 'ok'|'warn'|'error', detail: string}}
+ */
+function checkHooksRun({ wizzDir, projectDir, fileExists, rtkOnPath, runHookProcess = defaultRunHookProcess }) {
+  const hooksDir = path.join(wizzDir, 'hooks');
+  const errors = [];
+  const warnings = [];
+  let ran = 0;
+
+  for (const def of HOOK_DEFS) {
+    if (def.requires === 'rtk' && !rtkOnPath) continue;
+    const file = path.join(hooksDir, def.id);
+    if (!fileExists(file)) continue; // ausência é do check `hooks`
+    ran++;
+    const res = runHookProcess({ file, kind: def.kind, payload: probePayload(def.id, projectDir), cwd: projectDir });
+    const lines = debugLines(res.stderr);
+    if (res.error || res.status !== 0) {
+      const why = res.error || `exit ${res.status}`;
+      const tail = String(res.stderr).trim().split('\n').slice(-2).join(' | ');
+      errors.push(it('hrBroke', { id: def.id, why, tail: tail ? `: ${tail}` : '' }));
+    } else if (lines.some((l) => LOAD_FAILURE_RE.test(l))) {
+      errors.push(it('hrNoLibs', { id: def.id, line: lines.find((l) => LOAD_FAILURE_RE.test(l)) }));
+    } else if (lines.length > 0) {
+      warnings.push(it('hrSwallowed', { id: def.id, line: lines[0].replace('[wizz-debug] ', '') }));
+    }
+  }
+
+  if (errors.length > 0) {
+    return {
+      check: 'hooks-run',
+      status: 'error',
+      detail: `${errors.join('\n')}${warnings.length > 0 ? `\n${warnings.join('\n')}` : ''}\n${it('hrPartialCopy')}`,
+    };
+  }
+  if (warnings.length > 0) return { check: 'hooks-run', status: 'warn', detail: warnings.join('\n') };
+  return { check: 'hooks-run', status: 'ok', detail: it('hrOk', { n: ran }) };
+}
+
+module.exports = { checkHooksRun, probePayload, defaultRunHookProcess, HOOK_TIMEOUT_MS };