@kimbho/kimbho-cli 0.1.25 → 0.1.28

package/dist/index.cjs

@@ -12718,7 +12718,7 @@ function createCompletionRuntimeCommand(program2) {
 // package.json
 var package_default = {
   name: "@kimbho/kimbho-cli",
-  version: "0.1.25",
+  version: "0.1.28",
   description: "Kimbho CLI is a terminal-native coding agent for planning, execution, and verification.",
   type: "module",
   engines: {
@@ -13080,11 +13080,11 @@ var AGENT_CATALOG = {
       "Design-system mismatch",
       "Frontend contract drift"
     ],
-    maxConcurrentTasks: 2,
+    maxConcurrentTasks: 3,
     policy: {
       sandboxMode: "workspace-write",
       canSpawnSubagents: true,
-      maxSubagentDepth: 1
+      maxSubagentDepth: 2
     }
   },
   "backend-specialist": {
@@ -13110,11 +13110,11 @@ var AGENT_CATALOG = {
       "Schema drift",
       "Unclear domain contract"
     ],
-    maxConcurrentTasks: 2,
+    maxConcurrentTasks: 3,
     policy: {
       sandboxMode: "workspace-write",
       canSpawnSubagents: true,
-      maxSubagentDepth: 1
+      maxSubagentDepth: 2
     }
   },
   "database-specialist": {
@@ -13140,7 +13140,7 @@ var AGENT_CATALOG = {
       "Data-destructive migration",
       "Unclear persistence requirements"
     ],
-    maxConcurrentTasks: 1,
+    maxConcurrentTasks: 2,
     policy: {
       sandboxMode: "workspace-write",
       requireApprovalPatterns: [
@@ -13149,7 +13149,7 @@ var AGENT_CATALOG = {
         "\\bdrop\\s+database\\b"
       ],
       canSpawnSubagents: true,
-      maxSubagentDepth: 1
+      maxSubagentDepth: 2
     }
   },
   "infra-specialist": {
@@ -13180,7 +13180,7 @@ var AGENT_CATALOG = {
       "Dependency installation",
       "External environment changes"
     ],
-    maxConcurrentTasks: 1,
+    maxConcurrentTasks: 2,
     policy: {
       sandboxMode: "workspace-write",
       requireApprovalPatterns: [
@@ -13192,7 +13192,7 @@ var AGENT_CATALOG = {
         "\\bapt(-get)?\\s+install\\b"
       ],
       canSpawnSubagents: true,
-      maxSubagentDepth: 1
+      maxSubagentDepth: 2
     }
   },
   "test-debugger": {
@@ -33341,17 +33341,6 @@ function inferFallbackActionFromResponse(raw, task, request, allowedTools) {
       };
     }
   }
-  if (allowedTools.includes("scaffold.generate") && looksLikeStaticLandingGoal(request.goal) && task.filesLikelyTouched.some((filePath) => filePath === "src/app/page.tsx" || filePath === "src/app/layout.tsx" || filePath === "src/pages/index.tsx" || filePath === "index.html" || filePath === "styles.css")) {
-    return {
-      type: "tool",
-      tool: "scaffold.generate",
-      input: {
-        goal: request.goal,
-        preset: "static-landing"
-      },
-      reason: "Use the deterministic static-site adapter because the model stayed out of structured mode."
-    };
-  }
   if (!allowedTools.includes("file.write")) {
     return null;
   }
@@ -35036,6 +35025,26 @@ function buildSummary(shape, goal) {
   }
   return `Deliver "${goal}" through structured analysis, implementation, and verification milestones.`;
 }
+function buildPlanningSeedSummary(goal) {
+  return `Create the best executable task graph for "${goal}" with dynamically chosen milestones, task count, and verification.`;
+}
+function planningSeedMilestone() {
+  return {
+    id: "m1-planning-seed",
+    title: "Planning Seed",
+    objective: "Schema-valid placeholder context for the planner model. Replace this seed with a real executable plan.",
+    tasks: [
+      buildTask("seed-plan-task", "Replace this planning seed with the real task graph", "This placeholder exists only so the planner model receives a schema-valid example. The final plan should replace it with concrete milestones and executable tasks tailored to the goal.", "planner", "documentation", [], [
+        "The final plan removes the placeholder task.",
+        "The final plan contains executable tasks with explicit dependencies and verification."
+      ], [
+        "Executable task graph"
+      ], [
+        "."
+      ], "low")
+    ]
+  };
+}
 function createPlan(input) {
   const request = PlanRequestSchema.parse({
     ...input,
@@ -35065,6 +35074,33 @@ function createPlan(input) {
     ]
   });
 }
+function createPlanningSeed(input) {
+  const request = PlanRequestSchema.parse({
+    ...input,
+    goal: normalizeGoal(input.goal)
+  });
+  const shape = inferProjectShape(request.goal);
+  return KimbhoPlanSchema.parse({
+    goal: request.goal,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    summary: buildPlanningSeedSummary(request.goal),
+    repoStrategy: {
+      mode: request.workspaceState === "empty" ? "greenfield" : "existing-repo",
+      reasoning: request.workspaceState === "empty" ? "No meaningful workspace contents were detected, so the planner can choose an opinionated greenfield graph." : "Existing workspace state should be analyzed and preserved while the planner chooses the execution graph."
+    },
+    assumptions: deriveAssumptions(shape, request),
+    openQuestions: deriveOpenQuestions(shape),
+    milestones: [
+      planningSeedMilestone()
+    ],
+    verificationChecklist: deriveVerificationChecklist(shape),
+    executionNotes: [
+      "Replace the placeholder seed milestone with the real execution graph.",
+      "Choose milestone count, task count, and dependencies dynamically from the goal.",
+      "Keep deterministic fallback available only if model planning fails."
+    ]
+  });
+}
 
 // ../planner/dist/model-planner.js
 var DEFAULT_PLANNER_TEMPERATURE = 0.1;
@@ -35148,8 +35184,8 @@ function buildPlannerSystemPrompt() {
     "You are Kimbho's planner brain.",
     "Return one JSON object only. Do not use markdown fences or prose outside the JSON.",
     "The JSON must satisfy the KimbhoPlan schema used by Kimbho's runtime.",
-    "Prefer refining the provided seed plan instead of inventing a totally different graph.",
-    "Keep task ids stable and machine-friendly.",
+    "For initial planning, choose the milestone count, task count, and task graph shape that best fits the request instead of mirroring the fallback plan.",
+    "Keep task ids machine-friendly and stable within the returned plan.",
     "Use only these agent roles:",
     "- session-orchestrator",
     "- repo-analyst",
@@ -35180,8 +35216,9 @@ ${request.constraints.map((constraint) => `- ${constraint}`).join("\n")}` : "",
     "Seed plan JSON:",
     JSON.stringify(seedPlan, null, 2),
     "Instructions:",
-    "- Refine the seed plan into the best executable plan for this goal.",
-    "- Preserve the seed task ids unless there is a compelling execution reason not to.",
+    "- Use the seed plan only as a fallback reference, not as a task-count template.",
+    "- Produce the best executable plan for this goal, choosing milestone count and task count dynamically.",
+    "- You may replace the seed task ids for the initial plan if a different graph is materially better.",
     "- Keep the plan concise, practical, and tool-executable."
   ].filter(Boolean).join("\n\n");
 }
@@ -35205,7 +35242,7 @@ ${request.constraints.map((constraint) => `- ${constraint}`).join("\n")}` : "",
     "- Adjust milestone wording, task descriptions, acceptance criteria, files, and dependencies only when the repo evidence justifies it."
   ].filter(Boolean).join("\n\n");
 }
-async function generatePlannerPlan(request, seedPlan, invocation, userPrompt, preserveStatusesFrom) {
+async function generatePlannerPlan(request, seedPlan, fallbackPlan, invocation, userPrompt, preserveStatusesFrom, requireStableTaskIds = true) {
   try {
     const response = await invocation.generate({
       systemPrompt: buildPlannerSystemPrompt(),
@@ -35215,7 +35252,7 @@ async function generatePlannerPlan(request, seedPlan, invocation, userPrompt, pr
     });
     const parsed = extractJsonObjectish(response.text, "planner response");
     const candidatePlan = KimbhoPlanSchema.parse(parsed);
-    const normalized = normalizeCandidatePlan(request, seedPlan, candidatePlan, true, preserveStatusesFrom);
+    const normalized = normalizeCandidatePlan(request, fallbackPlan, candidatePlan, requireStableTaskIds, preserveStatusesFrom);
     return {
       plan: normalized,
       source: "model",
@@ -35229,7 +35266,7 @@ async function generatePlannerPlan(request, seedPlan, invocation, userPrompt, pr
     };
   } catch (error2) {
     return {
-      plan: preserveStatusesFrom ? preserveTaskStatuses(preserveStatusesFrom, seedPlan) : seedPlan,
+      plan: preserveStatusesFrom ? preserveTaskStatuses(preserveStatusesFrom, fallbackPlan) : fallbackPlan,
       source: "fallback",
       warning: summarizeStructuredOutputError("Planner", error2),
       ...invocation.modelLabel ? {
@@ -35239,18 +35276,19 @@ async function generatePlannerPlan(request, seedPlan, invocation, userPrompt, pr
   }
 }
 async function createPlanWithModel(request, invocation) {
-  const seedPlan = createPlan(request);
-  return generatePlannerPlan(request, seedPlan, invocation, buildInitialPlannerPrompt(request, seedPlan));
+  const fallbackPlan = createPlan(request);
+  const seedPlan = createPlanningSeed(request);
+  return generatePlannerPlan(request, seedPlan, fallbackPlan, invocation, buildInitialPlannerPrompt(request, seedPlan), void 0, false);
 }
 async function revisePlanWithModel(request, currentPlan, repoSummary, invocation) {
-  return generatePlannerPlan(request, currentPlan, invocation, buildReplanPrompt(request, currentPlan, repoSummary), currentPlan);
+  return generatePlannerPlan(request, currentPlan, currentPlan, invocation, buildReplanPrompt(request, currentPlan, repoSummary), currentPlan);
 }
 
 // ../planner/dist/task-expander.js
 var DEFAULT_EXPANDER_TEMPERATURE = 0.1;
 var DEFAULT_EXPANDER_MAX_TOKENS = 1600;
 var MAX_EXPANSION_CONTEXT_CHARS = 6e3;
-var MAX_EXPANDED_SUBTASKS = 4;
+var MAX_EXPANDED_SUBTASKS = 6;
 var ExpansionCandidateTaskSchema = external_exports.object({
   id: external_exports.string().min(1).optional(),
   title: external_exports.string().min(1),
@@ -35310,7 +35348,7 @@ function createEntrySubtask(task, suffix, title, description) {
   };
 }
 function fallbackExpandedTasks(task) {
-  if ((task.swarmDepth ?? 0) >= 1) {
+  if ((task.swarmDepth ?? 0) >= 2) {
     return null;
   }
   if (task.agentRole === "frontend-specialist" && task.type === "implementation") {
@@ -35326,10 +35364,24 @@ function fallbackExpandedTasks(task) {
         ]
       },
       {
-        ...createEntrySubtask(task, "polish", `Polish ${task.title.toLowerCase()} visuals and responsiveness`, `Refine styling, responsiveness, and interaction details after the content structure is in place.`),
+        ...createEntrySubtask(task, "interaction", `Design ${task.title.toLowerCase()} interaction and motion`, `Define animation, scroll behavior, and interaction states once the content structure is clear.`),
         dependsOn: [
           `${task.id}-content`
         ],
+        acceptanceCriteria: [
+          "Interaction patterns and motion direction are explicit.",
+          "Primary calls to action and navigation states feel intentional."
+        ],
+        outputs: [
+          "Interaction and motion direction"
+        ]
+      },
+      {
+        ...createEntrySubtask(task, "polish", `Polish ${task.title.toLowerCase()} visuals and responsiveness`, `Refine styling, responsiveness, and interaction details after the content structure is in place.`),
+        dependsOn: [
+          `${task.id}-content`,
+          `${task.id}-interaction`
+        ],
         acceptanceCriteria: [
           ...task.acceptanceCriteria,
           "Responsive behavior and visual polish are verified."
@@ -35532,9 +35584,10 @@ function buildExpansionPrompt(request, plan, task, repoSummary) {
     "Repo context:",
     truncate2(repoSummary),
     "Instructions:",
-    "- Replace the target task with 2-4 narrower subtasks.",
+    `- Replace the target task with 2-${MAX_EXPANDED_SUBTASKS} narrower subtasks.`,
     "- Preserve the target task's overall intent, but make execution more parallel-friendly when safe.",
     "- Keep dependencies explicit and machine-valid.",
+    "- Prefer at least 3 subtasks for broad frontend or product-surface work when the task can be split safely.",
     "- Prefer roles like frontend-specialist, backend-specialist, database-specialist, infra-specialist, reviewer, and test-debugger when they fit."
   ].join("\n\n");
 }
@@ -35551,7 +35604,7 @@ ${task.acceptanceCriteria.map((criterion) => `- ${criterion}`).join("\n") || "-
   ].filter(Boolean).join("\n\n");
 }
 function shouldExpandTask(task) {
-  if ((task.swarmDepth ?? 0) >= 1) {
+  if ((task.swarmDepth ?? 0) >= 2) {
     return false;
   }
   if (task.type !== "implementation") {
@@ -36673,9 +36726,6 @@ function shouldDelegateTask(task, request) {
   if (!canSpawnSubagents) {
     return false;
   }
-  if ((looksLikeVisualAdjustmentGoal(request.goal) || looksLikePageExpansionGoal(request.goal)) && isStaticSiteTask(task, request)) {
-    return false;
-  }
   return (task.swarmDepth ?? 0) < maxSubagentDepth && task.type === "implementation" && ![
     "repo-analyst",
     "planner",
@@ -36714,6 +36764,20 @@ function createDefaultDelegationPlan(task, request) {
             "Structured page/content update"
           ]
         },
+        {
+          id: "interaction-designer",
+          label: "interaction-designer",
+          agentRole: "frontend-specialist",
+          description: "Own motion design, interaction states, scroll behavior, and narrative pacing.",
+          instructions: "Focus on animation, interaction states, scroll rhythm, and motion hierarchy. Keep motion purposeful and aligned with the requested design direction.",
+          acceptanceCriteria: [
+            "Interaction patterns and motion choices are explicit.",
+            "The page has a coherent motion system without distracting from the content."
+          ],
+          outputs: [
+            "Interaction and motion design update"
+          ]
+        },
         {
           id: "visual-polisher",
           label: "visual-polisher",
@@ -37323,8 +37387,8 @@ var ExecutionOrchestrator = class {
     let pendingApprovals = [
       ...session.pendingApprovals
     ];
-    const maxAutoTasks = options.maxAutoTasks ?? 2;
-    const maxParallelTasks = Math.max(1, options.maxParallelTasks ?? 2);
+    const maxAutoTasks = options.maxAutoTasks ?? 4;
+    const maxParallelTasks = Math.max(1, options.maxParallelTasks ?? 4);
     let executedTasks = 0;
     for (const approval of session.pendingApprovals) {
       const decision = decisionByApprovalId.get(approval.id);
@@ -37640,7 +37704,8 @@ var ExecutionOrchestrator = class {
       }
       const profile = AGENT_CATALOG[task.agentRole];
       const currentRoleCount = roleCounts.get(task.agentRole) ?? 0;
-      if (currentRoleCount >= profile.maxConcurrentTasks) {
+      const effectiveConcurrency = Math.max(profile.maxConcurrentTasks, task.agentRole === "frontend-specialist" || task.agentRole === "backend-specialist" ? 3 : profile.maxConcurrentTasks);
+      if (currentRoleCount >= effectiveConcurrency) {
         continue;
       }
       selected.push(task);
@@ -37660,9 +37725,6 @@ var ExecutionOrchestrator = class {
     if (task.agentRole === "planner") {
       return this.executePlannerTask(sessionId, task, request, plan, emitProgress);
     }
-    if (request.workspaceState === "existing" && isStaticSiteTask(task, request) && (task.type === "scaffold" || task.type === "implementation")) {
-      return this.executeDeterministicStaticSiteTask(sessionId, task, request, resolvedApproval, options, emitProgress);
-    }
     if (request.workspaceState === "existing" && looksLikeStaticLandingGoal(request.goal) && task.type === "verification") {
       return this.executeDeterministicVerificationTask(sessionId, task, request, emitProgress, options.signal);
     }
@@ -39693,7 +39755,7 @@ async function executePromptByIntent(cwd, input, options = {}) {
   }
   return executeRunPrompt(cwd, input, options.outputFormat ?? "json", {
     ephemeral: options.ephemeral ?? false,
-    maxAutoTasks: options.maxAutoTasks ?? 3,
+    maxAutoTasks: options.maxAutoTasks ?? 4,
     maxAgentSteps: options.maxAgentSteps ?? 8,
     maxRepairAttempts: options.maxRepairAttempts ?? 2,
     ...options.sessionId ? {
@@ -39714,7 +39776,7 @@ function createExecCommand() {
   ], []).option("--image <pathOrUrl>", "Attach an image to the prompt", (value, previous = []) => [
     ...previous,
     value
-  ], []).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount, 3).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount, 2).action(async (rawPrompt, options) => {
+  ], []).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount, 4).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount, 2).action(async (rawPrompt, options) => {
     const cwd = import_node_process5.default.cwd();
     const format = options.json ? "json" : options.outputFormat;
     const agentSelection = await resolveAgentSelection(cwd, {
@@ -42190,7 +42252,7 @@ async function resolveSourceSession(cwd, sessionId, last = false, search) {
   return loadSessionById(sessionId, cwd);
 }
 function createForkCommand() {
-  return new Command("fork").description("Fork a saved session into a new session snapshot.").argument("[sessionId]", "Optional session id; defaults to the latest session").option("--last", "Fork the most recent session", false).option("--list", "List recent sessions and exit", false).option("--search <query>", "Filter sessions by id, goal, cwd, or labels").option("--json", "Print the forked snapshot as JSON", false).option("--execute", "Continue auto-executing the forked session", false).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount3, 3).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount3, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount3, 2).action(async (sessionId, options) => {
+  return new Command("fork").description("Fork a saved session into a new session snapshot.").argument("[sessionId]", "Optional session id; defaults to the latest session").option("--last", "Fork the most recent session", false).option("--list", "List recent sessions and exit", false).option("--search <query>", "Filter sessions by id, goal, cwd, or labels").option("--json", "Print the forked snapshot as JSON", false).option("--execute", "Continue auto-executing the forked session", false).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount3, 4).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount3, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount3, 2).action(async (sessionId, options) => {
     const cwd = import_node_process12.default.cwd();
     if (options.list) {
       const sessions = options.search ? await searchSessions(options.search, cwd) : await listSessions(cwd);
@@ -43360,7 +43422,7 @@ function parseCount4(value) {
   return parsed;
 }
 function createResumeCommand() {
-  return new Command("resume").alias("continue").description("Resume the latest saved Kimbho session snapshot.").argument("[sessionId]", "Optional session id; defaults to the latest session").option("--json", "Print the latest session as JSON", false).option("--last", "Resume the most recent session", false).option("--list", "List recent sessions and exit", false).option("--search <query>", "Filter sessions by id, goal, cwd, or labels").option("--execute", "Continue auto-executing the ready-task frontier", false).option("--approve <approvalId>", "Approve a pending action before continuing").option("--deny <approvalId>", "Deny a pending action before continuing").option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount4, 3).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount4, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount4, 2).action(async (sessionId, options) => {
+  return new Command("resume").alias("continue").description("Resume the latest saved Kimbho session snapshot.").argument("[sessionId]", "Optional session id; defaults to the latest session").option("--json", "Print the latest session as JSON", false).option("--last", "Resume the most recent session", false).option("--list", "List recent sessions and exit", false).option("--search <query>", "Filter sessions by id, goal, cwd, or labels").option("--execute", "Continue auto-executing the ready-task frontier", false).option("--approve <approvalId>", "Approve a pending action before continuing").option("--deny <approvalId>", "Deny a pending action before continuing").option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount4, 4).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount4, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount4, 2).action(async (sessionId, options) => {
     const cwd = import_node_process23.default.cwd();
     const firstSearchMatch = options.search ? (await searchSessions(options.search, cwd, 1)).at(0) ?? null : null;
     if (options.list) {
@@ -43439,7 +43501,7 @@ function createRunCommand() {
     "Explicit execution constraint; can be provided multiple times",
     (value, previous = []) => [...previous, value],
     []
-  ).option("--json", "Print the session snapshot as JSON", false).option("--snapshot-only", "Create the session without auto-executing ready tasks", false).option("--agent <id>", "Prefer one custom or plugin agent id for this session").option("--agents <jsonOrPath>", "Inline agent definitions as JSON or a path to a JSON file").option("--session-id <id>", "Use an explicit session id").option("--ephemeral", "Do not persist plans or sessions for this invocation", false).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount5, 3).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount5, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount5, 2).action(async (goal, options) => {
+  ).option("--json", "Print the session snapshot as JSON", false).option("--snapshot-only", "Create the session without auto-executing ready tasks", false).option("--agent <id>", "Prefer one custom or plugin agent id for this session").option("--agents <jsonOrPath>", "Inline agent definitions as JSON or a path to a JSON file").option("--session-id <id>", "Use an explicit session id").option("--ephemeral", "Do not persist plans or sessions for this invocation", false).option("--max-auto-tasks <count>", "Maximum ready tasks to auto-execute", parseCount5, 4).option("--max-agent-steps <count>", "Maximum tool/model steps per autonomous task", parseCount5, 8).option("--max-repair-attempts <count>", "Maximum failed verification cycles per autonomous task", parseCount5, 2).action(async (goal, options) => {
     const cwd = import_node_process24.default.cwd();
     const orchestrator = new ExecutionOrchestrator();
     const agentSelection = await resolveAgentSelection(cwd, {
@@ -44084,6 +44146,11 @@ function shouldAutoStartApprovedRuns(runtime) {
   const approvalMode = resolveRuntimeOverrideApprovalMode(runtime);
   return approvalMode === "auto" || approvalMode === "dontAsk" || approvalMode === "acceptEdits" || approvalMode === "bypassPermissions";
 }
+function shouldAutoStartProposal(runtime, proposal) {
+  return Boolean(
+    proposal && shouldAutoStartApprovedRuns(runtime) && !planRequiresOperatorReview(proposal.plan)
+  );
+}
 function resolveShellMaxAutoTasks(runtime) {
   return shouldAutoStartApprovedRuns(runtime) ? UNBOUNDED_MAX_AUTO_TASKS : DEFAULT_MAX_AUTO_TASKS;
 }
@@ -44681,6 +44748,21 @@ function pickStatusLabel(message) {
 function pickIdleStatusLabel(seed) {
   return IDLE_STATUS_LABELS[hashString(seed) % IDLE_STATUS_LABELS.length];
 }
+function statusLabelForToolStart(event) {
+  if (event.toolId === "shell.exec" || event.toolId === "tests.run") {
+    const command = typeof event.input?.command === "string" ? event.input.command.trim().toLowerCase() : "";
+    if (command.includes("build") || command.includes("lint") || command.includes("test")) {
+      return "verifying";
+    }
+    if (command.includes("dev") || command.includes("start")) {
+      return "serving";
+    }
+    if (command.length > 0) {
+      return pickStatusLabel(command);
+    }
+  }
+  return pickStatusLabel(event.reason ?? event.toolId);
+}
 function statusLabelForEvent(event) {
   switch (event.type) {
     case "task-note":
@@ -44688,7 +44770,7 @@ function statusLabelForEvent(event) {
     case "task-started":
       return pickStatusLabel(event.task.title);
     case "tool-started":
-      return pickStatusLabel(event.reason ?? event.toolId);
+      return statusLabelForToolStart(event);
     case "model-usage":
       return "thinking";
     case "approval-requested":
@@ -44798,14 +44880,67 @@ function renderShellPlanSummary(plan) {
   }
   return lines;
 }
+function inferRecommendedPlanAnswer(question, plan) {
+  const lower = question.toLowerCase();
+  const goal = plan.goal.toLowerCase();
+  if (lower.includes("brand voice") || lower.includes("visual direction")) {
+    if (goal.includes("blog") || goal.includes("post")) {
+      return "Use a premium editorial direction: clean typography, strong whitespace, restrained motion, and a polished reading-first layout.";
+    }
+    return "Use a restrained premium product direction: crisp typography, strong whitespace, subtle motion, and a clear call to action.";
+  }
+  if (lower.includes("which sections")) {
+    if (goal.includes("blog") || goal.includes("post")) {
+      return "Start with navigation, hero, featured posts, topic/category grid, newsletter CTA, and a compact footer.";
+    }
+    return "Start with navigation, hero, key benefits, proof/examples, primary CTA, and footer.";
+  }
+  if (lower.includes("primary call to action")) {
+    if (goal.includes("blog") || goal.includes("post")) {
+      return "Drive readers to featured posts first, with newsletter signup as the secondary CTA.";
+    }
+    return "Drive the main product action with one clear primary CTA and keep secondary actions minimal.";
+  }
+  if (lower.includes("which stack") || lower.includes("deployment target")) {
+    return "Stay with the current repo stack and existing deployment shape unless the user asks for a migration.";
+  }
+  if (lower.includes("authentication model")) {
+    return "Assume no authentication in the first version unless the request explicitly needs gated user flows.";
+  }
+  if (lower.includes("external services") || lower.includes("apis")) {
+    return "Assume no new external integrations beyond what already exists in the repository.";
+  }
+  return "Proceed with the most pragmatic default that preserves the current repo and keeps the first version focused.";
+}
+function extractPlanReviewPrompts(plan) {
+  return plan.openQuestions.slice(0, 3).map((question) => ({
+    question,
+    recommendation: inferRecommendedPlanAnswer(question, plan)
+  }));
+}
+function planRequiresOperatorReview(plan) {
+  return extractPlanReviewPrompts(plan).length > 0;
+}
 function renderPendingRunProposal(proposal, options = {}) {
+  const reviewPrompts = extractPlanReviewPrompts(proposal.plan);
+  const requiresReview = reviewPrompts.length > 0;
   const lines = [
     `${color(BOLD, proposal.source === "queued" ? "Queued Plan Ready" : "Ready To Run")}`,
-    ...renderShellPlanSummary(proposal.plan),
-    "",
-    color(DIM, `saved plan: ${proposal.planPath}`),
-    options.autoStart ? color(DIM, "next: auto-starting in the current permission mode") : "next: /approve to start, /run revise <feedback> to adjust, /run cancel to drop it"
+    ...renderShellPlanSummary(proposal.plan)
   ];
+  if (requiresReview) {
+    lines.push("");
+    lines.push(color(BOLD, "Recommended Defaults"));
+    for (const prompt of reviewPrompts) {
+      lines.push(`\u2022 ${prompt.question}`);
+      lines.push(color(DIM, `  recommended: ${prompt.recommendation}`));
+    }
+  }
+  lines.push("");
+  lines.push(color(DIM, `saved plan: ${proposal.planPath}`));
+  lines.push(
+    requiresReview ? "next: /run approve to accept the recommended defaults, /run revise <feedback> to adjust, /run cancel to drop it" : options.autoStart ? color(DIM, "next: auto-starting in the current permission mode") : "next: /approve to start, /run revise <feedback> to adjust, /run cancel to drop it"
+  );
   if (proposal.source === "queued") {
     lines.splice(1, 0, color(DIM, "The next queued request has been planned and is waiting for your approval."));
   }
@@ -44903,6 +45038,24 @@ function renderConciseProgress(board, startedAt) {
     ] : []
   ];
 }
+function summarizeToolStart(event) {
+  if (event.toolId === "shell.exec" || event.toolId === "tests.run") {
+    const command = typeof event.input?.command === "string" ? event.input.command.trim() : "";
+    if (command) {
+      return `Running ${shortenMiddle(command, 90)}`;
+    }
+  }
+  if (event.toolId === "http.fetch" && typeof event.input?.url === "string") {
+    return `Checking ${shortenMiddle(event.input.url, 90)}`;
+  }
+  if (event.toolId === "process.start" && typeof event.input?.command === "string") {
+    return `Starting ${shortenMiddle(event.input.command, 90)}`;
+  }
+  if (event.toolId === "browser.open" && typeof event.input?.url === "string") {
+    return `Opening ${shortenMiddle(event.input.url, 90)}`;
+  }
+  return null;
+}
 function renderLiveExecutionEvent(event, board, startedAt) {
   switch (event.type) {
     case "task-started":
@@ -44918,6 +45071,13 @@ function renderLiveExecutionEvent(event, board, startedAt) {
         )} ${simplifyExecutionSummary(event.summary) || event.taskId}`,
         ...renderConciseProgress(board, startedAt)
       ];
+    case "tool-started": {
+      const summary = summarizeToolStart(event);
+      return summary ? [
+        `${color(DIM, "working")} ${summary}`,
+        ...renderConciseProgress(board, startedAt)
+      ] : [];
+    }
     case "task-note":
       return isUserVisibleTaskNote(event.message) ? [
         `${color(DIM, "note")} ${simplifyTaskNote(event.message)}`
@@ -45096,7 +45256,7 @@ async function drainQueuedWork(runtime) {
             source: "queued"
           });
           runtime.currentCwd = nextCwd;
-          if (shouldAutoStartApprovedRuns(runtime)) {
+          if (shouldAutoStartProposal(runtime, runtime.pendingRunProposal)) {
             console.log(color(DIM, "Auto-starting queued request in the current permission mode."));
             startPendingRunExecution(runtime);
           }
@@ -45269,7 +45429,7 @@ async function prepareRunProposal(cwd, goal, runtime, options = {}) {
   console.log(renderPendingRunProposal(
     runtime.pendingRunProposal,
     {
-      autoStart: shouldAutoStartApprovedRuns(runtime)
+      autoStart: shouldAutoStartProposal(runtime, runtime.pendingRunProposal)
     }
   ).join("\n"));
   return request.cwd;
@@ -46679,7 +46839,7 @@ async function handleShellCommand(cwd, input, state, runtime, execute) {
         const nextCwd = await prepareRunProposal(cwd, trimmed, runtime, {
           source: "direct"
         });
-        if (shouldAutoStartApprovedRuns(runtime)) {
+        if (shouldAutoStartProposal(runtime, runtime.pendingRunProposal)) {
           console.log(color(DIM, "Auto-starting in the current permission mode."));
           startPendingRunExecution(runtime);
         }
@@ -46809,7 +46969,7 @@ async function handleShellCommand(cwd, input, state, runtime, execute) {
       console.log(renderPendingRunProposal(
         runtime.pendingRunProposal,
         {
-          autoStart: shouldAutoStartApprovedRuns(runtime)
+          autoStart: shouldAutoStartProposal(runtime, runtime.pendingRunProposal)
         }
       ).join("\n"));
       return cwd;
@@ -46846,7 +47006,7 @@ async function handleShellCommand(cwd, input, state, runtime, execute) {
     const nextCwd = await prepareRunProposal(cwd, goal, runtime, {
       source: "direct"
     });
-    if (shouldAutoStartApprovedRuns(runtime)) {
+    if (shouldAutoStartProposal(runtime, runtime.pendingRunProposal)) {
       console.log(color(DIM, "Auto-starting in the current permission mode."));
       startPendingRunExecution(runtime);
     }