@orkastery/cli 0.5.6 → 0.6.0

package/dist/parado-no-condutor.js

@@ -33,11 +33,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTRATO_FORJA_SEM_LEITURA = exports.ghPadrao = exports.FORJA_SEM_LEITURA = exports.LIMITE_DE_RECENTES = exports.LIMITE_DE_PRS = exports.VALIDADE_DO_RETRATO_MIN = exports.LIMIAR_PARADO_NO_CONDUTOR_MIN = exports.CONTRATO_PRS = void 0;
+exports.CONTRATO_FORJA_SEM_LEITURA = exports.ghPadrao = exports.FORJA_SEM_LEITURA = exports.LIMITES_DOS_PEDIDOS = exports.LIMITE_DE_RECENTES = exports.LIMITE_DE_PRS = exports.VALIDADE_DO_RETRATO_MIN = exports.LIMIAR_PARADO_NO_CONDUTOR_MIN = exports.CONTRATO_PRS = void 0;
 exports.nomeDeCheck = nomeDeCheck;
 exports.prDaForja = prDaForja;
 exports.githubDoRemoto = githubDoRemoto;
 exports.repositorioDoRemoto = repositorioDoRemoto;
+exports.forjaDoRemotoDoPulse = forjaDoRemotoDoPulse;
 exports.lerPrsDaForja = lerPrsDaForja;
 exports.gravarRetratoDePrs = gravarRetratoDePrs;
 exports.avisarForjaSemLeitura = avisarForjaSemLeitura;
@@ -78,11 +79,18 @@ exports.entregasDoProjeto = entregasDoProjeto;
  */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process");
+const api_1 = require("./forja/api");
+const cli_1 = require("./forja/cli");
+const endereco_1 = require("./forja/endereco");
+const executor_1 = require("./forja/executor");
+const resolver_1 = require("./forja/resolver");
+const registro_1 = require("./forja/registro");
+const estado_1 = require("./forja/estado");
 const branch_de_estado_1 = require("./branch-de-estado");
 const conducao_1 = require("./conducao");
 const estado_thread_1 = require("./estado-thread");
 const forja_1 = require("./forja");
+const locale_1 = require("./locale");
 const hitl_1 = require("./hitl");
 const hitl_contract_1 = require("./hitl-contract");
 const hitl_classificacao_1 = require("./hitl-classificacao");
@@ -103,36 +111,26 @@ exports.VALIDADE_DO_RETRATO_MIN = 60;
 exports.LIMITE_DE_PRS = 200;
 /** Quantos PRs recentes (de qualquer estado) a segunda leitura pede: so para achar o mesclado e o fechado. */
 exports.LIMITE_DE_RECENTES = 100;
+const PRAZO_DO_GH_MS = 30000;
+/** Os tetos e o prazo de cada chamada da leitura de pedidos, que o adaptador de cada forja respeita. */
+exports.LIMITES_DOS_PEDIDOS = { abertos: exports.LIMITE_DE_PRS, recentes: exports.LIMITE_DE_RECENTES, candidatas: 10,
+    minimoDaConferenciaMs: 5000, prazoMs: PRAZO_DO_GH_MS };
 /** Retrato com data mais a frente do relogio do que isto nao vale (relogio adiantado ou arquivo mexido). */
 const FOLGA_DO_RELOGIO_MIN = 5;
 const ARQUIVO_DOS_PRS = 'prs.json';
-const PRAZO_DO_GH_MS = 30000;
 /** A leitura inteira da forja numa batida: cabe com folga nos 240 s que a varredura da ao subprocesso do pulse. */
 const ORCAMENTO_DA_LEITURA_MS = 60000;
-const CAMPOS_DOS_RECENTES = 'number,state,headRefName,headRefOid,baseRefName,isDraft,isCrossRepository,url,createdAt,mergedAt';
-/** RM-059 (F7, D11 da ork-rm059pista): o estado de merge do PR aberto, que a pista de entrega mostra como conflito. */
-const CAMPOS_DO_GH = `${CAMPOS_DOS_RECENTES},statusCheckRollup,mergeable`;
-/** Quantas branches candidatas a "sem PR" sao conferidas uma a uma por batida; o resto fica "PR nao lido". */
-const LIMITE_DE_CANDIDATAS = 10;
-/** A conferencia de uma candidata so comeca com este tempo de sobra no orcamento; com menos, a branch fica sem conferir. */
-const MINIMO_DA_CONFERENCIA_MS = 5000;
 /** As fases que o ciclo despacha antes da entrega: depois de um bloco que para nelas, o passo e despachar, nao publicar. */
 const FASES_ANTES_DA_ENTREGA = ['GOAL', 'PLAN', 'GO', 'CHECK'];
 /** Os modos em que a #TAG ja autoriza o push (`autorizacaoDePush`, `core/src/ship.ts`). */
 const MODOS_COM_PUSH_AUTORIZADO = ['auto', 'maestro'];
 /** RM-037 (fatia 5, A5): o que as linhas e o resumo dizem quando a forja nao tem leitura de PR. */
 exports.FORJA_SEM_LEITURA = 'forja sem leitura de PR';
-/** O ambiente do `gh`: sem cor, sem prompt e sem host ou repositorio herdados (o host vai no `--repo`). */
-function ambienteDoGh() {
-    const env = { ...process.env, GH_PROMPT_DISABLED: '1', NO_COLOR: '1', CLICOLOR: '0', CLICOLOR_FORCE: '0' };
-    delete env.GH_HOST;
-    delete env.GH_REPO;
-    delete env.GH_FORCE_TTY;
-    return env;
-}
 const ghPadrao = (args, timeoutMs) => {
-    const r = (0, node_child_process_1.spawnSync)('gh', [...args], { encoding: 'utf8', timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, env: ambienteDoGh() });
-    return { status: r.status, stdout: r.stdout ?? '', stderr: r.error ? r.error.message : (r.stderr ?? '') };
+    const r = (0, executor_1.rodarCli)({ cmd: 'gh', args, prazoMs: timeoutMs, maxBuffer: 16 * 1024 * 1024, procurarBinario: false,
+        acrescentar: { GH_PROMPT_DISABLED: '1', NO_COLOR: '1', CLICOLOR: '0', CLICOLOR_FORCE: '0' },
+        apagar: ['GH_HOST', 'GH_REPO', 'GH_FORCE_TTY'] });
+    return { status: r.status, stdout: r.stdout, stderr: r.mensagemDoErro ?? r.stderr };
 };
 exports.ghPadrao = ghPadrao;
 /** Git local sem rede escondida: clone parcial nunca busca objeto durante uma leitura daqui. */
@@ -140,6 +138,10 @@ const git = (raiz, args) => (0, util_1.exec)('git', args, raiz, 60000, { ...proc
 const SHA = /^[0-9a-f]{40}$/;
 const BRANCH = /^[A-Za-z0-9._/-]{1,200}$/;
 const REPOSITORIO = /^[A-Za-z0-9_.-]{1,100}\/[A-Za-z0-9_.-]{1,100}$/;
+/** O caminho do projeto no retrato: `dono/nome` no GitHub, o caminho completo com subgrupos no GitLab. */
+const CAMINHO_DO_PROJETO = /^[A-Za-z0-9_.-]{1,100}(?:\/[A-Za-z0-9_.-]{1,100}){1,19}$/;
+/** O caminho do projeto na forma, sem segmento `.` ou `..`. */
+const caminhoDoProjeto = (v) => CAMINHO_DO_PROJETO.test(v) && v.split('/').every((p) => p !== '.' && p !== '..');
 /** O host do GitHub Enterprise guardado no retrato: rotulos alfanumericos separados por ponto, como na forja. */
 const HOST = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/;
 /** Texto curto vindo de fora: sem controle, num teto. */
@@ -185,11 +187,13 @@ function checkDaForja(c) {
     let situacao;
     if (o.__typename === 'StatusContext' || (o.status === undefined && typeof o.state === 'string')) {
         const s = String(o.state ?? '').toUpperCase();
-        situacao = s === 'SUCCESS' ? 'verde' : s === 'FAILURE' || s === 'ERROR' ? 'vermelho' : 'pendente';
+        situacao = (0, estado_1.estadoDoCheck)('commit-status', s, null);
     }
     else {
         const status = String(o.status ?? '').toUpperCase(), conclusao = String(o.conclusion ?? '').toUpperCase();
-        situacao = status !== 'COMPLETED' ? 'pendente' : ['SUCCESS', 'NEUTRAL', 'SKIPPED'].includes(conclusao) ? 'verde' : 'vermelho';
+        // O pulse mostra o job pulado de proposito como verde, como sempre: so o gate trata `bloqueado` como nao verde.
+        const estado = (0, estado_1.estadoDoCheck)('check-run', status, conclusao);
+        situacao = estado === 'bloqueado' ? 'verde' : estado;
     }
     const concluidoEm = situacao === 'pendente' ? null : instante(o.completedAt) ?? instante(o.startedAt);
     return { check: { nome, situacao, concluidoEm }, chave, inicio: instante(o.startedAt) ?? instante(o.completedAt) ?? '' };
@@ -252,52 +256,97 @@ function repositorioDoRemoto(raiz, remoto) {
     const github = githubDoRemoto(raiz, remoto);
     return github && github.host === 'github.com' ? github.repositorio : null;
 }
+const githubResolvido = (f) => ({ tipo: 'github', host: f.host, porta: null,
+    caminhoBase: '', sshHost: null, sshPorta: null, ca: null, repo: f.repositorio,
+    origem: { tipo: 'remoto', host: 'remoto', porta: 'padrao', caminhoBase: 'padrao' } });
+/**
+ * As sondas do pulse: o GitHub pelo `gh auth status --hostname` de sempre (o host proprio em que o `gh` tem login e
+ * um GitHub Enterprise) e o GitLab pela sonda padrao (o `glab` com login no host responde o `metadata`). O `auth
+ * status` que falha por outro motivo que nao a falta de login (prazo, rede, `gh` ausente) fica em `falha`.
+ */
+function sondasDoPulse(executor, prazoMs, rodar, logins, falha) {
+    return {
+        github: (alvo) => {
+            if (alvo.caminhoBase)
+                return 'nao-responde';
+            // Com porta propria, o login se confere no `host:porta` exato, pela sonda padrao: o `--hostname` nao leva porta.
+            if (alvo.porta !== null && alvo.porta !== 443)
+                return (0, resolver_1.sondasPadrao)(rodar, logins).github(alvo);
+            const auth = executor(['auth', 'status', '--hostname', alvo.host], prazoMs);
+            if (auth.status === 0)
+                return 'responde';
+            // So a resposta de login ausente (o `gh` 2.46 diz "You are not logged into any accounts on <host>") e o estado
+            // da forja; prazo estourado, `gh` ausente ou host fora do ar sao falha desta batida.
+            if (auth.status === 1 && /\bnot logged in/i.test(`${auth.stdout}\n${auth.stderr}`)) {
+                falha.ghSemLogin = true;
+                return 'sem-login';
+            }
+            falha.gh = `gh auth status --hostname ${alvo.host} falhou (${auth.status === null ? 'sem código de saída' : `código ${auth.status}`}): ` +
+                (curto((0, hitl_1.redigirSegredos)(auth.stderr || auth.stdout || ''), 120) ?? 'sem detalhe');
+            return 'nao-responde';
+        },
+        gitlab: (alvo) => {
+            const r = (0, resolver_1.sondasPadrao)(rodar, logins).gitlab(alvo);
+            if (r === 'sem-login')
+                falha.glabSemLogin = true;
+            return r;
+        },
+    };
+}
 /**
- * RM-037 (fatia 5, A5): de onde o pulse le os PRs do remoto. O github.com, como sempre; o host proprio em que o `gh`
- * esta autenticado, que e um GitHub Enterprise (`gh auth status --hostname <host>`); ou nenhum: GitLab, caminho local,
- * ou host em que o `gh` nao tem login. Ficar sem leitura nao e falha desta batida (o "PR nao lido"): e o estado da
- * forja, que o pulse diz uma vez.
+ * De onde o pulse le os pedidos do remoto: a forja resolvida pelo bloco `forja:` do manifesto, pelo host conhecido ou
+ * pela sondagem so por CLI com login no host (nunca pelo nome do host). Ficar sem leitura (remoto sem forja, forja
+ * que nao se resolve, tipo sem a capacidade) nao e falha desta batida: e o estado da forja, que o pulse diz uma vez.
  */
-function forjaDosPrs(raiz, remoto, executor, prazoMs) {
+function forjaDosPrs(carregado, remoto, executor, prazoMs, rodar, logins, sondas) {
     // RM-047: remoto que nao e nome de remoto nao chega ao git; para o pulse, e forja sem leitura.
     if (!(0, branch_de_estado_1.remotoValido)(remoto)) {
         return { leitura: false, host: null, motivo: `o remoto ${(0, branch_de_estado_1.remotoRedigido)(remoto)} não é nome de remoto do git`, semLeitura: true };
     }
-    const url = git(raiz, ['remote', 'get-url', '--', remoto]);
+    const url = git(carregado.raiz, ['remote', 'get-url', '--', remoto]);
     if (!url.ok)
         return { leitura: false, host: null, motivo: `o remoto ${remoto} não está configurado neste checkout`, semLeitura: true };
-    const endereco = (0, forja_1.enderecoDoRemoto)(url.stdout.trim());
+    const endereco = (0, forja_1.enderecoDoRemoto)(url.stdout.trim()), lido = (0, endereco_1.lerEnderecoDoRemoto)(url.stdout.trim());
     // Caminho local, ou apelido de SSH sem dominio (`git@github-trabalho:dono/repo.git`): nao ha host para ler.
-    if (!endereco) {
+    if (!endereco || !lido) {
         return { leitura: false, host: null, motivo: `o remoto ${remoto} não tem host de forja (caminho local ou apelido de SSH)`, semLeitura: true };
     }
-    if ((0, forja_1.identidadeDaForja)(url.stdout.trim())?.tipo === 'gitlab') {
-        return { leitura: false, host: endereco.host, motivo: `a forja de ${remoto} (${endereco.host}) é um GitLab, e o ork só lê PR do GitHub`,
-            semLeitura: true };
+    const falha = {};
+    // Sem o cache de 24 h: o pulse percebe na batida seguinte a CLI que perdeu o login no host.
+    const r = (0, resolver_1.resolverForja)({ endereco: lido, manifesto: carregado.manifesto.forja, sondas: sondas ?? sondasDoPulse(executor, prazoMs, rodar, logins, falha) });
+    if (!r.ok) {
+        if (falha.gh)
+            return { leitura: false, host: endereco.host, semLeitura: false, motivo: falha.gh };
+        const erro = r.erro;
+        const motivo = erro.codigo === 'forja.desconhecida' && falha.ghSemLogin
+            ? (0, locale_1.textoDoCatalogo)((m) => falha.glabSemLogin ? m.pulse.forjaSemLoginNasDuas(endereco.host, remoto) : m.pulse.forjaSemLogin('gh', endereco.host, remoto))
+            : (0, locale_1.textoDoCatalogo)((m) => m.pulse.forjaNaoResolvida(remoto, m.forja.motivo(erro, null)));
+        return { leitura: false, host: endereco.host, semLeitura: true, motivo };
     }
-    const github = githubDoRemoto(raiz, remoto);
-    if (!github) {
+    const forja = r.valor;
+    if (forja.tipo === 'github' && !REPOSITORIO.test(forja.repo)) {
         return { leitura: false, host: endereco.host, motivo: `o remoto ${remoto} (${endereco.host}) não aponta um repositório dono/nome`,
             semLeitura: true };
     }
-    if (github.host === 'github.com')
-        return { leitura: true, ...github };
-    const auth = executor(['auth', 'status', '--hostname', github.host], prazoMs);
-    if (auth.status === 0)
-        return { leitura: true, ...github };
-    // So a resposta de login ausente (o `gh` 2.46 diz "You are not logged into any accounts on <host>") e o estado da
-    // forja; prazo estourado, `gh` ausente ou host fora do ar sao falha desta batida.
-    const semLogin = auth.status === 1 && /\bnot logged in/i.test(`${auth.stdout}\n${auth.stderr}`);
-    return { leitura: false, host: github.host, semLeitura: semLogin, motivo: semLogin
-            ? `o gh não está autenticado em ${github.host}, a forja de ${remoto}`
-            : `gh auth status --hostname ${github.host} falhou (${auth.status === null ? 'sem código de saída' : `código ${auth.status}`}): ` +
-                (curto((0, hitl_1.redigirSegredos)(auth.stderr || auth.stdout || ''), 120) ?? 'sem detalhe') };
+    if (!(0, registro_1.adaptadorDaForja)(forja.tipo).pedidosAbertos) {
+        return { leitura: false, host: endereco.host, semLeitura: true,
+            motivo: (0, locale_1.textoDoCatalogo)((m) => m.pulse.forjaSemPedidos(forja.tipo, forja.host, remoto)) };
+    }
+    return { leitura: true, forja, hostDoRemoto: endereco.host };
+}
+/**
+ * A forja do remoto como o pulse a resolve (o bloco `forja:`, o host conhecido, o cache ou a sondagem pela CLI com
+ * login), sem ler pedido nenhum: a pista a usa num host proprio, para seguir o caminho da forja certa. `erro` e a frase
+ * que a leitura dos pedidos diria.
+ */
+function forjaDoRemotoDoPulse(carregado, remoto, opcoes = {}) {
+    const lido = forjaDosPrs(carregado, remoto, opcoes.executor ?? exports.ghPadrao, PRAZO_DO_GH_MS, opcoes.rodar ?? executor_1.rodarCli, new Map(), opcoes.sondas);
+    return lido.leitura ? { ok: true, forja: lido.forja } : { ok: false, erro: lido.motivo };
 }
 /**
- * Le os PRs da base do repositorio do remoto em duas chamadas: os abertos (ate `LIMITE_DE_PRS`; e so a
- * lista deles que pode dizer "sem PR") e os recentes de qualquer estado (para achar o mesclado e o fechado).
- * O `gh` usa a autenticacao dele; nenhum token passa por aqui. RM-037 (fatia 5, A5): no GitHub Enterprise, o host
- * vai no `--repo`; forja sem leitura de PR nao chama o `gh pr list`.
+ * Le os pedidos da base do projeto pela capacidade `pedidosAbertos` da forja resolvida: os abertos (so a lista deles
+ * pode dizer "sem PR"), os recentes de qualquer estado e as candidatas que nao apareceram. A CLI usa a autenticacao
+ * dela; nenhum token passa por aqui. Forja sem leitura de pedidos nao chama CLI nenhuma alem da sondagem.
  */
 function lerPrsDaForja(carregado, opcoes = {}) {
     const lidoEm = opcoes.quando ?? new Date().toISOString();
@@ -305,79 +354,52 @@ function lerPrsDaForja(carregado, opcoes = {}) {
     const base = carregado.manifesto.worktree.base_branch;
     const orcamento = opcoes.orcamentoMs ?? ORCAMENTO_DA_LEITURA_MS, fimDaLeitura = Date.now() + orcamento;
     const resta = () => fimDaLeitura - Date.now();
-    const executor = opcoes.executor ?? exports.ghPadrao;
-    const forja = opcoes.forja ? { leitura: true, ...opcoes.forja }
-        : forjaDosPrs(carregado.raiz, remoto, executor, Math.min(PRAZO_DO_GH_MS, Math.max(1, resta())));
-    if (!forja.leitura)
-        return { ok: false, lidoEm, erro: forja.motivo, ...(forja.semLeitura ? { semLeitura: { remoto, host: forja.host } } : {}) };
-    const { host, repositorio } = forja;
-    const pedir = (args) => {
-        if (resta() <= 0)
-            return `gh pr list: orçamento de ${Math.round(orcamento / 1000)} s da leitura esgotado`;
-        const r = executor(['pr', 'list', `--repo=${host}/${repositorio}`, `--base=${base}`, ...args], Math.min(PRAZO_DO_GH_MS, resta()));
-        if (r.status !== 0) {
-            const detalhe = curto((0, hitl_1.redigirSegredos)(r.stderr || r.stdout || ''), 160) ?? 'sem detalhe';
-            return `gh pr list falhou (${r.status === null ? 'sem código de saída' : `código ${r.status}`}): ${detalhe}`;
-        }
-        try {
-            const lista = JSON.parse(r.stdout);
-            if (!Array.isArray(lista))
-                throw new Error('a resposta não é uma lista');
-            return lista;
+    const executor = opcoes.executor ?? exports.ghPadrao, rodar = opcoes.rodar ?? executor_1.rodarCli, logins = new Map();
+    const lido = opcoes.resolvida ? { leitura: true, forja: opcoes.resolvida, hostDoRemoto: null }
+        : opcoes.forja ? { leitura: true, forja: githubResolvido(opcoes.forja), hostDoRemoto: null }
+            : forjaDosPrs(carregado, remoto, executor, Math.min(PRAZO_DO_GH_MS, Math.max(1, resta())), rodar, logins, opcoes.sondas);
+    if (!lido.leitura)
+        return { ok: false, lidoEm, erro: lido.motivo, ...(lido.semLeitura ? { semLeitura: { remoto, host: lido.host } } : {}) };
+    const forja = lido.forja;
+    const lidos = (0, registro_1.exigirCapacidade)((0, registro_1.adaptadorDaForja)(forja.tipo), 'pedidosAbertos')({ forja, base, candidatas: opcoes.candidatas ?? [],
+        contexto: carregado.manifesto.ci.context || 'ork-verify',
+        api: (0, api_1.chamadorDaApi)(forja, { rodar, logins }), executor, resta, orcamentoMs: orcamento, limites: exports.LIMITES_DOS_PEDIDOS });
+    if (!lidos.ok) {
+        const erro = lidos.erro, cli = cli_1.CLI_DA_FORJA[forja.tipo].cmd;
+        // O GitHub guarda a frase de sempre do `gh pr list` (o pulse e os snapshots a fixam); as outras dizem o motivo tipado.
+        if (forja.tipo === 'github')
+            return { ok: false, lidoEm, erro: erro.detalhe };
+        // A CLI sem login no host e o estado da forja, dito uma vez, como o `gh` sem login no host proprio.
+        if (erro.codigo === 'forja.sem-login') {
+            return { ok: false, lidoEm, erro: (0, locale_1.textoDoCatalogo)((m) => m.pulse.forjaSemLogin(cli, forja.host, remoto)),
+                semLeitura: { remoto, host: lido.hostDoRemoto ?? forja.host } };
         }
-        catch (e) {
-            return `resposta do gh pr list fora do formato: ${curto((0, hitl_1.redigirSegredos)(e.message), 120) ?? 'sem detalhe'}`;
-        }
-    };
-    try {
-        const porNumero = new Map();
-        const juntar = (lista, comChecks) => {
-            for (const bruto of lista) {
-                const pr = prDaForja(bruto, base);
-                if (!pr || porNumero.has(pr.numero))
-                    continue;
-                // S-b do CHECK (rodada 3): a leitura sem rollup nunca diz que o aberto nao tem checks.
-                if (!comChecks && pr.estado === 'aberto')
-                    pr.checks = [{ nome: 'checks não lidos', situacao: 'pendente', concluidoEm: null }];
-                porNumero.set(pr.numero, pr);
-            }
-        };
-        const abertos = pedir(['--state=open', `--limit=${exports.LIMITE_DE_PRS}`, `--json=${CAMPOS_DO_GH}`]);
-        if (typeof abertos === 'string')
-            return { ok: false, lidoEm, erro: abertos };
-        juntar(abertos, true);
-        const recentes = pedir(['--state=all', `--limit=${exports.LIMITE_DE_RECENTES}`, `--json=${CAMPOS_DOS_RECENTES}`]);
-        if (typeof recentes === 'string')
-            return { ok: false, lidoEm, erro: recentes };
-        juntar(recentes, false);
-        // R1 do CHECK (rodada 3): antes de dizer "sem PR", a branch candidata e conferida sozinha (o mesclado velho
-        // fica fora dos recentes). Acima do teto da batida, a branch fica sem conferir, e isso e "PR nao lido".
-        const achadas = new Set([...porNumero.values()].map((p) => p.branch));
-        const faltam = [...new Set(opcoes.candidatas ?? [])].filter((b) => BRANCH.test(b) && !achadas.has(b));
-        const semConferir = [];
-        for (const [i, branch] of faltam.entries()) {
-            // Acima do teto da batida, sem tempo para a conferencia inteira ou com ela falhando, a candidata fica sem conferir
-            // ("PR nao lido") e o que ja foi lido vale (sugestao da seguranca na rodada 4 do CHECK).
-            if (i >= LIMITE_DE_CANDIDATAS || resta() < MINIMO_DA_CONFERENCIA_MS) {
-                semConferir.push(branch);
-                continue;
-            }
-            const daBranch = pedir(['--state=all', `--head=${branch}`, '--limit=5', `--json=${CAMPOS_DOS_RECENTES}`]);
-            try {
-                if (typeof daBranch === 'string')
-                    throw new Error(daBranch);
-                juntar(daBranch, false);
-            }
-            catch {
-                semConferir.push(branch);
-            }
-        }
-        return { ok: true, retrato: { contrato: exports.CONTRATO_PRS, lidoEm, repositorio, ...(host !== 'github.com' ? { host } : {}), base,
-                parcial: abertos.length >= exports.LIMITE_DE_PRS, ...(semConferir.length ? { semConferir } : {}), prs: [...porNumero.values()] } };
-    }
-    catch (e) {
-        return { ok: false, lidoEm, erro: `resposta do gh pr list fora do formato: ${curto((0, hitl_1.redigirSegredos)(e.message), 120) ?? 'sem detalhe'}` };
+        return { ok: false, lidoEm, erro: (0, locale_1.textoDoCatalogo)((m) => m.forja.motivo(erro, forja.tipo)) };
     }
+    return { ok: true, retrato: { contrato: exports.CONTRATO_PRS, lidoEm, repositorio: forja.repo, ...(forja.host !== 'github.com' ? { host: forja.host } : {}),
+            base, parcial: lidos.valor.parcial, ...(lidos.valor.semConferir.length ? { semConferir: lidos.valor.semConferir } : {}), prs: lidos.valor.prs } };
+}
+/**
+ * O host e o caminho do projeto no remoto, sem rede nem CLI: o que o retrato tem de bater. A resolucao roda sem
+ * sondas; sem tipo declarado e fora dos hosts conhecidos, valem o host (o declarado, senao o do remoto) e o caminho do
+ * remoto sem o caminho base.
+ */
+function forjaDoRemotoSemRede(carregado, remoto) {
+    if (!(0, branch_de_estado_1.remotoValido)(remoto))
+        return null;
+    const url = git(carregado.raiz, ['remote', 'get-url', '--', remoto]);
+    const endereco = url.ok ? (0, endereco_1.lerEnderecoDoRemoto)(url.stdout.trim()) : null;
+    if (!endereco)
+        return null;
+    const m = carregado.manifesto.forja;
+    const r = (0, resolver_1.resolverForja)({ endereco, manifesto: m, sondas: {} });
+    if (r.ok)
+        return { host: r.valor.host, repositorio: r.valor.repo };
+    if (r.erro.codigo !== 'forja.desconhecida')
+        return null;
+    const prefixo = m?.caminho_base ? `${m.caminho_base.slice(1)}/` : '';
+    return { host: m?.host ?? endereco.host,
+        repositorio: prefixo && endereco.caminho.startsWith(prefixo) ? endereco.caminho.slice(prefixo.length) : endereco.caminho };
 }
 const dirDoMonitor = (raiz) => path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'monitor');
 /** Grava o retrato de uma leitura que deu certo: arquivo novo exclusivo, so do dono, renomeado por cima. */
@@ -460,7 +482,7 @@ function lerRetratoDePrs(raiz) {
     try {
         const r = JSON.parse(fs.readFileSync(path.join(dirDoMonitor(raiz), ARQUIVO_DOS_PRS), 'utf8'));
         const lidoEm = instante(r.lidoEm);
-        if (r.contrato !== exports.CONTRATO_PRS || !lidoEm || typeof r.repositorio !== 'string' || !REPOSITORIO.test(r.repositorio) ||
+        if (r.contrato !== exports.CONTRATO_PRS || !lidoEm || typeof r.repositorio !== 'string' || !caminhoDoProjeto(r.repositorio) ||
             typeof r.base !== 'string' || typeof r.parcial !== 'boolean' || !Array.isArray(r.prs) ||
             (r.host !== undefined && !(typeof r.host === 'string' && HOST.test(r.host))) ||
             (r.semConferir !== undefined && !(Array.isArray(r.semConferir) && r.semConferir.every((b) => typeof b === 'string' && BRANCH.test(b)))))
@@ -880,7 +902,7 @@ function entregasDoProjeto(carregado, opcoes) {
     const semLeituraDaForja = !!prs && !prs.ok && !!prs.semLeitura;
     let retrato = null, semRetrato = prs && !prs.ok ? (semLeituraDaForja ? exports.FORJA_SEM_LEITURA : prs.erro) : 'sem leitura dos PRs';
     if (prs?.ok) {
-        const r = prs.retrato, atual = githubDoRemoto(raiz, remoto);
+        const r = prs.retrato, atual = forjaDoRemotoSemRede(carregado, remoto);
         // O retrato vale do mesmo host: o do GitHub Enterprise (`host`) ou, sem ele, o github.com.
         if (r.base !== baseBranch || !atual || r.repositorio !== atual.repositorio || (r.host ?? 'github.com') !== atual.host) {
             semRetrato = 'retrato de PRs de outro repositório ou base';

package/dist/phase.js

@@ -33,12 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REGRAS_DE_EVIDENCIA = exports.CONTRATO_DAS_FASES = void 0;
+exports.REGRAS_DE_EVIDENCIA = exports.REGRA_DAS_ESPERAS = exports.CONTRATO_DAS_FASES = void 0;
 exports.escolherPerfil = escolherPerfil;
 exports.perfilPedido = perfilPedido;
 exports.perfilParaDespacho = perfilParaDespacho;
 exports.runtimeCruzadoParaDespacho = runtimeCruzadoParaDespacho;
 exports.estadoParaDespacho = estadoParaDespacho;
+exports.fechoDoGo = fechoDoGo;
 exports.fasesDoCicloNoPrompt = fasesDoCicloNoPrompt;
 exports.valoresDoPrompt = valoresDoPrompt;
 exports.montarPrompt = montarPrompt;
@@ -87,6 +88,7 @@ const memoria_1 = require("./memoria");
 const prompts_1 = require("./prompts");
 const slug_1 = require("./slug");
 const locale_1 = require("./locale");
+const locale_prompts_1 = require("./locale-prompts");
 const thread_1 = require("./thread");
 const types_1 = require("./types");
 const util_1 = require("./util");
@@ -96,6 +98,7 @@ const horario_1 = require("./horario");
 const runtime_profiles_1 = require("./runtime-profiles");
 const sessoes_contas_1 = require("./sessoes-contas");
 const maquina_1 = require("./maquina");
+const trabalho_thread_1 = require("./trabalho-thread");
 const procedencia_1 = require("./procedencia");
 const postura_local_1 = require("./postura-local");
 const fabrica_publicar_1 = require("./fabrica-publicar");
@@ -269,23 +272,31 @@ function estadoParaDespacho(raiz, thread, dryRun = false) {
 }
 /** O que cada fase canonica entrega. Vai no cabecalho do prompt de toda sessao. */
 exports.CONTRATO_DAS_FASES = {
-    GOAL: 'GOAL (F1): objetivo verificavel, impact map, criterios de sucesso e claims com comando de verificacao. Nao implementa.',
-    PLAN: 'PLAN (F2): plano com tarefas, touch_paths, decisoes D1..Dn com domicilio unico e verify executavel por tarefa. Nao implementa.',
-    GO: 'GO (F3): implementacao slice por slice, um commit atomico por tarefa, dentro da worktree da thread.',
-    CHECK: 'CHECK (F4): verificacao contra a baseline (regressao versus divida pre-existente), review de codigo, testes, seguranca e performance.',
-    SHIP: 'SHIP (F5): merge serializado, push provado por comando, roadmap atualizado e plano de rollback.',
-    MASTER: 'MASTER (F6): MASTER log com postmortem tipado, licoes e o score humano de 0 a 5. Uma entrega sem MASTER log nao aconteceu.',
+    ...locale_prompts_1.PROMPTS_PT_BR.contratoDasFases,
 };
+/**
+ * RM-037 (ork-rm037esperas, D3): a regra das esperas, uma linha so, a mesma no prompt de toda fase e na skill e nos
+ * guias que o adaptador instala (`core/test/rm037-esperas.test.ts` confere os arquivos). Em 12/10/2026, sessoes de
+ * fase esperaram para sempre por verify ou suite mandados para segundo plano com `&`, cujo processo morreu com a
+ * chamada, e por lacos de espera com `pgrep -f` que acham a si mesmos, porque o proprio laco traz o texto procurado.
+ */
+exports.REGRA_DAS_ESPERAS = locale_prompts_1.PROMPTS_PT_BR.regraDasEsperas;
 /** As regras de evidencia que valem em toda fase, em todo modo. */
 exports.REGRAS_DE_EVIDENCIA = [
-    'Nada de self-report: toda alegacao vem com o comando que a comprova e a saida real.',
-    'Trabalhe apenas no diretorio de trabalho indicado acima.',
-    'Passos irreversiveis (push, merge, delecao) so acontecem quando o modo autoriza.',
+    ...locale_prompts_1.PROMPTS_PT_BR.regrasDeEvidencia,
     // RM-058 N2 (D13 da ork-rm058n2): tres sessoes de 12/10/2026 mandaram verify ou suite para segundo plano com `&`,
-    // perderam o processo e esperaram para sempre.
-    'Verify, build e suite rodam em primeiro plano, com timeout, nunca com `&` no comando: o processo em segundo plano ' +
-        'se perde e a sessao espera para sempre. O `ork verify` espera a vez na fila de recursos pesados.',
+    // perderam o processo e esperaram para sempre. RM-037 (ork-rm037esperas, D3): a linha da N2 virou a regra das
+    // esperas, que tambem traz a execucao em segundo plano do host e a espera por `pgrep -f`.
+    exports.REGRA_DAS_ESPERAS,
 ];
+/**
+ * RM-016: o rito de saída do GO pertence ao prompt canônico, não a um adaptador. Assim Claude Code
+ * e Codex recebem os mesmos artefatos obrigatórios antes de a sessão encerrar. RM-061 F3c: o texto
+ * vem do catálogo dos prompts, e o prompt inglês leva o mesmo rito.
+ */
+function fechoDoGo(threadId, locale = (0, locale_1.localeAtivo)()) {
+    return (locale === 'en' ? locale_prompts_1.PROMPTS_EN : locale_prompts_1.PROMPTS_PT_BR).fechoDoGo(threadId);
+}
 /**
  * I-42 (D11): as fases que o cabecalho do prompt descreve.
  *
@@ -308,7 +319,8 @@ function fasesDoCicloNoPrompt(thread) {
  * decisao e codigo. E o que permite um projeto reescrever o texto do prompt em
  * `prompts/fase-padrao.md` sem poder mudar o que o `ork` considera verdade.
  */
-function valoresDoPrompt(thread, fase, pedido, memoriaInjetada = '') {
+function valoresDoPrompt(thread, fase, pedido, memoriaInjetada = '', locale = (0, locale_1.localeAtivo)()) {
+    const mp = locale === 'en' ? locale_prompts_1.PROMPTS_EN : locale_prompts_1.PROMPTS_PT_BR;
     const def = (0, modos_1.definicaoDoModo)(thread.modo);
     const bloco = (0, thread_1.blocoDaThread)(thread, fase);
     const pausa = (0, thread_1.pausaNaThread)(thread, fase);
@@ -317,27 +329,29 @@ function valoresDoPrompt(thread, fase, pedido, memoriaInjetada = '') {
         thread: thread.id,
         bloco: bloco.fases.join('-'),
         nome: thread.nome,
-        ciclo_canonico: fasesDoCicloNoPrompt(thread).map((f) => `${bloco.fases.includes(f) ? '>' : ' '} ${exports.CONTRATO_DAS_FASES[f]}`).join('\n'),
+        ciclo_canonico: fasesDoCicloNoPrompt(thread).map((f) => `${bloco.fases.includes(f) ? '>' : ' '} ${mp.contratoDasFases[f]}`).join('\n'),
         tag: def.tag,
         blocos: thread.blocos.map((b) => b.fases.join('-')).join(' / '),
         pausas: String(thread.blocos.filter((b) => b.pausa).length),
-        linha_variante: thread.variante ? `Variante de ciclo: ${thread.variante}` : '',
+        linha_variante: thread.variante ? mp.variante(thread.variante) : '',
         regra_de_pausa: pausa
-            ? `Ao fim deste bloco HA PAUSA humana sobre: ${bloco.pausaSobre}. Pare, apresente a evidencia e espere o veredito.`
-            : 'Ao fim deste bloco NAO ha pausa humana: siga com decisao autonoma e registre no ledger quem decidiu, com que evidencia e por que.',
-        invariantes: modos_1.INVARIANTES.map((i) => `- ${i}`).join('\n'),
+            ? mp.pausa(mp.pausaSobre(bloco.pausaSobre))
+            : mp.semPausa,
+        invariantes: mp.invariantes.map((i) => `- ${i}`).join('\n'),
         slug: thread.slug,
         projeto_nome: thread.projeto.name,
         projeto_abbrev: thread.projeto.abbrev,
         base_branch: thread.base.branch,
         base_commit: thread.base.commit,
-        diretorio: thread.worktree ?? '(raiz do projeto)',
+        diretorio: thread.worktree ?? mp.raizDoProjeto,
+        trabalho: (0, trabalho_thread_1.caminhoDoTrabalho)(thread.id),
         pedido: pedido.trim(),
+        fecho_go: bloco.fases.includes('GO') ? mp.fechoDoGo(thread.id) : '',
         // Bloco B6: o bloco de memoria injetada deterministicamente. Vazio em toda thread sem
         // decisao fechada e sem OrkMind, e ai a linha da variavel some do prompt: o texto fica
         // byte a byte igual ao que o B4 ja despachava.
         memoria_injetada: memoriaInjetada,
-        regras_de_evidencia: exports.REGRAS_DE_EVIDENCIA.map((r) => `- ${r}`).join('\n'),
+        regras_de_evidencia: [...mp.regrasDeEvidencia, mp.regraDasEsperas].map((r) => `- ${r}`).join('\n'),
     };
 }
 /**
@@ -347,8 +361,10 @@ function valoresDoPrompt(thread, fase, pedido, memoriaInjetada = '') {
  * `prompts/fase-padrao.md` (ou `prompts/fase-goal.md` e companhia) versionado no repositorio,
  * vale o do projeto, e `ork prompt lint` e quem garante que ele nao perdeu o contrato.
  */
-function montarPrompt(thread, fase, pedido, raiz, memoriaInjetada = '') {
-    return (0, prompts_1.renderizar)((0, prompts_1.templateDaFase)(fase, raiz), valoresDoPrompt(thread, fase, pedido, memoriaInjetada));
+function montarPrompt(thread, fase, pedido, raiz, memoriaInjetada = '', locale = (0, locale_1.localeAtivo)()) {
+    // RM-061 F3c: os valores falam a lingua do template escolhido; o do projeto sem par `.en` sai inteiro em pt-BR.
+    const template = (0, prompts_1.templateDaFase)(fase, raiz, locale);
+    return (0, prompts_1.renderizar)(template, valoresDoPrompt(thread, fase, pedido, memoriaInjetada, (0, prompts_1.idiomaDoTemplate)(template)));
 }
 /**
  * Monta o prompt da fase JA com a memoria injetada (bloco B6).
@@ -359,11 +375,15 @@ function montarPrompt(thread, fase, pedido, raiz, memoriaInjetada = '') {
  * com as decisoes fechadas lidas do `thread.json`: a garantia nao depende do OrkMind.
  */
 function montarPromptComMemoria(carregado, thread, fase, pedido, memoria) {
-    const injecao = (0, memoria_1.injecaoDaFase)(carregado, memoria, thread, fase);
+    // RM-061 F3c: o prompt despachado e dado (arquivo com sha256 no ledger). Segue a lingua declarada do dono
+    // (`owner.language`), nunca o locale de quem despacha: sem ela, pt-BR, com qualquer LANG (contrato da F2a). A
+    // dica do grafo fala a lingua do template que conduz a fase, como os valores.
+    const locale = (0, prompts_1.idiomaDoTemplate)((0, prompts_1.templateDaFase)(fase, carregado.raiz, (0, locale_1.linguaDeclaradaDoDono)(carregado.manifesto.owner?.language)));
+    const injecao = (0, memoria_1.injecaoDaFase)(carregado, memoria, thread, fase, locale);
     // Mesma raiz usada pelo MCP e runtime-context; o manifesto da WT nao habilita a dica.
     const ligado = (0, mcp_grafo_1.grafoLigado)((0, manifest_1.exigirManifesto)((0, estado_thread_1.raizDoEstado)(carregado.raiz)).manifesto);
     return {
-        prompt: montarPrompt(thread, fase, (0, prompts_1.pedidoComDicaDoGrafo)(pedido, thread.id, ligado), carregado.raiz, injecao.texto),
+        prompt: montarPrompt(thread, fase, (0, prompts_1.pedidoComDicaDoGrafo)(pedido, thread.id, ligado, locale), carregado.raiz, injecao.texto, locale),
         injecao,
     };
 }
@@ -448,6 +468,8 @@ function dadosDoDespacho(ctx, comando) {
         cwd: ctx.cwd,
         promptPath: path.relative(ctx.raiz, ctx.promptPath),
         promptSha256: ctx.promptSha256,
+        ...(ctx.promptOriginal ? { promptOriginalPath: path.relative(ctx.raiz, ctx.promptOriginal.path),
+            promptOriginalSha256: ctx.promptOriginal.sha256 } : {}),
         origem: ctx.origem,
         // I-36 (T10): a porta por onde o dono chegou. `runtime` e o motor; `canal` e a porta.
         ...(ctx.canal ? { canal: ctx.canal } : {}),
@@ -566,14 +588,14 @@ function registrarObservacao(ctx, sessao, dir, controlador, sensores) {
     const mesmoDespacho = (e) => e.sessionId === sessao.sessionId && e.despachoEm === sessao.despachadaEm;
     try {
         // I-34: claude-bg observa pela fonte nativa; no PLAN o registro guarda o sha de base do artefato.
-        // I-33 (N1): o GO codex registra o HEAD do despacho, como a fonte claude-bg; sem ele a D11c nao ve commit pelo shell.
+        // I-33 (N1): o GO codex registra o HEAD do despacho, como a fonte claude-bg; ele revela commit pelo shell no checkpoint.
         const head = ctx.runtime === 'codex' && ctx.fase === 'GO' ? { head: ctx.headNoDespacho ?? null } : {};
         const fonte = ctx.runtime === 'claude-bg' ? (0, session_watcher_claude_1.fonteClaudeDoDespacho)(ctx.raiz, ctx.thread.id, ctx.fase, ctx.cwd)
             : sensores?.logPath ? { logPath: sensores.logPath, processoPath: sensores.processoPath, reciboPath: sensores.reciboPath, ...head }
                 : controlador ? { controlador, cwd: ctx.cwd, ...head } : null;
         if (!fonte)
             return;
-        (0, session_watcher_1.validarFonteWatcher)(ctx.raiz, sessao.sessionId, fonte);
+        (0, session_watcher_1.prepararFonteWatcher)(ctx.raiz, sessao.sessionId, fonte);
         const eventos = (0, ledger_1.lerLedger)(dir);
         if (!eventos.some(e => e.tipo === 'session_sensor_registered' && mesmoDespacho(e))) {
             (0, ledger_1.registrar)(dir, ctx.thread.id, 'session_sensor_registered', { fase: ctx.fase,
@@ -687,6 +709,8 @@ tomadaPrevia) {
     const thread = (0, thread_1.lerThread)(raiz, threadId);
     const fase = opcoes.fase;
     const dir = (0, thread_1.dirThread)(raiz, thread.id);
+    if (!opcoes.dryRun)
+        (0, trabalho_thread_1.garantirDiretorioDoTrabalho)(raiz, thread.id);
     const slug = slugDaSessao(thread, fase);
     // Resolve UMA vez o trio runtime/modelo/esforco: o mesmo objeto vai ao runtime adapter,
     // ao ledger e a resposta do CLI. Resolver duas vezes e o caminho curto para o ledger
@@ -1096,6 +1120,8 @@ tomadaPrevia) {
                     effort,
                     sinal,
                     detalhe: erro,
+                    // RM-058 N4 (D17 da ork-rm058n4): o pedido do despacho do arco é do vigia do arco, e o `ork retry resume` não o retoma.
+                    ...(opcoes.correlacao ? { correlacao: opcoes.correlacao } : {}),
                 });
                 (0, ledger_1.registrar)(dir, thread.id, ledger_1.TIPOS_DE_EVENTO.rateLimitEnfileirado, {
                     fase,