@contextstream/mcp-server 0.4.13 → 0.4.15

package/dist/index.js

@@ -7453,6 +7453,7 @@ W:${wsHint}
    */
   async updateTask(params) {
     uuidSchema.parse(params.task_id);
+    if (params.plan_id) uuidSchema.parse(params.plan_id);
     const { task_id, ...updates } = params;
     return request(this.config, `/tasks/${task_id}`, { method: "PATCH", body: updates });
   }
@@ -7635,6 +7636,23 @@ Only after this preflight, proceed with search/analysis below.
 
 ---
 
+### Plans & Tasks
+
+When user asks to create a plan or implementation roadmap:
+1. Create plan: \`session(action="capture_plan", title="Plan Title", description="...", goals=["goal1", "goal2"], steps=[{id: "1", title: "Step 1", order: 1}, ...])\`
+2. Get plan_id from response, then create tasks: \`memory(action="create_task", title="Task Title", plan_id="<plan_id>", priority="high|medium|low", description="...")\`
+
+To manage existing plans/tasks:
+- List plans: \`session(action="list_plans")\`
+- Get plan with tasks: \`session(action="get_plan", plan_id="<uuid>", include_tasks=true)\`
+- List tasks: \`memory(action="list_tasks", plan_id="<uuid>")\` or \`memory(action="list_tasks")\` for all
+- Update task status: \`memory(action="update_task", task_id="<uuid>", task_status="pending|in_progress|completed|blocked")\`
+- Link task to plan: \`memory(action="update_task", task_id="<uuid>", plan_id="<plan_uuid>")\`
+- Unlink task from plan: \`memory(action="update_task", task_id="<uuid>", plan_id=null)\`
+- Delete: \`memory(action="delete_task", task_id="<uuid>")\` or \`memory(action="delete_event", event_id="<plan_uuid>")\`
+
+---
+
 ### Complete Action Reference
 
 **session actions:**
@@ -7702,6 +7720,21 @@ v0.4.x uses ~11 consolidated domain tools for ~75% token reduction vs previous v
 - **After completing work**: Always capture decisions/insights with \`session(action="capture")\`
 - **On mistakes/corrections**: Immediately capture lessons with \`session(action="capture_lesson")\`
 
+### Plans & Tasks
+
+When user asks to create a plan or implementation roadmap:
+1. Create plan: \`session(action="capture_plan", title="Plan Title", description="...", goals=["goal1", "goal2"], steps=[{id: "1", title: "Step 1", order: 1}, ...])\`
+2. Get plan_id from response, then create tasks: \`memory(action="create_task", title="Task Title", plan_id="<plan_id>", priority="high|medium|low", description="...")\`
+
+To manage existing plans/tasks:
+- List plans: \`session(action="list_plans")\`
+- Get plan with tasks: \`session(action="get_plan", plan_id="<uuid>", include_tasks=true)\`
+- List tasks: \`memory(action="list_tasks", plan_id="<uuid>")\` or \`memory(action="list_tasks")\` for all
+- Update task status: \`memory(action="update_task", task_id="<uuid>", task_status="pending|in_progress|completed|blocked")\`
+- Link task to plan: \`memory(action="update_task", task_id="<uuid>", plan_id="<plan_uuid>")\`
+- Unlink task from plan: \`memory(action="update_task", task_id="<uuid>", plan_id=null)\`
+- Delete: \`memory(action="delete_task", task_id="<uuid>")\` or \`memory(action="delete_event", event_id="<plan_uuid>")\`
+
 Full docs: https://contextstream.io/docs/mcp/tools
 `.trim();
 var TEMPLATES = {
@@ -12864,7 +12897,7 @@ Use this to remove a reminder that is no longer relevant.`,
       "memory",
       {
         title: "Memory",
-        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event. Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary. Task actions: create_task (create task, optionally linked to plan), get_task, update_task, delete_task, list_tasks, reorder_tasks.`,
+        description: `Memory operations for events and nodes. Event actions: create_event, get_event, update_event, delete_event, list_events, distill_event. Node actions: create_node, get_node, update_node, delete_node, list_nodes, supersede_node. Query actions: search, decisions, timeline, summary. Task actions: create_task (create task, optionally linked to plan), get_task, update_task (can link/unlink task to plan via plan_id), delete_task, list_tasks, reorder_tasks.`,
         inputSchema: external_exports.object({
           action: external_exports.enum([
             "create_event",
@@ -12928,7 +12961,7 @@ Use this to remove a reminder that is no longer relevant.`,
           })).optional(),
           // Task-specific params
           task_id: external_exports.string().uuid().optional().describe("Task ID for get_task/update_task/delete_task"),
-          plan_id: external_exports.string().uuid().optional().describe("Parent plan ID for create_task/list_tasks"),
+          plan_id: external_exports.string().uuid().nullable().optional().describe("Plan ID: for create_task (link to plan), update_task (set UUID to link, null to unlink), list_tasks (filter by plan)"),
           plan_step_id: external_exports.string().optional().describe("Which plan step this task implements"),
           description: external_exports.string().optional().describe("Description for task"),
           task_status: external_exports.enum(["pending", "in_progress", "completed", "blocked", "cancelled"]).optional().describe("Task status"),
@@ -13135,6 +13168,7 @@ Use this to remove a reminder that is no longer relevant.`,
               status: input.task_status,
               priority: input.priority,
               order: input.order,
+              plan_id: input.plan_id,
               plan_step_id: input.plan_step_id,
               code_refs: input.code_refs,
               tags: input.tags,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
   "type": "module",
   "license": "MIT",