@agent-plan/mcp 0.2.19-next.13 → 0.2.19-next.15

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA6+BA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA4iCA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD"}

package/dist/index.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import * as z from "zod/v4";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { PlanStore, ExportService, withFeatureLock, needsMotivation, findPhaseByRef, findTaskByRef, buildRecap, migrateToGlobalSequence } from "@agent-plan/core";
+import { PlanStore, ExportService, withFeatureLock, needsMotivation, findPhaseByRef, findTaskByRef, buildRecap, migrateToGlobalSequence, addChecklistItem, removeChecklistItem, toggleChecklistItem } from "@agent-plan/core";
 import { serve } from "@agent-plan/server";
 import { createChecklistItemId, createFeatureId, createPhaseId, createShortId, createTaskId, clampSlug, normalizeSlug, formatPhaseRef, formatFeatureRef } from "@agent-plan/core/naming";
 const STATUS_VALUES = ["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"];
@@ -124,7 +124,7 @@ server.registerTool("planner-export", {
     const markdown = exportService.exportToMarkdown(plan, full);
     const fs = await import("node:fs/promises");
     await fs.writeFile(join(st.root, "EXPORT.md"), markdown, "utf-8");
-    return text(`Project export generated. Summary results:\n\n${markdown.slice(0, 1000)}${markdown.length > 1000 ? "... (full report in .planner/EXPORT.md)" : ""}`, { markdown });
+    return text(`Project export generated. Summary results:\n\n${markdown.slice(0, 1000)}${markdown.length > 1000 ? "... (full report in .planner/EXPORT.md)" : ""}`);
 });
 server.registerTool("planner-authorize-bypass", {
     description: "Authorize a temporary guard bypass (default 15 minutes) so edit/write tools can proceed even when no task is in-progress. Use ONLY after the user explicitly authorizes proceeding without a task. Harness-agnostic: stored in resume.json so all adapters (Pi, Claude Code, Codex, ...) respect it.",
@@ -165,19 +165,43 @@ server.registerTool("planner-init", {
     return writeAndSummarize(st, `.planner/ initialized for "${project.name}"`);
 });
 server.registerTool("planner-show", {
-    description: "Show the current planner overview.",
+    description: "Show a compact planner overview: project metadata, counts, and a one-line summary of each feature (F00x · shortId — name (status; N phases, M tasks)). Does NOT include full descriptions, phases, or tasks — use planner-feature-list / planner-phase-list / planner-task-list for discovery and planner-*-show for full detail of a single entity. Keeps the result small to avoid token overflow.",
 }, async () => {
     const st = await requireStore();
-    const plan = await st.loadAll();
-    return text([
-        `📋 ${plan.project.name}`,
-        `Description: ${plan.project.description || "(not set)"}`,
-        `Goal: ${plan.project.goal || "(not set)"}`,
-        `Features: ${plan.features.features.length}`,
-        `Phases: ${plan.phases.length}`,
-        `Tasks: ${plan.phases.reduce((total, phase) => total + phase.tasks.length, 0)}`,
-        `Updated: ${plan.manifest.updatedAt}`,
-    ].join("\n"), { plan });
+    const features = (await st.loadFeatures()).features;
+    const phases = await st.loadAllPhases();
+    const totalTasks = phases.reduce((total, phase) => total + phase.tasks.length, 0);
+    const project = await st.loadProject();
+    const manifest = await st.loadManifest();
+    const featureLines = features.map((feature) => {
+        const featurePhases = phases.filter((phase) => phase.featureId === feature.id);
+        const taskCount = featurePhases.reduce((total, phase) => total + phase.tasks.length, 0);
+        return `- ${formatFeatureRef(feature.number)}${feature.shortId ? ` · ${feature.shortId}` : ""} — ${feature.name} (${feature.status}; ${featurePhases.length} phases, ${taskCount} tasks)`;
+    });
+    const summary = [
+        `📋 ${project.name}`,
+        `Description: ${project.description || "(not set)"}`,
+        `Goal: ${project.goal || "(not set)"}`,
+        `Features: ${features.length}  |  Phases: ${phases.length}  |  Tasks: ${totalTasks}`,
+        `Updated: ${manifest.updatedAt || "(unknown)"}`,
+        "",
+        "Features:",
+        featureLines.join("\n") || "(none)",
+    ].join("\n");
+    // Compact structured overview (no full plan: avoids 1M+ char token overflow).
+    const overview = {
+        project: { name: project.name, description: project.description || null, goal: project.goal || null, updatedAt: manifest.updatedAt || null },
+        counts: { features: features.length, phases: phases.length, tasks: totalTasks },
+        features: features.map((feature) => ({
+            ref: formatFeatureRef(feature.number),
+            shortId: feature.shortId || null,
+            name: feature.name,
+            status: feature.status,
+            phases: phases.filter((p) => p.featureId === feature.id).length,
+            tasks: phases.filter((p) => p.featureId === feature.id).reduce((t, p) => t + p.tasks.length, 0),
+        })),
+    };
+    return text(summary, { overview });
 });
 server.registerTool("planner-repair", {
     description: "Repair dangling feature→phase references, rebuild phase containment from each task's own phaseId (heals the migrateToGlobalSequence task-shuffle bug where tasks land in the wrong phase file), and report integrity.",
@@ -758,9 +782,9 @@ server.registerTool("planner-task-update", {
 server.registerTool("planner-task-checklist-toggle", {
     description: "Tick/untick a task checklist item (a 'step') without rewriting the whole list. Accepts the item as C{n} (e.g. C2), the item id, or the title (case-insensitive, first match). Pass checked=true/false to set explicitly, or omit to toggle. Use this instead of writing DONE in step titles. Items are numbered C1/C2… per task.",
     inputSchema: {
-        task: z.string().min(1),
-        item: z.string().min(1),
-        checked: z.boolean().optional(),
+        task: z.string().min(1).describe("Task ref: F00x/P00x/T00x, bare T00x (global), 5-char shortId, UUID, or title"),
+        item: z.string().min(1).describe("Checklist item selector: C{n} (e.g. C2), item id, or title (case-insensitive)"),
+        checked: z.boolean().optional().describe("Set explicitly: true=done, false=open. Omit to toggle."),
     },
 }, async ({ task: ref, item, checked }) => {
     const st = await requireStore();
@@ -779,32 +803,79 @@ server.registerTool("planner-task-checklist-toggle", {
             result = `Task "${found.task.title}" has no checklist.`;
             return phase;
         }
-        let target;
-        const cMatch = item.match(/^C(\d+)$/i);
-        if (cMatch) {
-            const idx = parseInt(cMatch[1], 10) - 1;
-            if (idx < 0 || idx >= ck.length) {
-                result = `C${idx + 1} not found (1..${ck.length}).`;
-                return phase;
-            }
-            target = ck[idx];
-        }
-        else {
-            const needle = item.trim().toLowerCase();
-            target = ck.find((i) => i.id === item)
-                ?? ck.find((i) => i.title.trim().toLowerCase() === needle)
-                ?? ck.find((i) => i.title.trim().toLowerCase().includes(needle));
-        }
+        const target = toggleChecklistItem(ck, item, checked);
         if (!target) {
             result = `No checklist item matching "${item}".`;
             return phase;
         }
-        const newValue = checked ?? !target.checked;
-        target.checked = newValue;
         task.updatedAt = nowISO();
         phase.updatedAt = nowISO();
         const doneCount = ck.filter((i) => i.checked).length;
-        result = `C${target.number} "${target.title}" → ${newValue ? "done" : "open"} (${doneCount}/${ck.length} checked)`;
+        result = `C${target.number} "${target.title}" → ${target.checked ? "done" : "open"} (${doneCount}/${ck.length} checked)`;
+        return phase;
+    });
+    return writeAndSummarize(st, `✅ ${result}`);
+});
+server.registerTool("planner-task-checklist-add", {
+    description: "Add a single checklist item (a 'step') to a task without rewriting the list. The new item is appended as C{n} (next progressive number, stable id, unchecked). Use this to subdivide a task into smaller steps INSTEAD of spawning sub-tasks — the checklist keeps description, notes, statusLog and steps concentrated in one task (sub-tasks disperse context). Also use for granular adds instead of replacing the whole checklist via planner-task-update.",
+    inputSchema: {
+        task: z.string().min(1).describe("Task ref: F00x/P00x/T00x, bare T00x (global), 5-char shortId, UUID, or title"),
+        title: z.string().min(1).describe("Checklist item text (a single step)"),
+    },
+}, async ({ task: ref, title }) => {
+    const st = await requireStore();
+    const found = findTaskByRef(await st.loadAllPhases(), (await st.loadFeatures()).features, ref);
+    if (!found)
+        return text(`Task not found: ${ref}`);
+    let result = "";
+    await st.updatePhase(found.phase.id, (phase) => {
+        const task = phase.tasks.find((entry) => entry.id === found.task.id);
+        if (!task) {
+            result = `Task not found: ${ref}`;
+            return phase;
+        }
+        const ck = task.checklist ?? [];
+        const item = addChecklistItem(ck, task.id, title);
+        ck.push(item);
+        task.checklist = ck;
+        task.updatedAt = nowISO();
+        phase.updatedAt = nowISO();
+        result = `Added C${item.number} "${item.title}" (${ck.length} items)`;
+        return phase;
+    });
+    return writeAndSummarize(st, `✅ ${result}`);
+});
+server.registerTool("planner-task-checklist-remove", {
+    description: "Remove a single checklist item (a 'step') from a task by C{n} (e.g. C2), item id, or title (case-insensitive). Remaining items are renumbered C1..Cn for readability; their stable ids are preserved. Use this for granular removes instead of replacing the whole checklist via planner-task-update.",
+    inputSchema: {
+        task: z.string().min(1).describe("Task ref: F00x/P00x/T00x, bare T00x (global), 5-char shortId, UUID, or title"),
+        item: z.string().min(1).describe("Checklist item selector: C{n} (e.g. C2), item id, or title (case-insensitive)"),
+    },
+}, async ({ task: ref, item }) => {
+    const st = await requireStore();
+    const found = findTaskByRef(await st.loadAllPhases(), (await st.loadFeatures()).features, ref);
+    if (!found)
+        return text(`Task not found: ${ref}`);
+    let result = "";
+    await st.updatePhase(found.phase.id, (phase) => {
+        const task = phase.tasks.find((entry) => entry.id === found.task.id);
+        if (!task) {
+            result = `Task not found: ${ref}`;
+            return phase;
+        }
+        const ck = task.checklist ?? [];
+        if (ck.length === 0) {
+            result = `Task "${found.task.title}" has no checklist.`;
+            return phase;
+        }
+        const removed = removeChecklistItem(ck, item);
+        if (!removed) {
+            result = `No checklist item matching "${item}".`;
+            return phase;
+        }
+        task.updatedAt = nowISO();
+        phase.updatedAt = nowISO();
+        result = `Removed C${removed.number} "${removed.title}" (${ck.length} items left)`;
         return phase;
     });
     return writeAndSummarize(st, `✅ ${result}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/mcp",
-  "version": "0.2.19-next.13",
+  "version": "0.2.19-next.15",
   "private": false,
   "description": "MCP server for Agent Plan, exposing planner-* tools over stdio.",
   "license": "MIT",
@@ -41,8 +41,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.0",
     "zod": "^3.24.0",
-    "@agent-plan/core": "0.2.19-next.13",
-    "@agent-plan/server": "0.2.19-next.13"
+    "@agent-plan/core": "0.2.19-next.15",
+    "@agent-plan/server": "0.2.19-next.15"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",