@orkastery/cli 0.5.3 → 0.6.0

package/dist/network-roadmap.js

@@ -78,6 +78,8 @@ const docs_1 = require("./docs");
 const fabrica_estado_1 = require("./fabrica-estado");
 Object.defineProperty(exports, "LIMIAR_SEM_BATIDA_MS", { enumerable: true, get: function () { return fabrica_estado_1.LIMIAR_SEM_BATIDA_MS; } });
 const forja_1 = require("./forja");
+const endereco_1 = require("./forja/endereco");
+const resolver_1 = require("./forja/resolver");
 const horario_1 = require("./horario");
 const estado_thread_1 = require("./estado-thread");
 const manifest_1 = require("./manifest");
@@ -89,9 +91,11 @@ const rede_projetos_1 = require("./rede-projetos");
 const rede_status_1 = require("./rede-status");
 const roadmap_reservas_1 = require("./roadmap-reservas");
 const roadmap_status_1 = require("./roadmap-status");
+const vida_da_thread_1 = require("./vida-da-thread");
 const thread_1 = require("./thread");
 const versao_1 = require("./versao");
 const yaml_1 = require("./yaml");
+const locale_1 = require("./locale");
 exports.CONTRATO_PANORAMA_DA_REDE = 'ork.network-roadmap/v1';
 /** O registro de projetos da RM-052, lido como ela o grava. */
 exports.CONTRATO_REGISTRO_DE_PROJETOS = 'ork.projetos/v1';
@@ -115,8 +119,10 @@ class ErroDoPedidoDeProjeto extends Error {
         return { erro: this.codigo, detalhe: this.detalhe, candidatos: this.candidatos, correcao: this.correcao };
     }
     get texto() {
-        return [`${this.codigo}: ${this.detalhe}`, ...(this.candidatos.length ? ['Candidatos:', ...this.candidatos.map((c) => `  • ${c}`)] : []),
-            this.correcao].join('\n');
+        const m = (0, locale_1.msg)().network.roadmap;
+        return [`${this.codigo}: ${m.recusaDetalhe(this.codigo, this.detalhe)}`,
+            ...(this.candidatos.length ? [m.candidatos, ...this.candidatos.map((c) => `  • ${c}`)] : []),
+            m.recusaCorrecao(this.codigo, this.correcao)].join('\n');
     }
 }
 exports.ErroDoPedidoDeProjeto = ErroDoPedidoDeProjeto;
@@ -137,9 +143,23 @@ const baseValida = (base) => typeof base === 'string' && /^[A-Za-z0-9][A-Za-z0-9
 function projetoDoClone(c, origem) {
     const remoto = c.manifesto.fabrica.remoto;
     const url = (0, branch_de_estado_1.remotoValido)(remoto) ? (0, branch_de_estado_1.git)(c.raiz, ['remote', 'get-url', '--', remoto]) : null;
-    return { nome: c.manifesto.project.name, forja: url?.ok ? (0, forja_1.identidadeDaForja)(url.stdout.trim()) : null, raiz: c.raiz,
+    return { nome: c.manifesto.project.name, forja: url?.ok ? forjaDoClone(c, url.stdout.trim()) : null, raiz: c.raiz,
         base: c.manifesto.worktree.base_branch, remoto, origem };
 }
+/**
+ * A forja do clone, com o manifesto: o bloco `forja:` e o host conhecido decidem, sem rede (como o pulse). So quando
+ * nenhum dos dois diz o tipo (`forja.desconhecida`) vale o nome do host, como para os remotos sem clone; o manifesto
+ * que contradiz o remoto deixa o projeto sem forja, e a leitura cai no clone.
+ */
+function forjaDoClone(c, url) {
+    const endereco = (0, endereco_1.lerEnderecoDoRemoto)(url);
+    if (!endereco)
+        return null;
+    const r = (0, resolver_1.resolverForja)({ endereco, manifesto: c.manifesto.forja, sondas: {} });
+    if (r.ok)
+        return (0, forja_1.identidadeDaForjaResolvida)(r.valor);
+    return r.erro.codigo === 'forja.desconhecida' ? (0, forja_1.identidadeDaForja)(url) : null;
+}
 function mesmoProjeto(a, b) {
     if ((0, forja_1.mesmaForja)(a.forja, b.forja))
         return true;
@@ -408,12 +428,14 @@ function retratoLegivel(v) {
         textoOuNulo(t.roadmap) && textoOuNulo(t.pergunta) && textoOuNulo(t.entregue) && textoOuNulo(t.paradaDesde) &&
         textoOuNulo(t.runtime) && textoOuNulo(t.modelo) && textoOuNulo(t.esforco));
 }
-function fatosDoRetrato(m, entregues, itemDaReserva) {
+function fatosDoRetrato(m, entregues, itemDaReserva, quando) {
     return m.threads.map((t) => ({
         id: t.id, roadmap: t.roadmap ?? itemDaReserva.get(t.id) ?? null, aberta: t.status !== 'fechada', fase: t.fase,
         entregueHoje: () => entregues.has(t.id),
         espera: () => t.esperaVoce ? { thread: t.id, pergunta: pontuar(t.pergunta ?? 'o veredito da pausa'), maquina: m.maquina } : undefined,
         maquina: m.maquina,
+        // RM-063 (F2): a sessao que a outra maquina verificou ao publicar; retrato sem o campo, ou velho, nao diz "sigo".
+        vida: () => (0, vida_da_thread_1.vidaDoRetrato)(t.sessao, m.publicadoEm, quando),
     }));
 }
 function fatosDaMaquinaLocal(raiz, quando, fuso, maquina, entregues, itemDaReserva) {
@@ -458,7 +480,7 @@ function montarProjeto(p, d, ctx, fontes, lacunas) {
         fatosDaMaquinaLocal(d.local.raiz, ctx.quando, ctx.fuso, d.local.retrato.maquina, entregues, itemDaReserva).forEach(somar);
     for (const m of d.retratos ?? [])
         if (!d.local || m.maquina !== d.local.retrato.maquina)
-            fatosDoRetrato(m, entregues, itemDaReserva).forEach(somar);
+            fatosDoRetrato(m, entregues, itemDaReserva, ctx.quando).forEach(somar);
     // Entregue hoje e ja fechada: nao esta em retrato nenhum, mas o merge na base e o fato do dia.
     for (const id of entregues)
         somar({ id, roadmap: itemDaReserva.get(id) ?? null, aberta: false, fase: 'SHIP', entregueHoje: () => true,
@@ -680,10 +702,20 @@ function lerProjetoDoClone(p, geral) {
 const CORRECAO_DA_FORJA = {
     'forja.ausente': (cli) => `instale ${cli} e faça login (${cli} auth login); gateway e cron têm PATH curto`,
     'forja.sem-login': (cli) => `rode ${cli} auth login nesta máquina; o ork nunca lê nem copia token`,
-    'forja.nao-encontrado': () => 'confira o nome (github:dono/repo) e se o login da forja enxerga o repositório',
-    'forja.tempo-esgotado': () => 'tente de novo: a forja não respondeu a tempo',
-    'forja.inacessivel': () => 'confira a rede e o status da forja',
     'forja.resposta-invalida': () => 'a forja respondeu fora do formato esperado: registre o caso no RM-054',
+    'forja.sem-permissao': () => 'o login da forja não tem permissão para isso: confira o escopo do token',
+    'forja.nao-achei': () => 'confira o nome (github:dono/repo ou gitlab:grupo/sub/repo) e se o login da forja enxerga o repositório; ' +
+        'no GitLab, projeto privado sem acesso também responde assim',
+    'forja.limite': () => 'a forja limitou as chamadas: tente de novo mais tarde',
+    'forja.conflito': () => 'a forja recusou por conflito: atualize e tente de novo',
+    'forja.indisponivel': () => 'tente de novo e confira a rede e o status da forja',
+    'forja.pedido-recusado': () => 'a forja recusou o pedido: confira os dados enviados',
+    'forja.incompleto': () => 'a forja devolveu uma lista incompleta: tente de novo',
+    'forja.desconhecida': () => 'o ork não reconheceu a forja: declare o bloco forja: no manifesto',
+    'forja.ambigua': () => 'a forja é ambígua: declare o bloco forja: no manifesto',
+    'forja.remoto-divergente': () => 'o remoto do clone não bate com a forja declarada: confira o manifesto',
+    'forja.sem-capacidade': () => 'esta forja não oferece o recurso necessário',
+    'forja.versao-abaixo-do-piso': () => 'o servidor da forja está abaixo do GitLab 17.0, o piso do ork',
 };
 function lerProjetoDaForja(p, geral) {
     const forja = p.forja, rotulo = (0, forja_1.rotuloDaForja)(forja), cli = forja.tipo === 'github' ? 'gh' : 'glab';
@@ -696,9 +728,10 @@ function lerProjetoDaForja(p, geral) {
         return semLeitura();
     }
     const desde = inicioDoDia(geral.quando, geral.fuso);
+    const api = forja.tipo === 'gitlab' && geral.rodarDaForja ? (0, forja_1.apiDoGitlab)(forja, { rodar: geral.rodarDaForja }) : undefined;
     const ler = (base) => (0, forja_1.lerDaForja)(forja, { base, desde, dirRoadmap: docs_1.DIR_ROADMAP, manifesto: manifest_1.NOME_MANIFESTO,
         reservas: { branch: roadmap_reservas_1.BRANCH_DE_RESERVAS, dir: roadmap_reservas_1.DIR_DE_RESERVAS }, fabrica: { branch: fabrica_estado_1.BRANCH_DA_FABRICA, dir: fabrica_estado_1.DIR_DA_FABRICA },
-        lidoEm: geral.quando }, geral.executor);
+        lidoEm: geral.quando }, geral.executor, api);
     let baseUsada = p.base;
     let r = ler(p.base);
     // Sem clone, a base e a do manifesto lido: se ele aponta outra branch, a leitura e refeita por ela.
@@ -722,7 +755,7 @@ function lerProjetoDaForja(p, geral) {
     let commits = l.base?.commits ?? [], commitsParciais = l.base?.commitsParciais ?? false;
     const inicioNoProjeto = inicioDoDia(ctx.quando, ctx.fuso);
     if (l.base && Date.parse(inicioNoProjeto) < Date.parse(desde)) {
-        const h = (0, forja_1.lerCommitsDaForja)(forja, { commit: l.base.commit, desde: inicioNoProjeto }, geral.executor);
+        const h = (0, forja_1.lerCommitsDaForja)(forja, { commit: l.base.commit, desde: inicioNoProjeto }, geral.executor, api);
         if (h.ok) {
             commits = h.commits;
             commitsParciais = h.parciais;
@@ -928,6 +961,7 @@ function montarPanoramaDaRede(opcoes = {}) {
     const quando = opcoes.quando ?? new Date().toISOString();
     const cwd = opcoes.cwd ?? process.cwd();
     const ctx = { quando, maquina: (0, maquina_1.nomeDaMaquina)(opcoes.maquina), semRemoto: opcoes.semRemoto === true, executor: opcoes.executor,
+        rodarDaForja: opcoes.rodarDaForja,
         fuso: (0, horario_1.fusoDoDono)().fuso };
     const naoConsultado = [];
     const lacunas = [];
@@ -997,86 +1031,91 @@ function descreverProjeto(x) {
     return `${x.nome} (${[x.forja, x.clone ? `clone em ${x.clone}` : 'sem clone nesta máquina'].filter(Boolean).join(', ')})`;
 }
 function linhaDaFonte(f, quando, fuso) {
-    const parte = { roadmap: 'roadmap', reservas: 'reservas', fabrica: 'fábrica', 'estado-local': 'esta máquina' }[f.parte];
-    const lido = f.lidoEm === quando ? 'lido agora' : `lido ${(0, horario_1.formatarDataHora)(f.lidoEm, { fuso })}`;
+    const m = (0, locale_1.msg)().network.roadmap;
+    const parte = m.fonteParte(f.parte);
+    const lido = f.lidoEm === quando ? m.lidoAgora : m.lidoEm((0, horario_1.formatarDataHora)(f.lidoEm, { fuso }));
     if (f.origem === 'estado-local')
-        return `• ${parte}: estado local em ${f.onde}, ${lido}`;
+        return m.fonteLocal(parte, f.onde, lido);
     if (!f.existe)
-        return `• ${parte}: ${f.onde} não existe, ${lido}`;
-    const alvo = f.parte === 'roadmap' ? `${docs_1.DIR_ROADMAP} em ${f.onde}` : f.onde;
-    return `• ${parte}: ${alvo} @ ${(f.commit ?? '').slice(0, 7)} (commit de ${(0, horario_1.formatarDataHora)(f.dataDoCommit, { fuso })}), ` +
-        (f.atualizado ? lido : 'última cópia desta máquina, sem leitura nova');
+        return m.fonteInexistente(parte, f.onde, lido);
+    const alvo = f.parte === 'roadmap' ? m.alvoDoRoadmap(f.onde) : f.onde;
+    return m.fonteCommit(parte, alvo, (f.commit ?? '').slice(0, 7), (0, horario_1.formatarDataHora)(f.dataDoCommit, { fuso }), f.atualizado ? lido : m.ultimaCopia);
 }
 function linhasDasMaquinas(x, fuso) {
+    const m = (0, locale_1.msg)().network.roadmap;
     if (x.maquinas === null)
-        return ['• não lidas: veja as lacunas'];
+        return [m.maquinasNaoLidas];
     if (x.maquinas.length === 0)
-        return ['• nenhuma máquina publicou em ork/fabrica-estado'];
+        return [m.nenhumaMaquinaNaFabrica];
     return x.maquinas.flatMap((m) => {
-        const quem = `${m.maquina}${m.estaMaquina ? ' (esta máquina)' : ''}`;
+        const quem = `${m.maquina}${m.estaMaquina ? (0, locale_1.msg)().network.roadmap.estaMaquina : ''}`;
         // Fatia 3: a maquina so da rede por pessoa; as threads dela neste projeto nao foram lidas.
         if (m.origem === 'rede') {
-            return [`• ${quem}: threads não lidas, na rede por pessoa (retrato de ${(0, horario_1.formatarDataHora)(m.publicadoEm, { fuso })}, ` +
-                    `há ${(0, horario_1.duracaoCurta)(m.idadeMin)}${m.semBatida ? ', SEM BATIDA' : ''}) e sem retrato em ${fabrica_estado_1.BRANCH_DA_FABRICA}`];
+            return [(0, locale_1.msg)().network.roadmap.maquinaSoNaRede(quem, (0, horario_1.formatarDataHora)(m.publicadoEm, { fuso }), (0, horario_1.duracaoCurta)(m.idadeMin), m.semBatida, fabrica_estado_1.BRANCH_DA_FABRICA)];
         }
-        const batida = m.origem === 'estado-local' ? 'estado local lido agora'
-            : `retrato de ${(0, horario_1.formatarDataHora)(m.publicadoEm, { fuso })} (há ${(0, horario_1.duracaoCurta)(m.idadeMin)})${m.semBatida ? ', SEM BATIDA' : ''}`;
-        const cabeca = `• ${quem}: ${m.ativas.length} ativa(s)${m.entreguesSemMaster ? `, ${m.entreguesSemMaster} entregue(s) sem MASTER` : ''}, ${batida}`;
+        const rm = (0, locale_1.msg)().network.roadmap;
+        const batida = m.origem === 'estado-local' ? rm.estadoLocalAgora
+            : rm.retrato((0, horario_1.formatarDataHora)(m.publicadoEm, { fuso }), (0, horario_1.duracaoCurta)(m.idadeMin), m.semBatida);
+        const cabeca = rm.resumoMaquina(quem, m.ativas.length, m.entreguesSemMaster, batida);
         // RM-037 (rm037noite, defeito 4): o runtime e o modelo de cada thread, quando o retrato os traz.
-        return [cabeca, ...m.ativas.map((t) => `  ${t.id} · ${t.modo} · ${t.fase} · ${t.roadmap ?? 'sem item'}` +
+        return [cabeca, ...m.ativas.map((t) => `  ${t.id} · ${t.modo} · ${t.fase} · ${t.roadmap ?? rm.semItem}` +
                 (t.runtime || t.modelo ? ` · ${(0, fabrica_estado_1.runtimeDaThread)(t)}` : '') +
-                (t.esperaVoce ? ` · espera você: ${t.pergunta ?? 'veredito'}` : ''))];
+                (t.esperaVoce ? rm.esperaVoce(t.pergunta ?? rm.veredito) : ''))];
     });
 }
 function linhasDasReservas(x, fuso) {
+    const m = (0, locale_1.msg)().network.roadmap;
     if (x.reservas === null)
-        return ['• não lidas: veja as lacunas'];
+        return [m.reservasNaoLidas];
     if (x.reservas.length === 0)
-        return ['• nenhuma reserva em ork/roadmap-reservas'];
-    return x.reservas.map((r) => `  ${r.item} · ${r.maquina} · ${r.thread ?? 'sem thread'} · desde ${(0, horario_1.formatarDataHora)(r.desdeEm, { fuso })}`);
+        return [m.nenhumaReserva];
+    return x.reservas.map((r) => m.reserva(r.item, r.maquina, r.thread ?? m.semThread, (0, horario_1.formatarDataHora)(r.desdeEm, { fuso })));
 }
 /** Fatia 3: a casa da rede por pessoa e as maquinas dela, com a batida e os projetos que declaram. */
 function linhasDaRede(r, quando, fuso) {
-    const lido = r.lidoEm === quando ? 'lida agora' : `lida ${(0, horario_1.formatarDataHora)(r.lidoEm, { fuso })}`;
-    const casa = !r.casa ? '• casa: nenhuma achada (veja as lacunas)'
-        : r.atualizado === null ? `• casa: ${r.casa}, não lida (veja as lacunas)`
-            : `• casa: ${r.casa} @ ${r.ponta ? r.ponta.slice(0, 7) : 'sem commit'}, ${r.atualizado ? lido : 'última cópia desta máquina, sem leitura nova'}`;
+    const x = (0, locale_1.msg)().network.roadmap;
+    const lido = r.lidoEm === quando ? x.redeLidaAgora : x.redeLidaEm((0, horario_1.formatarDataHora)(r.lidoEm, { fuso }));
+    const casa = !r.casa ? x.casaAusente
+        : r.atualizado === null ? x.casaNaoLida(r.casa)
+            : x.casaLida(r.casa, r.ponta ? r.ponta.slice(0, 7) : x.semCommit, r.atualizado ? lido : x.casaUltimaCopia);
     if (r.membros.length === 0)
-        return [casa, '• nenhum retrato lido na casa; isso não quer dizer que não há máquinas: veja as lacunas'];
-    return [casa, ...r.membros.map((m) => `• ${m.maquina}${m.estaMaquina ? ' (esta máquina)' : ''}: retrato de ` +
-            `${(0, horario_1.formatarDataHora)(m.publicadoEm, { fuso })}${m.idadeMin === null ? ' (batida ilegível)' : ` (há ${(0, horario_1.duracaoCurta)(m.idadeMin)})`}` +
-            `${m.semBatida ? ', SEM BATIDA' : ''}${m.versaoOrk ? `, ork ${m.versaoOrk}` : ''}, ` +
-            (m.projetos.length ? `projetos: ${m.projetos.join(', ')}` : 'nenhum projeto declarado aqui'))];
+        return [casa, x.nenhumRetrato];
+    return [casa, ...r.membros.map((m) => x.membro(m.maquina, m.estaMaquina ? x.estaMaquina : '', (0, horario_1.formatarDataHora)(m.publicadoEm, { fuso }), m.idadeMin === null ? x.batidaIlegivel : x.idade((0, horario_1.duracaoCurta)(m.idadeMin)), m.semBatida, m.versaoOrk ? x.versao(m.versaoOrk) : '', m.projetos.length ? x.projetos(m.projetos.join(', ')) : x.nenhumProjeto))];
 }
-const linhaDaLacuna = (l) => `• ${l.tipo}${l.alvo ? ` (${l.alvo})` : ''}: ${l.detalhe}. O que fazer: ${l.correcao}.`;
+const linhaDaLacuna = (l) => {
+    const m = (0, locale_1.msg)().network.roadmap;
+    return m.lacuna(l.tipo, l.alvo ? ` (${l.alvo})` : '', m.lacunaDetalhe(l.tipo, l.parte, l.alvo, l.detalhe), m.lacunaCorrecao(l.tipo, l.correcao));
+};
 /** O texto de `ork network roadmap`: o consultado e o nao consultado no alto, e cada parte com a fonte e a hora. */
 function textoDoPanoramaDaRede(p) {
+    const m = (0, locale_1.msg)().network.roadmap;
     if (p.contrato !== exports.CONTRATO_PANORAMA_DA_REDE)
-        throw new Error('panorama da rede: contrato inválido');
+        throw new Error(m.contratoInvalido);
     const h = (0, horario_1.partesLocais)(p.consultadoEm, p.fuso);
     const linhas = [
         `Panorama da rede lido de ${p.maquina} (${h.dia}/${h.mes}, ${h.hora}:${h.minuto})`,
         p.projetos.length ? `Consultado: ${p.projetos.map((x) => descreverProjeto(x.projeto)).join('; ')}` : 'Consultado: nenhum projeto.',
-        'Não consultado:', ...(p.naoConsultado.length ? p.naoConsultado.map((n) => `• ${n}`) : ['• nada fora do pedido']),
+        'Não consultado:', ...(p.naoConsultado.length ? p.naoConsultado.map(m.naoConsultado) : [m.nadaForaDoPedido]),
     ];
     if (p.rede)
-        linhas.push('', 'Rede por pessoa (RM-053)', ...linhasDaRede(p.rede, p.consultadoEm, p.fuso));
+        linhas.push('', m.redePorPessoa, ...linhasDaRede(p.rede, p.consultadoEm, p.fuso));
     if (p.lacunas.length)
-        linhas.push('', 'Lacunas da consulta', ...p.lacunas.map(linhaDaLacuna));
+        linhas.push('', m.lacunasDaConsulta, ...p.lacunas.map(linhaDaLacuna));
     for (const x of p.projetos) {
         // Cada projeto no fuso do dono dele (achado 5 da rodada 2): a legenda do bloco diz quando difere.
         const fuso = x.projeto.fuso;
         linhas.push('', '────────', '');
         // Fatia 2 do ensaio (P7): o fuso ja sai no fim do panorama (e no bloco, quando difere): sem a legenda do status.
         linhas.push(x.roadmap ? (0, roadmap_status_1.textoDoStatusDoRoadmap)(x.roadmap, fuso, { legenda: false })
-            : `Roadmap do ${x.projeto.nome}: não lido (${x.lacunas.map((l) => l.tipo).filter((t) => t !== 'projeto.sem-clone').join(', ') || 'sem fonte'}).`);
-        linhas.push('', 'Threads por máquina', ...linhasDasMaquinas(x, fuso));
-        linhas.push('', 'Reservas', ...linhasDasReservas(x, fuso));
-        linhas.push('', 'Fontes', ...(x.fontes.length ? x.fontes.map((f) => linhaDaFonte(f, p.consultadoEm, fuso)) : ['• nenhuma fonte lida']));
-        linhas.push('', 'Lacunas', ...(x.lacunas.length ? x.lacunas.map(linhaDaLacuna) : ['• nenhuma: todas as fontes foram lidas agora']));
+            : m.roadmapNaoLido(x.projeto.nome, x.lacunas.map((l) => l.tipo).filter((t) => t !== 'projeto.sem-clone').join(', ') || m.semFonte));
+        linhas.push('', m.threadsPorMaquina, ...linhasDasMaquinas(x, fuso));
+        linhas.push('', m.reservas, ...linhasDasReservas(x, fuso));
+        linhas.push('', m.fontes, ...(x.fontes.length ? x.fontes.map((f) => linhaDaFonte(f, p.consultadoEm, fuso)) : [m.nenhumaFonte]));
+        linhas.push('', m.lacunas, ...(x.lacunas.length ? x.lacunas.map(linhaDaLacuna) : [m.nenhumaLacuna]));
+        // A legenda e a da hora da leitura, como os horarios do panorama: com a de agora, o horario de verao mudava o texto.
         if (fuso !== p.fuso)
-            linhas.push('', `Neste projeto: ${(0, horario_1.legendaDoFuso)(fuso)}`);
+            linhas.push('', m.nesteProjeto((0, horario_1.legendaDoFuso)(fuso, p.consultadoEm)));
     }
-    linhas.push('', (0, horario_1.legendaDoFuso)(p.fuso));
+    linhas.push('', (0, horario_1.legendaDoFuso)(p.fuso, p.consultadoEm));
     return linhas.join('\n');
 }