seekstone 0.19.0 → 0.20.0

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) => {
@@ -5468,9 +5511,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 +5523,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.19.0" : "0.0.0-dev";
+var VERSION = true ? "0.20.0" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}
@@ -5527,7 +5570,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 +5622,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)
 }));