@orkastery/cli 0.5.6 → 0.6.0

package/dist/mcp-server.js

@@ -62,10 +62,13 @@ const network_roadmap_1 = require("./network-roadmap");
 const rede_status_1 = require("./rede-status");
 const hitl_sessions_1 = require("./hitl-sessions");
 const hitl_local_1 = require("./hitl-local");
+const master_nota_local_1 = require("./master-nota-local");
+const entrega_por_mod_1 = require("./entrega-por-mod");
 const mcp_artifacts_1 = require("./mcp-artifacts");
 const mcp_git_1 = require("./mcp-git");
 const preflight_1 = require("./preflight");
 const modos_1 = require("./modos");
+const mcp_noctum_1 = require("./mcp-noctum");
 const versao_1 = require("./versao");
 const mcp_verify_1 = require("./mcp-verify");
 const conducao_1 = require("./conducao");
@@ -81,6 +84,8 @@ const mcp_maestro_1 = require("./mcp-maestro");
 const projeto_alvo_1 = require("./projeto-alvo");
 const mcp_experiencia_1 = require("./mcp-experiencia");
 const mcp_grafo_1 = require("./mcp-grafo");
+const mcp_conhecimento_1 = require("./mcp-conhecimento");
+const locale_1 = require("./locale");
 const identidade = zod_1.z.string().min(1).max(80).regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/);
 const daThread = zod_1.z.object({ threadId: identidade }).strict();
 const daDecisao = daThread.extend({ pedidoId: identidade }).strict();
@@ -327,7 +332,7 @@ function criarServidorMcp(opcoes) {
         .describe('Nome ou abbrev do projeto pedido; este servidor atende somente o projeto fixado na instalacao');
     const ferramentas = new Map();
     function registrarTool(nome, config, executar) {
-        if (opcoes.threadId && ['ork_thread_new', 'ork_phase_run', 'ork_request_decision', 'ork_preflight'].includes(nome))
+        if (opcoes.threadId && ['ork_thread_new', 'ork_phase_run', 'ork_request_decision', 'ork_request_master_note', 'ork_preflight'].includes(nome))
             return;
         const entrada = config.inputSchema.extend({ projeto: campoProjeto.optional() });
         const schema = converterSchema(entrada, { $refStrategy: 'none' });
@@ -354,7 +359,11 @@ function criarServidorMcp(opcoes) {
             return { ...resposta({ erro: e.message }), isError: true };
         }
     });
-    const ingresso = (0, hitl_local_1.criarIngressoLocal)(raiz, { host: opcoes.host, connectionId: (0, node_crypto_1.randomUUID)() }, async (pedido, signal) => {
+    const conexaoLocal = (0, node_crypto_1.randomUUID)();
+    // RM-059 (F9, G3): a caixa de saida do Mensageiro de Sessoes so existe no servidor do dono do Claude Code, na memoria:
+    // a resposta a uma sessao claude-bg que entra pelo dialogo deste servidor sai por ela, e o texto nunca vai a disco.
+    const caixa = opcoes.host === 'claude-code' && !opcoes.threadId ? (0, entrega_por_mod_1.novaCaixaDeSaida)() : null;
+    const ingresso = (0, hitl_local_1.criarIngressoLocal)(raiz, { host: opcoes.host, connectionId: conexaoLocal }, async (pedido, signal) => {
         carregar();
         thread(pedido.thread);
         // D12: pergunta nativa que aceita texto NAO vira menu. Um menu sobre pergunta aberta
@@ -376,11 +385,33 @@ function criarServidorMcp(opcoes) {
             return { action: r.action };
         const parsed = zod_1.z.object({ opcao: zod_1.z.string().min(1).max(limite) }).strict().parse(r.content);
         return { action: 'accept', content: parsed };
-    });
-    server.onclose = () => ingresso.fechar();
+    }, { caixa });
+    // RM-059 (fatia F8, T8.1): a nota do MASTER pelo mesmo ingresso local. O formulario e fixo (a nota de 0 a 5 e o
+    // porque); sem a capacidade de formulario no cliente, a recusa vem antes de qualquer escrita.
+    const ingressoDaNota = (0, master_nota_local_1.criarIngressoDaNota)(raiz, { host: opcoes.host, connectionId: conexaoLocal }, async (apresentacao, signal) => {
+        carregar();
+        thread(apresentacao.thread);
+        const r = await server.elicitInput({ mode: 'form', message: apresentacao.mensagem,
+            requestedSchema: apresentacao.esquema }, { signal, timeout: 300000 });
+        return r.action === 'accept' ? { action: 'accept', content: r.content } : { action: r.action };
+    }, () => Boolean(server.getClientCapabilities()?.elicitation?.form));
+    server.onclose = () => { ingresso.fechar(); ingressoDaNota.fechar(); };
     (0, company_brain_mcp_1.registerBrainTools)(registrarTool, carregar, thread, opcoes.brainWrites ?? []);
     (0, mcp_experiencia_1.registrarConsultasExperiencia)(registrarTool, { raiz, carregar, transporte: opcoes.transporteShip ?? 'github-ssh' });
+    // RM-026 K7 (fatia 2): o conhecimento escrito, só leitura, do projeto fixado; também na sessão filha vinculada.
+    (0, mcp_conhecimento_1.registrarConsultasDoConhecimento)(registrarTool, carregar);
     (0, mcp_maestro_1.registerMaestro)(registrarTool, { root: raiz, threadId: opcoes.threadId, load: carregar, checkThread: thread, tools: () => [...ferramentas.keys()] });
+    // RM-058 N6 (D12): o arco #Noctum no host do dono, com o dialogo nativo deste servidor; nunca na sessao de fase.
+    if (!opcoes.threadId)
+        (0, mcp_noctum_1.registrarFerramentasDoNoctum)(registrarTool, { raiz, carregar, host: opcoes.host, conexao: conexaoLocal,
+            elicitar: async (a, signal) => {
+                // RM-057 (resposta curta, D7 da ork-rm057respost): a pergunta no contrato curto e o envelope inteiro abaixo dela.
+                const r = await server.elicitInput({ mode: 'form', message: a.mensagem,
+                    requestedSchema: { type: 'object', properties: { opcao: { type: 'string', title: 'Sua decisão', oneOf: a.opcoes.map(x => ({ const: x, title: x })) } },
+                        required: ['opcao'] } }, { signal, timeout: 300000 });
+                return r.action === 'accept' ? { action: 'accept', content: r.content } : { action: r.action };
+            },
+            temFormulario: () => Boolean(server.getClientCapabilities()?.elicitation?.form) });
     registrarTool('ork_preflight', { description: 'Preflight contextual por modo e bloco, sem inventário global/modelos. Não autoriza despacho nem comprova entrega.',
         inputSchema: zod_1.z.object({ modo: modoDeConducao }).strict(), annotations: { readOnlyHint: true } }, async ({ modo }) => {
         carregar();
@@ -454,15 +485,18 @@ function criarServidorMcp(opcoes) {
         annotations: { readOnlyHint: false, destructiveHint: false } }, async ({ threadId, ...e }) => {
         thread(threadId);
         livre(threadId);
-        // A sessao decide por ela: o rastro nao pode nascer assinado em nome do dono.
-        if (/^\s*(?:o\s+|a\s+)?(?:dono|owner|builder|maestro)\b/i.test(e.quemDecidiu))
-            throw Error('mcp.decision.author: quemDecidiu e a sessao que decidiu, nunca o dono');
+        const locale = (0, locale_1.resolverLocale)(carregar().manifesto.owner?.language).locale;
         let registro;
         try {
-            registro = (0, decisao_autonoma_1.registrarDecisao)(raiz, threadId, { decidido: e.decidido, porque: e.porque, comoMudar: e.comoMudar,
-                custoDeReverter: { agora: e.custoAgora, depois: e.custoDepois }, criterio: e.criterio, quemDecidiu: e.quemDecidiu,
-                evidencia: e.evidencia, ...(e.razao ? { razao: e.razao } : {}), ...(e.reverte ? { reverte: e.reverte } : {}), origem: 'mcp', host: opcoes.host,
-                despacho: opcoes.dispatchId ?? null });
+            registro = (0, locale_1.comLocale)(locale, () => {
+                // A sessao decide por ela: o rastro nao pode nascer assinado em nome do dono.
+                if (/^\s*(?:o\s+|a\s+)?(?:dono|owner|builder|maestro)\b/i.test(e.quemDecidiu))
+                    throw new locale_1.ErroDoCatalogo((m) => m.decisao.autorMcp);
+                return (0, decisao_autonoma_1.registrarDecisao)(raiz, threadId, { decidido: e.decidido, porque: e.porque, comoMudar: e.comoMudar,
+                    custoDeReverter: { agora: e.custoAgora, depois: e.custoDepois }, criterio: e.criterio, quemDecidiu: e.quemDecidiu,
+                    evidencia: e.evidencia, ...(e.razao ? { razao: e.razao } : {}), ...(e.reverte ? { reverte: e.reverte } : {}), origem: 'mcp', host: opcoes.host,
+                    despacho: opcoes.dispatchId ?? null });
+            });
         }
         catch (erro) {
             throw Error((0, hitl_contract_1.recusaNaSuperficie)(erro.message, hitl_contract_1.CAMPOS_DA_DECISAO_NO_MCP));
@@ -507,9 +541,11 @@ function criarServidorMcp(opcoes) {
      */
     registrarTool('ork_network_roadmap', { description: 'Roadmap da rede do projeto servido, somente leitura: o status report do roadmap (RM-048) com as threads de TODAS as maquinas, as reservas, as threads por maquina com a idade da batida, a fonte e a hora de cada parte e as lacunas tipadas. E a fonte do status do roadmap: transporte o texto como vem, sem reescrever nem resumir. Lacuna e "Nao consultado" sao o que nao foi lido: nunca conclua "roadmap vazio" nem "nenhuma maquina publicou" a partir deles. Este servidor le so o projeto fixado; os outros projetos vem do CLI ork network roadmap.',
         inputSchema: zod_1.z.object({}).strict(), annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true } }, async () => {
-        carregar();
-        const panorama = (0, network_roadmap_1.montarPanoramaDaRede)({ fixado: raiz });
-        return resposta({ texto: (0, network_roadmap_1.textoDoPanoramaDaRede)(panorama), panorama });
+        const c = carregar();
+        // O panorama devolvido continua no contrato pt-BR; somente o texto humano segue o dono.
+        const panorama = (0, locale_1.comLocale)('pt-BR', () => (0, network_roadmap_1.montarPanoramaDaRede)({ fixado: raiz }));
+        const locale = (0, locale_1.resolverLocale)(c.manifesto.owner?.language).locale;
+        return resposta({ texto: (0, locale_1.comLocale)(locale, () => (0, network_roadmap_1.textoDoPanoramaDaRede)(panorama)), panorama });
     });
     /**
      * RM-054 (fatia 3): as maquinas da pessoa (RM-053, `ork.rede-status/v1`), com a fonte, a batida e as
@@ -564,6 +600,38 @@ function criarServidorMcp(opcoes) {
         thread(threadId);
         return resposta(await ingresso.solicitar(threadId, pedidoId, extra.signal));
     });
+    registrarTool('ork_request_master_note', { description: 'Pede ao dono, pelo dialogo nativo do host, a nota de 0 a 5 e o porque de uma entrega. Somente o threadId; nunca forneca nota nem porque nos argumentos.',
+        inputSchema: daThread, annotations: { readOnlyHint: false, destructiveHint: false } }, async ({ threadId }, extra) => {
+        thread(threadId);
+        return resposta(await ingressoDaNota.solicitar(threadId, extra.signal));
+    });
+    // RM-059 (F9, T9.1): o Mensageiro de Sessoes nas duas pontas. Nenhuma das duas entra no --allowedTools do modelo (D8):
+    // quem chama e o mod ork-mensageiro, e nenhuma responde, aprova ou abre pedido.
+    if (caixa)
+        registrarTool('ork_session_outbox', { description: 'Caixa de saida do Mensageiro de Sessoes nesta sessao do dono: lista as respostas do dono que esperam ir a uma sessao de fase claude-bg (listar marca o Mensageiro vivo) e anota o resultado do envio. Nao responde, nao aprova nem abre pedido.',
+            inputSchema: zod_1.z.object({ operacao: zod_1.z.enum(['listar', 'enviada']), threadId: identidade.optional(), envioId: zod_1.z.string().uuid().optional(),
+                entregue: zod_1.z.boolean().optional(), motivo: zod_1.z.string().max(1000).optional() }).strict(),
+            annotations: { readOnlyHint: false, destructiveHint: false } }, async (args) => {
+            if (args.operacao === 'listar') {
+                carregar();
+                return resposta({ contrato: entrega_por_mod_1.CONTRATO_DA_ENTREGA, entregas: caixa.listar(raiz) });
+            }
+            if (!args.threadId || !args.envioId || args.entregue === undefined)
+                throw Error('mcp.outbox.args: enviada exige threadId, envioId e entregue');
+            thread(args.threadId);
+            return resposta({ contrato: entrega_por_mod_1.CONTRATO_DA_ENTREGA, entrega: caixa.anotarEnvio(raiz, args.threadId, args.envioId, args.entregue, args.motivo) });
+        });
+    if (opcoes.threadId && opcoes.dispatchId) {
+        const despacho = opcoes.dispatchId;
+        registrarTool('ork_session_inbox', { description: 'Lado receptor do Mensageiro de Sessoes na sessao de fase deste despacho: confere e reserva uma vez a resposta do dono que chegou de outra sessao (conferir, com o prazo ate) e, depois de ela entrar na fila, grava o recibo (confirmar). A sessao sai do despacho deste servidor, nunca de argumento. Nao responde nem aprova pedido.',
+            inputSchema: daThread.extend({ operacao: zod_1.z.enum(['conferir', 'confirmar']), texto: zod_1.z.string().max(entrega_por_mod_1.LIMITE_DA_MENSAGEM),
+                envioId: zod_1.z.string().uuid().optional(), ate: zod_1.z.string().max(40).optional() }).strict(),
+            annotations: { readOnlyHint: false, destructiveHint: false } }, async ({ threadId, operacao, texto, envioId, ate }) => {
+            thread(threadId);
+            return resposta(operacao === 'conferir' ? (0, entrega_por_mod_1.conferirNoReceptor)(raiz, threadId, despacho, texto, ate)
+                : (0, entrega_por_mod_1.confirmarNoReceptor)(raiz, threadId, despacho, envioId, texto));
+        });
+    }
     // RM-031 KG5 (D2): as tools do grafo so existem com a flag do manifesto da raiz no startup; sem ela, nada muda.
     // CHECK rodada 1 (S8): o startup le so o manifesto, como antes; as conferencias de estado ficam na chamada.
     if ((0, mcp_grafo_1.grafoLigado)((0, manifest_1.exigirManifesto)(raiz).manifesto))