@orkastery/cli 0.5.3 → 0.6.0

package/dist/evalrunner.js

@@ -68,6 +68,7 @@ const path = __importStar(require("node:path"));
 const canarios_1 = require("./canarios");
 const catalogo_1 = require("./catalogo");
 const util_1 = require("./util");
+const locale_1 = require("./locale");
 /** Os tres tipos que toda skill precisa cobrir. Menos que isso e cobertura de fachada. */
 exports.TIPOS_DE_CASO = ['caminho-feliz', 'racionalizacao', 'borda'];
 /** Minimo de casos por skill, para o corpus nao virar uma linha por skill. */
@@ -147,7 +148,7 @@ function lerCasos(catalogo) {
         try {
             const lido = JSON.parse(fs.readFileSync(caminho, 'utf8'));
             if (!lido.skill || !Array.isArray(lido.casos)) {
-                falhas.push({ codigo: 'fixture-invalida', detalhe: `${nome}: esperado { skill, casos[] }` });
+                falhas.push({ codigo: 'fixture-invalida', detalhe: (0, locale_1.msg)().operacao.restante.eval.fixtureFormato(nome) });
                 continue;
             }
             arquivos.push(lido);
@@ -160,6 +161,7 @@ function lerCasos(catalogo) {
 }
 function avaliarSkill(arquivo, textoDaSkill, vistos) {
     const falhas = [];
+    const m = (0, locale_1.msg)().operacao.restante.eval;
     const skill = arquivo.skill;
     const tabelaDeDesculpas = intervaloDaTabelaDeDesculpas(textoDaSkill);
     let assercoes = 0;
@@ -167,17 +169,17 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
         falhas.push({
             codigo: 'cobertura-minima',
             skill,
-            detalhe: `${arquivo.casos.length} caso(s); o minimo do catalogo e ${exports.MINIMO_DE_CASOS}`,
+            detalhe: m.casosMinimos(arquivo.casos.length, exports.MINIMO_DE_CASOS),
         });
     }
     for (const tipo of exports.TIPOS_DE_CASO) {
         if (!arquivo.casos.some((c) => c.tipo === tipo)) {
-            falhas.push({ codigo: 'tipo-faltando', skill, detalhe: `nenhum caso do tipo "${tipo}"` });
+            falhas.push({ codigo: 'tipo-faltando', skill, detalhe: m.tipoFaltando(tipo) });
         }
     }
     for (const caso of arquivo.casos) {
         if (vistos.has(caso.id)) {
-            falhas.push({ codigo: 'id-duplicado', skill, caso: caso.id, detalhe: 'id repetido no corpus' });
+            falhas.push({ codigo: 'id-duplicado', skill, caso: caso.id, detalhe: m.idRepetido });
         }
         vistos.add(caso.id);
         if (!caso.id.startsWith(`${skill}/`)) {
@@ -185,7 +187,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                 codigo: 'id-sem-prefixo',
                 skill,
                 caso: caso.id,
-                detalhe: `o id precisa comecar com "${skill}/"`,
+                detalhe: m.idPrefixo(skill),
             });
         }
         if (caso.tipo === 'racionalizacao' && !(caso.racionalizacao ?? '').trim()) {
@@ -193,7 +195,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                 codigo: 'racionalizacao-sem-desculpa',
                 skill,
                 caso: caso.id,
-                detalhe: 'caso de racionalizacao sem o campo `racionalizacao` com a desculpa',
+                detalhe: m.racionalizacao,
             });
         }
         let ancoraForaDaTabela = false;
@@ -204,7 +206,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                     codigo: 'assercao-sem-porque',
                     skill,
                     caso: caso.id,
-                    detalhe: `assercao "${a.valor}" sem o campo \`porque\``,
+                    detalhe: m.assercaoPorque(a.valor),
                 });
             }
             let posicoes;
@@ -216,7 +218,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                     codigo: 'padrao-invalido',
                     skill,
                     caso: caso.id,
-                    detalhe: `padrao "${a.valor}" invalido: ${e.message}`,
+                    detalhe: m.padraoInvalido(a.valor, e.message),
                 });
                 continue;
             }
@@ -226,7 +228,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                         codigo: 'assercao',
                         skill,
                         caso: caso.id,
-                        detalhe: `"${a.valor}" deveria estar AUSENTE da skill e aparece ${posicoes.length}x`,
+                        detalhe: m.deveriaAusente(a.valor, posicoes.length),
                     });
                 }
                 continue;
@@ -236,7 +238,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                     codigo: 'assercao',
                     skill,
                     caso: caso.id,
-                    detalhe: `"${a.valor}" nao existe em skills/.../${skill}/SKILL.md (${a.porque})`,
+                    detalhe: m.naoExiste(a.valor, skill, a.porque),
                 });
                 continue;
             }
@@ -250,7 +252,7 @@ function avaliarSkill(arquivo, textoDaSkill, vistos) {
                 codigo: 'ancora-fora-da-tabela',
                 skill,
                 caso: caso.id,
-                detalhe: 'todas as ancoras deste caso estao dentro da tabela de racionalizacoes: a skill lista a desculpa mas nao carrega a regra que responde a ela',
+                detalhe: m.ancora,
             });
         }
     }
@@ -274,14 +276,15 @@ function rodarCanarios(catalogo, filtro) {
     const dir = dirDeFixtures(catalogo);
     const resultados = [];
     const falhas = [];
+    const m = (0, locale_1.msg)().operacao.restante.eval;
     const temGit = (0, canarios_1.gitDisponivel)();
     const nomes = fs.existsSync(dir) ? fs.readdirSync(dir).sort() : [];
     if (filtro && filtro.length === 0) {
-        falhas.push({ codigo: 'fixture-invalida', detalhe: 'filtro de canários vazio: nenhuma prova foi executada' });
+        falhas.push({ codigo: 'fixture-invalida', detalhe: m.filtroVazio });
     }
     for (const id of new Set(filtro ?? [])) {
         if (!nomes.includes(id) || !(0, canarios_1.canarioPorId)(id)) {
-            falhas.push({ codigo: 'canario-sem-executor', caso: id, detalhe: `canário solicitado ausente: ${id}` });
+            falhas.push({ codigo: 'canario-sem-executor', caso: id, detalhe: m.canarioAusente(id) });
         }
     }
     for (const nome of nomes) {
@@ -291,7 +294,7 @@ function rodarCanarios(catalogo, filtro) {
             continue;
         const caminho = path.join(dir, nome, 'caso.json');
         if (!fs.existsSync(caminho)) {
-            falhas.push({ codigo: 'fixture-invalida', detalhe: `${nome}: falta caso.json` });
+            falhas.push({ codigo: 'fixture-invalida', detalhe: m.casoAusente(nome) });
             continue;
         }
         let fixture;
@@ -304,13 +307,13 @@ function rodarCanarios(catalogo, filtro) {
         }
         const canario = (0, canarios_1.canarioPorId)(fixture.id ?? nome);
         if (fixture.id !== nome) {
-            falhas.push({ codigo: 'fixture-invalida', caso: nome, detalhe: 'id da fixture diverge do canário solicitado' });
+            falhas.push({ codigo: 'fixture-invalida', caso: nome, detalhe: m.fixtureDiverge });
             continue;
         }
         if (!canario) {
             falhas.push({
                 codigo: 'canario-sem-executor',
-                detalhe: `${nome}: nenhum executor registrado para o canario "${fixture.id ?? nome}"`,
+                detalhe: m.semExecutor(nome, fixture.id ?? nome),
             });
             continue;
         }
@@ -320,7 +323,7 @@ function rodarCanarios(catalogo, filtro) {
                 sobre: canario.sobre,
                 estado: 'unavailable',
                 divergencias: [],
-                motivo: 'git nao esta nesta maquina: o canario sai unavailable, nunca passing',
+                motivo: m.semGit,
                 observado: {},
             });
             continue;
@@ -340,7 +343,7 @@ function rodarCanarios(catalogo, filtro) {
                 falhas.push({
                     codigo: 'canario',
                     caso: `${canario.id}/${d.chave}`,
-                    detalhe: `esperado ${JSON.stringify(d.esperado)}, observado ${JSON.stringify(d.observado)}`,
+                    detalhe: m.divergencia(JSON.stringify(d.esperado), JSON.stringify(d.observado)),
                 });
             }
         }
@@ -364,7 +367,7 @@ function rodarCanarios(catalogo, filtro) {
                 falhas.push({
                     codigo: 'fixture-invalida',
                     caso: c.id,
-                    detalhe: `o canario ${c.id} existe no codigo e nao tem eval/fixtures/${c.id}/caso.json`,
+                    detalhe: m.canarioSemFixture(c.id),
                 });
             }
         }
@@ -398,7 +401,7 @@ function rodarEval(opcoes) {
                 falhas.push({
                     codigo: 'skill-sem-eval',
                     skill: skill.nome,
-                    detalhe: `skill sem eval nao entra no catalogo: falta eval/casos/${skill.nome}.json`,
+                    detalhe: (0, locale_1.msg)().operacao.restante.eval.skillSemEval(skill.nome),
                 });
             }
         }
@@ -410,7 +413,7 @@ function rodarEval(opcoes) {
                 falhas.push({
                     codigo: 'eval-sem-skill',
                     skill: arquivo.skill,
-                    detalhe: 'ha casos para uma skill que nao existe no catalogo',
+                    detalhe: (0, locale_1.msg)().operacao.restante.eval.evalSemSkill,
                 });
                 continue;
             }
@@ -435,23 +438,24 @@ function rodarEval(opcoes) {
 }
 /** Texto de `ork eval`. */
 function textoDoEval(r) {
+    const m = (0, locale_1.msg)().operacao.restante.eval;
     const linhas = [];
-    linhas.push(`ork eval, catalogo em ${r.catalogo}`);
+    linhas.push(m.titulo(r.catalogo));
     linhas.push('');
     if (r.canarios.length > 0) {
-        linhas.push('Canarios (comportamento real do nucleo, contra git de verdade)');
+        linhas.push(m.canarios);
         linhas.push('');
-        linhas.push((0, util_1.tabela)(['CANARIO', 'ESTADO', 'SOBRE'], r.canarios.map((c) => [c.id, c.estado, c.estado === 'passou' ? c.sobre : c.motivo || c.sobre])));
+        linhas.push((0, util_1.tabela)([...m.colunasCanarios], r.canarios.map((c) => [c.id, m.estados[c.estado] ?? c.estado, c.estado === 'passou' ? c.sobre : c.motivo || c.sobre])));
         linhas.push('');
     }
     if (r.skills.length > 0) {
-        linhas.push('Corpus das skills (a metade estatica: as regras que precisam existir no arquivo)');
+        linhas.push(m.skills);
         linhas.push('');
-        linhas.push((0, util_1.tabela)(['SKILL', 'CASOS', 'ASSERCOES', 'FALHAS'], r.skills.map((s) => [s.skill, String(s.casos), String(s.assercoes), String(s.falhas)])));
+        linhas.push((0, util_1.tabela)([...m.colunasSkills], r.skills.map((s) => [s.skill, String(s.casos), String(s.assercoes), String(s.falhas)])));
         linhas.push('');
     }
     if (r.falhas.length > 0) {
-        linhas.push('Falhas');
+        linhas.push(m.falhas);
         for (const f of r.falhas) {
             const onde = [f.skill, f.caso].filter(Boolean).join(' :: ');
             linhas.push(`  [${f.codigo}] ${onde}`);
@@ -461,10 +465,9 @@ function textoDoEval(r) {
     }
     const passaram = r.canarios.filter((c) => c.estado === 'passou').length;
     const indisponiveis = r.canarios.filter((c) => c.estado === 'unavailable').length;
-    linhas.push(`canarios: ${passaram}/${r.canarios.length} verdes` +
-        (indisponiveis > 0 ? ` (${indisponiveis} unavailable)` : ''));
-    linhas.push(`skills: ${r.skills.length} | casos: ${r.totalDeCasos} | assercoes: ${r.totalDeAssercoes} | falhas: ${r.falhas.length}`);
-    linhas.push('metade comportamental (o agente resiste a desculpa?): unavailable, julgada por humano ou por modelo, nunca por este runner');
-    linhas.push(r.ok ? 'VEREDITO: verde' : 'VEREDITO: vermelho');
+    linhas.push(m.resumoCanarios(passaram, r.canarios.length, indisponiveis));
+    linhas.push(m.resumoSkills(r.skills.length, r.totalDeCasos, r.totalDeAssercoes, r.falhas.length));
+    linhas.push(m.metade);
+    linhas.push(m.veredito(r.ok));
     return linhas.join('\n');
 }

package/dist/experiencia-instalacao.js

@@ -41,10 +41,14 @@ exports.aplicarExperiencia = aplicarExperiencia;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const node_crypto_1 = require("node:crypto");
+const locale_1 = require("./locale");
 exports.INICIO_EXPERIENCIA = '<!-- orkastery:experiencia:begin -->';
 exports.FIM_EXPERIENCIA = '<!-- orkastery:experiencia:end -->';
 const CONTRATO = 'ork.experiencia-install/v1';
-const LINHA_DO_DIRETORIO = /^Se ativo, leia a skill selecionada pelo campo skill no diretório (".*")\.$/;
+/** RM-061 (F3a, D8): as linguas em que o bloco e escrito e, sem recibo, reconhecido. */
+const LOCALES_DO_BLOCO = ['pt-BR', 'en'];
+/** Marca do diretorio no molde da linha: o texto antes e depois dela reconhece a linha em cada lingua. */
+const MARCA_DO_DIRETORIO = '{{diretorio}}';
 const conflito = () => { throw Error('experiencia.bloco.conflict: bloco ou recibo alterado/duplicado; preserve os arquivos e revise a instalação'); };
 /** Recusa symlinks e hardlinks em qualquer componente antes da leitura/escrita. */
 function caminhoSeguro(projeto, arquivo) {
@@ -83,18 +87,35 @@ function decodificar(s) {
     return b;
 }
 const eolDe = (b) => b.includes('\r\n') ? '\r\n' : '\n';
-/** O caminho vai relativo ao projeto: o arquivo de instruções costuma ser versionado. */
-function nucleoDoBloco(skill, eol) {
-    return Buffer.from([exports.INICIO_EXPERIENCIA,
-        '## Experiência de orquestração',
-        'Consulte `ork experiencia show --json` neste projeto. Se experience for false, não ative o pacote.',
-        `Se ativo, leia a skill selecionada pelo campo skill no diretório ${JSON.stringify(skill)}.`,
-        'As preferências são dados do núcleo; preserve gates, proveniência humana e permissões do host.',
+/**
+ * O caminho vai relativo ao projeto: o arquivo de instruções costuma ser versionado. RM-061 (F3a, D1 e D2): o texto
+ * sai na língua pedida, pela família `gerados` do catálogo; os marcadores são os mesmos nas duas línguas.
+ */
+function nucleoDoBloco(skill, eol, locale) {
+    const t = (0, locale_1.msg)(locale).gerados.experiencia;
+    return Buffer.from([exports.INICIO_EXPERIENCIA, `## ${t.titulo}`, t.consulte, t.diretorio(JSON.stringify(skill)), t.preferencias,
         exports.FIM_EXPERIENCIA, ''].join(eol));
 }
+/** O diretório escrito na linha do bloco de uma língua, ou null se a linha não é a dessa língua. */
+function diretorioDaLinha(linha, locale) {
+    const molde = (0, locale_1.msg)(locale).gerados.experiencia.diretorio(MARCA_DO_DIRETORIO);
+    const corte = molde.indexOf(MARCA_DO_DIRETORIO);
+    const antes = molde.slice(0, corte), depois = molde.slice(corte + MARCA_DO_DIRETORIO.length);
+    if (linha.length < antes.length + depois.length || !linha.startsWith(antes) || !linha.endsWith(depois))
+        return null;
+    let skill;
+    try {
+        skill = JSON.parse(linha.slice(antes.length, linha.length - depois.length));
+    }
+    catch {
+        return null;
+    }
+    return typeof skill === 'string' && !/[\r\n`]/.test(skill) ? skill : null;
+}
 /**
  * Bloco sem recibo (clone novo, `.orkastery/` apagado) só é adotado quando é exatamente o texto
- * que esta versão ou a anterior geram, com qualquer diretório; qualquer outra edição é conflito.
+ * que esta versão ou a anterior geram, com qualquer diretório e em qualquer das duas línguas (RM-061,
+ * F3a, D8); qualquer outra edição é conflito.
  */
 function reconhecerBloco(antes) {
     if (contar(antes, exports.INICIO_EXPERIENCIA) !== 1 || contar(antes, exports.FIM_EXPERIENCIA) !== 1)
@@ -108,18 +129,14 @@ function reconhecerBloco(antes) {
         fim += eol.length;
     const texto = antes.subarray(inicio, fim);
     const linha = texto.toString('utf8').split(eol)[3] ?? '';
-    const m = LINHA_DO_DIRETORIO.exec(linha);
-    let skill;
-    try {
-        skill = m ? JSON.parse(m[1]) : undefined;
-    }
-    catch {
-        return null;
-    }
-    if (typeof skill !== 'string' || /[\r\n`]/.test(skill))
-        return null;
-    const esperado = nucleoDoBloco(skill, eol);
-    if (!texto.equals(esperado) && !texto.equals(esperado.subarray(0, esperado.length - eol.length)))
+    const reconhecido = LOCALES_DO_BLOCO.some((locale) => {
+        const skill = diretorioDaLinha(linha, locale);
+        if (skill === null)
+            return false;
+        const esperado = nucleoDoBloco(skill, eol, locale);
+        return texto.equals(esperado) || texto.equals(esperado.subarray(0, esperado.length - eol.length));
+    });
+    if (!reconhecido)
         return null;
     // Uma linha em branco antes do bloco é o separador que a instalação põe depois de uma linha.
     const sep = Buffer.from(eol);
@@ -144,8 +161,11 @@ function removerBloco(antes, bloco) {
     const juncao = prefixo.length && prefixo.at(-1) !== 10 && sufixo.length ? Buffer.from(bloco.eol) : Buffer.alloc(0);
     return Buffer.concat([prefixo, juncao, sufixo]);
 }
-/** Planejamento puro em relação ao disco: dry-run e preflight usam o mesmo contrato. */
-function planejarExperiencia(projeto, host, skill) {
+/**
+ * Planejamento puro em relação ao disco: dry-run e preflight usam o mesmo contrato. O bloco sai no `locale` pedido
+ * (RM-061, F3a), pt-BR por omissão: só o `ork adapter install` passa a língua do dono (D2).
+ */
+function planejarExperiencia(projeto, host, skill, locale = locale_1.LOCALE_PADRAO) {
     projeto = fs.realpathSync(path.resolve(projeto));
     if (!['claude-code', 'codex'].includes(host))
         throw Error('experiencia.host.unsupported');
@@ -189,7 +209,7 @@ function planejarExperiencia(projeto, host, skill) {
         let separador, nucleo, anterior;
         if (antes && bloco) {
             // Atualização no lugar: o que está antes e depois do bloco, inclusive edição externa, fica.
-            nucleo = nucleoDoBloco(skill, bloco.eol);
+            nucleo = nucleoDoBloco(skill, bloco.eol, locale);
             separador = bloco.separador;
             depois = Buffer.concat([antes.subarray(0, bloco.inicio), nucleo, antes.subarray(bloco.fim)]);
             // Adotado sem recibo: se só havia o bloco, o arquivo conta como criado pelo pacote.
@@ -198,7 +218,7 @@ function planejarExperiencia(projeto, host, skill) {
         }
         else {
             const base = antes ?? Buffer.alloc(0), eol = eolDe(base);
-            nucleo = nucleoDoBloco(skill, eol);
+            nucleo = nucleoDoBloco(skill, eol, locale);
             separador = Buffer.from(base.length ? (base.at(-1) === 10 ? eol : eol + eol) : '');
             depois = Buffer.concat([base, separador, nucleo]);
             anterior = antes?.toString('base64') ?? null;