@orkastery/cli 0.5.6 → 0.6.0

package/dist/roadmap-reservas.js

@@ -195,11 +195,11 @@ function reservarFeat(raiz, opcoes = {}) {
     for (let tentativa = 1; tentativa <= TENTATIVAS; tentativa++) {
         const { ponta, atualizado } = buscar(raiz, remoto);
         if (!atualizado)
-            throw new Error(`roadmap.sem-remoto: nao consegui ler ${exports.BRANCH_DE_RESERVAS} em ${remoto}; reservar exige rede`);
+            throw new locale_1.ErroDoCatalogo((m) => m.reservas.semRemotoParaReservar(exports.BRANCH_DE_RESERVAS, remoto));
         const feats = featsDaPonta(raiz, ponta);
         const proximo = Math.max(maiorFeatConhecida(raiz, remoto), ...feats.map((r) => numeroDaFeat(r.feat))) + 1;
         if (proximo > 999)
-            throw new Error('roadmap.feat: os numeros de FEAT de tres digitos acabaram');
+            throw new locale_1.ErroDoCatalogo((m) => m.reservas.featsAcabaram);
         const feat = `FEAT-${String(proximo).padStart(3, '0')}`;
         const reserva = { contrato: exports.CONTRATO_FEAT, feat, por: eu.por, maquina: eu.maquina,
             thread: opcoes.thread ?? null, nota: opcoes.nota ?? null, em: opcoes.agora ?? (0, util_1.agora)() };
@@ -210,7 +210,7 @@ function reservarFeat(raiz, opcoes = {}) {
         if (commit)
             return { feat, reserva, commit, tentativas: tentativa };
     }
-    throw new Error(`roadmap.concorrencia: ${TENTATIVAS} pushes recusados seguidos; tente de novo em instantes`);
+    throw new locale_1.ErroDoCatalogo((m) => m.reservas.concorrencia(TENTATIVAS));
 }
 /** O `RESERVAS.md` da branch: a mesma lista, para quem abre o GitHub. */
 function painelEmMarkdown(reservas, feats = []) {
@@ -243,14 +243,14 @@ function gravar(raiz, remoto, ponta, mudanca, todas, mensagem, rede = {}) {
 function ehMinha(r, eu) {
     return r.por === eu.por && r.maquina === eu.maquina;
 }
-function descrever(r) {
-    return `${r.item} esta com ${r.por} em ${r.maquina} desde ${(0, horario_1.formatarDataHora)(r.desdeEm)}` +
-        (r.thread ? ` (thread ${r.thread})` : '');
+/** RM-061 (F3b): a descricao no locale de quem a monta; o erro e o ledger a montam pelo catalogo. */
+function descrever(r, m = (0, locale_1.msg)().reservas) {
+    return m.descricao(r.item, r.por, r.maquina, (0, horario_1.formatarDataHora)(r.desdeEm), r.thread ?? null);
 }
 function exigirMotivo(opcoes) {
     const motivo = (opcoes.motivo ?? '').trim();
     if (!motivo)
-        throw new Error('roadmap.forcar: --forcar exige --motivo (tomar a reserva de outra maquina e decisao registrada)');
+        throw new locale_1.ErroDoCatalogo((m) => m.reservas.forcarSemMotivo);
     return motivo;
 }
 /**
@@ -264,7 +264,7 @@ function pegarItem(raiz, item, opcoes = {}) {
     for (let tentativa = 1; tentativa <= TENTATIVAS; tentativa++) {
         const { ponta, atualizado } = buscar(raiz, remoto, opcoes.rede);
         if (!atualizado)
-            throw new Error(`roadmap.sem-remoto: nao consegui ler ${exports.BRANCH_DE_RESERVAS} em ${remoto}; reservar exige rede`);
+            throw new locale_1.ErroDoCatalogo((m) => m.reservas.semRemotoParaReservar(exports.BRANCH_DE_RESERVAS, remoto));
         const todas = lerDaPonta(raiz, ponta);
         const atual = todas.find((r) => r.item === id) ?? null;
         if (opcoes.threadEsperada !== undefined && (atual?.thread ?? null) !== opcoes.threadEsperada) {
@@ -277,7 +277,7 @@ function pegarItem(raiz, item, opcoes = {}) {
             acao = 'renovou';
         else if (atual) {
             if (!opcoes.forcar)
-                throw new Error(`roadmap.reservado: ${descrever(atual)}. Escolha outro item ou combine com quem esta nele`);
+                throw new locale_1.ErroDoCatalogo((m) => m.reservas.reservadoAoPegar(descrever(atual, m.reservas)));
             tomadaDe = { por: atual.por, maquina: atual.maquina, motivo: exigirMotivo(opcoes) };
             acao = 'tomou';
         }
@@ -297,7 +297,7 @@ function pegarItem(raiz, item, opcoes = {}) {
         if (commit)
             return { acao, item: id, reserva, commit, tentativas: tentativa };
     }
-    throw new Error(`roadmap.concorrencia: ${TENTATIVAS} pushes recusados seguidos; tente de novo em instantes`);
+    throw new locale_1.ErroDoCatalogo((m) => m.reservas.concorrencia(TENTATIVAS));
 }
 /** `ork roadmap soltar`: devolve o item. Soltar a reserva de outra maquina exige `--forcar --motivo`. */
 function soltarItem(raiz, item, opcoes = {}) {
@@ -307,7 +307,7 @@ function soltarItem(raiz, item, opcoes = {}) {
     for (let tentativa = 1; tentativa <= TENTATIVAS; tentativa++) {
         const { ponta, atualizado } = buscar(raiz, remoto, opcoes.rede);
         if (!atualizado)
-            throw new Error(`roadmap.sem-remoto: nao consegui ler ${exports.BRANCH_DE_RESERVAS} em ${remoto}; soltar exige rede`);
+            throw new locale_1.ErroDoCatalogo((m) => m.reservas.semRemotoParaSoltar(exports.BRANCH_DE_RESERVAS, remoto));
         const todas = lerDaPonta(raiz, ponta);
         const atual = todas.find((r) => r.item === id);
         if (!atual)
@@ -318,7 +318,7 @@ function soltarItem(raiz, item, opcoes = {}) {
         let motivo = '';
         if (!ehMinha(atual, eu)) {
             if (!opcoes.forcar)
-                throw new Error(`roadmap.reservado: ${descrever(atual)}; so quem pegou solta, ou --forcar --motivo`);
+                throw new locale_1.ErroDoCatalogo((m) => m.reservas.reservadoAoSoltar(descrever(atual, m.reservas)));
             motivo = `: ${exigirMotivo(opcoes)}`;
         }
         const restantes = todas.filter((r) => r.item !== id);
@@ -327,7 +327,7 @@ function soltarItem(raiz, item, opcoes = {}) {
         if (commit)
             return { acao: 'soltou', item: id, reserva: atual, commit, tentativas: tentativa };
     }
-    throw new Error(`roadmap.concorrencia: ${TENTATIVAS} pushes recusados seguidos; tente de novo em instantes`);
+    throw new locale_1.ErroDoCatalogo((m) => m.reservas.concorrencia(TENTATIVAS));
 }
 function threadsLocais(raiz) {
     const threads = [];
@@ -367,10 +367,12 @@ function soltarOrfa(raiz, orfa, origem, opcoes) {
     // A reserva mudou de dono no meio (ou ja tinha saido): nada foi gravado e nada vai ao ledger como soltura.
     if (r.acao === 'nada') {
         return { item, thread, acao: 'intocada', para: null, commit: null,
-            detalhe: `${item} mudou de dono entre a leitura e a gravacao; ficou como estava` };
+            detalhe: (0, locale_1.textoDoCatalogo)((m) => m.reservas.mudouDeDono(item)) };
     }
     const acao = orfa.sucessora ? 'reapontada' : 'solta';
-    const detalhe = orfa.sucessora ? `${item} passou para a thread ${orfa.sucessora}, aberta no mesmo item` : `${item} devolvido`;
+    // RM-061 (F3b, G4): o detalhe vai ao ledger e ao --json em pt-BR; a impressao o remonta.
+    const sucessora = orfa.sucessora;
+    const detalhe = (0, locale_1.textoDoCatalogo)((m) => sucessora ? m.reservas.passouPara(item, sucessora) : m.reservas.devolvido(item));
     // Sugestao 3 do CHECK 2: a soltura ja foi ao remoto; erro so no registro nao a transforma em pendencia.
     try {
         (0, ledger_1.registrarSeExiste)((0, thread_1.dirThread)(raiz, thread), thread, ledger_1.TIPOS_DE_EVENTO.reservaLiberada, { item, acao, para: orfa.sucessora, commit: r.commit, origem, detalhe });
@@ -418,7 +420,7 @@ function soltarReservaDaThread(raiz, threadId, opcoes = {}) {
         return [pendenteDaThread(raiz, threadId, oItem, primeiraLinha(e))];
     }
     if (!painel.atualizado) {
-        return [pendenteDaThread(raiz, threadId, oItem, `sem leitura de ${exports.BRANCH_DE_RESERVAS} em ${remoto}; a reserva fica para depois`)];
+        return [pendenteDaThread(raiz, threadId, oItem, (0, locale_1.textoDoCatalogo)((m) => m.reservas.semLeituraPendente(exports.BRANCH_DE_RESERVAS, remoto)))];
     }
     const dela = painel.reservas.filter((r) => r.thread === threadId);
     let orfas;
@@ -432,7 +434,7 @@ function soltarReservaDaThread(raiz, threadId, opcoes = {}) {
     const saida = [];
     // Sugestao 1 do CHECK 1: toda reserva da thread, nao so a primeira; a de outra maquina fica pendente.
     for (const r of dela.filter((x) => !orfas.some((o) => o.reserva.item === x.item))) {
-        saida.push(pendenteDaThread(raiz, threadId, r.item, `${descrever(r)}; so quem pegou solta, ou --forcar --motivo`));
+        saida.push(pendenteDaThread(raiz, threadId, r.item, (0, locale_1.textoDoCatalogo)((m) => m.reservas.soQuemPegou(descrever(r, m.reservas)))));
     }
     for (const orfa of orfas) {
         try {
@@ -451,7 +453,7 @@ function soltarReservaDaThread(raiz, threadId, opcoes = {}) {
 function soltarReservasOrfas(raiz, opcoes = {}) {
     const painel = listarReservas(raiz, { remoto: opcoes.remoto, rede: opcoes.rede });
     if (!painel.atualizado)
-        throw new Error(`roadmap.sem-remoto: nao consegui ler ${exports.BRANCH_DE_RESERVAS}; soltar exige rede`);
+        throw new locale_1.ErroDoCatalogo((m) => m.reservas.semRemotoParaOrfas(exports.BRANCH_DE_RESERVAS));
     return reservasOrfas(raiz, painel.reservas, opcoes).map((orfa) => {
         try {
             return soltarOrfa(raiz, orfa, 'orfas', opcoes);
@@ -470,33 +472,31 @@ function leituraDasReservas(p, temRemoto) {
 function textoDasReservas(p, orfas = [], lida = {}) {
     const remoto = lida.remoto ?? exports.REMOTO_PADRAO;
     const leitura = leituraDasReservas(p, lida.temRemoto !== false);
-    if (leitura === 'sem-remoto') {
-        const projeto = lida.projeto ? `o projeto ${lida.projeto}` : 'o projeto';
-        return `Reservas do roadmap: ${projeto} não tem o remoto ${remoto}; nada foi lido de ${exports.BRANCH_DE_RESERVAS}.`;
-    }
-    if (leitura === 'sem-copia') {
-        return `Reservas do roadmap: o remoto ${remoto} não respondeu e esta máquina não tem cópia de ${exports.BRANCH_DE_RESERVAS}; nada foi lido.`;
-    }
+    // RM-061 (F3b): o painel no terminal pelo catalogo; item, pessoa, maquina, thread e nota sao dado.
+    const m = (0, locale_1.msg)().reservas;
+    if (leitura === 'sem-remoto')
+        return m.semRemoto(lida.projeto ?? null, remoto, exports.BRANCH_DE_RESERVAS);
+    if (leitura === 'sem-copia')
+        return m.semCopia(remoto, exports.BRANCH_DE_RESERVAS);
     const linhas = [];
     if (!p.atualizado)
-        linhas.push('AVISO: sem acesso ao remoto; esta e a ultima copia lida nesta maquina.', '');
+        linhas.push(m.copiaLocal, '');
     const feats = p.feats ?? [];
-    const numeros = feats.length === 0 ? [] : ['', `Números de FEAT reservados (${feats.length}), os últimos: ` +
-            feats.slice(-5).map((f) => `${f.feat} (${f.thread ?? f.maquina})`).join(', ') + '. O próximo sai de: ork roadmap feat'];
+    const numeros = feats.length === 0 ? [] : ['', m.numerosDeFeat(feats.length, feats.slice(-5).map((f) => `${f.feat} (${f.thread ?? f.maquina})`).join(', '))];
     if (p.reservas.length === 0) {
-        linhas.push('Nenhum item do roadmap reservado.', ...numeros);
+        linhas.push(m.nenhuma, ...numeros);
         return linhas.join('\n');
     }
-    linhas.push('ITEM     COM QUEM            MAQUINA         THREAD             DESDE');
+    linhas.push(m.cabecalho);
     const orfaDoItem = new Map(orfas.map((o) => [o.reserva.item, o]));
     for (const r of p.reservas) {
         const orfa = orfaDoItem.get(r.item);
-        const marca = orfa ? `  ÓRFÃ: thread fechada${orfa.sucessora ? `, passa para ${orfa.sucessora}` : ''}` : '';
+        const marca = orfa ? m.orfa(orfa.sucessora) : '';
         linhas.push(`${r.item.padEnd(8)} ${r.por.slice(0, 19).padEnd(19)} ${r.maquina.slice(0, 15).padEnd(15)} ` +
             `${(r.thread ?? '-').slice(0, 18).padEnd(18)} ${(0, horario_1.formatarDataHora)(r.desdeEm)}` + (r.nota ? `  ${r.nota}` : '') + marca);
     }
     if (orfas.length > 0)
-        linhas.push('', `${orfas.length} reserva(s) órfã(s) desta máquina. Para soltar: ork roadmap reservas --soltar-orfas`);
+        linhas.push('', m.orfas(orfas.length));
     linhas.push(...numeros, '', (0, horario_1.legendaDoFuso)());
     return linhas.join('\n');
 }

package/dist/runtime-ambiente.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENV_THREAD_DO_DESPACHO = exports.ENV_IDENTIDADE_DE_DESPACHO = exports.ENVS_DE_PROVIDER_PAGO = void 0;
 exports.nomesDeProviderAtivos = nomesDeProviderAtivos;
+exports.sessaoDespachada = sessaoDespachada;
 exports.ambienteDeAssinatura = ambienteDeAssinatura;
 const hitl_public_receipt_1 = require("./hitl-public-receipt");
 /**
@@ -27,6 +28,10 @@ function nomesDeProviderAtivos(base = process.env) {
  */
 exports.ENV_IDENTIDADE_DE_DESPACHO = 'ORK_DISPATCH_ID';
 exports.ENV_THREAD_DO_DESPACHO = 'ORK_DISPATCH_THREAD';
+/** O processo roda numa sessao despachada pelo `ork`: a identidade ou a thread do despacho estao no ambiente. */
+function sessaoDespachada(env = process.env) {
+    return (env[exports.ENV_IDENTIDADE_DE_DESPACHO] ?? '').trim() !== '' || (env[exports.ENV_THREAD_DO_DESPACHO] ?? '').trim() !== '';
+}
 /** Copia, sem alterar o ambiente em que as policies ainda precisam ser avaliadas. */
 function ambienteDeAssinatura(base = process.env) {
     const env = { ...base };

package/dist/runtime-context.js

@@ -34,6 +34,7 @@ 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;
@@ -49,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) {
@@ -108,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];
         }
@@ -133,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;
 }
@@ -151,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))
@@ -183,38 +246,7 @@ 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');
+    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');
@@ -279,14 +311,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 +366,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)}`);
             }