gnosys 5.4.1 → 5.4.3

package/README.md

@@ -269,6 +269,40 @@ cd /path/to/project-b && gnosys init
 
 ---
 
+## 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.

package/dist/cli.js

@@ -65,6 +65,49 @@ const __dirname = path.dirname(__filename);
 const pkgPath = path.resolve(__dirname, "..", "package.json");
 const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
 const program = new Command();
+/**
+ * v5.4.3 upgrade nudge — runs once per CLI invocation. If the installed
+ * version differs from the last-seen one stored in central DB meta, print
+ * a one-line stderr nudge so the user knows to run `gnosys upgrade`.
+ *
+ * Why stderr: doesn't pollute stdout consumers (agents parsing JSON, scripts
+ * piping the output). Visible to humans, invisible to most parsers.
+ *
+ * Why central DB meta: survives across CLI invocations and works whether
+ * gnosys is installed globally, locally, or via npx. Single source of truth
+ * for "what was the last version this user saw."
+ *
+ * Skipped when:
+ *   - GNOSYS_SKIP_UPGRADE_NUDGE=1
+ *   - Running `gnosys upgrade` itself (would be redundant)
+ *   - Central DB unavailable (graceful — never blocks the actual command)
+ */
+function maybePrintUpgradeNudge() {
+    if (process.env.GNOSYS_SKIP_UPGRADE_NUDGE === "1")
+        return;
+    // Avoid printing the nudge when the user is already running upgrade.
+    if (process.argv[2] === "upgrade")
+        return;
+    try {
+        const db = GnosysDB.openLocal();
+        if (!db.isAvailable() || !db.isMigrated()) {
+            db.close();
+            return;
+        }
+        const seen = db.getMeta("last_seen_version");
+        const current = pkg.version;
+        if (seen !== current) {
+            const prefix = seen ? `upgraded to v${current} (from v${seen})` : `installed v${current}`;
+            process.stderr.write(`gnosys: ${prefix}. Run 'gnosys upgrade' to sync registered projects.\n`);
+            db.setMeta("last_seen_version", current);
+        }
+        db.close();
+    }
+    catch {
+        // Never block actual commands — silently skip on any error.
+    }
+}
+maybePrintUpgradeNudge();
 async function getResolver() {
     const resolver = new GnosysResolver();
     await resolver.resolve();
@@ -503,7 +546,7 @@ 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");
@@ -528,17 +571,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]")
@@ -2804,39 +2848,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.openLocal();
-        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")
@@ -3328,10 +3343,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")
@@ -3378,6 +3395,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")