@actiondock/core 2.5.1 → 2.6.0

package/dist/project/init.js

@@ -86,10 +86,10 @@ export function initProject(targetDir, options = {}) {
             node: ">=24.12.0",
         },
         dependencies: {
-            "@actiondock/sdk": "^2.5.1",
+            "@actiondock/sdk": "^2.6.0",
         },
         devDependencies: {
-            "@actiondock/testing": "^2.5.1",
+            "@actiondock/testing": "^2.6.0",
             "@types/node": "^22.13.0",
             "tsx": "^4.19.0",
             "typescript": "^5.7.0",

package/dist/project/loader.d.ts

@@ -25,30 +25,6 @@ export declare const ALLOWED_INSTALLERS: Set<string>;
  * - 候选回退优先级探测（npm > bun）。
  */
 export declare function getInstallCommand(projectRoot?: string): string[];
-/**
- * 读取项目当前缓存的依赖指纹哈希。
- */
-export declare function readStoredDependencyFingerprint(projectRoot: string): string | null;
-/**
- * 将最新的依赖指纹哈希写入缓存文件。
- */
-export declare function saveDependencyFingerprint(projectRoot: string, fingerprint: string): void;
-/**
- * 计算项目依赖的指纹哈希（基于 package.json 依赖声明及可能存在的锁文件内容）。
- *
- * @param projectRoot 项目根目录
- * @returns 64位十六进制哈希字符串，若 package.json 不存在或解析失败则返回 null
- */
-export declare function computeDependencyFingerprint(projectRoot: string): string | null;
-/**
- * 确保项目依赖（node_modules）已正确安装。
- * 若尚未安装、依赖版本变更（指纹不匹配）或加载失败时，自动触发包管理器执行依赖安装。
- *
- * @param projectRoot 项目根目录
- * @param force 是否强制重新安装
- * @returns 是否成功执行了安装或更新
- */
-export declare function ensureProjectDependencies(projectRoot: string, force?: boolean): boolean;
 /**
  * 发现并检索项目 actions 目录下的所有 Action 源码文件（.ts）。
  *
@@ -67,7 +43,6 @@ export declare function discoverActionFiles(projectRoot: string, actionsDir?: st
  * @returns Map<ActionId, ActionDefinition> 映射
  */
 export declare function loadActions(projectRoot: string, _actionsDir?: string, options?: {
-    autoInstall?: boolean;
     loader?: ModuleLoader;
 }): Promise<Map<string, ActionDefinition>>;
 /**

package/dist/project/loader.js

@@ -1,6 +1,5 @@
 import { spawnSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { DefaultModuleLoader } from "../runtime/module-loader.js";
 import { ACTION_LOAD_FAILED, isMissingModuleError } from "../errors.js";
@@ -126,158 +125,6 @@ export function getInstallCommand(projectRoot) {
     }
     return ["npm", "install"];
 }
-/**
- * 缓存依赖指纹的文件相对路径（位于 node_modules/.cache/actiondock 下）。
- * 基于项目绝对路径生成唯一哈希标识，避免软链接共享 node_modules 时指纹冲突。
- */
-function getDependencyFingerprintPath(projectRoot) {
-    const projectKey = createHash("sha256").update(resolve(projectRoot)).digest("hex").slice(0, 16);
-    return join(projectRoot, "node_modules", ".cache", "actiondock", `${projectKey}-deps.hash`);
-}
-/**
- * 读取项目当前缓存的依赖指纹哈希。
- */
-export function readStoredDependencyFingerprint(projectRoot) {
-    const fpPath = getDependencyFingerprintPath(projectRoot);
-    try {
-        if (existsSync(fpPath)) {
-            return readFileSync(fpPath, "utf-8").trim();
-        }
-    }
-    catch {
-        // 忽略读取异常
-    }
-    return null;
-}
-/**
- * 将最新的依赖指纹哈希写入缓存文件。
- */
-export function saveDependencyFingerprint(projectRoot, fingerprint) {
-    try {
-        const fpPath = getDependencyFingerprintPath(projectRoot);
-        const dir = dirname(fpPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        writeFileSync(fpPath, fingerprint, "utf-8");
-    }
-    catch {
-        // 忽略写入异常（如只读文件系统或权限限制）
-    }
-}
-/**
- * 递归对对象所有键名进行升序排序，保证 JSON.stringify 序列化结果的唯一性与确定性。
- */
-function sortObjectKeys(obj) {
-    if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
-        return obj;
-    }
-    const sorted = {};
-    for (const key of Object.keys(obj).sort()) {
-        sorted[key] = sortObjectKeys(obj[key]);
-    }
-    return sorted;
-}
-/**
- * 计算项目依赖的指纹哈希（基于 package.json 依赖声明及可能存在的锁文件内容）。
- *
- * @param projectRoot 项目根目录
- * @returns 64位十六进制哈希字符串，若 package.json 不存在或解析失败则返回 null
- */
-export function computeDependencyFingerprint(projectRoot) {
-    const pkgJsonPath = join(projectRoot, "package.json");
-    if (!existsSync(pkgJsonPath)) {
-        return null;
-    }
-    try {
-        const raw = readFileSync(pkgJsonPath, "utf-8");
-        const pkg = JSON.parse(raw);
-        const depSpec = {
-            dependencies: pkg.dependencies || {},
-            devDependencies: pkg.devDependencies || {},
-            peerDependencies: pkg.peerDependencies || {},
-            optionalDependencies: pkg.optionalDependencies || {},
-            overrides: pkg.overrides || {},
-            resolutions: pkg.resolutions || {},
-        };
-        const hash = createHash("sha256");
-        hash.update(JSON.stringify(sortObjectKeys(depSpec)));
-        // 锁文件变化（如团队协同合并或手动更新锁文件）同样代表依赖版本变更
-        const lockFiles = [
-            "package-lock.json",
-            "npm-shrinkwrap.json",
-            "bun.lockb",
-            "bun.lock",
-        ];
-        for (const lockFile of lockFiles) {
-            const lockPath = join(projectRoot, lockFile);
-            if (existsSync(lockPath)) {
-                try {
-                    hash.update(lockFile);
-                    hash.update(readFileSync(lockPath));
-                }
-                catch {
-                    // 忽略不可读的锁文件
-                }
-            }
-        }
-        return hash.digest("hex");
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 确保项目依赖（node_modules）已正确安装。
- * 若尚未安装、依赖版本变更（指纹不匹配）或加载失败时，自动触发包管理器执行依赖安装。
- *
- * @param projectRoot 项目根目录
- * @param force 是否强制重新安装
- * @returns 是否成功执行了安装或更新
- */
-export function ensureProjectDependencies(projectRoot, force = false) {
-    if (process.env.ACTIONDOCK_AUTO_INSTALL === "false") {
-        return false;
-    }
-    const pkgJsonPath = join(projectRoot, "package.json");
-    if (!existsSync(pkgJsonPath)) {
-        return false;
-    }
-    let pkg;
-    try {
-        const raw = readFileSync(pkgJsonPath, "utf-8");
-        pkg = JSON.parse(raw);
-    }
-    catch {
-        return false;
-    }
-    const hasDeps = (pkg.dependencies && Object.keys(pkg.dependencies).length > 0) ||
-        (pkg.devDependencies && Object.keys(pkg.devDependencies).length > 0) ||
-        (pkg.peerDependencies && Object.keys(pkg.peerDependencies).length > 0) ||
-        (pkg.optionalDependencies && Object.keys(pkg.optionalDependencies).length > 0);
-    if (!hasDeps && !force) {
-        return false;
-    }
-    const nodeModulesPath = join(projectRoot, "node_modules");
-    const nodeModulesExists = existsSync(nodeModulesPath);
-    const currentFingerprint = computeDependencyFingerprint(projectRoot);
-    if (!force && nodeModulesExists) {
-        const storedFingerprint = readStoredDependencyFingerprint(projectRoot);
-        if (storedFingerprint === null) {
-            // 首次接入已包含 node_modules 的外部环境或既有项目，信任现有依赖并记录初始指纹
-            if (currentFingerprint) {
-                saveDependencyFingerprint(projectRoot, currentFingerprint);
-            }
-            return false;
-        }
-        if (currentFingerprint && storedFingerprint === currentFingerprint) {
-            // 依赖声明与锁文件指纹一致，无需重新安装
-            return false;
-        }
-    }
-    // ActionDock 2.0 彻底移除运行时静默在线安装依赖逻辑，严禁静默联网安装
-    return false;
-}
 /**
  * 递归扫描指定目录下的特定后缀文件（自动排除测试文件 *.test.ts, *.spec.ts 和 *.d.ts）。
  */

package/dist/project/transactions.d.ts

@@ -24,14 +24,6 @@ export interface ProjectTransaction {
  * 检查当前进程 PID 是否处于活跃运行状态。
  */
 export declare function isPidAlive(pid: number): boolean;
-/**
- * 安全清理陈旧接管守卫（reclaim guard）。
- * 采用原子重命名检疫并严格核对 guardToken 与持有者存活状态，确保仅删除目标陈旧 guard，严禁误删活跃守卫或并发新守卫。
- *
- * @param reclaimPath 目标守卫路径
- * @param expectedGuardToken 预期持有的守卫令牌（必填，拒绝未指定令牌的盲目清理）
- */
-export declare function safeRemoveStaleProjectReclaimGuard(reclaimPath: string, expectedGuardToken: string): void;
 /**
  * 从工程锁隔离或回滚临时目录名称中解析操作者 PID 与隔离生成时间戳。
  * 命名规范：*.(quarantine|rollback|release).<pid>.<timestamp>.<uuid> 或 *.orphan.<timestamp>.<uuid>
@@ -42,21 +34,27 @@ export declare function parseProjectQuarantineTimestamp(entryName: string): {
 };
 export declare const parseQuarantineTimestamp: typeof parseProjectQuarantineTimestamp;
 /**
- * 清理过期的工程锁隔离目录（GC 回收机制）。
- * 实施分流存活校验，防止误删活跃持锁者与回滚中目录，同时防止孤儿目录无限泄漏：
- * - 共同前置条件：存活年龄必须超过 maxAgeMs（默认 10000ms），未超期前严禁清理（保持宽限期）。
- * - 活跃隔离目录（quarantine / rollback / release）：若 operatorPid 存活或内部 metadata.json 记录的 pid 与 childPids 存活，跳过不予清理。
- * - 孤儿脱离目录（orphan）：内部旧 metadata.pid 不再作为续命依据；提取其内部 orphanToken，仅当当前规范主路径（主锁目录与 reclaim 目录）依然持有该凭证时保守跳过；规范路径不存在或已变更凭据时直接安全清理。
+ * 安全清理陈旧接管守卫（reclaim guard）。
+ * 采用原子重命名检疫并严格核对 guardToken 与持有者存活状态，确保仅删除目标陈旧 guard，严禁误删活跃守卫或并发新守卫。
+ *
+ * @param reclaimPath 目标守卫路径
+ * @param expectedGuardToken 预期持有的守卫令牌（必填，拒绝未指定令牌的盲目清理）
  */
-export declare function cleanStaleProjectQuarantines(parentDir: string, basePrefix: string, maxAgeMs?: number, deadline?: number): void;
+export declare function safeRemoveStaleProjectReclaimGuard(reclaimPath: string, expectedGuardToken: string): void;
 /**
  * 安全回滚当前进程创建的工程修改锁。
  * 优先核对 lockToken，回退核对 sessionToken，防止误删接管者或并发新锁。
  */
 export declare function safeRollbackProjectLock(lockPath: string, expectedSessionToken: string, expectedLockToken?: string): void;
+/**
+ * 清理过期的工程锁隔离目录（GC 回收机制）。
+ * 实施分流存活校验，防止误删活跃持锁者与回滚中目录，同时防止孤儿目录无限泄漏，语义由目录锁内核统一承载。
+ */
+export declare function cleanStaleProjectQuarantines(parentDir: string, basePrefix: string, maxAgeMs?: number, deadline?: number): void;
 /**
  * 安全释放工程主锁。
  * 仅当锁目录中持有当前 lockToken / sessionToken 时才删除，杜绝删除他人新锁。
+ * 释放后同步触发一轮工程锁隔离目录 GC。
  */
 export declare function safeReleaseProjectLock(lockPath: string, expectedSessionToken: string, expectedLockToken?: string): void;
 /**