wizz-method 2.18.0 → 2.19.0

package/tools/installer/commands/trace-report.js

@@ -15,6 +15,7 @@ const yaml = require('yaml');
 const fs = require('../fs-native');
 const prompts = require('../prompts');
 const { getProjectRoot } = require('../project-root');
+const { it, useCommandLang } = require('../install-text');
 
 function getTraceFile() {
   return process.env.WIZZ_TRACE_FILE || path.join(os.homedir(), '.claude', 'wizz-trace.jsonl');
@@ -36,8 +37,8 @@ function getRegistryFile() {
 // Lê e parseia skills-registry.yaml, devolvendo o catálogo de ids de
 // skills em ordem alfabética estável (mesma lista independente da ordem em
 // que as áreas/skills aparecem no YAML). Escopo deliberado: só as skills
-// `areas.*.skills[]` e as cross-cutting `utility[]` (find-skills,
-// enhance-prompt, wizz-router; também são skills de verdade em
+// `areas.*.skills[]` e as cross-cutting `utility[]` (wizz-find-skills,
+// wizz-enhance-prompt, wizz-router; também são skills de verdade em
 // src/skills-lib/). CLIs/MCPs/squads ficam de fora: `sel`/`desc` no
 // marcador de decisão podem citar agentes ou skills (ver encerramento.md),
 // mas este comando mede especificamente subutilização de SKILL, não de
@@ -122,20 +123,20 @@ function aggregateCoverage(entries, catalogIds) {
 function formatCoverageSummary(stats, registryFile) {
   const consideredCount = stats.catalogTotal - stats.neverConsidered.length;
   const lines = [
-    `Catálogo:                ${stats.catalogTotal} skills (${registryFile})`,
-    `Traces de decisão:       ${stats.decisionCount}`,
-    `Selecionadas (sel):      ${stats.selectedCount} (${pct(stats.selectedCount, stats.catalogTotal)})`,
-    `Descartadas c/ motivo:   ${stats.discardedOnlyCount} (${pct(stats.discardedOnlyCount, stats.catalogTotal)})`,
-    `Nunca consideradas:      ${stats.neverConsidered.length} (${pct(stats.neverConsidered.length, stats.catalogTotal)})`,
-    `Cobertura do catálogo:   ${pct(consideredCount, stats.catalogTotal)}`,
+    it('trCatalog', { n: stats.catalogTotal, file: registryFile }),
+    it('trDecisions', { n: stats.decisionCount }),
+    it('trSelected', { n: stats.selectedCount, pct: pct(stats.selectedCount, stats.catalogTotal) }),
+    it('trDiscarded', { n: stats.discardedOnlyCount, pct: pct(stats.discardedOnlyCount, stats.catalogTotal) }),
+    it('trNever', { n: stats.neverConsidered.length, pct: pct(stats.neverConsidered.length, stats.catalogTotal) }),
+    it('trCoverage', { pct: pct(consideredCount, stats.catalogTotal) }),
   ];
 
   if (stats.decisionCount === 0) {
-    lines.push('', '(nenhum trace de decisão encontrado; rode com WIZZ_TRACE=1 e feche pedidos roteados pra gerar dados)');
+    lines.push('', it('trNoDecisions'));
   } else if (stats.neverConsidered.length === 0) {
-    lines.push('', 'Nunca consideradas: nenhuma, catálogo 100% coberto.');
+    lines.push('', it('trNeverNone'));
   } else {
-    lines.push('', 'Nunca consideradas:');
+    lines.push('', it('trNeverHeader'));
     for (const id of stats.neverConsidered) lines.push(`  ${id}`);
   }
 
@@ -293,18 +294,18 @@ function pct(part, total) {
 
 function formatSummary(stats, traceFile) {
   const lines = [
-    `Arquivo:        ${traceFile}`,
-    `Total de linhas: ${stats.total}`,
-    `Triviais:        ${stats.trivialCount}`,
-    `Roteados:        ${stats.routedCount}`,
-    `  modo wizz:     ${stats.byMode.wizz}`,
-    `  modo flat:     ${stats.byMode.flat}`,
-    `  modo nulo:     ${stats.byMode.null}`,
-    `Com warnings:    ${stats.warningsCount}`,
-    `Período:         ${stats.firstTs || '—'} → ${stats.lastTs || '—'}`,
+    it('trFile', { file: traceFile }),
+    it('trTotal', { n: stats.total }),
+    it('trTrivial', { n: stats.trivialCount }),
+    it('trRouted', { n: stats.routedCount }),
+    it('trModeWizz', { n: stats.byMode.wizz }),
+    it('trModeFlat', { n: stats.byMode.flat }),
+    it('trModeNull', { n: stats.byMode.null }),
+    it('trWarnings', { n: stats.warningsCount }),
+    it('trPeriod', { first: stats.firstTs || '—', last: stats.lastTs || '—' }),
   ];
   if (stats.corruptedCount > 0) {
-    lines.push(`Linhas ignoradas (corrompidas): ${stats.corruptedCount}`);
+    lines.push(it('trCorrupted', { n: stats.corruptedCount }));
   }
   return lines.join('\n');
 }
@@ -316,14 +317,14 @@ const ROUTE_DISPLAY_ORDER = ['agent:*', 'maestro', 'flat', 'outro'];
 function formatLadderSummary(ladderStats) {
   const byTier = ladderStats.byTier || {};
   const lines = [
-    `Pedidos roteados com dado de escada: ${ladderStats.total}`,
-    `Invocaram algum wizz-exec-*:         ${ladderStats.withExec} (${pct(ladderStats.withExec, ladderStats.total)})`,
-    'Por rota:',
+    it('trLadderTotal', { n: ladderStats.total }),
+    it('trLadderExec', { n: ladderStats.withExec, pct: pct(ladderStats.withExec, ladderStats.total) }),
+    it('trByRoute'),
   ];
 
   const routes = ROUTE_DISPLAY_ORDER.filter((route) => ladderStats.byRoute[route]);
   if (routes.length === 0) {
-    lines.push('  (sem dados)');
+    lines.push(it('trNoData'));
   } else {
     for (const route of routes) {
       const bucket = ladderStats.byRoute[route];
@@ -331,10 +332,10 @@ function formatLadderSummary(ladderStats) {
     }
   }
 
-  lines.push('Por tier (execs) (wizz-exec-*, nomes legados contam no tier novo):');
+  lines.push(it('trByTier'));
   const tiers = TIER_DISPLAY_ORDER.filter((tier) => byTier[tier]);
   if (tiers.length === 0) {
-    lines.push('  (sem dados)');
+    lines.push(it('trNoData'));
   } else {
     for (const tier of tiers) {
       lines.push(`  ${tier.padEnd(10)} ${byTier[tier]}`);
@@ -346,16 +347,18 @@ function formatLadderSummary(ladderStats) {
 
 module.exports = {
   command: 'trace-report',
-  description: 'Resume o arquivo local de trace do roteamento (WIZZ_TRACE)',
-  options: [['--coverage', 'Cruza o catálogo de skills do registry contra os traces: mede skills nunca consideradas no roteamento']],
+  description: 'Summarize the local routing trace file (WIZZ_TRACE)',
+  options: [['--coverage', 'Cross the registry skill catalog with the traces: measures skills never considered in routing']],
   action: async (options) => {
     try {
+      const wizzDir = path.join(process.cwd(), '_wizz');
+      useCommandLang(fs.existsSync(wizzDir) ? wizzDir : null);
       const traceFile = getTraceFile();
 
       if (!(await fs.pathExists(traceFile))) {
-        await prompts.log.warn('Nenhum trace encontrado.');
-        await prompts.log.message(`Local esperado: ${traceFile}`);
-        await prompts.log.message('Rode o install e ligue o medidor de roteamento, ou exporte WIZZ_TRACE=1.');
+        await prompts.log.warn(it('trNoTrace'));
+        await prompts.log.message(it('trExpected', { file: traceFile }));
+        await prompts.log.message(it('trHowTo'));
         process.exit(0);
         return;
       }
@@ -386,14 +389,14 @@ module.exports = {
         try {
           catalogIds = collectSkillCatalog(registryFile);
         } catch (error) {
-          await prompts.log.error(`Não foi possível ler o catálogo de skills: ${error.message}`);
-          await prompts.log.message(`Esperado em: ${registryFile}`);
+          await prompts.log.error(it('trCatalogFail', { error: error.message }));
+          await prompts.log.message(it('trCatalogExpected', { file: registryFile }));
           process.exit(1);
           return;
         }
 
         const coverageStats = aggregateCoverage(entries, catalogIds);
-        await prompts.box(formatCoverageSummary(coverageStats, registryFile), 'Cobertura do Catálogo de Skills');
+        await prompts.box(formatCoverageSummary(coverageStats, registryFile), it('trCoverageTitle'));
         process.exit(0);
         return;
       }
@@ -403,11 +406,11 @@ module.exports = {
       await prompts.box(formatSummary(stats, traceFile), 'Wizz Trace Report');
 
       const ladderStats = aggregateLadder(entries);
-      await prompts.box(formatLadderSummary(ladderStats), 'Aderência à Escada de Modelos');
+      await prompts.box(formatLadderSummary(ladderStats), it('trLadderTitle'));
 
       process.exit(0);
     } catch (error) {
-      await prompts.log.error(`Trace report failed: ${error.message}`);
+      await prompts.log.error(it('trFailed', { error: error.message }));
       if (process.env.WIZZ_DEBUG) {
         await prompts.log.message(error.stack);
       }

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,
 };