@actiondock/cli 2.0.0 → 2.0.1

package/README.md

@@ -6,20 +6,19 @@ The official Command Line Interface (CLI) toolchain for ActionDock 2.0.
 [![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 is required.  
-> *(ActionDock CLI relies natively on Bun. Even if you install via `npm install -g @actiondock/cli`, Bun must be installed on your machine as the executable shebang runs via `#!/usr/bin/env bun`.)*
+> **Runtime requirement**: [Bun](https://bun.sh/) >= 1.2.0.
 
-`@actiondock/cli` provides the `ac` command to develop, test, build, deploy, and export AI Agent Actions and Skills across MCP, HTTP, CLI, and standalone executables.
+`@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.
 
 ---
 
 ## Installation
 
 ```bash
-# Global installation via Bun
-bun add -g @actiondock/cli
+# 1. Install Bun runtime (if not already installed)
+npm install -g bun
 
-# Or via npm
+# 2. Install ActionDock CLI
 npm install -g @actiondock/cli
 ```
 
@@ -29,20 +28,20 @@ npm install -g @actiondock/cli
 
 ```bash
 # 1. Initialize a new Action package scaffold
-ac init my-tools
+ad init my-tools
 cd my-tools
 
 # 2. Run an Action locally (outputs standard JSON envelope)
-ac run sample.greet --input '{"name": "Alice"}'
+ad run sample.greet --input '{"name": "Alice"}'
 
 # 3. Run in-memory unit tests
-ac test
+ad test
 
 # 4. Compile into a single standalone binary
-ac build
+ad build
 
 # 5. Export as a portable Agent Skill (with SOPs)
-ac export skill
+ad export skill
 ```
 
 ---
@@ -51,35 +50,35 @@ ac export skill
 
 | Command | Purpose |
 |---|---|
-| `ac init [dir]` | Initialize an Action package scaffold |
-| `ac info [patterns...]` | Explore capabilities and display metadata (supports fuzzy matching and `--tree`) |
-| `ac doctor` | Run environment, global registry health, and project diagnostics |
-| `ac action list` / `ac run <id>` | List and execute Actions |
-| `ac playbook list` / `show` | Inspect agent task SOP Playbooks |
-| `ac config list` / `get` / `set` | Manage runtime configurations |
-| `ac state list` / `get` / `set` / `delete` / `clear` | Inspect and manage persistent state (with namespaces, TTL, and clear) |
-| `ac runs list` / `show` | Inspect execution history and traces |
-| `ac test` | Run fast unit tests |
-| `ac build` | Compile into a zero-dependency standalone binary |
-| `ac export skill` | Export Skill bundle for AI Agent platforms |
-| `ac link` / `unlink` | Manage global router (with live subproject auto-discovery and prune) |
-| `ac profile` / `ac serve` | Manage remote node profiles and start HTTP Runner |
-| `ac mcp` | Start ActionDock as STDIO or HTTP MCP server |
+| `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 |
 
 ---
 
 ## 📖 Complete Documentation
 
-For the full list of flags, options, remote profiles, and advanced usage, refer to the [ActionDock Documentation Center](https://github.com/team4u/actiondock#readme):
+For the full list of flags, options, remote profiles, and advanced usage, refer to the [ActionDock Documentation Center](../../docs/README.md):
 
-- [CLI Reference Manual](https://github.com/team4u/actiondock/blob/main/docs/reference/cli.md)
-- [Quick Start Guide](https://github.com/team4u/actiondock/blob/main/docs/getting-started/quick-start.md)
-- [MCP Integration Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/mcp.md)
-- [Standalone Binary Build Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/standalone-build.md)
-- [Skill Export Guide](https://github.com/team4u/actiondock/blob/main/docs/guides/skill-export.md)
+- [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)
 
 ---
 
 ## License
 
-[Apache-2.0](LICENSE) © team4u
+[Apache-2.0](../../LICENSE) © team4u

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@actiondock/cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "ActionDock CLI facade for developing, testing, building, and exporting standalone Agent Actions and Skills",
   "type": "module",
   "bin": {
-    "ac": "./bin/ac.js"
+    "ad": "./bin/ad.js",
+    "actiondock": "./bin/ad.js"
   },
   "main": "./src/index.ts",
   "module": "./src/index.ts",
@@ -36,7 +37,7 @@
     "@types/bun": "latest",
     "typescript": "^5.7.0"
   },
-  "keywords": ["actiondock", "ac", "agent", "cli", "skill", "builder", "mcp"],
+  "keywords": ["actiondock", "ad", "agent", "cli", "skill", "builder", "mcp"],
   "author": "team4u",
   "license": "Apache-2.0",
   "repository": {

package/src/commands/action.ts

@@ -113,7 +113,7 @@ export function registerActionCommands(program: Command): void {
           const linkedList = listLinkedPackages();
           if (linkedList.length === 0) {
             console.log("No ActionDock project in current directory, and no packages linked.");
-            console.log("Run 'ac link' inside an Action package to register it.");
+            console.log("Run 'ad link' inside an Action package to register it.");
             return;
           }
 
@@ -283,7 +283,7 @@ export default defineAction<Input, Output>({
         writeFileSync(targetFullFile, template, "utf-8");
         console.log(`[OK] Created Action '${id}' at ${targetFullFile}`);
         console.log(`\nTo run this action:`);
-        console.log(`  ac action run ${id} --input '{"exampleParam": "hello"}'`);
+        console.log(`  ad action run ${id} --input '{"exampleParam": "hello"}'`);
       } catch (err: any) {
         console.error(`Error: ${err.message}`);
         process.exit(1);
@@ -454,10 +454,10 @@ export default defineAction<Input, Output>({
       await executeAction(id, options);
     });
 
-  // Root level alias: ac run <id>
+  // Root level alias: ad run <id>
   program
     .command("run <id>")
-    .description("Alias for 'ac action run <id>'")
+    .description("Alias for 'ad action run <id>'")
     .option("-i, --input <json>", "Input as JSON string")
     .option("-f, --input-file <path>", "Input from JSON file")
     .option("-c, --config <key=value...>", "Temporary config override")
@@ -551,7 +551,7 @@ async function executeAction(id: string, options: any): Promise<void> {
     // Local execution
     if (options.async) {
       console.error(
-        "Error: Async execution requires a long-running ActionDock server.\nUse --profile, --server, or start `ac serve`."
+        "Error: Async execution requires a long-running ActionDock server.\nUse --profile, --server, or start `ad serve`."
       );
       process.exit(1);
     }

package/src/commands/config.ts

@@ -28,7 +28,7 @@ export function registerConfigCommands(program: Command): void {
         const root = resolvePackageRoot(identifier || options.package);
         if (!root) {
           console.error(
-            "Error: Not in an ActionDock project.\nUsage: ac config schema [package-id] or cd into a project directory."
+            "Error: Not in an ActionDock project.\nUsage: ad config schema [package-id] or cd into a project directory."
           );
           process.exit(1);
         }
@@ -123,7 +123,7 @@ export function registerConfigCommands(program: Command): void {
           if (missingRequired.length > 0) {
             console.log(`\n[WARNING] ${missingRequired.length} required config(s) not set:`);
             for (const m of missingRequired) {
-              console.log(`  - ${m.key}: Run 'ac config set ${m.key} <value>' to configure.`);
+              console.log(`  - ${m.key}: Run 'ad config set ${m.key} <value>' to configure.`);
             }
           } else {
             console.log("\n[OK] All configuration dependencies are satisfied.");

package/src/commands/index.ts

@@ -19,9 +19,9 @@ export function createCliProgram(): Command {
   const program = new Command();
 
   program
-    .name("ac")
-    .description("ActionDock (ac) 2.0 - Toolchain for building and shipping standalone AI Agent Actions & Skills")
-    .version("2.0.0");
+    .name("ad")
+    .description("ActionDock (ad) 2.0 - Toolchain for building and shipping standalone AI Agent Actions & Skills")
+    .version("2.0.1");
 
   registerInitCommand(program);
   registerInfoCommand(program);

package/src/commands/info.ts

@@ -122,7 +122,7 @@ function printAggregatedPackages(
   }
   if (options?.showTip !== false) {
     console.log(
-      "Tip: Run 'ac info <package-id>' to view detailed package configuration and schema."
+      "Tip: Run 'ad info <package-id>' to view detailed package configuration and schema."
     );
   }
 }
@@ -133,7 +133,7 @@ function printRegistryTree(status: ReturnType<typeof getRegistryStatus>): void {
 
   if (!hasWorkspaces && !hasPackages) {
     console.log("[INFO] No ActionDock packages or workspaces currently linked.");
-    console.log("       Run 'ac link' inside an Action package or workspace to register it.");
+    console.log("       Run 'ad link' inside an Action package or workspace to register it.");
     return;
   }
 
@@ -165,7 +165,7 @@ function printRegistryTree(status: ReturnType<typeof getRegistryStatus>): void {
 
   console.log(`\n[Summary] Total: ${status.totalPackagesCount} active package(s), ${status.workspaces.length} workspace(s)`);
   if (status.staleCount > 0) {
-    console.log(`[WARN] ${status.staleCount} stale entry/entries detected. Run 'ac unlink --prune' to clean up.`);
+    console.log(`[WARN] ${status.staleCount} stale entry/entries detected. Run 'ad unlink --prune' to clean up.`);
   }
 }
 
@@ -423,7 +423,7 @@ export function registerInfoCommand(program: Command): void {
               "No ActionDock project in current directory, and no packages linked."
             );
             console.log(
-              "Run 'ac link' inside an Action package to register it."
+              "Run 'ad link' inside an Action package to register it."
             );
             return;
           }

package/src/commands/link.ts

@@ -6,7 +6,7 @@ import {
 import { Command } from "commander";
 
 export function registerLinkCommands(program: Command): void {
-  // ac link [path]
+  // ad link [path]
   program
     .command("link [path]")
     .option("-r, --recursive", "Recursively discover and link packages in subdirectories")
@@ -32,7 +32,7 @@ export function registerLinkCommands(program: Command): void {
       }
     });
 
-  // ac unlink [id|path]
+  // ad unlink [id|path]
   program
     .command("unlink [identifier]")
     .option("-p, --prune", "Automatically scan and prune any stale/missing paths from registry")

package/src/commands/playbook.ts

@@ -65,7 +65,7 @@ export function registerPlaybookCommands(program: Command): void {
           const linkedList = listLinkedPackages();
           if (linkedList.length === 0) {
             console.log("No ActionDock project in current directory, and no packages linked.");
-            console.log("Run 'ac link' inside an Action package to register it.");
+            console.log("Run 'ad link' inside an Action package to register it.");
             return;
           }
 

package/src/commands/profile.ts

@@ -20,7 +20,7 @@ export function registerProfileCommands(program: Command): void {
     .command("profile")
     .description("Manage multi-cloud and remote execution profiles");
 
-  // ac profile list
+  // ad profile list
   profileCmd
     .command("list [patterns...]")
     .description("List all configured profiles")
@@ -86,7 +86,7 @@ export function registerProfileCommands(program: Command): void {
             );
           }
           console.log(
-            "\nUse 'ac profile use <name>' to switch or 'ac run <action> --profile <name>' to execute on a specific target."
+            "\nUse 'ad profile use <name>' to switch or 'ad run <action> --profile <name>' to execute on a specific target."
           );
         }
       } catch (err: any) {
@@ -95,7 +95,7 @@ export function registerProfileCommands(program: Command): void {
       }
     });
 
-  // ac profile add <name>
+  // ad profile add <name>
   profileCmd
     .command("add <name>")
     .description("Add or update a remote execution profile")
@@ -123,7 +123,7 @@ export function registerProfileCommands(program: Command): void {
       }
     });
 
-  // ac profile use <name>
+  // ad profile use <name>
   profileCmd
     .command("use <name>")
     .description("Switch active default profile")
@@ -137,7 +137,7 @@ export function registerProfileCommands(program: Command): void {
       }
     });
 
-  // ac profile show [name]
+  // ad profile show [name]
   profileCmd
     .command("show [name]")
     .description("Display details of a profile (defaults to active profile)")
@@ -200,7 +200,7 @@ export function registerProfileCommands(program: Command): void {
       }
     });
 
-  // ac profile rm / remove <name>
+  // ad profile rm / remove <name>
   profileCmd
     .command("rm <name>")
     .alias("remove")
@@ -223,7 +223,7 @@ export function registerProfileCommands(program: Command): void {
       }
     });
 
-  // ac profile test [name]
+  // ad profile test [name]
   profileCmd
     .command("test [name]")
     .description("Test connection latency and health of a profile")

package/src/commands/runs.ts

@@ -107,7 +107,7 @@ export function registerRunsCommands(program: Command): void {
         const linkedList = listLinkedPackages();
         if (linkedList.length === 0) {
           console.log("No ActionDock project in current directory, and no packages linked.");
-          console.log("Run 'ac link' inside an Action package to register it.");
+          console.log("Run 'ad link' inside an Action package to register it.");
           return;
         }
 
@@ -293,7 +293,7 @@ export function registerRunsCommands(program: Command): void {
 
       if (target.type === "local") {
         console.error(
-          "Error: 'ac runs cancel' is only supported for remote execution targets. Use --profile <name> or --server <url>."
+          "Error: 'ad runs cancel' is only supported for remote execution targets. Use --profile <name> or --server <url>."
         );
         process.exit(1);
       }

package/src/commands/serve.ts

@@ -80,7 +80,7 @@ export function registerServeCommand(program: Command): void {
         console.log(`  * Max Body Size:   ${options.maxBody || "1mb"}`);
         console.log(`  * Health Endpoint: http://${host === "0.0.0.0" ? "127.0.0.1" : host}:${server.port}/api/v1/health`);
         console.log(`======================================================\n`);
-        console.log(`Server is ready to accept remote 'ac run' requests.`);
+        console.log(`Server is ready to accept remote 'ad run' requests.`);
         console.log(`Press Ctrl+C to terminate.\n`);
 
         // Keep process running

package/src/commands/state.ts

@@ -124,7 +124,7 @@ export function registerStateCommands(program: Command): void {
         const linkedList = listLinkedPackages();
         if (linkedList.length === 0) {
           console.log("No ActionDock project in current directory, and no packages linked.");
-          console.log("Run 'ac link' inside an Action package to register it.");
+          console.log("Run 'ad link' inside an Action package to register it.");
           return;
         }