seekstone 0.15.2 → 0.16.0

package/README.md

@@ -147,6 +147,7 @@ Every write tool (`append_note`, `patch_note`, `patch_frontmatter`, `replace_in_
 | `SEEKSTONE_LOG_LEVEL` | no | `error` \| `warn` \| `info` (default) \| `debug`. |
 | `SEEKSTONE_LOG_FILE` | no | Absolute path; when set, JSON-line logs are appended here (size-rotated). |
 | `SEEKSTONE_WATCH_POLL` | no | Set to `1` to stat-poll for changes instead of native OS events — reliable on network drives, WSL, containers. |
+| `SEEKSTONE_WATCH_POLL_INTERVAL` | no | Stat-poll interval in ms (default `10000`). Only used with `SEEKSTONE_WATCH_POLL=1`. Lower = faster pickup of external edits, higher CPU. |
 | `SEEKSTONE_LOG_MAX_SIZE` | no | Log-rotation threshold for `SEEKSTONE_LOG_FILE` (e.g. `10mb`; default 5 MB). |
 | `SEEKSTONE_READ_ONLY` | no | Set to `1` to run read-only: the 9 write tools are unregistered entirely (and rejected if called anyway), so the session provably cannot modify your vault. |
 | `SEEKSTONE_WRITE_PATHS` | no | Comma-separated vault-relative globs (e.g. `journal/**,inbox/*.md`). Writes are permitted only under matching paths; the rest of the vault stays read-only. |

package/dist/index.js

@@ -173,6 +173,7 @@ Optional environment:
   SEEKSTONE_LOG_LEVEL  error | warn | info (default) | debug
   SEEKSTONE_LOG_FILE   Absolute path; append JSON-line logs here
   SEEKSTONE_WATCH_POLL Set to 1 to poll for changes (network drives, WSL)
+  SEEKSTONE_WATCH_POLL_INTERVAL  Poll interval in ms (default 10000)
   SEEKSTONE_SEMANTIC   Set to 1 to enable semantic search (needs fetch-model first)
   SEEKSTONE_MODEL_PATH Override the embedding-model directory
   SEEKSTONE_CACHE_DIR  Override the cache root (default ~/.cache/seekstone)
@@ -4190,8 +4191,27 @@ import { realpathSync } from "fs";
 import { readFile as readFile16 } from "fs/promises";
 import { join as join10, relative as relative2, sep as sep3 } from "path";
 import chokidar from "chokidar";
+var DEFAULT_POLL_INTERVAL_MS = 1e4;
+function resolvePollInterval(optValue, envValue, log2) {
+  if (optValue !== void 0) return optValue;
+  if (envValue === void 0 || envValue === "") return DEFAULT_POLL_INTERVAL_MS;
+  const parsed = Number(envValue);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    log2?.warn("invalid SEEKSTONE_WATCH_POLL_INTERVAL, using default", {
+      value: envValue,
+      defaultMs: DEFAULT_POLL_INTERVAL_MS
+    });
+    return DEFAULT_POLL_INTERVAL_MS;
+  }
+  return parsed;
+}
 function startWatcher(ctx2, log2, opts) {
   const usePolling = opts?.usePolling ?? process.env.SEEKSTONE_WATCH_POLL === "1";
+  const pollInterval = resolvePollInterval(
+    opts?.pollInterval,
+    process.env.SEEKSTONE_WATCH_POLL_INTERVAL,
+    log2
+  );
   let vaultRoot2 = ctx2.vaultRoot;
   try {
     vaultRoot2 = realpathSync(ctx2.vaultRoot);
@@ -4227,8 +4247,8 @@ function startWatcher(ctx2, log2, opts) {
     // The startup index build already covers existing files.
     ignoreInitial: true,
     usePolling,
-    interval: 50,
-    binaryInterval: 100,
+    interval: pollInterval,
+    binaryInterval: pollInterval * 2,
     // Skip dot-dirs (.obsidian, .git, .trash, …) regardless of where the vault
     // lives — matched on the path relative to the vault root.
     ignored: (p) => {
@@ -4254,7 +4274,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.15.2" : "0.0.0-dev";
+var VERSION = true ? "0.16.0" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}