seekstone 0.11.0 → 0.12.0

package/dist/index.js

@@ -238,15 +238,6 @@ async function appendNote(ctx2, input) {
   };
 }
 
-// src/tools/create_note.ts
-import { access, mkdir, readFile as readFile2 } from "fs/promises";
-import { dirname, join as join2 } from "path";
-import { stringify as stringifyYaml } from "yaml";
-import { z as z2 } from "zod";
-
-// src/index/doc.ts
-import { basename, extname } from "path";
-
 // ../core/src/extract.ts
 var LINK_WITH_LINES_RE = /(!?\[\[)([^\]|#\n]{1,512})(#[^\]|\n]{1,512})?(\|[^\]\n]{1,512})?(\]\])/g;
 function extractLinksWithLines(raw) {
@@ -288,7 +279,298 @@ function frontmatterTags(fm) {
   return [];
 }
 
+// src/tools/context_pack.ts
+import { z as z3 } from "zod";
+
+// src/index/excerpt.ts
+function extractExcerpt(text, terms, maxLen = 200) {
+  const lower = text.toLowerCase();
+  let bestIdx = -1;
+  for (const term of terms) {
+    const idx = lower.indexOf(term.toLowerCase());
+    if (idx !== -1 && (bestIdx === -1 || idx < bestIdx)) {
+      bestIdx = idx;
+    }
+  }
+  if (bestIdx === -1) {
+    return truncate(text.trimStart(), maxLen);
+  }
+  const half = Math.floor(maxLen / 2);
+  const start = Math.max(0, bestIdx - half);
+  const end = Math.min(text.length, bestIdx + half + (terms[0]?.length ?? 0));
+  const slice = text.slice(start, end).trim();
+  return `${start > 0 ? "\u2026" : ""}${slice}${end < text.length ? "\u2026" : ""}`;
+}
+function truncate(s, max) {
+  if (s.length <= max) return s;
+  return `${s.slice(0, max).trimEnd()}\u2026`;
+}
+
+// src/index/resolve.ts
+function resolveLink(target, notes2) {
+  if (notes2.has(target)) return target;
+  const withMd = `${target}.md`;
+  if (notes2.has(withMd)) return withMd;
+  const targetLower = target.toLowerCase();
+  const targetBase = (target.split("/").pop() ?? target).toLowerCase();
+  for (const path2 of notes2.keys()) {
+    const pathNoExt = path2.replace(/\.md$/i, "");
+    if (pathNoExt.toLowerCase() === targetLower) return path2;
+    const pathBase = (pathNoExt.split("/").pop() ?? pathNoExt).toLowerCase();
+    if (pathBase === targetBase) return path2;
+  }
+  return void 0;
+}
+
+// src/tools/search.ts
+import { z as z2 } from "zod";
+var SearchInput = z2.object({
+  query: z2.string().min(1).describe("Search query. Supports fuzzy matching and prefix search."),
+  limit: z2.number().int().min(1).max(50).default(10).describe("Maximum number of results to return."),
+  folder: z2.string().optional().describe("Restrict results to notes under this vault-relative folder prefix."),
+  tag: z2.string().optional().describe("Restrict results to notes containing this tag."),
+  excerptLength: z2.number().int().min(20).max(2e3).optional().describe(
+    "Max characters of match context per hit (default 120). Lower trims payload; higher gives more context."
+  )
+});
+function basenameNoExt(path2) {
+  const base = path2.slice(path2.lastIndexOf("/") + 1);
+  const dot = base.lastIndexOf(".");
+  return dot > 0 ? base.slice(0, dot) : base;
+}
+function search(ctx2, input) {
+  const results = ctx2.index.search(input.query, {
+    boost: { title: 3, tags: 2, body: 1 },
+    fuzzy: 0.2,
+    prefix: true
+  });
+  const terms = input.query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
+  const hits = [];
+  for (const r of results) {
+    if (input.folder && !r.id.startsWith(input.folder)) continue;
+    if (input.tag) {
+      const note2 = ctx2.notes.get(r.id);
+      if (!note2) continue;
+      const noteTags2 = note2.tags.split(" ");
+      if (!noteTags2.some((t) => t === input.tag || t === input.tag?.replace(/^#/, ""))) continue;
+    }
+    const note = ctx2.notes.get(r.id);
+    const body = note?.body ?? "";
+    const noteTags = note?.tags ? note.tags.split(" ").filter(Boolean) : [];
+    const title = r.title;
+    const hit = {
+      path: r.id,
+      // Round the raw MiniSearch score: 2 decimals preserve relevance gaps without 17-digit float tax.
+      score: Math.round(r.score * 100) / 100,
+      excerpt: extractExcerpt(body, terms, input.excerptLength ?? 120)
+    };
+    if (title && title !== basenameNoExt(r.id)) hit.title = title;
+    if (noteTags.length > 0) hit.tags = noteTags;
+    hits.push(hit);
+    if (hits.length >= input.limit) break;
+  }
+  return hits;
+}
+
+// src/tools/context_pack.ts
+var ContextPackInput = z3.object({
+  query: z3.string().min(1).describe("Natural-language question or topic to assemble context for."),
+  budgetBytes: z3.number().int().min(256).max(16384).default(2048).describe("Hard cap on the response JSON size in bytes. The pack never exceeds it.")
+});
+var MAX_CANDIDATES = 10;
+var NEIGHBOR_HITS = 3;
+var MAX_NEIGHBORS = 5;
+var NEIGHBOR_SUMMARY_LEN = 100;
+var MIN_EXCERPT_LEN = 60;
+var FM_MAX_BYTES = 120;
+var SOURCES_MAX = 8;
+function entryCost(entry) {
+  return Buffer.byteLength(JSON.stringify(entry), "utf8") + 1;
+}
+function pickFm(fm) {
+  if (!fm) return void 0;
+  const out = {};
+  let picked = 0;
+  for (const key of Object.keys(fm)) {
+    const v = fm[key];
+    const t = typeof v;
+    if (t !== "string" && t !== "number" && t !== "boolean") continue;
+    const candidate = { ...out, [key]: v };
+    if (Buffer.byteLength(JSON.stringify(candidate), "utf8") > FM_MAX_BYTES) break;
+    out[key] = v;
+    picked += 1;
+  }
+  return picked > 0 ? out : void 0;
+}
+function clamp(n, lo, hi) {
+  return Math.min(hi, Math.max(lo, n));
+}
+function contextPack(ctx2, input) {
+  const results = ctx2.index.search(input.query, {
+    boost: { title: 3, tags: 2, body: 1 },
+    fuzzy: 0.2,
+    prefix: true
+  });
+  const totalMatches = results.length;
+  if (totalMatches === 0) {
+    return { excerpts: [], neighborhood: [], sources: [], totalMatches: 0, confidence: "none" };
+  }
+  const terms = input.query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
+  const scoreByPath = /* @__PURE__ */ new Map();
+  for (const r of results) scoreByPath.set(r.id, r.score);
+  const budget = input.budgetBytes;
+  let used = Buffer.byteLength(
+    JSON.stringify({
+      excerpts: [],
+      neighborhood: [],
+      sources: [],
+      totalMatches,
+      confidence: "high",
+      truncated: true
+    }),
+    "utf8"
+  );
+  const excerptLen = clamp(Math.floor(budget / 10), 80, 400);
+  const reserve = Math.min(Math.floor(budget / 4), 600);
+  const candidates = results.slice(0, MAX_CANDIDATES);
+  const excerpts = [];
+  const overflowHits = [];
+  let droppedForBudget = false;
+  const buildEntry = (r, len) => {
+    const note = ctx2.notes.get(r.id);
+    const body = note?.body ?? "";
+    const noteTags = note?.tags ? note.tags.split(" ").filter(Boolean) : [];
+    const entry = {
+      path: r.id,
+      score: Math.round(r.score * 100) / 100,
+      excerpt: extractExcerpt(body, terms, len)
+    };
+    const title = r.title;
+    if (title && title !== basenameNoExt(r.id)) entry.title = title;
+    if (noteTags.length > 0) entry.tags = noteTags;
+    const fm = pickFm(note?.fm ?? null);
+    if (fm) entry.fm = fm;
+    return entry;
+  };
+  const excerptCap = budget - reserve;
+  let phaseOpen = true;
+  for (const r of candidates) {
+    if (!phaseOpen) {
+      overflowHits.push({ path: r.id });
+      continue;
+    }
+    let placed = false;
+    const shrinkLens = [
+      .../* @__PURE__ */ new Set([
+        excerptLen,
+        Math.max(Math.floor(excerptLen / 2), MIN_EXCERPT_LEN),
+        MIN_EXCERPT_LEN
+      ])
+    ];
+    for (const len of shrinkLens) {
+      const entry = buildEntry(r, len);
+      const cost = entryCost(entry);
+      if (used + cost <= excerptCap) {
+        excerpts.push(entry);
+        used += cost;
+        placed = true;
+        if (len !== excerptLen) phaseOpen = false;
+        break;
+      }
+    }
+    if (!placed) {
+      phaseOpen = false;
+      droppedForBudget = true;
+      overflowHits.push({ path: r.id });
+    }
+  }
+  const includedPaths = new Set(excerpts.map((e) => e.path));
+  const seeds = excerpts.slice(0, NEIGHBOR_HITS).map((e) => e.path);
+  const agg = /* @__PURE__ */ new Map();
+  const connect = (neighborPath, seed, rel, line) => {
+    if (neighborPath === seed || includedPaths.has(neighborPath)) return;
+    if (!ctx2.notes.has(neighborPath)) return;
+    let entry = agg.get(neighborPath);
+    if (!entry) {
+      entry = { rels: /* @__PURE__ */ new Set(), seedPaths: /* @__PURE__ */ new Set() };
+      agg.set(neighborPath, entry);
+    }
+    entry.rels.add(rel);
+    entry.seedPaths.add(seed);
+    if (rel === "backlink" && entry.line === void 0 && line !== void 0) entry.line = line;
+  };
+  for (const seed of seeds) {
+    for (const ref of ctx2.backlinks.get(seed) ?? []) {
+      connect(ref.path, seed, "backlink", ref.line);
+    }
+    const note = ctx2.notes.get(seed);
+    if (!note) continue;
+    for (const link of extractLinksWithLines(note.raw)) {
+      const target = resolveLink(link.target, ctx2.notes);
+      if (target !== void 0) connect(target, seed, "outlink");
+    }
+  }
+  const ranked = [...agg.entries()].sort((a, b) => {
+    const conn = b[1].seedPaths.size - a[1].seedPaths.size;
+    if (conn !== 0) return conn;
+    const score = (scoreByPath.get(b[0]) ?? 0) - (scoreByPath.get(a[0]) ?? 0);
+    if (score !== 0) return score;
+    return a[0] < b[0] ? -1 : 1;
+  });
+  const neighborhood = [];
+  const overflowNeighbors = [];
+  for (const [path2, info] of ranked) {
+    if (neighborhood.length >= MAX_NEIGHBORS) {
+      overflowNeighbors.push(info.line !== void 0 ? { path: path2, line: info.line } : { path: path2 });
+      continue;
+    }
+    const note = ctx2.notes.get(path2);
+    const entry = {
+      path: path2,
+      rel: info.rels.size === 2 ? "both" : info.rels.has("backlink") ? "backlink" : "outlink",
+      summary: extractExcerpt(note?.body ?? "", terms, NEIGHBOR_SUMMARY_LEN)
+    };
+    if (info.line !== void 0) entry.line = info.line;
+    const cost = entryCost(entry);
+    if (used + cost > budget) {
+      droppedForBudget = true;
+      overflowNeighbors.push(info.line !== void 0 ? { path: path2, line: info.line } : { path: path2 });
+      for (const [p, i] of ranked.slice(ranked.findIndex(([rp]) => rp === path2) + 1)) {
+        overflowNeighbors.push(i.line !== void 0 ? { path: p, line: i.line } : { path: p });
+      }
+      break;
+    }
+    neighborhood.push(entry);
+    used += cost;
+  }
+  const sources = [];
+  const sourcePaths = /* @__PURE__ */ new Set();
+  for (const ref of [...overflowHits, ...overflowNeighbors]) {
+    if (sources.length >= SOURCES_MAX) break;
+    if (includedPaths.has(ref.path) || sourcePaths.has(ref.path)) continue;
+    const cost = entryCost(ref);
+    if (used + cost > budget) break;
+    sources.push(ref);
+    sourcePaths.add(ref.path);
+    used += cost;
+  }
+  const hasTermInExcerpt = excerpts.some(
+    (e) => terms.some((t) => e.excerpt.toLowerCase().includes(t))
+  );
+  const confidence = excerpts.length === 0 || terms.length > 0 && !hasTermInExcerpt ? "low" : "high";
+  const result = { excerpts, neighborhood, sources, totalMatches, confidence };
+  if (droppedForBudget) result.truncated = true;
+  return result;
+}
+
+// src/tools/create_note.ts
+import { access, mkdir, readFile as readFile2 } from "fs/promises";
+import { dirname, join as join2 } from "path";
+import { stringify as stringifyYaml } from "yaml";
+import { z as z4 } from "zod";
+
 // src/index/doc.ts
+import { basename, extname } from "path";
 function buildDoc(relPath, raw) {
   const fm = parseFrontmatter(raw);
   const allTags = [.../* @__PURE__ */ new Set([...extractInlineTags(fm.body), ...frontmatterTags(fm.data)])];
@@ -312,16 +594,16 @@ function upsertDoc(ctx2, doc) {
 }
 
 // src/tools/create_note.ts
-var CreateNoteInput = z2.object({
-  path: z2.string().describe(
+var CreateNoteInput = z4.object({
+  path: z4.string().describe(
     'Vault-relative path for the new note, e.g. "Daily Notes/2026-06-01.md". Parent directories are created automatically.'
   ),
-  content: z2.string().default("").describe("Body content for the note."),
-  frontmatter: z2.record(z2.string(), z2.unknown()).optional().describe("Frontmatter key-value pairs to write as a YAML block at the top of the note."),
-  overwrite: z2.boolean().default(false).describe(
+  content: z4.string().default("").describe("Body content for the note."),
+  frontmatter: z4.record(z4.string(), z4.unknown()).optional().describe("Frontmatter key-value pairs to write as a YAML block at the top of the note."),
+  overwrite: z4.boolean().default(false).describe(
     "Overwrite an existing note. Defaults to false \u2014 throws if the note already exists."
   ),
-  prevHash: z2.string().optional().describe(
+  prevHash: z4.string().optional().describe(
     "Optional compare-and-swap guard for overwrite: true \u2014 the contentHash of the note being replaced. Fails with hash_conflict if it changed since it was read."
   )
 }).refine((v) => v.prevHash === void 0 || v.overwrite === true, {
@@ -378,23 +660,7 @@ ${stringifyYaml(input.frontmatter)}---
 // src/tools/delete_note.ts
 import { access as access2, mkdir as mkdir2, rename as rename2, rm } from "fs/promises";
 import { basename as basename2, extname as extname2, join as join3 } from "path";
-import { z as z3 } from "zod";
-
-// src/index/resolve.ts
-function resolveLink(target, notes2) {
-  if (notes2.has(target)) return target;
-  const withMd = `${target}.md`;
-  if (notes2.has(withMd)) return withMd;
-  const targetLower = target.toLowerCase();
-  const targetBase = (target.split("/").pop() ?? target).toLowerCase();
-  for (const path2 of notes2.keys()) {
-    const pathNoExt = path2.replace(/\.md$/i, "");
-    if (pathNoExt.toLowerCase() === targetLower) return path2;
-    const pathBase = (pathNoExt.split("/").pop() ?? pathNoExt).toLowerCase();
-    if (pathBase === targetBase) return path2;
-  }
-  return void 0;
-}
+import { z as z5 } from "zod";
 
 // src/index/backlinks.ts
 function removeNoteBacklinks(ctx2, relPath) {
@@ -429,9 +695,9 @@ function addNoteBacklinks(ctx2, relPath, raw) {
 }
 
 // src/tools/delete_note.ts
-var DeleteNoteInput = z3.object({
-  path: z3.string().describe("Vault-relative path of the note to delete."),
-  permanent: z3.boolean().default(false).describe(
+var DeleteNoteInput = z5.object({
+  path: z5.string().describe("Vault-relative path of the note to delete."),
+  permanent: z5.boolean().default(false).describe(
     "Permanently remove the note instead of moving it to the vault .trash/ folder. Defaults to false \u2014 deletes are recoverable."
   )
 });
@@ -476,11 +742,11 @@ async function deleteNote(ctx2, rawInput) {
 
 // src/tools/get_backlinks.ts
 import { join as join4 } from "path";
-import { z as z4 } from "zod";
-var GetBacklinksInput = z4.object({
-  path: z4.string().describe("Vault-relative path to the target note."),
-  includeContext: z4.boolean().optional().describe("Include a short excerpt (~200 chars) from the linking line. Default true."),
-  limit: z4.number().int().min(1).max(500).optional().describe("Max backlinks to return. Default 50.")
+import { z as z6 } from "zod";
+var GetBacklinksInput = z6.object({
+  path: z6.string().describe("Vault-relative path to the target note."),
+  includeContext: z6.boolean().optional().describe("Include a short excerpt (~200 chars) from the linking line. Default true."),
+  limit: z6.number().int().min(1).max(500).optional().describe("Max backlinks to return. Default 50.")
 });
 var EXCERPT_MAX = 200;
 function getBacklinks(ctx2, input) {
@@ -513,9 +779,9 @@ function getBacklinks(ctx2, input) {
 
 // src/tools/get_links.ts
 import { join as join5 } from "path";
-import { z as z5 } from "zod";
-var GetLinksInput = z5.object({
-  path: z5.string().describe("Vault-relative path to the note.")
+import { z as z7 } from "zod";
+var GetLinksInput = z7.object({
+  path: z7.string().describe("Vault-relative path to the note.")
 });
 function getLinks(ctx2, input) {
   const absPath = join5(ctx2.vaultRoot, input.path);
@@ -545,13 +811,13 @@ function getLinks(ctx2, input) {
 }
 
 // src/tools/list_notes.ts
-import { z as z6 } from "zod";
-var ListNotesInput = z6.object({
-  folder: z6.string().optional().describe(
+import { z as z8 } from "zod";
+var ListNotesInput = z8.object({
+  folder: z8.string().optional().describe(
     'Vault-relative folder prefix to list. Omit for all notes. Example: "Daily Notes/2026".'
   ),
-  tag: z6.string().optional().describe("Filter by tag. Include or omit the leading #."),
-  limit: z6.number().int().min(1).max(500).default(100).describe("Maximum number of results.")
+  tag: z8.string().optional().describe("Filter by tag. Include or omit the leading #."),
+  limit: z8.number().int().min(1).max(500).default(100).describe("Maximum number of results.")
 });
 function listNotes(ctx2, input) {
   const tag = input.tag?.replace(/^#/, "");
@@ -574,11 +840,11 @@ function listNotes(ctx2, input) {
 }
 
 // src/tools/list_tags.ts
-import { z as z7 } from "zod";
-var ListTagsInput = z7.object({
-  pattern: z7.string().optional().describe('Substring filter on tag name. Example: "work" matches "work" and "area/work".'),
-  minCount: z7.number().int().min(1).optional().describe("Only return tags used in at least this many notes."),
-  sort: z7.enum(["count", "name"]).default("count").describe("Sort by usage count descending (default) or alphabetically.")
+import { z as z9 } from "zod";
+var ListTagsInput = z9.object({
+  pattern: z9.string().optional().describe('Substring filter on tag name. Example: "work" matches "work" and "area/work".'),
+  minCount: z9.number().int().min(1).optional().describe("Only return tags used in at least this many notes."),
+  sort: z9.enum(["count", "name"]).default("count").describe("Sort by usage count descending (default) or alphabetically.")
 });
 function listTags(ctx2, input) {
   const counts = /* @__PURE__ */ new Map();
@@ -607,7 +873,7 @@ function listTags(ctx2, input) {
 // src/tools/move_note.ts
 import { access as access3, mkdir as mkdir3, rename as rename3 } from "fs/promises";
 import { dirname as dirname2, join as join6 } from "path";
-import { z as z8 } from "zod";
+import { z as z10 } from "zod";
 
 // src/tools/rewrite_links.ts
 import { posix } from "path";
@@ -700,11 +966,11 @@ function hasMarkdownLinkTo(raw, sourcePath, targetPath) {
 }
 
 // src/tools/move_note.ts
-var MoveNoteInput = z8.object({
-  from: z8.string().describe("Vault-relative path of the note to move."),
-  to: z8.string().describe("Vault-relative destination path."),
-  overwrite: z8.boolean().default(false).describe("Overwrite the destination if it exists. Defaults to false."),
-  rewriteLinks: z8.boolean().default(true).describe(
+var MoveNoteInput = z10.object({
+  from: z10.string().describe("Vault-relative path of the note to move."),
+  to: z10.string().describe("Vault-relative destination path."),
+  overwrite: z10.boolean().default(false).describe("Overwrite the destination if it exists. Defaults to false."),
+  rewriteLinks: z10.boolean().default(true).describe(
     "Rewrite wikilinks and markdown links in other notes that point at the moved note, so nothing breaks. Defaults to true; pass false to move the file only."
   )
 });
@@ -838,11 +1104,11 @@ function buildOutline(raw, options = {}) {
 }
 
 // src/tools/outline_note.ts
-import { z as z9 } from "zod";
-var OutlineNoteInput = z9.object({
-  path: z9.string().describe("Vault-relative path to the note."),
-  includeBlocks: z9.boolean().default(true).describe("Include block-reference anchors (^id). Default true."),
-  includeSizes: z9.boolean().default(false).describe("Include per-section character length in each heading entry. Default false.")
+import { z as z11 } from "zod";
+var OutlineNoteInput = z11.object({
+  path: z11.string().describe("Vault-relative path to the note."),
+  includeBlocks: z11.boolean().default(true).describe("Include block-reference anchors (^id). Default true."),
+  includeSizes: z11.boolean().default(false).describe("Include per-section character length in each heading entry. Default false.")
 });
 async function outlineNote(ctx2, input) {
   const absPath = join7(ctx2.vaultRoot, input.path);
@@ -860,13 +1126,13 @@ async function outlineNote(ctx2, input) {
 import { readFile as readFile4 } from "fs/promises";
 import { join as join8 } from "path";
 import { parseDocument } from "yaml";
-import { z as z10 } from "zod";
-var PatchFrontmatterInput = z10.object({
-  path: z10.string().describe("Vault-relative path to the note."),
-  patch: z10.record(z10.string(), z10.unknown()).describe(
+import { z as z12 } from "zod";
+var PatchFrontmatterInput = z12.object({
+  path: z12.string().describe("Vault-relative path to the note."),
+  patch: z12.record(z12.string(), z12.unknown()).describe(
     "Key-value pairs to set in the frontmatter. Existing keys not in the patch are unchanged. Pass null as a value to remove a key."
   ),
-  prevHash: z10.string().optional().describe(
+  prevHash: z12.string().optional().describe(
     "Optional compare-and-swap guard: the contentHash from a prior read. Fails with hash_conflict if the note changed since."
   )
 });
@@ -938,21 +1204,21 @@ ${original}`;
 // src/tools/patch_note.ts
 import { readFile as readFile5 } from "fs/promises";
 import { join as join9 } from "path";
-import { z as z11 } from "zod";
-var PatchNoteInput = z11.object({
-  path: z11.string().describe("Vault-relative path to the note."),
-  target: z11.union([
-    z11.object({ heading: z11.string().describe("Heading text (without # markers).") }),
-    z11.object({ block: z11.string().describe("Block reference ID (without the ^ prefix).") })
+import { z as z13 } from "zod";
+var PatchNoteInput = z13.object({
+  path: z13.string().describe("Vault-relative path to the note."),
+  target: z13.union([
+    z13.object({ heading: z13.string().describe("Heading text (without # markers).") }),
+    z13.object({ block: z13.string().describe("Block reference ID (without the ^ prefix).") })
   ]).describe("Target section. Provide exactly one of heading or block."),
-  operation: z11.enum(["append", "prepend", "replace"]).describe(
+  operation: z13.enum(["append", "prepend", "replace"]).describe(
     "append: insert after section content. prepend: insert after heading line. replace: swap section content."
   ),
-  content: z11.string().min(1).describe("Content to insert or replace with."),
-  createIfMissing: z11.boolean().default(false).describe(
+  content: z13.string().min(1).describe("Content to insert or replace with."),
+  createIfMissing: z13.boolean().default(false).describe(
     "If the heading target is not found, append a new heading (level 2) + content. Only valid for heading targets."
   ),
-  prevHash: z11.string().optional().describe(
+  prevHash: z13.string().optional().describe(
     "Optional compare-and-swap guard: the contentHash from a prior read. Fails with hash_conflict if the note changed since."
   )
 });
@@ -1088,8 +1354,8 @@ function updateCache(ctx2, path2, newContent, bodyStart) {
 // src/tools/periodic_note.ts
 import { access as access4, mkdir as mkdir4, readFile as readFile6 } from "fs/promises";
 import { dirname as dirname3, join as join10 } from "path";
-import { z as z12 } from "zod";
-var PERIOD = z12.enum(["daily", "weekly", "monthly", "quarterly", "yearly"]);
+import { z as z14 } from "zod";
+var PERIOD = z14.enum(["daily", "weekly", "monthly", "quarterly", "yearly"]);
 var DEFAULTS = {
   daily: { folder: "", format: "YYYY-MM-DD", template: "" },
   weekly: { folder: "", format: "gggg-[W]ww", template: "" },
@@ -1154,12 +1420,12 @@ function resolveNotePath(cfg, date) {
   const filename = `${formatMomentDate(date, cfg.format)}.md`;
   return cfg.folder ? `${cfg.folder}/${filename}` : filename;
 }
-var GetPeriodicNoteInput = z12.object({
+var GetPeriodicNoteInput = z14.object({
   period: PERIOD.default("daily").describe(
     "Period type: daily (default), weekly, monthly, quarterly, or yearly."
   ),
-  date: z12.string().optional().describe("ISO date string (YYYY-MM-DD). Defaults to today when omitted."),
-  createIfMissing: z12.boolean().default(false).describe(
+  date: z14.string().optional().describe("ISO date string (YYYY-MM-DD). Defaults to today when omitted."),
+  createIfMissing: z14.boolean().default(false).describe(
     "Create the note from the configured template if it does not exist. Default false \u2014 reports missing without creating."
   )
 });
@@ -1197,12 +1463,12 @@ async function getPeriodicNote(ctx2, rawInput) {
   upsertDoc(ctx2, buildDoc(path2, body));
   return { path: path2, existed: false, created: true, contentHash: contentHash(body) };
 }
-var AppendPeriodicNoteInput = z12.object({
+var AppendPeriodicNoteInput = z14.object({
   period: PERIOD.default("daily").describe("Period type. Default: daily."),
-  date: z12.string().optional().describe("ISO date string (YYYY-MM-DD). Defaults to today."),
-  content: z12.string().min(1).describe("Text to append to the note body. Separated from existing content by a blank line."),
-  createIfMissing: z12.boolean().default(true).describe("Create the note if it does not exist before appending. Default true."),
-  prevHash: z12.string().optional().describe(
+  date: z14.string().optional().describe("ISO date string (YYYY-MM-DD). Defaults to today."),
+  content: z14.string().min(1).describe("Text to append to the note body. Separated from existing content by a blank line."),
+  createIfMissing: z14.boolean().default(true).describe("Create the note if it does not exist before appending. Default true."),
+  prevHash: z14.string().optional().describe(
     "Optional compare-and-swap guard: the contentHash from a prior read of the resolved periodic note. Fails with hash_conflict if it changed since."
   )
 });
@@ -1262,114 +1528,36 @@ async function appendPeriodicNote(ctx2, rawInput) {
 }
 
 // src/tools/query_notes.ts
-import { z as z14 } from "zod";
-
-// src/tools/search.ts
-import { z as z13 } from "zod";
-
-// src/index/excerpt.ts
-function extractExcerpt(text, terms, maxLen = 200) {
-  const lower = text.toLowerCase();
-  let bestIdx = -1;
-  for (const term of terms) {
-    const idx = lower.indexOf(term.toLowerCase());
-    if (idx !== -1 && (bestIdx === -1 || idx < bestIdx)) {
-      bestIdx = idx;
-    }
-  }
-  if (bestIdx === -1) {
-    return truncate(text.trimStart(), maxLen);
-  }
-  const half = Math.floor(maxLen / 2);
-  const start = Math.max(0, bestIdx - half);
-  const end = Math.min(text.length, bestIdx + half + (terms[0]?.length ?? 0));
-  const slice = text.slice(start, end).trim();
-  return `${start > 0 ? "\u2026" : ""}${slice}${end < text.length ? "\u2026" : ""}`;
-}
-function truncate(s, max) {
-  if (s.length <= max) return s;
-  return `${s.slice(0, max).trimEnd()}\u2026`;
-}
-
-// src/tools/search.ts
-var SearchInput = z13.object({
-  query: z13.string().min(1).describe("Search query. Supports fuzzy matching and prefix search."),
-  limit: z13.number().int().min(1).max(50).default(10).describe("Maximum number of results to return."),
-  folder: z13.string().optional().describe("Restrict results to notes under this vault-relative folder prefix."),
-  tag: z13.string().optional().describe("Restrict results to notes containing this tag."),
-  excerptLength: z13.number().int().min(20).max(2e3).optional().describe(
-    "Max characters of match context per hit (default 120). Lower trims payload; higher gives more context."
-  )
-});
-function basenameNoExt(path2) {
-  const base = path2.slice(path2.lastIndexOf("/") + 1);
-  const dot = base.lastIndexOf(".");
-  return dot > 0 ? base.slice(0, dot) : base;
-}
-function search(ctx2, input) {
-  const results = ctx2.index.search(input.query, {
-    boost: { title: 3, tags: 2, body: 1 },
-    fuzzy: 0.2,
-    prefix: true
-  });
-  const terms = input.query.toLowerCase().split(/\s+/).filter((t) => t.length > 1);
-  const hits = [];
-  for (const r of results) {
-    if (input.folder && !r.id.startsWith(input.folder)) continue;
-    if (input.tag) {
-      const note2 = ctx2.notes.get(r.id);
-      if (!note2) continue;
-      const noteTags2 = note2.tags.split(" ");
-      if (!noteTags2.some((t) => t === input.tag || t === input.tag?.replace(/^#/, ""))) continue;
-    }
-    const note = ctx2.notes.get(r.id);
-    const body = note?.body ?? "";
-    const noteTags = note?.tags ? note.tags.split(" ").filter(Boolean) : [];
-    const title = r.title;
-    const hit = {
-      path: r.id,
-      // Round the raw MiniSearch score: 2 decimals preserve relevance gaps without 17-digit float tax.
-      score: Math.round(r.score * 100) / 100,
-      excerpt: extractExcerpt(body, terms, input.excerptLength ?? 120)
-    };
-    if (title && title !== basenameNoExt(r.id)) hit.title = title;
-    if (noteTags.length > 0) hit.tags = noteTags;
-    hits.push(hit);
-    if (hits.length >= input.limit) break;
-  }
-  return hits;
-}
-
-// src/tools/query_notes.ts
+import { z as z15 } from "zod";
 var OPS_WITHOUT_VALUE = /* @__PURE__ */ new Set(["exists", "missing"]);
-var Predicate = z14.object({
-  key: z14.string().min(1).describe("Frontmatter key to test (top-level)."),
-  op: z14.enum(["eq", "ne", "contains", "exists", "missing", "gt", "gte", "lt", "lte"]).describe(
+var Predicate = z15.object({
+  key: z15.string().min(1).describe("Frontmatter key to test (top-level)."),
+  op: z15.enum(["eq", "ne", "contains", "exists", "missing", "gt", "gte", "lt", "lte"]).describe(
     "eq/ne compare scalars; contains matches array membership or substring; exists/missing test key presence; gt/gte/lt/lte compare numbers or strings (ISO dates sort correctly)."
   ),
-  value: z14.union([z14.string(), z14.number(), z14.boolean()]).optional().describe("Comparison value. Required for every op except exists/missing.")
+  value: z15.union([z15.string(), z15.number(), z15.boolean()]).optional().describe("Comparison value. Required for every op except exists/missing.")
 }).refine((p) => OPS_WITHOUT_VALUE.has(p.op) || p.value !== void 0, {
   message: "value is required for this op"
 });
-var ISO_DATE = z14.string().refine((s) => !Number.isNaN(Date.parse(s)), { message: "not a parseable date" });
-var QueryNotesInput = z14.object({
-  where: z14.array(Predicate).max(20).default([]).describe("Frontmatter predicates. All must match (AND)."),
-  folder: z14.string().optional().describe("Restrict to notes under this vault-relative folder prefix."),
-  tag: z14.string().optional().describe("Restrict to notes with this tag (# prefix optional)."),
+var ISO_DATE = z15.string().refine((s) => !Number.isNaN(Date.parse(s)), { message: "not a parseable date" });
+var QueryNotesInput = z15.object({
+  where: z15.array(Predicate).max(20).default([]).describe("Frontmatter predicates. All must match (AND)."),
+  folder: z15.string().optional().describe("Restrict to notes under this vault-relative folder prefix."),
+  tag: z15.string().optional().describe("Restrict to notes with this tag (# prefix optional)."),
   modifiedAfter: ISO_DATE.optional().describe(
     "Only notes modified at or after this ISO 8601 date/time."
   ),
   modifiedBefore: ISO_DATE.optional().describe(
     "Only notes modified before this ISO 8601 date/time."
   ),
-  minSizeBytes: z14.number().int().min(0).optional().describe("Only notes at least this many bytes."),
-  maxSizeBytes: z14.number().int().min(0).optional().describe("Only notes at most this many bytes."),
-  select: z14.array(z14.string()).max(20).default([]).describe(
+  minSizeBytes: z15.number().int().min(0).optional().describe("Only notes at least this many bytes."),
+  maxSizeBytes: z15.number().int().min(0).optional().describe("Only notes at most this many bytes."),
+  select: z15.array(z15.string()).max(20).default([]).describe(
     'Extra fields to return per hit: frontmatter keys, or the specials "mtime", "size", "tags". Default returns only path + title, keeping the payload minimal.'
   ),
-  sort: z14.enum(["path", "title", "mtime", "size"]).default("path").describe("Sort field."),
-  order: z14.enum(["asc", "desc"]).default("asc").describe("Sort order."),
-  limit: z14.number().int().min(1).max(500).default(100).describe("Maximum number of results.")
+  sort: z15.enum(["path", "title", "mtime", "size"]).default("path").describe("Sort field."),
+  order: z15.enum(["asc", "desc"]).default("asc").describe("Sort order."),
+  limit: z15.number().int().min(1).max(500).default(100).describe("Maximum number of results.")
 });
 function scalarEq(a, b) {
   if (a === b) return true;
@@ -1469,16 +1657,16 @@ function queryNotes(ctx2, input) {
 // src/tools/read_note.ts
 import { readFile as readFile7 } from "fs/promises";
 import { join as join11 } from "path";
-import { z as z15 } from "zod";
-var ReadNoteInput = z15.object({
-  path: z15.string().describe('Vault-relative path to the note, e.g. "Daily Notes/2026-05-29.md".'),
-  section: z15.string().optional().describe("Return only this heading section (heading text, # prefix optional)."),
-  block: z15.string().optional().describe("Return only the block anchored by this id (^ prefix optional)."),
-  lines: z15.object({
-    from: z15.number().int().min(1).describe("First line (1-indexed, inclusive)."),
-    to: z15.number().int().min(1).optional().describe("Last line (1-indexed, inclusive). Defaults to end of file.")
+import { z as z16 } from "zod";
+var ReadNoteInput = z16.object({
+  path: z16.string().describe('Vault-relative path to the note, e.g. "Daily Notes/2026-05-29.md".'),
+  section: z16.string().optional().describe("Return only this heading section (heading text, # prefix optional)."),
+  block: z16.string().optional().describe("Return only the block anchored by this id (^ prefix optional)."),
+  lines: z16.object({
+    from: z16.number().int().min(1).describe("First line (1-indexed, inclusive)."),
+    to: z16.number().int().min(1).optional().describe("Last line (1-indexed, inclusive). Defaults to end of file.")
   }).optional().describe("Return only this line range (1-indexed, inclusive)."),
-  includeFrontmatter: z15.boolean().optional().describe(
+  includeFrontmatter: z16.boolean().optional().describe(
     "Include frontmatter in span results. Default false for section/block spans. No effect on lines or whole-note reads."
   )
 }).refine((v) => [v.section, v.block, v.lines].filter((x) => x !== void 0).length <= 1, {
@@ -1579,17 +1767,17 @@ async function readNote(ctx2, input) {
 // src/tools/replace_in_note.ts
 import { readFile as readFile8 } from "fs/promises";
 import { join as join12 } from "path";
-import { z as z16 } from "zod";
-var ReplaceInNoteInput = z16.object({
-  path: z16.string().describe("Vault-relative path to the note."),
-  find: z16.string().min(1).max(1e3).describe("Text or pattern to find (max 1000 chars; bounds regex-mode pattern size)."),
-  replace: z16.string().describe("Replacement text. Supports $1, $2, \u2026 backreferences in regex mode."),
-  regex: z16.boolean().default(false).describe("Treat find as a regular expression."),
-  caseSensitive: z16.boolean().default(false).describe("Case-sensitive matching."),
-  wholeWord: z16.boolean().default(false).describe("Match whole words only (\\b word-boundary)."),
-  limit: z16.number().int().min(1).optional().describe("Maximum number of replacements. Omit to replace all."),
-  dryRun: z16.boolean().default(false).describe("If true, report matches without writing anything."),
-  prevHash: z16.string().optional().describe(
+import { z as z17 } from "zod";
+var ReplaceInNoteInput = z17.object({
+  path: z17.string().describe("Vault-relative path to the note."),
+  find: z17.string().min(1).max(1e3).describe("Text or pattern to find (max 1000 chars; bounds regex-mode pattern size)."),
+  replace: z17.string().describe("Replacement text. Supports $1, $2, \u2026 backreferences in regex mode."),
+  regex: z17.boolean().default(false).describe("Treat find as a regular expression."),
+  caseSensitive: z17.boolean().default(false).describe("Case-sensitive matching."),
+  wholeWord: z17.boolean().default(false).describe("Match whole words only (\\b word-boundary)."),
+  limit: z17.number().int().min(1).optional().describe("Maximum number of replacements. Omit to replace all."),
+  dryRun: z17.boolean().default(false).describe("If true, report matches without writing anything."),
+  prevHash: z17.string().optional().describe(
     "Optional compare-and-swap guard: the contentHash from a prior read. Fails with hash_conflict if the note changed since."
   )
 });
@@ -1701,7 +1889,8 @@ var META_KEYS = [
   "period",
   "date",
   "permanent",
-  "prevHash"
+  "prevHash",
+  "budgetBytes"
 ];
 function safeMeta(args) {
   if (typeof args !== "object" || args === null) return {};
@@ -1770,6 +1959,11 @@ async function run(ctx2, name, args) {
       const hits = queryNotes(ctx2, input);
       return { content: [{ type: "text", text: JSON.stringify(hits) }] };
     }
+    case "context_pack": {
+      const input = ContextPackInput.parse(args);
+      const pack = contextPack(ctx2, input);
+      return { content: [{ type: "text", text: JSON.stringify(pack) }] };
+    }
     case "read_note": {
       const input = ReadNoteInput.parse(args);
       const result = await readNote(ctx2, input);
@@ -2489,6 +2683,21 @@ var ALL_TOOLS = [
       required: []
     }
   },
+  {
+    name: "context_pack",
+    description: 'Assemble everything needed to ANSWER a natural-language question in one call, under a strict byte budget (default 2048): ranked excerpts, linked neighbor notes (backlinks/outlinks) with one-line summaries, and follow-up source paths. Use search to locate notes and query_notes for metadata filters; use context_pack when you want answer-ready context without multiple round-trips. Empty excerpts with confidence "none" or "low" means the vault lacks coverage \u2014 do not infer content.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Natural-language question or topic." },
+        budgetBytes: {
+          type: "number",
+          description: "Hard cap on response JSON bytes (256\u201316384, default 2048)."
+        }
+      },
+      required: ["query"]
+    }
+  },
   {
     name: "read_note",
     description: "Read a note or a span of it \u2014 by heading section, block reference, or line range. Returns structured JSON with the content, bytes returned, total note size, and a contentHash to pass as prevHash to edit tools for compare-and-swap. Use search or outline_note first to find the right path and section names.",
@@ -2907,7 +3116,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.11.0" : "0.0.0-dev";
+var VERSION = true ? "0.12.0" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}