@orkastery/cli 0.5.3 → 0.5.6

package/dist/agents-md.js

@@ -39,42 +39,51 @@ exports.atualizarAgentsMd = atualizarAgentsMd;
 /** Bloco de instrucoes do Orkastery em AGENTS.md, preservando todo texto humano. */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const locale_1 = require("./locale");
 const util_1 = require("./util");
 exports.INICIO_AGENTS_ORK = '<!-- orkastery:begin -->';
 exports.FIM_AGENTS_ORK = '<!-- orkastery:end -->';
 function seguro(valor) {
     return valor.replace(/[\r\n\0`]+/g, ' ').trim();
 }
-function blocoAgentsMd(manifesto) {
+/**
+ * O bloco do `ork init` no `AGENTS.md`. RM-061 (F3a, D1 e D2): o texto sai na lingua pedida, pela familia `gerados`
+ * do catalogo; os marcadores, o titulo e as verificacoes do manifesto sao os mesmos nas duas linguas. Sem locale,
+ * pt-BR: so o `ork init` passa a lingua do dono.
+ */
+function blocoAgentsMd(manifesto, locale = locale_1.LOCALE_PADRAO) {
+    const t = (0, locale_1.msg)(locale).gerados.agents;
     const comandos = Object.entries(manifesto.verify)
         .filter((item) => typeof item[1] === 'string' && item[1].trim() !== '')
         .map(([nome, comando]) => `- ${seguro(nome)}: \`${seguro(comando)}\``);
+    const modos = manifesto.conduction.allowed_modes.map(m => `#${m[0].toUpperCase()}${m.slice(1)}`).join(', ');
     return `${exports.INICIO_AGENTS_ORK}
 ## Orkastery
 
-Projeto: **${seguro(manifesto.project.name)}** (${seguro(manifesto.project.abbrev)}). Branch base: \`${seguro(manifesto.worktree.base_branch)}\`.
+${t.projeto(seguro(manifesto.project.name), seguro(manifesto.project.abbrev), seguro(manifesto.worktree.base_branch))}
 
-- Comece com \`ork doctor\`, \`ork onboarding\` e \`ork thread status <thread>\`.
-- Conduza o ciclo GOAL → PLAN → GO → CHECK → SHIP → MASTER pelo \`ork\`.
-- Respeite o modo da thread: ${manifesto.conduction.allowed_modes.map(m => `#${m[0].toUpperCase()}${m.slice(1)}`).join(', ')}.
-- Edite produto somente na worktree vinculada; estado em \`.orkastery/\` pertence ao núcleo.
-- PLAN não implementa. GO usa commits atômicos. CHECK não corrige. SHIP acontece por \`ork ship\`.
-- Toda alegação exige claim e comando reproduzível; self-report não é evidência.
-- MASTER por omissão só da sua thread: \`ork master <thread> --aceitar-omissao\`; sem a thread, fecha também as entregas de outras frentes.
-${comandos.length ? `\nVerificações do manifesto:\n\n${comandos.join('\n')}\n` : ''}
-Este bloco é mantido por \`ork init\`. Edite livremente o restante do arquivo.
+- ${t.comece}
+- ${t.ciclo}
+- ${t.modo(modos)}
+- ${t.worktree}
+- ${t.fases}
+- ${t.claims}
+- ${t.master}
+${comandos.length ? `\n${t.verificacoes}\n\n${comandos.join('\n')}\n` : ''}
+${t.rodape}
 ${exports.FIM_AGENTS_ORK}`;
 }
-/** Cria ou substitui somente o bloco delimitado. Marcadores ambiguos recusam sem escrita. */
-function atualizarAgentsMd(raiz, manifesto) {
+/** Cria ou substitui somente o bloco delimitado, no `locale` pedido. Marcadores ambiguos recusam sem escrita. */
+function atualizarAgentsMd(raiz, manifesto, locale = locale_1.LOCALE_PADRAO) {
     const caminho = path.join(raiz, 'AGENTS.md');
     const anterior = fs.existsSync(caminho) ? fs.readFileSync(caminho, 'utf8') : '';
     const inicios = anterior.split(exports.INICIO_AGENTS_ORK).length - 1;
     const fins = anterior.split(exports.FIM_AGENTS_ORK).length - 1;
     if (inicios !== fins || inicios > 1 || (inicios === 1 && anterior.indexOf(exports.INICIO_AGENTS_ORK) > anterior.indexOf(exports.FIM_AGENTS_ORK))) {
-        throw new Error('AGENTS.md possui marcadores Orkastery ambiguos; corrija o bloco antes de rodar ork init');
+        // RM-061 (F3a): a recusa sai no locale do comando, remontada pela entrada do CLI (D14 da F2a).
+        throw new locale_1.ErroDoCatalogo((m) => m.gerados.agents.marcadoresAmbiguos);
     }
-    const bloco = blocoAgentsMd(manifesto);
+    const bloco = blocoAgentsMd(manifesto, locale);
     const proximo = inicios === 1
         ? anterior.slice(0, anterior.indexOf(exports.INICIO_AGENTS_ORK)) + bloco + anterior.slice(anterior.indexOf(exports.FIM_AGENTS_ORK) + exports.FIM_AGENTS_ORK.length)
         : anterior === '' ? bloco + '\n' : anterior + (anterior.endsWith('\n') ? '\n' : '\n\n') + bloco + '\n';

package/dist/auditrun.js

@@ -51,6 +51,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PACK_DA_SUPERFICIE = exports.VERSAO_DA_RODADA = void 0;
 exports.dirAuditorias = dirAuditorias;
 exports.dirRodada = dirRodada;
+exports.exigirIdDeRodada = exigirIdDeRodada;
 exports.caminhoRodada = caminhoRodada;
 exports.listarRodadas = listarRodadas;
 exports.lerRodada = lerRodada;
@@ -76,6 +77,7 @@ const adapter = __importStar(require("./adapters/claude-bg"));
 const auditoria_1 = require("./auditoria");
 const phase_1 = require("./phase");
 const policies_1 = require("./policies");
+const projeto_alvo_1 = require("./projeto-alvo");
 const manifest_1 = require("./manifest");
 const ledger_1 = require("./ledger");
 const divida_1 = require("./divida");
@@ -93,7 +95,17 @@ function dirAuditorias(raiz) {
 }
 /** Diretorio de uma rodada. */
 function dirRodada(raiz, id) {
-    return path.join(dirAuditorias(raiz), id);
+    return path.join(dirAuditorias(raiz), exigirIdDeRodada(id));
+}
+/**
+ * RM-047 (fronteira de confiança): o id da rodada vira nome de pasta e de relatório, e o `run.json` que o
+ * traz pode ter vindo do clone. Um segmento só, como o que `novoIdDeRodada` gera, sem `/` nem `..`.
+ */
+function exigirIdDeRodada(id) {
+    if (typeof id !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(id) || id.includes('..')) {
+        throw new Error(`audit.rodada-invalida: id de rodada ${JSON.stringify(String(id)).slice(0, 60)} não é um nome simples`);
+    }
+    return id;
 }
 /** Caminho do `run.json` da rodada. */
 function caminhoRodada(raiz, id) {
@@ -372,6 +384,9 @@ function rodarAuditoria(carregado, pack, opcoes = {}) {
         cwd: raiz,
         model: base.custo.model,
         effort,
+        // RM-052 (fatia 2, D2, aviso A1 do CHECK): a sessao da auditoria roda na raiz do projeto e le o
+        // projeto pelo proprio cwd; o `ORK_PROJETO` e o modo host de quem chamou (ou do daemon) nao a seguem.
+        ambienteExtra: { ...projeto_alvo_1.AMBIENTE_SEM_PROJETO_HERDADO },
     });
     if (!resultado.ok || !resultado.sessionId) {
         const rodada = {
@@ -724,7 +739,7 @@ function relatorioDaRodada(carregado, rodadaId, opcoes = {}) {
     (0, util_1.gravar)(caminho, texto);
     let publicado = null;
     if (opcoes.publicar) {
-        publicado = path.join(raiz, 'docs', 'audit', `${rodada.id}.md`);
+        publicado = path.join(raiz, 'docs', 'audit', `${exigirIdDeRodada(rodada.id)}.md`);
         (0, util_1.gravar)(publicado, texto);
     }
     rodada.status = 'relatada';

package/dist/board.js

@@ -71,6 +71,7 @@ const util_1 = require("./util");
 const sessoes_adopt_1 = require("./sessoes-adopt");
 const horario_1 = require("./horario");
 const conducao_1 = require("./conducao");
+const locale_1 = require("./locale");
 const conducao_texto_1 = require("./conducao-texto");
 /**
  * Perfis detectados no projeto.
@@ -316,8 +317,8 @@ function planejar(carregado, opcoes = {}) {
                 situacao: 'espera',
                 motivo: 'vaga.stale',
                 detalhe: oc.detalhe,
-                correcao: `redespache com ork phase run ${t.id} --fase ${t.faseAtual}, ` +
-                    `ou feche com ork master ${t.id}`,
+                // RM-061 (F2b, G2): o pulse mostra esta correcao nas acoes automaticas e a remonta no locale.
+                correcao: (0, locale_1.textoDoCatalogo)((m) => m.pulse.vagaStaleCorrecao(t.id, t.faseAtual)),
                 leases: meus,
             });
             continue;
@@ -347,7 +348,7 @@ function planejar(carregado, opcoes = {}) {
                 situacao: 'espera',
                 motivo: 'concurrency.limite',
                 detalhe: `a maquina ja tem ${ocupadas} thread(s) em andamento, o limite e ${max}`,
-                correcao: 'espere uma thread liberar, ou suba concurrency.max_parallel_threads no orkastery.yaml',
+                correcao: (0, locale_1.textoDoCatalogo)((m) => m.pulse.limiteCorrecao),
                 leases: [],
             });
             continue;

package/dist/branch-de-estado.js

@@ -33,11 +33,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.refRemota = exports.remotoValido = exports.REMOTO_DO_GIT = void 0;
+exports.refRemota = exports.shaValido = exports.remotoValido = exports.REMOTO_DO_GIT = void 0;
 exports.git = git;
 exports.exigirGit = exigirGit;
 exports.remotoRedigido = remotoRedigido;
 exports.exigirRemoto = exigirRemoto;
+exports.branchValida = branchValida;
 exports.pontaLocal = pontaLocal;
 exports.buscarBranch = buscarBranch;
 exports.jsonsDaPonta = jsonsDaPonta;
@@ -107,6 +108,27 @@ function exigirRemoto(remoto, prefixo) {
         '(letras, dígitos, ".", "_", "-" e "/" entre partes, cada parte começando por letra ou dígito, sem URL); nada foi passado ao git. ' +
         'Corrija fabrica.remoto no orkastery.yaml ou --remoto (padrão: origin).');
 }
+/**
+ * RM-047 (fronteira de confiança): nome de branch que pode ir ao git como argumento. O valor vem do
+ * `worktree.base_branch` do manifesto, do campo `para` do ledger ou do frontmatter, e todos podem ser
+ * do clone: um nome que começa com `-` viraria opção do git (`--output=<arquivo>` grava arquivo).
+ * A regra é a do `git check-ref-format --branch`, então nenhum nome que o git aceite é recusado.
+ */
+function branchValida(branch) {
+    if (typeof branch !== 'string' || branch.length === 0 || branch.length > 255)
+        return false;
+    if (branch.startsWith('-') || branch === '@' || branch.includes('..') || branch.includes('@{'))
+        return false;
+    // eslint-disable-next-line no-control-regex
+    if (/[\x00-\x20\x7f~^:?*[\\]/.test(branch))
+        return false;
+    if (branch.startsWith('/') || branch.endsWith('/') || branch.includes('//') || branch.endsWith('.'))
+        return false;
+    return branch.split('/').every((parte) => !parte.startsWith('.') && !parte.endsWith('.lock'));
+}
+/** Sha hexadecimal (abreviado ou inteiro, SHA-1 ou SHA-256): o único formato de commit lido do ledger que vai ao git. */
+const shaValido = (sha) => typeof sha === 'string' && /^[0-9a-f]{7,64}$/i.test(sha);
+exports.shaValido = shaValido;
 const refRemota = (remoto, branch) => `refs/remotes/${remoto}/${branch}`;
 exports.refRemota = refRemota;
 /** A ultima copia lida da branch nesta maquina, sem rede. `null` quando nunca foi lida. */

package/dist/catalogo.js

@@ -45,6 +45,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUCKETS = void 0;
 exports.raizDoCatalogo = raizDoCatalogo;
 exports.exigirCatalogo = exigirCatalogo;
+exports.catalogoDoPacote = catalogoDoPacote;
+exports.exigirCatalogoDoPacote = exigirCatalogoDoPacote;
 exports.cliDoCatalogo = cliDoCatalogo;
 exports.skillsDoCatalogo = skillsDoCatalogo;
 exports.referenciasDoCatalogo = referenciasDoCatalogo;
@@ -83,6 +85,37 @@ function exigirCatalogo(inicial) {
     }
     return raiz;
 }
+/** A raiz do catálogo do pacote que está rodando: subindo a partir do próprio código, nunca do cwd. */
+function catalogoDoPacote() {
+    return subirProcurando(__dirname);
+}
+function real(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return path.resolve(p);
+    }
+}
+/**
+ * RM-047 (P4): o catálogo que o `ork eval` executa. O eval roda os canários, os hooks e o `core/dist`
+ * do catálogo, então ele só vale o do pacote que está rodando. Um diretório com `skills/`,
+ * `references/` e `eval/` achado a partir do cwd (um clone qualquer) que não seja o próprio pacote é
+ * recusado com `eval.catalogo-alheio`, com o comando que roda o eval daquele checkout de propósito.
+ */
+function exigirCatalogoDoPacote(inicial) {
+    const pacote = catalogoDoPacote();
+    if (!pacote) {
+        throw new Error('catalogo do Orkastery nao encontrado (esperado um diretorio com skills/, references/ e eval/)');
+    }
+    const doCwd = subirProcurando(inicial);
+    if (doCwd && real(doCwd) !== real(pacote)) {
+        throw new Error(`eval.catalogo-alheio: ${doCwd} tem skills/, references/ e eval/, mas nao e o pacote deste ork ` +
+            `(${pacote}). O eval executa os canarios, os hooks e o core/dist do catalogo, e so roda o do proprio pacote. ` +
+            `Para avaliar aquele checkout de proposito, rode o ork dele: node ${path.join(doCwd, 'core', 'dist', 'index.js')} eval`);
+    }
+    return pacote;
+}
 /** Os buckets do catalogo, na ordem em que o README os apresenta. */
 exports.BUCKETS = [
     'core',

package/dist/ci.js

@@ -40,6 +40,7 @@ exports.consultarCi = consultarCi;
 exports.consultarCiDoRepositorio = consultarCiDoRepositorio;
 exports.executarCi = executarCi;
 exports.arquivoDoBundle = arquivoDoBundle;
+exports.comandosDoBundle = comandosDoBundle;
 exports.lintDoBundle = lintDoBundle;
 exports.destinoDoBundle = destinoDoBundle;
 exports.prepararBundleCi = prepararBundleCi;
@@ -50,6 +51,7 @@ exports.executarBundleCi = executarBundleCi;
 const branch_de_estado_1 = require("./branch-de-estado");
 const util_1 = require("./util");
 const worktree_1 = require("./worktree");
+const procedencia_1 = require("./procedencia");
 const verify_1 = require("./verify");
 const verify_2 = require("./verify");
 const claims_1 = require("./claims");
@@ -59,6 +61,7 @@ const claim_lint_1 = require("./claim-lint");
 const integracoes_locais_1 = require("./integracoes-locais");
 const ledger_1 = require("./ledger");
 const thread_1 = require("./thread");
+const locale_1 = require("./locale");
 const MARCADORES_DE_HOST = [
     /(^|[\s;&|])\/home\//,
     /(^|[\s;&|])localhost(?=[:/\s;&|]|$)/,
@@ -138,12 +141,12 @@ function consultarCi(carregado, sha, remoto = 'origin', executor = executorPadra
     const { ci } = carregado.manifesto;
     const context = ci.context || 'ork-verify';
     if (!ci.required_for_ship)
-        return { schema: 'ork.ci-status/v1', required: false, ok: true, provider: 'github', repository: null, sha, context, state: 'disabled', url: null, detail: 'gate de CI não exigido pelo manifesto' };
+        return { schema: 'ork.ci-status/v1', required: false, ok: true, provider: 'github', repository: null, sha, context, state: 'disabled', url: null, detail: (0, locale_1.textoDoCatalogo)((m) => m.ship.ciNaoExigidoDetalhe) };
     // RM-047: o `--remoto` do `ork ci status` vem da linha de comando; so nome de remoto chega ao git.
     const remote = (0, util_1.exec)('git', ['remote', 'get-url', '--', (0, branch_de_estado_1.exigirRemoto)(remoto, 'ci')], carregado.raiz);
     const repository = remote.ok ? repositorioGitHub(remote.stdout) : null;
     if (!repository)
-        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository: null, sha, context, state: 'unavailable', url: null, detail: `remoto ${remoto} não é um repositório GitHub reconhecível` };
+        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository: null, sha, context, state: 'unavailable', url: null, detail: (0, locale_1.textoDoCatalogo)((m) => m.ship.ciRemotoNaoGithub(remoto)) };
     return consultarCiDoRepositorio(repository, sha, context, executor);
 }
 /**
@@ -153,23 +156,23 @@ function consultarCi(carregado, sha, remoto = 'origin', executor = executorPadra
 function consultarCiDoRepositorio(repository, sha, context, executor = executorPadrao) {
     const result = executor({ repository, sha, context });
     if (!result.ok)
-        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'unavailable', url: null, detail: (result.stderr || result.stdout || 'consulta ao GitHub falhou').trim().slice(0, 400) };
+        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'unavailable', url: null, detail: (result.stderr || result.stdout || (0, locale_1.textoDoCatalogo)((m) => m.ship.ciConsultaFalhou)).trim().slice(0, 400) };
     let payload;
     try {
         payload = JSON.parse(result.stdout);
     }
     catch {
-        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'unavailable', url: null, detail: 'GitHub devolveu uma resposta de checks inválida' };
+        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'unavailable', url: null, detail: (0, locale_1.textoDoCatalogo)((m) => m.ship.ciRespostaInvalida) };
     }
     const checks = (payload.check_runs ?? []).filter((check) => check.name === context);
     if (!checks.length)
-        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'missing', url: null, detail: `check ${context} não encontrado no commit` };
+        return { schema: 'ork.ci-status/v1', required: true, ok: false, provider: 'github', repository, sha, context, state: 'missing', url: null, detail: (0, locale_1.textoDoCatalogo)((m) => m.ship.ciSemCheck(context)) };
     const check = checks.at(-1);
     const status = check.status ?? 'unknown';
     const conclusion = check.conclusion ?? '';
     const url = check.html_url ?? '';
     const state = status !== 'completed' ? 'pending' : conclusion === 'success' ? 'success' : 'failure';
-    return { schema: 'ork.ci-status/v1', required: true, ok: state === 'success', provider: 'github', repository, sha, context, state, url: url || null, detail: state === 'success' ? 'CHECK independente verde no GitHub' : `check ${context}: ${status}/${conclusion || 'sem conclusão'}` };
+    return { schema: 'ork.ci-status/v1', required: true, ok: state === 'success', provider: 'github', repository, sha, context, state, url: url || null, detail: (0, locale_1.textoDoCatalogo)((m) => state === 'success' ? m.ship.ciVerde : m.ship.ciEstado(context, String(status), conclusion)) };
 }
 function executarCi(carregado, threadId) {
     const verify = (0, verify_1.verificar)(carregado, threadId);
@@ -202,6 +205,7 @@ function arquivoDoBundle(threadId) {
         throw new Error(`ci.bundle: "${threadId}" nao e id de thread`);
     return `${threadId}.json`;
 }
+/** Os comandos que o bundle leva ao runner; o `ork ship publicar` confere os do bundle no HEAD contra estes. */
 function comandosDoBundle(carregado) {
     return carregado.manifesto.ci.command
         ? [{ name: 'ci', command: carregado.manifesto.ci.command }]
@@ -233,7 +237,9 @@ function lintDoBundle(claims) {
  */
 function destinoDoBundle(carregado, threadId) {
     const worktree = (0, thread_1.lerThread)(carregado.raiz, threadId).worktree;
-    return worktree && fs.existsSync(worktree) ? worktree : carregado.raiz;
+    // RM-047 (P2): o bundle so e gravado na worktree registrada; outro diretorio do thread.json cai na raiz.
+    return worktree && fs.existsSync(worktree) && (0, procedencia_1.cwdLocalOuNulo)(carregado.raiz, threadId, worktree, 'thread') !== null
+        ? worktree : carregado.raiz;
 }
 function prepararBundleCi(carregado, threadId, opcoes = {}) {
     const commands = comandosDoBundle(carregado);