@tea-agent/loop-agent 0.35.1 → 0.35.3

package/AGENTS.md

@@ -94,6 +94,8 @@ npm run build
 node bin/loop-agent.js --help
 ```
 
+- 改 `src/**` 后必须先 `npm run build` 再用 `bin/loop-agent.js`：bin 内置 stale-dist 守卫（src 比 dist 新即硬失败，`--ignore-stale-dist` 逃生），`--version` 会显示构建 git SHA，发布/自测前用它确认跑的是目标改动。
+
 文档站变更：`npm run docs:build`。init / architecture / skill entry / pack 定向验证见 verification-matrix。
 
 ## 交接

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 ## [Unreleased]
 
+## [0.35.3] - 2026-08-15
+
+### 新增
+
+- chat as default landing + analyze-skills-first new-task flow
+- guide plan verification targets to writeSet-internal files, command-level checks to static
+- console recovery display — surface frontend recovery lineage + outcome
+- frontend-implementation DAG phase 6 — recovery root manifest + statistics dedup
+- frontend-implementation DAG phase 5 — writer partial-write rollback + child recovery
+- frontend-implementation DAG phase 4 — writer transient rollback base
+- frontend-implementation DAG phase 3c — scheduler activation gate + recovery trigger
+- frontend-implementation DAG phase 3b — staged child-creation kernel
+- frontend-implementation DAG phase 3a — recovery state/result types + terminal recovery intent
+- producing-node contract self-check and run robustness hardening
+- frontend-implementation DAG phase 2 — unified writer helper + structured repair assessment
+- slim frontend-implementation DAG phase 1 — prewrite merge + writer admission gate
+
+### 修复
+
+- 规范证据面板不再单列 openspec，统一为「规范已读取/规范检索」
+- green full test suite — python3 fallback, build-stamp version normalization, DEP0205 suppression
+- update candidate-continuation fixtures for failureCode (rebase semantic fix)
+
+## [0.35.2] - 2026-08-15
+
+### 重点更新
+
+- Operator Chat 处理详情对齐 pi-web：回合尾部的思考内容与工具调用摘要切分为可折叠「处理详情」，流式中思考可见，回合结束后自动折叠，最终回答单独成气泡
+
+### 新增
+
+- 对话时间线新增内联可折叠「处理详情」区块，集中展示模型思考与工具调用摘要，回合结束后自动折叠
+- turn-process 保留 SDK thinking blocks，流式传输与持久化均携带思考内容
+
+### 改进
+
+- 命令面板 shortcut 优化：Operator 组单行展示，/task、/contract、/dag 分别跳转到任务与恢复页面
+
+### 修复
+
+- 修复「处理详情」思考折叠块背景引用未定义样式变量 --panel 的问题，改为确定性透明背景，消除 Console 样式变量完整性门禁对发布的拦截（视觉无变化）
+- 移除自指的 /help 命令项：输入 / 已弹出命令面板，不再单独提供重复的帮助入口
+
 ## [0.35.1] - 2026-08-15
 
 ### 重点更新
@@ -31,6 +74,14 @@
 - 修复文字录入「请参照这三个prd路径XXX」只物化一句话、引用文件从未导入的问题
 - 修复 semantic intake attempt marker 一次性失败后永不重试的问题：新的 PRD 导入会重置 marker，失败可随新证据重试
 
+## [0.35.1-beta.4] - 2026-08-15
+
+> 观察面板规范证据不再单列 openspec：读取与检索统一为「规范已读取 / 规范检索」，空态文案同步中性化（beta，发布到 `beta` dist-tag）。
+
+## [0.35.1-beta.3] - 2026-08-14
+
+> frontend-implementation DAG 优化 v9 全六阶段 + Console 展示层（beta，发布到 `beta` dist-tag）。
+
 ## [0.35.0] - 2026-08-13
 
 ### 重点更新

package/README.md

@@ -110,7 +110,7 @@ agent-worker console doctor --repo .
 
 ```
 
-访问 Console <http://127.0.0.1:8790/>；**Operator Chat Official** 是 Console 内的主引导交互。构建时设置 `VITE_OPERATOR_CHAT_DEFAULT_LANDING=chat` 可将 Chat 作为默认 landing；flag 未开启时仍默认进入 Tasks，旧 Task Ops tab 始终保留。顶部「检视」以及 `/inspect/` 提供只读 Dashboard、DAG、时间线与 artifacts；`loop-agent …` / `agent-worker …` CLI direct path 仍是受治理 fallback。当前状态为 **code ready, dogfood pending/unmet**，不宣称已替代 openCode 或其他外部主会话。
+访问 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/bin/loop-agent.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { existsSync } from "node:fs";
+import { existsSync, readdirSync, statSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
@@ -13,6 +13,42 @@ if (!existsSync(cliEntry)) {
   process.exit(1);
 }
 
+/**
+ * Stale-dist guard: when running from a source checkout (src/ present), refuse
+ * to silently execute a dist/ that predates the latest source edit. The
+ * classic failure mode is editing src/** and running the bin without
+ * `npm run build`, which executes the previous build. Suppress with
+ * --ignore-stale-dist when intentionally running a stale build.
+ */
+const srcDir = join(packageRoot, "src");
+const ignoreStale = process.argv.includes("--ignore-stale-dist");
+if (ignoreStale) {
+  process.argv = process.argv.filter((arg) => arg !== "--ignore-stale-dist");
+}
+if (!ignoreStale && existsSync(srcDir)) {
+  const distCliMtime = statSync(cliEntry).mtimeMs;
+  let newestSrcMtime = 0;
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else {
+        const mtime = statSync(full).mtimeMs;
+        if (mtime > newestSrcMtime) newestSrcMtime = mtime;
+      }
+    }
+  };
+  walk(srcDir);
+  if (newestSrcMtime > distCliMtime) {
+    console.error(
+      `loop-agent: dist/ is stale relative to src/ (a source file is newer than ${cliEntry}).\n` +
+        `  Run \`npm run build\` before using the bin, or pass --ignore-stale-dist to run the stale build intentionally.`,
+    );
+    process.exit(1);
+  }
+}
+
 try {
   await import(pathToFileURL(cliEntry).href);
 } catch (error) {

package/dist/build-stamp.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": 1,
+  "version": "0.35.3",
+  "gitSha": "71e2505bbabe052302d753f25b4971e0bdb0f953",
+  "builtAt": "2026-08-15T11:42:48.937Z"
+}

package/dist/cli/program.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
-import { readPackageVersion } from "../shared/package-metadata.js";
+import { readCliVersionLabel } from "../shared/package-metadata.js";
 import { resolveAdapter } from "../adapters/index.js";
 import { runCoverageAudit } from "../commands/coverage-audit.js";
 import { runCoverageReport } from "../commands/coverage-report.js";
@@ -547,7 +547,7 @@ export function buildLoopAgentProgram(options) {
     program
         .name("loop-agent")
         .description("Loop Agent task and DAG automation CLI")
-        .version(readPackageVersion(path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url))))) ?? "0.0.0", "-V, --version", "display version")
+        .version(readCliVersionLabel(path.dirname(path.dirname(path.dirname(fileURLToPath(import.meta.url))))) ?? "0.0.0", "-V, --version", "display version")
         .showHelpAfterError()
         .option("--repo-root <path>", "repository root")
         .option("--adapter <name>", "harness adapter name")

package/dist/executors/dag-pi-executor.js

@@ -520,6 +520,33 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep, wr
     }
     let result;
     try {
+        // Phase 5 (P1-9): capture the writeSet baseline BEFORE the writer provider
+        // call so a transient partial write can be rolled back and recovered via a
+        // staged child. Only frontend-implementation writers; a failed capture is a
+        // hard fail (no baseline → no rollback → no recovery). Dynamic import avoids
+        // an executor ↔ scheduler static cycle.
+        if (isWriteTask &&
+            (input.task.id === "frontend-implement-pi" ||
+                input.task.id === "frontend-repair-pi") &&
+            (input.task.writeSet?.length ?? 0) > 0) {
+            try {
+                const { captureFrontendWriterAttemptIntent } = await import("../workflows/dag/frontend-writer-recovery.js");
+                await captureFrontendWriterAttemptIntent({
+                    cwd: input.cwd,
+                    runDir: meta.runDir,
+                    writeSet: input.task.writeSet,
+                });
+            }
+            catch (error) {
+                return {
+                    ok: false,
+                    stdout: "",
+                    stderr: `frontend writer attempt baseline capture failed: ${error instanceof Error ? error.message : String(error)}`,
+                    failureCategory: "write-guard",
+                    durationMs: Date.now() - started,
+                };
+            }
+        }
         result = await piStepFn({
             attachedFiles: [],
             modelConfig: resolveDagPiModelConfig(input.model, input.thinking ? { thinking: input.thinking } : undefined),
@@ -691,6 +718,23 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep, wr
             const changedFiles = pathsChangedDuringRun(snapshotGitStatusPorcelain(beforeStatus), afterSnapshot, beforePathFingerprints, afterPathFingerprints);
             changeManifestAfterStatus = afterStatus;
             changeManifestChangedFiles = changedFiles;
+            // Phase 5: record the attempt changed paths/hashes into the rollback
+            // intent so a transient partial write can be CAS-restored.
+            if ((input.task.id === "frontend-implement-pi" ||
+                input.task.id === "frontend-repair-pi") &&
+                (input.task.writeSet?.length ?? 0) > 0) {
+                try {
+                    const { recordFrontendWriterAttempt } = await import("../workflows/dag/frontend-writer-recovery.js");
+                    await recordFrontendWriterAttempt({
+                        cwd: input.cwd,
+                        runDir: meta.runDir,
+                        changedPaths: changedFiles,
+                    });
+                }
+                catch {
+                    // best-effort: a missing intent (no baseline captured) is a no-op
+                }
+            }
             const guard = validateShellWriteGuardFromDiff({
                 changedFiles,
                 task: input.task,

package/dist/shared/package-metadata.js

@@ -45,6 +45,48 @@ export function readPackageName(packageDir) {
     }
     return undefined;
 }
+/**
+ * Read the build stamp (git SHA + build time) written by the build pipeline
+ * into `<packageDir>/dist/build-stamp.json`. `undefined` when absent (e.g.
+ * running from source via tsx, or a hand-assembled package), which callers
+ * treat as "no stamp available".
+ */
+export function readBuildStamp(packageDir) {
+    try {
+        const raw = readFileSync(path.join(packageDir, "dist", "build-stamp.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed.schemaVersion !== 1 ||
+            typeof parsed.version !== "string" ||
+            typeof parsed.builtAt !== "string")
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Human-readable CLI version label: plain version, enriched with the build
+ * stamp (short git SHA + build date) when available so a stale dist/ that was
+ * built from an old commit is immediately recognizable in `--version`.
+ */
+export function readCliVersionLabel(packageDir) {
+    const version = readPackageVersion(packageDir) ?? "0.0.0";
+    const stamp = readBuildStamp(packageDir);
+    if (!stamp?.gitSha)
+        return version;
+    return `${version} (build ${stamp.gitSha.slice(0, 8)} ${stamp.builtAt.slice(0, 10)})`;
+}
+/**
+ * Strip the build-stamp suffix from a CLI `--version` label, returning the bare
+ * SemVer. Controller-identity/preflight comparisons must use this rather than
+ * the raw label so a build-stamped `0.35.0 (build 7f8c5b5b …)` still matches
+ * `packageVersion === "0.35.0"`.
+ */
+export function normalizeCliVersionLabel(label) {
+    const match = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?/.exec(label.trim());
+    return match ? match[0] : label.trim();
+}
 /**
  * Compute the SHA-256 hash of a file on disk.
  *

package/dist/worker/console/chat/assistant-content.js

@@ -0,0 +1,121 @@
+/**
+ * Assistant content-block helpers shared by Pi event mapping and Operator Chat UI.
+ * Mirrors pi-web `lib/message-display.ts` (process vs answer split) without deferred fetch.
+ */
+function asRecord(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    return value;
+}
+function readString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+/** Parse a persisted/SSE content array; unknown shapes are dropped. */
+export function parseAssistantContent(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const blocks = [];
+    for (const item of value) {
+        const rec = asRecord(item);
+        if (!rec)
+            continue;
+        const type = readString(rec.type) ?? "";
+        if (type === "thinking" || type === "reasoning") {
+            const thinking = readString(rec.thinking) ?? readString(rec.text) ?? "";
+            blocks.push({ type: "thinking", thinking });
+            continue;
+        }
+        if (type === "toolCall" ||
+            type === "tool_call" ||
+            type === "toolUse" ||
+            type === "tool_use") {
+            const toolCallId = readString(rec.toolCallId) ?? readString(rec.id) ?? "";
+            if (!toolCallId)
+                continue;
+            const toolName = readString(rec.toolName) ?? readString(rec.name);
+            blocks.push({
+                type: "toolCall",
+                toolCallId,
+                ...(toolName ? { toolName } : {}),
+            });
+            continue;
+        }
+        if (type === "text" || type === "output_text" || type === "") {
+            const text = readString(rec.text);
+            if (text !== undefined)
+                blocks.push({ type: "text", text });
+        }
+    }
+    return blocks;
+}
+/**
+ * Extract ordered assistant content blocks from a Pi SDK message object.
+ * Thinking/reasoning blocks keep their own type so they never leak into answer text.
+ */
+export function extractAssistantContentBlocks(message) {
+    const rec = asRecord(message);
+    if (!rec)
+        return [];
+    const contents = Array.isArray(rec.content) ? rec.content : [];
+    const parts = Array.isArray(rec.parts) ? rec.parts : [];
+    const fromArrays = parseAssistantContent([...contents, ...parts]) ?? [];
+    if (fromArrays.length > 0)
+        return fromArrays;
+    const top = readString(rec.text);
+    return top ? [{ type: "text", text: top }] : [];
+}
+/**
+ * Pi emits message_end for user / toolResult / custom too. Only assistant
+ * payloads belong in the Operator Chat assistant bubble (pi-web same split).
+ */
+export function isAssistantSdkMessage(message) {
+    const rec = asRecord(message);
+    if (!rec)
+        return false;
+    const role = readString(rec.role);
+    return role === undefined || role === "assistant";
+}
+/**
+ * Latest assistant answer text (text blocks only). Thinking is excluded.
+ * Preserves the historical `{ text }` / `{ parts: [{ text }] }` fallbacks.
+ */
+export function extractAssistantText(message) {
+    return extractAssistantContentBlocks(message)
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}
+export function isEmptyThinkingBlock(block, options = {}) {
+    return (block.type === "thinking" &&
+        !options.isStreaming &&
+        block.thinking.trim() === "");
+}
+export function getDisplayableAssistantBlocks(blocks, options = {}) {
+    return blocks.filter((block) => !isEmptyThinkingBlock(block, options));
+}
+function isFinalAnswerBlock(block) {
+    return block.type === "text";
+}
+export function splitFinalAssistantBlocks(blocks, options = {}) {
+    const displayable = getDisplayableAssistantBlocks(blocks, options);
+    let lastProcessIndex = -1;
+    for (let i = displayable.length - 1; i >= 0; i--) {
+        if (!isFinalAnswerBlock(displayable[i])) {
+            lastProcessIndex = i;
+            break;
+        }
+    }
+    if (lastProcessIndex === -1) {
+        return { answerBlocks: displayable, processBlocks: [] };
+    }
+    return {
+        answerBlocks: displayable.slice(lastProcessIndex + 1),
+        processBlocks: displayable.slice(0, lastProcessIndex + 1),
+    };
+}
+export function joinAssistantText(blocks) {
+    return blocks
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}

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

@@ -28,6 +28,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { access } from "node:fs/promises";
 import path from "node:path";
+import { extractAssistantContentBlocks, extractAssistantText, isAssistantSdkMessage, } from "./assistant-content.js";
 import { projectCompactSnapshot, } from "./chat-event-store.js";
 import { extractUsageSample } from "./usage.js";
 import { OPERATOR_CHAT_ALLOWED_TOOLS, authorizeOperatorChatTool, assertNoWriteToolInList, } from "./tools.js";
@@ -563,28 +564,7 @@ export function projectRuntimeSnapshot(input) {
         hasBash: input.hasBash,
     };
 }
-/**
- * Extract the latest assistant text fragment from an SDK message object.
- * Tolerant of multiple message shapes the SDK emits.
- */
-export function extractAssistantText(message) {
-    if (!message || typeof message !== "object")
-        return "";
-    const m = message;
-    if (typeof m.text === "string")
-        return m.text;
-    const contents = Array.isArray(m.content) ? m.content : [];
-    const parts = Array.isArray(m.parts) ? m.parts : [];
-    const segments = [];
-    for (const c of [...contents, ...parts]) {
-        if (!c || typeof c !== "object")
-            continue;
-        const seg = c;
-        if (typeof seg.text === "string")
-            segments.push(seg.text);
-    }
-    return segments.join("");
-}
+export { extractAssistantContentBlocks, extractAssistantText, isAssistantSdkMessage };
 function readSessionManagerId(manager) {
     if (!manager || typeof manager !== "object")
         return undefined;
@@ -2116,6 +2096,15 @@ export class ConsolePiRuntime {
             this.dispose(id);
     }
 }
+function mapAssistantMessageEvent(type, sessionId, message) {
+    const content = extractAssistantContentBlocks(message);
+    return {
+        type,
+        sessionId,
+        text: extractAssistantText(message),
+        ...(content.length > 0 ? { content } : {}),
+    };
+}
 function mapSdkEvent(sessionId, event) {
     switch (event.type) {
         case "agent_start":
@@ -2127,17 +2116,13 @@ function mapSdkEvent(sessionId, event) {
                 willRetry: Boolean(event.willRetry),
             };
         case "message_update":
-            return {
-                type: "message_update",
-                sessionId,
-                text: extractAssistantText(event.message),
-            };
+            if (!isAssistantSdkMessage(event.message))
+                return undefined;
+            return mapAssistantMessageEvent("message_update", sessionId, event.message);
         case "message_end":
-            return {
-                type: "message_end",
-                sessionId,
-                text: extractAssistantText(event.message),
-            };
+            if (!isAssistantSdkMessage(event.message))
+                return undefined;
+            return mapAssistantMessageEvent("message_end", sessionId, event.message);
         case "turn_end":
             // Usage is emitted from message_end (see prompt subscribe). turn_end
             // carries the same final assistant message and would double-count.

package/dist/worker/console/chat/routes.js

@@ -12,6 +12,7 @@
  * Mutation routes go through the Console mutation gate (boot token + Origin).
  * Read routes (GET capabilities / sessions) are open to loopback.
  */
+import { parseAssistantContent } from "./assistant-content.js";
 import { OPERATOR_CHAT_ALLOWED_TOOLS, OPERATOR_CHAT_DENIED_TOOLS, OPERATOR_CHAT_DENIED_OPERATOR_ACTIONS, } from "./tools.js";
 import { buildModelCallableToolSchemas } from "./tool-adapter.js";
 import { cleanChatTitle } from "./session-store.js";
@@ -83,12 +84,16 @@ function turnEventToStorePartial(event) {
         case "agent_start":
             return { kind: "agent_start", data: {} };
         case "message_update":
+        case "message_end": {
+            const content = parseAssistantContent(event.content);
             return {
-                kind: "message_update",
-                data: { text: String(event.text ?? "") },
+                kind: event.type,
+                data: {
+                    text: String(event.text ?? ""),
+                    ...(content ? { content } : {}),
+                },
             };
-        case "message_end":
-            return { kind: "message_end", data: { text: String(event.text ?? "") } };
+        }
         case "usage":
             return { kind: "usage", data: (event.usage ?? {}) };
         case "tool_call":

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

@@ -368,6 +368,9 @@ export async function runChatTurn(options) {
                         pending.push(store.appendMessage(sessionId, {
                             role: "assistant",
                             text: event.text,
+                            ...(event.content && event.content.length > 0
+                                ? { content: event.content }
+                                : {}),
                         }));
                     }
                     break;

package/dist/worker/console/chat/shortcuts.js

@@ -41,13 +41,6 @@ export const SHORTCUTS = [
         action: "reload",
         source: "operator",
     },
-    {
-        command: "/help",
-        label: "Shortcuts",
-        description: "显示可用 shortcut",
-        action: "show-help",
-        source: "operator",
-    },
 ];
 /** Pi Web commands with real browser-equivalent behavior (UI-11). */
 export const WEB_SLASH_COMMANDS = [
@@ -103,6 +96,15 @@ export function resolveShortcut(input) {
         return { command: local.command, action: local.action };
     return { command: token, action: "unknown" };
 }
+/** Map Operator panel shortcuts onto Console workspace routes. */
+export function workspaceForShortcut(action) {
+    if (action === "focus-panel:task" || action === "focus-panel:contract") {
+        return "tasks";
+    }
+    if (action === "focus-panel:dag")
+        return "recovery";
+    return undefined;
+}
 /**
  * Merge Operator, Web, and dynamic Session commands with conflict dedupe.
  * Priority: operator/web > extension > skill > prompt. /reload is single-card.