context-vault 2.2.0 → 2.3.0

package/{src → node_modules/@context-vault/core/src}/server/tools.js

@@ -1,8 +1,8 @@
 /**
  * tools.js — MCP tool registrations
  *
- * Five tools: save_context (write/update), get_context (search), list_context (browse),
- * delete_context (remove), context_status (diag).
+ * Six tools: save_context (write/update), get_context (search), list_context (browse),
+ * delete_context (remove), submit_feedback (bug/feature reports), context_status (diag).
  * Auto-reindex runs transparently on first tool call per session.
  */
 
@@ -63,9 +63,9 @@ export function registerTools(server, ctx) {
 
   server.tool(
     "get_context",
-    "Search your knowledge vault. Returns entries ranked by relevance using hybrid full-text + semantic search. Use this to find insights, decisions, patterns, or any saved context.",
+    "Search your knowledge vault. Returns entries ranked by relevance using hybrid full-text + semantic search. Use this to find insights, decisions, patterns, or any saved context. Each result includes an `id` you can use with save_context or delete_context.",
     {
-      query: z.string().describe("Search query (natural language or keywords)"),
+      query: z.string().optional().describe("Search query (natural language or keywords). Optional if filters (tags, kind, category) are provided."),
       kind: z.string().optional().describe("Filter by kind (e.g. 'insight', 'decision', 'pattern')"),
       category: z.enum(["knowledge", "entity", "event"]).optional().describe("Filter by category"),
       tags: z.array(z.string()).optional().describe("Filter by tags (entries must match at least one)"),
@@ -74,38 +74,69 @@ export function registerTools(server, ctx) {
       limit: z.number().optional().describe("Max results to return (default 10)"),
     },
     async ({ query, kind, category, tags, since, until, limit }) => {
-      if (!query?.trim()) return err("Required: query (non-empty string)", "INVALID_INPUT");
+      const hasQuery = query?.trim();
+      const hasFilters = kind || category || tags?.length || since || until;
+      if (!hasQuery && !hasFilters) return err("Required: query or at least one filter (kind, category, tags, since, until)", "INVALID_INPUT");
       await ensureIndexed();
 
       const kindFilter = kind ? normalizeKind(kind) : null;
-      const sorted = await hybridSearch(ctx, query, {
-        kindFilter,
-        categoryFilter: category || null,
-        since: since || null,
-        until: until || null,
-        limit: limit || 10,
-      });
 
-      // Post-filter by tags if provided
-      const filtered = tags?.length
-        ? sorted.filter((r) => {
-            const entryTags = r.tags ? JSON.parse(r.tags) : [];
-            return tags.some((t) => entryTags.includes(t));
-          })
-        : sorted;
+      let filtered;
+      if (hasQuery) {
+        // Hybrid search mode
+        const sorted = await hybridSearch(ctx, query, {
+          kindFilter,
+          categoryFilter: category || null,
+          since: since || null,
+          until: until || null,
+          limit: limit || 10,
+        });
+
+        // Post-filter by tags if provided
+        filtered = tags?.length
+          ? sorted.filter((r) => {
+              const entryTags = r.tags ? JSON.parse(r.tags) : [];
+              return tags.some((t) => entryTags.includes(t));
+            })
+          : sorted;
+      } else {
+        // Filter-only mode (no query, use SQL directly)
+        const clauses = [];
+        const params = [];
+        if (kindFilter) { clauses.push("kind = ?"); params.push(kindFilter); }
+        if (category) { clauses.push("category = ?"); params.push(category); }
+        if (since) { clauses.push("created_at >= ?"); params.push(since); }
+        if (until) { clauses.push("created_at <= ?"); params.push(until); }
+        clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
+        const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+        const effectiveLimit = limit || 10;
+        params.push(effectiveLimit);
+        const rows = ctx.db.prepare(`SELECT * FROM vault ${where} ORDER BY created_at DESC LIMIT ?`).all(...params);
+
+        filtered = tags?.length
+          ? rows.filter((r) => {
+              const entryTags = r.tags ? JSON.parse(r.tags) : [];
+              return tags.some((t) => entryTags.includes(t));
+            })
+          : rows;
+
+        // Add score field for consistent output
+        for (const r of filtered) r.score = 0;
+      }
 
-      if (!filtered.length) return ok("No results found for: " + query);
+      if (!filtered.length) return ok(hasQuery ? "No results found for: " + query : "No entries found matching the given filters.");
 
       const lines = [];
       if (reindexFailed) lines.push(`> **Warning:** Auto-reindex failed. Results may be stale. Run \`context-mcp reindex\` to fix.\n`);
-      lines.push(`## Results for "${query}" (${filtered.length} matches)\n`);
+      const heading = hasQuery ? `Results for "${query}"` : "Filtered entries";
+      lines.push(`## ${heading} (${filtered.length} matches)\n`);
       for (let i = 0; i < filtered.length; i++) {
         const r = filtered[i];
         const entryTags = r.tags ? JSON.parse(r.tags) : [];
         const tagStr = entryTags.length ? entryTags.join(", ") : "none";
         const relPath = r.file_path && config.vaultDir ? r.file_path.replace(config.vaultDir + "/", "") : r.file_path || "n/a";
         lines.push(`### [${i + 1}/${filtered.length}] ${r.title || "(untitled)"} [${r.kind}/${r.category}]`);
-        lines.push(`${r.score.toFixed(3)} · ${tagStr} · ${relPath}`);
+        lines.push(`${r.score.toFixed(3)} · ${tagStr} · ${relPath} · id: \`${r.id}\``);
         lines.push(r.body?.slice(0, 300) + (r.body?.length > 300 ? "..." : ""));
         lines.push("");
       }
@@ -117,7 +148,7 @@ export function registerTools(server, ctx) {
 
   server.tool(
     "save_context",
-    "Save knowledge to your vault. Creates a .md file and indexes it for search. Use for any kind of context: insights, decisions, patterns, references, or any custom kind.",
+    "Save knowledge to your vault. Creates a .md file and indexes it for search. Use for any kind of context: insights, decisions, patterns, references, or any custom kind. To update an existing entry, pass its `id` — omitted fields are preserved.",
     {
       id: z.string().optional().describe("Entry ULID to update. When provided, updates the existing entry instead of creating new. Omitted fields are preserved."),
       kind: z.string().optional().describe("Entry kind — determines folder (e.g. 'insight', 'decision', 'pattern', 'reference', or any custom kind). Required for new entries."),
@@ -155,6 +186,7 @@ export function registerTools(server, ctx) {
         if (entry.title) parts.push(`  title: ${entry.title}`);
         const entryTags = entry.tags || [];
         if (entryTags.length) parts.push(`  tags: ${entryTags.join(", ")}`);
+        parts.push("", "_Search with get_context to verify changes._");
         return ok(parts.join("\n"));
       }
 
@@ -179,6 +211,7 @@ export function registerTools(server, ctx) {
       const parts = [`✓ Saved ${kind} → ${relPath}`, `  id: ${entry.id}`];
       if (title) parts.push(`  title: ${title}`);
       if (tags?.length) parts.push(`  tags: ${tags.join(", ")}`);
+      parts.push("", "_Use this id to update or delete later._");
       return ok(parts.join("\n"));
     }
   );
@@ -187,7 +220,7 @@ export function registerTools(server, ctx) {
 
   server.tool(
     "list_context",
-    "Browse vault entries without a search query. Returns id, title, kind, category, tags, created_at. Use get_context with a query for semantic search.",
+    "Browse vault entries without a search query. Returns id, title, kind, category, tags, created_at. Use get_context with a query for semantic search. Use this to browse by tags or find recent entries.",
     {
       kind: z.string().optional().describe("Filter by kind (e.g. 'insight', 'decision', 'pattern')"),
       category: z.enum(["knowledge", "entity", "event"]).optional().describe("Filter by category"),
@@ -229,7 +262,7 @@ export function registerTools(server, ctx) {
       const total = ctx.db.prepare(`SELECT COUNT(*) as c FROM vault ${where}`).get(...countParams).c;
 
       params.push(effectiveLimit, effectiveOffset);
-      const rows = ctx.db.prepare(`SELECT id, title, kind, category, tags, created_at FROM vault ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params);
+      const rows = ctx.db.prepare(`SELECT id, title, kind, category, tags, created_at, SUBSTR(body, 1, 120) as preview FROM vault ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params);
 
       // Post-filter by tags if provided
       const filtered = tags?.length
@@ -246,6 +279,7 @@ export function registerTools(server, ctx) {
         const entryTags = r.tags ? JSON.parse(r.tags) : [];
         const tagStr = entryTags.length ? entryTags.join(", ") : "none";
         lines.push(`- **${r.title || "(untitled)"}** [${r.kind}/${r.category}] — ${tagStr} — ${r.created_at} — \`${r.id}\``);
+        if (r.preview) lines.push(`  ${r.preview.replace(/\n+/g, " ").trim()}${r.preview.length >= 120 ? "…" : ""}`);
       }
 
       if (effectiveOffset + effectiveLimit < total) {
@@ -289,11 +323,47 @@ export function registerTools(server, ctx) {
     }
   );
 
+  // ─── submit_feedback (bug/feature reports) ────────────────────────────────
+
+  server.tool(
+    "submit_feedback",
+    "Report a bug, request a feature, or suggest an improvement. Feedback is stored in the vault and triaged by the development pipeline.",
+    {
+      type: z.enum(["bug", "feature", "improvement"]).describe("Type of feedback"),
+      title: z.string().describe("Short summary of the feedback"),
+      body: z.string().describe("Detailed description"),
+      severity: z.enum(["low", "medium", "high"]).optional().describe("Severity level (default: medium)"),
+    },
+    async ({ type, title, body, severity }) => {
+      const vaultErr = ensureVaultExists(config);
+      if (vaultErr) return vaultErr;
+
+      await ensureIndexed();
+
+      const effectiveSeverity = severity || "medium";
+      const entry = await captureAndIndex(
+        ctx,
+        {
+          kind: "feedback",
+          title,
+          body,
+          tags: [type, effectiveSeverity],
+          source: "submit_feedback",
+          meta: { feedback_type: type, severity: effectiveSeverity, status: "new" },
+        },
+        indexEntry
+      );
+
+      const relPath = entry.filePath ? entry.filePath.replace(config.vaultDir + "/", "") : entry.filePath;
+      return ok(`Feedback submitted: ${type} [${effectiveSeverity}] → ${relPath}\n  id: ${entry.id}\n  title: ${title}`);
+    }
+  );
+
   // ─── context_status (diagnostics) ──────────────────────────────────────────
 
   server.tool(
     "context_status",
-    "Show vault health: resolved config, file counts per kind, database size, and any issues. Use to verify setup or troubleshoot.",
+    "Show vault health: resolved config, file counts per kind, database size, and any issues. Use to verify setup or troubleshoot. Call this when a user asks about their vault or to debug search issues.",
     {},
     () => {
       const status = gatherVaultStatus(ctx);
@@ -346,6 +416,17 @@ export function registerTools(server, ctx) {
         lines.push(`Auto-reindex will fix this on next search or save.`);
       }
 
+      // Suggested actions
+      const actions = [];
+      if (status.stalePaths) actions.push("- Run `context-mcp reindex` to fix stale paths");
+      if (status.embeddingStatus?.missing > 0) actions.push("- Run `context-mcp reindex` to generate missing embeddings");
+      if (!config.vaultDirExists) actions.push("- Run `context-mcp setup` to create the vault directory");
+      if (status.kindCounts.length === 0 && config.vaultDirExists) actions.push("- Use `save_context` to add your first entry");
+
+      if (actions.length) {
+        lines.push("", "### Suggested Actions", ...actions);
+      }
+
       return ok(lines.join("\n"));
     }
   );

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "context-vault",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
     "context-mcp": "bin/cli.js"
   },
   "main": "src/server/index.js",
+  "scripts": {
+    "prepack": "mkdir -p node_modules/@context-vault && rm -rf node_modules/@context-vault/core && cp -rL ../core node_modules/@context-vault/core && rm -rf node_modules/@context-vault/core/node_modules"
+  },
   "files": [
     "bin/",
     "src/",
     "ui/",
     "README.md",
-    "LICENSE",
-    "smithery.yaml"
+    "LICENSE"
   ],
   "license": "MIT",
   "engines": { "node": ">=20" },
@@ -21,17 +23,8 @@
   "repository": { "type": "git", "url": "https://github.com/fellanH/context-mcp.git" },
   "homepage": "https://github.com/fellanH/context-mcp",
   "keywords": ["mcp", "model-context-protocol", "ai", "knowledge-base", "knowledge-management", "vault", "rag", "sqlite", "embeddings", "claude", "cursor", "cline", "windsurf"],
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "devDependencies": {
-    "vitest": "^3.0.0"
-  },
+  "bundledDependencies": ["@context-vault/core"],
   "dependencies": {
-    "@huggingface/transformers": "^3.0.0",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "better-sqlite3": "^12.6.2",
-    "sqlite-vec": "^0.1.0"
+    "@context-vault/core": "^2.3.0"
   }
 }

package/src/server/index.js

@@ -9,10 +9,10 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf-8"));
 
-import { resolveConfig } from "../core/config.js";
-import { embed } from "../index/embed.js";
-import { initDatabase, prepareStatements, insertVec, deleteVec } from "../index/db.js";
-import { registerTools } from "./tools.js";
+import { resolveConfig } from "@context-vault/core/core/config";
+import { embed } from "@context-vault/core/index/embed";
+import { initDatabase, prepareStatements, insertVec, deleteVec } from "@context-vault/core/index/db";
+import { registerTools } from "@context-vault/core/server/tools";
 
 // ─── Config Resolution ──────────────────────────────────────────────────────
 
@@ -80,3 +80,20 @@ process.on("SIGTERM", shutdown);
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
+
+// ─── Non-blocking Update Check ──────────────────────────────────────────────
+
+setTimeout(() => {
+  import("node:child_process").then(({ execSync }) => {
+    try {
+      const latest = execSync("npm view context-vault version", {
+        encoding: "utf-8",
+        timeout: 5000,
+        stdio: ["pipe", "pipe", "pipe"],
+      }).trim();
+      if (latest && latest !== pkg.version) {
+        console.error(`[context-mcp] Update available: v${pkg.version} → v${latest}. Run: context-mcp update`);
+      }
+    } catch {}
+  }).catch(() => {});
+}, 3000);

package/ui/serve.js

@@ -12,10 +12,10 @@ import { createServer } from "node:http";
 import { readFileSync, writeFileSync, existsSync, statSync, readdirSync } from "node:fs";
 import { resolve, dirname, join, basename } from "node:path";
 import { fileURLToPath } from "node:url";
-import { resolveConfig } from "../src/config.js";
-import { initDatabase } from "../src/db.js";
-import { embed } from "../src/embed.js";
-import { hybridSearch } from "../src/search.js";
+import { resolveConfig } from "@context-vault/core/core/config";
+import { initDatabase } from "@context-vault/core/index/db";
+import { embed } from "@context-vault/core/index/embed";
+import { hybridSearch } from "@context-vault/core/retrieve";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -348,8 +348,9 @@ async function handleSearch(res, url) {
 
   if (!query) return jsonResponse(res, { results: [] });
 
-  const sorted = await hybridSearch(db, embed, query, kindFilter);
-  jsonResponse(res, { query, results: sorted });
+  const searchCtx = { db, config, embed };
+  const results = await hybridSearch(searchCtx, query, { kindFilter });
+  jsonResponse(res, { query, results });
 }
 
 // ─── Config Handlers ─────────────────────────────────────────────────────────

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Felix Hellstrom
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.