@actiondock/cli 2.7.0 → 2.8.0

package/dist/utils/utils.js

@@ -1,5 +1,36 @@
-import { resolvePackageRoot, findProjectRoot } from "@actiondock/core";
-import { ArgumentError, notInProjectError, packageNotFoundError } from "../errors.js";
+import { resolvePackageRoot, } from "@actiondock/core/registry";
+import { findProjectRoot, loadProjectConfig, } from "@actiondock/core";
+import { loadManifest, } from "@actiondock/core/project";
+import { resolve } from "node:path";
+import { ArgumentError, ExecutionError, notInProjectError, packageNotFoundError, wrapAsExecutionError } from "../errors.js";
+/**
+ * 「未显式指定包且当前目录无工程」的统一补救提示（单一事实源）。
+ */
+export const PACKAGE_HINT_MESSAGE = "Please specify -P, --package <id> or cd into a project directory.";
+/**
+ * 拼接远端目标标题后缀（单一事实源）。
+ *
+ * 形如 `on remote server <url> (Profile: <name>)`，供列表类命令的
+ * 标题拼接复用（如 `Actions ${remoteTargetSuffix(target)}`），
+ * 消除五处同构模板漂移。
+ *
+ * @param resolved 目标拓扑解析结果（远端分支）
+ */
+export function remoteTargetSuffix(resolved) {
+    const profile = resolved.profileName ? ` (Profile: ${resolved.profileName})` : "";
+    return `on remote server ${resolved.serverUrl}${profile}`;
+}
+/**
+ * 拼接远端目标标题标签（单一事实源）。
+ *
+ * 形如 `Remote Server <url> (Profile: <name>)`，与 remoteTargetSuffix 共享
+ * 同一拼接实现，供 state、config 等直接以远端目标为标题主体的命令复用。
+ *
+ * @param resolved 目标拓扑解析结果（远端分支）
+ */
+export function remoteTargetLabel(resolved) {
+    return `Remote Server ${resolved.serverUrl}${resolved.profileName ? ` (Profile: ${resolved.profileName})` : ""}`;
+}
 /**
  * 解析意图字符串（从显式 --intent 或位置模式参数聚合）。
  * 多个关键字使用 '|'（正则逻辑或）连接。
@@ -81,11 +112,64 @@ export function getTargetRoot(packageOption, keyHint) {
             throw packageNotFoundError(targetPackage);
         }
         else {
-            throw notInProjectError("Please specify -P, --package <id> or cd into a project directory.");
+            throw notInProjectError(PACKAGE_HINT_MESSAGE);
         }
     }
     return { root, key: effectiveKey };
 }
+export function requirePackageRoot(packageOption, options) {
+    const root = packageOption ? resolvePackageRoot(packageOption) : findProjectRoot();
+    if (!root) {
+        if (packageOption) {
+            throw packageNotFoundError(packageOption);
+        }
+        throw notInProjectError(options?.hint ?? PACKAGE_HINT_MESSAGE);
+    }
+    return options?.loadConfig
+        ? { root, projConfig: loadProjectConfig(root) }
+        : { root };
+}
+/**
+ * 依赖类命令（ad add / ad remove）的工程根目录与清单解析脚手架（单一事实源）。
+ *
+ * 与 requirePackageRoot 的差异：-P 语义为工程目录路径而非包标识，
+ * 显式路径不做注册表寻址（不抛 packageNotFoundError，缺失清单由后续存在性检查报错）。
+ *
+ * @param packageOption 显式指定的工程目录路径（对应 -P, --package <path>）
+ * @returns 工程根目录与已验存的 actiondock.json 清单
+ */
+export function requireProjectManifestRoot(packageOption) {
+    const root = packageOption ? resolve(packageOption) : findProjectRoot();
+    if (!root) {
+        throw notInProjectError("Please specify -P, --package <path> or cd into a project directory.");
+    }
+    const manifest = loadManifest(root);
+    if (!manifest) {
+        throw new ArgumentError(`actiondock.json not found in ${root}`);
+    }
+    return { root, manifest };
+}
+/**
+ * 依赖事务失败回滚辅助（ad add / ad remove 共享）：回滚事务后按统一规则透传异常。
+ *
+ * 回滚与包裹规则：
+ * - 先执行事务回滚快照，保留原始磁盘状态；
+ * - ActionDockError 与 CliError 原样透传（保留 code 与 details）；
+ * - 其余包裹为 ExecutionError 并保留原始 code，缺省时回退 fallbackCode。
+ *
+ * @param tx 已开启的工程事务快照
+ * @param err 业务回调抛出的原始异常
+ * @param fallbackCode 包裹分支缺省错误码（命令专属，如 ADD_DEPENDENCY_FAILED）
+ */
+export async function rollbackAndRethrow(tx, err, fallbackCode) {
+    await tx.rollback({ frozenInstall: false });
+    const passthrough = wrapAsExecutionError(err);
+    if (passthrough !== err) {
+        const original = err;
+        throw new ExecutionError(original.message, err, original.code || fallbackCode);
+    }
+    throw passthrough;
+}
 /**
  * 聚合命令自身选项与根程序全局选项（如 --json、--data-dir 等）。
  */
@@ -97,15 +181,21 @@ export function getEffectiveOptions(rawOptions, cmd) {
 }
 /**
  * 解析意图过滤回退策略。
- * 机器输出模式（--json）仅在显式传 --fallback 时回退，
+ *
+ * 统一事实源：机器输出模式（--json）仅在显式传 --fallback 时回退，
  * 人类交互模式默认回退（可被 --no-fallback 关闭）。
+ *
+ * 回退标志的显式性判定完全依据 Commander 解析结果（由调用方传入）：
+ * 同时注册 --fallback 与 --no-fallback 的命令，未指定时 fallback 为
+ * undefined、显式 --fallback 为 true、--no-fallback 为 false，
+ * 不再直读 process.argv，消除隐藏的全局依赖。
+ *
+ * @param options 命令选项视图（含 fallback 与 json 字段）
  */
 export function resolveFallbackStrategy(options) {
     const isMachine = Boolean(options.json);
-    const fallbackExplicit = options.fallback === true ||
-        (Array.isArray(process.argv) && process.argv.includes("--fallback"));
     return {
         isMachine,
-        shouldFallback: isMachine ? fallbackExplicit : options.fallback !== false,
+        shouldFallback: isMachine ? options.fallback === true : options.fallback !== false,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/cli",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "ActionDock CLI facade for developing, testing, building, and exporting standalone Agent Actions and Skills",
   "type": "module",
   "bin": {
@@ -34,11 +34,10 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/builder": "^2.7.0",
-    "@actiondock/core": "^2.7.0",
-    "@actiondock/mcp": "^2.7.0",
-    "@actiondock/runtime-node": "^2.7.0",
-    "@actiondock/sdk": "^2.7.0",
+    "@actiondock/builder": "^2.8.0",
+    "@actiondock/core": "^2.8.0",
+    "@actiondock/mcp": "^2.8.0",
+    "@actiondock/sdk": "^2.8.0",
     "commander": "^13.1.0",
     "selfsigned": "^5.5.0"
   },

package/dist/utils/bytes.d.ts

@@ -1 +0,0 @@
-export { parseByteSize } from "./utils.js";

package/dist/utils/bytes.js

@@ -1 +0,0 @@
-export { parseByteSize } from "./utils.js";

package/dist/utils/filter.d.ts

@@ -1 +0,0 @@
-export { resolveIntent } from "./utils.js";

package/dist/utils/filter.js

@@ -1 +0,0 @@
-export { resolveIntent } from "./utils.js";