@goondocks/myco 0.3.1 → 0.3.3

package/dist/{restart-NH5MX45I.js → restart-UGE2Y327.js}

@@ -1,11 +1,11 @@
 import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
 import {
   isProcessAlive
-} from "./chunk-PAUPHPOC.js";
+} from "./chunk-DBSG4V6Y.js";
 import "./chunk-SAKJMNSR.js";
-import "./chunk-XW3OL55U.js";
-import "./chunk-2QEJKG7R.js";
-import "./chunk-Q7BEFSOV.js";
+import "./chunk-BA23DROX.js";
+import "./chunk-Y3OYD4CX.js";
+import "./chunk-7VPJK56U.js";
 import "./chunk-PZUWP5VK.js";
 
 // src/cli/restart.ts
@@ -29,7 +29,7 @@ async function run(_args, vaultDir) {
     } catch {
     }
   }
-  const { DaemonClient } = await import("./client-HORA3CC4.js");
+  const { DaemonClient } = await import("./client-YI6RXFJD.js");
   const client = new DaemonClient(vaultDir);
   console.log("Waiting for health check...");
   const healthy = await client.ensureRunning();
@@ -47,4 +47,4 @@ async function run(_args, vaultDir) {
 export {
   run
 };
-//# sourceMappingURL=restart-NH5MX45I.js.map
+//# sourceMappingURL=restart-UGE2Y327.js.map

package/dist/{search-W3ECVSTH.js → search-2HMG3ON7.js}

@@ -2,24 +2,24 @@ import { createRequire as __cr } from 'node:module'; const require = __cr(import
 import {
   generateEmbedding
 } from "./chunk-RGVBGTD6.js";
-import {
-  searchFts
-} from "./chunk-6FQISQNA.js";
-import {
-  createEmbeddingProvider
-} from "./chunk-N6IAW33G.js";
 import {
   VectorIndex
 } from "./chunk-XQXXF6MU.js";
+import {
+  searchFts
+} from "./chunk-6FQISQNA.js";
 import {
   MycoIndex
 } from "./chunk-PA3VMINE.js";
-import "./chunk-XW3OL55U.js";
+import {
+  createEmbeddingProvider
+} from "./chunk-7WNE22W7.js";
+import "./chunk-BA23DROX.js";
 import {
   loadConfig
 } from "./chunk-ISCT2SI6.js";
 import "./chunk-EF4JVH24.js";
-import "./chunk-Q7BEFSOV.js";
+import "./chunk-7VPJK56U.js";
 import "./chunk-PZUWP5VK.js";
 
 // src/cli/search.ts
@@ -117,4 +117,4 @@ export {
   run,
   runVectors
 };
-//# sourceMappingURL=search-W3ECVSTH.js.map
+//# sourceMappingURL=search-2HMG3ON7.js.map

package/dist/{server-I7MRMIOP.js → server-YYGJKVBZ.js}

@@ -1,17 +1,21 @@
 import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
-import {
-  queryLogs
-} from "./chunk-BMJX2IDQ.js";
 import {
   VaultWriter
-} from "./chunk-P2Q77C5F.js";
+} from "./chunk-7ULKE5QH.js";
 import {
-  PlanFrontmatterSchema,
+  OBSERVATION_TYPES,
+  PLAN_STATUSES,
   indexNote
-} from "./chunk-72OAG4SF.js";
+} from "./chunk-AWF3M57N.js";
 import {
   generateEmbedding
 } from "./chunk-RGVBGTD6.js";
+import {
+  VectorIndex
+} from "./chunk-XQXXF6MU.js";
+import {
+  queryLogs
+} from "./chunk-BMJX2IDQ.js";
 import "./chunk-5EZ7QF6J.js";
 import {
   memoryFm,
@@ -22,16 +26,13 @@ import {
   initFts,
   searchFts
 } from "./chunk-6FQISQNA.js";
-import {
-  createEmbeddingProvider
-} from "./chunk-N6IAW33G.js";
-import {
-  VectorIndex
-} from "./chunk-XQXXF6MU.js";
 import {
   MycoIndex
 } from "./chunk-PA3VMINE.js";
-import "./chunk-XW3OL55U.js";
+import {
+  createEmbeddingProvider
+} from "./chunk-7WNE22W7.js";
+import "./chunk-BA23DROX.js";
 import {
   _enum,
   _null,
@@ -55,15 +56,22 @@ import {
   unknown
 } from "./chunk-ISCT2SI6.js";
 import "./chunk-EF4JVH24.js";
+import {
+  getPluginVersion
+} from "./chunk-R2R243GC.js";
 import {
   resolveVaultDir
 } from "./chunk-N33KUCFP.js";
+import "./chunk-Y3OYD4CX.js";
 import {
   CONTENT_SNIPPET_CHARS,
   EMBEDDING_INPUT_LIMIT,
+  MCP_LOGS_DEFAULT_LIMIT,
+  MCP_SEARCH_DEFAULT_LIMIT,
+  MCP_SESSIONS_DEFAULT_LIMIT,
   RECALL_SUMMARY_PREVIEW_CHARS,
   SESSION_SUMMARY_PREVIEW_CHARS
-} from "./chunk-Q7BEFSOV.js";
+} from "./chunk-7VPJK56U.js";
 import {
   __commonJS,
   __toESM
@@ -14051,7 +14059,6 @@ var StdioServerTransport = class {
 // src/mcp/server.ts
 import fs3 from "fs";
 import path4 from "path";
-import { fileURLToPath } from "url";
 
 // src/mcp/tools/search.ts
 async function handleMycoSearch(index, input, vectorIndex, backend) {
@@ -14143,6 +14150,7 @@ async function handleMycoRemember(vaultDir, index, input) {
   const notePath = writer.writeMemory({
     id,
     observation_type: input.type,
+    session: input.session,
     plan: input.related_plan ?? void 0,
     tags: input.tags,
     content: input.content
@@ -14458,166 +14466,167 @@ Superseded by:: [[${wisdomId}]]`;
   return { wisdom_id: wisdomId, wisdom_path: wisdomPath, sources_archived: archived };
 }
 
-// src/mcp/server.ts
-function getPackageVersion() {
-  try {
-    let dir = path4.dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 5; i++) {
-      const pkgPath = path4.join(dir, "package.json");
-      if (fs3.existsSync(pkgPath)) {
-        return JSON.parse(fs3.readFileSync(pkgPath, "utf-8")).version;
-      }
-      dir = path4.dirname(dir);
-    }
-    return "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-var OBSERVATION_TYPES = ["gotcha", "bug_fix", "decision", "discovery", "trade_off", "cross-cutting"];
-var PLAN_STATUSES = [...PlanFrontmatterSchema.shape.status._def.innerType.options, "all"];
+// src/mcp/tool-definitions.ts
+var PLAN_STATUS_FILTER = [...PLAN_STATUSES, "all"];
+var TOOL_SEARCH = "myco_search";
+var TOOL_RECALL = "myco_recall";
+var TOOL_REMEMBER = "myco_remember";
+var TOOL_PLANS = "myco_plans";
+var TOOL_SESSIONS = "myco_sessions";
+var TOOL_TEAM = "myco_team";
+var TOOL_GRAPH = "myco_graph";
+var TOOL_ORPHANS = "myco_orphans";
+var TOOL_LOGS = "myco_logs";
+var TOOL_SUPERSEDE = "myco_supersede";
+var TOOL_CONSOLIDATE = "myco_consolidate";
+var PROP_BRANCH = "Git branch name to find related sessions and plans";
+var PROP_SINCE = "ISO timestamp \u2014 entries after this date";
+var PROP_TAGS = "Tags for discoverability \u2014 component names, technologies, concepts";
 var TOOL_DEFINITIONS = [
   {
-    name: "myco_search",
-    description: "Combined semantic + full-text search across the vault",
+    name: TOOL_SEARCH,
+    description: "Search the vault for prior decisions, gotchas, bug fixes, and session history. Use before making design decisions, when debugging non-obvious issues, or when wondering why code is structured a certain way.",
     inputSchema: {
       type: "object",
       properties: {
-        query: { type: "string", description: "Search query" },
-        type: { type: "string", enum: ["session", "plan", "memory", "all"] },
-        limit: { type: "number", default: 10 }
+        query: { type: "string", description: "Natural language search query \u2014 describe what you are looking for" },
+        type: { type: "string", enum: ["session", "plan", "memory", "all"], description: "Filter by note type (default: all)" },
+        limit: { type: "number", description: `Max results (default: ${MCP_SEARCH_DEFAULT_LIMIT})` }
       },
       required: ["query"]
     }
   },
   {
-    name: "myco_recall",
-    description: "Automatic context retrieval based on current work",
+    name: TOOL_RECALL,
+    description: "Get context relevant to your current work \u2014 memories, sessions, and plans related to the branch and files you are working on. Use at the start of a task or when you need background on a component.",
     inputSchema: {
       type: "object",
       properties: {
-        branch: { type: "string" },
-        files: { type: "array", items: { type: "string" } }
+        branch: { type: "string", description: PROP_BRANCH },
+        files: { type: "array", items: { type: "string" }, description: "File paths you are working on \u2014 finds memories tagged with these files" }
       }
     }
   },
   {
-    name: "myco_remember",
-    description: "Store an observation as a memory note",
+    name: TOOL_REMEMBER,
+    description: "Save a decision, gotcha, bug fix, discovery, or trade-off as a permanent memory. Use after making a key decision, fixing a tricky bug, discovering something non-obvious, or encountering a gotcha. Always include the session ID from your context.",
     inputSchema: {
       type: "object",
       properties: {
-        content: { type: "string" },
-        type: { type: "string", enum: OBSERVATION_TYPES },
-        tags: { type: "array", items: { type: "string" } },
-        related_plan: { type: "string" }
+        content: { type: "string", description: "The observation \u2014 include context, reasoning, and what someone encountering this in the future needs to know" },
+        type: { type: "string", enum: OBSERVATION_TYPES, description: `Observation type: ${OBSERVATION_TYPES.join(", ")}` },
+        tags: { type: "array", items: { type: "string" }, description: PROP_TAGS },
+        session: { type: "string", description: 'Your session ID (from "Session::" in your context) \u2014 links this memory to the current session' },
+        related_plan: { type: "string", description: "Plan ID if this observation relates to an active plan" }
       },
       required: ["content", "type"]
     }
   },
   {
-    name: "myco_plans",
-    description: "List active plans with progress",
+    name: TOOL_PLANS,
+    description: "List active implementation plans and their status. Use to check what work is in flight before starting new tasks.",
     inputSchema: {
       type: "object",
       properties: {
-        status: { type: "string", enum: PLAN_STATUSES },
-        id: { type: "string" }
+        status: { type: "string", enum: PLAN_STATUS_FILTER, description: "Filter by status (default: all statuses)" },
+        id: { type: "string", description: "Get a specific plan by ID" }
       }
     }
   },
   {
-    name: "myco_sessions",
-    description: "Query session history with filters",
+    name: TOOL_SESSIONS,
+    description: "Browse past coding sessions with summaries, tools used, and linked memories. Use to understand what work has been done on a feature or branch.",
     inputSchema: {
       type: "object",
       properties: {
-        plan: { type: "string" },
-        branch: { type: "string" },
-        user: { type: "string" },
-        since: { type: "string" },
-        limit: { type: "number" }
+        plan: { type: "string", description: "Filter sessions linked to a specific plan" },
+        branch: { type: "string", description: PROP_BRANCH },
+        user: { type: "string", description: "Filter sessions by user" },
+        since: { type: "string", description: PROP_SINCE },
+        limit: { type: "number", description: `Max results (default: ${MCP_SESSIONS_DEFAULT_LIMIT})` }
       }
     }
   },
   {
-    name: "myco_team",
-    description: "Teammate activity on same files or plan",
+    name: TOOL_TEAM,
+    description: "See what teammates have been working on \u2014 filter by shared files or plan to understand who has context on a component.",
     inputSchema: {
       type: "object",
       properties: {
-        files: { type: "array", items: { type: "string" } },
-        plan: { type: "string" },
-        since: { type: "string" }
+        files: { type: "array", items: { type: "string" }, description: "File paths to find teammates who worked on them" },
+        plan: { type: "string", description: "Plan ID to find teammates collaborating on it" },
+        since: { type: "string", description: PROP_SINCE }
       }
     }
   },
   {
-    name: "myco_graph",
-    description: "Traverse vault connections via wikilinks \u2014 find related notes by following links",
+    name: TOOL_GRAPH,
+    description: "Traverse connections between vault notes via wikilinks \u2014 explore how sessions, memories, and plans relate to each other.",
     inputSchema: {
       type: "object",
       properties: {
-        note_id: { type: "string", description: 'Note ID to start from (e.g. "session-abc123")' },
-        direction: { type: "string", enum: ["incoming", "outgoing", "both"], description: "Link direction (default: both)" },
-        depth: { type: "number", description: "Traversal depth 1-3 (default: 1)" }
+        note_id: { type: "string", description: 'Note ID to start from (e.g., "session-abc123" or "decision-xyz789")' },
+        direction: { type: "string", enum: ["incoming", "outgoing", "both"], description: "Link direction to follow (default: both)" },
+        depth: { type: "number", description: "How many hops to traverse, 1-3 (default: 1)" }
       },
       required: ["note_id"]
     }
   },
   {
-    name: "myco_orphans",
-    description: "Find vault notes with no incoming or outgoing wikilinks",
+    name: TOOL_ORPHANS,
+    description: "Find vault notes with no connections \u2014 potentially stale or unlinked knowledge that may need review or cleanup.",
     inputSchema: {
       type: "object",
       properties: {}
     }
   },
   {
-    name: "myco_logs",
-    description: "View daemon and MCP activity logs with filtering \u2014 useful for debugging and auditing",
+    name: TOOL_LOGS,
+    description: "View daemon logs for debugging when sessions are not being captured, observations are missing, or embeddings fail. Filter by level, component, or time range.",
     inputSchema: {
       type: "object",
       properties: {
-        limit: { type: "number", description: "Max entries to return (default 50)" },
-        level: { type: "string", enum: ["debug", "info", "warn", "error"], description: "Minimum log level" },
-        component: { type: "string", description: "Filter by component (daemon, processor, hooks, lifecycle, embeddings, mcp, lineage, watcher)" },
-        since: { type: "string", description: "ISO timestamp \u2014 entries after this time" },
+        limit: { type: "number", description: `Max entries to return (default: ${MCP_LOGS_DEFAULT_LIMIT})` },
+        level: { type: "string", enum: ["debug", "info", "warn", "error"], description: "Minimum log level filter" },
+        component: { type: "string", description: "Component filter: daemon, processor, hooks, lifecycle, embeddings, mcp, lineage, watcher" },
+        since: { type: "string", description: PROP_SINCE },
         until: { type: "string", description: "ISO timestamp \u2014 entries before this time" }
       }
     }
   },
   {
-    name: "myco_supersede",
-    description: "Mark a memory as superseded by a newer one \u2014 use when an older observation is outdated, incorrect, or replaced by better understanding",
+    name: TOOL_SUPERSEDE,
+    description: "Mark a memory as outdated and replaced by a newer one. Use when a decision was reversed, a gotcha was fixed, a discovery was wrong, or the codebase changed and an observation no longer applies. The old memory is preserved but marked superseded.",
     inputSchema: {
       type: "object",
       properties: {
-        old_memory_id: { type: "string", description: "ID of the memory to supersede" },
-        new_memory_id: { type: "string", description: "ID of the memory that replaces it" },
-        reason: { type: "string", description: "Why this memory is being superseded" }
+        old_memory_id: { type: "string", description: 'ID of the outdated memory (e.g., "decision-abc123")' },
+        new_memory_id: { type: "string", description: "ID of the replacement memory" },
+        reason: { type: "string", description: "Why the old memory is being superseded" }
       },
       required: ["old_memory_id", "new_memory_id"]
     }
   },
   {
-    name: "myco_consolidate",
-    description: "Merge multiple related memories into a single wisdom note \u2014 use when several observations describe aspects of the same insight or pattern",
+    name: TOOL_CONSOLIDATE,
+    description: "Merge 3+ related memories into a single comprehensive wisdom note. Use when multiple observations describe aspects of the same insight, share a root cause, or would be more useful as one reference. Source memories are marked superseded.",
     inputSchema: {
       type: "object",
       properties: {
-        source_memory_ids: { type: "array", items: { type: "string" }, description: "IDs of memories to consolidate" },
-        consolidated_content: { type: "string", description: "The merged, comprehensive content for the wisdom note" },
-        observation_type: { type: "string", enum: OBSERVATION_TYPES, description: "Type for the consolidated note" },
-        tags: { type: "array", items: { type: "string" }, description: "Tags for the wisdom note" }
+        source_memory_ids: { type: "array", items: { type: "string" }, description: "IDs of the memories to merge (minimum 2)" },
+        consolidated_content: { type: "string", description: "The merged, comprehensive content \u2014 synthesize, do not just concatenate" },
+        observation_type: { type: "string", enum: OBSERVATION_TYPES, description: `Type for the consolidated wisdom note: ${OBSERVATION_TYPES.join(", ")}` },
+        tags: { type: "array", items: { type: "string" }, description: PROP_TAGS }
       },
       required: ["source_memory_ids", "consolidated_content", "observation_type"]
     }
   }
 ];
+
+// src/mcp/server.ts
 function createMycoServer(config2) {
   const server = new Server(
-    { name: "myco", version: getPackageVersion() },
+    { name: "myco", version: getPluginVersion() },
     { capabilities: { tools: {} } }
   );
   const dbPath = path4.join(config2.vaultDir, "index.db");
@@ -14651,37 +14660,37 @@ function createMycoServer(config2) {
     const idx = getIndex();
     const input = args;
     switch (name) {
-      case "myco_search":
+      case TOOL_SEARCH:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoSearch(idx, input, config2.vectorIndex, config2.embeddingProvider)) }] };
-      case "myco_recall":
+      case TOOL_RECALL:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoRecall(idx, input)) }] };
-      case "myco_remember": {
+      case TOOL_REMEMBER: {
         const result = await handleMycoRemember(config2.vaultDir, idx, input);
         embedNote(result.id, String(input.content), { type: "memory", observation_type: String(input.type ?? ""), importance: "high" });
-        logActivity("myco_remember", { id: result.id, observation_type: input.type, path: result.note_path });
+        logActivity(TOOL_REMEMBER, { id: result.id, observation_type: input.type, path: result.note_path });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
-      case "myco_plans":
+      case TOOL_PLANS:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoPlans(idx, input)) }] };
-      case "myco_sessions":
+      case TOOL_SESSIONS:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoSessions(idx, input)) }] };
-      case "myco_team":
+      case TOOL_TEAM:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoTeam(idx, input, config2.teamUser)) }] };
-      case "myco_graph":
+      case TOOL_GRAPH:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoGraph(idx, input)) }] };
-      case "myco_orphans":
+      case TOOL_ORPHANS:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoOrphans(idx)) }] };
-      case "myco_logs":
+      case TOOL_LOGS:
         return { content: [{ type: "text", text: JSON.stringify(await handleMycoLogs(config2.vaultDir, input)) }] };
-      case "myco_supersede": {
+      case TOOL_SUPERSEDE: {
         const result = await handleMycoSupersede(config2.vaultDir, idx, input);
         if (result.status === "superseded" && config2.vectorIndex) {
           config2.vectorIndex.delete(result.old_memory);
         }
-        logActivity("myco_supersede", { old: result.old_memory, new: result.new_memory, status: result.status });
+        logActivity(TOOL_SUPERSEDE, { old: result.old_memory, new: result.new_memory, status: result.status });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
-      case "myco_consolidate": {
+      case TOOL_CONSOLIDATE: {
         const result = await handleMycoConsolidate(config2.vaultDir, idx, input);
         embedNote(result.wisdom_id, String(input.consolidated_content), { type: "memory", observation_type: String(input.observation_type ?? ""), importance: "high" });
         if (config2.vectorIndex && Array.isArray(input.source_memory_ids)) {
@@ -14689,7 +14698,7 @@ function createMycoServer(config2) {
             config2.vectorIndex.delete(id);
           }
         }
-        logActivity("myco_consolidate", { wisdom_id: result.wisdom_id, sources: input.source_memory_ids, archived: result.sources_archived });
+        logActivity(TOOL_CONSOLIDATE, { wisdom_id: result.wisdom_id, sources: input.source_memory_ids, archived: result.sources_archived });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
       default:
@@ -14732,4 +14741,4 @@ export {
   createMycoServer,
   main
 };
-//# sourceMappingURL=server-I7MRMIOP.js.map
+//# sourceMappingURL=server-YYGJKVBZ.js.map