@tea-agent/loop-agent 0.35.2 → 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,29 @@
 
 ## [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
 
 ### 重点更新
@@ -51,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

@@ -64,6 +64,17 @@ export function extractAssistantContentBlocks(message) {
     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.

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

@@ -28,7 +28,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { access } from "node:fs/promises";
 import path from "node:path";
-import { extractAssistantContentBlocks, extractAssistantText, } from "./assistant-content.js";
+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";
@@ -564,7 +564,7 @@ export function projectRuntimeSnapshot(input) {
         hasBash: input.hasBash,
     };
 }
-export { extractAssistantContentBlocks, extractAssistantText };
+export { extractAssistantContentBlocks, extractAssistantText, isAssistantSdkMessage };
 function readSessionManagerId(manager) {
     if (!manager || typeof manager !== "object")
         return undefined;
@@ -2116,8 +2116,12 @@ function mapSdkEvent(sessionId, event) {
                 willRetry: Boolean(event.willRetry),
             };
         case "message_update":
+            if (!isAssistantSdkMessage(event.message))
+                return undefined;
             return mapAssistantMessageEvent("message_update", sessionId, event.message);
         case "message_end":
+            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

package/dist/worker/console/chat/turn-process.js

@@ -1,7 +1,7 @@
 /**
  * Turn grouping for Operator Chat inline process UX (pi-web ProcessDetails mind).
  */
-import { joinAssistantText, parseAssistantContent, splitFinalAssistantBlocks, } from "./assistant-content.js";
+import { getDisplayableAssistantBlocks, joinAssistantText, parseAssistantContent, splitFinalAssistantBlocks, } from "./assistant-content.js";
 function emptyGroup(key) {
     return {
         key,
@@ -76,19 +76,15 @@ export function hydrateSessionThread(raw) {
     }
     return { messages, toolCalls };
 }
-function fillProcessDetails(group) {
-    const finalAssistant = group.assistants[group.assistants.length - 1];
-    const blocks = finalAssistant?.content ?? [];
-    const split = splitFinalAssistantBlocks(blocks, { isStreaming: group.live });
-    const usedToolIds = new Set();
-    const processItems = [];
-    for (const block of split.processBlocks) {
+function emitProcessBlocks(blocks, group, processItems, usedToolIds) {
+    for (const block of blocks) {
         if (block.type === "thinking") {
             processItems.push({ kind: "thinking", thinking: block.thinking });
             continue;
         }
         if (block.type === "text") {
-            processItems.push({ kind: "text", text: block.text });
+            if (block.text.trim())
+                processItems.push({ kind: "text", text: block.text });
             continue;
         }
         const tool = group.tools.find((entry) => entry.id === block.toolCallId);
@@ -97,6 +93,18 @@ function fillProcessDetails(group) {
             usedToolIds.add(tool.id);
         }
     }
+}
+function fillProcessDetails(group) {
+    const usedToolIds = new Set();
+    const processItems = [];
+    const prior = group.assistants.slice(0, -1);
+    const finalAssistant = group.assistants[group.assistants.length - 1];
+    for (const assistant of prior) {
+        emitProcessBlocks(getDisplayableAssistantBlocks(assistant.content ?? []), group, processItems, usedToolIds);
+    }
+    const blocks = finalAssistant?.content ?? [];
+    const split = splitFinalAssistantBlocks(blocks, { isStreaming: group.live });
+    emitProcessBlocks(split.processBlocks, group, processItems, usedToolIds);
     for (const tool of group.tools) {
         if (!usedToolIds.has(tool.id))
             processItems.push({ kind: "tool", tool });

package/dist/worker/console/chat/workspace-landing.js

@@ -78,7 +78,7 @@ export function resolveDefaultLanding(input) {
     return (workspaceFromLocation(input.location) ??
         configuredLanding(input.storage?.getItem(DEFAULT_LANDING_STORAGE_KEY)) ??
         configuredLanding(input.env) ??
-        "tasks");
+        "chat");
 }
 /** Hash path segment for Console virtual routing (no leading `#`). */
 export function buildConsoleHashPath(workspace, params = {}) {