@geoql/mdr 0.0.1 → 1.0.0

package/src/index.ts

@@ -15,9 +15,9 @@
  * - expand_conversation: Load full context from a session
  */
 
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
 import {
   existsSync,
   readFileSync,
@@ -25,22 +25,22 @@ import {
   appendFileSync,
   mkdirSync,
   readdirSync,
-} from "fs";
-import { join } from "path";
+} from 'fs';
+import { join } from 'path';
 import {
   searchMemory as doSearchMemory,
   indexJournalEntry,
   rebuildIndex,
   getIndexStats,
   type MemoryItemType,
-} from "./indexer.js";
+} from './indexer.js';
 import {
   searchConversations,
   expandConversation,
   rebuildConversationIndex,
   updateConversationIndex,
   getConversationIndexStats,
-} from "./conversations.js";
+} from './conversations.js';
 import {
   getStateRoot,
   getStateDir,
@@ -48,8 +48,8 @@ import {
   getJournalDir,
   getIndexDir,
   getRemindersDir,
-} from "./config.js";
-import { unlinkSync } from "fs";
+} from './config.js';
+import { unlinkSync } from 'fs';
 
 // Types
 interface JournalEntry {
@@ -64,11 +64,11 @@ interface JournalEntry {
 
 interface Schedule {
   id: string;
-  type: "cron" | "once";
+  type: 'cron' | 'once';
   expression: string;
   description: string;
   payload: string;
-  agent?: "opencode" | "claude"; // Which agent CLI to trigger
+  agent?: 'opencode' | 'claude'; // Which agent CLI to trigger
   model?: string; // Optional model override (e.g., "anthropic/claude-opus-4-6")
   createdAt: string;
 }
@@ -80,8 +80,8 @@ function ensureDirectories() {
     getStateRoot(),
     getStateDir(),
     entitiesDir,
-    join(entitiesDir, "people"),
-    join(entitiesDir, "projects"),
+    join(entitiesDir, 'people'),
+    join(entitiesDir, 'projects'),
     getJournalDir(),
     getIndexDir(),
   ];
@@ -99,10 +99,10 @@ function loadAllSchedules(): Schedule[] {
   try {
     if (!existsSync(remindersDir)) return schedules;
 
-    const files = readdirSync(remindersDir).filter((f) => f.endsWith(".json"));
+    const files = readdirSync(remindersDir).filter((f) => f.endsWith('.json'));
     for (const file of files) {
       try {
-        const content = readFileSync(join(remindersDir, file), "utf-8");
+        const content = readFileSync(join(remindersDir, file), 'utf-8');
         schedules.push(JSON.parse(content));
       } catch {
         // Skip malformed files
@@ -140,7 +140,7 @@ function deleteScheduleFile(id: string) {
 }
 
 function getTodayJournalPath(): string {
-  const today = new Date().toISOString().split("T")[0];
+  const today = new Date().toISOString().split('T')[0];
   return join(getJournalDir(), `${today}.jsonl`);
 }
 
@@ -152,15 +152,15 @@ function getRecentJournalEntries(count: number): JournalEntry[] {
   if (!existsSync(journalDir)) return entries;
 
   const files = readdirSync(journalDir)
-    .filter((f: string) => f.endsWith(".jsonl"))
+    .filter((f: string) => f.endsWith('.jsonl'))
     .sort()
     .reverse();
 
   for (const file of files) {
     if (entries.length >= count) break;
 
-    const content = readFileSync(join(journalDir, file), "utf-8");
-    const lines = content.trim().split("\n").filter(Boolean);
+    const content = readFileSync(join(journalDir, file), 'utf-8');
+    const lines = content.trim().split('\n').filter(Boolean);
 
     for (const line of lines.reverse()) {
       if (entries.length >= count) break;
@@ -178,19 +178,19 @@ function getRecentJournalEntries(count: number): JournalEntry[] {
 // Create MCP server with every tool registered.
 export function createServer(): McpServer {
   const server = new McpServer({
-    name: "macrodata-local",
-    version: "0.1.0",
+    name: 'macrodata-local',
+    version: '0.1.0',
   });
 
   // Tool: log_journal
   server.tool(
-    "log_journal",
-    "Append a timestamped entry to the journal",
+    'log_journal',
+    'Append a timestamped entry to the journal',
     {
-      topic: z.string().describe("Category or tag for this entry"),
-      content: z.string().describe("The actual note or observation"),
-      source: z.string().optional().describe("Where this came from (conversation, cron, etc.)"),
-      intent: z.string().optional().describe("What you were doing when logging this"),
+      topic: z.string().describe('Category or tag for this entry'),
+      content: z.string().describe('The actual note or observation'),
+      source: z.string().optional().describe('Where this came from (conversation, cron, etc.)'),
+      intent: z.string().optional().describe('What you were doing when logging this'),
     },
     async ({ topic, content, source, intent }) => {
       ensureDirectories();
@@ -206,19 +206,19 @@ export function createServer(): McpServer {
       };
 
       const journalPath = getTodayJournalPath();
-      appendFileSync(journalPath, JSON.stringify(entry) + "\n");
+      appendFileSync(journalPath, JSON.stringify(entry) + '\n');
 
       // Index the entry for semantic search
       try {
         await indexJournalEntry(entry);
       } catch (err) {
-        console.error("[log_journal] Failed to index entry:", err);
+        console.error('[log_journal] Failed to index entry:', err);
       }
 
       return {
         content: [
           {
-            type: "text" as const,
+            type: 'text' as const,
             text: `Logged to journal: ${topic}`,
           },
         ],
@@ -228,11 +228,11 @@ export function createServer(): McpServer {
 
   // Tool: get_recent_journal
   server.tool(
-    "get_recent_journal",
-    "Get the N most recent journal entries, optionally filtered by topic",
+    'get_recent_journal',
+    'Get the N most recent journal entries, optionally filtered by topic',
     {
-      count: z.number().default(10).describe("Number of entries to retrieve"),
-      topic: z.string().optional().describe("Filter by specific topic"),
+      count: z.number().default(10).describe('Number of entries to retrieve'),
+      topic: z.string().optional().describe('Filter by specific topic'),
     },
     async ({ count, topic }) => {
       let entries = getRecentJournalEntries(Math.min(count * 2, 100)); // Get more to filter
@@ -246,7 +246,7 @@ export function createServer(): McpServer {
       return {
         content: [
           {
-            type: "text" as const,
+            type: 'text' as const,
             text: JSON.stringify(entries, null, 2),
           },
         ],
@@ -256,22 +256,22 @@ export function createServer(): McpServer {
 
   // Tool: search_memory
   server.tool(
-    "search_memory",
-    "Semantic search across journal entries and entity files. Returns ranked results.",
+    'search_memory',
+    'Semantic search across journal entries and entity files. Returns ranked results.',
     {
-      query: z.string().describe("Natural language search query"),
+      query: z.string().describe('Natural language search query'),
       type: z
-        .enum(["journal", "person", "project", "all"])
-        .default("all")
-        .describe("Filter by content type"),
-      since: z.string().optional().describe("Only include items after this ISO date"),
-      limit: z.number().default(5).describe("Maximum results to return"),
+        .enum(['journal', 'person', 'project', 'all'])
+        .default('all')
+        .describe('Filter by content type'),
+      since: z.string().optional().describe('Only include items after this ISO date'),
+      limit: z.number().default(5).describe('Maximum results to return'),
     },
     async ({ query, type, since, limit }) => {
       try {
         const results = await doSearchMemory(query, {
           limit,
-          type: type === "all" ? undefined : (type as MemoryItemType),
+          type: type === 'all' ? undefined : (type as MemoryItemType),
           since,
         });
 
@@ -279,8 +279,8 @@ export function createServer(): McpServer {
           return {
             content: [
               {
-                type: "text" as const,
-                text: "(no matches found)",
+                type: 'text' as const,
+                text: '(no matches found)',
               },
             ],
           };
@@ -288,18 +288,18 @@ export function createServer(): McpServer {
 
         const formatted = results
           .map((r, i) => {
-            const header = `[${i + 1}] ${r.type}${r.section ? ` / ${r.section}` : ""} (score: ${r.score.toFixed(3)})`;
-            const meta = r.timestamp ? `  Date: ${r.timestamp}` : "";
+            const header = `[${i + 1}] ${r.type}${r.section ? ` / ${r.section}` : ''} (score: ${r.score.toFixed(3)})`;
+            const meta = r.timestamp ? `  Date: ${r.timestamp}` : '';
             const source = `  Source: ${r.source}`;
-            const content = r.content.slice(0, 500) + (r.content.length > 500 ? "..." : "");
-            return [header, meta, source, "", content].filter(Boolean).join("\n");
+            const content = r.content.slice(0, 500) + (r.content.length > 500 ? '...' : '');
+            return [header, meta, source, '', content].filter(Boolean).join('\n');
           })
-          .join("\n\n---\n\n");
+          .join('\n\n---\n\n');
 
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: formatted,
             },
           ],
@@ -308,7 +308,7 @@ export function createServer(): McpServer {
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: `Search error: ${String(err)}`,
             },
           ],
@@ -319,25 +319,25 @@ export function createServer(): McpServer {
 
   // Tool: manage_index
   server.tool(
-    "manage_index",
+    'manage_index',
     "Manage search indexes. Target 'memory' for journal/entities, 'conversations' for past Claude Code sessions.",
     {
-      target: z.enum(["memory", "conversations"]).describe("Which index to manage"),
+      target: z.enum(['memory', 'conversations']).describe('Which index to manage'),
       action: z
-        .enum(["rebuild", "update", "stats"])
+        .enum(['rebuild', 'update', 'stats'])
         .describe(
           "'rebuild' to reindex from scratch, 'update' for incremental (conversations only), 'stats' to get counts",
         ),
     },
     async ({ target, action }) => {
       try {
-        if (target === "memory") {
-          if (action === "rebuild" || action === "update") {
+        if (target === 'memory') {
+          if (action === 'rebuild' || action === 'update') {
             const result = await rebuildIndex();
             return {
               content: [
                 {
-                  type: "text" as const,
+                  type: 'text' as const,
                   text: `Memory index rebuilt. Indexed ${result.itemCount} items.`,
                 },
               ],
@@ -346,12 +346,12 @@ export function createServer(): McpServer {
             const stats = await getIndexStats();
             return {
               content: [
-                { type: "text" as const, text: `Memory index contains ${stats.itemCount} items.` },
+                { type: 'text' as const, text: `Memory index contains ${stats.itemCount} items.` },
               ],
             };
           }
         } else {
-          if (action === "rebuild") {
+          if (action === 'rebuild') {
             // Run in background - don't wait
             rebuildConversationIndex()
               .then((result) =>
@@ -365,12 +365,12 @@ export function createServer(): McpServer {
             return {
               content: [
                 {
-                  type: "text" as const,
+                  type: 'text' as const,
                   text: `Conversation index rebuild started in background.`,
                 },
               ],
             };
-          } else if (action === "update") {
+          } else if (action === 'update') {
             // Incremental update - also background
             updateConversationIndex()
               .then((result) =>
@@ -383,7 +383,7 @@ export function createServer(): McpServer {
               );
             return {
               content: [
-                { type: "text" as const, text: `Conversation index update started in background.` },
+                { type: 'text' as const, text: `Conversation index update started in background.` },
               ],
             };
           } else {
@@ -391,7 +391,7 @@ export function createServer(): McpServer {
             return {
               content: [
                 {
-                  type: "text" as const,
+                  type: 'text' as const,
                   text: `Conversation index contains ${stats.exchangeCount} exchanges.`,
                 },
               ],
@@ -401,7 +401,7 @@ export function createServer(): McpServer {
       } catch (err) {
         return {
           content: [
-            { type: "text" as const, text: `Failed to ${action} ${target} index: ${String(err)}` },
+            { type: 'text' as const, text: `Failed to ${action} ${target} index: ${String(err)}` },
           ],
         };
       }
@@ -410,18 +410,18 @@ export function createServer(): McpServer {
 
   // Tool: schedule
   server.tool(
-    "schedule",
+    'schedule',
     "Create a reminder. Use type 'cron' for recurring (expression is cron syntax) or 'once' for one-shot (expression is ISO datetime).",
     {
-      type: z.enum(["cron", "once"]).describe("'cron' for recurring, 'once' for one-shot"),
-      id: z.string().describe("Unique identifier for this reminder"),
+      type: z.enum(['cron', 'once']).describe("'cron' for recurring, 'once' for one-shot"),
+      id: z.string().describe('Unique identifier for this reminder'),
       expression: z
         .string()
         .describe(
           "Cron expression (e.g., '0 9 * * *') or ISO datetime (e.g., '2026-01-31T10:00:00')",
         ),
-      description: z.string().describe("What this reminder is for"),
-      payload: z.string().describe("Message to process when reminder fires"),
+      description: z.string().describe('What this reminder is for'),
+      payload: z.string().describe('Message to process when reminder fires'),
       model: z
         .string()
         .optional()
@@ -434,7 +434,7 @@ export function createServer(): McpServer {
         expression,
         description,
         payload,
-        agent: "claude",
+        agent: 'claude',
         model,
         createdAt: new Date().toISOString(),
       };
@@ -442,12 +442,12 @@ export function createServer(): McpServer {
       // Save to individual file (overwrites if exists)
       saveSchedule(schedule);
 
-      const typeLabel = type === "cron" ? "recurring" : "one-shot";
+      const typeLabel = type === 'cron' ? 'recurring' : 'one-shot';
       return {
         content: [
           {
-            type: "text" as const,
-            text: `Created ${typeLabel} reminder: ${id} (${expression})${model ? ` with model ${model}` : ""}`,
+            type: 'text' as const,
+            text: `Created ${typeLabel} reminder: ${id} (${expression})${model ? ` with model ${model}` : ''}`,
           },
         ],
       };
@@ -455,13 +455,13 @@ export function createServer(): McpServer {
   );
 
   // Tool: list_reminders
-  server.tool("list_reminders", "List all active scheduled reminders", {}, async () => {
+  server.tool('list_reminders', 'List all active scheduled reminders', {}, async () => {
     const schedules = loadAllSchedules();
 
     return {
       content: [
         {
-          type: "text" as const,
+          type: 'text' as const,
           text: JSON.stringify(schedules, null, 2),
         },
       ],
@@ -470,10 +470,10 @@ export function createServer(): McpServer {
 
   // Tool: remove_reminder
   server.tool(
-    "remove_reminder",
-    "Remove a scheduled reminder",
+    'remove_reminder',
+    'Remove a scheduled reminder',
     {
-      id: z.string().describe("ID of the reminder to remove"),
+      id: z.string().describe('ID of the reminder to remove'),
     },
     async ({ id }) => {
       const removed = deleteScheduleFile(id);
@@ -481,7 +481,7 @@ export function createServer(): McpServer {
       return {
         content: [
           {
-            type: "text" as const,
+            type: 'text' as const,
             text: removed ? `Removed reminder: ${id}` : `Reminder not found: ${id}`,
           },
         ],
@@ -491,49 +491,49 @@ export function createServer(): McpServer {
 
   // Tool: save_conversation_summary
   server.tool(
-    "save_conversation_summary",
-    "Save a summary of the current conversation for context recovery in future sessions",
+    'save_conversation_summary',
+    'Save a summary of the current conversation for context recovery in future sessions',
     {
-      summary: z.string().describe("Brief summary of what was discussed/accomplished"),
-      keyDecisions: z.array(z.string()).optional().describe("Important decisions made"),
-      openThreads: z.array(z.string()).optional().describe("Topics to follow up on"),
+      summary: z.string().describe('Brief summary of what was discussed/accomplished'),
+      keyDecisions: z.array(z.string()).optional().describe('Important decisions made'),
+      openThreads: z.array(z.string()).optional().describe('Topics to follow up on'),
       learnedPatterns: z
         .array(z.string())
         .optional()
-        .describe("New patterns learned about the user"),
-      notes: z.string().optional().describe("Freeform notes"),
+        .describe('New patterns learned about the user'),
+      notes: z.string().optional().describe('Freeform notes'),
     },
     async ({ summary, keyDecisions, openThreads, learnedPatterns, notes }) => {
       ensureDirectories();
 
       const parts = [summary];
-      if (keyDecisions?.length) parts.push(`Decisions: ${keyDecisions.join(", ")}`);
-      if (openThreads?.length) parts.push(`Open threads: ${openThreads.join(", ")}`);
-      if (learnedPatterns?.length) parts.push(`Learned: ${learnedPatterns.join(", ")}`);
+      if (keyDecisions?.length) parts.push(`Decisions: ${keyDecisions.join(', ')}`);
+      if (openThreads?.length) parts.push(`Open threads: ${openThreads.join(', ')}`);
+      if (learnedPatterns?.length) parts.push(`Learned: ${learnedPatterns.join(', ')}`);
       if (notes) parts.push(`Notes: ${notes}`);
 
       const entry: JournalEntry = {
         timestamp: new Date().toISOString(),
-        topic: "conversation-summary",
-        content: parts.join("\n"),
-        metadata: { source: "conversation" },
+        topic: 'conversation-summary',
+        content: parts.join('\n'),
+        metadata: { source: 'conversation' },
       };
 
       const journalPath = getTodayJournalPath();
-      appendFileSync(journalPath, JSON.stringify(entry) + "\n");
+      appendFileSync(journalPath, JSON.stringify(entry) + '\n');
 
       // Index for semantic search
       try {
         await indexJournalEntry(entry);
       } catch (err) {
-        console.error("[save_conversation_summary] Failed to index:", err);
+        console.error('[save_conversation_summary] Failed to index:', err);
       }
 
       return {
         content: [
           {
-            type: "text" as const,
-            text: "Conversation summary saved.",
+            type: 'text' as const,
+            text: 'Conversation summary saved.',
           },
         ],
       };
@@ -542,22 +542,22 @@ export function createServer(): McpServer {
 
   // Tool: get_recent_summaries
   server.tool(
-    "get_recent_summaries",
-    "Get recent conversation summaries for context recovery",
+    'get_recent_summaries',
+    'Get recent conversation summaries for context recovery',
     {
-      count: z.number().default(7).describe("Number of summaries to retrieve"),
+      count: z.number().default(7).describe('Number of summaries to retrieve'),
     },
     async ({ count }) => {
       // Get recent journal entries filtered by topic
       let entries = getRecentJournalEntries(count * 3);
-      entries = entries.filter((e) => e.topic === "conversation-summary").slice(0, count);
+      entries = entries.filter((e) => e.topic === 'conversation-summary').slice(0, count);
 
       if (entries.length === 0) {
         return {
           content: [
             {
-              type: "text" as const,
-              text: "No conversation summaries yet.",
+              type: 'text' as const,
+              text: 'No conversation summaries yet.',
             },
           ],
         };
@@ -566,7 +566,7 @@ export function createServer(): McpServer {
       return {
         content: [
           {
-            type: "text" as const,
+            type: 'text' as const,
             text: JSON.stringify(entries, null, 2),
           },
         ],
@@ -576,8 +576,8 @@ export function createServer(): McpServer {
 
   // Tool: search_conversations
   server.tool(
-    "search_conversations",
-    "Search past Claude Code conversations for similar problems/solutions. By default searches current project first, with recent conversations weighted higher.",
+    'search_conversations',
+    'Search past Claude Code conversations for similar problems/solutions. By default searches current project first, with recent conversations weighted higher.',
     {
       query: z
         .string()
@@ -587,8 +587,8 @@ export function createServer(): McpServer {
       projectOnly: z
         .boolean()
         .default(false)
-        .describe("Only search current project (default: search all but boost current)"),
-      limit: z.number().default(5).describe("Maximum results to return"),
+        .describe('Only search current project (default: search all but boost current)'),
+      limit: z.number().default(5).describe('Maximum results to return'),
     },
     async ({ query, projectOnly, limit }) => {
       try {
@@ -605,7 +605,7 @@ export function createServer(): McpServer {
           return {
             content: [
               {
-                type: "text" as const,
+                type: 'text' as const,
                 text: "No matching conversations found. Try manage_index(target: 'conversations', action: 'update').",
               },
             ],
@@ -616,17 +616,17 @@ export function createServer(): McpServer {
         const formatted = results
           .map((r, i) => {
             const date = new Date(r.exchange.timestamp).toLocaleDateString();
-            const branch = r.exchange.branch ? ` (${r.exchange.branch})` : "";
+            const branch = r.exchange.branch ? ` (${r.exchange.branch})` : '';
             return `[${i + 1}] ${r.exchange.project}${branch} - ${date}
-    "${r.exchange.userPrompt.slice(0, 200)}${r.exchange.userPrompt.length > 200 ? "..." : ""}"
+    "${r.exchange.userPrompt.slice(0, 200)}${r.exchange.userPrompt.length > 200 ? '...' : ''}"
     Session: ${r.exchange.sessionId}`;
           })
-          .join("\n\n");
+          .join('\n\n');
 
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: `Found ${results.length} relevant conversation(s):\n\n${formatted}\n\nUse expand_conversation to see full context.`,
             },
           ],
@@ -635,7 +635,7 @@ export function createServer(): McpServer {
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: `Search error: ${String(err)}`,
             },
           ],
@@ -646,45 +646,45 @@ export function createServer(): McpServer {
 
   // Tool: expand_conversation
   server.tool(
-    "expand_conversation",
-    "Load full context from a past conversation. Use after search_conversations to see the complete exchange.",
+    'expand_conversation',
+    'Load full context from a past conversation. Use after search_conversations to see the complete exchange.',
     {
-      sessionPath: z.string().describe("Session file path from search results"),
-      messageUuid: z.string().optional().describe("Specific message UUID to center on"),
-      contextMessages: z.number().default(10).describe("Number of messages to include"),
+      sessionPath: z.string().describe('Session file path from search results'),
+      messageUuid: z.string().optional().describe('Specific message UUID to center on'),
+      contextMessages: z.number().default(10).describe('Number of messages to include'),
     },
     async ({ sessionPath, messageUuid, contextMessages }) => {
       try {
         // Resolve session path if only ID given
         let fullPath = sessionPath;
-        if (!sessionPath.startsWith("/")) {
+        if (!sessionPath.startsWith('/')) {
           // Assume it's a session ID, need to find the file
           // For now, require full path
           return {
             content: [
               {
-                type: "text" as const,
-                text: "Please provide the full session path from search results.",
+                type: 'text' as const,
+                text: 'Please provide the full session path from search results.',
               },
             ],
           };
         }
 
-        const result = await expandConversation(fullPath, messageUuid || "", contextMessages);
+        const result = await expandConversation(fullPath, messageUuid || '', contextMessages);
 
         const formatted = result.messages
           .map((m) => {
-            const prefix = m.role === "user" ? "User" : "Assistant";
+            const prefix = m.role === 'user' ? 'User' : 'Assistant';
             return `**${prefix}**: ${m.content}`;
           })
-          .join("\n\n---\n\n");
+          .join('\n\n---\n\n');
 
-        const header = `Project: ${result.project}${result.branch ? ` (${result.branch})` : ""}\n\n`;
+        const header = `Project: ${result.project}${result.branch ? ` (${result.branch})` : ''}\n\n`;
 
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: header + formatted,
             },
           ],
@@ -693,7 +693,7 @@ export function createServer(): McpServer {
         return {
           content: [
             {
-              type: "text" as const,
+              type: 'text' as const,
               text: `Failed to expand conversation: ${String(err)}`,
             },
           ],