@actiondock/cli 2.0.11-beta.0 → 2.0.12

package/src/commands/info.ts

@@ -1,537 +0,0 @@
-import { existsSync } from "node:fs";
-import {
-  fetchRemoteInfo,
-  filterWithFallbackInfo,
-  findProjectRoot,
-  getRegistryStatus,
-  listLinkedPackages,
-  loadManifest,
-  loadPlaybooks,
-  loadProjectConfig,
-  resolvePackageRoot,
-  resolveTarget,
-} from "@actiondock/core";
-import { Command } from "commander";
-import { ArgumentError, CliError, ExecutionError, getEffectiveOptions, renderResult } from "@actiondock/runtime-cli";
-import { resolveIntent } from "../utils/filter";
-
-interface AggregatedPackage {
-  id: string;
-  name: string;
-  version: string;
-  description?: string;
-  path: string;
-  actionsCount: number;
-  playbooksCount: number;
-  actions: string[];
-  playbooks: string[];
-  configDeclared: string[];
-}
-
-async function getProjectDetailInfo(root: string) {
-  const config = loadProjectConfig(root);
-  const manifest = loadManifest(root);
-  const actionsMap = new Map<string, { id: string; description?: string }>();
-  if (manifest?.actions) {
-    for (const [id, item] of Object.entries(manifest.actions)) {
-      actionsMap.set(id, {
-        id,
-        description: item.description,
-      });
-    }
-  }
-  const playbooks = loadPlaybooks(root, config.playbooksDir);
-
-  return {
-    id: config.id,
-    name: config.name,
-    version: config.version,
-    description: config.description,
-    projectRoot: root,
-    actionsDir: config.actionsDir || "actions",
-    playbooksDir: config.playbooksDir || "playbooks",
-    actionsCount: actionsMap.size,
-    playbooksCount: playbooks.size,
-    actions: Array.from(actionsMap.keys()),
-    playbooks: Array.from(playbooks.keys()),
-    configDeclared: config.config ? Object.keys(config.config) : [],
-    configDef: config.config,
-    actionsMap,
-    playbooksMap: playbooks,
-  };
-}
-
-function projectDetailToJson(info: Awaited<ReturnType<typeof getProjectDetailInfo>>) {
-  return {
-    id: info.id,
-    name: info.name,
-    version: info.version,
-    description: info.description,
-    projectRoot: info.projectRoot,
-    actionsDir: info.actionsDir,
-    playbooksDir: info.playbooksDir,
-    actionsCount: info.actionsCount,
-    playbooksCount: info.playbooksCount,
-    actions: info.actions,
-    playbooks: info.playbooks,
-    configDeclared: info.configDeclared,
-  };
-}
-
-function printProjectDetail(info: Awaited<ReturnType<typeof getProjectDetailInfo>>) {
-  console.log(`ActionDock Project: ${info.name} (${info.id})`);
-  console.log(`Version:     ${info.version}`);
-  if (info.description) console.log(`Description: ${info.description}`);
-  console.log(`Root:        ${info.projectRoot}`);
-  console.log(`\nActions (${info.actionsCount}):`);
-  for (const [id, act] of info.actionsMap.entries()) {
-    console.log(`  - ${id.padEnd(28)} ${act.description || ""}`);
-  }
-  console.log(`\nPlaybooks (${info.playbooksCount}):`);
-  for (const [id, pb] of info.playbooksMap.entries()) {
-    console.log(`  - ${id.padEnd(28)} ${pb.description || ""}`);
-  }
-  if (info.configDeclared.length > 0) {
-    console.log(`\nDeclared Config Keys:`);
-    for (const k of info.configDeclared) {
-      const item = info.configDef?.[k];
-      const isSec = item?.secret ? " [secret]" : "";
-      const def =
-        item?.default !== undefined
-          ? ` (default: ${JSON.stringify(item.default)})`
-          : "";
-      console.log(
-        `  - ${k.padEnd(24)} ${item?.description || ""}${def}${isSec}`
-      );
-    }
-  }
-}
-
-function printAggregatedPackages(
-  packages: AggregatedPackage[],
-  options?: { header?: string; showTip?: boolean }
-) {
-  if (options?.header) {
-    console.log(options.header);
-  } else {
-    console.log(`ActionDock Linked Packages (${packages.length}):\n`);
-  }
-  for (const p of packages) {
-    console.log(`* ${p.name} (${p.id}) v${p.version}`);
-    console.log(`  Path:      ${p.path}`);
-    if (p.description) {
-      console.log(`  Desc:      ${p.description}`);
-    }
-    console.log(
-      `  Actions (${p.actionsCount}):   ${p.actions.join(", ") || "(none)"}`
-    );
-    console.log(
-      `  Playbooks (${p.playbooksCount}): ${p.playbooks.join(", ") || "(none)"}`
-    );
-    console.log("");
-  }
-  if (options?.showTip !== false) {
-    console.log(
-      "Tip: Run 'ad info <package-id>' to view detailed package configuration and schema."
-    );
-  }
-}
-
-function printRegistryTree(status: ReturnType<typeof getRegistryStatus>): void {
-  const hasWorkspaces = status.workspaces.length > 0;
-  const hasPackages = status.packages.length > 0;
-
-  if (!hasWorkspaces && !hasPackages) {
-    console.log("[INFO] No ActionDock packages or workspaces currently linked.");
-    console.log("       Run 'ad link' inside an Action package or workspace to register it.");
-    return;
-  }
-
-  console.log("[ActionDock Workspace & Package Tree]\n");
-
-  if (hasWorkspaces) {
-    console.log("Workspaces:");
-    for (const ws of status.workspaces) {
-      const tag = ws.status === "active" ? "[OK]" : "[STALE]";
-      console.log(`  ${tag} ${ws.path} (${ws.packagesCount} package${ws.packagesCount === 1 ? "" : "s"})`);
-      if (ws.children && ws.children.length > 0) {
-        ws.children.forEach((child: any, idx: number) => {
-          const isLast = idx === ws.children!.length - 1;
-          const prefix = isLast ? "    +-- " : "    |-- ";
-          console.log(`${prefix}${child.id} (v${child.version}) -> ${child.path}`);
-        });
-      }
-    }
-  }
-
-  if (hasPackages) {
-    if (hasWorkspaces) console.log("");
-    console.log("Standalone Packages:");
-    for (const pkg of status.packages) {
-      const tag = pkg.status === "active" ? "[OK]" : "[STALE]";
-      console.log(`  ${tag} ${pkg.id} (v${pkg.version || "unknown"}) -> ${pkg.path}`);
-    }
-  }
-
-  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 'ad unlink --prune' to clean up.`);
-  }
-}
-
-export function registerInfoCommand(program: Command): void {
-  program
-    .command("info [patterns...]")
-    .description(
-      "Display information about current project, linked package, or remote target"
-    )
-    .option(
-      "-i, --intent <pattern>",
-      "Regex or fuzzy intent filter; falls back to full list when no match"
-    )
-    .option("-P, --package <id>", "Target package ID or path")
-    .option("--tree", "Display packages in hierarchical tree view grouped by workspace")
-    .option("-p, --profile <name>", "Query against a specific profile")
-    .option("-s, --server <url>", "Remote server URL")
-    .option("-t, --token <token>", "Auth token for remote server")
-    .option("--fallback", "Enable fallback to full list when no items match intent")
-    .option(
-      "--no-fallback",
-      "Disable fallback to full list when no items match intent"
-    )
-    .option("--json", "Output information as JSON")
-    .option("--envelope", "Wrap JSON output in standard envelope")
-    .option("--data-dir <path>", "Custom database storage directory")
-    .action(async (patterns: string[] = [], rawOptions: any, cmd: any) => {
-      try {
-        const options = getEffectiveOptions(rawOptions, cmd);
-        const effectiveIntent = resolveIntent(options.intent, patterns);
-        const isMachine = Boolean(options.json || options.envelope);
-        const fallbackExplicit = options.fallback === true || (Array.isArray(process.argv) && process.argv.includes("--fallback"));
-        const shouldFallback = isMachine ? fallbackExplicit : options.fallback !== false;
-
-        const target = resolveTarget({
-          profile: options.profile,
-          server: options.server,
-          token: options.token,
-        });
-
-        // 1. Remote target handling
-        if (target.type === "remote") {
-          const remoteInfo = await fetchRemoteInfo(
-            target.serverUrl!,
-            target.token,
-            {
-              intent: effectiveIntent,
-              package: options.package,
-              tree: Boolean(options.tree),
-            }
-          );
-
-          if (isMachine) {
-            renderResult(remoteInfo, { json: options.json, envelope: options.envelope });
-            return;
-          }
-
-          console.log(
-            `Remote ActionDock Server: ${target.serverUrl}${target.profileName ? ` (Profile: ${target.profileName})` : ""}\n`
-          );
-
-          // Remote Tree
-          if (remoteInfo.type === "tree" || (options.tree && remoteInfo.workspaces)) {
-            printRegistryTree(remoteInfo);
-            return;
-          }
-
-          // Remote Package Detail
-          if (remoteInfo.type === "package_detail" || (remoteInfo.id && !remoteInfo.packages)) {
-            console.log(`ActionDock Project: ${remoteInfo.name || remoteInfo.id} (${remoteInfo.id})`);
-            console.log(`Version:     ${remoteInfo.version || "unknown"}`);
-            if (remoteInfo.description) console.log(`Description: ${remoteInfo.description}`);
-            if (remoteInfo.path || remoteInfo.projectRoot) {
-              console.log(`Root:        ${remoteInfo.path || remoteInfo.projectRoot}`);
-            }
-
-            const actions = remoteInfo.actionsDetail || remoteInfo.actions || [];
-            console.log(`\nActions (${remoteInfo.actionsCount || actions.length}):`);
-            for (const act of actions) {
-              if (typeof act === "string") {
-                console.log(`  - ${act}`);
-              } else {
-                console.log(`  - ${(act.id || "").padEnd(28)} ${act.description || ""}`);
-              }
-            }
-
-            const playbooks = remoteInfo.playbooksDetail || remoteInfo.playbooks || [];
-            console.log(`\nPlaybooks (${remoteInfo.playbooksCount || playbooks.length}):`);
-            for (const pb of playbooks) {
-              if (typeof pb === "string") {
-                console.log(`  - ${pb}`);
-              } else {
-                console.log(`  - ${(pb.id || "").padEnd(28)} ${pb.description || ""}`);
-              }
-            }
-
-            const declared = remoteInfo.configDeclared || {};
-            const declaredKeys = Object.keys(declared);
-            if (declaredKeys.length > 0) {
-              console.log(`\nDeclared Config Keys:`);
-              for (const k of declaredKeys) {
-                const item = declared[k];
-                const isSec = item?.secret ? " [secret]" : "";
-                const def =
-                  item?.default !== undefined
-                    ? ` (default: ${JSON.stringify(item.default)})`
-                    : "";
-                console.log(
-                  `  - ${k.padEnd(24)} ${item?.description || ""}${def}${isSec}`
-                );
-              }
-            }
-            return;
-          }
-
-          // Remote Package List
-          const packages = remoteInfo.packages || remoteInfo.linkedPackages || [];
-          if (Array.isArray(packages)) {
-            console.log(`Remote ActionDock Packages (${packages.length}):\n`);
-            for (const p of packages) {
-              console.log(`* ${p.name || p.id} (${p.id}) v${p.version || "unknown"}`);
-              if (p.path) console.log(`  Path:      ${p.path}`);
-              if (p.description) console.log(`  Desc:      ${p.description}`);
-              const actNames = Array.isArray(p.actions)
-                ? p.actions.map((a: any) => (typeof a === "string" ? a : a.id)).join(", ")
-                : "";
-              const pbNames = Array.isArray(p.playbooks)
-                ? p.playbooks.map((pb: any) => (typeof pb === "string" ? pb : pb.id)).join(", ")
-                : "";
-              console.log(`  Actions (${p.actionsCount || (p.actions ? p.actions.length : 0)}):   ${actNames || "(none)"}`);
-              console.log(`  Playbooks (${p.playbooksCount || (p.playbooks ? p.playbooks.length : 0)}): ${pbNames || "(none)"}`);
-              console.log("");
-            }
-            console.log("Tip: Run 'ad info <package-id> --server <url>' to view detailed package configuration and schema.");
-            return;
-          }
-
-          console.log(JSON.stringify(remoteInfo, null, 2));
-          return;
-        }
-
-        // Local Tree
-        if (options.tree) {
-          const status = getRegistryStatus();
-          if (isMachine) {
-            renderResult(status, { json: options.json, envelope: options.envelope });
-          } else {
-            printRegistryTree(status);
-          }
-          return;
-        }
-
-        // 2. Explicit package option (-P, --package)
-        if (options.package) {
-          const directRoot = resolvePackageRoot(options.package);
-          if (directRoot) {
-            const detail = await getProjectDetailInfo(directRoot);
-            if (isMachine) {
-              renderResult(projectDetailToJson(detail), { json: options.json, envelope: options.envelope });
-            } else {
-              printProjectDetail(detail);
-            }
-            return;
-          }
-          throw new ArgumentError(
-            `Package '${options.package}' not found in linked packages or path`
-          );
-        }
-
-        // 3. Collect local candidate packages (current project + linked packages)
-        const currentRoot = findProjectRoot();
-        const linkedList = listLinkedPackages();
-        const aggregated: AggregatedPackage[] = [];
-        const seenPaths = new Set<string>();
-
-        if (currentRoot) {
-          try {
-            const config = loadProjectConfig(currentRoot);
-            const manifest = loadManifest(currentRoot);
-            const manifestActionIds = manifest?.actions ? Object.keys(manifest.actions) : [];
-            const playbooks = loadPlaybooks(currentRoot, config.playbooksDir);
-            aggregated.push({
-              id: config.id,
-              name: config.name,
-              version: config.version,
-              description: config.description,
-              path: currentRoot,
-              actionsCount: manifestActionIds.length,
-              playbooksCount: playbooks.size,
-              actions: manifestActionIds,
-              playbooks: Array.from(playbooks.keys()),
-              configDeclared: config.config ? Object.keys(config.config) : [],
-            });
-            seenPaths.add(currentRoot);
-          } catch {
-            // Ignore broken project root
-          }
-        }
-
-        for (const pkg of linkedList) {
-          if (!existsSync(pkg.path)) continue;
-          if (seenPaths.has(pkg.path)) continue;
-          try {
-            const config = loadProjectConfig(pkg.path);
-            const manifest = loadManifest(pkg.path);
-            const manifestActionIds = manifest?.actions ? Object.keys(manifest.actions) : [];
-            const playbooks = loadPlaybooks(pkg.path, config.playbooksDir);
-
-            aggregated.push({
-              id: config.id,
-              name: config.name,
-              version: config.version,
-              description: config.description,
-              path: pkg.path,
-              actionsCount: manifestActionIds.length,
-              playbooksCount: playbooks.size,
-              actions: manifestActionIds,
-              playbooks: Array.from(playbooks.keys()),
-              configDeclared: config.config ? Object.keys(config.config) : [],
-            });
-            seenPaths.add(pkg.path);
-          } catch {
-            // Ignore broken linked package
-          }
-        }
-
-        // 4. Case: No pattern / intent specified
-        if (!effectiveIntent) {
-          if (currentRoot) {
-            const detail = await getProjectDetailInfo(currentRoot);
-            if (isMachine) {
-              renderResult(projectDetailToJson(detail), { json: options.json, envelope: options.envelope });
-            } else {
-              printProjectDetail(detail);
-            }
-            return;
-          }
-
-          if (aggregated.length === 0) {
-            if (isMachine) {
-              renderResult({ linkedPackages: [] }, { 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 or specify a target package."
-            );
-            return;
-          }
-
-          if (isMachine) {
-            renderResult({ linkedPackages: aggregated }, { json: options.json, envelope: options.envelope });
-          } else {
-            printAggregatedPackages(aggregated);
-          }
-          return;
-        }
-
-        // 5. Case: Pattern / intent specified
-        // 5.1 Check if single positional argument directly matches an exact path or package ID/slug
-        if (patterns.length === 1 && !options.intent) {
-          const directRoot = resolvePackageRoot(patterns[0]);
-          if (directRoot) {
-            const detail = await getProjectDetailInfo(directRoot);
-            if (isMachine) {
-              renderResult(projectDetailToJson(detail), { json: options.json, envelope: options.envelope });
-            } else {
-              printProjectDetail(detail);
-            }
-            return;
-          }
-        }
-
-        if (aggregated.length === 0) {
-          if (isMachine) {
-            renderResult({ linkedPackages: [], matchedCount: 0, isFallback: false }, { json: options.json, envelope: options.envelope });
-            return;
-          }
-          throw new ExecutionError(
-            `No ActionDock project or linked packages available to match '${effectiveIntent}'`
-          );
-        }
-
-        // 5.2 Intent filtering across candidate packages
-        const filterRes = filterWithFallbackInfo(
-          aggregated,
-          effectiveIntent,
-          [
-            (p) => p.id,
-            (p) => p.name,
-            (p) => p.description,
-            (p) => p.path,
-            (p) => p.actions,
-            (p) => p.playbooks,
-          ],
-          shouldFallback
-        );
-
-        // Subcase A: 0 items matched
-        if (filterRes.matchedCount === 0) {
-          if (!filterRes.isFallback) {
-            if (isMachine) {
-              renderResult({ linkedPackages: [], matchedCount: 0, isFallback: false }, { json: options.json, envelope: options.envelope });
-              return;
-            }
-            throw new ExecutionError(
-              `No packages matched intent '${effectiveIntent}'`
-            );
-          }
-
-          // Fallback enabled: display all packages with a notice
-          if (isMachine) {
-            renderResult(
-              { linkedPackages: filterRes.items, isFallback: true, matchedCount: 0 },
-              { json: options.json, envelope: options.envelope }
-            );
-            return;
-          }
-          console.log(
-            `(No linked packages matched intent '${effectiveIntent}', showing all packages)\n`
-          );
-          printAggregatedPackages(filterRes.items);
-          return;
-        }
-
-        // Subcase B: Matched items in machine mode
-        if (isMachine) {
-          renderResult(
-            { linkedPackages: filterRes.items, matchedCount: filterRes.matchedCount, isFallback: false },
-            { json: options.json, envelope: options.envelope }
-          );
-          return;
-        }
-
-        // Subcase C: Exactly 1 item matched in human terminal mode -> Display full project detail
-        if (filterRes.matchedCount === 1) {
-          const matchedPkg = filterRes.items[0];
-          const detail = await getProjectDetailInfo(matchedPkg.path);
-          printProjectDetail(detail);
-          return;
-        }
-
-        // Subcase D: Multiple items matched in human terminal mode -> Display filtered summary list
-        printAggregatedPackages(filterRes.items, {
-          header: `ActionDock Linked Packages (${filterRes.matchedCount} matches for '${effectiveIntent}'):\n`,
-          showTip: true,
-        });
-      } catch (err: any) {
-        if (err instanceof CliError) {
-          throw err;
-        }
-        throw new ExecutionError(err.message);
-      }
-    });
-}
-
-

package/src/commands/init.ts

@@ -1,24 +0,0 @@
-import { initProject } from "@actiondock/core";
-import { ExecutionError } from "@actiondock/runtime-cli";
-import { Command } from "commander";
-
-export function registerInitCommand(program: Command): void {
-  program
-    .command("init [directory]")
-    .description("Initialize a new ActionDock project")
-    .option("-i, --id <id>", "Project identifier")
-    .option("-n, --name <name>", "Project display name")
-    .option("-d, --desc <description>", "Project description")
-    .action((dir = ".", options) => {
-      try {
-        initProject(dir, {
-          id: options.id,
-          name: options.name,
-          description: options.desc,
-        });
-        console.log(`Successfully initialized ActionDock project in ${dir}`);
-      } catch (err: any) {
-        throw new ExecutionError(err.message);
-      }
-    });
-}

package/src/commands/link.ts

@@ -1,73 +0,0 @@
-import {
-  linkPackage,
-  pruneRegistry,
-  unlinkPackage,
-} from "@actiondock/core";
-import { ExecutionError } from "@actiondock/runtime-cli";
-import { Command } from "commander";
-
-export function registerLinkCommands(program: Command): void {
-  // ad link [path]
-  program
-    .command("link [path]")
-    .option("-r, --recursive", "Recursively discover and link packages in subdirectories")
-    .description("Link local Action package(s) or workspace directory into global registry for instant cross-directory execution")
-    .action(async (targetPath, options) => {
-      try {
-        const result = linkPackage(targetPath || process.cwd(), undefined, {
-          recursive: options.recursive,
-        });
-
-        if (result.isWorkspace) {
-          console.log(`[OK] Linked workspace '${result.path}' (${result.entries.length} package${result.entries.length > 1 ? "s" : ""}):`);
-          for (const e of result.entries) {
-            console.log(`  - ${e.id} (v${e.version}) -> ${e.path}`);
-          }
-          console.log("[INFO] Sub-packages added to this workspace will be automatically discovered.");
-        } else {
-          console.log(`[OK] Linked package '${result.id}' (v${result.version}) from ${result.path}`);
-        }
-      } catch (err: any) {
-        throw new ExecutionError(err.message);
-      }
-    });
-
-  // ad unlink [id|path]
-  program
-    .command("unlink [identifier]")
-    .option("-p, --prune", "Automatically scan and prune any stale/missing paths from registry")
-    .description("Unlink a package, workspace, or prune stale entries from global developer registry")
-    .action((identifier, options) => {
-      try {
-        if (options.prune || identifier === "--prune") {
-          const result = pruneRegistry();
-          const totalPruned = result.prunedPackages.length + result.prunedWorkspaces.length;
-          if (totalPruned === 0) {
-            console.log("[OK] No stale registry entries found.");
-          } else {
-            console.log(`[OK] Pruned ${result.prunedWorkspaces.length} workspace(s) and ${result.prunedPackages.length} package(s) from registry.`);
-            for (const ws of result.prunedWorkspaces) {
-              console.log(`  - [workspace] ${ws.path}`);
-            }
-            for (const pkg of result.prunedPackages) {
-              console.log(`  - [package] ${pkg.id} (${pkg.path})`);
-            }
-          }
-          return;
-        }
-
-        const removed = unlinkPackage(identifier || process.cwd());
-        if (removed) {
-          if (removed.type === "workspace") {
-            console.log(`[OK] Unlinked workspace '${removed.path}' (${removed.packagesCount || 0} package${(removed.packagesCount || 0) > 1 ? "s" : ""} unlinked)`);
-          } else {
-            console.log(`[OK] Unlinked package '${removed.id}' (${removed.path})`);
-          }
-        } else {
-          console.log(`Package or workspace '${identifier || process.cwd()}' was not linked in registry`);
-        }
-      } catch (err: any) {
-        throw new ExecutionError(err.message);
-      }
-    });
-}