@orkastery/cli 0.5.1 → 0.5.6

package/dist/ocupacao.js

@@ -21,13 +21,14 @@
  * `slot_released` no ledger da thread devolvida.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EVENTOS_QUE_DESTRAVAM = exports.PAUSA_PREVISTA = void 0;
+exports.CARENCIA_DO_TURNO_ENCERRADO_MIN = exports.EVENTOS_QUE_DESTRAVAM = exports.PAUSA_PREVISTA = void 0;
 exports.ehAprovacaoHumana = ehAprovacaoHumana;
 exports.ehPausaPrevista = ehPausaPrevista;
 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';
@@ -89,7 +90,9 @@ function ultimaAtividadeEm(eventos) {
  * `human.pending` sem destravamento, ou sessao bloqueada no runtime), e a que o pulse declarou em silencio
  * (`runtime.silencio`). A pausa PREVISTA ao fim do bloco nao entra: ela e gravada no proprio
  * 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.
+ * verifica de novo. RM-058 N2 (D8): a quarta e a sessao com o turno encerrado pelo ledger (`turno-encerrado`), passada
+ * a carencia.
+ * Somente leitura.
  */
 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. */
@@ -115,8 +118,33 @@ sessionId) {
         (!sessionId || e.sessionId === sessionId)).at(-1);
     if (bloqueio?.tipo === 'sessao_bloqueada')
         return 'human.pending';
+    if (sessionId && turnoEncerrado(eventos, sessionId, desde, agora))
+        return 'turno-encerrado';
     return null;
 }
+/**
+ * RM-058 N2 (A8 do CHECK da ork-rm058n2): a carencia do turno encerrado. O Stop do Claude Code dispara a cada fim de
+ * turno, e a sessao que espera uma tarefa em segundo plano volta sozinha quando ela acaba; nesse intervalo a vaga
+ * continua dela. Sem atividade da sessao por toda a carencia, o turno acabou de vez e a vaga sai.
+ */
+exports.CARENCIA_DO_TURNO_ENCERRADO_MIN = 15;
+/**
+ * RM-058 N2 (D8 da ork-rm058n2): a sessao cujo turno o ledger prova encerrado (o Stop correlacionado e nenhuma
+ * atividade dela depois, ha pelo menos `CARENCIA_DO_TURNO_ENCERRADO_MIN`) nao trabalha mais, mesmo com o lease de pe:
+ * e a mesma leitura do pulse (P7). Em 12/10/2026 o `runtime_stop` sem `phase_result` (sessao parada com `claude stop`
+ * antes do resultado) prendia a vaga ate a thread fechar. A sessao que volta a trabalhar tem atividade depois do Stop
+ * e volta a ocupar.
+ */
+function turnoEncerrado(eventos, sessionId, desde, agora) {
+    const despacho = [...eventos].reverse().find((e) => e.tipo === ledger_1.TIPOS_DE_EVENTO.faseDespachada && e.sessionId === sessionId);
+    if (!despacho)
+        return false;
+    // Carregado na hora: `parado-no-condutor` importa este modulo, e o import no topo fecharia um ciclo de modulos.
+    const { fimDoTurno } = require('./parado-no-condutor');
+    const fim = fimDoTurno(eventos, despacho);
+    return !!fim && fim.tipo !== 'outro' && fim.sessionId === sessionId && Date.parse(fim.em) >= Date.parse(desde) &&
+        minutos(fim.em, agora) >= exports.CARENCIA_DO_TURNO_ENCERRADO_MIN;
+}
 /** A thread tem pausa humana ABERTA? Mesmas tres fontes do monitor, resumidas. */
 function pausaHumanaAberta(thread, eventos) {
     if (thread.status === 'pausada' && faseTemPausaPrevista(thread)) {
@@ -126,7 +154,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);
@@ -143,11 +172,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;
@@ -162,7 +196,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)
@@ -248,6 +282,7 @@ function avaliarOcupacao(thread, doLedger, 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,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ETAPAS_ONBOARDING = exports.PAUTA_ONBOARDING = exports.ONDE_FICAM_OS_SEGREDOS = exports.CONTRATO_ONBOARDING = void 0;
+exports.PAUTA_ONBOARDING = exports.ETAPAS_ONBOARDING = exports.ONDE_FICAM_OS_SEGREDOS = exports.CONTRATO_ONBOARDING = void 0;
+exports.perguntaDaEtapa = perguntaDaEtapa;
 exports.caminhoOnboarding = caminhoOnboarding;
 exports.validarConteudo = validarConteudo;
 exports.jsonCanonico = jsonCanonico;
@@ -42,6 +43,7 @@ exports.lerOnboarding = lerOnboarding;
 exports.gravarEtapa = gravarEtapa;
 exports.resetarOnboarding = resetarOnboarding;
 exports.textoDaPauta = textoDaPauta;
+exports.validarPedidoDeEtapa = validarPedidoDeEtapa;
 /** Entrevista determinística; hosts conduzem a conversa a partir desta pauta. */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -53,24 +55,28 @@ const policies_1 = require("./policies");
 const horario_1 = require("./horario");
 const experiencia_1 = require("./experiencia");
 const yaml_1 = require("./yaml");
+const locale_1 = require("./locale");
 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 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.' },
-    { etapa: 'arquitetura', pergunta: 'Quais decisões e restrições de arquitetura devem orientar o trabalho?' },
-    { etapa: 'skills', pergunta: 'Quais capacidades e skills serão necessárias?' },
-    { etapa: 'auditores', pergunta: 'Quais auditorias e cadências são desejadas?' },
-];
-exports.ETAPAS_ONBOARDING = exports.PAUTA_ONBOARDING.map(p => p.etapa);
+exports.ONDE_FICAM_OS_SEGREDOS = (0, locale_1.msg)('pt-BR').onboarding.segredos;
+/** RM-061 (F2a): as etapas, na ordem da entrevista; a pergunta de cada uma sai do catalogo. */
+exports.ETAPAS_ONBOARDING = ['maestro', 'credenciais', 'bancos', 'memoria', 'produtos', 'topologia', 'arquitetura', 'skills', 'auditores'];
+/** A pergunta da etapa no locale pedido (ou no ativo, que so os comandos cobertos trocam). */
+function perguntaDaEtapa(etapa, locale) {
+    const m = (0, locale_1.msg)(locale).onboarding, p = m.perguntas;
+    if (etapa === 'maestro')
+        return p.maestro(horario_1.FUSO_DE_BRASILIA, horario_1.CHAVE_DO_FUSO);
+    if (etapa === 'credenciais')
+        return p.credenciais(m.segredos);
+    if (etapa === 'bancos')
+        return p.bancos(m.segredos);
+    return p[etapa];
+}
+/** A pauta em pt-BR, como dado (testes e docs a leem); o texto do CLI usa `perguntaDaEtapa`. */
+exports.PAUTA_ONBOARDING = exports.ETAPAS_ONBOARDING.map((etapa) => ({ etapa, pergunta: perguntaDaEtapa(etapa, 'pt-BR') }));
 function caminhoOnboarding(raiz) {
     return (0, project_state_1.stateFile)(raiz, 'onboarding.json');
 }
@@ -79,7 +85,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 ficam ${exports.ONDE_FICAM_OS_SEGREDOS}`); }
+function invalido() { throw new Error((0, locale_1.msg)().onboarding.entradaInvalida((0, locale_1.msg)().onboarding.segredos)); }
 function textoSeguro(v) {
     return !(0, policies_1.procurarSegredos)(v).length &&
         !/[a-z][a-z0-9+.-]*:\/\/[^\s/]*@/i.test(v) &&
@@ -405,10 +411,23 @@ function resetarOnboarding(raiz, nome, por = 'owner') {
     });
 }
 function textoDaPauta(estado = onboardingPadrao(), owner = {}) {
-    const p = (0, experiencia_1.resolverExperiencia)(owner);
-    return ['Onboarding do projeto (' + exports.CONTRATO_ONBOARDING + ')',
-        `Experiência recomendada: ${p.language}, ${p.timezone}, resposta ${p.depth}. Ativar com esses valores, configurar ou desativar?`,
-        'Registre a escolha em maestro com {"owner":{"language":"' + p.language + '","timezone":"' + p.timezone + '","depth":"' + p.depth + '","experience":true}}; use experience:false para desativar. Consulta não registra resposta.',
-        ...exports.PAUTA_ONBOARDING.map(({ etapa, pergunta }) => `${estado.etapas[etapa] ? '[respondida]' : '[pendente]'} ${etapa}: ${pergunta}`),
-        'Responda com ork onboarding set <etapa> --conteudo <JSON> --por <quem>.'].join('\n');
+    const p = (0, experiencia_1.resolverExperiencia)(owner), m = (0, locale_1.msg)().onboarding;
+    return [m.titulo(exports.CONTRATO_ONBOARDING),
+        m.recomendada(p.language, p.timezone, p.depth),
+        m.registre(p.language, p.timezone, p.depth),
+        ...exports.ETAPAS_ONBOARDING.map((etapa) => `${estado.etapas[etapa] ? m.respondida : m.pendente} ${etapa}: ${perguntaDaEtapa(etapa)}`),
+        m.responda].join('\n');
+}
+/**
+ * RM-061 (F2a): a mesma recusa que `gravarEtapa` e `resetarOnboarding` dariam, antes de gravar: o CLI a
+ * chama no locale do comando e grava depois em `comLocale('pt-BR')`, entao a recusa de uso sai na
+ * lingua do texto e o dado gravado nao muda.
+ */
+function validarPedidoDeEtapa(nome, conteudo, por) {
+    exigirAutor(por);
+    if (nome !== undefined) {
+        const etapa = exigirEtapa(nome);
+        if (conteudo !== undefined)
+            validarConteudo(etapa, conteudo);
+    }
 }

package/dist/orkmind.js

@@ -54,7 +54,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.LIMITE_CONSULTA_MAXIMO = exports.LIMITE_CONSULTA_PADRAO = exports.CODIGOS_DE_EMBEDDING = exports.MODELO_DE_EMBEDDING = exports.EMBED_MAX_CARACTERES = exports.EMBED_MAX_TEXTOS = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.COLECOES_DO_ORK = void 0;
+exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.LIMITE_CONSULTA_MAXIMO = exports.LIMITE_CONSULTA_PADRAO = exports.CODIGOS_DE_EMBEDDING = exports.MODELO_DE_EMBEDDING = exports.EMBED_MAX_CARACTERES = exports.EMBED_MAX_TEXTOS = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.LIMITE_TIMEOUT_DO_UNIVERSO_MS = exports.TIMEOUT_DO_UNIVERSO_MS = exports.COLECOES_DO_ORK = void 0;
+exports.pertenceAoUniverso = pertenceAoUniverso;
 exports.enderecoDeMemoria = enderecoDeMemoria;
 exports.lerEndereco = lerEndereco;
 exports.violacoesDeGovernanca = violacoesDeGovernanca;
@@ -82,6 +83,7 @@ const fs = __importStar(require("node:fs"));
 const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
 const node_util_1 = require("node:util");
+const node_perf_hooks_1 = require("node:perf_hooks");
 /** As colecoes do OrkMind que o `ork` grava (guia: docs/guias/memoria-e-handoff.md). */
 exports.COLECOES_DO_ORK = [
     'decision',
@@ -90,6 +92,31 @@ exports.COLECOES_DO_ORK = [
     'learning',
     'roadmap',
 ];
+/** Cinco leituras governadas e a contagem, num unico subprocesso. */
+exports.TIMEOUT_DO_UNIVERSO_MS = 90_000;
+exports.LIMITE_TIMEOUT_DO_UNIVERSO_MS = 86_400_000;
+/** Configuracao direta tambem tem prazo finito: zero no spawnSync significaria sem limite. */
+function prazoDoUniversoMs(prazo) {
+    return typeof prazo === 'number' && Number.isSafeInteger(prazo) && prazo > 0 && prazo <= exports.LIMITE_TIMEOUT_DO_UNIVERSO_MS
+        ? prazo : exports.TIMEOUT_DO_UNIVERSO_MS;
+}
+/**
+ * RM-038: a fronteira do universo da busca vista do `ork`: colecao do ork e o tenant como item
+ * de `project`, sem injection_risk e ainda ativa. Reconferida antes de qualquer embed,
+ * mesmo quando a ponte ou outro driver devolve uma entrada que a biblioteca deveria recusar.
+ */
+function pertenceAoUniverso(e, tenant, agora = Date.now()) {
+    // A biblioteca trata datas sem fuso como UTC. Data invalida nunca vira entrada ativa.
+    const expira = e.expires_at == null ? null : Date.parse(/(?:Z|[+-]\d{2}:?\d{2})$/i.test(e.expires_at) ? e.expires_at : `${e.expires_at}Z`);
+    return exports.COLECOES_DO_ORK.includes(e.collection) && Array.isArray(e.tags.project) &&
+        e.tags.project.includes(tenant) && e.injection_risk !== true && (expira === null || expira > agora);
+}
+/** RM-038: contagem de fora da busca bem formada (tres inteiros nao negativos, nada mais). */
+function foraDaBuscaValida(x) {
+    const campos = ['injecao', 'expiradas', 'outrasColecoes'];
+    return !!x && typeof x === 'object' && !Array.isArray(x) && Object.keys(x).length === campos.length &&
+        campos.every(k => Number.isInteger(x[k]) && Number(x[k]) >= 0);
+}
 /**
  * Colecoes de governanca dura do OrkMind: entrada aqui vira REGRA do ecossistema.
  * O agente pode gravar (o B6 grava as policies do manifesto), mas nunca como `mandatory`
@@ -313,6 +340,10 @@ function entradaDoJson(bruto) {
     const o = bruto;
     if (typeof o.id !== 'string' || typeof o.content !== 'string')
         return null;
+    if (o.injection_risk !== undefined && typeof o.injection_risk !== 'boolean')
+        return null;
+    if (o.expires_at !== undefined && o.expires_at !== null && typeof o.expires_at !== 'string')
+        return null;
     const tags = {};
     if (o.tags && typeof o.tags === 'object' && !Array.isArray(o.tags)) {
         for (const [k, v] of Object.entries(o.tags)) {
@@ -340,6 +371,8 @@ function entradaDoJson(bruto) {
         author_id: typeof o.author_id === 'string' ? o.author_id : null,
         visibility: typeof o.visibility === 'string' ? o.visibility : undefined,
         protected: typeof o.protected === 'boolean' ? o.protected : undefined,
+        injection_risk: o.injection_risk,
+        expires_at: o.expires_at,
         criadaEm: typeof o.created_at === 'string' ? o.created_at : '',
     };
 }
@@ -360,8 +393,12 @@ class DriverCliOrkMind {
     }
     python() {
         const cli = this.config.cli;
-        const candidatos = cli.includes(path.sep) ? [path.resolve(cli)] :
-            (process.env.PATH ?? '').split(path.delimiter).map(p => path.join(p, cli));
+        // RM-047 (fronteira de confiança): caminho relativo resolveria no diretório atual, que é o clone, e
+        // entrada relativa do PATH também. Só caminho absoluto ou nome procurado em entrada absoluta do PATH.
+        if (cli.includes(path.sep) && !path.isAbsolute(cli))
+            throw new Error('cli.ausente: memory.cli relativo recusado');
+        const candidatos = path.isAbsolute(cli) ? [cli] :
+            (process.env.PATH ?? '').split(path.delimiter).filter(p => path.isAbsolute(p)).map(p => path.join(p, cli));
         const executavel = candidatos.find(p => {
             try {
                 fs.accessSync(p, fs.constants.X_OK);
@@ -377,6 +414,9 @@ class DriverCliOrkMind {
         const match = /^#!(\S+)(?:\s+(\S+))?\s*$/.exec(linha);
         if (!match)
             throw new Error('memory.transport.interpreter: shebang nao suportado');
+        // RM-047: interpretador relativo resolveria no diretório atual (o clone).
+        if (!path.isAbsolute(match[1]))
+            throw new Error('memory.transport.interpreter: shebang nao suportado');
         return match[2] ? [match[1], match[2]] : [match[1]];
     }
     /** Valor da chave de embedding no ambiente do `ork`; nunca guardado no driver. */
@@ -440,7 +480,7 @@ class DriverCliOrkMind {
                 code = JSON.parse(r.stdout)?.error;
             }
             catch { /* nenhum detalhe do filho */ }
-            throw new Error(['memory.schema.absent', 'memory.legacy.provenance-collision', 'memory.prospective.marker-invalid', 'memory.native.schema-mismatch', 'memory.query.invalid', 'memory.query.window-saturated', 'memory.query.scope-violation', 'memory.health.invalid', 'memory.fts.invalid', ...exports.CODIGOS_DE_EMBEDDING].includes(code) ? code : 'memory.transport.failed');
+            throw new Error(['memory.schema.absent', 'memory.legacy.provenance-collision', 'memory.prospective.marker-invalid', 'memory.native.schema-mismatch', 'memory.query.invalid', 'memory.query.window-saturated', 'memory.query.scope-violation', 'memory.health.invalid', 'memory.fts.invalid', 'memory.universo.invalid', ...exports.CODIGOS_DE_EMBEDDING].includes(code) ? code : 'memory.transport.failed');
         }
         let json;
         try {
@@ -555,6 +595,31 @@ class DriverCliOrkMind {
         }
         return r.ids;
     }
+    /**
+     * RM-038: o universo da busca numa chamada. A ponte filtra o tenant na origem e confere o
+     * predicado; o `ork` confere de novo cada entrada e recusa a alheia, nunca a descarta.
+     */
+    universo(tenant) {
+        if (!textoDeConsulta(tenant, 128) || tenant.trim() === '')
+            throw new Error('memory.universo.invalid');
+        const agora = Date.now();
+        const inicio = node_perf_hooks_1.performance.now();
+        const r = this.rodar({ op: 'universo', tenant }, prazoDoUniversoMs(this.config.universoTimeoutMs));
+        if (!objetoDeConsulta(r) || !Array.isArray(r.entradas) || !(r.foraDaBusca === null || foraDaBuscaValida(r.foraDaBusca))) {
+            throw new Error('memory.transport.universo');
+        }
+        const entradas = r.entradas.map(d => {
+            const e = entradaDoJson(d);
+            if (!e)
+                throw new Error('memory.transport.universo');
+            if (!pertenceAoUniverso(e, tenant, agora))
+                throw new Error('memory.query.scope-violation');
+            return e;
+        });
+        const fora = r.foraDaBusca;
+        return { entradas, foraDaBusca: fora === null ? null : { injecao: fora.injecao, expiradas: fora.expiradas, outrasColecoes: fora.outrasColecoes },
+            latenciaMs: node_perf_hooks_1.performance.now() - inicio };
+    }
     submeterHandoff(pedido) {
         try {
             const r = this.rodar({ op: 'handoff', pedido });
@@ -671,6 +736,8 @@ class DriverEmMemoria {
     embedding = { primario: true, fallback: true };
     /** Pedidos de embedding recebidos, para as assercoes de custo (chamadas ao provider). */
     pedidosDeEmbedding = [];
+    /** RM-038: o que a governanca da biblioteca tiraria da leitura (injection_risk, expirada), por id. */
+    foraDaBuscaMarcadas = new Map();
     constructor(entradas = []) {
         for (const e of entradas)
             this.entradas.push(e);
@@ -750,7 +817,31 @@ class DriverEmMemoria {
     exportar(colecao) {
         if (!this.ligado)
             throw new Error('memory.transport.unavailable');
-        return this.entradas.filter((e) => e.collection === colecao);
+        // Como o search_by_tags governado: o que a governanca tira nao sai pela leitura por tag.
+        return this.entradas.filter((e) => e.collection === colecao && !this.foraDaBuscaMarcadas.has(e.id));
+    }
+    /** So para os testes: a entrada passa a contar como tirada pela governanca da biblioteca. */
+    marcarForaDaBusca(id, motivo) {
+        this.foraDaBuscaMarcadas.set(id, motivo);
+    }
+    /** RM-038: o mesmo predicado do universo para o dublê inteiro (universo e FTS). */
+    naBusca(e, tenant) {
+        return pertenceAoUniverso(e, tenant) && !this.foraDaBuscaMarcadas.has(e.id);
+    }
+    /** RM-038: dublê da operacao `universo` da ponte, com a contagem de fora da busca. */
+    universo(tenant) {
+        if (!textoDeConsulta(tenant, 128) || tenant.trim() === '')
+            throw new Error('memory.universo.invalid');
+        if (!this.ligado)
+            throw new Error('memory.transport.unavailable');
+        const foraDaBusca = { injecao: 0, expiradas: 0, outrasColecoes: 0 };
+        for (const e of this.entradas.filter(x => (x.tags.project ?? []).includes(tenant))) {
+            if (!exports.COLECOES_DO_ORK.includes(e.collection))
+                foraDaBusca.outrasColecoes += 1;
+            else if (this.foraDaBuscaMarcadas.has(e.id))
+                foraDaBusca[this.foraDaBuscaMarcadas.get(e.id)] += 1;
+        }
+        return { entradas: this.entradas.filter(e => this.naBusca(e, tenant)), foraDaBusca };
     }
     consultar(consulta) {
         const q = validarConsultaDelimitada(consulta);
@@ -802,7 +893,7 @@ class DriverEmMemoria {
         this.pedidosDeEmbedding.push(p);
         return { alvo: p.alvo, modelo: p.modelo, dim: p.dim, vetores: p.textos.map(t => vetorDeDuble(t, p.dim)) };
     }
-    /** Dublê de FTS: todas as palavras da consulta no conteudo, sem stemming, com tenant obrigatorio. */
+    /** Dublê de FTS: todas as palavras da consulta no conteudo, sem stemming, dentro do universo da busca. */
     buscarTexto(tenant, texto) {
         if (!textoDeConsulta(tenant, 128) || !textoDeBuscaValido(texto))
             throw new Error('memory.fts.invalid');
@@ -811,7 +902,7 @@ class DriverEmMemoria {
         const palavras = (t) => t.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase().match(/[a-z0-9]+/g) ?? [];
         const consulta = palavras(texto);
         return this.entradas
-            .filter(e => exports.COLECOES_DO_ORK.includes(e.collection) && (e.tags.project ?? []).includes(tenant))
+            .filter(e => this.naBusca(e, tenant))
             .map(e => ({ id: e.id, conteudo: palavras(e.content) }))
             .filter(e => consulta.every(p => e.conteudo.includes(p)))
             .map(e => ({ id: e.id, peso: e.conteudo.filter(p => consulta.includes(p)).length }))
@@ -838,6 +929,7 @@ function configDoManifesto(manifesto) {
         variavel,
         dsn: variavel ? (process.env[variavel] ?? '') : '',
         timeoutMs: manifesto.memory.timeout_ms || 15000,
+        universoTimeoutMs: prazoDoUniversoMs(manifesto.memory.universo_timeout_ms),
         tenant: manifesto.memory.tenant || manifesto.project.name,
         // Lido direto do bloco: este modulo carrega sem o parser do manifesto (memory-native-schema).
         variavelDaChaveDeEmbedding: manifesto.memory.embedding?.provider === 'openrouter' ? manifesto.memory.embedding.api_key_env : '',

package/dist/orquestracao.js

@@ -69,16 +69,18 @@ const adapter = __importStar(require("./adapters/claude-bg"));
 const board_1 = require("./board");
 const gates_1 = require("./gates");
 const ledger_1 = require("./ledger");
+const leases_1 = require("./leases");
 const modos_1 = require("./modos");
 const ocupacao_1 = require("./ocupacao");
 const ratelimit_1 = require("./ratelimit");
-const hitl_1 = require("./hitl");
+const impedimento_1 = require("./impedimento");
 const thread_1 = require("./thread");
 const util_1 = require("./util");
 const horario_1 = require("./horario");
 Object.defineProperty(exports, "duracaoCurta", { enumerable: true, get: function () { return horario_1.duracaoCurta; } });
 const conducao_1 = require("./conducao");
 const conducao_texto_1 = require("./conducao-texto");
+const locale_1 = require("./locale");
 /** Limite de atencao padrao, em minutos: parada mais velha que isso e destacada. */
 exports.ATENCAO_PADRAO_MIN = 30;
 /** Minutos inteiros entre dois carimbos ISO (nunca negativo). */
@@ -167,16 +169,17 @@ function pausasAbertas(thread, eventos, estados, quando) {
             fase,
             bloco: blocoDaFase(thread, fase).bloco,
             pausaSobre: sobre,
-            detalhe: sessaoViva === true
-                ? `a sessao ${sessionId.slice(0, 8)} do bloco ainda esta trabalhando no runtime: a pausa chega quando ela terminar`
+            // RM-061 (F2b, G2): a parada nasce em pt-BR (o --json do monitor) e o pulse a remonta no locale.
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => sessaoViva === true
+                ? m.pulse.pausaTrabalhando(sessionId.slice(0, 8))
                 : sessaoEstado === 'blocked'
-                    ? `a sessao ${sessionId.slice(0, 8)} do bloco esta BLOQUEADA no runtime esperando acao humana (prompt, permissao ou credencial): veja \`ork sessions hitl\``
-                    : `bloco fechado em ${fase ?? '?'}: espera o veredito humano sobre ${sobre || 'a pausa do bloco'}`,
+                    ? m.pulse.pausaBloqueada(sessionId.slice(0, 8))
+                    : m.pulse.blocoFechado(fase ?? '?', sobre ? m.thread.pausaSobre(sobre) : m.pulse.aPausaDoBloco)),
             evidencia: `ledger ${ledger_1.TIPOS_DE_EVENTO.pausaHumana} (${ocupacao_1.PAUSA_PREVISTA})` +
                 `${sessionId ? `, sessao ${sessionId.slice(0, 8)}` : ''}` +
                 `${sessaoEstado ? ` em state=${sessaoEstado}` : ''}`,
             correcao: sessaoEstado === 'blocked'
-                ? `ork sessions logs ${sessionId.slice(0, 8)} para ver o que a sessao pede, e claude attach ${sessionId} para responder`
+                ? (0, locale_1.textoDoCatalogo)((m) => m.pulse.responderSessao(sessionId.slice(0, 8), sessionId))
                 : comandoDeAprovacao(thread.id, sobre),
             desdeEm: e.ts,
             sessaoViva,
@@ -188,7 +191,8 @@ function pausasAbertas(thread, eventos, estados, quando) {
     // ESCALADA do bloco B3 (limite de tentativas estourado), que pausa qualquer modo,
     // inclusive `#Auto` -- que por definicao nao tem pausa prevista no ledger.
     eventos.forEach((e, i) => {
-        if (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 espera dele.
+        if (!(0, impedimento_1.ehEsperaDoDono)(e, ledger_1.TIPOS_DE_EVENTO.gateBloqueado))
             return;
         const resolvido = eventos
             .slice(i + 1)
@@ -200,15 +204,17 @@ function pausasAbertas(thread, eventos, estados, quando) {
         if (porFase.has(chave))
             return;
         const { bloco, pausaSobre } = blocoDaFase(thread, fase);
+        const imp = (0, impedimento_1.ehImpedimentoDoDono)(e.motivo) ? (0, impedimento_1.impedimentoDoEvento)(e) : null;
         porFase.set(chave, parada({
             natureza: 'pausa-humana',
-            motivo: 'human.pending',
+            motivo: imp ? e.motivo : 'human.pending',
             fase,
             bloco,
-            pausaSobre: pausaSobre || 'autorizacao da retomada',
+            pausaSobre: imp ? `rodar \`${imp.comando}\` no terminal` : pausaSobre || 'autorizacao da retomada',
+            ...(imp ? { impedimento: imp } : {}),
             detalhe: typeof e.detalhe === 'string' && e.detalhe !== ''
                 ? e.detalhe
-                : gates_1.DESCRICAO_DO_MOTIVO['human.pending'],
+                : (0, locale_1.textoDoCatalogo)((m) => m.pulse.motivos['human.pending']),
             evidencia: `ledger ${ledger_1.TIPOS_DE_EVENTO.gateBloqueado} (gate ${String(e.gate ?? '?')})`,
             correcao: typeof e.correcao === 'string' && e.correcao !== ''
                 ? e.correcao
@@ -229,7 +235,7 @@ function pausasAbertas(thread, eventos, estados, quando) {
             fase: thread.faseAtual,
             bloco,
             pausaSobre: pausaSobre || 'veredito do bloco',
-            detalhe: `thread carimbada como pausada na fase ${thread.faseAtual}`,
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => m.pulse.threadPausada(thread.faseAtual)),
             evidencia: 'thread.json (status: pausada)',
             correcao: comandoDeAprovacao(thread.id, pausaSobre),
             desdeEm: thread.atualizadaEm,
@@ -254,9 +260,9 @@ function impedimentosAbertos(item, eventos, raizDoProjeto, quando) {
             fase: thread.faseAtual,
             bloco: blocoDaFase(thread, thread.faseAtual).bloco,
             pausaSobre: '',
-            detalhe: `na fila de ${p.nome}, atras da thread ${p.bloqueadaPor} (colide com ${p.colidiuCom})`,
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => m.pulse.naFilaDoLease(p.nome, p.bloqueadaPor, p.colidiuCom)),
             evidencia: `.orkastery/leases/fila.json (${p.tipo})`,
-            correcao: `espere a thread ${p.bloqueadaPor} liberar (ork lease release ${p.colidiuCom} --thread ${p.bloqueadaPor}), ou reduza a regiao pedida`,
+            correcao: (0, locale_1.textoDoCatalogo)((m) => m.pulse.espereOLease(p.bloqueadaPor, (0, leases_1.argumentoDeLease)(p.colidiuCom), (0, leases_1.argumentoDeLease)(p.bloqueadaPor))),
             desdeEm: p.desdeEm,
             sessaoViva: null,
             fonte: 'fila-de-lease',
@@ -273,8 +279,7 @@ function impedimentosAbertos(item, eventos, raizDoProjeto, quando) {
             fase: p.fase,
             bloco: blocoDaFase(thread, p.fase).bloco,
             pausaSobre: '',
-            detalhe: `pedido ${p.id} na fila de rate limit, libera ${(0, ratelimit_1.faltaPara)(p, quando)} ` +
-                `(${p.liberaEm}, ${p.janelaEstimada ? 'janela estimada' : 'hora dita pelo runtime'})`,
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => m.pulse.naFilaDeRateLimit(p.id, (0, ratelimit_1.faltaPara)(p, quando), p.liberaEm, p.janelaEstimada)),
             evidencia: `.orkastery/retry/fila.jsonl (${p.id}, ${p.sinal.fonte})`,
             correcao: `ork retry resume --id ${p.id}`,
             desdeEm: p.criadoEm,
@@ -288,7 +293,7 @@ function impedimentosAbertos(item, eventos, raizDoProjeto, quando) {
         if (e.tipo !== ledger_1.TIPOS_DE_EVENTO.gateBloqueado && e.tipo !== 'phase_wait')
             return;
         const motivo = e.motivo;
-        if (motivo === 'human.pending' || motivo === 'claims.unverifiable')
+        if (motivo === 'human.pending' || motivo === 'claims.unverifiable' || (0, impedimento_1.ehImpedimentoDoDono)(motivo))
             return;
         if (!(motivo in gates_1.DESCRICAO_DO_MOTIVO))
             return;
@@ -310,7 +315,7 @@ function impedimentosAbertos(item, eventos, raizDoProjeto, quando) {
             pausaSobre: '',
             detalhe: typeof e.detalhe === 'string' && e.detalhe !== ''
                 ? e.detalhe
-                : gates_1.DESCRICAO_DO_MOTIVO[motivo],
+                : (0, locale_1.textoDoCatalogo)((m) => m.pulse.motivos[motivo]),
             evidencia: `ledger ${e.tipo} (gate ${String(e.gate ?? '?')})`,
             correcao: typeof e.correcao === 'string' && e.correcao !== ''
                 ? e.correcao
@@ -372,10 +377,8 @@ function montarMonitor(carregado, opcoes = {}) {
     }
     else if (opcoes.semRuntime !== true) {
         if (adapter.disponivel()) {
-            estados = new Map(adapter
-                .listarSessoes()
-                .filter((s) => !!s.sessionId)
-                .map((s) => [s.sessionId, (0, hitl_1.estadoBruto)(s)]));
+            // RM-056 (D7): todas as contas, a mesma consulta do escalonador.
+            estados = (0, board_1.estadosDeSessao)(carregado.raiz, carregado.manifesto.concurrency.stale_after_min);
             runtimeDetalhe = '';
         }
         else {