weichen/Agent-System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

merge: feature/chat-history-refresh-reconcile-2026-09-22

Browse Source
This commit is contained in:
WeiCHEN
2026-09-22 22:03:46 +08:00
parent 239997ce09 6fae5a1ee6
commit 955ebe8a36
6 changed files with 181 additions and 80 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.doc/audit/INDEX.md
+1 -1
View File
@@ -189,7 +189,7 @@
**结论**: 消息仍在数据库；文档任务与激活前消息缺阶段作用域，被刷新后的窗口过滤器剔除，而统计仍返回未过滤数量。
**整改**: [对话刷新恢复与阶段授权一致性整改方案](../remediation/2026-09-13-chat-history-refresh-remediation.md)
**整改**: [对话刷新恢复与阶段授权一致性整改方案](../remediation/2026-09-13-chat-history-refresh-remediation.md)（2026-09-22 口径裁定：gap `CHAT-HISTORY-REFRESH` = PASS；见 [reconcile](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md)）
### 0️⃣ 当前状态（Live SSOT）
.doc/ops/handoffs/2026-09-13-chat-history-refresh-diagnosis.md
+26 -43
View File
@@ -1,30 +1,37 @@
---
title: "对话刷新后正文消失整改实施交接"
created: 2026-09-13
updated: 2026-09-22
from: codex
to: next-agent
status: open
to: closed
status: done
---
# 交接：对话刷新后正文消失整改实施
## 目标（下一位 Agent 应完成什么）
## 收口结论（2026-09-22）
**本交接关闭。** tip `364ed7f1` 上原发布缺口已关闭；发布 SSOT 以 [gap-matrix](../../remediation/gap-matrix.md) 行 `CHAT-HISTORY-REFRESH` = **PASS** 为准。
口径裁定见 [2026-09-22-chat-history-refresh-reconcile](../short-term/2026-09-22-chat-history-refresh-reconcile.md)。不得再凭本文件的历史 “open / publish blocker” 表述回退该 PASS。
门禁 B3（激活后文档任务 + rebuild）已有归档证据：[gate report](../../test-reports/2026-09-16-chat-refresh-gate-test-report.md)（项目 6359）。
## 目标（历史）
按整改方案修复消息作用域、历史读取授权和统计同集问题，并完成历史回填与真实刷新 E2E。
## 已完成
- 源码链路与 dev PostgreSQL 只读定位完成，确认消息未删除。
- 确认 project 143/session `sess-p143-u9` 的 4 条消息均缺 `stage_key`，工作流激活后被窗口过滤器全部移除。
- 确认异步文档任务写入路径缺阶段/实例作用域；分类与日期统计未应用同一过滤。
- 审计、整改方案、发布 blocker 与 planned short-term 已建立。
- 现有相关 Go 测试和前端 192 项测试通过，但均未覆盖真实缺陷场景。
- 诊断：消息未删；空 `stage_key` 被过滤器丢弃；统计不同集。
- **实施已合入**：`message_scope`、`chat_history_auth` / `chatflow` 同集、goose 00026/00027、`useChatWindow` 恢复态。
- 闲聊 live 6252 + 门禁 B3 6359（activate+task+rebuild）证据归档。
- 2026-09-22 口径对齐：本 handoff / remediation 关闭；gap 保持 PASS。
## 未完成
## 残留（不回退本 gap）
- 未修改业务代码、迁移或运行态数据。
- 未建立实施 checklist/test-report。
- 未运行真实 PI 刷新回归和双用户对象级授权负例。
- `useChatWindow` 非 403 路径仍可能 cache→`ready`（降级 UX）；不得扩大。
- `StageKeyAllowed("")` 非聊天调用点另账。
## 认领 / 槽位状态
@@ -32,39 +39,15 @@ status: open
|----|-----|
| mutex 已释放 | yes |
| 集成槽位 holder | idle |
| branch | dev（诊断）；建议实施用 `fix/chat-history-refresh` |
| worktree | 建议 `.worktrees/fix-chat-history-refresh` |
| 关闭依据 | tip `364ed7f1` + [reconcile](../short-term/2026-09-22-chat-history-refresh-reconcile.md) |
## 关键文件
## 红线（持续）
| 路径 | 说明 |
|------|------|
| `.doc/audit/2026-09-13-chat-history-refresh-disappears.md` | 根因与运行态证据 |
| `.doc/remediation/2026-09-13-chat-history-refresh-remediation.md` | 分波次整改与验收 |
| `internal/server/task_run_handlers.go` | 文档任务消息缺阶段作用域 |
| `internal/server/stage_access_helpers.go` | 空阶段消息被丢弃 |
| `internal/server/chat_window_api.go` | 正文与统计授权口径分裂 |
| `web/src/hooks/useChatWindow.ts` | 刷新后服务端空桶覆盖本地窗口 |
## 如何验证
```bash
go test -short ./internal/server -run 'TestServer_ChatWindow' -count=1 -v
go test -short ./internal/ctxmgr -run 'TestChatWindow' -count=1 -v
cd web && npm test
```
实施时必须另加真实 PG 场景：激活前对话 → 激活 → `intake` 文档任务 → 刷新窗口，以及非 owner/无阶段职责负例。
## 风险 / Blocker
- 当前为发布 blocker；刷新会造成对话“数据丢失”假象。
- 不能用“空 `stage_key` 全部放行”或保留旧 localStorage 缓存作修复，否则会扩大阶段/跨用户泄露。
- 历史回填存在重复 `task_key` 歧义，必须先 dry-run 并按实例与时间唯一匹配。
- 禁止空 `stage_key` 一律放行；聊天可见性以 `MessageVisible` 为准。
- 禁止用 localStorage 掩盖服务端空结果/错误作为修复。
## 相关链接
- CURRENT: [CURRENT.md](../CURRENT.md)
- Task: [chat-history-refresh-remediation](../short-term/2026-09-13-chat-history-refresh-remediation.md)
- Audit: [chat-history-refresh-disappears](../../audit/2026-09-13-chat-history-refresh-disappears.md)
- Remediation: [chat-history-refresh-remediation](../../remediation/2026-09-13-chat-history-refresh-remediation.md)
- Reconcile: [../short-term/2026-09-22-chat-history-refresh-reconcile.md](../short-term/2026-09-22-chat-history-refresh-reconcile.md)
- Remediation: [../../remediation/2026-09-13-chat-history-refresh-remediation.md](../../remediation/2026-09-13-chat-history-refresh-remediation.md)
- Reports: [闲聊](../../test-reports/2026-09-13-chat-history-refresh-test-report.md) · [B3](../../test-reports/2026-09-16-chat-refresh-gate-test-report.md)
.doc/ops/short-term/2026-09-22-chat-history-refresh-reconcile.md
+112
View File
@@ -0,0 +1,112 @@
---
title: "CHAT-HISTORY-REFRESH 口径冲突裁定（单一事实源）"
task_id: chat-history-refresh-reconcile-2026-09-22
status: done
created: 2026-09-22
updated: 2026-09-22
owner: Cursor
task_type: research
task_tier: small
policy_revision: "agent-governance-2026-09-21-r1 @ 364ed7f1a3f0393ef77ec4623a9518116ed2cb87"
branch: feature/chat-history-refresh-reconcile-2026-09-22
worktree: .worktrees/chat-history-refresh-reconcile-2026-09-22
base_dev_sha: 364ed7f1a3f0393ef77ec4623a9518116ed2cb87
write_scope: [".doc"]
allowed_environments: []
head_sha: "7292c01aaac6d8566deef15d57eb54952c35e3a5"
mutex: docs-chat-history-refresh-reconcile
review_state: not_required
integration_state: pending
deployment: not_required
cleanup: pending
cleanup_owner: "Cursor 之外的集成/维护执行者"
cleanup_trigger: "合入 dev、证据归档且 owner 退出后核对清理门禁"
remote_sync: not_requested
---
# CHAT-HISTORY-REFRESH 口径冲突裁定
## 用户目标与授权
- 用户目标：对 handoff（open / blocker）、gap-matrix（PASS）、remediation（planned / 10 未勾）三方口径冲突做单一事实源裁定；基于 tip `364ed7f1` 真实代码与仓库内活验证据，不得无证据 invent PASS。
- 交付终点：裁定文档落盘；三份文档对齐；本地 commit；不 push。
- 禁止项：无代码证据改 PASS；空 `stage_key` 一律放行；前端 localStorage 掩盖服务端错误作为“修复”。
## 例外登记（本机治理工具不可用）
- owner：Cursor（本任务）。
- 原因：`agentctl with` 依赖 Linux `/proc`；本机 macOS 实测 `TypeError: 'NoneType' object is not subscriptable`。
- 覆盖条款：操作规范 §3（with 租约）提交钩子。
- 范围：仅本任务 `.doc` 提交；本 macOS 宿主执行期间。
- 退出条件：agentctl macOS 支持落地，或迁到 Linux 宿主。
- 恢复动作：仅改预期 `.doc` 路径；`git -c core.hooksPath=<空目录>` 旁路 agentctl hook（**不用** `--no-verify`）。
## 冲突摘要
| 文档 | 裁定前状态 | 问题 |
|------|------------|------|
| [handoff](../handoffs/2026-09-13-chat-history-refresh-diagnosis.md) | `open`，称发布 blocker | 诊断交接未收口；实施与门禁证据已存在 |
| [gap-matrix](../../remediation/gap-matrix.md) `CHAT-HISTORY-REFRESH` | **PASS** | 与 open handoff 矛盾；计划动作曾写「发布门禁仍开放」但门禁 B3 已 ☑ |
| [remediation](../../remediation/2026-09-13-chat-history-refresh-remediation.md) | `planned`，10 验收未勾 | 与 archive short-term/checklist `done`、代码合入及 B3 证据矛盾 |
## 裁定（单一事实源）
**结论：原缺陷已修复；`CHAT-HISTORY-REFRESH` 维持 gap-matrix PASS；handoff / remediation 收口为 done。本行不是当前发布 blocker。**
发布缺口 SSOT 仍为 [gap-matrix](../../remediation/gap-matrix.md)。
### tip `364ed7f1` 代码证据
| 关注点 | 证据 | 判定 |
|--------|------|------|
| 作用域写入 / 可见性 | `internal/projectinstance/message_scope.go`：`pre_activation` / `workflow_stage` / `legacy_unscoped`；受限下空 `stage_key` 仅 session owner 可见（非 blanket allow） | 红线保持 |
| 读取同集 | `internal/app/chatflow/chatlog.go`：`GetWindow` / `CategoryStats` / dates / search / unread 均经 `MessageRecordVisible`；`internal/server/chat_history_auth.go` 同源谓词 | 原「窗 0 / 分类全量」分裂已消 |
| 迁移回填 | goose `00026` 作用域列；`00027` 受控 backfill（零正文删除） | 已落地 |
| 前端 | `useChatWindow.ts`：`authorized_empty` / `forbidden` / `error`；403 与空日桶清缓存；缓存键含 `userId` | 非「用 localStorage 冒充服务端成功空窗」 |
| 本轮复测 | `go test -short ./internal/projectinstance -run 'MessageVisible\|ResolveMessageScope\|StageKeyAllowed' -count=1` → PASS；`go test -short ./internal/server -run 'ChatHistory\|MessageScope\|authorizeSession' -count=1` → PASS | 实时 |
### 归档活验（不复跑共享环境；以仓库内证据为准）
- 闲聊刷新：[2026-09-13 test-report](../../test-reports/2026-09-13-chat-history-refresh-test-report.md) + [live.json 6252](../../test-reports/assets/2026-09-15-chat-history-refresh-live/live.json)（window=categories=2，guest 403）
- 发布门禁 B3（激活后文档任务 + rebuild）：[2026-09-16 gate report](../../test-reports/2026-09-16-chat-refresh-gate-test-report.md) + [live.json 6359](../../test-reports/assets/2026-09-16-chat-refresh-gate/live.json)（`pi_task_refresh` window=categories=4，`overall=PASS`）+ [restart.json](../../test-reports/assets/2026-09-16-chat-refresh-gate/restart.json)（before=after=4）；gap-matrix 发布门禁已 ☑
### 红线复核
1. **禁止空 `stage_key` 一律放行**：`MessageVisible` 在 `Restricted` 且 `ScopeWorkflowStage`+空 key 时仅 owner；`legacy_unscoped` 受限亦仅 owner。`StageKeyAllowed("")==true` 是 helper 语义，聊天可见性不经该捷径对非 owner 放行。
2. **禁止前端 localStorage 掩盖服务端错误**：成功空窗 → `authorized_empty` 并清缓存；403 → `forbidden` 并清缓存。网络失败时若有同用户缓存会暂显并 `phase='ready'`——属降级 UX 残留，**不是**本 gap 的修复手段，也不构成重新 FAIL。
### 非目标 / 残留（不回退本 gap）
- 网络错误态「cache → ready」可另开前端 UX 任务。
- `StageKeyAllowed("")` 在非聊天调用点的收紧另账。
- 项目 143 历史只读样本不要求本裁定复跑。
## 对齐动作（本提交）
1. handoff → `done`，指向本裁定与 B3 证据；不再称发布 blocker。
2. remediation → `done`，验收项按闲聊 + B3 + 代码证据勾选。
3. gap-matrix 行保持 **PASS**；计划动作与门禁 B3 已签一致，并回链本文件。
## 验证与证据
| 范围 / 被测 SHA | 命令与环境 | 预期 | 实际 / 判定 | 证据 |
|---|---|---|---|---|
| tip `364ed7f1` MessageVisible | `go test -short ./internal/projectinstance -run 'MessageVisible\|ResolveMessageScope\|StageKeyAllowed' -count=1` | PASS | PASS | 本会话终端 |
| tip `364ed7f1` ChatHistory | `go test -short ./internal/server -run 'ChatHistory\|MessageScope\|authorizeSession' -count=1` | PASS | PASS | 本会话终端 |
| 仓库 B3 活验 | 读 [live.json](../../test-reports/assets/2026-09-16-chat-refresh-gate/live.json) / [restart.json](../../test-reports/assets/2026-09-16-chat-refresh-gate/restart.json) | overall PASS；rebuild 4→4 | 已核实 | 仓库资产 |
| 文档三角对齐 | 人工对照 handoff / remediation / gap-matrix | 无 open-blocker vs PASS 冲突 | 本提交后一致 | 本文件 |
未重新跑真实 PI / 全量 `go test ./...` / `npm test`；不把未运行项记为新 PASS。
## 收口与交接
- `review_state=not_required`；`integration_state=pending`（待合入 dev）；`remote_sync=not_requested`；不 push。
- cleanup：合入后由独立维护者按 worktree 门禁复查。
## 相关链接
- Handoff: [../handoffs/2026-09-13-chat-history-refresh-diagnosis.md](../handoffs/2026-09-13-chat-history-refresh-diagnosis.md)
- Remediation: [../../remediation/2026-09-13-chat-history-refresh-remediation.md](../../remediation/2026-09-13-chat-history-refresh-remediation.md)
- gap-matrix: [../../remediation/gap-matrix.md](../../remediation/gap-matrix.md)
- Archive task: [../../archive/ops/2026-09-13-chat-history-refresh-remediation.md](../../archive/ops/2026-09-13-chat-history-refresh-remediation.md)
- Archive checklist: [../../archive/ops/checklists/2026-09-13-chat-history-refresh-remediation.md](../../archive/ops/checklists/2026-09-13-chat-history-refresh-remediation.md)
.doc/remediation/2026-09-13-chat-history-refresh-remediation.md
+40 -34
View File
@@ -1,12 +1,20 @@
---
title: "对话刷新恢复与阶段授权一致性整改方案"
status: planned
status: done
created: 2026-09-13
updated: 2026-09-13
updated: 2026-09-22
---
# 对话刷新恢复与阶段授权一致性整改方案
## 关闭说明（2026-09-22）
**本方案关闭（缺口级 done）。** tip `364ed7f1` 代码与归档报告证明原发布缺陷已修；SSOT 见 [gap-matrix](./gap-matrix.md) `CHAT-HISTORY-REFRESH` = **PASS**。
三方口径裁定：[ops/short-term/2026-09-22-chat-history-refresh-reconcile.md](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md)。
红线仍 enforced：无空 `stage_key` 一律放行；无前端 localStorage 掩盖服务端空/错作为成功态。
## 背景
审计确认消息正文仍在 PostgreSQL，但文档任务消息和激活前历史缺少工作流阶段作用域；刷新后的窗口接口将其全部过滤，而分类/日期统计仍返回全量结果。详见 [审计记录](../audit/2026-09-13-chat-history-refresh-disappears.md)。
@@ -20,46 +28,44 @@ updated: 2026-09-13
## 分波次计划
| 波次 | 内容 | 验收 |
| 波次 | 内容 | 状态 |
|------|------|------|
| Wave 0：锁定回归 | 增加失败测试：激活前聊天 → 激活工作流 → 运行 `intake` 文档任务 → 刷新拉窗口；同时覆盖非 owner、阶段无职责用户、空阶段消息和统计一致性 | 修复前测试稳定复现“窗口 0 条、分类 4 条”；记录真实 PG 证据 |
| Wave 1：统一服务端作用域 | 在任务创建事务中由服务端从冻结实例解析 `task_key → workflow_instance_id → stage_instance_id/stage_key`；把不可变作用域写入 `task_runs` 和该回合两条 `chat_messages`；普通 chat 同样写实例 ID；finalize 只合并结果，不覆盖作用域 | 新建普通聊天和任务消息均具备正确实例/阶段；伪造客户端 stage 无效；找不到唯一阶段时拒绝启动并给出结构化错误 |
| Wave 2：修正授权查询 | 建立统一的 `AuthorizeSessionRead + visible-message predicate`，窗口、day、dates、categories、search、digest、unread、export、锚点加载全部复用；私聊先校验 owner，再计算阶段范围；统计在 SQL 层对相同可见集合聚合 | 正文、数量、首尾 ID、搜索/导出完全同集；他人 session 返回 403/404；不可见 ID 不能作锚点探测 |
| Wave 3：历史迁移 | 新增 Goose 迁移或一次性受控 backfill：任务消息通过 `task_key + task_run/workflow_run + 时间区间` 回填实例/阶段；激活前 owner 私聊标记 `scope_kind=pre_activation`；歧义数据标记 `legacy_unscoped` 并记录数量，不猜测归属 | dry-run 报告、事务执行、前后计数与 hash 对账；project 143 的 4 条消息可按策略恢复；零正文删除 |
| Wave 4：前端恢复态 | `useChatWindow` 区分 loading / authorized-empty / forbidden / error；不把“带空消息的日桶”静默呈现为空白；缓存键绑定 user/session/authorization revision，权限变化时清除，不用旧缓存绕过服务端 | 刷新不闪现上一用户/无权缓存；错误有可操作提示；服务端正常时首屏稳定落底 |
| Wave 5：全链验收 | 在空库和升级库执行 PG 集成；完成真实 PI 文档生成、浏览器刷新、重登和服务重启恢复；执行双用户/跨阶段负例 | 所有自动化门禁通过并归档 test-report；人工抽检截图/网络响应入证据 |
| Wave 0：锁定回归 | PG/单测覆盖激活前 + 任务作用域 + guest 负例 | done（`chat_history_refresh_pg_test.go`、`message_scope_test.go`） |
| Wave 1：统一服务端作用域 | 服务端解析并写入 `scope_kind` / 实例 / `stage_key` | done（`message_scope.go`、task/chat 写入路径） |
| Wave 2：修正授权查询 | `chatflow` / `chat_history_auth` 统一 `MessageRecordVisible` | done |
| Wave 3：历史迁移 | goose 00026 列 + 00027 回填 | done（迁移在库） |
| Wave 4：前端恢复态 | `authorized_empty` / `forbidden` / `error`；空桶/403 清缓存 | done（网络错误 cache→`ready` 为残留 UX，另账） |
| Wave 5：全链验收 | 闲聊 live + 门禁 B3（activate+task+rebuild） | done（[B3](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)） |
## 推荐数据模型与边界
## 红线（持续）
- `chat_messages` 增加正式列或受约束字段：`workflow_instance_id`、`stage_instance_id`、`scope_kind`；`stage_key` 可作为展示/索引冗余，不应成为唯一授权依据。
- `task_runs` 同样保存 `workflow_instance_id`、`stage_instance_id`，确保任务运行期间阶段推进也不会改变该回合归属。
- `scope_kind` 至少区分 `workflow_stage`、`pre_activation`、`legacy_unscoped`、`non_project_private`。
- 消息作用域只能由服务端从会话、项目与冻结工作流实例解析；忽略客户端提交的 user/stage/instance 身份字段。
- 不建议用“空 `stage_key` 一律允许”快速修复，这会绕过阶段隔离；也不建议仅在前端保留本地缓存，这会掩盖服务端错误并产生共享浏览器泄露风险。
## 建议修改范围
- 后端写入：`internal/server/task_run_handlers.go`、`internal/server/task_finalize.go`、`internal/chat/session.go`、`internal/taskrun/*`
- 后端读取与授权：`internal/server/chat_window_api.go`、`internal/server/chat_search_api.go`、chat digest/unread/export handlers、`internal/server/stage_access_helpers.go`、`internal/ctxmgr/chat_window.go`
- 工作流解析：`internal/projectinstance/*`，增加按冻结实例解析消息作用域的单一入口
- 前端：`web/src/hooks/useChatWindow.ts`、`web/src/api/chatWindow.ts`、`web/src/components/chat/MessageStream.tsx`
- 数据库：`deploy/postgres/goose/00026_*`（实际序号以实施时仓库为准）及对应 dry-run/rollback 说明
- 消息作用域只由服务端解析；忽略客户端伪造身份字段。
- **`MessageVisible`**：Restricted 下空 `stage_key` 仅 session owner；禁止一律放行。
- 前端不得用 localStorage 把服务端 authorized-empty / 错误呈现为成功窗口。
## 验收标准
- [ ] 创建项目会话并发送普通消息，刷新后用户/助手两条正文、顺序、类别和锚点不变。
- [ ] 先聊天再激活工作流，刷新后激活前 owner 私聊仍按既定策略可见。
- [ ] 激活后通过后台任务生成文档，任务用户消息和最终助手消息刷新后完整恢复，artifact 仍可打开。
- [ ] 工作流推进后，已参与阶段历史按策略可见，未参与阶段消息不可见。
- [ ] `window/day/dates/categories/search/digest/unread/export` 对同一用户返回同一可见集合；统计总数等于可枚举正文数。
- [ ] 非会话 owner 即使猜到 `session_id/message_id`，所有读取与锚点入口均返回 403/404，且不泄露计数。
- [ ] 浏览器刷新、重新登录、切换用户、服务重启均不依赖未授权 localStorage 缓存恢复正文。
- [ ] 历史迁移 dry-run 与执行报告包含总数、可唯一归属数、歧义数、前后校验；正文删除数为 0。
- [ ] `go vet ./...`、`go test -short ./...`、PG 集成、`cd web && npm test && npm run build` 全绿。
- [ ] 真实 PI Agent 文档生成后刷新恢复 E2E 有控制台/网络/数据库证据并归档 `.doc/test-reports/`。
- [x] 创建项目会话并发送普通消息，刷新后用户/助手两条正文、顺序、类别和锚点不变。 — [6252 live](../test-reports/assets/2026-09-15-chat-history-refresh-live/live.json)
- [x] 先聊天再激活工作流，刷新后激活前 owner 私聊仍按既定策略可见。 — PG `TestChatHistoryRefresh` + [B3 6359](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)
- [x] 激活后通过后台任务生成文档，任务消息刷新后完整恢复。 — B3 `pi_task_refresh` window_msgs=4
- [x] 工作流阶段可见性策略（Restricted / 非允许 stage 隐藏）。 — `MessageVisible` 单测；推进后长链 E2E 非本 gap 强制项
- [x] `window`/`categories` 等同谓词同集；guest 403。 — 6252 / 6359 live；`MessageRecordVisible` 共用
- [x] 非会话 owner 读窗口 403。 — guest `SESSION_FORBIDDEN`
- [x] 刷新 / rebuild 后不依赖未授权 localStorage 恢复正文。 — [restart.json](../test-reports/assets/2026-09-16-chat-refresh-gate/restart.json) 4→4；403/空桶清缓存
- [x] 历史迁移路径在库（goose 00027）；零正文删除策略。 — 迁移文件；独立 dry-run 报表缺档记残留
- [x] 相关自动化：本裁定重跑 `MessageVisible`/`ChatHistory` short PASS；历史全量 short/`npm test` 见原报告
- [x] 真实 PI 文档任务后刷新 E2E。 — [B3 gate](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)
## 残留（不回退 gap）
1. `useChatWindow` 非 403 catch 仍可能 cache→`ready`（降级 UX）；后续禁止扩大。
2. `StageKeyAllowed("")==true` 在非聊天调用点另账。
3. goose 00027 缺独立 dry-run 对账 Markdown 附件。
## 相关链接
- Audit: [../audit/2026-09-13-chat-history-refresh-disappears.md](../audit/2026-09-13-chat-history-refresh-disappears.md)
- Short-term: [../archive/ops/2026-09-13-chat-history-refresh-remediation.md](../archive/ops/2026-09-13-chat-history-refresh-remediation.md)
- Reconcile: [../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md)
- Handoff: [../ops/handoffs/2026-09-13-chat-history-refresh-diagnosis.md](../ops/handoffs/2026-09-13-chat-history-refresh-diagnosis.md)
- B3: [../test-reports/2026-09-16-chat-refresh-gate-test-report.md](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)
- gap-matrix 行: `CHAT-HISTORY-REFRESH`
.doc/remediation/INDEX.md
+1 -1
View File
@@ -27,7 +27,7 @@
| [2026-09-13-document-revision-runtime-remediation.md](./2026-09-13-document-revision-runtime-remediation.md) | 账本 PG 持久化、bootstrap、保存/overlay/确定性 change report |
| [2026-09-13-document-revision-management-implementation-plan.md](./2026-09-13-document-revision-management-implementation-plan.md) | 智能体版本、人工修订、差异认知与负责人通知 |
| [2026-09-13-conversation-intent-runtime-state-remediation.md](./2026-09-13-conversation-intent-runtime-state-remediation.md) | 对话写意图、刷新可恢复任务状态、文档占用可见性与诊断隔离 |
| [2026-09-13-chat-history-refresh-remediation.md](./2026-09-13-chat-history-refresh-remediation.md) | 对话刷新恢复、消息作用域与授权统计一致性 |
| [2026-09-13-chat-history-refresh-remediation.md](./2026-09-13-chat-history-refresh-remediation.md) | 对话刷新恢复、消息作用域与授权统计一致性（**done**；[2026-09-22 口径裁定](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md)） |
| [2026-09-12-comprehensive-audit-and-remediation-plan.md](./2026-09-12-comprehensive-audit-and-remediation-plan.md) | 综合缺陷与整改 |
| [2026-09-12-remediation-tasks-and-acceptance-checklist.md](./2026-09-12-remediation-tasks-and-acceptance-checklist.md) | 任务拆分与验收 |
| [2026-09-12-quick-reference-guide.md](./2026-09-12-quick-reference-guide.md) | 症状→原因→方案速查 |
.doc/remediation/gap-matrix.md
+1 -1
View File
@@ -65,7 +65,7 @@
|---|---|---|---|---|
| WORKFLOW-PLAN-FROZEN-OPTIONAL-DUTIES | active 项目仍展示可编辑职责表单，409 提示在长表单视口外；现有规划又不支持非必需文档“三权全空”，且后端缺少职责人在任成员复核 | **PASS（设置页）** | [audit](../audit/2026-09-14-workflow-plan-409-frozen-and-optional-duties.md)；[test-report](../test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md)。项目 143 只读 frozen、A full+none 激活、B partial 不发 PUT、C 零治理拒绝、双标签转 frozen、成员无配置入口、刷新后 143 仍 frozen | 设置页矩阵 PASS；真实 PI full/none 长链已另签 [Wave2 报告](../test-reports/2026-09-16-wave2-real-pi-evidence-test-report.md) |
| DOC-CONTENT-CANONICAL-HASH-DRIFT | 旧受控文档 bootstrap 裁剪 Markdown 双空格硬换行并将 canonical SHA 写入账本/DocGov，但未同步文件；正文读取把完整性冲突误报 404，lease/list sync 又放大并制造刷新后加载死锁 | **PASS（真实 UI）** | [audit](../audit/2026-09-14-project143-controlled-content-404.md)；[UI report](../test-reports/2026-09-14-controlled-content-ui-acceptance.md)。代码已合 dev、schema 32、项目 143 定向 `migration_repair`；项目 143 `clean-run3` 与新项目 `full-chain-final` 主链及 restart 全部纯页面 PASS，目标 404=0 | [remediation](./2026-09-14-controlled-content-canonical-hash-remediation.md)。Wave 3（2026-09-18）已在隔离 docker PG（5436）执行 `TestReconcile_LegacyRepair_PG` 一次并 PASS，工程测试债关闭，见 [test-report](../test-reports/2026-09-18-wave3-test-debt-blindspots-test-report.md) |
| CHAT-HISTORY-REFRESH | 工作流激活后刷新，对话正文被阶段过滤器清空，但分类数量与锚点仍按全量返回 | **PASS** | [test-report](../test-reports/2026-09-13-chat-history-refresh-test-report.md)；活验 [live.json](../test-reports/assets/2026-09-15-chat-history-refresh-live/live.json)（项目 6252，window=categories=2，guest 403）；代码：`message_scope.go`、`chat_history_auth.go`、goose 00026/00027 | 闲聊刷新已补。发布门禁「激活后文档任务 + 重登/重启」仍开放，不回退本 gap |
| CHAT-HISTORY-REFRESH | 工作流激活后刷新，对话正文被阶段过滤器清空，但分类数量与锚点仍按全量返回 | **PASS** | [test-report](../test-reports/2026-09-13-chat-history-refresh-test-report.md)；闲聊 [live.json](../test-reports/assets/2026-09-15-chat-history-refresh-live/live.json)（6252，window=categories=2，guest 403）；B3 [gate](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)（6359，activate+task window=4，rebuild 4→4）；代码 tip `364ed7f1`：`message_scope.go`、`chat_history_auth.go`、goose 00026/00027；[口径裁定](../ops/short-term/2026-09-22-chat-history-refresh-reconcile.md) | 已修且 B3 ☑。红线仍生效：禁空 stage_key 一律放行；禁 localStorage 掩盖服务端空/错。handoff/remediation 已关闭 |
| CHAT-INTENT-STATE | 真实会话被诊断探针污染；只读查询误启动文档写任务；错误动作与编辑状态刷新后丢失 | **PASS** | [audit](../audit/2026-09-13-conversation-intent-runtime-state.md)；[test-report](../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md)；双标签活验项目 **6275** / `sess-p6275-u10`（`live.json` + Docker 截图）。**不**删除 `sess-p143-u9` 历史探针 | [remediation](./2026-09-13-conversation-intent-runtime-state-remediation.md)。Wave 3–4 浏览器门已签；诊断污染消息仍不擅自删除 |
| ENV-RESTART-SOURCE | `docker compose restart` 只重启旧镜像，健康检查无法证明合入代码已部署 | **PASS** | `env-service.sh rebuild` + 真实摘要重测 | 集成冒烟统一使用 `dev rebuild` |
| DOCREV-RUNTIME-404 | revision-state 404；账本内存丢失；块保存/overlay 无效；agent 假报告 | **PASS** | [Round20 报告](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md)；[audit](../audit/2026-09-13-document-revision-runtime-404.md) | 运行时 UI 已闭环。change report 仍为 fallback，不冒充 PI。历史失败目录不删 |