@orkastery/cli 0.5.1 → 0.5.3

package/dist/policies.js

@@ -11,8 +11,9 @@
  * ela volta na lista de desconhecidas, para o `doctor` e o CLI dizerem que ela nao vale.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.POLICIES_CONHECIDAS = void 0;
+exports.POLICIES_DE_PROVA_LOCAL = exports.POLICIES_CONHECIDAS = void 0;
 exports.procurarSegredos = procurarSegredos;
+exports.policyDeProvaLocal = policyDeProvaLocal;
 exports.policiesDesconhecidas = policiesDesconhecidas;
 exports.avaliarPolicies = avaliarPolicies;
 exports.avisos = avisos;
@@ -95,7 +96,28 @@ exports.POLICIES_CONHECIDAS = {
         quando: ['ship'],
         descricao: 'avisa quando a branch da thread esta atras da base',
     },
+    // RM-008 (B8): a licao `claims.failed` ("rode o comando da claim antes de registra-la"). Desligada por
+    // padrao; declarada, o `ork claims add` roda o comando uma vez no prazo do verify. So avisa, nunca para.
+    claim_sem_prova_local: {
+        quando: ['claims.add'],
+        descricao: 'avisa quando o comando da claim reprova (ou estoura o prazo do verify) no registro',
+    },
+    claims_failed: {
+        quando: ['claims.add'],
+        descricao: 'a mesma conferencia de claim_sem_prova_local, com o nome que o ork licoes propoe',
+    },
 };
+/** RM-008 (B8): as policies que conferem a claim no registro (um aviso so, como verify_regression e verify_failed). */
+exports.POLICIES_DE_PROVA_LOCAL = ['claim_sem_prova_local', 'claims_failed'];
+/** A primeira policy de prova local declarada fora de `off`, ou `null` (o `claims add` nao roda nada). */
+function policyDeProvaLocal(manifesto) {
+    const declaradas = manifesto.policies ?? {};
+    for (const [nome, bruta] of Object.entries(declaradas)) {
+        if (exports.POLICIES_DE_PROVA_LOCAL.includes(nome) && severidade(bruta) !== 'off')
+            return nome;
+    }
+    return null;
+}
 /**
  * Ensaio da 0.5.0: a thread criada sem `--worktree auto` entrega a base para a base, e a correcao
  * repetia o proprio `ork ship`. A thread que ainda nao passou do GO ganha a branch com
@@ -122,6 +144,8 @@ function avaliarPolicies(manifesto, ctx) {
     const violacoes = [];
     // verify_regression e verify_failed conferem a mesma coisa: um aviso so, com o nome da primeira declarada.
     let baselineJaAvaliada = false;
+    // claim_sem_prova_local e claims_failed idem.
+    let provaLocalJaAvaliada = false;
     for (const [nome, bruta] of Object.entries(declaradas)) {
         const conhecida = exports.POLICIES_CONHECIDAS[nome];
         if (!conhecida || !conhecida.quando.includes(ctx.gate))
@@ -224,6 +248,33 @@ function avaliarPolicies(manifesto, ctx) {
             }
             continue;
         }
+        if (exports.POLICIES_DE_PROVA_LOCAL.includes(nome)) {
+            if (provaLocalJaAvaliada)
+                continue;
+            provaLocalJaAvaliada = true;
+            const r = ctx.provaLocalReprovada;
+            if (r) {
+                const id = ctx.threadId ?? '<thread>';
+                violacoes.push({
+                    policy: nome,
+                    // O registro de claim nunca para: `block` declarado avisa como `warn`.
+                    severidade: 'warn',
+                    motivo: r.estourou ? 'verify.timeout' : 'claims.failed',
+                    detalhe: r.semDiretorio
+                        ? `a worktree da thread (${r.semDiretorio}) nao existe; o comando da claim ${r.claim} nao rodou e a claim entrou sem prova local`
+                        : r.estourou
+                            ? `o comando da claim ${r.claim} estourou o prazo do verify (${Math.round(r.prazoMs / 1000)} s) no registro; a claim entrou sem prova local`
+                            : `o comando da claim ${r.claim} saiu ${r.code} no registro; a claim entrou sem prova local e reprova no verify`,
+                    correcao: r.semDiretorio
+                        ? `recrie a worktree da thread (ou feche a thread que perdeu a worktree); depois, ork verify ${id}`
+                        : r.estourou
+                            ? `divida o comando ou suba verify.timeout_ms; depois, ork verify ${id}`
+                            : `corrija o produto ou o comando e anexe o certo com ork claims verificar ${id} ${r.claim} --comando "<comando>"; ` +
+                                `se a alegacao nao vale, ork claims retirar ${id} ${r.claim} --motivo "<motivo>"`,
+                });
+            }
+            continue;
+        }
         if (nome === 'tree_blocked') {
             if (ctx.branchAtrasDaBase === true) {
                 violacoes.push({

package/dist/portfolio.js

@@ -44,6 +44,7 @@ exports.assertCycleScope = assertCycleScope;
 /** Catálogo determinístico de produto -> projeto -> iniciativa. */
 const fs = __importStar(require("node:fs"));
 const project_state_1 = require("./project-state");
+const estado_thread_1 = require("./estado-thread");
 const company_brain_journal_1 = require("./company-brain-journal");
 const util_1 = require("./util");
 const creation_operation_store_1 = require("./creation-operation-store");
@@ -65,7 +66,9 @@ function readPortfolio(root) {
 }
 function persist(root, value) { value.updatedAt = (0, util_1.agora)(); (0, company_brain_journal_1.replaceWithJournal)(file(root), value); return value; }
 function mutatePortfolio(root, run) {
-    return (0, creation_operation_store_1.withCreationLock)(root, 'portfolio', () => (0, company_brain_journal_1.portfolioMutation)(file(root), run));
+    // RM-036 (D5): o portfolio.json e canonico, e o lock de espera tambem: chamado da raiz ou de uma worktree,
+    // quem chega depois espera a vez, em vez de recusar com brain.journal.busy no lock interno.
+    return (0, creation_operation_store_1.withCreationLock)((0, estado_thread_1.raizDoEstado)(root), 'portfolio', () => (0, company_brain_journal_1.portfolioMutation)(file(root), run));
 }
 function validateBase(kind, input) {
     if (!ID.test(input.id) || !input.id.startsWith(PREFIX[kind]))

package/dist/projeto-alvo.js

@@ -75,6 +75,7 @@ exports.linhasDaConsulta = linhasDaConsulta;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
+const branch_de_estado_1 = require("./branch-de-estado");
 const estado_thread_1 = require("./estado-thread");
 const manifest_1 = require("./manifest");
 const maquina_1 = require("./maquina");
@@ -198,7 +199,10 @@ function remotoSemCredencial(url) {
 }
 /** URL do remoto, sem credencial. `null` quando o projeto nao tem aquele remoto. */
 function remotoDoProjeto(raiz, remoto = 'origin') {
-    const r = (0, util_1.exec)('git', ['remote', 'get-url', remoto], raiz, 5000);
+    // RM-047: o nome vem do manifesto; fora do formato de remoto, nada vai ao git.
+    if (!(0, branch_de_estado_1.remotoValido)(remoto))
+        return null;
+    const r = (0, util_1.exec)('git', ['remote', 'get-url', '--', remoto], raiz, 5000);
     const url = r.ok ? r.stdout.trim() : '';
     return url ? remotoSemCredencial(url) : null;
 }

package/dist/prompts.js

@@ -49,11 +49,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEMPLATES_EMBUTIDOS = exports.TEMPLATE_FASE_PADRAO = exports.CONTRATO_DE_FASE = exports.REGRA_CENTRAL = exports.SECOES_OBRIGATORIAS = exports.LIMITE_TEMPLATE_BYTES = void 0;
+exports.TEMPLATES_EMBUTIDOS = exports.TEMPLATE_FASE_PADRAO = exports.PADROES_DE_HITL_EM_TEXTO_LIVRE = exports.CONTRATO_DE_FASE = exports.REGRA_CENTRAL = exports.SECOES_OBRIGATORIAS = exports.LIMITE_TEMPLATE_BYTES = void 0;
+exports.pedidoComDicaDoGrafo = pedidoComDicaDoGrafo;
 exports.dirDeTemplates = dirDeTemplates;
 exports.variaveisUsadas = variaveisUsadas;
 exports.renderizar = renderizar;
 exports.parseTemplate = parseTemplate;
+exports.procurarHitlEmTextoLivre = procurarHitlEmTextoLivre;
 exports.lintTemplate = lintTemplate;
 exports.carregarTemplatesDe = carregarTemplatesDe;
 exports.carregarTemplates = carregarTemplates;
@@ -69,6 +71,15 @@ const policies_1 = require("./policies");
 const types_1 = require("./types");
 /** Limite duro de um template, o mesmo do manifesto: prosa longa nao vira prompt. */
 exports.LIMITE_TEMPLATE_BYTES = 16384;
+/** KG5 fatia 2: dica opt-in no pedido; desligada preserva o texto byte a byte. */
+function pedidoComDicaDoGrafo(pedido, thread, ligado) {
+    if (!ligado)
+        return pedido;
+    return pedido.trimEnd() + '\n\n## Contexto do grafo (opcional)\n'
+        + `Consulte ork_grafo_contexto {threadId: "${thread}"} ou ork grafo contexto ${thread} --json para o pacote da thread com evidencias e teto em bytes.\n`
+        + 'As tools ork_grafo_vizinhos, ork_grafo_chamadores, ork_grafo_importadores e ork_grafo_caminho permitem aprofundar. '
+        + 'Sem indice do HEAD, rode ork grafo indexar. O grafo e parcial; com arvore modificada, descreve o HEAD.\n';
+}
 /** Onde um projeto guarda os templates que sobrescrevem os embutidos. */
 function dirDeTemplates(raiz) {
     return path.join(raiz, 'prompts');
@@ -170,6 +181,27 @@ exports.CONTRATO_DE_FASE = {
     variavelObrigatoria: 'pedido',
     validaFases: true,
 };
+/**
+ * RM-057: os jeitos de um template pedir ao dono texto livre ou texto colado. Lista fechada, como o
+ * vocabulario do pulse: acrescentar um padrao e decisao de contrato, com teste. Casa sobre a linha
+ * em minusculas e sem acento.
+ */
+exports.PADROES_DE_HITL_EM_TEXTO_LIVRE = Object.freeze([
+    { oQue: 'que o dono cole texto', padrao: /\b(cole|colar|colem)\b[^.\n]{0,60}\b(texto|aqui|mensagem|pedido|resposta|saida|conteudo)\b/ },
+    { oQue: 'que o dono cole texto', padrao: /\bpaste\b/ },
+    { oQue: 'confirmacao em texto livre', padrao: /\b(responda|digite|escreva|confirme|responder|digitar|escrever)\b[^.\n]{0,40}(\bconfirmo\b|texto livre|\bem texto\b)/ },
+    { oQue: 'confirmacao em texto livre', padrao: /\b(peca|peco|pedir|solicite|solicitar)\b[^.\n]{0,30}\bconfirmacao\b[^.\n]{0,20}\b(por escrito|em texto|textual)\b/ },
+]);
+function procurarHitlEmTextoLivre(corpo) {
+    const achados = [];
+    corpo.split('\n').forEach((bruta, i) => {
+        const linha = bruta.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase();
+        const casou = exports.PADROES_DE_HITL_EM_TEXTO_LIVRE.find(p => p.padrao.test(linha));
+        if (casou)
+            achados.push({ linha: i + 1, oQue: casou.oQue });
+    });
+    return achados;
+}
 /**
  * Lint de um template. Devolve os problemas; lista vazia quer dizer aprovado.
  *
@@ -231,6 +263,9 @@ function lintTemplate(t, contrato = exports.CONTRATO_DE_FASE) {
     if (bytes > exports.LIMITE_TEMPLATE_BYTES) {
         erro('tamanho', `${bytes} bytes acima do limite de ${exports.LIMITE_TEMPLATE_BYTES}`);
     }
+    for (const achado of procurarHitlEmTextoLivre(t.corpo)) {
+        erro('hitl-texto-livre', `linha ${achado.linha} pede ${achado.oQue}; HITL de conducao e selecao de 3 a 5 alternativas com uma Recomendacao (RM-057)`);
+    }
     if (t.bruto.includes('—')) {
         aviso('idioma', 'o template usa travessao longo (U+2014); o padrao do projeto e hifen ou virgula');
     }

package/dist/prova-ativacao.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENTRADAS = exports.HOSTS_DA_PROVA = void 0;
 exports.transcriptDoClaude = transcriptDoClaude;
 exports.transcriptDoOpenclaw = transcriptDoOpenclaw;
+exports.transcriptDoCodex = transcriptDoCodex;
 exports.extrairSnapshot = extrairSnapshot;
 exports.conferirProva = conferirProva;
 exports.redigir = redigir;
@@ -44,7 +45,7 @@ exports.redigirObjeto = redigirObjeto;
  * RM-032: conferência da prova de ativação por host, sem host.
  *
  * O roteiro `core/scripts/prova-ativacao.cjs` abre uma sessão nova e não interativa no host
- * (Claude Code ou OpenClaw), diz `orkastery maestro` e entrega aqui o transcript. Esta
+ * (Claude Code, OpenClaw ou Codex), diz `orkastery maestro` e entrega aqui o transcript. Esta
  * conferência olha só o que é determinístico: qual ferramenta o modelo chamou, o resultado que
  * ela devolveu (contra o contrato da entrada) e o projeto lido. Da resposta final em texto
  * livre, exige apenas que cite o projeto e não repita o incidente de 29/09 ("roadmap vazio").
@@ -52,20 +53,31 @@ exports.redigirObjeto = redigirObjeto;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const maestro_contract_1 = require("./maestro-contract");
-exports.HOSTS_DA_PROVA = ['claude-code', 'openclaw'];
+exports.HOSTS_DA_PROVA = ['claude-code', 'openclaw', 'codex'];
 /**
  * As entradas da frase em cada host. No Claude, a tool MCP do servidor `orkastery` fixado no
  * projeto (MAESTRO_HOST_SURFACES em hosts.ts). No OpenClaw 0.5.0 (RM-054, fatia 2), a frase sem
  * projeto vai a `ork_network_roadmap`, a única tool da extensão no perfil `coding`; com projeto
- * nomeado, a `ork_maestro`. `ork maestro` pelo shell do host é desvio: o CLI resolve o projeto
- * pelo diretório atual, a classe de erro do incidente.
+ * nomeado, a `ork_maestro`. No Codex (B11), a tool `ork_maestro` do servidor `orkastery` que o
+ * `ork mcp install --host codex` grava no projeto; o nome segue o padrão `mcp__<servidor>__<tool>`.
+ * `ork maestro` pelo shell do host é desvio: o CLI resolve o projeto pelo diretório atual, a classe
+ * de erro do incidente.
  */
 exports.ENTRADAS = {
     'claude-code': [{ ferramenta: 'mcp__orkastery__ork_maestro', contrato: 'maestro' }],
     openclaw: [{ ferramenta: 'ork_network_roadmap', contrato: 'rede' }, { ferramenta: 'ork_maestro', contrato: 'maestro' }],
+    codex: [{ ferramenta: 'mcp__orkastery__ork_maestro', contrato: 'maestro' }],
 };
-const SHELL_DO_HOST = { 'claude-code': 'Bash', openclaw: 'exec' };
-const ORK_MAESTRO_NO_SHELL = /(^|[\s;&|(/])ork(\s+(--projeto|--project|-p)(\s+|=)\S+)?\s+maestro\b/;
+const SHELL_DO_HOST = { 'claude-code': 'Bash', openclaw: 'exec', codex: 'command_execution' };
+// B11: o shell do Codex chega embrulhado (`bash -lc 'ork maestro'`), então aspas também abrem o comando.
+// Suspeitas da revisão de 03/10: o mesmo CLI roda também pelo caminho do binário (`$(which ork)`), pelo
+// node (`core/dist/index.js`), pelo npx (`@orkastery/cli`) e com o projeto entre aspas. É desvio a
+// invocação do ork cujo subcomando, depois só de opções (com valor, até entre aspas), é `maestro`;
+// `maestro` dentro do argumento de outro subcomando não é.
+const INVOCACAO_DO_ORK = String.raw `(?:(?:^|[^\w.@-])ork|@orkastery\/cli(?:@[\w.-]+)?|\bdist\/index\.js)(?![\w.-])[)\x60]?`;
+const VALOR = String.raw `(?:"[^"]*"|'[^']*'|[^\s"'-][^\s"']*)`;
+const OPCOES = String.raw `(?:\s+-[\w-]*(?:=(?:"[^"]*"|'[^']*'|[^\s"']+))?(?:\s+${VALOR})?)*`;
+const ORK_MAESTRO_NO_SHELL = new RegExp(String.raw `${INVOCACAO_DO_ORK}${OPCOES}\s+maestro(?![\w.-])`);
 function linhasJson(texto) {
     const eventos = [];
     for (const linha of texto.split('\n')) {
@@ -172,6 +184,63 @@ function transcriptDoOpenclaw(eventsJsonl, agenteJson) {
     const textos = (agente.payloads ?? []).map(p => p?.text).filter((t) => typeof t === 'string');
     return { ferramentasExpostas, chamadas, respostaFinal: textos.length ? textos.join('\n') : null };
 }
+/**
+ * Eventos do `codex exec --json` (B11): `item.started`/`item.completed` com `mcp_tool_call` (servidor,
+ * tool, argumentos, resultado, erro), `command_execution` (o shell do host) e `agent_message` (a
+ * resposta). O `codex exec` não lista as ferramentas expostas ao modelo: quem chama passa as do
+ * `tools/list` do mesmo servidor MCP que a sessão recebeu, já com o nome `mcp__<servidor>__<tool>`.
+ */
+function transcriptDoCodex(eventosJsonl, ferramentasExpostas) {
+    const porItem = new Map();
+    const chamadas = [];
+    const mensagens = [];
+    for (const e of linhasJson(eventosJsonl)) {
+        if (e.type !== 'item.started' && e.type !== 'item.completed')
+            continue;
+        const item = (e.item ?? {});
+        const id = typeof item.id === 'string' ? item.id : null;
+        if (item.type === 'agent_message') {
+            if (e.type === 'item.completed' && typeof item.text === 'string')
+                mensagens.push(item.text);
+            continue;
+        }
+        let ferramenta, argumentos, resultado = null, erro = false;
+        if (item.type === 'mcp_tool_call' && typeof item.server === 'string' && typeof item.tool === 'string') {
+            ferramenta = `mcp__${item.server}__${item.tool}`;
+            argumentos = item.arguments ?? null;
+            const r = item.result;
+            resultado = typeof r === 'string' ? r : textoDoConteudo(r?.content);
+            const falha = item.error;
+            erro = !!falha || item.status === 'failed';
+            if (erro && resultado === null)
+                resultado = typeof falha === 'string' ? falha : typeof falha?.message === 'string' ? falha.message : 'falhou';
+        }
+        else if (item.type === 'command_execution' && typeof item.command === 'string') {
+            ferramenta = 'command_execution';
+            argumentos = { command: item.command };
+            resultado = typeof item.aggregated_output === 'string' ? item.aggregated_output : null;
+            erro = item.status === 'failed' || (typeof item.exit_code === 'number' && item.exit_code !== 0);
+        }
+        else
+            continue;
+        const tipo = classificar('codex', ferramenta, argumentos);
+        if (!tipo)
+            continue;
+        const anterior = id ? porItem.get(id) : undefined;
+        if (anterior) {
+            // `item.completed` do mesmo item fecha a chamada aberta no `item.started`.
+            if (e.type === 'item.completed')
+                Object.assign(anterior, { argumentos, resultado, erro });
+            continue;
+        }
+        const chamada = { ferramenta, ...tipo, argumentos, resultado: e.type === 'item.completed' ? resultado : null,
+            erro: e.type === 'item.completed' ? erro : false };
+        if (id)
+            porItem.set(id, chamada);
+        chamadas.push(chamada);
+    }
+    return { ferramentasExpostas, chamadas, respostaFinal: mensagens.length ? mensagens.at(-1) : null };
+}
 /** O primeiro objeto `ork.maestro-snapshot/v1` do texto (o host pode juntar stderr ao stdout). */
 function extrairSnapshot(texto) {
     const inicio = texto.indexOf('{"schema":"ork.maestro-snapshot/v1"');

package/dist/pulse-delivery.js

@@ -38,6 +38,7 @@ exports.assinaturaPulse = assinaturaPulse;
 exports.assinaturaDoResumo = assinaturaDoResumo;
 exports.mensagemPulse = mensagemPulse;
 exports.varrerPulse = varrerPulse;
+exports.varrerEDepoisPublicarNaRede = varrerEDepoisPublicarNaRede;
 exports.enviarPayloadHost = enviarPayloadHost;
 const manifest_1 = require("./manifest");
 const write_activation_1 = require("./write-activation");
@@ -59,6 +60,8 @@ const hitl_contract_1 = require("./hitl-contract");
 const monitor_lock_1 = require("./monitor-lock");
 const fabrica_estado_1 = require("./fabrica-estado");
 const maquina_1 = require("./maquina");
+const rede_1 = require("./rede");
+const rede_adesao_1 = require("./rede-adesao");
 const pulse_cadencia_1 = require("./pulse-cadencia");
 // O lock dos monitores mudou de modulo (I-41, GO-FIX 1); quem o importava daqui continua importando.
 var monitor_lock_2 = require("./monitor-lock");
@@ -253,7 +256,9 @@ function varrerPulse(opcoes) {
             const guardadas = anterior ? fila.candidatos.filter(c => anterior.candidatos.some(a => a.thread === c.thread)).length : 0;
             const resumo = (0, hitl_resumo_1.resumirHitl)(itens, { quando, janelaMin, prontas: fila.candidatos.length, acumuladas: guardadas,
                 consertos: fila.consertos, atoDoItem: i => fila.atos.get(`${i.thread}|${i.fase}`),
-                decisoes: decisoesNovas, acimaDoLimiar: pulse.acimaDoLimiar ?? [], outrasMaquinas: outras, paradosNoCondutor: parados });
+                decisoes: decisoesNovas, acimaDoLimiar: pulse.acimaDoLimiar ?? [], outrasMaquinas: outras, paradosNoCondutor: parados,
+                // RM-057 (fatia 3): a linha so acompanha o resumo que ja sai; nao e novidade nem fura a cadencia.
+                ...(pulse.hitlDeConducao ? { hitlDeConducao: pulse.hitlDeConducao } : {}) });
             // Pedir licenca para mandar zero perguntas era o defeito: sem pergunta, nao ha codigo.
             // I-50: cadencia curta nao encurta o prazo do dono para responder ao resumo (minimo de 60 min).
             const consentimento = fila.candidatos.length ? (0, monitor_lock_1.comLockDaConversa)(dir, () => (0, pulse_consentimento_1.abrirConsentimento)(raiz, { quando,
@@ -287,6 +292,22 @@ function varrerPulse(opcoes) {
         trava.liberar();
     }
 }
+/**
+ * RM-053: a entrega ao dono vem primeiro, e a rede depois, mesmo quando a varredura falha. M4 do
+ * CHECK 1: antes da entrega, uma forja lenta atrasava o HITL em minutos. S13 da revisao 2: sem o
+ * `finally`, uma excecao na varredura suprimia tambem a batida da rede.
+ */
+function varrerEDepoisPublicarNaRede(varrer, publicar) {
+    try {
+        return varrer();
+    }
+    finally {
+        try {
+            publicar();
+        }
+        catch { /* a rede registra a propria falha no rede.log */ }
+    }
+}
 if (require.main === module) {
     try {
         const raiz = process.argv[2] ?? process.cwd();
@@ -317,7 +338,18 @@ if (require.main === module) {
         }
         const outrasMaquinas = compartilhada
             ? () => (0, fabrica_estado_1.resumoDasOutrasMaquinas)((0, fabrica_estado_1.lerFabrica)(carregado.raiz, { remoto, semRemoto: true }), (0, maquina_1.nomeDaMaquina)()) : undefined;
-        const r = varrerPulse({ raiz, escopo, comCadencia: true, outrasMaquinas });
+        // RM-053 (D9): depois da entrega ao dono, a mesma batida publica o retrato desta maquina na rede da
+        // pessoa (so membro, uma tentativa a cada 14 min, retrato igual so de hora em hora).
+        const r = varrerEDepoisPublicarNaRede(() => varrerPulse({ raiz, escopo, comCadencia: true, outrasMaquinas }), () => {
+            try {
+                const rede = (0, rede_1.publicarRedeNaBatida)({ diretorio: carregado.raiz });
+                if (rede)
+                    (0, rede_adesao_1.registrarNaRede)({ ...rede, origem: 'pulse' });
+            }
+            catch (e) {
+                (0, rede_adesao_1.registrarNaRede)({ acao: 'falhou', origem: 'pulse', erro: e.message });
+            }
+        });
         console.log(JSON.stringify(r));
         process.exitCode = r.code;
     }

package/dist/pulse.js

@@ -13,6 +13,7 @@ const liveness_1 = require("./liveness");
 const master_1 = require("./master");
 const master_batch_1 = require("./master-batch");
 const orquestracao_1 = require("./orquestracao");
+const impedimento_1 = require("./impedimento");
 const thread_1 = require("./thread");
 const sessoes_adopt_1 = require("./sessoes-adopt");
 const ledger_1 = require("./ledger");
@@ -27,6 +28,7 @@ const docs_1 = require("./docs");
 const conducao_1 = require("./conducao");
 const conducao_texto_1 = require("./conducao-texto");
 const hitl_resumo_1 = require("./hitl-resumo");
+const hitl_tempo_parado_1 = require("./hitl-tempo-parado");
 const parado_no_condutor_1 = require("./parado-no-condutor");
 exports.CONTRATO_PULSE = 'ork.pulse/v1';
 /** Uma semana: o resumo cita a decisao uma vez, e ela continua lida ate sair da janela. */
@@ -169,6 +171,19 @@ function comporPulse(carregado, entrada) {
                 thread: l.thread, fase: p.fase, sessionId: null, desdeEm: p.desdeEm, paradaHaMin: p.paradaHaMin, impacto: impacto(p.fase),
                 pergunta: p.detalhe, opcoes: [], recomendacao: p.correcao, comandoResposta: p.correcao, evidencia: [p.evidencia],
                 fontes: ['monitor'], contextoLogs: [] };
+            // RM-055: o impedimento do despacho sai no contrato curto, com o comando exato e o re-despacho depois.
+            if (p.impedimento) {
+                try {
+                    const curto = (0, impedimento_1.pedidoCurtoDoImpedimento)({ thread: l.thread, fase: p.fase, motivo: p.motivo, detalhe: p.detalhe,
+                        desdeEm: p.desdeEm, impedimento: p.impedimento }, quando);
+                    item.apresentacaoCurta = { telegram: (0, hitl_curto_1.textoDoPedidoCurto)(curto, 'telegram'), terminal: (0, hitl_curto_1.textoDoPedidoCurto)(curto, 'terminal') };
+                    item.opcoes = curto.alternativas.map(a => `${a.chave}. ${a.texto}`);
+                    item.comandoResposta = `ork retry run ${l.thread}`;
+                }
+                catch {
+                    item.evidencia.push('Pedido curto do impedimento indisponível; a correção acima vale.');
+                }
+            }
             // I-45: vaga parada e sinal do escalonador (`ork board reap` devolve a vaga), nao pergunta ao dono.
             const esperaAutomatica = ['lease.busy', 'conducao.em-andamento', 'concurrency.limite', 'runtime.rate-limited', 'vaga.stale'].includes(p.motivo);
             (esperaAutomatica ? automaticas : humanos).push(item);
@@ -276,11 +291,26 @@ function montarPulse(carregado, opcoes = {}) {
                         (0, parado_no_condutor_1.gravarRetratoDePrs)(carregado.raiz, leitura.retrato);
                     }
                     catch { /* o retrato e economia do status */ }
+                    try {
+                        (0, parado_no_condutor_1.esquecerForjaSemLeitura)(carregado.raiz);
+                    }
+                    catch { /* sem a marca, a proxima perda de leitura e dita de novo */ }
                 }
                 return leitura;
             } });
-        if (entregas.prs && !entregas.prs.ok)
-            diagnosticos.push(`prs.nao-lidos: ${entregas.prs.erro.slice(0, 160)}`);
+        const leitura = entregas.prs;
+        if (leitura && !leitura.ok && leitura.semLeitura) {
+            // RM-037 (fatia 5, A5): a forja sem leitura de PR e dita uma vez por remoto e host; as batidas seguintes nao repetem.
+            let novidade = true;
+            try {
+                novidade = (0, parado_no_condutor_1.avisarForjaSemLeitura)(carregado.raiz, leitura.semLeitura, leitura.erro, quando);
+            }
+            catch { /* sem marca, diz de novo */ }
+            if (novidade)
+                diagnosticos.push(`prs.sem-leitura: ${leitura.erro.slice(0, 160)}`);
+        }
+        else if (leitura && !leitura.ok)
+            diagnosticos.push(`prs.nao-lidos: ${leitura.erro.slice(0, 160)}`);
     }
     catch (e) {
         diagnosticos.push(`entregas.indisponiveis: ${e.message.slice(0, 120)}`);
@@ -298,6 +328,15 @@ function montarPulse(carregado, opcoes = {}) {
     catch (e) {
         diagnosticos.push(`decisoes.indisponiveis: ${e.message.slice(0, 120)}`);
     }
+    // RM-057 (fatia 3): leitura pura do ledger; falhar aqui nunca derruba a fila de atencao.
+    try {
+        const hitl = (0, hitl_tempo_parado_1.lerHitlDeConducaoAgora)(carregado.raiz, quando);
+        if (hitl.abertas.length || hitl.seteDias.pedidos || hitl.seteDias.respondidos)
+            pulse.hitlDeConducao = hitl;
+    }
+    catch (e) {
+        diagnosticos.push(`hitl-conducao.indisponivel: ${e.message.slice(0, 120)}`);
+    }
     if (diagnosticos.length)
         pulse.runtime.detalhe = [pulse.runtime.detalhe, ...diagnosticos].filter(Boolean).join('; ');
     return pulse;
@@ -307,7 +346,7 @@ function textoDoPulse(p) {
     const local = (texto) => (0, horario_1.localizarTexto)(texto, { agora: p.consultadoEm });
     const linhas = [`Pulse (${p.contrato}) ${(0, horario_1.formatarDataHoraRotulada)(p.consultadoEm, { agora: p.consultadoEm })}`, `Precisa de humano agora: ${p.resumo.humanos}`, `${p.resumo.scores} entrega(s) sem nota, aceitas por padrão com registro`];
     // RM-037 (fatia 4): PR nao lido tambem e dito, para a falta de linha do condutor nao parecer "nada parado".
-    if (p.runtime.ok && ['liveness.snapshot.invalid', 'prs.nao-lidos', 'entregas.indisponiveis'].some(d => p.runtime.detalhe.includes(d))) {
+    if (p.runtime.ok && ['liveness.snapshot.invalid', 'prs.nao-lidos', 'prs.sem-leitura', 'entregas.indisponiveis'].some(d => p.runtime.detalhe.includes(d))) {
         linhas.push(`[diagnostico] ${local(p.runtime.detalhe)}`);
     }
     if (!p.runtime.ok)
@@ -326,6 +365,13 @@ function textoDoPulse(p) {
         for (const x of p.paradoNoCondutor)
             linhas.push((0, hitl_resumo_1.linhaDoParadoNoCondutor)(x, { agora: p.consultadoEm }));
     }
+    // RM-057 (fatia 3): quanto tempo cada pergunta de conducao aberta ja parou a thread, e a mediana da semana.
+    if (p.hitlDeConducao) {
+        const h = p.hitlDeConducao;
+        linhas.push('', `HITL de condução: ${h.abertas.length} aberta(s); ${(0, hitl_tempo_parado_1.textoDaMediana)(h)}`);
+        for (const a of h.abertas)
+            linhas.push((0, hitl_tempo_parado_1.linhaDaPerguntaParada)(a, { agora: p.consultadoEm }));
+    }
     linhas.push('', `Ações automáticas pendentes: ${p.resumo.automaticas}`);
     for (const i of p.acoesAutomaticas)
         linhas.push(`${i.thread}: ${i.motivo}; ${i.comandoResposta}`);

package/dist/ratelimit.js

@@ -61,6 +61,7 @@ exports.lerFilaDeRetomada = lerFilaDeRetomada;
 exports.janelaPadraoMs = janelaPadraoMs;
 exports.enfileirar = enfileirar;
 exports.prazoDaConta = prazoDaConta;
+exports.prazoDaCotaVista = prazoDaCotaVista;
 exports.marcarContaDaFalha = marcarContaDaFalha;
 exports.gravarPedido = gravarPedido;
 exports.exigirPedido = exigirPedido;
@@ -151,15 +152,30 @@ function prazoDaConta(manifesto, falha, agoraMs = Date.now()) {
         return falha.resetEm;
     return new Date(agoraMs + janelaPadraoMs(manifesto)).toISOString();
 }
-/** Marca no store o perfil que falhou pela conta. Sem perfil (ambiente do processo), nada a marcar. */
-function marcarContaDaFalha(carregado, perfil, falha, agoraMs = Date.now()) {
+/**
+ * RM-037 (fatia 5): ate quando a conta sai do rodizio pela cota que o observador viu na transcricao, com a
+ * sessao viva. Vale a hora dita (ja ancorada no instante da mensagem) ou a janela padrao contada da mensagem,
+ * nunca do relogio de quem leu. Prazo que ja venceu volta `null`: a conta ja voltou, e marcar agora tiraria do
+ * rodizio uma conta boa (a regra A10 do despacho recusado nao vale aqui, porque ninguem acabou de recusar nada).
+ */
+function prazoDaCotaVista(manifesto, falha, mensagemMs, agoraMs = Date.now()) {
+    if (falha.motivo !== 'runtime.quota-exhausted' || !Number.isFinite(mensagemMs))
+        return null;
+    const prazo = falha.resetEm ?? new Date(mensagemMs + janelaPadraoMs(manifesto)).toISOString();
+    return Date.parse(prazo) > agoraMs ? prazo : null;
+}
+/**
+ * Marca no store o perfil que falhou pela conta. Sem perfil (ambiente do processo), nada a marcar. `prazo`,
+ * quando vem, e o ja calculado por quem viu a falha (`prazoDaCotaVista`); sem ele, vale `prazoDaConta`.
+ */
+function marcarContaDaFalha(carregado, perfil, falha, agoraMs = Date.now(), prazo) {
     // RM-037 (defeitosdeco D-6): modelo inacessivel nao e falha da conta inteira; o perfil fica no rodizio.
     if (!perfil || falha.motivo === 'runtime.model-unavailable')
         return null;
     const esgotado = falha.motivo === 'runtime.quota-exhausted';
     return (0, runtime_profiles_1.marcarFalhaDePerfil)(carregado.raiz, perfil.id, { estado: esgotado ? 'esgotado' : 'sem-auth',
-        esgotadoAte: prazoDaConta(carregado.manifesto, falha, agoraMs), motivo: falha.motivo, detalhe: falha.trecho,
-        em: new Date(agoraMs).toISOString() });
+        esgotadoAte: esgotado && prazo ? prazo : prazoDaConta(carregado.manifesto, falha, agoraMs), motivo: falha.motivo,
+        detalhe: falha.trecho, em: new Date(agoraMs).toISOString() });
 }
 /** Regrava um pedido (append-only: a versao nova vence, o historico fica). */
 function gravarPedido(raiz, pedido) {

package/dist/recall.js

@@ -257,7 +257,9 @@ function recallDaThread(carregado, memoria, threadId, opcoes = {}) {
             falhas.push({ id: 'memoria-busca', titulo: 'Descoberta de handoffs da fase', location: '',
                 orkmind: null, retrieve_when: fase, resolvido: false, motivo: 'orkmind-indisponivel', via: null,
                 conteudo: '', metodo: '', sha256: '', intervalo: null,
-                detalhe: `${memoria.leituraRestrita ? falhaDeConsulta(erro) : 'memory.transport.export'}: busca semantica falhou; resultado nao comprova colecao vazia` });
+                // RM-038: a janela cheia do export tem codigo proprio; o resto segue como falha de transporte.
+                detalhe: `${memoria.leituraRestrita ? falhaDeConsulta(erro) : erro instanceof Error && erro.message === 'memory.query.window-saturated'
+                    ? erro.message : 'memory.transport.export'}: busca semantica falhou; resultado nao comprova colecao vazia` });
         }
     }
     if (opcoes.id !== undefined && resolvidos.length === 0 && falhas.length === 0 && adiados.length === 0) {