@orkastery/cli 0.5.6 → 0.6.1

package/dist/runtime-context.js

@@ -33,9 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOTIVO_FORA_DOS_DESTINOS_AUTOMATICOS = exports.RUNTIMES_FORA_DOS_DESTINOS_AUTOMATICOS = exports.MOTIVO_SEM_HOST_MCP = exports.RUNTIMES_SEM_HOST_MCP = void 0;
 exports.novaIdentidadeDeDespacho = novaIdentidadeDeDespacho;
+exports.capacidadeDoRuntimeNoProjeto = capacidadeDoRuntimeNoProjeto;
+exports.capacidadeDaRotacao = capacidadeDaRotacao;
 exports.contextoDoProjeto = contextoDoProjeto;
 exports.validarContextoRuntime = validarContextoRuntime;
+exports.validarContextoDoGrok = validarContextoDoGrok;
 exports.lerDeclaracaoDeMod = lerDeclaracaoDeMod;
 exports.modsDeFaseInstalados = modsDeFaseInstalados;
 /** Contexto interno opt-in: configuracao M4 existente + catalogo instalado, nunca args do modelo. */
@@ -49,6 +53,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) {
@@ -81,48 +86,89 @@ function ler(raiz, file, limite) {
         fs.closeSync(fd);
     }
 }
-function preparado(raiz) {
-    let encontrado;
-    for (const host of ['claude-code', 'codex']) {
-        const file = path.join(raiz, host === 'codex' ? '.codex/config.toml' : '.mcp.json');
-        if (!fs.existsSync(file))
-            continue;
+/** A entrada `orkastery` de um host, conferida contra o perfil ja achado nos hosts anteriores; sem entrada, o perfil fica. */
+function perfilDoHost(raiz, host, encontrado) {
+    const file = (0, mcp_install_1.arquivoDoHostMcp)(raiz, host), toml = host !== 'claude-code';
+    if (!fs.existsSync(file))
+        return encontrado;
+    let config;
+    try {
         const text = ler(raiz, file, 262144).toString('utf8');
-        const config = objeto(host === 'codex' ? (0, smol_toml_1.parse)(text) : JSON.parse(text));
-        const chave = host === 'codex' ? 'mcp_servers' : 'mcpServers';
-        if (config[chave] === undefined)
-            continue;
-        const servidores = objeto(config[chave]);
-        if (!Object.hasOwn(servidores, 'orkastery'))
-            continue;
-        const entrada = objeto(servidores.orkastery), padrao = (0, mcp_install_1.configuracaoServidorMcp)(raiz, host);
-        const legado = padrao.args.slice(0, -2);
-        let transporte = 'github-ssh';
-        let argv = entrada.args;
-        let permissoesFilho = 'interactive';
-        if (Array.isArray(argv) && argv[argv.length - 2] === '--child-permissions') {
-            if (!['interactive', 'worktree'].includes(argv[argv.length - 1]))
-                throw Error('runtime.context.conflict: perfil de filho invalido');
-            permissoesFilho = argv[argv.length - 1];
-            argv = argv.slice(0, -2);
+        config = objeto(toml ? (0, smol_toml_1.parse)(text) : JSON.parse(text));
+    }
+    catch (erro) {
+        // RM-067 (F4b, GO-FIX A4 e N2): o motivo tipado do grok leva o codigo do erro de sistema ou a primeira linha do parser,
+        // sem o trecho do arquivo do time nem o caminho da maquina.
+        if (host !== 'grok')
+            throw erro;
+        const causa = erro.code ?? erro.message.split('\n')[0];
+        throw Error(`runtime.context.conflict: .grok/config.toml do projeto ilegivel (${causa}); conserte o arquivo ou tire dele a entrada orkastery`);
+    }
+    const chave = toml ? 'mcp_servers' : 'mcpServers';
+    if (config[chave] === undefined)
+        return encontrado;
+    const servidores = objeto(config[chave]);
+    if (!Object.hasOwn(servidores, 'orkastery'))
+        return encontrado;
+    const entrada = objeto(servidores.orkastery), padrao = (0, mcp_install_1.configuracaoServidorMcp)(raiz, host);
+    const legado = padrao.args.slice(0, -2);
+    let transporte = 'github-ssh';
+    let argv = entrada.args;
+    let permissoesFilho = 'interactive';
+    if (Array.isArray(argv) && argv[argv.length - 2] === '--child-permissions') {
+        if (!['interactive', 'worktree'].includes(argv[argv.length - 1]))
+            throw Error('runtime.context.conflict: perfil de filho invalido');
+        permissoesFilho = argv[argv.length - 1];
+        argv = argv.slice(0, -2);
+    }
+    if (JSON.stringify(argv) !== JSON.stringify(legado)) {
+        if (!Array.isArray(argv) || argv.length !== padrao.args.length ||
+            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];
+    }
+    const esperado = (0, mcp_install_1.configuracaoServidorMcp)(raiz, host, undefined, transporte);
+    if (entrada.command !== esperado.command || (JSON.stringify(argv) !== JSON.stringify(esperado.args) && JSON.stringify(argv) !== JSON.stringify(legado)))
+        throw Error('runtime.context.conflict: MCP Orkastery divergente; repare a instalacao do projeto');
+    if (encontrado !== undefined && encontrado.transporteShip !== transporte)
+        throw Error('runtime.context.conflict: transportes SHIP divergentes entre hosts');
+    if (encontrado !== undefined && encontrado.permissoesFilho !== permissoesFilho)
+        throw Error('runtime.context.conflict: perfis de filho divergentes entre hosts');
+    return { ...encontrado, transporteShip: transporte, permissoesFilho, ...(host === 'codex' ? { politicasCodex: entrada } : {}) };
+}
+/**
+ * O perfil da instalacao MCP do projeto. RM-067 (F4b, GO-FIX A4): o `.grok/config.toml` tambem prepara, em TOML como o do
+ * codex, mas ele e a config do proprio grok, que o time pode manter: para quem nao e o grok (`quem`), a falha de leitura,
+ * de parse ou de conferencia dele nao derruba a preparacao dos outros hosts, e a entrada dele fica de fora. GO-FIX N1: sem
+ * outro host preparado, a entrada `orkastery` do grok e a preparacao do projeto, e engolir a falha dela faria o claude-bg
+ * e o codex despacharem como num projeto legado, sem o MCP; a falha volta, e so a config do time sem a entrada fica de fora.
+ */
+function preparado(raiz, quem) {
+    let encontrado;
+    let falhaDoGrok = null;
+    for (const host of mcp_install_1.HOSTS_MCP) {
+        try {
+            encontrado = perfilDoHost(raiz, host, encontrado);
         }
-        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]))
-                throw Error('runtime.context.conflict: MCP Orkastery divergente; transporte invalido ou argumentos extras');
-            transporte = argv[argv.length - 1];
+        catch (erro) {
+            if (host !== 'grok' || quem === undefined || quem === 'grok')
+                throw erro;
+            falhaDoGrok = erro;
         }
-        const esperado = (0, mcp_install_1.configuracaoServidorMcp)(raiz, host, undefined, transporte);
-        if (entrada.command !== esperado.command || (JSON.stringify(argv) !== JSON.stringify(esperado.args) && JSON.stringify(argv) !== JSON.stringify(legado)))
-            throw Error('runtime.context.conflict: MCP Orkastery divergente; repare a instalacao do projeto');
-        if (encontrado !== undefined && encontrado.transporteShip !== transporte)
-            throw Error('runtime.context.conflict: transportes SHIP divergentes entre hosts');
-        if (encontrado !== undefined && encontrado.permissoesFilho !== permissoesFilho)
-            throw Error('runtime.context.conflict: perfis de filho divergentes entre hosts');
-        encontrado = { ...encontrado, transporteShip: transporte, permissoesFilho, ...(host === 'codex' ? { politicasCodex: entrada } : {}) };
     }
+    if (falhaDoGrok !== null && encontrado === undefined && podeTerEntradaDoOrk(raiz))
+        throw falhaDoGrok;
     return encontrado;
 }
+/** O `.grok/config.toml` do projeto tem, ou pode ter, a entrada `orkastery`; o que nao se le conta como se tivesse. */
+function podeTerEntradaDoOrk(raiz) {
+    try {
+        return ler(raiz, (0, mcp_install_1.arquivoDoHostMcp)(raiz, 'grok'), 262144).toString('utf8').includes('orkastery');
+    }
+    catch {
+        return true;
+    }
+}
 function raizCanonica(projeto) {
     if (!path.isAbsolute(projeto))
         throw Error('runtime.context.invalid: projeto absoluto obrigatorio');
@@ -133,30 +179,141 @@ 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';
+    if (runtime === 'grok')
+        return 'grok';
+    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, runtime);
+        if (!perfil)
+            return { runtime, host: null, preparado: false, capaz: true, motivo: null };
+        if (exports.RUNTIMES_SEM_HOST_MCP.includes(runtime))
+            return { runtime, host: null, preparado: true, capaz: false, motivo: exports.MOTIVO_SEM_HOST_MCP };
+        host = hostDoRuntime(runtime);
+        // RM-067 (F4b, G6): o grok nao tem adaptador instalavel (plugin, skills, mods); o contexto dele e so o MCP.
+        if (host !== 'grok')
+            conferirInstalacaoDoHost(raiz, host);
+        if (exports.RUNTIMES_FORA_DOS_DESTINOS_AUTOMATICOS.includes(runtime))
+            return { runtime, host, preparado: true, capaz: false, motivo: exports.MOTIVO_FORA_DOS_DESTINOS_AUTOMATICOS };
+        return { runtime, host, preparado: true, capaz: true, motivo: null };
+    }
+    catch (erro) {
+        return { runtime, host, preparado: true, capaz: false, motivo: erro.message };
+    }
+}
+/**
+ * RM-067 (D15 da ork-grokbuild): runtimes homologados que ainda nao tem host MCP do Orkastery. A sessao filha deles
+ * despacha sem contexto, como num projeto sem entrada MCP, ate o host existir. A capacidade de rotacao
+ * (`capacidadeDoRuntimeNoProjeto`) nao muda: num projeto preparado, eles seguem fora dos destinos automaticos.
+ * RM-067 (F4b, G6): o grok saiu daqui com o host `grok`; a lista fica para o proximo runtime sem host.
+ */
+exports.RUNTIMES_SEM_HOST_MCP = [];
+/** RM-067 (F4): o motivo tipado de um runtime sem host MCP num projeto preparado. */
+exports.MOTIVO_SEM_HOST_MCP = 'runtime.context.no-host: runtime sem host MCP do Orkastery; a sessao despacha sem o contexto do projeto';
+/**
+ * RM-067 (F4b, GO-FIX A5; F4c, D9): runtimes com o host MCP que, num projeto preparado, ficam fora dos destinos
+ * automaticos (o fallback do retry e a escada), porque o servidor MCP do ork nao grava o estado na sessao deles e a fase
+ * que chega por fallback pararia sem prova. O grok ficou aqui da F4b a F4c: o sandbox dele vale para o processo inteiro e
+ * os filhos (G17 da RM-067), e o servidor stdio era filho dele. Desde a F4c o servidor e um processo do ork, fora do
+ * sandbox (`adapters/grok-mcp.ts`), e a fase do grok no piso `workspace` fecha com prova; a lista fica vazia, para o
+ * proximo runtime cujo MCP nao grave o estado, como `RUNTIMES_SEM_HOST_MCP`.
+ */
+exports.RUNTIMES_FORA_DOS_DESTINOS_AUTOMATICOS = [];
+exports.MOTIVO_FORA_DOS_DESTINOS_AUTOMATICOS = 'runtime.context.sandbox: o sandbox do runtime vale tambem para o servidor MCP do ' +
+    'ork, que nao grava o estado; como destino automatico num projeto preparado, o runtime fica fora';
+/**
+ * RM-067 (F4): a capacidade de um runtime para a rotacao do retry. A troca de perfil DENTRO do runtime em que a thread ja
+ * despachou (`mesmoRuntime`) vale para o runtime sem host MCP e para o que fica fora dos destinos automaticos: a sessao
+ * dele ja roda como rodava, e a outra conta nao muda isso, entao o `ork retry` troca o perfil dele como troca o dos outros
+ * runtimes. Como alvo de fallback num projeto preparado, ele segue incapaz. Desde a F4c, nenhum runtime homologado esta
+ * nas duas listas, e o grok e capaz nos dois papeis.
+ */
+function capacidadeDaRotacao(projeto, runtime, mesmoRuntime) {
+    const capacidade = capacidadeDoRuntimeNoProjeto(projeto, runtime);
+    if (capacidade.capaz || !mesmoRuntime)
+        return capacidade;
+    const soComoDestino = (exports.RUNTIMES_SEM_HOST_MCP.includes(runtime) && capacidade.motivo === exports.MOTIVO_SEM_HOST_MCP) ||
+        (exports.RUNTIMES_FORA_DOS_DESTINOS_AUTOMATICOS.includes(runtime) && capacidade.motivo === exports.MOTIVO_FORA_DOS_DESTINOS_AUTOMATICOS);
+    return soComoDestino ? { ...capacidade, capaz: true } : capacidade;
+}
 /** 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);
+    const perfil = preparado(raiz, runtime);
     if (!perfil)
         return undefined;
-    if (!['claude-bg', 'codex'].includes(runtime))
-        throw Error('runtime.context.invalid: runtime desconhecido');
+    if (exports.RUNTIMES_SEM_HOST_MCP.includes(runtime))
+        return undefined;
+    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 };
-    validarContextoRuntime(contexto, cwd);
+    const contexto = { projeto: raiz, host, threadId, transporteShip: perfil.transporteShip, permissoesFilho: perfil.permissoesFilho };
+    if (host === 'grok')
+        validarContextoDoGrok(contexto, cwd);
+    else
+        validarContextoRuntime(contexto, cwd);
     return contexto;
 }
-/** Revalida no receptor do despacho, incluindo bytes instalados e escopo real do cwd. */
-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))
+/**
+ * A conferencia do vinculo, comum a todo host: projeto preparado, perfil e transporte iguais aos da instalacao, cwd e
+ * thread da sessao filha, identidade do despacho e, no perfil worktree, a worktree propria da thread. RM-067 (F4b, D2):
+ * saiu de `validarContextoRuntime` sem mudar a ordem das conferencias, para o contexto do grok usar a mesma.
+ */
+function conferirVinculo(contexto, cwd) {
+    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))
         throw Error('runtime.context.invalid: perfil de filho desconhecido');
-    const perfil = preparado(raiz);
+    const perfil = preparado(raiz, contexto.host);
     if (!perfil)
         throw Error('runtime.context.missing: projeto nao preparado pelo instalador MCP');
     const { transporteShip, permissoesFilho } = perfil;
@@ -183,38 +340,14 @@ 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();
-    // 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 || (contexto.host === 'claude-code' && !arquivos.has('.claude-plugin/plugin.json')))
-        throw Error('runtime.context.installation: catalogo ou plugin incompleto');
+    return { raiz, perfil, transporteShip, permissoesFilho, thread };
+}
+/** Revalida no receptor do despacho, incluindo bytes instalados e escopo real do cwd. */
+function validarContextoRuntime(contexto, cwd) {
+    if (!contexto || (contexto.host !== 'claude-code' && contexto.host !== 'codex'))
+        throw Error('runtime.context.invalid: host desconhecido');
+    const { raiz, perfil, transporteShip, permissoesFilho, thread } = conferirVinculo(contexto, cwd);
+    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');
@@ -233,6 +366,25 @@ function validarContextoRuntime(contexto, cwd) {
         ...(contexto.host === 'codex' && permissoesFilho === 'worktree' ? (0, mcp_install_1.politicasFilhoCodex)(perfil.politicasCodex ?? {}) : {}) };
     return { projeto: raiz, instalacao, bootstrap, permissoesFilho, permiteEditarProduto, grafoMcp, servidor, modsDeFase, agentTeams };
 }
+/**
+ * RM-067 (F4b, D2): o contexto do grok, revalidado no despacho. O vinculo e o mesmo dos outros hosts; nao ha adaptador
+ * instalado a conferir (o grok nao tem plugin, skills nem mods do Orkastery). Devolve o que o comando e o despacho usam:
+ * o perfil filho, a flag do grafo da raiz e, desde a F4c, a especificacao do servidor externo vinculado a thread e ao despacho.
+ */
+function validarContextoDoGrok(contexto, cwd) {
+    if (!contexto || contexto.host !== 'grok')
+        throw Error('runtime.context.invalid: host grok esperado');
+    const { raiz, transporteShip, permissoesFilho, thread } = conferirVinculo(contexto, cwd);
+    // RM-067 (F4b, GO-FIX B1): a config da sessao vai no cwd; na raiz do projeto ela viraria a entrada do host grok.
+    if (!thread.worktree || thread.worktree === raiz || cwd === raiz)
+        throw Error('runtime.context.worktree: o grok com o MCP do ork exige a worktree propria da thread; a config da sessao nunca vai a raiz do projeto');
+    const grafoMcp = (0, mcp_grafo_1.grafoLigado)((0, manifest_1.exigirManifesto)(raiz).manifesto);
+    const publicVerifiers = (0, hitl_public_receipt_1.publicHitlVerifiers)();
+    const servidor = { projeto: raiz, threadId: contexto.threadId,
+        dispatchId: contexto.identidade?.dispatchId ?? null, permissoesFilho, transporteShip,
+        ...(publicVerifiers ? { env: { [hitl_public_receipt_1.ENV_HITL_VERIFIERS]: publicVerifiers } } : {}) };
+    return { projeto: raiz, threadId: contexto.threadId, permissoesFilho, grafoMcp, servidor };
+}
 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])?$/;
@@ -279,14 +431,52 @@ function dependenciasDoManifesto(texto) {
         return typeof nome === 'string' && nome ? [nome.split('@')[0]] : [];
     });
 }
-/** Os tipos que o proprio Claude Code escreve na pasta do mod que ele carrega: declaracoes, nunca codigo. */
-function tipoDoMotor(relativo) {
-    return relativo.startsWith('.claude-plugin/types/') && (relativo.endsWith('.d.ts') || path.posix.basename(relativo) === 'tsconfig.json');
+/** 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. Link e arquivo especial recusam sempre.
+ * 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);
@@ -296,15 +486,19 @@ function conferirPastaDoMod(raiz, instalacao, nome, arquivos) {
     const visitar = (atual, prefixo) => {
         for (const entrada of fs.readdirSync(atual, { withFileTypes: true })) {
             const relativo = prefixo ? `${prefixo}/${entrada.name}` : entrada.name;
-            if (entrada.isSymbolicLink())
+            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}`) && !tipoDoMotor(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)}`);
             }