@actiondock/builder 2.0.12 → 2.2.0

package/dist/fs-utils.d.ts

@@ -0,0 +1,16 @@
+export declare function moveDirAtomic(src: string, dest: string): Promise<void>;
+/**
+ * 递归收集目录内全部文件的相对路径（正斜杠分隔，名称排序）。
+ * 统一排序保证产物文件清单与内容摘要的确定性。
+ */
+export declare function collectRelativeFiles(dir: string, baseDir?: string): string[];
+/**
+ * 获取内部 @actiondock/* 依赖的版本号规则。
+ * 预发布版本采用精确锁定，正式版本采用 ^ 语义范围。
+ */
+export declare function getInternalDependencyVersion(version?: string): string;
+/**
+ * 以新目录原子替换已存在的目标目录（含失败回滚保护）。
+ * promotion 失败后优先 backup -> target 回滚；只有新 target 完整成功后才能删除 backup。
+ */
+export declare function replaceDirAtomic(stagingDir: string, targetDir: string): Promise<void>;

package/dist/fs-utils.js

@@ -0,0 +1,146 @@
+import { cpSync, existsSync, readdirSync, renameSync, rmSync, statSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { ACTIONDOCK_VERSION } from "@actiondock/core";
+/**
+ * builder 包内共享的文件系统基础设施。
+ * 消除 pack / build / exporter 三个业务模块中成体系的重复实现，
+ * 保证目录扫描排序与原子移动等关键行为存在单一事实源。
+ */
+/**
+ * 跨文件系统/分区的原子移动目录辅助函数。
+ * 优先 rename，遇到瞬时性错误码按指数退避重试，最终回退为递归复制后删除。
+ */
+const TRANSIENT_MOVE_ERROR_CODES = new Set(["EPERM", "EBUSY", "EACCES", "ENOTEMPTY"]);
+const MOVE_RETRY_ATTEMPTS = 5;
+export async function moveDirAtomic(src, dest) {
+    let lastErr;
+    for (let attempt = 1; attempt <= MOVE_RETRY_ATTEMPTS; attempt++) {
+        try {
+            renameSync(src, dest);
+            return;
+        }
+        catch (err) {
+            lastErr = err;
+            if (err?.code === "EXDEV") {
+                // 跨文件系统/分区，立即转入跨设备原子搬迁流程
+                break;
+            }
+            if (!TRANSIENT_MOVE_ERROR_CODES.has(err?.code)) {
+                throw err;
+            }
+            await new Promise((r) => setTimeout(r, 50 * attempt));
+        }
+    }
+    if (lastErr?.code !== "EXDEV") {
+        throw lastErr;
+    }
+    // 跨设备场景：先复制到 dest 同父目录下的临时目录，再同设备 rename 保证 dest 提升的原子性
+    const tempDest = `${dest}.tmp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    try {
+        cpSync(src, tempDest, { recursive: true });
+        for (let attempt = 1; attempt <= MOVE_RETRY_ATTEMPTS; attempt++) {
+            try {
+                renameSync(tempDest, dest);
+                break;
+            }
+            catch (err) {
+                if (attempt === MOVE_RETRY_ATTEMPTS || !TRANSIENT_MOVE_ERROR_CODES.has(err?.code)) {
+                    throw err;
+                }
+                await new Promise((r) => setTimeout(r, 50 * attempt));
+            }
+        }
+        rmSync(src, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    }
+    catch (err) {
+        if (existsSync(tempDest)) {
+            try {
+                rmSync(tempDest, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+            }
+            catch {
+                // 忽略临时目录清理异常
+            }
+        }
+        throw err;
+    }
+}
+/**
+ * 递归收集目录内全部文件的相对路径（正斜杠分隔，名称排序）。
+ * 统一排序保证产物文件清单与内容摘要的确定性。
+ */
+export function collectRelativeFiles(dir, baseDir = dir) {
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    const entries = readdirSync(dir).sort();
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            results.push(...collectRelativeFiles(fullPath, baseDir));
+        }
+        else if (stat.isFile()) {
+            results.push(relative(baseDir, fullPath).split(sep).join("/"));
+        }
+    }
+    return results;
+}
+/**
+ * 获取内部 @actiondock/* 依赖的版本号规则。
+ * 预发布版本采用精确锁定，正式版本采用 ^ 语义范围。
+ */
+export function getInternalDependencyVersion(version = ACTIONDOCK_VERSION) {
+    if (version.includes("-")) {
+        return version;
+    }
+    return `^${version}`;
+}
+/**
+ * 以新目录原子替换已存在的目标目录（含失败回滚保护）。
+ * promotion 失败后优先 backup -> target 回滚；只有新 target 完整成功后才能删除 backup。
+ */
+export async function replaceDirAtomic(stagingDir, targetDir) {
+    if (existsSync(targetDir)) {
+        const backupDir = `${targetDir}.old-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        await moveDirAtomic(targetDir, backupDir);
+        try {
+            await moveDirAtomic(stagingDir, targetDir);
+        }
+        catch (promoteErr) {
+            // staging 提升失败：清理可能残留的损坏目标目录，并将 backup 恢复至 targetDir
+            if (existsSync(targetDir)) {
+                try {
+                    rmSync(targetDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+                }
+                catch {
+                    // 忽略清理残余异常
+                }
+            }
+            try {
+                await moveDirAtomic(backupDir, targetDir);
+            }
+            catch (rollbackErr) {
+                throw new Error(`Failed to promote directory to '${targetDir}' (${promoteErr instanceof Error ? promoteErr.message : String(promoteErr)}), and rollback from backup '${backupDir}' also failed: ${rollbackErr?.message || String(rollbackErr)}`);
+            }
+            throw promoteErr;
+        }
+        // 只有新 target 完整成功后才能删除 backup
+        rmSync(backupDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    }
+    else {
+        try {
+            await moveDirAtomic(stagingDir, targetDir);
+        }
+        catch (err) {
+            if (existsSync(targetDir)) {
+                try {
+                    rmSync(targetDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+                }
+                catch {
+                    // 忽略清理残余异常
+                }
+            }
+            throw err;
+        }
+    }
+}

package/dist/index.d.ts

@@ -1,7 +1,16 @@
-export * from "./types";
-export * from "./errors";
-export * from "./build";
-export * from "./planner";
-export * from "./compiler";
-export * from "./exporter";
-export * from "./archive";
+/**
+ * @actiondock/builder 公共导出面。
+ * 采用显式命名导出替代全量 export *，保证公开 API 边界清晰可控。
+ */
+export { BuilderError, PlannerError } from "./errors.js";
+export { collectRelativeFiles, getInternalDependencyVersion, moveDirAtomic, replaceDirAtomic, } from "./fs-utils.js";
+export { assertNoFileProtocolDeps, assertValidManifestActionIds, serializeManifestAction, serializeManifestPlaybooks, serializePlanManifest, } from "./manifest.js";
+export type { SerializePlanManifestOptions } from "./manifest.js";
+export { createTarGzArchive, createTarGzArchiveAsync, createZipArchive, createZipArchiveAsync, writeToStream, } from "./archive.js";
+export type { TarGzArchiveOptions } from "./archive.js";
+export { BuildPlanner, buildPlan, SelectionPlanner, selectionPlan } from "./planner.js";
+export { assertRelativeDependenciesIntegrity, extractRelativeSpecifiers, resolveRelativeModule, } from "./dependency-check.js";
+export { buildProject } from "./build.js";
+export { packProject } from "./pack.js";
+export { exportCompositeSkill, exportSkill, exportSkillBatch, findExistingCompositeSkillMd, findExistingSingleSkillMd, SkillExporter, } from "./exporter.js";
+export type { ActionDependency, ArchiveFormat, AssetDependency, BatchSkillExportOptions, BatchSkillExportResult, BuildOptions, BuildPlan, BuildPlanDependencies, BuildPlannerOptions, BuildResult, CompositeSkillExportOptions, CompositeSkillExportResult, ExternalDependency, LockfileInfo, PackOptions, PackResult, PlaybookPlanEntry, ProjectConfigWithDeclarations, SelectionPlan, SelectionPlannerOptions, SkillExporterOptions, SkillExportResult, } from "./types.js";