@kw-yeh/vibeflow 4.11.36 → 4.11.39

package/dist/vibeflow.mjs

@@ -168,8 +168,8 @@ function shellArgs(shell, command) {
   const isPosixShell = process.platform !== "win32" || shell.toLowerCase().endsWith("bash.exe");
   if (isPosixShell) return command ? ["-lic", command] : ["-l"];
   if (command) {
-    const message = GIT_BASH_MISSING_MESSAGE.replace(/'/g, "''");
-    return ["-NoProfile", "-NonInteractive", "-Command", `Write-Host '${message}' -ForegroundColor Yellow; exit 1`];
+    const message2 = GIT_BASH_MISSING_MESSAGE.replace(/'/g, "''");
+    return ["-NoProfile", "-NonInteractive", "-Command", `Write-Host '${message2}' -ForegroundColor Yellow; exit 1`];
   }
   return ["-NoProfile"];
 }
@@ -637,7 +637,8 @@ function masterSystemPrompt(opts) {
     "1. \u5224\u65B7\uFF1A\u4E00\u5F35\u5361\u505A\u5F97\u5B8C\u5C31\u53EA\u5EFA\u4E00\u5F35\uFF1B\u6D89\u53CA\u591A\u500B repo \u6216\u53EF\u5E73\u884C\u7684\u7368\u7ACB\u5DE5\u4F5C\u624D\u62C6\u6210\u591A\u5F35\u3002\u6BCF\u5F35\u53EA\u52D5\u4E00\u500B repo\uFF0C\u5404\u81EA\u80FD\u7368\u7ACB\u9A57\u6536\u3002",
     '2. \u6D3E\u5DE5\uFF1AVF task create --store-path "$VIBEFLOW_STORE_DIR" --master "$VIBEFLOW_TASK_ID" --project <repo \u7D55\u5C0D\u8DEF\u5F91> --title <\u6A19\u984C> --prompt <\u5167\u5BB9>',
     "   prompt \u5FC5\u9808\u81EA\u5305\u542B\uFF1A\u80CC\u666F\u3001\u7BC4\u570D\u3001\u9A57\u6536\u689D\u4EF6\u3001\u8207\u5176\u4ED6\u5361\u7684\u4ECB\u9762\u7D04\u5B9A\u2014\u2014slave \u770B\u4E0D\u5230\u4F60\u7684\u5C0D\u8A71\u3002",
-    "   \u9700\u8981\u6642\u53EF\u52A0 --agent / --model / --effort / --base-branch\u3002"
+    "   \u6A19\u984C\u8981\u77ED\u3001\u5F7C\u6B64\u4E00\u773C\u5206\u5F97\u51FA\u4F86\uFF1A\u4EE5\u9019\u5F35\u5361\u8CA0\u8CAC\u7684\u90E8\u5206\u958B\u982D\uFF08\u4F8B\u5982\u300C\u5F8C\u7AEF\uFF1A\u2026\u300D\u300C\u9A57\u6536\uFF1A\u2026\u300D\uFF09\uFF0C\u4E0D\u8981\u8B93\u591A\u5F35\u5361\u5171\u7528\u540C\u4E00\u6BB5\u958B\u982D\u3002",
+    "   \u9810\u8A2D\u4E0D\u8981\u52A0 --model / --effort\uFF1A\u6C92\u6307\u5B9A\u6642 Jev \u6703\u4F9D\u4EFB\u52D9\u8907\u96DC\u5EA6\u6311\u6A21\u578B\u8207 effort\uFF1B\u53EA\u6709\u4EFB\u52D9\u660E\u78BA\u9700\u8981\u7279\u5B9A\u6A21\u578B\u6216 effort \u6642\u624D\u6307\u5B9A\u3002\u9700\u8981\u6642\u53EF\u52A0 --agent / --base-branch\u3002"
   );
   lines.push(
     opts.autoMode ? '3. \u555F\u52D5\uFF1A\u6C92\u6709\u524D\u7F6E\u4F9D\u8CF4\u7684\u5361\u76F4\u63A5 VF task start --store-path "$VIBEFLOW_STORE_DIR" --task <id>\uFF1B\u6709\u4F9D\u8CF4\u7684\u5148\u7559\u5728 Backlog\uFF0C\u524D\u7F6E\u5361\u5B8C\u6210\u5F8C\u518D\u555F\u52D5\u3002' : "3. \u555F\u52D5\uFF1A\u4E0D\u8981\u81EA\u5DF1\u555F\u52D5\u5361\u7247\u3002\u5217\u51FA\u4F60\u5EFA\u4E86\u54EA\u4E9B\u5361\u3001\u5EFA\u8B70\u7684\u555F\u52D5\u9806\u5E8F\uFF0C\u7B49\u4F7F\u7528\u8005\u5728 VibeFlow \u6309\u958B\u59CB\u3002"
@@ -649,16 +650,21 @@ function masterSystemPrompt(opts) {
     "   \u9700\u8981\u7368\u7ACB\u9A57\u6536\u6642\u53E6\u958B\u4E00\u5F35\u9A57\u6536\u5361\u3002\u9A57\u6536\u56DE\u5831\u554F\u984C\u6642\uFF0C\u628A\u5177\u9AD4\u554F\u984C\u8207\u91CD\u73FE\u6B65\u9A5F\u6574\u7406\u597D\u8F49\u7D66\u8CA0\u8CAC\u958B\u767C\u7684\u5361\u4FEE\u6B63\uFF0C\u4FEE\u5B8C\u518D\u8ACB\u9A57\u6536\u5361\u8907\u9A57\uFF0C\u76F4\u5230\u901A\u904E\u3002",
     "   task send \u56DE TARGET_BLOCKED \u4EE3\u8868\u5C0D\u65B9\u5361\u5728\u6B0A\u9650\u78BA\u8A8D\uFF0C\u8ACB\u4F7F\u7528\u8005\u5230\u90A3\u5F35\u5361\u8655\u7406\u3002",
     "6. PR\uFF1A\u9A57\u6536\u901A\u904E\u5F8C\uFF0C\u4EA4\u4EE3\u958B\u767C\u5361\u7528 pr skill \u958B PR\uFF08\u74B0\u5883\u88E1\u6C92\u6709\u9019\u500B skill \u5C31\u7528 gh pr create\uFF09\uFF0C\u4E26\u56DE\u5831 PR \u9023\u7D50\u7D66\u4F60\u3002",
-    "7. \u4F7F\u7528\u8005\u4E3B\u8981\u53EA\u8DDF\u4F60\u6E9D\u901A\uFF1A\u4E3B\u52D5\u5411\u4F7F\u7528\u8005\u56DE\u5831\u6574\u9AD4\u9032\u5EA6\u8207\u9700\u8981\u4F7F\u7528\u8005\u6C7A\u5B9A\u7684\u4E8B\u3002\u4F60\u4E0D\u6703\u628A\u5361\u7247\u79FB\u5230 Done\u3001\u4E0D\u6703\u5408\u4F75 PR\uFF1B\u5168\u90E8\u5B8C\u6210\u5F8C\u6574\u7406\u6BCF\u5F35\u5361\u7684\u7D50\u679C\u8207 PR \u9023\u7D50\uFF0C\u4EA4\u7D66\u4F7F\u7528\u8005\u505A\u6700\u5F8C\u78BA\u8A8D\u3002"
+    "7. \u4F7F\u7528\u8005\u4E3B\u8981\u53EA\u8DDF\u4F60\u6E9D\u901A\uFF1A\u4E3B\u52D5\u5411\u4F7F\u7528\u8005\u56DE\u5831\u6574\u9AD4\u9032\u5EA6\u8207\u9700\u8981\u4F7F\u7528\u8005\u6C7A\u5B9A\u7684\u4E8B\u3002\u4F60\u4E0D\u6703\u628A\u5361\u7247\u79FB\u5230 Done\u3001\u4E0D\u6703\u5408\u4F75 PR\uFF1B\u5168\u90E8\u5B8C\u6210\u5F8C\u6574\u7406\u6BCF\u5F35\u5361\u7684\u7D50\u679C\u8207 PR \u9023\u7D50\uFF0C\u4EA4\u7D66\u4F7F\u7528\u8005\u505A\u6700\u5F8C\u78BA\u8A8D\u3002",
+    "   \u8DDF\u4F7F\u7528\u8005\u63D0\u5230\u4EFB\u4F55\u4E00\u5F35\u5361\u6642\uFF0C\u4E00\u5F8B\u5BEB\u6210 <id>\u300C<\u6A19\u984C>\u300D\u2014\u2014\u5361\u7247\u4E0A\u770B\u5F97\u5230 id\uFF0C\u4F7F\u7528\u8005\u9760\u5B83\u5C0D\u4E0A\u662F\u54EA\u4E00\u5F35\u3002"
   );
   return lines.join("\n");
 }
-function buildPrompt(task) {
+function buildPrompt(task, preface) {
   const lines = [`\u4EFB\u52D9\u6A19\u984C\uFF1A${task.title}`];
   const description = task.description?.trim();
   if (description) {
     lines.push("", "\u4EFB\u52D9\u63CF\u8FF0\uFF1A", description);
   }
+  const context = preface?.context.trim();
+  if (preface && context) {
+    lines.push("", `\u524D\u7F6E\u5206\u6790\uFF08${preface.model}\uFF0C\u50C5\u4F9B\u53C3\u8003\uFF09\uFF1A`, context);
+  }
   return lines.join("\n");
 }
 function executorSessionId(taskId, runId) {
@@ -716,9 +722,9 @@ function buildAgentCommand(task, systemPrompt, opts, workspacePath) {
   const custom = resolveSystemPrompt(systemPrompt);
   const canWrite = Boolean(opts?.boardCli?.cliPath);
   const role = task.role === "master" ? masterSystemPrompt({ canWrite, autoMode: opts?.autoMode === true }) : task.masterId ? slaveSystemPrompt({ canWrite }) : null;
-  const sys = role ? [custom, role].filter(Boolean).join("\n\n") : custom;
+  const sys = task.masterId && task.role !== "master" ? role ?? "" : role ? [custom, role].filter(Boolean).join("\n\n") : custom;
   const includeTaskPrompt = opts?.includeTaskPrompt !== false;
-  const prompt = includeTaskPrompt && !opts?.resume ? buildPrompt(task) : "";
+  const prompt = includeTaskPrompt && !opts?.resume ? buildPrompt(task, opts?.preface) : "";
   const sessionId = agent === "claude" && includeTaskPrompt ? executorSessionId(task.id, task.runId) : void 0;
   return boardEnvPrefix(task, opts, workspacePath) + assembleCommand(
     agent,
@@ -984,13 +990,13 @@ function reduceClaudeLine(state, line) {
   if (!entry) return state;
   const at = parseTime(entry.timestamp);
   const next = { ...state, startedAt: state.startedAt ?? at };
-  const message = entry.message;
-  const content = Array.isArray(message?.content) ? message.content : [];
-  if (entry.type === "assistant" && message) {
-    const usage = message.usage;
-    if (usage && typeof message.id === "string") {
+  const message2 = entry.message;
+  const content = Array.isArray(message2?.content) ? message2.content : [];
+  if (entry.type === "assistant" && message2) {
+    const usage = message2.usage;
+    if (usage && typeof message2.id === "string") {
       const u = claudeUsage(usage);
-      next.usageById = { ...state.usageById, [message.id]: u };
+      next.usageById = { ...state.usageById, [message2.id]: u };
       next.contextTokens = u.input + u.cacheRead + u.cacheWrite;
     }
     let tool;
@@ -1006,11 +1012,11 @@ function reduceClaudeLine(state, line) {
       }
     }
     if (tool) next.activity = { state: "working", tool, at };
-    else if (message.stop_reason === "end_turn") next.activity = { state: "waiting", waitingFor: "input", at };
+    else if (message2.stop_reason === "end_turn") next.activity = { state: "waiting", waitingFor: "input", at };
     else next.activity = { state: "working", at };
     return next;
   }
-  if (entry.type === "user" && message) {
+  if (entry.type === "user" && message2) {
     const result = entry.toolUseResult && typeof entry.toolUseResult === "object" ? entry.toolUseResult : void 0;
     let pending = next.pendingTasks;
     for (const block of content) {
@@ -1340,7 +1346,7 @@ function FormView({ api, ctx, initial, initialFocus, initialMessage, pristine, o
   const [focus, setFocus] = useState(initialFocus);
   const [editing, setEditing] = useState(null);
   const [draft, setDraft] = useState("");
-  const [message, setMessage] = useState(initialMessage ?? "");
+  const [message2, setMessage] = useState(initialMessage ?? "");
   const [busy, setBusy] = useState(null);
   const [loadingGit, setLoadingGit] = useState(false);
   const [confirmLeave, setConfirmLeave] = useState(false);
@@ -1559,7 +1565,7 @@ function FormView({ api, ctx, initial, initialFocus, initialMessage, pristine, o
       )
     ),
     extra ? h(Text, { dimColor: true }, `  ${extra}`) : null,
-    confirmLeave ? h(Text, { color: "yellow" }, "\u6709\u672A\u5132\u5B58\u7684\u8B8A\u66F4\uFF0C\u78BA\u5B9A\u8981\u96E2\u958B\uFF1F\uFF08y/n\uFF09") : message ? h(Text, { color: "yellow" }, message) : h(Text, { dimColor: true }, hint)
+    confirmLeave ? h(Text, { color: "yellow" }, "\u6709\u672A\u5132\u5B58\u7684\u8B8A\u66F4\uFF0C\u78BA\u5B9A\u8981\u96E2\u958B\uFF1F\uFF08y/n\uFF09") : message2 ? h(Text, { color: "yellow" }, message2) : h(Text, { dimColor: true }, hint)
   );
 }
 function showForm(api, ctx, initial, pristine, initialFocus = 0, initialMessage) {
@@ -1700,7 +1706,7 @@ function BoardView({ opts, initial, initialMessage, onAction }) {
   const [sel, setSel] = useState2(initial);
   const [running, setRunning] = useState2(/* @__PURE__ */ new Set());
   const [backend, setBackend] = useState2("pty");
-  const [message, setMessage] = useState2(initialMessage ?? "");
+  const [message2, setMessage] = useState2(initialMessage ?? "");
   const [confirm, setConfirm] = useState2(null);
   const [help, setHelp] = useState2(false);
   const [progress, setProgress] = useState2({});
@@ -1911,7 +1917,7 @@ function BoardView({ opts, initial, initialMessage, onAction }) {
     Box2,
     { flexDirection: "column" },
     h2(Box2, { flexDirection: "row" }, ...columns),
-    confirm ? h2(Text2, { color: "yellow" }, confirm.prompt) : message ? h2(Text2, { color: "yellow" }, message) : h2(
+    confirm ? h2(Text2, { color: "yellow" }, confirm.prompt) : message2 ? h2(Text2, { color: "yellow" }, message2) : h2(
       Text2,
       { dimColor: true },
       `h/l \u5207\u6B04 \xB7 j/k \u9078\u5361 \xB7 H/L \u79FB\u52D5 \xB7 Enter \u7D42\u7AEF \xB7 n \u65B0\u589E \xB7 e \u7DE8\u8F2F \xB7 d diff \xB7 w Web \xB7 ? \u8AAA\u660E \xB7 q \u96E2\u958B   [${backend}]`
@@ -2035,24 +2041,24 @@ async function runForm(opts, action) {
 }
 async function runTui(opts) {
   let sel = { column: 1, index: 0 };
-  let message;
+  let message2;
   for (; ; ) {
-    const result = await showBoard(opts, sel, message);
+    const result = await showBoard(opts, sel, message2);
     sel = result.sel;
-    message = void 0;
+    message2 = void 0;
     const { action } = result;
     if (action.type === "quit") return;
     try {
-      if (action.type === "attach") message = await openTerminal(opts, action.task);
+      if (action.type === "attach") message2 = await openTerminal(opts, action.task);
       else if (action.type === "diff") showDiff(action.task);
       else {
         process.stdout.write(CLEAR_SCREEN);
         const done = await runForm(opts, action);
-        message = done.message;
+        message2 = done.message;
         if (done.sel) sel = done.sel;
       }
     } catch (err) {
-      message = `\u5931\u6557\uFF1A${err.message}`;
+      message2 = `\u5931\u6557\uFF1A${err.message}`;
     }
     process.stdout.write(CLEAR_SCREEN);
   }
@@ -2650,7 +2656,7 @@ function createBridge(t) {
     restoreBuiltinSkill: (payload) => t.invoke("library:restoreBuiltin", payload),
     /** Shipped skills the user deleted, offered for restore. */
     listRemovedBuiltinSkills: () => t.invoke("library:removedBuiltins"),
-    approve: (taskId, message) => t.invoke("git:approve", { taskId, message }),
+    approve: (taskId, message2) => t.invoke("git:approve", { taskId, message: message2 }),
     /** Use the task's agent CLI to generate a commit message for branch changes. */
     generateCommitMessage: (taskId) => t.invoke("git:generateCommitMessage", taskId),
     /** Check whether a PR exists for the task's branch. */
@@ -4231,11 +4237,11 @@ async function getWorktreeDiff(worktreePath, baseBranch) {
   }
   return files;
 }
-async function commitAndPush(worktreePath, message) {
+async function commitAndPush(worktreePath, message2) {
   await git(worktreePath, ["add", "-A"]);
   let committed = false;
   try {
-    await git(worktreePath, ["commit", "-m", message]);
+    await git(worktreePath, ["commit", "-m", message2]);
     committed = true;
   } catch {
     committed = false;
@@ -4247,7 +4253,7 @@ async function commitAndPush(worktreePath, message) {
   } catch {
     pushed = false;
   }
-  return { committed, pushed, message };
+  return { committed, pushed, message: message2 };
 }
 var MAX_OUTCOME_COMMITS = 50;
 var OUTCOME_LOG_FORMAT = "%h%x00%s";
@@ -4451,8 +4457,8 @@ init_attachments();
 function mastersRoot(storeFile) {
   return path13.join(path13.dirname(storeFile), "masters");
 }
-function taskError(message, code2) {
-  return Object.assign(new Error(message), { code: code2 });
+function taskError(message2, code2) {
+  return Object.assign(new Error(message2), { code: code2 });
 }
 function assertMasterRef(board, masterId, taskId) {
   const master = Object.values(board).flat().find((t) => t.id === masterId);
@@ -4731,8 +4737,8 @@ function createWsTransport(options) {
   function dispatch(channel, payload) {
     for (const cb of Array.from(listeners.get(channel) ?? [])) cb(payload);
   }
-  function post(message) {
-    const data = JSON.stringify(message);
+  function post(message2) {
+    const data = JSON.stringify(message2);
     if (socket && socket.readyState === OPEN) socket.send(data);
     else queue.push(data);
   }
@@ -4870,13 +4876,13 @@ Examples:
 `.trim();
 var CliFailure = class extends Error {
   code;
-  constructor(code2, message) {
-    super(message);
+  constructor(code2, message2) {
+    super(message2);
     this.code = code2;
   }
 };
-function fail(code2, message) {
-  throw new CliFailure(code2, message);
+function fail(code2, message2) {
+  throw new CliFailure(code2, message2);
 }
 function requireOneOf(flag, value, allowed) {
   if (value !== void 0 && !allowed.includes(value)) {
@@ -5615,10 +5621,10 @@ function spawnJsonLines(bin, args, opts) {
     failure = err;
     for (const w of waiters.splice(0)) w.reject(err);
   };
-  const deliver = (message) => {
-    const i = waiters.findIndex((w) => w.match(message));
-    if (i === -1) inbox.push(message);
-    else waiters.splice(i, 1)[0].resolve(message);
+  const deliver = (message2) => {
+    const i = waiters.findIndex((w) => w.match(message2));
+    if (i === -1) inbox.push(message2);
+    else waiters.splice(i, 1)[0].resolve(message2);
   };
   let buffered = "";
   proc.stdout.setEncoding("utf8");
@@ -5629,13 +5635,13 @@ function spawnJsonLines(bin, args, opts) {
       const line = buffered.slice(0, nl).trim();
       buffered = buffered.slice(nl + 1);
       if (!line) continue;
-      let message;
+      let message2;
       try {
-        message = JSON.parse(line);
+        message2 = JSON.parse(line);
       } catch {
         continue;
       }
-      deliver(message);
+      deliver(message2);
     }
   });
   proc.stderr.setEncoding("utf8");
@@ -5672,8 +5678,8 @@ function spawnJsonLines(bin, args, opts) {
   }, opts.timeoutMs);
   let graceTimer;
   return {
-    send(message) {
-      if (!failure) proc.stdin.write(`${JSON.stringify(message)}
+    send(message2) {
+      if (!failure) proc.stdin.write(`${JSON.stringify(message2)}
 `);
     },
     next(match) {
@@ -5706,11 +5712,11 @@ function openClaude() {
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function isOurResponse(message) {
-  return isRecord(message) && message.type === "control_response" && isRecord(message.response) && message.response.request_id === REQUEST_ID;
+function isOurResponse(message2) {
+  return isRecord(message2) && message2.type === "control_response" && isRecord(message2.response) && message2.response.request_id === REQUEST_ID;
 }
-function parseClaudeInitialize(message) {
-  const outer = isRecord(message) && isRecord(message.response) ? message.response : null;
+function parseClaudeInitialize(message2) {
+  const outer = isRecord(message2) && isRecord(message2.response) ? message2.response : null;
   if (outer?.subtype === "error") throw new Error(`claude refused the handshake: ${String(outer.error ?? "unknown error")}`);
   const body = outer && isRecord(outer.response) ? outer.response : null;
   if (!body || !Array.isArray(body.models)) throw new Error("claude handshake has no models array");
@@ -5771,12 +5777,12 @@ function openCodex() {
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var responseTo = (id) => (message) => isRecord2(message) && message.id === id && ("result" in message || "error" in message);
-function resultOf(message, method) {
-  if (!isRecord2(message)) throw new Error(`codex ${method}: malformed response`);
-  if (isRecord2(message.error)) throw new Error(`codex ${method}: ${String(message.error.message ?? "request failed")}`);
-  if (!isRecord2(message.result)) throw new Error(`codex ${method}: response has no result`);
-  return message.result;
+var responseTo = (id) => (message2) => isRecord2(message2) && message2.id === id && ("result" in message2 || "error" in message2);
+function resultOf(message2, method) {
+  if (!isRecord2(message2)) throw new Error(`codex ${method}: malformed response`);
+  if (isRecord2(message2.error)) throw new Error(`codex ${method}: ${String(message2.error.message ?? "request failed")}`);
+  if (!isRecord2(message2.result)) throw new Error(`codex ${method}: response has no result`);
+  return message2.result;
 }
 function isCodexSignedIn(result) {
   return result.account != null || result.requiresOpenaiAuth === false;
@@ -5939,53 +5945,175 @@ init_effort();
 init_launch();
 var API_URL = "https://api.typesafe.ai/v1/systemone";
 var MAX_TASK_CHARS = 12e3;
+var MAX_CONTEXT_CHARS = 8e3;
+var SCOUT_TIMEOUT_MS = 5 * 6e4;
+var SAFE_MODEL_ID = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+function tier(model, agent) {
+  const name = `${model.id} ${model.label}`.toLowerCase();
+  if (/haiku|mini|nano|luna|flash/.test(name)) return 0;
+  if (/opus|fable|astra|pro\b/.test(name)) return 2;
+  if (agent === "codex" && /gpt-5\.5|gpt-5\.4(?!-mini)/.test(name)) return 2;
+  return 1;
+}
+var TIER_LABELS = ["lowest cost", "balanced", "highest capability"];
+function routeCandidates(agent, models) {
+  const byTier = /* @__PURE__ */ new Map();
+  for (const model of models) {
+    if (!SAFE_MODEL_ID.test(model.id) || model.id === "default") continue;
+    const rank = tier(model, agent);
+    if (!byTier.has(rank)) byTier.set(rank, model);
+  }
+  return [...byTier.entries()].sort(([a], [b]) => a - b).map(([, model]) => model);
+}
+function isChoice(value) {
+  return !!value && typeof value === "object" && value.type === "choice" && typeof value.choice === "string";
+}
+var defaultScout = (agent, model, effort, prompt, cwd) => {
+  const args = agent === "claude" ? ["-p", "--model", model, "--permission-mode", "plan", ...effort ? ["--effort", effort] : []] : [
+    "exec",
+    "--model",
+    model,
+    ...effort ? ["-c", `model_reasoning_effort=${effort}`] : [],
+    "--sandbox",
+    "read-only",
+    "--skip-git-repo-check",
+    "-"
+  ];
+  return runAgentPrint(agent, args, prompt, { cwd, timeout: SCOUT_TIMEOUT_MS, maxBuffer: 128 * 1024 });
+};
 function createJevRouter(opts = {}) {
   const getApiKey = opts.getApiKey ?? (() => opts.apiKey ?? process.env.TYPESAFE_API_KEY?.trim());
   const fetcher = opts.fetcher ?? fetch;
+  const scout = opts.scout ?? defaultScout;
+  async function ask(state, questions) {
+    const apiKey = getApiKey();
+    if (!apiKey) throw new Error("\u672A\u8A2D\u5B9A Jev API key\uFF08\u53EF\u5728\u8A2D\u5B9A\u4E2D\u8F38\u5165\u6216\u63D0\u4F9B TYPESAFE_API_KEY\uFF09");
+    const response = await fetcher(API_URL, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+      body: JSON.stringify({ model: "jev-latest", state, questions }),
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (response.status === 402 || response.status === 429) {
+      throw new Error(`Jev \u984D\u5EA6\u5DF2\u7528\u5B8C\u6216\u8ACB\u6C42\u904E\u591A\uFF08HTTP ${response.status}\uFF09\uFF0C\u6539\u7528 CLI \u76EE\u524D\u7684\u6A21\u578B`);
+    }
+    if (!response.ok) throw new Error(`Jev API \u56DE\u61C9 ${response.status}`);
+    const body = await response.json();
+    if (!body.answers) throw new Error("Jev API \u6C92\u6709\u56DE\u50B3\u5224\u65B7");
+    return body.answers;
+  }
+  async function routeEffort(task, catalog) {
+    const model = modelFor(catalog, taskModel(task));
+    const levels = selectableEfforts(model);
+    if (levels.length === 0) return { status: "fallback", reason: "\u76EE\u524D\u6A21\u578B\u4E0D\u652F\u63F4\u8ABF\u6574 effort" };
+    try {
+      const answers = await ask({
+        task: buildPrompt(task).slice(0, MAX_TASK_CHARS),
+        agent: taskAgent(task),
+        currentModel: model?.id ?? taskModel(task) ?? "CLI default (catalog unavailable)"
+      }, { effort: effortQuestion(levels) });
+      const choice = answers.effort;
+      if (!isChoice(choice) || !levels.includes(choice.choice)) {
+        throw new Error("Jev \u9078\u4E86\u76EE\u524D\u6A21\u578B\u4E0D\u652F\u63F4\u7684 effort");
+      }
+      return { status: "routed", effort: choice.choice };
+    } catch (err) {
+      return { status: "fallback", reason: message(err) };
+    }
+  }
+  async function routeModel(task, catalog, ro) {
+    const agent = taskAgent(task);
+    const candidates = routeCandidates(agent, catalog);
+    if (candidates.length === 0) return { status: "fallback", reason: "\u6A21\u578B\u6E05\u55AE\u6C92\u6709\u53EF\u7528\u7684\u6A21\u578B" };
+    const chooseEffort = task.effort === "auto";
+    const strongest = candidates[candidates.length - 1];
+    const levels = MANUAL_EFFORTS.filter((level) => candidates.some((m) => selectableEfforts(m).includes(level)));
+    const taskText = buildPrompt(task).slice(0, MAX_TASK_CHARS);
+    const modelQuestion = {
+      type: "choice",
+      instructions: "Choose the lowest-cost available model likely to implement this software task correctly. Prefer more capable models as complexity, ambiguity or risk rises.",
+      criteria: Object.fromEntries(candidates.map((m) => [m.id, `${m.label}; ${TIER_LABELS[tier(m, agent)]}`]))
+    };
+    const questions = (withUnclear) => ({
+      complexity: {
+        type: "choice",
+        instructions: "How difficult is this software task to implement correctly?",
+        criteria: {
+          simple: "Small, well scoped and routine",
+          moderate: "Some design choices or multiple files",
+          complex: "Architecture, ambiguous requirements, high risk, or many interacting parts",
+          ...withUnclear ? { unclear: "Cannot be judged from the description alone; the repository must be read first" } : {}
+        }
+      },
+      model: modelQuestion,
+      ...chooseEffort && levels.length > 0 ? { effort: effortQuestion(levels) } : {}
+    });
+    const decide = (answers, extra) => {
+      const model = candidates.find((m) => isChoice(answers.model) && m.id === answers.model.choice);
+      if (!model) throw new Error("Jev \u9078\u4E86\u4E0D\u5728\u6A21\u578B\u6E05\u55AE\u4E2D\u7684\u6A21\u578B");
+      let effort;
+      if (chooseEffort && levels.length > 0) {
+        const choice = answers.effort;
+        if (!isChoice(choice) || !levels.includes(choice.choice)) throw new Error("Jev \u56DE\u50B3\u4E0D\u53D7\u652F\u63F4\u7684 effort");
+        effort = clampEffort(choice.choice, selectableEfforts(model));
+      }
+      return { status: "routed", model: model.id, ...effort ? { effort } : {}, ...extra };
+    };
+    const conservative = (extra) => {
+      const effort = chooseEffort ? clampEffort("high", selectableEfforts(strongest)) : void 0;
+      return { model: strongest.id, ...effort ? { effort } : {}, ...extra };
+    };
+    let first;
+    let complexity;
+    try {
+      ro.onPhase?.("judging");
+      first = await ask({ task: taskText, agent }, questions(true));
+      const c = first.complexity;
+      if (!isChoice(c) || !["simple", "moderate", "complex", "unclear"].includes(c.choice)) throw new Error("Jev \u56DE\u50B3\u4E0D\u53D7\u652F\u63F4\u7684\u8907\u96DC\u5EA6");
+      complexity = c.choice;
+      if (complexity !== "unclear") return decide(first, { complexity });
+    } catch (err) {
+      return { status: "fallback", reason: message(err) };
+    }
+    if (ro.scout === false) return conservative({ status: "routed", complexity });
+    let context;
+    try {
+      if (!ro.cwd) throw new Error("\u88DC\u5145 context \u6642\u627E\u4E0D\u5230 worktree");
+      ro.onPhase?.("scouting");
+      const scoutEffort = clampEffort("high", selectableEfforts(strongest));
+      const instruction = "Read the repository to prepare the following software task. Do not edit any file. Report concisely: the affected areas and files, requirements that are unclear, the main risks, and how to verify the work. Return only the analysis.\n\n" + taskText;
+      context = (await scout(agent, strongest.id, scoutEffort, instruction, ro.cwd)).trim().slice(0, MAX_CONTEXT_CHARS);
+      if (!context) throw new Error("\u88DC\u5145 context \u7684\u6A21\u578B\u6C92\u6709\u56DE\u50B3\u5206\u6790");
+    } catch (err) {
+      return conservative({ status: "fallback", complexity, reason: message(err) });
+    }
+    try {
+      ro.onPhase?.("selecting");
+      const second = await ask({ task: taskText, agent, context }, questions(false));
+      return decide(second, { complexity, scoutModel: strongest.id, context });
+    } catch (err) {
+      return { status: "fallback", complexity, reason: message(err), scoutModel: strongest.id, context };
+    }
+  }
   return {
     get enabled() {
       return Boolean(getApiKey());
     },
-    async route(task, catalog) {
-      const model = modelFor(catalog, taskModel(task));
-      const levels = selectableEfforts(model);
-      if (levels.length === 0) return { status: "fallback", reason: "\u76EE\u524D\u6A21\u578B\u4E0D\u652F\u63F4\u8ABF\u6574 effort" };
-      try {
-        const apiKey = getApiKey();
-        if (!apiKey) throw new Error("\u672A\u8A2D\u5B9A Jev API key\uFF08\u53EF\u5728\u8A2D\u5B9A\u4E2D\u8F38\u5165\u6216\u63D0\u4F9B TYPESAFE_API_KEY\uFF09");
-        const response = await fetcher(API_URL, {
-          method: "POST",
-          headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
-          body: JSON.stringify({
-            model: "jev-latest",
-            state: {
-              task: buildPrompt(task).slice(0, MAX_TASK_CHARS),
-              agent: task.agentCli === "codex" ? "codex" : "claude",
-              currentModel: model?.id ?? taskModel(task) ?? "CLI default (catalog unavailable)"
-            },
-            questions: {
-              effort: {
-                type: "choice",
-                instructions: "Choose the lowest reasoning effort likely to complete this software task correctly on the current model. Increase effort for complexity, ambiguity, or risk.",
-                criteria: Object.fromEntries(levels.map((level) => [level, effortDescription(level)]))
-              }
-            }
-          }),
-          signal: AbortSignal.timeout(15e3)
-        });
-        if (!response.ok) throw new Error(`Jev API \u56DE\u61C9 ${response.status}`);
-        const body = await response.json();
-        const choice = body.answers?.effort;
-        if (choice?.type !== "choice" || !levels.includes(choice.choice)) {
-          throw new Error("Jev \u9078\u4E86\u76EE\u524D\u6A21\u578B\u4E0D\u652F\u63F4\u7684 effort");
-        }
-        return { status: "routed", effort: choice.choice };
-      } catch (err) {
-        return { status: "fallback", reason: err instanceof Error ? err.message : String(err) };
-      }
+    route(task, catalog, ro = {}) {
+      return taskModel(task) ? routeEffort(task, catalog) : routeModel(task, catalog, ro);
     }
   };
 }
+function effortQuestion(levels) {
+  return {
+    type: "choice",
+    instructions: "Choose the lowest reasoning effort likely to complete this software task correctly on the chosen model. Increase effort for complexity, ambiguity, or risk.",
+    criteria: Object.fromEntries(levels.map((level) => [level, effortDescription(level)]))
+  };
+}
+function message(err) {
+  return err instanceof Error ? err.message : String(err);
+}
 function effortDescription(level) {
   const descriptions = {
     low: "Routine, small and well scoped work",
@@ -6114,11 +6242,11 @@ async function getGitHubCliAuthStatus() {
       } catch {
       }
     }
-    const message = errorMessage2(err);
+    const message2 = errorMessage2(err);
     return {
-      installed: !/ENOENT|not found/i.test(message),
+      installed: !/ENOENT|not found/i.test(message2),
       authenticated: false,
-      error: message
+      error: message2
     };
   }
 }
@@ -6704,13 +6832,13 @@ function setConversation(taskId, conversation) {
 function loadConversation(taskId) {
   return getChatStore().get("conversations")[taskId] ?? null;
 }
-function appendMessage(taskId, message) {
+function appendMessage(taskId, message2) {
   const existing = loadConversation(taskId) ?? {
     taskId,
     messages: [],
     updatedAt: 0
   };
-  existing.messages.push(message);
+  existing.messages.push(message2);
   existing.updatedAt = Date.now();
   setConversation(taskId, existing);
 }
@@ -7265,8 +7393,8 @@ var PASTE_END = "\x1B[201~";
 var PASTE_GAP_MS = 200;
 var DEFAULT_QUIET_MS = 3e3;
 var DEFAULT_TIMEOUT_MS = 12e4;
-function coded(code2, message) {
-  return Object.assign(new Error(message), { code: code2 });
+function coded(code2, message2) {
+  return Object.assign(new Error(message2), { code: code2 });
 }
 function isBlocked(activity) {
   return activity?.state === "waiting" && activity.waitingFor === "permission";
@@ -7451,11 +7579,11 @@ var InvalidRequestError = class extends Error {
 };
 var STANDALONE_KEY = /^terminal_[0-9a-f-]{36}$/;
 var MAX_MESSAGE_LENGTH = 2e4;
-function coded2(code2, message) {
-  return Object.assign(new Error(message), { code: code2 });
+function coded2(code2, message2) {
+  return Object.assign(new Error(message2), { code: code2 });
 }
-function invalid(message) {
-  throw new InvalidRequestError(message);
+function invalid(message2) {
+  throw new InvalidRequestError(message2);
 }
 function str(value, name) {
   if (typeof value !== "string") invalid(`${name} must be a string`);
@@ -7636,16 +7764,23 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     const task = requireTask(key.split(":")[0]);
     return str(task.worktreePath ?? task.projectPath, "directory");
   }
+  function launchModel(task, route) {
+    return taskModel(task) ?? route?.model;
+  }
   function launchEffort(task, route) {
     const effort = task.effort === "auto" ? route?.effort : task.effort;
-    const model = models.findModel(taskAgent(task), taskModel(task));
+    const model = models.findModel(taskAgent(task), launchModel(task, route));
     return model?.efforts ? clampEffort(effort, model.efforts) : effort;
   }
+  function settledRoute(task) {
+    return task.jevRoute?.status === "routing" ? void 0 : task.jevRoute;
+  }
   async function launchCommand(task, intent) {
     const settings = getSettings();
     const boardCli = await boardCliLaunchInfo();
-    let route = task.jevRoute?.status === "routing" ? void 0 : task.jevRoute;
-    if (task.effort === "auto" && !intent.resume && intent.includeTaskPrompt !== false) {
+    let route = settledRoute(task);
+    const needsRoute = !taskModel(task) || task.effort === "auto";
+    if (needsRoute && !intent.resume && intent.includeTaskPrompt !== false) {
       let pending = routing.get(task.id);
       if (!pending) {
         const setRoute = (jevRoute) => {
@@ -7655,7 +7790,12 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
         pending = (async () => {
           setRoute({ status: "routing" });
           const candidateModels = (await (router.enabled === false ? models.get(taskAgent(task)) : models.refresh(taskAgent(task)))).models;
-          const selected = await router.route(task, candidateModels);
+          const selected = await router.route(task, candidateModels, {
+            // A master has no repo to read, only its notes folder.
+            scout: !isMasterTask(task),
+            cwd: task.worktreePath,
+            onPhase: (phase) => setRoute({ status: "routing", phase })
+          });
           setRoute(selected);
           return selected;
         })().catch((err) => {
@@ -7666,14 +7806,16 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
       }
       route = await pending;
     }
+    const preface = route?.context && route.scoutModel ? { model: route.scoutModel, context: route.context } : void 0;
     return buildAgentCommand(
-      { ...task, model: taskModel(task), effort: launchEffort(task, route) },
+      { ...task, model: launchModel(task, route), effort: launchEffort(task, route) },
       settings.systemPrompt ?? "",
       {
         resume: intent.resume === true,
         includeTaskPrompt: intent.includeTaskPrompt !== false,
         boardCli,
-        autoMode: task.autoMode ?? settings.autoMode
+        autoMode: task.autoMode ?? settings.autoMode,
+        preface
       },
       task.workspacePath
     );
@@ -7782,6 +7924,15 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
     const task = findTask(taskId);
     if (task && sessions.isAttached?.(taskId) === false) await startTaskSession(task, taskId, { taskId });
   }
+  function launchChoice(task) {
+    const route = settledRoute(task);
+    const model = launchModel(task, route);
+    const effort = launchEffort(task, route);
+    return {
+      ...model ? { model } : {},
+      ...effort && effort !== "auto" ? { effort } : {}
+    };
+  }
   async function summarizeTasks(filter) {
     const board = getState().board;
     const alive = new Set(await sessions.list());
@@ -7803,6 +7954,7 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
           ...task.masterId ? { masterId: task.masterId } : {},
           ...task.projectName ? { projectName: task.projectName } : {},
           ...task.branch ? { branch: task.branch } : {},
+          ...launchChoice(task),
           running: alive.has(task.id),
           ...task.launchedAt ? { launchedAt: task.launchedAt } : {},
           ...task.launchError ? { launchError: task.launchError } : {},
@@ -8192,8 +8344,8 @@ function createCore({ sessions, bus, version, homeDir, ghRunner, githubAuthStatu
       const file = await readTerminalFile(terminalDirectory(p.sessionKey), str(p.path, "path"), true);
       if (!file.ok) return { ok: false, message: file.message };
       try {
-        const message = await getPlatform().openPath(file.path);
-        return message ? { ok: false, message } : { ok: true };
+        const message2 = await getPlatform().openPath(file.path);
+        return message2 ? { ok: false, message: message2 } : { ok: true };
       } catch (error) {
         return { ok: false, message: error instanceof Error ? error.message : "\u7121\u6CD5\u958B\u555F\u6A94\u6848\u3002" };
       }