@tea-agent/loop-agent 0.18.0 → 0.19.0

package/AGENTS.md

@@ -54,7 +54,7 @@
 10. 检查 `git status --short --branch`。
 11. 运行本次任务相关的最小基线验证。
 12. 如果用户提到"后端测试"、"接口测试"、"pytest"、"自动化测试"，在任务 `task.json` 中设置 `taskKind: "backend-test"` 再 `dag run-task`；不要用 `--profile backend-test`（CLI 不接受该值，专用模板只走 taskKind）。知识回写用 `taskKind: "knowledge-sync"`（须 `featureId`），图谱开荒用 `taskKind: "knowledge-graph-bootstrap"`。`--profile` 仅表示治理强度：`auto|minimal|standard|reviewed|supervised`。
-13. 如果用户提到"看板"、"observe"、"监控面板"、"启动看板"，使用 `agent-worker observe serve --repo . --port 8787` 命令启动。
+13. 如果用户提到"看板"、"observe"、"监控面板"、"启动看板"，使用 `agent-worker console serve --repo . --port 8790` 启动统一 Operator Console；`/inspect/` 提供只读检视。`agent-worker observe serve --repo . --port 8787` 仅为兼容入口。
 14. 如果用户要求“合并 `<source>` 到 `<target>`”或“合并 origin/main 到当前分支”，先阅读 `docs/branch-merge-guideline.md`，按影响自动选择快速、标准或深度模式；始终冻结 source SHA、审查双方功能、运行 merge-tree、生成 source-SHA 合并报告，并在提交前再次 fetch 防止主干前进。
 
 ## 会话协议
@@ -89,7 +89,7 @@
 - 长期决策写入 `docs/`，不要只留在聊天里。
 - 分支合并遵循 `docs/branch-merge-guideline.md`；快速模式只用于可证明的低风险/no-op 合并，涉及冲突、init/package/runtime/release/public API 时必须升级为标准或深度模式。
 - 后端测试、接口/API 测试、pytest 或明确的后端自动化测试，必须把 `.harness/tasks/<task-id>/task.json` 的 `taskKind` 设置为 `"backend-test"`，不得保留默认 `standard`。`backend-test` 是 `taskKind`，不是 `--profile` 的可选值；`dag run-task` 继续使用 `--profile auto` 选择治理等级。仅说“自动化测试”且前后端不明时，先根据任务源和项目技术栈判断，禁止无条件路由。
-- 本地只读运行看板：`agent-worker observe serve --repo . --port 8787`，访问 `http://127.0.0.1:8787/`；看板只读，默认只绑定本机 `127.0.0.1`，不要直接暴露到公开网络。
+- 本地 Operator Console：`agent-worker console serve --repo . --port 8790`，访问 `http://127.0.0.1:8790/`；其中 `/inspect/` 为只读运行检视。默认绑定本机 `127.0.0.1`；可用 `--host 0.0.0.0` / `--debug`，不要直接暴露到公开网络。
 - 面向使用者的新增、修改、删除或修复，应同步更新根目录 `CHANGELOG.md`；保持版本级摘要即可，不写过细技术细节。
 - 面向用户的中文更新日志、README 和说明文档应使用自然、结果导向的表达：先说明用户能获得什么或问题如何改善，保留必要的命令和产品术语，避免逐字翻译、内部实现细节和无意义的中英混杂。
 - 涉及 `loop-agent init` 或目标项目投影的改动，必须同步考虑目标项目生成物：`AGENTS.md`、`README.md`、`harness.json`、`ai_workspace/loop-agent/`、`scripts/`、`.agents/skills/`、`.harness/prompts`、`.gitignore`（loop-agent runtime managed block）和 npm 包内置 assets；目标项目根 `docs/` 和根 `skills/` 的旧投影需要由 `init update --apply-safe` 安全迁移或退役。

package/CHANGELOG.md

@@ -2,86 +2,42 @@
 
 ## [Unreleased]
 
-- `backend-test` active runtime/template 改为 8 节点 Markdown-first 流程：环境 Shell 先检查 Python/pytest、配置/fixture/target 和 HTML renderer；随后生成并独立 Review Markdown 用例，经过确定性 Markdown/traceability gate 后只执行一次 pytest，同时生成 JUnit、self-contained HTML 和 Markdown facts，最终输出 Markdown 测试报告与 L-5。新流程不再要求模型生成 Analysis/Execution/Manifest/Classification/Result/L-5 业务 JSON，历史 JSON artifacts 仍保留读取兼容。
+## [0.19.0] - 2026-07-23
 
-### 修复
+### 重点更新
 
-- `backend-test` Markdown 用例生成与独立审查现在默认采用简体中文：用例标题、策略、前置条件、测试数据、步骤、预期结果、自动化说明、表头和证据缺口优先中文表达；Case/AC/REQ/BR ID、固定章节标题、HTTP 方法、路径、字段名、枚举值、命令和代码符号继续保持精确机器契约，不做无意义双语翻译。
-- `backend-test` traceability 现在识别带 `-> None` 等返回类型 annotation 以及可选 `async` 的 pytest 函数，不再把合法 typed test function 全部误报为缺失映射。
-- `backend-test` Markdown gate 只要求 case-level AC；pytest 执行、MD↔pytest 追溯、JUnit/HTML/stdout/stderr 和失败分类等下游证据 AC 交给 traceability、execute 与 report 节点，不再被错误要求写入单条 Markdown case。
-- `backend-test` Markdown gate 的 `Steps` 仍要求编号列表；`Expected Results` 现在接受编号列表或 Markdown bullet 列表，只要保持结构化可断言，不再误拒绝模型生成的合法 bullet 断言；普通散文仍 fail-closed。
-- `backend-test` 的 pre-run Spine 审计不再要求尚未执行的 `artifacts/requirement-coverage.json`：未覆盖需求在该 taskKind 下记为 warning，并交给运行内 Markdown validation 与 traceability gate 确定性阻断；普通实现任务仍保持 error/fail-closed。
-- `backend-test` Markdown 用例门禁现在从 DAG `sourceBinding` 精确识别 `Source References`，支持反引号以及中英文括号/标点，不再将说明文字吞入路径；未绑定引用、路径前缀伪装和绑定文件缺失仍然 fail-closed。
-- `backend-test` Markdown writer/reviewer 的 reference index 现在同时提供 task-relative 引用路径与 repo-relative `readPath`，Pi 会直接只读 `.harness/tasks/<taskId>/source/**` 的绑定文件，不再把 `source/references/**` 误读为仓库根路径，也不会在读取失败后回退到 `docs/**` 替代文件。
-- `backend-test` Markdown 用例门禁会通过 DAG `sourceBinding` 将 `source/需求.md`、`source/执行约束.md` 和 `source/references/**` 解析到对应任务目录，不再错误地相对仓库根查找，也不会接受未绑定的同名仓库文件。
-- `backend-test` traceability 门禁现在优先用 Markdown 中已知 Case ID 匹配 `test_BE_<MODULE>_<NNN>_` 函数前缀，不再把函数描述中的 `100`、`400`、`404` 等三位数字误识别为 Case ID。
-- `backend-test` traceability 门禁允许仅包裹 cleanup 调用的 `except requests.RequestException: pass`，避免 best-effort 资源清理被误报；bare/宽异常、`AssertionError` 及非 cleanup 主体仍然 fail-closed。
+- Operator Console 统一整合 Operate 与 Inspect，在同一服务即可检视只读 Dashboard、DAG、时间线与 artifacts
+- 原 Observe 服务进入兼容期，仍可运行但会输出迁移提示，引导平滑过渡到统一控制台
+
+### 新增
 
-- DAG runtime 的 task-contract 启动门禁现在只将 `writePolicy: "exclusive"` 视为 writer execution：历史只读/static/shell DAG 可继续执行，legacy writer DAG 仍必须升级为 DagSpec v4 并绑定 managed Task Contract；真实 DAG 生成会冻结当前 managed binding。测试执行 fixture、Worker materializer 和 Windows npm/tmp 路径也已同步适配该契约。
-- Pi CLI / SDK executor 不再把单个节点的完整 stdout 累积为一个 JS 字符串；长 `frontend-plan-pi` 或大段结构化输出会保留有界预览并继续流式解析最终 assistant 事件，避免触发 V8 `Invalid string length` 或卡死。
-- DAG 节点新增 `outputMode: "structured-required"`；前端实现计划/修订节点显式使用该模式，并在 `output-too-large` 时用紧凑结构化输出指令重试，避免直接截断计划后继续执行，也减少长计划输出阻断后续流程的概率。
-- `frontend-mock-assess-pi` 的 `MOCK_STRATEGY:` 协议行规范化现在可处理列表、引用、inline code、中文冒号、`Mock strategy` 标签和标签/值分行等常见格式漂移；仍只接受明确 Mock strategy 标签和五态白名单，不从普通正文猜默认策略。
+- 新增统一 Operator Console：`console serve` 同时提供 Operate 与 Inspect，支持通过 `/inspect/` 直接检视运行详情与 DAG
+- Console 健康检查接口升级，包含 Inspect 就绪状态与路由能力信息
+- `console serve` 新增局域网绑定（`--host 0.0.0.0`）与调试日志（`--debug`）选项，并在非本地访问时保留安全校验
 
 ### 改进
 
-- `backend-test` 的 source intake 能力已并入 Markdown 用例生成/Review：派生 `需求.md` / `执行约束.md` 有界内联，reference 使用 path/SHA-256/角色线索索引并按需精确读取；pytest writer 不再读取 `source/**`。
-
-- **Console Phase 3（Observe 协作）**：
-  - Observe `GET /api/health` 升级为 versioned DTO（`schemaVersion: 1`、`repoFingerprint` 复用 Console `repoFingerprintV1`、package name/version、由 ROUTES 派生的 `routeCapabilities`）。
-  - Console `observeLink` fail-closed：仅 health **match**（同仓 fingerprint + schema + 目标 kind 所需 capability）时返回深链；offline / mismatch 返回诊断与 `agent-worker observe serve --repo . --port 8787`，不打开错误 URL。
-  - Doctor 的 Observe 探测扩展 match / mismatch / unavailable（Observe 仍非阻塞，doctor `ok` 保持）。
-  - Recovery CTA 矩阵（report / doctor / decision / resume / reconcile / regenerate / observeLink）：**无** Cancel、**无**主 CTA「直接改代码」。
-  - Console 与 Observe 仍为独立进程；不 mount、不 proxy、不复制第二套 read model。
-- Phase 1 Console skeleton：`agent-worker console serve|doctor`（默认 loopback `127.0.0.1:8790`、非 loopback fail-closed）、Vite SPA 静态产物 + Node health/static server、boot capability cookie + mutation Host/Origin 门禁、封闭 ResourceLoader 骨架、sibling `loop-agent` identity doctor、`repoFingerprintV1` / Observe 深链 builder、以及 `UPSTREAM.md`（pi-web 源 commit）与预算 report。
-- Phase 0.5 operator surface repair：`buildOperatorCapabilitiesDocument()` 在权威 `src/shared/operator` 上补齐 Console 协商块 `dag`（`generatedSpecVersion: 4`、`requiresTaskContractBinding: true`，与 `dagSpecVersions` 同源常量），并删除冲突的 `src/task/operator` 双实现；CLI `--json` 继续写 `process.stdout`，测试侧改为捕获 stdout。
-- Nightly 自动发布改为双基线：`lastTag`（最新稳定 `vX.Y.Z`）只负责未发布增量、breaking 检测与 release notes；当前 minor 的 `vX.Y.0`（缺失则回退 `lastTag`）只累计严格 Conventional Commit `feat:` 以决定 minor/patch。手动 patch 不再抹掉同 minor 周期的 feature 信号；历史 minor 窗口中的 breaking 不再永久阻断后续自动发布。`Publish npm` 手动入口未改。
-
-- `frontend-implementation` 绿色路径由固定全链改为按需分支：删除重复的首轮 design shell gate，初审通过直接复用原计划，只有 `request-revision` 才执行计划修订与终审；只有可修复失败才执行 repair/reverify/retrace。常规全绿路径因此少执行 3 个 Pi 与 4 个 shell 节点，同时保留 pass-only 写入门禁、验证/评审证据和只读 `frontend-closeout-pi`。原计划/修订计划的结构化合同与需求覆盖使用同一有效来源，且只有主分支产物缺失时才回退；已存在但 malformed/schema-invalid 的产物继续 fail-closed。
-- Observe 节点检查器“规范证据”页签新增安全文件预览：已绑定任务源和已读取规范文件条目现以可聚焦按钮呈现，点击后在检查器内下钻查看内容（不新增弹窗），提供“返回规范证据”按钮并恢复触发行焦点。新增只读接口 `GET /api/dag-runs/:runId/nodes/:nodeId/spec-evidence/file?source=binding|read&path=...`，服务端重新校验证据成员身份（binding 必须在 `sourceBinding.sources`，read 必须有成功配对 read），拒 `..`/绝对/目录/二进制/仓库外符号链接；正文上限 64KB 并返回截断标志，统一走 Observe 脱敏规则；binding 返回 `sha256`/`currentSha256`/`hashMatch`，read 返回 session event 中实际读取正文与 `readAt`（不以当前工作区文件替代）。
-- 通用 standard/reviewed/supervised 实现 DAG 现在会在目标仓库存在 `AGENTS.md` 时，按本次 writer 的实际变更解析适用的根级/嵌套指令和仓库内代码规范索引：standard 复用 `verify-pi` 与条件 shell gate，reviewed/supervised 复用现有 `review-pi`/review gate，不新增模型节点；无 `AGENTS.md` 或无适用规范时保持原行为，审查节点只读且不会直接改代码。专用测试、前端和知识类 DAG 不受影响。
-
-- GitHub Actions CI 降低私有仓分钟消耗：合并为单 job（避免两次 `npm ci`）、同分支/`PR` concurrency 取消旧 run、Draft PR 跳过完整 CI，且仅忽略 `docs/reports/**`、`docs/progress/**`、`docs/design/archive/**`、`docs/exec-plans/completed/**` 等纯运营文档路径；治理文档与代码门禁仍全量跑。
-- 明确 **Compatibility / Operator Assist**：openCode 等主会话只编排已发布 `loop-agent` / `agent-worker` CLI 与只读诊断，不得绕过 CLI 直接改业务实现，失败只走 doctor / reconcile / human gate / CLI 重跑。`loop-agent init` 写入的 `AGENTS.md` managed block、包内 skills 与 website 快速开始/治理说明已对齐；架构决策见 `docs/decisions/0005-governed-operator-surface.md`（accepted）。已有目标项目用 `loop-agent init check-update` / `init update --apply-safe` 或 `init reconcile` 刷新 managed block。
-- 前端测试 DAG 收紧体验：execution preflight 仅硬校验绝对非生产 `baseUrl`；用例 map 缩短为优先用 `playwright-cli` 执行；复盘合并执行证据审查且不依赖 outcome=pass，失败也能出报告。
-- 前端测试用例生成现在会解析明确 `baseUrl`：优先读取任务源 `config.md` 中的前端 URL，缺失时默认 `http://localhost:5173`，并写入 RAG `context.md`；生成命令不得再保留 `<base-url>` 占位符。
-- 前端浏览器测试 DAG 的复盘报告现写入 `testcase/frontend/reports/**`，不再要求 `docs/test-reports/**` 权限；任务执行约束可以安全禁止整个 `docs/**`，同时仍保留可审计的测试资产。
-- `frontend-test` 结果链新增 run-owned `frontend-test-result-v1`、单次用例修订与终审门禁；只有所有浏览器用例和 AC 覆盖通过且结果合同明确为 real/pass 时，Worker 才会投影真实集成。
-- 后端测试 DAG 从 24 个收敛为 15 个真实顶层节点；用例与语义 `request-revision` 由确定性 gate 直接失败，pytest 只执行一次，TestBug 保留分类并转为独立 follow-up，不再触发同 run repair 或 final rerun。唯一 initial Result 会确定性复制为 canonical `contracts/backend-test-result.json`，最终 outcome 只认该结构化事实。
-- Backend Test Analysis、Case Manifest、Semantic Review 与 Classification 的严格 JSON 契约进一步对齐，生成节点明确字段白名单、`sourceBinding` 与 evidence gap 约束，避免模型自定义字段导致确定性门禁失败。
-- 新增升级后 init surface notifier：普通安全仓库命令结束后，当目标项目存在有效 `.harness/init-surface.json` 且 `controllerVersion` 与当前包版本不同时自动检测。surface 缺失/损坏、源仓库、未初始化目录与版本一致时直接跳过；`checkInitUpdate().ok` 时仅在无活跃运行时静默刷新 state；非 TTY 只向 stderr 输出 `loop-agent init reconcile --repo-root ...` 提示且不写入目标；TTY 且无 human decisions、无活跃 DAG/Worker 时可经明确 `y/yes` 同意后应用 deterministic safe actions；只有 model merge 时直接输出有边界指引，不询问“应用 0 个动作”。notifier 遵循全局 `--repo-root`、不写 stdout、不改变原命令退出码，CI、禁用环境变量、help/version、`--json`/`--markdown`、`init`、`run-dag`、`dag`、`loop`、`delegate`、`pi-prompt`、`cursor-prompt` 均跳过。
-- 新增统一命令 `loop-agent init reconcile --repo-root <target>`：surface 缺失返回 `needs-baseline` 且零写入，存在 human decisions 返回 `needs-human-decision` 且零写入，活跃 DAG/Worker 或 Worker 状态无法确认时返回 `blocked-active-runtime` 且零写入；其余情况复用现有 `applyInitUpdate({ applySafe: true })` 并复查返回 `clean`/`needs-model-merge`/`needs-safe-update`，支持 `--json`/`--markdown`。
-- 测试报告新增 L-5 指标消费与 Python coverage.py JSON、Java JaCoCo XML 的统一 Code Coverage v1 报告入口，覆盖通过率、AC/自动化覆盖率、稳定性、失败原因、缺陷、风险和回归建议；缺失覆盖率证据保持 `unavailable`，不改变 backend-test outcome gate。
-- 现有 backend-test DAG 在 retrospective 之后新增独立的 `l5-metrics-pi` 指标节点；它基于前序测试报告和 run-owned 证据输出 `L-5 ready/not-ready`，不创建独立 L-5 DAG，也不改变 Result v1 outcome gate。
-- 后端测试 DAG 从 38 个收敛为 24 个真实顶层节点；使用 fail-closed `runIf` 和复合 Shell capability 减少调度，同时保留双合同、Manifest、语义评审、JUnit、Result、分类、修复安全、追踪和最终 outcome 证据。三条可选修订/修复分支仍各最多执行一次。
-- Backend Test Analysis、Case Manifest、Semantic Review 与 Classification 的严格 JSON 契约进一步对齐，生成和修订节点明确字段白名单、`sourceBinding` 与 evidence gap 约束，避免模型自定义字段导致确定性门禁失败。
-
-### 修复
-
-- Init evolution 高影响校验现在覆盖升级后的 init surface notifier、eligibility policy、runtime activity gate 与 CLI entry 接线；这些专用路径单独变化时会触发 `model-review`，不再以 `no trigger matched` 静默跳过审查，同时不扩大到通用 CLI program/command registry 文件。
+- 优化操作与观测统一界面的导航与布局，合并确认与运行为「开始运行」，DAG 详情跳转路径更加准确
 
-- Windows DAG Shell/verification 的 clean environment 现在保留 `APPDATA`，使 Python 3.12/pip 可按系统规则发现用户级 `site-packages` 与其中的 pytest；仍不会继承完整宿主环境或透传未授权 token/credential，backend-test 无需硬编码用户路径。
-- Observe 节点检查器的“规范证据”现在会按任务目录解析 `sourceBinding` 中的相对路径，`source/需求.md` 等已绑定文件可正常打开；路径成员校验、目录穿越、绝对路径、二进制文件和符号链接逃逸防护保持不变。
-- Decision Gate 的 Pi 执行指令不再与输出合同冲突：启用 `decisionGate` 的只读节点会明确输出唯一的 `DECISION_ENVELOPE_JSON` fenced block，普通只读节点仍保持原有无代码围栏约束，严格解析规则不放宽。
-
-- Backend-test Analysis v2 intake 现在可确定性归一化模型常见的外部依赖 `type` / `target` 与风险 `type` 字段：dependency `target` 映射为 canonical `name`，扩展字段不落盘；dependency/risk 仍使用类别化白名单，未知字段和 `risks[].target` 继续 fail-closed，避免节点 02 因合法近似形态过早中断。
-
-- Backend-test 唯一 JSON object 提取器在扫描裸对象前会等长忽略完整 Markdown 行内代码中的对象形状示例（如 `{error:{code,message,type}}`）；唯一真实 envelope 可正常物化，多个真实 JSON、fence 外额外对象与未闭合对象继续 fail-closed。
-- Backend-test 节点 10 `backend-test-semantic-gate-shell` 不再用 Markdown `first-verdict-line` 读取 raw Pi 输出；改为同一 `semantic-initial` pipeline 按 task id 只读 `contracts/backend-test-semantic-review.json`，仅 `verdict=pass` 放行 pytest，`request-revision`/缺失/malformed 清晰 fail-closed；节点 09 仍只负责 materialize+trace，15 节点与单次 pytest 不变。
-- 公开 Case Manifest schema（`docs/templates/backend-test-case-manifest.schema.json`）对齐 materializer dual-scope coverage：`coverageSummary` 在 `additionalProperties:false` 下 required 并声明 `global`/`inScope`（`total`/`covered`/`gapped`/`ratio`）与 `crossDomainGapCount`；回归测试以无依赖轻量 contract 锁定 schema↔canonical 一致性；不改 materializer/15 节点。
-- Backend-test Case Manifest materializer 将模型顶层 `coverageSummary` 视为非权威：secret 扫描后剥离，再 strict parse 其余字段，并始终 `computeCaseManifestCoverageSummary` 写入 canonical summary；my-webapp 自定义/部分 summary 不再导致 invalid-output；prompt 禁止模型输出 coverageSummary；15 节点与单次 pytest 不变。
-- Backend-test 裸 object 路径现消费 scanner 的 `unclosedObject`：当文本含一个完整裸 JSON object，且其前或后仍有未闭合裸 object 时一律 fail-closed，不再因 `spans.length === 1` 错误接受完整对象；Semantic Review / Classification / contracts envelope 共用该行为。
-- Backend-test contracts composite pipeline （`validate-backend-test-contracts-shell`） 使用唯一确定性 envelope 提取：接受 pure JSON、唯一 fenced json、prose+唯一 fence、prose+唯一括号平衡裸 object；对无 JSON、多候选、未闭合、非 object、缺 `analysis`/`execution` fail-closed。提取后仍走 Analysis v2 / Execution v1 schema、source-binding 与 secret 门禁；不引入全局 Pi output rewrite，不将 `invalid-output` 加入自动 retry，不改 15 节点拓扑。
-- Backend-test Semantic Review（08→09）与 Classification（12→13）materializer 复用同一 `extractUniqueJsonObject` scanner：接受 pure / whole-fence / prose+唯一 fence / prose+唯一裸 object；多候选、未闭合、非 object 与 strict schema 错误继续 fail-closed；不改 Case Manifest、Pi SDK/retry 或 15 节点拓扑。
-- 节点检查器「执行过程」中的事件时间戳现在同时显示本地日期与 24 小时制 `HH:mm:ss`（例如 `2026/7/16 08:09:10`），不再被裁掉时间部分；缺少时间戳时仍显示「未记录时间」，事件字段优先级（`timestamp` → `at` → `recordedAt`）保持不变。
-- `frontend-test` 的 case review 现在是 fail-closed browser gate：只有 `VERDICT: pass` 才能物化 manifest 并启动动态 browser map；生成的 case 固定使用默认 browser session，要求每个子场景的 fixture/UI reset 和 fresh snapshot，并由确定性节点校验每个 case 的 `execution.md`、`case-result.json`、`caseId`、`status`、`evidencePaths` 及 blocked `blockedReason`。
-- 前端实现计划/修订节点会注入当前包内权威 `frontend-implementation-contract-v1` Schema 与固定 source binding，避免模型猜测字段导致契约门禁失败。
-- 前端 Mock 策略节点的 canonical 输出会把首条 `MOCK_STRATEGY:` 协议行提升为第一行，避免解释性前言触发 `first-non-empty` 门禁误判。
-- 前端规范回退目录统一为本地 `openspec/`，DAG 能力发现、提示词、Skill 与验证证据检查不再查找大小写不一致的旧目录名。
-- 后端测试复合 Shell pipeline 现在与普通 Shell 节点共享 Git write guard；即使命令退出成功，只要越过 `read-only`、`allowedPaths` 或 `forbiddenPaths` 边界，节点仍会 fail-closed。
-- Observe 对新 backend-test run 不再伪造 repair attempt/status，只投影 single-run/canonical Result、分类与 coverage；历史 24 节点 run 的 eligibility、repair、final 和 effective evidence 仍可兼容读取。
-- Pi SDK 对缺少响应 ID 的累计 Token 生命周期事件改为取本次执行最大快照，避免同一响应的匿名 usage 被重复累加。
-- Pi SDK 执行长推理或大段结构化输出时不再把高频流式增量事件无界累积到内存；同一响应在多个生命周期事件中重复出现的 Token 用量只统计一次，避免 `Invalid string length` 和成本数据虚高。
-- 后端测试复合执行节点继续保持 clean environment、失败分类和 fail-closed outcome，并为唯一 JUnit/initial Result、canonical Result、traceability 与 Observe 投影保留结构化运行证据。
+### 修复
+
+- 修复执行计划索引将命名约定占位符（如 `YYYY-MM-DD-<topic>.md`）误判为缺失计划引用的问题
+
+## [0.18.1] - 2026-07-22
+
+### 重点更新
+
+- 放宽后端测试 Markdown 用例的映射与验收标准校验，减少合法用例被误拦截的情况
+- 修复文档审计报错未阻断 CI 的治理漏洞，并全面修正失效链接
+- 清理发布日志中残留的已发布记录，避免将已上线能力误展示为未发布
+
+### 修复
+
+- 放宽后端测试 Markdown 用例的每条补充 Case 必须包含 AC 标识的硬性要求，改为确保任务要求的业务 AC 场景至少被一条最终用例覆盖即可，整体缺失必需 AC 时仍会严格阻断
+- 放宽后端测试 traceability 映射校验，Case ID 可位于测试函数名、装饰器、函数体或文档字符串区域，不再强制首行文档字符串或严格一对一映射，避免重复映射等情况导致的误阻断
+- 修复文档审计在发现错误时未返回非零退出码导致 CI 假绿的问题，并将链接门禁覆盖范围扩展至完整的 docs/ 目录
+- 修正文档报告分类迁移后遗留的 269 条失效链接
+- 修复自动发布创建版本区块时未正确消费已发布内容并清理残留记录的问题，移除了随 0.18.0 版本发布的 59 条残留日志
 
 ## [0.18.0] - 2026-07-22
 

package/README.md

@@ -85,24 +85,22 @@ loop-agent dag doctor --run-id <run-id> --markdown
 loop-agent dag report --run-id <run-id>
 ```
 
-### Official 本地操作面（CLI + Console + 独立 Observe）
+### Official 本地操作面（CLI + 统一 Operator Console）
 
 | 入口 | 命令 | 角色 |
 | --- | --- | --- |
 | 受治理 CLI | `loop-agent …` / `agent-worker …` | 权威写入与诊断 |
-| Loop Operator Console | `agent-worker console serve --repo .` | Official 本地控制面（默认 `127.0.0.1:8790`） |
-| Observe | `agent-worker observe serve --repo . --port 8787` | 独立只读看板 |
+| Loop Operator Console | `agent-worker console serve --repo .` | Official 本地控制面（默认 `127.0.0.1:8790`，含 Operate 与 Inspect） |
+| Observe | `agent-worker observe serve --repo . --port 8787` | 兼容期独立只读入口；不再作为推荐路径 |
 
 ```bash
 # 终端 A：Console（任务/运行操作面；canonical mutation 只经 sibling loop-agent）
 agent-worker console serve --repo .
 agent-worker console doctor --repo .
 
-# 终端 B：独立 Observe（不经 Console mount/proxy）
-agent-worker observe serve --repo . --port 8787
 ```
 
-访问 Console <http://127.0.0.1:8790/> 与 Observe <http://127.0.0.1:8787/>。Observe 只读运行事实；Console 通过 versioned health（同仓 `repoFingerprint` + route capability）fail-closed 构建深链。openCode 等主会话仍是 **Compatibility / Operator Assist**，不得升级为与 Official 同等保证。
+访问 Console <http://127.0.0.1:8790/>；顶部「检视」以及 `/inspect/` 提供原 Observe 的只读 Dashboard、DAG、时间线与 artifacts。需要保留的旧书签或脚本仍可在兼容窗口使用 Observe `:8787`。openCode 等主会话仍是 **Compatibility / Operator Assist**，不得升级为与 Official 同等保证。
 
 ## 核心边界
 

package/dist/commands/docs-audit.js

@@ -2,4 +2,5 @@ import { auditDocs } from '../governance/checks.js';
 export async function runDocsAudit(repoRoot) {
     const result = await auditDocs(repoRoot);
     console.log(JSON.stringify(result, null, 2));
+    process.exitCode = result.summary.errorCount > 0 ? 1 : 0;
 }

package/dist/commands/init.js

@@ -783,13 +783,13 @@ function buildManagedAgentsBlock(input) {
         "",
         "### 运行看板（只读）",
         "",
-        "启动本地只读运行看板：",
+        "启动统一 Operator Console（含只读 Inspect）：",
         "",
         "```bash",
-        "agent-worker observe serve --repo . --port 8787",
+        "agent-worker console serve --repo . --port 8790",
         "```",
         "",
-        "浏览器打开 `http://127.0.0.1:8787/`。看板只读，默认只绑定本机 `127.0.0.1`；不要直接暴露到公开网络。",
+        "浏览器打开 `http://127.0.0.1:8790/`；检视面为 `http://127.0.0.1:8790/inspect/`。默认绑定本机 `127.0.0.1`；可用 `--host 0.0.0.0` 做局域网访问（无网络鉴权，仅可信网络），`--debug` 输出请求日志。不要直接暴露到公开网络。`agent-worker observe serve` 仅为兼容入口。",
         "",
         "### DAG 诊断与收口",
         "",

package/dist/governance/exec-plans.js

@@ -177,6 +177,10 @@ function localIndexReference(rawReference) {
         .replaceAll("\\", "/");
     if (!normalized.endsWith(".md") || normalized.includes("/"))
         return null;
+    // Naming-convention placeholders (e.g. `YYYY-MM-DD-<topic>.md`) and other
+    // unsafe stems are documentation, not index entries. Align with assertSafePlanId.
+    if (/[<>:"|?*]/.test(normalized))
+        return null;
     return normalized;
 }
 function extractIndexReferences(indexContent) {

package/dist/worker/cli.js

@@ -559,9 +559,9 @@ export function buildAgentWorkerProgram() {
         .command("serve")
         .requiredOption("--repo <repo-root>", "Target repo root")
         .option("--port <port>", "HTTP port", "8787")
-        .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no auth)", "127.0.0.1")
+        .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no network auth)", "127.0.0.1")
         .option("--debug", "Log request source/method/path/status to stderr")
-        .description("Start read-only observe HTTP server")
+        .description("Start read-only observe HTTP server (compat entry; prefer console serve)")
         .action(async (options) => {
         const repoRoot = path.resolve(options.repo);
         const server = await createObserveServer({
@@ -570,6 +570,9 @@ export function buildAgentWorkerProgram() {
             port: Number.parseInt(options.port, 10),
             debug: options.debug === true,
         });
+        process.stderr.write("[OBSERVE_SERVE_DEPRECATED] agent-worker observe serve 作为独立看板入口将在兼容窗口后下线。\n" +
+            "请改用：agent-worker console serve --repo <repo> --port 8790\n" +
+            "统一 Operator Console 已包含原 Observe 的只读检视能力：http://127.0.0.1:8790/\n");
         process.stdout.write(`${server.url}\n`);
         await new Promise((resolve) => {
             const shutdown = () => resolve();
@@ -593,22 +596,18 @@ export function buildAgentWorkerProgram() {
         .command("serve")
         .requiredOption("--repo <repo-root>", "Target repo root")
         .option("--port <port>", "HTTP port", "8790")
-        .option("--host <host>", "Bind host (default 127.0.0.1; non-loopback is rejected)", "127.0.0.1")
+        .option("--host <host>", "Bind host (default 127.0.0.1; use 0.0.0.0 for LAN, no network auth)", "127.0.0.1")
+        .option("--debug", "Log request source/method/path/status to stderr")
         .option("--app-data <path>", "Override Console application-data root (Draft/Operation/confirmation)")
-        .description("Start Loop Operator Console HTTP server (static SPA + Operator API)")
+        .description("Start Loop Operator Console HTTP server (Operate + Inspect; static SPA + Operator API)")
         .action(async (options) => {
         const { createConsoleServer } = await import("./console/server.js");
-        const { isLoopbackHost } = await import("./console/loopback.js");
-        if (!isLoopbackHost(options.host)) {
-            process.stderr.write(`console serve: non-loopback host "${options.host}" is not allowed (fail closed)\n`);
-            process.exitCode = 1;
-            return;
-        }
         const repoRoot = path.resolve(options.repo);
         const server = await createConsoleServer({
             repoRoot,
             host: options.host,
             port: Number.parseInt(options.port, 10),
+            debug: options.debug === true,
             appDataRoot: options.appData
                 ? path.resolve(options.appData)
                 : undefined,
@@ -625,13 +624,15 @@ export function buildAgentWorkerProgram() {
         .command("doctor")
         .requiredOption("--repo <repo-root>", "Target repo root")
         .option("--json", "Emit JSON report on stdout")
-        .option("--observe-url <url>", "Optional Observe base URL to probe (non-blocking)", "http://127.0.0.1:8787")
-        .description("Report sibling loop-agent identity, repo preflight, and optional Observe health")
+        .option("--observe-url <url>", "Legacy external Observe base URL to probe (non-blocking)")
+        .option("--console-url <url>", "Unified Console base URL to probe")
+        .description("Report sibling identity, preflight, and unified Inspect readiness")
         .action(async (options) => {
         const { formatConsoleDoctorHuman, runConsoleDoctor } = await import("./console/doctor.js");
         const report = await runConsoleDoctor({
             repoRoot: path.resolve(options.repo),
             observeBaseUrl: options.observeUrl,
+            consoleBaseUrl: options.consoleUrl,
         });
         if (options.json) {
             process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);

package/dist/worker/console/doctor.js

@@ -1,3 +1,4 @@
+import { existsSync } from "node:fs";
 import { mkdtemp } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -7,6 +8,8 @@ import { probePiReadiness, } from "./pi-readiness.js";
 import { DEFAULT_OBSERVE_BASE_URL, OBSERVE_START_COMMAND, probeAndClassifyObserve, } from "./observe-health-match.js";
 import { repoFingerprintV1 } from "./repo-fingerprint.js";
 import { resolveSiblingLoopAgentBin } from "./sibling-controller.js";
+import { defaultObserveStaticDir, ROUTES } from "../observe/routes.js";
+import { deriveObserveRouteCapabilities } from "../observe/health.js";
 async function probeObserve(url, localFingerprint, fetchImpl) {
     const classified = await probeAndClassifyObserve({
         baseUrl: url,
@@ -42,6 +45,48 @@ async function probeObserve(url, localFingerprint, fetchImpl) {
         message: classified.message,
     };
 }
+async function probeInspect(consoleBaseUrl, fetchImpl) {
+    const routeCapabilities = deriveObserveRouteCapabilities(ROUTES);
+    if (!consoleBaseUrl) {
+        const ready = existsSync(path.join(defaultObserveStaticDir(), "index.html"));
+        return {
+            status: ready ? "ready" : "degraded",
+            source: "static-assets",
+            routeCapabilities,
+            message: ready
+                ? "Inspect 静态资源可用；启动 agent-worker console serve 以提供统一入口"
+                : "Inspect 静态资源缺失；请运行构建或检查发布包",
+        };
+    }
+    const url = `${consoleBaseUrl.replace(/\/+$/, "")}/api/health`;
+    try {
+        const response = await fetchImpl(url, {
+            method: "GET",
+            signal: AbortSignal.timeout(1500),
+        });
+        const body = (await response.json());
+        const ready = response.ok &&
+            body.ok === true &&
+            body.schemaVersion === 1 &&
+            body.inspect?.ready === true;
+        return {
+            status: ready ? "ready" : "degraded",
+            source: "console-health",
+            url,
+            routeCapabilities: body.inspect?.routeCapabilities ?? routeCapabilities,
+            message: ready ? undefined : "Console health 未确认 Inspect 已就绪",
+        };
+    }
+    catch (error) {
+        return {
+            status: "degraded",
+            source: "console-health",
+            url,
+            routeCapabilities,
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
 /**
  * Run console doctor checks. Observe unavailability never fails the report.
  */
@@ -115,8 +160,14 @@ export async function runConsoleDoctor(options) {
             message: "cannot run preflight without sibling loop-agent bin",
         };
     }
-    const observeBase = options.observeBaseUrl ?? DEFAULT_OBSERVE_BASE_URL;
-    const observe = await probeObserve(observeBase, fingerprint, options.fetchImpl ?? fetch);
+    const inspect = await probeInspect(options.consoleBaseUrl, options.fetchImpl ?? fetch);
+    const observe = options.observeBaseUrl
+        ? await probeObserve(options.observeBaseUrl, fingerprint, options.fetchImpl ?? fetch)
+        : {
+            status: "unavailable",
+            url: `${DEFAULT_OBSERVE_BASE_URL}/api/health`,
+            message: "未探测兼容 Observe；统一 Inspect 不依赖 8787",
+        };
     const pi = await probePiReadiness({
         override: options.piReadinessProbe,
         siblingControllerOk: Boolean(controllerIdentity && "packageVersion" in controllerIdentity),
@@ -133,6 +184,7 @@ export async function runConsoleDoctor(options) {
         piReadiness: pi.state,
         pi,
         observe,
+        inspect,
         generatedAt: new Date().toISOString(),
     };
 }
@@ -148,6 +200,7 @@ export function formatConsoleDoctorHuman(report) {
         `pi.interviewSession: ${report.pi.probe.interviewSessionOk}`,
         `preflight: ${report.preflight.ok ? `ok (${report.preflight.summary})` : `fail ${report.preflight.code}: ${report.preflight.message}`}`,
         `observe: ${report.observe.status}${report.observe.status === "unavailable" || report.observe.status === "mismatch" ? ` (${report.observe.message})` : ""}`,
+        `inspect: ${report.inspect.status}${report.inspect.message ? ` (${report.inspect.message})` : ""}`,
     ];
     if (report.observe.status === "unavailable" ||
         report.observe.status === "mismatch") {

package/dist/worker/console/index.js

@@ -1,4 +1,5 @@
 export { createConsoleServer, defaultConsoleStaticDir } from "./server.js";
+export { buildOperatorSurfaceHealthV1 } from "./operator-surface-health.js";
 export { runConsoleDoctor, formatConsoleDoctorHuman } from "./doctor.js";
 export { isLoopbackHost } from "./loopback.js";
 export { repoFingerprintV1, normalizeWorktreeRealpath, } from "./repo-fingerprint.js";

package/dist/worker/console/loopback.js

@@ -1,6 +1,6 @@
 /**
- * Console-local loopback host check. Non-loopback binds fail closed
- * (unlike Observe, which only warns).
+ * Console-local loopback host check.
+ * Used for default bind safety messaging and mutation Host checks on loopback binds.
  */
 export function isLoopbackHost(host) {
     const normalized = host.trim().toLowerCase();

package/dist/worker/console/observe-link.js

@@ -1,7 +1,8 @@
 /**
- * Observe hash-route deep-link builder (Phase 1 skeleton).
- * Does not mount/proxy Observe or fetch its snapshot.
+ * Deprecated Observe deep-link compatibility helpers.
+ * New unified-surface callers should use buildInspectDeepLink.
  */
+import { buildInspectUrl, selectionFromObserveLinkTarget, } from "./operator-selection.js";
 function stripTrailingSlash(baseUrl) {
     return baseUrl.replace(/\/+$/, "");
 }
@@ -31,3 +32,7 @@ export function buildObserveDeepLink(baseUrl, target) {
         }
     }
 }
+/** Build a canonical same-origin Inspect URL for the unified Operator surface. */
+export function buildInspectDeepLink(origin, target) {
+    return buildInspectUrl(origin, selectionFromObserveLinkTarget(target));
+}

package/dist/worker/console/operator-actions.js

@@ -5,7 +5,7 @@ import { getTaskPaths } from "../../task/runtime.js";
 import { stageUtf8Text } from "./app-data.js";
 import { ALL_CONFIRMATION_CHALLENGES, hashDagBytes, } from "./dag-confirmation.js";
 import { capabilityForObserveTarget, DEFAULT_OBSERVE_BASE_URL, OBSERVE_START_COMMAND, probeAndClassifyObserve, } from "./observe-health-match.js";
-import { buildObserveDeepLink, } from "./observe-link.js";
+import { buildInspectDeepLink, buildObserveDeepLink, } from "./observe-link.js";
 import { resolveLatestDagRunIdForTask } from "./resolve-dag-run-for-task.js";
 import { repoFingerprintV1 } from "./repo-fingerprint.js";
 import { scheduleOperation, } from "./operation-runner.js";
@@ -285,7 +285,8 @@ export async function dispatchOperatorAction(ctx, req) {
             };
         }
         case "observeLink": {
-            const baseUrl = ctx.observeBaseUrl ?? DEFAULT_OBSERVE_BASE_URL;
+            const consoleOrigin = ctx.getConsoleOrigin?.();
+            const baseUrl = ctx.observeBaseUrl ?? consoleOrigin ?? DEFAULT_OBSERVE_BASE_URL;
             const dagRunId = str(p.dagRunId);
             const taskId = str(p.taskId);
             const featureId = str(p.featureId);
@@ -320,6 +321,33 @@ export async function dispatchOperatorAction(ctx, req) {
             const requiredCapability = target
                 ? capabilityForObserveTarget(target)
                 : undefined;
+            const usesUnifiedSurface = Boolean(consoleOrigin) &&
+                (!ctx.observeBaseUrl ||
+                    ctx.observeBaseUrl.replace(/\/+$/, "") ===
+                        consoleOrigin?.replace(/\/+$/, ""));
+            if (usesUnifiedSurface) {
+                const inspectPath = target
+                    ? buildInspectDeepLink(consoleOrigin, target).slice(consoleOrigin.length)
+                    : "/inspect/#/";
+                return {
+                    kind: "sync",
+                    status: 200,
+                    body: operatorSucceeded("observeLink", {
+                        url: target
+                            ? buildInspectDeepLink(consoleOrigin, target)
+                            : `${consoleOrigin.replace(/\/+$/, "")}/inspect/#/`,
+                        inspectPath,
+                        status: "same-origin",
+                        requiredCapability: requiredCapability ?? null,
+                        dagRunId: target?.kind === "dag"
+                            ? target.dagRunId
+                            : resolvedFromTask?.dagRunId,
+                        taskId: taskId ?? undefined,
+                        home: openHome || undefined,
+                        fallbackToTask: fallbackToTask || undefined,
+                    }),
+                };
+            }
             let localFingerprint;
             try {
                 localFingerprint = repoFingerprintV1(ctx.repoRoot);

package/dist/worker/console/operator-selection.js

@@ -0,0 +1,92 @@
+function segment(value) {
+    return encodeURIComponent(value);
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value.length > 0;
+}
+export function encodeInspectHash(selection) {
+    switch (selection.kind) {
+        case "feature":
+            return `#/feature/${segment(selection.featureId)}`;
+        case "feature-task":
+            return `#/feature/${segment(selection.featureId)}/task/${segment(selection.taskId)}`;
+        case "legacy-task":
+            return `#/task/${segment(selection.taskId)}`;
+        case "dag-run":
+            // Inspect currently owns DAG-level routing. nodeId remains URL-adjacent
+            // selection state until the static router explicitly supports it.
+            return `#/dag/${segment(selection.dagRunId)}`;
+        case "worker-run":
+            return `#/run/${segment(selection.workerRunId)}`;
+        case "batch":
+            return `#/batch/${segment(selection.batchRunId)}`;
+    }
+}
+export function buildInspectPath(selection) {
+    return `/inspect/${selection ? encodeInspectHash(selection) : "#/"}`;
+}
+export function buildInspectUrl(origin, selection) {
+    const base = origin.trim().replace(/\/+$/, "");
+    if (!base)
+        throw new Error("buildInspectUrl: origin is required");
+    return `${base}${buildInspectPath(selection)}`;
+}
+function decodeSegment(value) {
+    if (!nonEmpty(value))
+        return null;
+    try {
+        const decoded = decodeURIComponent(value);
+        return decoded ? decoded : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function decodeInspectHash(hash) {
+    const normalized = hash.startsWith("#") ? hash.slice(1) : hash;
+    const parts = normalized.split("/").filter(Boolean);
+    if (parts.length === 0)
+        return null;
+    const [kind, first, third, fourth] = parts;
+    const id = decodeSegment(first);
+    if (!id)
+        return null;
+    if (kind === "feature" && parts.length === 2) {
+        return { kind: "feature", featureId: id };
+    }
+    if (kind === "feature" && parts.length === 4 && third === "task") {
+        const taskId = decodeSegment(fourth);
+        return taskId ? { kind: "feature-task", featureId: id, taskId } : null;
+    }
+    if (kind === "task" && parts.length === 2)
+        return { kind: "legacy-task", taskId: id };
+    if (kind === "dag" && parts.length === 2)
+        return { kind: "dag-run", dagRunId: id };
+    if (kind === "run" && parts.length === 2)
+        return { kind: "worker-run", workerRunId: id };
+    if (kind === "batch" && parts.length === 2)
+        return { kind: "batch", batchRunId: id };
+    return null;
+}
+export function selectionFromObserveLinkTarget(target) {
+    switch (target.kind) {
+        case "dag":
+            return { kind: "dag-run", dagRunId: target.dagRunId };
+        case "task":
+            return { kind: "legacy-task", taskId: target.taskId };
+        case "feature":
+            return { kind: "feature", featureId: target.featureId };
+        case "worker":
+            return { kind: "worker-run", workerRunId: target.workerRunId };
+        case "batch":
+            return { kind: "batch", batchRunId: target.batchRunId };
+    }
+}
+/** Canonicalize only the historical Console root hash shape. */
+export function normalizeLegacyConsoleDagHash(pathnameAndHash) {
+    const [pathname, hash = ""] = pathnameAndHash.split("#", 2);
+    if ((pathname === "/" || pathname === "") && /^\/dag\/[^/]+$/.test(hash)) {
+        return `/inspect/#${hash}`;
+    }
+    return pathnameAndHash;
+}

package/dist/worker/console/operator-surface-health.js

@@ -0,0 +1,23 @@
+import { deriveObserveRouteCapabilities, resolveObservePackageIdentity, } from "../observe/health.js";
+import { repoFingerprintV1 } from "./repo-fingerprint.js";
+export function buildOperatorSurfaceHealthV1(input) {
+    const { packageName, packageVersion } = resolveObservePackageIdentity();
+    const snapshotAvailable = input.routes.some((route) => route.method === "GET" && route.pattern.test("/api/snapshot"));
+    const eventStreamAvailable = input.routes.some((route) => route.method === "GET" && route.pattern.test("/api/events/stream"));
+    return {
+        schemaVersion: 1,
+        ok: true,
+        product: "loop-operator-console",
+        repoFingerprint: repoFingerprintV1(input.repoRoot),
+        packageName,
+        packageVersion,
+        piReadiness: input.piReadiness,
+        inspect: {
+            ready: input.inspectReady,
+            routeCapabilities: deriveObserveRouteCapabilities(input.routes),
+            snapshotAvailable,
+            eventStreamAvailable,
+        },
+        generatedAt: input.generatedAt ?? new Date().toISOString(),
+    };
+}

package/dist/worker/console/recovery-cta.js

@@ -38,9 +38,9 @@ const CTA = {
     },
     observeLink: {
         id: "observeLink",
-        label: "打开 Observe 深链",
+        label: "打开检视",
         action: "observeLink",
-        commandHint: "agent-worker observe serve --repo . --port 8787",
+        commandHint: "agent-worker console serve --repo . --port 8790",
     },
 };
 const MATRIX = {