context-vault 3.1.6 → 3.1.7

package/src/tools/ingest-project.js

@@ -1,30 +1,27 @@
-import { z } from "zod";
-import { readFileSync, existsSync } from "node:fs";
-import { execSync } from "node:child_process";
-import { join, basename } from "node:path";
-import { captureAndIndex } from "@context-vault/core/capture";
-import { ok, err, ensureVaultExists } from "../helpers.js";
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join, basename } from 'node:path';
+import { captureAndIndex } from '@context-vault/core/capture';
+import { ok, err, ensureVaultExists } from '../helpers.js';
 
-export const name = "ingest_project";
+export const name = 'ingest_project';
 
 export const description =
-  "Scan a local project directory and register it as a project entity in the vault. Extracts metadata from package.json, git history, and README. Also creates a bucket entity for project-scoped tagging.";
+  'Scan a local project directory and register it as a project entity in the vault. Extracts metadata from package.json, git history, and README. Also creates a bucket entity for project-scoped tagging.';
 
 export const inputSchema = {
-  path: z.string().describe("Absolute path to the project directory to ingest"),
+  path: z.string().describe('Absolute path to the project directory to ingest'),
   tags: z
     .array(z.string())
     .optional()
-    .describe("Additional tags to apply (bucket tags are auto-generated)"),
-  pillar: z
-    .string()
-    .optional()
-    .describe("Parent pillar/domain name — creates a bucket:pillar tag"),
+    .describe('Additional tags to apply (bucket tags are auto-generated)'),
+  pillar: z.string().optional().describe('Parent pillar/domain name — creates a bucket:pillar tag'),
 };
 
 function safeRead(filePath) {
   try {
-    return readFileSync(filePath, "utf-8");
+    return readFileSync(filePath, 'utf-8');
   } catch {
     return null;
   }
@@ -34,8 +31,8 @@ function safeExec(cmd, cwd) {
   try {
     return execSync(cmd, {
       cwd,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
     }).trim();
   } catch {
     return null;
@@ -46,49 +43,47 @@ function detectTechStack(projectPath, pkgJson) {
   const stack = [];
 
   if (
-    existsSync(join(projectPath, "pyproject.toml")) ||
-    existsSync(join(projectPath, "setup.py"))
+    existsSync(join(projectPath, 'pyproject.toml')) ||
+    existsSync(join(projectPath, 'setup.py'))
   ) {
-    stack.push("python");
+    stack.push('python');
   }
-  if (existsSync(join(projectPath, "Cargo.toml"))) {
-    stack.push("rust");
+  if (existsSync(join(projectPath, 'Cargo.toml'))) {
+    stack.push('rust');
   }
-  if (existsSync(join(projectPath, "go.mod"))) {
-    stack.push("go");
+  if (existsSync(join(projectPath, 'go.mod'))) {
+    stack.push('go');
   }
   if (pkgJson) {
-    stack.push("javascript");
+    stack.push('javascript');
     const allDeps = {
       ...(pkgJson.dependencies || {}),
       ...(pkgJson.devDependencies || {}),
     };
-    if (allDeps.typescript || existsSync(join(projectPath, "tsconfig.json"))) {
-      stack.push("typescript");
+    if (allDeps.typescript || existsSync(join(projectPath, 'tsconfig.json'))) {
+      stack.push('typescript');
     }
-    if (allDeps.react || allDeps["react-dom"]) stack.push("react");
-    if (allDeps.next || allDeps["next"]) stack.push("nextjs");
-    if (allDeps.vue) stack.push("vue");
-    if (allDeps.svelte) stack.push("svelte");
-    if (allDeps.express) stack.push("express");
-    if (allDeps.fastify) stack.push("fastify");
-    if (allDeps.hono) stack.push("hono");
-    if (allDeps.vite) stack.push("vite");
-    if (allDeps.electron) stack.push("electron");
-    if (allDeps.tauri || allDeps["@tauri-apps/api"]) stack.push("tauri");
+    if (allDeps.react || allDeps['react-dom']) stack.push('react');
+    if (allDeps.next || allDeps['next']) stack.push('nextjs');
+    if (allDeps.vue) stack.push('vue');
+    if (allDeps.svelte) stack.push('svelte');
+    if (allDeps.express) stack.push('express');
+    if (allDeps.fastify) stack.push('fastify');
+    if (allDeps.hono) stack.push('hono');
+    if (allDeps.vite) stack.push('vite');
+    if (allDeps.electron) stack.push('electron');
+    if (allDeps.tauri || allDeps['@tauri-apps/api']) stack.push('tauri');
   }
 
   return [...new Set(stack)];
 }
 
 function extractReadmeDescription(projectPath) {
-  const raw =
-    safeRead(join(projectPath, "README.md")) ||
-    safeRead(join(projectPath, "readme.md"));
+  const raw = safeRead(join(projectPath, 'README.md')) || safeRead(join(projectPath, 'readme.md'));
   if (!raw) return null;
-  for (const line of raw.split("\n")) {
+  for (const line of raw.split('\n')) {
     const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
+    if (!trimmed || trimmed.startsWith('#')) continue;
     return trimmed.slice(0, 200);
   }
   return null;
@@ -105,14 +100,14 @@ function buildProjectBody({
 }) {
   const lines = [];
   lines.push(`## ${projectName}`);
-  if (description) lines.push("", description);
-  lines.push("", "### Metadata");
+  if (description) lines.push('', description);
+  lines.push('', '### Metadata');
   lines.push(`- **Path**: \`${projectPath}\``);
   if (repoUrl) lines.push(`- **Repo**: ${repoUrl}`);
-  if (techStack.length) lines.push(`- **Stack**: ${techStack.join(", ")}`);
+  if (techStack.length) lines.push(`- **Stack**: ${techStack.join(', ')}`);
   if (lastCommit) lines.push(`- **Last commit**: ${lastCommit}`);
-  lines.push(`- **CLAUDE.md**: ${hasClaudeMd ? "yes" : "no"}`);
-  return lines.join("\n");
+  lines.push(`- **CLAUDE.md**: ${hasClaudeMd ? 'yes' : 'no'}`);
+  return lines.join('\n');
 }
 
 /**
@@ -120,34 +115,27 @@ function buildProjectBody({
  * @param {import('../types.js').BaseCtx & Partial<import('../types.js').HostedCtxExtensions>} ctx
  * @param {import('../types.js').ToolShared} shared
  */
-export async function handler(
-  { path: projectPath, tags, pillar },
-  ctx,
-  { ensureIndexed },
-) {
+export async function handler({ path: projectPath, tags, pillar }, ctx, { ensureIndexed }) {
   const { config } = ctx;
 
   const vaultErr = ensureVaultExists(config);
   if (vaultErr) return vaultErr;
 
   if (!projectPath?.trim()) {
-    return err(
-      "Required: path (absolute path to project directory)",
-      "INVALID_INPUT",
-    );
+    return err('Required: path (absolute path to project directory)', 'INVALID_INPUT');
   }
   if (!existsSync(projectPath)) {
-    return err(`Directory not found: ${projectPath}`, "INVALID_INPUT");
+    return err(`Directory not found: ${projectPath}`, 'INVALID_INPUT');
   }
 
   await ensureIndexed();
 
   // Read package.json if present
   let pkgJson = null;
-  const pkgPath = join(projectPath, "package.json");
+  const pkgPath = join(projectPath, 'package.json');
   if (existsSync(pkgPath)) {
     try {
-      pkgJson = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      pkgJson = JSON.parse(readFileSync(pkgPath, 'utf-8'));
     } catch {
       pkgJson = null;
     }
@@ -156,34 +144,29 @@ export async function handler(
   // Derive project name
   let projectName = basename(projectPath);
   if (pkgJson?.name) {
-    projectName = pkgJson.name.replace(/^@[^/]+\//, "");
+    projectName = pkgJson.name.replace(/^@[^/]+\//, '');
   }
 
   // Slug-safe identity_key
   const identityKey = projectName
     .toLowerCase()
-    .replace(/[^a-z0-9-]/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "");
+    .replace(/[^a-z0-9-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
 
   // Description: package.json > README
-  const description =
-    pkgJson?.description || extractReadmeDescription(projectPath) || null;
+  const description = pkgJson?.description || extractReadmeDescription(projectPath) || null;
 
   // Tech stack detection
   const techStack = detectTechStack(projectPath, pkgJson);
 
   // Git metadata
-  const isGitRepo = existsSync(join(projectPath, ".git"));
-  const repoUrl = isGitRepo
-    ? safeExec("git remote get-url origin", projectPath)
-    : null;
-  const lastCommit = isGitRepo
-    ? safeExec("git log -1 --format=%ci", projectPath)
-    : null;
+  const isGitRepo = existsSync(join(projectPath, '.git'));
+  const repoUrl = isGitRepo ? safeExec('git remote get-url origin', projectPath) : null;
+  const lastCommit = isGitRepo ? safeExec('git log -1 --format=%ci', projectPath) : null;
 
   // CLAUDE.md presence
-  const hasClaudeMd = existsSync(join(projectPath, "CLAUDE.md"));
+  const hasClaudeMd = existsSync(join(projectPath, 'CLAUDE.md'));
 
   // Build tags
   const bucketTag = `bucket:${identityKey}`;
@@ -212,7 +195,7 @@ export async function handler(
 
   // Save project entity
   const projectEntry = await captureAndIndex(ctx, {
-    kind: "project",
+    kind: 'project',
     title: projectName,
     body,
     tags: allTags,
@@ -221,18 +204,18 @@ export async function handler(
   });
 
   // Save bucket entity if it doesn't already exist
-  const bucketUserClause = "";
+  const bucketUserClause = '';
   const bucketParams = false ? [bucketTag] : [bucketTag];
   const bucketExists = ctx.db
     .prepare(
-      `SELECT 1 FROM vault WHERE kind = 'bucket' AND identity_key = ? ${bucketUserClause} LIMIT 1`,
+      `SELECT 1 FROM vault WHERE kind = 'bucket' AND identity_key = ? ${bucketUserClause} LIMIT 1`
     )
     .get(...bucketParams);
 
   let bucketEntry = null;
   if (!bucketExists) {
     bucketEntry = await captureAndIndex(ctx, {
-      kind: "bucket",
+      kind: 'bucket',
       title: projectName,
       body: `Bucket for project: ${projectName}`,
       tags: allTags,
@@ -242,21 +225,21 @@ export async function handler(
   }
 
   const relPath = projectEntry.filePath
-    ? projectEntry.filePath.replace(config.vaultDir + "/", "")
+    ? projectEntry.filePath.replace(config.vaultDir + '/', '')
     : projectEntry.filePath;
 
   const parts = [
     `✓ Ingested project → ${relPath}`,
     `  id: ${projectEntry.id}`,
     `  title: ${projectEntry.title}`,
-    `  tags: ${allTags.join(", ")}`,
-    ...(techStack.length ? [`  stack: ${techStack.join(", ")}`] : []),
+    `  tags: ${allTags.join(', ')}`,
+    ...(techStack.length ? [`  stack: ${techStack.join(', ')}`] : []),
     ...(repoUrl ? [`  repo: ${repoUrl}`] : []),
   ];
 
   if (bucketEntry) {
     const bucketRelPath = bucketEntry.filePath
-      ? bucketEntry.filePath.replace(config.vaultDir + "/", "")
+      ? bucketEntry.filePath.replace(config.vaultDir + '/', '')
       : bucketEntry.filePath;
     parts.push(``, `✓ Created bucket → ${bucketRelPath}`);
     parts.push(`  id: ${bucketEntry.id}`);
@@ -264,9 +247,6 @@ export async function handler(
     parts.push(``, `  (bucket '${bucketTag}' already exists — skipped)`);
   }
 
-  parts.push(
-    "",
-    "_Use get_context with bucket tag to retrieve project-scoped entries._",
-  );
-  return ok(parts.join("\n"));
+  parts.push('', '_Use get_context with bucket tag to retrieve project-scoped entries._');
+  return ok(parts.join('\n'));
 }

package/src/tools/ingest-url.js

@@ -1,23 +1,19 @@
-import { z } from "zod";
-import { captureAndIndex } from "@context-vault/core/capture";
-import { ok, err, ensureVaultExists } from "../helpers.js";
-import {
-  MAX_KIND_LENGTH,
-  MAX_TAG_LENGTH,
-  MAX_TAGS_COUNT,
-} from "@context-vault/core/constants";
+import { z } from 'zod';
+import { captureAndIndex } from '@context-vault/core/capture';
+import { ok, err, ensureVaultExists } from '../helpers.js';
+import { MAX_KIND_LENGTH, MAX_TAG_LENGTH, MAX_TAGS_COUNT } from '@context-vault/core/constants';
 
 const MAX_URL_LENGTH = 2048;
 
-export const name = "ingest_url";
+export const name = 'ingest_url';
 
 export const description =
-  "Fetch a URL, extract its readable content, and save it as a vault entry. Useful for saving articles, documentation, or web pages to your knowledge vault.";
+  'Fetch a URL, extract its readable content, and save it as a vault entry. Useful for saving articles, documentation, or web pages to your knowledge vault.';
 
 export const inputSchema = {
-  url: z.string().describe("The URL to fetch and save"),
-  kind: z.string().optional().describe("Entry kind (default: reference)"),
-  tags: z.array(z.string()).optional().describe("Tags for the entry"),
+  url: z.string().describe('The URL to fetch and save'),
+  kind: z.string().optional().describe('Entry kind (default: reference)'),
+  tags: z.array(z.string()).optional().describe('Tags for the entry'),
 };
 
 /**
@@ -25,39 +21,27 @@ export const inputSchema = {
  * @param {import('../types.js').BaseCtx & Partial<import('../types.js').HostedCtxExtensions>} ctx
  * @param {import('../types.js').ToolShared} shared
  */
-export async function handler(
-  { url: targetUrl, kind, tags },
-  ctx,
-  { ensureIndexed },
-) {
+export async function handler({ url: targetUrl, kind, tags }, ctx, { ensureIndexed }) {
   const { config } = ctx;
 
   const vaultErr = ensureVaultExists(config);
   if (vaultErr) return vaultErr;
 
-  if (!targetUrl?.trim())
-    return err("Required: url (non-empty string)", "INVALID_INPUT");
+  if (!targetUrl?.trim()) return err('Required: url (non-empty string)', 'INVALID_INPUT');
   if (targetUrl.length > MAX_URL_LENGTH)
-    return err(`url must be under ${MAX_URL_LENGTH} chars`, "INVALID_INPUT");
+    return err(`url must be under ${MAX_URL_LENGTH} chars`, 'INVALID_INPUT');
   if (kind !== undefined && kind !== null) {
-    if (typeof kind !== "string" || kind.length > MAX_KIND_LENGTH) {
-      return err(
-        `kind must be a string, max ${MAX_KIND_LENGTH} chars`,
-        "INVALID_INPUT",
-      );
+    if (typeof kind !== 'string' || kind.length > MAX_KIND_LENGTH) {
+      return err(`kind must be a string, max ${MAX_KIND_LENGTH} chars`, 'INVALID_INPUT');
     }
   }
   if (tags !== undefined && tags !== null) {
-    if (!Array.isArray(tags))
-      return err("tags must be an array of strings", "INVALID_INPUT");
+    if (!Array.isArray(tags)) return err('tags must be an array of strings', 'INVALID_INPUT');
     if (tags.length > MAX_TAGS_COUNT)
-      return err(`tags: max ${MAX_TAGS_COUNT} tags allowed`, "INVALID_INPUT");
+      return err(`tags: max ${MAX_TAGS_COUNT} tags allowed`, 'INVALID_INPUT');
     for (const tag of tags) {
-      if (typeof tag !== "string" || tag.length > MAX_TAG_LENGTH) {
-        return err(
-          `each tag must be a string, max ${MAX_TAG_LENGTH} chars`,
-          "INVALID_INPUT",
-        );
+      if (typeof tag !== 'string' || tag.length > MAX_TAG_LENGTH) {
+        return err(`each tag must be a string, max ${MAX_TAG_LENGTH} chars`, 'INVALID_INPUT');
       }
     }
   }
@@ -65,23 +49,23 @@ export async function handler(
   await ensureIndexed();
 
   try {
-    const { ingestUrl } = await import("../../capture/ingest-url.js");
+    const { ingestUrl } = await import('../../capture/ingest-url.js');
     const entryData = await ingestUrl(targetUrl, { kind, tags });
     const entry = await captureAndIndex(ctx, { ...entryData });
     const relPath = entry.filePath
-      ? entry.filePath.replace(config.vaultDir + "/", "")
+      ? entry.filePath.replace(config.vaultDir + '/', '')
       : entry.filePath;
     const parts = [
       `✓ Ingested URL → ${relPath}`,
       `  id: ${entry.id}`,
-      `  title: ${entry.title || "(untitled)"}`,
+      `  title: ${entry.title || '(untitled)'}`,
       `  source: ${entry.source || targetUrl}`,
     ];
-    if (entry.tags?.length) parts.push(`  tags: ${entry.tags.join(", ")}`);
+    if (entry.tags?.length) parts.push(`  tags: ${entry.tags.join(', ')}`);
     parts.push(`  body: ${entry.body?.length || 0} chars`);
-    parts.push("", "_Use this id to update or delete later._");
-    return ok(parts.join("\n"));
+    parts.push('', '_Use this id to update or delete later._');
+    return ok(parts.join('\n'));
   } catch (e) {
-    return err(`Failed to ingest URL: ${e.message}`, "INGEST_FAILED");
+    return err(`Failed to ingest URL: ${e.message}`, 'INGEST_FAILED');
   }
 }

package/src/tools/list-buckets.js

@@ -1,7 +1,7 @@
-import { z } from "zod";
-import { ok } from "../helpers.js";
+import { z } from 'zod';
+import { ok } from '../helpers.js';
 
-export const name = "list_buckets";
+export const name = 'list_buckets';
 
 export const description =
   "List all registered bucket entities in the vault. Buckets are named scopes used to group entries via 'bucket:' prefixed tags. Returns each bucket's name, description, parent, and optional entry count.";
@@ -11,7 +11,7 @@ export const inputSchema = {
     .boolean()
     .optional()
     .describe(
-      "Include count of entries tagged with each bucket (default true). Set false to skip the count queries for faster response.",
+      'Include count of entries tagged with each bucket (default true). Set false to skip the count queries for faster response.'
     ),
 };
 
@@ -20,14 +20,10 @@ export const inputSchema = {
  * @param {import('../types.js').BaseCtx & Partial<import('../types.js').HostedCtxExtensions>} ctx
  * @param {import('../types.js').ToolShared} shared
  */
-export async function handler(
-  { include_counts = true },
-  ctx,
-  { ensureIndexed, reindexFailed },
-) {
+export async function handler({ include_counts = true }, ctx, { ensureIndexed, reindexFailed }) {
   await ensureIndexed();
 
-  const userClause = "";
+  const userClause = '';
   const userParams = [];
 
   const buckets = ctx.db
@@ -38,20 +34,20 @@ export async function handler(
          AND (expires_at IS NULL OR expires_at > datetime('now'))
          AND superseded_by IS NULL
          ${userClause}
-       ORDER BY title ASC`,
+       ORDER BY title ASC`
     )
     .all(...userParams);
 
   if (!buckets.length) {
     return ok(
-      'No buckets registered.\n\nCreate one with `save_context(kind: "bucket", identity_key: "bucket:myproject", title: "My Project", body: "...")` to register a bucket.',
+      'No buckets registered.\n\nCreate one with `save_context(kind: "bucket", identity_key: "bucket:myproject", title: "My Project", body: "...")` to register a bucket.'
     );
   }
 
   const lines = [];
   if (reindexFailed) {
     lines.push(
-      `> **Warning:** Auto-reindex failed. Results may be stale. Run \`context-vault reindex\` to fix.\n`,
+      `> **Warning:** Auto-reindex failed. Results may be stale. Run \`context-vault reindex\` to fix.\n`
     );
   }
   lines.push(`## Registered Buckets (${buckets.length})\n`);
@@ -60,21 +56,19 @@ export async function handler(
     let meta = {};
     if (b.meta) {
       try {
-        meta = typeof b.meta === "string" ? JSON.parse(b.meta) : b.meta;
+        meta = typeof b.meta === 'string' ? JSON.parse(b.meta) : b.meta;
       } catch {
         meta = {};
       }
     }
 
     const bucketTags = b.tags ? JSON.parse(b.tags) : [];
-    const name = b.identity_key
-      ? b.identity_key.replace(/^bucket:/, "")
-      : b.title || b.id;
+    const name = b.identity_key ? b.identity_key.replace(/^bucket:/, '') : b.title || b.id;
     const parent = meta.parent || null;
 
     let entryCount = null;
     if (include_counts && b.identity_key) {
-      const countUserClause = "";
+      const countUserClause = '';
       const countParams = [];
       const row = ctx.db
         .prepare(
@@ -83,7 +77,7 @@ export async function handler(
              AND kind != 'bucket'
              AND (expires_at IS NULL OR expires_at > datetime('now'))
              AND superseded_by IS NULL
-             ${countUserClause}`,
+             ${countUserClause}`
         )
         .get(`%"${b.identity_key}"%`, ...countParams);
       entryCount = row ? row.c : 0;
@@ -94,20 +88,20 @@ export async function handler(
     if (b.identity_key) headerParts.push(`\`${b.identity_key}\``);
     if (parent) headerParts.push(`parent: ${parent}`);
     if (entryCount !== null) headerParts.push(`${entryCount} entries`);
-    lines.push(`- ${headerParts.join(" — ")}`);
+    lines.push(`- ${headerParts.join(' — ')}`);
 
     if (b.body) {
-      const preview = b.body.replace(/\n+/g, " ").trim().slice(0, 120);
-      lines.push(`  ${preview}${b.body.length > 120 ? "…" : ""}`);
+      const preview = b.body.replace(/\n+/g, ' ').trim().slice(0, 120);
+      lines.push(`  ${preview}${b.body.length > 120 ? '…' : ''}`);
     }
     if (bucketTags.length) {
-      lines.push(`  tags: ${bucketTags.join(", ")}`);
+      lines.push(`  tags: ${bucketTags.join(', ')}`);
     }
   }
 
   lines.push(
-    '\n_Register a new bucket with `save_context(kind: "bucket", identity_key: "bucket:<name>", title: "...", body: "...")`_',
+    '\n_Register a new bucket with `save_context(kind: "bucket", identity_key: "bucket:<name>", title: "...", body: "...")`_'
   );
 
-  return ok(lines.join("\n"));
+  return ok(lines.join('\n'));
 }