gnosys 4.2.0 → 4.3.0

package/README.md

@@ -81,7 +81,7 @@ gnosys add "We chose PostgreSQL over MySQL for its JSON support and mature ecosy
 gnosys recall "database selection"
 ```
 
-> **Multi-machine?** Set `GNOSYS_GLOBAL` to a cloud-synced folder (iCloud Drive, Dropbox, OneDrive) and both machines share the same brain. See the [User Guide — Installation & Setup](https://gnosys.ai/guide.html#guide-installation) for the full walkthrough, memory scopes, and multi-machine setup.
+> **Multi-machine?** Set `GNOSYS_GLOBAL` to a cloud-synced folder (iCloud Drive, Dropbox, OneDrive) and both machines share the same brain. After updating, run `gnosys upgrade` — it re-syncs all projects, regenerates agent rules, and warns other machines to upgrade too. See the [User Guide — Installation & Setup](https://gnosys.ai/guide.html#guide-installation) for the full walkthrough, memory scopes, and multi-machine setup.
 
 ### Agent / Helper Library
 
@@ -245,8 +245,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
   "mcpServers": {
     "gnosys": {
       "command": "gnosys",
-      "args": ["serve"],
-      "env": { "ANTHROPIC_API_KEY": "your-key-here" }
+      "args": ["serve"]
     }
   }
 }
@@ -261,8 +260,7 @@ Add to `.cursor/mcp.json`:
   "mcpServers": {
     "gnosys": {
       "command": "gnosys",
-      "args": ["serve"],
-      "env": { "ANTHROPIC_API_KEY": "your-key-here" }
+      "args": ["serve"]
     }
   }
 }
@@ -282,11 +280,10 @@ Add to `.codex/config.toml`:
 [mcp.gnosys]
 type = "local"
 command = ["gnosys", "serve"]
-
-[mcp.gnosys.env]
-ANTHROPIC_API_KEY = "your-key-here"
 ```
 
+> **Note:** API keys are configured globally in `~/.config/gnosys/.env`, not per-IDE. See [LLM Provider Setup](https://gnosys.ai/guide.html#guide-installation) in the User Guide.
+
 ---
 
 ## MCP Tools
@@ -352,7 +349,7 @@ All memories live in a single `~/.gnosys/gnosys.db` with `project_id` and `scope
 
 ### LLM Providers
 
-Five providers behind a single interface — switch between cloud and local with one command:
+Eight providers behind a single interface — switch between cloud and local with one command:
 
 | Provider | Type | Default Model | API Key Env Var |
 |----------|------|---------------|-----------------|
@@ -361,6 +358,9 @@ Five providers behind a single interface — switch between cloud and local with
 | **Groq** | Cloud | llama-3.3-70b-versatile | `GROQ_API_KEY` |
 | **OpenAI** | Cloud | gpt-4o-mini | `OPENAI_API_KEY` |
 | **LM Studio** | Local | default | — (runs locally) |
+| **xAI** | Cloud | grok-2 | `XAI_API_KEY` |
+| **Mistral** | Cloud | mistral-large-latest | `MISTRAL_API_KEY` |
+| **Custom** | Any | (user-defined) | `GNOSYS_LLM_API_KEY` |
 
 Route tasks to different providers — a cheap model for structuring, a powerful model for synthesis:
 
@@ -455,7 +455,7 @@ All commands support `--json` for programmatic output. See the [User Guide](http
 
 **History:** `history`, `rollback`
 
-**Maintenance:** `maintain`, `dearchive`, `dream`, `reindex`, `reindex-graph`
+**Maintenance:** `maintain`, `dearchive`, `dream`, `reindex`, `reindex-graph`, `upgrade`
 
 **Export & config:** `export`, `config show`, `config set`, `dashboard`, `doctor`, `stores`
 
@@ -505,7 +505,7 @@ src/
     embeddings.ts     # Lazy semantic embeddings (all-MiniLM-L6-v2)
     hybridSearch.ts   # Hybrid search with RRF fusion
     ask.ts            # Freeform Q&A with LLM synthesis + citations
-    llm.ts            # LLM abstraction (5 providers)
+    llm.ts            # LLM abstraction (8 providers)
     maintenance.ts    # Auto-maintenance: decay, dedup, archiving
     archive.ts        # Two-tier memory: active <-> archive
     recall.ts         # Ultra-fast recall for agent orchestrators

package/dist/cli.js

@@ -20,7 +20,7 @@ import { groupByPeriod, computeStats } from "./lib/timeline.js";
 import { buildLinkGraph, getBacklinks, getOutgoingLinks, formatGraphSummary } from "./lib/wikilinks.js";
 import { bootstrap, discoverFiles } from "./lib/bootstrap.js";
 import { performImport, formatImportSummary } from "./lib/import.js";
-import { loadConfig, generateConfigTemplate, DEFAULT_CONFIG, writeConfig, resolveTaskModel, ALL_PROVIDERS } from "./lib/config.js";
+import { loadConfig, generateConfigTemplate, DEFAULT_CONFIG, writeConfig, resolveTaskModel, ALL_PROVIDERS, getProviderModel } from "./lib/config.js";
 import { GnosysEmbeddings } from "./lib/embeddings.js";
 import { GnosysHybridSearch } from "./lib/hybridSearch.js";
 import { GnosysAsk } from "./lib/ask.js";
@@ -429,6 +429,24 @@ program
         await fs.writeFile(path.join(storePath, ".config", "gnosys-config.json"), generateConfigTemplate() + "\n", "utf-8");
         const changelog = `# Gnosys Changelog\n\n## ${new Date().toISOString().split("T")[0]}\n\n- Store initialized\n`;
         await fs.writeFile(path.join(storePath, "CHANGELOG.md"), changelog, "utf-8");
+        // Add .gnosys/ to project's .gitignore if in a git repo
+        try {
+            const projectGitignore = path.join(targetDir, ".gitignore");
+            let gitignoreContent = "";
+            try {
+                gitignoreContent = await fs.readFile(projectGitignore, "utf-8");
+            }
+            catch {
+                // No .gitignore yet
+            }
+            if (!gitignoreContent.includes(".gnosys")) {
+                const entry = "\n# Gnosys memory store\n.gnosys/\n";
+                await fs.writeFile(projectGitignore, gitignoreContent + entry, "utf-8");
+            }
+        }
+        catch {
+            // Non-critical
+        }
         try {
             const { execSync } = await import("child_process");
             execSync("git init", { cwd: storePath, stdio: "pipe" });
@@ -1642,6 +1660,16 @@ configCmd
                 cfg.llm.openai.model = value;
             else if (p === "lmstudio")
                 cfg.llm.lmstudio.model = value;
+            else if (p === "xai")
+                cfg.llm.xai.model = value;
+            else if (p === "mistral")
+                cfg.llm.mistral.model = value;
+            else if (p === "custom") {
+                if (!cfg.llm.custom)
+                    cfg.llm.custom = { model: value, baseUrl: "" };
+                else
+                    cfg.llm.custom.model = value;
+            }
             console.log(`Model set to: ${value} (for ${p})`);
             break;
         }
@@ -1700,6 +1728,35 @@ configCmd
             cfg.llm.lmstudio.model = value;
             console.log(`LM Studio model set to: ${value}`);
             break;
+        case "xai-model":
+            cfg.llm.xai.model = value;
+            console.log(`xAI model set to: ${value}`);
+            break;
+        case "mistral-model":
+            cfg.llm.mistral.model = value;
+            console.log(`Mistral model set to: ${value}`);
+            break;
+        case "custom-url":
+            if (!cfg.llm.custom)
+                cfg.llm.custom = { model: "", baseUrl: value };
+            else
+                cfg.llm.custom.baseUrl = value;
+            console.log(`Custom provider base URL set to: ${value}`);
+            break;
+        case "custom-model":
+            if (!cfg.llm.custom)
+                cfg.llm.custom = { model: value, baseUrl: "" };
+            else
+                cfg.llm.custom.model = value;
+            console.log(`Custom provider model set to: ${value}`);
+            break;
+        case "custom-key":
+            if (!cfg.llm.custom)
+                cfg.llm.custom = { model: "", baseUrl: "", apiKey: value };
+            else
+                cfg.llm.custom.apiKey = value;
+            console.log(`Custom provider API key set.`);
+            break;
         case "recall": {
             // gnosys config set recall <field> <value>
             // Supported: recall aggressive true/false, recall maxMemories <n>, recall minRelevance <n>
@@ -1916,17 +1973,51 @@ program
     .action(async () => {
     const currentVersion = pkg.version;
     console.log(`Gnosys v${currentVersion} — upgrading registered projects...\n`);
-    // 1. Read registered projects
+    // 1. Read registered projects from file registry AND central DB
     const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
     const registryPath = path.join(home, ".config", "gnosys", "projects.json");
-    let projects = [];
+    let fileProjects = [];
     try {
-        projects = JSON.parse(await fs.readFile(registryPath, "utf-8"));
+        fileProjects = JSON.parse(await fs.readFile(registryPath, "utf-8"));
     }
     catch {
+        // No file registry yet
+    }
+    // Also check central DB for projects not in the file registry
+    let dbProjects = [];
+    try {
+        const centralDb = GnosysDB.openCentral();
+        if (centralDb.isAvailable()) {
+            const allProjects = centralDb.getAllProjects();
+            dbProjects = allProjects.map((p) => p.working_directory);
+            centralDb.close();
+        }
+    }
+    catch {
+        // non-critical
+    }
+    // Merge: deduplicate by resolved path
+    const seen = new Set();
+    const projects = [];
+    for (const p of [...fileProjects, ...dbProjects]) {
+        const resolved = path.resolve(p);
+        if (!seen.has(resolved)) {
+            seen.add(resolved);
+            projects.push(resolved);
+        }
+    }
+    if (projects.length === 0) {
         console.log("No registered projects found. Run 'gnosys init' in each project first.");
         return;
     }
+    // Sync the merged list back to file registry
+    try {
+        await fs.mkdir(path.dirname(registryPath), { recursive: true });
+        await fs.writeFile(registryPath, JSON.stringify(projects, null, 2), "utf-8");
+    }
+    catch {
+        // non-critical
+    }
     // 2. Iterate and upgrade each project that exists on this machine
     const upgraded = [];
     const skipped = [];
@@ -2156,69 +2247,22 @@ program
     console.log("");
     // Check all LLM providers
     console.log("LLM Connectivity:");
-    // Check Anthropic
-    const anthropicStatus = isProviderAvailable(cfg, "anthropic");
-    if (anthropicStatus.available) {
-        try {
-            const provider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: "anthropic" } });
-            await provider.testConnection();
-            console.log(`  Anthropic: ✓ connected (${cfg.llm.anthropic.model})`);
-        }
-        catch (err) {
-            console.log(`  Anthropic: ✗ ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    else {
-        console.log(`  Anthropic: — ${anthropicStatus.error}`);
-    }
-    // Check Ollama
-    try {
-        const ollamaProvider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: "ollama" } });
-        await ollamaProvider.testConnection();
-        console.log(`  Ollama: ✓ connected (${cfg.llm.ollama.model} at ${cfg.llm.ollama.baseUrl})`);
-    }
-    catch (err) {
-        console.log(`  Ollama: ✗ ${err instanceof Error ? err.message : String(err)}`);
-    }
-    // Check Groq
-    const groqStatus = isProviderAvailable(cfg, "groq");
-    if (groqStatus.available) {
-        try {
-            const provider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: "groq" } });
-            await provider.testConnection();
-            console.log(`  Groq: ✓ connected (${cfg.llm.groq.model})`);
-        }
-        catch (err) {
-            console.log(`  Groq: ✗ ${err instanceof Error ? err.message : String(err)}`);
+    for (const providerName of ALL_PROVIDERS) {
+        const status = isProviderAvailable(cfg, providerName);
+        if (!status.available) {
+            console.log(`  ${providerName}: — ${status.error}`);
+            continue;
         }
-    }
-    else {
-        console.log(`  Groq: — ${groqStatus.error}`);
-    }
-    // Check OpenAI
-    const openaiStatus = isProviderAvailable(cfg, "openai");
-    if (openaiStatus.available) {
         try {
-            const provider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: "openai" } });
+            const provider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: providerName } });
             await provider.testConnection();
-            console.log(`  OpenAI: ✓ connected (${cfg.llm.openai.model})`);
+            const model = getProviderModel(cfg, providerName);
+            console.log(`  ${providerName}: ✓ connected (${model})`);
         }
         catch (err) {
-            console.log(`  OpenAI: ✗ ${err instanceof Error ? err.message : String(err)}`);
+            console.log(`  ${providerName}: ✗ ${err instanceof Error ? err.message : String(err)}`);
         }
     }
-    else {
-        console.log(`  OpenAI: — ${openaiStatus.error}`);
-    }
-    // Check LM Studio
-    try {
-        const lmsProvider = getLLMProvider({ ...cfg, llm: { ...cfg.llm, defaultProvider: "lmstudio" } });
-        await lmsProvider.testConnection();
-        console.log(`  LM Studio: ✓ connected (${cfg.llm.lmstudio.model} at ${cfg.llm.lmstudio.baseUrl})`);
-    }
-    catch (err) {
-        console.log(`  LM Studio: ✗ ${err instanceof Error ? err.message : String(err)}`);
-    }
     console.log("");
     // Check embeddings
     if (stores.length > 0) {