@orkastery/cli 0.5.3 → 0.6.0

package/dist/rede.js

@@ -33,9 +33,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RETRATO_PARADO_MS = exports.cachePronto = exports.MAXIMO_DE_ITENS = exports.refDaCasa = exports.PULSACAO_DA_REDE_MS = exports.PAINEL_DA_REDE = exports.DIR_DOS_RETRATOS = exports.BRANCH_DA_REDE = exports.CONTRATO_DO_RETRATO = void 0;
+exports.RETRATO_PARADO_MS = exports.cachePronto = exports.MAXIMO_DE_ITENS = exports.NIVEL_MINIMO_NO_GRUPO = exports.refDaCasa = exports.PULSACAO_DA_REDE_MS = exports.PAINEL_DA_REDE = exports.DIR_DOS_RETRATOS = exports.BRANCH_DA_REDE = exports.CONTRATO_DO_RETRATO = void 0;
 exports.nomeSeguro = nomeSeguro;
 exports.arquivoDoRetrato = arquivoDoRetrato;
+exports.separarRepositorio = separarRepositorio;
 exports.resolverCasa = resolverCasa;
 exports.hostnameSeguro = hostnameSeguro;
 exports.retratoDaMaquina = retratoDaMaquina;
@@ -94,6 +95,7 @@ const rede_adesao_1 = require("./rede-adesao");
 const rede_forja_1 = require("./rede-forja");
 const rede_projetos_1 = require("./rede-projetos");
 const versao_1 = require("./versao");
+const locale_1 = require("./locale");
 exports.CONTRATO_DO_RETRATO = 'ork.rede-maquina/v1';
 exports.BRANCH_DA_REDE = 'main';
 exports.DIR_DOS_RETRATOS = 'maquinas';
@@ -110,6 +112,8 @@ const BINARIO_DO_HOST = { 'claude-code': 'claude', codex: 'codex', hermes: 'herm
 const VERSAO_ESTRITA = /^\d+\.\d+(?:\.\d+)?(?:[-+][0-9A-Za-z.]{1,20})?$/;
 const refDaCasa = (c) => `${c.host}/${c.dono}/${c.repositorio}`;
 exports.refDaCasa = refDaCasa;
+/** O nivel minimo da pessoa no grupo para a casa da rede morar nele (GitLab: Maintainer). */
+exports.NIVEL_MINIMO_NO_GRUPO = 40;
 /**
  * O nome da maquina no que vai a forja: so o que o git e a forja aceitam sem surpresa. E o mesmo no
  * arquivo, no campo `maquina` do retrato, na trava e nos commits (S2 da revisao 2: o leitor recusava o
@@ -125,6 +129,11 @@ function nomeSeguro(maquina) {
 function arquivoDoRetrato(maquina) {
     return `${exports.DIR_DOS_RETRATOS}/${nomeSeguro(maquina)}.json`;
 }
+/** `--repositorio`: dono e nome pelo ULTIMO `/`, para o subgrupo do GitLab (`grupo/sub/casa`) nao ser truncado. */
+function separarRepositorio(texto) {
+    const corte = texto?.lastIndexOf('/') ?? -1;
+    return texto && corte > 0 ? [texto.slice(0, corte), texto.slice(corte + 1)] : [null, texto ?? null];
+}
 /**
  * A casa: a opcao do comando, senao a adesao gravada, senao o login da primeira forja com login.
  * Nunca lanca: sem forja ou sem login, devolve o motivo tipado.
@@ -134,21 +143,21 @@ function resolverCasa(opcoes = {}) {
     const forjas = (0, rede_forja_1.forjasDaMaquina)(amb);
     const identidades = opcoes.identidades ?? forjas.map((f) => f.identidade());
     const config = (0, rede_adesao_1.lerConfigDaRede)();
-    const [donoPedido, nomePedido] = opcoes.repositorio?.includes('/') ? opcoes.repositorio.split('/', 2) : [null, opcoes.repositorio ?? null];
+    const [donoPedido, nomePedido] = separarRepositorio(opcoes.repositorio);
     // B3: `--repositorio` sozinho troca so o repositorio; a forja gravada continua valendo.
     const nomeDaForja = opcoes.forja ?? config?.forja ?? null;
     if (!opcoes.forja && !opcoes.repositorio && config?.forja && config.dono && config.repositorio && config.host) {
         // B9: a forja da casa e a do host gravado (GitLab proprio), nao a do ambiente de quem chamou.
         const forja = (0, rede_forja_1.forjaPorNome)(config.forja, amb, config.host);
         return { casa: { forja: config.forja, host: config.host, dono: config.dono, repositorio: config.repositorio, origem: 'rede.json' },
-            forja, identidades, motivo: forja ? null : { tipo: 'forja.ausente', detalhe: `a CLI da forja ${config.forja} nao esta nesta maquina` } };
+            forja, identidades, motivo: forja ? null : { tipo: 'forja.ausente', detalhe: (0, locale_1.textoDoCatalogo)((m) => m.network.cliAusente(config.forja)) } };
     }
     // A forja gravada vale com o host gravado (GitLab proprio), mesmo quando so o repositorio muda.
     const daCasaGravada = nomeDaForja && config?.forja === nomeDaForja && config.host ? (0, rede_forja_1.forjaPorNome)(nomeDaForja, amb, config.host) : null;
     const candidatas = daCasaGravada ? [daCasaGravada] : nomeDaForja ? forjas.filter((f) => f.nome === nomeDaForja) : forjas;
     if (candidatas.length === 0) {
         return { casa: null, forja: null, identidades, motivo: { tipo: 'forja.ausente',
-                detalhe: nomeDaForja ? `a CLI da forja ${nomeDaForja} nao esta nesta maquina` : 'nenhuma CLI de forja (gh ou glab) nesta maquina' } };
+                detalhe: (0, locale_1.textoDoCatalogo)((m) => nomeDaForja ? m.network.cliAusente(nomeDaForja) : m.network.nenhumaCli) } };
     }
     const falhas = [];
     for (const forja of candidatas) {
@@ -166,11 +175,13 @@ function resolverCasa(opcoes = {}) {
     // Suspeitas da revisao de 03/10: prazo, erro da forja ou falta de rede no `gh api user` nao e falta de
     // login; mandar a pessoa ao `gh auth login` esconderia o motivo de verdade.
     if (falhas.length) {
+        // RM-061 (F3b): o montador de cada falha e guardado agora; o detalhe pode virar erro remontado depois.
+        const montarFalhas = falhas.map(locale_1.montadorDe);
         return { casa: null, forja: null, identidades, motivo: { tipo: 'rede.sem-leitura',
-                detalhe: `${falhas.join('; ')}; o login nao foi lido, rode de novo com a forja respondendo` } };
+                detalhe: (0, locale_1.textoDoCatalogo)((m) => m.network.loginNaoLido(montarFalhas.map((f) => f(m)).join('; '))) } };
     }
     return { casa: null, forja: null, identidades, motivo: { tipo: 'forja.sem-login',
-            detalhe: `${candidatas.map((f) => f.cli).join(' e ')} sem login nesta maquina (${candidatas.map((f) => `${f.cli} auth login`).join(' ou ')})` } };
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => m.network.semLogin(candidatas)) } };
 }
 function versaoDoAdaptador(host, home) {
     const recibo = (0, hosts_1.lerRecibo)(path.join(home, hosts_1.HOSTS[host].destinoPadrao, hosts_1.HOSTS[host].subdir));
@@ -294,12 +305,12 @@ const CAMPOS = {
 };
 function exigirSoCampos(onde, v, permitidos) {
     if (!v || typeof v !== 'object' || Array.isArray(v))
-        throw new Error(`rede.segredo: ${onde} fora do contrato; nada foi publicado`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.foraDoContrato(onde));
     for (const [k, x] of Object.entries(v)) {
         if (!permitidos.includes(k))
-            throw new Error(`rede.segredo: campo "${onde}.${k}" fora da lista de permissao; nada foi publicado`);
+            throw new locale_1.ErroDoCatalogo((m) => m.network.campoForaDaLista(`${onde}.${k}`));
         if (x !== null && typeof x === 'string' && x.length > 1024)
-            throw new Error(`rede.segredo: campo "${onde}.${k}" longo demais; nada foi publicado`);
+            throw new locale_1.ErroDoCatalogo((m) => m.network.campoLongo(`${onde}.${k}`));
     }
 }
 /**
@@ -310,15 +321,15 @@ function exigirRetratoSeguro(r) {
     exigirSoCampos('retrato', r, CAMPOS.retrato);
     for (const lista of ['forjas', 'runtimes', 'hosts', 'projetos']) {
         if (!Array.isArray(r[lista]))
-            throw new Error(`rede.segredo: ${lista} fora do contrato; nada foi publicado`);
+            throw new locale_1.ErroDoCatalogo((m) => m.network.foraDoContrato(lista));
         r[lista].forEach((item, i) => exigirSoCampos(`${lista}[${i}]`, item, CAMPOS[lista]));
     }
     // S2 da revisao 2: o que o escritor publica, o leitor aceita; senao, ninguem ve esta maquina.
     if (!normalizarRetrato(r))
-        throw new Error('rede.contrato: o retrato desta maquina nao passa no contrato ork.rede-maquina/v1; nada foi publicado');
+        throw new locale_1.ErroDoCatalogo((m) => m.network.contratoDoRetrato);
     const achado = segredoNoRetrato(r);
     if (achado)
-        throw new Error(`rede.segredo: padrao "${achado.padrao}" em ${achado.onde}; nada foi publicado (valor omitido de proposito)`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.segredoNoRetrato(achado.padrao, achado.onde));
 }
 /** O primeiro valor do retrato com cara de segredo: o padrao e o campo, nunca o valor. */
 function segredoNoRetrato(r) {
@@ -351,7 +362,8 @@ function exigirSoOProprioRetrato(maquina, mudancas) {
     const proprio = arquivoDoRetrato(maquina);
     for (const m of mudancas) {
         if (m.caminho !== proprio && m.caminho !== exports.PAINEL_DA_REDE) {
-            throw new Error(`rede.retrato-alheio: ${maquina} tentou gravar ${m.caminho}; cada maquina so escreve ${proprio}`);
+            const caminho = m.caminho;
+            throw new locale_1.ErroDoCatalogo((t) => t.network.retratoAlheio(maquina, caminho, proprio));
         }
     }
 }
@@ -440,7 +452,8 @@ function lerRetratos(cache, ponta) {
     for (const arquivo of arquivos) {
         const visivel = JSON.stringify(arquivo).slice(1, -1).slice(0, 120);
         if (!/^maquinas\/[A-Za-z0-9._-]{1,64}\.json$/.test(arquivo)) {
-            invalidos.push({ arquivo: visivel, motivo: 'nome de arquivo fora do padrao maquinas/<maquina>.json' });
+            // RM-061 (F3b, GO-FIX 1): o motivo nasce pelo catalogo, e a lacuna do status o remonta.
+            invalidos.push({ arquivo: visivel, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoForaDoPadrao) });
             continue;
         }
         let bruto;
@@ -448,12 +461,12 @@ function lerRetratos(cache, ponta) {
             bruto = JSON.parse((0, branch_de_estado_1.exigirGit)(cache, ['show', `${ponta}:${arquivo}`], PREFIXO));
         }
         catch {
-            invalidos.push({ arquivo, motivo: 'JSON ilegivel' });
+            invalidos.push({ arquivo, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoIlegivel) });
             continue;
         }
         const retrato = normalizarRetrato(bruto);
         if (!retrato) {
-            invalidos.push({ arquivo, motivo: `fora do contrato ${exports.CONTRATO_DO_RETRATO}` });
+            invalidos.push({ arquivo, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoForaDoContrato(exports.CONTRATO_DO_RETRATO)) });
             continue;
         }
         let esperado = null;
@@ -461,8 +474,9 @@ function lerRetratos(cache, ponta) {
             esperado = arquivoDoRetrato(retrato.maquina);
         }
         catch { /* nome impossivel */ }
+        const diz = retrato.maquina;
         if (esperado !== arquivo) {
-            invalidos.push({ arquivo, motivo: `diz ser a maquina "${retrato.maquina}", que nao e a dona deste arquivo` });
+            invalidos.push({ arquivo, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoDeOutraMaquina(diz)) });
             continue;
         }
         // V9 da revisao 4: a mesma varredura do escritor; o que ela pega nao vai ao status nem ao REDE.md.
@@ -472,12 +486,14 @@ function lerRetratos(cache, ponta) {
         const projetos = retrato.projetos.filter((_x, i) => !achados[i]);
         const primeiro = achados.find((x) => x !== null);
         if (primeiro) {
-            invalidos.push({ arquivo, motivo: `${retrato.projetos.length - projetos.length} projeto(s) fora da leitura: padrao "${primeiro.padrao}" (valor omitido de proposito)` });
+            const fora = retrato.projetos.length - projetos.length, padrao = primeiro.padrao;
+            invalidos.push({ arquivo, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoProjetosOmitidos(fora, padrao)) });
         }
         const lido = { ...retrato, projetos };
         const segredo = segredoNoRetrato(lido);
         if (segredo) {
-            invalidos.push({ arquivo, motivo: `padrao "${segredo.padrao}" em ${segredo.onde} (valor omitido de proposito)` });
+            const { padrao, onde } = segredo;
+            invalidos.push({ arquivo, motivo: (0, locale_1.textoDoCatalogo)((m) => m.network.retratoComSegredo(padrao, onde)) });
             continue;
         }
         retratos.push(lido);
@@ -489,7 +505,9 @@ function lerRetratos(cache, ponta) {
 // O cache da casa e o git sem prompt.
 // ---------------------------------------------------------------------------
 function dirDoCache(casa) {
-    return path.join((0, rede_adesao_1.pastaDaRede)(), `${casa.forja}-${casa.host}-${casa.dono}-${casa.repositorio}`.replace(/[^A-Za-z0-9._-]+/g, '-'));
+    const nome = `${casa.forja}-${casa.host}-${casa.dono}-${casa.repositorio}`.replace(/[^A-Za-z0-9._-]+/g, '-');
+    // O dono com subgrupo (`time/sub`) leva um resumo curto, para nao cair na pasta do dono `time-sub`; sem subgrupo, o nome de sempre.
+    return path.join((0, rede_adesao_1.pastaDaRede)(), casa.dono.includes('/') ? `${nome}-${(0, node_crypto_1.createHash)('sha256').update(casa.dono).digest('hex').slice(0, 8)}` : nome);
 }
 /** O cache ja foi criado? */
 const cachePronto = (dir) => fs.existsSync(path.join(dir, '.git', 'HEAD'));
@@ -577,26 +595,45 @@ function gravarMarca(marca) {
 /** A casa com o repositorio conferido: existe e e privado (D3). `criar` so no `ork network entrar`. */
 function casaConferida(opcoes) {
     const r = resolverCasa(opcoes);
-    if (!r.casa || !r.forja)
-        throw new Error(`rede.sem-forja: ${r.motivo?.detalhe ?? 'nenhuma forja utilizavel'}`);
+    if (!r.casa || !r.forja) {
+        const detalhe = r.motivo ? (0, locale_1.montadorDe)(r.motivo.detalhe) : null;
+        throw new locale_1.ErroDoCatalogo((m) => m.network.semForja(detalhe === null ? null : detalhe(m)));
+    }
+    const semSuporte = r.forja.nome === 'gitlab' ? (0, rede_forja_1.gitlabSemSuporteNaRede)(opcoes.amb ?? {}, r.forja.host) : null;
+    if (semSuporte)
+        throw new locale_1.ErroDoCatalogo((m) => m.network.gitlabNaoSuportado(semSuporte));
     let repo = r.forja.repositorio(r.casa.dono, r.casa.repositorio);
     let criado = false;
     if (!repo.existe) {
+        const ref = (0, exports.refDaCasa)(r.casa);
         if (!opcoes.criar)
-            throw new Error(`rede.sem-repositorio: ${(0, exports.refDaCasa)(r.casa)} ainda nao existe; ork network entrar o cria, privado`);
+            throw new locale_1.ErroDoCatalogo((m) => m.network.semRepositorio(ref));
         const login = (r.identidades.find((i) => i.forja === r.forja.nome && i.host === r.forja.host) ?? r.forja.identidade()).usuario;
+        let namespaceId;
         if (r.casa.dono !== login) {
-            throw new Error(`rede.repositorio-alheio: ${(0, exports.refDaCasa)(r.casa)} nao existe e nao e do login ${login}; crie o repositorio privado na forja e rode de novo`);
+            // Outro dono so vale quando e um grupo em que a pessoa e Maintainer ou acima; forja sem a capacidade recusa como antes.
+            const dono = r.forja.donoDaRede?.(r.casa.dono) ?? null;
+            if (dono && !dono.ok && dono.erro.codigo !== 'forja.nao-achei') {
+                const erro = dono.erro, cli = r.forja.cli, tipo = r.forja.nome, rota = `namespaces/${r.casa.dono}`;
+                throw new locale_1.ErroDoCatalogo((m) => m.network.apiFalhou(cli, rota, m.forja.motivo(erro, tipo)));
+            }
+            if (!dono || !dono.ok || dono.valor.tipo !== 'grupo')
+                throw new locale_1.ErroDoCatalogo((m) => m.network.repositorioAlheio(ref, login));
+            const nivel = dono.valor.nivel ?? 0, grupo = dono.valor.caminho;
+            if (nivel < exports.NIVEL_MINIMO_NO_GRUPO)
+                throw new locale_1.ErroDoCatalogo((m) => m.network.grupoSemNivel(ref, grupo, login, nivel));
+            namespaceId = dono.valor.namespaceId;
         }
-        repo = r.forja.criarPrivado(r.casa.repositorio, DESCRICAO);
+        repo = r.forja.criarPrivado(r.casa.repositorio, DESCRICAO, r.casa.dono, namespaceId);
         criado = true;
     }
+    const refDaConferida = (0, exports.refDaCasa)(r.casa), cli = r.forja.cli;
     if (repo.privado !== true)
-        throw new Error(`rede.repositorio-publico: ${(0, exports.refDaCasa)(r.casa)} nao e privado; nada foi publicado`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.repositorioPublico(refDaConferida));
     if (!repo.url)
-        throw new Error(`rede.forja: ${r.forja.cli} nao devolveu a URL de ${(0, exports.refDaCasa)(r.casa)}`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.semUrl(cli, refDaConferida));
     if (!urlDaCasaAceita(repo.url)) {
-        throw new Error(`rede.sem-https: ${r.forja.cli} devolveu para ${(0, exports.refDaCasa)(r.casa)} uma URL sem https; a rede so fala com a forja por https, e nada foi publicado`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.semHttps(cli, refDaConferida));
     }
     return { casa: r.casa, forja: r.forja, url: repo.url, criado, identidades: r.identidades };
 }
@@ -735,13 +772,13 @@ function gravarNaCasa(conferida, retrato, descartados, opcoes) {
         return { acao: 'ocupado', maquina, casa: (0, exports.refDaCasa)(casa), commit: null, tentativas: 0, descartados };
     try {
         if (opcoes.exigirAdesao && !(0, rede_adesao_1.adesaoDaRede)().membro)
-            throw new Error('rede.fora: esta maquina saiu da rede; nada foi publicado');
+            throw new locale_1.ErroDoCatalogo((m) => m.network.saiuDaRede);
         const cache = prepararCache(casa, url, forja.helperDeCredencial(), maquina);
         const assinatura = assinaturaDoRetrato(retrato);
         for (let tentativa = 1; tentativa <= TENTATIVAS; tentativa++) {
             const { ponta, atualizado } = (0, rede_forja_1.comGitIsolado)(() => (0, branch_de_estado_1.buscarBranch)(cache, 'origin', exports.BRANCH_DA_REDE, PREFIXO, 30000));
             if (!atualizado)
-                throw new Error(`rede.sem-leitura: nao consegui ler ${(0, exports.refDaCasa)(casa)}; publicar exige rede`);
+                throw new locale_1.ErroDoCatalogo((m) => m.network.semLeitura((0, exports.refDaCasa)(casa)));
             const { retratos } = retratosDaPonta(cache, ponta);
             const atual = retratos.find((r) => r.maquina === maquina);
             // U2: o arquivo que esta versao nao le ainda pode ser de outra instalacao (contrato mais novo).
@@ -749,12 +786,9 @@ function gravarNaCasa(conferida, retrato, descartados, opcoes) {
             const alheio = !!idDoOutro && idDoOutro !== retrato.id;
             if (alheio && !opcoes.tomarNome) {
                 // U7 da revisao 3: o hostname igual sugere a propria maquina, mas duas VMs podem se chamar `ubuntu`.
-                const dica = atual?.hostname === hostnameSeguro()
-                    ? '; o retrato tem o hostname desta maquina: se for ela mesma, com ~/.orkastery apagada ou copiada, retome o nome com ' +
-                        'ork network entrar --forcar; se for outra maquina ou instalacao com o mesmo hostname, escolha outro nome com --maquina NOME'
-                    : '; escolha outro nome com ork network entrar --maquina NOME, ou tome este com --forcar';
-                const quem = atual ? ` (hostname ${atual.hostname}, batida ${(0, horario_1.formatarDataHora)(atual.publicadoEm)})` : ' (num retrato que esta versao nao le)';
-                throw new Error(`rede.nome-em-uso: outra instalacao ja publica como "${maquina}"${quem}${dica}`);
+                const mesmoHostname = atual?.hostname === hostnameSeguro();
+                const outro = atual ? { hostname: atual.hostname, publicadoEm: atual.publicadoEm } : null;
+                throw new locale_1.ErroDoCatalogo((m) => m.network.nomeEmUso(maquina, outro ? m.network.quemHostname(String(outro.hostname), (0, horario_1.formatarDataHora)(outro.publicadoEm)) : m.network.quemIlegivel, mesmoHostname ? m.network.dicaMesmoHostname : m.network.dicaOutroNome));
             }
             const mudancas = [
                 { caminho: arquivoDoRetrato(maquina), conteudo: JSON.stringify(retrato, null, 2) + '\n' },
@@ -769,7 +803,7 @@ function gravarNaCasa(conferida, retrato, descartados, opcoes) {
                 return { acao: 'publicou', maquina, casa: (0, exports.refDaCasa)(casa), commit, tentativas: tentativa, descartados, ...(alheio ? { tomouNome: true } : {}) };
             }
         }
-        throw new Error(`rede.concorrencia: ${TENTATIVAS} pushes recusados seguidos; tente de novo em instantes`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.concorrencia(TENTATIVAS));
     }
     finally {
         trava.liberar();
@@ -783,7 +817,7 @@ function gravarNaCasa(conferida, retrato, descartados, opcoes) {
 function publicarRede(opcoes = {}) {
     const adesao = (0, rede_adesao_1.adesaoDaRede)();
     if (!adesao.membro)
-        throw new Error('rede.fora: esta maquina nao esta na rede; ork network entrar');
+        throw new locale_1.ErroDoCatalogo((m) => m.network.foraDaRede);
     const amb = opcoes.amb ?? {};
     const maquina = nomeSeguro((0, maquina_1.nomeDaMaquina)(opcoes.maquina));
     const id = (0, rede_adesao_1.idDaMaquina)();
@@ -833,7 +867,7 @@ function entrarNaRede(opcoes = {}) {
     const explicito = (opcoes.maquina ?? '').trim();
     const maquina = explicito || nomeSeguro((0, maquina_1.lerConfigDaMaquina)()?.nome || (0, maquina_1.nomeDaMaquina)());
     if (!NOME_DE_MAQUINA.test(maquina)) {
-        throw new Error(`rede.maquina: nome de maquina invalido ("${maquina}"); use ork network entrar --maquina NOME (letras, numeros, ponto, _ ou -)`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.nomeInvalido(maquina));
     }
     const amb = opcoes.amb ?? {};
     const lidas = opcoes.identidades ?? (0, rede_forja_1.forjasDaMaquina)(amb).map((f) => f.identidade());
@@ -847,7 +881,8 @@ function entrarNaRede(opcoes = {}) {
     exigirRetratoSeguro(retrato);
     const publicacao = gravarNaCasa(conferida, retrato, descartados, { exigirAdesao: false, tomarNome: opcoes.tomarNome });
     if (publicacao.acao === 'ocupado') {
-        throw new Error(`rede.ocupado: outra publicacao desta maquina esta em andamento (${TRAVA()}); rode ork network entrar de novo em instantes`);
+        const trava = TRAVA();
+        throw new locale_1.ErroDoCatalogo((m) => m.network.ocupadoAoEntrar(trava));
     }
     (0, maquina_1.gravarConfigDaMaquina)({ nome: maquina });
     const { casa } = conferida;
@@ -875,11 +910,14 @@ function sairDaRede(opcoes = {}) {
     if (!repo.existe || !repo.url)
         return { maquina, casa: (0, exports.refDaCasa)(r.casa), commit: null, alheio: false };
     if (!urlDaCasaAceita(repo.url)) {
-        throw new Error(`rede.sem-https: saiu da rede aqui, mas ${r.forja.cli} devolveu para ${(0, exports.refDaCasa)(r.casa)} uma URL sem https; o retrato fica na casa`);
+        const cli = r.forja.cli, ref = (0, exports.refDaCasa)(r.casa);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.semHttpsAoSair(cli, ref));
     }
     const trava = travarCasa(30000);
-    if (!trava.ok)
-        throw new Error(`rede.ocupado: saiu da rede aqui, mas outra publicacao desta maquina segura a casa (${TRAVA()}); rode ork network sair de novo`);
+    if (!trava.ok) {
+        const qual = TRAVA();
+        throw new locale_1.ErroDoCatalogo((m) => m.network.ocupadoAoSair(qual));
+    }
     try {
         // Suspeitas da revisao de 03/10: a publicacao que ja segurava a trava quando o `sair` comecou grava
         // a marca ao terminar o push. Sob a trava ela ja terminou, e a proxima reconfere a adesao e recusa
@@ -893,8 +931,10 @@ function sairDaRede(opcoes = {}) {
         const id = (0, rede_adesao_1.idDaMaquina)();
         for (let tentativa = 1; tentativa <= TENTATIVAS; tentativa++) {
             const { ponta, atualizado } = (0, rede_forja_1.comGitIsolado)(() => (0, branch_de_estado_1.buscarBranch)(cache, 'origin', exports.BRANCH_DA_REDE, PREFIXO, 30000));
-            if (!atualizado)
-                throw new Error(`rede.sem-leitura: saiu da rede aqui, mas nao consegui ler ${(0, exports.refDaCasa)(r.casa)} para tirar o retrato; rode ork network sair de novo com rede`);
+            if (!atualizado) {
+                const ref = (0, exports.refDaCasa)(r.casa);
+                throw new locale_1.ErroDoCatalogo((m) => m.network.semLeituraAoSair(ref));
+            }
             const { retratos, invalidos } = retratosDaPonta(cache, ponta);
             const atual = retratos.find((x) => x.maquina === maquina);
             // S9 da revisao 2: o arquivo com o nome desta maquina sai tambem quando esta invalido; so o de
@@ -918,7 +958,7 @@ function sairDaRede(opcoes = {}) {
             if (commit)
                 return { maquina, casa: (0, exports.refDaCasa)(r.casa), commit, alheio: false };
         }
-        throw new Error(`rede.concorrencia: ${TENTATIVAS} pushes recusados seguidos; tente de novo em instantes`);
+        throw new locale_1.ErroDoCatalogo((m) => m.network.concorrencia(TENTATIVAS));
     }
     finally {
         trava.liberar();

package/dist/retomada-checkpoint.js

@@ -0,0 +1,101 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.derivarPontoDeParada = derivarPontoDeParada;
+exports.prepararPromptDeRetomada = prepararPromptDeRetomada;
+/** RM-064 T3: checkpoint determinístico para continuar um bloco sem recomeçar GOAL/PLAN. */
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const claims_1 = require("./claims");
+const ledger_1 = require("./ledger");
+const procedencia_1 = require("./procedencia");
+const thread_1 = require("./thread");
+const trabalho_thread_1 = require("./trabalho-thread");
+const util_1 = require("./util");
+const hash = (texto) => (0, node_crypto_1.createHash)('sha256').update(texto, 'utf8').digest('hex');
+const SHA = /^[a-f0-9]{40}$/;
+function numero(e) {
+    return typeof e.rodada === 'number' && Number.isSafeInteger(e.rodada) && e.rodada > 0 ? e.rodada : null;
+}
+function derivarPontoDeParada(raiz, thread, fase, eventos = (0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, thread.id))) {
+    const cwdBruto = (0, procedencia_1.diretorioDaThread)(raiz, thread);
+    const cwd = (0, procedencia_1.cwdLocalOuNulo)(raiz, thread.id, cwdBruto, 'thread');
+    const head = cwd ? (0, util_1.exec)('git', ['rev-parse', '--verify', 'HEAD^{commit}'], cwd, 30_000) : null;
+    const ultimoCommit = head?.ok && SHA.test(head.stdout.trim()) ? head.stdout.trim() : null;
+    const status = cwd ? (0, util_1.exec)('git', ['status', '--porcelain=v1', '--untracked-files=normal'], cwd, 30_000) : null;
+    const gitStatus = status?.ok ? status.stdout.split('\n').filter(Boolean).slice(0, 100) : ['git status indisponível'];
+    const claimsPendentes = (0, claims_1.lerClaims)(raiz, thread.id).filter((c) => !['verificado', 'retirada'].includes(c.estado)).map((c) => c.id);
+    const rodadaCheck = eventos.filter((e) => e.tipo === ledger_1.TIPOS_DE_EVENTO.verificacao || e.tipo === ledger_1.TIPOS_DE_EVENTO.reverifyConcluido).length;
+    const abertas = eventos.filter((e) => e.tipo === ledger_1.TIPOS_DE_EVENTO.fixAberto).map(numero).filter((n) => n !== null);
+    const fechadas = new Set(eventos.filter((e) => e.tipo === ledger_1.TIPOS_DE_EVENTO.reverifyConcluido).map(numero).filter((n) => n !== null));
+    const goFixEmCurso = abertas.filter((r) => !fechadas.has(r)).at(-1) ?? null;
+    const trabalho = (0, trabalho_thread_1.resumirTrabalhoDaThread)(raiz, thread.id);
+    return { fase, ultimoCommit, gitStatus, claimsPendentes, rodadaCheck, goFixEmCurso, trabalho };
+}
+function secao(p, originalSha) {
+    const status = p.gitStatus.length ? p.gitStatus.map((l) => `  ${l}`).join('\n') : '  (limpa)';
+    return `## Ponto de parada\n\n` +
+        `Esta sessão retoma uma interrupção por cota. Continue da fase \`${p.fase}\`; não repita GOAL nem PLAN.\n\n` +
+        `- Prompt original: \`${originalSha}\`\n` +
+        `- Fase: \`${p.fase}\`\n` +
+        `- Último commit: ${p.ultimoCommit ? `\`${p.ultimoCommit}\`` : '(indisponível)'}\n` +
+        `- Claims pendentes: ${p.claimsPendentes.length ? p.claimsPendentes.map((c) => `\`${c}\``).join(', ') : '(nenhuma)'}\n` +
+        `- Rodadas de CHECK observadas: ${p.rodadaCheck}\n` +
+        `- GO-FIX em curso: ${p.goFixEmCurso === null ? '(nenhum)' : `rodada ${p.goFixEmCurso}`}\n` +
+        `- Trabalho retomável: \`${p.trabalho.caminho}\`\n` +
+        `${(0, trabalho_thread_1.formatarResumoDoTrabalho)(p.trabalho)}\n` +
+        `- \`git status --porcelain\`:\n\n\`\`\`text\n${status}\n\`\`\`\n\n`;
+}
+/** O original é conferido pelo chamador; este escritor só cria o derivado e nunca o altera. */
+function prepararPromptDeRetomada(raiz, thread, fase, original, gravar = true) {
+    const ponto = derivarPontoDeParada(raiz, thread, fase);
+    const prompt = `${secao(ponto, original.promptSha256)}${original.prompt}`;
+    const promptSha256 = hash(prompt);
+    const pasta = path.join((0, thread_1.dirThread)(raiz, thread.id), 'prompts');
+    const promptPath = path.join(pasta, `retomada-${fase.toLowerCase()}-${promptSha256.slice(0, 12)}.md`);
+    if (gravar) {
+        fs.mkdirSync(pasta, { recursive: true });
+        try {
+            fs.writeFileSync(promptPath, prompt, { flag: 'wx', mode: 0o600 });
+        }
+        catch (e) {
+            if (e.code !== 'EEXIST' || hash(fs.readFileSync(promptPath, 'utf8')) !== promptSha256)
+                throw e;
+        }
+    }
+    return { prompt, promptPath, promptSha256, promptOriginalPath: original.promptPath,
+        promptOriginalSha256: original.promptSha256, ponto };
+}