gnosys 5.9.0 → 5.9.1

package/dist/index.d.ts

@@ -4,5 +4,10 @@
  * Exposes memory operations as MCP tools that any agent can call.
  * Supports layered stores: project (auto-discovered), personal, global, optional.
  */
-export {};
+/**
+ * Returns once the heavy deps have been loaded and module-level vars
+ * (ingestion, hybridSearch, askEngine) are populated. Handlers that
+ * need any of these should `await ensureHeavyDeps()` first.
+ */
+export declare function ensureHeavyDeps(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAg/GH;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/index.js

@@ -43,26 +43,17 @@ import { z } from "zod";
 import fs from "fs/promises";
 import { GnosysSearch } from "./lib/search.js";
 import { GnosysTagRegistry } from "./lib/tags.js";
-import { performImport, formatImportSummary, estimateDuration } from "./lib/import.js";
-import { GnosysIngestion } from "./lib/ingest.js";
 import { GnosysResolver } from "./lib/resolver.js";
 import { applyLens } from "./lib/lensing.js";
 import { getFileHistory, rollbackToCommit, hasGitHistory } from "./lib/history.js";
 import { groupByPeriod, computeStats } from "./lib/timeline.js";
 import { buildLinkGraph, getBacklinks, getOutgoingLinks, formatGraphSummary } from "./lib/wikilinks.js";
-import { bootstrap } from "./lib/bootstrap.js";
 import { loadConfig, DEFAULT_CONFIG } from "./lib/config.js";
-import { GnosysEmbeddings } from "./lib/embeddings.js";
-import { GnosysHybridSearch } from "./lib/hybridSearch.js";
-import { GnosysAsk } from "./lib/ask.js";
 import { getLLMProvider } from "./lib/llm.js";
-import { GnosysMaintenanceEngine, formatMaintenanceReport } from "./lib/maintenance.js";
 import { recall, formatRecall } from "./lib/recall.js";
 import { initAudit, readAuditLog, formatAuditTimeline } from "./lib/audit.js";
 import { GnosysDB } from "./lib/db.js";
 import { syncMemoryToDb, syncUpdateToDb, syncDearchiveToDb, syncReinforcementToDb, auditToDb } from "./lib/dbWrite.js";
-import { GnosysDreamEngine, DreamScheduler, formatDreamReport } from "./lib/dream.js";
-import { GnosysExporter, formatExportReport } from "./lib/export.js";
 import { createProjectIdentity, readProjectIdentity } from "./lib/projectIdentity.js";
 import { setPreference, getPreference, getAllPreferences, deletePreference } from "./lib/preferences.js";
 import { syncRules, generateRulesBlock } from "./lib/rulesGen.js";
@@ -503,7 +494,11 @@ server.tool("gnosys_add", "Add a new memory. Accepts raw text — an LLM structu
             isError: true,
         };
     }
-    // Note: ingestion remains module-level since it's heavy and project-agnostic
+    // v5.9.1 (#100): ingestion is constructed in the background after
+    // server.connect() responds to the MCP handshake. Wait for that to
+    // finish before proceeding — first call after a fresh MCP spawn
+    // may pause here briefly.
+    await ensureHeavyDeps();
     if (!ingestion) {
         return {
             content: [
@@ -796,6 +791,7 @@ server.tool("gnosys_init", "Initialize Gnosys in a project directory. Creates .g
         search = new GnosysSearch(writeTarget.store.getStorePath());
         tagRegistry = new GnosysTagRegistry(writeTarget.store.getStorePath());
         await tagRegistry.load();
+        const { GnosysIngestion } = await import("./lib/ingest.js");
         ingestion = new GnosysIngestion(writeTarget.store, tagRegistry);
         await reindexAllStores();
     }
@@ -876,6 +872,7 @@ server.tool("gnosys_migrate", "Migrate a Gnosys store (.gnosys/) from one direct
             search = new GnosysSearch(writeTarget.store.getStorePath());
             tagRegistry = new GnosysTagRegistry(writeTarget.store.getStorePath());
             await tagRegistry.load();
+            const { GnosysIngestion } = await import("./lib/ingest.js");
             ingestion = new GnosysIngestion(writeTarget.store, tagRegistry);
             await reindexAllStores();
         }
@@ -1057,6 +1054,11 @@ server.tool("gnosys_commit_context", "Pre-compaction memory sweep. Call this bef
     // happens against `ctx.config` (merged project+global) below; if that
     // can't find a provider, getLLMProvider() surfaces a provider-specific
     // error message.
+    //
+    // v5.9.1 (#100): wait for the background heavy-init to populate
+    // `ingestion` if it hasn't yet (first call after a fresh MCP spawn
+    // may pause here while @huggingface/transformers etc. load).
+    await ensureHeavyDeps();
     if (!ingestion) {
         return {
             content: [{ type: "text", text: "Ingestion module not initialized." }],
@@ -1471,6 +1473,8 @@ server.tool("gnosys_bootstrap", "Batch-import existing documents from a director
         return { content: [{ type: "text", text: "No writable store found." }], isError: true };
     }
     try {
+        // v5.9.1 (#100): bootstrap pulls in heavy file-walking deps — load lazily.
+        const { bootstrap } = await import("./lib/bootstrap.js");
         const result = await bootstrap(writeTarget.store, {
             sourceDir,
             patterns,
@@ -1549,6 +1553,8 @@ server.tool("gnosys_import", "Bulk import structured data (CSV, JSON, JSONL) int
     }
     const effectiveMode = mode || "structured";
     try {
+        // v5.9.1 (#100): import.js pulls mammoth + pdf-parse + turndown.
+        const { performImport, formatImportSummary, estimateDuration } = await import("./lib/import.js");
         const result = await performImport(writeTarget.store, ingestion, {
             format: format,
             data,
@@ -1599,6 +1605,8 @@ server.tool("gnosys_hybrid_search", "Search memories using hybrid keyword + sema
 }, async ({ query, limit, mode, projectRoot }) => {
     // Note: hybridSearch is module-level (heavy) and not scoped per project
     (projectRoot); // quiets unused warning if any
+    // v5.9.1 (#100): wait for the background heavy-init to finish.
+    await ensureHeavyDeps();
     if (!hybridSearch) {
         return {
             content: [{ type: "text", text: "Hybrid search not initialized. No stores found." }],
@@ -1619,6 +1627,8 @@ server.tool("gnosys_hybrid_search", "Search memories using hybrid keyword + sema
         // Use default resolver here since hybridSearch operates across all stores
         const writeTarget = resolver.getWriteTarget();
         if (writeTarget) {
+            // v5.9.1 (#100): lazy-load the maintenance module here too.
+            const { GnosysMaintenanceEngine } = await import("./lib/maintenance.js");
             GnosysMaintenanceEngine.reinforceBatch(writeTarget.store, results.map((r) => r.relativePath)).catch(() => { }); // Fire-and-forget
         }
         const embCount = hybridSearch.embeddingCount();
@@ -1646,6 +1656,7 @@ server.tool("gnosys_semantic_search", "Search memories using semantic similarity
 }, async ({ query, limit, projectRoot }) => {
     // Note: hybridSearch is module-level (heavy) and not scoped per project
     (projectRoot); // quiets unused warning if any
+    await ensureHeavyDeps();
     if (!hybridSearch) {
         return {
             content: [{ type: "text", text: "Search not initialized. No stores found." }],
@@ -1677,6 +1688,7 @@ server.tool("gnosys_semantic_search", "Search memories using semantic similarity
 server.tool("gnosys_reindex", "Rebuild all semantic embeddings from every memory file. Downloads the embedding model (~80 MB) on first run. Required before hybrid/semantic search can be used. Safe to re-run — fully regenerates the index.", { projectRoot: projectRootParam }, async ({ projectRoot }) => {
     // Note: reindex operates on all stores, projectRoot is for API consistency
     (projectRoot); // quiets unused warning if any
+    await ensureHeavyDeps();
     if (!hybridSearch) {
         return {
             content: [{ type: "text", text: "No stores found. Initialize a store with gnosys_init first." }],
@@ -1712,6 +1724,7 @@ server.tool("gnosys_ask", "Ask a natural-language question and get a synthesized
 }, async ({ question, limit, mode, projectRoot }) => {
     // Note: askEngine is module-level (heavy) and not scoped per project
     (projectRoot); // quiets unused warning if any
+    await ensureHeavyDeps();
     if (!askEngine) {
         return {
             content: [{ type: "text", text: "Ask engine not initialized. Ensure stores exist and an LLM provider is configured." }],
@@ -1726,6 +1739,8 @@ server.tool("gnosys_ask", "Ask a natural-language question and get a synthesized
         // Reinforce used memories (best-effort, non-blocking)
         const writeTarget = resolver.getWriteTarget();
         if (writeTarget && result.sources.length > 0) {
+            // v5.9.1 (#100): lazy-load the maintenance module here too.
+            const { GnosysMaintenanceEngine } = await import("./lib/maintenance.js");
             GnosysMaintenanceEngine.reinforceBatch(writeTarget.store, result.sources.map((s) => s.relativePath)).catch(() => { }); // Fire-and-forget
         }
         const sourcesText = result.sources.length > 0
@@ -1765,6 +1780,9 @@ server.tool("gnosys_maintain", "Run vault maintenance: detect duplicate memories
 }, async ({ dryRun, autoApply, projectRoot }) => {
     const ctx = await resolveToolContext(projectRoot);
     try {
+        // v5.9.1 (#100): maintenance engine pulls LLM machinery for the
+        // discoverRelationships / generateSummaries phases — load lazily.
+        const { GnosysMaintenanceEngine, formatMaintenanceReport } = await import("./lib/maintenance.js");
         const engine = new GnosysMaintenanceEngine(ctx.resolver, ctx.config);
         const report = await engine.maintain({
             dryRun: dryRun ?? true,
@@ -1893,6 +1911,8 @@ server.tool("gnosys_dream", "Run a Dream Mode cycle — idle-time consolidation
         provider: ctx.config?.dream?.provider || "ollama",
         model: ctx.config?.dream?.model,
     };
+    // v5.9.1 (#100): dream engine pulls LLM provider machinery — load lazily.
+    const { GnosysDreamEngine, formatDreamReport } = await import("./lib/dream.js");
     const engine = new GnosysDreamEngine(ctx.centralDb, ctx.config || DEFAULT_CONFIG, dreamConfig);
     const report = await engine.dream((phase, detail) => {
         console.error(`[dream:${phase}] ${detail}`);
@@ -1927,6 +1947,8 @@ server.tool("gnosys_export", "Export gnosys.db to Obsidian-compatible vault —
             ],
         };
     }
+    // v5.9.1 (#100): exporter pulls obsidian-flavored markdown gen — lazy.
+    const { GnosysExporter, formatExportReport } = await import("./lib/export.js");
     const exporter = new GnosysExporter(ctx.centralDb);
     const report = await exporter.export({
         targetDir: params.targetDir,
@@ -2780,6 +2802,113 @@ This marks the conversation checkpoint so the next /gnosys-memorize only process
         ],
     };
 });
+// ─── Heavy module initialization (deferred) ───────────────────────────────
+//
+// v5.9.1 (#100). Constructs GnosysIngestion / GnosysEmbeddings /
+// GnosysHybridSearch / GnosysAsk / GnosysDreamEngine. These modules pull
+// in @huggingface/transformers (80MB), mammoth, pdf-parse, turndown, and
+// LLM provider SDKs — together ~24s of import time on cold disk. By
+// running them AFTER server.connect() responds to the MCP handshake, we
+// avoid the client-side timeout (Grok Build = 10s default).
+let heavyDepsReadyResolve = null;
+const heavyDepsReady = new Promise((resolve) => {
+    heavyDepsReadyResolve = resolve;
+});
+/**
+ * Returns once the heavy deps have been loaded and module-level vars
+ * (ingestion, hybridSearch, askEngine) are populated. Handlers that
+ * need any of these should `await ensureHeavyDeps()` first.
+ */
+export function ensureHeavyDeps() {
+    return heavyDepsReady;
+}
+async function initHeavyDeps() {
+    const writeTarget = resolver.getWriteTarget();
+    if (!writeTarget || !tagRegistry || !search) {
+        heavyDepsReadyResolve?.();
+        return;
+    }
+    // Ingestion (used by gnosys_add, gnosys_commit_context).
+    const { GnosysIngestion } = await import("./lib/ingest.js");
+    ingestion = new GnosysIngestion(writeTarget.store, tagRegistry, config);
+    console.error(`LLM ingestion: ${ingestion.isLLMAvailable ? `enabled (${ingestion.providerName})` : "disabled (configure LLM provider)"}`);
+    // Hybrid search + ask (used by gnosys_hybrid_search / gnosys_ask).
+    const { GnosysEmbeddings } = await import("./lib/embeddings.js");
+    const { GnosysHybridSearch } = await import("./lib/hybridSearch.js");
+    const { GnosysAsk } = await import("./lib/ask.js");
+    const embeddings = new GnosysEmbeddings(writeTarget.store.getStorePath());
+    hybridSearch = new GnosysHybridSearch(search, embeddings, resolver, writeTarget.store.getStorePath(), gnosysDb || undefined);
+    askEngine = new GnosysAsk(hybridSearch, config, resolver, writeTarget.store.getStorePath());
+    const embCount = embeddings.hasEmbeddings() ? embeddings.count() : 0;
+    console.error(`Hybrid search: ${embCount > 0 ? `ready (${embCount} embeddings)` : "available (run gnosys_reindex to build embeddings)"}`);
+    console.error(`Ask engine: ${askEngine.isLLMAvailable ? `ready (${askEngine.providerName}/${askEngine.modelName})` : "disabled (configure LLM provider)"}`);
+    // Dream mode (only constructed if enabled; designation gate inside start()).
+    if (gnosysDb && config.dream?.enabled) {
+        const { GnosysDreamEngine, DreamScheduler } = await import("./lib/dream.js");
+        const dreamEngine = new GnosysDreamEngine(gnosysDb, config, config.dream);
+        dreamScheduler = new DreamScheduler(dreamEngine, config.dream);
+        // Layer 3: probe the dream provider if this machine is the dream node.
+        try {
+            const designated = gnosysDb.getDreamMachineId();
+            const localId = gnosysDb.getMeta("machine_id");
+            if (designated && designated === localId) {
+                const dreamProvider = config.dream.provider || "ollama";
+                const dreamModel = config.dream.model || "(default)";
+                const { validateModel } = await import("./lib/modelValidation.js");
+                const envVarName = `GNOSYS_${dreamProvider.toUpperCase()}_KEY`;
+                let apiKey = process.env[envVarName] || "";
+                if (!apiKey && process.platform === "darwin" && dreamProvider !== "ollama" && dreamProvider !== "lmstudio") {
+                    try {
+                        const { execSync } = await import("child_process");
+                        apiKey = execSync(`security find-generic-password -a "$USER" -s "${envVarName}" -w 2>/dev/null`, {
+                            stdio: "pipe", encoding: "utf-8", timeout: 2000,
+                        }).trim();
+                    }
+                    catch {
+                        // No key in keychain
+                    }
+                }
+                if (!apiKey && dreamProvider !== "ollama" && dreamProvider !== "lmstudio") {
+                    process.stderr.write(`gnosys: dream provider '${dreamProvider}/${dreamModel}' has no API key configured.\n` +
+                        `  This machine is designated to dream, but the LLM cannot be called.\n` +
+                        `  Run 'gnosys setup dream' to reconfigure.\n`);
+                }
+                else {
+                    const result = await Promise.race([
+                        validateModel(dreamProvider, dreamModel, apiKey),
+                        new Promise((resolve) => setTimeout(() => resolve({ ok: false, error: "probe timeout (5s)" }), 5000)),
+                    ]);
+                    if (!result.ok) {
+                        process.stderr.write(`gnosys: dream provider '${dreamProvider}/${dreamModel}' is unreachable at startup.\n` +
+                            `  This machine is designated to dream, but the LLM cannot be called.\n` +
+                            `  Error: ${("error" in result && result.error) || "unknown"}\n` +
+                            `  Run 'gnosys setup dream' to reconfigure.\n`);
+                    }
+                }
+            }
+        }
+        catch {
+            // Probe failed — non-fatal. Continue with scheduler start.
+        }
+        dreamScheduler.start();
+        const designated = gnosysDb.getDreamMachineId();
+        const localId = gnosysDb.getMeta("machine_id");
+        if (!designated) {
+            console.error(`Dream Mode: enabled but no machine designated. Run 'gnosys setup dream' on the machine you want to host dreams.`);
+        }
+        else if (designated !== localId) {
+            console.error(`Dream Mode: enabled — designated to '${designated}'. This machine (${localId || "?"}) will not dream.`);
+        }
+        else {
+            console.error(`Dream Mode: enabled on this machine (idle ${config.dream.idleMinutes}min, max ${config.dream.maxRuntimeMinutes}min)`);
+        }
+    }
+    else {
+        console.error(`Dream Mode: disabled (run 'gnosys setup dream' to configure)`);
+    }
+    console.error("Gnosys MCP: heavy modules ready");
+    heavyDepsReadyResolve?.();
+}
 // ─── Start the server ────────────────────────────────────────────────────
 async function main() {
     // v5.7.1 (#15): start the upgrade-marker watcher BEFORE anything else.
@@ -2810,7 +2939,12 @@ async function main() {
     console.error("Gnosys MCP server starting.");
     console.error("Active stores:");
     console.error(resolver.getSummary());
-    // Initialize search from the first writable store
+    // Initialize search from the first writable store. Everything in this
+    // block is FAST — opening the search index + tag registry + loading
+    // gnosys.json. The slow stuff (LLM providers, transformers embeddings,
+    // pdf/docx parsers) is deferred to `initHeavyDeps()` below so the MCP
+    // server can answer the `initialize` handshake within the client's
+    // timeout (Grok Build is 10s, Claude Code is ~15s).
     const writeTarget = resolver.getWriteTarget();
     if (writeTarget) {
         search = new GnosysSearch(writeTarget.store.getStorePath());
@@ -2823,7 +2957,6 @@ async function main() {
         catch (err) {
             console.error(`Warning: Failed to load gnosys.json: ${err instanceof Error ? err.message : err}`);
         }
-        ingestion = new GnosysIngestion(writeTarget.store, tagRegistry, config);
         // Initialize audit logging
         initAudit(writeTarget.store.getStorePath());
         // Build search index across all stores
@@ -2831,91 +2964,22 @@ async function main() {
         // v5.2: gnosysDb now points to the central DB (sole source of truth).
         // No local project DB is created or opened.
         gnosysDb = centralDb;
-        // Initialize hybrid search + ask engine (embeddings loaded lazily)
-        const embeddings = new GnosysEmbeddings(writeTarget.store.getStorePath());
-        hybridSearch = new GnosysHybridSearch(search, embeddings, resolver, writeTarget.store.getStorePath(), gnosysDb || undefined);
-        askEngine = new GnosysAsk(hybridSearch, config, resolver, writeTarget.store.getStorePath());
-        const embCount = embeddings.hasEmbeddings() ? embeddings.count() : 0;
-        console.error(`LLM ingestion: ${ingestion.isLLMAvailable ? `enabled (${ingestion.providerName})` : "disabled (configure LLM provider)"}`);
-        console.error(`Hybrid search: ${embCount > 0 ? `ready (${embCount} embeddings)` : "available (run gnosys_reindex to build embeddings)"}`);
-        console.error(`Ask engine: ${askEngine.isLLMAvailable ? `ready (${askEngine.providerName}/${askEngine.modelName})` : "disabled (configure LLM provider)"}`);
-        // v2.0: Initialize Dream Mode (idle-time consolidation)
-        // v5.4.2: Designation gate inside DreamScheduler.start() — only the
-        // machine designated via `gnosys setup dream` arms the timer. Other
-        // machines no-op silently. Layer 3 startup probe surfaces a stderr
-        // warning if this machine is designated but the dream provider is
-        // unreachable.
-        if (gnosysDb && config.dream?.enabled) {
-            const dreamEngine = new GnosysDreamEngine(gnosysDb, config, config.dream);
-            dreamScheduler = new DreamScheduler(dreamEngine, config.dream);
-            // Layer 3: probe the dream provider if this machine is the dream node.
-            // Done before scheduler.start() so users see the warning immediately
-            // alongside other startup output.
-            try {
-                const designated = gnosysDb.getDreamMachineId();
-                const localId = gnosysDb.getMeta("machine_id");
-                if (designated && designated === localId) {
-                    // Quick reachability probe — 5s timeout to avoid blocking startup.
-                    const dreamProvider = config.dream.provider || "ollama";
-                    const dreamModel = config.dream.model || "(default)";
-                    const { validateModel } = await import("./lib/modelValidation.js");
-                    // Resolve API key from env or keychain (mirroring resolveApiKey precedence).
-                    const envVarName = `GNOSYS_${dreamProvider.toUpperCase()}_KEY`;
-                    let apiKey = process.env[envVarName] || "";
-                    if (!apiKey && process.platform === "darwin" && dreamProvider !== "ollama" && dreamProvider !== "lmstudio") {
-                        try {
-                            const { execSync } = await import("child_process");
-                            apiKey = execSync(`security find-generic-password -a "$USER" -s "${envVarName}" -w 2>/dev/null`, {
-                                stdio: "pipe", encoding: "utf-8", timeout: 2000,
-                            }).trim();
-                        }
-                        catch {
-                            // No key in keychain
-                        }
-                    }
-                    // Skip the network probe if there's clearly no key configured for a
-                    // remote provider — surface the obvious config gap instead.
-                    if (!apiKey && dreamProvider !== "ollama" && dreamProvider !== "lmstudio") {
-                        process.stderr.write(`gnosys: dream provider '${dreamProvider}/${dreamModel}' has no API key configured.\n` +
-                            `  This machine is designated to dream, but the LLM cannot be called.\n` +
-                            `  Run 'gnosys setup dream' to reconfigure.\n`);
-                    }
-                    else {
-                        const result = await Promise.race([
-                            validateModel(dreamProvider, dreamModel, apiKey),
-                            new Promise((resolve) => setTimeout(() => resolve({ ok: false, error: "probe timeout (5s)" }), 5000)),
-                        ]);
-                        if (!result.ok) {
-                            process.stderr.write(`gnosys: dream provider '${dreamProvider}/${dreamModel}' is unreachable at startup.\n` +
-                                `  This machine is designated to dream, but the LLM cannot be called.\n` +
-                                `  Error: ${("error" in result && result.error) || "unknown"}\n` +
-                                `  Run 'gnosys setup dream' to reconfigure.\n`);
-                        }
-                    }
-                }
-            }
-            catch {
-                // Probe failed — non-fatal. Continue with scheduler start.
-            }
-            dreamScheduler.start();
-            const designated = gnosysDb.getDreamMachineId();
-            const localId = gnosysDb.getMeta("machine_id");
-            if (!designated) {
-                console.error(`Dream Mode: enabled but no machine designated. Run 'gnosys setup dream' on the machine you want to host dreams.`);
-            }
-            else if (designated !== localId) {
-                console.error(`Dream Mode: enabled — designated to '${designated}'. This machine (${localId || "?"}) will not dream.`);
-            }
-            else {
-                console.error(`Dream Mode: enabled on this machine (idle ${config.dream.idleMinutes}min, max ${config.dream.maxRuntimeMinutes}min)`);
-            }
-        }
-        else {
-            console.error(`Dream Mode: disabled (run 'gnosys setup dream' to configure)`);
-        }
+        console.error("Gnosys MCP: light init complete; LLM/embeddings/dream loading in background…");
     }
+    // v5.9.1 (#100): connect EARLY so the MCP `initialize` handshake responds
+    // before we incur the ~24s heavy-import cost. After connect, kick off
+    // heavy module initialization in the background. Handlers that use the
+    // module-level `ingestion` / `hybridSearch` / `askEngine` vars guard
+    // against null and either await readiness or surface a clear error.
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    console.error("Gnosys MCP: handshake ready (heavy modules still loading)");
+    // Kick off heavy deps; fire-and-forget. Errors here are non-fatal —
+    // they're logged to stderr and the affected handlers will report the
+    // failure on first use.
+    void initHeavyDeps().catch((err) => {
+        console.error(`Gnosys MCP: heavy-init failed — ${err instanceof Error ? err.message : err}`);
+    });
     // ─── MCP Roots Support (multi-project awareness) ───────────────────────
     // After connecting, request workspace roots from the host. This lets us
     // discover .gnosys stores in all open projects, not just the cwd.