@actiondock/core 2.13.0 → 2.15.0

package/dist/project/types.d.ts

@@ -53,6 +53,25 @@ 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 为唯一事实源）。
  */
@@ -75,6 +94,8 @@ export interface ActionDockManifest {
     actions?: Record<string, ActionManifestEntry>;
     /** 声明的 Playbooks 集合（唯一事实源） */
     playbooks?: Record<string, PlaybookManifestEntry>;
+    /** 包级静态依赖引用，与 Action 的 uses 共用引用语义。 */
+    uses?: string[];
     /** 跨包外部依赖映射（逻辑包 ID 到 npm 包名） */
     dependencies?: Record<string, string>;
     /** 框架导出与分发边界文件列表 */
@@ -91,10 +112,20 @@ 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,6 +2,7 @@ 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";
@@ -399,31 +400,42 @@ export function resolvePackageRoot(packageIdOrPath, cwd, customHome) {
     const resolvedPath = resolve(baseDir, packageIdOrPath);
     // 检查 packageIdOrPath 是否为磁盘上现存的目录或文件路径
     if (existsSync(resolvedPath)) {
+        let info;
         try {
-            const info = statSync(resolvedPath);
+            info = statSync(resolvedPath);
+        }
+        catch (err) {
+            if (err?.code !== "ENOENT" && err?.code !== "ENOTDIR") {
+                throw err;
+            }
+        }
+        if (info) {
             const targetDir = info.isDirectory() ? resolvedPath : dirname(resolvedPath);
+            // 普通开发包根目录：直接包含 actiondock.json 清单。
+            // 普通清单根目录定位与封闭 Skill 执行校验分离，不能被当成只含一个包的 Skill 闭包拒绝。
             if (existsSync(join(targetDir, "actiondock.json"))) {
+                loadProjectConfig(targetDir);
                 return targetDir;
             }
-            const parentRoot = findProjectRoot(targetDir);
-            if (parentRoot) {
-                return parentRoot;
+            // 复合技能布局：根目录下存在 packages/ 目录且包含有效子包。
+            const localSkill = inspectLocalPackageDirectory(targetDir);
+            if (localSkill) {
+                return localSkill.root;
+            }
+            // 具体文件查找所属工程根目录：仅当 packageIdOrPath 指向具体文件（非目录）时，
+            // 才尝试向上查找所属工程根目录；目录形态绝不向上回退，防止显式目录越界命中父级工程。
+            if (!info.isDirectory()) {
+                const parentRoot = findProjectRoot(targetDir);
+                if (parentRoot) {
+                    loadProjectConfig(parentRoot);
+                    return parentRoot;
+                }
             }
-        }
-        catch {
-            // stat 失败（如并发删除）：忽略并继续走标识符解析路径
         }
     }
     // 显式路径形态但未解析成功的场景：
     // scoped package 标识符（如 @team/tools）虽含 '/' 但属于包 ID 而非文件路径
-    const isScopedPackage = packageIdOrPath.startsWith("@");
-    const isExplicitPath = !isScopedPackage &&
-        (packageIdOrPath.startsWith(".") ||
-            packageIdOrPath.startsWith("/") ||
-            packageIdOrPath.startsWith("~") ||
-            packageIdOrPath.includes("/") ||
-            packageIdOrPath.includes("\\"));
-    if (isExplicitPath) {
+    if (isExplicitPath(packageIdOrPath)) {
         // 显式路径不存在或不是 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 } from "../project/types.js";
+import type { ProjectConfig, RuntimeProjectConfig } 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, globalStorage?: RuntimeStorage);
+    constructor(storage: RuntimeStorage, overrides?: Record<string, unknown>, projectConfig?: ProjectConfig | RuntimeProjectConfig, 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;
+    projectConfig?: ProjectConfig | RuntimeProjectConfig;
     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: a.id,
+        id: ctx.options.multiPackage && a.packageId && !a.id.includes("/") ? `${a.packageId}/${a.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: ctx.options.packageId,
+        packageId: action.packageId || ctx.options.packageId,
     });
     if (isJson) {
         ctx.writeOut(JSON.stringify(payload, null, 2));
@@ -274,6 +274,9 @@ 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");
@@ -350,6 +353,9 @@ 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,6 +24,8 @@ export interface InvocationControl {
 export interface StandaloneDispatcherOptions {
     /** 所属 Package ID */
     packageId: string;
+    /** 多包入口使用完全限定发现标识，不以展示名操作配置和状态。 */
+    multiPackage?: boolean;
     /** 版本号 */
     version: string;
     /** 描述信息 */

package/dist/storage/sqlite-driver.d.ts

@@ -1,4 +1,3 @@
-import "../utils/warning.js";
 import type { DatabaseSync } from "node:sqlite";
 import { normalizeSqliteParams } from "./params.js";
 import type { SqliteDriver, SqliteStatement } from "./types.js";

package/dist/storage/sqlite-driver.js

@@ -1,4 +1,3 @@
-import "../utils/warning.js";
 import { normalizeSqliteParams } from "./params.js";
 import { ActionDockError, ASYNC_TRANSACTION_UNSUPPORTED, STORAGE_CLOSED } from "../errors.js";
 // 基于原生 ESM Top-Level Await 在模块评估期动态加载，确保警告静默拦截器优先就绪且保持纯正 ESM 架构

package/dist/utils/index.d.ts

@@ -104,4 +104,3 @@ export declare function assertPathWithinRoot(rootDir: string, targetPath: string
  * Backwards-compatible alias for assertPathWithinRoot targeting project roots.
  */
 export declare function assertWithinProjectRoot(projectRoot: string, subDir: string, fieldName: string): void;
-export { suppressExperimentalWarnings } from "./warning.js";

package/dist/utils/index.js

@@ -281,4 +281,3 @@ export function assertWithinProjectRoot(projectRoot, subDir, fieldName) {
     }
     assertPathWithinRoot(projectRoot, subDir, fieldName);
 }
-export { suppressExperimentalWarnings } from "./warning.js";

package/dist/utils/semver.d.ts

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

package/dist/utils/semver.js

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actiondock/core",
-  "version": "2.13.0",
+  "version": "2.15.0",
   "description": "ActionDock Core Engine - Project loader, runtime execution, SQLite storage, standalone builder, and skill exporter",
   "type": "module",
   "main": "./dist/index.js",
@@ -41,11 +41,6 @@
       "types": "./dist/package/index.d.ts",
       "import": "./dist/package/index.js",
       "default": "./dist/package/index.js"
-    },
-    "./warning": {
-      "types": "./dist/utils/warning.d.ts",
-      "import": "./dist/utils/warning.js",
-      "default": "./dist/utils/warning.js"
     }
   },
   "files": [
@@ -64,7 +59,7 @@
     "test": "node ../../scripts/run-tests.ts"
   },
   "dependencies": {
-    "@actiondock/sdk": "^2.13.0",
+    "@actiondock/sdk": "^2.15.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "undici": "^7.29.1"

package/dist/utils/warning.d.ts

@@ -1 +0,0 @@
-export declare function suppressExperimentalWarnings(): void;

package/dist/utils/warning.js

@@ -1,52 +0,0 @@
-/**
- * 全局禁用 Node.js 所有的 ExperimentalWarning 实验性特性警告。
- * 跨所有 Node.js 运行版本，不区分具体特性（如 SQLite、类型擦除等），
- * 在进程级别统一静默全部实验性警告，同时完整保留废弃警告与运行期异常。
- *
- * 逃生通道：当环境变量 ACTIONDOCK_SILENCE_WARNINGS 显式设置为 "0" 时，放弃静默以供深度调试排查。
- */
-const kExperimentalWarningSuppressed = Symbol.for("actiondock.experimental_warning_suppressed");
-export function suppressExperimentalWarnings() {
-    // 逃生通道：支持开发者显式禁用静默逻辑，确保排障透明度
-    if (process.env.ACTIONDOCK_SILENCE_WARNINGS === "0") {
-        return;
-    }
-    const globalObj = globalThis;
-    if (globalObj[kExperimentalWarningSuppressed]) {
-        return;
-    }
-    globalObj[kExperimentalWarningSuppressed] = true;
-    // 1. 拦截 process.emitWarning 源头
-    const originalEmitWarning = process.emitWarning;
-    if (typeof originalEmitWarning === "function") {
-        process.emitWarning = function (warning, ...args) {
-            if (typeof warning === "string") {
-                const type = typeof args[0] === "string" ? args[0] : args[0]?.type || args[1];
-                if (type === "ExperimentalWarning") {
-                    return;
-                }
-            }
-            else if (warning) {
-                const warnObj = warning;
-                if (warnObj.name === "ExperimentalWarning" || warnObj.type === "ExperimentalWarning") {
-                    return;
-                }
-            }
-            return Reflect.apply(originalEmitWarning, process, [warning, ...args]);
-        };
-    }
-    // 2. 包装进程级 warning 事件分发器，作为双层防护
-    const originalListeners = process.listeners("warning");
-    process.removeAllListeners("warning");
-    process.on("warning", (warning) => {
-        const warnObj = warning;
-        if (warnObj.name === "ExperimentalWarning" || warnObj.type === "ExperimentalWarning") {
-            return;
-        }
-        for (const listener of originalListeners) {
-            listener.call(process, warning);
-        }
-    });
-}
-// 模块被引入时立即自执行
-suppressExperimentalWarnings();