@contextstream/mcp-server 0.4.13 → 0.4.16

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 = {
@@ -9387,6 +9420,30 @@ Upgrade: ${upgradeUrl2}` : "";
     }
     return { ok: true, resolvedPath };
   }
+  function startBackgroundIngest(projectId, resolvedPath, ingestOptions, options = {}) {
+    (async () => {
+      try {
+        if (options.preflight) {
+          const fileCheck = await countIndexableFiles(resolvedPath, { maxFiles: 1 });
+          if (fileCheck.count === 0) {
+            console.error(`[ContextStream] No indexable files found in ${resolvedPath}. Skipping ingest.`);
+            return;
+          }
+        }
+        let totalIndexed = 0;
+        let batchCount = 0;
+        console.error(`[ContextStream] Starting background ingestion for project ${projectId} from ${resolvedPath}`);
+        for await (const batch of readAllFilesInBatches(resolvedPath, { batchSize: 50 })) {
+          const result = await client.ingestFiles(projectId, batch, ingestOptions);
+          totalIndexed += result.data?.files_indexed ?? batch.length;
+          batchCount++;
+        }
+        console.error(`[ContextStream] Completed background ingestion: ${totalIndexed} files in ${batchCount} batches`);
+      } catch (error) {
+        console.error(`[ContextStream] Ingestion failed:`, error);
+      }
+    })();
+  }
   registerTool(
     "mcp_server_version",
     {
@@ -10323,7 +10380,8 @@ ${formatContent(result)}`
       title: "Ingest local files",
       description: `Read ALL files from a local directory and ingest them for indexing.
 This indexes your entire project by reading files in batches.
-Automatically detects code files and skips ignored directories like node_modules, target, dist, etc.`,
+Automatically detects code files and skips ignored directories like node_modules, target, dist, etc.
+Runs in the background and returns immediately; use 'projects_index_status' to monitor progress.`,
       inputSchema: external_exports.object({
         project_id: external_exports.string().uuid().optional().describe("Project to ingest files into (defaults to current session project)"),
         path: external_exports.string().describe("Local directory path to read files from"),
@@ -10340,31 +10398,11 @@ Automatically detects code files and skips ignored directories like node_modules
       if (!pathCheck.ok) {
         return errorResult(pathCheck.error);
       }
-      const fileCheck = await countIndexableFiles(pathCheck.resolvedPath, { maxFiles: 1 });
-      if (fileCheck.count === 0) {
-        return errorResult(
-          `Error: no indexable files found in directory: ${input.path}. The directory may be empty or contain only ignored files/directories. Supported file types include: .ts, .js, .py, .rs, .go, .java, .md, .json, etc.`
-        );
-      }
       const ingestOptions = {
         ...input.write_to_disk !== void 0 && { write_to_disk: input.write_to_disk },
         ...input.overwrite !== void 0 && { overwrite: input.overwrite }
       };
-      (async () => {
-        try {
-          let totalIndexed = 0;
-          let batchCount = 0;
-          console.error(`[ContextStream] Starting background ingestion for project ${projectId} from ${pathCheck.resolvedPath}`);
-          for await (const batch of readAllFilesInBatches(pathCheck.resolvedPath, { batchSize: 50 })) {
-            const result = await client.ingestFiles(projectId, batch, ingestOptions);
-            totalIndexed += result.data?.files_indexed ?? batch.length;
-            batchCount++;
-          }
-          console.error(`[ContextStream] Completed background ingestion: ${totalIndexed} files in ${batchCount} batches`);
-        } catch (error) {
-          console.error(`[ContextStream] Ingestion failed:`, error);
-        }
-      })();
+      startBackgroundIngest(projectId, pathCheck.resolvedPath, ingestOptions, { preflight: true });
       const summary = {
         status: "started",
         message: "Ingestion running in background",
@@ -12864,7 +12902,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 +12966,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 +13173,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,
@@ -13455,24 +13494,27 @@ Use this to remove a reminder that is no longer relevant.`,
             if (!validPath.ok) {
               return errorResult(validPath.error);
             }
-            let totalFiles = 0;
-            let batches = 0;
-            for await (const batch of readAllFilesInBatches(validPath.resolvedPath, { batchSize: 50 })) {
-              if (batch.length === 0) continue;
-              await client.ingestFiles(projectId, batch, {
-                overwrite: input.overwrite,
-                write_to_disk: input.write_to_disk
-              });
-              totalFiles += batch.length;
-              batches += 1;
-            }
+            const ingestOptions = {
+              ...input.write_to_disk !== void 0 && { write_to_disk: input.write_to_disk },
+              ...input.overwrite !== void 0 && { overwrite: input.overwrite }
+            };
+            startBackgroundIngest(projectId, validPath.resolvedPath, ingestOptions);
             const result = {
+              status: "started",
+              message: "Ingestion running in background",
               project_id: projectId,
-              files_ingested: totalFiles,
-              batches,
-              path: validPath.resolvedPath
+              path: validPath.resolvedPath,
+              ...input.write_to_disk !== void 0 && { write_to_disk: input.write_to_disk },
+              ...input.overwrite !== void 0 && { overwrite: input.overwrite },
+              note: "Use 'project' with action 'index_status' to monitor progress."
+            };
+            return {
+              content: [{
+                type: "text",
+                text: `Ingestion started in background for directory: ${validPath.resolvedPath}. Use 'project' with action 'index_status' to monitor progress.`
+              }],
+              structuredContent: toStructured(result)
             };
-            return { content: [{ type: "text", text: formatContent(result) }], structuredContent: toStructured(result) };
           }
           default:
             return errorResult(`Unknown action: ${input.action}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.13",
+  "version": "0.4.16",
   "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",