@tea-agent/loop-agent 0.42.0-next.8 → 0.42.0

package/CHANGELOG.md

@@ -2,43 +2,61 @@
 
 ## [Unreleased]
 
-- 修复 Operator Chat 打开已丢失会话时把孤儿 JSONL 升级成 503、以及删会话后残留 workspace 选择被误报为跨工作区冲突的问题：缺失会话文件现在自愈为 404 并清掉记录，前端恢复路径安静忘记该会话。
-- 修复前端 `--from-text` 任务缺少 source-fidelity ledger、DAG 生成后降级为 v1 并在 `frontend-contract-pi` 0ms 失败的问题：文本入口现在持久化可校验的 v2 绑定输入，init-hybrid 复用任务自有需求源；Console 默认模型与 Pi readiness 同时排除无凭据 provider，避免把不可执行模型误报为可用。
-- 常规回归 `npm test` 默认跳过约 6 分钟的 I/O-heavy 测试池（仍跑 fast + integration）；完整三池改为 `npm run test:full` / `LOOP_AGENT_FULL_TEST=1`。本地 `ci.sh`、GitHub PR 与 release/next 发布门禁仍跑全量，不降低交付验证。
-- 修复 backend-test 把 `pytest.param({"title": ""})` 整段 dict 当成 empty 观察、且 `example=` 空值导致 `target=body.title` 解析失败的问题：空 example 仍解析 field，dict 内空字符串按字段 MATCH。
-- 修复 backend-test 把自动化映射多写的横切测试点当成 Markdown BLOCKED、挡住 N11 修 docstring 的问题：只拦 `### 测试点` 未恰好绑定一次。
-- 修复 backend-test 把 pytest `_MISSING` 哨兵当成普通 Name、可选 `min; bound=0` UNDETERMINED 的问题：`_MISSING` 与 `_OMIT` 同为省略键。
-- 修复 backend-test 把可选字段 `min; bound=0` 的 `_OMIT` 判成 UNDETERMINED 的问题：省略键视为空最小；`OMITTED` TP 视为 missing。
-- 修复 backend-test 对 `http_client(operation, json_body=dict)` 观察不到 payload 的问题：http-like Name-call 的第一参是参数化 method 变量时仍计入 `json_body`。
-- 修复 backend-test 把 Markdown `Payload Required Paths: false` 当成路径、GET filter 整 Case UNSAFE 的问题：`true`/`false` 与 `none` 一样不是 path。
-- 修复 backend-test 把列表反引号里的 `场景意图: ... bound=0` 解析失败、并把 `max+1` 的数字 1 当成 minLength 的问题：围栏行可解析，`+/-` 后缀数字不进 prose 窗。
-- 修复 backend-test 把 fixture `http("POST", path, json_body={"title": ...})` 当成无 payload、整 Case PAYLOAD_SHAPE_MISMATCH 的问题：首参为 HTTP method 的 Name-call 进入 observedPaths。eligibility 门禁不放宽。
-- 修复 backend-test 把 `intent=min; bound=0` 当成缺 bound 并落到 `maxLength`、导致空 content MISMATCH 的问题：无 `minLength=` / TP LEN 时保留 0；`max; bound=0` 仍是哨兵。
-- 修复 backend-test 把 evidence-only pytest stub（模块 docstring + Case-ID、无 `def test_`）当成截断脚本、N9 `incomplete-write-set` 的问题：闭合 stub 可通过 completeness，半截 `def (` 仍 fail-closed。
-- 修复 backend-test 把 Markdown 机器行 `intent=max-1; bound=99` 当成契约 max、导致 `x*99` MISMATCH 的问题：`max-1`/`max+1`/`min-1` 优先 `maxLength=` 与文案三元组。eligibility 门禁不放宽。
-- 修复 backend-test 把 pytest 多写、Markdown 没有的 `0:1` extra symbol 当成 Markdown Test Point binding 缺陷并 BLOCKED 的问题：这类条目进入 N11 删除多余函数，不再清空 pytest repair。
-- 修复 backend-test N12 只读 effective collection 再次跑 scenario-param 确定性写回、在 `filesystem-only` 下 `write-guard` 失败的问题：N12 只复验，不再改 pytest。N10 仍可修一次。
-- 修复 backend-test 把 `脚本：无` 的 evidence-only Case 当成缺 pytest 符号送进 N11 的问题：精确 1:0 元用例不再触发 `missing-pytest-symbol` repair，N11 不得发明业务函数。真缺符号的 1:0 仍可修。eligibility 门禁不放宽。
-- 修复 backend-test 把 Scenario Partitions 数据行的 exact `TP-SP-...` 清单写成第 8 列、导致 N6 `MISSING_PARTITION` 的问题：仅当尾列全是该 Partition 的 slot ID 时确定性裁成 7 列并写回 run-owned plan。7 列契约与非 slot 多余列 fail-closed 不放宽。
-- 修复 backend-test scenario 把 `intent=max-1` 当成 unknown、以及 Markdown 只写「100 个字符的最大 / 1999、2000、2001」时解析不到 bound 的问题：`max-1` 进入 closed set，长度清单三元组与「N 个字符的最大」可得到 MATCH。eligibility 门禁不放宽。
-- 修复 backend-test correspondence 把前面函数的 `pytest.param(..., id="TP-...")` 叠进后续 Case `parameterIds` 的问题：decorator 区域遇到上一 `def`/`class` 或非 decorator 续行即停，不再把整组打成 `TEST_POINT_BINDING_EXTRA`。eligibility 门禁不放宽。
-- 修复 backend-test scenario facts 把内部 max/min/oversize helper 哨兵 `-1/-2/-3` 写成 `observedLength`、导致 N10 在 schema `min(0)` 上 `invalid-output` 的问题：这些 helper 仍按 Markdown bound MATCH，持久化长度只保留非负值。
-- 修复 backend-test 把 GET `params=`/`query=` 过滤字段、Python `True`/`False` 布尔字面量和混合大小写 `pytest.param` 列表漏出 correspondence/payload/scenario 观察的问题：这些 variant 现在可以按 item 授权，而不再把整 Case 打成 `PAYLOAD_SHAPE_MISMATCH` / `VARIANT_PARAMETER_MISSING`。eligibility 门禁不放宽。
-- 修复 backend-test 计划协议标题被翻译成中文后 N3 直接 `missing-module-index`、以及 Markdown writer 漏写精确 Scenario Partition slot 只能等到 N6 才失败的问题：N3 现在把 `## 模块索引/覆盖范围/覆盖矩阵/场景分区` 确定性改写成英文 canonical heading 并最多写回一次 run-owned `plan.md`，同时展开 slot 清单写入 `contracts/backend-test-scenario-partition-slots.json` 并注入 map child `requiredVariantSlots`。Markdown shard completeness 对缺失精确 `TP-SP-...` variant 报 `incomplete-partition-slot-set` 并允许一次有界补写。覆盖语义按方案 A：Case 数量可以少于枚举数量，但每个 slot 仍须独立 variant Test Point；`SINGLE`/`MULTIPLE` 不计覆盖。N6 fail-closed 不放宽。
-- 修复 backend-test strict Markdown map writer 的 upstream artifact pointer 泄漏：当长上游输出的 `stdout.md` 不在当前节点 `readSet` 时，不再向 Pi 注入不可读取的 artifact 路径，避免模型触发 `read-outside-read-set` 后进入 pending；保留有界 preview，并新增回归覆盖严格 writer 边界。
-- 修复 backend-test Manifest 把模型生成的 Module Stem 展示单元格当成模块身份真源、导致 low-tier 输出（缺 `test_` 前缀或整段 Markdown 链接）在 N3 `module-markdown-path-mismatch` 反复失败的问题：N3 现在先解析唯一合法 Markdown Path 与 `<stem>.md` 相对链接作为 canonical 身份，再校验业务 ownership/split 与路径安全；Stem 单元格只作冗余展示并能确定性重写为 canonical 文件名 stem。strict `backendTest.moduleLayout` 改为先按唯一 required Markdown Path 定位模块，再恢复冻结 Markdown/Pytest path pair，避免错误 stem 提前丢弃整行，同时保留 Plan-only pytest path 修复。Markdown Path 缺失/多候选/越界或与 strict path pair 冲突、以及多行 canonicalize 后同 identity（`duplicate-canonical-module-stem`）继续 fail-closed，不再静默去重。同步加强 N2 prompt（Stem 单元格仅允许纯文件名 stem）。
-- 修复 Next Release 的 io-heavy 测试并发不稳定：发布 workflow 将该池固定为单 worker，避免全部测试已通过后触发 Vitest `onTaskUpdate` RPC settlement timeout，并消除 controller identity/package fingerprint 测试之间的共享状态竞态；不跳过或删除任何测试。
-- 修复 backend-test 唯一 pytest collection repair 已产生受控非空修改、却因模型遗漏 `IMPLEMENTATION_OUTCOME` 而阻断整条执行链的问题：仅 N11 exact repair writer 可把完全缺失的 outcome 确定性恢复为候选 changed，随后仍必须由 N12 重新通过 scenario、correspondence、payload、collection、fixture 和 readiness 门禁；unknown/conflicting/blocked、空 diff、越界写入及 provider/context failure 继续 fail-closed。
-- 新建和删除对话现在会立即在侧栏中反馈：新建时先显示“正在创建”，删除时平滑淡出；网络失败会自动恢复原会话，不再需要等待整张会话列表刷新后才看到变化。
-- 新建对话会优先复用当前工作区中真正的空白会话，避免重复创建；有历史消息、工具调用、待发送内容或正在运行的会话不会被复用。
-- 会话列表刷新现在会复用未变化的行和列表引用，标题、运行状态或队列变化时只更新对应会话，侧栏切换和刷新更平滑。
-- Operator Chat 新增仅对具备 Aimax 凭证的用户可见的 `/sdd-bingo` 数据对齐命令；`wizard-local` 模型请求会自动携带与上报一致的 OpenCode 风格会话身份、当前模型和最新 API key，请求头与资格文件变更均在下一次操作自动生效。
-- DAG 节点检查器的「执行记录」默认自动跟随最新内容；右下角新增纯图标悬浮开关，可显式暂停并保留阅读位置，恢复后立即回到底部，悬停时显示当前可执行动作。
-- 修复前端任务产物派生续跑无法识别当前节点链的问题；从实现节点继续时，设计约束、写入准入、验证和收尾步骤会按现行流程安全重放。
-- 统一工作区、Todo 和其他滚动区域的滚动条样式，默认更轻巧，鼠标悬浮时也更容易辨认。
-- HTML 文件预览现在支持页面内的标签切换等交互；较大的自包含 HTML 可以在新窗口中直接完整加载，不再受源码摘要长度影响。
-- 修复 Operator Chat 长工具链的消息错序：模型过程文字、思考和工具卡片现在按服务端事件顺序稳定交替展示，刷新历史会话后也保持相同顺序。
-- 修复 Operator Chat 旧会话继续使用过期模型认证的问题：模型配置变化后，下一轮发送或手动重新加载会自动刷新模型目录和当前模型认证。
+## [0.42.0] - 2026-09-07
+
+### 新增
+
+- 新增了本发布周期内已经完成并通过验证的功能。
+
+### 改进
+
+- 完善了日常使用体验和运行稳定性。
+
+### 修复
+
+- 修复了影响使用体验或运行稳定性的问题。
+
+## [0.41.3] - 2026-09-04
+
+### 改进
+
+- 完善了本发布周期内的日常使用体验和运行稳定性。
+
+### 修复
+
+- 修复了部分功能在特定环境下无法正常使用的问题。
+
+## [0.41.2] - 2026-09-04
+
+### 修复
+
+- 修复了 DAG 扩展解析、会话恢复和观测页面资源缓存等问题，让任务执行和对话页面在更新后更加可靠。
+- 修复了孤儿会话和观测入口偶发失效的问题，重启或刷新后可以继续使用原有会话。
+
+## [0.41.1] - 2026-09-02
+
+### 修复
+
+- 修复发布流程中的测试并发稳定性问题。
+- 修复旧会话继续使用过期模型认证的问题，配置更新后会自动采用最新认证信息。
+- 修复长工具链消息错序，历史会话也保持正确顺序。
+- 统一工作区、Todo 和其他滚动区域的滚动条样式。
+- 改进 HTML 文件预览，支持页面内交互和独立窗口完整阅读。
+
+### 测试
+
+- Pi MED 档测试改为校验模型档位形状，避免具体模型切换造成误报。
+
+## [0.41.1-beta.0] - 2026-08-31
+
+### 用户可见更新
+
+- 前端自动化任务的规划、执行和结果检查更加稳定，失败后更容易继续处理。
+- 长任务和复杂工作区的进度、文件和运行结果展示更加清晰。
+- 插件管理、文件预览和任务详情等常用操作得到改进。
+
+<details>
+<summary>实现细节（开发者参考）</summary>
 
 - 0.41.1-beta.0（frontend-node dogfood）：将前端 DAG 的 Contract、Scout、Plan 切换为节点专属 skill/reference，bounded implement 仅注入有界代码规范；在保留默认 3K/12K 上下文预算的同时，避免 `frontend-plan-pi` 的必需 stable-id 追踪合同被静默截断。
 - 拆分前端 DAG 的大一统 skill 注入：`frontend-contract-pi`、`frontend-scout-pi`、`frontend-plan-pi` 分别使用阶段专属 skill/reference，默认 12K runtime 预算内完整加载关键合同，不再让三个节点重复携带整份 node lifecycle、设计与代码规范；bounded implement 单独接收不授权扩展侦察的代码规范。新增真实默认预算回归断言，防 required reference 再次静默截断或因预算遗漏。
@@ -260,19 +278,7 @@
 - 右侧辅助栏统一承载文件、上下文、调用记录、运行活动和当前 DAG；点击消息流中的运行状态即可在同一侧栏查看运行、门禁与产物，并可自由调整侧栏宽度。
 - 新增任务清单与结构化提问卡片，让长任务的进度和需要用户选择的内容更容易理解。
 - 「对话 / 操作 / 观测」使用统一导航；操作和观测页面可以切换工作区查看对应数据。
-## [0.41.1] - 2026-09-02
-
-### 修复
-
-- 修复 Next Release 发布 workflow 的 io-heavy 测试并发不稳定：将该测试池固定为单 worker，避免全部测试通过后因过高并发触发 Vitest `onTaskUpdate` RPC settlement timeout，并消除 controller identity / package fingerprint 测试之间的共享状态竞态。
-- 修复 Operator Chat 旧会话继续使用过期模型认证的问题：模型配置变化后，下一轮发送或手动重新加载会自动刷新模型目录和当前模型认证。
-- 修复 Operator Chat 长工具链的消息错序：模型过程文字、思考和工具卡片现在按服务端事件顺序稳定交替展示，刷新历史会话后也保持相同顺序。
-- 统一工作区、Todo 和其他滚动区域的滚动条样式，默认更轻巧，鼠标悬浮时也更容易辨认。
-- HTML 文件预览现在支持页面内的标签切换等交互；较大的自包含 HTML 可以在新窗口中直接完整加载，不再受源码摘要长度限制。
-
-### 测试
-
-- `harness.json` Pi MED 档测试不再 pin 具体模型 id，改为校验 tier 形状，避免每次 dogfood 档位切换都造成测试失败。
+</details>
 
 ## [0.41.0] - 2026-08-31
 

package/dist/application/dag/run-dag.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { createDagEventObserver } from "../../workflows/dag/event-observer.js";
 import { composeDagRunObservers } from "../../workflows/dag/observer-compose.js";
 import { createDagCanvasObserver, resolveCanvasPath, } from "../../workflows/dag/canvas-observer.js";
@@ -28,6 +29,41 @@ function buildRunDagNextSteps(runId) {
         `loop-agent dag report --run-id ${runId} --markdown  # advanced forensic`,
     ];
 }
+/** Shared production recovery seam for fresh runs and recovery continuations. */
+export async function buildDefaultFrontendRecoveryDeps(repoRoot) {
+    // Keep the application layer free of a static worker→application cycle. The
+    // recovery controller is only needed after a frontend terminal failure.
+    const [{ openConsoleAppData }, { OperationStore }, { createOperationEventStore }, { LoopAgentClient }, { resolveSiblingLoopAgentBin },] = await Promise.all([
+        import("../../infrastructure/console/app-data.js"),
+        import("../../infrastructure/console/operation-store.js"),
+        import("../../worker/console/operation-sse.js"),
+        import("../../worker/loop-agent/loop-agent-client.js"),
+        import("../../worker/console/sibling-controller.js"),
+    ]);
+    const appData = openConsoleAppData({ repoRoot });
+    const store = new OperationStore(appData);
+    const events = createOperationEventStore({
+        persistenceDir: path.join(appData.operations, "events"),
+    });
+    const client = new LoopAgentClient({
+        loopAgentBin: resolveSiblingLoopAgentBin(),
+        artifactRoot: path.join(appData.root, "client-artifacts", appData.fingerprint),
+        resolveIdentity: true,
+    });
+    return {
+        store,
+        operationRunnerDeps: {
+            store,
+            events,
+            client,
+            repoRoot,
+            env: {
+                ...process.env,
+                LOOP_CONSOLE_APP_DATA: appData.root,
+            },
+        },
+    };
+}
 export async function runDagUseCase(input) {
     const spec = await loadDagSpecFromFile(input.dagPath);
     assertValidDagSpec(spec);
@@ -80,6 +116,10 @@ export async function runDagUseCase(input) {
             ...(canvasError ? { canvasError } : {}),
         };
     }
+    const recovery = input.recovery ??
+        (!input.initOnly && spec.tasks.some((task) => task.id === "frontend-implement-pi")
+            ? await buildDefaultFrontendRecoveryDeps(input.cwd)
+            : undefined);
     const summary = await runDag(spec, {
         cwd: input.cwd,
         initOnly: input.initOnly,
@@ -90,6 +130,7 @@ export async function runDagUseCase(input) {
         ...(input.workerAssociation
             ? { workerAssociation: input.workerAssociation }
             : {}),
+        ...(recovery ? { recovery } : {}),
     });
     const canvasError = await flushCanvasSafely(canvas);
     if (resolvedCanvasPath) {

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

@@ -842,13 +842,18 @@ export async function advanceTaskLifecycle(input) {
                 break;
             }
             preparedContractThisCall = true;
-            if (startupRepairAction ||
-                refreshManagedContractThisCall ||
-                input.fromDraftPath) {
+            const contractChanged = prepareResult.apply?.noOp !== true;
+            if (contractChanged &&
+                (startupRepairAction ||
+                    refreshManagedContractThisCall ||
+                    Boolean(input.fromDraftPath))) {
                 // The old DAG and gate were bound to the pre-mutation contract.
-                refreshManagedContractThisCall = false;
                 regenerateDagThisCall = true;
             }
+            // Consume the refresh request even when projection was a content no-op;
+            // otherwise the re-plan would invoke prepare-contract repeatedly in this
+            // advance call and eventually hit the step limit.
+            refreshManagedContractThisCall = false;
             record = {
                 ...appendTransition(record, "contract-managed"),
                 pendingPrdRefresh: false,

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.42.0-next.8",
-  "gitSha": "1d1ada8ede350e5778d753c04ed72bacd778e43d",
-  "builtAt": "2026-09-02T23:47:25.236Z"
+  "version": "0.42.0",
+  "gitSha": "d4c9130bf4feb25e4c120f97d29786dd48062cfd",
+  "builtAt": "2026-09-07T01:59:32.047Z"
 }

package/dist/cli/program.js

@@ -440,7 +440,7 @@ const RAW_SUBCOMMAND_USAGE = {
     "dag approve": 'usage: dag approve --run-id <id> --option <A|B|...> [--notes "..."]',
     "dag reject": 'usage: dag reject --run-id <id> --reason "..."',
     "dag rerun": "usage: dag rerun --run-id <id> --from-node <node-id> --plan [--json] | dag rerun --run-id <id> --from-node <node-id> --plan-hash <hash> --request-id <key> --reason <text> [--json]",
-    "dag rerun-task": "usage: dag rerun-task --run-id <id> --reason <text> --request-id <key> [--profile auto|minimal|standard|reviewed|supervised] [--task-id <id>] [--json]",
+    "dag rerun-task": "usage: dag rerun-task --run-id <id> --reason <text> --request-id <key> [--profile auto|minimal|standard|reviewed|supervised] [--task-id <id>] [--frontend-recovery --recovery-operation-id <id>] [--json]",
     "dag reconcile-run": "usage: dag reconcile-run --run-id <id> [--action supersede|abandon] [--reason <text>]",
     "dag doctor": "usage: dag doctor [--run-id <id>]\nInspect health issues before approve/reject/resume; no --json (output is already structured JSON).",
     "dag report": "usage: dag report [--run-id <id>] [--lifecycle active|paused|completed|all] [--json|--markdown] [--failed-only] [--latest] [--paused-latest]\nRead-only run report; --json gives structured facts (canonical: `dag report --run-id <id> --lifecycle completed --json`).",

package/dist/commands/dag-rerun-task.js

@@ -11,6 +11,8 @@ export async function runDagRerunTask(repoRoot, rawArgs) {
         profileExplicit: parsed.profileExplicit,
         taskIdOverride: parsed.taskIdOverride,
         execute: parsed.execute,
+        frontendRecovery: parsed.frontendRecovery,
+        recoveryOperationId: parsed.recoveryOperationId,
     });
     console.log(JSON.stringify(result, null, 2));
     if (!result.ok) {

package/dist/commands/task-source-prepare.js

@@ -373,7 +373,9 @@ function printHuman(result) {
         }
     }
     if (result.apply) {
-        lines.push(`  apply: revision=${result.apply.ref.revision} txId=${result.apply.txId}`);
+        lines.push(result.apply.noOp
+            ? `  apply: revision=${result.apply.ref.revision} (unchanged; identical content, no new transaction)`
+            : `  apply: revision=${result.apply.ref.revision} txId=${result.apply.txId ?? "n/a"}`);
     }
     if (result.error) {
         lines.push(`  error: ${result.error.code}: ${result.error.message}`);