@topolo/cli 0.13.0 → 0.13.1

package/dist/index.js

@@ -5,8 +5,22 @@ import { spawnSync } from "child_process";
 import { existsSync } from "fs";
 import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
+import { homedir } from "os";
 function registerAgentPacksCommand(program2) {
   const packs = program2.command("agent-packs").description("Install and operate Topolo Agent Packs in supported local hosts").option("--store <path>", "Portable pack library (default ~/AgentPacks)");
+  packs.command("configure").description("Qualify and configure an adopted Claude roster through its live native backend").argument("<pack>").option("--harness <name>", "Host adapter", "claude").requiredOption("--policy <path>", "Reviewed execution policy JSON").requiredOption("--endpoint <url>", "Explicit loopback main-process inspector endpoint, enabled separately with authorization").requiredOption("--pid <pid>", "Expected Claude main-process PID").option("--apply", "Apply native groups, pins, models, effort and permission modes; otherwise preflight only").action(async (pack, options) => {
+    if (options.harness !== "claude") throw new Error("Native configure is currently qualified only for Claude Desktop.");
+    const { configureClaudePack } = await import("./claude-pack-backend-IDQQX3DG.js");
+    const result = await configureClaudePack({
+      store: packs.opts().store ?? resolve(homedir(), "AgentPacks"),
+      pack,
+      policy: options.policy,
+      endpoint: options.endpoint,
+      pid: Number(options.pid),
+      apply: options.apply === true
+    });
+    console.log(JSON.stringify(result, null, 2));
+  });
   const commands = [
     "add",
     "replace",
@@ -19,6 +33,7 @@ function registerAgentPacksCommand(program2) {
     "list",
     "recover",
     "doctor",
+    "policy",
     "remote-recover",
     "connect",
     "remote-context",
@@ -27,8 +42,26 @@ function registerAgentPacksCommand(program2) {
     "artifact-get"
   ];
   for (const name of commands) {
-    packs.command(name).description(name === "add" ? "Add an installed or bundled pack, group, or agent" : `Run the pack ${name} operation`).option("--harness <name>", "Local host adapter (currently codex)", "codex").option("--adapter-help", "Show every option supported by the selected adapter").argument("[arguments...]").allowUnknownOption().allowExcessArguments().addHelpText("after", name === "add" ? "\nExamples:\n  topolo agent-packs add founder\n  topolo agent-packs add founder --group specialists\n  topolo agent-packs add founder --agent strategy\n" : "\nRun topolo agent-packs <command> --adapter-help for all adapter options. Cloud commands require explicit --environment and --context-key.\n").action((args, options) => {
-      if (options.harness !== "codex") throw new Error(`The ${options.harness} pack adapter is not available. Only Codex switching has been verified.`);
+    const command = packs.command(name).description(name === "add" ? "Add an installed or bundled pack, group, or agent" : `Run the pack ${name} operation`);
+    if (name === "switch" || name === "recover") command.option("--policy <path>", "Reviewed policy for an adopted Claude roster").option("--endpoint <url>", "Explicit authorized Claude main-process inspector endpoint").option("--pid <pid>", "Expected Claude main-process PID").option("--apply", "Apply a native switch; recovery is always read-only");
+    command.option("--harness <name>", "Local host adapter (codex, claude Desktop Code sessions)", "codex").option("--adapter-help", "Show every option supported by the selected adapter").argument("[arguments...]").allowUnknownOption().allowExcessArguments().addHelpText("after", name === "add" ? "\nExamples:\n  topolo agent-packs add founder\n  topolo agent-packs add founder --group specialists\n  topolo agent-packs add founder --agent strategy\n" : "\nRun topolo agent-packs <command> --adapter-help for all adapter options. Cloud commands require explicit --environment and --context-key.\n").action(async (args, options) => {
+      if (!["codex", "claude"].includes(options.harness)) throw new Error(`The ${options.harness} pack adapter is not available. Supported adapters: codex, claude.`);
+      if (options.policy || options.endpoint || options.pid || options.apply) {
+        if (options.harness !== "claude" || !options.policy || !options.endpoint || !options.pid || args.length !== 1)
+          throw new Error("Native switch/recovery requires one Claude pack, --policy, --endpoint and --pid.");
+        const { configureClaudePack } = await import("./claude-pack-backend-IDQQX3DG.js");
+        const result2 = await configureClaudePack({
+          store: packs.opts().store ?? resolve(homedir(), "AgentPacks"),
+          pack: args[0],
+          policy: options.policy,
+          endpoint: options.endpoint,
+          pid: Number(options.pid),
+          mode: name,
+          apply: options.apply === true
+        });
+        console.log(JSON.stringify(result2, null, 2));
+        return;
+      }
       const here = dirname(fileURLToPath(import.meta.url));
       const adapter = [resolve(here, "../agent-packs/topolo-agent-pack"), resolve(here, "../../agent-packs/topolo-agent-pack")].find(existsSync);
       if (!adapter) throw new Error("This CLI installation is missing its bundled Topolo Agent Pack adapter. Reinstall @topolo/cli.");
@@ -37,6 +70,7 @@ function registerAgentPacksCommand(program2) {
       const result = spawnSync("python3", [
         adapter,
         ...store ? ["--store", store] : [],
+        ...options.harness === "claude" ? ["--harness", "claude"] : [],
         name,
         ...forwarded,
         ...name === "add" && !options.adapterHelp ? ["--catalog"] : []
@@ -3667,7 +3701,7 @@ import { join as join2 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 import { mkdir, readFile, readdir, rename, rm, writeFile, chmod } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
-import { homedir, platform as hostPlatform } from "os";
+import { homedir as homedir3, platform as hostPlatform } from "os";
 import { dirname as dirname3, join } from "path";
 var TopoloSdkError2 = class extends Error {
   code;
@@ -4097,7 +4131,7 @@ var MACOS_KEYCHAIN_WRITE_SCRIPT = [
 function installationStorePath() {
   const override = process.env.TOPOLO_INSTALLATIONS_PATH?.trim();
   if (override) return override;
-  const base = process.env.XDG_CONFIG_HOME || (hostPlatform() === "win32" ? join(homedir(), "AppData", "Roaming") : join(homedir(), ".config"));
+  const base = process.env.XDG_CONFIG_HOME || (hostPlatform() === "win32" ? join(homedir3(), "AppData", "Roaming") : join(homedir3(), ".config"));
   return join(base, "topolo", "installations");
 }
 function installationPath(environment, id) {
@@ -6126,7 +6160,7 @@ function formatCheckResult(result) {
 import { spawnSync as spawnSync4 } from "child_process";
 import { existsSync as existsSync6 } from "fs";
 import { readFile as readFile6, rm as rm3 } from "fs/promises";
-import { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 import { dirname as dirname6, join as join7, resolve as resolve2 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { createRequire } from "module";
@@ -6135,7 +6169,7 @@ import { createRequire } from "module";
 import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
-import { homedir as homedir3 } from "os";
+import { homedir as homedir4 } from "os";
 import { isAbsolute, join as join6 } from "path";
 var SUPPORTED_AGENT_IDS = [
   "claude",
@@ -6191,7 +6225,7 @@ function stableNodeCommand() {
   });
   return selectStableNodeCommand(probe.status === 0 ? probe.stdout : void 0);
 }
-function agentSkillPath(agent, homeDir = homedir3(), projectDir) {
+function agentSkillPath(agent, homeDir = homedir4(), projectDir) {
   switch (agent) {
     case "claude":
       return projectDir ? join6(projectDir, ".claude", "skills", "topolo", "SKILL.md") : join6(homeDir, ".claude", "skills", "topolo", "SKILL.md");
@@ -6216,7 +6250,7 @@ function agentSkillPath(agent, homeDir = homedir3(), projectDir) {
       return void 0;
   }
 }
-function agentConfigPaths(agent, homeDir = homedir3(), projectDir) {
+function agentConfigPaths(agent, homeDir = homedir4(), projectDir) {
   switch (agent) {
     case "claude":
       return [{ path: join6(homeDir, ".claude.json"), format: "json", rootKey: "mcpServers" }];
@@ -6308,7 +6342,7 @@ function agentCliNames(agent) {
       return ["qchat", "q"];
   }
 }
-function agentConfigExists(agent, homeDir = homedir3(), projectDir) {
+function agentConfigExists(agent, homeDir = homedir4(), projectDir) {
   return agentConfigPaths(agent, homeDir, projectDir).some((config) => existsSync4(config.path));
 }
 function claudeDesktopConfigPath(homeDir) {
@@ -6321,7 +6355,7 @@ function vscodeUserConfigPath(homeDir) {
   if (process.platform === "win32") return join6(process.env.APPDATA ?? join6(homeDir, "AppData", "Roaming"), "Code", "User", "mcp.json");
   return join6(process.env.XDG_CONFIG_HOME ?? join6(homeDir, ".config"), "Code", "User", "mcp.json");
 }
-async function readAgentRegistrations(agent, homeDir = homedir3(), projectDir) {
+async function readAgentRegistrations(agent, homeDir = homedir4(), projectDir) {
   const registrations = [];
   for (const config of agentConfigPaths(agent, homeDir, projectDir)) {
     if (!existsSync4(config.path)) continue;
@@ -6859,8 +6893,8 @@ function resolveTargets(opts) {
     }))];
   }
   if (opts.all) return [...SUPPORTED_AGENT_IDS];
-  const homeDir = opts.homeDir ?? homedir4();
-  const detectBinaries = homeDir === homedir4();
+  const homeDir = opts.homeDir ?? homedir5();
+  const detectBinaries = homeDir === homedir5();
   const detected = SUPPORTED_AGENT_IDS.filter((agent) => agentConfigExists(agent, homeDir, opts.project) || detectBinaries && agentBinaryExists(agent));
   return [.../* @__PURE__ */ new Set(["claude", "codex", ...detected])];
 }
@@ -6921,7 +6955,7 @@ async function installAgentSurfaces(opts) {
   }
   const mcp = resolveMcpCommand();
   const registration = resolveMcpRegistration(opts);
-  const homeDir = opts.homeDir ?? homedir4();
+  const homeDir = opts.homeDir ?? homedir5();
   const results = [];
   for (const agent of resolveTargets({ ...opts, homeDir, project: opts.project })) {
     results.push(await installForAgent(agent, sourceDir, mcp, {
@@ -6956,7 +6990,7 @@ function assertAgentSetupSucceeded(results) {
   }
 }
 async function agentSurfaceStatus(options = {}) {
-  const homeDir = options.homeDir ?? homedir4();
+  const homeDir = options.homeDir ?? homedir5();
   const sourceSkill = await readFile6(join7(skillsSourceDir(), "topolo", "SKILL.md"), "utf8");
   const agents = resolveTargets({
     agent: options.agent,
@@ -6980,7 +7014,7 @@ async function agentSurfaceStatus(options = {}) {
   }));
 }
 async function uninstallAgentSurfaces(options) {
-  const homeDir = options.homeDir ?? homedir4();
+  const homeDir = options.homeDir ?? homedir5();
   const name = options.name?.trim() || "topolo";
   resolveMcpRegistration({ name, ...name === "topolo" ? {} : { context: "uninstall-validation" } });
   const removed = [];
@@ -7021,7 +7055,7 @@ function formatStatus(rows) {
 
 // src/commands/doctor.ts
 import { access } from "fs/promises";
-import { homedir as homedir5 } from "os";
+import { homedir as homedir6 } from "os";
 import { resolve as resolve3 } from "path";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
@@ -7084,7 +7118,7 @@ async function verifyMcpProtocol(command, args, env = definedEnvironment(process
 }
 async function resolveInstalledDoctorTarget(options) {
   const name = options.name?.trim() || "topolo";
-  const homeDir = options.agentHome ? resolve3(options.agentHome) : homedir5();
+  const homeDir = options.agentHome ? resolve3(options.agentHome) : homedir6();
   const expected = resolveMcpCommand();
   const requestedAgents = resolveTargets({
     ...options,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@topolo/cli",
   "packageManager": "pnpm@10.17.1",
-  "version": "0.13.0",
-  "topoloPublishedVersion": "0.13.0",
+  "version": "0.13.1",
+  "topoloPublishedVersion": "0.13.1",
   "description": "Public command-line interface for Topolo customer organizations, developers, and agents.",
   "license": "UNLICENSED",
   "author": "Topolo",
@@ -27,7 +27,7 @@
     "test:watch": "vitest",
     "coverage": "pnpm run coverage:node && pnpm run coverage:adapter",
     "coverage:node": "vitest run --coverage",
-    "coverage:adapter": "python3 -m venv node_modules/.cache/agent-pack-test && node_modules/.cache/agent-pack-test/bin/python -m pip install --disable-pip-version-check --quiet --timeout 15 --retries 0 -r agent-packs/requirements-test.txt && PYTHONPATH=agent-packs/src COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage run --branch --source=topolo_agent_pack.topolo -m unittest discover -s agent-packs/tests && COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage report --fail-under=100"
+    "coverage:adapter": "python3 -m venv node_modules/.cache/agent-pack-test && node_modules/.cache/agent-pack-test/bin/python -m pip install --disable-pip-version-check --quiet --timeout 15 --retries 0 -r agent-packs/requirements-test.txt && PYTHONPATH=agent-packs/src COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage run --branch --source=topolo_agent_pack.topolo,topolo_agent_pack.claude,topolo_agent_pack.policy -m unittest discover -s agent-packs/tests && COVERAGE_FILE=node_modules/.cache/agent-pack-test/.coverage node_modules/.cache/agent-pack-test/bin/python -m coverage report --fail-under=100"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",