threadnote 1.4.1 → 1.4.2

package/dist/mcp_server.cjs

@@ -35715,6 +35715,57 @@ async function sleep(ms) {
     setTimeout(resolvePromise, ms);
   });
 }
+function compareVersions(a, b) {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  for (let index = 0; index < 3; index += 1) {
+    const difference = left.numbers[index] - right.numbers[index];
+    if (difference !== 0) {
+      return difference;
+    }
+  }
+  const rankDelta = suffixRank(left.suffix) - suffixRank(right.suffix);
+  if (rankDelta !== 0) {
+    return rankDelta;
+  }
+  if (left.suffix === right.suffix) {
+    return 0;
+  }
+  return (left.suffix ?? "").localeCompare(right.suffix ?? "");
+}
+function suffixRank(suffix) {
+  if (suffix === void 0) {
+    return 0;
+  }
+  return /^post/i.test(suffix) ? 1 : -1;
+}
+function parseVersion(version2) {
+  const normalized = version2.trim().replace(/^v/, "").split("+", 1)[0];
+  const core = normalized.match(/^\d+(?:\.\d+){0,2}/)?.[0] ?? "";
+  const rawSuffix = normalized.slice(core.length).replace(/^[-_.]/, "");
+  const suffix = core.length > 0 && rawSuffix.length > 0 ? rawSuffix : void 0;
+  const parts = core.split(".");
+  return {
+    numbers: [
+      safeVersionNumber(Number.parseInt(parts[0] ?? "", 10)),
+      safeVersionNumber(Number.parseInt(parts[1] ?? "", 10)),
+      safeVersionNumber(Number.parseInt(parts[2] ?? "", 10))
+    ],
+    suffix
+  };
+}
+function safeVersionNumber(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : 0;
+}
+function formatStaleVersionNotice(runningVersion, diskVersion) {
+  if (runningVersion === void 0 || diskVersion === void 0) {
+    return void 0;
+  }
+  if (compareVersions(diskVersion, runningVersion) <= 0) {
+    return void 0;
+  }
+  return `threadnote ${diskVersion} is installed but this MCP server is still running ${runningVersion}. Reconnect the threadnote MCP server (e.g. /mcp) to load the update.`;
+}
 async function ensureDirectory(path, dryRun) {
   if (dryRun) {
     console.log(`Would create directory: ${path}`);
@@ -36218,6 +36269,20 @@ function shellQuote(value) {
   }
   return `'${value.replaceAll("'", `'"'"'`)}'`;
 }
+function toolRoot() {
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(__dirname, "package.json"))) {
+    return __dirname;
+  }
+  return (0, import_node_path.resolve)(__dirname, "..");
+}
+async function currentPackageVersion() {
+  const rawPackage = await (0, import_promises.readFile)((0, import_node_path.join)(toolRoot(), "package.json"), "utf8");
+  const parsed = JSON.parse(rawPackage);
+  if (!isJsonObject(parsed) || typeof parsed.version !== "string") {
+    throw new Error("Could not read current threadnote package version.");
+  }
+  return parsed.version;
+}
 function errorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -39267,8 +39332,36 @@ function formatPlanSection(title, lines) {
 }
 
 // src/mcp_server.ts
+var mcpStartupVersion;
+var staleNoticeCache;
+var STALE_NOTICE_TTL_MS = 6e4;
+async function staleVersionNotice() {
+  if (mcpStartupVersion === void 0) {
+    return void 0;
+  }
+  const nowMs = Date.now();
+  if (staleNoticeCache && nowMs - staleNoticeCache.checkedAtMs < STALE_NOTICE_TTL_MS) {
+    return staleNoticeCache.notice;
+  }
+  let notice;
+  try {
+    notice = formatStaleVersionNotice(mcpStartupVersion, await currentPackageVersion());
+  } catch {
+    notice = void 0;
+  }
+  staleNoticeCache = { checkedAtMs: nowMs, notice };
+  return notice;
+}
+async function withStaleVersionNotice(result) {
+  const notice = await staleVersionNotice();
+  if (notice === void 0) {
+    return result;
+  }
+  return { ...result, content: [...result.content ?? [], { type: "text", text: `\u26A0 ${notice}` }] };
+}
 async function main() {
   const config2 = getRuntimeConfig();
+  mcpStartupVersion = await currentPackageVersion().catch(() => void 0);
   const server = new McpServer(
     { name: "threadnote-local-adapter", version: "0.2.0" },
     {
@@ -39466,7 +39559,7 @@ function registerTools(server, config2) {
       description: "Check OpenViking server health through the CLI.",
       inputSchema: {}
     },
-    async () => runOpenVikingMcpTool(config2, "health", {})
+    async () => withStaleVersionNotice(await runOpenVikingMcpTool(config2, "health", {}))
   );
   registerOpenVikingParityTools(server, config2);
   server.registerTool(
@@ -39959,14 +40052,16 @@ function registerSearchTool(server, config2, name, description) {
       if (!checkedUri.ok) {
         return checkedUri.error;
       }
-      return runRecallTool(config2, {
-        callerCwd,
-        query: checkedQuery.value,
-        pinnedUri: checkedUri.value,
-        nodeLimit,
-        includeArchived: includeArchived === true,
-        threshold: threshold === void 0 ? void 0 : String(threshold)
-      });
+      return withStaleVersionNotice(
+        await runRecallTool(config2, {
+          callerCwd,
+          query: checkedQuery.value,
+          pinnedUri: checkedUri.value,
+          nodeLimit,
+          includeArchived: includeArchived === true,
+          threshold: threshold === void 0 ? void 0 : String(threshold)
+        })
+      );
     }
   );
 }
@@ -40194,11 +40289,13 @@ function registerStoreTool(server, config2, name, description) {
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         topic: normalizeOptionalMetadata2(topic)
       };
-      return writeDurableMemory(config2, {
-        bodyText: checkedText.value,
-        metadata,
-        replaceUri: checkedReplaceUri.value
-      });
+      return withStaleVersionNotice(
+        await writeDurableMemory(config2, {
+          bodyText: checkedText.value,
+          metadata,
+          replaceUri: checkedReplaceUri.value
+        })
+      );
     }
   );
 }

package/dist/threadnote.cjs

@@ -4583,6 +4583,14 @@ function toolRoot() {
   }
   return (0, import_node_path2.resolve)(__dirname, "..");
 }
+async function currentPackageVersion() {
+  const rawPackage = await (0, import_promises.readFile)((0, import_node_path2.join)(toolRoot(), "package.json"), "utf8");
+  const parsed = JSON.parse(rawPackage);
+  if (!isJsonObject(parsed) || typeof parsed.version !== "string") {
+    throw new Error("Could not read current threadnote package version.");
+  }
+  return parsed.version;
+}
 function errorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -13430,14 +13438,6 @@ async function getUpdateInfo(config, options) {
     registry: options.registry
   };
 }
-async function currentPackageVersion() {
-  const rawPackage = await (0, import_promises10.readFile)((0, import_node_path13.join)(toolRoot(), "package.json"), "utf8");
-  const parsed = JSON.parse(rawPackage);
-  if (!isJsonObject(parsed) || typeof parsed.version !== "string") {
-    throw new Error("Could not read current threadnote package version.");
-  }
-  return parsed.version;
-}
 async function fetchLatestVersion2(registry) {
   const url = new URL(`${NPM_PACKAGE_NAME}/latest`, normalizeRegistry(registry));
   const controller = new AbortController();
@@ -14263,22 +14263,20 @@ async function recallShapeCheck(config) {
   if (result.exitCode !== 0) {
     return { name: "recall shape", status: "warn", detail: "search failed; run threadnote repair" };
   }
-  let parsed;
+  const start = result.stdout.search(/^\{/m);
+  let envelope;
   try {
-    parsed = JSON.parse(result.stdout.trim());
+    const parsed = start >= 0 ? JSON.parse(result.stdout.slice(start)) : void 0;
+    envelope = isJsonObject(parsed) ? parsed.result : void 0;
   } catch {
-    return {
-      name: "recall shape",
-      status: "warn",
-      detail: "search output is not JSON; recall may silently return nothing"
-    };
+    envelope = void 0;
   }
   const buckets = ["memories", "resources", "skills"];
-  if (!isJsonObject(parsed) || !buckets.some((key) => Array.isArray(parsed[key]))) {
+  if (!isJsonObject(envelope) || !buckets.some((key) => Array.isArray(envelope[key]))) {
     return {
       name: "recall shape",
       status: "warn",
-      detail: `search JSON missing ${buckets.join("/")} buckets; recall parsing is out of sync with this OpenViking`
+      detail: `search JSON missing the result.{${buckets.join(",")}} buckets recall parsing depends on`
     };
   }
   return { name: "recall shape", status: "ok", detail: "memories/resources/skills buckets present" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threadnote",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "type": "commonjs",
   "main": "dist/threadnote.cjs",
   "description": "Shared local context and handoffs for development agents",