@actiondock/core 2.15.0 → 2.17.0

package/dist/host/routing.js

@@ -83,7 +83,7 @@ function buildFallbackGraph(runtimes) {
     ])));
 }
 /**
- * 静态查询指定 Playbook 规范：委托 resolvePlaybook 统一寻址与来源加载。
+ * 静态查询指定 Playbook 规范：基于 resolvePlaybook 统一纯领域解析。
  */
 export async function describeVisiblePlaybook(runtimes, id, visibility) {
     const graph = visibility.graph || buildFallbackGraph(runtimes);

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export type { TerminalRunStatus } from "./storage/types.js";
 export { parseDuration } from "./utils/index.js";
 export { toSnakeUpperCase, resolveEnvValue } from "./runtime/env.js";
 export type { ResolvedEnv } from "./runtime/env.js";
-export type { ActionRef, ResolvedActionRef, ExecutionResult, RunRecord, ExecutionEvent, } from "@actiondock/sdk";
+export type { ActionRef, ResolvedActionRef, ExecutionResult, RunRecord, RunOrigin, ExecutionEvent, } from "@actiondock/sdk";
 export type { RunOptions, ExecutionTicket, CancelResult, } from "./execution/types.js";
 export type { ActionSpec, ActionSummary, PlaybookSpec, PlaybookSummary, PackageInfo, ListActionsOptions, } from "./package/types.js";
 export { createNodePlatform, } from "./platform/node.js";
@@ -22,8 +22,6 @@ export { startActionDockServer, } from "./server/server.js";
 export type { ServerOptions, ServerOptions as ActionDockServerOptions, ActionDockServerInstance, } from "./server/types.js";
 export { initProject } from "./project/init.js";
 export { loadProjectConfig, findProjectRoot, } from "./project/loader.js";
-export { discoverLocalSkillDirectory, inspectLocalPackageDirectory, queryLocalPackageDirectory, validateLocalSkillPackages, isExplicitPath, } from "./project/skill-dir.js";
-export type { ProjectConfig, PlaybookSourceManifest, RuntimeProjectConfig, } from "./project/types.js";
-export type { LocalSkillDirectory, LocalPackageEntry, } from "./project/skill-dir.js";
+export type { ProjectConfig, } from "./project/types.js";
 export type { PackageGraph, } from "./catalog/graph.js";
 export { ActionDockError, ProcessError, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, PROCESS_FAILED, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, PROJECT_ROOT_NOT_FOUND, describeActionLoadFailure, createErrorEnvelope, resolveExecutionHint, } from "./errors.js";

package/dist/index.js

@@ -19,6 +19,5 @@ export { startActionDockServer, } from "./server/server.js";
 // 6. 核心工程辅助
 export { initProject } from "./project/init.js";
 export { loadProjectConfig, findProjectRoot, } from "./project/loader.js";
-export { discoverLocalSkillDirectory, inspectLocalPackageDirectory, queryLocalPackageDirectory, validateLocalSkillPackages, isExplicitPath, } from "./project/skill-dir.js";
 // 8. 统一错误模型与核心标准错误码常量
 export { ActionDockError, ProcessError, PACKAGE_NOT_FOUND, ACTION_PACKAGE_VERSION_CONFLICT, ACTION_NOT_FOUND, ACTION_LOAD_FAILED, ACTION_FAILED, ACTION_TIMEOUT, ACTION_CANCELLED, INPUT_VALIDATION_FAILED, OUTPUT_VALIDATION_FAILED, INPUT_NOT_JSON, OUTPUT_NOT_JSON, ACTION_SUBRUN_LIMIT, ACTION_CALL_CYCLE, UNDECLARED_ACTION_DEPENDENCY, INVALID_ACTION_REF, IDEMPOTENCY_CONFLICT, EXECUTION_FAILED, UNHANDLED_EXECUTION_ERROR, RUN_REPOSITORY_UNAVAILABLE, RUN_PERSISTENCE_FAILED, STANDALONE_ASYNC_UNSUPPORTED, HOST_PROCESS_EXITED, EXECUTION_ABORTED, TIMEOUT, NETWORK_ERROR, CAPABILITY_UNAVAILABLE, STATE_KEY_NOT_FOUND, STORAGE_BUSY, PROJECT_BUSY, PROJECT_RECOVERY_REQUIRED, EVENT_BACKPRESSURE_LIMIT, EVENT_CURSOR_EXPIRED, PROCESS_OUTPUT_LIMIT, PROCESS_SPAWN_ERROR, PROCESS_CANCELLED, PROCESS_TIMEOUT, UNAUTHORIZED, NOT_FOUND, SERVER_ERROR, PACKAGE_FORBIDDEN, ACTION_FORBIDDEN, PLAYBOOK_NOT_FOUND, REQUEST_TOO_LARGE, ACTION_START_FAILED, ACTION_EXECUTION_ERROR, DATA_DIR_IN_USE, DATA_DIR_RECOVERY_REQUIRED, PROCESS_FAILED, MCP_TOOL_NAME_COLLISION, ACCESS_DENIED, INVALID_FLAT_ARGUMENT, INVALID_JSON, INVALID_JSON_LITERAL, INPUT_PATH_CONFLICT, FLAT_INPUT_LIMIT_EXCEEDED, INPUT_LIMIT_EXCEEDED, INPUT_POLICY_VIOLATION, INPUT_CONFLICT, INPUT_FILE_NOT_FOUND, INPUT_FILE_READ_FAILED, INVALID_ARGUMENT, PACKAGE_NOT_ALLOWED, INVALID_PACKAGE_ID, PATH_TRAVERSAL, AMBIGUOUS_STATE_KEY, RUN_NOT_FOUND, RUN_ALREADY_FINISHED, PROJECT_ROOT_NOT_FOUND, describeActionLoadFailure, createErrorEnvelope, resolveExecutionHint, } from "./errors.js";

package/dist/invocation/types.d.ts

@@ -1,4 +1,4 @@
-import type { ActionDefinition, ActionRef, Logger, ProcessAPI, ProgressReporter } from "@actiondock/sdk";
+import type { ActionDefinition, ActionRef, Logger, ProcessAPI, ProgressReporter, RunOrigin } from "@actiondock/sdk";
 import type { ProcessOwner } from "../process/index.js";
 import { createPackageIdentity, type PackageIdentity } from "../runtime/identity.js";
 export { createPackageIdentity };
@@ -75,6 +75,8 @@ export interface InvocationContext {
     readonly process?: ProcessAPI;
     /** 进程属主身份 */
     readonly owner?: ProcessOwner;
+    /** 运行来源追踪快照 */
+    readonly origin?: RunOrigin;
 }
 /**
  * 内部调用上下文选项契约。
@@ -121,6 +123,8 @@ export interface CreateRootInvocationContextOptions {
     progress?: ProgressReporter;
     /** 显式执行归属所有者契约 */
     owner?: ProcessOwner;
+    /** 运行来源追踪快照 */
+    origin?: RunOrigin;
 }
 /**
  * 构造合法的受信任根调用上下文（Root InvocationContext）。

package/dist/invocation/types.js

@@ -1,4 +1,5 @@
 import { createPackageIdentity } from "../runtime/identity.js";
+import { snapshotRunOrigin } from "../runtime/run-origin.js";
 export { createPackageIdentity };
 /**
  * 构造默认进程归属所有者（ProcessOwner）的单一事实源工厂。
@@ -23,6 +24,7 @@ export function createInvocationContext(options) {
     const runId = options.runId ?? crypto.randomUUID();
     const rootRunId = options.rootRunId ?? runId;
     const pkg = options.package;
+    const origin = snapshotRunOrigin(options.origin);
     return {
         runId,
         rootRunId,
@@ -41,6 +43,7 @@ export function createInvocationContext(options) {
         logger: options.logger,
         progress: options.progress,
         process: options.process,
+        origin,
         owner: options.owner ??
             createDefaultProcessOwner({
                 tenantId: options.tenantId,
@@ -75,6 +78,7 @@ export function createRootInvocationContext(options) {
         owner: options.owner,
         tenantId: options.tenantId,
         principalId: options.principalId,
+        origin: options.origin,
     });
     return {
         runId: base.runId,
@@ -93,5 +97,6 @@ export function createRootInvocationContext(options) {
         progress: base.progress,
         process: base.process,
         owner: base.owner,
+        origin: base.origin,
     };
 }

package/dist/package/runtime.d.ts

@@ -1,6 +1,6 @@
 import type { ExecutionEvent, ExecutionResult, JsonValue, RunRecord } from "@actiondock/sdk";
 import type { ActionInvoker, CancelResult, ExecutionTicket } from "../execution/types.js";
-import type { ProjectConfig, RuntimeProjectConfig } from "../project/types.js";
+import type { ProjectConfig } from "../project/types.js";
 import { type PackageIdentity } from "../runtime/identity.js";
 import { type InvocationContext, type RunOptions } from "../invocation/types.js";
 import type { ActionSpec, ActionSummary, ConfigValueView, HostManagedPackageRuntime, ListActionsOptions, ListRunsOptions, PackageInfo, PackageRuntime, PackageRuntimeOptions, PackageRuntimeInternalOptions, PlaybookSpec, PlaybookSummary, StateScopeOptions } from "./types.js";
@@ -21,7 +21,7 @@ export declare class DefaultPackageRuntime implements HostManagedPackageRuntime
     readonly packageInstanceId: string;
     readonly generationId: string;
     readonly packageRoot?: string;
-    readonly projectConfig: ProjectConfig | RuntimeProjectConfig;
+    readonly projectConfig: ProjectConfig;
     readonly inMemory: boolean;
     private readonly platform;
     private readonly actionsMap;

package/dist/package/runtime.js

@@ -2,7 +2,7 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { DefaultExecutionService } from "../execution/service.js";
 import { createNodePlatform } from "../platform/index.js";
-import { completeRuntimeProjectConfig, findProjectRoot, loadProjectConfig } from "../project/loader.js";
+import { findProjectRoot, loadProjectConfig } from "../project/loader.js";
 import { RuntimeConfig } from "../runtime/context.js";
 import { normalizeActionCollection } from "../runtime/action-collection.js";
 import { isSecretConfigKey, sanitizeConfigDefinitions } from "../storage/mask.js";
@@ -11,6 +11,7 @@ import { createPackageIdentity } from "../runtime/identity.js";
 import { ACTION_NOT_FOUND, ActionDockError, CAPABILITY_UNAVAILABLE, INVALID_ARGUMENT, INVOCATION_UNSUPPORTED, NOT_FOUND, SERVICE_CLOSED, } from "../errors.js";
 import { createAbortError } from "../ipc/service.js";
 import { createRootInvocationContext } from "../invocation/types.js";
+import { snapshotRunOrigin } from "../runtime/run-origin.js";
 import { buildStaticActionMap, buildStaticPlaybookMap } from "./static-index.js";
 import { applyActionSummaryFilters } from "./types.js";
 function normalizeStateReadArgs(arg1, arg2, arg3) {
@@ -125,8 +126,6 @@ export class DefaultPackageRuntime {
                 version: "0.1.0",
             };
         }
-        // 在唯一装配边界确定规程来源，索引与包图共享同一份完整配置快照。
-        projectConfig = completeRuntimeProjectConfig(packageRoot, projectConfig);
         this.packageRoot = packageRoot;
         this.projectConfig = projectConfig;
         // 兼容未在公开选项契约中显式声明的包实例标识与代系标识内部参数透传
@@ -552,9 +551,12 @@ export class DefaultPackageRuntime {
             maxCallDepth: this.options.maxCallDepth,
             logger: this.options.logger,
             process: this.options.process ?? this.platform.process,
+            origin: options?.origin,
         });
     }
     async runAction(id, input, options) {
+        const origin = snapshotRunOrigin(options?.origin);
+        const effectiveOptions = { ...options, origin };
         const service = await this.prepareExecution();
         let actionId = id;
         if (actionId.includes("/")) {
@@ -565,10 +567,12 @@ export class DefaultPackageRuntime {
                 throw new ActionDockError(INVOCATION_UNSUPPORTED, `PackageRuntime only accepts local action short ID '${id}'. Cross-package invocations must be dispatched via Host invoker.`);
             }
         }
-        const context = this.buildRootInvocationContext(actionId, options);
+        const context = this.buildRootInvocationContext(actionId, effectiveOptions);
         return service.execute(actionId, input, context);
     }
     async startAction(id, input, options) {
+        const origin = snapshotRunOrigin(options?.origin);
+        const effectiveOptions = { ...options, origin };
         const service = await this.prepareExecution();
         let actionId = id;
         if (actionId.includes("/")) {
@@ -579,7 +583,7 @@ export class DefaultPackageRuntime {
                 throw new ActionDockError(INVOCATION_UNSUPPORTED, `PackageRuntime only accepts local action short ID '${id}'. Cross-package invocations must be dispatched via Host invoker.`);
             }
         }
-        const context = this.buildRootInvocationContext(actionId, options);
+        const context = this.buildRootInvocationContext(actionId, effectiveOptions);
         return service.start(actionId, input, context);
     }
     async startInvocation(actionId, input, context) {

package/dist/package/static-index.d.ts

@@ -1,5 +1,5 @@
 import type { ActionDefinition } from "@actiondock/sdk";
-import type { ProjectConfig, RuntimeProjectConfig } from "../project/types.js";
+import type { ProjectConfig } from "../project/types.js";
 import type { ActionSpec, PlaybookSpec } from "./types.js";
 /**
  * 静态清单索引构建入参：同一包的全部静态事实来源。
@@ -10,8 +10,8 @@ export interface StaticIndexInput {
     packageRoot?: string;
     /** 包唯一标识 */
     packageId: string;
-    /** 项目配置（规范化清单配置快照或运行时来源，单一事实源） */
-    projectConfig: ProjectConfig | RuntimeProjectConfig;
+    /** 项目配置（规范化清单配置快照，单一事实源） */
+    projectConfig: ProjectConfig;
 }
 /** Action 索引构建入参：静态事实来源之上叠加内存注入的 Action 定义集合 */
 export interface StaticActionIndexInput extends StaticIndexInput {
@@ -29,6 +29,8 @@ export interface StaticActionIndexInput extends StaticIndexInput {
 export declare function buildStaticActionMap(input: StaticActionIndexInput): Map<string, ActionSpec>;
 /**
  * 静态读取并聚合指定包的 Playbook 规范索引。
- * 统一复用 project/loader 的 loadPlaybooks（单一事实源），不再自行读文件或吞异常。
+ *
+ * 聚合来源：磁盘规程目录扫描（以 actiondock.json 声明为事实源）与
+ * 项目配置中声明的 playbooks；同键时配置声明覆盖磁盘扫描结果。
  */
 export declare function buildStaticPlaybookMap(input: StaticIndexInput): Map<string, PlaybookSpec>;

package/dist/package/static-index.js

@@ -1,5 +1,7 @@
-import { resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { loadPlaybooks } from "../project/loader.js";
+import { MANIFEST_FILE_NAME } from "../project/manifest.js";
 /**
  * 将增量声明合并到既有 Action 规范之上（纯函数，单一事实源）。
  *
@@ -84,21 +86,67 @@ export function buildStaticActionMap(input) {
 }
 /**
  * 静态读取并聚合指定包的 Playbook 规范索引。
- * 统一复用 project/loader 的 loadPlaybooks（单一事实源），不再自行读文件或吞异常。
+ *
+ * 聚合来源：磁盘规程目录扫描（以 actiondock.json 声明为事实源）与
+ * 项目配置中声明的 playbooks；同键时配置声明覆盖磁盘扫描结果。
  */
 export function buildStaticPlaybookMap(input) {
     const { packageRoot, packageId, projectConfig } = input;
     const map = new Map();
-    const loaded = loadPlaybooks(packageRoot || "", projectConfig.playbooksDir, projectConfig);
-    for (const [id, def] of loaded) {
-        map.set(id, {
-            id: def.id,
-            packageId,
-            description: def.description,
-            actions: def.actions,
-            content: def.content,
-            filePath: def.filePath,
-        });
+    // 扫描磁盘规程文件
+    if (packageRoot) {
+        const playbooksDir = projectConfig?.playbooksDir || "playbooks";
+        const dirPath = join(packageRoot, playbooksDir);
+        const manifestPath = join(packageRoot, MANIFEST_FILE_NAME);
+        if (existsSync(manifestPath) || existsSync(dirPath)) {
+            try {
+                const loaded = loadPlaybooks(packageRoot, playbooksDir);
+                for (const [id, def] of loaded) {
+                    map.set(id, {
+                        id: def.id,
+                        packageId,
+                        description: def.description,
+                        actions: def.actions,
+                        content: def.content,
+                        filePath: def.filePath,
+                    });
+                }
+            }
+            catch (err) {
+                // 规程加载失败（清单声明非法、规程文件损坏等）输出告警并跳过磁盘部分，保持返回可用列表
+                console.warn(`[App] Failed to load playbooks for package '${packageId}' from '${dirPath}': ${err?.message || String(err)}`);
+            }
+        }
+    }
+    // 读取项目配置文件中的 playbooks
+    if (projectConfig && projectConfig.playbooks) {
+        const rawPlaybooks = projectConfig.playbooks;
+        if (typeof rawPlaybooks === "object" && rawPlaybooks !== null) {
+            for (const [id, item] of Object.entries(rawPlaybooks)) {
+                const existing = map.get(id);
+                let content = item.content ?? existing?.content ?? "";
+                let filePath = item.entry && packageRoot
+                    ? resolve(packageRoot, item.entry)
+                    : existing?.filePath;
+                if (!content && filePath && existsSync(filePath)) {
+                    try {
+                        content = readFileSync(filePath, "utf-8");
+                    }
+                    catch (err) {
+                        // 读取失败（权限、IO 错误等）输出告警并保持空正文，不再无声吞没
+                        console.warn(`[App] Failed to read playbook '${id}' content from '${filePath}' in package '${packageId}': ${err?.message || String(err)}`);
+                    }
+                }
+                map.set(id, {
+                    id,
+                    packageId,
+                    description: item.description ?? existing?.description,
+                    actions: item.actions ?? existing?.actions,
+                    content,
+                    filePath,
+                });
+            }
+        }
     }
     return map;
 }

package/dist/package/types.d.ts

@@ -1,7 +1,7 @@
 import type { ActionDefinition, ExecutionEvent, ExecutionResult, JsonValue, Logger, ProcessAPI, RunRecord } from "@actiondock/sdk";
 import type { ActionInvoker, CancelResult, ExecutionTicket, LocalActionResolver } from "../execution/types.js";
 import type { InvocationContext, RunOptions } from "../invocation/types.js";
-import type { ConfigItemDefinition, ProjectConfig, RuntimeProjectConfig } from "../project/types.js";
+import type { ConfigItemDefinition, ProjectConfig } from "../project/types.js";
 import type { EventSink } from "../runtime/events.js";
 import type { RuntimePlatform, StorageFactory, StorageFactoryOptions } from "../platform/types.js";
 import type { RuntimeStorage, StateEntry } from "../storage/types.js";
@@ -156,8 +156,8 @@ export interface StateOptions {
 export interface PackageRuntimeOptions {
     /** 项目根目录绝对物理路径 */
     packageRoot?: string;
-    /** 项目配置文件 (actiondock.json) 对象或运行时规程来源配置 */
-    projectConfig?: ProjectConfig | RuntimeProjectConfig;
+    /** 项目配置文件 (actiondock.json) 对象 */
+    projectConfig?: ProjectConfig;
     /** 数据持久化存储目录 */
     dataDir?: string;
     /** 自定义家目录绝对路径 */
@@ -241,8 +241,8 @@ export interface PackageRuntime {
     readonly generationId?: string;
     /** 包根目录绝对物理路径 */
     readonly packageRoot?: string;
-    /** 项目配置对象（actiondock.json 解析结果或运行时配置） */
-    readonly projectConfig: ProjectConfig | RuntimeProjectConfig;
+    /** 项目配置对象（actiondock.json 解析结果） */
+    readonly projectConfig: ProjectConfig;
     /** 是否采用纯内存运行模式 */
     readonly inMemory?: boolean;
     /**

package/dist/project/index.d.ts

@@ -3,7 +3,6 @@ export * from "./init.js";
 export * from "./loader.js";
 export * from "./lockfile.js";
 export * from "./manifest.js";
-export * from "./skill-dir.js";
 export { SNAPSHOT_TRACKED_FILES, type TransactionFileRecord, type TransactionMetadata, type ProjectTransaction, isProjectLockHeld, acquireProjectLock, runFrozenInstall, hasPendingTransactions, beginTransaction, recoverPendingTransactions, } from "./transactions.js";
 export * from "./types.js";
 export * from "./types-generator.js";

package/dist/project/index.js

@@ -3,7 +3,6 @@ export * from "./init.js";
 export * from "./loader.js";
 export * from "./lockfile.js";
 export * from "./manifest.js";
-export * from "./skill-dir.js";
 export { SNAPSHOT_TRACKED_FILES, isProjectLockHeld, acquireProjectLock, runFrozenInstall, hasPendingTransactions, beginTransaction, recoverPendingTransactions, } from "./transactions.js";
 export * from "./types.js";
 export * from "./types-generator.js";

package/dist/project/init.js

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

package/dist/project/loader.d.ts

@@ -1,6 +1,6 @@
 import type { ActionDefinition } from "@actiondock/sdk";
 import { type ModuleLoader } from "../platform/module-loader.js";
-import type { ActionDockManifest, PlaybookDefinition, PlaybookManifestEntry, PlaybookSourceManifest, ProjectConfig, RuntimeProjectConfig } from "./types.js";
+import type { ActionDockManifest, PlaybookDefinition, PlaybookManifestEntry, ProjectConfig } from "./types.js";
 /**
  * 从指定目录开始向上逐级递归查找包含 `actiondock.json` 的项目根目录。
  *
@@ -16,8 +16,6 @@ export declare function findProjectRoot(cwd?: string): string | null;
  * @throws {Error} 若文件不存在或 JSON 格式错误、缺失必要字段
  */
 export declare function loadProjectConfig(projectRoot: string): ProjectConfig;
-/** 在运行时装配边界补全未声明的磁盘规程；显式规程来源（包括空集合）始终优先。 */
-export declare function completeRuntimeProjectConfig(projectRoot: string | undefined, config: RuntimeProjectConfig): RuntimeProjectConfig;
 export declare const ALLOWED_INSTALLERS: Set<string>;
 /**
  * 探测宿主系统中可用的包管理工具。
@@ -73,4 +71,4 @@ export declare function parsePlaybookContent(content: string, filePath: string,
  * @param customManifest 可选的显式清单对象（若未提供则从磁盘加载）
  * @returns Map<PlaybookId, PlaybookDefinition> 映射
  */
-export declare function loadPlaybooks(projectRoot: string, _playbooksDir?: string, customManifest?: ActionDockManifest | PlaybookSourceManifest | null): Map<string, PlaybookDefinition>;
+export declare function loadPlaybooks(projectRoot: string, _playbooksDir?: string, customManifest?: ActionDockManifest | null): Map<string, PlaybookDefinition>;

package/dist/project/loader.js

@@ -3,7 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { NodeModuleLoader, unwrapDefaultExport } from "../platform/module-loader.js";
 import { ActionDockError, ACTION_LOAD_FAILED, describeActionLoadFailure, INVALID_ACTION_ID, INVALID_JSON, INVALID_PACKAGE_ID, INVALID_PLAYBOOK_ID, MANIFEST_LOAD_FAILED, PLAYBOOK_NOT_FOUND, PROJECT_CONFIG_NOT_FOUND, } from "../errors.js";
-import { loadManifest, normalizeFilePlaybookEntries, ACTION_ID_REGEX, PLAYBOOK_ID_REGEX } from "./manifest.js";
+import { loadManifest, ACTION_ID_REGEX, PLAYBOOK_ID_REGEX } from "./manifest.js";
 /**
  * 从指定目录开始向上逐级递归查找包含 `actiondock.json` 的项目根目录。
  *
@@ -68,7 +68,7 @@ export function loadProjectConfig(projectRoot) {
         if (parsed.playbooksDir) {
             assertWithinProjectRoot(projectRoot, parsed.playbooksDir, "playbooksDir");
         }
-        return normalizeFilePlaybookEntries(parsed);
+        return parsed;
     }
     catch (err) {
         if (err instanceof ActionDockError) {
@@ -77,15 +77,6 @@ export function loadProjectConfig(projectRoot) {
         throw new ActionDockError(INVALID_JSON, `Failed to parse actiondock.json: ${err.message}`);
     }
 }
-/** 在运行时装配边界补全未声明的磁盘规程；显式规程来源（包括空集合）始终优先。 */
-export function completeRuntimeProjectConfig(projectRoot, config) {
-    if (!projectRoot || config.playbooks !== undefined)
-        return config;
-    const diskManifest = loadManifest(projectRoot);
-    return diskManifest?.playbooks === undefined
-        ? config
-        : { ...config, playbooks: diskManifest.playbooks };
-}
 export const ALLOWED_INSTALLERS = new Set(["npm", "bun"]);
 /**
  * 异步探测包管理器可用性（通过执行 --version 并检查退出码）。
@@ -317,38 +308,43 @@ export function parsePlaybookContent(content, filePath, metadata) {
  */
 export function loadPlaybooks(projectRoot, _playbooksDir = "playbooks", customManifest) {
     const playbooks = new Map();
-    const isExplicitSource = customManifest !== undefined;
-    const manifest = isExplicitSource
-        ? customManifest
-        : projectRoot ? loadManifest(projectRoot) : null;
-    for (const [playbookId, entry] of Object.entries(manifest?.playbooks || {})) {
-        if (!PLAYBOOK_ID_REGEX.test(playbookId)) {
-            throw new ActionDockError(INVALID_PLAYBOOK_ID, `Invalid playbook ID '${playbookId}' in manifest. Playbook IDs must match ${PLAYBOOK_ID_REGEX}`);
+    let manifest = null;
+    if (customManifest !== undefined) {
+        manifest = customManifest;
+    }
+    else {
+        try {
+            manifest = loadManifest(projectRoot);
         }
-        let content;
-        let filePath;
-        if (isExplicitSource && "content" in entry && typeof entry.content === "string") {
-            // 真实内联来源（包括空字符串）无需访问磁盘。
-            content = entry.content;
-            filePath = entry.entry ? (projectRoot ? resolve(projectRoot, entry.entry) : entry.entry) : "";
+        catch (err) {
+            // 容错与可观测性取舍说明：
+            // - 工程无清单时 loadManifest 返回 null，按空规程集处理属正常场景；
+            // - 清单文件存在但内容损坏或解析失败时，记录可观测警告后安全降级，避免静默吞没异常。
+            const reason = err instanceof Error ? err.message : String(err ?? "Unknown error");
+            process.stderr.write(`[actiondock] Warning: Failed to load manifest in ${projectRoot}: ${reason}\n`);
+            return playbooks;
         }
-        else {
-            if (!entry.entry || typeof entry.entry !== "string") {
-                throw new ActionDockError(PLAYBOOK_NOT_FOUND, `Playbook entry for '${playbookId}' must specify a valid file path or explicit inline content`);
+    }
+    // 以 actiondock.json 为唯一事实源
+    if (manifest?.playbooks && Object.keys(manifest.playbooks).length > 0) {
+        for (const [playbookId, pbEntry] of Object.entries(manifest.playbooks)) {
+            if (!PLAYBOOK_ID_REGEX.test(playbookId)) {
+                throw new ActionDockError(INVALID_PLAYBOOK_ID, `Invalid playbook ID '${playbookId}' in actiondock.json. Playbook IDs must match ${PLAYBOOK_ID_REGEX}`);
             }
-            filePath = resolve(projectRoot, entry.entry);
-            assertPathWithinRoot(projectRoot, filePath, `playbook entry '${entry.entry}'`);
-            if (!existsSync(filePath)) {
-                throw new ActionDockError(PLAYBOOK_NOT_FOUND, `Playbook file '${entry.entry}' for '${playbookId}' not found in ${projectRoot}`);
+            const fullPath = resolve(projectRoot, pbEntry.entry);
+            assertPathWithinRoot(projectRoot, fullPath, `playbook entry '${pbEntry.entry}'`);
+            if (!existsSync(fullPath)) {
+                throw new ActionDockError(PLAYBOOK_NOT_FOUND, `Playbook file '${pbEntry.entry}' for '${playbookId}' not found in ${projectRoot}`);
             }
-            content = readFileSync(filePath, "utf-8");
+            const content = readFileSync(fullPath, "utf-8");
+            const def = parsePlaybookContent(content, fullPath, {
+                id: playbookId,
+                name: pbEntry?.name,
+                description: pbEntry.description,
+                actions: pbEntry.actions,
+            });
+            playbooks.set(playbookId, def);
         }
-        playbooks.set(playbookId, parsePlaybookContent(content, filePath, {
-            id: playbookId,
-            name: entry.name,
-            description: entry.description,
-            actions: entry.actions,
-        }));
     }
     return playbooks;
 }

package/dist/project/manifest.d.ts

@@ -2,8 +2,6 @@ import type { ActionDockManifest } from "./types.js";
 export declare const MANIFEST_FILE_NAME = "actiondock.json";
 export declare const ACTION_ID_REGEX: RegExp;
 export declare const PLAYBOOK_ID_REGEX: RegExp;
-/** 磁盘规程始终采用文件声明，不能把非契约 content 字段带入运行时内联来源。 */
-export declare function normalizeFilePlaybookEntries(manifest: ActionDockManifest): ActionDockManifest;
 /**
  * 读取并解析项目的声明式清单文件（actiondock.json 为唯一事实源）。
  * 若文件不存在则返回 null。

package/dist/project/manifest.js

@@ -5,22 +5,6 @@ import { ActionDockError, MANIFEST_CORRUPTED, MANIFEST_INVALID, MANIFEST_READ_FA
 export const MANIFEST_FILE_NAME = "actiondock.json";
 export const ACTION_ID_REGEX = /^[a-z0-9][a-z0-9._-]*$/;
 export const PLAYBOOK_ID_REGEX = /^[a-z0-9][a-z0-9._-]*$/;
-/** 磁盘规程始终采用文件声明，不能把非契约 content 字段带入运行时内联来源。 */
-export function normalizeFilePlaybookEntries(manifest) {
-    if (!manifest.playbooks || typeof manifest.playbooks !== "object" || Array.isArray(manifest.playbooks)) {
-        return manifest;
-    }
-    let changed = false;
-    const playbooks = Object.fromEntries(Object.entries(manifest.playbooks).map(([id, entry]) => {
-        if (entry && typeof entry === "object" && "content" in entry) {
-            const { content: _inlineContent, ...fileEntry } = entry;
-            changed = true;
-            return [id, fileEntry];
-        }
-        return [id, entry];
-    }));
-    return changed ? { ...manifest, playbooks } : manifest;
-}
 /**
  * 读取并解析项目的声明式清单文件（actiondock.json 为唯一事实源）。
  * 若文件不存在则返回 null。
@@ -54,7 +38,7 @@ export function loadManifest(projectRoot) {
     if (!parsed.id) {
         parsed.id = basename(projectRoot);
     }
-    return normalizeFilePlaybookEntries(parsed);
+    return parsed;
 }
 /**
  * 保存声明式清单文件至项目根目录（actiondock.json）。

package/dist/project/types.d.ts

@@ -53,25 +53,6 @@ export interface PlaybookManifestEntry {
     /** 该 Playbook 所依赖/调用的 Action ID 列表 */
     actions?: string[];
 }
-/**
- * 内存运行时或测试中使用的内联 Playbook 声明项。
- */
-export interface InlinePlaybookSourceEntry {
-    /** Playbook Markdown 正文内容（纯 Markdown 规程内容，含空字符串） */
-    content: string;
-    /** 可选的虚拟入口相对路径（如 "playbooks/calc-sop.md"） */
-    entry?: string;
-    /** Playbook 展示名称，缺省回落文件名派生 */
-    name?: string;
-    /** Playbook 任务描述 */
-    description?: string;
-    /** 该 Playbook 所依赖/调用的 Action ID 列表 */
-    actions?: string[];
-}
-/**
- * Playbook 来源定义条目（支持磁盘清单声明项与内存内联正文声明项）。
- */
-export type PlaybookSourceEntry = PlaybookManifestEntry | InlinePlaybookSourceEntry;
 /**
  * ActionDock 声明式元数据清单契约（actiondock.json 为唯一事实源）。
  */
@@ -94,8 +75,6 @@ export interface ActionDockManifest {
     actions?: Record<string, ActionManifestEntry>;
     /** 声明的 Playbooks 集合（唯一事实源） */
     playbooks?: Record<string, PlaybookManifestEntry>;
-    /** 包级静态依赖引用，与 Action 的 uses 共用引用语义。 */
-    uses?: string[];
     /** 跨包外部依赖映射（逻辑包 ID 到 npm 包名） */
     dependencies?: Record<string, string>;
     /** 框架导出与分发边界文件列表 */
@@ -112,20 +91,10 @@ export interface ActionDockManifest {
         [key: string]: unknown;
     };
 }
-/**
- * 内存运行时或图模型中支持内联正文的规程来源清单契约。
- */
-export type PlaybookSourceManifest = Omit<ActionDockManifest, "playbooks"> & {
-    playbooks?: Record<string, PlaybookSourceEntry>;
-};
 /**
  * ActionDock 项目根配置文件契约（等同于 ActionDockManifest，actiondock.json 为单一事实源）。
  */
 export type ProjectConfig = ActionDockManifest;
-/**
- * 内存运行时或图模型中支持内联正文的项目配置契约。
- */
-export type RuntimeProjectConfig = PlaybookSourceManifest;
 /**
  * 解析后的完整 Playbook 定义对象。
  */