@orkastery/cli 0.5.0 → 0.5.3

package/dist/memoria.js

@@ -172,7 +172,7 @@ function abrirMemoria(carregado, opcoes = {}) {
     const { estado, driver } = (0, orkmind_1.resolverRegime)(carregado.manifesto, opcoes.driver ?? null);
     const ativo = estado.efetivo === 'orkmind' && driver !== null;
     const config = (0, orkmind_1.configDoManifesto)(carregado.manifesto);
-    const embeddings = (universo) => estadoDeEmbeddings(carregado.manifesto, ativo ? driver?.disponivel().saude ?? null : null, carregado.raiz, estado.tenant, config.dsn, { universo });
+    const embeddings = (leitura = {}) => estadoDeEmbeddings(carregado.manifesto, ativo ? driver?.disponivel().saude ?? null : null, carregado.raiz, estado.tenant, config.dsn, leitura);
     if (estado.pedido === 'orkmind')
         estado.embeddings = embeddings();
     const consultarRestrito = (collection, tags) => {
@@ -250,10 +250,30 @@ function abrirMemoria(carregado, opcoes = {}) {
                 return null;
             return driver.exportar(colecao).find((e) => e.id === id) ?? null;
         },
+        universo(tenant) {
+            // A fronteira do manifesto vale antes de qualquer leitura: tenant e so o configurado.
+            if (tenant !== estado.tenant)
+                throw new Error('memory.tenant.mismatch');
+            if (leituraRestrita)
+                throw new Error('memory.query.invalid');
+            if (!ativo || !driver)
+                throw new Error('memory.universo.indisponivel');
+            if (typeof driver.universo !== 'function')
+                throw new Error('memory.universo.unsupported');
+            return driver.universo(tenant);
+        },
     };
-    // A cobertura precisa do universo do tenant (um export por colecao): so quando pedida.
+    // RM-038: a cobertura precisa do universo da busca (uma leitura pela ponte): so quando pedida. Falha
+    // de leitura (janela saturada, fronteira violada) vira motivo tipado no estado, nunca cobertura inventada.
     if (opcoes.embeddings === 'detalhado' && ativo && !leituraRestrita) {
-        estado.embeddings = embeddings((0, indice_vetorial_1.universoDoTenant)(memoria, estado.tenant));
+        let leitura;
+        try {
+            leitura = { universo: (0, indice_vetorial_1.universoDaBusca)(memoria, estado.tenant) };
+        }
+        catch (erro) {
+            leitura = { falhaDoUniverso: (0, indice_vetorial_1.codigoDaFalha)(erro) };
+        }
+        estado.embeddings = embeddings(leitura);
     }
     return memoria;
 }
@@ -300,6 +320,7 @@ function estadoDeEmbeddings(manifesto, saude, raiz, tenant, dsn, opcoes = {}) {
     const estado = {
         configurado, provider: config.provider, modelo: configurado ? config.model : null, dim: configurado ? config.dim : null,
         variavelDaChave: variavel, chavePresente, fallback, indices: [], entradas: null, cobertura: null,
+        universo: null, aviso: null, falhaDoUniverso: null,
         ativo: 'nenhum', sondado: saude !== null, motivo: null, detalhe: '', correcao: '',
     };
     if (!configurado) {
@@ -331,13 +352,24 @@ function estadoDeEmbeddings(manifesto, saude, raiz, tenant, dsn, opcoes = {}) {
         estado.correcao = `exporte ${variavel} com a chave dedicada ao Orkastery; o valor nunca vai ao manifesto`;
     }
     if (opcoes.universo) {
-        const universo = opcoes.universo.filter(e => (e.tags.project ?? []).includes(tenant));
+        // RM-038: o universo vem de universoDaBusca; a fronteira vale de novo antes de contar.
+        if (opcoes.universo.tenant !== tenant)
+            throw new Error('memory.query.scope-violation');
+        (0, indice_vetorial_1.conferirUniverso)(opcoes.universo.entradas, tenant, opcoes.universo.lidoEm);
+        const universo = opcoes.universo.entradas;
         estado.indices = indicesDoTenant(raiz, tenant, base, universo);
         estado.entradas = universo.length;
+        estado.universo = { porColecao: { ...opcoes.universo.porColecao }, foraDaBusca: opcoes.universo.foraDaBusca,
+            ...(opcoes.universo.latenciaMs === undefined ? {} : { latenciaMs: opcoes.universo.latenciaMs }) };
         const referencia = estado.ativo === 'fallback' ? { modelo: fallback.modelo, dim: fallback.dim } : { modelo: config.model, dim: config.dim };
         const indice = estado.indices.find(i => i.modelo === referencia.modelo && i.dim === referencia.dim);
-        estado.cobertura = universo.length === 0 ? 0 : Math.round(((indice?.coerentes ?? 0) / universo.length) * 10_000) / 10_000;
+        const coerentes = indice?.coerentes ?? 0;
+        estado.cobertura = universo.length === 0 ? 0 : Math.round((coerentes / universo.length) * 10_000) / 10_000;
+        // RM-038 (D7): o indice que a busca usa cobre menos do que ela enxerga: dito, nunca escondido.
+        estado.aviso = (0, indice_vetorial_1.avisoDeCobertura)(coerentes, universo, estado.ativo);
     }
+    else if (opcoes.falhaDoUniverso)
+        estado.falhaDoUniverso = opcoes.falhaDoUniverso;
     return estado;
 }
 /**
@@ -1098,12 +1130,22 @@ function textoDosEmbeddings(e) {
             `dependencias ${e.fallback.dependencias ? 'ok' : e.sondado ? 'ausentes' : 'nao sondadas'}` : '(nao declarado)'}`);
         linhas.push(`  caminho ativo         ${e.ativo}${e.sondado ? '' : ' (ponte nao sondada)'}`);
     }
+    if (e.universo) {
+        const colecoes = Object.entries(e.universo.porColecao).map(([c, n]) => `${c} ${n}`).join(', ');
+        linhas.push(`  universo da busca     ${e.entradas} entrada(s) do tenant: ${colecoes}`);
+        linhas.push(`  fora da busca         ${(0, indice_vetorial_1.textoForaDaBusca)(e.universo.foraDaBusca)}`);
+    }
+    else if (e.falhaDoUniverso) {
+        linhas.push(`  universo da busca     nao lido (${e.falhaDoUniverso}); cobertura nao calculada`);
+    }
     for (const i of e.indices) {
         linhas.push(`  indice                ${i.modelo} / ${i.dim} dim: ${i.vetores} vetor(es), ${i.coerentes ?? '?'} coerente(s), ${i.desatualizados ?? '?'} desatualizado(s)`);
     }
     if (e.entradas !== null) {
-        linhas.push(`  cobertura             ${e.cobertura === null ? '-' : `${Math.round(e.cobertura * 1000) / 10}%`} de ${e.entradas} entrada(s) do tenant`);
+        linhas.push(`  cobertura             ${e.cobertura === null ? '-' : `${Math.round(e.cobertura * 1000) / 10}%`} de ${e.entradas} entrada(s) do universo da busca`);
     }
+    if (e.aviso)
+        linhas.push(`  aviso                 ${e.aviso}`);
     if (e.sonda) {
         linhas.push(`  sonda                 ${e.sonda.ok ? `${e.sonda.alvo} respondeu em ${e.sonda.latenciaMs} ms` : `sem resposta (${e.sonda.motivo ?? 'sem caminho ativo'})`}`);
     }

package/dist/network-roadmap.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErroDoPedidoDeProjeto = exports.SAIDA_DO_PEDIDO = exports.LIMIAR_SEM_BATIDA_MS = exports.CONTRATO_REGISTRO_DE_PROJETOS = exports.CONTRATO_PANORAMA_DA_REDE = void 0;
 exports.projetosConhecidos = projetosConhecidos;
 exports.resolverProjeto = resolverProjeto;
+exports.redeDoProjetoFixado = redeDoProjetoFixado;
 exports.montarPanoramaDaRede = montarPanoramaDaRede;
 exports.textoDoPanoramaDaRede = textoDoPanoramaDaRede;
 /**
@@ -62,6 +63,11 @@ exports.textoDoPanoramaDaRede = textoDoPanoramaDaRede;
  *
  * Na fatia 2, os hosts chegam aqui por dois modos: `host` (gateway sem cwd de projeto, a regra da
  * RM-052 no `--projeto` proprio do `network`) e `fixado` (o servidor MCP, que le so o projeto dele).
+ *
+ * Na fatia 3, a rede por pessoa da RM-053 (`ork.rede-status/v1`) entra como fonte: as maquinas da
+ * casa, com a batida de cada uma, os projetos que elas declaram (um projeto sem clone nem registro
+ * nesta maquina passa a ser conhecido pelo nome) e a maquina que esta na rede mas nao publicou na
+ * fabrica do projeto, dita como lacuna e nunca como "0 threads".
  */
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
@@ -70,6 +76,7 @@ const path = __importStar(require("node:path"));
 const branch_de_estado_1 = require("./branch-de-estado");
 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 horario_1 = require("./horario");
 const estado_thread_1 = require("./estado-thread");
@@ -77,6 +84,9 @@ const manifest_1 = require("./manifest");
 const maquina_1 = require("./maquina");
 const modos_1 = require("./modos");
 const projeto_alvo_1 = require("./projeto-alvo");
+const rede_1 = require("./rede");
+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 thread_1 = require("./thread");
@@ -85,8 +95,6 @@ const yaml_1 = require("./yaml");
 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';
-/** Maquina sem retrato novo ha mais disto esta sem batida: o mesmo limiar da rede (RM-053, `SEM_BATIDA_MS`). */
-exports.LIMIAR_SEM_BATIDA_MS = 3 * 60 * 60 * 1000;
 /** A recusa de projeto sai com o mesmo codigo da RM-052. */
 exports.SAIDA_DO_PEDIDO = 4;
 /** A recusa do `--projeto`, com os mesmos codigos da RM-052: o nucleo nunca chuta. */
@@ -119,9 +127,8 @@ const lacuna = (tipo, parte, alvo, detalhe, correcao) => ({ tipo, parte, ...(alv
 /**
  * Nome de remoto do git, como `origin`. O valor vem do manifesto versionado (`fabrica.remoto`), e um
  * valor que comece com `-` viraria opcao do `git fetch` (`--upload-pack=...`): so este formato chega
- * ao git (achado 4 do CHECK).
+ * ao git (achado 4 do CHECK). O validador e o mesmo da branch de estado (RM-047).
  */
-const REMOTO = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 /**
  * Nome de branch base, como `main`. Tambem vem do manifesto (`worktree.base_branch`), e o `git log`
  * da base o recebia cru: `--output=<arquivo>` gravava um arquivo (rodada 2 do CHECK).
@@ -129,7 +136,7 @@ const REMOTO = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
 const baseValida = (base) => typeof base === 'string' && /^[A-Za-z0-9][A-Za-z0-9._/-]{0,99}$/.test(base) && !base.includes('..');
 function projetoDoClone(c, origem) {
     const remoto = c.manifesto.fabrica.remoto;
-    const url = REMOTO.test(remoto) ? (0, branch_de_estado_1.git)(c.raiz, ['remote', 'get-url', remoto]) : null;
+    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,
         base: c.manifesto.worktree.base_branch, remoto, origem };
 }
@@ -423,19 +430,19 @@ function maquinasDoPanorama(retratos, local, ctx, lacunas) {
         if (local && m.maquina === local.maquina)
             continue;
         const idadeMs = Math.max(0, agora - Date.parse(m.publicadoEm));
-        const semBatida = idadeMs > exports.LIMIAR_SEM_BATIDA_MS;
+        const semBatida = idadeMs > fabrica_estado_1.LIMIAR_SEM_BATIDA_MS;
         if (semBatida) {
             lacunas.push(lacuna('maquina.sem-batida', 'fabrica', m.maquina, `${m.maquina} sem retrato novo há ${(0, horario_1.duracaoCurta)(Math.floor(idadeMs / 60000))} (último em ${(0, horario_1.formatarDataHora)(m.publicadoEm, { fuso: ctx.fuso })}): ` +
                 'as threads dela podem ter andado', `confira a ${m.maquina}: ela publica ao criar thread, despachar fase, entregar e a cada batida do pulse`));
         }
         saida.push({ maquina: m.maquina, por: m.por, publicadoEm: m.publicadoEm, idadeMin: Math.floor(idadeMs / 60000), semBatida,
             estaMaquina: m.maquina === ctx.maquina, origem: 'retrato', versaoOrk: m.versaoOrk ?? null,
-            ativas: m.threads.filter((t) => !t.entregue), entreguesSemMaster: m.threads.filter((t) => t.entregue).length });
+            ativas: m.threads.filter((t) => !t.entregue), entreguesSemMaster: m.threads.filter((t) => t.entregue).length, threadsLidas: true });
     }
     if (local) {
         saida.push({ maquina: local.maquina, por: local.por, publicadoEm: local.publicadoEm, idadeMin: 0, semBatida: false, estaMaquina: true,
             origem: 'estado-local', versaoOrk: local.versaoOrk, ativas: local.threads.filter((t) => !t.entregue),
-            entreguesSemMaster: local.threads.filter((t) => t.entregue).length });
+            entreguesSemMaster: local.threads.filter((t) => t.entregue).length, threadsLidas: true });
     }
     return saida.sort((a, b) => a.maquina.localeCompare(b.maquina));
 }
@@ -572,8 +579,8 @@ function lerProjetoDoClone(p, geral) {
     const carregado = (0, manifest_1.carregarManifesto)(raiz);
     // O fuso do dono deste projeto vale para o dia e os horarios dele (achado 5 do CHECK).
     const ctx = { ...geral, fuso: carregado?.manifesto.owner?.timezone ?? geral.fuso };
-    if (!REMOTO.test(remoto)) {
-        lacunas.push(lacuna('projeto.remoto-invalido', 'projeto', raizParaExibir(raiz), `fabrica.remoto do manifesto (${JSON.stringify(remoto).slice(0, 60)}) não é nome de remoto do git: nada foi lido pelo git`, 'corrija fabrica.remoto no orkastery.yaml (padrão: origin)'));
+    if (!(0, branch_de_estado_1.remotoValido)(remoto)) {
+        lacunas.push(lacuna('projeto.remoto-invalido', 'projeto', raizParaExibir(raiz), `fabrica.remoto do manifesto (${(0, branch_de_estado_1.remotoRedigido)(remoto)}) não é nome de remoto do git: nada foi lido pelo git`, 'corrija fabrica.remoto no orkastery.yaml (padrão: origin)'));
         return montarProjeto(p, { nome: p.nome, docs: null, reservas: null, retratos: null, local: null, commits: [] }, ctx, fontes, lacunas);
     }
     if (!baseValida(p.base ?? 'main') || (carregado && !baseValida(carregado.manifesto.worktree.base_branch))) {
@@ -785,6 +792,134 @@ function lerProjeto(p, ctx) {
         return vazio(lacuna('projeto.sem-leitura', 'projeto', p.raiz ? raizParaExibir(p.raiz) : p.nome, `a leitura de ${p.nome} parou: ${(0, forja_1.detalheSeguro)(e?.message ?? String(e))}`, 'confira o clone e o estado dele no próprio projeto; os outros projetos seguiram'));
     }
 }
+// ---------------------------------------------------------------------------
+// A rede por pessoa (fatia 3).
+// ---------------------------------------------------------------------------
+/** As lacunas do `ork.rede-status/v1` que sao da casa (forja, casa, retrato), e nao da fabrica de um projeto. */
+const lacunaDaCasa = (tipo) => tipo.startsWith('forja.') || tipo.startsWith('rede.') || tipo === 'retrato.invalido' || tipo === 'maquina.nome-em-uso';
+const CORRECAO_DA_CASA = {
+    'forja.ausente': 'instale o gh (ou o glab) nesta máquina',
+    'forja.sem-login': 'gh auth login (ou glab auth login) nesta máquina',
+    'rede.sem-repositorio': 'ork network entrar numa máquina da pessoa',
+    'maquina.nome-em-uso': 'ork network entrar --maquina NOME ou --forcar',
+};
+/** A rede lida para o panorama, ou o motivo de nao ter lido (vai ao `naoConsultado`). */
+function lerRedeDoPanorama(opcoes, ctx, cwd) {
+    if (opcoes.rede === false)
+        return { status: null, motivo: 'não lida nesta chamada' };
+    if (opcoes.rede)
+        return { status: opcoes.rede, motivo: null };
+    if ((process.env.ORK_REDE_LER ?? '').trim() === '0')
+        return { status: null, motivo: 'leitura desligada (ORK_REDE_LER=0)' };
+    try {
+        // D-G6 da fatia 2: no host, o diretorio do gateway nao e projeto; a rede le so o registro e os retratos.
+        return { status: (0, rede_status_1.lerRede)({ semRemoto: ctx.semRemoto, maquina: opcoes.maquina, agora: ctx.quando, diretorio: opcoes.host ? null : cwd }),
+            motivo: null };
+    }
+    catch (e) {
+        return { status: null, motivo: `a leitura parou: ${(0, forja_1.detalheSeguro)(e?.message ?? String(e))}` };
+    }
+}
+/** O projeto que um retrato declara casa com o projeto do panorama: pela forja, ou pelo nome quando falta a forja. */
+function declara(q, p, nome) {
+    const forja = q.remoto ? (0, forja_1.identidadeDaForja)(q.remoto) : null;
+    if (forja && p.forja)
+        return (0, forja_1.mesmaForja)(forja, p.forja);
+    return (0, rede_projetos_1.emUmaLinha)(q.nome) === nome;
+}
+/** Os projetos que as maquinas da rede declaram com remoto de forja e que esta maquina nao conhece. */
+function projetosDaRede(status, conhecidos) {
+    const saida = [];
+    for (const m of status.membros) {
+        if (m.origem !== 'rede')
+            continue;
+        for (const q of m.projetos) {
+            const nome = (0, rede_projetos_1.emUmaLinha)(q.nome);
+            const forja = q.remoto ? (0, forja_1.identidadeDaForja)(q.remoto) : null;
+            if (!forja || !projeto_alvo_1.PADRAO_DO_NOME_DE_PROJETO.test(nome))
+                continue;
+            const p = { nome, forja, raiz: null, base: null, remoto: 'origin', origem: 'rede' };
+            if (![...conhecidos, ...saida].some((x) => mesmoProjeto(x, p)))
+                saida.push(p);
+        }
+    }
+    return saida;
+}
+/**
+ * Suspeitas da revisao de 03/10 (mesma raiz do defeito 3 da revisao): o retrato com o nome desta
+ * maquina e de outra instalacao quando o status diz `nomeEmUso`; entao nenhum retrato da rede e "esta
+ * maquina". `null` nesse caso; senao, o nome saneado desta maquina.
+ */
+function euNaRede(status, ctx) {
+    const eu = (0, rede_1.nomeSeguro)(ctx.maquina);
+    return status.estaMaquina.maquina === eu && status.estaMaquina.nomeEmUso ? null : eu;
+}
+/** A rede no panorama; no MCP fixado, os projetos de cada maquina ficam so o servido (D5 da RM-052). */
+function redeNoPanorama(status, ctx, servido) {
+    const agora = Date.parse(ctx.quando);
+    const fonte = status.fontes.find((f) => f.fonte === 'rede');
+    const eu = euNaRede(status, ctx);
+    const membros = status.membros.filter((m) => m.origem === 'rede').map((m) => {
+        const idadeMs = agora - Date.parse(m.publicadoEm);
+        const idadeMin = Number.isFinite(idadeMs) ? Math.floor(Math.max(0, idadeMs) / 60000) : null;
+        const projetos = m.projetos.filter((q) => !servido || declara(q, servido.p, servido.nome)).map((q) => (0, rede_projetos_1.emUmaLinha)(q.nome));
+        return { maquina: (0, rede_projetos_1.emUmaLinha)(m.maquina), estaMaquina: m.maquina === eu, publicadoEm: m.publicadoEm, idadeMin,
+            semBatida: idadeMin === null || idadeMin * 60000 > fabrica_estado_1.LIMIAR_SEM_BATIDA_MS, versaoOrk: m.versaoOrk ? (0, rede_projetos_1.emUmaLinha)(m.versaoOrk) : null,
+            projetos: [...new Set(projetos)] };
+    });
+    return { casa: status.casa ? (0, rede_1.refDaCasa)(status.casa) : null, ponta: fonte?.ponta ?? null, atualizado: fonte ? fonte.atualizado : null,
+        lidoEm: status.consultadoEm, membros };
+}
+/**
+ * A maquina da rede que declara o projeto e nao publicou na fabrica dele entra na lista com as
+ * threads NAO lidas e uma lacuna: antes ela sumia, e a lista parecia completa.
+ */
+function completarComARede(x, p, status, ctx) {
+    if (x.maquinas === null)
+        return;
+    const agora = Date.parse(ctx.quando);
+    for (const m of status.membros) {
+        if (m.origem !== 'rede' || !m.projetos.some((q) => declara(q, p, x.projeto.nome)))
+            continue;
+        if (x.maquinas.some((y) => (0, rede_1.nomeSeguro)(y.maquina) === m.maquina))
+            continue;
+        const maquina = (0, rede_projetos_1.emUmaLinha)(m.maquina);
+        const idadeMs = agora - Date.parse(m.publicadoEm);
+        const legivel = Number.isFinite(idadeMs);
+        const idadeMin = legivel ? Math.floor(Math.max(0, idadeMs) / 60000) : 0;
+        const semBatida = !legivel || idadeMin * 60000 > fabrica_estado_1.LIMIAR_SEM_BATIDA_MS;
+        x.maquinas.push({ maquina, por: 'rede por pessoa', publicadoEm: m.publicadoEm, idadeMin, semBatida, estaMaquina: m.maquina === euNaRede(status, ctx),
+            origem: 'rede', versaoOrk: m.versaoOrk ? (0, rede_projetos_1.emUmaLinha)(m.versaoOrk) : null, ativas: [], entreguesSemMaster: 0, threadsLidas: false });
+        x.lacunas.push(lacuna('maquina.sem-fabrica', 'fabrica', maquina, `${maquina} está na rede por pessoa e declara ${x.projeto.nome}, mas não tem retrato em ${fabrica_estado_1.BRANCH_DA_FABRICA}: as threads dela neste projeto não foram lidas`, `na ${maquina}, rode ork fabrica entrar no clone de ${x.projeto.nome} (ou atualize o ork dela)`));
+        if (semBatida) {
+            x.lacunas.push(lacuna('maquina.sem-batida', 'rede', maquina, `${maquina} sem retrato novo na rede ${legivel
+                ? `há ${(0, horario_1.duracaoCurta)(idadeMin)}` : '(batida ilegível)'}`, `confira a ${maquina}: ela publica na batida do pulse`));
+        }
+    }
+    x.maquinas.sort((a, b) => a.maquina.localeCompare(b.maquina));
+}
+/**
+ * Fatia 3: o `ork network status` do servidor MCP fixado. A rede e da pessoa, mas o retrato de cada
+ * maquina lista todos os projetos dela: aqui fica so o projeto servido (D5 da RM-052), e o resto vai
+ * ao "nao consultado". Com `ORK_REDE_LER=0`, a casa e lida so da ultima copia desta maquina.
+ */
+function redeDoProjetoFixado(raiz, opcoes = {}) {
+    const c = (0, manifest_1.carregarManifesto)(raiz);
+    if (!c) {
+        throw new ErroDoPedidoDeProjeto('projeto.sem-manifesto', `a raiz fixada não tem ${manifest_1.NOME_MANIFESTO}`, [], 'confira a raiz fixada na instalação do servidor MCP (ork mcp install --project <raiz>)');
+    }
+    const p = projetoDoClone(c, 'instalacao');
+    const s = opcoes.status ?? (0, rede_status_1.lerRede)({ semRemoto: opcoes.semRemoto === true || (process.env.ORK_REDE_LER ?? '').trim() === '0', diretorio: c.raiz,
+        soRaiz: c.raiz });
+    const membros = s.membros.map((m) => ({ ...m, projetos: m.projetos.filter((q) => declara(q, p, p.nome)) }))
+        .filter((m) => m.origem === 'rede' || m.projetos.length > 0);
+    // Revisao de 03/10 (D5): a lacuna de uma maquina que saiu dos membros (vista so em outro projeto) sai junto.
+    const nomes = new Set(membros.map((m) => m.maquina));
+    return { ...s, membros, fontes: s.fontes.filter((f) => !f.projeto || f.projeto === p.nome),
+        lacunas: s.lacunas.filter((l) => (!l.projeto || l.projeto === p.nome) &&
+            (!l.maquina || l.tipo === 'maquina.nome-em-uso' || nomes.has(l.maquina))),
+        naoConsultado: [...s.naoConsultado, `outros projetos das máquinas (este servidor MCP mostra só ${p.nome}; os outros vêm do CLI ork network status)`] };
+}
 /**
  * `ork network roadmap`: os projetos pedidos (ou todos os conhecidos), cada um com roadmap, reservas,
  * threads por maquina, fontes e lacunas. Recusa o `--projeto` ambiguo ou desconhecido.
@@ -794,11 +929,21 @@ function montarPanoramaDaRede(opcoes = {}) {
     const cwd = opcoes.cwd ?? process.cwd();
     const ctx = { quando, maquina: (0, maquina_1.nomeDaMaquina)(opcoes.maquina), semRemoto: opcoes.semRemoto === true, executor: opcoes.executor,
         fuso: (0, horario_1.fusoDoDono)().fuso };
-    const naoConsultado = [
-        'rede por pessoa (RM-053, ork.rede-status/v1): não lida nesta versão; as máquinas vêm da branch ork/fabrica-estado de cada projeto',
-    ];
+    const naoConsultado = [];
     const lacunas = [];
+    const lida = lerRedeDoPanorama(opcoes, ctx, cwd);
+    const status = lida.status;
+    if (!status)
+        naoConsultado.push(`rede por pessoa (RM-053, ork.rede-status/v1): ${lida.motivo}; as máquinas vêm da branch ${fabrica_estado_1.BRANCH_DA_FABRICA} de cada projeto`);
+    else {
+        for (const l of status.lacunas) {
+            if (!lacunaDaCasa(l.tipo) || l.projeto)
+                continue;
+            lacunas.push(lacuna(l.tipo, 'rede', l.maquina, (0, forja_1.detalheSeguro)((0, rede_projetos_1.emUmaLinha)(l.detalhe)), CORRECAO_DA_CASA[l.tipo] ?? 'confira com ork network status'));
+        }
+    }
     let alvos;
+    let servido = null;
     if (opcoes.fixado !== undefined) {
         // D-G5 (fatia 2): o servidor MCP le so o projeto dele, em todas as maquinas; o registro nao e lido.
         const c = (0, manifest_1.carregarManifesto)(opcoes.fixado);
@@ -806,6 +951,7 @@ function montarPanoramaDaRede(opcoes = {}) {
             throw new ErroDoPedidoDeProjeto('projeto.sem-manifesto', `a raiz fixada não tem ${manifest_1.NOME_MANIFESTO}`, [], 'confira a raiz fixada na instalação do servidor MCP (ork mcp install --project <raiz>)');
         }
         alvos = [projetoDoClone(c, 'instalacao')];
+        servido = { p: alvos[0], nome: alvos[0].nome };
         naoConsultado.push('outros projetos desta máquina: este servidor MCP lê só o projeto fixado na instalação; ' +
             'os outros vêm do CLI `ork network roadmap`');
     }
@@ -813,17 +959,19 @@ function montarPanoramaDaRede(opcoes = {}) {
         const conhecidos = projetosConhecidos({ cwd, registro: opcoes.registro, host: opcoes.host });
         naoConsultado.push(...conhecidos.naoConsultado);
         lacunas.push(...conhecidos.lacunas);
+        // Fatia 3: o projeto que uma maquina da rede declara passa a ser conhecido, lido pela forja.
+        const todos = [...conhecidos.projetos, ...(status ? projetosDaRede(status, conhecidos.projetos) : [])];
         if (opcoes.pedido !== undefined) {
             if (opcoes.host)
-                exigirPedidoDoHost(opcoes.pedido, conhecidos.projetos);
-            const alvo = resolverProjeto(opcoes.pedido, conhecidos.projetos, cwd);
+                exigirPedidoDoHost(opcoes.pedido, todos);
+            const alvo = resolverProjeto(opcoes.pedido, todos, cwd);
             alvos = [alvo];
-            for (const p of conhecidos.projetos)
+            for (const p of todos)
                 if (!mesmoProjeto(p, alvo))
                     naoConsultado.push(`projeto ${p.nome}: fora do pedido (--projeto)`);
         }
         else {
-            alvos = conhecidos.projetos;
+            alvos = todos;
         }
     }
     if (alvos.length === 0) {
@@ -832,9 +980,15 @@ function montarPanoramaDaRede(opcoes = {}) {
             : 'nenhum projeto conhecido nesta máquina: sem manifesto no diretório atual e sem registro', opcoes.host ? 'peça o projeto pela forja (--projeto github:dono/repo) ou registre o clone com `ork projetos registrar <caminho>`'
             : 'peça o projeto: --projeto <caminho do clone> ou --projeto github:dono/repo'));
     }
-    const projetos = alvos.map((p) => lerProjeto(p, ctx));
+    const projetos = alvos.map((p) => {
+        const x = lerProjeto(p, ctx);
+        if (status)
+            completarComARede(x, p, status, ctx);
+        return x;
+    });
     return { contrato: exports.CONTRATO_PANORAMA_DA_REDE, consultadoEm: quando, maquina: ctx.maquina, pedido: opcoes.pedido ?? null,
-        limiarSemBatidaMin: exports.LIMIAR_SEM_BATIDA_MS / 60000, fuso: projetos[0]?.projeto.fuso ?? ctx.fuso, projetos, naoConsultado, lacunas };
+        limiarSemBatidaMin: fabrica_estado_1.LIMIAR_SEM_BATIDA_MS / 60000, fuso: projetos[0]?.projeto.fuso ?? ctx.fuso, projetos,
+        rede: status ? redeNoPanorama(status, ctx, servido) : null, naoConsultado, lacunas };
 }
 // ---------------------------------------------------------------------------
 // O texto.
@@ -860,6 +1014,11 @@ function linhasDasMaquinas(x, fuso) {
         return ['• nenhuma máquina publicou em ork/fabrica-estado'];
     return x.maquinas.flatMap((m) => {
         const quem = `${m.maquina}${m.estaMaquina ? ' (esta máquina)' : ''}`;
+        // 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}`];
+        }
         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}`;
@@ -876,6 +1035,19 @@ function linhasDasReservas(x, fuso) {
         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 })}`);
 }
+/** 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'}`;
+    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'))];
+}
 const linhaDaLacuna = (l) => `• ${l.tipo}${l.alvo ? ` (${l.alvo})` : ''}: ${l.detalhe}. O que fazer: ${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) {
@@ -887,13 +1059,16 @@ function textoDoPanoramaDaRede(p) {
         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']),
     ];
+    if (p.rede)
+        linhas.push('', 'Rede por pessoa (RM-053)', ...linhasDaRede(p.rede, p.consultadoEm, p.fuso));
     if (p.lacunas.length)
         linhas.push('', 'Lacunas da consulta', ...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('', '────────', '');
-        linhas.push(x.roadmap ? (0, roadmap_status_1.textoDoStatusDoRoadmap)(x.roadmap, fuso)
+        // 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));

package/dist/ocupacao.js

@@ -28,6 +28,7 @@ exports.faseTemPausaPrevista = faseTemPausaPrevista;
 exports.sessaoLivreDaVaga = sessaoLivreDaVaga;
 exports.avaliarOcupacao = avaliarOcupacao;
 const ledger_1 = require("./ledger");
+const impedimento_1 = require("./impedimento");
 const sessoes_adopt_1 = require("./sessoes-adopt");
 /** Estado que o `ork phase run` grava quando o bloco despachado pausa ao fim. */
 exports.PAUSA_PREVISTA = 'prevista ao fim do bloco';
@@ -91,9 +92,11 @@ function ultimaAtividadeEm(eventos) {
  * despacho e a sessao roda ate o fim do bloco. O impedimento de verify tambem nao: a sessao corrige e
  * verifica de novo. Somente leitura.
  */
-function sessaoLivreDaVaga(eventos, desde, agora, staleMin, 
+function sessaoLivreDaVaga(doLedger, desde, agora, staleMin, 
 /** A-3 do CHECK 4: o bloqueio no runtime e por sessao; o de outra sessao (a sucedida) nao libera esta. */
 sessionId) {
+    // Fatia 2 do ensaio da 0.5.0 (P2): evento de `--dry-run` nao e atividade nem parada.
+    const eventos = doLedger.filter((e) => !(0, ledger_1.ehEnsaio)(e));
     const ultima = ultimaAtividadeEm(eventos);
     if (ultima !== null && minutos(ultima, agora) >= staleMin)
         return 'stale';
@@ -124,7 +127,8 @@ function pausaHumanaAberta(thread, eventos) {
     for (let i = 0; i < eventos.length; i++) {
         const e = eventos[i];
         const prevista = ehPausaPrevista(e);
-        const escalada = e.tipo === ledger_1.TIPOS_DE_EVENTO.gateBloqueado && e.motivo === 'human.pending';
+        // RM-055: o impedimento do despacho que so o dono resolve tambem e pausa humana: nao ocupa vaga.
+        const escalada = (0, impedimento_1.ehEsperaDoDono)(e, ledger_1.TIPOS_DE_EVENTO.gateBloqueado);
         if (!prevista && !escalada)
             continue;
         const iFase = indiceDaFase(e.fase);
@@ -141,11 +145,16 @@ function pausaHumanaAberta(thread, eventos) {
         });
         if (resolvida)
             continue;
+        // Ensaio de 03/10/2026 (RM-049): a escalada traz a correcao gravada no gate (no impedimento do dono,
+        // o comando dele e o `ork retry run`); o board a mostra, em vez de um `ork gate request` que o
+        // modo sem pausa prevista recusa.
+        const correcao = escalada && typeof e.correcao === 'string' && e.correcao !== '' ? e.correcao : undefined;
         return {
             desdeEm: e.ts,
             evidencia: prevista
                 ? `ledger ${ledger_1.TIPOS_DE_EVENTO.pausaHumana} (${exports.PAUSA_PREVISTA}) em ${e.ts}`
-                : `ledger ${ledger_1.TIPOS_DE_EVENTO.gateBloqueado} (human.pending) em ${e.ts}`,
+                : `ledger ${ledger_1.TIPOS_DE_EVENTO.gateBloqueado} (${String(e.motivo)}) em ${e.ts}`,
+            ...(correcao ? { correcao } : {}),
         };
     }
     return null;
@@ -160,7 +169,7 @@ function impedimentoAberto(eventos) {
             continue;
         const motivo = e.motivo;
         // `human.pending` ja e pausa humana; `claims.unverifiable` avisa mas nao bloqueia.
-        if (motivo === 'human.pending' || motivo === 'claims.unverifiable')
+        if (motivo === 'human.pending' || motivo === 'claims.unverifiable' || (0, impedimento_1.ehImpedimentoDoDono)(motivo))
             continue;
         const resolvido = eventos
             .slice(i + 1)
@@ -196,7 +205,9 @@ function minutos(desdeEm, ateEm) {
  *      anterior terminada ou o runtime nao consultado), e entra por FIFO quando
  *      houver vaga -- e ai conta contra o limite, como sempre contou.
  */
-function avaliarOcupacao(thread, eventos, opcoes) {
+function avaliarOcupacao(thread, doLedger, opcoes) {
+    // Fatia 2 do ensaio da 0.5.0 (P2): o ensaio do ship (`dryRun: true`) nao pausa a thread no board.
+    const eventos = doLedger.filter((e) => !(0, ledger_1.ehEnsaio)(e));
     const sessionId = ultimaSessao(thread, eventos);
     const sessaoEstado = opcoes.estados === null || sessionId === null
         ? null
@@ -244,6 +255,7 @@ function avaliarOcupacao(thread, eventos, opcoes) {
             detalhe: `pausa humana aberta ha ${minutos(pausa.desdeEm, opcoes.agora)} min: ` +
                 'esperar veredito humano nao ocupa vaga da maquina',
             evidencia: pausa.evidencia,
+            ...(pausa.correcao ? { correcao: pausa.correcao } : {}),
         };
     }
     if (registro)

package/dist/onboarding.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ETAPAS_ONBOARDING = exports.PAUTA_ONBOARDING = exports.CONTRATO_ONBOARDING = void 0;
+exports.ETAPAS_ONBOARDING = exports.PAUTA_ONBOARDING = exports.ONDE_FICAM_OS_SEGREDOS = exports.CONTRATO_ONBOARDING = void 0;
 exports.caminhoOnboarding = caminhoOnboarding;
 exports.validarConteudo = validarConteudo;
 exports.jsonCanonico = jsonCanonico;
@@ -54,10 +54,15 @@ const horario_1 = require("./horario");
 const experiencia_1 = require("./experiencia");
 const yaml_1 = require("./yaml");
 exports.CONTRATO_ONBOARDING = 'ork.onboarding/v1';
+/**
+ * Fatia 2 do ensaio da 0.5.0 (P5): onde ficam os segredos, para quem usa o Hermes e para quem nao
+ * usa. Perguntas, erro e ajuda leem daqui; as docs e os hosts repetem a frase, conferida por teste.
+ */
+exports.ONDE_FICAM_OS_SEGREDOS = 'no ambiente do processo ou no cofre do host (no Hermes, ~/.hermes/.env)';
 exports.PAUTA_ONBOARDING = [
     { etapa: 'maestro', pergunta: `Quem conduz o projeto, quais são seus objetivos e preferências, e em qual fuso horário o Orkastery deve mostrar horários? Informe o fuso como nome IANA, ex.: {"fuso":"${horario_1.FUSO_DE_BRASILIA}"}; ele orienta ${horario_1.CHAVE_DO_FUSO} no manifesto, sem editá-lo. Preferências em {"owner":{...}} gravam owner no manifesto.` },
-    { etapa: 'credenciais', pergunta: 'Quais provedores públicos e nomes de variáveis em env serão usados? Segredos somente em ~/.hermes/.env; nunca informe valores.' },
-    { etapa: 'bancos', pergunta: 'Quais bancos públicos e nomes de variáveis em env configuram as conexões? Nunca informe DSN ou senha; valores somente em ~/.hermes/.env.' },
+    { etapa: 'credenciais', pergunta: `Quais provedores públicos e nomes de variáveis em env serão usados? Segredos ficam ${exports.ONDE_FICAM_OS_SEGREDOS}; nunca informe valores.` },
+    { etapa: 'bancos', pergunta: `Quais bancos públicos e nomes de variáveis em env configuram as conexões? Nunca informe DSN ou senha; valores ficam ${exports.ONDE_FICAM_OS_SEGREDOS}.` },
     { etapa: 'memoria', pergunta: 'Deseja OrkMind? Informe {"modo":"orkmind"} ou {"modo":"files"}; a escolha orienta memory.mode no manifesto, sem editá-lo.' },
     { etapa: 'produtos', pergunta: 'Quais produtos e repositórios públicos pertencem ao projeto?' },
     { etapa: 'topologia', pergunta: 'Como se distribuem ambientes e serviços? Informe identificadores públicos.' },
@@ -74,7 +79,7 @@ function objeto(v) {
         [Object.prototype, null].includes(Object.getPrototypeOf(v));
 }
 /** Recusa antes de persistir. Diagnósticos nunca incluem a entrada recebida. */
-function invalido() { throw new Error('onboarding.input.invalid: use JSON público e referências de variáveis; segredos somente em ~/.hermes/.env'); }
+function invalido() { throw new Error(`onboarding.input.invalid: use JSON público e referências de variáveis; segredos ficam ${exports.ONDE_FICAM_OS_SEGREDOS}`); }
 function textoSeguro(v) {
     return !(0, policies_1.procurarSegredos)(v).length &&
         !/[a-z][a-z0-9+.-]*:\/\/[^\s/]*@/i.test(v) &&