@actiondock/builder 2.15.0 → 2.17.0

package/dist/skill/templates.js

@@ -13,7 +13,7 @@ function renderActionListMarkdown(actions, options = {}) {
         .map((a) => {
         const aDesc = a.description ? ` - ${a.description}` : "";
         const idLabel = options.packageId
-            ? `\`${options.packageId}/${a.id}\``
+            ? `\`${options.packageId}/${a.id}\` (或 \`${a.id}\`)`
             : `\`${a.id}\``;
         const lines = [`- ${idLabel}${aDesc}`];
         // 标注元数据解析（安全标注不得从主说明移走）
@@ -124,60 +124,30 @@ function renderJsonEnvelopeSection(wording, options) {
  * 由主说明按需链接调阅，不在每个技能正文重复展开整套安装与框架管理教程。
  */
 export function renderRuntimeReferenceContent(options) {
-    if (options.invocationStyle === "node-entry") {
-        const entry = options.entryRelPath || "node ./entry.mjs";
-        return `# ActionDock 运行时环境参考
-
-本技能为独立 Node.js 运行目录交付，直接使用随附的 \`${entry}\` 入口执行，不要求全局安装 ActionDock 命令行工具，不读取 Registry 或当前工作目录项目。
-
-## 调用方式
-
-\`\`\`bash
-${entry} list
-${entry} describe <package-id>/<action-id>
-${entry} run <package-id>/<action-id> -- ASSIGNMENT...
-\`\`\`
-
-## 按需排查与依赖安装
-
-正常执行直接调用入口，不做前置体检。仅在模块缺失或运行环境报错时修复：
-
-- Node.js 版本要求大于等于 24.12.0。
-- ${options.dependencyStepLabel}：在技能根目录执行 \`npm install --omit=dev\`，由 npm 安装生产依赖。
-- 默认共享统一数据存储。仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`。
-- 验证就绪：执行 \`${entry} list\`。
-`;
-    }
-    if (options.invocationStyle === "source-ad") {
-        return `# ActionDock 运行时环境参考
-
-本技能通过 \`ad ... -P "<skill_root>"\` 执行，封闭加载本地包集合，不读取全局 Registry 或当前工作目录项目。
-
-## 调用方式
+    const relinkNote = options.compositeLinkNote
+        ? `\`ad link\` 会自动识别并注册工作区下的所有子包，使其中的 Action 随时可以通过完全限定标识调用。`
+        : "";
+    const invocationSection = options.invocationStyle === "node-entry"
+        ? `本技能为 Node 目录型交付，可直接使用自身入口执行，不要求全局安装 \`ad\` 命令行工具：
 
 \`\`\`bash
-ad list -P "<skill_root>"
-ad describe <package-id>/<action-id> -P "<skill_root>"
-ad run <package-id>/<action-id> -P "<skill_root>" -- ASSIGNMENT...
+${options.entryRelPath || "node ./entry.mjs"} list
+${options.entryRelPath || "node ./entry.mjs"} describe <action-id>
+${options.entryRelPath || "node ./entry.mjs"} run <action-id> -- ASSIGNMENT...
 \`\`\`
 
-本地封闭执行不支持 \`--async\`。默认共享统一数据存储，仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`。
-
-## 按需排查与依赖安装
-
-正常执行直接调用入口，不做前置体检。仅在模块缺失或运行环境报错时修复：
-
-- Node.js 版本要求大于等于 24.12.0。
-- ${options.dependencyStepLabel}：在技能根目录执行 \`npm install --omit=dev\`，由 npm 安装生产依赖。
-- 验证就绪：执行 \`ad list -P "<skill_root>"\`。
-`;
-    }
-    const relinkNote = options.compositeLinkNote
-        ? `\`ad link\` 会自动识别并注册工作区下的所有子包，使其中的 Action 随时可以通过完全限定标识调用。`
-        : "";
-    const invocationSection = `本说明书用于开发工作区，通过全局安装的 \`ad\` 命令行工具执行，不代表完整技能导出。`;
-    const probePrinciple = `默认宿主环境中已预置 \`ad\` 命令行工具与 Node.js 运行环境。正常执行流程直接调用上述 Action 即可，严禁在任务启动前盲目进行前置环境检查或体检；仅在终端明确报错提示命令不存在或依赖缺失时，方可按本文指引安装初始化。`;
-    const cliInstallSection = `- **环境要求**：Node.js 版本大于等于 24.12.0（执行 \`node -v\` 确认）。
+若宿主环境已全局安装 \`ad\`，亦可将其链接后统一调度。`
+        : `本技能为源码型交付，通过全局安装的 \`ad\` 命令行工具执行。`;
+    const isNodeEntry = options.invocationStyle === "node-entry";
+    const probePrinciple = isNodeEntry
+        ? `默认宿主环境中已预置 Node.js 运行环境。本目录型交付直接使用自身入口执行，不依赖全局 \`ad\`；正常执行流程直接调用上述 Action 即可，严禁在任务启动前盲目进行前置环境检查或体检；仅在入口报错提示模块缺失（如 \`Cannot find package\`）或 Node.js 版本不满足时，方可按本文指引修复。`
+        : `默认宿主环境中已预置 \`ad\` 命令行工具与 Node.js 运行环境。正常执行流程直接调用上述 Action 即可，严禁在任务启动前盲目进行前置环境检查或体检；仅在终端明确报错提示命令不存在（如 \`ad: command not found\`）或提示依赖缺失时，方可按本文指引安装初始化。`;
+    const cliInstallSection = isNodeEntry
+        ? `- **Node.js 环境要求**：Node.js 版本大于等于 24.12.0（执行 \`node -v\` 确认）。目录型交付不需要全局安装 \`ad\`；若需要接入全局调度，可另行安装：
+  \`\`\`bash
+  npm install -g @actiondock/cli
+  \`\`\``
+        : `- **环境要求**：Node.js 版本大于等于 24.12.0（执行 \`node -v\` 确认）。
 - **全局安装 ActionDock 命令行工具**：
   \`\`\`bash
   npm install -g @actiondock/cli
@@ -205,7 +175,7 @@ ${cliInstallSection}
   cd "<skill_root>" && npm install --omit=dev
   \`\`\`
 - **验证就绪**：
-  ad --version
+  ${isNodeEntry ? `${options.entryRelPath || "node ./entry.mjs"} list` : "ad --version"}
 - **环境诊断与体检**（仅全局接入 \`ad\` 后适用）：
   安装完成后若仍遇到异常，执行体检命令排查：
   \`\`\`bash
@@ -234,9 +204,10 @@ function renderTroubleshootingSection(referenceRelPath) {
 export const RUNTIME_REFERENCE_REL_PATH = "references/actiondock-runtime.md";
 export function generateSourceSkillMd(config, actions, playbooks) {
     const { cleanName, desc } = getCleanSkillMetadata(config);
-    const firstAction = `${config.id}/${actions[0]?.id || "sample.greet"}`;
-    const defaultDescribe = `ad describe ${firstAction} -P "<skill_root>"`;
-    const defaultRun = `ad run ${firstAction} -P "<skill_root>"`;
+    const pkgId = config.id;
+    const firstAction = actions[0]?.id || "sample.greet";
+    const playbookSection = renderPlaybookSectionMarkdown(playbooks, config.playbooksDir || "playbooks");
+    const actionListMd = renderActionListMarkdown(actions, { packageId: pkgId });
     return `---
 name: ${cleanName}
 description: ${desc}
@@ -246,32 +217,56 @@ description: ${desc}
 
 ${desc}
 
-## 本地执行
+## ActionDock 运行时
+
+本技能为 **ActionDock 源码型技能包**。智能体可直接通过宿主环境中已安装的 ActionDock 命令行工具 \`ad\` 执行其中的 Action。
+
+### 注册与链接（全局调用）
+
+本技能面向全局挂载使用：在初次调用或初始化时，将包含本 \`SKILL.md\` 的目录解析为 \`<skill_root>\` 并完成注册链接，之后可在任意工作目录通过完全限定 ID 全局调用：
+
+\`\`\`bash
+ad link "<skill_root>"
+\`\`\`
+
+> \`ad link\` 天然具备幂等性，同一 Package 多次执行会直接更新路径，可安全重复调用。若初次运行提示依赖缺失，可在 \`<skill_root>\` 目录下执行 \`npm install --omit=dev\` 安装生产依赖。
 
-将本文件所在目录解析为 \`<skill_root>\`。默认通过 \`ad ... -P "<skill_root>"\` 执行，只加载随附的确定版本包，不读取 Registry 或当前工作目录项目，不需要 \`ad link\`。
-首次缺少依赖时，在技能根目录执行 \`npm install --omit=dev\`。
-默认共享统一数据存储，仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`。
-本地封闭执行不支持 \`--async\`。
+### 动作参数契约按需调阅
 
-${renderInvocationGuidance(defaultDescribe, defaultRun)}
+在调用未知参数的 Action 前，可在终端执行命令查阅该 Action 的输入输出模式与详细说明：
+
+\`\`\`bash
+ad describe ${pkgId}/${firstAction}
+\`\`\`
+
+### 执行 Action
+
+为避免多技能之间的 Action ID 命名冲突，建议统一使用带有 Package 前缀的完全限定 ID。
+
+${renderInvocationGuidance(`ad describe ${pkgId}/${firstAction}`, `ad run ${pkgId}/${firstAction}`)}
 
 ${renderJsonEnvelopeSection("envelope")}
-${renderPlaybookSectionMarkdown(playbooks, config.playbooksDir || "playbooks")}
+${playbookSection}
+---
 
 ## Action 目录
 
-${renderActionListMarkdown(actions, { packageId: config.id })}
+${actionListMd}
+
+---
 
 ## 运行时配置与持久化状态
 
+如需检查或配置该 Package 的运行时参数与持久化数据：
+
 \`\`\`bash
 # 查看与设置配置项
-ad config list -P "<skill_root>"
-ad config set KEY VALUE -P "<skill_root>"
+ad config list --package ${pkgId}
+ad config set KEY VALUE --package ${pkgId}
 
 # 查看与检索状态数据
-ad state list -P "<skill_root>"
-ad state get KEY -P "<skill_root>"
+ad state list --package ${pkgId}
+ad state get KEY --package ${pkgId}
 \`\`\`
 
 ${renderTroubleshootingSection(RUNTIME_REFERENCE_REL_PATH)}
@@ -367,8 +362,8 @@ export function generateCompositeSkillMd(bundleName, description, packages, opti
     for (const pkg of packages) {
         for (const pb of pkg.playbooks) {
             const relPath = packagesBaseDir === "."
-                ? `./${pkg.packageDir}/${pkg.config.playbooksDir || "playbooks"}/${basename(pb.filePath)}`
-                : `packages/${pkg.packageDir}/${pkg.config.playbooksDir || "playbooks"}/${basename(pb.filePath)}`;
+                ? `./${pkg.packageDir}/playbooks/${basename(pb.filePath)}`
+                : `packages/${pkg.packageDir}/playbooks/${basename(pb.filePath)}`;
             playbookEntries.push(`- [${pb.name || pb.id}](${relPath}): ${pb.description || "标准操作规程"}`);
         }
     }
@@ -380,36 +375,12 @@ description: ${description}
 # ${bundleName} 复合技能套件
 
 ${description}`;
-    const invocationStyle = options?.invocationStyle ?? "source-ad";
-    const isGlobalAd = invocationStyle === "global-ad";
-    const isNodeEntry = invocationStyle === "node-entry";
-    const describeCmd = isGlobalAd
-        ? `ad describe ${sampleActionId}`
-        : isNodeEntry
-            ? `node "<skill_root>/entry.mjs" describe ${sampleActionId}`
-            : `ad describe ${sampleActionId} -P "<skill_root>"`;
-    const runCmd = isGlobalAd
-        ? `ad run ${sampleActionId}`
-        : isNodeEntry
-            ? `node "<skill_root>/entry.mjs" run ${sampleActionId}`
-            : `ad run ${sampleActionId} -P "<skill_root>"`;
-    const localGuidance = isGlobalAd
-        ? ""
-        : isNodeEntry
-            ? `将本文件所在目录解析为 \`<skill_root>\`。直接使用随附的 \`node "<skill_root>/entry.mjs"\` 入口执行，不要求全局安装 \`ad\` 命令行工具，不读取 Registry 或当前工作目录项目。
-缺少依赖时，在技能根目录执行 \`npm install --omit=dev\`。默认共享统一数据存储，仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`。
-本地封闭执行不支持 \`--async\`；复合技能不提供配置与状态管理子命令，配置覆盖使用 \`--config KEY=VALUE\`。`
-            : `将本文件所在目录解析为 \`<skill_root>\`。默认通过 \`ad ... -P "<skill_root>"\` 执行，仅使用本技能封闭包含的本地包集合，不通过 Registry 或当前工作目录项目执行，亦不需要 \`ad link\`。此执行约定优先于自定义正文中的历史调用说明。
-缺少依赖时，在技能根目录执行 \`npm install --omit=dev\`。默认共享统一数据存储，仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`。
-本地封闭执行不支持 \`--async\`；复合技能不提供配置与状态管理子命令，配置覆盖使用 \`--config KEY=VALUE\`。`;
     const sDescribe = `## 动作参数契约按需调阅
 
-${localGuidance}
-
 为节省上下文开销，各 Action 的详细参数结构不静态内嵌在说明书中。在调用未知参数的 Action 前，可在终端执行命令查阅输入输出约束：
 
 \`\`\`bash
-${describeCmd}
+ad describe ${sampleActionId}
 \`\`\``;
     const sActions = `## 可用 Action 工具清单
 
@@ -426,8 +397,8 @@ ${playbookEntries.join("\n")}
 ---`
         : "";
     const sInvoke = `## 标准调用命令
-
-${renderInvocationGuidance(describeCmd, runCmd)}
+ 
+${renderInvocationGuidance(`ad describe ${sampleActionId}`, `ad run ${sampleActionId}`)}
 
 ${renderJsonEnvelopeSection("envelope", { withDescriptions: false })}`;
     const sTroubleshooting = renderTroubleshootingSection(RUNTIME_REFERENCE_REL_PATH);

package/dist/skill-md.d.ts

@@ -35,11 +35,3 @@ export declare function writeSkillMd(root: string, destDir: string, options: {
  * 构造模板生成所需的 ProjectConfig 视图。
  */
 export declare function buildConfigForTemplates(plan: SelectionPlan, actionsDir: string, playbooksDir: string): ProjectConfig;
-/** 刷新有边界标记的本地执行约定，保留生成块之外的用户正文。 */
-export declare function appendLocalExecutionContract(file: string, packages: Array<{
-    packageId: string;
-    actions: Array<{
-        id: string;
-        isExternal?: boolean;
-    }>;
-}>): void;

package/dist/skill-md.js

@@ -159,49 +159,3 @@ export function buildConfigForTemplates(plan, actionsDir, playbooksDir) {
         config: plan.configDefs,
     };
 }
-/** 刷新有边界标记的本地执行约定，保留生成块之外的用户正文。 */
-export function appendLocalExecutionContract(file, packages) {
-    const commands = packages.flatMap((pkg) => pkg.actions
-        .filter((action) => !action.isExternal)
-        .map((action) => `- \`${pkg.packageId}/${action.id}\``));
-    const content = readFileSync(file, "utf-8");
-    const block = `<!-- actiondock:local-execution -->
-## 本地执行约定
-
-本节为导出器根据实际包清单生成的执行约定，优先于上文保留的历史调用或初始化说明。
-将本文件所在目录解析为 \`<skill_root>\`。默认使用 \`ad ... -P "<skill_root>"\` 执行，仅加载本技能封闭包含的本地包集合，不通过 Registry、当前工作目录项目或 \`ad link\` 调度。
-
-\`\`\`bash
-cd "<skill_root>" && npm install --omit=dev
-ad list -P "<skill_root>"
-ad describe <package-id>/<action-id> -P "<skill_root>"
-ad run <package-id>/<action-id> -P "<skill_root>" -- ASSIGNMENT...
-\`\`\`
-
-默认共享统一数据存储，仅在需要数据隔离等特殊场景下追加 \`--data-dir <path>\`；封闭执行不支持 \`--async\`。
-
-### 本次导出的可用动作
-
-${commands.join("\n")}
-<!-- actiondock:local-execution:end -->`;
-    const startMarker = "<!-- actiondock:local-execution -->";
-    const endMarker = "<!-- actiondock:local-execution:end -->";
-    let cursor = 0;
-    let refreshed = "";
-    let found = false;
-    while (true) {
-        const start = content.indexOf(startMarker, cursor);
-        const end = content.indexOf(endMarker, cursor);
-        if (start < 0 && end < 0)
-            break;
-        const nextStart = start < 0 ? -1 : content.indexOf(startMarker, start + startMarker.length);
-        if (start < 0 || end < start || (nextStart >= 0 && nextStart < end)) {
-            throw new BuilderError("Incomplete or misordered local execution block markers; refusing to replace user content");
-        }
-        refreshed += content.slice(cursor, start) + (found ? "" : block);
-        found = true;
-        cursor = end + endMarker.length;
-    }
-    refreshed += content.slice(cursor);
-    writeFileSync(file, found ? refreshed : content + "\n\n" + block + "\n", "utf-8");
-}

package/dist/types.d.ts

@@ -1,5 +1,4 @@
 import type { ProjectConfig } from "@actiondock/core";
-import type { PackageGraph } from "@actiondock/core/graph";
 import type { ActionDockManifest } from "@actiondock/core/project";
 /**
  * 规划输入侧的项目配置扩展字段。
@@ -151,8 +150,6 @@ export type SelectionPlan = BuildPlan;
  * 声明式选择规划器配置选项。
  */
 export interface SelectionPlannerOptions {
-    /** 显式共享包图，提供时不再发现 Registry 或当前工程。 */
-    packageGraph?: PackageGraph;
     /** 项目根目录绝对路径 */
     projectRoot: string;
     /** 显式传入的项目配置（若未提供则从 actiondock.json 读取） */
@@ -307,12 +304,14 @@ export interface PackResult {
  * Skill 导出选项。
  */
 export interface SkillExporterOptions {
-    /** 复合导出共享的明确包集合。 */
-    packageGraph?: PackageGraph;
     /** 源码项目根目录绝对路径 */
     projectRoot: string;
     /** 导出模式：source 源码型 Skill 或 node 目录型 Skill（默认 source） */
     mode?: "source" | "node";
+    /** 独立自包含模式（若为 true 则将导出模式设为 node 目录型） */
+    standalone?: boolean;
+    /** 是否将跨包依赖物理物化为微型工作区复合结构（默认 false） */
+    bundleDeps?: boolean;
     /** 导出产物目标目录（默认输出至 dist 目录） */
     outDir?: string;
     /** 是否执行归档压缩，亦可直接指定归档格式 */
@@ -341,8 +340,6 @@ export interface SkillExporterOptions {
     skipDependencyValidation?: boolean;
     /** 内部标识：是否作为复合套件子包导出（避免闭包再次触发嵌套 mini-workspace） */
     _isSubpackage?: boolean;
-    /** 复合套件子包缺省 npm 包名（当子包无 package.json 或缺少 name 时使用） */
-    defaultPackageName?: string;
     /** 自定义复合技能说明书文件路径 */
     customMdPath?: string;
     /** 所属 Workspace 根目录（可选） */
@@ -387,14 +384,16 @@ export type ExportSkillResult = SkillExportResult;
  * 复合 Skill 套件导出选项。
  */
 export interface CompositeSkillExportOptions {
-    /** 复用源码导出已解析的有效包图，避免丢失显式清单。 */
-    packageGraph?: PackageGraph;
     /** 复合技能套件名称 */
     bundleName: string;
     /** 参与聚合的项目根目录绝对路径列表 */
     projectRoots: string[];
     /** 复合套件输出目标目录（默认输出至 dist 目录） */
     outDir?: string;
+    /** 是否将外部依赖物理物化进复合产物（默认 false） */
+    bundleDeps?: boolean;
+    /** 独立自包含模式（复合导出暂不支持） */
+    standalone?: boolean;
     /** 复合技能描述信息 */
     description?: string;
     /** 是否执行归档压缩，亦可直接指定归档格式 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/builder",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "description": "ActionDock Build Planner, distribution packaging, and Skill exporter",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,8 +29,8 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/core": "^2.15.0",
-    "@actiondock/sdk": "^2.15.0"
+    "@actiondock/core": "^2.17.0",
+    "@actiondock/sdk": "^2.17.0"
   },
   "keywords": [
     "actiondock",

package/dist/derived-graph.d.ts

@@ -1,4 +0,0 @@
-import { type ActionDockManifest, type PlaybookSourceManifest } from "@actiondock/core/project";
-import { type PackageGraph } from "@actiondock/core/graph";
-/** 仅从共享包集合派生有效清单图，不修改调用方图或重新发现外部包。 */
-export declare function deriveEffectivePackageGraph(baseGraph: PackageGraph, root: string, effectiveManifest?: ActionDockManifest | PlaybookSourceManifest): PackageGraph;

package/dist/derived-graph.js

@@ -1,30 +0,0 @@
-import { resolve } from "node:path";
-import { computeManifestDigest } from "@actiondock/core/project";
-import { PackageGraphBuilder } from "@actiondock/core/graph";
-import { BuilderError } from "./errors.js";
-/** 仅从共享包集合派生有效清单图，不修改调用方图或重新发现外部包。 */
-export function deriveEffectivePackageGraph(baseGraph, root, effectiveManifest) {
-    const packages = Array.from(baseGraph.packages.values());
-    const target = packages.find((pkg) => resolve(pkg.root) === resolve(root));
-    if (!target) {
-        throw new BuilderError(`Project root '${root}' not found in provided packageGraph.`, "PACKAGE_NOT_FOUND");
-    }
-    if (!effectiveManifest)
-        return baseGraph;
-    if (effectiveManifest.id !== target.packageId) {
-        throw new BuilderError(`Cannot change package identity from '${target.packageId}' to '${effectiveManifest.id}' in shared package graph.`, "CANNOT_CHANGE_PACKAGE_IDENTITY");
-    }
-    // 合并配置可能仅创建等价对象；相同声明继续复用共享图。
-    if (computeManifestDigest(effectiveManifest) === target.manifestDigest)
-        return baseGraph;
-    return new PackageGraphBuilder({
-        packages: packages.map((pkg) => ({
-            id: pkg.packageId,
-            root: pkg.root,
-            manifest: pkg === target ? effectiveManifest : pkg.manifest,
-            isCurrentProject: pkg === target,
-        })),
-        root: target.root,
-        validateDependencies: true,
-    }).buildSync();
-}

package/dist/source-graph.d.ts

@@ -1,4 +0,0 @@
-import { type ActionDockManifest } from "@actiondock/core/project";
-import { type PackageGraph } from "@actiondock/core/graph";
-/** 源码导出只使用显式包与正式安装依赖；显式兄弟包优先于任何依赖查找。 */
-export declare function createSourcePackageGraph(projectRoots: string[], rootManifest?: ActionDockManifest): PackageGraph;

package/dist/source-graph.js

@@ -1,33 +0,0 @@
-import { realpathSync } from "node:fs";
-import { resolve } from "node:path";
-import { ActionDockError } from "@actiondock/core";
-import { loadManifest } from "@actiondock/core/project";
-import { PackageGraphBuilder } from "@actiondock/core/graph";
-import { BuilderError } from "./errors.js";
-/** 源码导出只使用显式包与正式安装依赖；显式兄弟包优先于任何依赖查找。 */
-export function createSourcePackageGraph(projectRoots, rootManifest) {
-    const packages = new Map();
-    const register = (pkg) => {
-        const existing = packages.get(pkg.id);
-        if (existing && realpathSync(existing.root) !== realpathSync(pkg.root)) {
-            throw new ActionDockError("PACKAGE_ID_CONFLICT", `Package ID '${pkg.id}' is declared by multiple directories: '${existing.root}' and '${pkg.root}'`);
-        }
-        packages.set(pkg.id, pkg);
-    };
-    for (const [index, root] of projectRoots.entries()) {
-        const absRoot = resolve(root);
-        const manifest = index === 0 && rootManifest ? rootManifest : loadManifest(absRoot);
-        if (!manifest)
-            throw new BuilderError(`Missing actiondock.json at '${absRoot}'`);
-        register({ id: manifest.id, root: absRoot, manifest });
-    }
-    const packageRoots = Object.fromEntries(Array.from(packages.values(), (p) => [p.id, p.root]));
-    // 每个显式包的正式依赖均纳入闭包，统一查重后再构造供所有规划共享的图。
-    for (const pkg of Array.from(packages.values())) {
-        const graph = new PackageGraphBuilder({ root: pkg.root, manifest: pkg.manifest, packageRoots, allowDevLinks: false }).buildSync();
-        for (const node of graph.packages.values()) {
-            register({ id: node.packageId, root: node.root, manifest: node.manifest });
-        }
-    }
-    return new PackageGraphBuilder({ packages: Array.from(packages.values()), validateDependencies: true }).buildSync();
-}