@shgroup/dsh-serenity-hooks 1.80.0 → 1.82.0

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.80.0",
+  "version": "1.82.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.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": {

package/lib/{ccc-roots-DYJvlQhc.js → ccc-roots-4LwGLCXa.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-DmWw2M0q.js").then((n) => n.i);
+		const { listTrajectoryConstraints } = await import("./profile-CiRWh2a2.js").then((n) => n.i);
 		rolesOf = (root) => {
 			try {
 				return listTrajectoryConstraints(root).map((p) => p.code);

package/lib/im/guard.d.ts

@@ -51,13 +51,35 @@ export declare function noteManualOutputSession(sessionId: string, session: Manu
 export declare function forgetManualOutputSession(sessionId: string): void;
 /** 是否手动模式会话（测试/诊断用） */
 export declare function isManualOutputSession(sessionId: string): boolean;
-/** 本轮是否已成功发送（测试/诊断用；桥在每轮结束时读它决定是否兜底） */
-export declare function hasSentThisTurn(sessionId: string): boolean;
 /**
- * 桥：**每轮开始时**清空本会话的"已发送"标记（turn 边界由桥掌握——v1.30.17）。
- * 闸门侧不再于 turn-stopping 结算清空，否则桥读不到本轮结果、无法兜底。
+ * 本轮是否已成功发送。
+ *
+ * @param turn 期望的轮号（`agent/turn-stopping` 的 `payload.turn`）。
+ *   - **省略** ⇒ 旧语义："这个会话发过就算"（测试与桥的兜底判定用）。
+ *   - **给了** ⇒ 按轮比：只有"**这一轮**发的"才算。
+ *   - **任一侧取不到轮号**（记录是 `null`，或 `turn` 传了 `null`）⇒ **偏向"发过"**。
+ *     🔴 方向是刻意的：误判"没发"的代价 = 打回 + 重复回答（用户看到两轮，本缺陷本尊）；
+ *     误判"发过"的代价 = 少打回一次（用户可能真没收到一条）。前者已经发生过、后者尚未。
+ */
+export declare function hasSentThisTurn(sessionId: string, turn?: number | null): boolean;
+/**
+ * 🔴 **桥不再调用本函数**（2026-10-21）。
+ *
+ * 旧语义 `clearSentThisTurn(sessionId)` = "来了新消息就当这个会话没发过"，
+ * 它**连正在跑那一轮的证据一起抹掉** —— 这正是"同一条消息被处理两轮"的根因：
+ * `12:08:25 发送成功 → 12:08:56 新入站(抹) → 12:09:19 那一轮 turn-stopping 判"没发" ⇒ 打回`。
+ *
+ * ## 现在的分工（判据只有一处：轮号）
+ *
+ * - **置位**：`tools/post-execute` 发送成功 ⇒ 记下**当前轮号**（`currentTurnOf`）。
+ * - **判定**：`agent/turn-stopping` 拿 `payload.turn` 与记录比对（`hasSentThisTurn`）。
+ * - **陈旧**：靠"轮号不等"自然淘汰 —— 上一轮发的记录，在下一轮 stopping 时天然不匹配。
+ *   ⇒ **不再需要任何"清空"动作**，也就不存在"清错人的记录"这件事。
+ *
+ * 本函数只留给**测试与显式重置**（如切换手动/自动模式）。`turn` 给定时按轮清，
+ * 是给诊断用的窄口子，生产路径不调用。
  */
-export declare function clearSentThisTurn(sessionId: string): void;
+export declare function clearSentThisTurn(sessionId: string, turn?: number | null): void;
 /** 闸门是否装配成功（未装配 → 桥不做兜底：宁可静默也不冒重复发送的风险） */
 export declare function isWeixinOutputGuardActive(): boolean;
 /**

package/lib/im/inbound-event.d.ts

@@ -124,6 +124,11 @@ export declare function resolveInboundTarget(ctx: Context, input: {
         trajectory: string;
     } | null;
 }): Promise<ResolvedInboundTarget | null>;
+declare function acquireSessionLock(key: string): Promise<() => void>;
+/** 测试/诊断用：当前有几条会话仍持有锁位（0 = 全部释放） */
+export declare function __sessionLockCountForTest(): number;
+/** 测试专用：直接拿真锁（不复制实现 —— 实现换形状时本导出会先炸，不会静默失效） */
+export declare const __acquireSessionLockForTest: typeof acquireSessionLock;
 /**
  * **一条入站消息的主流程**（通道中立）。
  *
@@ -165,3 +170,4 @@ export declare function manualOutputFallbackNeeded(input: {
     sentThisTurn: boolean;
     answer: string;
 }): boolean;
+export {};

package/lib/index.js

@@ -1,12 +1,12 @@
 import { i as __toESM, n as __exportAll } from "./rolldown-runtime-B4iAMlE-.js";
-import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-DYJvlQhc.js";
+import { c as hostInjected, d as hostSessions, f as hostSettings, h as hostWebServer, i as cccRootForExec, l as hostLlm, m as hostWeb, n as agentCwdFor, o as listCccs, p as hostSubagents, r as cccRootForCwd, s as hostAgents, t as NO_CCC_FROM_AGENT_CWD, u as hostService } from "./ccc-roots-4LwGLCXa.js";
 import { _ as resolveInside, a as findSerenityRoot$1, c as matchBlacklist, d as readCccName$1, f as readCheapWorkerConfig, h as readSafeModeHiddenTools, i as findGitRoot, l as pathInside, m as readExclusiveTools, n as SAFE_MODE_MARKER, o as isSafeModeOn, r as classifyPath, s as loadSerenityConfig, t as DEFAULT_SERENITY_CONFIG_PATHS, u as readBlacklist } from "./ccc-CyYJL4F2.js";
-import { A as sessionEvents, B as isoLocal, C as listSessions, E as parseTrajectoryCode, F as trajectoryDescOf, H as localHuman, I as useSession, L as TRAJECTORY_FILENAME, M as setActiveSessionInfo, N as showSession, O as readTrajectoryUid, P as summarize, R as TRAJECTORY_LEGACY_FILENAMES, S as listActiveTrajectories, T as parseSessionContextFromEvents, U as localIdStamp, V as localFileStamp, _ as createSession, a as readTrajectoryConstraintAt, b as getActiveSessionInfo, c as trajectoryConstraintForSession, f as COGNITIVE_TRAJECTORY_ACTIONS, g as clearActiveSessionInfo, h as archiveSession, j as sessionsRoot, k as resolveSessionByTitle, m as UID_FILENAME, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, r as listTrajectoryConstraints, s as replacesDefaultIdentity, t as TRAJECTORY_CONSTRAINT_FILENAME, v as extractSessionMdPathFromText, w as namingTitleFor, y as findSession, z as readTrajectoryFile } from "./profile-DmWw2M0q.js";
+import { A as sessionEvents, B as isoLocal, C as listSessions, E as parseTrajectoryCode, F as trajectoryDescOf, H as localHuman, I as useSession, L as TRAJECTORY_FILENAME, M as setActiveSessionInfo, N as showSession, O as readTrajectoryUid, P as summarize, R as TRAJECTORY_LEGACY_FILENAMES, S as listActiveTrajectories, T as parseSessionContextFromEvents, U as localIdStamp, V as localFileStamp, _ as createSession, a as readTrajectoryConstraintAt, b as getActiveSessionInfo, c as trajectoryConstraintForSession, f as COGNITIVE_TRAJECTORY_ACTIONS, g as clearActiveSessionInfo, h as archiveSession, j as sessionsRoot, k as resolveSessionByTitle, m as UID_FILENAME, n as isTrajectoryConstrained, o as readTrajectoryConstraintByCode, r as listTrajectoryConstraints, s as replacesDefaultIdentity, t as TRAJECTORY_CONSTRAINT_FILENAME, v as extractSessionMdPathFromText, w as namingTitleFor, y as findSession, z as readTrajectoryFile } from "./profile-CiRWh2a2.js";
 import { n as checkLocalstoreGitCompliance, o as readStore, s as runLocalStore, t as LOCALSTORE_SCOPES } from "./service-DDmHSglV.js";
-import { _ as ACC_VERSION, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as resolveConstraintSystemPrompt, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as findPackageRoot } from "./message-source-BYO-FyFP.js";
-import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-sV-kc1gQ.js";
+import { _ as resolveConstraintSystemPrompt, a as listBoundSessionIds, d as constraintCognitiveTrajectory, f as constraintSystemPromptSource, g as profileWriteWhitelist, h as profileToolWhitelist, i as carrierState, l as TRAJECTORY_CONSTRAINT_HINT, n as PLUGIN_SOURCE, o as readLastBound, r as appendBound, s as resolveSessionCognitiveTrajectoryLabel, t as ACC_MESSAGE_KIND, v as ACC_VERSION, y as findPackageRoot } from "./message-source-CfqdGIi2.js";
+import { A as buildResourceIndex, C as verifyPassword, D as recordToolUsage, E as verifyTotpCode, F as hasTrajectoryPrompt, M as isSafeSkillName, N as truncateContent, O as REFERENCE_DIR, P as TRAJECTORY_PROMPT_FILENAME, S as toWire, T as MECHANISM_PORTS, _ as registerEntrySkillSectionGlobal, a as trajectoryConstraintFor, b as projectKnownWorkspaces, c as trajectoryWorkspaceMdPath, d as CHEAP_WORKER_GUIDE, f as providerAvailabilityError, g as registerEntrySkillSection, h as registerCognitiveTrajectorySkillSection, i as getTrajectoryAgent, j as buildResourceNameSuffix, k as SKILL_ONTOLOGY_FILE, l as unregisterTrajectorySession, m as splitModel, n as createTrajectoryAgent, o as trajectoryConstraintMsmGate, p as requireWhitelistedModel, r as ensureWorkspacePromptSection, s as trajectoryConstraintParticipates, t as askTrajectory, u as workspaceCognitiveTrajectoryLine, v as applyWirePatch, w as FACE_PORTS, x as readAdvancedSettings, y as migrateLegacyLocalstore } from "./session-BF4C3hJL.js";
 import { n as hasSessionLogById, r as sessionsRootDir } from "./cleanup-C-92qnDs.js";
-import { n as readSimpleSettings, r as registerSettingsSection } from "./settings-DdYLVK3O.js";
+import { n as readSimpleSettings, r as registerSettingsSection } from "./settings-Dj4_ppTC.js";
 import { REGISTERED_TOOLS } from "./invariant.js";
 import { a as readFeishuCredential, d as weixinSessionIdForTrajectory, i as matchWeixinRoute, l as sanitizeFileName$1, n as extractWeixinText, o as readWeixinCredential, r as hasVoiceItem, s as readWeixinSettings, t as extractWeixinMedia, u as weixinInboundDir } from "./route-Dr0SFD8A.js";
 import { c as sendTextMessage, i as getUpdates, l as sendTyping, n as downloadMedia, o as markdownToPlainText, r as getConfig, s as sendFileMessage, t as TypingStatus, u as sniffImageExt } from "./ilink-BMk2w2KY.js";
@@ -10727,6 +10727,7 @@ becomes a 轨迹约束; delete it and it goes back to being an ordinary trajecto
     "model": "provider/model",          // optional; **不写 = 用会话当前模型**（不回退 cheap-worker；每轮生效）
     "tools": ["read","grep","msm",...], // optional; **不写 = 不收窄**。显式 [] = 全隐藏（除 skill）
     "msms":  ["msm-a","msm-b"],         // optional; **不写 = 不收窄**。register/deregister 恒拒
+    "writes": ["AGENT_SESSIONS/<我的目录>/"], // optional; **不写 = 不收窄**。显式 [] = 一个写都落不下
     "cognitiveTrajectory": { "session": true, "keeper": true, "rebuild": true },  // 缺省 TRUE（见下）
     "resident": { "serves": "..." },    // optional; 对外用途自述（见 trajectory-self 章）
     "cro": { "host": "<machine name>" } // optional: which machine may run this trajectory's CRO program
@@ -10752,6 +10753,20 @@ becomes a 轨迹约束; delete it and it goes back to being an ordinary trajecto
   🔴 判据是**字段在不在**，不是**数组空不空**（D181）。旧版把两者混成"空 = 全拒"，
      于是「只想声明常驻」的人被静默锁死 —— 那是本仓实测踩过的坑（D179(b)）。
 
+── \`writes\`: the THIRD whitelist — the PATH dimension（owner 2026-10-20 令）──
+  \`tools\` 管的是**工具名**，管不了"这个工具能写哪儿"：给了 \`write\` 之后，路径守卫只拦
+  「逃出 CCC」与黑名单，**拦不住它去写别人的轨迹或 docs/**。\`writes\` 补的正是这一维。
+
+  - **不写** ⇒ 不收窄（写权限 = 路径守卫那几条，与之前完全一致）
+  - \`"writes": []\` ⇒ **一个写都落不下**（显式意图；只影响写，不影响读）
+  - \`"writes": ["AGENT_SESSIONS/<我的目录>/", "_tmp/"]\` ⇒ 写类工具的**目标路径**必须落在这些前缀内
+  - 条目可以是**相对 CCC 根**的路径，也可以是绝对路径；判定按"目标在这个目录之内（含自身）"
+  - 只管**写类**工具（\`write\` / \`edit\` / \`container_fs\` 的写动作 / \`append\` / \`touch\`），**读不受影响**
+  - 越界拒绝时**会指名允许的前缀与当前目标**（D186：不许不出声；出声必须指对路）
+
+  ⇒ 典型用法（两条 IM 轨迹）：给 \`write\`/\`edit\` 写自己的身体，同时把写面收窄到自己那一格：
+     \`"tools": ["read","write","edit",...], "writes": ["AGENT_SESSIONS/<code 目录>/"]\`
+
 ── cognitiveTrajectory: why the defaults are TRUE ──
   The workspace of a 轨迹约束 is its own SESSION.md. Setting these to false would cut it off from
   its own body, so \`session\`/\`keeper\`/\`rebuild\` all default to true. Set false explicitly only
@@ -10792,6 +10807,11 @@ function validateTrajectoryConstraint(root) {
 			}
 		})())) issues.push(`trajectory "${p.code}": no trajectory prompt (add ${TRAJECTORY_PROMPT_FILENAME} in the trajectory dir — recommended — or the legacy systemPromptFile/systemPrompt)`);
 		for (const m of p.msms ?? []) if (!registered.has(m)) issues.push(`trajectory "${p.code}": msms "${m}" is not registered in mech-registry.json`);
+		for (const w of p.writes ?? []) try {
+			resolveInside(root, w);
+		} catch (err) {
+			issues.push(`trajectory "${p.code}": writes "${w}" is outside the CCC root (${String(err?.message ?? err)}) — a write prefix outside the container can never match; use a path relative to the CCC root`);
+		}
 		if (p.model && allowedModels && !allowedModels.has(p.model)) issues.push(`trajectory "${p.code}": model "${p.model}" not in cheap-worker.models (${[...allowedModels].join(", ") || "(none)"})`);
 	}
 	return {
@@ -10824,6 +10844,7 @@ function listTrajectoryConstraintSummary(root) {
 			model: p.model ?? "(unchanged)",
 			msms: wl(p.msms, "(unrestricted)"),
 			tools: wl(p.tools, "(unrestricted)"),
+			writes: wl(p.writes, "(unrestricted)"),
 			...p.resident !== void 0 ? { resident: p.resident.serves !== void 0 ? p.resident.serves : "(no serves)" } : {},
 			cognitiveTrajectory: constraintCognitiveTrajectory(p),
 			promptSource: constraintSystemPromptSource(p, hasTrajectoryPrompt(root, p.dirName)),
@@ -10955,6 +10976,7 @@ const TRAJECTORY_SELF_GUIDE = [
   | \`model\` | 用会话当前的模型（**不会**回退到 cheap-worker） | **每轮**（改文件下一轮即生效） |
   | \`tools\` | **不收窄**工具面 | 每轮 |
   | \`msms\` | **不收窄** MSM 面 | 每轮 |
+  | \`writes\` | **不收窄**写路径（写权限 = 路径守卫那几条） | 每轮 |
   | \`resident\` | 不出现在常驻名单里（不参与"被找"） | 每轮 |
   | \`cognitiveTrajectory\` | 三项纪律全参与（true） | 每轮 |
   | \`systemPromptFile\` / \`systemPrompt\` | 用 ACC 的通用身份（**不替换**） | 保存即生效 |
@@ -10980,7 +11002,7 @@ const TRAJECTORY_SELF_GUIDE = [
   章程生效了吗    改 PROMPT.md 后**在同一会话里**看下一轮的系统提示词段是否变化（保存即生效）
   注入模式生效了吗 改 trajectory.json 的 prompt 段后，**同一会话下一轮**：replace 下四块消失、
                   我的章程紧跟身份块；⛔ 不需要重启（这两者都是每轮现读）
-  我声明了什么    container_admin config list  —— 逐轨迹列出 model/tools/msms 的**生效值**；
+  我声明了什么    container_admin config list  —— 逐轨迹列出 model/tools/msms/writes 的**生效值**；
                   没写的字段印 \`(unchanged)\` / \`(unrestricted)\`，不是伪装成某个默认值
   配置合法吗      container_admin config validate  —— msms 均已注册 / model 在可用表里
   常驻被看见了吗  cognitive_trajectory action=resident —— 我出现在名单里，且 serves 可读
@@ -11565,6 +11587,14 @@ function decideGuard(input) {
 			deny: "tool not allowed in this 轨迹约束 trajectory",
 			kind: "deny"
 		};
+		const writeScopes = profileWriteWhitelist(profile);
+		if (writeScopes !== null && pathArg !== void 0 && isWriteTool(toolName, action)) {
+			const abs = resolve(root, pathArg);
+			if (!writeScopes.some((scope) => pathInside(resolve(root, scope), abs))) return {
+				deny: `${toolName}: write outside this trajectory's declared write scope (allowed: ${writeScopes.length > 0 ? writeScopes.join(" / ") : "(none — \"writes\" is an empty array)"}); target: ${pathArg} — add the prefix to this trajectory's trajectory.json "writes" if the write is intended`,
+				kind: "deny"
+			};
+		}
 	}
 	if (safeModeOn && toolName === "bash") return {
 		deny: `bash: no such tool`,
@@ -14118,7 +14148,7 @@ function registerStatusApi(ctx, opts = {}) {
 						});
 					}
 					const { saveWeixinRoutes } = await import("./route-Dr0SFD8A.js").then((n) => n.c);
-					const { findDirNameByCode } = await import("./profile-DmWw2M0q.js").then((n) => n.i);
+					const { findDirNameByCode } = await import("./profile-CiRWh2a2.js").then((n) => n.i);
 					for (const r of routes) if (findDirNameByCode(root, r.trajectory) === null) {
 						sendJson$2(res, 400, { error: `unknown trajectory: ${r.trajectory} (no such trajectory code in ${root})` });
 						return;
@@ -18967,10 +18997,23 @@ function installWeixinAccountImpl(d) {
 }
 const manualSessions = /* @__PURE__ */ new Map();
 /**
-* 本轮是否已成功发送（**由桥在每轮开始时清空** `clearSentThisTurn`；闸门只置位不清空——
-* v1.30.17 起桥要在 `askTrajectory` 返回后读它决定是否兜底，故 turn-stopping 不再结算清空）。
+* 「已发送」记账 —— 值是**发送发生时的轮号**（`null` = 取不到轮号，退化为旧语义）。
+*
+* ## 🔴 为什么必须是「轮号」而不是一个布尔（2026-10-21 实测缺陷）
+*
+* 旧形态是 `Set<sessionId>`：桥在**每条入站一到达**就 `clearSentThisTurn()`（`inbound-event.ts`），
+* 而闸门只在 `tools/post-execute` 置位、`turn-stopping` 只读。
+* ⇒ **一个还在跑的轮，它"我已经发了"的证据会被后到的那条入站抹掉。**
+*
+* 现场时刻线（真机，12:08~12:10）：`12:08:25` 发送成功 → `12:08:56` 新入站（抹）→
+* `12:09:19` 那一轮的 `turn-stopping` 读空 ⇒ 判"没发" ⇒ 打回 ⇒ 模型重答。
+* 用户看到的就是"同一条消息被处理了两轮"。
+*
+* ⇒ 记**轮号**之后：抹除操作可以问"我要抹的这一发，是不是**当前这一轮**发的"；
+*   `turn-stopping` 也可以问"这一发是不是**我这一轮**发的"。两处都从"是不是同一轮"出发，
+*   而不是从"这个会话有没有发过"出发。
 */
-const sentThisTurn = /* @__PURE__ */ new Set();
+const sentTurn = /* @__PURE__ */ new Map();
 /** 连续打回计数（成功发送即清零） */
 const rebukeCounts = /* @__PURE__ */ new Map();
 /** 闸门是否装配成功（v1.30.17：桥据此判断能否信任"未发送"这一判定——未装配时不兜底，防重复发送） */
@@ -18983,19 +19026,25 @@ function noteManualOutputSession(sessionId, session) {
 /** 桥：非手动模式 / 会话失效 → 注销（闸门随之失效，零干预） */
 function forgetManualOutputSession(sessionId) {
 	manualSessions.delete(sessionId);
-	sentThisTurn.delete(sessionId);
+	sentTurn.delete(sessionId);
 	rebukeCounts.delete(sessionId);
 }
-/** 本轮是否已成功发送（测试/诊断用；桥在每轮结束时读它决定是否兜底） */
-function hasSentThisTurn(sessionId) {
-	return sentThisTurn.has(sessionId);
-}
 /**
-* 桥：**每轮开始时**清空本会话的"已发送"标记（turn 边界由桥掌握——v1.30.17）。
-* 闸门侧不再于 turn-stopping 结算清空，否则桥读不到本轮结果、无法兜底。
+* 本轮是否已成功发送。
+*
+* @param turn 期望的轮号（`agent/turn-stopping` 的 `payload.turn`）。
+*   - **省略** ⇒ 旧语义："这个会话发过就算"（测试与桥的兜底判定用）。
+*   - **给了** ⇒ 按轮比：只有"**这一轮**发的"才算。
+*   - **任一侧取不到轮号**（记录是 `null`，或 `turn` 传了 `null`）⇒ **偏向"发过"**。
+*     🔴 方向是刻意的：误判"没发"的代价 = 打回 + 重复回答（用户看到两轮，本缺陷本尊）；
+*     误判"发过"的代价 = 少打回一次（用户可能真没收到一条）。前者已经发生过、后者尚未。
 */
-function clearSentThisTurn(sessionId) {
-	sentThisTurn.delete(sessionId);
+function hasSentThisTurn(sessionId, turn) {
+	if (!sentTurn.has(sessionId)) return false;
+	if (turn === void 0) return true;
+	const recorded = sentTurn.get(sessionId) ?? null;
+	if (recorded === null || turn === null) return true;
+	return recorded === turn;
 }
 /** 闸门是否装配成功（未装配 → 桥不做兜底：宁可静默也不冒重复发送的风险） */
 function isWeixinOutputGuardActive() {
@@ -19045,6 +19094,29 @@ function buildManualOutputRebuke(session) {
 	].join("\n");
 }
 /**
+* 从 `tools/post-execute` / 会话事件里取**当前轮号**（取不到 ⇒ `null`）。
+*
+* 为什么要费这个劲：修"同一条消息处理两轮"的判据是「这一发是不是**我这一轮**发的」，
+* 而 `tools/post-execute` 的 `exec` 上**不一定**带 turn（宿主形状随版本变）。
+* ⇒ 三级兜底：① `exec.turn` ② `agent.session` 的最后一个 `turn/start` ③ `null`（退化为旧语义）。
+* ⛔ `null` 时**绝不**当成"发过了/没发过"的强判据 —— 见 `hasSentThisTurn` 的降级说明。
+*/
+function currentTurnOf(exec, agent) {
+	const direct = exec?.turn;
+	if (typeof direct === "number" && Number.isFinite(direct)) return direct;
+	const events = agent?.session;
+	const list = typeof events?.snapshotEvents === "function" ? events.snapshotEvents() : events?.events;
+	if (!Array.isArray(list)) return null;
+	for (let i = list.length - 1; i >= 0; i--) {
+		const e = list[i];
+		if (e?.type === "turn/start") {
+			const t = e.data?.turn;
+			return typeof t === "number" && Number.isFinite(t) ? t : null;
+		}
+	}
+	return null;
+}
+/**
 * 装配闸门（index.ts apply 调用）。
 * 只对**已登记的手动模式会话**生效——其他会话（主舱/其他 轨迹约束会话）零干预。
 */
@@ -19056,7 +19128,7 @@ function registerWeixinOutputGuard(ctx) {
 				const sessionId = sessionIdOf$1(exec?.agent);
 				if (sessionId && manualSessions.has(sessionId)) {
 					if (isSuccessfulImSend(exec, result, manualSessions.get(sessionId)?.channel ?? "weixin")) {
-						sentThisTurn.add(sessionId);
+						sentTurn.set(sessionId, currentTurnOf(exec, exec.agent));
 						rebukeCounts.delete(sessionId);
 					}
 				}
@@ -19075,7 +19147,7 @@ function registerWeixinOutputGuard(ctx) {
 			if (!sessionId) return;
 			const session = manualSessions.get(sessionId);
 			if (!session) return;
-			if (sentThisTurn.has(sessionId)) return;
+			if (hasSentThisTurn(sessionId, payload?.turn ?? null)) return;
 			const count = (rebukeCounts.get(sessionId) ?? 0) + 1;
 			if (count > 2) {
 				rebukeCounts.delete(sessionId);
@@ -19115,7 +19187,7 @@ const MEDIA_MAX_BYTES = 20971520;
 */
 async function resolveCccRootByAlias(ctx, alias) {
 	try {
-		const { listCccs } = await import("./ccc-roots-DYJvlQhc.js").then((n) => n.a);
+		const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
 		const entries = await listCccs(ctx);
 		const byName = entries.find((e) => e.name === alias);
 		if (byName) return byName.root;
@@ -19183,7 +19255,7 @@ async function resolveInboundTarget(ctx, input) {
 		});
 		return null;
 	}
-	const { findDirNameByCode } = await import("./profile-DmWw2M0q.js").then((n) => n.i);
+	const { findDirNameByCode } = await import("./profile-CiRWh2a2.js").then((n) => n.i);
 	if (findDirNameByCode(root, target.role) === null) {
 		const detail = `目标 CCC "${target.ccc}" 内没有编码为 "${target.role}" 的认知轨迹`;
 		console.error(`[serenity-hooks] ✗ human-channel: ${detail}（account=${input.account} user=${input.user}）—— 该消息**未投递**，请改订阅表里的目标编码`);
@@ -19205,6 +19277,41 @@ async function resolveInboundTarget(ctx, input) {
 	};
 }
 /**
+* 同会话入站**串行化**（2026-10-21，修"同一条消息被处理两轮"的第二个缺陷）。
+*
+* ## 为什么必须有锁（R↓，代价换来的）
+*
+* `askTrajectory` 的成功判据是"`assistant/message` **条数增长**"。两条入站并发时，
+* 后一条的快照包含前一条尚未落盘的产出 ⇒ **前一轮的产出会满足后一条的成功判据**
+* ⇒ 兜底 / `reply-fallback` 可能拿到**错轮**的答案（真机实测：把内部过程话发给了家人）。
+*
+* ## 粒度与边界
+*
+* - 按**会话 id**加锁：不同轨迹（各 IM 账号）各跑各的，互不拖慢。
+* - ⚠️ 与投递侧"不排队"**不是一回事**：`send-now` 的"当场注入"是**投递**语义，
+*   这里排的是**处理**语义 —— 同一会话不该同时开两轮。两者不冲突。
+* - 用 acquire/release 而不是 callback 形态：主流程已在 `try/catch/finally` 里，
+*   callback 会把整段重新缩进，diff 看不清"到底改了什么"。
+*/
+const sessionLocks = /* @__PURE__ */ new Map();
+async function acquireSessionLock(key) {
+	const prev = sessionLocks.get(key) ?? Promise.resolve();
+	let release = () => {};
+	const held = new Promise((resolve) => {
+		release = resolve;
+	});
+	const mine = prev.catch(() => void 0).then(() => held);
+	sessionLocks.set(key, mine);
+	await prev.catch(() => void 0);
+	let released = false;
+	return () => {
+		if (released) return;
+		released = true;
+		if (sessionLocks.get(key) === mine) sessionLocks.delete(key);
+		release();
+	};
+}
+/**
 * **一条入站消息的主流程**（通道中立）。
 *
 * 职责：路由 → 固定会话 id 创建/延续 → 提问 → 回复（或被闸门拦下后兜底）。
@@ -19258,8 +19365,21 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 		}).catch(() => {});
 		return;
 	}
+	let releaseLock = null;
 	try {
 		const sessionId = weixinSessionIdForTrajectory(trajectory);
+		/**
+		* 🔴 **同会话串行化**（2026-10-21，修"同一条消息被处理两轮"的第二个缺陷）。
+		*
+		* `askTrajectory` 的成功判据是"`assistant/message` **条数增长**"。两条入站并发时，
+		* 后一条的快照包含前一条尚未落盘的产出 ⇒ **前一轮的产出会满足后一条的成功判据**
+		* ⇒ 兜底/`reply-fallback` 可能拿到**错轮**的答案（真机实测：把内部过程话发给了家人）。
+		*
+		* 锁的粒度 = **一个会话同一时刻只跑一条入站**（不同轨迹各跑各的，互不拖慢）。
+		* ⚠️ 与投递侧"不排队"不是一回事：`send-now` 的"当场注入"是**投递**语义，
+		* 这里排的是**处理**语义 —— 两者不冲突。
+		*/
+		releaseLock = await acquireSessionLock(sessionId);
 		const existing = getTrajectoryAgent(sessionId);
 		const hc = readCheapWorkerConfig(root);
 		const ref = existing ? {
@@ -19339,7 +19459,18 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 			if (text) parts.push(text);
 			parts.push(...mediaNotes, ...degradedNotes);
 			if (manualOutput) {
-				clearSentThisTurn(sessionId);
+				/**
+				* 🔴 **不在这里清空"已发送"标记**（2026-10-21 修"同一条消息被处理两轮"）。
+				*
+				* 旧写法 `clearSentThisTurn(sessionId)` 的语义是"来了新消息就当这个会话没发过"——
+				* 而它**连正在跑那一轮的证据一起抹掉**：真机时刻线
+				* `12:08:25 发送成功 → 12:08:56 新入站(抹) → 12:09:19 那一轮 turn-stopping 判"没发" ⇒ 打回`
+				* ⇒ 用户看到的就是"同一条消息被处理了两轮"。
+				*
+				* 现在**没有任何清空动作**：标记记的是**轮号**，上一轮发的记录在下一轮 `turn-stopping`
+				* 时天然不匹配（`hasSentThisTurn` 按轮比）⇒ 陈旧记录靠"轮号不等"淘汰，
+				* 不靠"谁来抹掉"。清空动作本身就是误伤面。
+				*/
 				noteManualOutputSession(sessionId, {
 					root,
 					accountId,
@@ -19415,6 +19546,8 @@ async function handleInboundEvent(ctx, root, accountId, io, event, preset) {
 		console.log(`[serenity-hooks] im-bridge error (ccc=${root}): ${msg}`);
 		const stack = err instanceof Error ? err.stack : void 0;
 		if (stack) console.log(`[serenity-hooks] im-bridge stack:\n${stack.slice(0, 1500)}`);
+	} finally {
+		releaseLock?.();
 	}
 }
 /**
@@ -20023,7 +20156,7 @@ function syncHumanChannel(ctx) {
 	(async () => {
 		try {
 			stopMachineLoops();
-			const { listCccs } = await import("./ccc-roots-DYJvlQhc.js").then((n) => n.a);
+			const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
 			for (const entry of await listCccs(ctx)) syncCccBridge(ctx, entry.root);
 		} catch {}
 	})();
@@ -20287,7 +20420,7 @@ function matchCcc(input, candidates) {
 }
 /** 组装候选列表（`ccc-roots.listCccs` 投影 + `.serenity` 名；动态 import 保持本模块静态依赖轻量） */
 async function collectCandidates(ctx) {
-	const { listCccs } = await import("./ccc-roots-DYJvlQhc.js").then((n) => n.a);
+	const { listCccs } = await import("./ccc-roots-4LwGLCXa.js").then((n) => n.a);
 	const entries = await listCccs(ctx, { defaultRoot: process.cwd() });
 	const seen = /* @__PURE__ */ new Set();
 	const out = [];

package/lib/{message-source-BYO-FyFP.js → message-source-CfqdGIi2.js}

@@ -1,6 +1,6 @@
-import { r as cccRootForCwd } from "./ccc-roots-DYJvlQhc.js";
+import { r as cccRootForCwd } from "./ccc-roots-4LwGLCXa.js";
 import { _ as resolveInside, g as readUtf8 } from "./ccc-CyYJL4F2.js";
-import { A as sessionEvents, E as parseTrajectoryCode, b as getActiveSessionInfo, j as sessionsRoot, x as getLastActiveSessionInfo } from "./profile-DmWw2M0q.js";
+import { A as sessionEvents, E as parseTrajectoryCode, b as getActiveSessionInfo, j as sessionsRoot, x as getLastActiveSessionInfo } from "./profile-CiRWh2a2.js";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -105,6 +105,28 @@ function profileToolWhitelist(profile) {
 function profileMsmWhitelist(profile) {
 	return new Set(profile?.msms ?? []);
 }
+/**
+* 该轨迹可**写**的路径前缀（owner 2026-10-20 令：「轨迹设定自己的写白名单」）。
+*
+* 🔴 与 `profileToolWhitelist` 共用同一条判据（D181/D183）：**字段在不在，不是数组空不空**。
+*
+* | `writes` | 返回 | 语义 |
+* |---|---|---|
+* | 缺省 | **`null`** | 不收窄（写权限 = 路径守卫那几条，与今天一致） |
+* | `[]` | `[]`（空数组） | **一个写都落不下**（显式意图） |
+* | `['a/']` | `['a/']` | 写目标必须落在 `a/` 之内 |
+*
+* ⛔ **调用方不许把 `null` 当 `[]`** —— 那会把"我没想到这件事"读成"我不许写任何东西"，
+* 正是 S196 被静默锁死的形态（D179(b)）。
+*
+* ⚠️ 返回的是**原始条目**（相对 CCC 根或绝对路径都可），解析成绝对路径由调用方按自己的 root 做 ——
+* 本模块不持有 root（判据在 `seams/guards.ts`）。
+*/
+function profileWriteWhitelist(profile) {
+	if (!profile) return null;
+	if (profile.writes === void 0) return null;
+	return profile.writes;
+}
 /** 轨迹纪律参与项（`profile` 缺省已在 `readTrajectoryConstraintAt` 归一为全 true） */
 function constraintCognitiveTrajectory(profile) {
 	return {
@@ -799,4 +821,4 @@ const ACC_MESSAGE_KIND = "plugin:dsh-serenity-hooks";
 /** ACC 注入消息的统一来源值（各缝共用；需要 `form` 时按 `ContextFormed` 另加字段）。 */
 const PLUGIN_SOURCE = { kind: ACC_MESSAGE_KIND };
 //#endregion
-export { ACC_VERSION as _, listBoundSessionIds as a, setBindingStore as c, constraintCognitiveTrajectory as d, constraintSystemPromptSource as f, resolveConstraintSystemPrompt as g, profileToolWhitelist as h, carrierState as i, TRAJECTORY_CONSTRAINT_HINT as l, profileMsmWhitelist as m, PLUGIN_SOURCE as n, readLastBound as o, createProfilePromptReader as p, appendBound as r, resolveSessionCognitiveTrajectoryLabel as s, ACC_MESSAGE_KIND as t, buildTrajectoryBasePrompt as u, findPackageRoot as v };
+export { resolveConstraintSystemPrompt as _, listBoundSessionIds as a, setBindingStore as c, constraintCognitiveTrajectory as d, constraintSystemPromptSource as f, profileWriteWhitelist as g, profileToolWhitelist as h, carrierState as i, TRAJECTORY_CONSTRAINT_HINT as l, profileMsmWhitelist as m, PLUGIN_SOURCE as n, readLastBound as o, createProfilePromptReader as p, appendBound as r, resolveSessionCognitiveTrajectoryLabel as s, ACC_MESSAGE_KIND as t, buildTrajectoryBasePrompt as u, ACC_VERSION as v, findPackageRoot as y };

package/lib/{profile-DmWw2M0q.js → profile-CiRWh2a2.js}

@@ -1078,6 +1078,7 @@ function readTrajectoryConstraintAt(trajectoryDir, root) {
 	}
 	const tools = strListMaybe(obj.tools);
 	const msms = strListMaybe(obj.msms);
+	const writes = strListMaybe(obj.writes);
 	/**
 	* 提示词注入模式（owner 2026-10-20）：只搬运，不判决。
 	*
@@ -1097,6 +1098,7 @@ function readTrajectoryConstraintAt(trajectoryDir, root) {
 		...model !== void 0 ? { model } : {},
 		...tools !== void 0 ? { tools } : {},
 		...msms !== void 0 ? { msms } : {},
+		...writes !== void 0 ? { writes } : {},
 		...resident !== void 0 ? { resident } : {},
 		...prompt !== void 0 ? { prompt } : {},
 		cognitiveTrajectory: {

package/lib/{session-sV-kc1gQ.js → session-BF4C3hJL.js}

@@ -1,8 +1,8 @@
-import { n as agentCwdFor, r as cccRootForCwd, s as hostAgents } from "./ccc-roots-DYJvlQhc.js";
+import { n as agentCwdFor, r as cccRootForCwd, s as hostAgents } from "./ccc-roots-4LwGLCXa.js";
 import { g as readUtf8, o as isSafeModeOn, p as readCognitiveTrajectorySkills, u as readBlacklist } from "./ccc-CyYJL4F2.js";
-import { B as isoLocal, D as readActiveSessionMd, a as readTrajectoryConstraintAt, c as trajectoryConstraintForSession, d as unregisterTrajectorySession$1, j as sessionsRoot, l as registerTrajectorySession$1, p as DEFAULT_SESSION_SCOPE, u as trajectoryDirNameForSession } from "./profile-DmWw2M0q.js";
+import { B as isoLocal, D as readActiveSessionMd, a as readTrajectoryConstraintAt, c as trajectoryConstraintForSession, d as unregisterTrajectorySession$1, j as sessionsRoot, l as registerTrajectorySession$1, p as DEFAULT_SESSION_SCOPE, u as trajectoryDirNameForSession } from "./profile-CiRWh2a2.js";
 import { a as readGitTrack, i as localstorePath } from "./service-DDmHSglV.js";
-import { _ as ACC_VERSION, d as constraintCognitiveTrajectory, m as profileMsmWhitelist, n as PLUGIN_SOURCE, o as readLastBound, p as createProfilePromptReader, u as buildTrajectoryBasePrompt } from "./message-source-BYO-FyFP.js";
+import { d as constraintCognitiveTrajectory, m as profileMsmWhitelist, n as PLUGIN_SOURCE, o as readLastBound, p as createProfilePromptReader, u as buildTrajectoryBasePrompt, v as ACC_VERSION } from "./message-source-CfqdGIi2.js";
 import { basename, dirname, join, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { createUserMessage } from "@deepseek-ai/dsh-llm";
@@ -2555,6 +2555,51 @@ function countAssistantMessages(session) {
 	return n;
 }
 /**
+* 会话当前轮号（最后一个 `turn/start` 的 `turn`；取不到 ⇒ `null`）。
+*
+* 🔴 为什么需要它（2026-10-21，"同一条消息被处理两轮"的第二处缺陷）：
+* 判"本轮是否产出"用的是 **`assistant/message` 条数增长**。而在**并发入站**下，
+* 后一条的快照里，**前一条那一轮**还在继续产出 assistant 消息 ⇒ 计数照样增长
+* ⇒ 后一条会把**别人那一轮的文本**当成自己的答案（真机实测：兜底把内部过程话发给了家人）。
+* ⇒ 增长必须限定在「**这一轮开始之后**新出现的事件」里。
+*/
+function currentTurnOfSession(session) {
+	const events = sessionEvents(session);
+	for (let i = events.length - 1; i >= 0; i--) {
+		const e = events[i];
+		if (e?.type === "turn/start") {
+			const t = e.data?.turn;
+			return typeof t === "number" && Number.isFinite(t) ? t : null;
+		}
+	}
+	return null;
+}
+function snapshotSession(session) {
+	return {
+		turn: currentTurnOfSession(session),
+		assistantCount: countAssistantMessages(session),
+		eventCount: sessionEvents(session).length
+	};
+}
+/**
+* **本轮**（快照之后）是否产出了 assistant 消息。
+*
+* 判据顺序（每一条都是被真账打出来的）：
+* ① 只数**快照之后**新增的事件 ⇒ 前一轮续跑的产出**不进账**（2026-10-21）；
+* ② 若快照时的轮号已知，且现在的轮号变了 ⇒ 那是**别的轮**在产出 ⇒ 不算我的；
+* ③ 条数确实增长 ⇒ 成功。
+*/
+function grewWithFreshAssistant(session, snap) {
+	const events = sessionEvents(session);
+	if (events.length <= snap.eventCount) return false;
+	const now = currentTurnOfSession(session);
+	if (snap.turn !== null && now !== null && now !== snap.turn) return false;
+	let fresh = 0;
+	for (let i = snap.eventCount; i < events.length; i++) if (events[i]?.type === "assistant/message") fresh += 1;
+	if (fresh > 0) return true;
+	return countAssistantMessages(session) > snap.assistantCount;
+}
+/**
 * 等**本轮**产出一条 assistant 消息。
 *
 * ## 为什么不能用 `waitAgentIdle` 单独当判据（2026-10-19 复读缺陷）
@@ -2570,9 +2615,19 @@ function countAssistantMessages(session) {
 * ② 成功 ⟺ 该计数**增长**；
 * ③ 超时或有界轮询耗尽 ⇒ `false`（调用方据此给空答案，兜底不触发）。
 */
-async function waitForTurnAssistant(ctx, agent, beforeAssistantCount, opts = {}) {
+async function waitForTurnAssistant(ctx, agent, before, opts = {}) {
 	const timeoutMs = opts.timeoutMs ?? ASK_TURN_TIMEOUT_MS;
-	const grew = () => countAssistantMessages(agent.session) > beforeAssistantCount;
+	/**
+	* 快照兼容两种入参：数字（旧调用方的"条数"）与 `SessionSnapshot`（新，带轮号与事件位）。
+	* 🔴 数字形态**仍然可用**，因为既有测试与调用点按数字传，而它们的语义（"条数增长"）
+	* 在本轮修法之后依然成立 —— 只是**并发**时不够。给 `SessionSnapshot` 才拿到全部判别力。
+	*/
+	const snap = typeof before === "number" ? {
+		turn: null,
+		assistantCount: before,
+		eventCount: 0
+	} : before;
+	const grew = () => typeof before === "number" ? countAssistantMessages(agent.session) > before : grewWithFreshAssistant(agent.session, snap);
 	if (await Promise.race([waitAgentIdle(ctx, agent).then(() => true), new Promise((resolve) => {
 		setTimeout(() => resolve(false), timeoutMs);
 	})])) return grew();
@@ -2581,10 +2636,17 @@ async function waitForTurnAssistant(ctx, agent, beforeAssistantCount, opts = {})
 /**
 * 提问一轮：followup → 等**本轮**回答 → 读答案。
 *
+* ## 🔴 2026-10-21：快照从"条数"升级为"（轮号, 条数, 事件位）"
+*
+* 并发入站时，后一条的快照里**前一条那一轮还在产出** ⇒ 旧判据（条数增长）会被满足
+* ⇒ 后一条把**别人那一轮的文本**当自己的答案。新快照让"增长"只在**本轮的窗口内**才成立。
+* 配套：调用侧（`im/inbound-event.ts`）给**同一会话**加了串行锁 —— 两层都要，缺一不可：
+* 锁防"同时开两轮"，快照防"锁被绕过时（如别的路径直接调本函数）把错轮的文本当答案"。
+*
 * @param options.timeoutMs 本轮等待上限（测试注入；生产用缺省）
 */
 async function askTrajectory(ctx, agent, question, options) {
-	const beforeAssistant = countAssistantMessages(agent.session);
+	const beforeSnapshot = snapshotSession(agent.session);
 	agent.followup(createUserMessage({
 		content: [{
 			type: "text",
@@ -2593,7 +2655,7 @@ async function askTrajectory(ctx, agent, question, options) {
 		source: PLUGIN_SOURCE
 	}));
 	return {
-		answer: await waitForTurnAssistant(ctx, agent, beforeAssistant, { timeoutMs: options?.timeoutMs }) ? lastAssistantText(agent) : "",
+		answer: await waitForTurnAssistant(ctx, agent, beforeSnapshot, { timeoutMs: options?.timeoutMs }) ? lastAssistantText(agent) : "",
 		sessionId: String(agent.session.id ?? "")
 	};
 }

package/lib/{settings-DdYLVK3O.js → settings-Dj4_ppTC.js}

@@ -1,4 +1,4 @@
-import { f as hostSettings } from "./ccc-roots-DYJvlQhc.js";
+import { f as hostSettings } from "./ccc-roots-4LwGLCXa.js";
 //#region src/surface/settings.ts
 /**
 * 设置面板命名空间 = **profile 条目 id**（v0.1.7 起；与旧 `settings.yaml` 段名逐字相同）。

package/lib/trajectory/policy/profile.d.ts

@@ -67,6 +67,20 @@ export interface TrajectoryConstraint {
     tools?: string[];
     /** MSM 白名单；缺省/空数组语义同 `tools`（D181） */
     msms?: string[];
+    /**
+     * **写路径白名单**（owner 2026-10-20 令：「ACC 如果支持轨迹设定自己的写白名单就好了」）。
+     *
+     * `tools` 只管**工具名**，管不了"这个工具能写哪儿"——一旦给了 `write`，路径守卫只拦
+     * "逃出 CCC"与黑名单，**拦不住它去写别人的轨迹或 `docs/`**。本字段补的就是这一维。
+     *
+     * 🔴 判据与 D181 同一条：**字段在不在，不是数组空不空**。
+     * - 缺省（`undefined`）⇒ **不收窄**（写权限 = 路径守卫那几条）；
+     * - `[]` ⇒ **一个写都落不下**（显式意图，不告警）；
+     * - 非空 ⇒ 写类工具的**目标路径**必须落在这些前缀内（相对 CCC 根，或其绝对路径）。
+     *
+     * 只约束**写类**工具（`write`/`edit`/`container_fs` 写动作/`append`/`touch`）；读不受影响。
+     */
+    writes?: string[];
     /** 轨迹纪律参与项（**缺省全 true**，见上方 R↓） */
     cognitiveTrajectory: {
         session: boolean;

package/lib/trajectory/policy/rules.d.ts

@@ -45,6 +45,24 @@ export declare const TRAJECTORY_CONSTRAINT_HINT = "systemPromptFile hot-reloads
 export declare function profileToolWhitelist(profile: TrajectoryConstraint | null | undefined): Set<string> | null;
 /** 该轨迹会话可 exec 的 MSM 白名单（`msm` 工具内部再过滤；独立于工具白名单） */
 export declare function profileMsmWhitelist(profile: TrajectoryConstraint | null | undefined): Set<string>;
+/**
+ * 该轨迹可**写**的路径前缀（owner 2026-10-20 令：「轨迹设定自己的写白名单」）。
+ *
+ * 🔴 与 `profileToolWhitelist` 共用同一条判据（D181/D183）：**字段在不在，不是数组空不空**。
+ *
+ * | `writes` | 返回 | 语义 |
+ * |---|---|---|
+ * | 缺省 | **`null`** | 不收窄（写权限 = 路径守卫那几条，与今天一致） |
+ * | `[]` | `[]`（空数组） | **一个写都落不下**（显式意图） |
+ * | `['a/']` | `['a/']` | 写目标必须落在 `a/` 之内 |
+ *
+ * ⛔ **调用方不许把 `null` 当 `[]`** —— 那会把"我没想到这件事"读成"我不许写任何东西"，
+ * 正是 S196 被静默锁死的形态（D179(b)）。
+ *
+ * ⚠️ 返回的是**原始条目**（相对 CCC 根或绝对路径都可），解析成绝对路径由调用方按自己的 root 做 ——
+ * 本模块不持有 root（判据在 `seams/guards.ts`）。
+ */
+export declare function profileWriteWhitelist(profile: TrajectoryConstraint | null | undefined): string[] | null;
 /** 轨迹纪律参与项（`profile` 缺省已在 `readTrajectoryConstraintAt` 归一为全 true） */
 export declare function constraintCognitiveTrajectory(profile: TrajectoryConstraint | null | undefined): {
     session: boolean;

package/lib/trajectory/session.d.ts

@@ -105,6 +105,18 @@ interface TrajectoryAskResult {
     answer: string;
     sessionId: string;
 }
+/**
+ * 会话快照：**调用那一刻**的（轮号, assistant 条数, 事件条数）。
+ *
+ * 三个值一起记，是因为判"增长"要能回答两个问题：
+ * ① 有没有新的 assistant 消息？（条数）
+ * ② 那些新消息是不是**我这一轮**产的？（轮号 ＋ 只看快照之后的事件）
+ */
+interface SessionSnapshot {
+    turn: number | null;
+    assistantCount: number;
+    eventCount: number;
+}
 /**
  * 等**本轮**产出一条 assistant 消息。
  *
@@ -121,13 +133,20 @@ interface TrajectoryAskResult {
  * ② 成功 ⟺ 该计数**增长**；
  * ③ 超时或有界轮询耗尽 ⇒ `false`（调用方据此给空答案，兜底不触发）。
  */
-export declare function waitForTurnAssistant(ctx: unknown, agent: Agent, beforeAssistantCount: number, opts?: {
+export declare function waitForTurnAssistant(ctx: unknown, agent: Agent, before: number | SessionSnapshot, opts?: {
     timeoutMs?: number;
     pollMs?: number;
 }): Promise<boolean>;
 /**
  * 提问一轮：followup → 等**本轮**回答 → 读答案。
  *
+ * ## 🔴 2026-10-21：快照从"条数"升级为"（轮号, 条数, 事件位）"
+ *
+ * 并发入站时，后一条的快照里**前一条那一轮还在产出** ⇒ 旧判据（条数增长）会被满足
+ * ⇒ 后一条把**别人那一轮的文本**当自己的答案。新快照让"增长"只在**本轮的窗口内**才成立。
+ * 配套：调用侧（`im/inbound-event.ts`）给**同一会话**加了串行锁 —— 两层都要，缺一不可：
+ * 锁防"同时开两轮"，快照防"锁被绕过时（如别的路径直接调本函数）把错轮的文本当答案"。
+ *
  * @param options.timeoutMs 本轮等待上限（测试注入；生产用缺省）
  */
 export declare function askTrajectory(ctx: Context, agent: Agent, question: string, options?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.80.0",
+  "version": "1.82.0",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「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（三档）。",
   "license": "MIT",
   "repository": {