harness-wingman 0.5.0 → 0.6.0

package/apps/cli/dist/main.js

@@ -3239,7 +3239,7 @@ var init_actions2 = __esm({
 
 // packages/adapter-codex/dist/hooks.js
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync9, rmSync as rmSync4, writeFileSync as writeFileSync7 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync9, realpathSync, rmSync as rmSync4, writeFileSync as writeFileSync7 } from "node:fs";
 import { basename as basename5, dirname as dirname8, join as join12 } from "node:path";
 async function installHooks(port, options) {
   if (!Number.isInteger(port) || port <= 0 || port > 65535) {
@@ -3395,25 +3395,51 @@ function restoreTarget(remainder, state) {
 }
 function resolveNodeExecutable(probe = {}) {
   const execPath = probe.execPath ?? process.execPath;
-  if (isNodeExecutable(execPath))
-    return execPath;
-  const loginShellWhich = probe.loginShellWhich ?? defaultLoginShellWhich;
-  try {
-    const shellNode = loginShellWhich(probe.shell ?? process.env.SHELL ?? "/bin/sh")?.trim();
-    if (shellNode !== void 0 && shellNode !== "node" && isNodeExecutable(shellNode)) {
-      return shellNode;
+  const exists = probe.exists ?? existsSync8;
+  let executable = isNodeExecutable(execPath) ? execPath : void 0;
+  if (executable === void 0) {
+    const loginShellWhich = probe.loginShellWhich ?? defaultLoginShellWhich;
+    try {
+      const shellNode = loginShellWhich(probe.shell ?? process.env.SHELL ?? "/bin/sh")?.trim();
+      if (shellNode !== void 0 && shellNode !== "node" && isNodeExecutable(shellNode)) {
+        executable = shellNode;
+      }
+    } catch {
     }
-  } catch {
   }
-  const exists = probe.exists ?? existsSync8;
-  for (const candidate of ["/opt/homebrew/bin/node", "/usr/local/bin/node"]) {
+  if (executable === void 0) {
+    for (const candidate of ["/opt/homebrew/bin/node", "/usr/local/bin/node"]) {
+      try {
+        if (exists(candidate) && isNodeExecutable(candidate)) {
+          executable = candidate;
+          break;
+        }
+      } catch {
+      }
+    }
+  }
+  if (executable === void 0)
+    return "node";
+  const realpath2 = probe.realpath ?? defaultRealpath;
+  for (const alias of ["/opt/homebrew/bin/node", "/usr/local/bin/node"]) {
     try {
-      if (exists(candidate) && isNodeExecutable(candidate))
-        return candidate;
+      if (!exists(alias))
+        continue;
+      const executableRealpath = realpath2(executable);
+      if (executableRealpath !== void 0 && realpath2(alias) === executableRealpath) {
+        return alias;
+      }
     } catch {
     }
   }
-  return "node";
+  return executable;
+}
+function defaultRealpath(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return void 0;
+  }
 }
 function defaultLoginShellWhich(shell) {
   const result4 = spawnSync(shell, ["-lc", "command -v node"], {
@@ -12905,9 +12931,9 @@ var init_dist5 = __esm({
 
 // apps/cli/dist/main.js
 init_dist();
-import { readFileSync as readFileSync15 } from "node:fs";
+import { readFileSync as readFileSync17 } from "node:fs";
 import { homedir as homedir13 } from "node:os";
-import { dirname as dirname16, resolve as resolve11 } from "node:path";
+import { dirname as dirname17, resolve as resolve11 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // packages/fixtures/dist/index.js
@@ -13308,7 +13334,7 @@ init_dist4();
 init_dist5();
 init_dist();
 import { readdir } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join20, resolve as resolve9 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join21, resolve as resolve9 } from "node:path";
 
 // packages/narrative/dist/attribute.js
 function extractSteps(lines2) {
@@ -13882,7 +13908,7 @@ function parseProjectPlan(input, facts = {}) {
   }
   let title;
   let goal;
-  let ignoredLineCount = 0;
+  const ignoredLines = [];
   let fence;
   let stepCount = 0;
   let lastStep;
@@ -13892,7 +13918,7 @@ function parseProjectPlan(input, facts = {}) {
     const lineNumber = index + 1;
     const fenceMatch = FENCE_LINE.exec(line);
     if (fence !== void 0) {
-      ignoredLineCount += 1;
+      ignoredLines.push(ignoredLine(lineNumber, line));
       if (fenceMatch?.[1] === fence)
         fence = void 0;
       lastStep = void 0;
@@ -13900,7 +13926,7 @@ function parseProjectPlan(input, facts = {}) {
     }
     if (fenceMatch !== null) {
       fence = fenceMatch[1];
-      ignoredLineCount += 1;
+      ignoredLines.push(ignoredLine(lineNumber, line));
       lastStep = void 0;
       continue;
     }
@@ -13910,8 +13936,9 @@ function parseProjectPlan(input, facts = {}) {
     if (headingMatch !== null) {
       if (title === void 0)
         title = headingMatch[1];
-      else
-        ignoredLineCount += 1;
+      else {
+        ignoredLines.push(ignoredLine(lineNumber, line));
+      }
       lastStep = void 0;
       continue;
     }
@@ -13951,7 +13978,7 @@ function parseProjectPlan(input, facts = {}) {
       lastStep = { indent, line: lineNumber, node };
       continue;
     }
-    ignoredLineCount += 1;
+    ignoredLines.push(ignoredLine(lineNumber, line));
     lastStep = void 0;
   }
   assignNodeKeys(nodes);
@@ -13960,7 +13987,8 @@ function parseProjectPlan(input, facts = {}) {
     version: 1,
     ...title === void 0 ? {} : { title },
     ...goal === void 0 ? {} : { goal },
-    ignoredLineCount,
+    ignoredLineCount: ignoredLines.length,
+    ignoredLines,
     nodes
   };
 }
@@ -13996,7 +14024,8 @@ function deriveProjectPlanSummary(nodes) {
   };
   const allLeavesDone = leaves.length > 0 && leaves.every((node) => node.status === "completed" || node.status === "cancelled");
   return {
-    currentPointLabel: currentPoints.length === 0 ? "\u8BA1\u5212\u672A\u6807\u8BB0\u8FDB\u884C\u4E2D\u6B65\u9AA4" : currentPoints.length === 1 ? "\u5F53\u524D\u70B9" : `\u5E76\u884C ${currentPoints.length} \u9879`,
+    currentPointLabel: currentPoints.length === 0 ? "\u5F53\u524D\u70B9" : currentPoints.length === 1 ? "\u5F53\u524D\u70B9" : `\u5E76\u884C ${currentPoints.length} \u9879`,
+    ...currentPoints.length === 0 ? { currentPointEmptyText: "\u8BA1\u5212\u672A\u6807\u8BB0\u8FDB\u884C\u4E2D\u6B65\u9AA4" } : {},
     currentPoints,
     checkpoints,
     counts,
@@ -14040,6 +14069,9 @@ function validateFileFacts(facts) {
 function unavailable(reason, line) {
   return { availability: "unavailable", reason, ...line === void 0 ? {} : { line } };
 }
+function ignoredLine(line, text) {
+  return { line, preview: Array.from(text).slice(0, 40).join("") };
+}
 function indentColumns(indent) {
   let columns = 0;
   for (const character of indent)
@@ -14406,6 +14438,12 @@ function costUsd(usage, model) {
 }
 
 // packages/narrative/dist/workflow.js
+var PLAN_MANAGEMENT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "TodoWrite",
+  "TaskCreate",
+  "TaskUpdate",
+  "update_plan"
+]);
 function deriveTaskWorkflowView(input) {
   return {
     ...input.goal === void 0 ? {} : { goal: input.goal },
@@ -14611,6 +14649,51 @@ function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+// packages/narrative/dist/verification.js
+var CHECK_STATS_SOURCE = "Harness tool_result(is_error / exit_code)";
+function deriveCheckStats(steps, briefs) {
+  let runs = 0;
+  let failures = 0;
+  let latestFailureStep;
+  for (const step of steps) {
+    if (step.endTs === void 0 || PLAN_MANAGEMENT_TOOL_NAMES.has(step.toolName))
+      continue;
+    runs += 1;
+    if (!step.isError)
+      continue;
+    failures += 1;
+    if (latestFailureStep?.endTs === void 0 || latestFailureStep.endTs < step.endTs) {
+      latestFailureStep = step;
+    }
+  }
+  if (latestFailureStep?.endTs === void 0)
+    return { runs, failures };
+  const brief = briefs.get(latestFailureStep.toolUseId);
+  return {
+    runs,
+    failures,
+    latestFailure: {
+      toolName: latestFailureStep.toolName,
+      ...brief === void 0 ? {} : { brief },
+      at: latestFailureStep.endTs
+    }
+  };
+}
+function deriveTodoCheckStats(attributed) {
+  const stats = /* @__PURE__ */ new Map();
+  for (const { step, attribution } of attributed) {
+    if (attribution.kind !== "todo" || step.endTs === void 0 || PLAN_MANAGEMENT_TOOL_NAMES.has(step.toolName)) {
+      continue;
+    }
+    const current = stats.get(attribution.todoId) ?? { runs: 0, failures: 0 };
+    current.runs += 1;
+    if (step.isError)
+      current.failures += 1;
+    stats.set(attribution.todoId, current);
+  }
+  return stats;
+}
+
 // apps/cli/dist/project-attribution.js
 function extractToolObservations(harness, records) {
   const observations = [];
@@ -14950,18 +15033,171 @@ function isWithin(parent, child) {
   return pathFromParent === "" || !pathFromParent.startsWith("..") && !isAbsolute3(pathFromParent);
 }
 
+// apps/cli/dist/task-overlay.js
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { closeSync, mkdirSync as mkdirSync9, openSync, readFileSync as readFileSync14, renameSync as renameSync3, rmSync as rmSync7, writeFileSync as writeFileSync10 } from "node:fs";
+import { dirname as dirname15, join as join20 } from "node:path";
+function taskOverlayPath(homeDir) {
+  return join20(homeDir, ".wingman", "state", "task-overlay.json");
+}
+function readTaskOverlay(homeDir) {
+  const path = taskOverlayPath(homeDir);
+  let raw;
+  try {
+    raw = readFileSync14(path, "utf8");
+  } catch (error) {
+    if (isErrno(error, "ENOENT"))
+      return { version: 1, entries: {} };
+    return { unavailable: `overlay \u6587\u4EF6\u65E0\u6CD5\u8BFB\u53D6;\u8BF7\u4EBA\u5DE5\u68C0\u67E5 ${path}:${errorMessage(error)}` };
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!isTaskOverlay(parsed))
+      throw new Error("\u4E0D\u662F\u5408\u6CD5 v1 \u7ED3\u6784");
+    return parsed;
+  } catch (error) {
+    return { unavailable: `overlay \u6587\u4EF6\u65E0\u6CD5\u89E3\u6790;\u8BF7\u4EBA\u5DE5\u68C0\u67E5 ${path}:${errorMessage(error)}` };
+  }
+}
+function patchTaskOverlay(homeDir, key, patch, now) {
+  const current = readTaskOverlay(homeDir);
+  if ("unavailable" in current) {
+    return {
+      unavailable: `overlay \u6587\u4EF6\u65E0\u6CD5\u89E3\u6790,\u62D2\u7EDD\u8986\u76D6;\u8BF7\u4EBA\u5DE5\u68C0\u67E5 ${taskOverlayPath(homeDir)}`
+    };
+  }
+  const entry = {
+    ...current.entries[key],
+    updatedAt: now.toISOString()
+  };
+  if ("title" in patch) {
+    const title = patch.title?.trim() ?? "";
+    if (title === "")
+      delete entry.title;
+    else
+      entry.title = title;
+  }
+  if (patch.pinned !== void 0)
+    entry.pinned = patch.pinned;
+  if (patch.hidden !== void 0)
+    entry.hidden = patch.hidden;
+  if (patch.accepted === true)
+    entry.accepted = { at: now.toISOString() };
+  else if (patch.accepted === false)
+    delete entry.accepted;
+  const empty = entry.title === void 0 && entry.pinned !== true && entry.hidden !== true && entry.accepted === void 0;
+  const entries = { ...current.entries };
+  if (empty)
+    delete entries[key];
+  else
+    entries[key] = entry;
+  writeTaskOverlay(homeDir, { version: 1, entries });
+  return { entry: empty ? null : entry };
+}
+function writeTaskOverlay(homeDir, overlay) {
+  const path = taskOverlayPath(homeDir);
+  const tempPath = join20(dirname15(path), `.task-overlay-${randomBytes2(8).toString("hex")}.tmp`);
+  let fd;
+  try {
+    mkdirSync9(dirname15(path), { recursive: true, mode: 448 });
+    fd = openSync(tempPath, "wx", 384);
+    writeFileSync10(fd, `${JSON.stringify(overlay)}
+`, "utf8");
+    closeSync(fd);
+    fd = void 0;
+    renameSync3(tempPath, path);
+  } catch (error) {
+    if (fd !== void 0) {
+      try {
+        closeSync(fd);
+      } catch {
+      }
+    }
+    try {
+      rmSync7(tempPath, { force: true });
+    } catch {
+    }
+    throw error;
+  }
+}
+function isTaskOverlay(value) {
+  if (!isRecord6(value) || value.version !== 1 || !isRecord6(value.entries))
+    return false;
+  return Object.values(value.entries).every(isTaskOverlayEntry);
+}
+function isTaskOverlayEntry(value) {
+  if (!isRecord6(value))
+    return false;
+  if (Object.keys(value).some((key) => !["title", "pinned", "hidden", "accepted", "updatedAt"].includes(key))) {
+    return false;
+  }
+  return (value.title === void 0 || typeof value.title === "string") && (value.pinned === void 0 || typeof value.pinned === "boolean") && (value.hidden === void 0 || typeof value.hidden === "boolean") && (value.accepted === void 0 || isTaskAcceptance(value.accepted)) && typeof value.updatedAt === "string";
+}
+function isTaskAcceptance(value) {
+  return isRecord6(value) && Object.keys(value).every((key) => key === "at") && typeof value.at === "string";
+}
+function isRecord6(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isErrno(error, code) {
+  return isRecord6(error) && error.code === code;
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// apps/cli/dist/version.js
+import { readFileSync as readFileSync15 } from "node:fs";
+function resolveWingmanVersion({ defined, moduleUrl = import.meta.url, readPackage }) {
+  if (typeof defined === "string" && defined.trim() !== "")
+    return defined;
+  for (const packageUrl of [
+    new URL("../package.json", moduleUrl),
+    new URL("../../../package.json", moduleUrl)
+  ]) {
+    try {
+      const pkg = readPackage(packageUrl);
+      if (typeof pkg === "object" && pkg !== null && "name" in pkg && pkg.name === "harness-wingman" && "version" in pkg && typeof pkg.version === "string") {
+        return pkg.version;
+      }
+    } catch {
+    }
+  }
+  return void 0;
+}
+function wingmanVersion() {
+  const defined = false ? void 0 : "0.6.0";
+  return resolveWingmanVersion({
+    defined,
+    readPackage: (url) => JSON.parse(readFileSync15(url, "utf8"))
+  });
+}
+
 // apps/cli/dist/narrative-service.js
 var MAX_SESSIONS = 8;
 var ENDED_AFTER_STOP_MS = 10 * 6e4;
-var TODO_TOOLS = /* @__PURE__ */ new Set(["TaskCreate", "TaskUpdate", "TodoWrite", "update_plan"]);
 var DETAIL_LIMIT = 80;
 var QUOTE_LIMIT = 160;
 var ERROR_BRIEF_LIMIT = 60;
+function acceptanceView(homeDir, overlay, key) {
+  if (homeDir === void 0)
+    return { state: "unavailable", reason: "\u672A\u914D\u7F6E\u672C\u673A\u72B6\u6001\u76EE\u5F55" };
+  if (overlay === void 0 || "unavailable" in overlay) {
+    return {
+      state: "unavailable",
+      reason: overlay?.unavailable ?? "\u672C\u673A\u9A8C\u6536\u72B6\u6001\u4E0D\u53EF\u8BFB"
+    };
+  }
+  const accepted = overlay.entries[key]?.accepted;
+  return accepted === void 0 ? { state: "none" } : { state: "accepted", at: accepted.at };
+}
 function createNarrativeService(options = {}) {
   const follow = options.followTranscripts ?? true;
   const intervalMs = options.intervalMs ?? 500;
   const now = options.now ?? (() => /* @__PURE__ */ new Date());
+  const startedAt = now().toISOString();
   const harnesses = /* @__PURE__ */ new Map();
+  const notices = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Set();
   const pendingNotifications = /* @__PURE__ */ new Set();
   const projectWatchers = /* @__PURE__ */ new Map();
@@ -15045,7 +15281,7 @@ function createNarrativeService(options = {}) {
   function watchResolution(resolution) {
     if (resolution.lookedUp.length === 0)
       return;
-    const planPath = resolution.planPath ?? join20(resolution.root, ".wingman", "plan.md");
+    const planPath = resolution.planPath ?? join21(resolution.root, ".wingman", "plan.md");
     const planPathIdentity = resolution.planPathIdentity;
     if (projectWatchers.has(planPathIdentity))
       return;
@@ -15105,7 +15341,7 @@ function createNarrativeService(options = {}) {
       for (const session of sessions.values()) {
         const resolution = session.projectResolution;
         if (resolution?.planPathIdentity === planPathIdentity) {
-          const planPath = resolution.planPath ?? join20(resolution.root, ".wingman", "plan.md");
+          const planPath = resolution.planPath ?? join21(resolution.root, ".wingman", "plan.md");
           void applyPendingPlanWrites(session, planPath, planPathIdentity).then(() => {
             session.dirty = true;
             notify(harness);
@@ -15121,8 +15357,9 @@ function createNarrativeService(options = {}) {
   function recordToolObservations(harness, session, tools) {
     for (const tool of tools) {
       if (tool.planWrites.length === 0) {
-        if (!tool.planFileAccess && !TODO_TOOLS.has(tool.method))
+        if (!tool.planFileAccess && !PLAN_MANAGEMENT_TOOL_NAMES.has(tool.method)) {
           session.nonPlanToolSteps += 1;
+        }
         continue;
       }
       recordPlanWrites(harness, session, tool.planWrites, session.nonPlanToolSteps);
@@ -15145,7 +15382,7 @@ function createNarrativeService(options = {}) {
     }
     const resolution = session.projectResolution;
     if (resolution !== void 0) {
-      const planPath = resolution.planPath ?? join20(resolution.root, ".wingman", "plan.md");
+      const planPath = resolution.planPath ?? join21(resolution.root, ".wingman", "plan.md");
       void applyPendingPlanWrites(session, planPath, resolution.planPathIdentity).then(() => {
         session.dirty = true;
         notify(harness);
@@ -15185,7 +15422,7 @@ function createNarrativeService(options = {}) {
     }
     session.pendingPlanWrites = remaining;
   }
-  function evictOne(sessions, nowIso) {
+  function evictOne(harness, sessions, nowIso) {
     let victimId;
     let victimAt = "\uFFFF";
     let victimEnded = false;
@@ -15201,8 +15438,20 @@ function createNarrativeService(options = {}) {
     }
     if (victimId !== void 0) {
       const victim = sessions.get(victimId);
-      if (victim)
+      if (victim) {
         closeSession(victim);
+        const current = notices.get(harness) ?? [];
+        current.push({
+          kind: "evicted",
+          sessionId: victim.id,
+          label: victim.label ?? victim.id.slice(0, 8),
+          at: nowIso,
+          reason: "\u5DF2\u8FBE 8 \u4E2A\u4F1A\u8BDD\u4E0A\u9650"
+        });
+        if (current.length > 5)
+          current.splice(0, current.length - 5);
+        notices.set(harness, current);
+      }
       sessions.delete(victimId);
     }
   }
@@ -15211,7 +15460,7 @@ function createNarrativeService(options = {}) {
     let session = sessions.get(id);
     if (session === void 0) {
       if (sessions.size >= MAX_SESSIONS)
-        evictOne(sessions, now().toISOString());
+        evictOne(harness, sessions, now().toISOString());
       session = newSession(id);
       sessions.set(id, session);
     }
@@ -15247,7 +15496,7 @@ function createNarrativeService(options = {}) {
     const sessionDir = transcriptPath.replace(/\.jsonl$/, "");
     if (sessionDir === transcriptPath)
       return;
-    const subagentsDir = join20(sessionDir, "subagents");
+    const subagentsDir = join21(sessionDir, "subagents");
     const generation = session.generation;
     const poll = async () => {
       try {
@@ -15257,7 +15506,7 @@ function createNarrativeService(options = {}) {
         }
         for (const entry of entries) {
           if (/^agent-.*\.jsonl$/.test(entry)) {
-            startFollowing(harness, session, join20(subagentsDir, entry), generation);
+            startFollowing(harness, session, join21(subagentsDir, entry), generation);
           }
         }
       } catch {
@@ -15433,6 +15682,7 @@ function createNarrativeService(options = {}) {
   function getOverview(harness) {
     const nowIso = now().toISOString();
     const sessions = sessionsOf(harness);
+    const overlay = options.homeDir === void 0 ? void 0 : readTaskOverlay(options.homeDir);
     let feedback;
     try {
       feedback = options.feedbackSignals?.(harness);
@@ -15451,15 +15701,28 @@ function createNarrativeService(options = {}) {
     const states = {};
     for (const [id, session] of sessions) {
       const state = deriveCached(harness, session);
+      const verification = state.taskWorkflow?.verification;
       states[id] = state.taskWorkflow === void 0 ? state : {
         ...state,
         taskWorkflow: {
           ...state.taskWorkflow,
-          feedback: feedbackView(harness, feedback, session.feedbackState)
+          feedback: feedbackView(harness, feedback, session.feedbackState),
+          ...verification === void 0 ? {} : {
+            verification: {
+              ...verification,
+              acceptance: acceptanceView(options.homeDir, overlay, `${harness}:${id}`)
+            }
+          }
         }
       };
     }
-    return { harness, sessions: infos, states };
+    return {
+      harness,
+      startedAt,
+      notices: [...notices.get(harness) ?? []],
+      sessions: infos,
+      states
+    };
   }
   function getState(harness) {
     const overview = getOverview(harness);
@@ -15533,6 +15796,8 @@ function createNarrativeService(options = {}) {
     };
   }
   function getProjects() {
+    const overlay = options.homeDir === void 0 ? void 0 : readTaskOverlay(options.homeDir);
+    const overlayEntries = overlay === void 0 || "unavailable" in overlay ? {} : overlay.entries;
     const grouped = /* @__PURE__ */ new Map();
     for (const [harness, sessions] of harnesses) {
       for (const session of sessions.values()) {
@@ -15553,7 +15818,7 @@ function createNarrativeService(options = {}) {
     for (const members of grouped.values()) {
       const resolution = members.find((member) => member.session.projectResolution !== void 0)?.session.projectResolution;
       const root = resolution?.root ?? resolve9(members[0]?.session.cwd ?? "");
-      const planPath = resolution?.planPath ?? join20(root, ".wingman", "plan.md");
+      const planPath = resolution?.planPath ?? join21(root, ".wingman", "plan.md");
       const runtime = projectFiles.get(resolution?.planPathIdentity ?? planPath);
       const parsed = runtime?.missing === true ? void 0 : runtime?.parsed;
       const planMtime = parsed?.availability === "available" ? runtime?.current?.info.mtime : void 0;
@@ -15566,11 +15831,31 @@ function createNarrativeService(options = {}) {
         const overview = overviews.get(harness);
         const state = overview?.states[session.id];
         const info = overview?.sessions.find((candidate) => candidate.id === session.id);
+        const label = session.label ?? session.id.slice(0, 8);
+        const userEntry = overlayEntries[`${harness}:${session.id}`];
+        const verification = state?.taskWorkflow?.verification;
+        const attachedTitle = session.planAttachment?.attachedTo.split(" > ").at(-1);
+        const instructionTitle = state?.taskWorkflow?.latestInstruction?.text;
         return {
           harness,
           id: session.id,
-          label: session.label ?? session.id.slice(0, 8),
+          label,
           ended: info?.ended ?? false,
+          title: attachedTitle !== void 0 ? { text: attachedTitle, source: "plan.md \u6B65\u9AA4" } : instructionTitle !== void 0 ? { text: truncate(instructionTitle, DETAIL_LIMIT), source: "\u6700\u65B0\u6307\u4EE4" } : { text: label, source: "\u5DE5\u4F5C\u76EE\u5F55" },
+          user: {
+            ...userEntry?.title === void 0 ? {} : { title: userEntry.title },
+            pinned: userEntry?.pinned ?? false,
+            hidden: userEntry?.hidden ?? false
+          },
+          ...session.cwd === void 0 ? {} : { cwd: session.cwd },
+          ...info?.lastActivity === void 0 ? {} : { lastActivity: info.lastActivity },
+          waiting: info?.waiting ?? false,
+          checks: verification?.checks ?? {
+            runs: 0,
+            failures: 0,
+            source: CHECK_STATS_SOURCE
+          },
+          acceptance: acceptanceView(options.homeDir, overlay, `${harness}:${session.id}`),
           compliance: complianceFor(session, protocol[harness]),
           ...session.planAttachment === void 0 ? {} : {
             attachedTo: session.planAttachment.attachedTo,
@@ -15614,6 +15899,7 @@ function createNarrativeService(options = {}) {
         plan = {
           availability: "available",
           ignoredLineCount: parsed.ignoredLineCount,
+          ignoredLines: parsed.ignoredLines,
           nodes: parsed.nodes,
           higherPlanPaths: resolution?.higherPlanPaths ?? []
         };
@@ -15774,9 +16060,11 @@ function waitingSignal(payload) {
 }
 function feedbackView(harness, capability, state) {
   if (capability === "not_wired") {
+    const version = wingmanVersion();
+    const command = `npx harness-wingman${version === void 0 ? "" : `@${version}`} hook install ${harness}`;
     return {
       state: "unavailable",
-      reason: `\u53CD\u9988\u4FE1\u53F7\u672A\u63A5\u7EBF\uFF1B\u8BF7\u8FD0\u884C npx harness-wingman hook install ${harness}`
+      reason: `\u53CD\u9988\u4FE1\u53F7\u672A\u63A5\u7EBF\uFF1B\u8BF7\u8FD0\u884C ${command}${version === void 0 ? "\uFF08\u7248\u672C\u672A\u77E5,\u53EF\u80FD\u88C5\u5230\u522B\u7684\u7248\u672C\uFF09" : ""}`
     };
   }
   if (capability === "unavailable") {
@@ -15792,10 +16080,17 @@ function derive(harness, session, nowIso) {
   const lines2 = harness === "codex" ? adaptCodexNarrativeLines(codexLines) : sortedByTimestamp(session.lines);
   const timeline = deriveTodoTimeline(extractTodoSnapshots(lines2));
   const allSteps = extractSteps(lines2);
-  const steps = allSteps.filter((s) => !TODO_TOOLS.has(s.toolName));
+  const steps = allSteps.filter((s) => !PLAN_MANAGEMENT_TOOL_NAMES.has(s.toolName));
   const intervals = [...deriveSubagentIntervals(lines2), ...session.hookIntervals];
   const attributed = attributeSteps(steps, timeline, intervals);
   const results = collectResults(lines2);
+  const resultBriefs = /* @__PURE__ */ new Map();
+  for (const [toolUseId, result4] of results) {
+    if (result4.brief !== void 0)
+      resultBriefs.set(toolUseId, result4.brief);
+  }
+  const checks = deriveCheckStats(allSteps, resultBriefs);
+  const todoChecks = deriveTodoCheckStats(attributed);
   const buckets = /* @__PURE__ */ new Map();
   for (const { step, attribution } of attributed) {
     const key = attribution.kind === "todo" ? attribution.todoId : null;
@@ -15881,7 +16176,7 @@ function derive(harness, session, nowIso) {
     source: "transcript / hook tool event",
     ...currentAction.since === void 0 ? {} : { observedAt: currentAction.since }
   } : { text: currentAction.name, source: "hook event", observedAt: currentAction.at };
-  const taskWorkflow = deriveTaskWorkflowView({
+  const workflowBase = deriveTaskWorkflowView({
     harness,
     lines: lines2,
     codexLines,
@@ -15898,6 +16193,26 @@ function derive(harness, session, nowIso) {
     },
     feedback: { state: "unavailable", reason: "\u53CD\u9988\u80FD\u529B\u5C1A\u672A\u6620\u5C04" }
   });
+  const activeTodos = todos.filter((todo) => todo.status === "in_progress");
+  const activeTodo = activeTodos.length === 1 ? activeTodos[0] : void 0;
+  const activeChecks = activeTodo === void 0 ? void 0 : todoChecks.get(activeTodo.id);
+  const plan = workflowBase.plan;
+  const taskWorkflow = {
+    ...workflowBase,
+    verification: {
+      agentMarkedComplete: plan.availability === "available" && plan.steps.length > 0 && plan.steps.every((step) => step.status === "completed"),
+      checks: { ...checks, source: CHECK_STATS_SOURCE },
+      ...activeTodo === void 0 ? {} : {
+        currentStep: {
+          text: activeTodo.content,
+          runs: activeChecks?.runs ?? 0,
+          failures: activeChecks?.failures ?? 0
+        }
+      },
+      // 响应组装时从 overlay 重读并覆盖；检查与计划派生仍可安全缓存。
+      acceptance: { state: "unavailable", reason: "\u9A8C\u6536\u72B6\u6001\u5728\u54CD\u5E94\u65F6\u8BFB\u53D6" }
+    }
+  };
   return {
     harness,
     sessionId: session.id,
@@ -16574,45 +16889,45 @@ async function loadHarness(harness, mode) {
 }
 
 // apps/cli/dist/runtime-state.js
-import { randomBytes as randomBytes2 } from "node:crypto";
-import { closeSync, mkdirSync as mkdirSync9, openSync, readFileSync as readFileSync14, renameSync as renameSync3, rmSync as rmSync7, writeFileSync as writeFileSync10 } from "node:fs";
+import { randomBytes as randomBytes3 } from "node:crypto";
+import { closeSync as closeSync2, mkdirSync as mkdirSync10, openSync as openSync2, readFileSync as readFileSync16, renameSync as renameSync4, rmSync as rmSync8, writeFileSync as writeFileSync11 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
-import { dirname as dirname15, join as join21 } from "node:path";
+import { dirname as dirname16, join as join22 } from "node:path";
 function createHookToken() {
-  return randomBytes2(32).toString("base64url");
+  return randomBytes3(32).toString("base64url");
 }
 function writeServeRuntimeState(port, token, options = {}) {
   const warn = options.warn ?? (() => {
   });
   const startedAtMs = (options.now ?? Date.now)();
   const pid = options.pid ?? process.pid;
-  const suffix = randomBytes2(8).toString("base64url");
+  const suffix = randomBytes3(8).toString("base64url");
   const owner = `serve-${startedAtMs}-${pid}-${suffix}`;
-  const path = join21(options.homeDir ?? homedir12(), ".wingman", "state", "serve", `${owner}.json`);
-  const tempPath = join21(dirname15(path), `.${owner}.tmp`);
+  const path = join22(options.homeDir ?? homedir12(), ".wingman", "state", "serve", `${owner}.json`);
+  const tempPath = join22(dirname16(path), `.${owner}.tmp`);
   const contents = Buffer.from(`${JSON.stringify({ version: 2, owner, pid, port, startedAtMs, token })}
 `, "utf8");
   let fd;
   try {
-    mkdirSync9(dirname15(path), { recursive: true, mode: 448 });
-    fd = openSync(tempPath, "wx", 384);
-    writeFileSync10(fd, contents);
-    closeSync(fd);
+    mkdirSync10(dirname16(path), { recursive: true, mode: 448 });
+    fd = openSync2(tempPath, "wx", 384);
+    writeFileSync11(fd, contents);
+    closeSync2(fd);
     fd = void 0;
-    renameSync3(tempPath, path);
+    renameSync4(tempPath, path);
     return { path, contents };
   } catch (error) {
     if (fd !== void 0) {
       try {
-        closeSync(fd);
+        closeSync2(fd);
       } catch {
       }
     }
     try {
-      rmSync7(tempPath, { force: true });
+      rmSync8(tempPath, { force: true });
     } catch {
     }
-    warn(`Codex hook \u8FD0\u884C\u6001\u5199\u5165\u5931\u8D25,\u9762\u677F\u7EE7\u7EED\u8FD0\u884C:${errorMessage(error)}`);
+    warn(`Codex hook \u8FD0\u884C\u6001\u5199\u5165\u5931\u8D25,\u9762\u677F\u7EE7\u7EED\u8FD0\u884C:${errorMessage2(error)}`);
     return void 0;
   }
 }
@@ -16620,13 +16935,13 @@ function removeServeRuntimeState(registration) {
   if (registration === void 0)
     return;
   try {
-    const current = readFileSync14(registration.path);
+    const current = readFileSync16(registration.path);
     if (current.equals(registration.contents))
-      rmSync7(registration.path, { force: true });
+      rmSync8(registration.path, { force: true });
   } catch {
   }
 }
-function errorMessage(error) {
+function errorMessage2(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
@@ -16816,7 +17131,7 @@ function createWingmanServer(options) {
   const runtime = { anatomy: null };
   return createServer({ requireHostHeader: false }, (req, res) => {
     handle(req, res, options, warn, runtime).catch((error) => {
-      warn(`[wingman] \u8BF7\u6C42\u5904\u7406\u5931\u8D25:${errorMessage2(error)}`);
+      warn(`[wingman] \u8BF7\u6C42\u5904\u7406\u5931\u8D25:${errorMessage3(error)}`);
       if (!res.headersSent)
         sendText2(res, 500, "internal error");
       else
@@ -16891,6 +17206,10 @@ async function handle(req, res, options, warn, runtime) {
     await handleActionApply(req, res, options, runtime);
     return;
   }
+  if (url.pathname === "/api/task-overlay" && req.method === "POST") {
+    await handleTaskOverlay(req, res, options);
+    return;
+  }
   if (url.pathname === "/api/license/install" && req.method === "POST") {
     await handleLicenseInstall(req, res, options);
     return;
@@ -16955,6 +17274,10 @@ async function handle(req, res, options, warn, runtime) {
     res.end(JSON.stringify(configs));
     return;
   }
+  if (url.pathname === "/api/version") {
+    sendJson2(res, 200, { version: wingmanVersion() ?? null });
+    return;
+  }
   if (url.pathname.startsWith("/api/")) {
     sendText2(res, 404, "not found");
     return;
@@ -17012,7 +17335,7 @@ async function scanAll(harnesses, warn) {
       const detected = await adapter.detect(scanOptions);
       installed = detected.installed;
     } catch (error) {
-      warn(`[wingman] ${harness} detect \u5931\u8D25,\u5DF2\u8DF3\u8FC7:${errorMessage2(error)}`);
+      warn(`[wingman] ${harness} detect \u5931\u8D25,\u5DF2\u8DF3\u8FC7:${errorMessage3(error)}`);
       continue;
     }
     if (!installed)
@@ -17020,7 +17343,7 @@ async function scanAll(harnesses, warn) {
     try {
       configs.push(await scanValidated(adapter, scanOptions));
     } catch (error) {
-      warn(`[wingman] ${harness} \u626B\u63CF\u5931\u8D25,\u964D\u7EA7\u663E\u793A:${errorMessage2(error)}`);
+      warn(`[wingman] ${harness} \u626B\u63CF\u5931\u8D25,\u964D\u7EA7\u663E\u793A:${errorMessage3(error)}`);
       configs.push(degradedScanConfig(harness, error));
     }
   }
@@ -17057,7 +17380,7 @@ function degradedScanConfig(harness, error) {
   };
 }
 function errorSummary(error) {
-  const first = errorMessage2(error).split("\n", 1)[0] ?? "";
+  const first = errorMessage3(error).split("\n", 1)[0] ?? "";
   const scrubbed = first.replace(/(?:[A-Za-z]:)?[\\/][^\s'"()|,;]+/g, "\u2026").trim();
   return scrubbed.length <= 120 ? scrubbed : `${scrubbed.slice(0, 119)}\u2026`;
 }
@@ -17081,7 +17404,7 @@ async function handleActionPlan(req, res, options) {
     const plan = await loaded.adapter.planAction(action, loaded.scanOptions);
     sendJson2(res, 200, plan);
   } catch (error) {
-    sendJson2(res, 400, { error: errorMessage2(error) });
+    sendJson2(res, 400, { error: errorMessage3(error) });
   }
 }
 async function handleActionApply(req, res, options, runtime) {
@@ -17115,8 +17438,32 @@ async function handleActionApply(req, res, options, runtime) {
     }
     sendJson2(res, 200, result4);
   } catch (error) {
-    sendJson2(res, 400, { error: errorMessage2(error) });
+    sendJson2(res, 400, { error: errorMessage3(error) });
+  }
+}
+async function handleTaskOverlay(req, res, options) {
+  if (options.readonlyActions) {
+    sendJson2(res, 403, { error: "fixtures \u6A21\u5F0F\u53EA\u8BFB:\u4E0D\u5199\u4EFB\u52A1\u5361 overlay" });
+    return;
+  }
+  const body = await readJsonBody(req);
+  if (!isTaskOverlayRequest(body)) {
+    sendJson2(res, 400, {
+      error: "\u8BF7\u6C42\u9700\u8981\u5408\u6CD5 harness\u3001\u975E\u7A7A sessionId \u4E0E\u81F3\u5C11\u4E00\u4E2A title/pinned/hidden/accepted \u8865\u4E01\u5B57\u6BB5"
+    });
+    return;
+  }
+  if (options.homeDir === void 0) {
+    sendJson2(res, 500, { error: "\u4EFB\u52A1\u5361 overlay \u7F3A\u5C11 homeDir" });
+    return;
+  }
+  const key = `${body.harness}:${body.sessionId}`;
+  const result4 = patchTaskOverlay(options.homeDir, key, body.patch, /* @__PURE__ */ new Date());
+  if ("unavailable" in result4) {
+    sendJson2(res, 409, { error: result4.unavailable });
+    return;
   }
+  sendJson2(res, 200, { key, entry: result4.entry });
 }
 var LICENSE_BODY_LIMIT = 64 * 1024;
 async function handleLicenseInstall(req, res, options) {
@@ -17198,6 +17545,25 @@ function isToggleRequest(value) {
   const o = value;
   return o.kind === "toggle" && typeof o.itemId === "string" && typeof o.enable === "boolean";
 }
+function isTaskOverlayRequest(value) {
+  if (!isRecord7(value) || !isHarnessId3(value.harness))
+    return false;
+  if (typeof value.sessionId !== "string" || value.sessionId.trim() === "")
+    return false;
+  if (!isRecord7(value.patch))
+    return false;
+  const keys = Object.keys(value.patch);
+  if (keys.length === 0 || keys.some((key) => !["title", "pinned", "hidden", "accepted"].includes(key))) {
+    return false;
+  }
+  return (value.patch.title === void 0 || value.patch.title === null || typeof value.patch.title === "string") && (value.patch.pinned === void 0 || typeof value.patch.pinned === "boolean") && (value.patch.hidden === void 0 || typeof value.patch.hidden === "boolean") && (value.patch.accepted === void 0 || typeof value.patch.accepted === "boolean");
+}
+function isHarnessId3(value) {
+  return typeof value === "string" && HARNESS_IDS.includes(value);
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function readJsonBody(req) {
   return new Promise((resolveBody) => {
     const chunks = [];
@@ -17258,7 +17624,7 @@ function sendText2(res, status3, body) {
   res.writeHead(status3, { "content-type": "text/plain; charset=utf-8" });
   res.end(body);
 }
-function errorMessage2(error) {
+function errorMessage3(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
@@ -17275,12 +17641,18 @@ var HELP = `wingman \u2014 Not your copilot. Your wingman.
                 [--project <dir>] [--dry-run] [--yes]
   wingman license status                              \u67E5\u770B\u8BA2\u9605\u72B6\u6001(\u5199\u52A8\u4F5C\u7684\u95F8)
   wingman license refresh                             \u8054\u7F51\u5411\u7B7E\u53D1\u7AEF\u6362\u65B0 license(\u7EED\u671F)
+  wingman --version | -v | version                    \u663E\u793A\u7248\u672C
   wingman help                                        \u663E\u793A\u672C\u5E2E\u52A9
 `;
 var UsageError = class extends Error {
 };
 async function main(argv) {
   const [command, ...rest] = argv;
+  if (command === "--version" || command === "-v" || command === "version") {
+    process.stdout.write(`${wingmanVersion() ?? "unknown"}
+`);
+    return 0;
+  }
   switch (command) {
     case void 0:
     case "help":
@@ -17346,6 +17718,7 @@ ${counts}
 }
 async function runServe(args) {
   const { port, fixtures, panelDist } = parseServeArgs(args);
+  const homeDir = fixtures ? fixturesRoot : homedir13();
   const hookToken = createHookToken();
   const harnesses = [];
   for (const id of HARNESS_IDS) {
@@ -17357,10 +17730,10 @@ async function runServe(args) {
 `);
     }
   }
-  const panelDistDir = panelDist === void 0 ? resolve11(dirname16(fileURLToPath2(import.meta.url)), "../../panel/dist") : resolve11(panelDist);
+  const panelDistDir = panelDist === void 0 ? resolve11(dirname17(fileURLToPath2(import.meta.url)), "../../panel/dist") : resolve11(panelDist);
   const narrative = createNarrativeService({
     followTranscripts: !fixtures,
-    homeDir: fixtures ? fixturesRoot : homedir13(),
+    homeDir,
     ...fixtures ? { projectBoundaryDir: fixturesRoot } : {},
     feedbackSignals: (harness) => {
       const loaded = harnesses.find((candidate) => candidate.harness === harness);
@@ -17369,7 +17742,7 @@ async function runServe(args) {
   });
   if (fixtures) {
     try {
-      const raw = readFileSync15(fixturePath("cc", "sessions", "session-todos.jsonl"), "utf8");
+      const raw = readFileSync17(fixturePath("cc", "sessions", "session-todos.jsonl"), "utf8");
       narrative.seedFixture("cc", raw.split("\n"), "MOCK \u2014 fixtures \u6F14\u793A:\u53D9\u4E8B\u6570\u636E\u6765\u81EA packages/fixtures \u7684 session-todos.jsonl \u6837\u4F8B\u4F1A\u8BDD,\u975E\u672C\u673A\u771F\u5B9E transcript\u3002");
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -17382,6 +17755,7 @@ async function runServe(args) {
     panelDistDir,
     receiver: createReceiver({ onEvent: narrative.handleEvent }),
     readonlyActions: fixtures,
+    homeDir,
     narrative,
     hookToken
   });
@@ -17412,7 +17786,7 @@ async function runHook(args) {
   if (action !== "install" && action !== "uninstall" || harness === void 0) {
     throw new UsageError("hook \u7528\u6CD5:wingman hook install|uninstall <cc|codex|dsh> [--port 7333]");
   }
-  if (!isHarnessId3(harness)) {
+  if (!isHarnessId4(harness)) {
     throw new UsageError(`hook \u9700\u8981 harness \u2208 ${HARNESS_IDS.join("|")},\u5F97\u5230 ${harness}`);
   }
   let port = 7333;
@@ -17455,7 +17829,7 @@ function parseScanArgs(args) {
       json = true;
     } else if (arg === "--harness") {
       const value = rest.shift();
-      if (value === void 0 || !isHarnessId3(value)) {
+      if (value === void 0 || !isHarnessId4(value)) {
         throw new UsageError(`--harness \u9700\u8981 ${HARNESS_IDS.join("|")},\u5F97\u5230 ${value ?? "(\u7F3A\u53C2)"}`);
       }
       harness = value;
@@ -17493,7 +17867,7 @@ function parseServeArgs(args) {
   }
   return { port, fixtures, panelDist };
 }
-function isHarnessId3(value) {
+function isHarnessId4(value) {
   return HARNESS_IDS.includes(value);
 }
 main(process.argv.slice(2)).then((code) => {