wizz-method 2.18.0 → 2.19.0

package/tools/hooks/wizz-router-enforce.js

@@ -120,17 +120,14 @@ function findWizzRoot(startDir) {
   return null;
 }
 
+// Gerado por tools/generate-dispatch-rule.mjs a partir de
+// src/skills-lib/_shared/dispatch-rule.yaml (`hook_hint`). Não edite a linha
+// abaixo: edite o yaml e rode `npm run generate:dispatch-rule`.
+const WIZZ_PROJECT_HINT =
+  '🎛️ Wizz: NÃO invoque wizz-router. Capacidades → rel necessário à entrega → áreas → atalhos. 2+ áreas → `wizz-maestro`. 1 área: 2+ fatores (multi-passo, planejar, artefato memorável) → `wizz-maestro`; senão → Skill da área. Auth/pagamento/permissão/migração → maestro. Personas são skills, não subagent_type; Agent usa tipos disponíveis wizz-exec-*; difícil → wizz-exec-strong (ESCALAR → ultra).';
+
 function buildContext(isWizzProject) {
-  if (isWizzProject) {
-    return (
-      '🎛️ Wizz: NÃO invoque wizz-router. Capacidades → rel necessário à entrega → áreas → atalhos. 2+ áreas → `wizz-maestro`. ' +
-      '1 área: 2+ fatores (multi-passo, planejar, artefato memorável) → `wizz-maestro`; ' +
-      'senão → Skill da área. ' +
-      'Auth/pagamento/permissão/migração → maestro. ' +
-      'Personas são skills, não subagent_type; Agent usa tipos disponíveis wizz-exec-*' +
-      '; difícil → wizz-exec-strong (ESCALAR → ultra).'
-    );
-  }
+  if (isWizzProject) return WIZZ_PROJECT_HINT;
   return (
     '🎛️ Pedido não-trivial: invoque a Skill `wizz-router` antes de agir para ' +
     'mapear skills/MCPs (liste candidatas via AskUserQuestion e confirme). ' +
@@ -138,6 +135,21 @@ function buildContext(isWizzProject) {
   );
 }
 
+// Diagnóstico opt-in (WIZZ_DEBUG=1). Lib ausente numa cópia parcial: ainda avisa em stderr.
+let debug = (hook, phase, err) => {
+  if (process.env.WIZZ_DEBUG !== '1') return;
+  try {
+    process.stderr.write(`[wizz-debug] ${hook} ${phase}: ${(err && err.message) || err}\n`);
+  } catch {
+    // stderr fechado
+  }
+};
+try {
+  ({ debug } = require('./wizz-debug-lib.js'));
+} catch (error) {
+  debug('router-enforce', 'require wizz-debug-lib', error);
+}
+
 // Linha de feature, por prompt, em projeto Wizz (2026-10-02, caso Spider).
 // O SessionStart avisa 1x, mas é aqui que o pedido nomeado chega: sem este
 // lembrete o despacho saía sem feature e o artefato caía na raiz. Fail-open:
@@ -152,7 +164,8 @@ function featureLine(wizzRoot) {
       return ` Feature: nenhuma ativa. Pedido nomeado → ANTES de despachar \`${cmd} definir <slug do pedido>\` (sem perguntar); handoff leva \`feature:\`.`;
     }
     return ` Feature: ${state.slug}. Outro assunto → \`${cmd} definir <novo>\`; continuação mantém; entrega fechada → \`${cmd} encerrar\`. Handoff leva \`feature: ${state.slug}\`.`;
-  } catch {
+  } catch (error) {
+    debug('router-enforce', 'featureLine', error);
     return '';
   }
 }
@@ -197,8 +210,9 @@ function checkFallbackWarnings(isWizzProject, wizzRoot) {
         warnings.push(`routing-table-flat.md não encontrada em ${flatTablePath} — rode "npm run sync:global" no repo wizz-method`);
       }
     }
-  } catch {
+  } catch (error) {
     // fail-silent — checagem de fallback nunca bloqueia o prompt
+    debug('router-enforce', 'checkFallbackWarnings', error);
   }
   return warnings;
 }
@@ -218,7 +232,10 @@ function emitFallbackWarnings(warnings) {
 
 function runHook() {
   let input = '';
-  const stdinTimeout = setTimeout(() => process.exit(0), 3000);
+  const stdinTimeout = setTimeout(() => {
+    debug('router-enforce', 'stdin', 'timeout de 3s sem fim de stdin; saindo sem rotear');
+    process.exit(0);
+  }, 3000);
   process.stdin.setEncoding('utf8');
   process.stdin.on('data', (chunk) => (input += chunk));
   process.stdin.on('end', () => {

package/tools/installer/command-text.js

@@ -0,0 +1,243 @@
+/**
+ * Text of the maintenance commands that run on an existing install:
+ * `wizz doctor` (core/doctor.js + core/hooks-smoke.js), `wizz resolve` and
+ * `wizz trace-report`. Merged into install-text.js, so `it()` and the en/pt
+ * key-parity test cover these keys too (pendência de 2026-10-15: these three
+ * commands only spoke Portuguese).
+ *
+ * The language comes from install-text.js `useCommandLang()`: WIZZ_LANG,
+ * then `communication_language` of the install, then English.
+ */
+
+const en = {
+  // wizz doctor (commands/doctor.js)
+  doctorTitle: 'wizz doctor — project diagnosis\n',
+  doctorSummary: 'Summary: {ok} ok, {warn} warn, {error} error.',
+  doctorNextErrors: 'Next step: fix the ERROR items above (wizz update restores the hook files) and run wizz doctor again.',
+  doctorNextWarns: 'Next step: warns are optional or degrade single features; follow the hint in each block when it makes sense.',
+  doctorResolveHint: 'For the customization snapshots, the command is: wizz resolve',
+  doctorAllGood: 'All good: install intact, tools in place and no drift in _wizz/.',
+  doctorFailed: 'wizz doctor failed: {error}',
+
+  // checks (core/doctor.js)
+  docSkipped: 'skipped.',
+  docHooksMissingFiles: 'Hook files missing in _wizz/hooks/: {list}. Run wizz update to restore them.',
+  docHooksNotRegistered:
+    'Files ok, but not registered in the PROJECT settings ({settings}): {list}. Not in the GLOBAL settings either ({global}). Run wizz install to register them in the project, or register them globally.',
+  docHooksSkippedNote: ' ({n} already registered in the global settings {global}, ok)',
+  docHooksOk: '{n} hooks checked{note}.',
+  docNoInstallHooks: 'No Wizz install in this directory (_wizz/ missing); project hooks not checked. Run wizz install.',
+  docRtkMissing:
+    'rtk not found on PATH. Optional, but without it the rtk-rewrite.sh hook is not registered and the token savings do not run. Install: cargo install rtk',
+  docRtkOld: 'rtk {installed} is older than the hook floor ({floor}); the rewrite fails with a warn. Update: cargo install rtk',
+  docRtkOk: 'rtk {version} on PATH.',
+  docVersionUnknown: '(version not reported)',
+  docJqMissing:
+    'jq not found on PATH. The rtk-rewrite.sh hook needs it; without jq the Bash rewrite warns and carries on without rewriting. Install: brew install jq',
+  docJqOk: 'jq on PATH.',
+  docPyOptional: 'Optional: the core runs on Node alone; Python only enables the skills that ship their own script ({skills}).',
+  docPyFull: 'Python {version} via {command} (tomllib ok): the Python skills run too.',
+  docPyFullNoPython3: 'Python {version} exists via {command}, but the scripts call python3, which is not on PATH. {optional}',
+  docPyPartial: 'Python {version} on PATH, without tomllib (the skills with their own script need 3.11+). {optional}',
+  docPyUnsupported: 'Python {version} is too old (the skills with their own script need 3.11+). {optional}',
+  docPyNone: 'python3 not found on PATH. {optional} To get them: brew install python3 (macOS).',
+  docDriftNoManifest:
+    'files-manifest.csv not found in _wizz/_config/. Without it drift cannot be detected; run wizz update to generate it.',
+  docDriftEmpty: 'files-manifest.csv is empty, nothing to compare.',
+  docDriftOk: '{n} files match files-manifest.csv.',
+  docDriftChanged: '{n} changed',
+  docDriftMissing: '{n} missing',
+  docDriftAnd: ' and ',
+  docDriftWarn:
+    'Drift in _wizz/: {parts} against files-manifest.csv (e.g. {examples}). Manual edits in _wizz/ are lost on the next update: move them to _wizz/custom/ and run wizz update.',
+  docNoInstallDrift: 'No Wizz install in this directory; drift not checked. Run wizz install.',
+  docResolvedNone: 'No installed skill has a customize.toml; nothing to resolve.',
+  docResolvedNoIndex: 'Index {file} missing or unreadable: cannot tell whether the {n} snapshots are up to date. Run wizz resolve.',
+  docResolvedOk: '{n} snapshots in _wizz/_resolved/ match the inputs that generated them.',
+  docResolvedMissing: '{n} without snapshot ({list})',
+  docResolvedStale: '{n} with a stale snapshot ({list})',
+  docResolvedPrefixStale: 'stale snapshot: run wizz resolve',
+  docResolvedPrefix: 'run wizz resolve',
+  docNoInstallResolved: 'No Wizz install in this directory; _wizz/_resolved/ snapshots not checked. Run wizz install.',
+  docInstrNoBlock: '{file} without the Wizz block at the top (run wizz install)',
+  docInstrNone: 'No CLAUDE.md/AGENTS.md in the project.',
+  docInstrOk: 'Wizz block present, no legacy rule.',
+  'docLegacy.gsd': 'GSD was replaced by the Wizz Method phases and checkpoints',
+  'docLegacy.superpowers': 'superpowers was replaced by the Wizz Method',
+  'docLegacy.bmad': 'plain BMAD commands and folders became wizz-* and _wizz/',
+  'docLegacy.modelo-aposentado': 'retired model ID; the Wizz ladder uses the current aliases',
+
+  // hooks-run (core/hooks-smoke.js)
+  hrBroke: '{id}: broke ({why}){tail}',
+  hrNoLibs: '{id}: cannot load its libs ({line})',
+  hrSwallowed: '{id}: swallowed error ({line})',
+  hrPartialCopy: 'Partial copy in _wizz/hooks/? Run wizz update to restore it.',
+  hrOk: '{n} hook(s) run with a minimal payload, no swallowed error.',
+
+  // wizz resolve (commands/resolve.js)
+  rsNoInstall: 'No Wizz install in this directory (_wizz/ missing). Run wizz install first.',
+  rsSkillMissing: 'Skill "{skill}" has no customize.toml anywhere in this project.',
+  rsSearched: 'Looked in:\n  {list}',
+  rsOneDone: 'wizz resolve — {written} snapshot written, {skipped} skipped (skill {skill}).',
+  rsConfigOk: '_config.json rewritten',
+  rsConfigMissing: '_config.json NOT generated (config.toml missing or invalid)',
+  rsNoToml: 'No customize.toml in this project (neither in _wizz/ nor in the IDE skill folders).',
+  rsPruned: '{n} orphan snapshot(s) removed from _wizz/_resolved/.',
+  rsUpdateHint: '{config}. If the install looks incomplete, run: wizz update',
+  rsWritten: '{n} snapshot(s) written',
+  rsSkipped: '{n} skipped',
+  rsOrphans: '{n} orphan(s) removed',
+  rsDone: 'wizz resolve — {parts} in _wizz/_resolved/.',
+  rsSkippedNote:
+    'Skipped skills have an invalid customize.toml: their snapshot was removed and activation falls back to the raw customize.toml until the file is fixed.',
+  rsFailed: 'wizz resolve failed: {error}',
+
+  // wizz trace-report (commands/trace-report.js)
+  trCatalog: 'Catalog:                 {n} skills ({file})',
+  trDecisions: 'Decision traces:         {n}',
+  trSelected: 'Selected (sel):          {n} ({pct})',
+  trDiscarded: 'Discarded with reason:   {n} ({pct})',
+  trNever: 'Never considered:        {n} ({pct})',
+  trCoverage: 'Catalog coverage:        {pct}',
+  trNoDecisions: '(no decision trace found; run with WIZZ_TRACE=1 and close routed requests to generate data)',
+  trNeverNone: 'Never considered: none, catalog 100% covered.',
+  trNeverHeader: 'Never considered:',
+  trFile: 'File:            {file}',
+  trTotal: 'Total lines:     {n}',
+  trTrivial: 'Trivial:         {n}',
+  trRouted: 'Routed:          {n}',
+  trModeWizz: '  wizz mode:     {n}',
+  trModeFlat: '  flat mode:     {n}',
+  trModeNull: '  null mode:     {n}',
+  trWarnings: 'With warnings:   {n}',
+  trPeriod: 'Period:          {first} → {last}',
+  trCorrupted: 'Ignored lines (corrupted): {n}',
+  trLadderTotal: 'Routed requests with ladder data: {n}',
+  trLadderExec: 'Invoked some wizz-exec-*:         {n} ({pct})',
+  trByRoute: 'By route:',
+  trNoData: '  (no data)',
+  trByTier: 'By tier (execs) (wizz-exec-*, legacy names count in the new tier):',
+  trNoTrace: 'No trace found.',
+  trExpected: 'Expected location: {file}',
+  trHowTo: 'Run install and turn on the routing meter, or export WIZZ_TRACE=1.',
+  trCatalogFail: 'Could not read the skill catalog: {error}',
+  trCatalogExpected: 'Expected at: {file}',
+  trCoverageTitle: 'Skill Catalog Coverage',
+  trLadderTitle: 'Model Ladder Adherence',
+  trFailed: 'Trace report failed: {error}',
+};
+
+const pt = {
+  doctorTitle: 'wizz doctor — diagnóstico do projeto\n',
+  doctorSummary: 'Resumo: {ok} ok, {warn} warn, {error} error.',
+  doctorNextErrors: 'Próximo passo: corrija os itens com ERROR acima (wizz update repõe os arquivos de hook) e rode wizz doctor de novo.',
+  doctorNextWarns: 'Próximo passo: os warns são opcionais ou degradam features pontuais; siga a dica de cada bloco quando fizer sentido.',
+  doctorResolveHint: 'Para os snapshots de customização, o comando é: wizz resolve',
+  doctorAllGood: 'Tudo certo: instalação íntegra, tools no lugar e sem drift em _wizz/.',
+  doctorFailed: 'wizz doctor falhou: {error}',
+
+  docSkipped: 'pulado.',
+  docHooksMissingFiles: 'Faltam arquivos de hook em _wizz/hooks/: {list}. Execute wizz update para repor.',
+  docHooksNotRegistered:
+    'Arquivos ok, mas sem registro no settings do PROJETO ({settings}): {list}. Também não estão no settings GLOBAL ({global}). Rode wizz install para registrar no projeto, ou registre no global.',
+  docHooksSkippedNote: ' ({n} já registrado(s) no settings global {global}, ok)',
+  docHooksOk: '{n} hooks verificados{note}.',
+  docNoInstallHooks: 'Sem instalação Wizz neste diretório (_wizz/ ausente); hooks do projeto não verificados. Rode wizz install.',
+  docRtkMissing:
+    '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',
+  docRtkOld: 'rtk {installed} é mais antigo que o piso do hook ({floor}); o rewrite falha em warn. Atualize: cargo install rtk',
+  docRtkOk: 'rtk {version} no PATH.',
+  docVersionUnknown: '(versão não informada)',
+  docJqMissing:
+    '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',
+  docJqOk: 'jq no PATH.',
+  docPyOptional: 'Opcional: o núcleo roda só com Node; Python só habilita as skills com script próprio ({skills}).',
+  docPyFull: 'Python {version} via {command} (tomllib ok): as skills Python também rodam.',
+  docPyFullNoPython3: 'Python {version} existe via {command}, mas os scripts chamam python3, que não está no PATH. {optional}',
+  docPyPartial: 'Python {version} no PATH, sem tomllib (as skills com script próprio pedem 3.11+). {optional}',
+  docPyUnsupported: 'Python {version} é antigo demais (as skills com script próprio pedem 3.11+). {optional}',
+  docPyNone: 'python3 não encontrado no PATH. {optional} Para tê-las: brew install python3 (macOS).',
+  docDriftNoManifest:
+    'files-manifest.csv não encontrado em _wizz/_config/. Sem ele não dá para detectar drift; rode wizz update para gerar.',
+  docDriftEmpty: 'files-manifest.csv vazio, nada a comparar.',
+  docDriftOk: '{n} arquivos batem com o files-manifest.csv.',
+  docDriftChanged: '{n} alterado(s)',
+  docDriftMissing: '{n} ausente(s)',
+  docDriftAnd: ' e ',
+  docDriftWarn:
+    'Drift em _wizz/: {parts} contra o files-manifest.csv (ex.: {examples}). Edições manuais em _wizz/ são perdidas no próximo update: mova para _wizz/custom/ e rode wizz update.',
+  docNoInstallDrift: 'Sem instalação Wizz neste diretório; drift não verificado. Rode wizz install.',
+  docResolvedNone: 'Nenhuma skill com customize.toml instalada; nada a resolver.',
+  docResolvedNoIndex: 'Índice {file} ausente ou ilegível: não dá para saber se os {n} snapshots estão atualizados. Rode wizz resolve.',
+  docResolvedOk: '{n} snapshots em _wizz/_resolved/ batem com as entradas que os geraram.',
+  docResolvedMissing: '{n} sem snapshot ({list})',
+  docResolvedStale: '{n} com snapshot obsoleto ({list})',
+  docResolvedPrefixStale: 'snapshot obsoleto: rode wizz resolve',
+  docResolvedPrefix: 'rode wizz resolve',
+  docNoInstallResolved: 'Sem instalação Wizz neste diretório; snapshots de _wizz/_resolved/ não verificados. Rode wizz install.',
+  docInstrNoBlock: '{file} sem o bloco Wizz no topo (rode wizz install)',
+  docInstrNone: 'Sem CLAUDE.md/AGENTS.md no projeto.',
+  docInstrOk: 'Bloco Wizz presente, nenhuma regra legada.',
+  'docLegacy.gsd': 'GSD foi substituído pelas fases e checkpoints do Wizz Method',
+  'docLegacy.superpowers': 'superpowers foi substituído pelo Wizz Method',
+  'docLegacy.bmad': 'comandos e pastas do BMAD puro viraram wizz-* e _wizz/',
+  'docLegacy.modelo-aposentado': 'ID de modelo aposentado; a escada do Wizz usa os apelidos atuais',
+
+  hrBroke: '{id}: quebrou ({why}){tail}',
+  hrNoLibs: '{id}: não carrega suas libs ({line})',
+  hrSwallowed: '{id}: erro engolido ({line})',
+  hrPartialCopy: 'Cópia parcial em _wizz/hooks/? Execute wizz update para repor.',
+  hrOk: '{n} hook(s) executados com payload mínimo, sem erro engolido.',
+
+  rsNoInstall: 'Nenhuma instalação Wizz neste diretório (_wizz/ ausente). Rode wizz install primeiro.',
+  rsSkillMissing: 'Skill "{skill}" não tem customize.toml em lugar nenhum deste projeto.',
+  rsSearched: 'Procurei em:\n  {list}',
+  rsOneDone: 'wizz resolve — {written} snapshot gravado, {skipped} pulado (skill {skill}).',
+  rsConfigOk: '_config.json regravado',
+  rsConfigMissing: '_config.json NÃO gerado (config.toml ausente ou inválido)',
+  rsNoToml: 'Nenhum customize.toml neste projeto (nem em _wizz/, nem nas pastas de skill dos IDEs).',
+  rsPruned: '{n} snapshot(s) órfão(s) removido(s) de _wizz/_resolved/.',
+  rsUpdateHint: '{config}. Se a instalação parece incompleta, rode: wizz update',
+  rsWritten: '{n} snapshot(s) gravado(s)',
+  rsSkipped: '{n} pulado(s)',
+  rsOrphans: '{n} órfão(s) removido(s)',
+  rsDone: 'wizz resolve — {parts} em _wizz/_resolved/.',
+  rsSkippedNote:
+    'Skills puladas têm customize.toml inválido: o snapshot delas foi removido e a ativação cai no customize.toml bruto até o arquivo ser corrigido.',
+  rsFailed: 'wizz resolve falhou: {error}',
+
+  trCatalog: 'Catálogo:                {n} skills ({file})',
+  trDecisions: 'Traces de decisão:       {n}',
+  trSelected: 'Selecionadas (sel):      {n} ({pct})',
+  trDiscarded: 'Descartadas c/ motivo:   {n} ({pct})',
+  trNever: 'Nunca consideradas:      {n} ({pct})',
+  trCoverage: 'Cobertura do catálogo:   {pct}',
+  trNoDecisions: '(nenhum trace de decisão encontrado; rode com WIZZ_TRACE=1 e feche pedidos roteados pra gerar dados)',
+  trNeverNone: 'Nunca consideradas: nenhuma, catálogo 100% coberto.',
+  trNeverHeader: 'Nunca consideradas:',
+  trFile: 'Arquivo:        {file}',
+  trTotal: 'Total de linhas: {n}',
+  trTrivial: 'Triviais:        {n}',
+  trRouted: 'Roteados:        {n}',
+  trModeWizz: '  modo wizz:     {n}',
+  trModeFlat: '  modo flat:     {n}',
+  trModeNull: '  modo nulo:     {n}',
+  trWarnings: 'Com warnings:    {n}',
+  trPeriod: 'Período:         {first} → {last}',
+  trCorrupted: 'Linhas ignoradas (corrompidas): {n}',
+  trLadderTotal: 'Pedidos roteados com dado de escada: {n}',
+  trLadderExec: 'Invocaram algum wizz-exec-*:         {n} ({pct})',
+  trByRoute: 'Por rota:',
+  trNoData: '  (sem dados)',
+  trByTier: 'Por tier (execs) (wizz-exec-*, nomes legados contam no tier novo):',
+  trNoTrace: 'Nenhum trace encontrado.',
+  trExpected: 'Local esperado: {file}',
+  trHowTo: 'Rode o install e ligue o medidor de roteamento, ou exporte WIZZ_TRACE=1.',
+  trCatalogFail: 'Não foi possível ler o catálogo de skills: {error}',
+  trCatalogExpected: 'Esperado em: {file}',
+  trCoverageTitle: 'Cobertura do Catálogo de Skills',
+  trLadderTitle: 'Aderência à Escada de Modelos',
+  trFailed: 'Trace report falhou: {error}',
+};
+
+module.exports = { en, pt };

package/tools/installer/commands/catalog.js

@@ -84,4 +84,6 @@ module.exports = {
     process.stdout.write(lines.join('\n'));
   },
   renderCatalog,
+  isSkillInstalled,
+  shortWhen,
 };

package/tools/installer/commands/doctor.js

@@ -11,6 +11,7 @@ const os = require('node:os');
 const prompts = require('../prompts');
 const { runDoctor } = require('../core/doctor');
 const { findWizzDir } = require('../core/installer');
+const { it, useCommandLang } = require('../install-text');
 
 /**
  * Path do `settings.json` GLOBAL do usuário. Mesmo override que o installer
@@ -54,7 +55,7 @@ const STATUS_LABEL = {
 
 module.exports = {
   command: 'doctor',
-  description: 'Diagnóstico do projeto Wizz: hooks, rtk, jq, python e drift de _wizz/',
+  description: 'Diagnose the Wizz project: hooks, rtk, jq, python and drift in _wizz/',
   options: [],
   // Exportado para teste (item 17 fase3, bug 9): prova, a partir do comando
   // real da CLI, que o leitor de settings.json GLOBAL usado por checkHooks
@@ -65,6 +66,7 @@ module.exports = {
       const projectDir = process.cwd();
       const { wizzDir } = findWizzDir(projectDir);
       const hasInstall = path.basename(wizzDir) && require('../fs-native').existsSync(wizzDir);
+      useCommandLang(hasInstall ? wizzDir : null);
 
       const { results, exitCode } = await runDoctor({
         deps: {
@@ -75,7 +77,7 @@ module.exports = {
         },
       });
 
-      await prompts.log.message('wizz doctor — diagnóstico do projeto\n');
+      await prompts.log.message(it('doctorTitle'));
 
       for (const r of results) {
         const line = `[${STATUS_LABEL[r.status]}] ${r.check}: ${r.detail}`;
@@ -93,28 +95,24 @@ module.exports = {
       const oks = results.filter((r) => r.status === 'ok').length;
 
       await prompts.log.message('');
-      await prompts.log.message(`Resumo: ${oks} ok, ${warns} warn, ${errors} error.`);
+      await prompts.log.message(it('doctorSummary', { ok: oks, warn: warns, error: errors }));
 
       const staleResolved = results.find((r) => r.check === 'resolved' && r.status === 'warn');
 
       if (errors > 0) {
-        await prompts.log.message(
-          'Próximo passo: corrija os itens com ERROR acima (wizz update repor os arquivos de hook) e rode wizz doctor de novo.',
-        );
+        await prompts.log.message(it('doctorNextErrors'));
       } else if (warns > 0) {
-        await prompts.log.message(
-          'Próximo passo: os warns são opcionais ou degradam features pontuais; siga a dica de cada bloco quando fizer sentido.',
-        );
+        await prompts.log.message(it('doctorNextWarns'));
         if (staleResolved) {
-          await prompts.log.message('Para os snapshots de customização, o comando é: wizz resolve');
+          await prompts.log.message(it('doctorResolveHint'));
         }
       } else {
-        await prompts.log.message('Tudo certo: instalação íntegra, tools no lugar e sem drift em _wizz/.');
+        await prompts.log.message(it('doctorAllGood'));
       }
 
       process.exit(exitCode);
     } catch (error) {
-      await prompts.log.error(`wizz doctor falhou: ${error.message}`);
+      await prompts.log.error(it('doctorFailed', { error: error.message }));
       if (process.env.WIZZ_DEBUG) {
         await prompts.log.message(error.stack);
       }

package/tools/installer/commands/fetch-assets.js

@@ -22,12 +22,12 @@
 
 module.exports = {
   command: 'fetch-assets',
-  description: 'Baixa sob demanda os assets pesados (MP3 do huashu-design, fontes do canvas-design)',
+  description: 'Download the heavy assets on demand (huashu-design MP3s, canvas-design fonts)',
   options: [
-    ['--bundle <name>', 'Bundle a baixar (huashu-audio | canvas-fonts)'],
-    ['--dest <dir>', 'Destino da extração (default: local do bundle dentro do pacote wizz-method)'],
-    ['--force', 'Ignora o cache e rebaixa mesmo se os arquivos já existirem'],
-    ['--all', 'Baixa todos os bundles conhecidos'],
+    ['--bundle <name>', 'Bundle to download (huashu-audio | canvas-fonts)'],
+    ['--dest <dir>', 'Extraction target (default: the bundle location inside the wizz-method package)'],
+    ['--force', 'Ignore the cache and download again even if the files exist'],
+    ['--all', 'Download every known bundle'],
   ],
   action: async (options) => {
     const { fetchNamedBundle, BUNDLES } = await import('../../fetch-assets.mjs');

package/tools/installer/commands/install.js

@@ -1,3 +1,4 @@
+const { it } = require('../install-text');
 const path = require('node:path');
 const prompts = require('../prompts');
 const { Installer } = require('../core/installer');
@@ -139,14 +140,12 @@ module.exports = {
         // isQuickUpdate() gate in core/installer.js). Say so in the final
         // summary too, not just as a menu hint and an in-run log line, so
         // the "no new skills" outcome is never a silent surprise.
-        await prompts.log.info(
-          'Skills/MCPs/CLIs não foram alterados (Quick Update). Para provisioná-los, rode install e escolha "Modify Wizz Installation".',
-        );
+        await prompts.log.info(it('quickUpdateNoSkills'));
         if (result.warnings > 0) {
-          await prompts.log.warn(`Concluído com ${result.warnings} aviso(s). Veja o resumo acima para detalhes.`);
+          await prompts.log.warn(it('doneWarnings', { n: result.warnings }));
         }
         if (result.errors > 0) {
-          await prompts.log.error(`Concluído com ${result.errors} falha(s) real(is). Veja o resumo acima para detalhes.`);
+          await prompts.log.error(it('doneErrors', { n: result.errors }));
           process.exit(1);
         }
         process.exit(0);
@@ -169,10 +168,10 @@ module.exports = {
       // count means a real failure happened and the exit code must reflect it.
       if (result) {
         if (result.warnings > 0) {
-          await prompts.log.warn(`Concluído com ${result.warnings} aviso(s). Veja o resumo acima para detalhes.`);
+          await prompts.log.warn(it('doneWarnings', { n: result.warnings }));
         }
         if (result.errors > 0) {
-          await prompts.log.error(`Concluído com ${result.errors} falha(s) real(is). Veja o resumo acima para detalhes.`);
+          await prompts.log.error(it('doneErrors', { n: result.errors }));
           process.exit(1);
         }
         if (result.success) {

package/tools/installer/commands/resolve.js

@@ -31,18 +31,20 @@ const prompts = require('../prompts');
 const fs = require('../fs-native');
 const { findWizzDir } = require('../core/installer');
 const { resolveAll, resolveOne } = require('../core/resolved-customizations');
+const { it, useCommandLang } = require('../install-text');
 
 module.exports = {
   command: 'resolve',
-  description: 'Regenera os snapshots de customização em _wizz/_resolved/ (todas as skills ou uma)',
-  options: [['--skill <name>', 'Regenera só a skill indicada (nome do diretório, ex.: wizz-maestro)']],
+  description: 'Regenerate the customization snapshots in _wizz/_resolved/ (all skills or one)',
+  options: [['--skill <name>', 'Regenerate only this skill (directory name, e.g. wizz-maestro)']],
   action: async (options = {}) => {
     try {
       const projectDir = process.cwd();
       const { wizzDir } = findWizzDir(projectDir);
+      useCommandLang(fs.existsSync(wizzDir) ? wizzDir : null);
 
       if (!fs.existsSync(wizzDir)) {
-        await prompts.log.error('Nenhuma instalação Wizz neste diretório (_wizz/ ausente). Rode wizz install primeiro.');
+        await prompts.log.error(it('rsNoInstall'));
         process.exit(1);
         return;
       }
@@ -53,39 +55,37 @@ module.exports = {
       if (skillName) {
         const result = await resolveOne(projectDir, wizzDir, skillName, { warn, includeDeployed: true });
         if (!result.found) {
-          await prompts.log.error(`Skill "${skillName}" não tem customize.toml em lugar nenhum deste projeto.`);
-          await prompts.log.message(`Procurei em:\n  ${(result.searched || []).join('\n  ')}`);
+          await prompts.log.error(it('rsSkillMissing', { skill: skillName }));
+          await prompts.log.message(it('rsSearched', { list: (result.searched || []).join('\n  ') }));
           process.exit(1);
           return;
         }
-        await prompts.log.message(`wizz resolve — ${result.written} snapshot gravado, ${result.skipped} pulado (skill ${skillName}).`);
+        await prompts.log.message(it('rsOneDone', { written: result.written, skipped: result.skipped, skill: skillName }));
         process.exit(0);
         return;
       }
 
       const result = await resolveAll({ projectRoot: projectDir, wizzDir, warn, includeDeployed: true });
-      const configNote = result.config ? '_config.json regravado' : '_config.json NÃO gerado (config.toml ausente ou inválido)';
+      const configNote = result.config ? it('rsConfigOk') : it('rsConfigMissing');
       if (result.written === 0 && result.skipped === 0) {
-        await prompts.log.warn('Nenhum customize.toml neste projeto (nem em _wizz/, nem nas pastas de skill dos IDEs).');
+        await prompts.log.warn(it('rsNoToml'));
         if (result.pruned.length > 0) {
-          await prompts.log.message(`${result.pruned.length} snapshot(s) órfão(s) removido(s) de _wizz/_resolved/.`);
+          await prompts.log.message(it('rsPruned', { n: result.pruned.length }));
         }
-        await prompts.log.message(`${configNote}. Se a instalação parece incompleta, rode: wizz update`);
+        await prompts.log.message(it('rsUpdateHint', { config: configNote }));
         process.exit(0);
         return;
       }
-      const parts = [`${result.written} snapshot(s) gravado(s)`, `${result.skipped} pulado(s)`];
-      if (result.pruned.length > 0) parts.push(`${result.pruned.length} órfão(s) removido(s)`);
+      const parts = [it('rsWritten', { n: result.written }), it('rsSkipped', { n: result.skipped })];
+      if (result.pruned.length > 0) parts.push(it('rsOrphans', { n: result.pruned.length }));
       parts.push(configNote);
-      await prompts.log.message(`wizz resolve — ${parts.join(', ')} em _wizz/_resolved/.`);
+      await prompts.log.message(it('rsDone', { parts: parts.join(', ') }));
       if (result.skipped > 0) {
-        await prompts.log.message(
-          'Skills puladas têm customize.toml inválido: o snapshot delas foi removido e a ativação cai no customize.toml bruto até o arquivo ser corrigido.',
-        );
+        await prompts.log.message(it('rsSkippedNote'));
       }
       process.exit(0);
     } catch (error) {
-      await prompts.log.error(`wizz resolve falhou: ${error.message}`);
+      await prompts.log.error(it('rsFailed', { error: error.message }));
       if (process.env.WIZZ_DEBUG) {
         await prompts.log.message(error.stack);
       }