gnosys 5.4.0 → 5.4.2

package/README.md

@@ -24,7 +24,7 @@
 
 Gnosys is **sandbox-first**: a persistent background process holds the database connection while agents import a tiny helper library and call memory operations like normal code — no MCP schemas, no round-trips, near-zero context cost. The central brain at `~/.gnosys/gnosys.db` unifies all projects, user preferences, and global knowledge. Federated search ranks results across scopes with tier boosting and recency awareness. The **Web Knowledge Base** turns any website into a searchable knowledge base for serverless chatbots — pre-computed JSON index, zero runtime dependencies. **Multimodal ingestion** handles PDFs, images, audio, and video. **Portfolio Dashboard** gives a bird's-eye view of all projects. Process tracing builds call chains from source code. Dream Mode consolidates knowledge during idle time. One-command export regenerates a full Obsidian vault.
 
-It also runs as a CLI and a complete MCP server that drops straight into Cursor, Claude Desktop, Claude Code, Cowork, Codex, or any MCP client.
+It also runs as a CLI and a complete MCP server that drops straight into Cursor, Claude Desktop (Chat / Cowork / Code), Claude Code, Codex, Gemini CLI, Antigravity, or any MCP client.
 
 No vector DBs. No black boxes. No external services. Just SQLite and optional Obsidian export — the way knowledge should be.
 
@@ -53,7 +53,7 @@ Gnosys takes a different approach: the central brain is a single SQLite database
 - **Bulk import** — CSV, JSON, JSONL. Import entire datasets in seconds.
 - **Obsidian-native** — `gnosys export` generates a full vault with YAML frontmatter, `[[wikilinks]]`, summaries, and graph data.
 - **Multi-machine sync (v5.3.0)** — share your `gnosys.db` across machines via NAS or shared drive. Local cache for speed, remote source of truth for consistency. Built-in conflict detection with skip-and-flag resolution. Run `gnosys remote configure` to set up.
-- **MCP-compatible** — also runs as a full MCP server that drops into Cursor, Claude Desktop, Claude Code, Cowork, Codex, or any MCP client.
+- **MCP-compatible** — also runs as a full MCP server that drops into Cursor, Claude Desktop (Chat / Cowork / Code), Claude Code, Codex, Gemini CLI, Antigravity, or any MCP client.
 - **Zero infrastructure** — no external databases, no Docker (unless you want it), no cloud services. Just `npm install`.
 
 > For the complete CLI reference and detailed guides, see the **[User Guide](https://gnosys.ai/guide.html)**.
@@ -235,9 +235,81 @@ This improves your site's visibility in AI-powered search results and enables LL
 
 ## MCP Server Setup
 
-### Claude Desktop
+The fastest way to wire gnosys into any supported client is to run `gnosys init <ide>` from the project directory you want memory-enabled. Examples:
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+```bash
+gnosys init claude-desktop   # Claude Desktop (covers Chat, Cowork, and Code)
+gnosys init claude           # Claude Code CLI
+gnosys init cursor           # Cursor
+gnosys init codex            # Codex
+gnosys init gemini-cli       # Gemini CLI
+gnosys init antigravity      # Google Antigravity
+```
+
+This does two things at once:
+1. Wires gnosys into the IDE's MCP config (idempotent — safe to re-run).
+2. Initializes the current directory as a gnosys project (creates `.gnosys/gnosys.json`, registers it in the central DB) so your memories can be scoped to it.
+
+### One-time vs. per-project
+
+The IDE wiring writes to a **user-level** config file, so it only needs to happen **once**. Re-running it in another project just re-merges the same `mcpServers.gnosys` entry — harmless.
+
+The project registration is **per-directory**: every codebase you want to be memory-aware of needs its own `gnosys init`. From then on, agents pass `projectRoot: "/path/to/project"` to gnosys MCP tools to scope memory to that codebase.
+
+```bash
+# Once, anywhere — wires Claude Desktop's MCP config:
+gnosys init claude-desktop
+
+# Once per project — registers the codebase in the central DB:
+cd /path/to/project-a && gnosys init
+cd /path/to/project-b && gnosys init
+```
+
+> **Cowork users:** Cowork sessions don't have a working directory like a CLI does. The agent in Cowork uses whichever `projectRoot` it's told to use (typically auto-detected from open files or set via the system prompt). The "every working directory" question doesn't apply to Cowork itself — only to the projects you want memory-enabled. Run `gnosys init claude-desktop` once globally; run `gnosys init` per project.
+
+---
+
+## Setup Wizards
+
+`gnosys setup` runs the full interactive wizard. To configure just one piece without walking the whole thing, use one of these subcommands:
+
+```bash
+gnosys setup           # full wizard (provider, models, IDE, remote sync, dream)
+gnosys setup models    # LLM provider + model only
+gnosys setup remote    # multi-machine sync (NAS/shared drive)
+gnosys setup dream     # Dream Mode designation, schedule, sub-tasks
+```
+
+### Dream Mode setup (v5.4.2+)
+
+Dream Mode is the idle-time consolidation engine — confidence decay, summary generation, self-critique, relationship discovery. With multi-machine sync (v5.3.0+), running dream cycles from every machine wastes work and fights for SQLite write locks. v5.4.2 introduces a **single designated machine** model:
+
+- Run `gnosys setup dream` on the machine you want to host dream cycles.
+- The wizard validates your provider/model with a live API probe before saving.
+- Other machines stay quiet — they see the designation in the central DB and skip the scheduler.
+- `gnosys dream log` shows recent runs; `gnosys dashboard` has a `DREAM HEALTH` section with last-run timestamp, designated machine, and consecutive-failure counter.
+- If the designated machine's LLM provider becomes unreachable, you'll see warnings at three layers: in audit log entries (`dream_provider_unreachable`), as stderr at MCP startup, and as a desktop notification after 3 consecutive failures.
+
+### Removed in v5.4.2
+
+The following commands were removed in favor of the canonical `gnosys setup <thing>` form:
+
+| Removed | Use instead |
+|---|---|
+| `gnosys models` | `gnosys setup models` |
+| `gnosys remote configure` | `gnosys setup remote` |
+
+`gnosys remote push|pull|sync|status` remain unchanged — only `configure` moved.
+
+---
+
+### Manual config (if you prefer)
+
+If you'd rather edit configs by hand, here's where each client looks for MCP servers.
+
+#### Claude Desktop (Chat, Cowork, and Code share the same config)
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows), or `~/.config/Claude/claude_desktop_config.json` (Linux):
 
 ```json
 {
@@ -250,9 +322,11 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-### Cursor
+Restart Claude Desktop after editing.
+
+#### Cursor
 
-Add to `.cursor/mcp.json`:
+Add to `.cursor/mcp.json` in your project:
 
 ```json
 {
@@ -265,13 +339,13 @@ Add to `.cursor/mcp.json`:
 }
 ```
 
-### Claude Code
+#### Claude Code
 
 ```bash
 claude mcp add gnosys gnosys serve
 ```
 
-### Codex
+#### Codex
 
 Add to `.codex/config.toml`:
 
@@ -281,6 +355,38 @@ type = "local"
 command = ["gnosys", "serve"]
 ```
 
+#### Gemini CLI
+
+Add to `~/.gemini/settings.json` (preserves any existing settings):
+
+```json
+{
+  "mcpServers": {
+    "gnosys": {
+      "command": "gnosys",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+#### Antigravity
+
+Add to `~/.gemini/antigravity/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gnosys": {
+      "command": "gnosys",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+Antigravity reloads MCP servers automatically when you save the file.
+
 > **Note:** API keys are configured via `gnosys setup` (macOS Keychain, environment variable, or `~/.config/gnosys/.env`). See [LLM Provider Setup](https://gnosys.ai/guide.html#guide-llm-provider-setup) in the User Guide.
 
 ---

package/dist/cli.js

@@ -503,11 +503,12 @@ setupCmd
 // `gnosys setup remote` — configure remote sync (alias for `gnosys remote configure`)
 setupCmd
     .command("remote")
-    .description("Configure multi-machine sync (alias for 'gnosys remote configure')")
+    .description("Configure multi-machine sync (NAS/shared drive)")
     .option("--path <path>", "Set remote path directly (non-interactive)")
     .action(async (opts) => {
     const { GnosysDB } = await import("./lib/db.js");
-    const db = GnosysDB.openCentral();
+    // Sync configuration needs explicit local DB access (not auto-routed remote).
+    const db = GnosysDB.openLocal();
     if (!db.isAvailable()) {
         console.error("Central DB not available.");
         db.close();
@@ -527,17 +528,18 @@ setupCmd
         db.close();
     }
 });
-// ─── gnosys models (top-level shortcut) ─────────────────────────────────
-program
-    .command("models")
-    .description("Quick model operations — list available, refresh cache, or set the default")
-    .option("--list", "List available models for the current provider")
-    .option("--refresh", "Refresh model list from OpenRouter (clears the cache)")
-    .option("--set <model>", "Set the default model for the current provider")
-    .action(async (opts) => {
-    const { runModelsCommand } = await import("./lib/setup.js");
-    await runModelsCommand(opts);
+// `gnosys setup dream` — configure dream mode (designation, provider, schedule)
+setupCmd
+    .command("dream")
+    .description("Configure Dream Mode — designate this machine, pick provider/model, set schedule")
+    .action(async () => {
+    const { runDreamSetup } = await import("./lib/setup.js");
+    await runDreamSetup({ directory: process.cwd() });
 });
+// v5.4.2 removal: `gnosys models` (top-level shortcut) was removed in favor
+// of the canonical `gnosys setup models` form. The implementation function
+// runModelsCommand() in setup.ts is no longer wired but kept for now in case
+// we need to revive a top-level shortcut later.
 // ─── gnosys init ─────────────────────────────────────────────────────────
 program
     .command("init [ide]")
@@ -1713,14 +1715,60 @@ program
     .command("graph")
     .description("Show the full cross-reference graph across all memories")
     .action(async () => {
-    const resolver = await getResolver();
-    const allMemories = await resolver.getAllMemories();
-    if (allMemories.length === 0) {
-        console.log("No memories found.");
-        return;
+    // v5.4.1: Query the central DB directly. Previously this used the
+    // filesystem resolver, which returns nothing in v5.x DB-only mode
+    // because memories no longer live as markdown files.
+    let centralDb = null;
+    try {
+        centralDb = GnosysDB.openCentral();
+        if (!centralDb.isAvailable()) {
+            console.error("Central DB not available.");
+            process.exit(1);
+        }
+        const dbMemories = centralDb.getAllMemories();
+        if (dbMemories.length === 0) {
+            console.log("No memories found.");
+            return;
+        }
+        // Adapt DbMemory → legacy Memory shape that buildLinkGraph expects.
+        // The graph builder only reads id, title, content, and synthesises
+        // a filesystem-style path for display.
+        const adapted = dbMemories.map((m) => {
+            let parsedTags = [];
+            try {
+                parsedTags = JSON.parse(m.tags);
+            }
+            catch {
+                parsedTags = [];
+            }
+            const relativePath = `${m.category}/${m.id}.md`;
+            return {
+                frontmatter: {
+                    id: m.id,
+                    title: m.title,
+                    category: m.category,
+                    tags: parsedTags,
+                    relevance: m.relevance,
+                    author: m.author,
+                    authority: m.authority,
+                    confidence: m.confidence,
+                    created: m.created,
+                    modified: m.modified,
+                    last_reviewed: m.modified,
+                    status: m.status,
+                    supersedes: m.supersedes,
+                },
+                content: m.content,
+                filePath: relativePath,
+                relativePath,
+            };
+        });
+        const graph = buildLinkGraph(adapted);
+        console.log(formatGraphSummary(graph));
+    }
+    finally {
+        centralDb?.close();
     }
-    const graph = buildLinkGraph(allMemories);
-    console.log(formatGraphSummary(graph));
 });
 // ─── gnosys bootstrap <sourceDir> ────────────────────────────────────────
 program
@@ -2541,7 +2589,8 @@ remoteCmd
     .action(async (opts) => {
     let centralDb = null;
     try {
-        centralDb = GnosysDB.openCentral();
+        // Sync operations need explicit local DB access (not auto-routed remote).
+        centralDb = GnosysDB.openLocal();
         if (!centralDb.isAvailable()) {
             console.error("Central DB not available.");
             process.exit(1);
@@ -2592,7 +2641,7 @@ remoteCmd
     .action(async (opts) => {
     let centralDb = null;
     try {
-        centralDb = GnosysDB.openCentral();
+        centralDb = GnosysDB.openLocal();
         if (!centralDb.isAvailable()) {
             console.error("Central DB not available.");
             process.exit(1);
@@ -2606,7 +2655,8 @@ remoteCmd
         const sync = new RemoteSync(centralDb, remotePath);
         const result = await sync.push({ strategy: opts.newerWins ? "newer-wins" : "skip-and-flag" });
         sync.closeRemote();
-        console.log(`Pushed: ${result.pushed} | Skipped: ${result.skipped} | Conflicts: ${result.conflicts.length}`);
+        const projParts = (result.projectsPushed || 0) > 0 ? ` | Projects pushed: ${result.projectsPushed}` : "";
+        console.log(`Pushed: ${result.pushed} | Skipped: ${result.skipped} | Conflicts: ${result.conflicts.length}${projParts}`);
         if (result.errors.length > 0) {
             console.log("\nErrors:");
             for (const e of result.errors)
@@ -2633,7 +2683,7 @@ remoteCmd
     .action(async (opts) => {
     let centralDb = null;
     try {
-        centralDb = GnosysDB.openCentral();
+        centralDb = GnosysDB.openLocal();
         if (!centralDb.isAvailable()) {
             console.error("Central DB not available.");
             process.exit(1);
@@ -2647,7 +2697,8 @@ remoteCmd
         const sync = new RemoteSync(centralDb, remotePath);
         const result = await sync.pull({ strategy: opts.newerWins ? "newer-wins" : "skip-and-flag" });
         sync.closeRemote();
-        console.log(`Pulled: ${result.pulled} | Skipped: ${result.skipped} | Conflicts: ${result.conflicts.length}`);
+        const projParts = (result.projectsPulled || 0) > 0 ? ` | Projects pulled: ${result.projectsPulled}` : "";
+        console.log(`Pulled: ${result.pulled} | Skipped: ${result.skipped} | Conflicts: ${result.conflicts.length}${projParts}`);
         if (result.errors.length > 0) {
             console.log("\nErrors:");
             for (const e of result.errors)
@@ -2670,7 +2721,7 @@ remoteCmd
     .action(async (opts) => {
     let centralDb = null;
     try {
-        centralDb = GnosysDB.openCentral();
+        centralDb = GnosysDB.openLocal();
         if (!centralDb.isAvailable()) {
             if (!opts.auto)
                 console.error("Central DB not available.");
@@ -2690,7 +2741,10 @@ remoteCmd
         });
         sync.closeRemote();
         if (!opts.auto || result.conflicts.length > 0 || result.errors.length > 0) {
-            console.log(`Pushed: ${result.pushed} | Pulled: ${result.pulled} | Conflicts: ${result.conflicts.length}`);
+            const pp = result.projectsPushed || 0;
+            const pl = result.projectsPulled || 0;
+            const projParts = (pp + pl) > 0 ? ` | Projects: ↑${pp}/↓${pl}` : "";
+            console.log(`Pushed: ${result.pushed} | Pulled: ${result.pulled} | Conflicts: ${result.conflicts.length}${projParts}`);
             if (result.errors.length > 0) {
                 console.log("\nErrors:");
                 for (const e of result.errors)
@@ -2717,7 +2771,7 @@ remoteCmd
     .action(async (memoryId, opts) => {
     let centralDb = null;
     try {
-        centralDb = GnosysDB.openCentral();
+        centralDb = GnosysDB.openLocal();
         if (!centralDb.isAvailable()) {
             console.error("Central DB not available.");
             process.exit(1);
@@ -2751,39 +2805,10 @@ remoteCmd
         centralDb?.close();
     }
 });
-remoteCmd
-    .command("configure")
-    .description("Configure or change the remote sync location (interactive wizard)")
-    .option("--path <path>", "Set remote path non-interactively (skips wizard)")
-    .option("--migrate", "Copy current local DB to remote on first setup (with --path)")
-    .action(async (opts) => {
-    let centralDb = null;
-    try {
-        centralDb = GnosysDB.openCentral();
-        if (!centralDb.isAvailable()) {
-            console.error("Central DB not available.");
-            process.exit(1);
-        }
-        const { runConfigureWizard, configureFromPath } = await import("./lib/remoteWizard.js");
-        if (opts.path) {
-            // Non-interactive mode
-            const ok = await configureFromPath(centralDb, opts.path, { migrate: opts.migrate });
-            process.exit(ok ? 0 : 1);
-        }
-        else {
-            // Interactive wizard
-            const ok = await runConfigureWizard(centralDb);
-            process.exit(ok ? 0 : 1);
-        }
-    }
-    catch (err) {
-        console.error(`Error: ${err instanceof Error ? err.message : err}`);
-        process.exit(1);
-    }
-    finally {
-        centralDb?.close();
-    }
-});
+// v5.4.2 removal: `gnosys remote configure` was removed in favor of the
+// canonical `gnosys setup remote` form (which calls the same wizard
+// helpers from lib/remoteWizard.ts). Sync operations like push/pull/sync
+// remain under the `remote` parent.
 // ─── gnosys upgrade ─────────────────────────────────────────────────────
 program
     .command("upgrade")
@@ -3275,10 +3300,12 @@ program
     }
     console.log();
 });
-// ─── gnosys dream ────────────────────────────────────────────────────────
-program
+// ─── gnosys dream (parent command) ───────────────────────────────────────
+const dreamCmd = program
     .command("dream")
-    .description("Run a Dream Mode cycle — idle-time consolidation (decay, summaries, self-critique, relationships)")
+    .description("Dream Mode — idle-time consolidation (run a cycle, view log)");
+// Bare `gnosys dream` runs a cycle now (preserves v5.4.1 behavior).
+dreamCmd
     .option("--max-runtime <minutes>", "Max runtime in minutes (default: 30)")
     .option("--no-critique", "Skip self-critique phase")
     .option("--no-summaries", "Skip summary generation")
@@ -3325,6 +3352,73 @@ program
     }
     db.close();
 });
+// `gnosys dream log` — view recent dream runs from audit_log
+dreamCmd
+    .command("log")
+    .description("Show recent dream runs from the audit log (default: last 20)")
+    .option("--last <N>", "Number of most recent runs to show", "20")
+    .option("--since <YYYY-MM-DD>", "Only runs since this date")
+    .option("--failures-only", "Only runs with errors or unreachable provider")
+    .option("--json", "Output raw audit rows as JSON")
+    .action(async function (opts) {
+    let centralDb = null;
+    try {
+        centralDb = GnosysDB.openCentral();
+        if (!centralDb.isAvailable()) {
+            console.error("Central DB not available.");
+            process.exit(1);
+        }
+        const limit = Math.max(1, parseInt(opts.last) || 20);
+        const sinceIso = opts.since ? `${opts.since}T00:00:00Z` : undefined;
+        const runs = centralDb.getRecentDreamRuns(limit, {
+            failuresOnly: !!opts.failuresOnly,
+            sinceIso,
+        });
+        // Commander v13 hoists `--json` to the parent when both parent and
+        // subcommand define it. Check the parent (dreamCmd) too so users can
+        // type `gnosys dream log --json` and get JSON output.
+        const wantJson = !!opts.json || !!(this.parent?.opts().json);
+        // JSON path always emits a structured response — including empty runs.
+        if (wantJson) {
+            console.log(JSON.stringify({ count: runs.length, runs }, null, 2));
+            return;
+        }
+        if (runs.length === 0) {
+            console.log("No dream runs recorded.");
+            return;
+        }
+        const DIM = "\x1b[2m";
+        const RESET = "\x1b[0m";
+        const RED = "\x1b[31m";
+        const GREEN = "\x1b[32m";
+        console.log(`${runs.length} dream run(s):\n`);
+        for (const r of runs) {
+            const d = r.details;
+            const dur = r.durationMs != null ? `${(r.durationMs / 1000).toFixed(1)}s` : "—";
+            const summaries = Number(d.summariesGenerated || 0);
+            const decays = Number(d.decayUpdated || 0);
+            const reviews = Number(d.reviewSuggestions || 0);
+            const rels = Number(d.relationshipsDiscovered || 0);
+            const errors = Number(d.errors || 0);
+            const unreachable = Boolean(d.providerUnreachable);
+            const status = unreachable
+                ? `${RED}provider unreachable${RESET}`
+                : errors > 0
+                    ? `${RED}${errors} error(s)${RESET}`
+                    : summaries + decays + rels > 0
+                        ? `${GREEN}did work${RESET}`
+                        : `${DIM}no LLM work${RESET}`;
+            console.log(`  ${r.completed} ${DIM}(${dur})${RESET} ${status}`);
+            console.log(`    decays=${decays} summaries=${summaries} reviews=${reviews} relations=${rels}`);
+            if (d.provider) {
+                console.log(`    ${DIM}provider=${d.provider}${d.model ? "/" + d.model : ""}${RESET}`);
+            }
+        }
+    }
+    finally {
+        centralDb?.close();
+    }
+});
 // ─── gnosys export ───────────────────────────────────────────────────────
 program
     .command("export")