@actiondock/builder 2.7.0 → 2.9.0

package/dist/dependency-check.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
-import { isPathOutsideBoundary } from "@actiondock/core";
+import { isPathOutsideBoundary } from "@actiondock/core/project";
 import { BuilderError } from "./errors.js";
 /**
  * 移除源码中的单行与多行注释，防止注释内的相对路径字符串误触发依赖解析。
@@ -53,73 +53,60 @@ const RESOLUTION_EXTENSIONS = [
     ".cts",
     ".json",
 ];
+/**
+ * 将路径解析为物理真实路径：不存在时回退到逻辑绝对路径，realpath 失败时同样回退。
+ */
+function toRealPath(p) {
+    try {
+        return existsSync(p) ? realpathSync(p) : resolve(p);
+    }
+    catch {
+        return resolve(p);
+    }
+}
+/**
+ * 判断候选路径是否为磁盘上真实存在的文件。
+ */
+function isFileReal(cand) {
+    return existsSync(cand) && statSync(cand).isFile();
+}
 /**
  * 将相对模块说明符解析为磁盘上的物理真实文件路径。
  */
 export function resolveRelativeModule(fromDir, specifier) {
     const basePath = resolve(fromDir, specifier);
     // 1. 精确匹配文件
-    if (existsSync(basePath) && statSync(basePath).isFile()) {
-        try {
-            return realpathSync(basePath);
-        }
-        catch {
-            return basePath;
-        }
+    if (isFileReal(basePath)) {
+        return toRealPath(basePath);
     }
     // 2. ESM TypeScript 映射：导入写了 .js / .mjs / .cjs，但在源码中真实文件为 .ts / .mts / .cts
     if (specifier.endsWith(".js")) {
         const tsCandidate = basePath.slice(0, -3) + ".ts";
-        if (existsSync(tsCandidate) && statSync(tsCandidate).isFile()) {
-            try {
-                return realpathSync(tsCandidate);
-            }
-            catch {
-                return tsCandidate;
-            }
+        if (isFileReal(tsCandidate)) {
+            return toRealPath(tsCandidate);
         }
         const tsxCandidate = basePath.slice(0, -3) + ".tsx";
-        if (existsSync(tsxCandidate) && statSync(tsxCandidate).isFile()) {
-            try {
-                return realpathSync(tsxCandidate);
-            }
-            catch {
-                return tsxCandidate;
-            }
+        if (isFileReal(tsxCandidate)) {
+            return toRealPath(tsxCandidate);
         }
     }
     else if (specifier.endsWith(".mjs")) {
         const mtsCandidate = basePath.slice(0, -4) + ".mts";
-        if (existsSync(mtsCandidate) && statSync(mtsCandidate).isFile()) {
-            try {
-                return realpathSync(mtsCandidate);
-            }
-            catch {
-                return mtsCandidate;
-            }
+        if (isFileReal(mtsCandidate)) {
+            return toRealPath(mtsCandidate);
         }
     }
     else if (specifier.endsWith(".cjs")) {
         const ctsCandidate = basePath.slice(0, -4) + ".cts";
-        if (existsSync(ctsCandidate) && statSync(ctsCandidate).isFile()) {
-            try {
-                return realpathSync(ctsCandidate);
-            }
-            catch {
-                return ctsCandidate;
-            }
+        if (isFileReal(ctsCandidate)) {
+            return toRealPath(ctsCandidate);
         }
     }
     // 3. 补充扩展名尝试
     for (const ext of RESOLUTION_EXTENSIONS) {
         const cand = basePath + ext;
-        if (existsSync(cand) && statSync(cand).isFile()) {
-            try {
-                return realpathSync(cand);
-            }
-            catch {
-                return cand;
-            }
+        if (isFileReal(cand)) {
+            return toRealPath(cand);
         }
     }
     // 4. 目录默认 index 尝试
@@ -127,13 +114,8 @@ export function resolveRelativeModule(fromDir, specifier) {
         if (ext === "")
             continue;
         const cand = join(basePath, `index${ext}`);
-        if (existsSync(cand) && statSync(cand).isFile()) {
-            try {
-                return realpathSync(cand);
-            }
-            catch {
-                return cand;
-            }
+        if (isFileReal(cand)) {
+            return toRealPath(cand);
         }
     }
     return undefined;
@@ -144,59 +126,24 @@ export function resolveRelativeModule(fromDir, specifier) {
  */
 export function assertRelativeDependenciesIntegrity(projectRoot, plan) {
     const root = resolve(projectRoot);
-    let realRoot;
-    try {
-        realRoot = existsSync(root) ? realpathSync(root) : root;
-    }
-    catch {
-        realRoot = root;
-    }
+    const realRoot = toRealPath(root);
     // 收集已包含在构建规划中的全部文件物理绝对路径
     const collectedPaths = new Set();
     for (const act of plan.actions) {
         if (act.resolvedPath) {
-            try {
-                const real = existsSync(act.resolvedPath)
-                    ? realpathSync(act.resolvedPath)
-                    : resolve(act.resolvedPath);
-                collectedPaths.add(real);
-            }
-            catch {
-                collectedPaths.add(resolve(act.resolvedPath));
-            }
+            collectedPaths.add(toRealPath(act.resolvedPath));
         }
     }
     for (const dep of plan.dependencies.modulesAndAssets) {
         if (dep.resolvedPath) {
-            try {
-                const real = existsSync(dep.resolvedPath)
-                    ? realpathSync(dep.resolvedPath)
-                    : resolve(dep.resolvedPath);
-                collectedPaths.add(real);
-            }
-            catch {
-                collectedPaths.add(resolve(dep.resolvedPath));
-            }
+            collectedPaths.add(toRealPath(dep.resolvedPath));
         }
     }
     // 待校验文件队列（包括全部 Action 及其收集的 TS/JS 模块）
     const queue = [];
     for (const act of plan.actions) {
         if (act.resolvedPath && existsSync(act.resolvedPath)) {
-            try {
-                queue.push({
-                    file: existsSync(act.resolvedPath)
-                        ? realpathSync(act.resolvedPath)
-                        : resolve(act.resolvedPath),
-                    actionId: act.id,
-                });
-            }
-            catch {
-                queue.push({
-                    file: resolve(act.resolvedPath),
-                    actionId: act.id,
-                });
-            }
+            queue.push({ file: toRealPath(act.resolvedPath), actionId: act.id });
         }
     }
     const visited = new Set();

package/dist/export-batch.js

@@ -1,7 +1,8 @@
 import { mkdirSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { getPackageSlug, loadProjectConfig } from "@actiondock/core";
+import { loadProjectConfig } from "@actiondock/core";
 import { BuilderError } from "./errors.js";
+import { allocatePackageDirName } from "./manifest.js";
 /**
  * 执行批量导出多个 Skill。
  */
@@ -15,11 +16,8 @@ export async function exportBatchImpl(options, exportSingle) {
     const usedDirNames = new Set();
     for (const projectRoot of options.projectRoots) {
         const config = loadProjectConfig(projectRoot);
-        let pkgSlug = getPackageSlug(config.id);
-        if (usedDirNames.has(pkgSlug)) {
-            pkgSlug = config.id.replace(/[^a-zA-Z0-9-_]/g, "-").replace(/^-+|-+$/g, "");
-        }
-        usedDirNames.add(pkgSlug);
+        // 目录名分配统一复用 manifest 的 allocatePackageDirName，回退后仍冲突会追加数字后缀
+        const pkgSlug = allocatePackageDirName(usedDirNames, config.id);
         const pkgOutDir = join(baseOutDir, `${pkgSlug}-skill`);
         const res = await exportSingle({
             ...options,

package/dist/export-composite.js

@@ -1,9 +1,11 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
-import { generateCompositeSkillMd, getPackageSlug, loadManifest, loadPlaybooks, loadProjectConfig, } from "@actiondock/core";
+import { loadProjectConfig, } from "@actiondock/core";
+import { getPackageSlug, loadManifest, loadPlaybooks, } from "@actiondock/core/project";
+import { generateCompositeSkillMd } from "./skill/index.js";
 import { BuilderError } from "./errors.js";
 import { collectRelativeFiles, getInternalDependencyVersion, replaceDirAtomic } from "./fs-utils.js";
-import { assertNoFileProtocolDeps, resolveWorkspaceDepVersion } from "./manifest.js";
+import { allocatePackageDirName, sanitizeExportDependencies } from "./manifest.js";
 import { SelectionPlanner } from "./planner.js";
 import { findExistingCompositeSkillMd, resolveCustomSkillDeclaration, } from "./skill-md.js";
 import { createArchive, resolveArchiveFormat } from "./export-archive.js";
@@ -65,11 +67,8 @@ export async function exportCompositeImpl(options, exportSubpackage) {
                 pkgSlug = basename(resolve(projectRoot));
             }
             else {
-                pkgSlug = getPackageSlug(config.id);
-                if (usedDirNames.has(pkgSlug)) {
-                    pkgSlug = config.id.replace(/[^a-zA-Z0-9-_]/g, "-").replace(/^-+|-+$/g, "");
-                }
-                usedDirNames.add(pkgSlug);
+                // 目录名分配统一复用 manifest 的 allocatePackageDirName，回退后仍冲突会追加数字后缀
+                pkgSlug = allocatePackageDirName(usedDirNames, config.id);
             }
             let actionIds;
             let playbookIds;
@@ -179,6 +178,7 @@ export async function exportCompositeImpl(options, exportSubpackage) {
 }
 /**
  * 复合套件聚合各子包依赖并生成复合根目录 package.json。
+ * 依赖清洗统一复用 manifest 的 sanitizeExportDependencies 单一入口，与单包导出口径一致。
  */
 function writeCompositePkgJson(stagingDir, packagesDestDir, packageInfos, bundleSlug, options) {
     const aggregatedDeps = {
@@ -189,21 +189,7 @@ function writeCompositePkgJson(stagingDir, packagesDestDir, packageInfos, bundle
         if (existsSync(pkgJsonPath)) {
             try {
                 const parsed = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
-                if (parsed.dependencies && typeof parsed.dependencies === "object") {
-                    assertNoFileProtocolDeps(parsed.dependencies, "exported skill packages");
-                    for (const [dep, ver] of Object.entries(parsed.dependencies)) {
-                        const verStr = String(ver);
-                        if (dep.startsWith("@actiondock/")) {
-                            aggregatedDeps[dep] = getInternalDependencyVersion();
-                        }
-                        else if (verStr.startsWith("workspace:")) {
-                            aggregatedDeps[dep] = resolveWorkspaceDepVersion(join(packagesDestDir, info.packageDir), dep, verStr);
-                        }
-                        else {
-                            aggregatedDeps[dep] = verStr;
-                        }
-                    }
-                }
+                Object.assign(aggregatedDeps, sanitizeExportDependencies(join(packagesDestDir, info.packageDir), parsed.dependencies, "exported skill packages", false));
             }
             catch (err) {
                 if (err instanceof BuilderError)

package/dist/export-node.js

@@ -1,4 +1,4 @@
-import { generateStandaloneSkillMd } from "@actiondock/core";
+import { generateStandaloneSkillMd } from "./skill/index.js";
 import { buildProject } from "./build.js";
 import { collectRelativeFiles } from "./fs-utils.js";
 import { buildConfigForTemplates, toPlaybookDefinitions, toSkillActionItems, writeSkillMd, } from "./skill-md.js";

package/dist/export-source.js

@@ -1,9 +1,10 @@
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
-import { basename, dirname, join } from "node:path";
-import { generateSourceSkillMd } from "@actiondock/core";
+import { copyFileSync, existsSync, readFileSync, writeFileSync, } from "node:fs";
+import { basename, join } from "node:path";
+import { generateSourceSkillMd } from "./skill/index.js";
 import { BuilderError } from "./errors.js";
 import { getInternalDependencyVersion } from "./fs-utils.js";
-import { assertValidManifestActionIds, resolveWorkspaceDepVersion, serializePlanManifest, } from "./manifest.js";
+import { assertValidManifestActionIds, sanitizeExportDependencies, serializePlanManifest, } from "./manifest.js";
+import { copyPlanEntries } from "./stage-sources.js";
 import { buildConfigForTemplates, toPlaybookDefinitions, toSkillActionItems, writeSkillMd, } from "./skill-md.js";
 /**
  * 源码型 Skill 导出装配层。
@@ -17,10 +18,6 @@ import { buildConfigForTemplates, toPlaybookDefinitions, toSkillActionItems, wri
 export function stageSourceSkill(root, skillDir, plan, options, pkgSlug) {
     const actionsDir = plan.actionsDir || "actions";
     const playbooksDir = plan.playbooksDir || "playbooks";
-    const playbooksDestDir = join(skillDir, playbooksDir);
-    if (plan.playbooks.length > 0) {
-        mkdirSync(playbooksDestDir, { recursive: true });
-    }
     const configForTemplates = buildConfigForTemplates(plan, actionsDir, playbooksDir);
     const usedExistingSkillMd = writeSkillMd(root, skillDir, plan, { skipSkillMd: options.skipSkillMd, skillMdPath: options.skillMdPath, pkgSlug }, () => generateSourceSkillMd(configForTemplates, toSkillActionItems(plan.actions), toPlaybookDefinitions(plan.playbooks)));
     // 导出精简后的 actiondock.json 项目配置（项目元数据与清单的单一事实源）
@@ -39,63 +36,16 @@ export function stageSourceSkill(root, skillDir, plan, options, pkgSlug) {
     if (existsSync(tsconfigPath)) {
         copyFileSync(tsconfigPath, join(skillDir, "tsconfig.json"));
     }
-    // 拷贝 Action 源码文件，保留相对路径（仅拷贝自有 Action，跨包依赖不物化进消费包目录）
-    for (const act of plan.actions) {
-        if (act.isExternal || act.id.includes("/")) {
-            continue;
-        }
-        if (existsSync(act.resolvedPath)) {
-            const destFile = join(skillDir, act.entry);
-            mkdirSync(dirname(destFile), { recursive: true });
-            copyFileSync(act.resolvedPath, destFile);
-        }
-    }
-    // 拷贝静态资产与代码模块文件，保留相对路径
-    for (const dep of plan.dependencies.modulesAndAssets) {
-        if ((dep.type === "asset" || dep.type === "module" || dep.type === "file") &&
-            existsSync(dep.resolvedPath)) {
-            const destAsset = join(skillDir, dep.path);
-            mkdirSync(dirname(destAsset), { recursive: true });
-            copyFileSync(dep.resolvedPath, destAsset);
-        }
-    }
-    // 拷贝 Playbook 规程文件
-    for (const pb of plan.playbooks) {
-        if (existsSync(pb.filePath)) {
-            const destPb = join(playbooksDestDir, basename(pb.filePath));
-            copyFileSync(pb.filePath, destPb);
-        }
-    }
+    // 拷贝 Action 源码、静态资产与 Playbook 规程文件（共享拷贝内核，行为与 stage-sources 单一事实源对齐）
+    copyPlanEntries(skillDir, plan, {
+        playbookRelPath: (pb) => join(playbooksDir, basename(pb.filePath)),
+    });
     return usedExistingSkillMd;
 }
 /**
- * 生成源码型 Skill 的 package.json（含依赖协议校验与 workspace 版本解析）。
+ * 生成源码型 Skill 的 package.json（依赖清洗统一复用 manifest 的 sanitizeExportDependencies 单一入口）。
  */
 function writeSourceSkillPkgJson(root, skillDir, plan, pkgSlug) {
-    const sanitizeDependencies = (deps) => {
-        const result = {};
-        if (deps && typeof deps === "object") {
-            for (const [k, v] of Object.entries(deps)) {
-                const verStr = String(v);
-                if (verStr.startsWith("file:")) {
-                    throw new BuilderError(`Unsupported file: dependency for '${k}'. Runtime dependencies must not use file: protocol in exported skill packages.`);
-                }
-                if (k.startsWith("@actiondock/")) {
-                    result[k] = getInternalDependencyVersion();
-                }
-                else if (verStr.startsWith("workspace:")) {
-                    result[k] = resolveWorkspaceDepVersion(root, k, verStr);
-                }
-                else {
-                    result[k] = verStr;
-                }
-            }
-        }
-        if (!result["@actiondock/sdk"]) {
-            result["@actiondock/sdk"] = getInternalDependencyVersion();
-        }
-        return result;
-    };
     let exportedPkg;
     const projectPkgPath = join(root, "package.json");
     if (existsSync(projectPkgPath)) {
@@ -107,7 +57,7 @@ function writeSourceSkillPkgJson(root, skillDir, plan, pkgSlug) {
                 version: plan.version || parsed.version || "0.1.0",
                 description: plan.description || parsed.description,
                 type: "module",
-                dependencies: sanitizeDependencies(parsed.dependencies),
+                dependencies: sanitizeExportDependencies(root, parsed.dependencies, "exported skill packages"),
             };
         }
         catch (err) {

package/dist/exporter.js

@@ -1,10 +1,11 @@
 import { existsSync, mkdirSync, rmSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
-import { getPackageSlug } from "@actiondock/core";
+import { getPackageSlug } from "@actiondock/core/project";
 import { BuilderError } from "./errors.js";
 import { replaceDirAtomic } from "./fs-utils.js";
 import { collectRelativeFiles } from "./fs-utils.js";
 import { SelectionPlanner } from "./planner.js";
+import { isOwnAction } from "./types.js";
 import { createArchive, resolveArchiveFormat } from "./export-archive.js";
 import { stageSourceSkill } from "./export-source.js";
 import { exportNodeSkill } from "./export-node.js";
@@ -24,13 +25,6 @@ export class SkillExporter {
      * @returns 导出产物详细描述
      */
     async export(options) {
-        // 彻底废弃旧的独立二进制编译分支与参数
-        if (options.standalone ||
-            options.mode === "standalone" ||
-            options.target !== undefined ||
-            options.bytecode !== undefined) {
-            throw new BuilderError("The '--standalone' mode has been removed in ActionDock 2.0. Please use '--mode node' for self-contained Node.js directory skills, or '--mode source' for source-based skills.", "UNSUPPORTED_BUILD_MODE");
-        }
         const root = resolve(options.projectRoot);
         const mode = options.mode === "node" ? "node" : "source";
         // 调用 SelectionPlanner 执行声明式构建规划
@@ -109,7 +103,7 @@ export class SkillExporter {
         if (options.archive) {
             archivePath = await createArchive(targetSkillDir, resolveArchiveFormat(options));
         }
-        const ownActions = plan.actions.filter((a) => !a.isExternal && !a.id.includes("/"));
+        const ownActions = plan.actions.filter((a) => isOwnAction(a));
         return {
             packageId: plan.packageId,
             version: plan.version,

package/dist/fs-utils.d.ts

@@ -2,9 +2,10 @@ export declare function moveDirAtomic(src: string, dest: string): Promise<void>;
 /**
  * 递归收集目录内全部文件的相对路径（正斜杠分隔）。
  * 收集完成后对最终 POSIX 相对路径统一排序，保证跨平台 digest 一致性；
- * 符号链接防护策略与 archive.ts collectEntries 对齐：越出根边界的软链接与循环软链接直接跳过。
+ * 目录遍历统一复用 core 的 traverseDirectory 单一事实源，
+ * 自带软链接越界跳过与循环拦截防护。
  */
-export declare function collectRelativeFiles(dir: string, baseDir?: string): string[];
+export declare function collectRelativeFiles(dir: string): string[];
 /**
  * 获取内部 @actiondock/* 依赖的版本号规则。
  * 预发布版本采用精确锁定，正式版本采用 ^ 语义范围。

package/dist/fs-utils.js

@@ -1,6 +1,6 @@
-import { cpSync, existsSync, readdirSync, realpathSync, renameSync, rmSync, statSync } from "node:fs";
-import { join, relative, sep } from "node:path";
-import { ACTIONDOCK_VERSION, assertPathWithinRoot } from "@actiondock/core";
+import { cpSync, existsSync, renameSync, rmSync } from "node:fs";
+import { ACTIONDOCK_VERSION } from "@actiondock/core";
+import { traverseDirectory } from "@actiondock/core/project";
 /**
  * builder 包内共享的文件系统基础设施。
  * 消除 pack / build / exporter 三个业务模块中成体系的重复实现，
@@ -67,72 +67,15 @@ export async function moveDirAtomic(src, dest) {
 /**
  * 递归收集目录内全部文件的相对路径（正斜杠分隔）。
  * 收集完成后对最终 POSIX 相对路径统一排序，保证跨平台 digest 一致性；
- * 符号链接防护策略与 archive.ts collectEntries 对齐：越出根边界的软链接与循环软链接直接跳过。
+ * 目录遍历统一复用 core 的 traverseDirectory 单一事实源，
+ * 自带软链接越界跳过与循环拦截防护。
  */
-export function collectRelativeFiles(dir, baseDir = dir) {
-    const results = collectRelativeFilesUnsorted(dir, baseDir, new Set());
-    return results.sort();
-}
-function collectRelativeFilesUnsorted(dir, baseDir, visited) {
+export function collectRelativeFiles(dir) {
     if (!existsSync(dir))
         return [];
-    if (visited.size === 0) {
-        try {
-            visited.add(existsSync(baseDir) ? realpathSync(baseDir) : baseDir);
-        }
-        catch {
-            // 忽略根目录真实路径解析异常，退化为不携带根真实路径的循环拦截
-        }
-    }
-    const results = [];
-    let entries;
-    try {
-        entries = readdirSync(dir).sort();
-    }
-    catch {
-        return [];
-    }
-    for (const entry of entries) {
-        const fullPath = join(dir, entry);
-        try {
-            assertPathWithinRoot(baseDir, fullPath, "collect files path");
-        }
-        catch {
-            continue;
-        }
-        let real;
-        try {
-            real = existsSync(fullPath) ? realpathSync(fullPath) : fullPath;
-        }
-        catch {
-            continue;
-        }
-        try {
-            assertPathWithinRoot(baseDir, real, "collect files path");
-        }
-        catch {
-            // 忽略并跳过指向 baseDir 外部的软链接，与归档防护策略保持一致
-            continue;
-        }
-        if (visited.has(real)) {
-            continue;
-        }
-        visited.add(real);
-        try {
-            const stat = statSync(fullPath);
-            if (stat.isDirectory()) {
-                results.push(...collectRelativeFilesUnsorted(fullPath, baseDir, visited));
-            }
-            else if (stat.isFile()) {
-                results.push(relative(baseDir, fullPath).split(sep).join("/"));
-            }
-        }
-        catch {
-            // 忽略无法访问或损坏的文件/符号链接
-            continue;
-        }
-    }
-    return results;
+    return traverseDirectory(dir)
+        .map((entry) => entry.relPath)
+        .sort();
 }
 /**
  * 获取内部 @actiondock/* 依赖的版本号规则。

package/dist/index.d.ts

@@ -1,17 +1,10 @@
 /**
  * @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, dosDateTime, writeToStream, } from "./archive.js";
-export type { TarGzArchiveOptions } from "./archive.js";
-export { SelectionPlanner } 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, SkillExporter, } from "./exporter.js";
-export { findExistingCompositeSkillMd, findExistingSingleSkillMd, } from "./skill-md.js";
-export type { ActionDependency, ArchiveFormat, AssetDependency, BatchSkillExportOptions, BatchSkillExportResult, BuildOptions, BuildPlan, BuildPlanDependencies, BuildResult, CompositeSkillExportOptions, CompositeSkillExportResult, ExternalDependency, LockfileInfo, PackOptions, PackResult, PlaybookPlanEntry, ProjectConfigWithDeclarations, SelectionPlan, SelectionPlannerOptions, SkillExporterOptions, SkillExportResult, } from "./types.js";
+export { SelectionPlanner } from "./planner.js";
+export type { ArchiveFormat, BatchSkillExportOptions, BatchSkillExportResult, BuildOptions, BuildPlan, BuildResult, CompositeSkillExportOptions, CompositeSkillExportResult, ExportSkillOptions, ExportSkillResult, PackOptions, PackResult, SelectionPlan, SelectionPlannerOptions, SkillExporterOptions, SkillExportResult, } from "./types.js";

package/dist/index.js

@@ -1,23 +1,12 @@
 /**
  * @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 { createTarGzArchive, createTarGzArchiveAsync, createZipArchive, createZipArchiveAsync, dosDateTime, writeToStream, } from "./archive.js";
-// 构建规划
-export { SelectionPlanner } from "./planner.js";
-// 相对依赖完整性校验
-export { assertRelativeDependenciesIntegrity, extractRelativeSpecifiers, resolveRelativeModule, } from "./dependency-check.js";
-// 目录型构建与 npm 打包
+// 构建、打包与导出主接口
 export { buildProject } from "./build.js";
 export { packProject } from "./pack.js";
-// Skill 导出
-// 入口函数与导出器门面位于 ./exporter；SKILL.md 发现能力单一事实源位于 ./skill-md
 export { exportCompositeSkill, exportSkill, exportSkillBatch, SkillExporter, } from "./exporter.js";
-export { findExistingCompositeSkillMd, findExistingSingleSkillMd, } from "./skill-md.js";
+// 构建规划器
+export { SelectionPlanner } from "./planner.js";

package/dist/manifest.d.ts

@@ -64,6 +64,32 @@ export declare function assertNoFileProtocolDeps(dependencies: Record<string, un
  * workspace:* 则在本地 node_modules 与 monorepo packages 目录中搜索目标包版本。
  */
 export declare function resolveWorkspaceDepVersion(root: string, depName: string, ver: string): string;
+/**
+ * 为导出子包分配互不冲突的目录名。
+ *
+ * 首选 Package ID 尾段（getPackageSlug）；冲突时回退为 ID 全量的安全形式，
+ * 回退后仍冲突（如两个同尾段 ID 回退值相同）则追加数字后缀直至唯一，
+ * 严禁仅加入 used 集合而不二次消歧导致目录互相覆盖。
+ *
+ * @param used 已占用的目录名集合（函数内部会登记分配结果）
+ * @param configId 待分配目录名的 Package ID
+ */
+export declare function allocatePackageDirName(used: Set<string>, configId: string): string;
+/**
+ * 导出产物依赖清洗单一入口。
+ *
+ * 清洗规则（单包源码导出与复合套件聚合导出共用同一事实源）：
+ * - file: 本地协议拒绝（经 assertNoFileProtocolDeps）；
+ * - @actiondock/* 内部依赖覆写为内部版本规则；
+ * - workspace: 前缀解析为真实版本（经 resolveWorkspaceDepVersion）；
+ * - 其余依赖原样保留。
+ *
+ * @param root 解析 workspace 依赖时的参照根目录
+ * @param deps 待清洗的依赖字典（可选）
+ * @param context 错误消息中的场景描述
+ * @param ensureSdk 是否保证 @actiondock/sdk 依赖存在（单包导出需要，复合根目录已预置）
+ */
+export declare function sanitizeExportDependencies(root: string, deps: Record<string, unknown> | undefined, context: string, ensureSdk?: boolean): Record<string, string>;
 /**
  * 读取并解析 package.json，解析失败抛出 BuilderError。
  */