dsh-plugin-prompt-tool 2.0.1 → 2.1.0

package/lib/{rules-migration-DJ6vASB5.mjs → rule-builder-DMrJten6.mjs}

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, rmdirSync, statSync, writeFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -24,8 +24,8 @@ function resolveDshHome() {
 	return resolve(expanded);
 }
 const DSH_HOME = resolveDshHome();
-/** 用户技能根：官方 `user-dsh` 技能根，也是本插件创建、复制导入与回收站的落点。
-*  插件不再内置任何技能：包内没有 skills 目录，也不再有安装副本与内容账本。 */
+/** 用户技能根：官方 `user-dsh` 技能根，也是本插件创建、复制导入、回收站与内置技能种子化的落点。
+*  内置技能按「只补缺失」补建（见 `ensureSkillSeed`）：已有目录的正文、资源与调用策略保持原样。 */
 const USER_SKILLS_DIR = join(DSH_HOME, "skills");
 /**
 * 插件自有**存储根**（DSH_HOME/.prompt-tool）。
@@ -657,7 +657,7 @@ var ModuleLayerSettingsError = class extends Error {
 		this.name = "ModuleLayerSettingsError";
 	}
 };
-const isRecord$1 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 function engineParamPath(key) {
 	if (!Object.prototype.hasOwnProperty.call(ENGINE_PARAM_LAYERS, key)) throw new Error(`未知引擎参数：${key}`);
 	return [
@@ -672,11 +672,11 @@ function readLayerSettings(value) {
 		throw new ModuleLayerSettingsError(message);
 	};
 	if (value === void 0) return {};
-	if (!isRecord$1(value)) return invalid("layerSettings 必须是对象");
+	if (!isRecord(value)) return invalid("layerSettings 必须是对象");
 	const params = {};
 	for (const [layer, settings] of Object.entries(value)) {
 		if (!INJECTION_POINT_ORDER.includes(layer)) invalid(`未知插入点：layerSettings.${layer}`);
-		if (!isRecord$1(settings)) return invalid(`layerSettings.${layer} 必须是对象`);
+		if (!isRecord(settings)) return invalid(`layerSettings.${layer} 必须是对象`);
 		for (const [key, entry] of Object.entries(settings)) {
 			if (!Object.prototype.hasOwnProperty.call(ENGINE_PARAM_LAYERS, key)) continue;
 			const expected = ENGINE_PARAM_LAYERS[key];
@@ -688,7 +688,7 @@ function readLayerSettings(value) {
 }
 /** 仅消费当前 layerSettings；其余段作为未知字段留存，不投影为运行时参数。 */
 function readModuleLayerSettings(source) {
-	if (!isRecord$1(source)) throw new ModuleLayerSettingsError("module.yml 必须是对象");
+	if (!isRecord(source)) throw new ModuleLayerSettingsError("module.yml 必须是对象");
 	return readLayerSettings(source.layerSettings);
 }
 //#endregion
@@ -816,8 +816,7 @@ const MAX_TRACKED_SESSIONS = 4096;
 *
 * 收敛「每个模块自己维护会话态 Map、自己决定上限与清空策略、自己决定复位时机」，
 * 但**不改变任何既有策略**：键类型、淘汰策略、复位语义逐项由调用方按现状声明，
-* 本函数只把它们收进同一套读写入口。它**不替代** `sessionMapGet`（后者仍是
-* 「按 id + 超限全清」这一档的实现，本函数在 `evict` 缺省且按 id 索引时逐字复用它）。
+* 本函数只把它们收进同一套读写入口。
 *
 * ## 三个必答项（正好对应现状的三处差异）
 *
@@ -978,8 +977,7 @@ function createMask(source, label, plugin, allowExtra) {
 		allowExtra,
 		/**
 		* fail-open 兜底开关（**可选**，缺省 false）：原 `tool-bootstrap` 的语义是
-		* 「keep 名单里的工具在本次装配目录里一个都不存在 → 放弃裁剪、暴露完整目录」（声明侧见
-		* `test/engine/declarations/tool-bootstrap.yml` 的 `requireMatch: true`），而原
+		* 「keep 名单里的工具在本次装配目录里一个都不存在 → 放弃裁剪、暴露完整目录」，而原
 		* `tool-filter` 的同名场景是**照名单裁成空目录**。两种语义都真实存在，所以这里
 		* **不设默认**——要兜底的声明自己写 `requireMatch: true`。把某一个模块的特有语义当成
 		* 通用默认，会让另一个声明路径的行为被悄悄改掉（这正是对拍抓出来的）。
@@ -1012,7 +1010,7 @@ const ACTION_DEGRADE = Object.freeze({
 	silent: "silent"
 });
 /**
-* 七类动作的声明：**合法事件通道** + **降级语义** + 触发时机。
+* 九类动作的声明：**合法事件通道** + **降级语义** + 触发时机。
 * `events` 是动作允许注册的官方事件（注册到声明外的事件在挂载期 fail loud）；
 * `services` 是它允许触碰的宿主服务方法（同一纪律的文档面）。
 */
@@ -9911,8 +9909,7 @@ function wireRuntimeContexts(ctx, configs, registry, warnOnce, keep, on) {
 *   - `replace: true`：整体替换为 `patch`（不叠加 base，故 `unset` 无比较对象）；
 *   - `unset`：**按值条件删键** —— 仅当合并结果里的值**恰好等于**声明值时删除该键
 *     （`Object.is` 比较）。这来自原 `tool-bootstrap` 剥离 `bootstrapMaxTokens` 的语义
-*     （「仅当解析后的 maxTokens 恰好等于本声明注入的那个值时才删」；声明侧见
-*     `test/engine/declarations/tool-bootstrap.yml` 声明 4 的 `do.unset`），不是"存在即删"
+*     （「仅当解析后的 maxTokens 恰好等于本声明注入的那个值时才删」），不是"存在即删"
 *     ——模型或其它插件设置的同名参数不会被删。
 *     浅合并做不到删键，故删键必须走显式通道。
 * @param params 提示词配置的 `params`（或动作的等价声明）。
@@ -10094,7 +10091,7 @@ function createTurnStopBudget() {
 	/**
 	* 会话预算条目（`sessionState`：统一访问接口，策略逐条声明）。
 	*
-	* 键类型 `session.id`；淘汰策略超限 `clear()` 全清（与迁移前的 `sessionMapGet` 同档：
+	* 键类型 `session.id`；淘汰策略超限 `clear()` 全清（与迁移前的会话态记账同档：
 	* 第 `MAX_TRACKED_SESSIONS` 个会话仍会清空整个容器）；**不声明复位**——预算是纯增量、
 	* 不可从事件流重建的计数（与 `progress-reminder` 同档），丢失时机必须与迁移前逐字一致，
 	* compaction 也不重置它。
@@ -12578,7 +12575,7 @@ function wireTriggerObservers(ctx, triggers, { plugin, warnOnce } = {}) {
 //#endregion
 //#region engine/branch.mjs
 /**
-* 分支语法的唯一展开器：`if`/`then`/`else` 是当前名，`when`/`do` 是兼容输入。
+* 分支语法的唯一展开器：只认 `if`/`then`/`else`，旧名 `when`/`do` 由各入口显式拒绝。
 *
 * 规则（`rule-spec.mjs`）与触发器声明（`trigger-spec.mjs`）共用这一份实现——
 * 两套入口必须是同一套语义，否则同一个模块换个入口就换行为。
@@ -12629,7 +12626,7 @@ function expandActions(list, options = {}, label) {
 //#endregion
 //#region engine/rule-spec.mjs
 /** module.yml.rules 的唯一运行时编译入口。旧声明仅由离线迁移器读取。 */
-/** 规则字段：`if`/`then`/`else` 是当前名，`when`/`do` 保留为兼容输入（见 pickAlias）。 */
+/** 规则字段：只有 `if`/`then`/`else`；旧名 `when`/`do` 留在名单里，只为把 unknown fields 换成一句「已退役，改用 X」。 */
 const RULE_FIELDS = /* @__PURE__ */ new Set([
 	"id",
 	"name",
@@ -12842,7 +12839,7 @@ function stable(value) {
 	if (Array.isArray(value)) return value.map(stable);
 	return record$2(value) ? Object.fromEntries(Object.keys(value).sort().map((key) => [key, stable(value[key])])) : value;
 }
-const digest$1 = (value) => revisionOf(JSON.stringify(stable(value)));
+const digest = (value) => revisionOf(JSON.stringify(stable(value)));
 const yaml = (value) => new Document(value).toString();
 var ModuleRulesError = class extends Error {
 	status;
@@ -12942,7 +12939,7 @@ function projection(source, directory, sourceRevision, validation = {}) {
 			...exclusive === void 0 ? {} : { exclusive }
 		};
 		files[`${rule.id}.yml`] = yaml(content);
-		ruleRevisions[rule.id] = digest$1(content);
+		ruleRevisions[rule.id] = digest(content);
 	}
 	files[RULES_VARIABLES_FILE] = yaml(variables);
 	const state = {
@@ -12951,8 +12948,8 @@ function projection(source, directory, sourceRevision, validation = {}) {
 	};
 	const revisions = {
 		rules: ruleRevisions,
-		settings: digest$1(state),
-		variables: digest$1(variables)
+		settings: digest(state),
+		variables: digest(variables)
 	};
 	files[RULES_SETTINGS_FILE] = yaml({
 		...state,
@@ -13941,26 +13938,20 @@ function buildModuleConfigsFromParams(params, options = {}) {
 	return out;
 }
 /**
-* 组合模块目录分工：
-* - source/local：本项目自有模块的唯一源文件；
-* - library：随包分发的官方切块与官方预设变体快照（版本化产物，不手工编辑）；
-*   生成它的 `rebuild-composition` 脚本随内置模块目录 `modules/` 一并退场——输入源已不存在，
-*   快照本体保留为既成事实，不再重建。
-* 同名文件禁止同时存在，避免 source 与产物漂移。
+* 组合模块目录：本项目自有模块的唯一源是 `source/local/`。官方切块已随「与预设彻底解耦」
+* 全部清理——官方工具由会话原有预设提供，模块不需要也不应该重新声明它们。
 */
 function compositionModuleDirs() {
-	const root = join(packageEngineDir(), "compositions");
-	return [join(root, "source", "local"), join(root, "library")];
+	return [join(packageEngineDir(), "compositions", "source", "local")];
 }
 function assertBareModuleName(name) {
 	if (name.includes("/") || name.includes("\\") || name === "." || name === ".." || name.includes("..")) throw new Error(`composition module name ${JSON.stringify(name)} must be a bare library name`);
 }
 function moduleFile(name) {
 	assertBareModuleName(name);
-	const existing = compositionModuleDirs().map((dir) => join(dir, `${name}.yml`)).filter((file) => existsSync(file));
-	if (existing.length > 1) throw new Error(`composition module ${name} is duplicated across source/local and library: ${existing.join(", ")}`);
-	if (existing.length === 0) throw new Error(`composition module ${name} not found in source/local or library`);
-	return existing[0];
+	const file = join(compositionModuleDirs()[0], `${name}.yml`);
+	if (!existsSync(file)) throw new Error(`composition module ${name} not found in source/local`);
+	return file;
 }
 function assembleModules(spec) {
 	const parts = [];
@@ -14629,117 +14620,11 @@ function saveModuleConfigOrder(root, expectedRevision, entries, moduleId) {
 	return writeOrders(root, inputs, orders);
 }
 //#endregion
-//#region src/host/legacy-prompt-params.ts
-/** 旧层参数到规则实例的唯一兼容投影；读取、导入物化与旧 API 保存共用。 */
-const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const text = (value) => value === void 0 || value === null ? "" : String(value);
-function readLegacyPromptParams(source) {
-	const params = {};
-	if (!isRecord(source.layerSettings)) return params;
-	for (const [layer, settings] of Object.entries(source.layerSettings)) {
-		if (!isRecord(settings)) continue;
-		for (const [key, value] of Object.entries(settings)) {
-			if (!isLegacyPromptParam(key)) continue;
-			if (layer !== "pre-step") throw new ModuleLayerSettingsError(`${key} 必须位于 layerSettings.pre-step`);
-			params[key] = value === "on" ? true : value === "off" ? false : value;
-		}
-	}
-	return params;
-}
-function legacyBody(source, moduleDir, supplied) {
-	if (supplied !== void 0) return supplied;
-	if (moduleDir !== void 0) try {
-		const file = join(moduleDir, "preset.md");
-		if (lstatSync(file).isSymbolicLink()) throw new Error(`旧模块正文不能是链接：${file}`);
-		return readFileSync(file, "utf8");
-	} catch (error) {
-		if (error.code !== "ENOENT") throw error;
-	}
-	return text(source.content?.presetText);
-}
-function resolveLegacyPromptConfigs(source, options = {}) {
-	const params = readLegacyPromptParams(source);
-	for (const [key, value] of Object.entries(options.overrides ?? {})) if (isLegacyPromptParam(key) && value !== void 0 && value !== null) params[key] = value;
-	const keys = LEGACY_PROMPT_PARAM_KEYS.filter((key) => Object.hasOwn(params, key));
-	const applies = (id) => keys.some((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.includes(id));
-	const provided = (key) => options.partial !== true || Object.hasOwn(params, key);
-	const projected = (source.promptConfigs ?? []).map((config) => {
-		if (!isRecord(config) || !applies(config.id)) return config;
-		const next = {
-			...config,
-			params: { ...config.params }
-		};
-		if (config.id === "near-anchor") {
-			if (provided("firstTurnAnchor")) next.enabled = params.firstTurnAnchor === true;
-			if (provided("firstTurnCustom")) next.params.useCustom = params.firstTurnCustom === true;
-			if (provided("firstTurnText")) next.params.text = text(params.firstTurnText);
-			for (const key of [
-				"buildPattern",
-				"complexPattern",
-				"firstTurnBuild",
-				"firstTurnInspect",
-				"firstTurnDeep"
-			]) if (provided(key)) next.params[key] = text(params[key]);
-		} else if (config.id === "router-guide") {
-			if (provided("guideEnabled")) next.enabled = params.guideEnabled === true;
-			if (provided("guideCustom") || provided("guideEnabled")) {
-				const useCustom = provided("guideCustom") ? params.guideCustom === true : next.params.useCustom === true;
-				next.params.useCustom = useCustom;
-				next.modelScope = useCustom ? "all" : "flash";
-			}
-			if (provided("guideText")) next.params.text = text(params.guideText);
-			for (const key of [
-				"complexPattern",
-				"guideWeak",
-				"guideDeep"
-			]) if (provided(key)) next.params[key] = text(params[key]);
-		}
-		return next;
-	});
-	const configs = mergePromptConfigs(projected, options.promptConfigs).map((config) => {
-		if (config.id !== "prompt-injector" || !applies(config.id)) return config;
-		const body = legacyBody(source, options.moduleDir, options.prompt);
-		const explicitWord = text(options.partial === true && Object.hasOwn(params, "firstTurnWord") ? params.firstTurnWord : config.params?.firstTurnWord ?? params.firstTurnWord);
-		const anchor = projected.find((entry) => entry.id === "near-anchor");
-		const signalWord = (value) => {
-			const sentence = /the exact sentence:\s*([A-Za-z]+)/i.exec(value);
-			const first = /^\P{L}*([\p{L}]+)/u.exec(value.trim());
-			return (sentence?.[1] ?? first?.[1])?.toLowerCase();
-		};
-		const derivedWords = [...new Set([
-			"firstTurnText",
-			"firstTurnBuild",
-			"firstTurnInspect",
-			"firstTurnDeep"
-		].map((key) => signalWord(text(Object.hasOwn(params, key) || options.partial !== true ? params[key] : anchor?.params?.[key === "firstTurnText" ? "text" : key]))).filter((word) => word !== void 0))];
-		const { text: _text, texts: _texts, ...rest } = config;
-		return {
-			...rest,
-			enabled: body.trim().length > 0 && (provided("injectPrompt") ? params.injectPrompt !== false : config.enabled !== false),
-			params: {
-				...config.params,
-				text: body,
-				firstTurnWord: explicitWord,
-				anchorWords: explicitWord.length > 0 ? [explicitWord] : derivedWords
-			}
-		};
-	});
-	const ids = new Set(configs.map((config) => config.id));
-	const consumedKeys = keys.filter((key) => LEGACY_PROMPT_PARAM_DEFINITIONS[key].targets.some((id) => ids.has(id)));
-	const unhandled = keys.filter((key) => !consumedKeys.includes(key));
-	return {
-		configs,
-		consumedKeys,
-		active: keys.length > 0,
-		warnings: unhandled.length === 0 ? [] : [`旧规则参数没有承接配置，原值保留：${unhandled.join(", ")}`]
-	};
-}
-//#endregion
-//#region src/host/rules-migration.ts
-/** 旧规则只在显式离线迁移或外部导入时转换；运行时不调用此模块。 */
+//#region src/host/rule-builder.ts
+/** 提示词配置 → 规则的纯构造函数：外部导入（SillyTavern / 角色卡 / 世界书）与离线迁移共用，运行时不调用。 */
 const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const condition = (items) => items.length === 0 ? void 0 : items.length === 1 ? items[0] : { all: items };
-/** 旧非空行为由显式模板快照保存，迁移器不再持有另一份业务文案。 */
+/** 旧非空行为由显式模板快照保存，转换器不再持有另一份业务文案。 */
 function legacyPolicyDefaults() {
 	const file = join(dirname(packageEngineDir()), "templates", "policies", "legacy-defaults.yml");
 	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
@@ -14787,33 +14672,6 @@ function migrateFillerDefaults(config) {
 	if (Object.keys(params).length > 0) next.params = params;
 	return next;
 }
-/** 只递归条件语法树；正文、正则字符串及未知对象字段均不扫描或改写。 */
-function migrateConditionDefaults(value) {
-	if (!record(value)) return value;
-	if (Object.keys(value).length !== 1) return value;
-	if (record(value.phase) && value.phase.promoteGate === true) {
-		const phase = structuredClone(value.phase);
-		fillMissing(phase, legacyPolicyDefaults().promotionGate);
-		return { phase };
-	}
-	for (const key of [
-		"all",
-		"any",
-		"notAny"
-	]) if (Array.isArray(value[key])) return { [key]: value[key].map(migrateConditionDefaults) };
-	if (Object.hasOwn(value, "not")) return { not: migrateConditionDefaults(value.not) };
-	return value;
-}
-/** 参数桥优先于行配置；仅旧定义里确已打开的指令提示才携入旧非空模板。 */
-function instructionHintPolicyPatch(source) {
-	const params = readModuleLayerSettings(source);
-	const modules = record(source.moduleConfigs) ? source.moduleConfigs : {};
-	const current = record(modules["instruction-hint"]) ? modules["instruction-hint"] : {};
-	if (!(Object.hasOwn(params, "instructionHint") ? params.instructionHint === true : current.enabled === true)) return void 0;
-	const patched = { ...current };
-	fillMissing(patched, legacyPolicyDefaults().instructionHint);
-	return JSON.stringify(current) === JSON.stringify(patched) ? void 0 : patched;
-}
 /** 可供外部导入/模板创建复用的纯转换；既有投递身份、策略和官方位置原样保留。 */
 function promptConfigToRule(config) {
 	if (!record(config) || typeof config.id !== "string" || config.id.length === 0) throw new TypeError("旧提示词配置必须有 id");
@@ -14905,430 +14763,5 @@ function promptConfigToRule(config) {
 		then: actions
 	};
 }
-function rebaseTemplate(config, directory, previousBase) {
-	if (typeof config.templateFile !== "string" || config.templateFile.length === 0) return config;
-	const resolved = isAbsolute(config.templateFile) ? resolve(config.templateFile) : fileURLToPath(new URL(config.templateFile, previousBase));
-	const path = relative(directory, resolved);
-	if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path)) throw new Error(`模板路径不在模块目录，无法安全迁移：${config.templateFile}`);
-	if (!existsSync(resolved)) throw new Error(`模板文件缺失，无法验证迁移：${config.templateFile}`);
-	return {
-		...config,
-		templateFile: `./${path.replaceAll(sep, "/")}`
-	};
-}
-function convertLegacyModuleRules(source, options = {}) {
-	if (!record(source)) throw new TypeError("模块定义必须是对象");
-	const directory = options.directory;
-	const legacy = resolveLegacyPromptConfigs(source, { moduleDir: directory });
-	if (legacy.warnings.length > 0) throw new Error(`旧快捷参数没有无损承接规则：${legacy.warnings.join("; ")}`);
-	if (source.promptConfigs !== void 0 && !Array.isArray(source.promptConfigs)) throw new Error("promptConfigs 必须是数组");
-	if (source.triggers !== void 0 && !Array.isArray(source.triggers)) throw new Error("triggers 必须是数组");
-	if (source.rules !== void 0 && !Array.isArray(source.rules)) throw new Error("rules 必须是数组");
-	const root = directory === void 0 ? void 0 : dirname(directory);
-	let configs = mergePromptConfigs(modelRequestConfigs(readModuleLayerSettings(source)), legacy.configs);
-	const rules = structuredClone(source.rules ?? []);
-	const configOrder = readConfigOrder(source.configOrder);
-	if (directory !== void 0 && existsSync(join(directory, "configs"))) {
-		const actual = loadPromptConfigFiles(pathToFileURL(join(directory, "configs") + sep));
-		for (const [index, config] of actual.entries()) if (configOrder[config.id] === void 0) configOrder[config.id] = config[FILE_SEQUENCE] ?? index * 10;
-		if (!Object.hasOwn(source, "promptConfigs") && configs.length === 0) configs = actual;
-		else {
-			const options = {
-				sourceModuleId: source.id,
-				configOrder,
-				templateBaseUrl: pathToFileURL(join(root, ".engine", "prompt-config-engine.mjs")),
-				templateModuleRoot: pathToFileURL(root + sep)
-			};
-			const prepared = configs.map((config) => injectionConfigSpec({ id: config.id }, {
-				id: "inject",
-				kind: "inject-text",
-				config
-			}, source));
-			const comparable = (config) => config.strategy === "custom-fallback" ? {
-				...config,
-				strategy: "anchor-notice"
-			} : config;
-			const expected = createPromptConfigs(prepared.map(comparable), options);
-			const running = createPromptConfigs(actual.map(comparable), options);
-			const fingerprint = (entries) => contentHash(entries.map((config) => {
-				const value = { ...config };
-				if (value.enabled === false) delete value.texts;
-				return value;
-			}));
-			if (fingerprint(expected) !== fingerprint(running)) throw new Error(`模块 ${String(source.id ?? directory)} 的定义与旧实际物化内容不一致，无法无损迁移；请先明确选择来源`);
-		}
-	}
-	const append = (rule, sequence) => {
-		if (rules.some((item) => item.id === rule.id)) throw new Error(`规则身份冲突，须先明确改名：${rule.id}`);
-		rules.push(rule);
-		if (configOrder[rule.id] === void 0) configOrder[rule.id] = sequence;
-	};
-	for (const [index, config] of configs.entries()) append(promptConfigToRule(directory === void 0 ? config : rebaseTemplate(config, directory, pathToFileURL(join(root, ".engine", "prompt-config-engine.mjs")))), index * 10);
-	for (const [index, raw] of (source.triggers ?? []).entries()) {
-		if (!record(raw) || typeof raw.id !== "string" || raw.id.length === 0) throw new Error("旧声明必须有唯一 id");
-		const rawActions = Array.isArray(raw.do) ? raw.do : [raw.do];
-		let enabled;
-		const gates = raw.when == null ? [] : [migrateConditionDefaults(raw.when)];
-		const liftCondition = (gate) => {
-			if (gate === void 0) return;
-			if (rawActions.length !== 1) throw new Error(`声明 ${raw.id} 的动作局部条件不能无损提升为整卡条件；请先拆分声明`);
-			gates.push(gate);
-		};
-		const actions = rawActions.map((action, actionIndex) => {
-			if (!record(action) || typeof action.kind !== "string") throw new Error(`旧声明 ${raw.id} 的动作不合法`);
-			const point = actionExecutionPoint(action);
-			if (raw.channel !== point.channel || raw.phase !== void 0 && raw.phase !== point.phase) throw new Error(`旧声明 ${raw.id} 的执行点不合法`);
-			const next = structuredClone(action);
-			if (next.kind === "inject-text" && record(next.config)) {
-				const converted = promptConfigToRule(next.config);
-				if (converted.enabled === false && rawActions.length !== 1) throw new Error(`声明 ${raw.id} 的动作局部停用不能无损提升为整卡开关；请先拆分声明`);
-				if (rawActions.length === 1) enabled = converted.enabled;
-				liftCondition(converted.if);
-				const payload = converted.then[0]?.config;
-				const config = {
-					...next.config,
-					...record(payload) ? payload : {}
-				};
-				delete config.enabled;
-				const params = record(config.params) ? config.params : {};
-				if (params.complete !== true && params.suppressRuntimeContext !== true) for (const key of [
-					"audience",
-					"modelScope",
-					"promotion",
-					"subject",
-					"match"
-				]) delete config[key];
-				next.config = config;
-			}
-			if (next.kind === "request-params") {
-				const modelScope = Object.hasOwn(next, "modelScope") ? next.modelScope : "pro";
-				const scope = {
-					...next.audience == null || next.audience === "" ? {} : { audience: next.audience },
-					...modelScope == null || modelScope === "" || modelScope === "all" ? {} : { modelScope }
-				};
-				if (Object.keys(scope).length > 0) liftCondition({ scope });
-				delete next.audience;
-				delete next.modelScope;
-			}
-			if (next.kind === "inject-text" && record(next.config) && directory !== void 0) next.config = rebaseTemplate(next.config, directory, pathToFileURL(join(directory, "triggers.yml")));
-			return {
-				...next,
-				id: typeof next.id === "string" && next.id.length > 0 ? next.id : `action-${actionIndex + 1}`,
-				kind: action.kind,
-				channelOrder: typeof raw.channelOrder === "number" ? raw.channelOrder : 0,
-				...raw.waterfallPosition === void 0 ? {} : { waterfallPosition: raw.waterfallPosition }
-			};
-		});
-		if (actions.length > 1 && actions.some((action) => actionExecutionPoint(action).phase === "after-next")) throw new Error(`声明 ${raw.id} 含多个 after-next 动作，须先核对实际执行顺序再迁移`);
-		const layer = actions.find((action) => action.kind === "inject-text" && record(action.config))?.config;
-		append({
-			id: raw.id,
-			...enabled === void 0 ? {} : { enabled },
-			...layer?.layer === void 0 ? {} : { layer: layer.layer },
-			...condition(gates) === void 0 ? {} : { if: condition(gates) },
-			then: actions
-		}, (configs.length + index) * 10);
-	}
-	compileRules(rules, {
-		configOrder,
-		...directory === void 0 ? {} : {
-			moduleId: source.id,
-			promptConfigOptions: rulePromptConfigOptions(directory)
-		}
-	});
-	return {
-		rules,
-		configOrder,
-		consumedLegacyKeys: Object.keys(readLegacyPromptParams(source))
-	};
-}
-const MODEL_KEYS = RULE_OWNED_MODEL_PARAMS;
-const OLD_ENGINES = /* @__PURE__ */ new Set(["prompt-config-engine", "declared-triggers"]);
-const digest = (value) => createHash("sha256").update(value).digest("hex");
-const sortedValue = (value) => Array.isArray(value) ? value.map(sortedValue) : record(value) ? Object.fromEntries(Object.keys(value).sort().map((key) => [key, sortedValue(value[key])])) : value;
-const contentHash = (value) => digest(JSON.stringify(sortedValue(value)));
-/** 原证明仍匹配旧卡时才推进角色记忆哈希；用户改过的卡保持未认领。 */
-function migrateMemoryProofs(doc, source, rules) {
-	const proofs = record(source.meta) && record(source.meta.characterMemories) ? source.meta.characterMemories : {};
-	const configs = Array.isArray(source.promptConfigs) ? source.promptConfigs : [];
-	for (const [cardId, proof] of Object.entries(proofs)) {
-		if (!record(proof) || typeof proof.configId !== "string") continue;
-		const old = configs.find((config) => record(config) && config.id === proof.configId);
-		const rule = rules.find((item) => item.id === proof.configId);
-		if (old !== void 0 && rule !== void 0 && proof.contentHash === contentHash(old)) doc.setIn([
-			"meta",
-			"characterMemories",
-			cardId,
-			"contentHash"
-		], contentHash(rule));
-	}
-}
-/** 旧字段移入动作后仍把原注释保留在所属规则上，不把用户说明随旧段删除。 */
-function setMigratedRules(doc, rules) {
-	const comments = (node) => {
-		const own = record(node) ? [node.commentBefore, node.comment].filter((value) => typeof value === "string" && value.length > 0) : [];
-		if (isMap(node)) return [...own, ...node.items.flatMap((pair) => [...comments(pair.key), ...comments(pair.value)])];
-		if (isSeq(node)) return [...own, ...node.items.flatMap(comments)];
-		return own;
-	};
-	const previous = [
-		"rules",
-		"promptConfigs",
-		"triggers"
-	].map((key) => doc.get(key, true)).filter(isSeq);
-	const nodes = doc.createNode(rules);
-	if (isSeq(nodes)) {
-		const groupComments = previous.flatMap((node) => [node.commentBefore, node.comment].filter((value) => typeof value === "string"));
-		if (groupComments.length > 0) nodes.commentBefore = groupComments.join("\n");
-		for (const node of nodes.items) if (isMap(node)) {
-			const text = comments(previous.flatMap((item) => item.items).find((item) => isMap(item) && item.get("id") === node.get("id"))).join("\n");
-			if (text.length > 0) node.commentBefore = text;
-		}
-	}
-	doc.set("rules", nodes);
-}
-function assertAssetDirectory(root, id, definitionFile) {
-	if (definitionFile !== "module.yml") throw new Error("迁移只接受模块定义");
-	return assertModuleDirectory(root, id);
-}
-/** 包括资产和生成物的整个模块指纹；回滚不覆盖迁移后出现的任意用户改动。 */
-function treeHash(directory) {
-	assertModuleTree(directory);
-	const hash = createHash("sha256");
-	const visit = (dir) => {
-		for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
-			const file = join(dir, entry.name);
-			const key = relative(directory, file).replaceAll(sep, "/");
-			hash.update(JSON.stringify([
-				key,
-				entry.isDirectory() ? "directory" : "file",
-				lstatSync(file).mode
-			]));
-			if (entry.isDirectory()) visit(file);
-			else hash.update(readFileSync(file));
-		}
-	};
-	visit(directory);
-	return hash.digest("hex");
-}
-/** 全量只读预检。root 必须显式提供，不从真实 DSH_HOME 推断。 */
-function planRulesMigration(root, options = {}) {
-	if (typeof root !== "string" || root.trim().length === 0 || !isAbsolute(root)) throw new Error("迁移必须显式指定绝对 --root（模块根目录）");
-	const canonical = canonicalModulesRoot(root);
-	const definitionFile = MODULE_DEFINITION_FILE;
-	const items = [];
-	for (const entry of readdirSync(canonical, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-		if (entry.name.startsWith(".")) continue;
-		if (entry.isSymbolicLink() && existsSync(join(canonical, entry.name, definitionFile))) throw new Error(`迁移目录不能是链接：${entry.name}`);
-		if (!entry.isDirectory()) continue;
-		if (!existsSync(join(canonical, entry.name, definitionFile))) continue;
-		const directory = assertAssetDirectory(canonical, entry.name, definitionFile);
-		assertModuleTree(directory);
-		const bytes = readFileSync(join(directory, definitionFile));
-		const doc = parseDocument(new TextDecoder("utf-8", { fatal: true }).decode(bytes), { logLevel: "silent" });
-		if (doc.errors.length > 0) throw new Error(`模块 ${entry.name} YAML 无效：${doc.errors[0].message}`);
-		const source = doc.toJS();
-		if (!record(source)) throw new Error(`模块 ${entry.name} 定义必须是对象`);
-		const layerParams = readModuleLayerSettings(source);
-		const oldModules = Array.isArray(source.modules) && source.modules.some((id) => OLD_ENGINES.has(String(id)));
-		const oldRules = Object.hasOwn(source, "promptConfigs") || Object.hasOwn(source, "triggers") || Object.keys(readLegacyPromptParams(source)).length > 0 || MODEL_KEYS.some((key) => Object.hasOwn(layerParams, key)) || oldModules;
-		const hintPatch = oldRules || !Object.hasOwn(source, "rules") ? instructionHintPolicyPatch(source) : void 0;
-		if (!(oldRules || hintPatch !== void 0)) {
-			validateModuleDefinitionText(directory, doc.toString());
-			if (options.decompose) items.push({
-				moduleId: entry.name,
-				directory,
-				definitionFile,
-				originalHash: treeHash(directory),
-				sourceHash: digest(bytes),
-				nextDefinition: new TextDecoder("utf-8", { fatal: true }).decode(bytes)
-			});
-			continue;
-		}
-		if (options.decompose) throw new Error(`模块 ${entry.name} 仍含旧规则来源，请先运行 --apply 迁移再分解`);
-		if (!Array.isArray(source.modules)) throw new Error(`模块 ${entry.name} 使用手写组合，无法证明旧引擎装配替换；请先显式整理 modules`);
-		if (record(source.params) && LEGACY_PROMPT_PARAM_KEYS.some((key) => Object.hasOwn(source.params, key))) throw new Error(`模块 ${entry.name} 含曾被运行时忽略的顶层旧参数，无法推测激活语义`);
-		const converted = convertLegacyModuleRules(source, { directory });
-		if (hintPatch !== void 0) {
-			for (const [key, value] of Object.entries(hintPatch)) if (!doc.hasIn([
-				"moduleConfigs",
-				"instruction-hint",
-				key
-			])) doc.setIn([
-				"moduleConfigs",
-				"instruction-hint",
-				key
-			], value);
-		}
-		migrateMemoryProofs(doc, source, converted.rules);
-		setMigratedRules(doc, converted.rules);
-		doc.set("configOrder", converted.configOrder);
-		doc.delete("promptConfigs");
-		doc.delete("triggers");
-		if (Array.isArray(source.modules)) doc.set("modules", [...new Set(source.modules.map((id) => OLD_ENGINES.has(String(id)) ? "rule-engine" : id))]);
-		if (record(source.layerSettings)) {
-			for (const [layer, values] of Object.entries(source.layerSettings)) if (record(values)) {
-				for (const key of [...converted.consumedLegacyKeys, ...MODEL_KEYS]) if (Object.hasOwn(values, key)) doc.deleteIn([
-					"layerSettings",
-					layer,
-					key
-				]);
-			}
-		}
-		if (record(source.moduleConfigs)) {
-			if ([source.moduleConfigs["prompt-config-engine"], source.moduleConfigs["declared-triggers"]].filter(record).map((value) => value.strategyDir).filter((value) => typeof value === "string" && value.length > 0).length > 0) throw new Error(`模块 ${entry.name} 使用自定义策略目录，需先确认统一基准后迁移`);
-			for (const id of OLD_ENGINES) doc.deleteIn(["moduleConfigs", id]);
-		}
-		validateModuleDefinitionText(directory, doc.toString());
-		items.push({
-			moduleId: entry.name,
-			directory,
-			definitionFile,
-			originalHash: treeHash(directory),
-			sourceHash: digest(bytes),
-			nextDefinition: doc.toString()
-		});
-	}
-	return {
-		root: canonical,
-		kind: "modules",
-		items
-	};
-}
-const BACKUP_DIR = ".rules-migration-backup";
-/** 先完整生成所有候选，再复核全根；每个模块以目录 rename 原子交换并保留原树备份。 */
-async function applyRulesMigration(plan) {
-	if (canonicalModulesRoot(plan.root) !== plan.root) throw new Error("迁移根目录身份已变化");
-	if (plan.items.length === 0) return { changed: [] };
-	const backup = join(plan.root, BACKUP_DIR);
-	if (existsSync(backup)) throw new Error(`已存在迁移备份，请先处理：${backup}`);
-	const workspace = mkdtempSync(join(plan.root, ".rules-migration-stage-"));
-	const staged = /* @__PURE__ */ new Map();
-	const manifest = {
-		version: 1,
-		root: plan.root,
-		status: "applying",
-		entries: []
-	};
-	const manifestFile = join(backup, "manifest.json");
-	const verify = (item) => {
-		if (assertAssetDirectory(plan.root, item.moduleId, item.definitionFile) !== item.directory || treeHash(item.directory) !== item.originalHash || digest(readFileSync(join(item.directory, item.definitionFile))) !== item.sourceHash) throw new Error(`来源 ${item.moduleId} 在预检后已变化，未覆盖`);
-	};
-	try {
-		for (const item of plan.items) {
-			verify(item);
-			const source = join(workspace, item.moduleId);
-			cpSync(item.directory, source, {
-				recursive: true,
-				errorOnExist: true,
-				force: false
-			});
-			atomicWriteTextFile(join(source, item.definitionFile), item.nextDefinition);
-			decomposeModule(source);
-			for (const path of [
-				"rules.yml",
-				"configs",
-				"agent.cordis.yml",
-				"custom-tools",
-				"subagent-tools"
-			]) rmSync(join(source, path), {
-				recursive: true,
-				force: true
-			});
-			const generated = source;
-			staged.set(item.moduleId, generated);
-			manifest.entries.push({
-				moduleId: item.moduleId,
-				definitionFile: item.definitionFile,
-				before: item.originalHash,
-				after: treeHash(generated),
-				written: false
-			});
-		}
-		for (const item of plan.items) verify(item);
-		mkdirSync(backup);
-		atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
-		for (const item of plan.items) withModuleLock(plan.root, item.moduleId, () => {
-			verify(item);
-			const old = join(backup, item.moduleId);
-			renameSync(item.directory, old);
-			try {
-				renameSync(staged.get(item.moduleId), item.directory);
-			} catch (error) {
-				if (!existsSync(item.directory)) renameSync(old, item.directory);
-				throw error;
-			}
-			manifest.entries.find((entry) => entry.moduleId === item.moduleId).written = true;
-			invalidateModuleSpec(item.directory);
-			atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
-		});
-		manifest.status = "applied";
-		atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
-		return {
-			changed: plan.items.map((item) => item.moduleId),
-			backup
-		};
-	} catch (error) {
-		for (const entry of [...manifest.entries].reverse()) if (entry.written) {
-			const current = join(plan.root, entry.moduleId);
-			const original = join(backup, entry.moduleId);
-			withModuleLock(plan.root, entry.moduleId, () => {
-				if (existsSync(current) && treeHash(current) === entry.after && existsSync(original)) {
-					const retired = join(workspace, `failed-${entry.moduleId}`);
-					renameSync(current, retired);
-					renameSync(original, current);
-					entry.written = false;
-					invalidateModuleSpec(current);
-				}
-			});
-		}
-		if (existsSync(manifestFile)) atomicWriteTextFile(manifestFile, JSON.stringify(manifest, null, 2) + "\n");
-		throw error;
-	} finally {
-		if (dirname(workspace) === plan.root && workspace.startsWith(join(plan.root, ".rules-migration-stage-"))) rmSync(workspace, {
-			recursive: true,
-			force: true
-		});
-	}
-}
-function rollbackRulesMigration(root, options = {}) {
-	if (typeof root !== "string" || !isAbsolute(root)) throw new Error("回滚必须显式指定绝对 --root");
-	const canonical = canonicalModulesRoot(root);
-	const backup = join(canonical, BACKUP_DIR);
-	if (lstatSync(backup).isSymbolicLink()) throw new Error("迁移备份不能是链接");
-	const file = join(backup, "manifest.json");
-	const manifest = JSON.parse(readFileSync(file, "utf8"));
-	if (manifest.version !== 1 || manifest.root !== canonical || !Array.isArray(manifest.entries)) throw new Error("迁移备份不属于当前根");
-	if (manifest.status === "rolled-back") return { restored: [] };
-	const targets = manifest.entries.filter((entry) => entry.written);
-	for (const entry of targets) {
-		if (entry.definitionFile !== "module.yml") throw new Error("迁移备份定义类型无效");
-		const current = assertAssetDirectory(canonical, entry.moduleId, entry.definitionFile);
-		const original = assertAssetDirectory(backup, entry.moduleId, entry.definitionFile);
-		if (treeHash(current) !== entry.after || treeHash(original) !== entry.before) throw new Error(`模块 ${entry.moduleId} 或备份已变化，拒绝回滚覆盖`);
-		if (existsSync(join(backup, `${entry.moduleId}.migrated`))) throw new Error(`模块 ${entry.moduleId} 的回滚保留目录已存在`);
-	}
-	if (options.checkOnly === true) return { restored: targets.map((entry) => entry.moduleId) };
-	for (const entry of targets) {
-		const current = join(canonical, entry.moduleId);
-		const retired = join(backup, `${entry.moduleId}.migrated`);
-		withModuleLock(canonical, entry.moduleId, () => {
-			if (treeHash(current) !== entry.after || treeHash(join(backup, entry.moduleId)) !== entry.before) throw new Error(`模块 ${entry.moduleId} 在回滚期间变化，未覆盖`);
-			renameSync(current, retired);
-			try {
-				renameSync(join(backup, entry.moduleId), current);
-			} catch (error) {
-				if (!existsSync(current)) renameSync(retired, current);
-				throw error;
-			}
-			entry.written = false;
-			invalidateModuleSpec(current);
-			atomicWriteTextFile(file, JSON.stringify(manifest, null, 2) + "\n");
-		});
-	}
-	manifest.status = "rolled-back";
-	atomicWriteTextFile(file, JSON.stringify(manifest, null, 2) + "\n");
-	return { restored: targets.map((entry) => entry.moduleId) };
-}
 //#endregion
-export { wireTriggerObservers as $, packageEngineDir as A, INJECTION_POINT_ORDER as At, userModulesDir as B, validateEngineParamValues as Bt, ensureModuleSeed as C, assertModuleTree as Ct, loadModuleSpec as D, readPersonaSpec as Dt, listModules as E, setModuleDefinitionId as Et, resolveModuleDir as F, validateCustomToolIdentities as Ft, assertCanonicalRuleSource as G, USER_SKILLS_DIR as Gt, editModuleRules as H, DSH_HOME as Ht, resolveModuleFacts as I, ENGINE_PARAM_DEFINITIONS as It, rulePromptConfigOptions as J, ensureModuleSlices as K, resolveModuleParams as L, ENGINE_PARAM_KEYS as Lt, removeModuleCapabilityDeclaration as M, engineRecipe as Mt, removeUserModule as N, isModuleCapabilityPresent as Nt, moduleDirExists as O, ENGINE_EDITOR_GROUP_MAP as Ot, renderComposition as P, moduleCapability as Pt, injectionConfigSpec as Q, saveModuleParams as R, WRITER_PARAM_KEYS as Rt, duplicateUserModule as S, assertModuleId as St, listBuiltinTemplates as T, modulePathExists as Tt, readModuleRules as U, MODULES_DIR as Ut, withModuleDefinition as V, LEGACY_PROMPT_PARAM_KEYS as Vt, ModuleRulesError as W, MODULE_DEFINITION_FILE as Wt, withModuleLock as X, validateModuleDefinitionText as Y, compileRules as Z, applyModuleConfigs as _, RULE_OWNED_MODEL_PARAMS as _t, rollbackRulesMigration as a, runPreStepBatch as at, cloneBuiltinModule as b, readModuleLayerSettings as bt, readConfigOrder as c, actionMatches as ct, assertSafeConfigId as d, prepareStText as dt, compileWhen as et, configFileName as f, renderStText as ft, appendModuleCapabilities as g, atomicWriteTextFile as gt, setModuleEnabled as h, createWarnOnce as ht, promptConfigToRule as i, confirmDelivered as it, removeModuleCapability as j, MODULE_CAPABILITIES as jt, openModuleLocation as k, ENGINE_RECIPES as kt, readModuleConfigOrder as l, ruleFrame as lt, resolveEditDir as m, PROMOTE_EVENTS as mt, convertLegacyModuleRules as n, prepareAction as nt, ModuleConfigOrderError as o, lastWorldBookDiagnostics as ot, enabledModuleIds as p, createEpochPromotion as pt, loadModuleDefinition as q, planRulesMigration as r, applyPromptConfigSources as rt, appendModuleConfigOrder as s, wireLayers as st, applyRulesMigration as t, loadStandingMountFor as tt, saveModuleConfigOrder as u, compareConfigSequence as ut, assertCompositionArray as v, ModuleLayerSettingsError as vt, invalidateModuleSpec as w, canonicalModulesRoot as wt, createModuleCapability as x, assertModuleDirectory as xt, buildModuleConfigsFromParams as y, engineParamPath as yt, saveModulePersona as z, moduleParamFallbacks as zt };
+export { injectionConfigSpec as $, packageEngineDir as A, modulePathExists as At, userModulesDir as B, validateCustomToolIdentities as Bt, ensureModuleSeed as C, ModuleLayerSettingsError as Ct, loadModuleSpec as D, assertModuleId as Dt, listModules as E, assertModuleDirectory as Et, resolveModuleDir as F, INJECTION_POINT_ORDER as Ft, assertCanonicalRuleSource as G, validateEngineParamValues as Gt, editModuleRules as H, ENGINE_PARAM_KEYS as Ht, resolveModuleFacts as I, MODULE_CAPABILITIES as It, loadModuleDefinition as J, isLegacyPromptParam as Jt, decomposeModule as K, LEGACY_PROMPT_PARAM_DEFINITIONS as Kt, resolveModuleParams as L, engineRecipe as Lt, removeModuleCapabilityDeclaration as M, readPersonaSpec as Mt, removeUserModule as N, ENGINE_EDITOR_GROUP_MAP as Nt, moduleDirExists as O, assertModuleTree as Ot, renderComposition as P, ENGINE_RECIPES as Pt, compileRules as Q, USER_SKILLS_DIR as Qt, saveModuleParams as R, isModuleCapabilityPresent as Rt, duplicateUserModule as S, RULE_OWNED_MODEL_PARAMS as St, listBuiltinTemplates as T, readModuleLayerSettings as Tt, readModuleRules as U, WRITER_PARAM_KEYS as Ut, withModuleDefinition as V, ENGINE_PARAM_DEFINITIONS as Vt, ModuleRulesError as W, moduleParamFallbacks as Wt, validateModuleDefinitionText as X, MODULES_DIR as Xt, rulePromptConfigOptions as Y, DSH_HOME as Yt, withModuleLock as Z, MODULE_DEFINITION_FILE as Zt, applyModuleConfigs as _, createEpochPromotion as _t, appendModuleConfigOrder as a, confirmDelivered as at, cloneBuiltinModule as b, createWarnOnce as bt, saveModuleConfigOrder as c, wireLayers as ct, mergePromptConfigs as d, createPromptConfigs as dt, wireTriggerObservers as et, modelRequestConfigs as f, loadPromptConfigFiles as ft, appendModuleCapabilities as g, renderStText as gt, setModuleEnabled as h, prepareStText as ht, ModuleConfigOrderError as i, applyPromptConfigSources as it, removeModuleCapability as j, setModuleDefinitionId as jt, openModuleLocation as k, canonicalModulesRoot as kt, assertSafeConfigId as l, actionMatches as lt, resolveEditDir as m, compareConfigSequence as mt, legacyPolicyDefaults as n, loadStandingMountFor as nt, readConfigOrder as o, runPreStepBatch as ot, enabledModuleIds as p, FILE_SEQUENCE as pt, ensureModuleSlices as q, LEGACY_PROMPT_PARAM_KEYS as qt, promptConfigToRule as r, prepareAction as rt, readModuleConfigOrder as s, lastWorldBookDiagnostics as st, fillMissing as t, compileWhen as tt, configFileName as u, ruleFrame as ut, assertCompositionArray as v, actionExecutionPoint as vt, invalidateModuleSpec as w, engineParamPath as wt, createModuleCapability as x, atomicWriteTextFile as xt, buildModuleConfigsFromParams as y, PROMOTE_EVENTS as yt, saveModulePersona as z, moduleCapability as zt };