@actiondock/cli 2.0.1 → 2.0.3

package/README.md

@@ -1,84 +1,110 @@
 # @actiondock/cli
 
-The official Command Line Interface (CLI) toolchain for ActionDock 2.0.
+ActionDock 2.0 官方命令行门面工具链。
 
-[![Bun](https://img.shields.io/badge/Bun-%3E%3D1.2-black?logo=bun)](https://bun.sh/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.12.0-green?logo=node.js)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue?logo=typescript)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-> **Runtime requirement**: [Bun](https://bun.sh/) >= 1.2.0.
+`@actiondock/cli` 提供 `ad` 命令行接口，用于开发、测试、构建、分发和运行 AI 智能体工具与技能。
 
-`@actiondock/cli` provides the `ad` command to develop, test, build, deploy, and export AI Agent Actions and Skills across MCP, HTTP, CLI, and standalone executables.
+---
+
+## 运行环境
+
+- 原生基于 Node.js 22.12.0 或更高版本运行。
+- 支持 npm、pnpm 与 yarn 进行全局安装或项目级管理。
+- 日常开发、调试、测试、MCP 服务启动与 HTTP 部署完全基于 Node.js，无需安装 Bun。
+- 仅在使用 `ad build` 编译单文件独立二进制产物时，需要系统安装外部 Bun 编译器。
 
 ---
 
-## Installation
+## 安装方式
 
-```bash
-# 1. Install Bun runtime (if not already installed)
-npm install -g bun
+使用标准包管理器全局安装：
 
-# 2. Install ActionDock CLI
+```bash
 npm install -g @actiondock/cli
 ```
 
+也可以在项目中通过 npx 临时调用：
+
+```bash
+npx ad --help
+```
+
 ---
 
-## Quick Start in 5 Steps
+## 快速上手流程
 
+- 初始化项目脚手架：
 ```bash
-# 1. Initialize a new Action package scaffold
 ad init my-tools
 cd my-tools
+npm install
+```
 
-# 2. Run an Action locally (outputs standard JSON envelope)
+- 本地执行 Action：
+```bash
 ad run sample.greet --input '{"name": "Alice"}'
+```
 
-# 3. Run in-memory unit tests
+- 运行单元测试：
+```bash
 ad test
+```
 
-# 4. Compile into a single standalone binary
-ad build
+- 启动为 MCP 协议服务：
+```bash
+ad mcp
+```
 
-# 5. Export as a portable Agent Skill (with SOPs)
+- 导出为便携式 Agent Skill 技能包：
+```bash
 ad export skill
 ```
 
+- 编译为零依赖单文件独立二进制产物（需外部安装 Bun）：
+```bash
+ad build
+```
+
 ---
 
-## Command Cheat Sheet
+## 常用命令速查
 
-| Command | Purpose |
+| 命令 | 说明 |
 |---|---|
-| `ad init [dir]` | Initialize an Action package scaffold |
-| `ad info [patterns...]` | Explore capabilities and display metadata (supports fuzzy matching and `--tree`) |
-| `ad doctor` | Run environment, global registry health, and project diagnostics |
-| `ad action list` / `ad run <id>` | List and execute Actions |
-| `ad playbook list` / `show` | Inspect agent task SOP Playbooks |
-| `ad config list` / `get` / `set` | Manage runtime configurations |
-| `ad state list` / `get` / `set` / `delete` / `clear` | Inspect and manage persistent state (with namespaces, TTL, and clear) |
-| `ad runs list` / `show` | Inspect execution history and traces |
-| `ad test` | Run fast unit tests |
-| `ad build` | Compile into a zero-dependency standalone binary |
-| `ad export skill` | Export Skill bundle for AI Agent platforms |
-| `ad link` / `unlink` | Manage global router (with live subproject auto-discovery and prune) |
-| `ad profile` / `ad serve` | Manage remote node profiles and start HTTP Runner |
-| `ad mcp` | Start ActionDock as STDIO or HTTP MCP server |
+| `ad init [dir]` | 初始化 Action Package 项目脚手架 |
+| `ad info [patterns...]` | 检索包元数据与能力清单，支持模式匹配与树形展示 |
+| `ad doctor` | 执行运行环境与项目结构健康诊断 |
+| `ad run <id>` | 本地执行指定 Action 并输出标准信封结果 |
+| `ad action list` | 列出包内所有已注册的 Action |
+| `ad playbook list` / `show` | 查看智能体操作规程 Playbook |
+| `ad config list` / `get` / `set` | 管理包运行时配置与环境变量绑定 |
+| `ad state list` / `get` / `set` / `delete` / `clear` | 查看与维护 SQLite 持久化状态 |
+| `ad runs list` / `show` | 查询任务执行历史与追踪记录 |
+| `ad test` | 执行快速单元测试 |
+| `ad build` | 调度外部 Bun 编译器打包单文件独立二进制产物 |
+| `ad export skill` | 导出包含操作规程的 Agent Skill 技能包 |
+| `ad link` / `unlink` | 注册或注销工作区全局路由与符号链接 |
+| `ad profile` | 管理远程执行节点凭证与环境配置 |
+| `ad serve` | 启动远程 HTTP 执行调度微服务 |
+| `ad mcp` | 以 STDIO 或 HTTP 协议启动 MCP 服务 |
 
 ---
 
-## 📖 Complete Documentation
+## 架构集成
 
-For the full list of flags, options, remote profiles, and advanced usage, refer to the [ActionDock Documentation Center](../../docs/README.md):
+作为顶层门面，`@actiondock/cli` 串联以下子包：
 
-- [CLI Reference Manual](../../docs/reference/cli.md)
-- [Quick Start Guide](../../docs/developer/quick-start.md)
-- [MCP Integration Guide](../../docs/consumer/use-as-mcp.md)
-- [Standalone Binary Build Guide](../../docs/developer/build-and-export.md)
-- [Agent Skill Usage Guide](../../docs/consumer/use-as-skill.md)
+- 运行时适配：依赖 `@actiondock/runtime-node`，在启动时自动注入基于 Node.js 原生能力的驱动实现。
+- 共享命令集：复用 `@actiondock/runtime-cli` 的命令处理器与标准信封输出渲染器。
+- 构建与打包：调用 `@actiondock/builder` 完成依赖闭包分析与产物装配。
+- 协议服务：通过 `@actiondock/mcp` 与 `@actiondock/core` 启动协议监听。
 
 ---
 
-## License
+## 开源协议
 
-[Apache-2.0](../../LICENSE) © team4u
+本项目采用 Apache-2.0 开源协议。

package/bin/ad.js

@@ -1,4 +1,29 @@
-#!/usr/bin/env bun
-import { main } from "../src/index.js";
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
+const isBun = typeof process.versions.bun !== "undefined";
+
+if (!isBun && !process.env.ACTIONDOCK_TSX_BOOTSTRAPPED) {
+  const hasTsx =
+    process.execArgv.some((arg, i) => arg === "--import" && process.execArgv[i + 1] === "tsx") ||
+    process.execArgv.some((arg) => arg.includes("tsx"));
+  if (!hasTsx) {
+    const res = spawnSync(
+      process.execPath,
+      ["--import", "tsx", fileURLToPath(import.meta.url), ...process.argv.slice(2)],
+      {
+        stdio: "inherit",
+        env: {
+          ...process.env,
+          ACTIONDOCK_TSX_BOOTSTRAPPED: "1",
+        },
+      }
+    );
+    process.exit(res.status ?? (res.signal ? 1 : 0));
+  }
+}
+
+const { main } = await import("../src/index.ts");
 await main(process.argv);
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/cli",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "ActionDock CLI facade for developing, testing, building, and exporting standalone Agent Actions and Skills",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "engines": {
-    "bun": ">=1.2.0"
+    "node": ">=22.12.0"
   },
   "publishConfig": {
     "access": "public",
@@ -28,9 +28,12 @@
     "build": "bun build ./src/index.ts --outdir ./dist --target bun"
   },
   "dependencies": {
-    "@actiondock/core": "^2.0.0",
-    "@actiondock/mcp": "^2.0.0",
-    "@actiondock/sdk": "^2.0.0",
+    "@actiondock/builder": "workspace:*",
+    "@actiondock/core": "workspace:*",
+    "@actiondock/mcp": "workspace:*",
+    "@actiondock/runtime-cli": "workspace:*",
+    "@actiondock/runtime-node": "workspace:*",
+    "@actiondock/sdk": "workspace:*",
     "commander": "^13.1.0"
   },
   "devDependencies": {

package/src/commands/action.ts

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import {
   ActionRunner,
   createStorage,
@@ -11,9 +11,11 @@ import {
   getPackageSlug,
   listLinkedPackages,
   loadActions,
+  loadManifest,
   loadProjectConfig,
   resolveActionProject,
   resolveTarget,
+  saveManifest,
   validateSchema,
 } from "@actiondock/core";
 import { Command } from "commander";
@@ -281,6 +283,35 @@ export default defineAction<Input, Output>({
 `;
 
         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),
+          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(`\nTo run this action:`);
         console.log(`  ad action run ${id} --input '{"exampleParam": "hello"}'`);

package/src/commands/config.ts

@@ -1,11 +1,15 @@
 import {
   createGlobalStorage,
   createStorage,
+  deleteRemoteConfig,
+  fetchRemoteConfig,
   filterWithFallbackInfo,
   isSecretConfigKey,
   loadProjectConfig,
   maskSecretValue,
   resolvePackageRoot,
+  resolveTarget,
+  setRemoteConfig,
   type ConfigItemDefinition,
 } from "@actiondock/core";
 import { Command } from "commander";
@@ -69,18 +73,17 @@ export function registerConfigCommands(program: Command): void {
             resolvedValue = itemDef.default;
             source = "default";
             status = "DEFAULT";
-          } else {
-            status = "MISSING";
           }
 
+          const displayValue = isSecret && resolvedValue !== undefined ? maskSecretValue(resolvedValue) : resolvedValue;
+
           return {
             key,
-            description: itemDef.description || "",
-            secret: isSecret,
-            default: itemDef.default,
+            value: displayValue,
             status,
             source,
-            value: isSecret && resolvedValue !== undefined ? maskSecretValue(resolvedValue) : resolvedValue,
+            secret: isSecret,
+            description: itemDef.description || "",
             required: itemDef.default === undefined,
           };
         });
@@ -141,16 +144,45 @@ export function registerConfigCommands(program: Command): void {
     .description("List configuration entries (Global & Project)")
     .option("-P, --package <id>", "Target package ID or path")
     .option("-g, --global", "Show only global configurations")
+    .option("-p, --profile <name>", "Query config on a remote target")
+    .option("-s, --server <url>", "Remote server URL")
+    .option("-t, --token <token>", "Auth token for remote server")
     .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 secrets")
     .option("--no-fallback", "Disable fallback to full list when no items match intent")
     .option("--json", "Output as JSON")
-    .action((patterns, options) => {
+    .action(async (patterns, options) => {
       try {
         const effectiveIntent = resolveIntent(options.intent, patterns);
         const shouldFallback = options.fallback !== false;
         const reveal = options.reveal || options.showSecrets;
 
+        const target = resolveTarget({
+          profile: options.profile,
+          server: options.server,
+          token: options.token,
+        });
+
+        if (target.type === "remote") {
+          const res = await fetchRemoteConfig(target.serverUrl!, target.token, options.package);
+          if (options.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+          }
+          console.log(
+            `Config on remote server ${target.serverUrl}${target.profileName ? ` (Profile: ${target.profileName})` : ""}:\n`
+          );
+          const entries = Object.entries(res.values || {});
+          if (entries.length === 0) {
+            console.log("  (No config entries stored)");
+          } else {
+            for (const [k, v] of entries) {
+              console.log(`  ${k.padEnd(24)} = ${JSON.stringify(v)}`);
+            }
+          }
+          return;
+        }
+
         const globalStorage = createGlobalStorage();
         const globalConfig = globalStorage.listConfig();
 
@@ -246,10 +278,30 @@ export function registerConfigCommands(program: Command): void {
     .description("Get a configuration value")
     .option("-P, --package <id>", "Target package ID or path")
     .option("-g, --global", "Get from global configuration only")
+    .option("-p, --profile <name>", "Query config on a remote target")
+    .option("-s, --server <url>", "Remote server URL")
+    .option("-t, --token <token>", "Auth token for remote server")
     .option("--reveal, --show-secrets", "Reveal plain text value for secret")
     .option("--json", "Output as JSON")
-    .action((key, options) => {
+    .action(async (key, options) => {
       try {
+        const target = resolveTarget({
+          profile: options.profile,
+          server: options.server,
+          token: options.token,
+        });
+
+        if (target.type === "remote") {
+          const res = await fetchRemoteConfig(target.serverUrl!, target.token, options.package);
+          const val = res.values?.[key];
+          if (options.json) {
+            console.log(JSON.stringify({ key, value: val }, null, 2));
+          } else {
+            console.log(val !== undefined ? JSON.stringify(val) : "undefined");
+          }
+          return;
+        }
+
         const reveal = options.reveal || options.showSecrets;
         const globalStorage = createGlobalStorage();
         const globalVal = globalStorage.getConfig(key);
@@ -326,7 +378,10 @@ export function registerConfigCommands(program: Command): void {
     .description("Set a configuration value (Global by default outside project, or use -g for global)")
     .option("-P, --package <id>", "Target package ID or path")
     .option("-g, --global", "Set globally across all packages")
-    .action((key, rawValue, options) => {
+    .option("-p, --profile <name>", "Set config on a remote target")
+    .option("-s, --server <url>", "Remote server URL")
+    .option("-t, --token <token>", "Auth token for remote server")
+    .action(async (key, rawValue, options) => {
       try {
         let parsed: unknown = rawValue;
         try {
@@ -335,6 +390,18 @@ export function registerConfigCommands(program: Command): void {
           parsed = rawValue;
         }
 
+        const target = resolveTarget({
+          profile: options.profile,
+          server: options.server,
+          token: options.token,
+        });
+
+        if (target.type === "remote") {
+          await setRemoteConfig(target.serverUrl!, key, parsed, target.token, options.package);
+          console.log(`[OK] Remote config '${key}' updated on ${target.serverUrl}`);
+          return;
+        }
+
         const projectRoot = !options.global ? resolvePackageRoot(options.package) : null;
         const isSecret = isSecretConfigKey(key);
         const displayVal = isSecret ? maskSecretValue(parsed) : JSON.stringify(parsed);
@@ -366,8 +433,27 @@ export function registerConfigCommands(program: Command): void {
     .description("Delete a configuration value")
     .option("-P, --package <id>", "Target package ID or path")
     .option("-g, --global", "Delete from global configuration")
-    .action((key, options) => {
+    .option("-p, --profile <name>", "Delete config on a remote target")
+    .option("-s, --server <url>", "Remote server URL")
+    .option("-t, --token <token>", "Auth token for remote server")
+    .action(async (key, options) => {
       try {
+        const target = resolveTarget({
+          profile: options.profile,
+          server: options.server,
+          token: options.token,
+        });
+
+        if (target.type === "remote") {
+          const res = await deleteRemoteConfig(target.serverUrl!, key, target.token, options.package);
+          if (res.deleted) {
+            console.log(`[OK] Remote config '${key}' deleted from ${target.serverUrl}`);
+          } else {
+            console.log(`Remote config '${key}' not found on ${target.serverUrl}`);
+          }
+          return;
+        }
+
         const projectRoot = !options.global ? resolvePackageRoot(options.package) : null;
 
         if (options.global || !projectRoot) {

package/src/commands/doctor.ts

@@ -1,4 +1,4 @@
-import { runDoctorChecks } from "@actiondock/core";
+import { fetchRemoteDoctor, resolveTarget, runDoctorChecks } from "@actiondock/core";
 import { Command } from "commander";
 
 export function registerDoctorCommand(program: Command): void {
@@ -6,13 +6,28 @@ export function registerDoctorCommand(program: Command): void {
     .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")
     .action(async (options) => {
       try {
-        const report = await runDoctorChecks({
-          packageIdOrPath: options.package,
+        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,
+          });
+        }
+
         if (options.json) {
           console.log(JSON.stringify(report, null, 2));
           if (!report.ok) {
@@ -21,11 +36,14 @@ export function registerDoctorCommand(program: Command): void {
           return;
         }
 
-        console.log("[DOCTOR] ActionDock System & Project Diagnostics\n");
+        const title = target.type === "remote"
+          ? `[DOCTOR] Remote ActionDock Server Diagnostics (${target.serverUrl}${target.profileName ? ` - Profile: ${target.profileName}` : ""})\n`
+          : "[DOCTOR] ActionDock System & Project Diagnostics\n";
+        console.log(title);
 
         // 1. Runtime & Environment Group
         console.log("[Runtime & Environment]");
-        const envChecks = report.checks.filter((c) => c.category === "runtime" || c.category === "storage" || c.category === "registry");
+        const envChecks = (report.checks || []).filter((c: any) => 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]";
           console.log(`  ${tag} ${c.name}: ${c.message}`);
@@ -37,7 +55,7 @@ export function registerDoctorCommand(program: Command): void {
         // 2. Project Group
         if (report.hasProject) {
           console.log(`\n[Project: ${report.packageId || "unknown"}] (${report.projectRoot})`);
-          const projChecks = report.checks.filter((c) => c.category === "project");
+          const projChecks = (report.checks || []).filter((c: any) => c.category === "project");
           for (const c of projChecks) {
             const tag = c.status === "ok" ? "[OK]" : c.status === "warn" ? "[WARN]" : "[ERROR]";
             console.log(`  ${tag} ${c.name}: ${c.message}`);

package/src/commands/index.ts

@@ -21,7 +21,7 @@ export function createCliProgram(): Command {
   program
     .name("ad")
     .description("ActionDock (ad) 2.0 - Toolchain for building and shipping standalone AI Agent Actions & Skills")
-    .version("2.0.1");
+    .version("2.0.3");
 
   registerInitCommand(program);
   registerInfoCommand(program);