@shgroup/dsh-serenity-hooks 1.77.0 → 1.78.0

package/lib/settings-f9WZXcgi.js

@@ -1,368 +0,0 @@
-import { f as hostSettings } from "./ccc-roots-rwgzt_0F.js";
-import { _ as resolveInside, g as readUtf8 } from "./ccc-CyYJL4F2.js";
-import { dirname, join } from "node:path";
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-//#region src/kernel/constants.ts
-/** 常量（纯模块，零 DSH 依赖） */
-/** 本包名 —— 上溯定位包根时的**身份核对**（同名目录家的邻居不会误命中） */
-const PACKAGE_NAME = "@shgroup/dsh-serenity-hooks";
-/** 上溯层数上限（源码态最深 `src/<域>/<子域>/` ／ 发布态 `lib/` ⇒ 8 层足够，且**保证有界**） */
-const MAX_ROOT_ASCENT = 8;
-/**
-* 包根 = 含**本包** `package.json` 的目录。
-*
-* 🔴 为什么不写 `join(here, '..')`：本模块自身的位置**随目录重构变化**
-* （曾 `src/`，现 `src/kernel/`），而发布态是从打包入口 `lib/index.js` 反推 ——
-* 两种布局的深度不同，写死层数**必然在其中一个布局下静默错位**。
-* 实测代价：`src/` → `src/kernel/` 之后，`join(here,'..')` 指到 `src/`（无 package.json）
-* ⇒ `ACC_VERSION` 落进 catch 分支变 `0.0.0`，**没有任何门禁报警**。
-*
-* ⇒ 判据改成**内容**（找带本包名的 package.json）而不是**层数**。
-*
-* @param start 起点目录（缺省 = 本模块所在目录；测试可注入）
-*/
-function findPackageRoot(start) {
-	let dir = start ?? dirname(fileURLToPath(import.meta.url));
-	for (let i = 0; i < MAX_ROOT_ASCENT; i += 1) {
-		try {
-			if (JSON.parse(readFileSync(join(dir, "package.json"), "utf-8")).name === PACKAGE_NAME) return dir;
-		} catch {}
-		const parent = dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-	return null;
-}
-/**
-* ACC 版本：自动从 package.json 读取（单一真相源，消除与 CHANGELOG 的漂移）。
-* 发布时只需改 package.json 的 version。
-*/
-const ACC_VERSION = (() => {
-	try {
-		const root = findPackageRoot();
-		if (root === null) return "0.0.0";
-		return JSON.parse(readFileSync(join(root, "package.json"), "utf-8")).version ?? "0.0.0";
-	} catch {
-		return "0.0.0";
-	}
-})();
-//#endregion
-//#region src/trajectory/policy/rules.ts
-/**
-* trajectory/policy/rules.ts — 轨迹约束面的**纯逻辑助手**（零 DSH 依赖，可独立单测）
-*
-* ## 2026-10-19 重做后的职责边界（R↓，别再混起来）
-*
-* | 模块 | 管什么 |
-* |---|---|
-* | `./profile.ts` | **判据 + 读盘**（"这是不是 轨迹约束"、"约束面是什么"） |
-* | `./rules.ts`（本文件） | **从约束面派生出的纯函数**（白名单集合、提示词读取器、基础提示词文本） |
-* | `../session-create.ts` | 会话创建/复用、提问、守门查询 |
-*
-* ⇒ 本文件**不再读 `serenity.json`**：`轨迹约束.roles` 整段已退役（owner 2026-10-19 重做）。
-* 它只接收一个已解析好的 `TrajectoryConstraint`，因此**不涉及任何 IO**（除提示词文件，那是刻意懒读的）。
-*
-* ## S12（2026-10-19，轨迹中心重构）
-*
-* 原名 `role/轨迹约束/config.ts`。改名理由（框架 §6.3「角色不是一个概念，是一段历史」）：
-* 它派生的是**某条轨迹的约束面**，与"配置读取"无关（本文件零配置读取，见上一段）
-* ⇒ `config` 这个名字描述的是**它曾经的样子**，`rules` 描述它**现在做的事**。
-*/
-/** 白名单推导 ────────────────────────────────────────────────────────────── */
-/** 提示词来源提示串（`apply` 回执与面板共用；避免两处措辞漂） */
-const TRAJECTORY_CONSTRAINT_HINT = "systemPromptFile hot-reloads by mtime; the rest of trajectory-constraint.json is re-read every turn";
-/**
-* 该 轨迹约束会话**可见**的工具面（tools ∪ `msm`）。
-*
-* 🔴 `msm` 为什么自动加入：`msms` 非空意味着这个 轨迹约束 **有 MSM 通道**，
-* 而 MSM 的唯一合法调用入口是 `msm` 工具（单入口纪律）——不给它 `msm` 就等于
-* 声明了一堆调不动的能力。⚠️ 这是**并集**，不是覆盖：`tools` 里显式写的照旧生效。
-*/
-function profileToolWhitelist(profile) {
-	const out = /* @__PURE__ */ new Set();
-	for (const t of profile?.tools ?? []) out.add(t);
-	if ((profile?.msms?.length ?? 0) > 0) out.add("msm");
-	return out;
-}
-/** 该 轨迹约束会话可 exec 的 MSM 白名单（`msm` 工具内部再过滤；独立于工具白名单） */
-function profileMsmWhitelist(profile) {
-	return new Set(profile?.msms ?? []);
-}
-/** 轨迹纪律参与项（`profile` 缺省已在 `readTrajectoryConstraintAt` 归一为全 true） */
-function constraintCognitiveTrajectory(profile) {
-	return {
-		session: profile?.cognitiveTrajectory.session === true,
-		keeper: profile?.cognitiveTrajectory.keeper === true,
-		rebuild: profile?.cognitiveTrajectory.rebuild === true
-	};
-}
-/**
-* 解析约束面声明的**系统提示词全文**（一次性读取；`create` / `validate` / `list` 用）。
-*
-* 顺序：`systemPromptFile`（**推荐**：超长提示词在 JSON 里内嵌不可读）→ 内嵌 `systemPrompt` → 空串。
-* 文件缺失/逃逸 ⇒ **抛错**（调用方 catch 降级；`validate` 据此报 issue）。
-*
-* ⚠️ 热路径**不用**它（那会用每次工具调用去读盘）——热路径用 `createProfilePromptReader`。
-*/
-function resolveConstraintSystemPrompt(root, profile) {
-	if (!profile) return "";
-	const file = profile.systemPromptFile?.trim();
-	if (file) {
-		const abs = resolveInside(root, file);
-		if (!existsSync(abs)) throw new Error(`轨迹约束 "${profile.code}": systemPromptFile "${file}" not found (resolved: ${abs})`);
-		return readUtf8(abs).trim();
-	}
-	return profile.systemPrompt ?? "";
-}
-/**
-* 提示词来源（`list`/`validate` 展示用）。
-*
-* 🔴 **2026-10-19 修（T4 的漏网面）**：v1.72.0 起提示词有两代来源——**新形态**
-* 是轨迹目录里的 `PROMPT.md`（`trajectory/prompt.ts`，**优先**），旧形态才是
-* `systemPromptFile` / `systemPrompt`。本函数原先只认旧形态 ⇒ 两条只写了 `PROMPT.md`
-* 的轨迹在 `container_admin config list` 里恒显示 `promptSource: 'none'`。
-*
-* 那是**读数器过时**，不是配置缺失：`validate` 侧早已按两条来源判（见
-* `trajectory-constraint-admin.ts` 的 `hasTrajectoryPromptOrLegacy`），而 `list` 侧漏了。
-* ⇒ 返 **四种**值，把"有章程但来源是新形态"这一格单独说出来。
-*
-* @param hasPromptFile 该轨迹目录下**是否真有** `PROMPT.md`（调用方查，本函数不做 IO）
-*/
-function constraintSystemPromptSource(profile, hasPromptFile = false) {
-	if (hasPromptFile) return "trajectory-file";
-	if (profile?.systemPromptFile?.trim()) return "file";
-	if (profile?.systemPrompt?.trim()) return "inline";
-	return "none";
-}
-/**
-* 提示词**读取器**（长期热更新；改文件即生效，无需重启）。
-*
-* 为什么返回函数而不是字符串（R↓，实证代价）：旧实现在创建时把提示词**快照**进系统提示词段闭包
-* ⇒ CCC 改了提示词文件必须重启 dsh web 才生效（实测：改完 18KB 提示词，live agent 仍用旧文本）。
-* 现形态由系统提示词段的 `text()` **每轮调用**本读取器：
-*   - `systemPromptFile`：按 **mtime + size** 缓存重读（命中缓存零 IO；未变不解析）
-*   - 内嵌 `systemPrompt`：静态（改 JSON 仍需重载配置，这与文件热更的差别是**必然**的 —— 文件有 mtime，JSON 没有）
-*   - 读取失败：返回**上次成功内容**（⛔ 绝不返回空——空提示词会让角色失去人格与纪律），并按标签去重告警一次
-*
-* @param root CCC 根
-* @param profile 约束面
-*/
-function createProfilePromptReader(root, profile) {
-	const file = profile?.systemPromptFile?.trim();
-	if (!file) {
-		const inline = profile?.systemPrompt ?? "";
-		return () => inline;
-	}
-	let abs = null;
-	try {
-		abs = resolveInside(root, file);
-	} catch (err) {
-		console.warn(`[serenity-hooks] ✗ 轨迹约束提示词路径非法（${file}）: ${String(err?.message ?? err)}`);
-	}
-	if (abs === null) return () => "";
-	const absPath = abs;
-	let cachedMtime = -1;
-	let cachedSize = -1;
-	let cachedText = "";
-	let warned = false;
-	return () => {
-		try {
-			const st = statSync(absPath);
-			if (st.mtimeMs === cachedMtime && st.size === cachedSize) return cachedText;
-			const text = readUtf8(absPath).trim();
-			const isReload = cachedMtime !== -1;
-			cachedMtime = st.mtimeMs;
-			cachedSize = st.size;
-			cachedText = text;
-			warned = false;
-			if (isReload) console.info(`[serenity-hooks] ↻ 轨迹约束提示词已热重载（${file}，${text.length} 字符）`);
-			return text;
-		} catch (err) {
-			if (!warned) {
-				warned = true;
-				console.warn(`[serenity-hooks] ✗ 轨迹约束提示词读取失败（${file}）——沿用上次成功内容: ${String(err?.message ?? err)}`);
-			}
-			return cachedText;
-		}
-	};
-}
-/**
-* 轨迹约束 基础提示词（dsp 只给这部分；CCC 的 `systemPrompt` 段由调用方拼接）。
-*
-* ## 🔴 为什么**不再枚举**清单（owner 2026-10-19 令）
-*
-* 旧版在这里抄了两份清单（`MSMs: a, b, c` / `Tools: read, grep, …`）。那是**第二真相源**，
-* 而真相源本来就在模型自己手里：
-*   · **工具清单** = 这一轮实际注册给它的 tool schema —— 模型已经看得见，抄一遍只会漂
-*   · **MSM 清单** = `msm()` 无参调用返回的目录 —— 已按白名单过滤，且**每次实时读配置**
-*
-* ⚠️ **漂移不是理论风险，是已发生的缺陷**（2026-10-19）：角色配置早就长到 8 个工具，
-* 而这个函数是从**创建时冻结的快照**求值的 ⇒ 提示词里一直写着旧的 4 个
-* ⇒ 模型照着提示词办事，**它自己以为没有的能力就不去调** ⇒ 症状是"工具用不了"，
-* 而守卫那边（每调用实时读配置）其实是放行的。两个真相源打架，输的总是提示词。
-*
-* ⇒ 现在只声明**边界与发现路径**，不抄内容：清单在哪，怎么取，越界会怎样。
-*
-* @param code 轨迹编码（轨迹约束的身份 —— 不是"角色名"，那个概念已退役）
-*/
-function buildTrajectoryBasePrompt(code) {
-	return [
-		"=== Serenity 轨迹约束 ===",
-		`Cognitive trajectory: ${code} (this is the trajectory you ARE, not a role you play)`,
-		"Your capability boundary is enforced mechanically by this CCC — anything outside it is rejected at the call site, not by your judgment.",
-		"Discover your surface, do not memorize it (both are generated from the live config on every turn):",
-		"  · Your tools are exactly the tool schemas you see in this session — if a tool is not in your schema, it is not available.",
-		"  · Your MSMs are listed by calling msm() with no arguments — that directory is already filtered to this trajectory.",
-		"  · Usage for any MSM: msm(\"<name>\", [], inspect=true) or pass \"--help\" as the first argument.",
-		"Do not infer unavailability from anything you remember or from an earlier list: this surface changes when the CCC configuration changes, and it takes effect without restarting.",
-		"",
-		"---",
-		""
-	].join("\n");
-}
-//#endregion
-//#region src/surface/settings.ts
-/**
-* 设置面板命名空间 = **profile 条目 id**（v0.1.7 起；与旧 `settings.yaml` 段名逐字相同）。
-*/
-const SERENITY_SETTINGS_NS = "serenity-hooks";
-/** 进程级默认（无 Config 可读时的兜底；与 Config 各字段的缺省一致） */
-function defaultSimpleSettings() {
-	return {
-		gatewayEnabled: false,
-		rebuildThresholdK: 400,
-		croEnabled: true,
-		diagramEnabled: false,
-		humanChannel: defaultHumanChannelSettings()
-	};
-}
-/**
-* volatile 字段的**结构化解包**（v1.47.2；本文件读取语义的第一道）。
-*
-* ## 为什么必须有它（两个事实的合成，缺一即错）
-* ① **0.1.7 的面板层字段必须标 `.volatile()`** —— 否则本插件命名空间整个不进宿主的
-*    `settings.describe()`（`volatileForm()` 只认 `meta.volatile`）⇒ **设置面板那一节消失**。
-* ② **标了之后，运行期拿到的是引用包装，不是裸值** —— schemastery 的 `Schema.resolve()` 对
-*    `meta.volatile` **无条件**包 `createVolatile(value)`，且该分支排在"缺省值回退"那一段
-*    **之前** ⇒ **"用户没设过"的字段也是恒真对象**（`.get()` 返回 `undefined`），**不是 `undefined`**。
-*
-* ⇒ 若这里不解包，下面十行的 `??` 链会**短路在这层包装上** ⇒ 网关 / 轨迹约束 会被
-* **无意打开**（比"面板不显示"更坏：静默改变对外暴露面）。
-*
-* ## 为什么用结构判定
-* 可观察形状就是"有 `get()`"（cosmokit 的 `isVolatile` 也这么判）；本模块不引它的运行时依赖。
-*
-* @param value - volatile 引用 ｜ 裸值 ｜ undefined
-* @returns 解包后的裸值（引用 ⇒ `.get()`；裸值原样；缺省 ⇒ `undefined`）
-*/
-function unwrapVolatile(value) {
-	if (value === void 0 || value === null) return void 0;
-	if (typeof value.get === "function") return value.get();
-	return value;
-}
-/** human-channel 的内建缺省（与 `Config` 的 schema 缺省**同源**：这里是读取面，那里是解析面） */
-function defaultHumanChannelSettings() {
-	return {
-		accounts: [],
-		subscriptions: [],
-		relayCcc: null,
-		sendingAllow: ["*"]
-	};
-}
-/** 取"有内容的字符串"（首尾空白剥掉；空白串 ⇒ `undefined`）—— 面板空文本框会写 `''`，那是"没填"不是"填了个空名" */
-function nonEmptyText(value) {
-	if (typeof value !== "string") return void 0;
-	const trimmed = value.trim();
-	return trimmed === "" ? void 0 : trimmed;
-}
-/**
-* `humanChannel` 片段 → 运行时归一形态。**优先级：显式值 > 内建缺省**（与 `simpleSettingsFromConfig` 同族）。
-*
-* 🔴 三处"缺省 vs 显式"的语义差别，别写反：
-*  ① `sending.allow: []` ⇒ **`[]`**（"谁都不许"），**不是**回退到 `['*']` —— 故用 `??`
-*     （只对 `undefined`/`null` 回退）。⚠️ **别拿 `??`→`||` 当变异探针**：空数组在 JS 里是
-*     **真值** ⇒ 两种写法在这个输入上**恰好同效**，那是**非变异**（会得出"测试不承重"的假结论）。
-*  ② `relay.ccc` 空白 ⇒ `null`（"没填"与"没这一项"同义），**不是**把空白当 CCC 名；
-*  ③ 账号 `enabled` 缺省 **true**（老账号表里 `enabled` 不写就是开）。
-*
-* 🔴 **旧 CCC 侧 `weixin.*` 不在这里、也不该在这里**：机器级面**只**认 `humanChannel`
-*   （硬切无别名，同 D61 先例）⇒ 传进来的旧键**一律不进结构**（回归钉见
-*   `tests/human-channel-config.test.ts`；CCC 侧旧读取面的退役在 P0-2~P0-4）。
-* @param fragment - `Config.humanChannel`（可能整个不存在 —— 那是**合法**初始态）
-* @returns 归一形态（永不 `undefined`）
-*/
-function humanChannelSettingsFromConfig(fragment) {
-	const d = defaultHumanChannelSettings();
-	if (!fragment) return d;
-	return {
-		accounts: (fragment.accounts ?? []).map((a) => ({
-			id: nonEmptyText(a?.id),
-			channel: nonEmptyText(a?.channel),
-			enabled: a?.enabled !== false,
-			token: a?.token,
-			userId: a?.userId
-		})),
-		subscriptions: (fragment.subscriptions ?? []).map((s) => ({
-			account: nonEmptyText(s?.account),
-			user: nonEmptyText(s?.user),
-			ccc: nonEmptyText(s?.ccc),
-			role: nonEmptyText(s?.role)
-		})),
-		relayCcc: nonEmptyText(fragment.relay?.ccc) ?? d.relayCcc,
-		sendingAllow: fragment.sending?.allow ?? d.sendingAllow
-	};
-}
-/**
-* Config（宿主 Loader 校验后的解析值）→ 扁平简单配置。**本文件唯一的读取语义**。
-*
-* 优先级：**面板层（扁平键）> 部署层（嵌套段）> 内建缺省**。
-* @param config - 插件 Config（`fiber.config` 或 apply 收到的 config）
-* @returns 扁平开关集合
-*/
-function simpleSettingsFromConfig(config) {
-	const d = defaultSimpleSettings();
-	return {
-		gatewayEnabled: unwrapVolatile(config.gatewayEnabled) ?? config.gateway?.enabled ?? d.gatewayEnabled,
-		rebuildThresholdK: unwrapVolatile(config.rebuildThresholdK) ?? config.rebuild?.thresholdK ?? d.rebuildThresholdK,
-		croEnabled: unwrapVolatile(config.croEnabled) ?? d.croEnabled,
-		diagramEnabled: unwrapVolatile(config.diagramEnabled) ?? config.diagram?.enabled ?? d.diagramEnabled,
-		humanChannel: humanChannelSettingsFromConfig(config.humanChannel)
-	};
-}
-/** 运行时源（`registerSettingsSection` 装配：读本插件 fiber 的**当前** Config） */
-let simpleSource = null;
-/**
-* 读取当前简单配置（各功能 gateway/rebuild/轨迹约束/… 的启动与运行时判断都经此）。
-*
-* 源 = 本插件 fiber 的 `config`（宿主在配置变更时走 `fiber.update()` ⇒ `config` 始终最新，
-* **不必**依赖 apply 重跑，也不必缓存）。
-* @returns 扁平开关集合
-*/
-function readSimpleSettings() {
-	return simpleSource ? simpleSource() : defaultSimpleSettings();
-}
-/**
-* 装配简单配置读取面（v1.21 分层；**v0.1.7 起不再注册任何 section**）。
-*
-* 两件事：
-*  1. 把"本插件自己的 Config"接成简单配置源 —— 读 `ctx.fiber.config`（宿主 `fiber.update()`
-*     保证最新），拿不到 fiber 时退回 apply 收到的 `config`。
-*  2. 关掉宿主按 Config schema **自动生成**的通用页（`settings.configure({ auto: false })`）——
-*     门面是我们的自定义页 `client/SettingsSection.tsx`（同一个命名空间，同一份数据）。
-*
-* ⚠️ 两个失败都不阻断插件装载（面板是附属能力，绝不能成为启动单点）。
-* @param ctx - 插件上下文
-* @param config - apply 收到的 Config（fiber.config 不可用时的兜底）
-*/
-function registerSettingsSection(ctx, config) {
-	const fiber = ctx.fiber;
-	const readConfig = () => fiber?.config ?? config;
-	simpleSource = () => simpleSettingsFromConfig(readConfig());
-	const settings = hostSettings(ctx);
-	try {
-		settings?.configure?.({ auto: false }, fiber);
-	} catch {}
-}
-//#endregion
-export { buildTrajectoryBasePrompt as a, createProfilePromptReader as c, resolveConstraintSystemPrompt as d, ACC_VERSION as f, TRAJECTORY_CONSTRAINT_HINT as i, profileMsmWhitelist as l, readSimpleSettings as n, constraintCognitiveTrajectory as o, findPackageRoot as p, registerSettingsSection as r, constraintSystemPromptSource as s, SERENITY_SETTINGS_NS as t, profileToolWhitelist as u };