@shgroup/dsh-serenity-hooks 1.37.0 → 1.38.0

package/lib/wake-scheduler.d.ts

@@ -70,6 +70,44 @@ export declare function buildWakeText(entry: WakeEntry, target: WakeTarget): str
  * @returns 投递结果（写回 lastResult）
  */
 export declare function deliverWake(ctx: Context, root: string, entry: WakeEntry): Promise<WakeDeliveryResult>;
+/**
+ * 即时消息正文（**刻意不复用** {@link buildWakeText}）：唤醒文本以「**到点**（登记于…）」开头，
+ * 对即时投递那是**错的事实**。本函数显式区分"这是即时消息、不是到点唤醒"，
+ * 并写明"消息已入队、若此前在跑轮次则本轮结束后生效"（防目标误判时序）。
+ * @param target 目标轨迹（目录名 + SESSION.md）
+ * @param message 递送正文
+ * @param sender 发起者轨迹标识（供目标与人类识别来源）
+ */
+export declare function buildSendText(target: WakeTarget, message: string, sender: string): string;
+/**
+ * 即时投递（`container_trajectory send-message`）——与唤醒**共用取用通路**，
+ * 区别只在**时刻**（现在 vs 未来）与**回执**（有 vs 无）：
+ *   · `wake-later`：未来时刻 + 一条 message → 落注册表 → 本文件的调度器到点投递（**fire-and-forget，无回执**）
+ *   · `send-message`：**此刻**把一条 message 递进目标队列 → **同步回执** → **不落注册表**
+ *
+ * **为什么冷路径落在这里（R↓，2026-09-16 所有者裁决）**：`addWake` 显式拒绝 `at ≤ now`
+ * （"时刻必须在未来"——那是"**预约**"语义的地基，不许放宽）⇒ 即时投递**不能**靠一条
+ * `at=now` 的注册表条目实现（那还会让调度器把一次性即时投递当 `pending` **每 tick 重试**）。
+ * 必须直接走 {@link acquireWakeAgent}（live 优先 → `sessionController.resolveAgent` 冷载入）。
+ * 这正对应所有者要的「**会话不活跃则等效于直接 wake**」：**同一条冷载入通路**，只是**不等 tick**。
+ *
+ * ⚠️ **承诺边界（不许含糊）**：回执只到「**已入队**」（`followup` 未抛错），
+ * **到不了**"目标已执行/已答复" —— 与 `deliverWake` 同一层。目标若正在跑轮次，
+ * 消息**排在轮次边界**（**不打断当前轮**）。判"目标真的动了"必须用**文件级判据**
+ * （它自己的 SESSION.md），**不得凭回执结案**（§12.B 的 `delivered ≠ 跑了一轮`）。
+ *
+ * **归属**：本函数放在调度器侧而非工具侧 —— "怎么把一句话送到一条轨迹"是**调度器的知识**，
+ * 工具只该知道"有这个动作"。这样 `trajectory.ts` 完全不碰调度器内部（v1.35.0 硬约束①：
+ * `wake-later` 链路**一行为不动**，本次改动 = **纯新增**）。
+ *
+ * @param ctx 插件上下文
+ * @param root CCC 根
+ * @param target `S###` 或 AGENT_SESSIONS 目录名
+ * @param message 递送正文
+ * @param sender 发起者轨迹标识
+ * @returns 投递结果（**同步**返回给调用方）
+ */
+export declare function sendToTrajectory(ctx: Context, root: string, target: string, message: string, sender: string): Promise<WakeDeliveryResult>;
 /**
  * 装配调度器（index.ts apply 调用）：5min tick + 生命周期 disposer +
  * 会话出现/settings 变化时热启动（与 autopilot 同款触发面，互不干扰）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.37.0",
+  "version": "1.38.0",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/container_trajectory/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/im-bridge/acc-diag）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2。",
   "license": "MIT",
   "repository": {

package/lib/wake-registry-Cj2aSHME.js

@@ -1,258 +0,0 @@
-import { dirname, join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-//#region src/wake-registry.ts
-/**
-* wake-registry.ts — trajectory 唤醒注册表（D58，S142 2026-09-13）
-*
-* 需求（用户原话）：一个 CCC 内允许多个 trajectory 任意形态并行；某个 trajectory 可以
-* **预定未来唤醒自己或别人**，本质上是一次「未来时刻 + 一条 message」的投递；「周期自唤醒」
-* 曾是它的特例（原 ACC autopilot / D59，该机制已于 2026-09-15 整段退场）。协作边界：
-* 互相可见、**无阻塞无等待**。
-*
-* 本模块只负责**注册表本身**（纯数据层，无宿主依赖，可单测）：
-*  - 落点：CCC 内 `AGENT_SESSIONS/wake-registry.json`（随 CCC git，人可读可审计）
-*  - 状态机：`pending` →（投递成功）`delivered`｜（超补跑窗口）`missed`｜（`wake rm` 物理移除）
-*  - 投递即终结：一次性，不重投（无回执语义——发起方不 await，见设计文档 §2）
-*
-* 调度与投递在 `wake-scheduler.ts`（需要 ctx），本模块保持纯净。
-*/
-/** 注册表相对 CCC 根的路径（与 `.bindings.json` 同居 AGENT_SESSIONS/） */
-const WAKE_REGISTRY_REL_PATH = "AGENT_SESSIONS/wake-registry.json";
-/** 注册表格式版本（结构变更时 +1；读取端只接受本版本） */
-const WAKE_REGISTRY_VERSION = 1;
-/**
-* 补跑窗口（缺省 2h）：dsh 停机期间到期的条目，若迟到不超过本窗口则补投，
-* 超过则置 `missed` 留痕（不补投——避免"半夜该做的事早上突然连环跑"）。
-*/
-const WAKE_CATCH_UP_MS = 72e5;
-/** 注册表绝对路径 */
-function wakeRegistryPath(root) {
-	return join(root, WAKE_REGISTRY_REL_PATH);
-}
-/** 空注册表 */
-function emptyRegistry() {
-	return {
-		version: WAKE_REGISTRY_VERSION,
-		entries: []
-	};
-}
-/** 条目形状校验（容忍手改：字段缺失/类型不符 → 丢弃该条，不阻断整表） */
-function asEntry(value) {
-	const e = value;
-	if (!e || typeof e.id !== "string" || typeof e.target !== "string") return null;
-	if (typeof e.at !== "string" || typeof e.message !== "string") return null;
-	const state = e.state === "delivered" || e.state === "missed" || e.state === "cancelled" ? e.state : "pending";
-	return {
-		id: e.id,
-		target: e.target,
-		at: e.at,
-		message: e.message,
-		state,
-		createdBy: typeof e.createdBy === "string" ? e.createdBy : "",
-		createdAt: typeof e.createdAt === "string" ? e.createdAt : "",
-		attempts: typeof e.attempts === "number" && Number.isFinite(e.attempts) ? e.attempts : 0,
-		lastResult: typeof e.lastResult === "string" ? e.lastResult : null,
-		deliveredAt: typeof e.deliveredAt === "string" ? e.deliveredAt : null
-	};
-}
-/**
-* 读注册表。文件缺失 → 空表；损坏 → 空表 + error（不抛错，调用方决定是否告警）。
-* @param root CCC 根
-* @returns 注册表与读取错误（无错为 null）
-*/
-function loadWakeRegistry(root) {
-	const path = wakeRegistryPath(root);
-	if (!existsSync(path)) return {
-		registry: emptyRegistry(),
-		error: null
-	};
-	try {
-		const parsed = JSON.parse(readFileSync(path, "utf-8"));
-		const raw = Array.isArray(parsed.entries) ? parsed.entries : [];
-		const entries = [];
-		for (const item of raw) {
-			const e = asEntry(item);
-			if (e) entries.push(e);
-		}
-		return {
-			registry: {
-				version: WAKE_REGISTRY_VERSION,
-				entries
-			},
-			error: null
-		};
-	} catch (err) {
-		return {
-			registry: emptyRegistry(),
-			error: `唤醒注册表解析失败（${String(err?.message ?? err)}）`
-		};
-	}
-}
-/** 原子写（tmp + rename；与 .bindings.json 同款形态） */
-function saveWakeRegistry(root, registry) {
-	const path = wakeRegistryPath(root);
-	try {
-		mkdirSync(dirname(path), { recursive: true });
-		const tmp = `${path}.tmp`;
-		writeFileSync(tmp, `${JSON.stringify({
-			version: WAKE_REGISTRY_VERSION,
-			entries: registry.entries
-		}, null, 2)}\n`, "utf-8");
-		renameSync(tmp, path);
-		return {
-			ok: true,
-			error: null
-		};
-	} catch (err) {
-		return {
-			ok: false,
-			error: `唤醒注册表写入失败（${String(err?.message ?? err)}）`
-		};
-	}
-}
-/** 条目 id：`w-<UTC 到分钟>-<4 hex>`（可读 + 低碰撞；不复用由"物理移除"保证） */
-function newWakeId(nowMs, rand = Math.random) {
-	const iso = new Date(nowMs).toISOString();
-	return `w-${`${iso.slice(0, 10).replace(/-/g, "")}-${iso.slice(11, 16).replace(":", "")}`}-${Math.floor(rand() * 65536).toString(16).padStart(4, "0")}`;
-}
-/**
-* 解析唤醒时刻。接受两种写法（设计文档 §7）：
-*  - 绝对：RFC3339（含时区偏移，如 `2026-09-14T09:00:00+08:00`）
-*  - 相对：`+30m` / `+2h`（便于 agent 直接登记"半小时后"）
-* @param input 用户/agent 传入的时刻串
-* @param nowMs 当前时刻（相对写法基准）
-* @returns `{ ok, ms }` 或 `{ ok: false, error }`
-*/
-function parseWakeAt(input, nowMs) {
-	const raw = input.trim();
-	if (raw === "") return {
-		ok: false,
-		error: "时刻为空"
-	};
-	const rel = /^\+(\d+(?:\.\d+)?)([mhd])$/.exec(raw);
-	if (rel) {
-		const n = Number(rel[1]);
-		const unit = rel[2];
-		return {
-			ok: true,
-			ms: nowMs + n * (unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5)
-		};
-	}
-	const ms = Date.parse(raw);
-	if (!Number.isFinite(ms)) return {
-		ok: false,
-		error: `时刻无法解析（须 RFC3339 或 +30m/+2h）: ${raw}`
-	};
-	return {
-		ok: true,
-		ms
-	};
-}
-/**
-* 登记一条唤醒。
-* @param root CCC 根
-* @param input 目标 trajectory / 时刻串 / message / 发起者 / 当前时刻
-* @returns 成功返回条目，失败返回稳定错误文案（不抛错）
-*/
-function addWake(root, input) {
-	const target = input.target.trim();
-	if (target === "") return {
-		ok: false,
-		error: "target 为空（须 S### 或 AGENT_SESSIONS 目录名）"
-	};
-	const message = input.message.trim();
-	if (message === "") return {
-		ok: false,
-		error: "message 为空（唤醒必须携带一条信息）"
-	};
-	const parsed = parseWakeAt(input.at, input.nowMs);
-	if (!parsed.ok) return {
-		ok: false,
-		error: parsed.error
-	};
-	if (parsed.ms <= input.nowMs) return {
-		ok: false,
-		error: "时刻必须在未来（唤醒只允许可预期的未来）"
-	};
-	const { registry, error } = loadWakeRegistry(root);
-	if (error) return {
-		ok: false,
-		error
-	};
-	const entry = {
-		id: newWakeId(input.nowMs),
-		target,
-		at: new Date(parsed.ms).toISOString(),
-		message,
-		state: "pending",
-		createdBy: input.createdBy,
-		createdAt: new Date(input.nowMs).toISOString(),
-		attempts: 0,
-		lastResult: null,
-		deliveredAt: null
-	};
-	registry.entries.push(entry);
-	const saved = saveWakeRegistry(root, registry);
-	if (!saved.ok) return {
-		ok: false,
-		error: saved.error ?? "写入失败"
-	};
-	return {
-		ok: true,
-		entry
-	};
-}
-/**
-* 到期切分（纯函数，可单测）：
-*  - `due`：`state === 'pending'` 且 `now >= at`（在补跑窗口内）→ 应投递
-*  - `expired`：`state === 'pending'` 且 `now - at > catchUpMs` → 应置 missed（不投递）
-* @param registry 注册表
-* @param nowMs 当前时刻
-* @param catchUpMs 补跑窗口
-*/
-function splitDueWakes(registry, nowMs, catchUpMs = WAKE_CATCH_UP_MS) {
-	const due = [];
-	const expired = [];
-	for (const e of registry.entries) {
-		if (e.state !== "pending") continue;
-		const at = Date.parse(e.at);
-		if (!Number.isFinite(at) || nowMs < at) continue;
-		if (nowMs - at > catchUpMs) expired.push(e);
-		else due.push(e);
-	}
-	return {
-		due,
-		expired
-	};
-}
-/**
-* 更新一条（状态推进；调用方给最终状态与结果文案）。
-* @param root CCC 根
-* @param id 条目 id
-* @param patch 要写入的字段
-* @returns 写入结果
-*/
-function updateWake(root, id, patch) {
-	const { registry, error } = loadWakeRegistry(root);
-	if (error) return {
-		ok: false,
-		error
-	};
-	const entry = registry.entries.find((e) => e.id === id);
-	if (!entry) return {
-		ok: false,
-		error: `wake_not_found: ${id}`
-	};
-	Object.assign(entry, patch);
-	return saveWakeRegistry(root, registry);
-}
-/** 列条目（默认全量；`pendingOnly` 只列在办项——面板/工具用） */
-function listWakes(root, opts = {}) {
-	const { registry, error } = loadWakeRegistry(root);
-	return {
-		entries: [...opts.pendingOnly ? registry.entries.filter((e) => e.state === "pending") : registry.entries].sort((a, b) => Date.parse(a.at) - Date.parse(b.at)),
-		error
-	};
-}
-//#endregion
-export { splitDueWakes as a, loadWakeRegistry as i, addWake as n, updateWake as o, listWakes as r, WAKE_CATCH_UP_MS as t };