projectionlab-mcp 1.0.1 → 1.2.0

package/dist/updateCheck.js

@@ -0,0 +1,58 @@
+// One request per server process asks the npm registry for the latest
+// published version of this package, so check_connection can tell the user
+// an update is available. The request carries no user data: no query string,
+// no custom headers beyond Accept, nothing from config or the plan.
+// PL_UPDATE_CHECK=false turns the lookup off entirely.
+import { config } from "./config.js";
+import { log } from "./logger.js";
+import { compareVersions } from "./versionCompare.js";
+import { VERSION } from "./version.js";
+const REGISTRY_URL = "https://registry.npmjs.org/projectionlab-mcp/latest";
+const DEFAULT_TIMEOUT_MS = 3000;
+/**
+ * Read the `version` field of the registry's latest-release document.
+ * Any failure (offline, timeout, non-200, bad JSON, missing or unparsable
+ * version) resolves to null; this never rejects.
+ */
+export async function fetchLatestVersion(fetchImpl = fetch, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    try {
+        const response = await fetchImpl(REGISTRY_URL, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        if (typeof body?.version !== "string")
+            return null;
+        // Unparsable versions are as good as unknown.
+        return compareVersions(body.version, "0.0.0") === null ? null : body.version;
+    }
+    catch (err) {
+        log.debug("updateCheck", `update lookup failed: ${err}`);
+        return null;
+    }
+}
+/** A fresh holder; the module-level one is what the server uses. */
+export function createUpdateCheck() {
+    let latest = null;
+    let started = false;
+    return {
+        start(fetchImpl = fetch) {
+            if (started || !config.updateCheck)
+                return;
+            started = true;
+            void fetchLatestVersion(fetchImpl).then((found) => {
+                latest = found;
+                if (found && compareVersions(found, VERSION) === 1) {
+                    log.info("updateCheck", `projectionlab-mcp ${found} is available (running ${VERSION})`);
+                }
+            });
+        },
+        latest() {
+            return latest;
+        },
+    };
+}
+export const updateCheck = createUpdateCheck();
+//# sourceMappingURL=updateCheck.js.map

package/dist/updateCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCheck.js","sourceRoot":"","sources":["../src/updateCheck.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2EAA2E;AAC3E,6EAA6E;AAC7E,oEAAoE;AACpE,uDAAuD;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,YAAY,GAAG,qDAAqD,CAAC;AAC3E,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAUhC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAAuB,KAA6B,EACpD,YAAoB,kBAAkB;IAEtC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE;YAC7C,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;QAC9D,IAAI,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnD,8CAA8C;QAC9C,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IAC/E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,yBAAyB,GAAG,EAAE,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AASD,oEAAoE;AACpE,MAAM,UAAU,iBAAiB;IAC/B,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO;QACL,KAAK,CAAC,YAAuB,KAA6B;YACxD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW;gBAAE,OAAO;YAC3C,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,kBAAkB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBAChD,MAAM,GAAG,KAAK,CAAC;gBACf,IAAI,KAAK,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnD,GAAG,CAAC,IAAI,CACN,aAAa,EACb,qBAAqB,KAAK,0BAA0B,OAAO,GAAG,CAC/D,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM;YACJ,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/versionCompare.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compare two `major.minor.patch` versions numerically. Returns -1, 0, or 1,
+ * or null when either input is not three dot-separated non-negative integers.
+ */
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1 | null;

package/dist/versionCompare.js

@@ -0,0 +1,33 @@
+// Release versions are major.minor.patch triples of non-negative integers.
+// Anything else (a leading v, prerelease or build suffixes, extra segments)
+// is unparsable, and callers treat unparsable as "say nothing".
+function parse(version) {
+    if (typeof version !== "string")
+        return null;
+    const parts = version.split(".");
+    if (parts.length !== 3)
+        return null;
+    const numbers = [];
+    for (const part of parts) {
+        if (!/^(0|[1-9]\d*)$/.test(part))
+            return null;
+        numbers.push(Number(part));
+    }
+    return [numbers[0], numbers[1], numbers[2]];
+}
+/**
+ * Compare two `major.minor.patch` versions numerically. Returns -1, 0, or 1,
+ * or null when either input is not three dot-separated non-negative integers.
+ */
+export function compareVersions(a, b) {
+    const left = parse(a);
+    const right = parse(b);
+    if (!left || !right)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        if (left[i] !== right[i])
+            return left[i] < right[i] ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=versionCompare.js.map

package/dist/versionCompare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionCompare.js","sourceRoot":"","sources":["../src/versionCompare.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,gEAAgE;AAEhE,SAAS,KAAK,CAAC,OAAe;IAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/versionNotices.d.ts

@@ -0,0 +1,9 @@
+export interface VersionInfo {
+    /** The server's own release. */
+    server: string;
+    /** Connected executor, "extension/<v>" or "bootstrap/<v>", or null. */
+    executor: string | null;
+    /** Newest release on npm, or null when unknown or the check is off. */
+    latest: string | null;
+}
+export declare function versionNotices(info: VersionInfo): string[];

package/dist/versionNotices.js

@@ -0,0 +1,42 @@
+// Plain-language update notices for projectionlab_check_connection. Each
+// rule says nothing whenever a needed comparison is unparsable or a version
+// is unknown; being out of date is never reported as a connection failure.
+import { compareVersions } from "./versionCompare.js";
+const SERVER_FIX = "To update it, fully quit and reopen the AI assistant's host so npx fetches the new release; " +
+    "if the old version is still reported afterwards, set the server args in the host " +
+    "configuration to -y projectionlab-mcp@latest.";
+const EXTENSION_FIX = "To update it, download the zip for the browser from " +
+    "https://github.com/Backroads4Me/projectionlab-mcp/releases/latest, replace the unpacked " +
+    "extension folder with its contents, and reload the extension from the browser's extensions " +
+    "page. Settings are kept.";
+export function versionNotices(info) {
+    const notices = [];
+    const serverOutOfDate = info.latest !== null && compareVersions(info.latest, info.server) === 1;
+    if (serverOutOfDate) {
+        notices.push(`The ProjectionLab MCP server is running version ${info.server}, but version ` +
+            `${info.latest} is available on npm. ${SERVER_FIX}`);
+    }
+    if (info.executor) {
+        const slash = info.executor.lastIndexOf("/");
+        const kind = slash === -1 ? "" : info.executor.slice(0, slash);
+        const version = slash === -1 ? "" : info.executor.slice(slash + 1);
+        const cmp = compareVersions(version, info.server);
+        if (kind === "extension" && cmp === -1) {
+            notices.push(`The ProjectionLab browser extension is version ${version}, older than the server ` +
+                `(${info.server}). ${EXTENSION_FIX}`);
+        }
+        else if (kind === "extension" && cmp === 1 && !serverOutOfDate) {
+            // Only worth saying when npm has nothing newer to offer as well.
+            notices.push(`The ProjectionLab MCP server is version ${info.server}, older than the browser ` +
+                `extension (${version}). ${SERVER_FIX}`);
+        }
+        else if (kind === "bootstrap" && cmp !== null && cmp !== 0) {
+            notices.push(`The bootstrap snippet in the ProjectionLab tab is version ${version}, pasted from a ` +
+                `different server release than the running server (${info.server}). Ask the user to ` +
+                `reload the tab, then call projectionlab_get_bootstrap and paste the fresh snippet ` +
+                `into the browser console.`);
+        }
+    }
+    return notices;
+}
+//# sourceMappingURL=versionNotices.js.map

package/dist/versionNotices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionNotices.js","sourceRoot":"","sources":["../src/versionNotices.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,UAAU,GACd,8FAA8F;IAC9F,mFAAmF;IACnF,+CAA+C,CAAC;AAClD,MAAM,aAAa,GACjB,sDAAsD;IACtD,0FAA0F;IAC1F,6FAA6F;IAC7F,0BAA0B,CAAC;AAW7B,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,eAAe,GACnB,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1E,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CACV,mDAAmD,IAAI,CAAC,MAAM,gBAAgB;YAC5E,GAAG,IAAI,CAAC,MAAM,yBAAyB,UAAU,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,WAAW,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CACV,kDAAkD,OAAO,0BAA0B;gBACjF,IAAI,IAAI,CAAC,MAAM,MAAM,aAAa,EAAE,CACvC,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACjE,iEAAiE;YACjE,OAAO,CAAC,IAAI,CACV,2CAA2C,IAAI,CAAC,MAAM,2BAA2B;gBAC/E,cAAc,OAAO,MAAM,UAAU,EAAE,CAC1C,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,IAAI,CACV,6DAA6D,OAAO,kBAAkB;gBACpF,qDAAqD,IAAI,CAAC,MAAM,qBAAqB;gBACrF,oFAAoF;gBACpF,2BAA2B,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectionlab-mcp",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "MCP server for ProjectionLab: read and safely edit your retirement plan from any MCP-compatible AI assistant",
   "type": "module",
   "license": "MIT",
@@ -30,6 +30,9 @@
     "skills",
     "README.md",
     "HOW-IT-WORKS.md",
+    "SETUP-FOR-AGENTS.md",
+    "MANUAL-SETUP.md",
+    "REFERENCE.md",
     "LICENSE"
   ],
   "publishConfig": {
@@ -48,13 +51,13 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dotenv": "^16.4.7",
     "ws": "^8.21.1",
-    "zod": "^3.24.0"
+    "zod": "^4.6.7"
   },
   "//overrides": "Patched transitive deps of the MCP SDK, kept within each parent's declared range (in-major) for compatibility. All except fast-uri live only in the SDK's HTTP/SSE transport, which this stdio-only server never loads; fast-uri is used by ajv for schema validation.",
   "overrides": {
     "fast-uri": "^3.1.6",
     "hono": "^4.13.4",
-    "@hono/node-server": "^1.19.17",
+    "@hono/node-server": "^2.1.3",
     "path-to-regexp": "^8.4.2",
     "body-parser": "^2.3.0",
     "qs": "^6.15.3",