@tea-agent/loop-agent 0.39.0-next.9 → 0.39.1

package/dist/worker/console/operation-run-facts.js

@@ -13,6 +13,7 @@
  * - A run summary is a projection only: it can never change the terminal
  *   operation state decided by the command envelope/exit facts.
  */
+import { normalizeDagFailureCategory } from "../../shared/dag-failure-category.js";
 import { scrubSecrets } from "./chat/explore-tools.js";
 const RUN_SUMMARY_MAX_NODES = 20;
 const RUN_SUMMARY_MAX_TEXT_CHARS = 600;
@@ -72,7 +73,13 @@ function safeNode(value) {
     const status = boundedRedactedText(rec.status, 100);
     if (!id || !status)
         return undefined;
-    return { id, status };
+    const rawCategory = boundedRedactedText(rec.failureCategory, 200);
+    if (!rawCategory)
+        return { id, status };
+    const category = normalizeDagFailureCategory(rawCategory, status);
+    if (category === "success" || category === "skipped")
+        return { id, status };
+    return { id, status, failureCategory: category };
 }
 /** Independent allowlist projection of a structured run summary. */
 export function safeRunSummaryForProjection(value) {
@@ -117,13 +124,22 @@ export function safeRunSummaryForProjection(value) {
         }
     }
     const verdict = boundedRedactedText(rec.verdict);
-    const failureCategory = boundedRedactedText(rec.failureCategory);
+    const rawFailureCategory = boundedRedactedText(rec.failureCategory, 200);
+    // Normalize the run-level category too (2026-08-23): raw codes like
+    // missing-api-key / nonzero-exit never matched the browser advice table.
+    const failureCategory = rawFailureCategory !== undefined
+        ? normalizeDagFailureCategory(rawFailureCategory, status)
+        : undefined;
     return {
         runId,
         status,
         nodes,
         ...(verdict !== undefined ? { verdict } : {}),
-        ...(failureCategory !== undefined ? { failureCategory } : {}),
+        ...(failureCategory !== undefined &&
+            failureCategory !== "success" &&
+            failureCategory !== "skipped"
+            ? { failureCategory }
+            : {}),
         ...(outOfBounds.length > 0 ? { outOfBounds } : {}),
         ...(next ? { next } : {}),
     };

package/dist/worker/console/operation-store.js

@@ -1,7 +1,7 @@
 import { randomBytes } from "node:crypto";
 import path from "node:path";
 import { listJsonFiles, readJsonIfExists, sha256Json, writeSecureJson, } from "./app-data.js";
-export const TERMINAL_OPERATION_STATES = new Set(["succeeded", "failed", "timed-out"]);
+export const TERMINAL_OPERATION_STATES = new Set(["succeeded", "failed", "timed-out", "restarting"]);
 function operationFile(appData, operationId) {
     return path.join(appData.operations, `${operationId}.json`);
 }

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

@@ -1,5 +1,6 @@
 import { access, readFile } from "node:fs/promises";
-import { buildOperatorCapabilitiesDocument } from "../../shared/operator/capabilities.js";
+import { buildOperatorCapabilitiesDocument, OFFICIAL_TAIL_ACTION_IDS, } from "../../shared/operator/capabilities.js";
+import { DAG_RERUN_PROMPT_OVERRIDE_ENV, isDagRerunPromptOverrideEnabled, MAX_DAG_RERUN_PROMPT_OVERRIDE_CHARS, } from "../../shared/dag-prompt-override.js";
 import { buildOperatorResult, operatorFailed, operatorSucceeded, } from "../../shared/operator/envelope.js";
 import { CANONICAL_TASK_ID_PATTERN, formatLocalBusinessDate, getTaskPaths, loadTaskConfig, } from "../../task/runtime.js";
 import { diffTaskContract, validateDraftForTask, } from "../../task/contract/index.js";
@@ -401,6 +402,85 @@ async function runReadCli(ctx, args, command) {
         });
     }
 }
+/**
+ * Parse and bound the experimental promptOverrides action param. The env
+ * switch is checked separately so disabled deployments fail closed before any
+ * staging happens. `mode` defaults to "replace"; "append" keeps the frozen
+ * base prompt and only appends the operator text as a marked addendum.
+ */
+function parsePromptOverrideParams(raw) {
+    if (raw === undefined || raw === null)
+        return { kind: "ok", overrides: [] };
+    if (!Array.isArray(raw)) {
+        return {
+            kind: "error",
+            message: "promptOverrides must be an array of {nodeId, prompt, mode?}",
+        };
+    }
+    if (raw.length === 0)
+        return { kind: "ok", overrides: [] };
+    if (raw.length > 8) {
+        return { kind: "error", message: "promptOverrides supports at most 8 nodes" };
+    }
+    const overrides = [];
+    const seen = new Set();
+    for (const item of raw) {
+        if (!item || typeof item !== "object") {
+            return {
+                kind: "error",
+                message: "promptOverrides entries must be objects {nodeId, prompt, mode?}",
+            };
+        }
+        const record = item;
+        const nodeId = typeof record.nodeId === "string" ? record.nodeId.trim() : "";
+        const prompt = typeof record.prompt === "string" ? record.prompt : "";
+        const mode = record.mode === undefined || record.mode === null
+            ? undefined
+            : typeof record.mode === "string"
+                ? record.mode
+                : "invalid";
+        if (!nodeId) {
+            return { kind: "error", message: "promptOverrides nodeId is required" };
+        }
+        if (seen.has(nodeId)) {
+            return {
+                kind: "error",
+                message: `promptOverrides contains duplicate nodeId: ${nodeId}`,
+            };
+        }
+        seen.add(nodeId);
+        if (mode !== undefined && mode !== "append" && mode !== "replace") {
+            return {
+                kind: "error",
+                message: `promptOverrides mode for ${nodeId} must be append or replace`,
+            };
+        }
+        if (!prompt.trim() || prompt.length > MAX_DAG_RERUN_PROMPT_OVERRIDE_CHARS) {
+            return {
+                kind: "error",
+                message: `promptOverrides prompt for ${nodeId} must be 1-${MAX_DAG_RERUN_PROMPT_OVERRIDE_CHARS} characters`,
+            };
+        }
+        overrides.push(mode === undefined ? { nodeId, prompt } : { nodeId, prompt, mode });
+    }
+    return { kind: "ok", overrides };
+}
+/** Stage override bodies under app-data and build `--prompt-override` CLI
+ *  args. The flag carries the mode: `--prompt-override-append` for append. */
+async function buildPromptOverrideCliArgs(ctx, overrides) {
+    const args = [];
+    for (const override of overrides) {
+        const staged = await stageUtf8Text(ctx.appData, override.prompt, {
+            extension: ".md",
+            label: `prompt-override-${override.nodeId}`,
+        });
+        const flag = override.mode === "append"
+            ? "--prompt-override-append"
+            : "--prompt-override";
+        args.push(flag, `${override.nodeId}@${staged.path}`);
+    }
+    return args;
+}
 async function acceptOperation(ctx, input) {
     const created = await ctx.operations.create({
         clientRequestId: input.clientRequestId,
@@ -456,6 +536,106 @@ async function acceptOperation(ctx, input) {
         },
     };
 }
+async function acceptConsoleUpdateAndInit(ctx, clientRequestId, channel) {
+    if (!ctx.consoleUpdateExecutor) {
+        return {
+            kind: "error",
+            status: 503,
+            body: operatorFailed({
+                command: "consoleUpdateAndInit",
+                outcome: "blocked",
+                code: "CONSOLE_UPDATE_UNAVAILABLE",
+                message: "Console update runtime is unavailable",
+            }),
+        };
+    }
+    const created = await ctx.operations.create({
+        clientRequestId,
+        action: "consoleUpdateAndInit",
+        actionParams: { channel },
+    });
+    if (created.kind === "conflict") {
+        return {
+            kind: "error",
+            status: 409,
+            body: operatorFailed({
+                command: "consoleUpdateAndInit",
+                outcome: "conflict",
+                code: "REQUEST_ID_REUSE_CONFLICT",
+                message: created.message,
+            }),
+        };
+    }
+    if (created.kind === "idempotent") {
+        return {
+            kind: "accepted",
+            status: 202,
+            body: {
+                operationId: created.operation.operationId,
+                state: created.operation.state,
+                clientRequestId: created.operation.clientRequestId,
+                action: created.operation.action,
+            },
+        };
+    }
+    queueMicrotask(() => {
+        void (async () => {
+            const operationId = created.operation.operationId;
+            await ctx.operations.update(operationId, {
+                state: "running",
+                startedAt: new Date().toISOString(),
+            });
+            ctx.events.append(operationId, {
+                at: new Date().toISOString(),
+                kind: "state",
+                state: "running",
+                message: `checking runtime, npm ${channel}, and safe initialization`,
+            });
+            try {
+                const result = await ctx.consoleUpdateExecutor(channel);
+                const state = result.state;
+                const next = await ctx.operations.update(operationId, {
+                    state,
+                    finishedAt: new Date().toISOString(),
+                    result: result,
+                    ...(result.errorCode ? { errorCode: result.errorCode } : {}),
+                    ...(result.errorMessage ? { errorMessage: result.errorMessage } : {}),
+                });
+                ctx.events.append(operationId, {
+                    at: new Date().toISOString(),
+                    kind: "state",
+                    state: next.state,
+                    message: result.errorMessage ?? `console maintenance ${next.state}`,
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                const next = await ctx.operations.update(operationId, {
+                    state: "needs-reconcile",
+                    finishedAt: new Date().toISOString(),
+                    errorCode: "CONSOLE_UPDATE_EXCEPTION",
+                    errorMessage: message,
+                });
+                ctx.events.append(operationId, {
+                    at: new Date().toISOString(),
+                    kind: "error",
+                    state: next.state,
+                    message,
+                });
+            }
+        })();
+    });
+    return {
+        kind: "accepted",
+        status: 202,
+        body: {
+            operationId: created.operation.operationId,
+            state: created.operation.state,
+            clientRequestId: created.operation.clientRequestId,
+            action: created.operation.action,
+        },
+    };
+}
 export async function dispatchOperatorAction(ctx, req) {
     const action = req.action?.trim();
     if (!action) {
@@ -486,6 +666,31 @@ export async function dispatchOperatorAction(ctx, req) {
         };
     }
     const p = paramsOf(req);
+    if (action === "consoleUpdateAndInit") {
+        if (req.source !== "human-ui") {
+            return {
+                kind: "error",
+                status: 403,
+                body: operatorFailed({
+                    command: action,
+                    outcome: "blocked",
+                    code: "HUMAN_UI_REQUIRED",
+                    message: "consoleUpdateAndInit is available only from the Operate UI",
+                }),
+            };
+        }
+        if (!req.clientRequestId?.trim()) {
+            return invalid(action, "clientRequestId is required");
+        }
+        if (Object.keys(p).some((key) => key !== "channel")) {
+            return invalid(action, "only channel may be provided");
+        }
+        const channel = p.channel ?? "latest";
+        if (channel !== "latest" && channel !== "next") {
+            return invalid(action, "channel must be latest or next");
+        }
+        return acceptConsoleUpdateAndInit(ctx, req.clientRequestId, channel);
+    }
     switch (action) {
         case "operatorCapabilities": {
             const doc = buildOperatorCapabilitiesDocument();
@@ -672,6 +877,80 @@ export async function dispatchOperatorAction(ctx, req) {
             const body = await runReadCli(ctx, ["dag", "report", "--run-id", runId, "--json"], "dag report");
             return { kind: "sync", status: body.ok ? 200 : 400, body };
         }
+        case "dagDoctor": {
+            const runId = str(p.runId) ?? str(p.dagRunId);
+            const args = ["dag", "doctor"];
+            if (runId)
+                args.push("--run-id", runId);
+            const body = await runReadCli(ctx, args, "dag doctor");
+            return { kind: "sync", status: body.ok ? 200 : 400, body };
+        }
+        case "dagStatus": {
+            const runId = str(p.runId) ?? str(p.dagRunId);
+            if (!runId)
+                return invalid(action, "runId is required");
+            const body = await runReadCli(ctx, ["dag", "status", "--run-id", runId], "dag status");
+            return { kind: "sync", status: body.ok ? 200 : 400, body };
+        }
+        case "workerPoolDoctor": {
+            const taskId = str(p.taskId);
+            const run = ctx.runCommand ??
+                ((args, options) => ctx.client.runExternal
+                    ? ctx.client.runExternal(resolveSiblingAgentWorkerBin(), args, options)
+                    : ctx.client.run(args, options));
+            let result;
+            try {
+                result = await run(["pool", "doctor", "--repo", ctx.repoRoot, "--json"], {
+                    cwd: ctx.repoRoot,
+                    artifactName: "read-pool-doctor",
+                    expectJson: true,
+                });
+            }
+            catch (error) {
+                return {
+                    kind: "error",
+                    status: 400,
+                    body: operatorFailed({
+                        command: action,
+                        outcome: "invalid",
+                        code: "INVALID_INPUT",
+                        message: `cannot read pool doctor facts: ${error instanceof Error ? error.message : String(error)}`,
+                    }),
+                };
+            }
+            if (!result.ok || result.exitCode !== 0 || !result.json) {
+                return {
+                    kind: "error",
+                    status: 400,
+                    body: operatorFailed({
+                        command: action,
+                        outcome: "invalid",
+                        code: "INVALID_INPUT",
+                        message: summarizeReadCliFailure(result),
+                    }),
+                };
+            }
+            const inventory = result.json;
+            if (!taskId) {
+                return {
+                    kind: "sync",
+                    status: 200,
+                    body: operatorSucceeded(action, inventory),
+                };
+            }
+            const v2 = (inventory.v2 ?? []).filter((entry) => entry.taskId === taskId);
+            const legacy = (inventory.legacy ?? []).filter((entry) => entry.taskId === taskId);
+            return {
+                kind: "sync",
+                status: 200,
+                body: operatorSucceeded(action, {
+                    ...inventory,
+                    v2,
+                    legacy,
+                    focusedTaskId: taskId,
+                }),
+            };
+        }
         case "status": {
             const taskId = str(p.taskId);
             if (!taskId) {
@@ -986,7 +1265,7 @@ export async function dispatchOperatorAction(ctx, req) {
             }
             if (operatorAction) {
                 const target = buildOperatorCapabilitiesDocument().actions.find((entry) => entry.action === operatorAction &&
-                    entry.description.startsWith("Official CLI action coverage") &&
+                    OFFICIAL_TAIL_ACTION_IDS.has(entry.action) &&
                     entry.humanConfirmation === "required");
                 if (!target)
                     return invalid(action, "operatorAction must name a required official action");
@@ -2004,12 +2283,35 @@ export async function dispatchOperatorAction(ctx, req) {
             }
             return accepted;
         }
+        case "dagPromptOverrideConfig": {
+            // The prompt-edit entry is visible by default. The internal environment
+            // switch remains an emergency kill switch and is reflected here.
+            return {
+                kind: "sync",
+                status: 200,
+                body: operatorSucceeded(action, {
+                    enabled: isDagRerunPromptOverrideEnabled(),
+                    envVar: DAG_RERUN_PROMPT_OVERRIDE_ENV,
+                }),
+            };
+        }
         case "dagRerunPlan": {
             const runId = str(p.runId);
             const fromNode = str(p.fromNode);
             if (!runId || !fromNode) {
                 return invalid(action, "runId and fromNode are required");
             }
+            const parsedOverrides = parsePromptOverrideParams(p.promptOverrides);
+            if (parsedOverrides.kind === "error") {
+                return invalid(action, parsedOverrides.message);
+            }
+            if (parsedOverrides.overrides.length > 0 &&
+                !isDagRerunPromptOverrideEnabled()) {
+                return invalid(action, `prompt override rerun is disabled by ${DAG_RERUN_PROMPT_OVERRIDE_ENV}; unset it or use a value other than 0, false, or off to enable this experimental capability`);
+            }
+            const overrideArgs = parsedOverrides.overrides.length > 0
+                ? await buildPromptOverrideCliArgs(ctx, parsedOverrides.overrides)
+                : [];
             const body = await runReadCli(ctx, [
                 "dag",
                 "rerun",
@@ -2018,6 +2320,7 @@ export async function dispatchOperatorAction(ctx, req) {
                 "--from-node",
                 fromNode,
                 "--plan",
+                ...overrideArgs,
                 "--json",
             ], "dag rerun plan");
             return { kind: "sync", status: body.ok ? 200 : 400, body };
@@ -2031,6 +2334,17 @@ export async function dispatchOperatorAction(ctx, req) {
             if (!runId || !fromNode || !planHash || !reason || !clientRequestId) {
                 return invalid(action, "runId, fromNode, planHash, reason, and clientRequestId are required");
             }
+            const parsedOverrides = parsePromptOverrideParams(p.promptOverrides);
+            if (parsedOverrides.kind === "error") {
+                return invalid(action, parsedOverrides.message);
+            }
+            if (parsedOverrides.overrides.length > 0 &&
+                !isDagRerunPromptOverrideEnabled()) {
+                return invalid(action, `prompt override rerun is disabled by ${DAG_RERUN_PROMPT_OVERRIDE_ENV}; unset it or use a value other than 0, false, or off to enable this experimental capability`);
+            }
+            const overrideArgs = parsedOverrides.overrides.length > 0
+                ? await buildPromptOverrideCliArgs(ctx, parsedOverrides.overrides)
+                : [];
             return acceptOperation(ctx, {
                 action,
                 actionParams: p,
@@ -2048,6 +2362,7 @@ export async function dispatchOperatorAction(ctx, req) {
                     clientRequestId,
                     "--reason",
                     reason,
+                    ...overrideArgs,
                     "--json",
                 ],
             });
@@ -2536,8 +2851,9 @@ export async function dispatchOperatorAction(ctx, req) {
             // M5 official-command coverage uses one generic tail for newly registered
             // CLI actions. It remains inside dispatchOperatorAction (the sole dispatch
             // surface) and only accepts argv arrays declared by the capability schema.
-            const capability = buildOperatorCapabilitiesDocument().actions.find((entry) => entry.action === action &&
-                entry.description.startsWith("Official CLI action coverage"));
+            // 2026-08-18: high-frequency entries got real descriptions; membership is
+            // now derived from OFFICIAL_TAIL_ACTION_IDS, not description prefixes.
+            const capability = buildOperatorCapabilitiesDocument().actions.find((entry) => entry.action === action && OFFICIAL_TAIL_ACTION_IDS.has(entry.action));
             if (capability) {
                 const rawArgs = p.args;
                 if (rawArgs !== undefined &&

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

@@ -12,6 +12,7 @@ export function buildOperatorSurfaceHealthV1(input) {
         repoName: input.repoRoot.split(/[\\/]/).filter(Boolean).pop() ?? "repository",
         packageName,
         packageVersion,
+        consoleInstanceId: input.consoleInstanceId,
         piReadiness: input.piReadiness,
         inspect: {
             ready: input.inspectReady,

package/dist/worker/console/operator-user-error.js

@@ -3,7 +3,7 @@ import { rewriteRecoveryOperatorError } from "./recovery-error-copy.js";
 const MUTATION_GATE_COPY = [
     {
         pattern: /invalid (boot capability|confirmation header) token/i,
-        copy: "页面已过期（控制台已重启），请刷新页面（F5）后重试。",
+        copy: "页面凭证已失效（控制台可能已重启），请刷新页面（F5）后重试。",
     },
     {
         pattern: /mutation requires boot capability cookie|mutation requires confirmation header token/i,
@@ -23,7 +23,7 @@ export function formatOperatorUserError(message) {
     if (recovery)
         return recovery;
     if (/controller identity changed|package fingerprint changed|entry binary sha256 changed/i.test(raw)) {
-        return "控制器版本已变更（Console 启动后代码被重新编译）。请重启 Console 后再试，一次会话中途不要升级/重建控制器。";
+        return "控制器版本已变更（Console 启动后代码被重新编译，或提交了 package.json / bin / dist / skills 等指纹范围文件）。请重启 Console 进程使其重新加载当前构建后再重试本操作；一次会话中途不要重建控制器。";
     }
     if (/Pi session file missing or not openable|cannot reopen chat session .* no persisted Pi session file/i.test(raw)) {
         return "该对话的 Pi 会话文件已丢失，无法恢复上下文。请新建对话继续（历史记录无法重开）。";

package/dist/worker/console/pi-readiness.js

@@ -85,7 +85,7 @@ function hasProviderConfig(snapshot) {
 /**
  * Discover live Pi SDK / auth / model readiness via ModelRuntime.
  * Kept inside worker/console (dynamic import) so Worker does not depend on
- * executors; contract matches pi-sdk-executor 0.80.10.
+ * executors; contract matches pi-sdk-executor 0.83.0.
  */
 export async function discoverPiReadinessProbe(options) {
     const repoRoot = options?.repoRoot ?? process.cwd();
@@ -118,7 +118,7 @@ export async function discoverPiReadinessProbe(options) {
             modelsAvailable: false,
             interviewSessionOk: false,
             details: {
-                sdkMessage: "Pi SDK incompatible: requires createAgentSession, getAgentDir, and ModelRuntime.create (0.80.10)",
+                sdkMessage: "Pi SDK incompatible: requires createAgentSession, getAgentDir, and ModelRuntime.create (0.83.0)",
                 authMessage: "skipped (sdk incompatible)",
                 modelsMessage: "skipped (sdk incompatible)",
                 sessionMessage: "skipped (sdk incompatible)",
@@ -159,7 +159,7 @@ export async function discoverPiReadinessProbe(options) {
             modelsAvailable: false,
             interviewSessionOk: false,
             details: {
-                sdkMessage: "Pi SDK 0.80.10 contract available",
+                sdkMessage: "Pi SDK 0.83.0 contract available",
                 authMessage: `ModelRuntime.create failed: ${message}`,
                 modelsMessage: "skipped (runtime init failed)",
                 sessionMessage: "skipped (runtime init failed)",
@@ -222,8 +222,9 @@ export async function discoverPiReadinessProbe(options) {
         authReady,
         modelsAvailable,
         interviewSessionOk,
+        piAvailableModels: availableModels,
         details: {
-            sdkMessage: `Pi SDK 0.80.10 contract available (agentDir=${agentDir})`,
+            sdkMessage: `Pi SDK 0.83.0 contract available (agentDir=${agentDir})`,
             authMessage: authReady
                 ? `credentials/providers ready (available=${availableCount}, providerConfig=${providerConfigured})`
                 : "no available models and no stored/configured provider credentials (set Pi auth or provider API keys)",

package/dist/worker/console/prd-intake-bridge.js

@@ -9,6 +9,7 @@ import { getTaskPaths } from "../../task/runtime.js";
 import { SEMANTIC_INTAKE_ARTIFACT_REL, } from "../../task/source-prepare/semantic-intake.js";
 import { extractRequirementFactsFromMarkdown } from "../../task/source-prepare/parse-intent.js";
 import { filterPlaceholderPaths, isNonPlaceholderPath, } from "../../task/source-prepare/placeholder-paths.js";
+import { summarizeLedgerPayload, } from "./draft-store.js";
 import { emptyDraft } from "./interview/grill-me.js";
 import { normalizeConsoleWorkflowKind } from "./workflow-kinds.js";
 function asStringList(value) {
@@ -219,6 +220,15 @@ export async function buildDraftFromTaskIntake(input) {
     const paths = getTaskPaths(input.repoRoot, input.taskId);
     const warnings = warningList(input.advanceJson);
     const lifecycleState = lifecycleFromAdvanceJson(input.advanceJson);
+    // Source fidelity ledger 安全摘要透传（AC-009）：来自 advance/prepare 结果，
+    // 未知形状安全丢弃，绝不携带未截断原文。
+    const advanceRoot = input.advanceJson && typeof input.advanceJson === "object"
+        ? input.advanceJson
+        : {};
+    const ledgerSummary = summarizeLedgerPayload(advanceRoot.ledgerSummary) ??
+        summarizeLedgerPayload(advanceRoot.result && typeof advanceRoot.result === "object"
+            ? advanceRoot.result.ledgerSummary
+            : undefined);
     const semanticApplied = warnings.some((w) => w.code === "SEMANTIC_INTAKE_APPLIED");
     const semanticFailed = warnings.find((w) => w.code === "SEMANTIC_INTAKE_PI_FAILED" ||
         w.code === "SEMANTIC_INTAKE_INVALID_OUTPUT" ||
@@ -427,11 +437,14 @@ export async function buildDraftFromTaskIntake(input) {
     if (input.engineering) {
         draft = applyEngineeringBoundaryToDraft(draft, input.engineering);
     }
+    // AC-BLOCK-002：摘要仅经响应返回 UI 视图模型，不写入 draft（防止 strict
+    // taskContractDraftSchema 因未知 ledgerSummary 键拒绝 canonical draft）。
     return {
         draft,
         parseStatus,
         semanticIntake,
         gaps,
+        ...(ledgerSummary ? { ledgerSummary } : {}),
         lifecycleState,
     };
 }

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

@@ -59,20 +59,20 @@ const CTA = {
     },
     dagRerun: {
         id: "dagRerun",
-        label: "从节点重跑",
+        label: "从失败节点恢复",
         requiresReason: true,
         action: "dagRerun",
         lane: "dag",
-        guide: "终端失败默认首选：先 dagRerunPlan，plan 合格后直接执行（无需 Human Gate）。Worker 持有的 run、workspace/controller 漂移或含 unsafe shell 时不要强跑子图",
+        guide: "Provider、网络、限流或超时等非代码问题的首选：先评估安全子图，合格后创建 continuation run 从有效节点恢复（无需 Human Gate）。Worker 持有的 run、workspace/controller 漂移或含 unsafe shell 时不要强跑子图",
         commandHint: "loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan",
     },
     standaloneTaskRerun: {
         id: "standaloneTaskRerun",
-        label: "完整重跑任务",
+        label: "带反馈重新执行任务",
         requiresReason: true,
         action: "standaloneTaskRerun",
         lane: "dag",
-        guide: "独立 DAG run 整单重跑：仅当 from-node plan 不合格时直调执行，服务端校验 run facts，无需 Human Gate。Worker 持有的 run 请用下方「重新排队 Worker Task」",
+        guide: "独立 DAG run 无法安全从节点恢复时，重新生成完整 DAG，并带入上一轮仍未解决的 verify/review 反馈；没有可继承反馈时会明确说明（无需 Human Gate）。Worker 持有的 run 请用下方「重新排队 Worker Task」",
         commandHint: "loop-agent dag rerun-task --run-id <run-id> --reason <text> --json",
     },
     workerTaskRetry: {

package/dist/worker/console/recovery-error-copy.js

@@ -107,7 +107,7 @@ export function nextActionForIneligibleRerun(reasons) {
             "worker-managed-rerun-unsupported")) {
         return "下一步：请点下方「重新排队 Worker Task」，从头完整执行。";
     }
-    return "下一步：请改用「完整重跑任务」，从头完整执行。";
+    return "下一步：请改用「带反馈重新执行任务」，重新生成完整 DAG。";
 }
 export function formatIneligibleRerunMessage(input) {
     const fallback = input.fallbackMessage?.trim();
@@ -141,16 +141,16 @@ export function rewriteRecoveryOperatorError(raw) {
         return formatIneligibleRerunMessage({ fallbackMessage: text });
     }
     if (/action must be a mutation-gate target/i.test(text)) {
-        return "这个操作不能再走确认门。Worker 启动的任务请直接点「重新排队 Worker Task」；独立运行请点「完整重跑任务」。";
+        return "这个操作不能再走确认门。Worker 启动的任务请直接点「重新排队 Worker Task」；独立运行请点「带反馈重新执行任务」。";
     }
     if (/cannot read dagReport run facts/i.test(text)) {
         return "读不到这次运行的失败报告，不能完整重跑。请先点「查看报告」或「Doctor 诊断」。";
     }
     if (/dagRerunPlan run facts unavailable/i.test(text)) {
-        return "读不到从节点续跑的资格结果，不能改走完整重跑。请先点「从节点重跑」查看资格，或先「查看报告」。";
+        return "读不到节点恢复资格，不能直接改走完整重跑。请先点「从失败节点恢复」查看资格，或先「查看报告」。";
     }
     if (/node rerun plan is eligible/i.test(text)) {
-        return "从节点续跑是安全的，请改用「从节点重跑」，不必完整重跑整单。";
+        return "节点恢复是安全的，请改用「从失败节点恢复」，不必重新执行完整任务。";
     }
     if (/does not support autonomous standaloneTaskRerun/i.test(text)) {
         return "当前失败不适合自动完整重跑。请先点「查看报告」，按建议操作。";