@actiondock/cli 2.0.2 → 2.0.4

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.2",
+  "version": "2.0.4",
   "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,8 +28,11 @@
     "build": "bun build ./src/index.ts --outdir ./dist --target bun"
   },
   "dependencies": {
+    "@actiondock/builder": "^2.0.0",
     "@actiondock/core": "^2.0.0",
     "@actiondock/mcp": "^2.0.0",
+    "@actiondock/runtime-cli": "^2.0.0",
+    "@actiondock/runtime-node": "^2.0.0",
     "@actiondock/sdk": "^2.0.0",
     "commander": "^13.1.0"
   },

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/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.2");
+    .version("2.0.4");
 
   registerInitCommand(program);
   registerInfoCommand(program);

package/src/commands/playbook.ts

@@ -7,8 +7,10 @@ import {
   findProjectRoot,
   listLinkedPackages,
   loadActions,
+  loadManifest,
   loadPlaybooks,
   loadProjectConfig,
+  resolveActionProject,
   resolvePlaybookProject,
   resolveTarget,
 } from "@actiondock/core";
@@ -368,7 +370,18 @@ This playbook provides task execution guidance for AI Agents.
 
         for (const target of targets) {
           const config = loadProjectConfig(target.root);
-          const actions = await loadActions(target.root, config.actionsDir);
+          let actionIds = new Set<string>();
+          const manifest = loadManifest(target.root);
+          if (manifest?.actions) {
+            actionIds = new Set(Object.keys(manifest.actions));
+          } else {
+            try {
+              const actions = await loadActions(target.root, config.actionsDir, { autoInstall: false });
+              actionIds = new Set(actions.keys());
+            } catch {
+              // Ignore action loading failure during validation
+            }
+          }
 
           for (const pb of target.playbooks) {
             if (!pb) continue;
@@ -380,8 +393,13 @@ This playbook provides task execution guidance for AI Agents.
 
             if (pb.actions) {
               for (const actId of pb.actions) {
-                if (!actions.has(actId)) {
-                  warnings.push(`Referenced action '${actId}' not found in package '${target.packageId}'`);
+                if (actionIds.has(actId)) {
+                  continue;
+                }
+                try {
+                  await resolveActionProject(actId, target.root);
+                } catch (err: any) {
+                  warnings.push(err.message);
                 }
               }
             }

package/src/commands/profile.ts

@@ -235,7 +235,7 @@ export function registerProfileCommands(program: Command): void {
           if (options.json) {
             console.log(JSON.stringify({ ok: true, type: "local", message: "Local execution" }, null, 2));
           } else {
-            console.log(`Target profile '${target.profileName || "local"}' is local (runs in local Bun runtime).`);
+            console.log(`Target profile '${target.profileName || "local"}' is local (runs in local runtime).`);
           }
           return;
         }

package/src/commands/test.ts

@@ -1,26 +1,48 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import { findProjectRoot } from "@actiondock/core";
 import { Command } from "commander";
 
 export function registerTestCommand(program: Command): void {
   program
     .command("test [pattern]")
-    .description("Run project tests using Bun test runner")
+    .description("Run project tests using configured test runner (node:test or bun test)")
     .action((pattern) => {
       const root = findProjectRoot();
       const cwd = root || process.cwd();
 
-      const args = ["bun", "test"];
+      const pkgJsonPath = join(cwd, "package.json");
+      let testCmd = "npm";
+      let testArgs = ["test"];
+
+      if (existsSync(pkgJsonPath)) {
+        try {
+          const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+          if (pkg.scripts?.test?.includes("bun test") && typeof (globalThis as any).Bun !== "undefined") {
+            testCmd = "bun";
+            testArgs = ["test"];
+          }
+        } catch {
+          // ignore
+        }
+      }
+
       if (pattern) {
-        args.push(pattern);
+        if (testCmd === "npm") {
+          testArgs.push("--", pattern);
+        } else {
+          testArgs.push(pattern);
+        }
       }
 
-      const proc = Bun.spawnSync(args, {
+      const proc = spawnSync(testCmd, testArgs, {
         cwd,
-        stdio: ["inherit", "inherit", "inherit"],
+        stdio: "inherit",
       });
 
-      if (proc.exitCode !== 0) {
-        process.exit(proc.exitCode ?? 1);
+      if (proc.status !== 0) {
+        process.exit(proc.status ?? 1);
       }
     });
 }

package/src/index.ts

@@ -1,18 +1,20 @@
-export * from "./commands";
-
+import { setupNodeRuntime } from "@actiondock/runtime-node";
 import { createCliProgram } from "./commands";
 
+export * from "./commands";
+
 /**
  * ActionDock CLI 主执行入口函数。
  * 
  * @param argv 命令行参数数组（默认使用 process.argv）
  */
 export async function main(argv: string[] = process.argv): Promise<void> {
+  setupNodeRuntime();
   const program = createCliProgram();
   await program.parseAsync(argv);
 }
 
-if (import.meta.main) {
+if ((import.meta as any).main) {
   main().catch((err) => {
     console.error("Fatal error:", err);
     process.exit(1);