pi-messenger 0.7.3

package/crew/handlers/task.ts

@@ -0,0 +1,511 @@
+/**
+ * Crew - Task Handlers
+ * 
+ * Operations: create, show, list, start, done, block, unblock, ready, reset
+ * Simplified: tasks belong to the plan, not an epic
+ */
+
+import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { MessengerState, Dirs } from "../../lib.js";
+import type { CrewParams, TaskEvidence } from "../types.js";
+import { result } from "../utils/result.js";
+import * as store from "../store.js";
+
+export async function execute(
+  op: string,
+  params: CrewParams,
+  state: MessengerState,
+  _dirs: Dirs,
+  ctx: ExtensionContext
+) {
+  const cwd = ctx.cwd ?? process.cwd();
+
+  switch (op) {
+    case "create":
+      return taskCreate(cwd, params);
+    case "show":
+      return taskShow(cwd, params);
+    case "list":
+      return taskList(cwd);
+    case "start":
+      return taskStart(cwd, params, state);
+    case "done":
+      return taskDone(cwd, params);
+    case "block":
+      return taskBlock(cwd, params);
+    case "unblock":
+      return taskUnblock(cwd, params);
+    case "ready":
+      return taskReady(cwd);
+    case "reset":
+      return taskReset(cwd, params);
+    default:
+      return result(`Unknown task operation: ${op}`, { mode: "task", error: "unknown_operation", operation: op });
+  }
+}
+
+// =============================================================================
+// task.create
+// =============================================================================
+
+function taskCreate(cwd: string, params: CrewParams) {
+  if (!params.title) {
+    return result("Error: title required for task.create", { mode: "task.create", error: "missing_title" });
+  }
+
+  // Verify plan exists
+  const plan = store.getPlan(cwd);
+  if (!plan) {
+    return result("Error: No plan exists. Create one first with pi_messenger({ action: \"plan\" })", { 
+      mode: "task.create", error: "no_plan" 
+    });
+  }
+
+  // Validate dependencies exist
+  if (params.dependsOn && params.dependsOn.length > 0) {
+    for (const depId of params.dependsOn) {
+      const dep = store.getTask(cwd, depId);
+      if (!dep) {
+        return result(`Error: Dependency ${depId} not found`, { mode: "task.create", error: "dependency_not_found", dependency: depId });
+      }
+    }
+  }
+
+  const task = store.createTask(cwd, params.title, params.content, params.dependsOn);
+
+  const depsText = task.depends_on.length > 0 
+    ? `\n**Depends on:** ${task.depends_on.join(", ")}`
+    : "";
+
+  const text = `✅ Created task **${task.id}**
+
+**Title:** ${task.title}
+**Status:** ${task.status}${depsText}
+
+Start with: \`pi_messenger({ action: "task.start", id: "${task.id}" })\``;
+
+  return result(text, {
+    mode: "task.create",
+    task: {
+      id: task.id,
+      title: task.title,
+      status: task.status,
+      depends_on: task.depends_on,
+    }
+  });
+}
+
+// =============================================================================
+// task.show
+// =============================================================================
+
+function taskShow(cwd: string, params: CrewParams) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.show", { mode: "task.show", error: "missing_id" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.show", error: "not_found", id });
+  }
+
+  const spec = store.getTaskSpec(cwd, id);
+
+  // Build status details
+  let statusDetails = "";
+  switch (task.status) {
+    case "in_progress":
+      statusDetails = `\n**Assigned to:** ${task.assigned_to ?? "unknown"}\n**Started:** ${task.started_at}`;
+      if (task.base_commit) statusDetails += `\n**Base commit:** ${task.base_commit.slice(0, 8)}`;
+      break;
+    case "done":
+      statusDetails = `\n**Completed:** ${task.completed_at}`;
+      if (task.summary) statusDetails += `\n**Summary:** ${task.summary}`;
+      break;
+    case "blocked":
+      statusDetails = `\n**Blocked reason:** ${task.blocked_reason ?? "unknown"}`;
+      break;
+  }
+
+  const depsText = task.depends_on.length > 0 
+    ? `\n**Depends on:** ${task.depends_on.join(", ")}`
+    : "";
+
+  // Spec preview
+  let specPreview = "";
+  if (spec && !spec.includes("*Spec pending*")) {
+    const truncated = spec.length > 800 ? spec.slice(0, 800) + "..." : spec;
+    specPreview = `\n\n## Spec\n\`\`\`\n${truncated}\n\`\`\``;
+  }
+
+  const statusIcon = {
+    todo: "⬜",
+    in_progress: "🔄",
+    done: "✅",
+    blocked: "🚫",
+  }[task.status];
+
+  const text = `# Task ${task.id}: ${task.title}
+
+${statusIcon} **Status:** ${task.status}${statusDetails}
+**Attempts:** ${task.attempt_count}${depsText}${specPreview}`;
+
+  return result(text, {
+    mode: "task.show",
+    task,
+    hasSpec: spec && !spec.includes("*Spec pending*"),
+  });
+}
+
+// =============================================================================
+// task.list
+// =============================================================================
+
+function taskList(cwd: string) {
+  const plan = store.getPlan(cwd);
+  if (!plan) {
+    return result("No plan found. Create one with: pi_messenger({ action: \"plan\" })", { 
+      mode: "task.list", tasks: [], hasPlan: false 
+    });
+  }
+
+  const tasks = store.getTasks(cwd);
+  if (tasks.length === 0) {
+    return result(`No tasks in plan. Create with: \`pi_messenger({ action: "task.create", title: "..." })\``, {
+      mode: "task.list",
+      tasks: [],
+      prd: plan.prd,
+    });
+  }
+
+  const lines: string[] = [`# Tasks for ${plan.prd}\n`];
+  
+  for (const task of tasks) {
+    const icon = { todo: "⬜", in_progress: "🔄", done: "✅", blocked: "🚫" }[task.status];
+    const deps = task.depends_on.length > 0 ? ` → deps: ${task.depends_on.join(", ")}` : "";
+    const assignee = task.assigned_to ? ` [${task.assigned_to}]` : "";
+    lines.push(`${icon} **${task.id}**: ${task.title}${assignee}${deps}`);
+  }
+
+  const done = tasks.filter(t => t.status === "done").length;
+  lines.push(`\n**Progress:** ${done}/${tasks.length}`);
+
+  return result(lines.join("\n"), {
+    mode: "task.list",
+    prd: plan.prd,
+    tasks: tasks.map(t => ({
+      id: t.id,
+      title: t.title,
+      status: t.status,
+      depends_on: t.depends_on,
+    })),
+  });
+}
+
+// =============================================================================
+// task.start
+// =============================================================================
+
+function taskStart(cwd: string, params: CrewParams, state: MessengerState) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.start", { mode: "task.start", error: "missing_id" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.start", error: "not_found", id });
+  }
+
+  if (task.status !== "todo") {
+    return result(`Error: Task ${id} is ${task.status}, not todo`, { 
+      mode: "task.start", error: "invalid_status", id, status: task.status 
+    });
+  }
+
+  // Check dependencies are done
+  if (task.depends_on.length > 0) {
+    const notDone: string[] = [];
+    for (const depId of task.depends_on) {
+      const dep = store.getTask(cwd, depId);
+      if (dep && dep.status !== "done") {
+        notDone.push(`${depId} (${dep.status})`);
+      }
+    }
+    if (notDone.length > 0) {
+      return result(`Error: Task ${id} has unmet dependencies: ${notDone.join(", ")}`, {
+        mode: "task.start",
+        error: "unmet_dependencies",
+        id,
+        unmetDependencies: notDone,
+      });
+    }
+  }
+
+  const agentName = state.agentName || "unknown";
+  const started = store.startTask(cwd, id, agentName);
+
+  if (!started) {
+    return result(`Error: Failed to start task ${id}`, { mode: "task.start", error: "start_failed", id });
+  }
+
+  const spec = store.getTaskSpec(cwd, id);
+  const specPreview = spec && !spec.includes("*Spec pending*")
+    ? `\n\n**Spec:**\n\`\`\`\n${spec.length > 1000 ? spec.slice(0, 1000) + "..." : spec}\n\`\`\``
+    : "";
+
+  const text = `🔄 Started task **${id}**
+
+**Title:** ${started.title}
+**Assigned to:** ${agentName}
+**Attempt:** ${started.attempt_count}
+${started.base_commit ? `**Base commit:** ${started.base_commit.slice(0, 8)}` : ""}${specPreview}
+
+When done: \`pi_messenger({ action: "task.done", id: "${id}", summary: "..." })\`
+If blocked: \`pi_messenger({ action: "task.block", id: "${id}", reason: "..." })\``;
+
+  return result(text, {
+    mode: "task.start",
+    task: {
+      id: started.id,
+      title: started.title,
+      status: started.status,
+      assigned_to: started.assigned_to,
+      attempt_count: started.attempt_count,
+      base_commit: started.base_commit,
+    }
+  });
+}
+
+// =============================================================================
+// task.done
+// =============================================================================
+
+function taskDone(cwd: string, params: CrewParams) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.done", { mode: "task.done", error: "missing_id" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.done", error: "not_found", id });
+  }
+
+  if (task.status !== "in_progress") {
+    return result(`Error: Task ${id} is ${task.status}, not in_progress`, {
+      mode: "task.done", error: "invalid_status", id, status: task.status
+    });
+  }
+
+  const summary = params.summary ?? "Task completed";
+  const evidence: TaskEvidence | undefined = params.evidence;
+
+  const completed = store.completeTask(cwd, id, summary, evidence);
+  if (!completed) {
+    return result(`Error: Failed to complete task ${id}`, { mode: "task.done", error: "complete_failed", id });
+  }
+
+  // Check progress
+  const plan = store.getPlan(cwd);
+  const tasks = store.getTasks(cwd);
+  const remaining = tasks.filter(t => t.status !== "done");
+
+  let nextSteps = "";
+  if (remaining.length === 0) {
+    nextSteps = `\n\n🎉 **All tasks complete!** Plan is finished.`;
+  } else {
+    const ready = store.getReadyTasks(cwd);
+    if (ready.length > 0) {
+      nextSteps = `\n\n**Ready tasks:** ${ready.map(t => t.id).join(", ")}`;
+    }
+  }
+
+  const text = `✅ Completed task **${id}**
+
+**Summary:** ${summary}
+**Progress:** ${plan?.completed_count}/${plan?.task_count}${nextSteps}`;
+
+  return result(text, {
+    mode: "task.done",
+    task: {
+      id: completed.id,
+      title: completed.title,
+      status: completed.status,
+      summary: completed.summary,
+    },
+    progress: {
+      completed: plan?.completed_count ?? 0,
+      total: plan?.task_count ?? 0,
+    }
+  });
+}
+
+// =============================================================================
+// task.block
+// =============================================================================
+
+function taskBlock(cwd: string, params: CrewParams) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.block", { mode: "task.block", error: "missing_id" });
+  }
+
+  if (!params.reason) {
+    return result("Error: reason required for task.block", { mode: "task.block", error: "missing_reason" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.block", error: "not_found", id });
+  }
+
+  const blocked = store.blockTask(cwd, id, params.reason);
+  if (!blocked) {
+    return result(`Error: Failed to block task ${id}`, { mode: "task.block", error: "block_failed", id });
+  }
+
+  const text = `🚫 Blocked task **${id}**
+
+**Reason:** ${params.reason}
+
+Unblock with: \`pi_messenger({ action: "task.unblock", id: "${id}" })\``;
+
+  return result(text, {
+    mode: "task.block",
+    task: {
+      id: blocked.id,
+      title: blocked.title,
+      status: blocked.status,
+      blocked_reason: blocked.blocked_reason,
+    }
+  });
+}
+
+// =============================================================================
+// task.unblock
+// =============================================================================
+
+function taskUnblock(cwd: string, params: CrewParams) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.unblock", { mode: "task.unblock", error: "missing_id" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.unblock", error: "not_found", id });
+  }
+
+  if (task.status !== "blocked") {
+    return result(`Error: Task ${id} is ${task.status}, not blocked`, {
+      mode: "task.unblock", error: "invalid_status", id, status: task.status
+    });
+  }
+
+  const unblocked = store.unblockTask(cwd, id);
+  if (!unblocked) {
+    return result(`Error: Failed to unblock task ${id}`, { mode: "task.unblock", error: "unblock_failed", id });
+  }
+
+  const text = `⬜ Unblocked task **${id}**
+
+Task is now ready to start: \`pi_messenger({ action: "task.start", id: "${id}" })\``;
+
+  return result(text, {
+    mode: "task.unblock",
+    task: {
+      id: unblocked.id,
+      title: unblocked.title,
+      status: unblocked.status,
+    }
+  });
+}
+
+// =============================================================================
+// task.ready
+// =============================================================================
+
+function taskReady(cwd: string) {
+  const plan = store.getPlan(cwd);
+  if (!plan) {
+    return result("No plan found. Create one with: pi_messenger({ action: \"plan\" })", { 
+      mode: "task.ready", ready: [], hasPlan: false 
+    });
+  }
+
+  const ready = store.getReadyTasks(cwd);
+
+  if (ready.length === 0) {
+    const tasks = store.getTasks(cwd);
+    const inProgress = tasks.filter(t => t.status === "in_progress");
+    const blocked = tasks.filter(t => t.status === "blocked");
+    const done = tasks.filter(t => t.status === "done");
+
+    let reason = "";
+    if (done.length === tasks.length) {
+      reason = "All tasks are done!";
+    } else if (inProgress.length > 0) {
+      reason = `${inProgress.length} task(s) in progress: ${inProgress.map(t => t.id).join(", ")}`;
+    } else if (blocked.length > 0) {
+      reason = `${blocked.length} task(s) blocked: ${blocked.map(t => t.id).join(", ")}`;
+    } else {
+      reason = "All remaining tasks have unmet dependencies.";
+    }
+
+    return result(`No ready tasks.\n\n${reason}`, {
+      mode: "task.ready",
+      ready: [],
+      reason,
+    });
+  }
+
+  const lines: string[] = [`# Ready Tasks\n`];
+  for (const task of ready) {
+    lines.push(`⬜ **${task.id}**: ${task.title}`);
+  }
+  lines.push(`\nStart one: \`pi_messenger({ action: "task.start", id: "${ready[0].id}" })\``);
+  lines.push(`Or run all: \`pi_messenger({ action: "work" })\``);
+
+  return result(lines.join("\n"), {
+    mode: "task.ready",
+    ready: ready.map(t => ({
+      id: t.id,
+      title: t.title,
+    })),
+  });
+}
+
+// =============================================================================
+// task.reset
+// =============================================================================
+
+function taskReset(cwd: string, params: CrewParams) {
+  const id = params.id;
+  if (!id) {
+    return result("Error: id required for task.reset", { mode: "task.reset", error: "missing_id" });
+  }
+
+  const task = store.getTask(cwd, id);
+  if (!task) {
+    return result(`Error: Task ${id} not found`, { mode: "task.reset", error: "not_found", id });
+  }
+
+  const cascade = params.cascade ?? false;
+  const resetTasks = store.resetTask(cwd, id, cascade);
+
+  if (resetTasks.length === 0) {
+    return result(`Error: Failed to reset task ${id}`, { mode: "task.reset", error: "reset_failed", id });
+  }
+
+  const text = cascade && resetTasks.length > 1
+    ? `🔄 Reset ${resetTasks.length} tasks:\n${resetTasks.map(t => `  - ${t.id}`).join("\n")}`
+    : `🔄 Reset task **${id}**`;
+
+  return result(text + `\n\nStart with: \`pi_messenger({ action: "task.start", id: "${id}" })\``, {
+    mode: "task.reset",
+    reset: resetTasks.map(t => t.id),
+    cascade,
+  });
+}