@wrongstack/tools 0.89.3 → 0.104.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import * as fs4 from 'node:fs/promises';
 import * as Core from '@wrongstack/core';
-import { atomicWrite, unifiedDiff, detectNewlineStyle, normalizeToLf, toStyle, compileGlob, expectDefined, buildChildEnv, loadPlan, emptyPlan, clearPlan, savePlan, getPlanTemplate, addPlanItem, deriveTodosFromPlanItem, removePlanItem, setPlanItemStatus, formatPlan, resolveWstackPaths } from '@wrongstack/core';
+import { atomicWrite, unifiedDiff, detectNewlineStyle, normalizeToLf, toStyle, compileGlob, expectDefined, buildChildEnv, loadPlan, emptyPlan, clearPlan, savePlan, getPlanTemplate, addPlanItem, deriveTodosFromPlanItem, removePlanItem, setPlanItemStatus, formatPlan, loadTasks, emptyTaskFile, saveTasks, computeTaskItemProgress, formatTaskList, resolveWstackPaths } from '@wrongstack/core';
 import * as path from 'node:path';
 import { resolve, sep, dirname } from 'node:path';
 import { spawn, execFileSync, spawnSync } from 'node:child_process';
@@ -7713,6 +7713,147 @@ var codebaseStatsTool = {
     }
   }
 };
+var taskTool = {
+  name: "task",
+  category: "Session",
+  description: "Manage structured work items with dependencies, types, and priorities. Use this for complex, multi-step work where tasks have ordering constraints. Unlike `todo` (flat, tactical), `task` supports typed work (feature/bugfix/refactor/etc.), dependencies between items, priority ranking, and agent assignment. The task list persists across session resumes.",
+  usageHint: 'USE FOR STRUCTURED WORK:\n- `action: "replace"` \u2014 set the complete task list (tasks ordered by priority)\n- `action: "add"` \u2014 append a single task\n- `action: "status"` \u2014 update a task\'s status (e.g. pending\u2192in_progress, in_progress\u2192completed)\n- `action: "show"` \u2014 view current tasks without changing them\n\nTask fields:\n- `dependsOn`: list of task IDs this one waits for\n- `type`: "feature" | "bugfix" | "refactor" | "docs" | "test" | "chore"\n- `priority`: "critical" | "high" | "medium" | "low"\n- `assignee`: agent/subagent name (e.g. "bug-hunter", "refactor-planner")\n- `estimateHours`: rough time estimate',
+  permission: "auto",
+  mutating: false,
+  timeoutMs: 2e3,
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["replace", "add", "status", "show"],
+        description: "replace = set full list, add = append, status = update task status, show = view only."
+      },
+      tasks: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            id: { type: "string", description: 'Unique id (e.g. "t1", "auth-flow").' },
+            title: { type: "string", description: "Short title." },
+            description: { type: "string", description: "Optional details." },
+            type: { type: "string", enum: ["feature", "bugfix", "refactor", "docs", "test", "chore"] },
+            priority: { type: "string", enum: ["critical", "high", "medium", "low"] },
+            status: { type: "string", enum: ["pending", "in_progress", "blocked", "failed", "review", "completed"] },
+            dependsOn: {
+              type: "array",
+              items: { type: "string" },
+              description: "IDs of tasks this one depends on."
+            },
+            assignee: { type: "string", description: "Agent/subagent assigned." },
+            estimateHours: { type: "number", description: "Estimated hours." },
+            tags: { type: "array", items: { type: "string" }, description: "Optional tags." },
+            createdAt: { type: "string" },
+            updatedAt: { type: "string" }
+          },
+          required: ["id", "title", "type", "priority", "status"]
+        },
+        description: "Complete task list. Replaces previous list entirely."
+      },
+      task: {
+        type: "object",
+        properties: {
+          title: { type: "string" },
+          description: { type: "string" },
+          type: { type: "string", enum: ["feature", "bugfix", "refactor", "docs", "test", "chore"] },
+          priority: { type: "string", enum: ["critical", "high", "medium", "low"] },
+          status: { type: "string", enum: ["pending", "in_progress", "blocked", "failed", "review", "completed"] },
+          dependsOn: { type: "array", items: { type: "string" } },
+          assignee: { type: "string" },
+          estimateHours: { type: "number" },
+          tags: { type: "array", items: { type: "string" } }
+        },
+        required: ["title", "type", "priority"],
+        description: "Single task to append (id/createdAt/updatedAt auto-generated)."
+      },
+      id: { type: "string", description: "Task id for action=status." },
+      status: {
+        type: "string",
+        enum: ["pending", "in_progress", "blocked", "failed", "review", "completed"],
+        description: "New status for action=status."
+      }
+    },
+    required: ["action"]
+  },
+  async execute(input, ctx) {
+    const taskPath = ctx.meta["task.path"];
+    if (typeof taskPath !== "string" || !taskPath) {
+      return { ok: false, message: "Task storage path not configured.", count: 0, completed: 0, inProgress: 0 };
+    }
+    const sessionId = ctx.session?.id ?? "unknown";
+    let file = await loadTasks(taskPath) ?? emptyTaskFile(sessionId);
+    switch (input.action) {
+      case "show":
+        break;
+      case "replace": {
+        if (!Array.isArray(input.tasks)) {
+          return { ok: false, message: "action=replace requires `tasks` array.", count: 0, completed: 0, inProgress: 0 };
+        }
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        file.tasks = input.tasks.map((t) => ({
+          ...t,
+          createdAt: t.createdAt || now,
+          updatedAt: now
+        }));
+        await saveTasks(taskPath, file);
+        break;
+      }
+      case "add": {
+        const t = input.task;
+        if (!t || !t.title) {
+          return { ok: false, message: "action=add requires `task` with at least `title`.", count: 0, completed: 0, inProgress: 0 };
+        }
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        const newTask = {
+          id: `task_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+          title: t.title,
+          description: t.description,
+          type: t.type || "feature",
+          priority: t.priority || "medium",
+          status: t.status || "pending",
+          dependsOn: t.dependsOn,
+          assignee: t.assignee,
+          estimateHours: t.estimateHours,
+          tags: t.tags,
+          createdAt: now,
+          updatedAt: now
+        };
+        file.tasks.push(newTask);
+        await saveTasks(taskPath, file);
+        break;
+      }
+      case "status": {
+        if (!input.id || !input.status) {
+          return { ok: false, message: "action=status requires `id` and `status`.", count: 0, completed: 0, inProgress: 0 };
+        }
+        const task = file.tasks.find((t) => t.id === input.id);
+        if (!task) {
+          return { ok: false, message: `Task "${input.id}" not found.`, count: 0, completed: 0, inProgress: 0 };
+        }
+        task.status = input.status;
+        task.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        await saveTasks(taskPath, file);
+        break;
+      }
+      default:
+        return { ok: false, message: `Unknown action "${input.action}". Use replace | add | status | show.`, count: 0, completed: 0, inProgress: 0 };
+    }
+    const p = computeTaskItemProgress(file.tasks);
+    const summary = file.tasks.length > 0 ? formatTaskList(file.tasks) : "No tasks.";
+    return {
+      ok: true,
+      message: summary,
+      count: file.tasks.length,
+      completed: p.completed,
+      inProgress: p.inProgress
+    };
+  }
+};
 
 // src/builtin.ts
 var builtinTools = [
@@ -7728,6 +7869,7 @@ var builtinTools = [
   searchTool,
   todoTool,
   planTool,
+  taskTool,
   gitTool,
   patchTool,
   jsonTool,