@tea-agent/loop-agent 0.40.0-next.7 → 0.40.0-next.8

package/CHANGELOG.md

@@ -4,148 +4,113 @@
 
 ### 重点更新
 
-- backend-test Markdown plan 节点收紧为严格 readSet：仅读取绑定任务源、权威 reference 文档和 N1 环境报告，Pi 只暴露受策略包裹的 `read` 工具，禁止全仓库扫描；plan 不再写入 `testcase/md/README.md`，而是保存为 run-owned Harness artifact `generate-backend-md-plan-pi/plan.md`，N3 从该 artifact 提取模块并将 `planReadPath` 传递给下游 map writer。Markdown map child 与唯一 review/sync writer 也增加机器级 strict readSet：动态 child readSet 随 item 模板物化，strict writer 只获得 `read/edit/write`，不能通过 `grep/find/ls/bash` 递归发现仓库；edit 的预读取同样受 readSet 约束，review 机器禁止写 `testcase/md/README.md`。保持 16 节点拓扑不变；backend-test 定向回归通过。
-- Operator Chat 多次输入排队对齐 DSH Web：运行中的连续输入改为持久化 FIFO 队列，不再用后一条覆盖前一条；单条直接展示，多条默认折叠为数量栏，展开后逐行提供内联编辑、删除和插话发送。队列 Dock 使用与 DSH 一致的外层定位与内层面板结构，标题固定、仅消息列表滚动，并在编辑或请求期间锁定折叠操作。编辑/删除以消息 ID + revision 做并发保护，插话复用 Pi `steer` 注入当前回合，其余消息继续按顺序在回合结束后自动发送；队列通过会话快照与 SSE 权威数组恢复，刷新或 Console 重启不丢失。
-- Operator Chat 右侧辅助栏统一上下文与调用记录：输入框的上下文环、调用记录入口现在复用文件/DAG 侧栏；「文件」常驻，「上下文 / 调用记录」按入口临时添加并支持独立 `×` 关闭，关闭后回到文件 Tab；点击已选入口可收起侧栏，切换到上下文时同步开启注入状态，收起时仅关闭注入而保留上下文数据。上下文与工具调用内容改为内嵌布局，不再叠加独立弹窗、遮罩、焦点陷阱或重复关闭按钮，并补充 Tab 切换与侧栏开合动画；修复折叠态右侧展开按钮无法恢复侧栏的问题。
-- Operator Chat 手动 compact 消息流对齐 DSH Web：压缩中在时间线显示状态行，完成后显示默认折叠的 `compact` 摘要边界，点击可展开完整 Markdown 压缩结果；compact 事件通过 SSE 与 session 详情快照双路径恢复，使用事件 ID 去重，刷新/重新进入会话不丢失。Pi compaction 会把摘要写入 session context，后续模型请求继续使用压缩后的上下文。
-- Operator Chat 对齐 DSH Web Todo 能力：新增 `todo_write` 整表替换工具与内容校验，Todo 状态通过会话事件持久化并支持刷新恢复；新一轮开始自动清空，输入框上方展示默认折叠的任务面板（待处理虚线圆环、进行中旋转圆环与完成勾选），消息流使用专用“更新任务清单”摘要行；手动压缩上下文时会把当前完整 Todo 列表合并进压缩指令，避免摘要遗漏仍在执行的任务。
-- Todo 压缩续跑保护：保留 Pi 默认压缩算法，在手动、阈值或上下文溢出压缩成功后的同一轮下一次模型请求前，临时注入当前完整 Todo 内容与状态；下一轮按 DSH 生命周期清空，避免旧任务串入新对话。
-- Operator Chat 的 `ask_user_question` 提问卡片进一步对齐 DSH Web：问题协议新增 Markdown `detail` 说明；选项标签、推荐标记与描述按同一行自然换行，多选仅由 checkbox 表达勾选而不再整行强高亮；自定义回答按单选编辑图标/多选 checkbox 区分，并使用最多六行的镜像自增高输入框；卡片滚动、悬浮/选中动画、窄屏间距和无障碍 tooltip 同步 DSH 行为。
-- Console 多工作区作用域模型收敛（2026-08-26）：对话页顶部不再渲染工作区切换器，工作区添加/选择/新建会话只保留在左侧 Workspace browser；会话按创建工作区持久归属，打开会话后的对话、文件与仓库能力请求全部路由该 session 的 owning workspaceId，与当前全局 active workspace 无关，切换 Operate/Inspect 活动工作区不再泄漏跨工作区数据；新建会话必须携带已知 workspaceId，缺失或未知时前后端一致 fail closed（400 `WORKSPACE_REQUIRED` / 404 `WORKSPACE_NOT_FOUND`），绝不回退默认工作区；Operate 顶部切换工作区为硬作用域边界——中止旧 operation SSE、清空 taskId/dagRunId/operationId/确认态并以新 workspaceId 重新加载；readiness、recovery candidates、night jobs/doctor/morning/ticker 与全部 Observe GET 改为显式 `?workspaceId=` 作用域（`/api/health` 保持进程级），Observe 工作区切换严格按 abort old → clear old → set scope → route/reload new 原子顺序执行，消除旧作用域请求新路由的竞态窗口。
-
-- Operator Console 顶栏以对话页为统一基准：Logo 与工作区入口固定在左侧，「对话 / 操作 / 观测」使用视口居中的三等分胶囊与 190ms 横向滑动选中态；切换页面时复用同一个滑块 DOM 节点，避免顶栏更新中断过渡而闪到终点，也不再因仓库身份、状态胶囊或不同内容宽度发生位移；原“仓库身份”改为消费唯一多工作区控制器的工作区下拉，保持列表顺序，切换后停留在当前主页面，并让对话、操作请求与观测数据继续携带同一 `workspaceId`。
-- Operator Chat 右侧文件工作台对齐 `dsh-better-sidebar@0.16.1`：辅助栏宽度不再受固定 520px 上限限制，拖拽宽度随视口钳制并跨会话持久化；文件打开后采用左侧预览、右侧文件树布局，树宽可在 160–480px 间独立拖动。文件 Tab 内置关闭按钮，「预览 / 源文件」与「新窗口打开」收为右侧紧凑工具区；Tab 悬浮、选中与键盘焦点统一为整行反馈，不再出现文件名和关闭按钮各自高亮；预览滚动条同步模型选择器的低对比细滚动条样式。
-- Operator Chat 工具执行状态进一步对齐 DSH Web：成功后不再显示“完成”标签，错误时以红色状态点和错误首行替换普通图标、参数摘要，运行中以低对比扫光表达状态；Think 与工具行统一为 14/24，Think 正文继承界面正文字体，Bash/代码输出保留 12/18 等宽字体；折叠态显示语义图标、悬浮时切换展开箭头，未知工具使用 Sparkle 图标；状态文字继续通过无障碍文本提供，错误详情仍默认展开，右侧“工具调用记录”诊断面板保持不变。
-- Operator Chat 输入框把模型与推理等级合并为一个 DSH 风格入口：根菜单分为“模型 / 推理等级”，模型仍按供应商分组，`Auto` 同时显示 Pi 当前实际档位。
-- Operator Chat 输入框下方统计栏对齐 DSH Web：移除长期硬编码的 `轮/步 —`、`LLM —`、`首 token —` 等占位，改由服务端从持久会话事件投影真实轮数、步骤数、LLM/工具耗时与 token/cache 汇总，刷新或切换历史会话后仍可恢复；新回复同时记录每个 assistant step 的首 token、解码时长和输出 token，结束后自动刷新并展示平均 TTFT 与 tok/s。展示按 DSH 使用 `|` 分组、组内 `·`，没有可靠证据的整组直接隐藏，超长单行省略并保留完整悬浮文本。
-- Operator Chat 消息流对齐 DSH Web：彻底移除历史回合中的“处理详情”聚合入口以及残留的 `Assistant process` 展示容器，Think、进展、阶段性正文、Bash/Read/Search/Edit/Web/MCP 等工具调用与最终回答作为轮次下的同级节点，按真实事件顺序直接展示；Think 与工具行显式左对齐，不再继承全局按钮的横向居中，运行中 Think 展开、历史 Think 折叠，右侧“工具调用记录”诊断面板继续保留。回答正文、Think、工具行与代码输出同步采用 DSH 的字号和行高基准。
-- Operator Chat Markdown 表格对齐 DSH Web：三列及以下表格在 748px 正文列内自动换行，四列及以上表格扩展利用整个消息视口；宽表静止时不再常驻横向滚动条，只有内容确实溢出且鼠标悬浮或键盘聚焦时才显示，窄视口自动回退为列内安全滚动。
-- 新增源码仓库专用 `npm run console:dev`：浏览器继续固定使用 8790 的真实同源接口与 mutation gate，8790 仅把前端模块代理给内部 loopback Vite；CSS 原地 HMR、TSX 自动整页刷新，后台类型检查不阻塞视觉循环，Console 后端依赖变化只重启受监督源码子进程。正式 build、发布包与 init surface 不变。
-- Operator Chat 左侧会话行按 DSH Web 保留 2px 相邻间距，选中/悬浮背景不再黏连；工作区行隔离鼠标点击焦点，鼠标移开即恢复，仅键盘 `focus-visible` 与打开菜单时保留聚焦反馈；Console mutation gate 修正同端口 `localhost`、`127.0.0.1` 与 `[::1]` 回环别名误判，并把新建会话的安全闸错误转换为可操作中文提示。
-- Operator Chat 左侧工作区与会话的悬浮/键盘聚焦状态改为行级隔离：会话仍归属工作区分组，但悬浮或聚焦会话时不再连带高亮工作区行、切换工作区图标或显示工作区操作按钮；工作区自身的悬浮卡片和菜单保持原行为。
-- Operator Console 收敛为常驻单壳：一级导航改为「对话 / 操作 / 观测」。对话与操作工作区保活不卸载；观测工作区首次动态挂载 `inspect-workspace.js`，切走 `setActive(false)` 暂停轮询。对话模式没有二级页签时直接隐藏空标签带与折叠按钮，不覆盖操作/观测已有的折叠偏好。产品观测入口（Night 深链、Recovery 全屏、InspectSplitPanel、对话卡片）一律写入 Console canonical hash（`/#/inspect...`），独立 `/inspect/#/...` 仅作兼容入口。
-- Console DAG 检查器「提示词重启」面板改为与检查器一致的卡片层级：版本选择复用自定义下拉；编辑模式与页签同款分段按钮；提交按钮用品牌橙药丸并吸底；追加/替换编辑区放到底稿前面，长底稿默认折叠以免把操作挤出视口。
-- Console「操作」模式新增人类专用的“更新并初始化”入口：默认更新 npm `latest` 稳定版，也可明确选择 `next` 预发布版；先 fail-closed 检查活跃 DAG/Worker/Chat/Console 操作与 npm 来源，再精确安装并验证所选版本、仅执行 `init update --apply-safe`，并以 hash-bound handoff 在原端口接棒新 Console。`latest` 保持稳定版且拒绝回退，`next` 仅在人工选择时允许精确 prerelease；渠道写入 operation 审计身份。Inspect 与模型工具均不能触发该写入操作。启动时不再在终端询问更新，页面会在接棒后自动刷新并通过新的 `consoleInstanceId` 识别实例。
-- 修复 Console 四处评审缺陷（合并前收口）：① 向导「运行」进度块接通——`runDag` 只返回 operationId，原实现读的 `recovery.dagRunId` 在向导路径永远为空；现在确认页先快照基线 run、进入运行页后轮询 `observeLink`，以 (taskId, operationId) 任一变化为失效信号（operationId 覆盖「重新运行」按钮——它不改变向导步骤；taskId 覆盖运行步骤中手动改任务 ID 的场景，失效时基线一并重置，避免沿用上一任务的 run）：新派发/切任务会清掉旧选中 run 并重新解析，**只接受与当前任务基线不同的新 run**；从 Recovery 带回的共享选中 run 先做归属校验——`GET /api/dag-runs/:id` 详情响应新增 `taskId` 投影（源自 run.json 的 `taskContractBinding`→`sourceBinding`→Hybrid 标题，与 observeLink/candidates 同一绑定真源，不受候选列表 limit 截断影响；404 视为失效选中、无绑定视为不可判定），非本任务的 run 不展示；校验全程由 effect 生命周期栅栏保护——任务/运行/选中在异步校验期间变化时，旧响应直接丢弃、不会改写新状态；校验暂不可用时按有界退避（2s→30s，约 2 分钟）自动重试而非被动等待状态变化，重试计划为纯函数并有行为测试；**展示层另有闸门**——进度面板与运行操作只消费「本解析器已采纳/已验证」的 run（组件 state），未验证期间（校验中、重试中、give-up 后）进度面板保持空缺，不会即时或永久显示其他任务的 DAG；「打开检视」「侧栏预览」两个入口同样双重门禁（按钮无已验证 run 即禁用 + 处理器复核 verifiedRunId），共享的 openInspectSplit 解析器不再能带出未验证的外来 run。解析决策本身抽取为纯状态机 `pages/tasks/run-id-resolution.ts`（首跑/重跑/切任务/外来选中/基线门控五类迁移），Effects 只做薄适配，主流程「确认页基线快照 → runDag 派发 → observeLink 轮询 → 新 run 采纳」有完整行为测试。基线快照为三态（成功/权威无运行/暂不可查），**查询失败不会被当成「没有历史运行」**——快照重试期间基线保持未知、探测轮询等待，不会把旧运行误判为新运行；新 run 创建失败或注册较慢时进度面板宁可空缺也不把上一次已终止的 DAG 当作当前运行（轮询上限 5 分钟后安静停止）。② 失败建议数据契约修正——旅程卡原先把原始 run 级 `failureCategory` 直接查归一化建议表（`missing-api-key`/`nonzero-exit` 等永远查不中，节点分类又在安全投影中被丢弃）；现在纯分类核心下沉 `src/shared/dag-failure-category.ts`（console↔workflows 双向共享叶，不破坏 console 禁止 import workflows 的边界测试），服务端投影把 run 级与节点级分类都归一化输出（success/skipped 不出），卡片按「失败节点分类优先、run 级兜底」取值，失败卡始终有可操作建议。③ Recovery interrupt 资格轮询在运行中档位同步刷新 run 状态——原先状态只在选中时读一次，运行中的 run 结束后仍永久保持 4 秒快轮询；现在 4 秒档附带轻量 `GET /api/dag-runs/:id` 刷新 `effectiveStatus`，终态后自动退到 30 秒。④ Inspect 紧凑检视一次瞬时刷新失败不再永久显示错误——成功刷新回合会清除上一轮 error 横幅。
-- Operator Chat 输入框两项交互增强：① **↑/↓ 历史输入召回**——每次发送的文本进入输入历史（连续重复折叠、上限 100 条），光标在首行按 ↑ 逐条向旧回溯、按 ↓ 向新前进，越过最新一条时恢复回溯前**未发送的草稿**（草稿不会被历史浏览冲掉）；多行文本中部的方向键仍是普通光标移动，IME 组词与 @文件/命令面板打开时不抢占。② **运行中排队下一轮指令**——当前回合运行中 Enter 不再被吞掉，消息作为「排队消息」绑定当前 Turn（服务端 `PUT deferred-turn` 从仅限 stopping 放开为 running/stopping，错误码 `TURN_NOT_STOPPING`→`TURN_NOT_ACTIVE`），当前回合结束（正常完成或停止）后自动发送；排队条提供「立即发送」（停止当前回复并立即发出）、「编辑」（移回输入框改写后再排）、「删除」三种操作，运行中输入框右侧提供排队发送按钮（与停止按钮并列）；排队条单行展示（状态 + 省略号预览 + 操作按钮一行），输入框默认一行高（自动增高上限 280px 不变）。
-- 向导「运行」面板结构化与预期管理（A2/C9）：新增实时运行进度块——节点完成计数与百分比进度条（含 progressbar 无障碍语义）、当前运行节点名称与已运行时长、失败节点与错误摘要，数据来自 `/api/dag-runs/:id` 每 5 秒轮询并在终态自动停止；`effectiveStatus=running-suspected-stall` 时显示橙色「疑似停滞」提示条（建议打开检视查看节点活动或到恢复页协作中止/诊断），把 20–40 分钟长跑的「日志噪音等待」变为有阶段感、可判断的等待。原始 SSE 事件日志默认折叠为「原始事件日志（最近 80 条）」，需要排查时再展开。
-- Console 前端三项体验优化（P0/P2）：① Recovery 页 DAG 紧凑检视侧栏（InspectSplitPanel）从一次性快照改为实时刷新——运行中每 5 秒自动拉取节点/事件并新增「进行中/已结束」刷新状态行，到达终态（finished/failed/partial_failed/superseded/abandoned）自动停止轮询，刷新轮不清空既有内容避免闪烁；② Chat 任务旅程卡失败态新增按归一化 failureCategory 的可操作「建议」行（validation/executor/write-guard/timeout/auth/human-required/human-rejected/shell-command/static-error/decision-envelope/unknown 各映射到具体下一步：从失败节点重跑、修正契约后重新生成、跳「模型与认证」页等），不再只报「原因分类为 X」；③ Recovery 页 interrupt 资格轮询退避：选中 run 已终态（含 interrupted）时从 4 秒降到 30 秒，运行中保持 4 秒。
-- Console 对话页 Models 面板的模型管理增强：以弹框形式增/改/删 Pi 的模型条目，支持 6 个定义字段（id、name、contextWindow、maxTokens、input、reasoning）。新增时 Provider 用下拉选择、其余字段自动补默认值；编辑时 Provider 只读且仅在原位置就地替换，只改表单内字段、不覆盖配置里页面未展示的其它字段（如 cost/compat）；不读写 API key（凭据走 Pi CLI）。编辑已存在的模型不再被移到最后。（该能力仅在对话页提供，设置页不再重复入口。）
-- 修复 `markdown-traceability` pipeline 未将冻结 `backendLayout` 传给 `validateBackendMarkdownTraceability`，自定义 layout 下不再回落默认 `testcase/md` ENOENT；新增回归用例以非默认 nested layout（`testRoot=testcase/elb/remote`、`markdownRel=md`）执行真实 shell pipeline，traceability 从自定义 Markdown 目录读取并 PASS，默认 layout 行为不变。（验证：`npm run typecheck`、`npx vitest run test/backend-test-markdown-workflow.test.ts test/backend-test-layout.test.ts`、`npm run build`、`git diff --check`。）
-- backend-test 快速补强（backend-test-fast-failclosed-attribution）：两处 fail-open 缺口已 fail-closed。① 当前轮次 Markdown 作用域严格依赖唯一有效 `## Module Index`——README 缺失 / 不可读 / `## Module Index` 重复（或缺标题）/ 唯一但空或不可解析任一状态，`markdownFiles` 与 coverage `markdownModuleFiles` 均返回空作用域而非回退全目录扫描，历史 `.md` 不再渗入 Case/coverage/partition facts，`resolveBackendTestManifestModules` 新增可区分 `manifestStatus`（valid/missing/unreadable/duplicate/empty-unparsable）与 `moduleIndexHeadingCount`，`validateBackendMarkdownCases` 与 `analyzeBackendTestCaseCoverage` 为非法状态各推 FAIL finding，默认与自定义 `backendTest` 布局一致。② collection 分类器不再凭 `__NNN_*` 裸 import 名称单独判 REPAIRABLE：inventory 构建时预计算每个 mapped script 的裸本地 helper import 证据（`scriptBareImports`），只有「存在同名 generated-local helper asset 且 mapped script 源码确实 import 该裸模块」才判 REPAIRABLE 并给精确 repairPaths；无 helper asset / mapped script 无对应 import / 无法精确归因一律 `BLOCKED`（`missing-generated-local-helper-without-evidence`。真第三方模块缺失保持 BLOCKED，不通过 PYTHONPATH/sys.path/conftest/ImportError fallback 绕行。（验证：`npm run typecheck`、backend-test 四聚焦 vitest、`npm run build`、`git diff --check`。）
-- backend-test 后续修复（backend-test-fast-manifest-import-fix）：Markdown 用例校验与 coverage 分析改为按 README `## Module Index` 清单限定本轮有效模块资产——未声明旧 `.md`（如 legacy.md）不再进入 Case/coverage/partition 统计，报告改为显式非静默 unmanifested advisory；“清单声明但文件缺失” fail-closed 明确失败，默认与自定义 `backendTest` 布局统一生效。generated pytest 裸本地 helper import（`from __551_manager_helpers import ...`）在 writer completeness gate 判为 recoverable 并给出精确 mapped 脚本 target path；collection 分类器对可归因到 mapped 资产的裸本地 helper `ModuleNotFoundError` 判 REPAIRABLE 并提供精确 repairPaths，真正第三方依赖缺失仍保持 BLOCKED。不放宽 self-contained、writeSet、forbiddenPaths、skip/xfail、断言与单次业务执行约束（验证：`npm run typecheck`、backend-test 聚焦 vitest、`npm run build`、`git diff --check`）。
-- 前端风险分级细分 manifest 触及语义：`allowedPaths` 含 `package.json`/lockfile 或需求文本提到 package.json 不再单独触发 `new-dependency` high-risk（改一行 script、调构建参数的任务不再被顶到强制全门禁并误标高风险），只有任务文本同时出现安装语言（npm install / yarn add / pnpm add / 新增依赖等）才升级；仅路径触及时记 `new-dependency:manifest-path-without-install-language` 拒绝信号，审计可溯。
-- 前端验证 fallback 生成期诚实化：真实项目无可读取的 `package.json` scripts 且未探测到本地 tsc 时，不再注入必然失败的 `npm run typecheck` / `npm run build` / `npm test`（纯静态 / vanilla JS 站点原会在 verify 阶段假失败），改为执行显式 no-op 标记命令（`No frontend verification command configured`，进入冻结命令集可被 contract 引用，trace 如实记录 not-run），并写生成期 advisory 提示用 `--verify` 或执行约束显式声明验证命令后重新生成 DAG。无 repoRoot 的单测 fixture 保留历史 generic fallback。**标记不构成验证证据（fail-closed）**：verification trace 将绑定标记的 target 判为失败、只含标记的 static 证据判为 unavailable，repair 分类归为 non-repairable `contract`，verify 节点以 `frontend verification unavailable` 硬失败阻断 review/closeout——无真实验证命令的 run 无法走完绿灯链。
-- frontend-test `passed` 回执链改按 dispatch 序号判序（B-HASH-01）：`summarizePlaywrightCliReceipts` 先按 `sequence` 排序再判 open→find→cleanup 连续链；并行 `find`/`screenshot` 按完成时间落盘导致的乱序不再误杀执行已通过的 case（Wave 1 实测 4 条 passed 被改判 `browser-command-evidence-missing`）。真 gap / 重复序号仍 fail-closed。
-- `tool-policy` 失败归一为 `executor`（B-REC-03）：前端 preflight 能力拒绝（缺 `@playwright/cli` JS entry、allowlist 拒绝）不再落 `unknown`→`manual-review`+`humanRequired`；`dag report` 给出 `rerun-after-fix`，Console `standaloneTaskRerun` 的 R2 gate 放行 run-failed 同 task 整单重跑，无需人工决策门或 sibling task。
-- Operator Chrome Band1 模式切换入口补显式 `aria-label`（B-FIND-01，方案 A）：`操作`/`观测` mode link 原为 inline-flex 裸文本节点，不参与 name-from-content，a11y snapshot 序列化为无名 link，`find` 无法断言；补 `aria-label` 后实测 `find "观测"` 1 命中、click 后 `find "运行总览"` 1 命中，AC-FE-CHROME-003 恢复可见断言路径。
-- Inspect 异常 Task 页空态文案统一（B-FIND-02）：`failures.js` 运行时空态由 `当前没有失败或阻塞的 Task。` 改回与静态 `#failures-empty`、页面标题及回归目录 AC-FE-INS-004 一致的 `当前没有异常 Task`，消除静态/运行时文案漂移；实测新文案 find 1 命中、旧文案 0 命中。
-
-- `next-release.yml` 防重复发布守卫补充幂等语义：`mode=recover`（dist-tags.next 已指向出自本 HEAD 的 tarball）时，手动 `workflow_dispatch` 重入不再撞 duplicate publish 硬失败，改为写 summary 后干净退出（§5.1 规则 4）；非 recover 的重复发布仍硬失败。
-
-- frozen repair 工具审计改为按 attempt 段扫描（B1）：`session-events.jsonl` 跨 attempt 共享追加，attempt>1 的 `auditRepairAttemptToolUse` 现在只审本 attempt 字节段（newline 对齐），planner attempt 1 的 ls/find 不再被误判给 repair 轮；repair prompt 显式声明 read-only 工具契约与 allowlist 边界（B2），并内嵌 openspec-citations 输出格式正例；`LOOP_AGENT_IGNORE_STALE_DIST=1` 环境变量旁路 stale-dist guard（B3），Console spawn 的 sibling CLI 可继承。
-- frontend plan/revision 结构化输出改为冻结 repair context + hash-bound canonical artifact：attempt>1 不再重放完整 planner prompt；成功后 stdout 只保留 artifact 路径，design review / prewrite 只消费已校验 artifact，不再从节点文本 merge。失败分类补齐 `structured-repair-exhausted` / `governance-blocked`，并修正 `structured-output-truncated` / `output-too-large` 的归一化映射。
-- 将 `@earendil-works/pi-ai` 与 `@earendil-works/pi-coding-agent` 从可选依赖提升为精确 pin 的运行时依赖 `0.83.0`，将运行时直接导入的 `typebox` 精确声明为 `1.3.7`，并在根包声明 Node.js `>=22.19.0`。安装 `@tea-agent/loop-agent` 会默认装上 Pi SDK（含 `--omit=optional` 场景）；`@cursor/sdk` 仍保持 optional。availability / readiness 探针、隔离 tarball canary、发布包契约测试与安装/本地环境说明同步对齐。
-- backend-test Scenario Partition 仅接受绑定源有限 enum/分类集合的 GET/list query/path 轴；非法 Domain（空/重复/保留 token、无有限域、与 OpenAPI enum 不一致）报 `INVALID_PARTITION_DOMAIN` / `NO_FINITE_DOMAIN` / `PARTITION_SOURCE_MISMATCH` 根因，不再生成空后缀 `TP-SP-...-`、重复 slot，也不再级联 `MISSING_*_SLOT`。N6 对这些根因码 fail-closed；合法源分区缺槽仍阻断。N2 禁止为自由串/主键/required-only/boundary-only 建分区；N5 允许删除无源非法 Partition 及其派生槽位。
-- npm `next` 渠道发布改为提交数节流：main push 仅当距上次 next 发布的 source commit ≥ 5 个 commit 时才自动发布（新增 `scripts/next-publish-gate.mjs`，读已发布 tarball build-stamp 对比 HEAD）；不足阈值时 workflow 绿色跳过，手动 `workflow_dispatch` 不受限（切 release 线前强制出包 / 紧急补发）。发布文档真源 §4.1/§5.1/§7/§12 同步。
-
-### 新增
-
-- Frontend source fidelity 生产 Pi 接线（2026-08-24-source-fidelity-production-pi-wiring）：真实 `task advance` 的 prepare-contract 主路径与 semantic-intake retry 路径现在对 `frontend-implementation` 任务注入生产 reconciliation executor 与独立 reviewer（`src/task/source-prepare/source-fidelity-pi.ts`）：叙述性/歧义片段按标题顺序串行、逐块 `budgetChars=4000` 有界调用，结构化显式 AC/checklist/table 片段仍走 `isStructuredMappableFragment` 代码映射且零 Pi 调用；context-only/duplicate/conflict 在 reconciliation 完成后的独立阶段由 Pi reviewer 审核（`LEDGER_REVIEW_MAX_REVISIONS=1`，第二次拒绝 fail closed）。接线侧门 = `taskKind === 'frontend-implementation'`（`input.taskKind` 优先，缺省回退 `loadTaskConfig`），ineligible 不接线、行为不变。模型队列镜像 semantic-intake（MED→HIGH→LOW + Pi SDK 目录），单次尝试沿用有界超时，工具面仅只读 read/grep/find/ls；模型输出经 validateOutput + zod 严格校验，无效 JSON/schema、越界 canonical ID、排除类 disposition 缺理由、队列空、执行失败/超时一律以稳定 `SOURCE_FIDELITY_*` 阻断码 fail closed，生产路径无确定性 reviewer 回退。Mock 策略 not-needed（无 HTTP API 面，Pi 为 CLI/SDK 模型路径，不添加 Mock 文件/依赖）；聚焦测试在 Pi 执行边界打桩（`vi.mock` / 可注入 `executePi` 桩，默认仍为真实 `executePiStep`），覆盖生产生命周期接线、reconcile→review 调用序、结构化零调用、fail-closed 阻断码与 ineligible 零调用。
-- Frontend 原始需求完整性门禁修复 v2（source fidelity ledger repair）：① DAG 绑定改读 Task Contract 已持久化的 `source/requirement-ledger.json`（与 intake/apply/prewrite 同一份受管账本的原始字节/hash/inputDigest），删除从 materialized reference path 重建 ledger 的逻辑；缺失/损坏/漂移 fail closed（`SOURCE_FIDELITY_LEDGER_MISSING`/`SOURCE_FIDELITY_LEDGER_STALE`）。② `dagSourceBindingSchema` 拆为 v1（strict 拒绝 ledger 字段）与 v2（schemaVersion=2，`ledgerPath`/`ledgerSha256`/`inputDigest`/`requirementToFragments` 全部必填）的 discriminated union，禁止 v1+optional 冒充 v2；契约级 sourceBinding 增加 all-or-none 约束。③ canonical source identity 单一边界：ledger `sourceDocuments[].path` 与 DAG 侧 `serializeDagTaskSourcePath`/`resolveDagTaskSourcePath` 一致（repo-root relative），路径不再二次转换进入 digest。④ 确定性分片补全：Markdown 表格数据行独立切分、跨文档稳定哈希 `REQ-SRC-*` ID（消除 per-document counter reset 碰撞、文档枚举顺序无关）、V4 `#### AC-*` 标题式显式 ID 原样保留并关联正文、fragment ID 防伪造校验。⑤ 顺序 reconciliation（`ledger-reconciliation.ts`）：可注入 executor 显式接口，仅叙述性/歧义 chunk 调用、按标题顺序串行、逐块有界，失败/无效返回/identity 越界 fail closed。⑥ 独立 reviewer（`ledger-review.ts`）：context-only/duplicate/conflict 独立审核（不同调用阶段），最多一次有界修订，低风险 context-only 仅 reviewer pass 放行、高风险始终阻断。⑦ human resolution 真正生效：与当前 inputDigest + conflict/fragment identity 匹配且 human-confirmed 的 resolution 解除 blocking conflict/unresolved 并保留 audit，stale/伪造/未确认不生效。⑧ Console/Observe 展示 v2 binding 语义（`binding=v2`、ledger sha256、inputDigest）与稳定 failure code；`GET /api/tasks/:id/ledger` 增加绑定语义字段（向后兼容）。
-- Operator Chat 时间线左缘新增「用户消息锚点栏」：每个用户输入一枚横向小条（12×3px 微圆角），紧凑等距排列并在时间线高度内垂直居中；条数超出栏高时相邻锚点自动聚合为稍宽的聚合条（悬停展开「N 条聚合输入」逐条列表，时间 + 单行预览，逐条点击定位）。悬停时小条向对话一侧平滑伸长（12→18px）并变橙，浮窗右侧弹出（白底圆角，正文最多 3 行、超出省略号，附序号与时间）；单击平滑滚动定位到对应消息（精确停靠在视口顶部偏移 8px）；覆盖视口顶部的锚点保持高亮。空会话自动隐藏；历史分页/流式更新/窗口缩放时自动重算（rAF 节流）。
-- frontend-test 产物根可配置：`task.json.frontendTest.testRoot` 缺省仍为 `testcase/frontend`，省略时生成的 DAG 路径与历史默认根一致；自定义根（如 `qa/frontend-test`）在编译期冻结并驱动 writer、gate、playwright 围栏与 `allowedPaths`。`.harness/**` 等隐藏/治理树在生成期拒绝。
-- 实验能力「编辑失败节点提示词后从节点重跑」默认开放：无需环境变量即可使用 `dag rerun --prompt-override <nodeId>@<file>`（全文替换）与 `--prompt-override-append <nodeId>@<file>`（追加指令：保留冻结原提示词，末尾追加 `<operator_addendum>` 块）；`HARNESS_DAG_RERUN_PROMPT_OVERRIDE=0|false|off` 保留为紧急关闭开关。仅限 ERROR 且位于 reset closure 内的节点；mode + base/最终 prompt sha256 计入 planHash（execute 漂移即 `PLAN_DRIFT`），父 run spec 冻结、provenance（含 mode）落 `continuation.promptOverrides`。Console 新增 `dagPromptOverrideConfig` 开关探测 action，`dagRerunPlan`/`dagRerun` 接受 `promptOverrides`（`{nodeId, prompt, mode?}`）；Inspect DAG 节点 inspector 新增「提示词重启」tab——默认「追加指令」模式（只读底稿 + 追加编辑器），可切换「全文替换（高级）」，预检通过展示执行估算，提交后续跑并跳转新 run，全程不离开图页；默认开启时 `/inspect` 只注入 **scoped** 变体凭据（独立 cookie + `__INSPECT_MUTATION_TOKEN__`，与 Console 通用 token 互不可重放），mutations 路由对 inspect 凭据仅放行 `dagRerunPlan`/`dagRerun`（其余 action 403 `ACTION_NOT_IN_INSPECT_SCOPE`），Inspect 不获得通用写能力；显式关闭时不注入任何 token、tab 不出现，检视面保持严格只读。
-- 观察面 DAG Inspector 节点详情适配 Pi 扩展：执行器输入摘要展示节点声明的 `piExtensions` 短 id；新增「Pi 扩展运行事实」展示 `pi-extensions.json` 的 resolved（包名@版本）与 missing 降级原因（缺包降级不再静默）；产物未生成/损坏时降级提示不阻断接口，绝对路径不外泄。
-- 后端实现 DAG（standard / review-gated / supervised）的 Pi 节点支持按桶显式加载本机 Pi 导航扩展：读侧节点（除 closeout）加载 `pi-codegraph` + `pi-lens`，写侧节点只加载 `pi-codegraph`（pi-lens 的 `ast_grep_replace` 可绕过 writeSet，不加载）；前端/测试模板与省略字段节点保持扩展全关。扩展发现始终关闭，只经白名单解析 `~/.pi/agent` 与项目 `.pi` settings 的已装包（缺包降级不失败，产物 `pi-extensions.json` 记录 requested/resolved/missing）；session 后 pin 工具面剔 builtin 同名、deny 面与写工具，writer 的 `edit`/`write` 仍为 policy-wrapped；`.codegraph/**` index 同步不再计入 write-guard 越界。
-- Pi SDK 终态 session-events JSONL 顶层增加可选 `finish_reason`：仅当 `message_end` / `turn_end` / `assistant_message` 明确携带非空终止原因时由序列化层提升，不伪造默认值，也不回流 `stopReason` 诊断。
-- `backendTest` 布局配置纳入 Task Contract managed 注入面：`task advance` 新增 `--backend-test <json>`，可在公共任务生命周期内把 `testRoot`/`markdownRel`/`scriptRel`/`sharedSetupDoc`/`mode`/`gapDoc`/`executeScope` 写进 `task.json`，不再需要手工编辑（手工编辑会让任务漂移成 `externally-modified` 并拒绝 `--approve-gate`）。给出即整体替换、省略即保留既有配置（历史手写配置因此自愈）、`'{}'` 为显式清空回默认布局；重复 advance 幂等，契约保持 `managed`。`task contract diff` 把值变更标 routine `BACKEND_TEST_CONFIG_CHANGED`、丢键/清空额外标 elevated `BACKEND_TEST_CONFIG_WEAKENED`。
-- Operator Chat 文件预览抽屉新增图标「新窗口打开」：用当前已加载内容在独立浏览器窗口打开全页阅读视图，窗口内可切换「预览 / 查看原文」（带宽高的 `window.open` popup，Markdown 排版、HTML 铺满视口的空 sandbox iframe、JSON pretty-print / 其它文本等宽滚动）；打开成功后断开 `opener` 且不立刻 revoke Blob，避免空白页；弹窗被拦截时 header 附近报错且不关闭抽屉
-- backend-test 适配 A–D：可配置 `backendTest` 布局（`testRoot`/`markdownRel`/`scriptRel`）、用户公共前置文档引用与模块顶部 `user_shared_setup`（不写 conftest）、查询轴 Scenario Partitions 确定性展开与 fail-closed 门禁、`mode=gap-fill` 13 节点增量 DAG。Slot ID 以声明的 Partition ID 为真源（`TP-<Partition ID>-...`）。
-- 前端 plan 唯一机器契约化（JSON-only）：`frontend-plan-pi` / `frontend-plan-revision-pi` 输出收敛为「一行导语 + 唯一 fenced `json` 契约 + 唯一 `openspec-citations` 引用块」，彻底移除「可选 Markdown 说明」；plan.md（`contracts/frontend-plan.md`）改由 prewrite gate 用纯函数 `renderFrontendPlanMarkdown` 确定性渲染（不新增 DAG 节点/不新增 Pi 调用）
-- 契约 schema 新增 5 个可选字段（`implementationSteps` / `stylingStrategy` / `dependencyPolicy` / `residualRisks` / `realIntegrationGap`），`schemaVersion` 保持 1；`docs/templates/frontend-implementation-contract.schema.json` 同步
-- revision 输出改为 RFC 7386 merge-patch delta + 引用块：gate 配置新增 `revisionPatch`，生效时在 `planFallbackFromNodeIds[0]` 原始契约上应用 `applyFrontendImplementationContractPatch` 后进入既有分析/规范化/物化管线；旧 DAG 缺字段按整契约处理
-- canonical contract 序列化（UTF-8）超过 64KB → `retryable-invalid` + 新增 `contract-too-large` failureCode（体积守卫兜底）
-- `design-review` / `final-design-review` 提示改为消费契约 JSON（注入契约字段摘要），不再要求读取 plan prose
-- Console「模型与认证」页新增模型矩阵编辑器：展示并允许编辑 `harness.json executors.pi` 的 LOW/MED/HIGH 三档模型；输入框从 readiness 结构化投影 `piModelMatrix` 预填（provider/model 或裸 model id），本地内联校验（空串 / `default` 哨兵 / 畸形 `provider/`、`/model`、`a//b`）非法时禁用保存；保存经既有 `POST /api/operator/v1/operations` 派发 `savePiModelMatrix`，复用 HTTP 层 `evaluateMutationGate`（boot capability cookie + `x-loop-console-confirmation` 头 + Origin/Host/Sec-Fetch-Site），读全文档后原子写 tmp+fsync+rename（保留 `$schema` 与其余字段），成功后自动重测 readiness 并对活动 Chat session 触发 `/sessions/:id/reload`（409 `PI_SESSION_BUSY` 给出可恢复提示）
-- `GET /api/operator/v1/readiness` 的 probe 新增 `piModelMatrix` 结构化投影（向后兼容，不改动既有 `modelsMessage`）
-- 组件选型规范合规（ADR 0016）：契约 schema 新增可选 `uiComponentChoices[]`（`{ purpose, component, decision(specified|reuse-existing|new), specReference{path,section,line}|null, rationale }`），`specified` 必须给非空 `specReference`、`new` 不得携带、空串拒绝；`schemaVersion` 保持 1；`docs/templates/frontend-implementation-contract.schema.json` 同步
-- `frontend-prewrite-gate` 新增三个 `retryable-invalid` failureCode：`component-spec-reference-invalid`（specReference.path 非受支持规范路径）、`component-spec-not-cited`（未在 openspec-citations 引用块引用或未真实读取）、`component-choices-missing`（组件/主题候选桶非空且契约有 UI 可见工作而 `uiComponentChoices` 缺失/空）
-- gate 配置新增可选 `componentSpecCandidatePaths`（旧 DAG 缺字段兼容）；`init-hybrid` 从 `designEvidence.classified.component ∪ theme ∪ rule.components` 冻结注入，capability context 强调组件/主题桶语义，plan/revision/design-review/final-design-review 提示加入硬规则与 BAD/GOOD 示例
-- `frontend-plan.md` 新增 `Component Selection (spec conformance)` 章节（纯函数确定性渲染，缺省 `_(not specified)_`）
-
-- `frontend-prewrite-gate` 的 OpenSpec 读取校验支持 `task.json.frontendOpenspec` 配置：`policy` 缺省 `cited`（候选 = `requiredReadPaths` ∪ 任务源显式引用的 openspec 路径），`scan-strict` 保留止血任务后的全量必读语义；`requiredReadPaths` 中非 openspec 支持路径在生成期确定性失败
-- 确定性引用块协议：生效 plan 输出在 fenced `json` 契约块后追加 `openspec-citations` fenced 块（每行一个 JSON `{"path","section","line"}`）；gate 解析并与生效 plan/review 节点的成功 read 事件核验，新增 `openspec-citation-block-unparseable` / `openspec-not-cited` / `openspec-citation-not-read` 三个 retryable-invalid failureCode（防捏造、防遗漏）
-- `src/shared/openspec-spec.ts` 新增 `extractTaskSourceOpenspecPaths` 纯函数（反引号内联、markdown 链接目标、裸路径 token → 归一化 → spec 过滤 → 治理子树排除 → 去重排序）
-- 生成期把 `openspecPolicy` 与候选来源元数据（`openspecCandidateSources.declared` / `taskSourceCited` / `scanStrict`）冻结进 prewrite gate 配置；`task advance` 的 advisories 说明当前模式与候选来源
-
-### 改进
-
-- Windows 上读取运行中的 DAG `state.json` / `run.json` / `interrupt.json` 时，对原子替换窗口内的短暂文件占用与半成品 JSON 做有界重试；Console 协作中止不再因杀毒软件或文件系统竞争偶发误报输入非法。I/O preflight 测试同步采用与该资源分组一致的 60 秒上限，避免进程启动压力造成假失败。
-- 检查器「提示词重启」只读态的提示词卡片会撑满剩余高度并在卡片内滚动，不再在面板底部留下大块空白；失败节点的可编辑布局不变。
-- DAG 节点表「备注」改为节点用途简介（是什么、做什么、目的），不再重复节点 ID；失败节点仍显示错误摘要。检查器标题与图节点悬浮提示同步展示同一句说明。
-- 实验「提示词重启」会为 Pi 节点的每次失败 attempt 保存独立、脱敏且 64 KiB 有界的提示词候选；Inspector 始终展示提示词版本选择框，新 run 会列出冻结原始提示词与全部失败尝试（含自动重试产生的恢复提示词），历史 run 未保存候选时明确说明，成功尝试不混入。提示词卡片右上角提供复制图标并以勾选图标反馈成功；已截断候选复制时明确标记为截断预览，并保持只读、禁止直接提交，避免用不完整提示词发起续跑。选择失败候选会载入「全文替换」编辑器；即使节点后续自动重试成功，历史失败候选仍可只读切换查看。
-- DAG 节点检查器「执行过程」按执行器分流：Pi 仍看 session-events；有命令的 shell 展示 `shell-command-receipt` 与 stdout/stderr；`frontendBrowserToolPreflight` 等内部处理器展示步骤回执（历史 run 可从 capability / attempt 产物合成）。空态不再把 shell/static 误说成「暂无过程日志」。节点输入补充 named handler 名称。脚本仍属于节点输入，不假装已执行。
-- DAG 节点检查器「节点输出」在整段内容为完整 JSON 对象或数组时改为缩进代码块展示，不再把紧凑 `JSON.stringify` 挤成一段 Markdown 段落；截断或非法 JSON、普通 Markdown 仍走原阅读器。
-- frontend DAG 的 materialized source references 恢复统一的有界 excerpt 与按需 read 指针，不再把 requirement/acceptance 文档全文复制进每个相关节点，也不再强制 contract/plan 重读全部绑定源文件，降低长需求在多节点中的重复上下文占用。
-- frontend-test prepare-package 会从 `docs/templates/`、`harness.json` `governanceRoot`/templates 以及 init 投影的 `ai_workspace/loop-agent/templates/` 拷贝标准场景；full init 目标仓不再静默落到仅含 `STD-FE-SMOKE-ENTRY` 的 fallback。
-- frontend-test 环境探测区分 connection-refused（curl 7）与 HTTP 4xx/5xx，并提示先启动本地前端后再从 probe 节点续跑；不再把所有不可达都写成同一句 `frontend-base-url-unreachable`。
-- frontend-test 报告解析用例 Markdown 的 `##`/`###` 标题与有序列表（`测试步骤` / `预期结果` / `前置条件与重置`）；缺 `测试目的` 时回退到用例 H1，避免主 HTML 出现空步骤。
-- `dag rerun --from-node` 把尚未启动的 writer/map 视为首次执行；frontend-test probe 这种失败的 exclusive shell 可以带着下游未跑节点续跑，不必整图 `standaloneTaskRerun`。
-- Pi SDK 节点在 stall watchdog（默认 15 分钟无 provider 活动）触发后，会先 abort 当前等待，并在同一会话自动发送一次「继续」；仅 abort 已确认且尚未调用 write 工具时恢复，失败仍判 timeout。绝对墙钟超时与 CLI 后端不走这条恢复。
-- DAG 节点检查器「执行过程」时间线默认隐藏原始协议事件（`message_start` / `message_end`），按钮文案为「展开原始协议事件」；用户可点选展开，同会话内选择会保持。
-- Operator Chat 的乐观停止现在把“视觉已停止”和 Turn ownership 分开：Abort 获得可靠终态前明确显示“正在停止”，此时可为原会话保存一条服务端持久化的“停止后发送”消息；后一次覆盖前一次，切换会话、刷新页面或 Console 重启不会丢失，旧 Turn 结束后复用正常 Turn 准入路径自动发送，并以固定 `clientRequestId` 防止重复执行。
-- Operator Chat 修复快速终止时“停止后发送”与普通发送之间的准入空洞：发送路径改读实时 ownership；若 deferred 请求恰好撞上旧 Turn 终态，会先按服务端状态对账，再使用同一 `clientRequestId` 自动转为普通发送，不再要求用户刷新重试或丢失本次提交。
-- `dag rerun-task` 现在会把父 run 最后一轮仍未解决的 `verify-pi` / review 反馈、证据引用和修订轮次带入新完整 DAG；planner、implementer 与 verifier/reviewer 必须修复或举证说明不再适用，不能仅因文件已存在就返回 `already-satisfied`。Console 同步区分「自动修订」「从失败节点恢复」「带反馈重新执行任务」。
-- DAG 恢复与治理收敛收窄为两条最小路径：标准治理 `request-revision` 仅在 `maxFixLoops > 0` 时同 run 回到 `implement-pi`；writer 遇到 `unavailable` / `network` / `rate-limit` / `timeout` 时，`dag rerun --from-node` 重跑 writer 本身及安全下游，不再把 parent `ERROR` 改写成 `FINISHED`，任意自定义 shell 也不能仅凭 `verifyEvidence` 获得续跑资格。
-- `frontend-plan-pi` 改为 runtime skeleton + editable RFC 7386 patch：`schemaVersion`、source binding、risk、writer target files 与生产 Mock 安全位由 DAG 冻结且不可被 plan/revision 覆盖；节点 validator 将补丁编译为 canonical 完整契约后再交给 review/prewrite，并在 `contracts/candidates/<nodeId>/` 保存每次 raw/extracted/normalized/validation 证据。任务提示与三类结构化重试（invalid-output / provider length 截断 / output-too-large）同步收敛为单一 patch + 唯一 `openspec-citations`；无法在声明文件中解析的可选 verification symbol 会被确定性移除并留下 normalization action，避免格式冲突、完整契约重复输出和说明性 symbol 延迟到 trace 才失败。
-- Operator Chat 恢复工具对齐真实能力：系统提示改用 `dagReport` / `dagRerunPlan` / `dagRerun` / `standaloneTaskRerun` / `workerTaskRetry` 真名，不再写 `operator_*` 或把 `dagResume` 当成模型可执行项；`dagDoctor` / `dagStatus` / `workerPoolDoctor` 改为 typed `runId`/`taskId`，不再让模型猜 CLI `args[]`。ADR 0013 自定义 base prompt 上限由 1900 统一调整为 2500（2026-08-18，废止 0.8×2498 比例），预算用于写清节点续跑 / 整单重生 / Worker 重排队分流，以及多轮迭代恢复纪律（先一句话总结上一轮错误、修根因不修症状、禁止原样重交、同错两轮后停下报告）。
-- Operator Chat 模型工具面收敛：`advanced` 分类的命令（workflow/loop/benchmark/knowledge-graph 等 8 个只读低频入口）不再进入模型工具白名单，模型注意力集中到高频工具；保留的 27 个 model-callable 官方 CLI 动作全部换上「做什么 + 何时用」语义描述，不再是无信息的 `Official CLI action coverage for ...` 模板；dispatcher 对官方尾部动作的识别从描述前缀匹配改为结构化 `OFFICIAL_TAIL_ACTION_IDS` 集合判断。审查收口：`knowledgeCurate` 纠正为 `mutation`/`advanced`（条件写盘，移出模型面，防经 read 通道传 `--output` 写盘）；`promoteRun`/`closeoutTask` 描述去掉 dispatch 不保证的生命周期断言，如实标注为 task-advance 别名并提示先核 run/任务状态。工具清单渲染修复：promptSnippet 去掉重复工具名前缀（SDK 渲染自带 `- name:`，原实现名字出现两遍）；`inspect`/`status`/`spineCheck`/`sourceInstructions` 四条占位描述换成语义描述；task-advance 家族（`newTask`/`dagRunTask`）标注与标准流 `taskAdvance` 的关系，避免模型在 5 个相似入口间选错。可调用性修复：`observeLink` 补上 4 个可选参数 schema（dagRunId/taskId/featureId/workerRunId，原空 schema + additionalProperties:false 导致模型传参必被拒、工具名存实亡）；Pi 工具参数 schema 现在携带注册表里的参数描述（Type.String/Boolean/Number/Array 注入 `description`，原实现丢弃参数描述、模型只能看到参数名）。
-
-- Operator Chat 对齐 pi-web：建会话不再传封闭 `tools` 白名单（避免 SDK 把扩展 MCP 工具滤出 registry），创建后 `bindExtensions` 发 `session_start`，再钉激活集。扩展注册的 MCP 工具可被模型调用；`apply_patch` / `full-tools` / `shell` / `coding-chat` 仍排除。
-- 对话侧栏 Plugins 右侧新增只读 MCP 弹窗：展示 `mcp.json` 配置的服务，以及当前会话真正注册/激活的 MCP 工具；没有配置也没有工具时保持真实空态。
-- 对话侧栏原 Packages 入口改名为 Plugins，与 pi-web / Pi 用户面一致；内部仍是 package inventory。
-- 对话进行中底部上下文占用百分比保持常驻：token 用量事件不再冲掉上一帧的 contextUsage，并在回合中持续刷新。
-- 上一轮大量 bash 结束后再发新消息，旧工具条不再整批挂到新气泡下面：无主工具不再丢进最新一组，历史按完整回合裁切，空助手气泡若还挂着工具会留下来当锚点。
-- 侧栏文件树点击目录行直接插入 `@目录/` 引用（箭头单独负责展开/收起）；输入框 @ 补全也列出目录，排在文件前面。
-- 对话进行中点「停止」立即安静下来（乐观停止，对齐 pi-web）：不再等 POST /abort 往返；后端 abort 等待从 8s 降到 2.5s，未终结时由状态对账收敛。
-- 侧栏文件树实时刷新：agent 回合结束、浏览器标签页回到前台、手动点「刷新」时重拉根目录+全部已展开目录（此前手动刷新只拉根目录，子目录永远旧缓存）。
-- Skills / Packages / Models 面板不再把 Pi 的 warning / collision 原文堆在列表上方：改成标题条一颗摘要芯片（如「14 条提示」），点开按「需要处理 / 名称不规范 / 同名未生效」分组，文案用自然语言，路径只显示末两段；名称不规范的技能在列表旁标「提示」，详情里说明「现在这样也能用」。加载失败仍单独成组，可点「再读一次」。
-- Skills / Packages 双栏改为左右各自滚动；资源弹窗挂到 `document.body`，按顶部对话导航的实时高度在剩余视口居中，不再被 sticky 顶栏挡住上沿。
-- 标准、评审和监督型 DAG 现在会在当前运行中重试短暂的验证故障；写入节点只有在确认工作区完全未变更时才会重试，避免因网络波动重新执行整条任务。
-- 后端测试支持自定义目录、公共前置说明、查询场景分区和增量补缺模式；相关布局可通过 `task advance --backend-test` 纳入受管任务契约，不再需要手工修改 `task.json`。
-
-- 裸 `agent-worker console` 在 listen 前会按本机自然日询问一次 npm `latest` 升级；继承当前 npm registry，失败不阻断启动，Console URL 仍只写 stdout。
-- npm `next` 发布成功后会更新 `npm-next` 分支锚点；可用 `loop-agent inspect next` 查看已发布版本、源码提交、构建时间和本地尚未发布的提交。
-- Operator Chat 的文件预览可在新窗口中打开，并可切换排版预览与原始内容；弹窗被浏览器拦截时会保留当前抽屉并给出提示。
-- Pi SDK 的会话事件可透出模型明确返回的结束原因，便于诊断截断、停止和异常结束。
-
-- 初始化模型配置新增 Pi/OpenCode 脱敏目录：代码只暴露白名单模型元数据和凭据就绪状态，执行初始化的模型结合目标项目自主选择并直接写入 LOW/MED/HIGH；只有实质歧义才询问用户。
-- npm `next` 自动发布改为每累计 5 个提交触发一次，减少无意义构建；手动发布仍可随时执行。
-- `dag rerun-task` 会继承上一轮尚未解决的验证和评审反馈，避免新一轮忽略旧问题或误判为已经完成。
-- DAG 恢复入口会根据失败类型区分“从节点继续”和“完整重跑”，并避免把失败节点改写成成功状态。
-- Operator Chat 停止会话时会显示真实进度；用户可预先提交一条“停止后发送”的消息，刷新页面或重启 Console 也不会丢失。
-- Operator Chat 的命令说明和参数提示与实际能力保持一致，减少选错恢复入口或误用占位参数。
-- 测试套件按 CPU、内存、平台和当前 DAG 压力动态分配资源，并减少重复启动进程，完整验证耗时更稳定。
-
-### 修复
-
-- backend-test 用例覆盖分析的 payload 形状提取在无 `python` 可执行文件的环境（现代 macOS 只有 `python3`）静默降级为空结果，导致 payload 观测路径全空、`PAYLOAD_SHAPE_MISMATCH` 误报；解释器解析改为 POSIX 优先 `python3`、Windows 优先 `python`（与 scenario-param 语法校验一致），仅在解释器缺失时尝试下一候选，分析输入自身的失败不再重试。
-- Inspector「执行过程」时间轴按「执行分次」选择过滤：session-events 是跨 attempt 共享追加的单文件，此前所有次执行的事件重合显示、切换顶部分次不生效；现在按 `agent_start` 边界分段，选中第 N 次执行只显示该段并标注「已按第 N 次执行过滤 · 共 M 次执行」，单次执行与 pass 选择保持全量展示，检测不到边界时显式提示并回退全量。
-- 前端 plan/revision 的 `openspec-citations` fence 提取改为行锚定正则：直接闭合的空 fence（无候选行、紧跟关闭 fence）此前被判定为「不存在 citation 块」而进入格式重试循环，现在计为合法的唯一 citation 块；重复、损坏或非唯一的 fence 仍被拒绝。
-- `npm test` 前置段失败导致后续段（io-heavy / integration）被跳过时，`scripts/run-tests.mjs` 显式输出警告与补跑命令，不再静默跳过（此前失败汇总会被误读为全量覆盖）。
-- npm 包现在会包含 `inspect next` 运行时依赖的查询脚本，安装后的 CLI 不再因缺少包内文件而无法启动。
-- 初始化更新改为一次扫描与规划：固定投影按 recorded ownership 确定性增删改，多个语义合并按单文件写边界串行排队，全部完成后只做一次最终验证；已完成的 `--status` / `--report` 只读取哈希锚定证据，不再重复运行项目脚本。`harness.json` 按属性结构演进并保留项目值，仍存在于 Pi 的 LOW/MED/HIGH 保持不变，只重选失效档位；fresh init、update 与 doctor 会在 Pi 无可用模型时提前阻断。
-- CLI 新版本检查与 `init upgrade` 的版本门禁会从调用开始就使用 npm 当前配置：目标项目 `.npmrc`、用户级/全局 `npm config set registry`、环境变量与 scoped registry 均继续由 npm 按原生优先级解析；企业镜像失败时不会偷偷回退官方源，并以脱敏原因区分超时、npm 启动失败、查询失败和无效响应。
-- 同一浏览器、同一 hostname、不同端口的多个 Operator Console 不再争用认证 Cookie；不同项目和同一项目的多个 Console 可以并行对话，往返页面无需刷新。Console 重启后旧页面仍会被安全拒绝，刷新后恢复。
-- Markdown 表格只处理横向溢出，鼠标停在表格上时仍可正常上下滚动对话。
-- Windows 上执行后端测试场景参数的 Python 语法检查时，会跳过不可用的 Microsoft Store 占位程序，避免错误回滚合法改动。
-- 旧版前端 DAG 也能识别增量计划修订，不再因契约格式差异反复重试；无法合并的修订会提示重新生成 DAG。
+- Operator Chat 现在可以在同一个页面管理多个工作区；每个会话始终使用创建它的工作区，切换对话时地址栏保持简洁稳定。
+- 对话消息流整体调整为更紧凑、清晰的布局，思考过程、工具执行、阶段性结果和最终回答会按真实发生顺序展示。
+- 上下文过大时会自动压缩并继续原请求，消息流会依次展示触发原因、压缩进度和压缩结果；手动压缩也使用同一套展示方式。
+- 对话进行中可以连续提交多条消息，并支持编辑、删除或立即插入当前回复；刷新页面或重启 Console 后，未发送内容仍会保留。
 
-### 文档
+### 新增
+
+- 右侧辅助栏统一承载文件、上下文、调用记录和当前 DAG，可自由调整宽度；文件预览采用内容与文件树并排布局。
+- 新增任务清单与结构化提问卡片，让长任务的进度和需要用户选择的内容更容易理解。
+- 「对话 / 操作 / 观测」使用统一导航；操作和观测页面可以切换工作区查看对应数据。
+
+### 改进
+
+- 后端测试的计划与生成阶段只读取任务明确绑定的需求、环境报告和本轮产物，减少无关仓库内容干扰结果，并让后续步骤继续使用同一份已确认计划。
+- Operator Chat 的任务清单工具描述补齐多步骤与 DAG 使用纪律：开始前按具体步骤规划、保持进行中约束、完成后立即更新完整列表，并用面向用户的阶段呈现 DAG 进度，简单任务自动跳过。
+- 正式发布会自动同步更新版本日志和文档站摘要；发布说明优先生成简洁自然的中文，生成服务不可用时也能安全完成发布。
+- 输入框整合模型与推理等级选择，并只展示有真实数据的轮次、耗时、速度和缓存统计。
+- 工作区、会话列表、文件标签和侧栏交互更加紧凑自然，折叠、切换和页面过渡更加流畅。
+- 设置页改用自然中文展示当前工作区的模型状态，减少内部状态和重复信息。
+- DAG 检查器简化节点说明、执行记录和提示词重启面板，长内容更容易阅读和定位。
+
+### 修复
+
+- 修复重命名会话时输入框没有回显当前标题的问题。
+- 修复停止回复后输入区恢复迟缓、排队消息偶发丢失，以及切换会话后旧状态残留的问题。
+- 修复宽表格、文件预览、滚动条和窄屏布局中的多处显示异常。
+- 修复部分 Windows 环境读取运行状态时的偶发失败，并提高前后端任务验证的可靠性。
+
+## [0.39.1] - 2026-08-25
+
+### 重点更新
+
+- 前端实现流程会逐项核对原始需求与验收标准，减少长需求被遗漏、误解或静默排除的情况。
+- Console 新增可选择稳定版或预发布版的更新入口，更新前会检查正在运行的任务，完成后自动恢复当前页面。
+
+### 新增
+
+- DAG 检查器可以查看失败节点的提示词版本，并在确认后从选定内容重新执行。
+- 后端测试会核对本轮文件清单与实际引用关系，避免历史文件或错误依赖混入测试结果。
+
+### 改进
+
+- 设置页移除重复的模型配置入口，模型管理继续集中在对话页。
+- 关键治理文档完成复核，当前能力、限制和操作方式保持一致。
+
+## [0.39.0] - 2026-08-23
+
+### 重点更新
+
+- Operator Chat 支持通过方向键找回历史输入，并可在当前回复进行时预先排队下一条消息。
+- 任务向导新增实时进度、当前节点、运行时长和失败摘要，长时间任务更容易判断是否正常推进。
+
+### 新增
+
+- 前端测试支持自定义测试目录和文件布局，适配不同项目结构。
+
+### 改进
+
+- 运行结束后会自动降低刷新频率，并为失败状态提供更直接的处理建议。
+- npm 预发布包会记录准确版本，安装后显示的版本与实际发布制品保持一致。
+
+## [0.38.4] - 2026-08-23
+
+### 重点更新
+
+- 初始化与升级流程更好地支持企业 npm 镜像、已有模型配置和一次性安全更新。
+- Console 与 DAG 检查器补充了运行状态、失败节点和提示词重启等诊断能力。
+
+### 新增
+
+- 新增 `inspect next`，可以查看当前 npm 预发布版本对应的源码和本地尚未发布的变化。
+- 前端测试可以从项目治理目录和初始化模板读取标准场景，并提供更完整的执行报告。
+
+### 修复
+
+- 修复 npm 包缺少运行文件、macOS Python 命令差异、Windows 场景检查和部分滚动显示问题。
+- 修复前端计划引用、失败恢复和测试回执在复杂项目中的多处误判。
+
+## [0.38.3] - 2026-08-22
+
+### 重点更新
+
+- Operator Chat 的文件预览可以在新窗口打开，并能在排版预览与原始内容之间切换。
+- 长时间模型任务遇到输出截断或暂时停滞时，恢复过程更加可靠。
+
+### 新增
+
+- 安装 loop-agent 时会默认包含 Pi 运行能力，减少额外配置步骤。
+- DAG 检查器可以查看不同执行器的运行过程和更清晰的节点输出。
+
+### 改进
+
+- 后端测试增强了自定义目录、场景分区和生成文件的校验。
+- 文件浏览、结束原因和前端计划恢复信息更容易查看和诊断。
+
+## [0.38.2] - 2026-08-20
+
+### 重点更新
+
+- 后端测试支持自定义输出目录、公共前置说明、查询场景分区和增量补缺模式。
+- Operator Chat 的停止与后续发送更加可靠，停止过程中提交的下一条消息不会因刷新或重启丢失。
+
+### 改进
 
-- 整理 `0.36.0` 以来的更新日志，改为面向用户描述结果，并补齐 `0.38.0`、`0.38.1` 的正式发布记录。
-- 新增检查以阻止纯英文条目、重复版本、版本倒序和非标准 `Unreleased` 标题。
+- DAG 重新执行时会继承上一轮尚未解决的验证和评审反馈，减少重复失败。
+- 恢复入口会根据失败原因选择从节点继续或完整重跑，并给出更明确的操作建议。
+- npm 预发布改为按提交数量节流，减少没有必要的重复发布。
 
 ## [0.38.1] - 2026-08-18
 

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.40.0-next.7",
-  "gitSha": "59deccb31726ce014324385bd26a5558c5ed7a49",
-  "builtAt": "2026-08-27T14:04:40.295Z"
+  "version": "0.40.0-next.8",
+  "gitSha": "e0f67bfb9ec26c1df24ddf3e6b0213dcb3513bb6",
+  "builtAt": "2026-08-27T18:02:05.269Z"
 }

package/dist/worker/console/chat/chat-event-store.js

@@ -231,6 +231,10 @@ export function projectCompactSnapshot(value) {
         Number.isFinite(record.tokensBefore)
         ? Math.max(0, Math.floor(record.tokensBefore))
         : undefined;
+    const estimatedTokensAfter = typeof record.estimatedTokensAfter === "number" &&
+        Number.isFinite(record.estimatedTokensAfter)
+        ? Math.max(0, Math.floor(record.estimatedTokensAfter))
+        : undefined;
     const details = record.details === undefined
         ? undefined
         : boundedRedactedJson(record.details).preview;
@@ -239,9 +243,16 @@ export function projectCompactSnapshot(value) {
         summary,
         ...(firstKeptEntryId ? { firstKeptEntryId } : {}),
         ...(tokensBefore !== undefined ? { tokensBefore } : {}),
+        ...(estimatedTokensAfter !== undefined ? { estimatedTokensAfter } : {}),
         ...(details ? { details } : {}),
         previewHash: createHash("sha256")
-            .update(JSON.stringify({ summary, firstKeptEntryId, tokensBefore, details }))
+            .update(JSON.stringify({
+            summary,
+            firstKeptEntryId,
+            tokensBefore,
+            estimatedTokensAfter,
+            details,
+        }))
             .digest("hex"),
     };
 }
@@ -785,6 +796,7 @@ export function createChatEventStore(options) {
                 "assessment",
                 "taskKind-confirmed",
                 "human-gate-card",
+                "compaction_end",
                 "compact",
                 "artifact-ref",
             ]);

package/dist/worker/console/chat/pi-runtime.js

@@ -376,7 +376,7 @@ async function buildAskUserQuestionTool(options) {
         },
     });
 }
-const TODO_WRITE_DESCRIPTION = "Record and update a structured task list for the current work. Send the ENTIRE list every call — it REPLACES the previous list. Use it for multi-step work; skip trivial single-step tasks. Mark tasks pending, in_progress, or completed, and mark completed immediately when done.";
+const TODO_WRITE_DESCRIPTION = "Record and update a structured task list for the current work. Send the ENTIRE list every call — it REPLACES the previous list (no partial updates, no per-item edits). Before starting multi-step work, add one todo per concrete step. Keep at least one todo `in_progress` while work remains. Mark a todo `completed` immediately when it is done (do not batch completions) and resend the full list as progress or DAG state advances. Skip the list for simple Q&A, read-only lookups, and single-step tasks. Use it for multi-step implementation and whenever you prepare, run, or supervise a DAG — call `todo_write` before entering the DAG tool chain. Phrase DAG todos as user-facing phases users can understand, not copies of internal DAG nodes. Statuses: `pending` / `in_progress` / `completed`.";
 async function buildTodoWriteTool(options) {
     const [{ Type }, { defineTool }] = await Promise.all([
         import("typebox"),
@@ -2216,6 +2216,7 @@ export class ConsolePiRuntime {
             let firstTokenAt;
             let pendingProviderError;
             let providerErrorEmitted = false;
+            let activeCompaction;
             const emitPendingProviderError = () => {
                 if (!pendingProviderError)
                     return;
@@ -2225,7 +2226,18 @@ export class ConsolePiRuntime {
             };
             unsub = session.subscribe((event) => {
                 const observedAt = Date.now();
-                const mapped = mapSdkEvent(sessionId, event);
+                if (event.type === "compaction_start") {
+                    activeCompaction = {
+                        compactionId: newCompactionId(sessionId),
+                        reason: event.reason,
+                    };
+                }
+                const compactionId = event.type === "compaction_start" || event.type === "compaction_end"
+                    ? activeCompaction?.compactionId ?? newCompactionId(sessionId)
+                    : undefined;
+                const mapped = mapSdkEvent(sessionId, event, compactionId);
+                if (event.type === "compaction_end")
+                    activeCompaction = undefined;
                 if (mapped?.type === "error") {
                     // Pi represents provider failures as an assistant message_end and may
                     // retry internally. Hold the candidate until the SDK says the attempt
@@ -2237,8 +2249,15 @@ export class ConsolePiRuntime {
                 }
                 if (mapped?.type === "message_end")
                     pendingProviderError = undefined;
-                if ((mapped?.type === "agent_end" && !mapped.willRetry) ||
-                    mapped?.type === "agent_settled") {
+                if (mapped?.type === "compaction_end" &&
+                    mapped.reason === "overflow" &&
+                    mapped.status === "completed" &&
+                    mapped.willRetry) {
+                    // The overflow error was a recoverable attempt fact. Pi has already
+                    // committed the compacted session and scheduled the continuation.
+                    pendingProviderError = undefined;
+                }
+                if (mapped?.type === "agent_settled") {
                     emitPendingProviderError();
                 }
                 if (mapped?.type === "agent_start") {
@@ -2499,7 +2518,7 @@ function mapAssistantMessageEvent(type, sessionId, message) {
         ...(content.length > 0 ? { content } : {}),
     };
 }
-function mapSdkEvent(sessionId, event) {
+function mapSdkEvent(sessionId, event, compactionId) {
     switch (event.type) {
         case "agent_start":
             return { type: "agent_start", sessionId };
@@ -2540,10 +2559,56 @@ function mapSdkEvent(sessionId, event) {
             };
         case "agent_settled":
             return { type: "agent_settled", sessionId };
+        case "compaction_start":
+            return {
+                type: "compaction_start",
+                sessionId,
+                compactionId: compactionId ?? newCompactionId(sessionId),
+                reason: event.reason,
+            };
+        case "compaction_end": {
+            const snapshot = event.result
+                ? projectCompactSnapshot(event.result)
+                : undefined;
+            return {
+                type: "compaction_end",
+                sessionId,
+                compactionId: compactionId ?? newCompactionId(sessionId),
+                reason: event.reason,
+                status: event.aborted
+                    ? "aborted"
+                    : snapshot
+                        ? "completed"
+                        : "failed",
+                ...(snapshot
+                    ? {
+                        summary: snapshot.summary,
+                        ...(snapshot.firstKeptEntryId
+                            ? { firstKeptEntryId: snapshot.firstKeptEntryId }
+                            : {}),
+                        ...(snapshot.tokensBefore === undefined
+                            ? {}
+                            : { tokensBefore: snapshot.tokensBefore }),
+                        ...(snapshot.estimatedTokensAfter === undefined
+                            ? {}
+                            : {
+                                estimatedTokensAfter: snapshot.estimatedTokensAfter,
+                            }),
+                    }
+                    : {}),
+                willRetry: Boolean(event.willRetry),
+                ...(event.errorMessage
+                    ? { errorMessage: redactRuntimeText(event.errorMessage, 600) }
+                    : {}),
+            };
+        }
         default:
             return undefined;
     }
 }
+function newCompactionId(sessionId) {
+    return `${sessionId}:compaction:${randomBytes(8).toString("hex")}`;
+}
 async function waitForIdle(session, options) {
     // Default 45s — shorter than the previous 120s so a stuck SDK session does
     // not pin an HTTP connection for two full minutes. The SDK agent turn