@orkastery/cli 0.5.6 → 0.6.0

package/dist/ocupacao.js

@@ -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';
@@ -251,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

@@ -51,6 +51,7 @@ 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");
@@ -141,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))
@@ -342,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);

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',
@@ -426,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();
@@ -920,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,
@@ -943,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':
@@ -966,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: {
@@ -983,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)`);
@@ -1003,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,7 +74,9 @@ 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; } });
@@ -158,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;
@@ -205,13 +208,17 @@ 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
                 : (0, locale_1.textoDoCatalogo)((m) => m.pulse.motivos['human.pending']),
@@ -493,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 ? ' !' : ''}`,
@@ -555,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))
@@ -565,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)
@@ -575,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');
 }