@agent-plan/mcp 0.4.0 → 0.4.2

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA4BA,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA2LrI;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAUzE;AA83FD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA4BA,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA2LrI;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAUzE;AAi4FD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAItD"}

package/dist/index.js

@@ -1484,7 +1484,7 @@ server.registerTool("planner-task-show", {
     const summary = `${found.task.title} — ${taskCompositeRef(found.task, found.phase, features)}${found.task.shortId ? ` · ${found.task.shortId}` : ""} (${found.task.status}; phase ${formatPhaseRef(found.phase.number, featureNumberOfPhase(found.phase, features))})`;
     if (!full)
         return text(summary);
-    const project = await st.loadProject();
+    const project = await st.loadProject(plannerSessionId);
     const pendingDeviation = found.task.status === "done" || found.task.status === "canceled" || found.task.status === "rejected"
         ? undefined
         : project.workDeviations
@@ -1707,7 +1707,8 @@ server.registerTool("planner-task-update", {
         checklist: z.array(z.string()).optional().describe("Replace the task checklist (implementation steps, plain strings). Ticks carry over by exact title match, and by position when the new list is the same length (so renaming an item keeps its tick); an item that cannot be matched loses its tick and that loss is reported. Agents should tick steps via planner-task-checklist-toggle, not write DONE in titles, and use planner-task-checklist-add/remove for granular edits."),
         subtasks: z.array(z.object({ id: z.string().optional(), title: z.string().min(1), description: z.string().optional(), status: z.enum(STATUS_VALUES).optional() })).optional().describe("Replace subtasks; existing IDs must belong to this task and omitted IDs are planner-generated."),
     },
-}, async ({ task: ref, title, status, description, descriptionRef: rawDescriptionRef, notes, decisions, motivation, priority, checklist, subtasks }) => {
+}, async ({ task: ref, title, status, description, descriptionRef: rawDescriptionRef, notes, decisions, motivation, priority, checklist, subtasks }, extra) => {
+    const plannerSessionId = plannerSessionIdFor(extra);
     const st = await requireStore();
     const found = findTaskByRef(await st.loadAllPhases(), (await st.loadFeatures()).features, ref);
     if (!found)
@@ -1813,7 +1814,7 @@ server.registerTool("planner-task-update", {
     let resumeNotice = "";
     let resumeRequired;
     if (status && status !== "in-progress" && status !== found.task.status) {
-        const deviation = (await st.loadProject()).workDeviations
+        const deviation = (await st.loadProject(plannerSessionId)).workDeviations
             .filter((entry) => (entry.state === "approved" || entry.state === "active") && entry.temporaryTaskId === found.task.id)
             .sort((left, right) => right.createdAt.localeCompare(left.createdAt))[0];
         if (deviation) {
@@ -1999,17 +2000,17 @@ server.registerTool("planner-task-delete", {
 server.registerTool("planner-task-recommend", {
     description: "Return the harness-agnostic next-work chain: active task if present, otherwise the lowest-priority ready feature → phase → task, plus bounded typed claims. Only persisted resume-ready handoffs are actionable; Markdown prose and terminal archives are not authority. Does not start or block work.",
     inputSchema: {},
-}, async () => {
+}, async (_args, extra) => {
+    const plannerSessionId = plannerSessionIdFor(extra);
     const st = await requireStore();
-    const [features, phases, project, resume, handoffs, archivedHandoffs] = await Promise.all([
+    const [features, phases, resume, handoffs, archivedHandoffs] = await Promise.all([
         st.loadFeatures(),
         st.loadAllPhases(),
-        st.loadProject(),
-        st.loadResume(),
+        st.loadResume(plannerSessionId),
         st.listHandoffs(),
         st.listArchivedHandoffs(),
     ]);
-    const result = recommendNextWork(features.features, phases, project.workDeviations, resume?.currentPhaseId, "", {
+    const result = recommendNextWork(features.features, phases, await st.listAllWorkDeviations(), resume?.currentPhaseId, plannerSessionId, {
         handoffs: handoffs.map((handoff) => ({
             compositeRef: handoff.compositeRef,
             firstLine: handoff.firstLine,
@@ -2023,13 +2024,14 @@ server.registerTool("planner-task-recommend", {
 server.registerTool("planner-task-deviation", {
     description: "Record a user-approved temporary task deviation. It preserves the recommended/resume task and never starts, pauses, or blocks work; use normal lifecycle tools for those transitions.",
     inputSchema: { temporary_task: z.string().min(1), resume_task: z.string().min(1).optional(), reason: z.string().min(1) },
-}, async ({ temporary_task, resume_task, reason }) => {
+}, async ({ temporary_task, resume_task, reason }, extra) => {
+    const plannerSessionId = plannerSessionIdFor(extra);
     const st = await requireStore();
-    const [features, phases, project, focus] = await Promise.all([st.loadFeatures(), st.loadAllPhases(), st.loadProject(), st.loadResume()]);
+    const [features, phases, focus] = await Promise.all([st.loadFeatures(), st.loadAllPhases(), st.loadResume(plannerSessionId)]);
     const temporary = findTaskByRef(phases, features.features, temporary_task);
     if (!temporary)
         return text(`Task not found: ${temporary_task}`);
-    const selected = recommendNextTask(features.features, phases, project.workDeviations, focus?.currentPhaseId);
+    const selected = recommendNextTask(features.features, phases, await st.listAllWorkDeviations(), focus?.currentPhaseId, plannerSessionId);
     const resume = resume_task ? findTaskByRef(phases, features.features, resume_task) : selected.candidate;
     if (!resume)
         return text(`No resume task is available. Provide resume_task explicitly. ${selected.reason}`);
@@ -2044,7 +2046,7 @@ server.registerTool("planner-task-deviation", {
         requestedBy: "user", approvedBy: "user", state: "approved",
         createdAt: timestamp, activatedAt: "", resumeRequiredAt: "", resolvedAt: "", resumedAt: "",
     };
-    await st.addWorkDeviation(record);
+    await st.addWorkDeviation(record, plannerSessionId);
     return writeAndSummarize(st, `✅ Approved deviation: ${taskCompositeRef(temporary.task, temporary.phase, features.features)} temporarily overrides ${taskCompositeRef(resume.task, resume.phase, features.features)}. Resume target retained.`, { deviation: record });
 });
 server.registerTool("planner-task-pause", {
@@ -2074,7 +2076,7 @@ server.registerTool("planner-task-pause", {
     invalidateReads(plannerSessionId);
     const checkpointed = await st.pauseTask(found.phase.id, found.task.id, snapshot);
     await st.syncTaskStatusRollup(found.phase.id);
-    const activeDeviation = (await st.loadProject()).workDeviations
+    const activeDeviation = (await st.loadProject(plannerSessionId)).workDeviations
         .filter((deviation) => (deviation.state === "approved" || deviation.state === "active")
         && deviation.temporaryTaskId === found.task.id)
         .sort((left, right) => right.createdAt.localeCompare(left.createdAt))[0];
@@ -2108,7 +2110,7 @@ server.registerTool("planner-task-switch", {
 }, async ({ from_task, to_task, reason, what_was_being_done, resume_location, how_to_resume, switched_by }, extra) => {
     const plannerSessionId = plannerSessionIdFor(extra);
     const st = await requireStore();
-    const [featuresDoc, phases, project, focus] = await Promise.all([st.loadFeatures(), st.loadAllPhases(), st.loadProject(), st.loadResume()]);
+    const [featuresDoc, phases, project, focus] = await Promise.all([st.loadFeatures(), st.loadAllPhases(), st.loadProject(plannerSessionId), st.loadResume(plannerSessionId)]);
     const features = featuresDoc.features;
     const source = findTaskByRef(phases, features, from_task);
     const target = findTaskByRef(phases, features, to_task);
@@ -2172,7 +2174,7 @@ server.registerTool("planner-task-switch", {
         resumeLocation: resume_location, howToResume: how_to_resume,
         relatedTaskId: target.task.id, pausedAt: timestamp, pausedBy: switched_by?.trim() ?? "",
     };
-    const selection = recommendNextTask(features, phases, project.workDeviations, focus?.currentPhaseId, plannerSessionId);
+    const selection = recommendNextTask(features, phases, await st.listAllWorkDeviations(), focus?.currentPhaseId, plannerSessionId);
     const record = {
         id: crypto.randomUUID(), recommendedTaskId: selection.candidate?.task.id ?? source.task.id,
         temporaryTaskId: target.task.id, resumeTaskId: source.task.id, reason, snapshot,
@@ -2222,7 +2224,7 @@ server.registerTool("planner-task-switch", {
                 });
             }
             targetStarted = true;
-            await st.addWorkDeviation(record);
+            await st.addWorkDeviation(record, plannerSessionId);
             if (target.task.pauseSnapshot) {
                 const resumedDeviation = project.workDeviations
                     .filter((deviation) => deviation.resumeTaskId === target.task.id
@@ -2306,7 +2308,7 @@ server.registerTool("planner-task-start", {
         const featureRef = parentFeature ? formatFeatureRef(parentFeature.number) : "";
         if (found.task.status === "done")
             return taskStartError(taskStartDenied("TASK_DONE", `Task ${taskRef} is done and was not reopened.`, [`Use planner-task-reopen with task=${taskRef} and confirmed=true after explicit user confirmation.`, `Retry planner-task-start ${taskRef} only if reopening is not the intended operation.`], { taskId: found.task.id }));
-        const project = await st.loadProject();
+        const project = await st.loadProject(plannerSessionId);
         // Targeted stale-context refresh (P102(F005)/T404): task-start delivery
         // stays scoped to feature/phase/task context, but a session that already
         // did a full planner-load gets a non-blocking advisory when project-level
@@ -2350,11 +2352,11 @@ server.registerTool("planner-task-start", {
             const phaseOrderAdvisory = higherPriorityOpenPhaseAdvisory(higherPriorityPhase);
             return text(`✅ Task already started: ${taskRef} — ${found.task.title} (in-progress)\nstarted: true${projectContextAdvisory}${phaseOrderAdvisory}`, { ...outcome, task: found.task, projectContextStale: projectContextReadState === "stale", higherPriorityOpenPhase: higherPriorityPhase });
         }
-        const [phases, focus] = await Promise.all([st.loadAllPhases(), st.loadResume()]);
+        const [phases, focus] = await Promise.all([st.loadAllPhases(), st.loadResume(plannerSessionId)]);
         const eligibility = checkExplicitTaskStart(features, phases, found.task.id, project.workDeviations);
         if (!eligibility.eligible)
             return taskStartError(taskStartDenied("START_NOT_ALLOWED", eligibility.reason, ["Resolve the reported task readiness condition, then retry planner-task-start."], { taskId: found.task.id }), { eligibility });
-        const selection = recommendNextTask(features, phases, project.workDeviations, focus?.currentPhaseId, plannerSessionId);
+        const selection = recommendNextTask(features, phases, await st.listAllWorkDeviations(), focus?.currentPhaseId, plannerSessionId);
         if (selection.kind === "conflict") {
             return taskStartError(taskStartDenied("ACTIVE_TASK_CONFLICT", selection.reason, ["Pause or reconcile the active tasks.", `Retry planner-task-start ${taskRef}.`], { taskId: found.task.id }), { selection });
         }
@@ -2464,7 +2466,8 @@ server.registerTool("planner-task-complete", {
         motivation: z.string().optional().describe("Required when force=true overrides unchecked checklist items: why the checklist no longer matches the work."),
         description_update: z.string().min(10).describe("Required evidence: shipped work, verification level including partial verification, remaining/unverified work, files, decisions, and updated code references."),
     },
-}, async ({ task: ref, force, motivation, description_update }) => {
+}, async ({ task: ref, force, motivation, description_update }, extra) => {
+    const plannerSessionId = plannerSessionIdFor(extra);
     const st = await requireStore();
     const found = findTaskByRef(await st.loadAllPhases(), (await st.loadFeatures()).features, ref);
     if (!found)
@@ -2510,7 +2513,7 @@ server.registerTool("planner-task-complete", {
         return phase;
     });
     const clearedRef = await st.syncTaskStatusRollup(found.phase.id);
-    const completedDeviation = (await st.loadProject()).workDeviations
+    const completedDeviation = (await st.loadProject(plannerSessionId)).workDeviations
         .filter((deviation) => (deviation.state === "approved" || deviation.state === "active") && deviation.temporaryTaskId === found.task.id)
         .sort((left, right) => right.createdAt.localeCompare(left.createdAt))[0];
     if (completedDeviation)
@@ -3167,7 +3170,7 @@ server.registerTool("planner-load", {
     const plannerSkill = await st.syncPlannerSkill();
     await st.syncGrillMeSkill();
     const web = await ensureWebStarted();
-    const recap = await buildRecap(st, web, { harness: "mcp" });
+    const recap = await buildRecap(st, web, { harness: "mcp", sessionId: plannerSessionId });
     const plan = await st.loadAll();
     // Explicit planner load must deliver the complete project-level context
     // (P102(F005)/T404), attested through the same lossless contract used

package/package.json

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