@orkastery/cli 0.2.0 → 0.4.1

package/dist/mcp-install.js

@@ -0,0 +1,310 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_VARS_CODEX_MCP = exports.BRAIN_WRITE_TOOLS = exports.BRAIN_READ_TOOLS = exports.TOOLS_FILHO_CODEX = exports.TOOLS_DONO_CODEX = void 0;
+exports.validarGrantsCodex = validarGrantsCodex;
+exports.politicasFilhoCodex = politicasFilhoCodex;
+exports.configuracaoServidorMcp = configuracaoServidorMcp;
+exports.instalarMcp = instalarMcp;
+exports.textoInstalacaoMcp = textoInstalacaoMcp;
+/** Configuracao MCP local ao projeto. Copiar configuracao nao concede confianca ao cliente. */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const node_util_1 = require("node:util");
+const smol_toml_1 = require("smol-toml");
+const manifest_1 = require("./manifest");
+exports.TOOLS_DONO_CODEX = ['ork_thread_new', 'ork_phase_run', 'ork_request_decision'];
+exports.TOOLS_FILHO_CODEX = ['ork_artifact_write', 'ork_claim_add', 'ork_git_commit', 'ork_verify', 'ork_ship'];
+// Brain mutation tools are deliberately excluded from the existing opt-in bundle.
+// A native integration must request exact startup grants plus scoped activation.
+var company_brain_mcp_1 = require("./company-brain-mcp");
+Object.defineProperty(exports, "BRAIN_READ_TOOLS", { enumerable: true, get: function () { return company_brain_mcp_1.BRAIN_READ_TOOLS; } });
+Object.defineProperty(exports, "BRAIN_WRITE_TOOLS", { enumerable: true, get: function () { return company_brain_mcp_1.BRAIN_WRITE_TOOLS; } });
+/** Caminho de sessao, nunca credencial. O cliente resolve o valor no ambiente ao iniciar o MCP. */
+exports.ENV_VARS_CODEX_MCP = ['CODEX_HOME'];
+function objeto(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        throw Error('mcp.install.config.invalid: objeto esperado');
+    return v;
+}
+/** Consentimento de invocacao somente: nao responde gates nem altera sandbox. */
+function validarGrantsCodex(entrada, nomes) {
+    const conflito = () => { throw Error('mcp.permissions.conflict: politica existente restringe ferramentas; configuracao preservada'); };
+    if (entrada.enabled !== undefined && entrada.enabled !== true)
+        conflito();
+    for (const chave of ['enabled_tools', 'disabled_tools']) {
+        const lista = entrada[chave];
+        if (lista !== undefined && (!Array.isArray(lista) || lista.some(x => typeof x !== 'string')))
+            conflito();
+    }
+    const tools = entrada.tools === undefined ? {} : objeto(entrada.tools), resultado = {};
+    for (const nome of nomes) {
+        if ((Array.isArray(entrada.enabled_tools) && !entrada.enabled_tools.includes(nome)) ||
+            (Array.isArray(entrada.disabled_tools) && entrada.disabled_tools.includes(nome)))
+            conflito();
+        const tool = tools[nome] === undefined ? {} : objeto(tools[nome]);
+        const mode = tool.approval_mode ?? entrada.default_tools_approval_mode;
+        if (mode !== undefined && mode !== 'approve')
+            conflito();
+        resultado[nome] = { ...tool, approval_mode: 'approve' };
+    }
+    return resultado;
+}
+/** Renderer filho recebe apenas uma instalacao ja validada e nunca herda grants do dono. */
+function politicasFilhoCodex(entrada) {
+    if (entrada.default_tools_approval_mode !== undefined && entrada.default_tools_approval_mode !== 'approve')
+        throw Error('mcp.permissions.conflict: default restritivo nao pode ser removido no filho');
+    const grants = validarGrantsCodex(entrada, exports.TOOLS_FILHO_CODEX);
+    const tools = {};
+    if (entrada.tools !== undefined)
+        for (const [nome, raw] of Object.entries(objeto(entrada.tools))) {
+            const tool = objeto(raw);
+            if (tool.approval_mode !== undefined && !['auto', 'prompt', 'writes', 'approve'].includes(String(tool.approval_mode)))
+                throw Error('mcp.permissions.conflict: politica de ferramenta invalida');
+            if (tool.approval_mode !== 'approve')
+                tools[nome] = { ...tool };
+        }
+    return {
+        ...(entrada.enabled_tools !== undefined ? { enabled_tools: entrada.enabled_tools } : {}),
+        ...(entrada.disabled_tools !== undefined ? { disabled_tools: entrada.disabled_tools } : {}),
+        tools: { ...tools, ...grants },
+    };
+}
+function ler(file) {
+    let fd;
+    try {
+        fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW | fs.constants.O_NONBLOCK);
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return null;
+        throw Error('mcp.install.config.unsafe');
+    }
+    try {
+        const st = fs.fstatSync(fd);
+        if (!st.isFile() || st.size > 262144)
+            throw Error('mcp.install.config.unsafe');
+        const bytes = fs.readFileSync(fd);
+        if (bytes.length > 262144)
+            throw Error('mcp.install.config.unsafe');
+        return { bytes, modo: st.mode & 0o777 };
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/** Renderer de startup interno: a raiz vem do manifesto, nunca de argumentos de ferramentas. */
+function configuracaoServidorMcp(raiz, host, threadId, transporteShip = 'github-ssh', permissoesFilho = 'interactive', 
+/** I-36 (D4): identidade do despacho da sessao filha; so existe junto com a thread vinculada. */
+dispatchId) {
+    if (!['github-ssh', 'bare-local'].includes(transporteShip))
+        throw Error('mcp.install.transport.invalid');
+    if (!['interactive', 'worktree'].includes(permissoesFilho))
+        throw Error('mcp.install.child-permissions.invalid');
+    if (dispatchId !== undefined && (!threadId || !/^[a-f0-9-]{36}$/.test(dispatchId)))
+        throw Error('mcp.install.dispatch.invalid');
+    return { command: process.execPath, args: [path.resolve(__dirname, 'index.js'), 'mcp', 'serve', '--project', raiz, '--host', host, '--ship-transport', transporteShip,
+            ...(permissoesFilho === 'worktree' ? ['--child-permissions', permissoesFilho] : []),
+            ...(threadId ? ['--thread', threadId] : []),
+            ...(dispatchId ? ['--dispatch', dispatchId] : [])],
+        ...(host === 'codex' ? { env_vars: [...exports.ENV_VARS_CODEX_MCP] } : {}) };
+}
+function migrarEnvVarsCodex(bruto, entrada) {
+    const atual = entrada.env_vars;
+    if (atual !== undefined && (!Array.isArray(atual) || atual.some(v => typeof v !== 'string')))
+        throw Error('mcp.install.conflict: env_vars existente invalido; configuracao preservada');
+    const nomes = atual;
+    if (nomes?.includes('CODEX_HOME'))
+        return bruto;
+    const inicio = /^[ \t]*\[mcp_servers\.orkastery\][ \t]*(?:#[^\r\n]*)?$/m.exec(bruto);
+    if (!inicio)
+        throw Error('mcp.install.conflict: tabela TOML nao pode receber env_vars; configuracao preservada');
+    const corpoInicio = inicio.index + inicio[0].length;
+    const proxima = /^[ \t]*\[/m.exec(bruto.slice(corpoInicio));
+    const corpoFim = proxima ? corpoInicio + proxima.index : bruto.length;
+    const corpo = bruto.slice(corpoInicio, corpoFim);
+    const linha = /^[ \t]*env_vars[ \t]*=[^\r\n]*$/m.exec(corpo);
+    const valor = JSON.stringify([...(nomes ?? []), 'CODEX_HOME']);
+    if (nomes !== undefined) {
+        if (!linha)
+            throw Error('mcp.install.conflict: env_vars TOML complexo nao pode ser migrado; configuracao preservada');
+        const original = linha[0], igual = original.indexOf('='), prefixo = original.slice(0, igual + 1);
+        let aspas = '', escape = false, comentario = -1;
+        for (let i = igual + 1; i < original.length; i++) {
+            const c = original[i];
+            if (aspas === '"' && escape) {
+                escape = false;
+                continue;
+            }
+            if (aspas === '"' && c === '\\') {
+                escape = true;
+                continue;
+            }
+            if (aspas) {
+                if (c === aspas)
+                    aspas = '';
+                continue;
+            }
+            if (c === '"' || c === "'") {
+                aspas = c;
+                continue;
+            }
+            if (c === '#') {
+                comentario = i;
+                break;
+            }
+        }
+        let antesComentario = comentario < 0 ? original.length : comentario;
+        while (antesComentario > igual + 1 && /[ \t]/.test(original[antesComentario - 1]))
+            antesComentario--;
+        const espacos = original.slice(igual + 1, antesComentario).match(/^[ \t]*/)?.[0] ?? ' ';
+        const sufixo = comentario < 0 ? '' : original.slice(antesComentario);
+        const substituta = `${prefixo}${espacos}${valor}${sufixo}`;
+        return bruto.slice(0, corpoInicio) + corpo.slice(0, linha.index) + substituta + corpo.slice(linha.index + linha[0].length) + bruto.slice(corpoFim);
+    }
+    return bruto.slice(0, corpoFim) + (corpo.endsWith('\n') ? '' : '\n') + `env_vars = ${valor}\n` + bruto.slice(corpoFim);
+}
+function instalarMcp(opcoes) {
+    if (!path.isAbsolute(opcoes.projeto))
+        throw Error('mcp.install.project.invalid: raiz absoluta obrigatoria');
+    if (!['claude-code', 'codex'].includes(opcoes.host))
+        throw Error('mcp.install.host.invalid');
+    if (opcoes.transporteShip !== undefined && !['github-ssh', 'bare-local'].includes(opcoes.transporteShip))
+        throw Error('mcp.install.transport.invalid');
+    if (opcoes.permissoesFilho !== undefined && !['interactive', 'worktree'].includes(opcoes.permissoesFilho))
+        throw Error('mcp.install.child-permissions.invalid');
+    if (opcoes.permissoesDono !== undefined && (opcoes.host !== 'codex' || !['interactive', 'orchestrate'].includes(opcoes.permissoesDono)))
+        throw Error('mcp.install.owner-permissions.invalid: opt-in exclusivo Codex');
+    const raiz = fs.realpathSync(opcoes.projeto);
+    if (fs.realpathSync((0, manifest_1.exigirManifesto)(raiz).raiz) !== raiz)
+        throw Error('mcp.install.project.invalid');
+    const pasta = opcoes.host === 'codex' ? path.join(raiz, '.codex') : raiz;
+    const validarPasta = () => {
+        try {
+            const st = fs.lstatSync(pasta);
+            if (!st.isDirectory() || st.isSymbolicLink() || fs.realpathSync(pasta) !== pasta)
+                throw Error('mcp.install.directory.unsafe');
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT')
+                throw e;
+        }
+    };
+    validarPasta();
+    const arquivo = path.join(pasta, opcoes.host === 'codex' ? 'config.toml' : '.mcp.json');
+    const anterior = ler(arquivo), bruto = anterior?.bytes.toString('utf8') ?? '';
+    const { command: comando, args } = configuracaoServidorMcp(raiz, opcoes.host, undefined, opcoes.transporteShip, opcoes.permissoesFilho);
+    let dados;
+    try {
+        dados = anterior ? objeto(opcoes.host === 'codex' ? (0, smol_toml_1.parse)(bruto) : JSON.parse(bruto)) : {};
+    }
+    catch {
+        throw Error('mcp.install.config.invalid: configuracao existente nao foi alterada');
+    }
+    const chave = opcoes.host === 'codex' ? 'mcp_servers' : 'mcpServers';
+    const servidores = dados[chave] === undefined ? {} : objeto(dados[chave]);
+    const existente = Object.hasOwn(servidores, 'orkastery') ? objeto(servidores.orkastery) : undefined;
+    const faltaEnvCodex = opcoes.host === 'codex' && existente !== undefined &&
+        (!Array.isArray(existente.env_vars) || !existente.env_vars.includes('CODEX_HOME'));
+    let faltantes = [];
+    if (opcoes.permissoesDono === 'orchestrate') {
+        validarGrantsCodex(existente ?? {}, exports.TOOLS_DONO_CODEX);
+        const tools = existente?.tools === undefined ? {} : objeto(existente.tools);
+        faltantes = exports.TOOLS_DONO_CODEX.filter(nome => tools[nome] === undefined);
+        for (const nome of exports.TOOLS_DONO_CODEX)
+            if (tools[nome] !== undefined && objeto(tools[nome]).approval_mode === undefined)
+                throw Error('mcp.permissions.conflict: tabela existente sem consentimento explicito; configuracao preservada');
+    }
+    if (existente) {
+        const legadoSSH = (opcoes.permissoesFilho ?? 'interactive') === 'interactive' && (opcoes.transporteShip ?? 'github-ssh') === 'github-ssh' && JSON.stringify(existente.args) === JSON.stringify(args.slice(0, -2));
+        if (existente.command !== comando || (JSON.stringify(existente.args) !== JSON.stringify(args) && !legadoSSH))
+            throw Error('mcp.install.conflict: entrada orkastery divergente; configuracao preservada');
+        if (faltantes.length === 0 && !faltaEnvCodex)
+            return { arquivo, estado: 'igual', dryRun: !!opcoes.dryRun, ativacao: 'pendente-no-cliente' };
+    }
+    let proximo;
+    if (opcoes.host === 'codex') {
+        // Append preserva comentarios e escolhas do usuario. TOML inline fechado pode impedir a extensao.
+        proximo = bruto + (bruto.endsWith('\n') || !bruto ? '' : '\n') + (existente ? '' : '\n[mcp_servers.orkastery]\ncommand = ' + JSON.stringify(comando) + '\nargs = ' + JSON.stringify(args) + '\nenv_vars = ' + JSON.stringify([...exports.ENV_VARS_CODEX_MCP]) + '\n');
+        if (existente && faltaEnvCodex) {
+            proximo = migrarEnvVarsCodex(proximo, existente);
+            try {
+                const migrado = objeto((0, smol_toml_1.parse)(proximo)), migradoServidores = objeto(migrado.mcp_servers), migradoEntrada = objeto(migradoServidores.orkastery);
+                const sem = (valor, chave) => Object.fromEntries(Object.entries(valor).filter(([k]) => k !== chave));
+                if (!(0, node_util_1.isDeepStrictEqual)(sem(migrado, 'mcp_servers'), sem(dados, 'mcp_servers')) ||
+                    !(0, node_util_1.isDeepStrictEqual)(sem(migradoServidores, 'orkastery'), sem(servidores, 'orkastery')) ||
+                    !(0, node_util_1.isDeepStrictEqual)(migradoEntrada, { ...existente, env_vars: [...(existente.env_vars ?? []), 'CODEX_HOME'] }))
+                    throw Error('semantic mismatch');
+            }
+            catch {
+                throw Error('mcp.install.conflict: env_vars nao pode ser migrado com seguranca; configuracao preservada');
+            }
+        }
+        for (const nome of faltantes)
+            proximo += '\n[mcp_servers.orkastery.tools.' + nome + ']\napproval_mode = "approve"\n';
+        try {
+            (0, smol_toml_1.parse)(proximo);
+        }
+        catch {
+            throw Error('mcp.install.conflict: tabela TOML nao pode ser estendida; configuracao preservada');
+        }
+    }
+    else {
+        dados[chave] = { ...servidores, orkastery: { command: comando, args } };
+        proximo = JSON.stringify(dados, null, 2) + '\n';
+    }
+    if (!opcoes.dryRun) {
+        validarPasta();
+        fs.mkdirSync(pasta, { recursive: true });
+        validarPasta();
+        const temp = path.join(pasta, '.ork-mcp-' + (0, node_crypto_1.randomUUID)() + '.tmp');
+        try {
+            fs.writeFileSync(temp, proximo, { flag: 'wx', mode: anterior?.modo ?? 0o600 });
+            const atual = ler(arquivo);
+            if ((atual === null) !== (anterior === null) || (atual && anterior && !atual.bytes.equals(anterior.bytes)))
+                throw Error('mcp.install.concurrent-change: configuracao alterada durante instalacao');
+            validarPasta();
+            fs.renameSync(temp, arquivo);
+        }
+        finally {
+            fs.rmSync(temp, { force: true });
+        }
+    }
+    return { arquivo, estado: anterior ? 'atualizado' : 'novo', dryRun: !!opcoes.dryRun, ativacao: 'pendente-no-cliente' };
+}
+function textoInstalacaoMcp(r) {
+    return `${r.dryRun ? 'Simulacao: nenhuma escrita.' : 'Configuracao MCP preparada.'} ${r.arquivo} (${r.estado}).\nAbra uma nova sessao neste projeto, conclua o consentimento nativo solicitado pelo cliente e confira a descoberta das ferramentas ork_*.\nAtivacao e uso ainda pendentes de verificacao no cliente. Respostas automaticas de elicitation nao devem estar habilitadas para decisoes do dono.`;
+}

package/dist/mcp-maestro.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maestroInputSchema = void 0;
+exports.registerMaestro = registerMaestro;
+const zod_1 = require("zod");
+const maestro_contract_1 = require("./maestro-contract");
+const maestro_discovery_1 = require("./maestro-discovery");
+const maestro_cli_1 = require("./maestro-cli");
+exports.maestroInputSchema = zod_1.z.object({ threadId: zod_1.z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/).optional(),
+    section: zod_1.z.enum(maestro_contract_1.SECTION_NAMES).optional(), offset: zod_1.z.number().int().min(0).max(100000).optional() }).strict();
+function registerMaestro(register, options) {
+    register('ork_maestro', { description: 'Panorama Maestro somente leitura, fixado ao projeto e ao escopo da sessão; cobertura, lacunas e próximas ações pelos endpoints existentes.',
+        inputSchema: exports.maestroInputSchema, annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false } }, async (args) => {
+        options.load();
+        if ((args.section === undefined) !== (args.offset === undefined))
+            throw Error('maestro.page.invalid');
+        const threadId = args.threadId ?? options.threadId;
+        if (threadId)
+            options.checkThread(threadId);
+        const context = (0, maestro_discovery_1.discoverMaestro)({ cwd: options.root, pinned: options.root });
+        const result = (0, maestro_cli_1.readMaestro)(context, { threadId, native: true, offsets: args.section ? { [args.section]: args.offset } : undefined,
+            host: { tools: options.tools(), child: !!options.threadId } });
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+}