context-vault 2.17.0 → 3.0.1

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

@@ -1,10 +1,11 @@
 import { z } from "zod";
-import { captureAndIndex, updateEntryFile } from "../../capture/index.js";
-import { indexEntry } from "../../index/index.js";
-import { categoryFor, defaultTierFor } from "../../core/categories.js";
-import { normalizeKind } from "../../core/files.js";
+import { captureAndIndex, updateEntryFile } from "@context-vault/core/capture";
+import { indexEntry } from "@context-vault/core/index";
+import { categoryFor, defaultTierFor } from "@context-vault/core/categories";
+import { normalizeKind } from "@context-vault/core/files";
 import { ok, err, ensureVaultExists, ensureValidKind } from "../helpers.js";
-import { maybeShowFeedbackPrompt } from "../../core/telemetry.js";
+import { maybeShowFeedbackPrompt } from "../telemetry.js";
+import { validateRelatedTo } from "../linking.js";
 import {
   MAX_BODY_LENGTH,
   MAX_TITLE_LENGTH,
@@ -14,7 +15,7 @@ import {
   MAX_META_LENGTH,
   MAX_SOURCE_LENGTH,
   MAX_IDENTITY_KEY_LENGTH,
-} from "../../constants.js";
+} from "@context-vault/core/constants";
 
 const DEFAULT_SIMILARITY_THRESHOLD = 0.85;
 const SKIP_THRESHOLD = 0.95;
@@ -24,7 +25,7 @@ async function findSimilar(
   ctx,
   embedding,
   threshold,
-  userId,
+  
   { hydrate = false } = {},
 ) {
   try {
@@ -43,9 +44,15 @@ async function findSimilar(
 
     const rowids = vecRows.map((vr) => vr.rowid);
     const placeholders = rowids.map(() => "?").join(",");
-    const columns = hydrate
-      ? "rowid, id, title, body, kind, tags, category, user_id, updated_at"
-      : "rowid, id, title, category, user_id";
+    // Local mode has no user_id column — omit it from the SELECT list.
+    const isLocal = ctx.stmts._mode === "local";
+    const columns = isLocal
+      ? hydrate
+        ? "rowid, id, title, body, kind, tags, category, updated_at"
+        : "rowid, id, title, category"
+      : hydrate
+        ? "rowid, id, title, body, kind, tags, category, updated_at"
+        : "rowid, id, title, category";
     const hydratedRows = ctx.db
       .prepare(`SELECT ${columns} FROM vault WHERE rowid IN (${placeholders})`)
       .all(...rowids);
@@ -59,7 +66,6 @@ async function findSimilar(
       if (similarity < threshold) continue;
       const row = byRowid.get(vr.rowid);
       if (!row) continue;
-      if (userId !== undefined && row.user_id !== userId) continue;
       if (row.category === "entity") continue;
       const entry = { id: row.id, title: row.title, score: similarity };
       if (hydrate) {
@@ -294,6 +300,12 @@ export const inputSchema = {
     .describe(
       "Array of entry IDs that this entry supersedes/replaces. Those entries will be marked with superseded_by pointing to this new entry and excluded from future search results by default.",
     ),
+  related_to: z
+    .array(z.string())
+    .optional()
+    .describe(
+      "Array of entry IDs this entry is related to. Enables bidirectional graph traversal — use get_context with follow_links:true to retrieve linked entries.",
+    ),
   source_files: z
     .array(
       z.object({
@@ -359,6 +371,7 @@ export async function handler(
     identity_key,
     expires_at,
     supersedes,
+    related_to,
     source_files,
     dry_run,
     similarity_threshold,
@@ -369,12 +382,14 @@ export async function handler(
   { ensureIndexed },
 ) {
   const { config } = ctx;
-  const userId = ctx.userId !== undefined ? ctx.userId : undefined;
   const suggestMode = conflict_resolution !== "off";
 
   const vaultErr = ensureVaultExists(config);
   if (vaultErr) return vaultErr;
 
+  const relatedToErr = validateRelatedTo(related_to);
+  if (relatedToErr) return err(relatedToErr, "INVALID_INPUT");
+
   const inputErr = validateSaveInput({
     kind,
     title,
@@ -395,7 +410,6 @@ export async function handler(
     if (!existing) return err(`Entry not found: ${id}`, "NOT_FOUND");
 
     // Ownership check: don't leak existence across users
-    if (userId !== undefined && existing.user_id !== userId) {
       return err(`Entry not found: ${id}`, "NOT_FOUND");
     }
 
@@ -428,9 +442,15 @@ export async function handler(
       source,
       expires_at,
       supersedes,
+      related_to,
       source_files,
     });
     await indexEntry(ctx, entry);
+    if (entry.related_to?.length && ctx.stmts.updateRelatedTo) {
+      ctx.stmts.updateRelatedTo.run(JSON.stringify(entry.related_to), entry.id);
+    } else if (entry.related_to === null && ctx.stmts.updateRelatedTo) {
+      ctx.stmts.updateRelatedTo.run(null, entry.id);
+    }
     const relPath = entry.filePath
       ? entry.filePath.replace(config.vaultDir + "/", "")
       : entry.filePath;
@@ -474,7 +494,7 @@ export async function handler(
         ctx,
         queryEmbedding,
         threshold,
-        userId,
+        
         { hydrate: suggestMode },
       );
     }
@@ -531,8 +551,9 @@ export async function handler(
     identity_key,
     expires_at,
     supersedes,
+    related_to,
     source_files,
-    userId,
+    
     tier: effectiveTier,
   });
 
@@ -561,9 +582,8 @@ export async function handler(
     (t) => typeof t === "string" && t.startsWith("bucket:"),
   );
   for (const bt of bucketTags) {
-    const bucketUserClause = userId !== undefined ? "AND user_id = ?" : "";
-    const bucketParams =
-      userId !== undefined ? [bt, userId] : [bt];
+    const bucketUserClause = "";
+    const bucketParams = false ? [bt] : [bt];
     const exists = ctx.db
       .prepare(
         `SELECT 1 FROM vault WHERE kind = 'bucket' AND identity_key = ? ${bucketUserClause} LIMIT 1`,
@@ -591,11 +611,11 @@ export async function handler(
     try {
       const countRow = ctx.db
         .prepare(
-          userId !== undefined
-            ? "SELECT COUNT(*) as c FROM vault WHERE user_id = ?"
+          false
+            
             : "SELECT COUNT(*) as c FROM vault",
         )
-        .get(...(userId !== undefined ? [userId] : []));
+        .get(...([]));
       if (countRow.c >= criticalLimit) {
         parts.push(
           ``,

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

@@ -79,7 +79,6 @@ function formatEntry(entry) {
 
 export async function handler({ project, max_tokens, buckets }, ctx, { ensureIndexed }) {
   const { config } = ctx;
-  const userId = ctx.userId !== undefined ? ctx.userId : undefined;
 
   const vaultErr = ensureVaultExists(config);
   if (vaultErr) return vaultErr;
@@ -110,7 +109,7 @@ export async function handler({ project, max_tokens, buckets }, ctx, { ensureInd
   );
   tokensUsed += estimateTokens(sections.join("\n"));
 
-  const lastSession = queryLastSession(ctx, userId, effectiveTags);
+  const lastSession = queryLastSession(ctx, effectiveTags);
   if (lastSession) {
     const sessionBlock = [
       "## Last Session Summary",
@@ -128,7 +127,7 @@ export async function handler({ project, max_tokens, buckets }, ctx, { ensureInd
     ctx,
     PRIORITY_KINDS,
     sinceDate,
-    userId,
+    
     effectiveTags,
   );
   if (decisions.length > 0) {
@@ -150,7 +149,7 @@ export async function handler({ project, max_tokens, buckets }, ctx, { ensureInd
     }
   }
 
-  const recent = queryRecent(ctx, sinceDate, userId, effectiveTags);
+  const recent = queryRecent(ctx, sinceDate, effectiveTags);
   const seenIds = new Set(decisions.map((d) => d.id));
   if (lastSession) seenIds.add(lastSession.id);
   const deduped = recent.filter((r) => !seenIds.has(r.id));
@@ -202,13 +201,11 @@ export async function handler({ project, max_tokens, buckets }, ctx, { ensureInd
   return result;
 }
 
-function queryLastSession(ctx, userId, effectiveTags) {
+function queryLastSession(ctx, effectiveTags) {
   const clauses = [`kind = '${SESSION_SUMMARY_KIND}'`];
   const params = [];
 
-  if (userId !== undefined) {
-    clauses.push("user_id = ?");
-    params.push(userId);
+  if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
   clauses.push("superseded_by IS NULL");
@@ -228,7 +225,7 @@ function queryLastSession(ctx, userId, effectiveTags) {
   return rows[0] || null;
 }
 
-function queryByKinds(ctx, kinds, since, userId, effectiveTags) {
+function queryByKinds(ctx, kinds, since, effectiveTags) {
   const kindPlaceholders = kinds.map(() => "?").join(",");
   const clauses = [`kind IN (${kindPlaceholders})`];
   const params = [...kinds];
@@ -236,9 +233,7 @@ function queryByKinds(ctx, kinds, since, userId, effectiveTags) {
   clauses.push("created_at >= ?");
   params.push(since);
 
-  if (userId !== undefined) {
-    clauses.push("user_id = ?");
-    params.push(userId);
+  if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
   clauses.push("superseded_by IS NULL");
@@ -258,13 +253,11 @@ function queryByKinds(ctx, kinds, since, userId, effectiveTags) {
   return rows;
 }
 
-function queryRecent(ctx, since, userId, effectiveTags) {
+function queryRecent(ctx, since, effectiveTags) {
   const clauses = ["created_at >= ?"];
   const params = [since];
 
-  if (userId !== undefined) {
-    clauses.push("user_id = ?");
-    params.push(userId);
+  if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
   clauses.push("superseded_by IS NULL");

package/node_modules/@context-vault/core/src/capture/file-ops.js

@@ -1,97 +0,0 @@
-/**
- * file-ops.js — Capture-specific file operations
- *
- * Writes markdown entry files with frontmatter to the vault directory.
- */
-
-import { mkdirSync, writeFileSync } from "node:fs";
-import { resolve, relative } from "node:path";
-import { formatFrontmatter } from "../core/frontmatter.js";
-import { slugify, kindToPath } from "../core/files.js";
-import { formatBody } from "./formatters.js";
-
-export function safeFolderPath(vaultDir, kind, folder) {
-  const base = resolve(vaultDir, kindToPath(kind));
-  if (!folder) return base;
-  const resolved = resolve(base, folder);
-  const rel = relative(base, resolved);
-  if (rel.startsWith("..") || resolve(base, rel) !== resolved) {
-    throw new Error(`Folder path escapes vault: "${folder}"`);
-  }
-  return resolved;
-}
-
-export function writeEntryFile(
-  vaultDir,
-  kind,
-  {
-    id,
-    title,
-    body,
-    meta,
-    tags,
-    source,
-    createdAt,
-    updatedAt,
-    folder,
-    category,
-    identity_key,
-    expires_at,
-    supersedes,
-  },
-) {
-  // P5: folder is now a top-level param; also accept from meta for backward compat
-  const resolvedFolder = folder || meta?.folder || "";
-  const dir = safeFolderPath(vaultDir, kind, resolvedFolder);
-
-  try {
-    mkdirSync(dir, { recursive: true });
-  } catch (e) {
-    throw new Error(`Failed to create directory "${dir}": ${e.message}`);
-  }
-
-  const created = createdAt || new Date().toISOString();
-  const fmFields = { id };
-
-  // Add kind-specific meta fields to frontmatter (flattened, not nested)
-  if (meta) {
-    for (const [k, v] of Object.entries(meta)) {
-      if (k === "folder") continue;
-      if (v !== null && v !== undefined) fmFields[k] = v;
-    }
-  }
-
-  if (identity_key) fmFields.identity_key = identity_key;
-  if (expires_at) fmFields.expires_at = expires_at;
-  if (supersedes?.length) fmFields.supersedes = supersedes;
-  fmFields.tags = tags || [];
-  fmFields.source = source || "claude-code";
-  fmFields.created = created;
-  if (updatedAt && updatedAt !== created) fmFields.updated = updatedAt;
-
-  const mdBody = formatBody(kind, { title, body, meta });
-
-  // Entity kinds: deterministic filename from identity_key (no ULID suffix)
-  let filename;
-  if (category === "entity" && identity_key) {
-    const identitySlug = slugify(identity_key);
-    filename = identitySlug
-      ? `${identitySlug}.md`
-      : `${id.slice(-8).toLowerCase()}.md`;
-  } else {
-    const slug = slugify((title || body).slice(0, 40));
-    const shortId = id.slice(-8).toLowerCase();
-    filename = slug ? `${slug}-${shortId}.md` : `${shortId}.md`;
-  }
-
-  const filePath = resolve(dir, filename);
-  const md = formatFrontmatter(fmFields) + mdBody;
-
-  try {
-    writeFileSync(filePath, md);
-  } catch (e) {
-    throw new Error(`Failed to write entry file "${filePath}": ${e.message}`);
-  }
-
-  return filePath;
-}

package/node_modules/@context-vault/core/src/capture/import-pipeline.js

@@ -1,46 +0,0 @@
-import { captureAndIndex } from "./index.js";
-
-export async function importEntries(ctx, entries, opts = {}) {
-  const { onProgress, source } = opts;
-  let imported = 0;
-  let failed = 0;
-  const errors = [];
-
-  for (let i = 0; i < entries.length; i++) {
-    const entry = entries[i];
-
-    if (onProgress) {
-      onProgress(i + 1, entries.length);
-    }
-
-    try {
-      if (!entry.body?.trim()) {
-        failed++;
-        errors.push({ index: i, title: entry.title, error: "Empty body" });
-        continue;
-      }
-
-      await captureAndIndex(ctx, {
-        kind: entry.kind || "insight",
-        title: entry.title || null,
-        body: entry.body,
-        meta: entry.meta,
-        tags: entry.tags,
-        source: entry.source || source || "import",
-        identity_key: entry.identity_key,
-        expires_at: entry.expires_at,
-        userId: ctx.userId || null,
-      });
-      imported++;
-    } catch (err) {
-      failed++;
-      errors.push({
-        index: i,
-        title: entry.title || null,
-        error: err.message,
-      });
-    }
-  }
-
-  return { imported, failed, errors };
-}