@knowsuchagency/fulcrum 3.3.0 → 3.4.0

package/bin/fulcrum.js

@@ -44351,6 +44351,27 @@ var init_registry = __esm(() => {
       keywords: ["memory", "store", "save", "remember", "knowledge", "persist", "fact"],
       defer_loading: false
     },
+    {
+      name: "memory_search",
+      description: "Search persistent memories using full-text search (FTS5)",
+      category: "memory",
+      keywords: ["memory", "search", "find", "query", "fts", "recall", "knowledge"],
+      defer_loading: false
+    },
+    {
+      name: "memory_list",
+      description: "List persistent memories with optional tag filter",
+      category: "memory",
+      keywords: ["memory", "list", "browse", "tags", "filter", "all"],
+      defer_loading: false
+    },
+    {
+      name: "memory_delete",
+      description: "Delete a persistent memory by ID",
+      category: "memory",
+      keywords: ["memory", "delete", "remove", "clean", "resolved", "outdated"],
+      defer_loading: false
+    },
     {
       name: "memory_file_read",
       description: "Read the master memory file (MEMORY.md)",
@@ -44464,7 +44485,7 @@ function getTodayInTimezone(timezone) {
 
 // cli/src/mcp/tools/tasks.ts
 import { basename as basename2 } from "path";
-var registerTaskTools = (server, client) => {
+function registerListTasks(server, client) {
   server.tool("list_tasks", "List all Fulcrum tasks with flexible filtering. Supports text search across title/tags/project, multi-tag filtering (OR logic), multi-status filtering, date range, and overdue detection.", {
     status: exports_external.optional(TaskStatusSchema2).describe("Filter by single task status (use statuses for multiple)"),
     statuses: exports_external.optional(exports_external.array(TaskStatusSchema2)).describe("Filter by multiple statuses (OR logic)"),
@@ -44556,20 +44577,8 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("get_task", "Get details of a specific task by ID, including dependencies and attachments", {
-    id: exports_external.string().describe("Task ID (UUID)")
-  }, async ({ id }) => {
-    try {
-      const [task, dependencies, attachments] = await Promise.all([
-        client.getTask(id),
-        client.getTaskDependencies(id),
-        client.listTaskAttachments(id)
-      ]);
-      return formatSuccess({ ...task, dependencies, attachments });
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
+}
+function registerCreateTask(server, client) {
   server.tool("create_task", "Create a new task. For worktree tasks, provide repoPath to create a git worktree. For non-worktree tasks, omit repoPath. When tags are provided, returns all existing tags for reference.", {
     title: exports_external.string().describe("Task title"),
     repoPath: exports_external.optional(exports_external.string()).describe("Absolute path to the git repository (optional for non-worktree tasks)"),
@@ -44630,6 +44639,8 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerUpdateTask(server, client) {
   server.tool("update_task", "Update task metadata (title or description)", {
     id: exports_external.string().describe("Task ID"),
     title: exports_external.optional(exports_external.string()).describe("New title"),
@@ -44647,6 +44658,82 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerAddTaskLink(server, client) {
+  server.tool("add_task_link", "Add a URL link to a task (for documentation, related PRs, design files, etc.)", {
+    taskId: exports_external.string().describe("Task ID"),
+    url: exports_external.string().url().describe("URL to add"),
+    label: exports_external.optional(exports_external.string()).describe("Display label (auto-detected if not provided)")
+  }, async ({ taskId, url: url2, label }) => {
+    try {
+      const link = await client.addTaskLink(taskId, url2, label);
+      return formatSuccess(link);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerAddTaskTag(server, client) {
+  server.tool("add_task_tag", "Add a tag to a task for categorization. Returns similar existing tags to help catch typos.", {
+    taskId: exports_external.string().describe("Task ID"),
+    tag: exports_external.string().describe("Tag to add")
+  }, async ({ taskId, tag }) => {
+    try {
+      const result = await client.addTaskTag(taskId, tag);
+      const allTasks = await client.listTasks();
+      const existingTags = new Set;
+      for (const t2 of allTasks) {
+        if (t2.tags) {
+          for (const tg of t2.tags) {
+            existingTags.add(tg);
+          }
+        }
+      }
+      const tagLower = tag.toLowerCase();
+      const similarTags = Array.from(existingTags).filter((tg) => tg !== tag && (tg.toLowerCase().includes(tagLower) || tagLower.includes(tg.toLowerCase())));
+      return formatSuccess({
+        ...result,
+        similarTags: similarTags.length > 0 ? similarTags : undefined
+      });
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerSetTaskDueDate(server, client) {
+  server.tool("set_task_due_date", "Set or clear the due date for a task", {
+    taskId: exports_external.string().describe("Task ID"),
+    dueDate: exports_external.nullable(exports_external.string()).describe("Due date in YYYY-MM-DD format, or null to clear")
+  }, async ({ taskId, dueDate }) => {
+    try {
+      const result = await client.setTaskDueDate(taskId, dueDate);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+var registerTaskTools = (server, client) => {
+  registerListTasks(server, client);
+  registerCreateTask(server, client);
+  registerUpdateTask(server, client);
+  registerAddTaskLink(server, client);
+  registerAddTaskTag(server, client);
+  registerSetTaskDueDate(server, client);
+  server.tool("get_task", "Get details of a specific task by ID, including dependencies and attachments", {
+    id: exports_external.string().describe("Task ID (UUID)")
+  }, async ({ id }) => {
+    try {
+      const [task, dependencies, attachments] = await Promise.all([
+        client.getTask(id),
+        client.getTaskDependencies(id),
+        client.listTaskAttachments(id)
+      ]);
+      return formatSuccess({ ...task, dependencies, attachments });
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
   server.tool("delete_task", "Delete a task and optionally its linked git worktree", {
     id: exports_external.string().describe("Task ID"),
     deleteWorktree: exports_external.optional(exports_external.boolean()).describe("Also delete the linked git worktree (default: false)")
@@ -44671,18 +44758,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("add_task_link", "Add a URL link to a task (for documentation, related PRs, design files, etc.)", {
-    taskId: exports_external.string().describe("Task ID"),
-    url: exports_external.string().url().describe("URL to add"),
-    label: exports_external.optional(exports_external.string()).describe("Display label (auto-detected if not provided)")
-  }, async ({ taskId, url: url2, label }) => {
-    try {
-      const link = await client.addTaskLink(taskId, url2, label);
-      return formatSuccess(link);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("remove_task_link", "Remove a URL link from a task", {
     taskId: exports_external.string().describe("Task ID"),
     linkId: exports_external.string().describe("Link ID to remove")
@@ -44704,31 +44779,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("add_task_tag", "Add a tag to a task for categorization. Returns similar existing tags to help catch typos.", {
-    taskId: exports_external.string().describe("Task ID"),
-    tag: exports_external.string().describe("Tag to add")
-  }, async ({ taskId, tag }) => {
-    try {
-      const result = await client.addTaskTag(taskId, tag);
-      const allTasks = await client.listTasks();
-      const existingTags = new Set;
-      for (const t2 of allTasks) {
-        if (t2.tags) {
-          for (const tg of t2.tags) {
-            existingTags.add(tg);
-          }
-        }
-      }
-      const tagLower = tag.toLowerCase();
-      const similarTags = Array.from(existingTags).filter((tg) => tg !== tag && (tg.toLowerCase().includes(tagLower) || tagLower.includes(tg.toLowerCase())));
-      return formatSuccess({
-        ...result,
-        similarTags: similarTags.length > 0 ? similarTags : undefined
-      });
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("remove_task_tag", "Remove a tag from a task", {
     taskId: exports_external.string().describe("Task ID"),
     tag: exports_external.string().describe("Tag to remove")
@@ -44740,17 +44790,6 @@ var registerTaskTools = (server, client) => {
       return handleToolError(err);
     }
   });
-  server.tool("set_task_due_date", "Set or clear the due date for a task", {
-    taskId: exports_external.string().describe("Task ID"),
-    dueDate: exports_external.nullable(exports_external.string()).describe("Due date in YYYY-MM-DD format, or null to clear")
-  }, async ({ taskId, dueDate }) => {
-    try {
-      const result = await client.setTaskDueDate(taskId, dueDate);
-      return formatSuccess(result);
-    } catch (err) {
-      return handleToolError(err);
-    }
-  });
   server.tool("get_task_dependencies", "Get the dependencies and dependents of a task, and whether it is blocked", {
     taskId: exports_external.string().describe("Task ID")
   }, async ({ taskId }) => {
@@ -45841,8 +45880,9 @@ var ChannelSchema, registerAssistantTools = (server, client) => {
     subject: exports_external.optional(exports_external.string()).describe("Email subject (for Gmail channel only)"),
     replyToMessageId: exports_external.optional(exports_external.string()).describe("Message ID to reply to (for threading)"),
     slack_blocks: exports_external.optional(exports_external.array(exports_external.record(exports_external.string(), exports_external.any()))).describe("Slack Block Kit blocks for rich formatting (Slack channel only). Array of block objects."),
+    filePath: exports_external.optional(exports_external.string()).describe("Absolute path to a local file to upload alongside the message (Slack only). Use for sending images, documents, etc."),
     googleAccountId: exports_external.optional(exports_external.string()).describe("Google account ID for Gmail channel. If omitted, auto-resolves when exactly one Gmail-enabled account exists.")
-  }, async ({ channel, body, subject, replyToMessageId, slack_blocks, googleAccountId }) => {
+  }, async ({ channel, body, subject, replyToMessageId, slack_blocks, filePath, googleAccountId }) => {
     try {
       if (channel === "gmail") {
         let accountId = googleAccountId;
@@ -45865,7 +45905,8 @@ var ChannelSchema, registerAssistantTools = (server, client) => {
         body,
         subject,
         replyToMessageId,
-        slackBlocks: slack_blocks
+        slackBlocks: slack_blocks,
+        filePath
       });
       return formatSuccess(result);
     } catch (err) {
@@ -46152,7 +46193,7 @@ var init_types5 = __esm(() => {
 });
 
 // cli/src/mcp/tools/memory.ts
-var registerMemoryTools = (server, client) => {
+function registerMemoryStoreTool(server, client) {
   server.tool("memory_store", "Store a piece of knowledge in persistent memory. Use this to remember facts, preferences, decisions, patterns, or any information that should persist across conversations.", {
     content: exports_external.string().describe("The memory content to store. Be specific and self-contained."),
     tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Optional tags for categorization (e.g., ["preference", "architecture", "decision"])'),
@@ -46165,6 +46206,52 @@ var registerMemoryTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}
+function registerMemorySearchTool(server, client) {
+  server.tool("memory_search", 'Search persistent memories using full-text search (FTS5). Supports boolean operators (AND, OR, NOT), phrase matching ("quoted"), and prefix matching (term*).', {
+    query: exports_external.string().describe('Search query. Supports FTS5 syntax: AND, OR, NOT, "phrases", prefix*'),
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter by tags (e.g., ["actionable", "preference"])'),
+    limit: exports_external.optional(exports_external.number()).describe("Max results to return (default: 20)")
+  }, async ({ query, tags, limit }) => {
+    try {
+      const result = await client.searchMemories({ query, tags, limit });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerMemoryListTool(server, client) {
+  server.tool("memory_list", "List all persistent memories, optionally filtered by tags. Returns memories sorted by creation date (newest first).", {
+    tags: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter by tags (e.g., ["actionable"])'),
+    limit: exports_external.optional(exports_external.number()).describe("Max results to return (default: 50)"),
+    offset: exports_external.optional(exports_external.number()).describe("Offset for pagination")
+  }, async ({ tags, limit, offset }) => {
+    try {
+      const result = await client.listMemories({ tags, limit, offset });
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+function registerMemoryDeleteTool(server, client) {
+  server.tool("memory_delete", "Delete a persistent memory by ID. Use this to clean up resolved or outdated memories.", {
+    id: exports_external.string().describe("The ID of the memory to delete")
+  }, async ({ id }) => {
+    try {
+      const result = await client.deleteMemory(id);
+      return formatSuccess(result);
+    } catch (err) {
+      return handleToolError(err);
+    }
+  });
+}
+var registerMemoryTools = (server, client) => {
+  registerMemoryStoreTool(server, client);
+  registerMemorySearchTool(server, client);
+  registerMemoryListTool(server, client);
+  registerMemoryDeleteTool(server, client);
 };
 var init_memory = __esm(() => {
   init_zod2();
@@ -46173,7 +46260,7 @@ var init_memory = __esm(() => {
 });
 
 // cli/src/mcp/tools/memory-file.ts
-var registerMemoryFileTools = (server, client) => {
+var registerMemoryFileReadTool = (server, client) => {
   server.tool("memory_file_read", "Read the master memory file (MEMORY.md). This file contains persistent knowledge, user preferences, and instructions that are included in every conversation.", {}, async () => {
     try {
       const result = await client.readMemoryFile();
@@ -46182,6 +46269,8 @@ var registerMemoryFileTools = (server, client) => {
       return handleToolError(err);
     }
   });
+}, registerMemoryFileTools = (server, client) => {
+  registerMemoryFileReadTool(server, client);
   server.tool("memory_file_update", "Update the master memory file. Provide full content to replace the entire file, or specify a section heading to update just that section. The memory file is included in every conversation, so keep it organized and concise.", {
     content: exports_external.string().describe("The content to write. If section is specified, this replaces only that section body."),
     section: exports_external.optional(exports_external.string()).describe('Optional markdown heading (e.g., "## Preferences") to update a specific section. If omitted, replaces the entire file.')
@@ -46332,7 +46421,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "3.3.0"
+    version: "3.4.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48681,7 +48770,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "3.3.0",
+      "version": "3.4.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49885,7 +49974,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "3.3.0",
+  version: "3.4.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",
@@ -49901,7 +49990,7 @@ var package_default = {
     "db:studio": "drizzle-kit studio"
   },
   dependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.34",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.37",
     "@atlaskit/pragmatic-drag-and-drop": "^1.7.7",
     "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
     "@azurity/pure-nerd-font": "^3.0.5",