@shgroup/dsh-serenity-hooks 1.42.0 → 1.43.0

package/lib/index.js

@@ -2,12 +2,12 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as hostSettings, c as hostWebServer, i as hostSessions, n as hostInjected, o as hostSubagents, r as hostService, s as hostWeb, t as hostAgents } from "./access-fiehjxV6.js";
 import { a as findSerenityRoot, c as matchBlacklist, d as readCccName$1, f as readExclusiveTools, h as resolveInside, i as findGitRoot, l as pathInside, n as SAFE_MODE_MARKER, o as isSafeModeOn, p as readHandymanConfig, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-NlLr_sxy.js";
 import { i as cccRootForExec, n as agentCwdFor, o as listCccs, r as cccRootForCwd, t as NO_CCC_FROM_AGENT_CWD } from "./ccc-roots-Bd_SjEs7.js";
-import { C as summarize, E as localFileStamp, S as showSession, T as isoLocal, _ as readActiveSessionMd, a as resolveSessionTrajectoryLabel, b as sessionsRoot, c as DEFAULT_SESSION_SCOPE, d as createSession, f as extractSessionMdPathFromText, g as parseSessionContextFromEvents, h as listSessions, i as readLastBound, l as TRAJECTORY_ACTIONS, m as getActiveSessionInfo, o as setBindingStore, p as findSession, r as pruneMissingBindings, s as supersedeOtherBindings, t as appendBound, u as clearActiveSessionInfo, v as resolveSessionByTitle, w as useSession, x as setActiveSessionInfo, y as sessionEvents$1 } from "./trajectory-bound-4xkZDfmO.js";
+import { C as summarize, E as localFileStamp, S as showSession, T as isoLocal, _ as readActiveSessionMd, a as resolveSessionTrajectoryLabel, b as sessionsRoot, c as DEFAULT_SESSION_SCOPE, d as createSession, f as extractSessionMdPathFromText, g as parseSessionContextFromEvents, h as listSessions, i as readLastBound, l as TRAJECTORY_ACTIONS, m as getActiveSessionInfo, o as setBindingStore, p as findSession, r as pruneMissingBindings, s as supersedeOtherBindings, t as appendBound, u as clearActiveSessionInfo, v as resolveSessionByTitle, w as useSession, x as setActiveSessionInfo, y as sessionEvents$1 } from "./trajectory-bound-kxvMuCui.js";
 import { a as readWeixinCredential, c as weixinInboundDir, d as LOCALSTORE_SCOPES, f as checkLocalstoreGitCompliance, g as runLocalStore, h as readStore, i as matchWeixinRoute, l as weixinSessionIdFor, m as readGitTrack, n as extractWeixinText, o as readWeixinSettings, p as localstorePath, r as hasVoiceItem, s as sanitizeFileName$1, t as extractWeixinMedia } from "./weixin-route-B2ajFypI.js";
 import { a as readSkiffRoles, c as roleMsmWhitelist, d as systemPromptSource, f as trajectorySubset, i as isSkiffSessionId, l as roleToolWhitelist, n as buildSkiffBasePrompt, o as resolveRoleSystemPrompt, r as createRolePromptReader, s as resolveSkiffKind } from "./skiff-role-CEHL5cek.js";
 import { a as unregisterSkiffSession$1, i as skiffSessionSnapshot$1, n as skiffRoleFor$1, r as skiffSessionInfo$1, t as registerSkiffSession$1 } from "./skiff-registry-FTjoWQTQ.js";
 import { r as sessionsRootDir, t as hasSessionLogById } from "./session-cleanup-BtkSmry8.js";
-import { a as WAKE_CATCH_UP_MS, i as registerDisposer, n as sendToTrajectory, o as addWake, r as wakeSchedulerState, s as listWakes, t as registerWakeScheduler } from "./wake-scheduler-1AsvNQPW.js";
+import { a as registerDisposer, c as addWake, i as registerCroTurnTracking, l as listWakes, n as sendToTrajectory, o as buildCroSnapshot, r as wakeSchedulerState, s as WAKE_CATCH_UP_MS, t as registerWakeScheduler } from "./wake-scheduler-DC4-imVO.js";
 import { a as FACE_PORTS, c as MECHANISM_PORTS, i as ACP_HTTP_PORT, l as SKIFF_DEBUG_PORT, n as registerSettingsSection, o as GATEWAY_PORT, s as MAIN_WEB_PORT, t as readSimpleSettings, u as WEIXIN_SEND_PORT } from "./settings-section-DMDUoQum.js";
 import { a as markdownToPlainText, c as sendTyping, i as getUpdates, l as sniffImageExt, n as downloadMedia, o as sendFileMessage, r as getConfig, s as sendTextMessage, t as TypingStatus } from "./weixin-api-CtFYm53S.js";
 import z from "@deepseek-ai/schemastery";
@@ -956,7 +956,8 @@ const NPX_BIN = process.platform === "win32" ? "npx.cmd" : "npx";
 const ACC_CATALOG = `═══ ACC Usage Catalog ═══
 Directory of ACC capabilities — each area lists where to go for details (guides live with their feature; this catalog only points).
 
-  ① 轨迹本体          → container_trajectory（list/show/create/use + rebuild 超限重建 + send-now 即时投递 + send-later 未来一次性唤醒）
+  ① 轨迹本体          → container_trajectory（list/show/create/use + rebuild 超限重建 + send-now 即时投递 + send-later 未来一次性唤醒
+                          + cro-guide CRO 编写指南）
                          原 logbook 已并入（v1.33 用户裁决：废除 logbook 词）；close/archive 删（归档走 container_fs mv），
                          health/qa/summary 分别并入 use / list，hook-develop-guide 并进 container_admin msm guide
   ② 认知质量框架      → praxis（eap/neat/cce 三合一——可实践理论注入，section 渐进披露，无参即目录）
@@ -3010,6 +3011,205 @@ function createHandymanTool(ctx) {
 	});
 }
 //#endregion
+//#region src/cro-guide.ts
+/**
+* cro-guide.ts — CRO 编写指南（**ACC 内置**，S142 §7.8，2026-09-19）
+*
+* ## 为什么指南在 ACC 而不在 CCC（所有者令）
+*
+* 所有者 2026-09-19：「**ACC 内置，整个机制属于 ACC，CCC 是用户**」。
+* ⇒ 契约 / 调度 / 执行 / 状态暴露 / 容错 / **编写指南** 全在 ACC；
+*   CCC（用户）只负责**写那段程序**。
+*
+* ## 🔴 单真相源纪律（本文件的核心约束）
+*
+* 指南**不复制**契约条款，且**样例快照是"派生"而非"手抄"**：
+* {@link CRO_SAMPLE_SNAPSHOT} 由 {@link buildCroSnapshot} **真正装配**出来 ⇒
+* **schema 一变，样例自动跟着变**，不存在"文档里的样例过期"这一失效模式。
+* （本容器栽过多次"第二真相源"，此处用代码结构而不是纪律去防它。）
+*
+* ## 所有者对本指南的两条明示要求（2026-09-19）
+*
+* 1. 🔴 **必须备注：CRO 程序是可自测的；测试通过再把文件名改成正式名**；
+* 2. 🔴 **要一并给出测试用的参数**。
+*/
+/**
+* 样例快照输入 —— **代表性数据**（不是真实某条轨迹的现状）。
+*
+* 取值刻意让它能演示所有者举的 S185 场景（天亮/有人/非高峰 + 已在干活 + 日志过大）。
+*/
+const CRO_SAMPLE_SNAPSHOT_INPUT = {
+	dirName: "2026-09-13--S185--desk-camera",
+	cccRoot: "/home/yh/home/home-serenity",
+	nowMs: 17898e8,
+	sessionMdPath: "/home/yh/home/home-serenity/AGENT_SESSIONS/2026-09-13--S185--desk-camera/SESSION.md",
+	sessionMdBytes: 182e3,
+	sessionMdMtimeMs: 1789799e6,
+	references: [{
+		name: "campaign-100.md",
+		bytes: 41200,
+		mtimeMs: 178979e7
+	}, {
+		name: "auto-exposure.md",
+		bytes: 8400,
+		mtimeMs: 17897e8
+	}],
+	boundSessionIds: ["session-adccc461-9f32-4d9a-a688-9da81fa1ca35"],
+	liveSessionIds: ["session-adccc461-9f32-4d9a-a688-9da81fa1ca35"],
+	runningSessionIds: [],
+	pendingWakes: [{
+		id: "w-20260919-0900-aaaa",
+		at: "2026-09-19T09:30:00+08:00",
+		createdAt: "2026-09-19T07:00:00+08:00",
+		createdBy: "S185"
+	}],
+	scheduler: {
+		armed: true,
+		enabled: true,
+		ticks: 128,
+		lastSkipReason: null
+	}
+};
+/**
+* 🔴 **样例快照（测试参数）** —— **由真实装配器生成**，故**永不与 schema 漂移**。
+*
+* 用途：写 CRO 程序时把它喂给你的程序做自测（见指南 §8「自测」）。
+* @returns 缩进过的快照 JSON 文本
+*/
+function renderCroSampleSnapshot() {
+	return JSON.stringify(buildCroSnapshot(CRO_SAMPLE_SNAPSHOT_INPUT), null, 2);
+}
+/**
+* CRO 编写指南正文（ACC 内置手册；由工具的 guide 动作输出）。
+*
+* 结构照既有 guide 惯例（`MSM_GUIDE` / `handyman(guide=true)`）：
+* 用途 → 位置 → 我给什么 → 你给我什么 → 骨架 → 常见模式 → 坑 → **自测**。
+*/
+const CRO_GUIDE = `CRO（Continuous Re-Occurrence · 持续再发生）编写指南
+
+## 0. 这是什么（一句话）
+让一条轨迹**自己带一段程序**，由 ACC 在每次检查时跑它，
+**由这段程序决定「现在该不该叫我、叫我的时候说什么」**。
+
+今天的唤醒只认时间（"3 点叫我"）；CRO 让它认**情况**（"天亮且家里有人才叫我"）。
+
+## 1. 它在系统里的位置
+· **机制属 ACC**（本指南、契约、调度、执行、容错都在 ACC）
+· **程序属 CCC**（你写的那段 TS，放在**你自己轨迹的目录**里）
+· **执行者** = ACC 的唤醒调度器（每 5 分钟一次 tick）
+
+## 2. 文件放哪、叫什么
+  <CCC 根>/AGENT_SESSIONS/<轨迹目录>/continuous-re-occurrence.ts
+
+🔴 **文件名必须全写**（不许用缩写）。
+🔴 **程序只有一个**：**文件在 = 启用；文件不在 = 禁用**。
+   —— 没有开关、没有注册表、没有 enabled 字段。
+
+## 3. 我给你什么（输入）
+ACC 把这条轨迹的状态做成一个 **JSON 快照**，从 **stdin** 喂给你的程序。
+字段分四组：identity（身份）/ time（时间）/ body（轨迹身体）/ binding + scheduling（绑定与调度）。
+
+⚠️ **给的是"快照"，不是"无限能力"**：ACC 看不见的东西（比如"你上次判了什么"）
+   **物理上给不了**（那是你进程里的内存）。那类状态**归你自己**——
+   写在你自己的轨迹目录里（例如一个 state.json），自己读自己写。
+
+## 4. 你给我什么（输出）
+向 **stdout** 写 **一行 JSON**：
+
+  { "wake": true,  "prompt": "唤起时的提示词", "reason": "判定理由（可选）" }
+  { "wake": false }                                  // 不唤起
+
+· \`wake\` 缺省 / false ⇒ **不唤起**（**这是常态**，缺省是"不打扰"）
+· \`wake: true\` 时 \`prompt\` **必须非空**（否则视为非法，本轮跳过、不投递空消息）
+· 🔴 \`reason\` **强烈建议填**：见 §7 坑 3
+
+## 5. 骨架
+
+  // continuous-re-occurrence.ts
+  let raw = ''
+  process.stdin.on('data', (d) => { raw += d })
+  process.stdin.on('end', () => {
+    const s = JSON.parse(raw)                 // 轨迹状态快照
+    // ... 在这里写你的判定 ...
+    process.stdout.write(JSON.stringify({ wake: false }))
+  })
+
+例（所有者举的 S185 那类情形，仅示意）：
+
+  const tooBig = (s.body.sessionMdBytes ?? 0) > 150_000
+  const busy   = s.binding.runningSessionIds.length > 0
+  if (busy) return out({ wake: false, reason: '已在干活' })
+  if (tooBig) return out({ wake: true, prompt: '你的 SESSION.md 已很大，请先压缩再继续。', reason: '日志超限' })
+
+## 6. 常见模式
+· **环境谓词**（天亮/有人/非高峰）：ACC 给不了这些 —— **你自己去拿**（查设备、读传感器、
+  查你自己的程序）。这就是"程序和程序可以互相访问"的用法。快照里的 \`time\` 只是给你一个时间锚。
+· **已在工作就别叫**：看 \`binding.runningSessionIds\`（非空 = 有载体正在跑轮次）。
+  ⚠️ 注意它和 \`liveSessionIds\` 不同：**会话活着 ≠ 在干活**。
+· **要求它先自整理**：不需要新机制 —— **就是 \`prompt\` 的一种写法**
+  （如"你的 SESSION.md 已 180 KB，请先压缩再继续"）。
+· **次数上限 / 连续 N 次才叫**：ACC 不给你计数器（**给不了**）⇒ **自己目录里写状态文件**。
+
+## 7. 坑
+1. **不许阻塞等输入**：你只从 stdin 拿一次快照，不要在程序里 readline / prompt 等用户输入。
+2. **硬超时 60 秒**：超时会被 SIGKILL、本轮跳过。外部查询请自己设更短的超时。
+3. 🔴 **一定要填 \`reason\`**：改成程序判定之后，"当时为什么叫了"**不再能从时间表重建**——
+   原因在**你的程序肚子里**（可能有随机、可能看了外部数据）。不写 reason，
+   以后出事**无法复现**。这条不是形式主义，是**可重建性**的要求。
+4. **失败只影响你自己**：程序报错/超时/输出非法 ⇒ 记一行 + **跳过本轮**，
+   **绝不会影响** \`send-later\` / \`send-now\` 等既有机制。所以你可以放心试。
+5. 🔴 **不要提前用正式文件名**：见 §8。
+
+## 8. 🔴 自测（**测试通过再把文件名改成正式的**）
+CRO 程序**是可以自测的** —— 因为它只做一件事：**吃一份快照 JSON，吐一行决策 JSON**。
+（纯函数式的边界 ⇒ 不需要真机、不需要等 5 分钟 tick、不需要调度器。）
+
+### 8.1 推荐流程：**用开发名写，绿了再改名**
+因为「**文件在 = 启用**」没有开关，**改名这个动作本身就是上线动作**：
+
+  1. 先用**开发名**写（如 \`continuous-re-occurrence.dev.ts\`）
+     —— 开发名**不会**被 ACC 启用（启用只认正式名 exact match），可以放心留一半
+  2. 配一个自测（如 \`continuous-re-occurrence.dev.test.ts\`），喂几份快照断言输出
+  3. **全部绿了** ⇒ 改名为 \`continuous-re-occurrence.ts\` ⇒ **这一刻才生效**
+
+⚠️ 若你跳过自测直接上正式名：半成品会被当成生效程序，**报错并跳过本轮**（不会搞坏系统，
+  但那条轨迹的 CRO 就是空转的）。**报错是安全网，不是工作流。**
+
+### 8.2 手工试跑（最快的一条路）
+把样例快照喂给你的程序，看它吐什么：
+
+  # 用开发名试跑（推荐 bun；node 需能跑 TS）
+  bun continuous-re-occurrence.dev.ts < sample-snapshot.json
+
+  # 或直接管道
+  echo '<一行快照 JSON>' | bun continuous-re-occurrence.dev.ts
+
+### 8.3 测试用的参数
+**样例快照 = 由 ACC 的装配器实时生成**（故**永不与 schema 漂移**，schema 一变它跟着变）。
+取法：**运行本指南所在工具的 guide 动作**，或用同一机制导出；内容是：
+
+\`\`\`json
+${renderCroSampleSnapshot()}
+\`\`\`
+
+该样例刻意覆盖了：
+· \`body.sessionMdBytes\` = 182000（**日志过大**那一档）
+· \`binding.runningSessionIds\` = []（**空闲**；把它填成一个 id 就能测"已在干活"分支）
+· \`scheduling.pendingWakes\` 非空（**已有待办唤醒**）
+· 无 S 前缀格式的情形请自己造 \`dirName\`（\`identity.code\` 会是空串——那是**正常**的，
+  编号不是固定格式，硬锚永远是 \`dirName\`）
+
+### 8.4 自测该断言什么（建议清单）
+· 快照缺字段（\`null\` 体积）时不崩 —— 用 \`?? 0\` 之类兜底
+· \`wake:true\` 时 \`prompt\` **确实非空**
+· "已在干活"分支：\`runningSessionIds\` 非空 ⇒ \`wake:false\`
+· 同一个程序**连跑两次**给同样输入 ⇒ 同样输出（除非你刻意用了随机/外部状态，
+  那就必须写进 \`reason\`）
+
+## 9. 一句话
+**吃一份快照，吐一行决策。先自测，绿了再改名。**
+`;
+//#endregion
 //#region src/tools/trajectory.ts
 /**
 * trajectory.ts — `container_trajectory` 真实 DSH 工具定义（defineTool）
@@ -3017,7 +3217,7 @@ function createHandymanTool(ctx) {
 * v1.33（S142 §32 用户裁决）：由 `logbook` **更名并收敛为 `trajectory`**（v1.34：工具名再硬切为
 * `container_trajectory`，无别名）——trajectory 是一等概念
 * （SESSION.md 是它的持久身体），本工具管它的**载体生命周期 + 一次性时间安排**。
-* 动作面现行 **7 个**：list / show / create / use / rebuild / **`send-now`** / **`send-later`**。
+* 动作面现行 **8 个**：list / show / create / use / rebuild / **`send-now`** / **`send-later`** / **`cro-guide`**。
 * 🔴 2026-09-16（所有者裁决）：**第 7 个动作 `send-message`（即时投递）**
 *    ——与 `wake-later` 共用取用通路，差别只在**时刻**（现在 vs 未来）与**回执**（有 vs 无）；
 *    实现落在 `wake-scheduler.ts` 的 `sendToTrajectory()`（"怎么把一句话送到一条轨迹"是调度器的知识）。
@@ -3040,6 +3240,9 @@ function createHandymanTool(ctx) {
 *     `systemPrompt.section` 注入，见 `docs/trajectory-skill-injection.md`）
 *   · autopilot 面（all/init/random/diag/doc/check/status/guide）→ `container_admin` 的 autopilot 域
 *   · `wake-add`/`wake-list`/`wake-rm` → **`wake-later`**（v1.33 收敛；**2026-09-17 更名 `send-later`**）
+*   · 2026-09-20（CRO 落地）：新增 **`cro-guide`** —— CRO 编写指南的出口（纯读）。
+*     判据（R↓，为何在此而不新增域）：CRO 程序放在**轨迹自己的目录**里 ⇒ "怎么写它"是
+*     **逐轨迹**的知识，而管轨迹的人正是用本工具的人（设计 §9-5「既有 guide 位置，不新增域」）。
 *
 * 保留 osp 对齐语义的部分：create 的 `--desc`/`--issue` 二选一、use 激活即重命名 dsh 会话标题（F3）。
 * 活跃会话跟踪：内存 Map（按 dsh 会话 id 隔离）+ 从 events 恢复（S134）。
@@ -3170,13 +3373,13 @@ function renderText$3(value) {
 function createTrajectoryTool(ctx) {
 	return defineTool({
 		name: "container_trajectory",
-		description: "Trajectory (AGENT_SESSIONS/ — the persistent body of a trajectory; the dsh conversation is only its rebuildable carrier). Lifecycle + delivery: list (inventory with stats and anomaly marks) / show (read one SESSION.md) / create / use (activate for this conversation, with inline integrity check) / rebuild (clear-and-rebuild the current conversation in place, Ship of Theseus) / send-now (deliver ONE message to a trajectory RIGHT NOW — live: injected immediately; not live: cold-resumed, i.e. equivalent to a direct wake; returns a synchronous receipt) / send-later (schedule ONE message to any trajectory at a future instant — fire-and-forget: no receipt, no recall, no panel). create requires --desc <desc> [--goal] or --issue <ticket> (exactly one) plus --summary (≤20 chars). use requires --summary (≤20 chars) and may pass --force to switch away from the currently-bound trajectory. rebuild requires --summary (next-phase summary ≤20 chars) + optional --note (task focus for the rebuilt self). send-later requires target (S### or AGENT_SESSIONS dir name) + at (RFC3339 or +30m/+2h) + message. send-now requires target + message. It delivers IMMEDIATELY (never queued behind the current turn): a busy target is steered mid-turn so it reads the message in the CURRENT turn, and an idle target starts a turn right away. Its receipt means the message was injected into the target (it does NOT mean the target ran or replied). The summary is appended to the dsh session title (S###-YYYY-MM-DD-<summary>); the S### id and date stay server-derived.",
+		description: "Trajectory (AGENT_SESSIONS/ — the persistent body of a trajectory; the dsh conversation is only its rebuildable carrier). Lifecycle + delivery: list (inventory with stats and anomaly marks) / show (read one SESSION.md) / create / use (activate for this conversation, with inline integrity check) / rebuild (clear-and-rebuild the current conversation in place, Ship of Theseus) / send-now (deliver ONE message to a trajectory RIGHT NOW — live: injected immediately; not live: cold-resumed, i.e. equivalent to a direct wake; returns a synchronous receipt) / send-later (schedule ONE message to any trajectory at a future instant — fire-and-forget: no receipt, no recall, no panel) / cro-guide (the CRO programming guide: how to give THIS trajectory its own program that decides when it should be woken). create requires --desc <desc> [--goal] or --issue <ticket> (exactly one) plus --summary (≤20 chars). use requires --summary (≤20 chars) and may pass --force to switch away from the currently-bound trajectory. rebuild requires --summary (next-phase summary ≤20 chars) + optional --note (task focus for the rebuilt self). send-later requires target (S### or AGENT_SESSIONS dir name) + at (RFC3339 or +30m/+2h) + message. send-now requires target + message. It delivers IMMEDIATELY (never queued behind the current turn): a busy target is steered mid-turn so it reads the message in the CURRENT turn, and an idle target starts a turn right away. Its receipt means the message was injected into the target (it does NOT mean the target ran or replied). The summary is appended to the dsh session title (S###-YYYY-MM-DD-<summary>); the S### id and date stay server-derived.",
 		parameters: {
 			action: {
 				type: "string",
 				enum: [...TRAJECTORY_ACTIONS],
 				required: true,
-				description: "Subcommand: list (inventory + stats + anomaly marks) / show (S### or dir name or fuzzy keyword) / create (--desc or --issue) / use (activate context; inline integrity check — pass silent, problems reported as hints, not errors) / rebuild (clear-and-rebuild current conversation — requires --summary + optional --note) / send-now (deliver one message RIGHT NOW: live target injected immediately, non-live cold-resumed like a direct wake; returns a synchronous receipt) / send-later (one future instant + one message, delivered to target trajectory)"
+				description: "Subcommand: list (inventory + stats + anomaly marks) / show (S### or dir name or fuzzy keyword) / create (--desc or --issue) / use (activate context; inline integrity check — pass silent, problems reported as hints, not errors) / rebuild (clear-and-rebuild current conversation — requires --summary + optional --note) / send-now (deliver one message RIGHT NOW: live target injected immediately, non-live cold-resumed like a direct wake; returns a synchronous receipt) / send-later (one future instant + one message, delivered to target trajectory) / cro-guide (no parameters: prints the CRO programming guide, including a ready-to-use sample snapshot)"
 			},
 			name: {
 				type: "string",
@@ -3352,6 +3555,7 @@ function createTrajectoryTool(ctx) {
 						].join("\n")
 					};
 				}
+				case "cro-guide": return CRO_GUIDE;
 				default: throw new Error(`Unknown action: ${args.action}`);
 			}
 		}
@@ -5656,7 +5860,7 @@ function toolsBlock() {
 		"The ACC (this plugin) provides the following built-in tools:",
 		"",
 		"  container_fs — container filesystem operations (15 subcommands: root/resolve/exists/list/tree/relative/mkdir/rm/mv/cp/touch/append/reveal/info/find)",
-		"  container_trajectory — one trajectory: its persistent body (SESSION.md) + its timeline. Lifecycle: list (inventory + stats) / show / create / use (activate; inline integrity check — silent when fine) / rebuild (clear-and-rebuild this conversation in place, Ship of Theseus); delivery: send-now (deliver one message RIGHT NOW; live target injected immediately, non-live cold-resumed like a direct wake — returns a synchronous receipt) / send-later (one future instant + one message to any trajectory; fire-and-forget — no receipt, no recall)",
+		"  container_trajectory — one trajectory: its persistent body (SESSION.md) + its timeline. Lifecycle: list (inventory + stats) / show / create / use (activate; inline integrity check — silent when fine) / rebuild (clear-and-rebuild this conversation in place, Ship of Theseus); delivery: send-now (deliver one message RIGHT NOW; live target injected immediately, non-live cold-resumed like a direct wake — returns a synchronous receipt) / send-later (one future instant + one message to any trajectory; fire-and-forget — no receipt, no recall) / cro-guide (the CRO programming guide: how to give THIS trajectory its own program that decides when it should be woken)",
 		"  dashboard    — always-on container instruments: health (CCC three-principle check + registry integrity) / time (now) / wait (N seconds)",
 		"  container_git— git operations (status/commit/push/log)",
 		"  msm          — execute a registered CCC MSM: msm(name, args); partial name returns candidates; inspect=true shows usage",
@@ -14958,6 +15162,7 @@ function apply(ctx, config) {
 	registerBootstrap(ctx);
 	registerSkiff(ctx);
 	registerAcp(ctx);
+	registerCroTurnTracking(ctx);
 	registerWakeScheduler(ctx);
 	registerWeixinBridge(ctx);
 	registerWeixinSendApi(ctx);

package/lib/tools/trajectory.d.ts

@@ -4,7 +4,7 @@
  * v1.33（S142 §32 用户裁决）：由 `logbook` **更名并收敛为 `trajectory`**（v1.34：工具名再硬切为
  * `container_trajectory`，无别名）——trajectory 是一等概念
  * （SESSION.md 是它的持久身体），本工具管它的**载体生命周期 + 一次性时间安排**。
- * 动作面现行 **7 个**：list / show / create / use / rebuild / **`send-now`** / **`send-later`**。
+ * 动作面现行 **8 个**：list / show / create / use / rebuild / **`send-now`** / **`send-later`** / **`cro-guide`**。
  * 🔴 2026-09-16（所有者裁决）：**第 7 个动作 `send-message`（即时投递）**
  *    ——与 `wake-later` 共用取用通路，差别只在**时刻**（现在 vs 未来）与**回执**（有 vs 无）；
  *    实现落在 `wake-scheduler.ts` 的 `sendToTrajectory()`（"怎么把一句话送到一条轨迹"是调度器的知识）。
@@ -27,6 +27,9 @@
  *     `systemPrompt.section` 注入，见 `docs/trajectory-skill-injection.md`）
  *   · autopilot 面（all/init/random/diag/doc/check/status/guide）→ `container_admin` 的 autopilot 域
  *   · `wake-add`/`wake-list`/`wake-rm` → **`wake-later`**（v1.33 收敛；**2026-09-17 更名 `send-later`**）
+ *   · 2026-09-20（CRO 落地）：新增 **`cro-guide`** —— CRO 编写指南的出口（纯读）。
+ *     判据（R↓，为何在此而不新增域）：CRO 程序放在**轨迹自己的目录**里 ⇒ "怎么写它"是
+ *     **逐轨迹**的知识，而管轨迹的人正是用本工具的人（设计 §9-5「既有 guide 位置，不新增域」）。
  *
  * 保留 osp 对齐语义的部分：create 的 `--desc`/`--issue` 二选一、use 激活即重命名 dsh 会话标题（F3）。
  * 活跃会话跟踪：内存 Map（按 dsh 会话 id 隔离）+ 从 events 恢复（S134）。

package/lib/{trajectory-bound-4xkZDfmO.js → trajectory-bound-kxvMuCui.js}

@@ -94,7 +94,7 @@ function localIdStamp(value = Date.now()) {
 * 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec。
 *
 * v1.33 收敛（S142 §32）：本文件只服务 `container_trajectory` 的动作面
-* （现行 **7 个**：list / show / create / use / rebuild / **send-now** / **send-later**）。旧 `logbook` 面里
+* （现行 **8 个**：list / show / create / use / rebuild / **send-now** / **send-later** / **cro-guide**）。旧 `logbook` 面里
 * **close / archive / health / qa 四个动作已删**（用户裁决「功能上废弃，实际上没用」），
 * 其函数（closeSession / archiveSessions / healthCheck / qaCheck）**同批删除**——
 * 保留下来的只有：create（--desc / --issue 二选一、dry-run 预览）、
@@ -108,7 +108,8 @@ const TRAJECTORY_ACTIONS = [
 	"use",
 	"rebuild",
 	"send-now",
-	"send-later"
+	"send-later",
+	"cro-guide"
 ];
 /**
 * 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类

package/lib/trajectory-ops.d.ts

@@ -4,7 +4,7 @@
  * 行为对齐 osp（opencode-serenity-plugin/src/session/lib.ts）——osp 是 ACC 工具 spec。
  *
  * v1.33 收敛（S142 §32）：本文件只服务 `container_trajectory` 的动作面
- * （现行 **7 个**：list / show / create / use / rebuild / **send-now** / **send-later**）。旧 `logbook` 面里
+ * （现行 **8 个**：list / show / create / use / rebuild / **send-now** / **send-later** / **cro-guide**）。旧 `logbook` 面里
  * **close / archive / health / qa 四个动作已删**（用户裁决「功能上废弃，实际上没用」），
  * 其函数（closeSession / archiveSessions / healthCheck / qaCheck）**同批删除**——
  * 保留下来的只有：create（--desc / --issue 二选一、dry-run 预览）、
@@ -29,8 +29,14 @@
  *   同落点语义），只差**时刻**；而「唤醒（冷载入）」是**两条路径共有**的属性，不配做区分
  *   ⇒ 族名取共享词干 **`send-`**、轴取 **`-now` / `-later`**（同构）。**硬切无别名**；
  *   机制层词汇（`wake-registry.json` / `w-*` id / `WakeEntry` / 调度器名）**一律不动**（分层命名）。
+ * 2026-09-20（CRO 落地，owner 令「搞定了发一版」）：新增 **`cro-guide`** —— CRO
+ *   （Continuous Re-Occurrence，`docs/cro-design.md`）的**编写指南**出口。
+ *   判据（R↓，为何挂在本工具而不新增域）：CRO 程序**放在轨迹自己的目录里**
+ *   （`<轨迹目录>/continuous-re-occurrence.ts`）⇒ 「怎么写它」是**逐轨迹**的知识，
+ *   而**管轨迹的人正是用本工具的人**；挂这儿 = 设计 §9-5 的"**既有 guide 位置、不新增域**"。
+ *   ⚠️ 本动作**纯读**（输出指南正文，不碰 fs、不碰注册表）。
  */
-type TrajectoryAction = 'list' | 'show' | 'create' | 'use' | 'rebuild' | 'send-now' | 'send-later';
+type TrajectoryAction = 'list' | 'show' | 'create' | 'use' | 'rebuild' | 'send-now' | 'send-later' | 'cro-guide';
 export declare const TRAJECTORY_ACTIONS: readonly TrajectoryAction[];
 /**
  * 读取 Session 事件序列（v1.28.1 适配 0.1.2-rc.1 补齐）：rc.1 起官方 Session 类