@actiondock/cli 2.0.11 → 2.2.0

package/src/commands/state.ts

@@ -1,590 +0,0 @@
-import { existsSync } from "node:fs";
-import {
-  clearRemoteState,
-  createStorage,
-  deleteRemoteStateKey,
-  fetchRemoteStateList,
-  filterWithFallbackInfo,
-  findProjectRoot,
-  getRemoteStateKey,
-  listLinkedPackages,
-  loadProjectConfig,
-  resolvePackageRoot,
-  resolveTarget,
-  setRemoteStateKey,
-} from "@actiondock/core";
-import { ArgumentError, ExecutionError, getEffectiveOptions, renderResult } from "@actiondock/runtime-cli";
-import { Command } from "commander";
-import { resolveIntent } from "../utils/filter";
-
-function getTargetRoot(packageOption?: string, keyHint?: string): { root: string; key: string } {
-  let targetPackage = packageOption;
-  let effectiveKey = keyHint || "";
-
-  if (!targetPackage && keyHint) {
-    if (keyHint.includes("/")) {
-      const slashIdx = keyHint.indexOf("/");
-      targetPackage = keyHint.slice(0, slashIdx);
-      effectiveKey = keyHint.slice(slashIdx + 1);
-    }
-  }
-
-  const root = resolvePackageRoot(targetPackage);
-  if (!root) {
-    if (targetPackage) {
-      throw new ArgumentError(`Package '${targetPackage}' not found in linked packages or path`);
-    }
-    throw new ArgumentError(
-      "Not in an ActionDock project (actiondock.json not found).\nPlease specify -P, --package <id> or cd into a project directory."
-    );
-  }
-  return { root, key: effectiveKey };
-}
-
-export function registerStateCommands(program: Command): void {
-  const stateCmd = program
-    .command("state")
-    .description("Inspect and manage Shared State store");
-
-  // state list
-  stateCmd
-    .command("list [prefix]")
-    .description("List state keys matching prefix, namespace, or intent pattern (in current project or linked packages)")
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("-n, --namespace <ns>", "Filter by specific namespace")
-    .option("-p, --profile <name>", "Query state 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("--no-fallback", "Disable fallback to full list when no items match intent")
-    .option("-d, --detail", "Show detailed state entry objects (including namespace, expiration, update time)")
-    .option("--data-dir <path>", "Custom database storage directory")
-    .option("--json", "Output as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .action(async (prefix = "", rawOptions, cmd) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const effectiveIntent = resolveIntent(options.intent, prefix ? [prefix] : []);
-        const shouldFallback = options.fallback !== false;
-        const isMachine = Boolean(options.json || options.envelope);
-
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        if (target.type === "remote") {
-          const res = await fetchRemoteStateList(target.serverUrl!, target.token, {
-            package: options.package,
-            namespace: options.namespace,
-            prefix,
-          });
-          if (isMachine) {
-            renderResult(res.keys, { json: options.json, envelope: options.envelope });
-            return;
-          }
-          console.log(
-            `State keys on remote server ${target.serverUrl}${target.profileName ? ` (Profile: ${target.profileName})` : ""} (${res.keys.length}):\n`
-          );
-          for (const k of res.keys) {
-            console.log(`  - ${k}`);
-          }
-          return;
-        }
-
-        const targetRoot = options.package
-          ? resolvePackageRoot(options.package)
-          : findProjectRoot();
-
-        if (options.package && !targetRoot) {
-          throw new ArgumentError(`Package '${options.package}' not found in linked packages or path`);
-        }
-
-        if (targetRoot) {
-          const projConfig = loadProjectConfig(targetRoot);
-          const storage = createStorage(projConfig.id, {
-            projectRoot: targetRoot,
-            dataDir: options.dataDir,
-          });
-
-          if (options.detail && isMachine) {
-            const entries = await storage.listStateEntries({
-              namespace: options.namespace,
-              prefix: prefix || undefined,
-            });
-            storage.close();
-
-            const filterRes = filterWithFallbackInfo(
-              entries,
-              effectiveIntent,
-              [(e) => e.fullKey, (e) => e.key, (e) => e.namespace],
-              shouldFallback
-            );
-
-            renderResult(filterRes.items, { json: options.json, envelope: options.envelope });
-            return;
-          }
-
-          const allKeys = await storage.listStateKeys(
-            options.namespace !== undefined ? options.namespace : null,
-            prefix
-          );
-          storage.close();
-
-          const filterRes = filterWithFallbackInfo(
-            allKeys,
-            effectiveIntent,
-            [(k) => k],
-            shouldFallback
-          );
-
-          if (isMachine) {
-            renderResult(filterRes.items, { json: options.json, envelope: options.envelope });
-          } else {
-            const nsDesc = options.namespace ? ` [namespace: ${options.namespace}]` : "";
-            const filterDesc = prefix ? ` (filter: ${prefix})` : "";
-            console.log(`State keys for ${projConfig.id} (${targetRoot})${nsDesc}${filterDesc}:\n`);
-            if (filterRes.isFallback && effectiveIntent) {
-              console.log(`(No state keys matched intent '${effectiveIntent}', showing all keys)\n`);
-            }
-            if (filterRes.items.length === 0) {
-              console.log("  (no state keys found)\n");
-            } else {
-              for (const k of filterRes.items) {
-                console.log(`  - ${k}`);
-              }
-            }
-          }
-          return;
-        }
-
-        // Outside project: list state keys across all linked packages
-        const linkedList = listLinkedPackages();
-        if (linkedList.length === 0) {
-          if (isMachine) {
-            renderResult([], { json: options.json, envelope: options.envelope });
-            return;
-          }
-          console.log("No ActionDock project in current directory, and no packages linked.");
-          console.log("Run 'ad link' inside an Action package to register it.");
-          return;
-        }
-
-        const aggregated: Array<{
-          packageId: string;
-          packageName: string;
-          path: string;
-          keys: string[];
-          entries?: any[];
-        }> = [];
-
-        for (const pkg of linkedList) {
-          if (!existsSync(pkg.path)) continue;
-          try {
-            const projConfig = loadProjectConfig(pkg.path);
-            const storage = createStorage(projConfig.id, {
-              projectRoot: pkg.path,
-              dataDir: options.dataDir,
-            });
-
-            if (options.detail && isMachine) {
-              const entries = await storage.listStateEntries({
-                namespace: options.namespace,
-                prefix: prefix || undefined,
-              });
-              storage.close();
-              aggregated.push({
-                packageId: pkg.id,
-                packageName: pkg.name,
-                path: pkg.path,
-                keys: entries.map((e) => e.fullKey),
-                entries,
-              });
-            } else {
-              const keys = await storage.listStateKeys(
-                options.namespace !== undefined ? options.namespace : null,
-                prefix
-              );
-              storage.close();
-              aggregated.push({
-                packageId: pkg.id,
-                packageName: pkg.name,
-                path: pkg.path,
-                keys,
-              });
-            }
-          } catch {
-            // Ignore broken linked package
-          }
-        }
-
-        let filteredPackages: typeof aggregated = [];
-        if (!effectiveIntent) {
-          filteredPackages = aggregated;
-        } else {
-          for (const pkg of aggregated) {
-            const pkgMatches = filterWithFallbackInfo(
-              [pkg],
-              effectiveIntent,
-              [(p) => p.packageId, (p) => p.packageName, (p) => p.path],
-              false
-            ).matchedCount > 0;
-
-            if (pkgMatches) {
-              filteredPackages.push(pkg);
-            } else {
-              const matchedKeys = filterWithFallbackInfo(
-                pkg.keys,
-                effectiveIntent,
-                [(k) => k],
-                false
-              ).items;
-
-              if (matchedKeys.length > 0) {
-                filteredPackages.push({
-                  ...pkg,
-                  keys: matchedKeys,
-                });
-              }
-            }
-          }
-
-          if (filteredPackages.length === 0 && shouldFallback) {
-            filteredPackages = aggregated;
-          }
-        }
-
-        if (isMachine) {
-          renderResult(filteredPackages, { json: options.json, envelope: options.envelope });
-        } else {
-          console.log("State Keys in Linked Packages:\n");
-          for (const pkg of filteredPackages) {
-            console.log(`* Package: ${pkg.packageId} (${pkg.path})`);
-            if (pkg.keys.length === 0) {
-              console.log("    (no state keys found)");
-            } else {
-              for (const k of pkg.keys) {
-                console.log(`    - ${k}`);
-              }
-            }
-          }
-        }
-      } catch (err: any) {
-        if (err instanceof ArgumentError || err instanceof ExecutionError) throw err;
-        throw new ExecutionError(err.message);
-      }
-    });
-
-  // state get
-  stateCmd
-    .command("get <key>")
-    .description("Get a state value by key, namespace:key, or package/namespace:key")
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("-n, --namespace <ns>", "Target namespace")
-    .option("-p, --profile <name>", "Query state on a remote target")
-    .option("-s, --server <url>", "Remote server URL")
-    .option("-t, --token <token>", "Auth token for remote server")
-    .option("--data-dir <path>", "Custom database storage directory")
-    .option("--json", "Output as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .action(async (rawKey, rawOptions, cmd) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const isMachine = Boolean(options.json || options.envelope);
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        if (target.type === "remote") {
-          const res = await getRemoteStateKey(target.serverUrl!, rawKey, target.token, {
-            package: options.package,
-            namespace: options.namespace,
-          });
-          if (isMachine) {
-            renderResult(res, { json: options.json, envelope: options.envelope });
-          } else {
-            console.log(res.value !== undefined ? JSON.stringify(res.value, null, 2) : "undefined");
-          }
-          return;
-        }
-
-        const { root, key } = getTargetRoot(options.package, rawKey);
-        const projConfig = loadProjectConfig(root);
-        const storage = createStorage(projConfig.id, {
-          projectRoot: root,
-          dataDir: options.dataDir,
-        });
-
-        let val: unknown;
-        let entryNamespace = options.namespace || "";
-
-        if (options.namespace !== undefined) {
-          val = await storage.getState(options.namespace, key);
-        } else {
-          const entry = await storage.findState(key);
-          if (entry) {
-            val = entry.value;
-            entryNamespace = entry.namespace;
-          }
-        }
-        storage.close();
-
-        if (val === undefined) {
-          throw new ExecutionError(`State key '${key}' not found in ${projConfig.id}`);
-        }
-
-        if (isMachine) {
-          renderResult(
-            {
-              key,
-              packageId: projConfig.id,
-              namespace: entryNamespace,
-              value: val,
-            },
-            { json: options.json, envelope: options.envelope }
-          );
-        } else {
-          console.log(val !== undefined ? JSON.stringify(val, null, 2) : "undefined");
-        }
-      } catch (err: any) {
-        if (err instanceof ArgumentError || err instanceof ExecutionError) throw err;
-        throw new ExecutionError(err.message);
-      }
-    });
-
-  // state set
-  stateCmd
-    .command("set <key> <value>")
-    .description("Set a state value by key, namespace:key, or package/namespace:key")
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("-n, --namespace <ns>", "Target namespace")
-    .option("-p, --profile <name>", "Set state on a remote target")
-    .option("-s, --server <url>", "Remote server URL")
-    .option("-t, --token <token>", "Auth token for remote server")
-    .option("--ttl <seconds>", "Time to live in seconds", (v) => parseInt(v, 10))
-    .option("--data-dir <path>", "Custom database storage directory")
-    .option("--json", "Output as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .action(async (rawKey, rawValue, rawOptions, cmd) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const isMachine = Boolean(options.json || options.envelope);
-        let parsed: unknown = rawValue;
-        try {
-          parsed = JSON.parse(rawValue);
-        } catch {
-          parsed = rawValue;
-        }
-
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        if (target.type === "remote") {
-          await setRemoteStateKey(target.serverUrl!, rawKey, parsed, target.token, {
-            package: options.package,
-            namespace: options.namespace,
-            ttl: options.ttl,
-          });
-          if (isMachine) {
-            renderResult(
-              { ok: true, key: rawKey, value: parsed, ttl: options.ttl },
-              { json: options.json, envelope: options.envelope }
-            );
-          } else {
-            console.log(`[OK] State '${rawKey}' updated on remote server ${target.serverUrl}`);
-          }
-          return;
-        }
-
-        const { root, key } = getTargetRoot(options.package, rawKey);
-        const projConfig = loadProjectConfig(root);
-        const storage = createStorage(projConfig.id, {
-          projectRoot: root,
-          dataDir: options.dataDir,
-        });
-
-        let ns = "";
-        let actualKey = key;
-
-        if (options.namespace !== undefined) {
-          ns = options.namespace;
-          actualKey = key;
-        } else if (key.includes(":")) {
-          const colonIdx = key.indexOf(":");
-          ns = key.slice(0, colonIdx);
-          actualKey = key.slice(colonIdx + 1);
-        }
-
-        await storage.setState(ns, actualKey, parsed, options.ttl);
-        storage.close();
-
-        const displayKey = ns ? `${ns}:${actualKey}` : actualKey;
-        if (isMachine) {
-          renderResult(
-            {
-              ok: true,
-              key: displayKey,
-              value: parsed,
-              ttl: options.ttl,
-              packageId: projConfig.id,
-            },
-            { json: options.json, envelope: options.envelope }
-          );
-        } else {
-          console.log(
-            `[OK] State '${displayKey}' set to ${JSON.stringify(parsed)}${options.ttl ? ` (TTL: ${options.ttl}s)` : ""} in ${projConfig.id}`
-          );
-        }
-      } catch (err: any) {
-        if (err instanceof ArgumentError || err instanceof ExecutionError) throw err;
-        throw new ExecutionError(err.message);
-      }
-    });
-
-  // state delete
-  stateCmd
-    .command("delete <key>")
-    .alias("rm")
-    .description("Delete a state value by key, namespace:key, or package/namespace:key")
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("-n, --namespace <ns>", "Target namespace")
-    .option("-p, --profile <name>", "Delete state on a remote target")
-    .option("-s, --server <url>", "Remote server URL")
-    .option("-t, --token <token>", "Auth token for remote server")
-    .option("--silent", "Do not exit with error if key is not found")
-    .option("--data-dir <path>", "Custom database storage directory")
-    .option("--json", "Output as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .action(async (rawKey, rawOptions, cmd) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const isMachine = Boolean(options.json || options.envelope);
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        if (target.type === "remote") {
-          await deleteRemoteStateKey(target.serverUrl!, rawKey, target.token, {
-            package: options.package,
-            namespace: options.namespace,
-          });
-          if (isMachine) {
-            renderResult({ ok: true, key: rawKey }, { json: options.json, envelope: options.envelope });
-          } else {
-            console.log(`[OK] State '${rawKey}' deleted from remote server ${target.serverUrl}`);
-          }
-          return;
-        }
-
-        const { root, key } = getTargetRoot(options.package, rawKey);
-        const projConfig = loadProjectConfig(root);
-        const storage = createStorage(projConfig.id, {
-          projectRoot: root,
-          dataDir: options.dataDir,
-        });
-        const deleted = await storage.deleteStateSmart(key, options.namespace);
-        storage.close();
-
-        if (deleted) {
-          if (isMachine) {
-            renderResult({ ok: true, key, deleted: true, packageId: projConfig.id }, { json: options.json, envelope: options.envelope });
-          } else {
-            console.log(`[OK] State '${key}' deleted from ${projConfig.id}`);
-          }
-        } else {
-          if (!options.silent) {
-            throw new ExecutionError(`State key '${key}' not found in ${projConfig.id}`);
-          }
-          if (isMachine) {
-            renderResult({ ok: true, key, deleted: false, packageId: projConfig.id }, { json: options.json, envelope: options.envelope });
-          }
-        }
-      } catch (err: any) {
-        if (err instanceof ArgumentError || err instanceof ExecutionError) throw err;
-        throw new ExecutionError(err.message);
-      }
-    });
-
-  // state clear
-  stateCmd
-    .command("clear [prefix]")
-    .alias("clean")
-    .description("Clear state entries by namespace, prefix, or all")
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("-n, --namespace <ns>", "Target namespace to clear")
-    .option("-p, --profile <name>", "Clear state on a remote target")
-    .option("-s, --server <url>", "Remote server URL")
-    .option("-t, --token <token>", "Auth token for remote server")
-    .option("-a, --all", "Clear all state entries across all namespaces in this package")
-    .option("--data-dir <path>", "Custom database storage directory")
-    .option("--json", "Output as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .action(async (prefix = "", rawOptions, cmd) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const isMachine = Boolean(options.json || options.envelope);
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        if (target.type === "remote") {
-          const res = await clearRemoteState(target.serverUrl!, target.token, {
-            package: options.package,
-            namespace: options.namespace,
-            prefix,
-            all: Boolean(options.all),
-          });
-          if (isMachine) {
-            renderResult(res, { json: options.json, envelope: options.envelope });
-          } else {
-            console.log(`[OK] Cleared ${res.clearedCount} state entry(s) on remote server ${target.serverUrl}`);
-          }
-          return;
-        }
-
-        const { root } = getTargetRoot(options.package);
-        const projConfig = loadProjectConfig(root);
-        const storage = createStorage(projConfig.id, {
-          projectRoot: root,
-          dataDir: options.dataDir,
-        });
-        const count = await storage.clearState({
-          namespace: options.namespace,
-          all: options.all,
-          prefix: prefix || undefined,
-        });
-        storage.close();
-
-        const scopeDesc = options.all
-          ? "all namespaces"
-          : options.namespace
-            ? `namespace '${options.namespace}'`
-            : prefix
-              ? `prefix '${prefix}'`
-              : "root namespace";
-
-        if (isMachine) {
-          renderResult(
-            { ok: true, clearedCount: count, scope: scopeDesc, packageId: projConfig.id },
-            { json: options.json, envelope: options.envelope }
-          );
-        } else {
-          console.log(`[OK] Cleared ${count} state entry(s) (${scopeDesc}) from ${projConfig.id}`);
-        }
-      } catch (err: any) {
-        if (err instanceof ArgumentError || err instanceof ExecutionError) throw err;
-        throw new ExecutionError(err.message);
-      }
-    });
-}
-

package/src/commands/test.ts

@@ -1,48 +0,0 @@
-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 configured test runner (node:test or bun test)")
-    .action((pattern) => {
-      const root = findProjectRoot();
-      const cwd = root || process.cwd();
-
-      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) {
-        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;
-      }
-    });
-}

package/src/index.ts

@@ -1,58 +0,0 @@
-import { formatError } from "@actiondock/runtime-cli";
-import { setupNodeRuntime } from "@actiondock/runtime-node";
-import { CommanderError } from "commander";
-import { createCliProgram } from "./commands";
-
-export * from "./commands";
-
-/**
- * ActionDock CLI 主执行入口函数。
- * 
- * @param argv 命令行参数数组（默认使用 process.argv）
- * @returns 进程退出码
- */
-export async function main(argv: string[] = process.argv): Promise<number> {
-  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: unknown) {
-    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;
-  }
-}
-
-if ((import.meta as any).main) {
-  main().catch((err) => {
-    console.error("Fatal error:", err);
-    process.exitCode = 1;
-  });
-}
-

package/src/utils/bytes.ts

@@ -1,2 +0,0 @@
-export { parseByteSize } from "@actiondock/runtime-cli";
-

package/src/utils/filter.ts

@@ -1,2 +0,0 @@
-export { resolveIntent } from "@actiondock/runtime-cli";
-