agestra 4.4.2 → 4.5.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agestra",
-  "version": "4.4.2",
-  "description": "Claude Code plugin — orchestrate Ollama, Gemini, and Codex for multi-AI debates, cross-validation, and GraphRAG memory",
+  "version": "4.5.2",
+  "description": "Multi-host AI orchestration toolkit for Claude Code, Codex CLI, and Gemini CLI",
   "type": "module",
   "packageManager": "npm@11.11.0",
   "workspaces": [
@@ -16,9 +16,14 @@
     "dist/sql-wasm.cjs",
     "dist/sql-wasm.wasm",
     ".claude-plugin/",
+    ".gemini/",
+    "AGENTS.md",
+    "GEMINI.md",
     "agents/",
     "commands/",
     "hooks/",
+    "scripts/install-host-mcp.mjs",
+    "scripts/uninstall-host-mcp.mjs",
     "skills/"
   ],
   "scripts": {
@@ -31,10 +36,16 @@
     "clean": "turbo clean",
     "prebundle": "npm run sync:metadata",
     "bundle": "node scripts/bundle.mjs",
+    "install:codex": "node scripts/install-host-mcp.mjs codex",
+    "install:gemini": "node scripts/install-host-mcp.mjs gemini",
+    "uninstall:codex": "node scripts/uninstall-host-mcp.mjs codex",
+    "uninstall:gemini": "node scripts/uninstall-host-mcp.mjs gemini",
     "prepublishOnly": "npm run build && npm run bundle"
   },
   "keywords": [
     "claude-code-plugin",
+    "codex-cli",
+    "gemini-cli",
     "mcp",
     "multi-ai",
     "ollama",

package/scripts/install-host-mcp.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const USAGE = `Usage: node scripts/install-host-mcp.mjs <codex|gemini|all> [--scope project|user] [--trust]
+
+Registers the local Agestra MCP bundle with the selected host CLI.
+`;
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(USAGE);
+    process.exit(0);
+  }
+
+  const args = [...argv];
+  const target = args.shift();
+  let scope = "project";
+  let trust = false;
+
+  while (args.length > 0) {
+    const current = args.shift();
+    if (current === "--trust") {
+      trust = true;
+      continue;
+    }
+
+    if (current === "--scope") {
+      const value = args.shift();
+      if (value !== "project" && value !== "user") {
+        fail("`--scope` must be `project` or `user`.");
+      }
+      scope = value;
+      continue;
+    }
+
+    fail(`Unknown argument: ${current}`);
+  }
+
+  if (!target || !["codex", "gemini", "all"].includes(target)) {
+    fail(USAGE);
+  }
+
+  return { target, scope, trust };
+}
+
+function runCommand(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+    shell: false,
+    ...options,
+  });
+
+  if (result.error) {
+    fail(`Failed to run \`${command}\`: ${result.error.message}`);
+  }
+
+  if (typeof result.status === "number" && result.status !== 0) {
+    fail(`\`${command} ${args.join(" ")}\` exited with status ${result.status}.`);
+  }
+}
+
+function commandSucceeds(command, args) {
+  const result = spawnSync(command, args, {
+    stdio: "ignore",
+    shell: false,
+  });
+
+  if (result.error) {
+    return false;
+  }
+
+  return result.status === 0;
+}
+
+function resolveBundlePath() {
+  const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+  const bundlePath = path.join(rootDir, "dist", "bundle.js");
+
+  if (!fs.existsSync(bundlePath)) {
+    fail(`Could not find ${bundlePath}. Run \`npm run bundle\` first.`);
+  }
+
+  return bundlePath;
+}
+
+function installCodex(bundlePath) {
+  if (commandSucceeds("codex", ["mcp", "get", "agestra", "--json"])) {
+    runCommand("codex", ["mcp", "remove", "agestra"]);
+  }
+
+  runCommand("codex", ["mcp", "add", "agestra", "--", process.execPath, bundlePath]);
+  console.log("Agestra is now registered with Codex. Open this repo and Codex will pick up AGENTS.md automatically.");
+}
+
+function installGemini(bundlePath, scope, trust) {
+  if (commandSucceeds("gemini", ["mcp", "remove", "agestra", "--scope", scope])) {
+    console.log(`Removed existing Gemini MCP registration for scope \`${scope}\`.`);
+  }
+
+  const args = [
+    "mcp",
+    "add",
+    "agestra",
+    process.execPath,
+    bundlePath,
+    "--scope",
+    scope,
+    "--description",
+    "Agestra multi-AI orchestration MCP server",
+  ];
+
+  if (trust) {
+    args.push("--trust");
+  }
+
+  runCommand("gemini", args);
+  console.log("Agestra is now registered with Gemini. Open this repo and Gemini will load GEMINI.md plus /agestra:* project commands.");
+}
+
+const { target, scope, trust } = parseArgs(process.argv.slice(2));
+const bundlePath = resolveBundlePath();
+
+if (target === "codex" || target === "all") {
+  installCodex(bundlePath);
+}
+
+if (target === "gemini" || target === "all") {
+  installGemini(bundlePath, scope, trust);
+}

package/scripts/uninstall-host-mcp.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+
+const USAGE = `Usage: node scripts/uninstall-host-mcp.mjs <codex|gemini|all> [--scope project|user]
+
+Removes the Agestra MCP registration from the selected host CLI.
+`;
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function parseArgs(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(USAGE);
+    process.exit(0);
+  }
+
+  const args = [...argv];
+  const target = args.shift();
+  let scope = "project";
+
+  while (args.length > 0) {
+    const current = args.shift();
+    if (current === "--scope") {
+      const value = args.shift();
+      if (value !== "project" && value !== "user") {
+        fail("`--scope` must be `project` or `user`.");
+      }
+      scope = value;
+      continue;
+    }
+
+    fail(`Unknown argument: ${current}`);
+  }
+
+  if (!target || !["codex", "gemini", "all"].includes(target)) {
+    fail(USAGE);
+  }
+
+  return { target, scope };
+}
+
+function runCommand(command, args) {
+  const result = spawnSync(command, args, {
+    stdio: "inherit",
+    shell: false,
+  });
+
+  if (result.error) {
+    fail(`Failed to run \`${command}\`: ${result.error.message}`);
+  }
+
+  if (typeof result.status === "number" && result.status !== 0) {
+    fail(`\`${command} ${args.join(" ")}\` exited with status ${result.status}.`);
+  }
+}
+
+function commandSucceeds(command, args) {
+  const result = spawnSync(command, args, {
+    stdio: "ignore",
+    shell: false,
+  });
+
+  if (result.error) {
+    return false;
+  }
+
+  return result.status === 0;
+}
+
+function uninstallCodex() {
+  if (!commandSucceeds("codex", ["mcp", "get", "agestra", "--json"])) {
+    console.log("Codex does not have an Agestra MCP registration to remove.");
+    return;
+  }
+
+  runCommand("codex", ["mcp", "remove", "agestra"]);
+  console.log("Removed Agestra from Codex.");
+}
+
+function uninstallGemini(scope) {
+  if (!commandSucceeds("gemini", ["mcp", "remove", "agestra", "--scope", scope])) {
+    console.log(`Gemini does not have an Agestra MCP registration in scope \`${scope}\`.`);
+    return;
+  }
+
+  console.log(`Removed Agestra from Gemini scope \`${scope}\`.`);
+}
+
+const { target, scope } = parseArgs(process.argv.slice(2));
+
+if (target === "codex" || target === "all") {
+  uninstallCodex();
+}
+
+if (target === "gemini" || target === "all") {
+  uninstallGemini(scope);
+}