wizz-method 2.17.2 → 2.19.0

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

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