@wrongstack/tools 0.5.5 → 0.5.6

package/dist/index.d.ts

@@ -43,18 +43,22 @@ export { builtinToolsPack } from './pack.js';
  * during startup so the tool always knows where to read/write.
  *
  * One tool, multiple actions, JSON in/out. The action discriminates the
- * operation so the LLM can do show / add / start / done / remove / clear
- * via a single tool registration instead of bloating the surface with
- * six near-identical tools.
+ * operation so the LLM can do show / add / start / done / remove / promote /
+ * derive / template_use / clear via a single tool registration instead of
+ * bloating the surface with nine near-identical tools.
  */
 interface PlanInput {
-    action: 'show' | 'add' | 'start' | 'done' | 'remove' | 'clear';
+    action: 'show' | 'add' | 'start' | 'done' | 'remove' | 'promote' | 'derive' | 'template_use' | 'clear';
     /** Required for add. */
     title?: string;
     /** Optional detail line for add. */
     details?: string;
-    /** Required for start/done/remove — accepts plan item id OR 1-based index OR title substring. */
+    /** Required for start/done/remove/promote/derive — accepts plan item id OR 1-based index OR title substring. */
     target?: string;
+    /** Optional subtasks for promote/derive. If omitted, a single todo is created from the plan item title. */
+    subtasks?: string[];
+    /** Required for template_use — the template name (e.g. "new-feature", "bug-fix"). */
+    template?: string;
 }
 interface PlanOutput {
     ok: boolean;
@@ -65,6 +69,13 @@ interface PlanOutput {
     count: number;
     /** Number of items not in 'done' status. */
     open: number;
+    /** When promote/derive succeed, the generated todo items so the caller can inspect them. */
+    todos?: Array<{
+        id: string;
+        content: string;
+        status: string;
+        activeForm?: string;
+    }>;
 }
 declare const planTool: Tool<PlanInput, PlanOutput>;
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import * as fs4 from 'fs/promises';
 import * as path from 'path';
 import { dirname } from 'path';
-import { atomicWrite, unifiedDiff, detectNewlineStyle, normalizeToLf, toStyle, compileGlob, buildChildEnv, stripAnsi, loadPlan, emptyPlan, clearPlan, savePlan, removePlanItem, setPlanItemStatus, addPlanItem, formatPlan } from '@wrongstack/core';
+import { atomicWrite, unifiedDiff, detectNewlineStyle, normalizeToLf, toStyle, compileGlob, buildChildEnv, stripAnsi, loadPlan, emptyPlan, clearPlan, savePlan, getPlanTemplate, addPlanItem, deriveTodosFromPlanItem, removePlanItem, setPlanItemStatus, formatPlan } from '@wrongstack/core';
 import { spawn } from 'child_process';
 import * as os from 'os';
 import * as dns from 'dns/promises';
@@ -1821,8 +1821,8 @@ var todoTool = {
 var planTool = {
   name: "plan",
   category: "Session",
-  description: "Inspect or edit the strategic plan board for this session. Plans persist across resume (unlike todos). Use this to lay out the multi-step approach before diving in, then mark steps in_progress/done as the work proceeds.",
-  usageHint: "Set action to one of: show | add | start | done | remove | clear. Pass `title` for add. Pass `target` (item id, 1-based index, or title substring) for start/done/remove. Always returns the formatted plan plus open/total counts.",
+  description: "Inspect or edit the strategic plan board for this session. Plans persist across resume (unlike todos). Use this to lay out the multi-step approach before diving in, then mark steps in_progress/done as the work proceeds. Promote a plan item to todos to start working on it. Apply templates for common workflows.",
+  usageHint: 'Set action to one of: show | add | start | done | remove | promote | derive | template_use | clear. Pass `title` for add. Pass `target` (item id, 1-based index, or title substring) for start/done/remove/promote/derive. Pass `subtasks` for promote/derive to break the plan item into multiple todos. Pass `template` (e.g. "new-feature", "bug-fix", "refactor", "release") for template_use. Always returns the formatted plan plus open/total counts.',
   permission: "auto",
   mutating: false,
   timeoutMs: 2e3,
@@ -1831,13 +1831,22 @@ var planTool = {
     properties: {
       action: {
         type: "string",
-        enum: ["show", "add", "start", "done", "remove", "clear"]
+        enum: ["show", "add", "start", "done", "remove", "promote", "derive", "template_use", "clear"]
       },
       title: { type: "string", description: "Required when action = add." },
       details: { type: "string", description: "Optional extra context for add." },
       target: {
         type: "string",
-        description: "Plan item id, 1-based index, or title substring. Required for start/done/remove."
+        description: "Plan item id, 1-based index, or title substring. Required for start/done/remove/promote/derive."
+      },
+      subtasks: {
+        type: "array",
+        items: { type: "string" },
+        description: "Optional subtasks for promote/derive. If omitted, a single todo is created from the plan item title."
+      },
+      template: {
+        type: "string",
+        description: "Template name for template_use action. Available: new-feature, bug-fix, refactor, release, security-audit, onboarding."
       }
     },
     required: ["action"]
@@ -1896,6 +1905,35 @@ var planTool = {
         await savePlan(planPath, plan);
         break;
       }
+      case "promote":
+      case "derive": {
+        if (!input.target) {
+          return mkResult(plan, false, `${input.action} requires \`target\` (id|index|substring).`);
+        }
+        const derived = deriveTodosFromPlanItem(plan, input.target, input.subtasks);
+        if (!derived) {
+          return mkResult(plan, false, `No plan item matched "${input.target}".`);
+        }
+        plan = derived.plan;
+        await savePlan(planPath, plan);
+        ctx.state.replaceTodos(derived.todos);
+        return mkResult(plan, true, `${input.action} ok \u2014 ${derived.todos.length} todo(s) created.`, derived.todos);
+      }
+      case "template_use": {
+        const templateName = input.template?.trim();
+        if (!templateName) {
+          return mkResult(plan, false, "template_use requires `template` name.");
+        }
+        const template = getPlanTemplate(templateName);
+        if (!template) {
+          return mkResult(plan, false, `Unknown template "${templateName}".`);
+        }
+        for (const item of template.items) {
+          ({ plan } = addPlanItem(plan, item.title, item.details));
+        }
+        await savePlan(planPath, plan);
+        return mkResult(plan, true, `Applied template "${template.name}" \u2014 ${template.items.length} items added.`);
+      }
       case "clear":
         plan = clearPlan(plan);
         await savePlan(planPath, plan);
@@ -1906,14 +1944,15 @@ var planTool = {
     return mkResult(plan, true, `Plan ${input.action} ok.`);
   }
 };
-function mkResult(plan, ok, message) {
+function mkResult(plan, ok, message, todos) {
   const open = plan.items.filter((i) => i.status !== "done").length;
   return {
     ok,
     message,
     plan: formatPlan(plan),
     count: plan.items.length,
-    open
+    open,
+    todos
   };
 }
 var TIMEOUT_MS4 = 3e4;