Agent-System/.doc/ops/short-term/2026-09-22-chat-history-refresh-reconcile.md

title, task_id, status, created, updated, owner, task_type, task_tier, policy_revision, branch, worktree, base_dev_sha, write_scope, allowed_environments, head_sha, mutex, review_state, integration_state, deployment, cleanup, cleanup_owner, cleanup_trigger, remote_sync

title	task_id	status	created	updated	owner	task_type	task_tier	policy_revision	branch	worktree	base_dev_sha	write_scope	allowed_environments	head_sha	mutex	review_state	integration_state	deployment	cleanup	cleanup_owner	cleanup_trigger	remote_sync
CHAT-HISTORY-REFRESH 口径冲突裁定（单一事实源）	chat-history-refresh-reconcile-2026-09-22	done	2026-09-22	2026-09-22	Cursor	research	small	agent-governance-2026-09-21-r1 @ 364ed7f1a3	feature/chat-history-refresh-reconcile-2026-09-22	.worktrees/chat-history-refresh-reconcile-2026-09-22	364ed7f1a3	.doc		7292c01aaa	docs-chat-history-refresh-reconcile	not_required	pending	not_required	pending	Cursor 之外的集成/维护执行者	合入 dev、证据归档且 owner 退出后核对清理门禁	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	open，称发布 blocker	诊断交接未收口；实施与门禁证据已存在
gap-matrix CHAT-HISTORY-REFRESH	PASS	与 open handoff 矛盾；计划动作曾写「发布门禁仍开放」但门禁 B3 已 ☑
remediation	planned，10 验收未勾	与 archive short-term/checklist done、代码合入及 B3 证据矛盾

裁定（单一事实源）

结论：原缺陷已修复；CHAT-HISTORY-REFRESH 维持 gap-matrix PASS；handoff / remediation 收口为 done。本行不是当前发布 blocker。

发布缺口 SSOT 仍为 gap-matrix。

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 + live.json 6252（window=categories=2，guest 403）
• 发布门禁 B3（激活后文档任务 + rebuild）：2026-09-16 gate report + live.json 6359（pi_task_refresh window=categories=4，overall=PASS）+ 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 / 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
• Remediation: ../../remediation/2026-09-13-chat-history-refresh-remediation.md
• gap-matrix: ../../remediation/gap-matrix.md
• Archive task: ../../archive/ops/2026-09-13-chat-history-refresh-remediation.md
• Archive checklist: ../../archive/ops/checklists/2026-09-13-chat-history-refresh-remediation.md