@webspire/mcp 0.9.0 → 0.10.0

package/dist/registry.d.ts

@@ -7,9 +7,15 @@ export interface RegistryOptions {
 }
 /**
  * Load the registry with fallback chain:
- * 1. Explicit --registry-file path
- * 2. Bundled data/registry.json (shipped with npm package)
- * 3. Remote fetch from --registry-url or default URL
+ * 1. Explicit --registry-file path (dev / CI override)
+ * 2. In-memory cache (5-min TTL, cleared when MCP process restarts)
+ * 3. Remote fetch from webspire.de — if newer than disk cache, writes to disk
+ * 4. Disk cache (~/.cache/webspire/registry.json) — persists across restarts,
+ *    always holds the last successfully fetched remote version
+ * 5. Bundled data/registry.json — frozen at npm publish time, last resort
+ *
+ * The date comparison (registry.generated) ensures the disk cache is only
+ * overwritten when the remote actually has newer content.
  */
 export declare function loadRegistry(options?: RegistryOptions): Promise<Registry>;
 /**

package/dist/registry.js

@@ -1,19 +1,16 @@
 import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { searchSnippets as searchEntries } from './search.js';
 const DEFAULT_REGISTRY_URL = 'https://webspire.de/registry.json';
 const CACHE_TTL_MS = 5 * 60 * 1000;
-let cache = null;
-/**
- * Resolve the path to the bundled registry.json shipped with this package.
- * Works both from src/ (development) and dist/ (published).
- */
+const DISK_CACHE_PATH = resolve(homedir(), '.cache', 'webspire', 'registry.json');
+let memCache = null;
 function getBundledRegistryPath() {
     try {
         const thisDir = dirname(fileURLToPath(import.meta.url));
-        // From dist/ → ../data/registry.json, from src/ → ../data/registry.json
         const candidate = resolve(thisDir, '..', 'data', 'registry.json');
         return existsSync(candidate) ? candidate : undefined;
     }
@@ -21,11 +18,39 @@ function getBundledRegistryPath() {
         return undefined;
     }
 }
+async function readDiskCache() {
+    try {
+        const raw = await readFile(DISK_CACHE_PATH, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDiskCache(registry) {
+    try {
+        await mkdir(dirname(DISK_CACHE_PATH), { recursive: true });
+        await writeFile(DISK_CACHE_PATH, JSON.stringify(registry), 'utf-8');
+    }
+    catch {
+        // Best-effort — disk write failures are non-fatal
+    }
+}
+/** Returns true if registry a was generated after registry b. */
+function isNewer(a, b) {
+    return new Date(a.generated ?? 0).getTime() > new Date(b.generated ?? 0).getTime();
+}
 /**
  * Load the registry with fallback chain:
- * 1. Explicit --registry-file path
- * 2. Bundled data/registry.json (shipped with npm package)
- * 3. Remote fetch from --registry-url or default URL
+ * 1. Explicit --registry-file path (dev / CI override)
+ * 2. In-memory cache (5-min TTL, cleared when MCP process restarts)
+ * 3. Remote fetch from webspire.de — if newer than disk cache, writes to disk
+ * 4. Disk cache (~/.cache/webspire/registry.json) — persists across restarts,
+ *    always holds the last successfully fetched remote version
+ * 5. Bundled data/registry.json — frozen at npm publish time, last resort
+ *
+ * The date comparison (registry.generated) ensures the disk cache is only
+ * overwritten when the remote actually has newer content.
  */
 export async function loadRegistry(options) {
     // 1. Explicit file path
@@ -33,24 +58,42 @@ export async function loadRegistry(options) {
         const raw = await readFile(options.filePath, 'utf-8');
         return JSON.parse(raw);
     }
-    // 2. Bundled registry (no cache needed — file is local and fast)
+    // 2. In-memory cache (avoids re-fetching within the same session)
+    if (memCache && Date.now() - memCache.loadedAt < CACHE_TTL_MS) {
+        return memCache.registry;
+    }
+    // 3. Remote fetch — compare with disk cache, write if newer
+    try {
+        const url = options?.url ?? DEFAULT_REGISTRY_URL;
+        const response = await fetch(url);
+        if (response.ok) {
+            const remote = (await response.json());
+            memCache = { registry: remote, loadedAt: Date.now() };
+            // Write to disk only when remote is actually newer than what's cached
+            const disk = await readDiskCache();
+            if (!disk || isNewer(remote, disk)) {
+                await writeDiskCache(remote);
+            }
+            return remote;
+        }
+    }
+    catch {
+        // Network unavailable — fall through to disk cache
+    }
+    // 4. Disk cache — last successfully fetched version, survives process restarts
+    const disk = await readDiskCache();
+    if (disk) {
+        memCache = { registry: disk, loadedAt: Date.now() };
+        return disk;
+    }
+    // 5. Bundled registry — frozen at npm publish time
     const bundledPath = getBundledRegistryPath();
-    if (bundledPath && !options?.url) {
+    if (bundledPath) {
         const raw = await readFile(bundledPath, 'utf-8');
         return JSON.parse(raw);
     }
-    // 3. Remote fetch with TTL cache
-    if (cache && Date.now() - cache.loadedAt < CACHE_TTL_MS) {
-        return cache.registry;
-    }
-    const url = options?.url ?? DEFAULT_REGISTRY_URL;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch registry from ${url}: ${response.statusText}`);
-    }
-    const registry = (await response.json());
-    cache = { registry, loadedAt: Date.now() };
-    return registry;
+    throw new Error('Registry unavailable: network unreachable and no local cache found. ' +
+        'Try reinstalling @webspire/mcp or check your internet connection.');
 }
 /**
  * Load the bundled fonts.json shipped with this package.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webspire/mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "MCP server for Webspire — AI-native discovery of CSS snippets, UI patterns, canvas effects, page templates, and font recommendations",
   "type": "module",
   "exports": {