context-vault 3.1.6 → 3.1.8

package/src/tools/clear-context.js

@@ -1,47 +0,0 @@
-import { z } from "zod";
-import { ok } from "../helpers.js";
-
-export const name = "clear_context";
-
-export const description =
-  "Reset active in-memory session context without deleting vault entries. Call this when switching projects or topics mid-session. With `scope`, all subsequent get_context calls should filter to that tag/project. Vault data is never modified.";
-
-export const inputSchema = {
-  scope: z
-    .string()
-    .optional()
-    .describe(
-      "Optional tag or project name to focus on going forward. When provided, treat subsequent get_context calls as if filtered to this tag.",
-    ),
-};
-
-/**
- * @param {object} args
- * @param {import('../types.js').BaseCtx & Partial<import('../types.js').HostedCtxExtensions>} _ctx
- */
-export function handler({ scope } = {}) {
-  const lines = [
-    "## Context Reset",
-    "",
-    "Active session context has been cleared. All previous context from this session should be disregarded.",
-    "",
-    "Vault entries are unchanged — no data was deleted.",
-  ];
-
-  if (scope?.trim()) {
-    const trimmed = scope.trim();
-    lines.push(
-      "",
-      `### Active Scope: \`${trimmed}\``,
-      "",
-      `Going forward, treat \`get_context\` calls as scoped to the tag or project **"${trimmed}"** unless the user explicitly requests a different scope or passes their own tag filters.`,
-    );
-  } else {
-    lines.push(
-      "",
-      "No scope set. Use `get_context` normally — all vault entries are accessible.",
-    );
-  }
-
-  return ok(lines.join("\n"));
-}

package/src/tools/delete-context.js

@@ -1,54 +0,0 @@
-import { z } from "zod";
-import { unlinkSync } from "node:fs";
-import { ok, err } from "../helpers.js";
-
-export const name = "delete_context";
-
-export const description =
-  "Delete an entry from your vault by its ULID id. Removes the file from disk and cleans up the search index.";
-
-export const inputSchema = {
-  id: z.string().describe("The entry ULID to delete"),
-};
-
-/**
- * @param {object} args
- * @param {import('../types.js').BaseCtx & Partial<import('../types.js').HostedCtxExtensions>} ctx
- * @param {import('../types.js').ToolShared} shared
- */
-export async function handler({ id }, ctx, { ensureIndexed }) {
-  if (!id?.trim())
-    return err("Required: id (non-empty string)", "INVALID_INPUT");
-  await ensureIndexed();
-
-  const entry = ctx.stmts.getEntryById.get(id);
-  if (!entry) return err(`Entry not found: ${id}`, "NOT_FOUND");
-
-  try {
-    // Delete DB record first — if this fails, the file stays and no orphan is created
-    const rowidResult = ctx.stmts.getRowid.get(id);
-    if (rowidResult?.rowid) {
-      try {
-        ctx.deleteVec(Number(rowidResult.rowid));
-      } catch {}
-    }
-    ctx.stmts.deleteEntry.run(id);
-
-    // Delete file from disk after successful DB delete
-    let fileWarning = null;
-    if (entry.file_path) {
-      try {
-        unlinkSync(entry.file_path);
-      } catch (e) {
-        if (e.code !== "ENOENT") {
-          fileWarning = `file could not be removed from disk (${e.code}): ${entry.file_path}`;
-        }
-      }
-    }
-
-    const msg = `Deleted ${entry.kind}: ${entry.title || "(untitled)"} [${id}]`;
-    return ok(fileWarning ? `${msg}\nWarning: ${fileWarning}` : msg);
-  } catch (e) {
-    return err(e.message, "DELETE_FAILED");
-  }
-}

package/src/tools/ingest-project.js

@@ -1,272 +0,0 @@
-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 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.";
-
-export const inputSchema = {
-  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"),
-};
-
-function safeRead(filePath) {
-  try {
-    return readFileSync(filePath, "utf-8");
-  } catch {
-    return null;
-  }
-}
-
-function safeExec(cmd, cwd) {
-  try {
-    return execSync(cmd, {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-
-function detectTechStack(projectPath, pkgJson) {
-  const stack = [];
-
-  if (
-    existsSync(join(projectPath, "pyproject.toml")) ||
-    existsSync(join(projectPath, "setup.py"))
-  ) {
-    stack.push("python");
-  }
-  if (existsSync(join(projectPath, "Cargo.toml"))) {
-    stack.push("rust");
-  }
-  if (existsSync(join(projectPath, "go.mod"))) {
-    stack.push("go");
-  }
-  if (pkgJson) {
-    stack.push("javascript");
-    const allDeps = {
-      ...(pkgJson.dependencies || {}),
-      ...(pkgJson.devDependencies || {}),
-    };
-    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");
-  }
-
-  return [...new Set(stack)];
-}
-
-function extractReadmeDescription(projectPath) {
-  const raw =
-    safeRead(join(projectPath, "README.md")) ||
-    safeRead(join(projectPath, "readme.md"));
-  if (!raw) return null;
-  for (const line of raw.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    return trimmed.slice(0, 200);
-  }
-  return null;
-}
-
-function buildProjectBody({
-  projectName,
-  description,
-  techStack,
-  repoUrl,
-  lastCommit,
-  projectPath,
-  hasClaudeMd,
-}) {
-  const lines = [];
-  lines.push(`## ${projectName}`);
-  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 (lastCommit) lines.push(`- **Last commit**: ${lastCommit}`);
-  lines.push(`- **CLAUDE.md**: ${hasClaudeMd ? "yes" : "no"}`);
-  return lines.join("\n");
-}
-
-/**
- * @param {object} args
- * @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 },
-) {
-  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",
-    );
-  }
-  if (!existsSync(projectPath)) {
-    return err(`Directory not found: ${projectPath}`, "INVALID_INPUT");
-  }
-
-  await ensureIndexed();
-
-  // Read package.json if present
-  let pkgJson = null;
-  const pkgPath = join(projectPath, "package.json");
-  if (existsSync(pkgPath)) {
-    try {
-      pkgJson = JSON.parse(readFileSync(pkgPath, "utf-8"));
-    } catch {
-      pkgJson = null;
-    }
-  }
-
-  // Derive project name
-  let projectName = basename(projectPath);
-  if (pkgJson?.name) {
-    projectName = pkgJson.name.replace(/^@[^/]+\//, "");
-  }
-
-  // Slug-safe identity_key
-  const identityKey = projectName
-    .toLowerCase()
-    .replace(/[^a-z0-9-]/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "");
-
-  // Description: package.json > README
-  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;
-
-  // CLAUDE.md presence
-  const hasClaudeMd = existsSync(join(projectPath, "CLAUDE.md"));
-
-  // Build tags
-  const bucketTag = `bucket:${identityKey}`;
-  const autoTags = [bucketTag];
-  if (pillar) autoTags.push(`bucket:${pillar}`);
-  const allTags = [...new Set([...autoTags, ...(tags || [])])];
-
-  // Build body
-  const body = buildProjectBody({
-    projectName,
-    description,
-    techStack,
-    repoUrl,
-    lastCommit,
-    projectPath,
-    hasClaudeMd,
-  });
-
-  // Build meta
-  const meta = {
-    path: projectPath,
-    ...(repoUrl ? { repo_url: repoUrl } : {}),
-    ...(techStack.length ? { tech_stack: techStack } : {}),
-    has_claude_md: hasClaudeMd,
-  };
-
-  // Save project entity
-  const projectEntry = await captureAndIndex(ctx, {
-    kind: "project",
-    title: projectName,
-    body,
-    tags: allTags,
-    identity_key: identityKey,
-    meta,
-  });
-
-  // Save bucket entity if it doesn't already exist
-  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`,
-    )
-    .get(...bucketParams);
-
-  let bucketEntry = null;
-  if (!bucketExists) {
-    bucketEntry = await captureAndIndex(ctx, {
-      kind: "bucket",
-      title: projectName,
-      body: `Bucket for project: ${projectName}`,
-      tags: allTags,
-      identity_key: bucketTag,
-      meta: { project_path: projectPath },
-    });
-  }
-
-  const relPath = projectEntry.filePath
-    ? 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(", ")}`] : []),
-    ...(repoUrl ? [`  repo: ${repoUrl}`] : []),
-  ];
-
-  if (bucketEntry) {
-    const bucketRelPath = bucketEntry.filePath
-      ? bucketEntry.filePath.replace(config.vaultDir + "/", "")
-      : bucketEntry.filePath;
-    parts.push(``, `✓ Created bucket → ${bucketRelPath}`);
-    parts.push(`  id: ${bucketEntry.id}`);
-  } else {
-    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"));
-}

package/src/tools/ingest-url.js

@@ -1,87 +0,0 @@
-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 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.";
-
-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"),
-};
-
-/**
- * @param {object} args
- * @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 },
-) {
-  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.length > MAX_URL_LENGTH)
-    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 (tags !== undefined && tags !== null) {
-    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");
-    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",
-        );
-      }
-    }
-  }
-
-  await ensureIndexed();
-
-  try {
-    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;
-    const parts = [
-      `✓ Ingested URL → ${relPath}`,
-      `  id: ${entry.id}`,
-      `  title: ${entry.title || "(untitled)"}`,
-      `  source: ${entry.source || targetUrl}`,
-    ];
-    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"));
-  } catch (e) {
-    return err(`Failed to ingest URL: ${e.message}`, "INGEST_FAILED");
-  }
-}