@orkastery/cli 0.5.3 → 0.6.0

package/dist/runtime-context.js

@@ -34,8 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.novaIdentidadeDeDespacho = novaIdentidadeDeDespacho;
+exports.capacidadeDoRuntimeNoProjeto = capacidadeDoRuntimeNoProjeto;
 exports.contextoDoProjeto = contextoDoProjeto;
 exports.validarContextoRuntime = validarContextoRuntime;
+exports.lerDeclaracaoDeMod = lerDeclaracaoDeMod;
+exports.modsDeFaseInstalados = modsDeFaseInstalados;
 /** Contexto interno opt-in: configuracao M4 existente + catalogo instalado, nunca args do modelo. */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -47,6 +50,7 @@ const hosts_1 = require("./hosts");
 const worktree_1 = require("./worktree");
 const mcp_install_1 = require("./mcp-install");
 const mcp_grafo_1 = require("./mcp-grafo");
+const mcp_transportes_1 = require("./mcp-transportes");
 const hitl_public_receipt_1 = require("./hitl-public-receipt");
 /** Correlação interna; nenhuma identidade de despacho concede poder de gate. */
 function novaIdentidadeDeDespacho(threadId, fase) {
@@ -106,7 +110,7 @@ function preparado(raiz) {
         }
         if (JSON.stringify(argv) !== JSON.stringify(legado)) {
             if (!Array.isArray(argv) || argv.length !== padrao.args.length ||
-                argv[argv.length - 2] !== '--ship-transport' || !['github-ssh', 'bare-local'].includes(argv[argv.length - 1]))
+                argv[argv.length - 2] !== '--ship-transport' || !(0, mcp_transportes_1.ehTransporteShipMcp)(argv[argv.length - 1]))
                 throw Error('runtime.context.conflict: MCP Orkastery divergente; transporte invalido ou argumentos extras');
             transporte = argv[argv.length - 1];
         }
@@ -131,17 +135,78 @@ function raizCanonica(projeto) {
         dentro(raiz, path.join(raiz, '.orkastery'));
     return raiz;
 }
+function hostDoRuntime(runtime) {
+    if (runtime === 'claude-bg')
+        return 'claude-code';
+    if (runtime === 'codex')
+        return 'codex';
+    throw Error('runtime.context.invalid: runtime desconhecido');
+}
+/** Confere o recibo e todos os bytes do adaptador antes de considerar o runtime um destino. */
+function conferirInstalacaoDoHost(raiz, host) {
+    const def = hosts_1.HOSTS[host];
+    const instalacao = path.join(raiz, def.destinoPadrao, def.subdir ?? '');
+    let recibo;
+    try {
+        recibo = objeto(JSON.parse(ler(raiz, path.join(instalacao, 'INSTALADO.json'), 1048576).toString('utf8')));
+    }
+    catch {
+        throw Error('runtime.context.installation: instale/verifique o adaptador do runtime neste projeto');
+    }
+    if (recibo.contrato !== 'ork.adapter-install/v1' || recibo.host !== host || !Array.isArray(recibo.arquivos) || recibo.arquivos.length > 512)
+        throw Error('runtime.context.installation: recibo instalado invalido');
+    const arquivos = new Map();
+    // RM-059 (T0.7): os bytes ja conferidos da declaracao e do manifesto de cada mod, lidos uma vez so.
+    const conferidos = new Map();
+    for (const item of recibo.arquivos) {
+        const a = objeto(item);
+        if (typeof a.arquivo !== 'string' || path.isAbsolute(a.arquivo) || a.arquivo.split(/[\\/]/).includes('..') ||
+            typeof a.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(a.sha256) || arquivos.has(a.arquivo))
+            throw Error('runtime.context.installation: arquivo do recibo invalido');
+        const file = path.join(instalacao, a.arquivo);
+        if (!dentro(raiz, file).startsWith(instalacao + path.sep))
+            throw Error('runtime.context.installation: bytes instalados divergentes');
+        const bytes = ler(raiz, file, 1048576);
+        if ((0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex') !== a.sha256)
+            throw Error('runtime.context.installation: bytes instalados divergentes');
+        arquivos.set(a.arquivo, file);
+        if (DECLARACAO_OU_MANIFESTO_DE_MOD.test(a.arquivo))
+            conferidos.set(a.arquivo, bytes);
+    }
+    const bootstrap = arquivos.get('skills/core/orkastery-bootstrap/SKILL.md');
+    if (!bootstrap || (host === 'claude-code' && !arquivos.has('.claude-plugin/plugin.json')))
+        throw Error('runtime.context.installation: catalogo ou plugin incompleto');
+    return { instalacao, arquivos, conferidos, bootstrap };
+}
+/**
+ * Um projeto preparado so pode escolher runtimes cujo adaptador esteja instalado e integro.
+ * Projeto legado, sem entrada MCP do Orkastery, conserva a selecao anterior.
+ */
+function capacidadeDoRuntimeNoProjeto(projeto, runtime) {
+    let host = null;
+    try {
+        const raiz = raizCanonica(projeto);
+        const perfil = preparado(raiz);
+        if (!perfil)
+            return { runtime, host: null, preparado: false, capaz: true, motivo: null };
+        host = hostDoRuntime(runtime);
+        conferirInstalacaoDoHost(raiz, host);
+        return { runtime, host, preparado: true, capaz: true, motivo: null };
+    }
+    catch (erro) {
+        return { runtime, host, preparado: true, capaz: false, motivo: erro.message };
+    }
+}
 /** Projeto sem entrada MCP Orkastery continua com o contrato legado. Nao instala nem altera arquivos. */
 function contextoDoProjeto(projeto, runtime, cwd, threadId) {
     const raiz = raizCanonica(projeto);
     const perfil = preparado(raiz);
     if (!perfil)
         return undefined;
-    if (!['claude-bg', 'codex'].includes(runtime))
-        throw Error('runtime.context.invalid: runtime desconhecido');
+    const host = hostDoRuntime(runtime);
     if (!threadId)
         throw Error('runtime.context.invalid: thread obrigatoria para sessao filha');
-    const contexto = { projeto: raiz, host: runtime === 'codex' ? 'codex' : 'claude-code', threadId, transporteShip: perfil.transporteShip, permissoesFilho: perfil.permissoesFilho };
+    const contexto = { projeto: raiz, host, threadId, transporteShip: perfil.transporteShip, permissoesFilho: perfil.permissoesFilho };
     validarContextoRuntime(contexto, cwd);
     return contexto;
 }
@@ -149,7 +214,7 @@ function contextoDoProjeto(projeto, runtime, cwd, threadId) {
 function validarContextoRuntime(contexto, cwd) {
     if (!contexto || !['claude-code', 'codex'].includes(contexto.host))
         throw Error('runtime.context.invalid: host desconhecido');
-    if (contexto.transporteShip !== undefined && !['github-ssh', 'bare-local'].includes(contexto.transporteShip))
+    if (contexto.transporteShip !== undefined && !(0, mcp_transportes_1.ehTransporteShipMcp)(contexto.transporteShip))
         throw Error('runtime.context.invalid: transporte desconhecido');
     const raiz = raizCanonica(contexto.projeto);
     if (contexto.permissoesFilho !== undefined && !['interactive', 'worktree'].includes(contexto.permissoesFilho))
@@ -181,39 +246,226 @@ function validarContextoRuntime(contexto, cwd) {
         if (!(0, worktree_1.worktreesDoGit)(raiz).some(w => w.dir === cwd && w.branch === (0, worktree_1.branchDaWorktree)(thread)))
             throw Error('runtime.context.worktree: worktree nao registrada na branch da thread');
     }
-    const def = hosts_1.HOSTS[contexto.host];
-    const instalacao = path.join(raiz, def.destinoPadrao, def.subdir ?? '');
-    let recibo;
-    try {
-        recibo = objeto(JSON.parse(ler(raiz, path.join(instalacao, 'INSTALADO.json'), 1048576).toString('utf8')));
-    }
-    catch {
-        throw Error('runtime.context.installation: instale/verifique o adaptador do runtime neste projeto');
-    }
-    if (recibo.contrato !== 'ork.adapter-install/v1' || recibo.host !== contexto.host || !Array.isArray(recibo.arquivos) || recibo.arquivos.length > 512)
-        throw Error('runtime.context.installation: recibo instalado invalido');
-    const arquivos = new Map();
-    for (const item of recibo.arquivos) {
-        const a = objeto(item);
-        if (typeof a.arquivo !== 'string' || path.isAbsolute(a.arquivo) || a.arquivo.split(/[\\/]/).includes('..') ||
-            typeof a.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(a.sha256) || arquivos.has(a.arquivo))
-            throw Error('runtime.context.installation: arquivo do recibo invalido');
-        const file = path.join(instalacao, a.arquivo);
-        if (!dentro(raiz, file).startsWith(instalacao + path.sep) || (0, node_crypto_1.createHash)('sha256').update(ler(raiz, file, 1048576)).digest('hex') !== a.sha256)
-            throw Error('runtime.context.installation: bytes instalados divergentes');
-        arquivos.set(a.arquivo, file);
-    }
-    const bootstrap = arquivos.get('skills/core/orkastery-bootstrap/SKILL.md');
-    if (!bootstrap || (contexto.host === 'claude-code' && !arquivos.has('.claude-plugin/plugin.json')))
-        throw Error('runtime.context.installation: catalogo ou plugin incompleto');
+    const { instalacao, arquivos, conferidos, bootstrap } = conferirInstalacaoDoHost(raiz, contexto.host);
+    const modsDeFase = contexto.host === 'claude-code' ? modsDeFaseInstalados(raiz, instalacao, arquivos, conferidos) : [];
     // Capacidade derivada do bloco atual, nunca aceita como entrada do modelo.
     const permiteEditarProduto = permissoesFilho === 'worktree' && (0, thread_1.blocoDaThread)(thread, thread.faseAtual).fases.includes('GO');
     // RM-031 KG5 (D2, D7): as tools do grafo seguem a flag do manifesto da raiz, que o servidor do filho tambem le;
     // o manifesto da worktree da thread e o pedido do modelo nao ligam nada.
-    const grafoMcp = (0, mcp_grafo_1.grafoLigado)((0, manifest_1.exigirManifesto)(raiz).manifesto);
+    const manifestoDaRaiz = (0, manifest_1.exigirManifesto)(raiz).manifesto;
+    const grafoMcp = (0, mcp_grafo_1.grafoLigado)(manifestoDaRaiz);
+    // RM-059 (T10.4, D11 da thread ork-rm059portao): os tetos do piloto de agent teams so vao ao despacho do Claude Code
+    // quando o bloco da fase atual tem o GO, a mesma regra da edicao de produto; o manifesto da raiz decide, nunca o
+    // pedido do modelo. Quem liga de fato e o `montarComando`, e so com o Portao de Tarefas na sessao.
+    const tetos = contexto.host === 'claude-code' ? manifestoDaRaiz.runtime.agent_teams : undefined;
+    const agentTeams = tetos && (0, thread_1.blocoDaThread)(thread, thread.faseAtual).fases.includes('GO') ? { ...tetos } : null;
     const publicVerifiers = (0, hitl_public_receipt_1.publicHitlVerifiers)();
     const servidor = { ...(0, mcp_install_1.configuracaoServidorMcp)(raiz, contexto.host, contexto.threadId, transporteShip, permissoesFilho, contexto.identidade?.dispatchId),
         ...(publicVerifiers ? { env: { [hitl_public_receipt_1.ENV_HITL_VERIFIERS]: publicVerifiers } } : {}),
         ...(contexto.host === 'codex' && permissoesFilho === 'worktree' ? (0, mcp_install_1.politicasFilhoCodex)(perfil.politicasCodex ?? {}) : {}) };
-    return { projeto: raiz, instalacao, bootstrap, permissoesFilho, permiteEditarProduto, grafoMcp, servidor };
+    return { projeto: raiz, instalacao, bootstrap, permissoesFilho, permiteEditarProduto, grafoMcp, servidor, modsDeFase, agentTeams };
+}
+const DECLARACAO_OU_MANIFESTO_DE_MOD = /^mods\/[^/]+\/(?:orkastery-mod\.json|\.claude-plugin\/plugin\.json)$/;
+const DECLARACAO_DE_MOD = /^mods\/([^/]+)\/orkastery-mod\.json$/;
+const NOME_DE_MOD = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/;
+/** A declaracao de papel de um mod; o erro diz o que esta fora da convencao. */
+function lerDeclaracaoDeMod(texto) {
+    let bruto;
+    try {
+        bruto = JSON.parse(texto);
+    }
+    catch {
+        throw Error('orkastery-mod.json nao e JSON');
+    }
+    if (!bruto || typeof bruto !== 'object' || Array.isArray(bruto))
+        throw Error('orkastery-mod.json precisa ser objeto');
+    const d = bruto;
+    if (d.formato !== 'ork.mod/v1')
+        throw Error('orkastery-mod.json com formato diferente de ork.mod/v1');
+    const papeis = d.papeis;
+    if (!Array.isArray(papeis) || papeis.length === 0 || papeis.some((p) => p !== 'dono' && p !== 'fase') ||
+        new Set(papeis).size !== papeis.length)
+        throw Error('orkastery-mod.json com papeis fora de dono e fase, vazios ou repetidos');
+    if (typeof d.claudeCodeMinimo !== 'string' || !/^\d+\.\d+\.\d+$/.test(d.claudeCodeMinimo))
+        throw Error('orkastery-mod.json com claudeCodeMinimo fora do formato X.Y.Z');
+    return { formato: 'ork.mod/v1', papeis: papeis, claudeCodeMinimo: d.claudeCodeMinimo };
+}
+/**
+ * RM-059 (T0.7, D3): os nomes que o `dependencies` do `plugin.json` de um mod cita, em melhor esforco:
+ * lista de nomes (com ou sem `@marketplace`), objeto com os nomes nas chaves, ou lista de objetos com `name`.
+ */
+function dependenciasDoManifesto(texto) {
+    let manifesto;
+    try {
+        manifesto = JSON.parse(texto);
+    }
+    catch {
+        throw Error('.claude-plugin/plugin.json nao e JSON');
+    }
+    if (!manifesto || typeof manifesto !== 'object' || Array.isArray(manifesto))
+        throw Error('.claude-plugin/plugin.json precisa ser objeto');
+    const deps = manifesto.dependencies;
+    const itens = Array.isArray(deps) ? deps : deps && typeof deps === 'object' ? Object.keys(deps) : [];
+    return itens.flatMap((item) => {
+        const nome = typeof item === 'string' ? item : item && typeof item === 'object' ? item.name : undefined;
+        return typeof nome === 'string' && nome ? [nome.split('@')[0]] : [];
+    });
+}
+/** Os arquivos comuns que o proprio Claude Code escreve na pasta do mod que ele carrega: declaracoes, nunca codigo. */
+function arquivoDoMotor(raiz, arquivo, relativo) {
+    if (relativo === '.claude-plugin/types/.gitignore')
+        return true;
+    if (relativo.startsWith('.claude-plugin/types/') &&
+        (relativo.endsWith('.d.ts') || path.posix.basename(relativo) === 'tsconfig.json'))
+        return true;
+    if (relativo !== 'tsconfig.json')
+        return false;
+    try {
+        const config = objeto(JSON.parse(ler(raiz, arquivo, 4096).toString('utf8')));
+        return Object.keys(config).length === 1 && config.extends === './.claude-plugin/types/tsconfig.json';
+    }
+    catch {
+        return false;
+    }
+}
+/** Link de tipos gerado pelo Claude Code: o alvo real continua preso a um .d.ts comprovado pelo recibo. */
+function linkDeTipoDoMotor(instalacao, arquivo, relativo, arquivos) {
+    if (!relativo.startsWith('.claude-plugin/types/') || !relativo.endsWith('.d.ts'))
+        return false;
+    let alvo;
+    try {
+        alvo = fs.realpathSync(arquivo);
+    }
+    catch {
+        return false;
+    }
+    const relativoAoRecibo = path.relative(instalacao, alvo).split(path.sep).join('/');
+    if (!/^mods\/[^/]+\/types\/[^/]+\.d\.ts$/.test(relativoAoRecibo))
+        return false;
+    const comprovado = arquivos.get(relativoAoRecibo);
+    if (!comprovado)
+        return false;
+    try {
+        return fs.realpathSync(comprovado) === alvo && fs.statSync(alvo).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * RM-059 (T0.7, D1): a pasta instalada de um mod de fase tem exatamente os arquivos do recibo. O
+ * `--plugin-dir` carrega o que estiver nela (comandos, agentes e skills sao descobertos), entao arquivo
+ * fora do recibo entraria na sessao de fase sem prova. So o link de tipos gerado pelo motor conserva
+ * a prova pelo alvo real; outro link e arquivo especial recusam sempre.
+ */
+function conferirPastaDoMod(raiz, instalacao, nome, arquivos) {
+    const dir = path.join(instalacao, 'mods', nome);
+    const recusa = (motivo, correcao = 'reinstale com ork adapter install claude-code') => Error(`runtime.context.installation: mod ${nome}: ${motivo}; ${correcao}`);
+    if (!fs.lstatSync(dir, { throwIfNoEntry: false })?.isDirectory() || dentro(raiz, dir) !== dir)
+        throw recusa('pasta instalada ausente ou fora da instalacao');
+    const visitar = (atual, prefixo) => {
+        for (const entrada of fs.readdirSync(atual, { withFileTypes: true })) {
+            const relativo = prefixo ? `${prefixo}/${entrada.name}` : entrada.name;
+            const arquivo = path.join(atual, entrada.name);
+            if (entrada.isSymbolicLink()) {
+                if (linkDeTipoDoMotor(instalacao, arquivo, relativo, arquivos))
+                    continue;
+                throw recusa(`link em ${relativo}`);
+            }
+            if (entrada.isDirectory()) {
+                visitar(path.join(atual, entrada.name), relativo);
+                continue;
+            }
+            if (!entrada.isFile())
+                throw recusa(`arquivo especial em ${relativo}`);
+            if (!arquivos.has(`mods/${nome}/${relativo}`) && !arquivoDoMotor(raiz, arquivo, relativo)) {
+                throw recusa(`arquivo fora do INSTALADO.json (${relativo})`, 'se ele saiu do catalogo, ork adapter install claude-code o tira da copia; ' +
+                    `se foi editado ou acrescentado a mao, apague ${path.join(dir, relativo)}`);
+            }
+        }
+    };
+    visitar(dir, '');
+    return dir;
+}
+/**
+ * RM-059 (rodada 2 do CHECK, N2): o arquivo comum da raiz de `mods/` tambem so vale com prova. A ponte le a lista
+ * de autoridade em `../autoridade.json` antes da propria pasta, entao uma copia velha ou escrita a mao ali mudaria o
+ * que a sessao de fase aceita. Com mod de fase no despacho, todo arquivo direto em `mods/` esta no recibo (que ja
+ * conferiu os bytes); link e arquivo especial recusam. Pastas sao os mods, conferidos um a um.
+ */
+function conferirRaizDosMods(raiz, instalacao, arquivos) {
+    const dir = path.join(instalacao, 'mods');
+    const recusa = (motivo, correcao = 'reinstale com ork adapter install claude-code') => Error(`runtime.context.installation: mods/: ${motivo}; ${correcao}`);
+    if (!fs.lstatSync(dir, { throwIfNoEntry: false })?.isDirectory() || dentro(raiz, dir) !== dir)
+        throw recusa('pasta instalada ausente ou fora da instalacao');
+    for (const entrada of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entrada.isSymbolicLink())
+            throw recusa(`link em ${entrada.name}`);
+        if (entrada.isDirectory())
+            continue;
+        if (!entrada.isFile())
+            throw recusa(`arquivo especial em ${entrada.name}`);
+        if (!arquivos.has(`mods/${entrada.name}`)) {
+            throw recusa(`arquivo fora do INSTALADO.json (${entrada.name})`, 'se ele saiu do catalogo, ork adapter install claude-code o tira da copia; ' +
+                `se foi editado ou acrescentado a mao, apague ${path.join(dir, entrada.name)}`);
+        }
+    }
+}
+/**
+ * RM-059 (T0.7): os mods de papel `fase` da instalacao, lidos do recibo ja conferido e na ordem da D3:
+ * a dependencia antes de quem depende, depois o nome. Declaracao ou manifesto invalidos recusam como
+ * um byte divergente (D2): e instalacao corrompida, e o CI do catalogo ja reprova esse caso.
+ */
+function modsDeFaseInstalados(raiz, instalacao, arquivos, conferidos) {
+    const achados = [];
+    const nomes = [...arquivos.keys()].flatMap((arquivo) => DECLARACAO_DE_MOD.exec(arquivo)?.[1] ?? []).sort();
+    const daInstalacao = new Set(nomes);
+    for (const nome of nomes) {
+        const arquivo = `mods/${nome}/orkastery-mod.json`;
+        const recusa = (motivo) => Error(`runtime.context.installation: mod ${nome}: ${motivo}; reinstale com ork adapter install claude-code`);
+        if (!NOME_DE_MOD.test(nome))
+            throw recusa('nome fora de letras minusculas, digitos e hifen');
+        let declaracao;
+        try {
+            declaracao = lerDeclaracaoDeMod(conferidos.get(arquivo).toString('utf8'));
+        }
+        catch (e) {
+            throw recusa(e.message);
+        }
+        if (!declaracao.papeis.includes('fase'))
+            continue;
+        const manifesto = conferidos.get(`mods/${nome}/.claude-plugin/plugin.json`);
+        if (!manifesto)
+            throw recusa('.claude-plugin/plugin.json fora do recibo');
+        let dependencias;
+        try {
+            dependencias = dependenciasDoManifesto(manifesto.toString('utf8')).filter((d) => daInstalacao.has(d) && d !== nome);
+        }
+        catch (e) {
+            throw recusa(e.message);
+        }
+        achados.push({ nome, dir: conferirPastaDoMod(raiz, instalacao, nome, arquivos), claudeCodeMinimo: declaracao.claudeCodeMinimo, dependencias });
+    }
+    if (achados.length)
+        conferirRaizDosMods(raiz, instalacao, arquivos);
+    const porNome = new Map(achados.map((m) => [m.nome, m]));
+    const ordem = [];
+    const feitos = new Set(), abertos = new Set();
+    // Busca em profundidade: a dependencia sai antes; num ciclo, a aresta de volta e ignorada (melhor esforco).
+    const visitar = (m) => {
+        if (feitos.has(m.nome) || abertos.has(m.nome))
+            return;
+        abertos.add(m.nome);
+        for (const dep of [...m.dependencias].sort()) {
+            const alvo = porNome.get(dep);
+            if (alvo)
+                visitar(alvo);
+        }
+        abertos.delete(m.nome);
+        feitos.add(m.nome);
+        ordem.push(m);
+    };
+    for (const m of achados)
+        visitar(m);
+    return ordem;
 }