@orkastery/cli 0.5.3 → 0.6.0

package/dist/docs.js

@@ -79,6 +79,8 @@ const node_child_process_1 = require("node:child_process");
 const yaml_1 = require("./yaml");
 const thread_1 = require("./thread");
 const ledger_1 = require("./ledger");
+const branch_de_estado_1 = require("./branch-de-estado");
+const locale_1 = require("./locale");
 exports.DIR_PRODUTO = 'docs/produto';
 exports.DIR_ROADMAP = 'docs/roadmap';
 exports.DIR_PADROES = 'docs/padroes';
@@ -161,17 +163,18 @@ function paginas(raiz, dir) {
 function documentoDeTexto(arquivo, texto) {
     const { bruto, corpo } = separarFrontmatter(texto);
     if (bruto === null) {
-        return { achado: erro(arquivo, undefined, 'docs.frontmatter.ausente', 'página sem frontmatter YAML', 'comece o arquivo com as chaves do modelo entre duas linhas ---') };
+        return { achado: erro(arquivo, undefined, 'docs.frontmatter.ausente', (m) => m.semFrontmatter, (m) => m.semFrontmatterCorrecao) };
     }
     let dados;
     try {
         dados = (0, yaml_1.lerYaml)(bruto);
     }
     catch (e) {
-        return { achado: erro(arquivo, undefined, 'docs.frontmatter.invalido', `frontmatter inválido: ${e.message}`) };
+        const detalhe = e.message;
+        return { achado: erro(arquivo, undefined, 'docs.frontmatter.invalido', (m) => m.frontmatterInvalido(detalhe)) };
     }
     if (!ehMapa(dados)) {
-        return { achado: erro(arquivo, undefined, 'docs.frontmatter.invalido', 'o frontmatter precisa ser um mapa de chaves') };
+        return { achado: erro(arquivo, undefined, 'docs.frontmatter.invalido', (m) => m.frontmatterNaoMapa) };
     }
     return { doc: { arquivo, tipo: dados.tipo, id: String(dados.id ?? ''), dados, corpo } };
 }
@@ -187,11 +190,15 @@ function carregarDocs(raiz) {
     }
     return { docs, achados };
 }
+function achado(gravidade, arquivo, id, regra, mensagem, correcao) {
+    const texto = (montar) => (0, locale_1.textoDoCatalogo)((m) => montar(m.docs));
+    return { arquivo, ...(id ? { id } : {}), regra, gravidade, mensagem: texto(mensagem), ...(correcao ? { correcao: texto(correcao) } : {}) };
+}
 function erro(arquivo, id, regra, mensagem, correcao) {
-    return { arquivo, ...(id ? { id } : {}), regra, gravidade: 'erro', mensagem, ...(correcao ? { correcao } : {}) };
+    return achado('erro', arquivo, id, regra, mensagem, correcao);
 }
 function aviso(arquivo, id, regra, mensagem, correcao) {
-    return { arquivo, ...(id ? { id } : {}), regra, gravidade: 'aviso', mensagem, ...(correcao ? { correcao } : {}) };
+    return achado('aviso', arquivo, id, regra, mensagem, correcao);
 }
 function git(raiz, args) {
     const r = (0, node_child_process_1.spawnSync)('git', args, { cwd: raiz, encoding: 'utf8' });
@@ -199,6 +206,9 @@ function git(raiz, args) {
 }
 /** Resolve a branch base: local, depois `origin/`, porque o CI faz checkout destacado. */
 function resolverBase(raiz, preferida = 'main') {
+    // RM-047 (fronteira de confiança): `preferida` vem do `worktree.base_branch` do clone.
+    if (!(0, branch_de_estado_1.branchValida)(preferida))
+        return null;
     for (const ref of [preferida, `origin/${preferida}`]) {
         if (git(raiz, ['rev-parse', '--verify', '--quiet', `${ref}^{commit}`]).ok)
             return ref;
@@ -228,23 +238,23 @@ function verificarDocs(raiz, opcoes = {}) {
     const porId = new Map();
     for (const d of docs) {
         if (!TIPOS.includes(d.tipo)) {
-            achados.push(erro(d.arquivo, d.id || undefined, 'docs.tipo', `tipo "${String(d.dados.tipo)}" desconhecido`, `use um de: ${TIPOS.join(', ')}`));
+            achados.push(erro(d.arquivo, d.id || undefined, 'docs.tipo', (m) => m.tipoDesconhecido(String(d.dados.tipo)), (m) => m.useUmDe(TIPOS.join(', '))));
             continue;
         }
         if (!PADRAO_ID[d.tipo].test(d.id)) {
-            achados.push(erro(d.arquivo, d.id || undefined, 'docs.id.formato', `ID "${d.id}" fora do padrão de ${d.tipo}`, `formato esperado: ${PADRAO_ID[d.tipo].source.replace(/[\^$\\]/g, '')}`));
+            achados.push(erro(d.arquivo, d.id || undefined, 'docs.id.formato', (m) => m.idForaDoPadrao(d.id, d.tipo), (m) => m.formatoEsperado(PADRAO_ID[d.tipo].source.replace(/[\^$\\]/g, ''))));
         }
         const nome = path.posix.basename(d.arquivo);
         if (!(nome === `${d.id}.md` || nome.startsWith(`${d.id}-`))) {
-            achados.push(erro(d.arquivo, d.id, 'docs.id.arquivo', 'o nome do arquivo não começa pelo ID', `renomeie para ${d.id}-<assunto>.md`));
+            achados.push(erro(d.arquivo, d.id, 'docs.id.arquivo', (m) => m.arquivoSemId, (m) => m.renomeie(d.id)));
         }
         const pastaCerta = d.tipo === 'roadmap' ? exports.DIR_ROADMAP : exports.DIR_PRODUTO;
         if (path.posix.dirname(d.arquivo) !== pastaCerta) {
-            achados.push(erro(d.arquivo, d.id, 'docs.pasta', `${d.tipo} mora em ${pastaCerta}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.pasta', (m) => m.pastaErrada(d.tipo, pastaCerta)));
         }
         const anterior = porId.get(d.id);
         if (anterior) {
-            achados.push(erro(d.arquivo, d.id, 'docs.id.duplicado', `ID repetido: também em ${anterior.arquivo}`, 'IDs são estáveis e únicos; renumere o novo, nunca o antigo'));
+            achados.push(erro(d.arquivo, d.id, 'docs.id.duplicado', (m) => m.idRepetido(anterior.arquivo), (m) => m.idRepetidoCorrecao));
         }
         else {
             porId.set(d.id, d);
@@ -252,7 +262,7 @@ function verificarDocs(raiz, opcoes = {}) {
     }
     const base = opcoes.semGit ? null : resolverBase(raiz, opcoes.baseBranch);
     if (!opcoes.semGit && !base) {
-        achados.push(aviso('.', undefined, 'docs.git.base', `branch base "${opcoes.baseBranch ?? 'main'}" não encontrada: a paridade com o git ficou de fora`, 'rode com o histórico do git disponível (fetch-depth: 0 no CI)'));
+        achados.push(aviso('.', undefined, 'docs.git.base', (m) => m.baseAusente(opcoes.baseBranch ?? 'main'), (m) => m.baseAusenteCorrecao));
     }
     const comandos = opcoes.ajudaDoCli ? comandosDaAjuda(opcoes.ajudaDoCli) : null;
     for (const d of docs) {
@@ -275,50 +285,53 @@ function verificarDocs(raiz, opcoes = {}) {
 function verificarChaves(d, achados) {
     for (const k of CHAVES[d.tipo]) {
         if (!(k in d.dados)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', `falta a chave "${k}"`, 'copie a chave do modelo; lacuna é "A definir — responsável, prazo"'));
+            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', (m) => m.faltaChave(k), (m) => m.faltaChaveCorrecao));
         }
     }
     if (d.tipo !== 'roadmap' && 'estado' in d.dados) {
         const e = String(d.dados.estado);
         if (!exports.ESTADOS_DA_ESPECIFICACAO.includes(e)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', `estado "${e}" fora do padrão`, `use um de: ${exports.ESTADOS_DA_ESPECIFICACAO.join(', ')}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', (m) => m.estadoForaDoPadrao(e), (m) => m.useUmDe(exports.ESTADOS_DA_ESPECIFICACAO.join(', '))));
         }
     }
     if (d.tipo === 'roadmap') {
         const cat = String(d.dados.categoria ?? '');
         if ('categoria' in d.dados && !exports.CATEGORIAS.includes(cat)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', `categoria "${cat}" fora do padrão`, `use uma de: ${exports.CATEGORIAS.join(', ')}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', (m) => m.categoriaForaDoPadrao(cat), (m) => m.useUmaDe(exports.CATEGORIAS.join(', '))));
         }
         const estado = d.dados.estado;
         if ('estado' in d.dados && !ehMapa(estado)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', 'estado do roadmap é um mapa de dimensões', `dimensões: ${Object.keys(exports.DIMENSOES).join(', ')}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', (m) => m.estadoNaoMapa, (m) => m.dimensoes(Object.keys(exports.DIMENSOES).join(', '))));
         }
         else if (ehMapa(estado)) {
             for (const [dim, valores] of Object.entries(exports.DIMENSOES)) {
                 if (!(dim in estado)) {
-                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', `falta a dimensão estado.${dim}`, 'o padrão atualiza cada dimensão separadamente'));
+                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', (m) => m.faltaDimensao(dim), (m) => m.faltaDimensaoCorrecao));
                 }
                 else if (!valores.includes(String(estado[dim]))) {
-                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', `estado.${dim} "${String(estado[dim])}" fora do padrão`, `use um de: ${valores.join(', ')}`));
+                    const valor = String(estado[dim]);
+                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', (m) => m.dimensaoForaDoPadrao(dim, valor), (m) => m.useUmDe(valores.join(', '))));
                 }
             }
             for (const dim of Object.keys(estado)) {
                 if (!(dim in exports.DIMENSOES)) {
-                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', `dimensão desconhecida estado.${dim}`));
+                    achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.chave', (m) => m.dimensaoDesconhecida(dim)));
                 }
             }
         }
     }
     for (const k of ['verificado_em', 'atualizado_em']) {
         if (k in d.dados && !ISO_COM_FUSO.test(String(d.dados[k]))) {
-            achados.push(erro(d.arquivo, d.id, 'docs.data', `${k} "${String(d.dados[k])}" não é ISO 8601 com fuso`, 'exemplo: 2026-09-24T20:00:00-03:00'));
+            const valor = String(d.dados[k]);
+            achados.push(erro(d.arquivo, d.id, 'docs.data', (m) => m.dataSemFuso(k, valor), (m) => m.dataExemplo));
         }
     }
     // Valor de modelo esquecido no frontmatter: `<...>` ou ID zerado (FEAT-000, MOD-00, RM-000).
     const visitar = (v, onde) => {
         if (typeof v === 'string') {
             if (/^<[^>]*>$/.test(v.trim()) || /^(PLAT|SYS|MOD|FEAT|RM)-0+$/.test(v.trim()) || /@0{7}$/.test(v.trim())) {
-                achados.push(erro(d.arquivo, d.id, 'docs.modelo', `valor do modelo não preenchido em ${onde}: ${v}`));
+                const valor = v;
+                achados.push(erro(d.arquivo, d.id, 'docs.modelo', (m) => m.valorDoModelo(onde, valor)));
             }
         }
         else if (Array.isArray(v))
@@ -392,15 +405,15 @@ function substituirBloco(corpo, ini, fim, conteudo) {
 }
 function verificarTabelasDeEstado(d, achados) {
     for (const [ini, fim, render, nome] of [
-        [RELANCE_INI, RELANCE_FIM, renderizarRelance, 'a linha de relance'],
-        [ESTADO_INI, ESTADO_FIM, renderizarEstado, 'a tabela "Estado com evidências"'],
+        [RELANCE_INI, RELANCE_FIM, renderizarRelance, (m) => m.nomeDaRelance],
+        [ESTADO_INI, ESTADO_FIM, renderizarEstado, (m) => m.nomeDoEstado],
     ]) {
         const atual = blocoEntre(d.corpo, ini, fim);
         if (atual === null) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.estado', `falta ${nome} gerada do frontmatter`, 'copie os marcadores do modelo e rode ork docs sincronizar --escrever'));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.estado', (m) => m.faltaTabela(nome(m)), (m) => m.faltaTabelaCorrecao));
         }
         else if (atual !== render(d)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.estado', `${nome} diverge do frontmatter`, 'o estado se edita no frontmatter; rode ork docs sincronizar --escrever para regerar a tabela'));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.estado', (m) => m.tabelaDiverge(nome(m)), (m) => m.tabelaDivergeCorrecao));
         }
     }
 }
@@ -410,14 +423,14 @@ function verificarReferencias(raiz, d, porId, achados) {
     if (esperadoDoPai && pai !== undefined && pai !== null) {
         const idPai = String(pai);
         if (!esperadoDoPai.test(idPai)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.referencia', `pai "${idPai}" não é do nível acima de ${d.tipo}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.referencia', (m) => m.paiDeOutroNivel(idPai, d.tipo)));
         }
         else if (!porId.has(idPai)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.referencia', `pai ${idPai} não existe`, 'crie a página do pai ou corrija o ID'));
+            achados.push(erro(d.arquivo, d.id, 'docs.referencia', (m) => m.paiNaoExiste(idPai), (m) => m.paiNaoExisteCorrecao));
         }
     }
     else if (esperadoDoPai && d.tipo !== 'roadmap' && (pai === undefined || pai === null)) {
-        achados.push(erro(d.arquivo, d.id, 'docs.referencia', `${d.tipo} precisa de pai`));
+        achados.push(erro(d.arquivo, d.id, 'docs.referencia', (m) => m.precisaDePai(d.tipo)));
     }
     const cruzadas = d.tipo === 'feature' ? [['roadmap', 'roadmap', 'features']]
         : d.tipo === 'roadmap' ? [['features', 'feature', 'roadmap']] : [];
@@ -425,10 +438,10 @@ function verificarReferencias(raiz, d, porId, achados) {
         for (const alvo of lista(d.dados[chave])) {
             const outro = porId.get(alvo);
             if (!outro || outro.tipo !== tipoAlvo) {
-                achados.push(erro(d.arquivo, d.id, 'docs.referencia', `${chave} cita ${alvo}, que não existe como ${tipoAlvo}`));
+                achados.push(erro(d.arquivo, d.id, 'docs.referencia', (m) => m.citaInexistente(chave, alvo, tipoAlvo)));
             }
             else if (!lista(outro.dados[chaveDeVolta]).includes(d.id)) {
-                achados.push(aviso(d.arquivo, d.id, 'docs.referencia.reciproca', `${alvo} não cita ${d.id} de volta`, `acrescente ${d.id} em ${chaveDeVolta} de ${alvo}`));
+                achados.push(aviso(d.arquivo, d.id, 'docs.referencia.reciproca', (m) => m.naoCitaDeVolta(alvo, d.id), (m) => m.naoCitaDeVoltaCorrecao(d.id, chaveDeVolta, alvo)));
             }
         }
     }
@@ -439,7 +452,7 @@ function verificarReferencias(raiz, d, porId, achados) {
             continue;
         const abs = path.resolve(path.dirname(path.join(raiz, d.arquivo)), decodeURIComponent(alvo));
         if (!fs.existsSync(abs)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.link', `link quebrado: ${alvo}`));
+            achados.push(erro(d.arquivo, d.id, 'docs.link', (m) => m.linkQuebrado(alvo)));
         }
     }
 }
@@ -451,36 +464,36 @@ function verificarLeitura(d, achados) {
     const linhas = d.corpo.split('\n');
     const h1 = linhas.find((l) => l.startsWith('# '));
     if (!h1 || !h1.includes(d.id)) {
-        achados.push(erro(d.arquivo, d.id, 'docs.leitura.titulo', 'o título (#) não começa pelo ID', `# ${d.id} — <nome>: humano e agente acham a página pelo mesmo nome`));
+        achados.push(erro(d.arquivo, d.id, 'docs.leitura.titulo', (m) => m.tituloSemId, (m) => m.tituloSemIdCorrecao(d.id)));
     }
     const frase = linhas.find((l) => /^>\s*\*\*Em uma frase:\*\*/.test(l));
     if (!frase) {
-        achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', 'falta a linha "> **Em uma frase:**" logo abaixo do título', 'escreva o que a página responde, antes de qualquer detalhe'));
+        achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', (m) => m.faltaFrase, (m) => m.faltaFraseCorrecao));
     }
     else {
         const n = frase.replace(/^>\s*\*\*Em uma frase:\*\*\s*/, '').trim().length;
         if (n === 0)
-            achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', 'a frase de abertura está vazia'));
+            achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', (m) => m.fraseVazia));
         else if (n > exports.LIMITE_DA_FRASE) {
-            achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', `a frase de abertura tem ${n} caracteres (limite ${exports.LIMITE_DA_FRASE})`, 'corte para uma ideia só; o resto vai em tópicos'));
+            achados.push(erro(d.arquivo, d.id, 'docs.leitura.resumo', (m) => m.fraseLonga(n, exports.LIMITE_DA_FRASE), (m) => m.fraseLongaCorrecao));
         }
     }
     const h2 = new Set(linhas.filter((l) => l.startsWith('## ')).map((l) => l.slice(3).trim()));
     for (const s of SECOES[d.tipo]) {
         if (!h2.has(s)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.secao', `falta a seção "## ${s}"`, 'se não se aplica, escreva dentro dela: Não aplicável — motivo'));
+            achados.push(erro(d.arquivo, d.id, 'docs.secao', (m) => m.faltaSecao(s), (m) => m.faltaSecaoCorrecao));
         }
     }
     const texto = semCodigo(d.corpo);
-    for (const m of texto.matchAll(/\[(\.\.\.|[^\]\n]{1,60})\](?!\()/g)) {
-        achados.push(erro(d.arquivo, d.id, 'docs.modelo', `campo do modelo não preenchido: [${m[1]}]`, 'preencha, ou escreva "A definir — responsável, prazo" / "Não aplicável — motivo"'));
+    for (const [, campo] of texto.matchAll(/\[(\.\.\.|[^\]\n]{1,60})\](?!\()/g)) {
+        achados.push(erro(d.arquivo, d.id, 'docs.modelo', (m) => m.campoDoModelo(campo), (m) => m.campoDoModeloCorrecao));
     }
     for (const p of texto.split(/\n\s*\n/)) {
         const bloco = p.trim();
         if (!bloco || /^(#|>|\||[-*+] |\d+\. |<!--)/.test(bloco))
             continue;
         if (bloco.length > exports.LIMITE_DO_PARAGRAFO) {
-            achados.push(aviso(d.arquivo, d.id, 'docs.leitura.paragrafo', `parágrafo com ${bloco.length} caracteres`, 'quebre em tópicos: uma ideia por linha'));
+            achados.push(aviso(d.arquivo, d.id, 'docs.leitura.paragrafo', (m) => m.paragrafoLongo(bloco.length), (m) => m.paragrafoLongoCorrecao));
         }
     }
 }
@@ -489,36 +502,36 @@ function verificarFontes(raiz, d, comandos, achados) {
     if (f === undefined || f === null)
         return;
     if (!ehMapa(f)) {
-        achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', 'fontes é um mapa (codigo, testes, simbolos, contratos, comandos)'));
+        achados.push(erro(d.arquivo, d.id, 'docs.frontmatter.valor', (m) => m.fontesNaoMapa));
         return;
     }
     const existe = (p) => fs.existsSync(path.join(raiz, p));
     for (const chave of ['codigo', 'testes', 'docs']) {
         for (const p of lista(f[chave])) {
             if (path.isAbsolute(p) || p.split('/').includes('..')) {
-                achados.push(erro(d.arquivo, d.id, 'docs.paridade.fonte', `${p}: caminho fora do repositório`, 'use caminho relativo à raiz'));
+                achados.push(erro(d.arquivo, d.id, 'docs.paridade.fonte', (m) => m.caminhoFora(p), (m) => m.caminhoForaCorrecao));
             }
             else if (!existe(p)) {
-                achados.push(erro(d.arquivo, d.id, 'docs.paridade.fonte', `${p} não existe no repositório`, 'a doc descreve o código que existe: corrija o caminho ou a página'));
+                achados.push(erro(d.arquivo, d.id, 'docs.paridade.fonte', (m) => m.caminhoNaoExiste(p), (m) => m.caminhoNaoExisteCorrecao));
             }
         }
     }
     for (const s of lista(f.simbolos)) {
         const [arq, simbolo] = s.split('#');
         if (!arq || !simbolo) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', `símbolo "${s}" fora do formato arquivo#nome`));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', (m) => m.simboloForaDoFormato(s)));
         }
         else if (!existe(arq)) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', `${arq} não existe (símbolo ${simbolo})`));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', (m) => m.arquivoDoSimbolo(arq, simbolo)));
         }
         else if (!new RegExp(`\\b${escapar(simbolo)}\\b`).test(fs.readFileSync(path.join(raiz, arq), 'utf8'))) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', `${simbolo} não aparece em ${arq}`, 'o código mudou de nome ou a página ficou para trás'));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.simbolo', (m) => m.simboloAusente(simbolo, arq), (m) => m.simboloAusenteCorrecao));
         }
     }
     const codigo = lista(f.codigo).filter(existe).map((p) => fs.readFileSync(path.join(raiz, p), 'utf8'));
     for (const c of lista(f.contratos)) {
         if (!codigo.some((t) => t.includes(c))) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.contrato', `o contrato ${c} não aparece nos arquivos de fontes.codigo`));
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.contrato', (m) => m.contratoAusente(c)));
         }
     }
     if (comandos) {
@@ -530,7 +543,8 @@ function verificarFontes(raiz, d, comandos, achados) {
             const temSubcomandos = [...comandos].some((c) => c.startsWith(`${topo} `));
             const exigePar = temSubcomandos && /^[a-z][a-z-]*$/.test(sub);
             if (!comandos.has(topo) || (exigePar && !comandos.has(`${topo} ${sub}`))) {
-                achados.push(erro(d.arquivo, d.id, 'docs.paridade.comando', `o CLI não declara "${[programa, topo, sub].join(' ').trim()}"`, 'confira `ork --help`: a doc descreve o CLI que existe'));
+                const comando = [programa, topo, sub].join(' ').trim();
+                achados.push(erro(d.arquivo, d.id, 'docs.paridade.comando', (m) => m.comandoAusente(comando), (m) => m.comandoAusenteCorrecao));
             }
         }
     }
@@ -546,26 +560,28 @@ function verificarEstadoDoRoadmap(raiz, d, base, achados) {
     const [ciclo, codigo, testes, deploy] = [e.ciclo, e.codigo, e.testes, e.deploy].map((v) => String(v ?? ''));
     // Coerencia entre dimensoes (padrao 3.6): o status nao pode esconder o que falta.
     if (ciclo === 'Concluído' && codigo !== 'Mesclado') {
-        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', 'ciclo Concluído com código que não está Mesclado'));
+        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', (m) => m.concluidoSemMerge));
     }
     if (ciclo === 'Concluído' && testes !== 'Aprovados') {
-        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', 'ciclo Concluído com testes que não estão Aprovados'));
+        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', (m) => m.concluidoSemTestes));
     }
     if (deploy === 'Produção' && codigo !== 'Mesclado') {
-        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', 'deploy em Produção com código que não está Mesclado'));
+        achados.push(erro(d.arquivo, d.id, 'docs.estado.coerencia', (m) => m.producaoSemMerge));
     }
     if (ciclo === 'Bloqueado' && !ehMapa(d.dados.bloqueio)) {
-        achados.push(erro(d.arquivo, d.id, 'docs.estado.bloqueio', 'Bloqueado exige o mapa "bloqueio"', 'bloqueio: motivo, dependencia, responsavel, proxima_revisao'));
+        achados.push(erro(d.arquivo, d.id, 'docs.estado.bloqueio', (m) => m.bloqueadoSemMapa, (m) => m.bloqueadoSemMapaCorrecao));
     }
     if (codigo === 'Mesclado' && !commit) {
-        achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', 'código Mesclado sem o commit do merge', 'preencha evidencias.codigo.commit (ork docs sincronizar faz isso a partir do ledger e do git)'));
+        achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', (m) => m.mescladoSemCommit, (m) => m.mescladoSemCommitCorrecao));
     }
     if (commit && base) {
-        if (!git(raiz, ['cat-file', '-e', `${commit}^{commit}`]).ok) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', `o commit ${commit} não existe neste repositório`));
+        // RM-047: o commit vem do frontmatter do clone; só sha hexadecimal vai ao git.
+        if (!(0, branch_de_estado_1.shaValido)(commit) || !git(raiz, ['cat-file', '-e', `${commit}^{commit}`]).ok) {
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', (m) => m.commitInexistente(commit)));
         }
         else if (codigo === 'Mesclado' && !git(raiz, ['merge-base', '--is-ancestor', commit, base]).ok) {
-            achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', `o commit ${commit} não está na ${base}: o merge não aconteceu`, 'volte o estado.codigo para "PR aberto" ou "Branch criada" até o merge'));
+            const naBase = base;
+            achados.push(erro(d.arquivo, d.id, 'docs.paridade.git', (m) => m.commitForaDaBase(commit, naBase), (m) => m.commitForaDaBaseCorrecao));
         }
     }
 }
@@ -581,9 +597,7 @@ function verificarMergeDaThread(raiz, d, base, achados, pr = false) {
     if (!pendente)
         return;
     const { thread, merges, codigo } = pendente;
-    achados.push((pr ? aviso : erro)(d.arquivo, d.id, 'docs.paridade.merge', `a thread ${thread} entrou na ${base} pelo merge ${merges[0].slice(0, 7)} (ship(${thread})), e o estado.codigo diz "${codigo || 'vazio'}"` +
-        (pr ? ' (no PR, aviso: o push da main reprova)' : ''), `abra um PR de docs sobre a ${base} atualizada com ork docs sincronizar --escrever --so ${d.id} (o item e os índices); ` +
-        `se o item tem outra fatia em curso, aponte sdlc.thread para a thread dela`));
+    achados.push((pr ? aviso : erro)(d.arquivo, d.id, 'docs.paridade.merge', (m) => m.mergeDaThread(thread, base, merges[0].slice(0, 7), codigo, pr), (m) => m.mergeDaThreadCorrecao(base, d.id)));
 }
 /**
  * A regra do `docs.paridade.merge`, isolada para o `ork ship registrar-pr` (RM-044, A3): a pagina cujo
@@ -650,34 +664,33 @@ function verificarIndices(raiz, docs, achados, pr = false) {
             continue;
         if (atual === '') {
             if (docs.length > 0) {
-                achados.push(aviso(arquivo, undefined, 'docs.paridade.indice', 'o índice ainda não foi gerado', 'rode ork docs sincronizar --escrever'));
+                achados.push(aviso(arquivo, undefined, 'docs.paridade.indice', (m) => m.indiceNaoGerado, (m) => m.indiceNaoGeradoCorrecao));
             }
         }
         else if (atual !== gerar(docs)) {
-            achados.push((pr ? aviso : erro)(arquivo, undefined, 'docs.paridade.indice', `o índice diverge do frontmatter das páginas${pr ? ' (no PR, aviso: o push da main reprova)' : ''}`, 'o índice é gerado do frontmatter: rode ork docs sincronizar --escrever e commite o índice'));
+            achados.push((pr ? aviso : erro)(arquivo, undefined, 'docs.paridade.indice', (m) => m.indiceDiverge(pr), (m) => m.indiceDivergeCorrecao));
         }
     }
 }
 // --------------------------------------------------------------------------------------------
 // Saida para humano (TDAH) e para agente
+/** O texto da verificacao, no locale ativo; a mensagem e a correcao de cada achado sao remontadas (G4 da F3b). */
 function textoDaVerificacao(docs, achados) {
+    const m = (0, locale_1.msg)().docs;
     const conta = (t) => docs.filter((d) => d.tipo === t).length;
     const erros = achados.filter((a) => a.gravidade === 'erro');
     const avisos = achados.filter((a) => a.gravidade === 'aviso');
     const L = [];
-    L.push(`Documentação: ${docs.length} páginas — ${conta('feature')} features, ${conta('roadmap')} itens de roadmap, `
-        + `${conta('plataforma') + conta('sistema') + conta('modulo')} de contexto`);
-    L.push(erros.length === 0
-        ? `OK: nenhum erro de paridade${avisos.length ? ` · ${avisos.length} aviso(s) de leitura` : ''}`
-        : `REPROVADO: ${erros.length} erro(s)${avisos.length ? ` · ${avisos.length} aviso(s)` : ''}`);
-    for (const [titulo, grupo] of [['Erros', erros], ['Avisos', avisos]]) {
+    L.push(m.resumo(docs.length, conta('feature'), conta('roadmap'), conta('plataforma') + conta('sistema') + conta('modulo')));
+    L.push(erros.length === 0 ? m.semErro(avisos.length) : m.reprovado(erros.length, avisos.length));
+    for (const [titulo, grupo] of [[m.tituloErros, erros], [m.tituloAvisos, avisos]]) {
         if (grupo.length === 0)
             continue;
         L.push('', titulo);
         for (const a of grupo) {
-            L.push(`  ${(a.id ?? a.arquivo).padEnd(9)} ${a.mensagem}`);
+            L.push(`  ${(a.id ?? a.arquivo).padEnd(9)} ${(0, locale_1.remontar)(a.mensagem)}`);
             if (a.correcao)
-                L.push(`  ${''.padEnd(9)} → ${a.correcao}`);
+                L.push(`  ${''.padEnd(9)} → ${(0, locale_1.remontar)(a.correcao)}`);
         }
     }
     return L.join('\n');
@@ -755,7 +768,7 @@ function mergeDaThread(raiz, thread, base) {
     try {
         const eventos = (0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, thread));
         const ship = eventos.filter((e) => e.tipo === 'ship_done' && typeof e.mergeSha === 'string')
-            .find((e) => git(raiz, ['merge-base', '--is-ancestor', String(e.mergeSha), base]).ok);
+            .find((e) => (0, branch_de_estado_1.shaValido)(e.mergeSha) && (0, branch_de_estado_1.branchValida)(base) && git(raiz, ['merge-base', '--is-ancestor', e.mergeSha, base]).ok);
         if (ship)
             return { sha: String(ship.mergeSha).slice(0, 7), fonte: 'ledger ship_done' };
     }
@@ -773,6 +786,9 @@ function mergesDaThreadNoGit(raiz, thread, base) {
     // Sem `-n 1`: o git corta antes de inverter, e `--reverse -n 1` devolveria o mais recente.
     // GO-FIX 2 (achado 4 do CHECK): so a linha de primeiro pai da base e o assunto que COMECA com
     // `ship(<thread>)`, como no `mergeDaEntrega`. Commit que cita o merge no corpo, ou o Revert dele, nao e merge.
+    // RM-047 (fronteira de confiança): a base pode ser o `worktree.base_branch` cru do clone.
+    if (!(0, branch_de_estado_1.branchValida)(base))
+        return [];
     const log = git(raiz, ['log', base, '--first-parent', '--reverse', '--format=%H%x09%s', '--fixed-strings', `--grep=ship(${thread})`]);
     if (!log.ok)
         return [];
@@ -929,18 +945,18 @@ function tabelaDoProduto(docs) {
     }
     return L.join('\n');
 }
+/** O texto da sincronizacao, no locale ativo; o campo e os valores de cada mudanca sao dado e so a impressao os traduz. */
 function textoDaSincronizacao(r, escreveu) {
+    const m = (0, locale_1.msg)().docs;
     const L = [];
-    const ids = new Set(r.mudancas.map((m) => m.id));
-    L.push(r.mudancas.length === 0 && r.indices.length === 0
-        ? 'Sincronizado: a documentação já bate com o ledger e o git.'
-        : `${escreveu ? 'Atualizado' : 'A atualizar'}: ${ids.size} item(ns) de roadmap, ${r.indices.length} índice(s).`);
-    for (const m of r.mudancas)
-        L.push(`  ${m.id.padEnd(7)} ${m.campo}: ${m.de || '—'} → ${m.para}  (${m.fonte})`);
+    const ids = new Set(r.mudancas.map((x) => x.id));
+    L.push(r.mudancas.length === 0 && r.indices.length === 0 ? m.sincronizado : m.aAtualizar(escreveu, ids.size, r.indices.length));
+    for (const x of r.mudancas)
+        L.push(m.linhaDaMudanca(x.id, x.campo, x.de, x.para, x.fonte));
     for (const i of r.indices)
-        L.push(`  índice  ${i}`);
+        L.push(m.indice(i));
     if (!escreveu && (r.mudancas.length || r.indices.length))
-        L.push('', 'Nada foi gravado. Para gravar: ork docs sincronizar --escrever');
+        L.push('', m.nadaGravado);
     return L.join('\n');
 }
 // --------------------------------------------------------------------------------------------
@@ -954,16 +970,21 @@ const ARQUIVOS_DO_PADRAO = [
     ['roadmap/README.md', `${exports.DIR_ROADMAP}/README.md`],
     ['markdownlint-cli2.jsonc', '.markdownlint-cli2.jsonc'],
 ];
-function dirDosModelos() {
-    for (const c of [path.join(__dirname, '..', 'assets', 'docs'), path.join(__dirname, '..', '..', 'assets', 'docs')]) {
+/**
+ * A pasta dos modelos do nucleo na lingua pedida. RM-061 (F3a, D3 e D6): o ingles mora em `assets/docs-en/`, com os
+ * mesmos nomes; o contrato que o `ork docs verificar` le (frontmatter, secoes, `Em uma frase`) e o mesmo nas duas.
+ */
+function dirDosModelos(locale = locale_1.LOCALE_PADRAO) {
+    const pasta = locale === 'en' ? 'docs-en' : 'docs';
+    for (const c of [path.join(__dirname, '..', 'assets', pasta), path.join(__dirname, '..', '..', 'assets', pasta)]) {
         if (fs.existsSync(c))
             return c;
     }
-    throw new Error('docs.modelos: assets/docs do nucleo nao encontrado');
+    throw new Error(`docs.modelos: assets/${pasta} do nucleo nao encontrado`);
 }
-/** Cria o que falta; nunca sobrescreve pagina existente. Devolve o que criou. */
-function iniciarDocs(raiz) {
-    const origem = dirDosModelos();
+/** Cria o que falta, no `locale` pedido (pt-BR por omissao); nunca sobrescreve pagina existente. Devolve o que criou. */
+function iniciarDocs(raiz, locale = locale_1.LOCALE_PADRAO) {
+    const origem = dirDosModelos(locale);
     const criados = [];
     for (const [de, para] of ARQUIVOS_DO_PADRAO) {
         const destino = path.join(raiz, para);