@actiondock/cli 2.0.0 → 2.0.2

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.2",
   "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

@@ -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";
@@ -28,7 +32,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);
         }
@@ -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,
           };
         });
@@ -123,7 +126,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.");
@@ -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

@@ -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.2");
 
   registerInitCommand(program);
   registerInfoCommand(program);