@agent-plan/mcp 0.2.19-next.0 → 0.2.19-next.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA+5BA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAm5BA,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 } from "@agent-plan/core";
+import { PlanStore, ExportService, withFeatureLock, needsMotivation, findPhaseByRef, buildRecap } from "@agent-plan/core";
 import { serve } from "@agent-plan/server";
 import { createChecklistItemId, createFeatureId, createPhaseId, createShortId, createTaskId, clampSlug, normalizeSlug, formatPhaseRef } from "@agent-plan/core/naming";
 const STATUS_VALUES = ["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"];
@@ -55,49 +55,6 @@ async function ensureWebStarted() {
         return { localUrl: "" };
     }
 }
-/** Build a consolidated planner recap (project state + active work + pending
- *  handoff + web URL). Harness-agnostic equivalent of Pi's buildStartupResumeSummary. */
-async function buildRecapText(st, web) {
-    const [plan, resume, handoffs] = await Promise.all([st.loadAll(), st.loadResume(), st.listHandoffs()]);
-    const allTasks = plan.phases.flatMap((p) => p.tasks.map((t) => ({ phase: p, task: t })));
-    const totalF = plan.features.features.length;
-    const doneF = plan.features.features.filter((f) => f.status === "done").length;
-    const activeF = plan.features.features.filter((f) => f.status === "in-progress").length;
-    const totalP = plan.phases.length;
-    const doneP = plan.phases.filter((p) => p.status === "done").length;
-    const activeP = plan.phases.filter((p) => p.status === "in-progress" || p.status === "discovery").length;
-    const totalT = allTasks.length;
-    const doneT = allTasks.filter(({ task }) => task.status === "done").length;
-    const activeT = allTasks.filter(({ task }) => task.status === "in-progress").length;
-    const inProgress = allTasks.filter(({ task }) => task.status === "in-progress");
-    const focus = inProgress[0];
-    const focusFeature = focus ? plan.features.features.find((f) => f.id === focus.phase.featureId) : undefined;
-    const lines = [];
-    lines.push("## Planner recap");
-    const name = plan.project.name || "(unnamed project)";
-    lines.push(`Project: ${name}${plan.project.goal ? " — " + plan.project.goal : ""}`);
-    lines.push(`Progress: Features ${doneF}/${totalF} done (${activeF} active) · Phases ${doneP}/${totalP} done (${activeP} active) · Tasks ${doneT}/${totalT} done (${activeT} active)`);
-    if (focus) {
-        lines.push(`Current focus: ${focusFeature?.name ?? "?"} / ${focus.phase.title} / ${focus.task.title} (in-progress)`);
-    }
-    else {
-        lines.push("Current focus: no active task — review the plan and pick the next concrete task");
-    }
-    if (resume?.nextSteps?.length)
-        lines.push(`Next step: ${resume.nextSteps[0]}`);
-    if (handoffs.length > 0) {
-        lines.push("", `## Pending phase handoffs (${handoffs.length})`);
-        handoffs.forEach((h, i) => lines.push(`[${i + 1}] ${h.compositeRef} — ${h.updatedAt} — "${h.firstLine}"`));
-        lines.push("", "→ Read the relevant one with planner-handoff-show <ref> (validate against current state), then call planner-handoff-clear <ref> once consumed (delete-on-resume).");
-    }
-    else if (activeT === 0) {
-        lines.push("", "No phase handoff pending and no task in-progress. Use planner-task-add / planner-task-start to begin work.");
-    }
-    if (web.localUrl) {
-        lines.push("", "## Web UI", `🌐 ${web.localUrl}${web.lanUrl ? " (LAN: " + web.lanUrl + ")" : ""}`);
-    }
-    return lines.join("\n");
-}
 function findFeatureByRef(features, ref) {
     const normalized = ref.trim().toLowerCase();
     return features.find((feature) => feature.id.toLowerCase() === normalized)
@@ -106,8 +63,25 @@ function findFeatureByRef(features, ref) {
 }
 function findTaskByRef(phases, ref) {
     const normalized = ref.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    // Composite ref like "P00x(F00x)/T00x" or "T00x(P00x/F00x)": match by phase + task number.
+    const tMatch = normalized.match(/t0*(\d+)/);
+    const pMatch = normalized.match(/p0*(\d+)/);
+    if (tMatch && pMatch) {
+        const tNum = parseInt(tMatch[1], 10);
+        const pNum = parseInt(pMatch[1], 10);
+        for (const phase of phases) {
+            if (phase.number !== pNum)
+                continue;
+            const task = phase.tasks.find((t) => t.number === tNum);
+            if (task)
+                return { phase, task };
+        }
+    }
     for (const phase of phases) {
         const task = phase.tasks.find((entry) => entry.id.toLowerCase() === normalized
+            || (entry.shortId && entry.shortId.toLowerCase() === normalized)
             || entry.title.toLowerCase() === normalized
             || entry.title.toLowerCase().includes(normalized));
         if (task)
@@ -115,6 +89,12 @@ function findTaskByRef(phases, ref) {
     }
     return undefined;
 }
+function featureNumberOfPhase(phase, features) {
+    return phase.featureId ? features.find((f) => f.id === phase.featureId)?.number : undefined;
+}
+function taskCompositeRef(task, phase, features) {
+    return `${formatPhaseRef(phase.number, featureNumberOfPhase(phase, features))}/T${String(task.number).padStart(3, "0")}`;
+}
 function applyTaskLifecycleDates(task, nextStatus, now) {
     const previousStatus = task.status;
     if (nextStatus === "in-progress" && !task.startedAt)
@@ -625,13 +605,14 @@ server.registerTool("planner-task-add", {
         createdAt: timestamp,
         updatedAt: timestamp,
     };
-    const phase = await st.updatePhase(found.id, (entry) => {
+    await st.updatePhase(found.id, (entry) => {
         entry.tasks.push(task);
         entry.taskIds.push(task.id);
         entry.updatedAt = timestamp;
         return entry;
     });
-    return writeAndSummarize(st, `Task created: ${task.id} — ${task.title}`, { task, phase });
+    const features = (await st.loadFeatures()).features;
+    return writeAndSummarize(st, `✅ Task created: ${taskCompositeRef(task, found, features)} — ${task.title} (planned)${task.shortId ? ` · ${task.shortId}` : ""}`);
 });
 server.registerTool("planner-task-show", {
     description: "Show a task by id or name.",
@@ -669,7 +650,9 @@ server.registerTool("planner-task-discuss", {
         updatedTask = task;
         return phase;
     });
-    return writeAndSummarize(st, `Task discussed/updated: ${found.task.id}`, { task: updatedTask ?? found.task });
+    const features = (await st.loadFeatures()).features;
+    const t = updatedTask ?? found.task;
+    return writeAndSummarize(st, `✅ Task discussed/updated: ${taskCompositeRef(t, found.phase, features)} — ${t.title} (${t.status})${t.shortId ? ` · ${t.shortId}` : ""}`);
 });
 server.registerTool("planner-task-update", {
     description: "Update task fields. A motivation is REQUIRED when changing to blocked, canceled, deferred, rejected, waiting, or back to planned from another status.",
@@ -724,7 +707,9 @@ server.registerTool("planner-task-update", {
         return phase;
     });
     await st.syncTaskStatusRollup(found.phase.id);
-    return writeAndSummarize(st, `Task updated: ${found.task.id}`, { task: updatedTask ?? found.task });
+    const features = (await st.loadFeatures()).features;
+    const t = updatedTask ?? found.task;
+    return writeAndSummarize(st, `✅ Task updated: ${taskCompositeRef(t, found.phase, features)} — ${t.title} (${t.status})${t.shortId ? ` · ${t.shortId}` : ""}`);
 });
 server.registerTool("planner-task-delete", {
     description: "Delete a task.",
@@ -782,7 +767,9 @@ server.registerTool("planner-task-start", {
         return phase;
     });
     await st.syncTaskStatusRollup(found.phase.id);
-    return writeAndSummarize(st, `${handoffNotice}✅ Task started: ${found.task.id}`, { task: updatedTask ?? found.task });
+    const features = (await st.loadFeatures()).features;
+    const t = updatedTask ?? found.task;
+    return writeAndSummarize(st, `${handoffNotice}✅ Task started: ${taskCompositeRef(t, found.phase, features)} — ${t.title} (in-progress)${t.shortId ? ` · ${t.shortId}` : ""}`);
 });
 server.registerTool("planner-task-complete", {
     description: "Set a task to done. Fails if checklist is incomplete unless force=true.",
@@ -827,7 +814,9 @@ server.registerTool("planner-task-complete", {
         return phase;
     });
     const clearedRef = await st.syncTaskStatusRollup(found.phase.id);
-    return writeAndSummarize(st, `✅ Task completed: ${found.task.id}${clearedRef ? ` — phase handoff auto-cleared (${clearedRef})` : ""}`, { task: updatedTask ?? found.task });
+    const features = (await st.loadFeatures()).features;
+    const t = updatedTask ?? found.task;
+    return writeAndSummarize(st, `✅ Task completed: ${taskCompositeRef(t, found.phase, features)} — ${t.title} (done)${t.shortId ? ` · ${t.shortId}` : ""}${clearedRef ? ` — phase handoff auto-cleared (${clearedRef})` : ""}`);
 });
 server.registerTool("planner-handoff-list", {
     description: "List all phases with a non-empty entity-scoped handoff (phase.handoff field). Returns composite refs (P00x / P00x(F00x)) with the first line and last-updated time.",
@@ -931,7 +920,7 @@ server.registerTool("planner-load", {
     if (!(await st.exists()))
         return text("No .planner/ found at " + planRoot() + ". Run planner-init first.");
     const web = await ensureWebStarted();
-    const recap = await buildRecapText(st, web);
+    const recap = await buildRecap(st, web, { harness: "mcp" });
     return text(recap);
 });
 server.registerTool("planner-disable", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-plan/mcp",
-  "version": "0.2.19-next.0",
+  "version": "0.2.19-next.1",
   "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.0",
-    "@agent-plan/server": "0.2.19-next.0"
+    "@agent-plan/core": "0.2.19-next.1",
+    "@agent-plan/server": "0.2.19-next.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",