@knowsuchagency/fulcrum 2.15.3 → 2.16.0

package/README.md

@@ -253,7 +253,7 @@ Both plugins include an MCP server with 60+ tools:
 | **Notifications** | Send notifications to enabled channels |
 | **Backup & Restore** | Snapshot database and settings; auto-safety-backup on restore |
 | **Settings** | View and update configuration; manage notification channels |
-| **Search** | Unified full-text search across tasks, projects, messages, events, and memories |
+| **Search** | Unified full-text search across tasks, projects, messages, events, memories, and conversations |
 | **Memory** | Read/update master memory file; store ephemeral knowledge with tags |
 | **Calendar** | Manage CalDAV accounts, sync calendars, configure event copy rules |
 | **Gmail** | List Google accounts, manage Gmail drafts (create, update, delete) |

package/bin/fulcrum.js

@@ -1695,6 +1695,12 @@ class FulcrumClient {
       params.set("eventTo", input.eventTo);
     if (input.memoryTags?.length)
       params.set("memoryTags", input.memoryTags.join(","));
+    if (input.conversationRole)
+      params.set("conversationRole", input.conversationRole);
+    if (input.conversationProvider)
+      params.set("conversationProvider", input.conversationProvider);
+    if (input.conversationProjectId)
+      params.set("conversationProjectId", input.conversationProjectId);
     return this.fetch(`/api/search?${params.toString()}`);
   }
 }
@@ -46142,9 +46148,9 @@ var init_memory_file = __esm(() => {
 
 // cli/src/mcp/tools/search.ts
 var EntityTypeSchema, registerSearchTools = (server, client) => {
-  server.tool("search", 'Search across all Fulcrum entities (tasks, projects, messages, calendar events, memories) using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Returns results ranked by relevance.', {
+  server.tool("search", 'Search across all Fulcrum entities (tasks, projects, messages, calendar events, memories, conversations) using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Returns results ranked by relevance.', {
     query: exports_external.string().describe('FTS5 search query. Supports: AND, OR, NOT operators, "quoted phrases", prefix* matching. Example: "kubernetes deployment" OR k8s'),
-    entities: exports_external.optional(exports_external.array(EntityTypeSchema)).describe("Entity types to search. Defaults to all: tasks, projects, messages, events, memories"),
+    entities: exports_external.optional(exports_external.array(EntityTypeSchema)).describe("Entity types to search. Defaults to all: tasks, projects, messages, events, memories, conversations"),
     limit: exports_external.optional(exports_external.number()).describe("Maximum results per entity type (default: 10)"),
     taskStatus: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter tasks by status (e.g., ["IN_PROGRESS", "TO_DO"])'),
     projectStatus: exports_external.optional(exports_external.enum(["active", "archived"])).describe("Filter projects by status"),
@@ -46152,8 +46158,11 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
     messageDirection: exports_external.optional(exports_external.enum(["incoming", "outgoing"])).describe("Filter messages by direction"),
     eventFrom: exports_external.optional(exports_external.string()).describe("Filter calendar events starting from this date (ISO 8601)"),
     eventTo: exports_external.optional(exports_external.string()).describe("Filter calendar events up to this date (ISO 8601)"),
-    memoryTags: exports_external.optional(exports_external.array(exports_external.string())).describe("Filter memories by tags")
-  }, async ({ query, entities, limit, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags }) => {
+    memoryTags: exports_external.optional(exports_external.array(exports_external.string())).describe("Filter memories by tags"),
+    conversationRole: exports_external.optional(exports_external.string()).describe('Filter conversations by role (e.g., "user", "assistant")'),
+    conversationProvider: exports_external.optional(exports_external.string()).describe('Filter conversations by provider (e.g., "claude", "opencode")'),
+    conversationProjectId: exports_external.optional(exports_external.string()).describe("Filter conversations by project ID")
+  }, async ({ query, entities, limit, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags, conversationRole, conversationProvider, conversationProjectId }) => {
     try {
       const results = await client.search({
         query,
@@ -46165,7 +46174,10 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
         messageDirection,
         eventFrom,
         eventTo,
-        memoryTags
+        memoryTags,
+        conversationRole,
+        conversationProvider,
+        conversationProjectId
       });
       return formatSuccess(results);
     } catch (err) {
@@ -46176,7 +46188,7 @@ var EntityTypeSchema, registerSearchTools = (server, client) => {
 var init_search = __esm(() => {
   init_zod2();
   init_utils();
-  EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories"]);
+  EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations"]);
 });
 
 // cli/src/mcp/tools/index.ts
@@ -46235,7 +46247,7 @@ async function runMcpServer(urlOverride, portOverride) {
   const client = new FulcrumClient(urlOverride, portOverride);
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.15.3"
+    version: "2.16.0"
   });
   registerTools(server, client);
   const transport = new StdioServerTransport;
@@ -48584,7 +48596,7 @@ var marketplace_default = `{
       "name": "fulcrum",
       "source": "./",
       "description": "Task orchestration for Claude Code",
-      "version": "2.15.3",
+      "version": "2.16.0",
       "skills": [
         "./skills/fulcrum"
       ],
@@ -49772,7 +49784,7 @@ function compareVersions(v1, v2) {
 var package_default = {
   name: "@knowsuchagency/fulcrum",
   private: true,
-  version: "2.15.3",
+  version: "2.16.0",
   description: "Harness Attention. Orchestrate Agents. Ship.",
   license: "PolyForm-Perimeter-1.0.0",
   type: "module",

package/drizzle/0059_chat_messages_fts.sql

@@ -0,0 +1,37 @@
+-- FTS5 full-text search for chat messages (AI assistant conversations)
+-- Indexes content and denormalized session_title for search
+-- Excludes system role messages from index (system prompts pollute results)
+CREATE VIRTUAL TABLE `chat_messages_fts` USING fts5(
+	content,
+	session_title,
+	content=chat_messages,
+	content_rowid=rowid
+);--> statement-breakpoint
+CREATE TRIGGER chat_messages_fts_ai AFTER INSERT ON `chat_messages` BEGIN
+	INSERT INTO chat_messages_fts(rowid, content, session_title)
+	SELECT new.rowid, new.content,
+		COALESCE((SELECT title FROM chat_sessions WHERE id = new.session_id), '')
+	WHERE new.role != 'system';
+END;--> statement-breakpoint
+CREATE TRIGGER chat_messages_fts_ad AFTER DELETE ON `chat_messages` BEGIN
+	INSERT INTO chat_messages_fts(chat_messages_fts, rowid, content, session_title)
+	SELECT 'delete', old.rowid, old.content,
+		COALESCE((SELECT title FROM chat_sessions WHERE id = old.session_id), '')
+	WHERE old.role != 'system';
+END;--> statement-breakpoint
+CREATE TRIGGER chat_messages_fts_au AFTER UPDATE ON `chat_messages` BEGIN
+	INSERT INTO chat_messages_fts(chat_messages_fts, rowid, content, session_title)
+	SELECT 'delete', old.rowid, old.content,
+		COALESCE((SELECT title FROM chat_sessions WHERE id = old.session_id), '')
+	WHERE old.role != 'system';
+	INSERT INTO chat_messages_fts(rowid, content, session_title)
+	SELECT new.rowid, new.content,
+		COALESCE((SELECT title FROM chat_sessions WHERE id = new.session_id), '')
+	WHERE new.role != 'system';
+END;--> statement-breakpoint
+-- Backfill chat_messages_fts from existing data (excluding system messages)
+INSERT INTO chat_messages_fts(rowid, content, session_title)
+SELECT m.rowid, m.content,
+	COALESCE((SELECT title FROM chat_sessions WHERE id = m.session_id), '')
+FROM chat_messages m
+WHERE m.role != 'system';

package/drizzle/meta/_journal.json

@@ -414,6 +414,13 @@
       "when": 1771152800000,
       "tag": "0058_unified_search_fts",
       "breakpoints": true
+    },
+    {
+      "idx": 59,
+      "version": "6",
+      "when": 1771239200000,
+      "tag": "0059_chat_messages_fts",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowsuchagency/fulcrum",
-  "version": "2.15.3",
+  "version": "2.16.0",
   "description": "Harness Attention. Orchestrate Agents. Ship.",
   "license": "PolyForm-Perimeter-1.0.0",
   "repository": {

package/server/index.js

@@ -71229,9 +71229,10 @@ You have access to Fulcrum's MCP tools. Use them proactively to help users.
 - Use \`search\` with \`memoryTags: ["actionable"]\` to review tracked items
 
 **Unified Search:**
-- \`search\` - Cross-entity FTS5 full-text search across tasks, projects, messages, events, and memories
-  - Filter by entity type: \`entities: ["tasks", "projects", "messages", "events", "memories"]\`
-  - Entity-specific filters: \`taskStatus\`, \`projectStatus\`, \`messageChannel\`, \`messageDirection\`, \`eventFrom\`, \`eventTo\`, \`memoryTags\`
+- \`search\` - Cross-entity FTS5 full-text search across tasks, projects, messages, events, memories, and conversations
+  - Filter by entity type: \`entities: ["tasks", "projects", "messages", "events", "memories", "conversations"]\`
+  - Entity-specific filters: \`taskStatus\`, \`projectStatus\`, \`messageChannel\`, \`messageDirection\`, \`eventFrom\`, \`eventTo\`, \`memoryTags\`, \`conversationRole\`, \`conversationProvider\`, \`conversationProjectId\`
+  - Conversations search indexes AI assistant chat messages (excludes system prompts) with session context
   - Results sorted by relevance score with BM25 ranking
 
 **Memory File (Persistent Knowledge):**
@@ -71562,7 +71563,7 @@ Fulcrum is your digital concierge - a personal command center where you track ev
 - list_projects, create_project
 - execute_command (run any CLI command)
 - send_notification
-- search (unified FTS5 search across tasks, projects, messages, events, memories)
+- search (unified FTS5 search across tasks, projects, messages, events, memories, conversations)
 - memory_file_read, memory_file_update (master memory file - always in prompt)
 - memory_store (ephemeral knowledge snippets with tags)
 - message (send to email/WhatsApp - concierge mode)
@@ -1214393,7 +1214394,7 @@ async function updateTaskStatus(taskId, newStatus, newPosition) {
 // server/services/search-service.ts
 init_db2();
 init_drizzle_orm();
-var ALL_ENTITIES = ["tasks", "projects", "messages", "events", "memories"];
+var ALL_ENTITIES = ["tasks", "projects", "messages", "events", "memories", "conversations"];
 async function search(options) {
   const entities = options.entities?.length ? options.entities : ALL_ENTITIES;
   const limit = options.limit ?? 10;
@@ -1214409,6 +1214410,8 @@ async function search(options) {
         return searchEvents(options.query, { from: options.eventFrom, to: options.eventTo }, limit);
       case "memories":
         return searchMemories(options.query, { tags: options.memoryTags }, limit);
+      case "conversations":
+        return searchConversations(options.query, { role: options.conversationRole, provider: options.conversationProvider, projectId: options.conversationProjectId }, limit);
     }
   });
   const resultSets = await Promise.all(searches);
@@ -1214575,6 +1214578,43 @@ async function searchMemories(query, filters, limit) {
     }
   }));
 }
+async function searchConversations(query, filters, limit) {
+  const roleFilter = filters.role ? sql`AND m.role = ${filters.role}` : sql`AND m.role != 'system'`;
+  const providerFilter = filters.provider ? sql`AND s.provider = ${filters.provider}` : sql``;
+  const projectFilter = filters.projectId ? sql`AND s.project_id = ${filters.projectId}` : sql``;
+  const rows = db2.all(sql`SELECT m.id, m.content, m.role, m.session_id as "sessionId",
+        s.title as "sessionTitle", s.provider, s.project_id as "projectId",
+        m.created_at as "createdAt",
+        bm25(chat_messages_fts, 5.0, 2.0) as rank
+        FROM chat_messages_fts fts
+        JOIN chat_messages m ON m.rowid = fts.rowid
+        JOIN chat_sessions s ON s.id = m.session_id
+        WHERE chat_messages_fts MATCH ${query}
+          ${roleFilter}
+          ${providerFilter}
+          ${projectFilter}
+        ORDER BY bm25(chat_messages_fts, 5.0, 2.0)
+        LIMIT ${limit}`);
+  if (!rows.length)
+    return [];
+  const minRank = Math.min(...rows.map((r) => r.rank));
+  const maxRank = Math.max(...rows.map((r) => r.rank));
+  const range2 = maxRank - minRank || 1;
+  return rows.map((r) => ({
+    entityType: "conversation",
+    id: r.id,
+    title: r.sessionTitle || "Untitled conversation",
+    snippet: r.content.slice(0, 200),
+    score: 1 - (r.rank - minRank) / range2,
+    metadata: {
+      sessionId: r.sessionId,
+      role: r.role,
+      provider: r.provider,
+      projectId: r.projectId || undefined,
+      createdAt: r.createdAt
+    }
+  }));
+}
 function reindexTaskFTS(taskId) {
   db2.run(sql`
     UPDATE tasks SET updated_at = updated_at WHERE id = ${taskId}
@@ -1259594,11 +1259634,11 @@ var registerMemoryFileTools = (server, client) => {
 };
 
 // cli/src/mcp/tools/search.ts
-var EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories"]);
+var EntityTypeSchema = exports_external.enum(["tasks", "projects", "messages", "events", "memories", "conversations"]);
 var registerSearchTools = (server, client) => {
-  server.tool("search", 'Search across all Fulcrum entities (tasks, projects, messages, calendar events, memories) using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Returns results ranked by relevance.', {
+  server.tool("search", 'Search across all Fulcrum entities (tasks, projects, messages, calendar events, memories, conversations) using full-text search. Supports boolean operators (AND, OR, NOT), phrase matching ("quoted phrases"), and prefix matching (term*). Returns results ranked by relevance.', {
     query: exports_external.string().describe('FTS5 search query. Supports: AND, OR, NOT operators, "quoted phrases", prefix* matching. Example: "kubernetes deployment" OR k8s'),
-    entities: exports_external.optional(exports_external.array(EntityTypeSchema)).describe("Entity types to search. Defaults to all: tasks, projects, messages, events, memories"),
+    entities: exports_external.optional(exports_external.array(EntityTypeSchema)).describe("Entity types to search. Defaults to all: tasks, projects, messages, events, memories, conversations"),
     limit: exports_external.optional(exports_external.number()).describe("Maximum results per entity type (default: 10)"),
     taskStatus: exports_external.optional(exports_external.array(exports_external.string())).describe('Filter tasks by status (e.g., ["IN_PROGRESS", "TO_DO"])'),
     projectStatus: exports_external.optional(exports_external.enum(["active", "archived"])).describe("Filter projects by status"),
@@ -1259606,8 +1259646,11 @@ var registerSearchTools = (server, client) => {
     messageDirection: exports_external.optional(exports_external.enum(["incoming", "outgoing"])).describe("Filter messages by direction"),
     eventFrom: exports_external.optional(exports_external.string()).describe("Filter calendar events starting from this date (ISO 8601)"),
     eventTo: exports_external.optional(exports_external.string()).describe("Filter calendar events up to this date (ISO 8601)"),
-    memoryTags: exports_external.optional(exports_external.array(exports_external.string())).describe("Filter memories by tags")
-  }, async ({ query, entities, limit: limit2, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags }) => {
+    memoryTags: exports_external.optional(exports_external.array(exports_external.string())).describe("Filter memories by tags"),
+    conversationRole: exports_external.optional(exports_external.string()).describe('Filter conversations by role (e.g., "user", "assistant")'),
+    conversationProvider: exports_external.optional(exports_external.string()).describe('Filter conversations by provider (e.g., "claude", "opencode")'),
+    conversationProjectId: exports_external.optional(exports_external.string()).describe("Filter conversations by project ID")
+  }, async ({ query, entities, limit: limit2, taskStatus, projectStatus, messageChannel, messageDirection, eventFrom, eventTo, memoryTags, conversationRole, conversationProvider, conversationProjectId }) => {
     try {
       const results = await client.search({
         query,
@@ -1259619,7 +1259662,10 @@ var registerSearchTools = (server, client) => {
         messageDirection,
         eventFrom,
         eventTo,
-        memoryTags
+        memoryTags,
+        conversationRole,
+        conversationProvider,
+        conversationProjectId
       });
       return formatSuccess(results);
     } catch (err) {
@@ -1260443,6 +1260489,12 @@ class FulcrumClient {
       params.set("eventTo", input.eventTo);
     if (input.memoryTags?.length)
       params.set("memoryTags", input.memoryTags.join(","));
+    if (input.conversationRole)
+      params.set("conversationRole", input.conversationRole);
+    if (input.conversationProvider)
+      params.set("conversationProvider", input.conversationProvider);
+    if (input.conversationProjectId)
+      params.set("conversationProjectId", input.conversationProjectId);
     return this.fetch(`/api/search?${params.toString()}`);
   }
 }
@@ -1260458,7 +1260510,7 @@ mcpRoutes.all("/", async (c) => {
   });
   const server = new McpServer({
     name: "fulcrum",
-    version: "2.15.3"
+    version: "2.16.0"
   });
   const client = new FulcrumClient(`http://localhost:${port}`);
   registerTools(server, client);
@@ -1263092,6 +1263144,9 @@ app28.get("/", async (c) => {
   const eventTo = c.req.query("eventTo") || undefined;
   const memoryTagsParam = c.req.query("memoryTags");
   const memoryTags = memoryTagsParam ? memoryTagsParam.split(",").map((t) => t.trim()) : undefined;
+  const conversationRole = c.req.query("conversationRole") || undefined;
+  const conversationProvider = c.req.query("conversationProvider") || undefined;
+  const conversationProjectId = c.req.query("conversationProjectId") || undefined;
   try {
     const results = await search({
       query: query2.trim(),
@@ -1263103,7 +1263158,10 @@ app28.get("/", async (c) => {
       messageDirection,
       eventFrom,
       eventTo,
-      memoryTags
+      memoryTags,
+      conversationRole,
+      conversationProvider,
+      conversationProjectId
     });
     return c.json(results);
   } catch (err) {