@stitchdb/cli 0.2.0 → 0.3.1

package/dist/cli.js

@@ -36,10 +36,29 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
-import { spawn } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
 import { Stitch } from '@stitchdb/agent';
 const CONFIG_DIR = path.join(os.homedir(), '.stitch');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const UPDATE_CACHE = path.join(CONFIG_DIR, 'update-check.json');
+// Embedded at build time from package.json, but keeps a fallback if the file's
+// not next to the bundle (e.g. published tarball layout).
+const CLI_VERSION = readSelfVersion() ?? '0.0.0';
+function readSelfVersion() {
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        for (const candidate of [path.join(here, '..', 'package.json'), path.join(here, 'package.json')]) {
+            if (fs.existsSync(candidate)) {
+                const pkg = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+                if (pkg.name === '@stitchdb/cli' && typeof pkg.version === 'string')
+                    return pkg.version;
+            }
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
 function loadConfig() {
     try {
         return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
@@ -421,6 +440,85 @@ function readStdinAll() {
         process.stdin.on('end', () => resolve(data.trim()));
     });
 }
+function loadUpdateCache() {
+    try {
+        return JSON.parse(fs.readFileSync(UPDATE_CACHE, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function saveUpdateCache(c) {
+    try {
+        if (!fs.existsSync(CONFIG_DIR))
+            fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+        fs.writeFileSync(UPDATE_CACHE, JSON.stringify(c));
+    }
+    catch { /* ignore */ }
+}
+function semverGt(a, b) {
+    const pa = a.split('.').map((x) => parseInt(x, 10) || 0);
+    const pb = b.split('.').map((x) => parseInt(x, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] ?? 0) > (pb[i] ?? 0))
+            return true;
+        if ((pa[i] ?? 0) < (pb[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+/**
+ * Best-effort fetch of the latest published version. Cached for 6h so we don't
+ * hammer npm. Runs after the user's command is done and prints a one-line
+ * notice if an update is available. Never blocks, never errors loudly.
+ */
+async function maybeNotifyUpdate() {
+    if (process.env.STITCH_NO_UPDATE_CHECK === '1')
+        return;
+    try {
+        const cache = loadUpdateCache();
+        const fresh = cache && Date.now() - cache.checkedAt < 6 * 3600_000;
+        let latest = fresh ? cache.latest : '';
+        if (!fresh) {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), 1500);
+            try {
+                const res = await fetch('https://registry.npmjs.org/@stitchdb/cli/latest', { signal: ctrl.signal });
+                if (res.ok) {
+                    const j = await res.json();
+                    if (j.version)
+                        latest = j.version;
+                    saveUpdateCache({ checkedAt: Date.now(), latest });
+                }
+            }
+            finally {
+                clearTimeout(t);
+            }
+        }
+        if (latest && semverGt(latest, CLI_VERSION)) {
+            const msg = `\n  Stitch CLI ${latest} is available (you have ${CLI_VERSION}). Run: stitch update\n`;
+            process.stderr.write(msg);
+        }
+    }
+    catch { /* never let the check break a real command */ }
+}
+async function cmdUpdate(args) {
+    const channel = parseFlag(args, ['--tag']) || 'latest';
+    console.log(`Updating @stitchdb/cli (current: ${CLI_VERSION}) → ${channel}…`);
+    // Use the user's npm. Try `npm i -g @stitchdb/cli@latest` first; if that
+    // fails with EACCES, retry under sudo.
+    const cmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const result = spawnSync(cmd, ['install', '-g', `@stitchdb/cli@${channel}`], { stdio: 'inherit' });
+    if (result.status !== 0) {
+        console.error('\nUpdate failed. Try one of:');
+        console.error(`  npm install -g @stitchdb/cli@${channel}`);
+        console.error(`  sudo npm install -g @stitchdb/cli@${channel}`);
+        process.exit(result.status ?? 1);
+    }
+    // Reset the cache so we don't nag with the version we just installed.
+    saveUpdateCache({ checkedAt: Date.now(), latest: '0.0.0' });
+    console.log('\nUpdated. Open a fresh shell or run `which stitch` to verify.');
+}
 // ── One-shot install: MCP server + auto-log hooks + project CLAUDE.md ─────
 async function cmdInstall(args) {
     const cfg = loadConfig();
@@ -683,6 +781,9 @@ function help() {
   stitch whoami                               Show the configured key.
   stitch logout
 
+  stitch update                               Update to the latest @stitchdb/cli.
+  stitch version                              Print the installed version.
+
   stitch install [--no-mcp] [--no-hooks] [--no-claude-md]
                                               One-shot: register Stitch as an MCP
                                               server in Claude Code, wire up auto-log
@@ -721,6 +822,14 @@ async function main(argv) {
             case 'recall': return cmdRecall(rest);
             case 'thread': return cmdThread(rest);
             case 'install': return cmdInstall(rest);
+            case 'update':
+            case 'upgrade': return cmdUpdate(rest);
+            case 'version':
+            case '--version':
+            case '-v': {
+                console.log(CLI_VERSION);
+                return;
+            }
             case 'workspace':
             case 'ws': return cmdWorkspace(rest);
             case 'agent': return cmdAgent(rest);
@@ -741,4 +850,4 @@ async function main(argv) {
         process.exit(1);
     }
 }
-main(process.argv.slice(2));
+main(process.argv.slice(2)).then(() => maybeNotifyUpdate());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stitchdb/cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Stitch CLI — manage memory + run agents from your terminal",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
   "license": "MIT",
   "engines": { "node": ">=20" },
   "dependencies": {
-    "@stitchdb/agent": "^0.1.0"
+    "@stitchdb/agent": "^0.1.1"
   },
   "devDependencies": {
     "typescript": "^5.4.0",