@actiondock/cli 2.9.1 → 2.11.0

package/dist/utils/target.d.ts

@@ -47,9 +47,9 @@ export declare function resolveTargetFromOptions(options: TargetResolutionOption
  * 回调获得创建好的 service 与解析后的目标拓扑信息；无论回调成功或抛出，
  * 都保证 service 资源被正确释放，业务异常原样透传。
  *
- * 默认旁观打开：内部创建的本地 Host 以非收割模式打开存储（不置 recoverOrphans），
+ * 默认旁观打开：内部创建的本地 Host 以非收割模式打开存储（显式指定 recoverOrphans: false），
  * 供 ad state / ad runs / ad config 等查询命令与运行中的 serve 进程并发访问同一库；
- * 需要持有者语义的执行命令通过 localOptions.ownDataDir 显式声明。
+ * 需要持有者语义的执行命令通过 localOptions.ownDataDir 显式声明启用收割。
  *
  * @param options 命令选项视图（profile/server/token/package/dataDir/insecure/allowInsecureHttp）
  * @param context CLI 上下文
@@ -67,6 +67,10 @@ export declare function withService(options: TargetResolutionOptions, context: C
      * 保持缺省 false，避免误收割并发 serve 进程的在途运行记录。
      */
     ownDataDir?: boolean;
+    /**
+     * 是否显式指定孤儿运行收割策略；缺省依据 ownDataDir 决策（仅 ownDataDir 为 true 时启用收割，查询旁观模式显式关闭）
+     */
+    recoverOrphans?: boolean;
     /**
      * 是否强制要求远端目标：true 时 local 分支直接抛 ArgumentError（如 ad runs cancel），
      * 替代原 withRemoteService 的专用实现。

package/dist/utils/target.js

@@ -42,9 +42,9 @@ export function resolveTargetFromOptions(options, context) {
  * 回调获得创建好的 service 与解析后的目标拓扑信息；无论回调成功或抛出，
  * 都保证 service 资源被正确释放，业务异常原样透传。
  *
- * 默认旁观打开：内部创建的本地 Host 以非收割模式打开存储（不置 recoverOrphans），
+ * 默认旁观打开：内部创建的本地 Host 以非收割模式打开存储（显式指定 recoverOrphans: false），
  * 供 ad state / ad runs / ad config 等查询命令与运行中的 serve 进程并发访问同一库；
- * 需要持有者语义的执行命令通过 localOptions.ownDataDir 显式声明。
+ * 需要持有者语义的执行命令通过 localOptions.ownDataDir 显式声明启用收割。
  *
  * @param options 命令选项视图（profile/server/token/package/dataDir/insecure/allowInsecureHttp）
  * @param context CLI 上下文
@@ -62,6 +62,7 @@ export async function withService(options, context, fn, localOptions) {
             findProjectRoot() ??
             undefined
         : undefined;
+    const recoverOrphans = localOptions?.recoverOrphans ?? (localOptions?.ownDataDir === true);
     const service = resolved.type === "remote"
         ? await connectActionDock({
             serverUrl: resolved.serverUrl,
@@ -77,12 +78,11 @@ export async function withService(options, context, fn, localOptions) {
             platform: createNodePlatform({
                 customHome: context?.customHome,
                 dataDir: options.dataDir || context?.dataDir,
-                rootDir: localRoot,
             }),
             ...(localOptions?.scanLinkedPackages !== undefined
                 ? { scanLinkedPackages: localOptions.scanLinkedPackages }
                 : undefined),
-            ...(localOptions?.ownDataDir === true ? { recoverOrphans: true } : undefined),
+            recoverOrphans,
         });
     try {
         await fn(service, resolved);

package/dist/utils/utils.d.ts

@@ -3,7 +3,7 @@ import { type ActionDockManifest, type ProjectTransaction } from "@actiondock/co
 /**
  * 「未显式指定包且当前目录无工程」的统一补救提示（单一事实源）。
  */
-export declare const PACKAGE_HINT_MESSAGE = "Please specify -P, --package <id> or cd into a project directory.";
+export declare const PACKAGE_HINT_MESSAGE = "Hint: Run 'ad init' to start a new project, specify '-P <id|path>' for an existing package, or run 'ad link <path>' to register it.";
 /**
  * 远端目标拓扑的最小字段视图（与 core 的 ResolvedTarget 远端分支兼容）。
  */

package/dist/utils/utils.js

@@ -1,12 +1,12 @@
-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";
+import { resolveLocalPackageRoot } from "./target.js";
 /**
  * 「未显式指定包且当前目录无工程」的统一补救提示（单一事实源）。
  */
-export const PACKAGE_HINT_MESSAGE = "Please specify -P, --package <id> or cd into a project directory.";
+export const PACKAGE_HINT_MESSAGE = "Hint: Run 'ad init' to start a new project, specify '-P <id|path>' for an existing package, or run 'ad link <path>' to register it.";
 /**
  * 拼接远端目标标题后缀（单一事实源）。
  *
@@ -106,19 +106,11 @@ export function getTargetRoot(packageOption, keyHint) {
         targetPackage = keyHint.slice(0, slashIdx);
         effectiveKey = keyHint.slice(slashIdx + 1);
     }
-    const root = resolvePackageRoot(targetPackage) || (targetPackage ? null : findProjectRoot());
-    if (!root) {
-        if (targetPackage) {
-            throw packageNotFoundError(targetPackage);
-        }
-        else {
-            throw notInProjectError(PACKAGE_HINT_MESSAGE);
-        }
-    }
+    const { root } = requirePackageRoot(targetPackage);
     return { root, key: effectiveKey };
 }
 export function requirePackageRoot(packageOption, options) {
-    const root = packageOption ? resolvePackageRoot(packageOption) : findProjectRoot();
+    const root = resolveLocalPackageRoot(packageOption);
     if (!root) {
         if (packageOption) {
             throw packageNotFoundError(packageOption);

package/dist/utils/warning.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 实验性特性警告静默函数（统一对齐 @actiondock/core/warning 单一事实源）。
+ */
+export { suppressExperimentalWarnings } from "@actiondock/core/warning";

package/dist/utils/warning.js

@@ -0,0 +1,4 @@
+/**
+ * 实验性特性警告静默函数（统一对齐 @actiondock/core/warning 单一事实源）。
+ */
+export { suppressExperimentalWarnings } from "@actiondock/core/warning";

package/package.json

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

package/dist/commands/state-list.d.ts

@@ -1,24 +0,0 @@
-import { type ActionDockService } from "@actiondock/core";
-import type { CliContext } from "../types.js";
-/**
- * 状态键列表渲染参数视图。
- */
-export interface StateListRenderArgs {
-    service: ActionDockService;
-    actionId: string;
-    prefix: string;
-    options: any;
-    effectiveIntent?: string;
-    shouldFallback: boolean;
-    context?: CliContext;
-}
-/**
- * 渲染单个项目作用域的状态键列表（含 --detail JSON 明细分支）。
- */
-export declare function renderProjectScopedStateList(args: StateListRenderArgs & {
-    targetRoot: string;
-}): Promise<void>;
-/**
- * 渲染全部链接包聚合的状态键列表（跳过磁盘失效与清单损坏的链接项）。
- */
-export declare function renderLinkedPackagesStateList(args: StateListRenderArgs): Promise<void>;

package/dist/commands/state-list.js

@@ -1,81 +0,0 @@
-import { loadProjectConfig, } from "@actiondock/core";
-import { filterWithFallbackInfo, } from "@actiondock/core/project";
-import { listLinkedPackages, } from "@actiondock/core/registry";
-import { existsSync } from "node:fs";
-import { NO_PROJECT_NO_LINKED_MESSAGE } from "../errors.js";
-import { renderResult, renderStateList } from "../renderer.js";
-/**
- * 渲染单个项目作用域的状态键列表（含 --detail JSON 明细分支）。
- */
-export async function renderProjectScopedStateList(args) {
-    const { service, targetRoot, actionId, prefix, options, effectiveIntent, shouldFallback, context } = args;
-    const projConfig = loadProjectConfig(targetRoot);
-    const allKeys = (await service.management?.state.list(projConfig.id, actionId, {
-        namespace: options.namespace !== undefined ? options.namespace : null,
-        prefix,
-    })) ?? [];
-    if (options.detail && options.json) {
-        const entries = [];
-        for (const k of allKeys) {
-            const entry = await service.management?.state.get(projConfig.id, actionId, k, {
-                namespace: options.namespace,
-                detail: true,
-            });
-            if (entry) {
-                entries.push(entry);
-            }
-        }
-        const filterRes = filterWithFallbackInfo(entries, effectiveIntent, [(e) => e.fullKey, (e) => e.key, (e) => e.namespace], shouldFallback);
-        renderResult(filterRes.items, {
-            json: true,
-            context,
-        });
-        return;
-    }
-    const filterRes = filterWithFallbackInfo(allKeys, effectiveIntent, [(k) => k], shouldFallback);
-    renderResult(filterRes.items, {
-        json: options.json,
-        humanFormatter: () => renderStateList(filterRes.items, `${projConfig.name} (${projConfig.id})`, filterRes.isFallback, effectiveIntent),
-        context,
-    });
-}
-/**
- * 渲染全部链接包聚合的状态键列表（跳过磁盘失效与清单损坏的链接项）。
- */
-export async function renderLinkedPackagesStateList(args) {
-    const { service, actionId, prefix, options, effectiveIntent, shouldFallback, context } = args;
-    // 扫描所有链接的包状态
-    const linked = listLinkedPackages();
-    if (linked.length === 0) {
-        renderResult([], {
-            json: options.json,
-            humanFormatter: () => NO_PROJECT_NO_LINKED_MESSAGE,
-            context,
-        });
-        return;
-    }
-    const aggregatedKeys = [];
-    for (const pkg of linked) {
-        if (!existsSync(pkg.path))
-            continue;
-        try {
-            const config = loadProjectConfig(pkg.path);
-            const keys = (await service.management?.state.list(config.id, actionId, {
-                namespace: options.namespace !== undefined ? options.namespace : null,
-                prefix,
-            })) ?? [];
-            for (const k of keys) {
-                aggregatedKeys.push(`${config.id}/${k}`);
-            }
-        }
-        catch {
-            // 单个链接包清单损坏或状态读取失败时跳过，继续聚合其余包
-        }
-    }
-    const filterRes = filterWithFallbackInfo(aggregatedKeys, effectiveIntent, [(k) => k], shouldFallback);
-    renderResult(filterRes.items, {
-        json: options.json,
-        humanFormatter: () => renderStateList(filterRes.items, "Linked Packages State Store", filterRes.isFallback, effectiveIntent),
-        context,
-    });
-}

package/dist/standalone/index.d.ts

@@ -1,12 +0,0 @@
-import { type InvocationControl } from "@actiondock/core/server";
-import type { StandaloneOptions } from "../types.js";
-export { type InvocationControl };
-/**
- * 运行独立二进制参数解析分发器并返回退出状态码（委托 Core 统一实现）。
- */
-export declare function runStandaloneCli(argv: string[] | undefined, options: StandaloneOptions, control?: InvocationControl): Promise<number>;
-/**
- * 独立二进制进程入口适配器（事实源位于 core 包，此处 re-export 维持既有导入路径兼容）。
- * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
- */
-export { runStandaloneProcess } from "@actiondock/core/server";

package/dist/standalone/index.js

@@ -1,13 +0,0 @@
-import { StandaloneDispatcher as CoreStandaloneDispatcher, } from "@actiondock/core/server";
-/**
- * 运行独立二进制参数解析分发器并返回退出状态码（委托 Core 统一实现）。
- */
-export async function runStandaloneCli(argv = process.argv.slice(2), options, control) {
-    const dispatcher = new CoreStandaloneDispatcher(options);
-    return dispatcher.dispatch(argv, control);
-}
-/**
- * 独立二进制进程入口适配器（事实源位于 core 包，此处 re-export 维持既有导入路径兼容）。
- * 仅在命令行可执行入口调用，负责全局 SIGINT 监听与退出状态码写入。
- */
-export { runStandaloneProcess } from "@actiondock/core/server";

package/dist/utils/duration.d.ts

@@ -1 +0,0 @@
-export { parseDuration } from "@actiondock/core/project";

package/dist/utils/duration.js

@@ -1 +0,0 @@
-export { parseDuration } from "@actiondock/core/project";