@orkastery/cli 0.5.3 → 0.6.0

package/dist/ocupacao.js

@@ -21,7 +21,7 @@
  * `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;
@@ -29,6 +29,7 @@ exports.sessaoLivreDaVaga = sessaoLivreDaVaga;
 exports.avaliarOcupacao = avaliarOcupacao;
 const ledger_1 = require("./ledger");
 const impedimento_1 = require("./impedimento");
+const types_1 = require("./types");
 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';
@@ -90,7 +91,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. */
@@ -116,8 +119,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)) {
@@ -224,7 +252,8 @@ function avaliarOcupacao(thread, doLedger, opcoes) {
         };
     }
     const registro = (0, sessoes_adopt_1.ehRegistroDeAdocao)(thread);
-    if (!registro && (sessaoEstado === 'working' || (sessaoEstado === '' && sessionId !== null))) {
+    // RM-063 (fatia 3, achado a): `busy` e `running` tambem sao a sessao trabalhando.
+    if (!registro && ((0, types_1.estadoDeTrabalho)(sessaoEstado) || (sessaoEstado === '' && sessionId !== null))) {
         return {
             ...base,
             classe: 'ativa',

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"));
@@ -49,28 +51,33 @@ const node_crypto_1 = require("node:crypto");
 const manifest_1 = require("./manifest");
 const project_state_1 = require("./project-state");
 const ledger_1 = require("./ledger");
+const transporte_do_canal_1 = require("./transporte-do-canal");
 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 +86,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) &&
@@ -135,6 +142,9 @@ function validarConteudo(etapa, conteudo) {
             invalido();
         }
     }
+    // RM-063 (fatia 3, H3): o canal do dono, com o host e o chat autorizado; o transporte pronto sai dele.
+    if (etapa === 'maestro' && objeto(conteudo) && Object.hasOwn(conteudo, 'canal') && !(0, transporte_do_canal_1.canalValido)(conteudo.canal))
+        invalido();
     // Etapas sensíveis usam um formato fechado: não há espaço para texto de credenciais.
     if (etapa === 'credenciais' || etapa === 'bancos') {
         if (!objeto(conteudo))
@@ -336,16 +346,23 @@ function gravarEtapa(raiz, nome, conteudo, por = 'owner') {
     const etapa = exigirEtapa(nome);
     exigirAutor(por);
     validarConteudo(etapa, conteudo);
+    // RM-063 (fatia 3, H3): o transporte pronto do host do canal, resolvido nesta maquina antes de qualquer gravacao.
+    const transporte = etapa === 'maestro' && objeto(conteudo) && (0, transporte_do_canal_1.canalValido)(conteudo.canal)
+        ? (0, transporte_do_canal_1.transporteDoCanal)(raiz, conteudo.canal) : null;
     return comTrava(raiz, () => {
         const solicitadas = conteudo;
         const { estado } = lerParaMutacao(raiz), anterior = estado.etapas[etapa];
-        // Configurar preferências não apaga objetivos ou outras respostas da etapa maestro.
-        if (etapa === 'maestro' && objeto(conteudo) && objeto(conteudo.owner) && anterior && objeto(anterior.conteudo)) {
-            conteudo = { ...anterior.conteudo, ...conteudo, owner: {
-                    ...(objeto(anterior.conteudo.owner) ? anterior.conteudo.owner : {}), ...conteudo.owner,
-                } };
+        // Configurar preferências (ou o canal, RM-063) não apaga objetivos ou outras respostas da etapa maestro.
+        if (etapa === 'maestro' && objeto(conteudo) && (objeto(conteudo.owner) || objeto(conteudo.canal)) && anterior && objeto(anterior.conteudo)) {
+            conteudo = { ...anterior.conteudo, ...conteudo, ...(objeto(conteudo.owner) ? { owner: {
+                        ...(objeto(anterior.conteudo.owner) ? anterior.conteudo.owner : {}), ...conteudo.owner,
+                    } } : {}) };
             validarConteudo(etapa, conteudo);
         }
+        // RM-063 (fatia 3, H3): o transporte do pulse sai junto com o canal do dono, e antes da resposta: sem o host nesta
+        // maquina, nada e gravado. A mesma resposta de novo regrava o transporte (a maquina nunca fica sem ele).
+        if (transporte)
+            (0, transporte_do_canal_1.gravarTransporteDoCanal)(raiz, transporte);
         validarConteudo(etapa, conteudo);
         // Persistir só chaves deste pedido: uma resposta antiga não vence edição explícita do manifesto.
         validarConteudo(etapa, solicitadas);
@@ -405,10 +422,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

@@ -84,6 +84,7 @@ 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");
+const dsn_da_memoria_1 = require("./dsn-da-memoria");
 /** As colecoes do OrkMind que o `ork` grava (guia: docs/guias/memoria-e-handoff.md). */
 exports.COLECOES_DO_ORK = [
     'decision',
@@ -393,8 +394,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);
@@ -410,6 +415,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. */
@@ -419,26 +427,17 @@ class DriverCliOrkMind {
         return chaveDeEmbeddingAceita(valor, this.config.dsn) ? valor : '';
     }
     contemSegredo(valor) {
-        const segredo = this.config.dsn;
-        const proibidos = [segredo];
+        // RM-069 (D6, D20, D21): a DSN e a senha dela, de qualquer tamanho, pelos fragmentos e pela barreira de domicilio unico.
+        const proibidos = (0, dsn_da_memoria_1.fragmentosDaDsn)(this.config.dsn);
         const nome = this.config.variavelDaChaveDeEmbedding ?? '';
         const chave = nome ? (process.env[nome] ?? '').trim() : '';
         if (chave.length >= 12)
             proibidos.push(chave);
-        try {
-            const senha = new URL(segredo).password;
-            if (senha.length >= 12)
-                proibidos.push(senha, decodeURIComponent(senha));
-        }
-        catch { /* DSN opaca */ }
-        const examinar = (x) => typeof x === 'string'
-            ? proibidos.some(p => p && x.includes(p))
-            : !!x && typeof x === 'object' && Object.entries(x).some(([k, v]) => examinar(k) || examinar(v));
-        return examinar(valor);
+        return (0, dsn_da_memoria_1.contemFragmento)(valor, proibidos);
     }
     rodar(pedido, timeoutMs = this.config.timeoutMs) {
         if (!this.config.dsn.trim())
-            throw new Error('dsn.env-ausente');
+            throw new Error(this.config.falhaDaDsn ?? 'dsn.env-ausente');
         if (this.contemSegredo(pedido))
             throw new Error('memory.transport.secret: conteudo recusado');
         const [python, ...prefixo] = this.python();
@@ -913,14 +912,21 @@ class DriverEmMemoria {
     }
 }
 exports.DriverEmMemoria = DriverEmMemoria;
-/** Config de memoria efetiva a partir do manifesto, ja com o tenant resolvido. */
-function configDoManifesto(manifesto) {
-    const variavel = manifesto.memory.database_url_env ?? '';
+/**
+ * Config de memoria efetiva a partir do manifesto, ja com o tenant resolvido. RM-069: a DSN vem da fonte declarada
+ * (a variavel de `database_url_env` ou o arquivo de `database_url_file`) pelo resolvedor unico, lida a cada chamada (D12).
+ */
+function configDoManifesto(manifesto, env = process.env) {
+    const fonte = (0, dsn_da_memoria_1.resolverDsn)(manifesto.memory, { env });
     return {
         modo: manifesto.memory.mode,
         cli: manifesto.memory.cli || 'orkmind',
-        variavel,
-        dsn: variavel ? (process.env[variavel] ?? '') : '',
+        variavel: fonte.fonte === 'ambiente' ? fonte.rotulo : '',
+        dsn: fonte.dsn,
+        fonteDaDsn: fonte.fonte,
+        rotuloDaDsn: fonte.rotulo,
+        falhaDaDsn: fonte.falha,
+        detalheDaDsn: fonte.detalhe,
         timeoutMs: manifesto.memory.timeout_ms || 15000,
         universoTimeoutMs: prazoDoUniversoMs(manifesto.memory.universo_timeout_ms),
         tenant: manifesto.memory.tenant || manifesto.project.name,
@@ -936,9 +942,18 @@ function correcaoDe(motivo, config) {
         case 'modo.desconhecido':
             return 'memory.mode aceita files ou orkmind';
         case 'dsn.nao-declarado':
-            return 'declare memory.database_url_env com o NOME da variavel de ambiente da base do tenant';
+            return 'declare memory.database_url_file (arquivo 0600 em ~/.orkastery/segredos/) ou memory.database_url_env ' +
+                'com o NOME da variavel de ambiente da base do tenant';
         case 'dsn.env-ausente':
             return `exporte ${config.variavel} com a DSN da base propria do tenant (o ork nao adivinha base)`;
+        case 'dsn.arquivo-ausente':
+            return `grave a DSN da base propria do tenant em ${config.rotuloDaDsn}, numa linha e com permissao 0600 (o ork nao adivinha base)`;
+        case 'dsn.arquivo-inseguro':
+            return `deixe ${config.rotuloDaDsn} como arquivo do usuario que roda o ork, numa pasta dele, com chmod 600 ` +
+                '(DSN que outro usuario pode ler nao e lida)';
+        case 'dsn.arquivo-invalido':
+            return `regrave ${config.rotuloDaDsn} como arquivo comum numa pasta de segredos comum, dentro da casa do usuario e ` +
+                'sem link simbolico no caminho, so com a DSN (esquema://...), numa linha e sem NOME= na frente';
         case 'cli.ausente':
             return `instale o OrkMind e garanta "${config.cli}" no PATH`;
         case 'orkmind.indisponivel':
@@ -959,6 +974,9 @@ function resolverRegime(manifesto, driver) {
         dsnPresente: config.dsn.trim() !== '',
         cli: config.cli,
         tenant: config.tenant,
+        // RM-069 (D5): a fonte da DSN, aditiva; o arquivo so pelo rotulo com `~`.
+        fonteDaDsn: config.fonteDaDsn ?? 'nenhuma',
+        ...(config.fonteDaDsn === 'arquivo' ? { arquivoDaDsn: config.rotuloDaDsn } : {}),
     };
     const degradar = (motivo, detalhe) => ({
         estado: {
@@ -976,9 +994,13 @@ function resolverRegime(manifesto, driver) {
     if (config.modo !== 'orkmind') {
         return degradar('modo.desconhecido', `memory.mode "${config.modo}" nao e um regime conhecido`);
     }
-    // Isolamento por tenant: sem NOME de variavel declarado nao ha base, e nao ha palpite.
-    if (config.variavel === '') {
-        return degradar('dsn.nao-declarado', 'memory.database_url_env vazio: sem base declarada o ork nao conecta em base nenhuma');
+    // Isolamento por tenant: sem fonte declarada (variavel ou arquivo) nao ha base, e nao ha palpite.
+    if (config.fonteDaDsn === 'nenhuma') {
+        return degradar('dsn.nao-declarado', 'memory.database_url_file e memory.database_url_env vazios: sem base declarada o ork nao conecta em base nenhuma');
+    }
+    // RM-069: o arquivo que falha degrada com o motivo dele e nunca cai para a variavel.
+    if (config.dsn.trim() === '' && !driver && config.fonteDaDsn === 'arquivo') {
+        return degradar(config.falhaDaDsn ?? 'dsn.arquivo-ausente', `${config.detalheDaDsn}: o ork nao cai para outra fonte (precedente memory-orkmind)`);
     }
     if (config.dsn.trim() === '' && !driver) {
         return degradar('dsn.env-ausente', `${config.variavel} nao esta no ambiente: o ork nao cai para outra DSN (precedente memory-orkmind)`);
@@ -996,7 +1018,8 @@ function resolverRegime(manifesto, driver) {
             ...base,
             efetivo: 'orkmind',
             motivo: null,
-            detalhe: `${efetivoDriver.nome} ativo na base declarada por ${config.variavel}: ${saude.detalhe}`,
+            detalhe: `${efetivoDriver.nome} ativo na base declarada por ${config.fonteDaDsn === 'arquivo' ? config.rotuloDaDsn : config.variavel}: ` +
+                saude.detalhe,
             correcao: '',
         },
         driver: efetivoDriver,

package/dist/orquestracao.js

@@ -74,12 +74,15 @@ const modos_1 = require("./modos");
 const ocupacao_1 = require("./ocupacao");
 const ratelimit_1 = require("./ratelimit");
 const impedimento_1 = require("./impedimento");
+const runtime_escada_1 = require("./runtime-escada");
 const thread_1 = require("./thread");
+const types_1 = require("./types");
 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). */
@@ -157,7 +160,8 @@ function pausasAbertas(thread, eventos, estados, quando) {
         // continua listada, e o monitor a lia como uma sessao que ainda ia terminar. Uma
         // sessao `blocked` e o contrario disso -- ela e a pausa, ja chegada.
         const sessaoEstado = estados === null ? null : estados.get(sessionId) ?? null;
-        const sessaoViva = estados === null ? null : sessaoEstado === 'working' || sessaoEstado === '';
+        // RM-063 (fatia 3, achado a): `busy` e `running` tambem sao a sessao trabalhando.
+        const sessaoViva = estados === null ? null : (0, types_1.estadoDeTrabalho)(sessaoEstado) || sessaoEstado === '';
         const sobre = typeof e.previstaSobre === 'string' && e.previstaSobre !== ''
             ? e.previstaSobre
             : blocoDaFase(thread, fase).pausaSobre;
@@ -168,16 +172,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,
@@ -203,16 +208,20 @@ function pausasAbertas(thread, eventos, estados, quando) {
             return;
         const { bloco, pausaSobre } = blocoDaFase(thread, fase);
         const imp = (0, impedimento_1.ehImpedimentoDoDono)(e.motivo) ? (0, impedimento_1.impedimentoDoEvento)(e) : null;
+        // RM-063 (F4): a escada de recuperacao do runtime que acabou chama o dono com as alternativas e o comando que retoma.
+        const escada = !imp && e.motivo === 'human.pending' ? (0, runtime_escada_1.escadaDoEvento)(e) : null;
         porFase.set(chave, parada({
             natureza: 'pausa-humana',
             motivo: imp ? e.motivo : 'human.pending',
             fase,
             bloco,
-            pausaSobre: imp ? `rodar \`${imp.comando}\` no terminal` : pausaSobre || 'autorizacao da retomada',
+            pausaSobre: imp ? `rodar \`${imp.comando}\` no terminal` : escada ? 'a escada de recuperacao do runtime'
+                : pausaSobre || 'autorizacao da retomada',
             ...(imp ? { impedimento: imp } : {}),
+            ...(escada ? { escada } : {}),
             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
@@ -233,7 +242,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,
@@ -258,9 +267,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 ${(0, leases_1.argumentoDeLease)(p.colidiuCom)} --thread ${(0, leases_1.argumentoDeLease)(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',
@@ -277,8 +286,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,
@@ -314,7 +322,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
@@ -492,61 +500,50 @@ function montarMonitor(carregado, opcoes = {}) {
  * ISO (o `--json` e o ledger nao mudam); aqui o horario sai no fuso do dono.
  */
 function linhaDaParada(p, agora) {
+    const m = (0, locale_1.msg)().operacao.restante.monitor;
     const local = (texto) => (0, horario_1.localizarTexto)(texto, { agora });
     const L = [];
-    L.push(`      [${p.motivo}] parada ha ${(0, horario_1.duracaoRelativa)(p.paradaHaMin)} (desde ${(0, horario_1.formatarHora)(p.desdeEm, { agora })})`);
+    L.push(m.parada(p.motivo, (0, horario_1.duracaoRelativa)(p.paradaHaMin), (0, horario_1.formatarHora)(p.desdeEm, { agora })));
     if (p.pausaSobre)
-        L.push(`      o humano decide: ${p.pausaSobre}`);
-    L.push(`      detalhe  : ${local(p.detalhe)}`);
-    L.push(`      evidencia: ${local(p.evidencia)}`);
-    L.push(`      correcao : ${local(p.correcao)}`);
+        L.push(m.humanoDecide(local(p.pausaSobre)));
+    L.push(m.detalhe(local(p.detalhe)));
+    L.push(m.evidencia(local(p.evidencia)));
+    L.push(m.correcao(local(p.correcao)));
     return L;
 }
 /** Texto de `ork orquestracao status`. */
 function textoDoMonitor(m) {
+    const t = (0, locale_1.msg)().operacao.restante.monitor;
     const L = [];
-    L.push(`Monitor de orquestracao, projeto ${m.projeto} ` +
-        `(${m.resumo.threads} thread(s) em ${m.perfis.length} perfil(is): ${m.perfis.join(', ')})`);
-    L.push(`  aguardando humano: ${m.resumo.aguardandoHumano} | com impedimento: ${m.resumo.comImpedimento} | ` +
-        `em andamento: ${m.resumo.emAndamento} | podem avancar: ${m.resumo.podemAvancar} | ` +
-        `fechadas: ${m.resumo.fechadas}`);
-    L.push(`  limite de atencao: ${m.atencaoMin} min (${m.resumo.acimaDoLimite} parada(s) acima, marcadas com !)`);
+    L.push(t.titulo(m.projeto, m.resumo.threads, m.perfis.length, m.perfis.join(', ')));
+    L.push(t.resumo(m.resumo.aguardandoHumano, m.resumo.comImpedimento, m.resumo.emAndamento, m.resumo.podemAvancar, m.resumo.fechadas));
+    L.push(t.limite(m.atencaoMin, m.resumo.acimaDoLimite));
     L.push(`  ${(0, horario_1.legendaDoFuso)(undefined, m.consultadoEm)}`);
     if (!m.runtimeConsultado) {
-        L.push(`  [warn] ${m.runtimeDetalhe}: pausa prevista e reportada como valendo`);
+        L.push(t.runtime(m.runtimeDetalhe));
     }
     L.push('');
     // I-36 (T17): conducao em andamento nao e parada; ela aparece antes, com a linha unica.
     const conduzidas = m.linhas.filter((l) => l.conducao);
     if (conduzidas.length > 0) {
-        L.push('Conduzidas agora:');
+        L.push(t.conduzidas);
         for (const l of conduzidas)
             L.push(`  ${l.thread}: ${(0, conducao_texto_1.linhaDeConducao)(l.conducao, { agora: m.consultadoEm })}`);
         L.push('');
     }
     if (m.linhas.length === 0) {
-        L.push('  Nenhuma thread parada: ninguem esperando veredito humano nem impedido.');
+        L.push(t.nenhuma);
         return L.join('\n');
     }
-    L.push((0, util_1.tabela)([
-        'PERFIL',
-        'THREAD',
-        'FASE',
-        'STATUS',
-        'BLOCO QUE PAUSA',
-        'AGUARDA DO HUMANO',
-        'IMPEDIMENTO',
-        'ULTIMO EVENTO',
-        'PARADA HA',
-    ], m.linhas.map((l) => [
+    L.push((0, util_1.tabela)([...t.colunas], m.linhas.map((l) => [
         l.perfil,
         l.thread,
         l.faseAtual,
-        l.situacao,
+        t.situacoes[l.situacao] ?? l.situacao,
         l.pausas.map((p) => p.bloco || '?').join(' ') || '-',
         l.pausas.map((p) => p.pausaSobre).filter((s) => s !== '').join('; ') || '-',
-        l.impedimentos.map((p) => p.motivo).join(' ') || 'nao',
-        l.ultimoEvento ? l.ultimoEvento.tipo : '(sem ledger)',
+        l.impedimentos.map((p) => p.motivo).join(' ') || t.nao,
+        l.ultimoEvento ? l.ultimoEvento.tipo : t.semLedger,
         l.paradaHaMin === null
             ? '-'
             : `${(0, horario_1.duracaoRelativa)(l.paradaHaMin)}${l.acimaDoLimite ? ' !' : ''}`,
@@ -554,7 +551,7 @@ function textoDoMonitor(m) {
     const hitl = m.linhas.filter((l) => l.precisaDeHumano);
     if (hitl.length > 0) {
         L.push('');
-        L.push('Esperando VEREDITO HUMANO agora (o orquestrador deve avisar o humano):');
+        L.push(t.esperando);
         for (const l of hitl) {
             L.push(`  ${l.thread} (${l.tag}, ${l.nome})`);
             for (const p of l.pausas.filter((x) => x.sessaoViva !== true))
@@ -564,7 +561,7 @@ function textoDoMonitor(m) {
     const impedidas = m.linhas.filter((l) => l.temImpedimento);
     if (impedidas.length > 0) {
         L.push('');
-        L.push('Com IMPEDIMENTO (nao e veredito humano: e colisao, gate, limite ou janela):');
+        L.push(t.impedidas);
         for (const l of impedidas) {
             L.push(`  ${l.thread} (${l.tag}, ${l.nome})`);
             for (const p of l.impedimentos)
@@ -574,16 +571,16 @@ function textoDoMonitor(m) {
     const emCurso = m.linhas.filter((l) => l.pausas.some((p) => p.sessaoViva === true));
     if (emCurso.length > 0) {
         L.push('');
-        L.push('Pausa PREVISTA, sessao ainda viva (nao avise ainda, mas ja e a proxima fila):');
+        L.push(t.previstas);
         for (const l of emCurso) {
             for (const p of l.pausas.filter((x) => x.sessaoViva === true)) {
-                L.push(`  ${l.thread}: ${p.bloco || '?'} vai pausar sobre "${p.pausaSobre}"`);
+                L.push(t.vaiPausar(l.thread, p.bloco || '?', (0, horario_1.localizarTexto)(p.pausaSobre, { agora: m.consultadoEm })));
             }
         }
     }
     if (m.resumo.aguardandoHumano === 0 && m.resumo.comImpedimento === 0) {
         L.push('');
-        L.push('  Nenhuma thread parada: ninguem esperando veredito humano nem impedido.');
+        L.push(t.nenhuma);
     }
     return L.join('\n');
 }