@actiondock/core 2.15.0 → 2.16.0

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.16.0",
         },
         devDependencies: {
-            "@actiondock/testing": "^2.15.0",
+            "@actiondock/testing": "^2.16.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 定义对象。
  */

package/dist/registry/registry.js

@@ -2,7 +2,6 @@ import { existsSync, mkdirSync, readFileSync, renameSync, statSync } from "node:
 import { readFile, rename, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import { findProjectRoot, loadProjectConfig } from "../project/loader.js";
-import { inspectLocalPackageDirectory, isExplicitPath } from "../project/skill-dir.js";
 import { getActionDockHome, getPackageSlug } from "../utils/index.js";
 import { ActionDockError, MANIFEST_NOT_FOUND, REGISTRY_CORRUPTED } from "../errors.js";
 import { withRegistryLock } from "./lock.js";
@@ -400,42 +399,31 @@ export function resolvePackageRoot(packageIdOrPath, cwd, customHome) {
     const resolvedPath = resolve(baseDir, packageIdOrPath);
     // 检查 packageIdOrPath 是否为磁盘上现存的目录或文件路径
     if (existsSync(resolvedPath)) {
-        let info;
         try {
-            info = statSync(resolvedPath);
-        }
-        catch (err) {
-            if (err?.code !== "ENOENT" && err?.code !== "ENOTDIR") {
-                throw err;
-            }
-        }
-        if (info) {
+            const info = statSync(resolvedPath);
             const targetDir = info.isDirectory() ? resolvedPath : dirname(resolvedPath);
-            // 普通开发包根目录：直接包含 actiondock.json 清单。
-            // 普通清单根目录定位与封闭 Skill 执行校验分离，不能被当成只含一个包的 Skill 闭包拒绝。
             if (existsSync(join(targetDir, "actiondock.json"))) {
-                loadProjectConfig(targetDir);
                 return targetDir;
             }
-            // 复合技能布局：根目录下存在 packages/ 目录且包含有效子包。
-            const localSkill = inspectLocalPackageDirectory(targetDir);
-            if (localSkill) {
-                return localSkill.root;
-            }
-            // 具体文件查找所属工程根目录：仅当 packageIdOrPath 指向具体文件（非目录）时，
-            // 才尝试向上查找所属工程根目录；目录形态绝不向上回退，防止显式目录越界命中父级工程。
-            if (!info.isDirectory()) {
-                const parentRoot = findProjectRoot(targetDir);
-                if (parentRoot) {
-                    loadProjectConfig(parentRoot);
-                    return parentRoot;
-                }
+            const parentRoot = findProjectRoot(targetDir);
+            if (parentRoot) {
+                return parentRoot;
             }
         }
+        catch {
+            // stat 失败（如并发删除）：忽略并继续走标识符解析路径
+        }
     }
     // 显式路径形态但未解析成功的场景：
     // scoped package 标识符（如 @team/tools）虽含 '/' 但属于包 ID 而非文件路径
-    if (isExplicitPath(packageIdOrPath)) {
+    const isScopedPackage = packageIdOrPath.startsWith("@");
+    const isExplicitPath = !isScopedPackage &&
+        (packageIdOrPath.startsWith(".") ||
+            packageIdOrPath.startsWith("/") ||
+            packageIdOrPath.startsWith("~") ||
+            packageIdOrPath.includes("/") ||
+            packageIdOrPath.includes("\\"));
+    if (isExplicitPath) {
         // 显式路径不存在或不是 ActionDock 项目时必须失败，禁止静默回退
         return null;
     }

package/dist/runtime/context.d.ts

@@ -1,5 +1,5 @@
 import type { ActionContext, ActionRef, Config, Logger, ProcessAPI, ProgressReporter, StateStore } from "@actiondock/sdk";
-import type { ProjectConfig, RuntimeProjectConfig } from "../project/types.js";
+import type { ProjectConfig } from "../project/types.js";
 import type { RuntimeStorage } from "../storage/types.js";
 import { ProcessManager, type ProcessOwner } from "../process/index.js";
 /**
@@ -17,7 +17,7 @@ export declare class RuntimeConfig implements Config {
     private storage;
     private projectConfig?;
     private globalStorage?;
-    constructor(storage: RuntimeStorage, overrides?: Record<string, unknown>, projectConfig?: ProjectConfig | RuntimeProjectConfig, globalStorage?: RuntimeStorage);
+    constructor(storage: RuntimeStorage, overrides?: Record<string, unknown>, projectConfig?: ProjectConfig, globalStorage?: RuntimeStorage);
     get<T = unknown>(key: string): T | undefined;
     get<T = unknown>(key: string, defaultValue: T): T;
     has(key: string): boolean;
@@ -70,7 +70,7 @@ export interface ContextOptions {
     storage: RuntimeStorage;
     globalStorage?: RuntimeStorage;
     overrides?: Record<string, unknown>;
-    projectConfig?: ProjectConfig | RuntimeProjectConfig;
+    projectConfig?: ProjectConfig;
     parentRunId?: string;
     runId?: string;
     rootRunId?: string;

package/dist/runtime/standalone-commands.js

@@ -29,7 +29,7 @@ export async function handleList(ctx, subArgs) {
     const effectiveIntent = intent || (positionalPatterns.length > 0 ? positionalPatterns.join("|") : undefined);
     const actions = await ctx.service.discovery.listActions();
     const list = actions.map((a) => ({
-        id: ctx.options.multiPackage && a.packageId && !a.id.includes("/") ? `${a.packageId}/${a.id}` : a.id,
+        id: a.id,
         description: a.description || "",
     }));
     const filterRes = filterWithFallbackInfo(list, effectiveIntent, [(a) => a.id, (a) => a.description], !noFallback);
@@ -66,7 +66,7 @@ export async function handleDescribe(ctx, subArgs) {
         });
     }
     const payload = buildActionDescribePayload(action, {
-        packageId: action.packageId || ctx.options.packageId,
+        packageId: ctx.options.packageId,
     });
     if (isJson) {
         ctx.writeOut(JSON.stringify(payload, null, 2));
@@ -274,9 +274,6 @@ function isServiceCapabilityError(err) {
         code === "TARGET_CAPABILITY_UNAVAILABLE");
 }
 export async function handleConfig(ctx, subArgs) {
-    if (ctx.options.multiPackage) {
-        return ctx.emitError(subArgs.includes("--json"), "CAPABILITY_UNAVAILABLE", "Multi-package entries do not support config/state management; configure actions using --config and --data-dir.", ExitCode.INVALID_ARGUMENT);
-    }
     const sub = subArgs[0] || "list";
     if (!ctx.service.management) {
         ctx.writeErr("Error: management port is not enabled on this service");
@@ -353,9 +350,6 @@ function decodeStateKeyArg(key) {
     }
 }
 export async function handleState(ctx, subArgs) {
-    if (ctx.options.multiPackage) {
-        return ctx.emitError(subArgs.includes("--json"), "CAPABILITY_UNAVAILABLE", "Multi-package entries do not support config/state management; configure actions using --config and --data-dir.", ExitCode.INVALID_ARGUMENT);
-    }
     const sub = subArgs[0] || "list";
     let namespace;
     let isAll = false;

package/dist/runtime/standalone.d.ts

@@ -24,8 +24,6 @@ export interface InvocationControl {
 export interface StandaloneDispatcherOptions {
     /** 所属 Package ID */
     packageId: string;
-    /** 多包入口使用完全限定发现标识，不以展示名操作配置和状态。 */
-    multiPackage?: boolean;
     /** 版本号 */
     version: string;
     /** 描述信息 */

package/dist/utils/semver.d.ts

@@ -6,11 +6,10 @@ export interface SemVer {
     minor: number;
     patch: number;
     prerelease?: string;
-    build?: string;
 }
 /**
  * 解析基础 SemVer 版本字符串（单一事实源）。
- * 仅接受可选 v/= 前缀的严格三段式语义化版本，可携带预发布后缀与构建元数据；
+ * 仅接受可选 v/= 前缀的严格三段式语义化版本，可携带预发布后缀；
  * 其余形态（两段式、非数值等）返回 null，由调用方自行兜底。
  *
  * 本模块不依赖任何 Node 内建与 core 领域模块，可在无 loader 的原生

package/dist/utils/semver.js

@@ -1,25 +1,19 @@
 /**
  * 解析基础 SemVer 版本字符串（单一事实源）。
- * 仅接受可选 v/= 前缀的严格三段式语义化版本，可携带预发布后缀与构建元数据；
+ * 仅接受可选 v/= 前缀的严格三段式语义化版本，可携带预发布后缀；
  * 其余形态（两段式、非数值等）返回 null，由调用方自行兜底。
  *
  * 本模块不依赖任何 Node 内建与 core 领域模块，可在无 loader 的原生
  * Node 直接以 .ts 形态导入（工程脚本域复用此处单一事实源）。
  */
 export function parseSemVer(v) {
-    const match = v.trim().replace(/^[v=]/, "").match(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/);
+    const match = v.trim().replace(/^[v=]/, "").match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
     if (!match)
         return null;
-    const [major, minor, patch] = match.slice(1, 4).map(Number);
-    if (![major, minor, patch].every(Number.isSafeInteger))
-        return null;
-    if (match[4]?.split(".").some((id) => /^\d+$/.test(id) && id.length > 1 && id.startsWith("0")))
-        return null;
     return {
-        major,
-        minor,
-        patch,
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
         prerelease: match[4],
-        ...(match[5] === undefined ? {} : { build: match[5] }),
     };
 }

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 /**
  * ActionDock 核心版本号单一事实源。
  */
-export declare const ACTIONDOCK_VERSION = "2.15.0";
+export declare const ACTIONDOCK_VERSION = "2.16.0";

package/dist/version.js

@@ -1,4 +1,4 @@
 /**
  * ActionDock 核心版本号单一事实源。
  */
-export const ACTIONDOCK_VERSION = "2.15.0";
+export const ACTIONDOCK_VERSION = "2.16.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/core",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "ActionDock Core Engine - Project loader, runtime execution, SQLite storage, standalone builder, and skill exporter",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,7 +59,7 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/sdk": "^2.15.0",
+    "@actiondock/sdk": "^2.16.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "undici": "^7.29.1"