gnosys 5.4.2 → 5.5.0

package/README.md

@@ -52,7 +52,7 @@ Gnosys takes a different approach: the central brain is a single SQLite database
 - **Reflection API** — `gnosys.reflect(outcome)` updates confidence and consolidates memories based on real-world outcomes.
 - **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.
+- **Multi-machine sync** — share your `gnosys.db` across machines via NAS or shared drive. Remote NAS is the canonical source of truth; local DB is an offline-resilience cache. Built-in conflict detection with skip-and-flag resolution. Run `gnosys setup remote` to set up.
 - **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`.
 
@@ -461,19 +461,19 @@ All memories live in a single `~/.gnosys/gnosys.db` with `project_id` and `scope
 
 ### Multi-Machine Sync
 
-Gnosys v5.3.0 supports running across multiple machines with a shared database on a NAS or network share.
+Gnosys supports running across multiple machines with a shared database on a NAS or network share.
 
 **How it works:**
-- Local DB at `~/.gnosys/gnosys.db` is your fast working cache
 - Remote DB on a network share (e.g. `/Volumes/nas/gnosys/`) is the canonical source of truth
-- Reads always hit local for speed
-- Writes go to local first, then sync to remote
-- Per-memory `modified` timestamps detect conflicts
+- Local DB at `~/.gnosys/gnosys.db` is an offline-resilience cache, not a performance optimization
+- Reads hit remote when reachable; fall back to local cache when remote is offline
+- Writes go to remote first; queue locally and auto-flush when offline
+- Per-memory `modified` timestamps detect conflicts; ULID memory IDs prevent collisions across concurrent writers
 - Skip-and-flag is the safe default; `--newer-wins` for unattended sync
 
 **Setup:**
 ```bash
-gnosys remote configure
+gnosys setup remote
 # interactive: validates path, tests SQLite locking, checks latency
 ```
 
@@ -616,7 +616,7 @@ All commands support `--json` for programmatic output. See the [User Guide](http
 
 **Web knowledge base:** `web init`, `web ingest`, `web build-index`, `web build`, `web add`, `web remove`, `web status`
 
-**Multi-machine sync:** `remote configure`, `remote status`, `remote sync`, `remote push`, `remote pull`, `remote resolve`
+**Multi-machine sync:** `remote status`, `remote sync`, `remote push`, `remote pull`, `remote resolve` (configure via `gnosys setup remote`)
 
 **Server:** `serve`, `serve --with-maintenance`
 

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();
@@ -3304,14 +3347,7 @@ program
 const dreamCmd = program
     .command("dream")
     .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")
-    .option("--no-relationships", "Skip relationship discovery")
-    .option("--json", "Output raw JSON report")
-    .action(async (opts) => {
+async function runDreamCycle(opts) {
     const resolver = new GnosysResolver();
     await resolver.resolve();
     const stores = resolver.getStores();
@@ -3321,6 +3357,7 @@ dreamCmd
     }
     const { GnosysDB: DbClass } = await import("./lib/db.js");
     const { GnosysDreamEngine, formatDreamReport } = await import("./lib/dream.js");
+    const { getMachineId } = await import("./lib/remote.js");
     const storePath = stores[0].path;
     const cfg = await loadConfig(storePath);
     const db = new DbClass(storePath);
@@ -3328,6 +3365,24 @@ dreamCmd
         console.error("Dream Mode requires gnosys.db (v2.0). Run 'gnosys migrate' first.");
         process.exit(1);
     }
+    // Designation gate — warn (and exit unless --force) if this isn't the
+    // designated dream machine. Manual runs from non-designated machines are
+    // useful for testing but shouldn't happen by accident on shared brains.
+    const centralDb = GnosysDB.openCentral();
+    if (centralDb.isAvailable()) {
+        const designated = centralDb.getDreamMachineId();
+        if (designated) {
+            const localId = getMachineId(centralDb);
+            if (designated !== localId && !opts.force) {
+                console.error(`Dream is designated to machine ${designated}, but this is ${localId}.\n` +
+                    `Pass --force to run anyway, or run 'gnosys setup dream' to redesignate.`);
+                centralDb.close();
+                db.close();
+                process.exit(1);
+            }
+        }
+        centralDb.close();
+    }
     const dreamConfig = {
         enabled: true,
         idleMinutes: 0,
@@ -3351,7 +3406,28 @@ dreamCmd
         console.log(formatDreamReport(report));
     }
     db.close();
-});
+}
+// Bare `gnosys dream` runs a cycle (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")
+    .option("--no-relationships", "Skip relationship discovery")
+    .option("--force", "Run even if this machine is not the designated dream node")
+    .option("--json", "Output raw JSON report")
+    .action(runDreamCycle);
+// `gnosys dream run` — explicit alias matching the `gnosys dream log|run`
+// pattern. Same options + behavior as the bare command.
+dreamCmd
+    .command("run")
+    .description("Force a dream cycle now (manual trigger)")
+    .option("--max-runtime <minutes>", "Max runtime in minutes (default: 30)")
+    .option("--no-critique", "Skip self-critique phase")
+    .option("--no-summaries", "Skip summary generation")
+    .option("--no-relationships", "Skip relationship discovery")
+    .option("--force", "Run even if this machine is not the designated dream node")
+    .option("--json", "Output raw JSON report")
+    .action(runDreamCycle);
 // `gnosys dream log` — view recent dream runs from audit_log
 dreamCmd
     .command("log")