@shgroup/dsh-serenity-hooks 1.76.0 → 1.77.0

package/lib/message-source-C_Zd2vJh.js

@@ -1,435 +0,0 @@
-import { r as cccRootForCwd } from "./ccc-roots-rwgzt_0F.js";
-import { T as parseTrajectoryCode, b as getLastActiveSessionInfo, k as sessionEvents, y as getActiveSessionInfo } from "./profile-DplLGGqo.js";
-import { dirname, join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-//#region src/trajectory/bound.ts
-/**
-* trajectory/bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
-*
-* 目标（S142 用户拍板，方案 v1.0）：让「dsh 会话（载体）↔ SESSION（宁静号轨迹）」
-* 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 cognitive_trajectory rebuild 后
-* 自行更换 SESSION。
-*
-* 存储形态（v1.30.6 起，S142 review F-01）：绑定**不再写入 dsh 会话日志**。
-* 原因（宿主契约实证）：dsp 的自定义事件 `serenity/bound` 既不在宿主的
-* `KNOWN_SESSION_EVENT_TYPES`（生成静态集，明确说明 out-of-repo 插件事件不在其中），
-* 而 `Session.append` 构造事件时只写 `{type,seq,time,data,surfaceOp?,sourceEventSeqs?}`
-* ——**没有写入 envelope `ignorable` 标记的通道**；宿主的 `assertEventsSupported`
-* （session-persistence/coordinator.ts:1248-1252，调用点含恢复/HMR 路径）会拒绝任何
-* "未知且非 ignorable" 的事件 → 含该事件的会话在冷加载时可能抛
-* `SessionFormatUnsupportedError`。v1.29.1~v1.30.5 的设计文档虽写明要带
-* `ignorable: true`（docs/session-binding-hardening-research.md:53），但类型层声明
-* 不等于持久层标记，实际从未落盘。
-*
-* 现形态：每 CCC 一个 JSON 文件 `AGENT_SESSIONS/.bindings.json`（原子写：tmp + rename），
-* 以 dsh 会话 id 为键，latest-wins 覆盖。**向后兼容**：读取时若文件中无该会话记录，
-* 仍回落到扫描会话日志中的旧 `serenity/bound` 事件（老会话的绑定不丢）。
-*
-* 编码无关（U4）：绑定锚 = **完整 AGENT_SESSIONS 目录名**（磁盘唯一存在），
-* sessionId（S###/apaas-xxx/自定义）仅是派生展示字段——绝不假设 S 前缀。
-*/
-/** 旧形态事件类型（v1.29.1~v1.30.5 写入会话日志；v1.30.6 起只读不写——兼容存量绑定） */
-const SESSION_BOUND_EVENT = "serenity/bound";
-/** 绑定文件相对 CCC 根的路径 */
-const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
-const BINDINGS_VERSION = 1;
-let domainStore = null;
-/**
-* 注入域句柄（装载期调用一次）。传 `null` = 域不可用 ⇒ 全部退回旧文件行为。
-* 幂等：重复调用以后者为准（HMR / 重载场景）。
-*/
-function setBindingStore(store) {
-	domainStore = store;
-}
-/** 域记录 → 本模块记录形状（同名字段，无需映射表；见 host/storage-domain.ts 头注） */
-function fromDomainRecord(rec) {
-	return {
-		dirName: rec.dirName,
-		mdPath: rec.mdPath,
-		...rec.sessionId ? { sessionId: rec.sessionId } : {},
-		action: rec.action ?? "activate",
-		at: typeof rec.at === "number" ? rec.at : 0,
-		...rec.note ? { note: rec.note } : {},
-		...rec.createdAsUser === true ? { createdAsUser: true } : {},
-		...rec.supersededAt !== void 0 ? { supersededAt: rec.supersededAt } : {}
-	};
-}
-/** 本模块记录 → 域记录形状 */
-function toDomainRecord(rec) {
-	return {
-		dirName: rec.dirName,
-		mdPath: rec.mdPath,
-		...rec.sessionId ? { sessionId: rec.sessionId } : {},
-		action: rec.action,
-		at: rec.at,
-		...rec.note ? { note: rec.note } : {},
-		...rec.createdAsUser === true ? { createdAsUser: true } : {},
-		...rec.supersededAt !== void 0 ? { supersededAt: rec.supersededAt } : {}
-	};
-}
-/**
-* §0L **一次性迁移**：把某个 CCC 的旧 `.bindings.json` 全量灌入宿主存储域。
-*
-* 设计要点（R↓）：
-*  - **幂等**：只写域里**尚不存在**的键（`skip existing`）。⇒ 重复调用（每次启动都调）
-*    不会覆盖域里的新状态，也不会因并发而互相踩踏。
-*  - **不删旧文件**：迁移只读不写旧表（owner「向前兼容」的第二道保险仍在）。
-*  - **不丢绑定**：逐条迁移，单条失败不影响其余（返回计数供诊断）。
-*  - **失败静默**：域写不可用 ⇒ 返回 `{migrated:0, skipped:0, failed:0}`，不抛错
-*    （装载期调用，不能成为启动单点）。
-*
-* @param root CCC 根（`AGENT_SESSIONS/.bindings.json` 所在）
-* @returns 迁移计数（诊断用；`migrated` = 本次真正灌入的条数）
-*/
-function migrateBindingsToDomain(root) {
-	const out = {
-		migrated: 0,
-		skipped: 0,
-		failed: 0
-	};
-	if (!domainStore?.available) return out;
-	let file;
-	try {
-		file = readBindingsFile(join(root, BINDINGS_REL_PATH));
-	} catch {
-		return out;
-	}
-	for (const [id, raw] of Object.entries(file.sessions)) {
-		const rec = asBoundRecord(raw);
-		if (!rec) continue;
-		if (domainStore.get(id)) {
-			out.skipped += 1;
-			continue;
-		}
-		try {
-			domainStore.put(id, toDomainRecord(rec)).catch(() => {});
-			out.migrated += 1;
-		} catch {
-			out.failed += 1;
-		}
-	}
-	if (out.migrated > 0) migratedRoots.add(root);
-	return out;
-}
-/** 已补过迁移的 CCC 根（进程内去重；跨进程各补一次是可接受的——迁移幂等） */
-const migratedRoots = /* @__PURE__ */ new Set();
-/**
-* **按 CCC 惰性补迁移**（§0L 修正，S142 2026-09-19）。
-*
-* 🔴 为什么需要它（实测缺陷，R↓）：
-* 装载期那次迁移用的是 `process.cwd()` —— 而 dsh **服务进程的 cwd 是用户家目录**，
-* **不是 CCC 根**（实测 `acc-diag`：`进程 cwd: <家目录> ｜ 进程 CCC: （无）`）。
-* ⇒ 迁移读的是一个**不存在的文件**，静默迁移 0 条
-* （症状：发布后 `~/.dsh/storages/serenity_bindings.json` **没出现**）。
-*
-* 现在改为：**任何一次能定位到 CCC 根的路径**都顺手补一次迁移（幂等 + 进程内去重）。
-* 这样无论服务从哪个 cwd 启动，只要那条 CCC 有会话活动，它的绑定就会被带上。
-*
-* @param root CCC 根
-*/
-function ensureBindingsMigrated(root) {
-	if (!domainStore?.available) return;
-	if (migratedRoots.has(root)) return;
-	try {
-		migrateBindingsToDomain(root);
-	} catch {}
-}
-/**
-* 域内读一条（同步）。域不可用 → `undefined`（调用方据此回落文件）。
-* @param sessionId dsh 会话 id
-*/
-function readFromDomain(sessionId) {
-	if (!domainStore?.available) return void 0;
-	const rec = domainStore.get(sessionId);
-	return rec ? fromDomainRecord(rec) : void 0;
-}
-/**
-* 域内取**某轨迹的全部绑定**（同步；已排除 superseded —— 与 `listBoundSessionIds` 同判据）。
-* 域不可用 → `null`（**注意与"空结果"区分**：null = 回落文件，[] = 域里确实没有）。
-*/
-function listFromDomain(dirName) {
-	if (!domainStore?.available) return null;
-	const out = [];
-	for (const [id, raw] of domainStore.entries()) {
-		const rec = fromDomainRecord(raw);
-		if (rec.dirName !== dirName) continue;
-		out.push({
-			id,
-			rec
-		});
-	}
-	return out;
-}
-function sessionHeader(session) {
-	const header = session?.header;
-	if (!header || typeof header !== "object") return null;
-	return header;
-}
-/** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
-function bindingsPathFor(session) {
-	const header = sessionHeader(session);
-	if (typeof header?.cwd !== "string") return null;
-	const root = cccRootForCwd(header.cwd);
-	if (!root) return null;
-	ensureBindingsMigrated(root);
-	return join(root, BINDINGS_REL_PATH);
-}
-function readBindingsFile(path) {
-	if (!existsSync(path)) return {
-		version: BINDINGS_VERSION,
-		sessions: {}
-	};
-	try {
-		const sessions = JSON.parse(readFileSync(path, "utf-8")).sessions;
-		if (!sessions || typeof sessions !== "object") return {
-			version: BINDINGS_VERSION,
-			sessions: {}
-		};
-		return {
-			version: BINDINGS_VERSION,
-			sessions
-		};
-	} catch {
-		return {
-			version: BINDINGS_VERSION,
-			sessions: {}
-		};
-	}
-}
-/** 原子写：同目录 tmp + rename（避免半写文件被后续读取） */
-function writeBindingsFile(path, data) {
-	mkdirSync(dirname(path), { recursive: true });
-	const tmp = `${path}.tmp`;
-	writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
-	renameSync(tmp, path);
-}
-/** 记录形状校验（容忍手改/旧数据） */
-function asBoundRecord(value) {
-	const r = value;
-	if (!r || typeof r.dirName !== "string" || typeof r.mdPath !== "string") return null;
-	return r;
-}
-/** 旧形态：从会话日志扫最后一条 `serenity/bound`（兼容 v1.30.5 及更早写入的绑定） */
-function readLegacyBoundFromEvents(session) {
-	const events = sessionEvents(session);
-	for (let i = events.length - 1; i >= 0; i--) {
-		const ev = events[i];
-		if (!ev || ev.type !== SESSION_BOUND_EVENT) continue;
-		const rec = asBoundRecord(ev.data);
-		if (rec) return rec;
-	}
-	return null;
-}
-/**
-* 读取会话当前绑定（权威，latest-wins）。
-*
-* 读取顺序（§0L，S142 2026-09-19）：
-*  1. **宿主存储域**（域可用时的权威来源）；
-*  2. **旧文件** `.bindings.json`（域不可用 ⇒ 零回归回落；域可用但该会话未迁移 ⇒ 兜底）；
-*  3. **旧事件形态** `serenity/bound`（v1.30.5 及更早的存量）。
-* 无绑定返回 null。
-*/
-function readLastBound(session) {
-	const id = sessionHeader(session)?.id;
-	if (typeof id === "string") {
-		const fromDomain = readFromDomain(id);
-		if (fromDomain) return fromDomain;
-	}
-	const path = bindingsPathFor(session);
-	if (path && typeof id === "string") {
-		const rec = asBoundRecord(readBindingsFile(path).sessions[id]);
-		if (rec) return rec;
-	}
-	return readLegacyBoundFromEvents(session);
-}
-/** 目录名 → 轨迹标签（取固定位置编码；非本工具建的目录回退整名——编码无关 U4） */
-function cognitiveTrajectoryLabel(dirName) {
-	return parseTrajectoryCode(dirName) ?? dirName;
-}
-/**
-* **调用方自身**所属 cognitive trajectory 的标签（审计字段 `createdBy` 的唯一正解）。
-*
-* 三级来源，逐级回退（R↓：为什么不用单一来源）：
-*  1. `readLastBound(session)` —— **持久 bound**，权威（重启存活、不受别的会话激活污染）
-*  2. `getActiveSessionInfo(scope)` —— 本 dsh 会话的**内存**激活（按 scope 隔离）
-*  3. `getLastActiveSessionInfo()` —— **全局**最近激活指针（无绑定的会话兼容回退）
-*
-* ⚠️ 为何单列成本函数（S142 §30.12.1 实测缺陷）：唤醒注册表的 `createdBy` 原先直接取第 3 级
-* 全局指针，而它记录的是"**进程内最近一次被激活的 cognitive trajectory**"——多会话并发时必然张冠李戴
-* （实测：S142 登记唤醒被写成 `by=S060`）。`createdBy` 是 D60「以可审计替代入口栅」的**唯一凭证**，
-* 失真即替代控制失效 ⇒ 必须以"调用方自己是谁"为准，全局指针只作最后兜底。
-*
-* @param session 调用方 dsh 会话对象（需 `header.id` + `header.cwd`）
-* @param scope 调用方 dsh 会话 id（取不到传空串）
-* @returns 轨迹标签（`S###` 或完整目录名）；三级全落空 → 空串（渲染为 `?`）
-*/
-function resolveSessionCognitiveTrajectoryLabel(session, scope) {
-	const bound = session ? readLastBound(session) : null;
-	if (bound?.dirName) return cognitiveTrajectoryLabel(bound.dirName);
-	const scoped = scope !== "" ? getActiveSessionInfo(scope) : null;
-	if (scoped) return scoped.sessionId;
-	return getLastActiveSessionInfo()?.sessionId ?? "";
-}
-/**
-* 反向查：绑定到某 cognitive trajectory 目录名的 dsh 会话 id（**按绑定时间倒序，最新在前**）。
-*
-* 用途（wake-scheduler 冷唤醒）：.bindings.json 以 **sessionId 为键**，而唤醒条目的
-* target 是**目录名**——需要值侧扫描做反向索引。冷会话被唤醒时必须先知道"哪个 dsh
-* 会话承载这条轨迹"，这是唯一的权威来源（标题只作回退，见 v1.29.2 R2）。
-*
-* @param root CCC 根
-* @param dirName AGENT_SESSIONS 目录名（完整名，如 `2026-09-01--S151--x--auto`）
-* @returns 会话 id 列表（最新绑定在前）；无绑定 → `[]`
-*/
-function listBoundSessionIds(root, dirName) {
-	const hits = [];
-	const fromDomain = listFromDomain(dirName);
-	if (fromDomain !== null) {
-		for (const { id, rec } of fromDomain) {
-			if (rec.supersededAt !== void 0) continue;
-			hits.push({
-				id,
-				at: typeof rec.at === "number" ? rec.at : 0
-			});
-		}
-		if (hits.length > 0) return hits.sort((a, b) => b.at - a.at).map((h) => h.id);
-	}
-	const file = readBindingsFile(join(root, BINDINGS_REL_PATH));
-	for (const [id, raw] of Object.entries(file.sessions)) {
-		const rec = asBoundRecord(raw);
-		if (!rec || rec.dirName !== dirName) continue;
-		if (rec.supersededAt !== void 0) continue;
-		if (hits.some((h) => h.id === id)) continue;
-		hits.push({
-			id,
-			at: typeof rec.at === "number" ? rec.at : 0
-		});
-	}
-	return hits.sort((a, b) => b.at - a.at).map((h) => h.id);
-}
-/**
-* 🔴 **「只留一条」的唯一判据**（2026-09-21 收进单一实现；此前同一判据在域侧/文件侧各写一遍）。
-*
-* 判据：同 `dirName` ∧ **不是** `keepIds` 里的 ∧ **尚未** `supersededAt`。
-* 域侧与文件侧**同判据**——历史缺陷（2026-09-19）正是"只在一侧收集 ⇒ 返回值恒空"，
-* 见 {@link supersedeOtherBindings} 的注释。
-*
-* @param fileSessions 旧文件表的记录集
-* @param domainEntries 域侧条目（域不可用时传 `undefined` = 不参与判定）
-*/
-function collectSupersedeTargets(dirName, keepIds, fileSessions, domainEntries) {
-	const toMark = /* @__PURE__ */ new Set();
-	if (domainEntries) for (const [id, raw] of domainEntries) {
-		const rec = fromDomainRecord(raw);
-		if (rec.dirName !== dirName) continue;
-		if (keepIds.has(id) || rec.supersededAt !== void 0) continue;
-		toMark.add(id);
-	}
-	for (const [id, raw] of Object.entries(fileSessions)) {
-		const rec = asBoundRecord(raw);
-		if (!rec || rec.dirName !== dirName) continue;
-		if (keepIds.has(id) || rec.supersededAt !== void 0) continue;
-		toMark.add(id);
-	}
-	return toMark;
-}
-/**
-* **(c) 绑定一致性兜底**（S142 §0y，所有者 2026-09-18 裁「c 也算个兜底」）：
-* 删除指向**已不存在**的 dsh 会话的绑定记录。
-*
-* 为什么需要：`.bindings.json` **只增不清**，而 DSH 会话目录会被
-* `session-cleanup`（本仓既有机制）物理删除 ⇒ 表里必然残留**悬空 id**。
-* 悬空记录本身无害，但它会**污染反向索引**（`listBoundSessionIds` 是唤醒选人的唯一入口），
-* 让"这条轨迹到底还有没有可用会话"变得不可判。
-*
-* 🔴 **安全性由调用方的判据负责**（本函数是纯函数，不认识文件系统）：
-* `isMissing` 必须是 **fail-closed** 的（读不到 ⇒ 返回 false = "不当作缺失"），
-* 见 `hasSessionLogById`。判据写错会**清掉整张表**，故此处刻意不提供默认实现。
-*
-* @param root CCC 根
-* @param isMissing 判据：该会话 id 是否**确认**已不存在（false = 保留）
-* @returns 被删除的会话 id（升序稳定；未删任何一条 → `[]`）
-*/
-function pruneMissingBindings(root, isMissing) {
-	const path = join(root, BINDINGS_REL_PATH);
-	const file = readBindingsFile(path);
-	const toRemove = /* @__PURE__ */ new Set();
-	const judge = (id) => {
-		try {
-			return isMissing(id);
-		} catch {
-			return false;
-		}
-	};
-	if (domainStore?.available) {
-		for (const [id] of domainStore.entries()) if (judge(id)) toRemove.add(id);
-	}
-	for (const id of Object.keys(file.sessions)) if (judge(id)) toRemove.add(id);
-	if (toRemove.size === 0) return [];
-	if (domainStore?.available) for (const id of toRemove) domainStore.delete(id).catch(() => {});
-	for (const id of toRemove) delete file.sessions[id];
-	try {
-		writeBindingsFile(path, file);
-	} catch {}
-	return [...toRemove].sort();
-}
-/**
-* 写入绑定（latest-wins 覆盖该会话记录）。
-*
-* 绑定持久化尽力而为：无法定位 CCC 根 / 无会话 id / 写盘失败 → 返回 false，不阻断主流程。
-*
-* 🔴 **同时是「只留一条」（D69）的唯一写入口**（2026-09-21 起）：每写一条，就在**同一次 RMW** 里
-* 把同轨迹的**其它**条标 `supersededAt`（自己除外）。⇒ 任何调用路径（`create`/`activate`/`switch`/
-* `rebuild`/`reconcile`）**都自动满足"只留一条"**，调用方**不需要**（也**不应当**）自己算 selfId。
-*
-* @param session 目标 dsh 会话（需 `header.id` + `header.cwd` 可定位 CCC 根）
-* @param action 绑定动作
-* @param rec 绑定记录（dirName + mdPath 必填；sessionId 可选展示码）
-*/
-function appendBound(session, action, rec) {
-	const path = bindingsPathFor(session);
-	const id = sessionHeader(session)?.id;
-	if (typeof id !== "string") return false;
-	const record = {
-		dirName: rec.dirName,
-		mdPath: rec.mdPath,
-		...rec.sessionId ? { sessionId: rec.sessionId } : {},
-		action,
-		at: Date.now(),
-		...rec.note ? { note: rec.note } : {},
-		...rec.createdAsUser === true ? { createdAsUser: true } : {}
-	};
-	if (domainStore?.available) domainStore.put(id, toDomainRecord(record)).catch(() => {});
-	if (!path) return domainStore?.available === true;
-	try {
-		const file = readBindingsFile(path);
-		file.sessions[id] = record;
-		const targets = collectSupersedeTargets(rec.dirName, /* @__PURE__ */ new Set([id]), file.sessions, domainStore?.available ? domainStore.entries() : void 0);
-		for (const other of targets) {
-			const otherRec = asBoundRecord(file.sessions[other]);
-			if (!otherRec) continue;
-			otherRec.supersededAt = record.at;
-			file.sessions[other] = otherRec;
-		}
-		writeBindingsFile(path, file);
-		if (domainStore?.available) for (const other of targets) {
-			const raw = domainStore.get(other);
-			if (!raw) continue;
-			domainStore.put(other, toDomainRecord({
-				...fromDomainRecord(raw),
-				supersededAt: record.at
-			})).catch(() => {});
-		}
-		return true;
-	} catch {
-		return domainStore?.available === true;
-	}
-}
-//#endregion
-//#region src/kernel/message-source.ts
-/** ACC 注入消息的 kind —— 唤醒 / 打回 / keeper 提醒 / 锚定轮 / rebuild 交接等一律同值。 */
-const ACC_MESSAGE_KIND = "plugin:dsh-serenity-hooks";
-/** ACC 注入消息的统一来源值（各缝共用；需要 `form` 时按 `ContextFormed` 另加字段）。 */
-const PLUGIN_SOURCE = { kind: ACC_MESSAGE_KIND };
-//#endregion
-export { pruneMissingBindings as a, setBindingStore as c, listBoundSessionIds as i, PLUGIN_SOURCE as n, readLastBound as o, appendBound as r, resolveSessionCognitiveTrajectoryLabel as s, ACC_MESSAGE_KIND as t };