seekstone 0.19.0 → 0.20.1

package/README.md

@@ -163,6 +163,7 @@ Every write tool (`append_note`, `patch_note`, `patch_frontmatter`, `replace_in_
 | `SEEKSTONE_MODEL_PATH` | no | Directory holding the Model2Vec embedding model (default: where `fetch-model` puts the selected model). |
 | `SEEKSTONE_CACHE_DIR` | no | Cache root for the model and per-vault embedding caches (default `~/.cache/seekstone`). |
 | `SEEKSTONE_BUNDLED_MODEL_DIR` | no | Set by the `seekstone-semantic.mcpb` bundle's manifest — sharded model files shipped inside the extension, reassembled into the model directory at boot (disk-only, hash-verified). Not usually set by hand. |
+| `SEEKSTONE_INSTRUCTIONS` | no | Path to a file whose contents become the MCP server's `instructions` string (surfaced to clients alongside the tool list). A relative path resolves against the vault root. Read once at boot, trimmed, capped at 16 KB (truncated with a warning past that). Missing, unreadable, or empty after trim means no instructions — never a boot failure. |
 
 ---
 

package/dist/index.js

@@ -192,7 +192,7 @@ var init_fetch_model = __esm({
 
 // src/index.ts
 import { homedir } from "os";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -439,6 +439,8 @@ Optional environment:
   SEEKSTONE_SEMANTIC_MODEL  potion-base-8M (default) | potion-retrieval-32M (bigger, more accurate)
   SEEKSTONE_MODEL_PATH Override the embedding-model directory
   SEEKSTONE_CACHE_DIR  Override the cache root (default ~/.cache/seekstone)
+  SEEKSTONE_INSTRUCTIONS  Path to a file whose contents become the MCP
+                       "instructions" (relative paths resolve against the vault)
 
 Add to Claude Code:
   claude mcp add seekstone --env SEEKSTONE_VAULT=/path/to/vault -- npx -y seekstone
@@ -3790,6 +3792,47 @@ async function runInit(opts, deps) {
   return { ok: true, exitCode: 0, output: out, wrotePath: configPath, backupPath };
 }
 
+// src/instructions.ts
+import { readFileSync } from "fs";
+import { isAbsolute, resolve as resolve2 } from "path";
+var MAX_BYTES = 16 * 1024;
+function truncateUtf8(text, maxBytes) {
+  let bytes = 0;
+  let out = "";
+  for (const ch of text) {
+    const chBytes = Buffer.byteLength(ch, "utf8");
+    if (bytes + chBytes > maxBytes) break;
+    out += ch;
+    bytes += chBytes;
+  }
+  return out;
+}
+function resolveInstructions(env, vaultRoot2, log2) {
+  const raw = (env.SEEKSTONE_INSTRUCTIONS ?? "").trim();
+  if (raw === "") return void 0;
+  const path2 = isAbsolute(raw) ? raw : resolve2(vaultRoot2, raw);
+  let content;
+  try {
+    content = readFileSync(path2, "utf8");
+  } catch (err) {
+    log2.warn("cannot read SEEKSTONE_INSTRUCTIONS file; starting without instructions", {
+      path: path2,
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return void 0;
+  }
+  let trimmed = content.trim();
+  if (trimmed === "") return void 0;
+  const bytes = Buffer.byteLength(trimmed, "utf8");
+  if (bytes > MAX_BYTES) {
+    log2.warn("SEEKSTONE_INSTRUCTIONS file exceeds 16 KB; truncated", { path: path2, bytes });
+    trimmed = truncateUtf8(trimmed, MAX_BYTES).trim();
+    if (trimmed === "") return void 0;
+  }
+  log2.info("instructions attached", { bytes: Buffer.byteLength(trimmed, "utf8") });
+  return trimmed;
+}
+
 // src/process-guards.ts
 function installProcessGuards(log2) {
   const onUnhandledRejection = (reason) => {
@@ -4894,6 +4937,7 @@ var ALL_TOOLS = [
                 description: "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: {
+                type: ["string", "number", "boolean"],
                 description: "Comparison value. Required for every op except exists/missing."
               }
             },
@@ -5200,8 +5244,26 @@ var ALL_TOOLS = [
       properties: {
         path: { type: "string", description: "Vault-relative path to the note." },
         target: {
-          type: "object",
-          description: 'Exactly one of: { heading: "Section Title" } or { block: "block-id" } (without the ^ prefix).'
+          description: 'Exactly one of: { heading: "Section Title" } or { block: "block-id" } (without the ^ prefix).',
+          anyOf: [
+            {
+              type: "object",
+              properties: {
+                heading: { type: "string", description: "Heading text (without # markers)." }
+              },
+              required: ["heading"]
+            },
+            {
+              type: "object",
+              properties: {
+                block: {
+                  type: "string",
+                  description: "Block reference ID (without the ^ prefix)."
+                }
+              },
+              required: ["block"]
+            }
+          ]
         },
         operation: {
           type: "string",
@@ -5468,9 +5530,9 @@ function startWatcher(ctx2, log2, opts) {
     opts?.onRawEvent?.("unlink", abs, relPath);
     if (relPath.endsWith(".md")) remove(relPath);
   });
-  const ready = new Promise((resolve3) => {
+  const ready = new Promise((resolve4) => {
     watcher2.once("ready", () => {
-      resolve3();
+      resolve4();
     });
   });
   return {
@@ -5480,7 +5542,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.19.0" : "0.0.0-dev";
+var VERSION = true ? "0.20.1" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}
@@ -5527,7 +5589,7 @@ if (!rawVaultRoot) {
   log.error("SEEKSTONE_VAULT env var is required");
   process.exit(1);
 }
-var vaultRoot = resolve2(rawVaultRoot);
+var vaultRoot = resolve3(rawVaultRoot);
 var policy = parseWritePolicy(process.env);
 if (policy.readOnly) log.info("read-only mode", { env: "SEEKSTONE_READ_ONLY" });
 if (policy.writeGlobs) log.info("write paths scoped", { globs: policy.writeGlobs });
@@ -5579,7 +5641,11 @@ if (semanticCfg) {
 }
 var watcher = startWatcher(ctx, log);
 process.on("exit", () => void watcher.stop());
-var server = new Server({ name: "seekstone", version: VERSION }, { capabilities: { tools: {} } });
+var instructions = resolveInstructions(process.env, vaultRoot, log);
+var server = new Server(
+  { name: "seekstone", version: VERSION },
+  { capabilities: { tools: {} }, instructions }
+);
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
   tools: visibleTools(ctx.policy)
 }));