@shgroup/dsh-serenity-hooks 1.74.0 → 1.75.0

package/README.md

@@ -252,21 +252,23 @@ my-workspace/                     ← 工作区根目录（放一个 .serenity
   `source: "reply-fallback"` 表示"AI 没发、插件兜底发的"。
 - **排障**：`msm("weixin-doctor", ["status"|"diag"|"verify"|"guide"])`
 
-### 6.3 轨迹约束（trajectory constraint）
+### 6.3 轨迹声明（trajectory declaration）
 
-**轨迹约束就是一条「目录里放了 `trajectory-constraint.json` 的认知轨迹」** —— 没有别的定义。
-放进去，这条轨迹立刻受约束；删掉它，当场恢复成普通轨迹。
+**轨迹的"声明"只有一个文件**：`trajectory.json`。**目录里有它 ⇒ 这条轨迹受约束**；删掉它，当场恢复成普通轨迹。
 
 ```jsonc
 // AGENT_SESSIONS/2026-10-19--qa--问答/  ← 轨迹目录（编码 = 目录名固定位置那一段）
-//   ├─ SESSION.md                  ← 它自己的身体（工作台就是它，不另建）
-//   ├─ PROMPT.md                   ← 它的章程（推荐；所有轨迹都适用，不限于轨迹约束）
-//   ├─ trajectory-constraint.json  ← 约束面（这个文件的存在，就是"它是轨迹约束"的判据）
+//   ├─ SESSION.md              ← 它自己的身体（工作台就是它，不另建）
+//   ├─ PROMPT.md               ← 它的章程（推荐；所有轨迹都适用，不限于受约束的轨迹）
+//   ├─ trajectory.json         ← 声明面（这个文件的存在，就是判据）
+//   └─ cro-wake-log.log        ← CRO 流水（纯文本；只有真的唤起过才会有）
 {
   "model": "provider/model",              // 这条轨迹单独用哪个模型
   "msms": ["web-search", "vlm-describe"], // 它能调哪些小工具（MSM）
   "tools": ["read", "grep", "glob"],      // 它能用哪些平台工具
-  "cognitiveTrajectory": { "session": true, "keeper": true, "rebuild": true }  // 缺省即全 true
+  "cognitiveTrajectory": { "session": true, "keeper": true, "rebuild": true },  // 缺省即全 true
+  "uid": "my-handle",                     // 可选：旧的只读标识（身份已归轨迹编码）
+  "cro": { "host": "<机器名>" }           // 可选：本轨迹的 CRO 程序只许哪台机器跑
 }
 ```
 
@@ -275,6 +277,9 @@ my-workspace/                     ← 工作区根目录（放一个 .serenity
 - 章程写在轨迹目录的 **`PROMPT.md`** 里（跟着轨迹走，归档时一起搬）；旧的 `systemPromptFile` 仍被读取，但 `PROMPT.md` 优先
 - `container_admin config validate` 校验，`apply` 才真正生效；两者都**实时读盘**，改完下一轮即生效
 - 微信路由也指向它：`routes: [{ "user": "*", "trajectory": "qa" }]`（**user → 轨迹编码**）
+- 🔴 **旧文件名仍被读取**：`trajectory-constraint.json`（v1.74）／ `skiff.json`（v1.71）都在**读取族**里，
+  **写只写 `trajectory.json`**，旧文件**永不自动删**。判据 = **认族不认名**（上游改名、下游写死旧名
+  是本仓反复发生的失效形态）。详见 [`docs/trajectory-declaration-file.md`](https://github.com/tellmewhattodo/dsh-serenity-plugin/blob/master/docs/trajectory-declaration-file.md)。
 
 ### 6.4 对外接入（官方 ACP）
 

package/dsh.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.74.0",
+  "version": "1.75.0",
   "main": "lib/index.js",
-  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹约束 = 目录下有 trajectory-constraint.json 的认知轨迹（约束面住在轨迹里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
+  "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {
     "dsh": ">=0.1.7-rc.1"
   },

package/lib/{ccc-roots-B2t_aM8L.js → ccc-roots-BVxn97dY.js}

@@ -227,7 +227,7 @@ async function listCccs(ctx, opts = {}) {
 	if (typeof defaultRoot === "string" && defaultRoot !== "" && !c.roots.includes(defaultRoot)) c.roots.unshift(defaultRoot);
 	let rolesOf = null;
 	if (opts.withRoles === true) {
-		const { listTrajectoryConstraints } = await import("./profile-BVt84mbi.js").then((n) => n.i);
+		const { listTrajectoryConstraints } = await import("./profile-Cz4oBXlI.js").then((n) => n.i);
 		rolesOf = (root) => {
 			try {
 				return listTrajectoryConstraints(root).map((p) => p.code);

package/lib/cro/core.d.ts

@@ -296,6 +296,16 @@ export interface CroHostVerdict {
  * —— 程序还没跑，没有快照可读。⇒ 只能读文件。（这也是"机制属 ACC"的体现：
  * ACC 在调用用户程序前先判定自己该不该调用。）
  *
+ * ## 🆕 2026-10-19 owner 裁 Q2：**声明文件里的 `cro.host` 优先，独立文件回落**
+ *
+ * 收拢后机器名住在 `<轨迹目录>/trajectory.json` 的 `cro.host` 字段里。
+ * 判据（**两代并读，不硬切**）：**声明面里有合法 `cro.host` ⇒ 用它；否则回落 `cro-host-binding` 文件**。
+ *
+ * 🔴 **为什么这里绝不能硬切**（比别处更硬的一条，逐字保留原裁定）：
+ * 硬切之后，**第二台机器**读到的是「没绑」而不是「绑给了别人」——
+ * 两者都导致"不跑"，**表面结果相同，但判据退化**（失去可诊断性）。
+ * ⇒ 只要还有一台机器可能装着旧版本，两条路都必须能读。
+ *
  * @param root CCC 根
  * @param dirName 轨迹目录名
  * @param selfHost 本机机器名（**注入** ⇒ 可测；生产调用方传 `hostname()`）

package/lib/cro/log.d.ts

@@ -22,12 +22,36 @@
  * | 文件 | 谁写 | 主语 | 回答 |
  * |---|---|---|---|
  * | `<轨迹目录>/cro-state.json`（CCC 侧程序自建，名字自定） | **CCC 的 CRO 程序** | 程序 | 「**我判了什么**」（含"没叫"的判定、心跳阈值、环境谓词） |
- * | `<轨迹目录>/cro-wake-log.json`（**本模块**） | **ACC** | ACC | 「**我把什么送出去了、送成没有**」 |
+ * | `<轨迹目录>/cro-wake-log.log`（**本模块**） | **ACC** | ACC | 「**我把什么送出去了、送成没有**」 |
  *
  * **内容不重叠**：本模块**不复制**判定细节（不存 `lastDecision` / 阈值 / 谓词）；
  * 而程序**不可能**知道投递结果（CRO 投递是 fire-and-forget）。
  * ⇒ 两者**互补**：完整审计 = 两者合看（本模块 = 投递面｜程序状态 = 判定面）。
  *
+ * ## 🔴 形态 = 纯文本行，不是 JSON（owner 2026-10-19 裁 Q1）
+ *
+ * owner 原话：「**日志不要写 json，不合适，日志直接写纯文本 `.log` 就行**」。
+ * ⇒ 一行一条，**tab 分隔**（终端里按制表位对齐，`grep` / `cut` / `awk` 直接可用）：
+ *
+ * ```text
+ * # ACC CRO 唤起流水（纯文本 · tab 分隔 · 时间 / 结果 / tick / 方式 / 理由 / 提示词摘要）
+ * 2026-10-19T22:15:03+08:00	ok	tick=82	已投递（live）	reason=心跳：距上次 44m	prompt=17:请先整理你的 SESSION.md
+ * ```
+ *
+ * 🔴 **`#` 开头是注释 / 表头行，解析时跳过** —— 纯文本档案缺了表头，下一个人（或半年后的我）
+ * 打开只看到一堆制表符，那是把 R 推给读者。
+ * 🔴 **坏行跳过而非报错**（与 JSON 版的 `asEntry()` 同口径）：手改 / 半行 / 截断都不得让整档失效。
+ *
+ * ## 🔴 两代并读（**不硬切**，本容器反复栽过的形态）
+ *
+ * 旧名 `cro-wake-log.json` **仍然读**（存量轨迹里可能正有那份）；
+ * **只写新 `.log`**。读侧判据 = **「新档在就只读新档，否则回落旧档」**。
+ *
+ * 🔴 **首次写入 = 迁移，不是覆盖**：那一刻 `loadCroWakeLog` 读到的仍是旧档条目，
+ * 它们与新条目一起过裁剪、一起落进新档 ⇒ **窗内的旧记录不会凭空消失**；
+ * 而旧档此后不再被读（新档已在）⇒ **不会重复计入**，也不需要删除动作。
+ * ⚠️ 这条**只能靠读源码知道**（写出来的档看不出它继承过谁）⇒ 故在此明写。
+ *
  * ## 🔴 轮转（所有者明示「程序化的」）
  *
  * **写入时按窗裁剪**：每次落盘只保留 `at >= now - CRO_LOG_RETENTION_MS` 的条目，
@@ -46,11 +70,21 @@
  * 最坏（某程序每 5min 都叫）⇒ 288 条/天 ⇒ 两天 **≤ ~600 条、< 100 KB** —— 轮转**自带上限**。
  */
 /** 固定文件名（所有者令：「文件名固定即可」）——与程序自建的 `cro-state.json` 并排、主语分明 */
-export declare const CRO_LOG_FILENAME = "cro-wake-log.json";
+export declare const CRO_LOG_FILENAME = "cro-wake-log.log";
+/**
+ * 🔴 **读取族 = 新名在前、旧名在后**（认族，不认"当前叫什么"）。
+ *
+ * 本容器已两次栽在"上游改名、下游写死旧名"：`skiff.json` → `trajectory-constraint.json` 那次，
+ * 症状是「写不进去」，而真因是「文件名对不上」，两者在读数上完全不像。
+ * ⇒ 上游再改名只往族里加一项。
+ */
+export declare const CRO_LOG_LEGACY_FILENAMES: readonly ["cro-wake-log.json"];
 /** 保留窗 = 2 日（所有者令「只保留仅两日」）；**常量** ⇒ 「这个时间是程序化的」 */
 export declare const CRO_LOG_RETENTION_MS: number;
 /** 提示词摘要取前多少字（**只存摘要，不搬第二份全文**——全文属程序那侧的产物） */
 export declare const CRO_PROMPT_HEAD_MAX = 80;
+/** 纯文本档案的表头行（解析时跳过；人打开时先看到它） */
+export declare const CRO_LOG_HEADER = "# ACC CRO \u5524\u8D77\u6D41\u6C34\uFF08\u7EAF\u6587\u672C \u00B7 tab \u5206\u9694 \u00B7 \u65F6\u95F4 / \u7ED3\u679C / tick / \u65B9\u5F0F / \u7406\u7531 / \u63D0\u793A\u8BCD\u6458\u8981\uFF09";
 /** 一条唤起**尝试**（成功与失败**都记**，所有者令 2026-09-20） */
 export interface CroWakeLogEntry {
     /** 时刻（当地 RFC3339 带偏移，遵 D67） */
@@ -69,7 +103,7 @@ export interface CroWakeLogEntry {
         head: string;
     };
 }
-/** 文件形态（与 `wake-registry.json` 同款：`{version, entries}`） */
+/** 内存形态（**不再落盘**；读取器与裁剪器都吃它 ⇒ 换载体不改上层契约） */
 export interface CroWakeLog {
     version: number;
     entries: CroWakeLogEntry[];
@@ -83,8 +117,20 @@ export interface CroWakeLogInput {
     /** 唤起提示词原文（本模块只留摘要） */
     prompt?: string;
 }
-/** 日志绝对路径 */
+/** 日志绝对路径（**写入目标** = 新名） */
 export declare function croWakeLogPath(root: string, dirName: string): string;
+/** 旧档绝对路径（**只读**，用于两代并读） */
+export declare function croWakeLogLegacyPath(root: string, dirName: string, filename: string): string;
+/** 一条记录 → 纯文本行（tab 分隔、字段带前缀便于人读） */
+export declare function formatCroLogLine(entry: CroWakeLogEntry): string;
+/**
+ * 纯文本行 → 记录（**坏行返回 null 而不是抛**）。
+ *
+ * 判据：字段数不足 / 时间不可解析 / `ok` 标记不认识 ⇒ `null`（跳过该行，其余照读）。
+ * 🔴 `at` 必须**可被 `Date.parse` 解析**才收 —— 那是裁剪的前提，
+ * 收一条解析不了的时间等于让它在此档里永久驻留（轮转对它失效）。
+ */
+export declare function parseCroLogLine(line: string): CroWakeLogEntry | null;
 /** 提示词摘要（长度 + 前 N 字；超长不截断标记——长度字段本身就是信号） */
 export declare function summarizeCroPrompt(prompt: string | undefined): {
     length: number;
@@ -92,6 +138,10 @@ export declare function summarizeCroPrompt(prompt: string | undefined): {
 };
 /**
  * 读取日志（**永不抛**；读坏 ⇒ 当作空档 + 返回 error 文本）。
+ *
+ * 🔴 **两代并读的判据**：新档在 ⇒ **只读新档**；否则按族回落旧档。
+ * 这样首次写入之后旧档自然退场，**不需要删除动作、也不会重复计入**。
+ *
  * @param root CCC 根
  * @param dirName 轨迹目录名
  */