@tea-agent/loop-agent 0.39.0-beta.8 → 0.39.0-beta.9

package/AGENTS.md

@@ -41,7 +41,7 @@
 4. 涉及测试纪律/验证声明/调试时继续读：`docs/governance/harness-methodology-*.md`。
 5. 查看最近提交、相关 plan/progress/report；`git status --short --branch`；跑最小基线验证。
 6. 后端/接口/pytest → `taskKind: "backend-test"`（不是 `--profile`）；知识回写 `knowledge-sync`；图谱开荒 `knowledge-graph-bootstrap`。`--profile` 仅 `auto|minimal|standard|reviewed|supervised`。
-7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；listen 成功后默认打开系统浏览器，`--no-open` 禁止）（`/inspect/` 只读；唯一实验例外：`HARNESS_DAG_RERUN_PROMPT_OVERRIDE=1` 时节点 inspector 出现「提示词重启」tab 并注入 mutation token，默认关闭时零 token 零 tab）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
+7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；listen 成功后默认打开系统浏览器，`--no-open` 禁止）（`/inspect/` 只读；唯一实验例外：节点 inspector 默认出现「提示词重启」tab 并注入 scoped mutation token；设置 `HARNESS_DAG_RERUN_PROMPT_OVERRIDE=0|false|off` 可紧急关闭，此时零 token 零 tab）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
 8. 分支合并 → 先读 `docs/operations/branch-merge-guideline.md`。
 9. 涉及版本发布、npm 渠道、release 分支、GitHub Actions 发布链或 dist-tag → 先读 `docs/operations/version-and-release-management.md`。
 

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+- 修复前端 DAG 的新增组件选型契约：任务源/PRD 明确要求新增的组件现在以 `decision=new` 携带可追溯的 PRD `specReference` 通过 schema、design policy 与兼容 prewrite gate；OpenSpec 候选与读取证据校验仅约束 `specified` 组件，避免 `TaskSourceBadge` 一类计划在 writer 前自相矛盾地失败。
+
+- 前端 DAG 的注入合同与运行时对齐：design review、final review 与 bounded writer skills 不再要求 `VERDICT:` 或 `IMPLEMENTATION_OUTCOME:` 首行；design/review 改以 committed typed terminal 为唯一权威，writer 状态由 write events、累计 diff、write guard、requirement coverage 与 focused checks 派生。同步修正旧拓扑文档、必读 node-contract reference 的预算和累计 diff 回归断言，避免模型按已删除的 revision/repair 链工作。
+
+- 前端 taskKind 分类漂移修复（合并后冒烟暴露）：semantic-intake 模型提示词只列了 `backend-test / frontend-test / standard`，没提 `frontend-implementation`——模型把「实现组件 + 附带测试」的 PRD 误分类为 frontend-test（走了 browser-test RAG DAG 模板，报 allowedPaths 未覆盖 testcase/frontend）。提示词补全 taskKind 全集并明确区分：实现组件（含自带测试）是 frontend-implementation；frontend-test 只用于对既有功能的纯浏览器/UI 自动化测试。同时 source fidelity 不再把 PRD「背景」段误判为 executable（fragment-inventory other 章节固定 context-only，`EXECUTABLE_HINT_RE` 过度匹配「需要」导致 SOURCE_FIDELITY_HIGH_RISK_UNCOVERED 阻塞的回归）。
+
+- 根 `tsconfig.json` 补 `jsx: "react-jsx"`（规范冒烟暴露）：`test/**` 下的前端测试 import `static-src/**/*.tsx`（JSX 组件）时，根 tsc（无 jsx 配置）报 `TS6142: '--jsx' is not set` 导致 typecheck 失败——之前只能靠组件避免 JSX 语法或测试用 readFile 读源码绕过。补配置后测试可直接 import/渲染 JSX 组件，与 `src/worker/console/tsconfig.json` 的 static-src 编译约定一致；服务端 `src/**` 无 `.tsx` 不受影响。
+
 - 前端 design-review 拒绝纳入自动恢复（方向 A 姊妹实现）：`request_design_changes`（definite finding）不再让 writer-admission blocked 变成 terminal failed——runner 终态判定识别 committed design fact 后生成 recovery trigger（new-dag，从 plan 重启）+ 渲染 design findings PRD 草稿 + `deriveDagRerunFeedback` 增加 design typed-fact 通道（findings 注入下一轮 `<rerun_feedback>`），受同一 `frontendRecoveryQuota` 控制；无 design fact 的 blocked admission 仍保持 terminal failed。design-review 发现"AC 未被契约/测试锚定"这类真问题会在写代码前自动进入修正轮，而非一次失败即停。
 - 前端 DAG 两个闭环补齐（P0-1 / P2-4）：
   - **P0-1 前端 recovery 配额可配置**：`task.json frontendRecovery.maxContinuations`（默认 1，可配 2-5）冻结进 DAG spec（`spec.frontendRecovery`），runner 的 `finalizeTerminalRunStatus` 4 处硬编码 `< 1` 改为按配额判定——verify 偶发失败导致 run 真失败的场景可放宽到 2-3 次自动恢复，不必人工介入。
@@ -11,11 +19,12 @@
 - 前端 review `request_review_changes` 不再被静默当作成功（方向 A）：`frontend-review-pi` 提交 typed `request_review_changes` 时，run 终态判定为「未通过」（`partial_failed` + `terminalReason=review-request-changes`，即使全部节点 FINISHED 也不显示成功），committed findings 自动渲染为 run-owned 下游任务 PRD 草稿 `contracts/frontend-review-findings-prd.md`（含 issueCategory/evidenceRefs/findings/restartPhase 指引），并生成 recovery trigger（issueCategory→failureOwner 映射，new-dag）。`deriveDagRerunFeedback` 新增 typed-fact 通道：无文本 verdict、无 convergence 的 frontend 场景也能把 committed `request_review_changes` findings 注入下一轮 `<rerun_feedback>`，问题不再丢失、下一轮从 restartPhase 定点修复而非重复流程。
 - 前端 review findings PRD 草稿携带修复范围路由信号（方向 A 补充）：`deriveFrontendReviewFixScope` 从 committed findings 确定性推导建议 shape（单文件无远程 API→micro、同目录集中多文件→small、跨目录/API 信号→standard）与建议 complexity、目标文件、建议 allowedPaths；PRD 标题改为「修复 review 发现（<shape>）：<目标文件>」，正文新增「修复范围（供下一轮任务生成路由）」段（含 small 信号词，如「单文件局部修复」「无远程接口」），下一轮任务以该 PRD 生成 DAG 时，`resolveFrontendTaskShape` 能把小修复路由到 micro=7/small=10 节点拓扑，而非默认 11 节点 standard 全流程。
 - 前端 shape 分类 API 否定词覆盖中文空格形式（冒烟暴露边界）：`无 API/网络调用`、`无 API` 等表述不再被误判为远程 API 信号（原 `\b(...)\b` 对 CJK 开头无词边界），`resolveFrontendTaskShape` 与 `deriveFrontendReviewFixScope` 的 hasApiSignal 判定同步修正——带「无 API/无接口」声明的单文件小修复正确路由 micro/small，而非误升级 standard。
-- 前端实现契约对 `decision=new` 的退化空 `specReference` 归一化兜底（冒烟暴露 plan invalid-output）：模型偶发把 new 组件输出成 `specReference:{path:"",section:"",line:null}`（空对象而非 prompt 要求的 null），原校验直接判 `invalid-output` 触发完整 plan 重试；`frontendImplementationContractSchema` preprocess 新增 `normalizeNewComponentSpecReference`——new 选择携带空 path 的退化 specReference 时按 null 意图归一化为缺省（非空 path 的 `specified` 命中原样保留，真实 new+specReference 仍拒绝），一次格式滑动不再烧掉整个 plan attempt。
 - 深度合入 origin/main（source e68dfbe1）：以 frontend-node typed-tools 拓扑为基底移植 main 硬化——canonical artifact 消费、fail-closed 无验证 marker、风险分级细化（DEPENDENCY_INSTALL_LANGUAGE）、`HARNESS_DAG_RERUN_PROMPT_OVERRIDE` prompt override、Pi SDK 运行时依赖 0.83.0 与 `engines node>=22.19.0`、next-release scripts 入包；废弃节点（verify-assess/reverify/repair-pi/plan-revision/final-design-review/lint-baseline shell）能力确认被当前流程覆盖后裁剪对应实现（repair-gate 机制、lint-baseline shell 类型），plan retry 文案对齐 committed ledger；affected 392 + M2-M9 303 测试全绿，fast 3909/3910、integration 397/398（各 1 个 fn 既有失败）。
 
 ### 重点更新
 
+- 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 条）」，需要排查时再展开。
@@ -47,9 +56,11 @@
 
 ### 新增
 
+- 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/**` 等隐藏/治理树在生成期拒绝。
-- 实验能力「编辑失败节点提示词后从节点重跑」（默认关闭）：内部开关 `HARNESS_DAG_RERUN_PROMPT_OVERRIDE=1` 启用后，`dag rerun` 支持 `--prompt-override <nodeId>@<file>`（全文替换）与 `--prompt-override-append <nodeId>@<file>`（追加指令：保留冻结原提示词，末尾追加 `<operator_addendum>` 块）。仅限 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 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` 诊断。
@@ -63,7 +74,7 @@
 - `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` 同步
+- 组件选型规范合规（ADR 0016）：契约 schema 新增可选 `uiComponentChoices[]`（`{ purpose, component, decision(specified|reuse-existing|new), specReference{path,section,line}|null, rationale }`）；`specified` 必须给 OpenSpec `specReference`，任务源要求新增的 `new` 必须给 PRD `specReference`，空串拒绝；`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)_`）
@@ -75,6 +86,7 @@
 
 ### 改进
 
+- 实验「提示词重启」会为 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 重读全部绑定源文件，降低长需求在多节点中的重复上下文占用。
@@ -83,7 +95,7 @@
 - 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`），按钮文案为「隐藏原始协议事件」；用户可点选关闭，同会话内选择会保持。
+- 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 同步区分「自动修订」「从失败节点恢复」「带反馈重新执行任务」。
@@ -176,7 +188,7 @@
 - Console 对话中的 Markdown 表格只约束横向滚动，不再截断纵向滚动链；鼠标或触控板停在表格上时仍可继续上下滚动对话。
 - scenario-param 确定性 rewrite 的 Python 语法校验：Windows 优先 `python`，并把 Microsoft Store `python3` 空壳（非 0 且无语法诊断）视为解释器不可用后回退，避免误回滚合法 rewrite。
 - `frontend-plan-revision-pi` 节点级校验与 merge-patch 输出协议矛盾修复：新增 schemaId `frontend-implementation-contract-revision-patch-v1` 与格式级宽松校验 `validateFrontendRevisionPatchNodeOutput`（至少一个 `openspec-citations` 块 + 剥离引用块后恰好一个 JSON 对象，不做完整契约 schema 校验），revision 节点 `structuredContractOutput.schemaId` 切换（plan-pi 仍为 v1）；node-execution 的 invalid-output retry 指令按 schemaId 分支，patch 协议提示 merge-patch delta + 引用块，消除「prompt 要求 patch、retry 要求完整契约」的 retryable 死循环；gate 仍是唯一权威合并/校验点（零改动）。ADR 0015 补「节点级校验」决策 7
-- `frontend-implementation-contract.schema.json` 的 `uiComponentChoices` items 补 `if/then` 决策语义（`specified` ⇒ `specReference` 必填非 null；`new` ⇒ `specReference` 为 null/缺失）；`frontend-plan-render.ts` 空 `section` 不再渲染尾随 `#`；ADR 0016 增补「门禁边界」小节
+- `frontend-implementation-contract.schema.json` 的 `uiComponentChoices` items 补 `if/then` 决策语义（`specified` ⇒ OpenSpec `specReference` 必填非 null；任务源要求新增的 `new` ⇒ PRD `specReference` 必填非 null）；`frontend-plan-render.ts` 空 `section` 不再渲染尾随 `#`；ADR 0016 增补「门禁边界」小节
 - 前端 gate 内容驱动 revisionPatch 兼容 + verdict 归一化统一：旧 DAG（缺 `revisionPatch` 字段）但 revision 节点按协议输出 merge-patch 时，gate 按内容判定自动合并原始契约并走既有校验（不再因 `missing targets.files` 进入 retryable 死循环）；patch 形态但无法合并（fallback 缺失/自身、原始节点不可读或非完整契约、apply 失败）→ `blocked` + 新增 `revision-patch-unmergeable`（错误信息含重新生成 DAG 指引）；`normalizeVerdictCandidateLine` 增强 backtick 强调剥离，gate 的 `firstNonEmptyVerdictLine` 复用共享 normalize，runIf / output-protocol / gate 三处一致
 
 - 前端计划修订能正确识别增量补丁，不再因“提交完整契约”和“只提交变更”两套要求冲突而循环失败。

package/README.md

@@ -116,7 +116,7 @@ loop-agent dag report --run-id <run-id>
 | --- | --- | --- |
 | 受治理 CLI | `loop-agent …` / `agent-worker …` | 权威写入与诊断 |
 | Loop Operator Console | `agent-worker console` | Official 本地控制面（默认 repo=当前目录、`127.0.0.1:8790`，含 Operate 与 Inspect） |
-| Inspect（只读） | `agent-worker console` → `/inspect/`；`observe snapshot` | 统一 Console 内只读检视；`observe serve` 已下线（REMOVED / exit 2）。实验例外：`HARNESS_DAG_RERUN_PROMPT_OVERRIDE=1` 时节点 inspector 增加失败节点「提示词重启」tab（默认关闭，不注入任何 mutation token） |
+| Inspect（只读） | `agent-worker console` → `/inspect/`；`observe snapshot` | 统一 Console 内只读检视；`observe serve` 已下线（REMOVED / exit 2）。实验例外：节点 inspector 默认显示失败节点「提示词重启」tab；紧急回退可设置 `HARNESS_DAG_RERUN_PROMPT_OVERRIDE=0`（也接受 `false` / `off`），关闭后不注入任何 mutation token |
 
 ```bash
 # 终端 A：Console（任务/运行操作面；canonical mutation 只经 sibling loop-agent）
@@ -126,7 +126,7 @@ agent-worker console doctor --repo .
 
 ```
 
-裸 `agent-worker console` 在 listen 前会做一次交互式 npm `latest` 检查（本机自然日最多询问一次，继承当前 npm registry / 企业镜像，失败不阻断启动）。询问与失败提示写 stderr，Console URL 仍只出现在 stdout。`console doctor`、帮助和版本命令不检查。
+裸 `agent-worker console` 不在终端询问升级。Operate 右上角提供非阻塞的更新入口，默认选择 npm `latest` 稳定版，也可由操作者显式选择 `next` 预发布版；更新前会先检查活跃运行和全局安装来源。`console doctor`、帮助和版本命令均不触发更新检查。
 
 访问 Console <http://127.0.0.1:8790/>；**Operator Chat Official** 是 Console 内的主引导交互，默认打开「对话」工作区。构建时设置 `VITE_OPERATOR_CHAT_DEFAULT_LANDING=tasks` 可改回 Tasks；URL hash（`#/tasks`）与 localStorage 仍优先于默认值。顶部「检视」以及 `/inspect/` 提供只读 Dashboard、DAG、时间线与 artifacts；`loop-agent …` / `agent-worker …` CLI direct path 仍是受治理 fallback。当前状态为 **code ready, dogfood pending/unmet**，不宣称已替代 openCode 或其他外部主会话。
 

package/dist/application/task-lifecycle/advance.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { createTask, getTaskPaths, loadTaskConfig, } from "../../task/runtime.js";
 import { importPrdDocument } from "../../task/source-references.js";
 import { prepareTaskSource } from "../../task/source-prepare/index.js";
+import { resolveProductionSourceFidelityPi } from "../../task/source-prepare/source-fidelity-pi.js";
 import { isIntakeSoftGapCode, resolvePrdImportRole, } from "../../task/source-prepare/artifact-meta.js";
 import { sanitizeDraftPlaceholders } from "../../task/source-prepare/placeholder-paths.js";
 import { evaluateSemanticIntakeEligibility, isSemanticIntakeDisabled, readSemanticIntakeAttempted, runSemanticIntake, } from "../../task/source-prepare/semantic-intake.js";
@@ -585,6 +586,15 @@ export async function advanceTaskLifecycle(input) {
             continue;
         }
         if (action.type === "prepare-contract") {
+            // 生产 source fidelity Pi 接线（AC-PROD-001/005）：仅 frontend-implementation
+            // 任务注入 reconcile executor + 独立 reviewer；ineligible 返回 undefined 不接线。
+            // 主路径与 semantic-intake retry 路径共用同一接线，保证任意一条生产路径都实际
+            // 触发 reconciliation executor（修复前两处均缺省导致生产路径从不调用 Pi）。
+            const sourceFidelity = await resolveProductionSourceFidelityPi({
+                repoRoot: input.repoRoot,
+                taskId: input.taskId,
+                taskKind: input.taskKind,
+            });
             let draftIntent = null;
             if (input.fromDraftPath) {
                 try {
@@ -635,6 +645,7 @@ export async function advanceTaskLifecycle(input) {
                     verifyCommands: effectiveInput.verifyCommands,
                     backendTest: input.backendTest,
                 },
+                ...(sourceFidelity ? { sourceFidelity } : {}),
             });
             if (!prepareResult.ok) {
                 const gapCodes = (prepareResult.gaps ?? [])
@@ -712,6 +723,7 @@ export async function advanceTaskLifecycle(input) {
                                     verifyCommands: effectiveInput.verifyCommands,
                                     backendTest: input.backendTest,
                                 },
+                                ...(sourceFidelity ? { sourceFidelity } : {}),
                             });
                             if (retry.ok) {
                                 warnings.push({

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.39.0-beta.8",
-  "gitSha": "b698721e82e0ff98c85484a5b2864d9b28e968f8",
-  "builtAt": "2026-08-24T06:32:44.509Z"
+  "version": "0.39.0-beta.9",
+  "gitSha": "7089625511935979251d4aed29cb8c48b1105786",
+  "builtAt": "2026-08-26T05:33:29.646Z"
 }

package/dist/cli/update/runtime-activity.js

@@ -1,29 +1 @@
-import { readdir } from "node:fs/promises";
-import path from "node:path";
-import { buildGlobalSnapshot } from "../../worker/observability/read-model.js";
-/**
- * Read-only runtime guard for init-surface writes.
- *
- * DAG activeness is anchored to real directories in the canonical active
- * lifecycle root. Worker activeness reuses the Observe read model so Task Pool
- * status precedence and composite identity stay owned by the Worker adapter.
- * Projection failures block writes because liveness cannot be proven safely.
- */
-export async function readInitRuntimeActivity(repoRoot) {
-    const resolvedRoot = path.resolve(repoRoot);
-    const activeDagRoot = path.join(resolvedRoot, ".harness", "dag-runs", "active");
-    const entries = await readdir(activeDagRoot, { withFileTypes: true }).catch(() => []);
-    const activeDagRunIds = entries
-        .filter((entry) => entry.isDirectory() && entry.name !== ".gitkeep")
-        .map((entry) => entry.name)
-        .sort();
-    const snapshot = await buildGlobalSnapshot({ repoRoot: resolvedRoot });
-    return {
-        activeDagRunIds,
-        activeWorkerBatches: snapshot.health.worker.activeBatches,
-        activeWorkerTasks: snapshot.health.worker.activeTasks,
-        ...(snapshot.projectionError
-            ? { workerProjectionError: snapshot.projectionError.message }
-            : {}),
-    };
-}
+export { readInitRuntimeActivity } from "../../worker/observability/init-runtime-activity.js";

package/dist/commands/dag-rerun.js

@@ -117,7 +117,7 @@ export async function runDagRerun(repoRoot, rawArgs) {
         parsed.promptOverrideAppendSpecs.length > 0;
     if (hasOverrides) {
         if (!isDagRerunPromptOverrideEnabled()) {
-            throw new Error("prompt override rerun is disabled; set HARNESS_DAG_RERUN_PROMPT_OVERRIDE=1 to enable this experimental capability");
+            throw new Error("prompt override rerun is disabled by HARNESS_DAG_RERUN_PROMPT_OVERRIDE; unset it or use a value other than 0, false, or off to enable this experimental capability");
         }
         promptOverrides = [
             ...(await loadPromptOverrides(parsed.promptOverrideSpecs, "replace")),

package/dist/commands/init.js

@@ -14,6 +14,19 @@ const GITIGNORE_BLOCK_START = "# LOOP_AGENT_INIT_START";
 const GITIGNORE_BLOCK_END = "# LOOP_AGENT_INIT_END";
 const INIT_SURFACE_STATE_PATH = ".harness/init-surface.json";
 const DEFAULT_GOVERNANCE_ROOT = "ai_workspace/loop-agent";
+function buildSpecRegistry() {
+    return `${JSON.stringify({
+        version: 1,
+        roots: [],
+        discovery: {
+            enabled: true,
+            maxDepth: 3,
+            maxFiles: 100,
+            maxBytes: 1048576,
+            timeoutMs: 2000,
+        },
+    }, null, 2)}\n`;
+}
 const CORE_DOC_FILES = [
     { source: "README.md", target: "README.md" },
     {
@@ -1312,6 +1325,9 @@ async function buildDesiredSurfaceContent(input) {
             }), null, 2)}\n`,
         };
     }
+    if (manifestPath === "docs/spec-registry.json") {
+        return { content: buildSpecRegistry() };
+    }
     if (manifestPath === OPENCODE_TRANSIENT_RETRY_PLUGIN_PATH) {
         return { content: buildOpenCodeTransientRetryPluginSource() };
     }
@@ -1709,6 +1725,8 @@ async function listRelativeFiles(rootPath) {
 async function expectedLegacyInitFileSha(input) {
     if (input.legacyPath.startsWith("docs/")) {
         const doc = input.legacyPath.slice("docs/".length);
+        if (doc === "spec-registry.json")
+            return sha256Text(buildSpecRegistry());
         const generated = buildGeneratedCoreDoc({
             doc,
             projectName: input.projectName,
@@ -2707,6 +2725,14 @@ export async function initializeLoopAgentProject(options) {
         targetRelativePath: path.join(governanceRoot, "templates"),
         written,
     });
+    await writeTextIfMissing({
+        repoRoot,
+        relativePath: path.join(governanceRoot, "spec-registry.json"),
+        content: buildSpecRegistry(),
+        merge,
+        written,
+        skipped,
+    });
     if (profile === "full") {
         // Project repo-local skills live only under `.agents/skills/`.
         // The package still ships `skills/` as the built-in fallback source.