@actiondock/core 2.5.0 → 2.6.0

package/dist/execution/service.js

@@ -3,7 +3,8 @@ import { ActionResolver } from "../catalog/action-resolver.js";
 import { computeDigest } from "../project/digest.js";
 import { InMemoryEventSink } from "../runtime/events.js";
 import { ActionRunner } from "../runtime/runner.js";
-import { ACTION_CANCELLED, ACTION_NOT_FOUND, ACTION_TIMEOUT, EXECUTION_FAILED, IDEMPOTENCY_CONFLICT, RUN_REPOSITORY_UNAVAILABLE, UNHANDLED_EXECUTION_ERROR, describeActionLoadFailure, } from "../errors.js";
+import { ACTION_NOT_FOUND, EXECUTION_FAILED, IDEMPOTENCY_CONFLICT, RUN_REPOSITORY_UNAVAILABLE, UNHANDLED_EXECUTION_ERROR, describeActionLoadFailure, } from "../errors.js";
+import { resultStatusToRunStatus } from "../storage/types.js";
 /**
  * 统一执行协调服务实现。
  */
@@ -49,6 +50,8 @@ export class DefaultExecutionService {
                     options.platform.storage.createStorage(this.packageId, {
                         projectRoot: options.projectRoot,
                         customHome: options.customHome,
+                        // 执行服务属于数据目录持有者主路径，打开时收割遗留孤儿运行
+                        recoverOrphans: true,
                     });
         }
         else {
@@ -60,7 +63,8 @@ export class DefaultExecutionService {
             this.storage = options.storage;
         }
         const globalStorage = options.platform
-            ? (options.globalStorage ?? options.platform.storage.createGlobalStorage({ customHome: options.customHome }))
+            ? (options.globalStorage ??
+                options.platform.storage.createGlobalStorage({ customHome: options.customHome, recoverOrphans: true }))
             : options.globalStorage;
         this.ownsStorage = !options.storage;
         this.ownsGlobalStorage = !options.globalStorage && !!options.platform;
@@ -533,13 +537,7 @@ export class DefaultExecutionService {
     watchHandleCompletion(handle, activeItem, bridge) {
         handle.result
             .then((result) => {
-            const finalStatus = result.ok
-                ? "success"
-                : result.error?.code === ACTION_TIMEOUT
-                    ? "timed_out"
-                    : result.error?.code === ACTION_CANCELLED
-                        ? "cancelled"
-                        : "failed";
+            const finalStatus = resultStatusToRunStatus(result.ok, result.ok ? undefined : result.error?.code);
             activeItem.status = finalStatus;
             bridge.emitEvent({ type: "status", status: finalStatus });
             bridge.emitEvent({ type: "finish", result });
@@ -633,6 +631,13 @@ export class DefaultExecutionService {
             }
         }
         this.activeRuns.clear();
+        // 级联释放跨包子包 Runner 及其独立创建的存储连接（幂等，异常不阻断后续释放）
+        try {
+            await this._runner.dispose();
+        }
+        catch {
+            // 子包释放异常已在 dispose 内部隔离，此处仅需保障主流程继续
+        }
         if (this.ownsStorage && this.storage && typeof this.storage.close === "function") {
             await this.storage.close();
         }

package/dist/host/host.d.ts

@@ -8,6 +8,7 @@ import type { ActionDockHost, ActionDockHostOptions } from "./types.js";
  */
 export declare class DefaultActionDockHost implements ActionDockHost {
     readonly hostSessionId: string;
+    readonly options: ActionDockHostOptions;
     private apps;
     private readonly internallyCreatedApps;
     private activeSubRunsPerRoot;
@@ -19,11 +20,43 @@ export declare class DefaultActionDockHost implements ActionDockHost {
     private isClosed;
     private dataDirLock?;
     private failedLinkedPackages;
+    private failedAutoLoad?;
+    /** 透传给内部创建 App 的存储收割开关（Host 默认持有者身份，显式可关） */
+    private recoverOrphans;
     constructor(options?: ActionDockHostOptions);
+    /**
+     * 阶段函数：注册显式传入的 packages 列表（现成 App 实例或 AppOptions 配置）。
+     */
+    private registerExplicitPackages;
+    /**
+     * 阶段函数：自动加载当前工程并注册依赖闭包内的全部包。
+     *
+     * 失败语义区分场景：
+     * - 显式传入 projectRoot 时，任何解析失败（损坏 actiondock.json、文件系统错误等）
+     *   必须向上抛出，由调用方感知，严禁吞没；
+     * - 自动探测场景（未传 projectRoot，由 findProjectRoot 发现）失败时记录实例诊断
+     *   failedAutoLoad 并在创建时输出单行告警，保持宿主其余能力可用但绝不无声。
+     */
+    private loadCurrentProject;
+    /**
+     * 阶段函数：扫描全局注册表中已软链接的外部包并注册至 Host。
+     * 加载失败的链接包记录至 failedLinkedPackages 诊断并在调阅时透传精准失败原因。
+     */
+    private registerLinkedPackages;
     private resolvePackageContext;
     private bindApp;
+    /** 路由可见性上下文（公开包集合与依赖解析器） */
+    private visibility;
     getApp(packageId: string): ActionDockApp | undefined;
     listApps(): ActionDockApp[];
+    /**
+     * 获取自动加载工程的失败诊断信息。
+     * 仅自动探测场景会记录此诊断；显式传入 projectRoot 的加载失败会直接抛出，不产生此诊断。
+     */
+    getAutoLoadFailure(): {
+        projectRoot: string;
+        error: string;
+    } | undefined;
     private registerAppInternal;
     registerApp(app: ActionDockApp): void;
     info(): Promise<PackageInfo[]>;