@actiondock/cli 2.0.12 → 2.2.1

package/dist/index.js

@@ -1,1009 +1,50 @@
-// packages/cli/src/index.ts
-import { formatError } from "@actiondock/runtime-cli";
-import { setupNodeRuntime } from "@actiondock/runtime-node";
 import { CommanderError } from "commander";
-
-// packages/cli/src/commands/index.ts
-import { Command } from "commander";
-
-// packages/cli/src/commands/action/index.ts
-import {
-  executeAction as executeAction2,
-  registerActionCommands as registerRuntimeActionCommands
-} from "@actiondock/runtime-cli";
-
-// packages/cli/src/commands/action/create.ts
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { isAbsolute, join, resolve } from "node:path";
-import {
-  assertPathWithinRoot,
-  findProjectRoot,
-  getPackageSlug,
-  loadManifest,
-  loadProjectConfig,
-  saveManifest
-} from "@actiondock/core";
-import { ExecutionError } from "@actiondock/runtime-cli";
-function registerActionCreateCommand(actionCmd) {
-  actionCmd.command("create <id>").alias("new").description("Scaffold a new Action definition file").option("-d, --desc <description>", "Action description").option("-f, --file <filePath>", "Target file path relative to actions dir").action(async (id, options) => {
-    const root = findProjectRoot();
-    if (!root) {
-      throw new ExecutionError("Not in an ActionDock project (actiondock.json not found)");
-    }
-    try {
-      const config = loadProjectConfig(root);
-      const actionsDir = resolve(root, config.actionsDir || "actions");
-      if (!existsSync(actionsDir)) {
-        mkdirSync(actionsDir, { recursive: true });
-      }
-      if (options.file && isAbsolute(options.file)) {
-        throw new ExecutionError(`--file option must be a relative path, received: ${options.file}`);
-      }
-      const cleanName = getPackageSlug(id);
-      const targetRelFile = options.file || `${cleanName}.ts`;
-      const targetFullFile = resolve(actionsDir, targetRelFile);
-      assertPathWithinRoot(actionsDir, targetFullFile, "action file");
-      if (existsSync(targetFullFile)) {
-        throw new ExecutionError(`Target action file already exists at ${targetFullFile}`);
-      }
-      const desc = options.desc || `Action ${id}`;
-      const template = `import { defineAction } from "@actiondock/sdk";
-
-export interface Input {
-  exampleParam?: string;
-}
-
-export interface Output {
-  success: boolean;
-  result?: unknown;
-}
-
-export default defineAction<Input, Output>({
-  id: "${id}",
-  description: "${desc}",
-
-  inputSchema: {
-    type: "object",
-    properties: {
-      exampleParam: {
-        type: "string",
-        description: "Example parameter description",
-      },
-    },
-    required: [],
-  },
-
-  outputSchema: {
-    type: "object",
-    properties: {
-      success: { type: "boolean" },
-      result: {},
-    },
-    required: ["success"],
-  },
-
-  async run(input, ctx) {
-    ctx.log.info("Running ${id}", input);
-
-    // Access config: ctx.config.get("MY_CONFIG")
-    // Access state:  await ctx.state.get("my_key") / await ctx.state.set("my_key", val)
-    // Call action:   await ctx.actions.invoke(otherAction, input)
-
-    return {
-      success: true,
-      result: input.exampleParam || "done",
-    };
-  },
-});
-`;
-      writeFileSync(targetFullFile, template, "utf-8");
-      const manifest = loadManifest(root) || { schemaVersion: 1, actions: {}, assets: [] };
-      manifest.actions = manifest.actions || {};
-      manifest.actions[id] = {
-        entry: join(config.actionsDir || "actions", targetRelFile).replace(/\\/g, "/"),
-        description: desc,
-        inputSchema: {
-          type: "object",
-          properties: {
-            exampleParam: {
-              type: "string",
-              description: "Example parameter description"
-            }
-          },
-          required: []
-        },
-        outputSchema: {
-          type: "object",
-          properties: {
-            success: { type: "boolean" },
-            result: {}
-          },
-          required: ["success"]
-        },
-        uses: [],
-        tags: []
-      };
-      saveManifest(root, manifest);
-      console.log(`[OK] Created Action '${id}' at ${targetFullFile}`);
-      console.log(`
-To run this action:`);
-      console.log(`  ad action run ${id} --input '{"exampleParam": "hello"}'`);
-    } catch (err) {
-      if (err instanceof ExecutionError)
-        throw err;
-      throw new ExecutionError(err.message);
-    }
-  });
-}
-
-// packages/cli/src/commands/action/sync.ts
-import { findProjectRoot as findProjectRoot2, syncManifest } from "@actiondock/core";
-import { ExecutionError as ExecutionError2, getEffectiveOptions, renderResult } from "@actiondock/runtime-cli";
-function registerActionSyncCommand(actionCmd) {
-  actionCmd.command("sync").description("Synchronize action metadata manifest with TypeScript definitions").option("--check", "Check if manifest is synchronized without modifying files").option("--no-prune", "Do not remove deleted actions from manifest").option("--json", "Output as JSON").option("--envelope", "Wrap JSON output in standard envelope").action(async (rawOptions, cmd) => {
-    const options = getEffectiveOptions(rawOptions, cmd);
-    const root = findProjectRoot2();
-    if (!root) {
-      throw new ExecutionError2("Not in an ActionDock project (actiondock.json not found)");
-    }
-    try {
-      const result = await syncManifest(root, {
-        check: Boolean(options.check),
-        prune: options.prune !== false
-      });
-      renderResult(result, {
-        json: options.json,
-        envelope: options.envelope,
-        humanFormatter: () => {
-          const lines = [];
-          if (options.check) {
-            if (result.inSync) {
-              lines.push("[OK] actiondock.manifest.json is up to date.");
-            } else {
-              lines.push(`[FAIL] actiondock.manifest.json is out of sync with action definitions:
-`);
-              if (result.added.length > 0) {
-                lines.push(`  - Added actions:   ${result.added.join(", ")}`);
-              }
-              if (result.updated.length > 0) {
-                lines.push(`  - Updated actions: ${result.updated.join(", ")}`);
-              }
-              if (result.removed.length > 0) {
-                lines.push(`  - Removed actions: ${result.removed.join(", ")}`);
-              }
-              lines.push(`
-Run 'ad action sync' to synchronize metadata manifest.`);
-            }
-          } else {
-            if (result.inSync) {
-              lines.push(`[OK] actiondock.manifest.json is already up to date (${result.unchanged.length} action(s)).`);
-            } else {
-              lines.push(`[OK] Successfully synchronized actiondock.manifest.json:
-`);
-              if (result.added.length > 0) {
-                lines.push(`  - Added:   ${result.added.join(", ")}`);
-              }
-              if (result.updated.length > 0) {
-                lines.push(`  - Updated: ${result.updated.join(", ")}`);
-              }
-              if (result.removed.length > 0) {
-                lines.push(`  - Removed: ${result.removed.join(", ")}`);
-              }
-              lines.push(`
-Manifest updated at ${result.manifestPath}`);
-            }
-          }
-          return lines.join(`
-`);
-        }
-      });
-      if (options.check && !result.inSync) {
-        process.exitCode = 1;
-      }
-    } catch (err) {
-      if (err instanceof ExecutionError2)
-        throw err;
-      throw new ExecutionError2(err.message);
-    }
-  });
-}
-// packages/cli/src/commands/action/list.ts
-import { registerActionCommands } from "@actiondock/runtime-cli";
-// packages/cli/src/commands/action/show.ts
-import { registerActionCommands as registerActionCommands2 } from "@actiondock/runtime-cli";
-// packages/cli/src/commands/action/validate.ts
-import { registerActionCommands as registerActionCommands3 } from "@actiondock/runtime-cli";
-// packages/cli/src/commands/action/run.ts
-import { executeAction, getEffectiveOptions as getEffectiveOptions2 } from "@actiondock/runtime-cli";
-// packages/cli/src/commands/action/index.ts
-function registerActionCommands4(program) {
-  registerRuntimeActionCommands(program);
-  const actionCmd = program.commands.find((c) => c.name() === "action") || program.command("action");
-  registerActionCreateCommand(actionCmd);
-  registerActionSyncCommand(actionCmd);
-}
-// packages/cli/src/commands/build.ts
-import { buildProject } from "@actiondock/builder";
-import { findProjectRoot as findProjectRoot3, resolvePackageRoot } from "@actiondock/core";
-import { ExecutionError as ExecutionError3 } from "@actiondock/runtime-cli";
-function registerBuildCommand(program) {
-  program.command("build").description("Build project actions into a single standalone executable").option("-P, --package <id>", "Target package ID or path").option("-t, --target <target>", "Target compilation platform (e.g. bun, linux-x64, darwin-arm64, windows-x64)").option("-o, --out <path>", "Output executable path").option("-a, --actions <actions...>", "Only build specific action(s) into the standalone binary").option("-m, --minify", "Minify bundled JavaScript (default: true)", true).option("--no-minify", "Disable JavaScript minification").option("--bytecode", "Compile JavaScript to bytecode for faster startup (default: true)", true).option("--no-bytecode", "Disable bytecode compilation").action(async (options) => {
-    const root = options.package ? resolvePackageRoot(options.package) : findProjectRoot3();
-    if (!root) {
-      if (options.package) {
-        throw new ExecutionError3(`Package '${options.package}' not found in linked packages or path`);
-      }
-      throw new ExecutionError3(`Not in an ActionDock project (actiondock.json not found).
-Please specify -P, --package <id> or cd into a project directory.`);
-    }
-    console.log("Building standalone executable...");
-    let result;
-    try {
-      result = await buildProject({
-        projectRoot: root,
-        target: options.target,
-        outfile: options.out,
-        minify: options.minify,
-        bytecode: options.bytecode,
-        actions: options.actions
-      });
-    } catch (err) {
-      throw new ExecutionError3(`Build failed: ${err.message}`);
-    }
-    console.log(`[OK] Successfully compiled ${result.packageId} (v${result.version})`);
-    console.log(`  Target:     ${result.target}`);
-    console.log(`  Actions:    ${result.actions.join(", ")}`);
-    console.log(`  Executable: ${result.executablePath}`);
-    if (result.metadataPath) {
-      console.log(`  Metadata:   ${result.metadataPath}`);
-    }
-  });
-}
-
-// packages/cli/src/commands/config.ts
-import { registerConfigCommands as registerRuntimeConfigCommands } from "@actiondock/runtime-cli";
-function registerConfigCommands(program) {
-  registerRuntimeConfigCommands(program);
-}
-
-// packages/cli/src/commands/doctor.ts
-import { fetchRemoteDoctor, resolveTarget, runDoctorChecks } from "@actiondock/core";
-import { ExecutionError as ExecutionError4, getEffectiveOptions as getEffectiveOptions3, renderResult as renderResult2 } from "@actiondock/runtime-cli";
-function registerDoctorCommand(program) {
-  program.command("doctor").description("Check ActionDock environment, registry health, and project diagnostics").option("-P, --package <id|path>", "Target package ID or directory path for project diagnostics").option("-p, --profile <name>", "Query doctor diagnostics on a remote target").option("-s, --server <url>", "Remote server URL").option("-t, --token <token>", "Auth token for remote server").option("--json", "Output diagnostics report in JSON format").option("--envelope", "Wrap JSON output in standard envelope").action(async (rawOptions, cmd) => {
-    try {
-      const options = getEffectiveOptions3(rawOptions, cmd);
-      const target = resolveTarget({
-        profile: options.profile,
-        server: options.server,
-        token: options.token
-      });
-      let report;
-      if (target.type === "remote") {
-        const remoteRes = await fetchRemoteDoctor(target.serverUrl, target.token, options.package);
-        report = remoteRes.report || remoteRes;
-      } else {
-        report = await runDoctorChecks({
-          packageIdOrPath: options.package
-        });
-      }
-      renderResult2(report, {
-        json: options.json,
-        envelope: options.envelope,
-        humanFormatter: () => {
-          const lines = [];
-          const title = target.type === "remote" ? `[DOCTOR] Remote ActionDock Server Diagnostics (${target.serverUrl}${target.profileName ? ` - Profile: ${target.profileName}` : ""})
-` : `[DOCTOR] ActionDock System & Project Diagnostics
-`;
-          lines.push(title);
-          lines.push("[Runtime & Environment]");
-          const envChecks = (report.checks || []).filter((c) => c.category === "runtime" || c.category === "storage" || c.category === "registry");
-          for (const c of envChecks) {
-            const tag = c.status === "ok" ? "[OK]" : c.status === "warn" ? "[WARN]" : "[ERROR]";
-            lines.push(`  ${tag} ${c.name}: ${c.message}`);
-            if (c.fix) {
-              lines.push(`       Fix: ${c.fix}`);
-            }
-          }
-          if (report.hasProject) {
-            lines.push(`
-[Project: ${report.packageId || "unknown"}] (${report.projectRoot})`);
-            const projChecks = (report.checks || []).filter((c) => c.category === "project");
-            for (const c of projChecks) {
-              const tag = c.status === "ok" ? "[OK]" : c.status === "warn" ? "[WARN]" : "[ERROR]";
-              lines.push(`  ${tag} ${c.name}: ${c.message}`);
-              if (c.fix) {
-                lines.push(`       Fix: ${c.fix}`);
-              }
-            }
-          } else {
-            lines.push(`
-[Project Context]`);
-            lines.push("  [INFO] Not inside an ActionDock project directory (skipped project checks)");
-          }
-          lines.push(`
-[Summary] ${report.summary.ok} passed, ${report.summary.warn} warning(s), ${report.summary.error} error(s)`);
-          return lines.join(`
-`);
-        }
-      });
-      if (!report.ok) {
-        process.exitCode = 1;
-      }
-    } catch (err) {
-      throw new ExecutionError4(`Doctor failed to run diagnostics: ${err.message}`);
-    }
-  });
-}
-
-// packages/cli/src/commands/export.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { basename } from "node:path";
-import { exportCompositeSkill, exportSkill, exportSkillBatch } from "@actiondock/builder";
-import { discoverProjects, findProjectRoot as findProjectRoot4, listLinkedPackages, resolvePackageRoot as resolvePackageRoot2 } from "@actiondock/core";
-import { ExecutionError as ExecutionError5 } from "@actiondock/runtime-cli";
-function parseListOption(val, prev = []) {
-  const parts = val.split(",").map((s) => s.trim()).filter(Boolean);
-  return [...prev, ...parts];
-}
-function registerExportCommand(program) {
-  const exportCmd = program.command("export").description("Export project artifacts");
-  exportCmd.command("skill").description("Export Skill directory for AI Agents (default: source skill; use -s/--standalone for pre-built standalone binary)").option("-P, --package <id...>", "Target package ID(s) or path(s) (can be specified multiple times or comma-separated)", parseListOption, []).option("--workspace", "Export all packages discovered in current workspace").option("--all", "Export all linked packages from global registry").option("--bundle [name]", "Export multiple packages as a unified composite Skill bundle (defaults to workspace directory name if omitted)").option("-s, --standalone", "Export pre-compiled standalone binary skill (for environments without ActionDock runtime)").option("-t, --target <target>", "Target compilation platform for standalone mode (e.g. host, linux-x64, darwin-arm64, windows-x64)").option("-o, --out <path>", "Output skill directory").option("-p, --playbook <playbooks...>", "Only export specific playbook(s) and their dependent actions (Playbook-driven minimal export)").option("-a, --actions <actions...>", "Only export specific action(s)").option("-m, --minify", "Minify bundled JavaScript in standalone mode (default: true)", true).option("--no-minify", "Disable JavaScript minification in standalone mode").option("--bytecode", "Compile JavaScript to bytecode in standalone mode (default: true)", true).option("--no-bytecode", "Disable bytecode compilation in standalone mode").option("-z, --archive", "Create a .zip archive of the exported skill").option("--skill-md <path>", "Use specified existing SKILL.md file instead of auto-generating").action(async (options) => {
-    const isStandalone = Boolean(options.standalone);
-    if (options.bundle && isStandalone) {
-      throw new ExecutionError5("Composite Skill export (--bundle) currently only supports source mode. Please remove --standalone to export as a composite workspace Skill.");
-    }
-    const sourceCount = (options.all ? 1 : 0) + (options.workspace ? 1 : 0) + (options.package && options.package.length > 0 ? 1 : 0);
-    if (sourceCount > 1) {
-      throw new ExecutionError5("Options -P/--package, --workspace, and --all are mutually exclusive. Please specify only one package selection mode.");
-    }
-    let roots = [];
-    if (options.all) {
-      const linked = listLinkedPackages();
-      roots = linked.map((p) => p.path).filter((p) => existsSync2(p));
-      if (roots.length === 0) {
-        throw new ExecutionError5("No linked packages found in global registry.");
-      }
-    } else if (options.workspace) {
-      const cwd = process.cwd();
-      const discovered = discoverProjects(cwd);
-      roots = discovered.length > 0 ? discovered : findProjectRoot4(cwd) ? [findProjectRoot4(cwd)] : [];
-      if (roots.length === 0) {
-        throw new ExecutionError5(`No ActionDock packages found in workspace '${cwd}'.
-Make sure child directories contain actiondock.json.`);
-      }
-    } else if (options.package && options.package.length > 0) {
-      for (const pkgIdOrPath of options.package) {
-        const root = resolvePackageRoot2(pkgIdOrPath);
-        if (!root) {
-          throw new ExecutionError5(`Package '${pkgIdOrPath}' not found in linked packages or path`);
-        }
-        if (!roots.includes(root)) {
-          roots.push(root);
-        }
-      }
-    } else {
-      const root = findProjectRoot4();
-      if (root) {
-        roots.push(root);
-      } else {
-        throw new ExecutionError5(`Not in an ActionDock project (actiondock.json not found).
-Please specify -P, --package <id>, --workspace, --all, or cd into a project directory.`);
-      }
-    }
-    if (roots.length > 1 && (options.actions || options.playbook)) {
-      throw new ExecutionError5("Filtering options (--actions, --playbook) can only be used when exporting a single package.");
-    }
-    try {
-      if (options.bundle !== undefined) {
-        const bundleName = typeof options.bundle === "string" && options.bundle.trim() ? options.bundle.trim() : basename(process.cwd());
-        console.log(`Exporting composite Skill bundle '${bundleName}' (${roots.length} package${roots.length > 1 ? "s" : ""})...`);
-        const result = await exportCompositeSkill({
-          bundleName,
-          projectRoots: roots,
-          outDir: options.out,
-          archive: options.archive,
-          workspaceRoot: options.workspace ? process.cwd() : undefined,
-          skillMdPath: options.skillMd
-        });
-        console.log(`[OK] Successfully exported Composite Skill: ${result.bundleName}`);
-        console.log(`  Packages:   ${result.packagesCount}`);
-        console.log(`  Actions:    ${result.actionsCount}`);
-        console.log(`  Playbooks:  ${result.playbooksCount}`);
-        console.log(`  Skill Dir:  ${result.skillDir}`);
-        if (result.usedExistingSkillMd) {
-          console.log(`  SKILL.md:   Reused existing file from ${result.usedExistingSkillMd}`);
-        }
-        if (result.archivePath) {
-          console.log(`  Archive:    ${result.archivePath}`);
-        }
-        return;
-      }
-      if (roots.length > 1) {
-        console.log(`Batch exporting ${roots.length} Skill packages...`);
-        const batchRes = await exportSkillBatch({
-          projectRoots: roots,
-          mode: isStandalone ? "standalone" : "source",
-          standalone: isStandalone,
-          target: options.target,
-          outDir: options.out,
-          archive: options.archive,
-          playbooks: options.playbook,
-          actions: options.actions,
-          minify: options.minify,
-          bytecode: options.bytecode,
-          skillMdPath: options.skillMd
-        });
-        console.log(`[OK] Successfully batch exported ${batchRes.results.length} Skill packages to: ${batchRes.outDir}`);
-        for (const res of batchRes.results) {
-          console.log(`  - ${res.packageId} (v${res.version}): ${res.actionsCount} actions, ${res.playbooksCount} playbooks -> ${res.skillDir}`);
-        }
-        console.log(`  Total Actions:   ${batchRes.totalActions}`);
-        console.log(`  Total Playbooks: ${batchRes.totalPlaybooks}`);
-        return;
-      }
-      const root = roots[0];
-      console.log(`Exporting ${isStandalone ? "standalone binary" : "source"} Skill artifact...`);
-      const result = await exportSkill({
-        projectRoot: root,
-        mode: isStandalone ? "standalone" : "source",
-        standalone: isStandalone,
-        target: options.target,
-        outDir: options.out,
-        archive: options.archive,
-        playbooks: options.playbook,
-        actions: options.actions,
-        minify: options.minify,
-        bytecode: options.bytecode,
-        skillMdPath: options.skillMd
-      });
-      console.log(`[OK] Successfully exported ${result.mode === "standalone" ? "Standalone" : "Source"} Skill: ${result.packageId} (v${result.version})`);
-      console.log(`  Mode:       ${result.mode}${result.mode === "standalone" ? ` (target: ${result.target})` : ""}`);
-      console.log(`  Actions:    ${result.actionsCount}`);
-      console.log(`  Playbooks:  ${result.playbooksCount}`);
-      console.log(`  Skill Dir:  ${result.skillDir}`);
-      if (result.usedExistingSkillMd) {
-        console.log(`  SKILL.md:   Reused existing file from ${result.usedExistingSkillMd}`);
-      }
-      if (result.archivePath) {
-        console.log(`  Archive:    ${result.archivePath}`);
-      }
-    } catch (err) {
-      throw new ExecutionError5(`Export failed: ${err.message}`);
-    }
-  });
-}
-
-// packages/cli/src/commands/info.ts
-import { registerInfoCommand as registerRuntimeInfoCommand } from "@actiondock/runtime-cli";
-function registerInfoCommand(program) {
-  registerRuntimeInfoCommand(program);
-}
-
-// packages/cli/src/commands/init.ts
-import { initProject } from "@actiondock/core";
-import { ExecutionError as ExecutionError6 } from "@actiondock/runtime-cli";
-function registerInitCommand(program) {
-  program.command("init [directory]").description("Initialize a new ActionDock project").option("-i, --id <id>", "Project identifier").option("-n, --name <name>", "Project display name").option("-d, --desc <description>", "Project description").action((dir = ".", options) => {
-    try {
-      initProject(dir, {
-        id: options.id,
-        name: options.name,
-        description: options.desc
-      });
-      console.log(`Successfully initialized ActionDock project in ${dir}`);
-    } catch (err) {
-      throw new ExecutionError6(err.message);
-    }
-  });
-}
-
-// packages/cli/src/commands/link.ts
-import {
-  linkPackage,
-  pruneRegistry,
-  unlinkPackage
-} from "@actiondock/core";
-import { ExecutionError as ExecutionError7 } from "@actiondock/runtime-cli";
-function registerLinkCommands(program) {
-  program.command("link [path]").option("-r, --recursive", "Recursively discover and link packages in subdirectories").description("Link local Action package(s) or workspace directory into global registry for instant cross-directory execution").action(async (targetPath, options) => {
-    try {
-      const result = linkPackage(targetPath || process.cwd(), undefined, {
-        recursive: options.recursive
-      });
-      if (result.isWorkspace) {
-        console.log(`[OK] Linked workspace '${result.path}' (${result.entries.length} package${result.entries.length > 1 ? "s" : ""}):`);
-        for (const e of result.entries) {
-          console.log(`  - ${e.id} (v${e.version}) -> ${e.path}`);
-        }
-        console.log("[INFO] Sub-packages added to this workspace will be automatically discovered.");
-      } else {
-        console.log(`[OK] Linked package '${result.id}' (v${result.version}) from ${result.path}`);
-      }
-    } catch (err) {
-      throw new ExecutionError7(err.message);
-    }
-  });
-  program.command("unlink [identifier]").option("-p, --prune", "Automatically scan and prune any stale/missing paths from registry").description("Unlink a package, workspace, or prune stale entries from global developer registry").action((identifier, options) => {
-    try {
-      if (options.prune || identifier === "--prune") {
-        const result = pruneRegistry();
-        const totalPruned = result.prunedPackages.length + result.prunedWorkspaces.length;
-        if (totalPruned === 0) {
-          console.log("[OK] No stale registry entries found.");
-        } else {
-          console.log(`[OK] Pruned ${result.prunedWorkspaces.length} workspace(s) and ${result.prunedPackages.length} package(s) from registry.`);
-          for (const ws of result.prunedWorkspaces) {
-            console.log(`  - [workspace] ${ws.path}`);
-          }
-          for (const pkg of result.prunedPackages) {
-            console.log(`  - [package] ${pkg.id} (${pkg.path})`);
-          }
-        }
-        return;
-      }
-      const removed = unlinkPackage(identifier || process.cwd());
-      if (removed) {
-        if (removed.type === "workspace") {
-          console.log(`[OK] Unlinked workspace '${removed.path}' (${removed.packagesCount || 0} package${(removed.packagesCount || 0) > 1 ? "s" : ""} unlinked)`);
-        } else {
-          console.log(`[OK] Unlinked package '${removed.id}' (${removed.path})`);
-        }
-      } else {
-        console.log(`Package or workspace '${identifier || process.cwd()}' was not linked in registry`);
-      }
-    } catch (err) {
-      throw new ExecutionError7(err.message);
-    }
-  });
-}
-
-// packages/cli/src/commands/mcp.ts
-import { registerMcpCommands as registerRuntimeMcpCommands } from "@actiondock/runtime-cli";
-function registerMcpCommands(program) {
-  registerRuntimeMcpCommands(program);
-}
-
-// packages/cli/src/commands/playbook.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname, isAbsolute as isAbsolute2, resolve as resolve2 } from "node:path";
-import { assertPathWithinRoot as assertPathWithinRoot2, findProjectRoot as findProjectRoot5, loadProjectConfig as loadProjectConfig2 } from "@actiondock/core";
-import {
-  CliError,
-  ExecutionError as ExecutionError8,
-  registerPlaybookCommands as registerRuntimePlaybookCommands
-} from "@actiondock/runtime-cli";
-function registerPlaybookCommands(program) {
-  registerRuntimePlaybookCommands(program);
-  const pbCmd = program.commands.find((c) => c.name() === "playbook") || program.command("playbook");
-  pbCmd.command("create <id>").alias("new").description("Scaffold a new Playbook markdown file").option("-d, --desc <description>", "Playbook description").option("-a, --actions <actions...>", "Referenced action IDs").option("-f, --file <filePath>", "Target file path relative to playbooks dir").action((id, options) => {
-    const root = findProjectRoot5();
-    if (!root) {
-      throw new ExecutionError8("Not in an ActionDock project (actiondock.json not found)");
-    }
-    try {
-      const config = loadProjectConfig2(root);
-      const pbDir = resolve2(root, config.playbooksDir || "playbooks");
-      if (!existsSync3(pbDir)) {
-        mkdirSync2(pbDir, { recursive: true });
-      }
-      if (options.file && isAbsolute2(options.file)) {
-        throw new ExecutionError8(`--file option must be a relative path, received: ${options.file}`);
-      }
-      const cleanName = id.replace(/[^a-zA-Z0-9-_]/g, "-");
-      const targetRelFile = options.file || `${cleanName}.md`;
-      const targetFullFile = resolve2(pbDir, targetRelFile);
-      assertPathWithinRoot2(pbDir, targetFullFile, "playbook file");
-      if (existsSync3(targetFullFile)) {
-        throw new ExecutionError8(`File '${targetFullFile}' already exists`);
-      }
-      mkdirSync2(dirname(targetFullFile), { recursive: true });
-      const desc = options.desc || `SOP guide for ${id}`;
-      const actionsList = Array.isArray(options.actions) ? options.actions : [];
-      const actionsYaml = actionsList.length > 0 ? `actions:
-${actionsList.map((a) => `  - ${a}`).join(`
-`)}
-` : `actions: []
-`;
-      const template = `---
-id: ${id}
-description: ${desc}
-${actionsYaml}---
-
-# ${id.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase())} SOP
-
-This playbook provides task execution guidance for AI Agents.
-
-## Instructions
-
-- Inspect available actions with \`<binary> list --json\`.
-- Follow the required steps to complete the task.
-`;
-      writeFileSync2(targetFullFile, template, "utf-8");
-      console.log(`[OK] Created Playbook '${id}' at ${targetFullFile}`);
-    } catch (err) {
-      if (err instanceof CliError) {
-        throw err;
-      }
-      throw new ExecutionError8(err.message);
-    }
-  });
-}
-
-// packages/cli/src/commands/profile.ts
-import {
-  addProfile,
-  checkRemoteHealth,
-  filterWithFallbackInfo,
-  getProfile,
-  listProfiles,
-  loadProfiles,
-  maskSecretValue,
-  removeProfile,
-  resolveProfileToken,
-  resolveTarget as resolveTarget2,
-  toSnakeUpperCase,
-  useProfile
-} from "@actiondock/core";
-import {
-  ArgumentError,
-  CliError as CliError2,
-  ExecutionError as ExecutionError9,
-  getEffectiveOptions as getEffectiveOptions4,
-  renderResult as renderResult3
-} from "@actiondock/runtime-cli";
-
-// packages/cli/src/utils/filter.ts
-import { resolveIntent } from "@actiondock/runtime-cli";
-
-// packages/cli/src/commands/profile.ts
-function registerProfileCommands(program) {
-  const profileCmd = program.command("profile").description("Manage multi-cloud and remote execution profiles");
-  profileCmd.command("list [patterns...]").description("List all configured profiles").option("-i, --intent <pattern>", "Regex or fuzzy intent filter; falls back to full list when no match").option("--reveal, --show-secrets", "Reveal plain text values for tokens").option("--fallback", "Enable fallback to full list when no items match intent").option("--no-fallback", "Disable fallback to full list when no items match intent").option("--json", "Output as JSON").option("--envelope", "Wrap JSON output in standard envelope").action((patterns, rawOptions, cmd) => {
-    try {
-      const options = getEffectiveOptions4(rawOptions, cmd);
-      const effectiveIntent = resolveIntent(options.intent, patterns);
-      const isMachine = Boolean(options.json || options.envelope);
-      const fallbackExplicit = options.fallback === true || Array.isArray(process.argv) && process.argv.includes("--fallback");
-      const shouldFallback = isMachine ? fallbackExplicit : options.fallback !== false;
-      const reveal = Boolean(options.reveal || options.showSecrets);
-      const list = listProfiles();
-      const enriched = list.map((p) => {
-        const resolved = resolveProfileToken(p.name, p.entry);
-        return {
-          name: p.name,
-          isCurrent: p.isCurrent,
-          serverUrl: p.entry.serverUrl,
-          description: p.entry.description || "",
-          tokenEnv: p.entry.tokenEnv,
-          tokenConfigured: resolved.source !== "none",
-          tokenSource: resolved.source,
-          token: reveal ? resolved.token : resolved.token ? maskSecretValue(resolved.token) : undefined
-        };
-      });
-      const filterRes = filterWithFallbackInfo(enriched, effectiveIntent, [(p) => p.name, (p) => p.serverUrl, (p) => p.description, (p) => p.tokenSource], shouldFallback);
-      if (filterRes.isFallback && isMachine) {
-        renderResult3({ items: filterRes.items, isFallback: true, matchedCount: 0 }, { json: options.json, envelope: options.envelope });
-        return;
-      }
-      renderResult3(filterRes.items, {
-        json: options.json,
-        envelope: options.envelope,
-        humanFormatter: () => {
-          const lines = [`ActionDock Execution Profiles:
-`];
-          if (filterRes.isFallback && effectiveIntent) {
-            lines.push(`(No profiles matched intent '${effectiveIntent}', showing all profiles)
-`);
-          }
-          for (const item of filterRes.items) {
-            const currentMarker = item.isCurrent ? "* " : "  ";
-            let tokenInfo = "";
-            if (item.tokenSource === "tokenEnv") {
-              tokenInfo = ` [token: env(${item.tokenEnv})]`;
-            } else if (item.tokenSource === "profileEnv") {
-              tokenInfo = ` [token: env(ACTIONDOCK_${toSnakeUpperCase(item.name)}_TOKEN)]`;
-            } else if (item.tokenSource === "profile") {
-              tokenInfo = ` [token: stored in profile]`;
-            } else if (item.tokenSource === "globalEnv") {
-              tokenInfo = ` [token: env(ACTIONDOCK_TOKEN)]`;
-            }
-            if (reveal && item.token) {
-              tokenInfo += ` = ${item.token}`;
+import { createCliProgram } from "./commands/index.js";
+import { formatError } from "./errors.js";
+import { renderError } from "./renderer.js";
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./renderer.js";
+export * from "./prompt.js";
+export * from "./standalone/index.js";
+export * from "./utils/index.js";
+export * from "./services/index.js";
+export * from "./commands/index.js";
+/**
+ * ActionDock CLI 主执行入口函数。
+ *
+ * @param argv 命令行参数数组（默认使用 process.argv）
+ * @returns 进程退出码
+ */
+export async function main(argv = process.argv) {
+    const program = createCliProgram();
+    const isMachine = argv.includes("--json") || argv.includes("--envelope");
+    try {
+        await program.parseAsync(argv);
+        return typeof process.exitCode === "number" ? process.exitCode : 0;
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            if (err.exitCode === 0) {
+                return 0;
             }
-            const desc = item.description ? ` - ${item.description}` : "";
-            lines.push(`${currentMarker}${item.name.padEnd(20)} ${item.serverUrl}${tokenInfo}${desc}`);
-          }
-          lines.push(`
-Use 'ad profile use <name>' to switch or 'ad run <action> --profile <name>' to execute on a specific target.`);
-          return lines.join(`
-`);
-        }
-      });
-    } catch (err) {
-      if (err instanceof ArgumentError || err instanceof CliError2)
-        throw err;
-      throw new ExecutionError9(err.message);
-    }
-  });
-  profileCmd.command("add <name>").description("Add or update a remote execution profile").requiredOption("-s, --server <url>", "Remote ActionDock server URL (e.g. http://1.2.3.4:5177)").option("-t, --token <token>", "Authentication token for the remote server (deprecated; prefer --token-env)").option("--token-env <env>", "Environment variable name containing the authentication token").option("-d, --desc <description>", "Description of this profile/machine").action((name, options) => {
-    try {
-      if (options.token) {
-        console.warn("Warning: storing tokens directly in profiles.json is deprecated. Use --token-env or standard environment variables (e.g. ACTIONDOCK_<PROFILE>_TOKEN) instead.");
-      }
-      addProfile(name, {
-        serverUrl: options.server,
-        token: options.token,
-        tokenEnv: options.tokenEnv,
-        description: options.desc
-      });
-      console.log(`[OK] Profile '${name}' configured for server: ${options.server}`);
-    } catch (err) {
-      throw new ExecutionError9(err.message);
-    }
-  });
-  profileCmd.command("use <name>").description("Switch active default profile").action((name) => {
-    try {
-      useProfile(name);
-      console.log(`[OK] Active profile switched to '${name}'`);
-    } catch (err) {
-      throw new ExecutionError9(err.message);
-    }
-  });
-  profileCmd.command("show [name]").description("Display details of a profile (defaults to active profile)").option("--reveal, --show-secrets", "Reveal plain text values for tokens").option("--json", "Output as JSON").option("--envelope", "Wrap JSON output in standard envelope").action((name, rawOptions, cmd) => {
-    try {
-      const options = getEffectiveOptions4(rawOptions, cmd);
-      const config = loadProfiles();
-      const targetName = name || config.currentProfile || "local";
-      const entry = getProfile(targetName);
-      const reveal = Boolean(options.reveal || options.showSecrets);
-      if (!entry && targetName !== "local") {
-        throw new ArgumentError(`Profile '${targetName}' not found.`);
-      }
-      const resolved = resolveProfileToken(targetName, entry);
-      const displayToken = reveal ? resolved.token : resolved.token ? maskSecretValue(resolved.token) : undefined;
-      const data = {
-        name: targetName,
-        isCurrent: config.currentProfile === targetName,
-        serverUrl: entry?.serverUrl || "local",
-        tokenConfigured: resolved.source !== "none",
-        tokenSource: resolved.source,
-        tokenEnv: entry?.tokenEnv,
-        token: displayToken,
-        description: entry?.description || ""
-      };
-      renderResult3(data, {
-        json: options.json,
-        envelope: options.envelope,
-        humanFormatter: () => {
-          const lines = [];
-          lines.push(`Profile:      ${data.name}${data.isCurrent ? " (Active)" : ""}`);
-          lines.push(`Server URL:   ${data.serverUrl}`);
-          let sourceDetail = "None";
-          if (data.tokenSource === "tokenEnv") {
-            sourceDetail = `Environment Variable ($${data.tokenEnv})`;
-          } else if (data.tokenSource === "profileEnv") {
-            sourceDetail = `Profile Environment Variable ($ACTIONDOCK_${toSnakeUpperCase(data.name)}_TOKEN)`;
-          } else if (data.tokenSource === "profile") {
-            sourceDetail = "Stored in profiles.json (Deprecated)";
-          } else if (data.tokenSource === "globalEnv") {
-            sourceDetail = "Global Environment Variable ($ACTIONDOCK_TOKEN)";
-          }
-          lines.push(`Auth Source:  ${sourceDetail}`);
-          if (data.tokenConfigured) {
-            lines.push(`Token Value:  ${data.token}`);
-          }
-          if (data.description) {
-            lines.push(`Description:  ${data.description}`);
-          }
-          return lines.join(`
-`);
         }
-      });
-    } catch (err) {
-      if (err instanceof ArgumentError || err instanceof CliError2) {
-        throw err;
-      }
-      throw new ExecutionError9(err.message);
-    }
-  });
-  profileCmd.command("rm <name>").alias("remove").description("Remove a profile").action((name) => {
-    try {
-      if (name === "local") {
-        throw new ExecutionError9("Cannot remove built-in 'local' profile");
-      }
-      const removed = removeProfile(name);
-      if (!removed) {
-        throw new ExecutionError9(`Profile '${name}' not found`);
-      }
-      console.log(`[OK] Profile '${name}' removed`);
-    } catch (err) {
-      if (err instanceof CliError2) {
-        throw err;
-      }
-      throw new ExecutionError9(err.message);
-    }
-  });
-  profileCmd.command("test [name]").description("Test connection latency and health of a profile").option("--json", "Output as JSON").option("--envelope", "Wrap JSON output in standard envelope").action(async (name, rawOptions, cmd) => {
-    try {
-      const options = getEffectiveOptions4(rawOptions, cmd);
-      const target = resolveTarget2({ profile: name });
-      if (target.type === "local") {
-        renderResult3({ ok: true, type: "local", message: "Local execution" }, {
-          json: options.json,
-          envelope: options.envelope,
-          humanFormatter: () => `Target profile '${target.profileName || "local"}' is local (runs in local runtime).`
+        // 复用 renderer 的 renderError 统一错误信封，消除手工拼装的双实现
+        renderError(err, {
+            json: isMachine,
+            envelope: isMachine,
         });
-        return;
-      }
-      const health = await checkRemoteHealth(target.serverUrl, target.token);
-      renderResult3(health, {
-        json: options.json,
-        envelope: options.envelope,
-        humanFormatter: () => {
-          if (health.ok) {
-            return `[OK] Connected to ${target.serverUrl} (${health.latencyMs}ms) - Version: ${health.version}, Status: ${health.status}`;
-          }
-          return `[FAIL] Connection to ${target.serverUrl} failed (${health.latencyMs}ms): ${health.error}`;
-        }
-      });
-      if (!health.ok) {
-        process.exitCode = 1;
-      }
-    } catch (err) {
-      if (err instanceof ArgumentError || err instanceof CliError2)
-        throw err;
-      throw new ExecutionError9(err.message);
+        process.exitCode = formatError(err).exitCode;
+        return process.exitCode;
     }
-  });
 }
-
-// packages/cli/src/commands/runs.ts
-import { registerRunsCommands as registerRuntimeRunsCommands } from "@actiondock/runtime-cli";
-function registerRunsCommands(program) {
-  registerRuntimeRunsCommands(program);
-}
-
-// packages/cli/src/commands/serve.ts
-import { registerServeCommand as registerRuntimeServeCommand } from "@actiondock/runtime-cli";
-function registerServeCommand(program) {
-  registerRuntimeServeCommand(program);
-}
-
-// packages/cli/src/commands/state.ts
-import { registerStateCommands as registerRuntimeStateCommands } from "@actiondock/runtime-cli";
-function registerStateCommands(program) {
-  registerRuntimeStateCommands(program);
-}
-
-// packages/cli/src/commands/test.ts
-import { spawnSync } from "node:child_process";
-import { existsSync as existsSync4, readFileSync } from "node:fs";
-import { join as join2 } from "node:path";
-import { findProjectRoot as findProjectRoot6 } from "@actiondock/core";
-function registerTestCommand(program) {
-  program.command("test [pattern]").description("Run project tests using configured test runner (node:test or bun test)").action((pattern) => {
-    const root = findProjectRoot6();
-    const cwd = root || process.cwd();
-    const pkgJsonPath = join2(cwd, "package.json");
-    let testCmd = "npm";
-    let testArgs = ["test"];
-    if (existsSync4(pkgJsonPath)) {
-      try {
-        const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
-        if (pkg.scripts?.test?.includes("bun test") && typeof globalThis.Bun !== "undefined") {
-          testCmd = "bun";
-          testArgs = ["test"];
-        }
-      } catch {}
-    }
-    if (pattern) {
-      if (testCmd === "npm") {
-        testArgs.push("--", pattern);
-      } else {
-        testArgs.push(pattern);
-      }
-    }
-    const proc = spawnSync(testCmd, testArgs, {
-      cwd,
-      stdio: "inherit"
-    });
-    if (proc.status !== 0) {
-      process.exitCode = proc.status ?? 1;
-    }
-  });
-}
-
-// packages/cli/src/commands/index.ts
-function applyCommonOptions(cmd) {
-  const hasOpt = (flagName) => cmd.options.some((o) => o.name() === flagName || o.long === `--${flagName}`);
-  if (!hasOpt("json")) {
-    cmd.option("--json", "Output as JSON");
-  }
-  if (!hasOpt("envelope")) {
-    cmd.option("--envelope", "Wrap JSON output in standard envelope");
-  }
-  if (!hasOpt("dataDir") && !hasOpt("data-dir")) {
-    cmd.option("--data-dir <path>", "Custom database storage directory");
-  }
-  for (const sub of cmd.commands) {
-    applyCommonOptions(sub);
-  }
-}
-function createCliProgram() {
-  const program = new Command;
-  program.name("ad").description("ActionDock (ad) 2.0 - Toolchain for building and shipping standalone AI Agent Actions & Skills").version("2.0.12", "-v, --version");
-  program.option("-V", "output the version number");
-  program.on("option:V", () => {
-    program._outputConfiguration.writeOut(`${program.version()}
-`);
-    program._exit(0, "commander.version", program.version());
-  });
-  program.exitOverride((err) => {
-    throw err;
-  });
-  registerInitCommand(program);
-  registerInfoCommand(program);
-  registerDoctorCommand(program);
-  registerActionCommands4(program);
-  registerPlaybookCommands(program);
-  registerConfigCommands(program);
-  registerStateCommands(program);
-  registerRunsCommands(program);
-  registerTestCommand(program);
-  registerBuildCommand(program);
-  registerExportCommand(program);
-  registerLinkCommands(program);
-  registerProfileCommands(program);
-  registerServeCommand(program);
-  registerMcpCommands(program);
-  applyCommonOptions(program);
-  return program;
-}
-
-// packages/cli/src/index.ts
 import { fileURLToPath } from "node:url";
-import { resolve as resolve3 } from "node:path";
-async function main(argv = process.argv) {
-  setupNodeRuntime();
-  const program = createCliProgram();
-  const isMachine = argv.includes("--json") || argv.includes("--envelope");
-  try {
-    await program.parseAsync(argv);
-    return typeof process.exitCode === "number" ? process.exitCode : 0;
-  } catch (err) {
-    if (err instanceof CommanderError) {
-      if (err.exitCode === 0) {
-        return 0;
-      }
-    }
-    const formatted = formatError(err);
-    if (isMachine) {
-      const errorEnv = {
-        ok: false,
-        error: {
-          code: formatted.code,
-          message: formatted.message,
-          ...formatted.details !== undefined ? { details: formatted.details } : {}
-        }
-      };
-      console.log(JSON.stringify(errorEnv, null, 2));
-    } else {
-      const msg = formatted.message.startsWith("Error: ") ? formatted.message : `Error: ${formatted.message}`;
-      console.error(msg);
-    }
-    process.exitCode = formatted.exitCode;
-    return formatted.exitCode;
-  }
-}
-var isDirectRun = Boolean(process.argv[1]) && resolve3(process.argv[1]) === fileURLToPath(import.meta.url);
+import { resolve } from "node:path";
+const isDirectRun = Boolean(process.argv[1]) &&
+    resolve(process.argv[1]) === fileURLToPath(import.meta.url);
 if (isDirectRun) {
-  main().catch((err) => {
-    console.error("Fatal error:", err);
-    process.exitCode = 1;
-  });
+    main().catch((err) => {
+        console.error("Fatal error:", err);
+        process.exitCode = 1;
+    });
 }
-export {
-  createCliProgram,
-  main
-};