@tea-agent/loop-agent 0.9.0 → 0.10.0-alpha.0

package/dist/worker/observe/static/index.html

@@ -35,7 +35,9 @@
           <h2>运行总览</h2>
           <p>聚焦正在推进的 DAG、需要处理的风险与近期运行记录。</p>
         </div>
-        <section id="dashboard-kpi" class="kpi-grid panel panel-kpi" aria-label="运行摘要"></section>
+        <div id="dashboard-repo" class="repo-banner" aria-label="当前仓库"></div>
+        <section id="dashboard-features" class="panel panel-features" aria-label="Feature 决策"></section>
+        <section id="dashboard-kpi" class="panel panel-kpi" aria-label="运行摘要"></section>
         <div class="dashboard-workspace">
           <section id="dashboard-active-dags" class="panel panel-primary"></section>
           <aside id="dashboard-risk" class="panel panel-risk" aria-label="运行风险"></aside>

package/dist/worker/observe/static/styles.css

@@ -238,12 +238,22 @@ td:first-child,
 
 .view-dashboard { display: grid; gap: var(--space-4); }
 
+.repo-banner { display: flex; align-items: center; gap: var(--space-3); padding: 10px 14px; border: 1px solid var(--hairline-strong); border-radius: var(--radius-lg); background: var(--surface); }
+.repo-banner > i { color: var(--muted); font-size: 18px; }
+.repo-banner-text { display: grid; gap: 2px; min-width: 0; }
+.repo-banner-name { color: var(--ink); font-size: 14px; font-weight: 700; overflow-wrap: anywhere; }
+.repo-banner-path { color: var(--muted); font-size: 11px; overflow-wrap: anywhere; }
+
 .panel-kpi { padding: 0; background: transparent; border: 0; }
 
+.kpi-group { margin: 0; padding: 0; border: 0; display: grid; gap: var(--space-3); }
+.kpi-group + .kpi-group { margin-top: var(--space-3); }
+.kpi-group-legend { padding: 0; color: var(--muted); font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; }
+
 .kpi-grid {
   display: grid;
   grid-template-columns: repeat(6, minmax(0, 1fr));
-  overflow: hidden;
+  overflow: visible;
   border: 1px solid var(--hairline-strong);
   border-radius: var(--radius-lg);
   background: var(--surface);
@@ -259,8 +269,15 @@ td:first-child,
 
 .kpi-card:first-child { border-left: 0; }
 .kpi-label { margin-bottom: 9px; color: var(--muted); font-size: 11px; font-weight: 650; }
+.kpi-value-row { display: flex; align-items: baseline; gap: 6px; }
 .kpi-value { color: var(--ink); font-size: 26px; font-weight: 500; line-height: 1; font-variant-numeric: tabular-nums; }
 
+.kpi-help { display: inline-flex; align-items: center; justify-content: center; width: 16px; height: 16px; padding: 0; border: 0; border-radius: 50%; background: transparent; color: var(--muted-soft); cursor: help; font-size: 13px; line-height: 1; }
+.kpi-help:hover, .kpi-help:focus-visible { color: var(--ink); background: var(--surface-muted); outline: none; }
+.kpi-help:focus-visible { box-shadow: 0 0 0 2px var(--hairline-strong); }
+.kpi-tip { position: absolute; left: 12px; right: 12px; top: calc(100% - 8px); z-index: 10; max-width: 280px; padding: 8px 10px; border: 1px solid var(--hairline-strong); border-radius: var(--radius-md); background: var(--surface-ink); color: var(--canvas); font-size: 11px; font-weight: 400; line-height: 1.5; box-shadow: var(--shadow-panel); opacity: 0; visibility: hidden; pointer-events: none; transition: opacity var(--transition-fast); }
+.kpi-help:hover + .kpi-tip, .kpi-help:focus-visible + .kpi-tip { opacity: 1; visibility: visible; }
+
 .dashboard-workspace,
 .dashboard-secondary {
   display: grid;
@@ -272,19 +289,29 @@ td:first-child,
 .dashboard-secondary { grid-template-columns: repeat(2, minmax(0, 1fr)); }
 
 .panel-risk {
-  display: grid;
-  grid-template-columns: minmax(130px, .28fr) minmax(0, 1fr) auto;
-  align-items: center;
-  gap: var(--space-4);
+  display: block;
   background: var(--canvas-soft);
 }
 
 .panel-risk-attention { border-color: color-mix(in srgb, var(--red) 50%, var(--hairline)); background: #fff8f9; }
-.panel-risk .section-heading { margin: 0; }
-.risk-total { margin: 0; color: var(--amber); font-size: 38px; font-weight: 500; line-height: 1; font-variant-numeric: tabular-nums; }
+.panel-risk .section-heading { margin: 0 0 var(--space-3); }
+.risk-blocks { display: grid; gap: var(--space-4); }
+.risk-block { display: grid; grid-template-columns: minmax(120px, .25fr) minmax(0, 1fr); align-items: start; gap: var(--space-3); padding-top: var(--space-3); border-top: 1px solid var(--hairline); }
+.risk-block:first-child { padding-top: 0; border-top: 0; }
+.risk-block-label { color: var(--muted); font-size: 11px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; }
+.risk-block-dag .risk-block-label { color: var(--ink); }
+.risk-block-worker .risk-block-label { color: var(--ink); }
+.risk-total { margin: 0; color: var(--amber); font-size: 32px; font-weight: 500; line-height: 1; font-variant-numeric: tabular-nums; }
 .panel-risk-attention .risk-total { color: var(--red); }
 .risk-summary { margin: 0; color: var(--body); font-size: 12px; line-height: 1.6; }
-.panel-risk .risk-empty { grid-column: 2 / -1; }
+.panel-risk .risk-empty { margin: 0; }
+
+.projection-fault { display: flex; align-items: flex-start; gap: var(--space-3); padding: 14px 16px; border: 1px solid color-mix(in srgb, var(--red) 50%, var(--hairline)); border-radius: var(--radius-lg); background: #fff8f9; }
+.projection-fault > i { color: var(--red); font-size: 20px; line-height: 1.4; }
+.projection-fault-body { display: grid; gap: 4px; min-width: 0; }
+.projection-fault-title { margin: 0; color: var(--ink); font-size: 14px; font-weight: 700; }
+.projection-fault-message { margin: 0; color: var(--body); font-size: 12px; overflow-wrap: anywhere; }
+.projection-fault-at { margin: 0; color: var(--muted); font-size: 11px; }
 
 .risk-link,
 .active-dag-link,
@@ -383,7 +410,7 @@ tr.clickable:focus-within { outline: 2px solid var(--orange); outline-offset: -2
   bottom: 24px;
   display: grid;
   grid-template-rows: auto minmax(0, 1fr);
-  width: min(440px, calc(100vw - 48px));
+  width: min(var(--dag-inspector-width, 440px), calc(100vw - 48px));
   min-width: 0;
   padding: 0;
   overflow: hidden;
@@ -393,9 +420,37 @@ tr.clickable:focus-within { outline: 2px solid var(--orange); outline-offset: -2
   pointer-events: none;
   transform: translateX(calc(100% + 24px));
   visibility: hidden;
-  transition: transform var(--transition-base), opacity var(--transition-base);
+  transition: transform var(--transition-base), opacity var(--transition-base), visibility 0s linear 240ms;
+}
+.dag-inspector.is-open { opacity: 1; pointer-events: auto; transform: translateX(0); visibility: visible; transition-delay: 0s, 0s, 0s; }
+.dag-inspector-resize-handle {
+  position: absolute;
+  z-index: 1;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  width: 18px;
+  cursor: col-resize;
+  touch-action: none;
+  outline: none;
+}
+.dag-inspector-resize-handle::before {
+  content: "";
+  position: absolute;
+  top: 50%;
+  left: 7px;
+  width: 3px;
+  height: 52px;
+  transform: translateY(-50%);
+  border-radius: 2px;
+  background: var(--hairline-strong);
+  opacity: 0;
+  transition: opacity var(--transition-base), background var(--transition-base);
 }
-.dag-inspector.is-open { opacity: 1; pointer-events: auto; transform: translateX(0); visibility: visible; }
+.dag-inspector-resize-handle:hover::before,
+.dag-inspector-resize-handle:focus-visible::before { background: var(--orange); opacity: 1; }
+.dag-inspector-resize-handle:focus-visible { outline: 2px solid var(--orange); outline-offset: -2px; }
+body.is-resizing-dag-inspector { cursor: col-resize; user-select: none; }
 .dag-inspector-header { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: var(--space-3); align-items: start; padding: var(--space-4) var(--space-4) var(--space-3); border-bottom: 1px solid var(--hairline); background: var(--canvas-soft); }
 .dag-inspector-title { display: grid; gap: 6px; min-width: 0; }
 .dag-inspector-title h3 { margin: 0; font-size: 14px; }
@@ -489,11 +544,23 @@ tr.clickable:focus-within { outline: 2px solid var(--orange); outline-offset: -2
 .rank-node-id { color: var(--ink); font-size: 11px; }
 .rank-node-dur { color: var(--muted); font-size: 11px; }
 
-.process-timeline { position: relative; display: grid; gap: 0; margin: 0; padding: var(--space-2) 0 0; list-style: none; }
-.process-timeline-item { position: relative; display: grid; grid-template-columns: 100px minmax(0, 1fr); gap: var(--space-3); padding: 10px 0 10px 13px; border-left: 1px solid var(--hairline-strong); }
-.process-timeline-item::before { position: absolute; width: 7px; height: 7px; margin-left: -17px; border: 2px solid var(--surface); border-radius: 50%; background: var(--lavender); content: ""; }
-.process-timeline-time { color: var(--muted); font-size: 10px; }
-.process-timeline-label { color: var(--body); font-size: 12px; overflow-wrap: anywhere; }
+.process-timeline-note { margin: 0 0 var(--space-2); color: var(--muted); font-size: 11px; }
+.process-timeline { display: grid; gap: 0; margin: 0; padding: var(--space-2) 0; list-style: none; }
+.process-timeline-item { display: grid; grid-template-columns: 20px minmax(0, 1fr); align-items: stretch; min-height: 34px; }
+.process-timeline-item.has-time { grid-template-columns: 20px 92px minmax(0, 1fr); }
+.process-timeline-rail { position: relative; display: grid; place-items: center; min-height: 34px; }
+.process-timeline-rail::before { position: absolute; top: 0; bottom: 0; width: 1px; background: var(--hairline-strong); content: ""; }
+.process-timeline-item.is-first .process-timeline-rail::before { top: 50%; }
+.process-timeline-item.is-last .process-timeline-rail::before { bottom: 50%; }
+.process-timeline-dot { position: relative; z-index: 1; width: 8px; height: 8px; border: 2px solid var(--surface); border-radius: 50%; background: var(--muted-soft); }
+.process-timeline-lifecycle .process-timeline-dot { background: var(--lavender); }
+.process-timeline-tool-start .process-timeline-dot { background: var(--orange); }
+.process-timeline-tool-end .process-timeline-dot { background: var(--green); }
+.process-timeline-assistant .process-timeline-dot { background: var(--blue); }
+.process-timeline-protocol .process-timeline-dot { background: var(--muted-soft); }
+.process-timeline-time { padding: 9px 0; color: var(--muted); font-size: 10px; font-variant-numeric: tabular-nums; }
+.process-timeline-label { min-width: 0; padding: 8px 0 8px var(--space-2); color: var(--body); font-size: 12px; line-height: 1.5; overflow-wrap: anywhere; }
+.process-timeline-protocol .process-timeline-label { color: var(--muted); font-size: 11px; }
 
 .markdown-output { display: grid; gap: var(--space-3); color: var(--body); font-size: 13px; line-height: 1.65; }
 .markdown-output > :first-child { margin-top: 0; }
@@ -579,9 +646,9 @@ tr.clickable:focus-within { outline: 2px solid var(--orange); outline-offset: -2
   .kpi-card:nth-child(1), .kpi-card:nth-child(2) { border-top: 0; }
   .kpi-card:nth-child(odd) { border-left: 0; }
   .dag-inspector { top: 76px; right: 12px; bottom: 12px; width: calc(100vw - 24px); }
+  .dag-inspector-resize-handle { display: none; }
   .dashboard-secondary { grid-template-columns: 1fr; }
-  .panel-risk { grid-template-columns: 1fr; gap: var(--space-2); }
-  .panel-risk .risk-empty { grid-column: auto; }
+  .risk-block { grid-template-columns: 1fr; gap: var(--space-2); }
   .panel { padding: var(--space-4); }
   .panel-table { overflow-x: auto; padding: 0; }
   table { min-width: 680px; }

package/dist/worker/pool/run-store.js

@@ -1,4 +1,5 @@
-import { appendFile, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile, readdir, rename, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
 export const TASK_POOL_RELATIVE_ROOT = ".harness/task-pool";
 export function getTaskPoolRoot(repoRoot) {
@@ -19,6 +20,10 @@ export async function recordTaskPoolRun(input) {
     await writeTaskPoolState(input.repoRoot, stateFromRun(input.run));
     await appendJsonlFile(getEventsJsonlPath(input.repoRoot), eventFromRun(input.run));
 }
+export async function appendTaskPoolEvent(repoRoot, event) {
+    await ensurePoolDirs(repoRoot);
+    await appendJsonlFile(getEventsJsonlPath(repoRoot), event);
+}
 export async function findRunByWorkerRunId(repoRoot, workerRunId) {
     const runs = await readJsonlFile(getRunsJsonlPath(repoRoot));
     return runs.find((run) => run.workerRunId === workerRunId);
@@ -99,7 +104,14 @@ export async function readAllTaskPoolStates(repoRoot) {
 export async function writeTaskPoolState(repoRoot, state) {
     const statePath = getTaskStatePath(repoRoot, state.taskId);
     await mkdir(path.dirname(statePath), { recursive: true });
-    await writeFile(statePath, `${JSON.stringify({ schemaVersion: 1, ...state }, null, 2)}\n`, "utf-8");
+    const tempPath = path.join(path.dirname(statePath), `.${path.basename(statePath)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(tempPath, `${JSON.stringify({ schemaVersion: 1, ...state }, null, 2)}\n`, "utf-8");
+        await rename(tempPath, statePath);
+    }
+    finally {
+        await unlink(tempPath).catch(() => { });
+    }
 }
 export async function readJsonlFile(filePath) {
     try {

package/dist/worker/pool/validation.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { getRunsJsonlPath, getTaskPoolRoot } from "./run-store.js";
+export const taskPoolRunFactSchema = z.object({
+    schemaVersion: z.literal(1), batchRunId: z.string().min(1), workerRunId: z.string().min(1), taskId: z.string().min(1), featureId: z.string().min(1),
+    status: z.enum(["succeeded", "failed", "run-error"]), recordedAt: z.string().datetime(),
+}).passthrough();
+export const taskPoolStateFactSchema = z.object({
+    taskId: z.string().min(1), status: z.enum(["Draft", "Ready", "Queued", "Running", "AgentCompleted", "VerificationRunning", "HumanReview", "Done", "Failed", "Blocked", "Abandoned"]), updatedAt: z.string().datetime(),
+}).passthrough();
+export async function readValidTaskPoolRuns(repoRoot) {
+    const records = [];
+    const warnings = [];
+    try {
+        const raw = await readFile(getRunsJsonlPath(repoRoot), "utf-8");
+        for (const [index, line] of raw.split(/\r?\n/).filter(Boolean).entries())
+            try {
+                const parsed = taskPoolRunFactSchema.safeParse(JSON.parse(line));
+                if (parsed.success)
+                    records.push(parsed.data);
+                else
+                    warnings.push(`Task Pool runs.jsonl line ${index + 1} is semantically invalid`);
+            }
+            catch {
+                warnings.push(`Task Pool runs.jsonl line ${index + 1} is corrupt`);
+            }
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            warnings.push("Task Pool runs.jsonl is unreadable");
+    }
+    return { records, warnings };
+}
+export async function readValidTaskPoolStates(repoRoot) {
+    const records = {};
+    const warnings = [];
+    const stateDir = path.join(getTaskPoolRoot(repoRoot), "states");
+    try {
+        for (const entry of await readdir(stateDir))
+            if (entry.endsWith(".json"))
+                try {
+                    const parsed = taskPoolStateFactSchema.safeParse(JSON.parse(await readFile(path.join(stateDir, entry), "utf-8")));
+                    if (parsed.success && parsed.data.taskId === entry.slice(0, -5))
+                        records[parsed.data.taskId] = parsed.data;
+                    else
+                        warnings.push(`Task Pool state is semantically invalid: ${entry}`);
+                }
+                catch {
+                    warnings.push(`Task Pool state is corrupt: ${entry}`);
+                }
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            warnings.push("Task Pool states are unreadable");
+    }
+    return { records, warnings };
+}
+function isNotFound(error) { return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT"); }

package/dist/worker/preflight.js

@@ -1,14 +1,27 @@
 import { access } from "node:fs/promises";
 import path from "node:path";
+import { controllerIdentityExpectationFailure, resolveControllerIdentity, } from "./loop-agent/loop-agent-client.js";
 export const DEFAULT_CHECK_REPO_TIMEOUT_MS = 300_000;
 export async function preflightTargetRepo(input) {
     const commands = [];
+    const identity = resolveControllerIdentity(input.client);
+    const expectationFailure = controllerIdentityExpectationFailure(identity, input.expectation);
+    if (expectationFailure) {
+        return {
+            ok: false,
+            code: expectationFailure.code,
+            message: expectationFailure.message,
+            commands,
+            controllerIdentity: identity,
+        };
+    }
     if (!(await exists(path.join(input.repoRoot, "harness.json")))) {
         return {
             ok: false,
             code: "target-not-initialized",
             message: "target repo is missing harness.json",
             commands,
+            controllerIdentity: identity,
         };
     }
     if (!(await exists(path.join(input.repoRoot, ".harness")))) {
@@ -17,6 +30,7 @@ export async function preflightTargetRepo(input) {
             code: "target-not-initialized",
             message: "target repo is missing .harness",
             commands,
+            controllerIdentity: identity,
         };
     }
     const version = await input.client.run(["--version"], {
@@ -30,8 +44,36 @@ export async function preflightTargetRepo(input) {
             code: "version-failed",
             message: "loop-agent --version failed",
             commands,
+            controllerIdentity: identity,
         };
     }
+    const reportedVersion = version.stdout.trim();
+    let controllerIdentity = identity
+        ? { ...identity, reportedVersion }
+        : undefined;
+    if (identity && reportedVersion !== identity.packageVersion) {
+        return {
+            ok: false,
+            code: "reported-version-mismatch",
+            message: `reported version ${reportedVersion} does not match package version ${identity.packageVersion}`,
+            commands,
+            controllerIdentity,
+        };
+    }
+    if (identity && input.client.observeReportedVersion) {
+        try {
+            controllerIdentity = input.client.observeReportedVersion(reportedVersion) ?? controllerIdentity;
+        }
+        catch (error) {
+            return {
+                ok: false,
+                code: "reported-version-mismatch",
+                message: error instanceof Error ? error.message : String(error),
+                commands,
+                controllerIdentity,
+            };
+        }
+    }
     const inspect = await input.client.run(["inspect"], {
         cwd: input.repoRoot,
         artifactName: "inspect",
@@ -44,6 +86,7 @@ export async function preflightTargetRepo(input) {
             code: "inspect-failed",
             message: "loop-agent inspect failed or did not return JSON",
             commands,
+            controllerIdentity,
         };
     }
     const docsAudit = await input.client.run(["docs", "audit"], {
@@ -57,6 +100,7 @@ export async function preflightTargetRepo(input) {
             code: "docs-audit-failed",
             message: "loop-agent docs audit failed",
             commands,
+            controllerIdentity,
         };
     }
     const gitStatus = await input.client.runExternal("git", ["status", "--short", "--branch"], {
@@ -70,6 +114,7 @@ export async function preflightTargetRepo(input) {
             code: "git-status-failed",
             message: "git status --short --branch failed",
             commands,
+            controllerIdentity,
         };
     }
     if (input.runCheckRepo) {
@@ -86,15 +131,18 @@ export async function preflightTargetRepo(input) {
                 code: "check-repo-failed",
                 message: `${[command, ...args].join(" ")} failed`,
                 commands,
+                controllerIdentity,
             };
         }
     }
     return {
         ok: true,
-        version: version.stdout.trim(),
+        version: reportedVersion,
+        reportedVersion: controllerIdentity?.reportedVersion,
         inspect: inspect.json,
         gitStatus: gitStatus.stdout,
         commands,
+        controllerIdentity,
     };
 }
 async function exists(filePath) {

package/dist/worker/report/morning-report.js

@@ -1,17 +1,30 @@
-import { access, writeFile, mkdir } from "node:fs/promises";
+import { access, writeFile, mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
-import { getRunsJsonlPath, readAllTaskPoolStates, readJsonlFile, } from "../pool/run-store.js";
+import YAML from "yaml";
+import { followUpActionCardSchema } from "../follow-up/schema.js";
+import { readFollowUpIndex, resolveRepoFile } from "../follow-up/store.js";
+import { loadFeatureDecisionModels } from "../feature/decision-loader.js";
+import { readValidTaskPoolRuns, readValidTaskPoolStates } from "../pool/validation.js";
 export async function renderMorningReport(options) {
-    const runs = (await readJsonlFile(getRunsJsonlPath(options.repoRoot))).filter((run) => !options.batchRunId || run.batchRunId === options.batchRunId);
+    const { features } = await loadFeatureDecisionModels(options.repoRoot);
+    const allRuns = (await readValidTaskPoolRuns(options.repoRoot)).records;
+    const runs = allRuns.filter((run) => !options.batchRunId || run.batchRunId === options.batchRunId);
     const total = runs.length;
     const succeeded = runs.filter((run) => run.status === "succeeded").length;
     const failed = runs.filter((run) => run.status === "failed").length;
     const followUps = runs.filter((run) => run.failure).length;
-    const states = await readAllTaskPoolStates(options.repoRoot);
+    const states = (await readValidTaskPoolStates(options.repoRoot)).records;
     const blocked = Object.values(states).filter((state) => state.status === "Blocked").length;
     const lines = [
         "# Nightly Worker Report",
         "",
+        "## Feature Decision Summary",
+        "",
+        ...(features.length === 0 ? ["- Status: no Feature Packet discovered", "- Next Action: add or locate a Feature Packet", "- Why: no shared Feature read model is available", "- Evidence: none"] : features.flatMap((feature) => {
+            const why = feature.blockingItems[0]?.message ?? `${feature.summary.tasksSucceeded}/${feature.summary.tasksTotal} tasks; ${feature.summary.requiredAcCovered}/${feature.summary.requiredAcTotal} required AC`;
+            const evidence = [feature.evidence.delivery, feature.evidence.closeout, feature.evidence.morningReport, feature.evidence.observeSnapshot, ...feature.blockingItems.flatMap((item) => item.evidence)].find(Boolean) ?? "none";
+            return [`### ${feature.featureId}`, "", `- Status: ${feature.status}`, `- Next Action: ${feature.nextAction?.command ?? feature.nextAction?.label ?? "none"}`, `- Why: ${why}`, `- Evidence: ${evidence}`, ""];
+        })),
         "## Summary",
         "",
         `- Total: ${total}`,
@@ -26,16 +39,38 @@ export async function renderMorningReport(options) {
         "|---|---|---|---|---|---|",
     ];
     for (const run of runs) {
-        lines.push(`| ${run.taskId} | ${run.status} | ${run.workerRunId} | ${run.failure?.category ?? "-"} | ${run.failure?.derivedFollowUpTaskId ?? "-"} | ${await artifactSummary(run)} |`);
+        const followUp = await followUpSummary(run, options.repoRoot);
+        lines.push(`| ${run.taskId} | ${run.status} | ${run.workerRunId} | ${run.failure?.category ?? "-"} | ${followUp ?? run.failure?.derivedFollowUpTaskId ?? "-"} | ${await artifactSummary(run)} |`);
     }
     if (followUps > 0) {
         lines.push("", "## Human Actions", "");
         for (const run of runs.filter((candidate) => candidate.failure)) {
-            lines.push(`- ${run.failure?.derivedFollowUpTaskId}: ${run.failure?.recommendedFollowUpKind} for ${run.taskId}`);
+            const followUp = await followUpSummary(run, options.repoRoot);
+            lines.push(`- ${followUp ?? `${run.failure?.derivedFollowUpTaskId}: ${run.failure?.recommendedFollowUpKind} for ${run.taskId}`}`);
         }
     }
     return `${lines.join("\n")}\n`;
 }
+async function followUpSummary(run, repoRoot) {
+    if (!run.failure)
+        return undefined;
+    try {
+        const index = await readFollowUpIndex(repoRoot, run.featureId);
+        const entry = index.entries.find((candidate) => candidate.workerRunId === run.workerRunId && candidate.status !== "Superseded" && candidate.status !== "Rejected");
+        if (!entry)
+            return undefined;
+        if (entry.kind === "TaskDraft") {
+            return entry.status === "Approved"
+                ? `${entry.followUpId}: approved as ${entry.proposedTaskId}`
+                : `${entry.followUpId}: approve ${entry.proposedTaskId}`;
+        }
+        const card = followUpActionCardSchema.parse(YAML.parse(await readFile(await resolveRepoFile(repoRoot, entry.draftPath), "utf-8")));
+        return `${entry.followUpId}: ${card.command ?? card.label}`;
+    }
+    catch {
+        return undefined;
+    }
+}
 export async function writeMorningReport(input) {
     const markdown = await renderMorningReport(input);
     await mkdir(path.dirname(input.outputPath), { recursive: true });

package/dist/worker/run-task/run-task.js

@@ -3,12 +3,18 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { formatDuration, noopProgressReporter } from "../progress-reporter.js";
 import { redactForPreview, truncatePreview } from "../observability/events.js";
+import { controllerIdentityExpectationFailure, resolveControllerIdentity, } from "../loop-agent/loop-agent-client.js";
 import { materializeTaskSpec, } from "../materialize/harness-task-materializer.js";
 import { preflightTargetRepo } from "../preflight.js";
 import { getTaskPoolRoot } from "../pool/run-store.js";
 export const DEFAULT_RUN_DAG_TIMEOUT_MS = 1_800_000;
 export const MAX_WORKER_TIMEOUT_MS = 7_200_000;
 export async function runTaskSpec(options) {
+    let controllerIdentity = resolveControllerIdentity(options.client, options.controllerIdentity);
+    const identityFailure = controllerIdentityExpectationFailure(controllerIdentity, options.controllerExpectation);
+    if (identityFailure) {
+        throw new Error(`${identityFailure.code}: ${identityFailure.message}`);
+    }
     const now = options.now ?? new Date();
     const workerRunId = options.workerRunId ?? buildWorkerRunId(options.taskSpec.id, now);
     const commands = [];
@@ -26,11 +32,13 @@ export async function runTaskSpec(options) {
                 repoRoot: options.repoRoot,
                 client,
                 ...(typeof options.preflight === "object" ? options.preflight : {}),
+                ...(options.controllerExpectation ? { expectation: options.controllerExpectation } : {}),
             });
             if (!preflight.ok) {
                 progress.note(`preflight FAILED: ${preflight.code}`);
                 throw new Error(`target repo preflight failed: ${preflight.code}: ${preflight.message}`);
             }
+            controllerIdentity = preflight.controllerIdentity ?? controllerIdentity;
         });
         progress.step(`preflight ok in ${formatDuration(Date.now() - preflightStartedAt)}`);
     }
@@ -66,7 +74,6 @@ export async function runTaskSpec(options) {
             dagPath,
             "--cwd",
             options.repoRoot,
-            ...noCursorArgs(options.taskSpec),
         ], true, undefined, eventCtx);
     });
     progress.step(`dag generated in ${formatDuration(Date.now() - dagGenStartedAt)}`);
@@ -90,7 +97,6 @@ export async function runTaskSpec(options) {
             "--strict-governance",
             "--spine-task",
             materializeManifest.harnessTaskId,
-            ...forbidCursorArgs(options.taskSpec),
         ], true, undefined, eventCtx);
     });
     progress.step(`dag validated in ${formatDuration(Date.now() - validateStartedAt)}`);
@@ -111,7 +117,6 @@ export async function runTaskSpec(options) {
             "--events-jsonl",
             dagEventsPath,
             ...maxConcurrentArgs(options.taskSpec),
-            ...noCursorArgs(options.taskSpec),
         ], resolveRunDagTimeoutMs(options.taskSpec), eventCtx);
     });
     progress.step(`run-dag finished in ${formatDuration(Date.now() - runDagStartedAt)}`);
@@ -156,7 +161,7 @@ export async function runTaskSpec(options) {
             taskArtifactsDir,
             eventCtx,
         });
-    if (reportDecision.succeeded) {
+    if (reportDecision.succeeded && !options.skipSuccessFinalization) {
         await runObservedStep(eventCtx, "promote-run", async () => {
             progress.step("promote run");
             await runRequiredCommand(options.repoRoot, client, "promote-run", ["promote-run", materializeManifest.harnessTaskId, "--run-id", workerRunId], true, undefined, eventCtx);
@@ -180,6 +185,7 @@ export async function runTaskSpec(options) {
         reportDecision,
         commands,
         ...(failureArtifacts ? { failureArtifacts } : {}),
+        ...(controllerIdentity ? { controllerIdentity } : {}),
     };
     await writeFile(runRecordPath, `${JSON.stringify(record, null, 2)}\n`, "utf-8");
     emit(progress, {
@@ -407,6 +413,12 @@ class RecordingRunTaskClient {
         this.delegate = delegate;
         this.records = records;
     }
+    getIdentity() {
+        return this.delegate.getIdentity?.();
+    }
+    observeReportedVersion(reportedVersion) {
+        return this.delegate.observeReportedVersion?.(reportedVersion);
+    }
     async run(args, options) {
         const result = await this.delegate.run(args, options);
         this.records.push({
@@ -452,6 +464,12 @@ class ObservedRunTaskClient {
         this.delegate = delegate;
         this.eventCtx = eventCtx;
     }
+    getIdentity() {
+        return this.delegate.getIdentity();
+    }
+    observeReportedVersion(reportedVersion) {
+        return this.delegate.observeReportedVersion(reportedVersion);
+    }
     run(args, options) {
         return this.runObserved(args, options, (observedOptions) => this.delegate.run(args, observedOptions));
     }
@@ -544,12 +562,6 @@ function commandRecordName(args, artifactName) {
         return "new-task";
     return artifactName;
 }
-function noCursorArgs(taskSpec) {
-    return taskSpec.loop_agent.no_cursor ? ["--no-cursor"] : [];
-}
-function forbidCursorArgs(taskSpec) {
-    return taskSpec.loop_agent.no_cursor ? ["--forbid-executor", "cursor"] : [];
-}
 function maxConcurrentArgs(taskSpec) {
     return ["--max-concurrent", String(taskSpec.loop_agent.max_concurrent)];
 }
@@ -563,14 +575,12 @@ function strictModelsArgs(piModel) {
 }
 /**
  * Rewrite `executorModels.pi.{LOW,MED,HIGH}` in an already-generated DAG JSON
- * so every pi executor node resolves to the smoke override model. Cursor / shell
- * slots are left untouched.
+ * so every pi executor node resolves to the smoke override model.
  */
 export async function applyPiModelOverride(dagPath, piModel) {
     const raw = await readFile(dagPath, "utf-8");
     const spec = JSON.parse(raw);
     spec.executorModels = {
-        ...(spec.executorModels?.cursor ? { cursor: spec.executorModels.cursor } : {}),
         pi: {
             LOW: piModel,
             MED: piModel,