noterai 0.1.2 → 0.1.3

package/bin/noter.js

@@ -11,9 +11,11 @@ import { loadConfig } from '../packages/server/dist/config.js';
 import { resolveRepoContext } from '../packages/server/dist/repoContext.js';
 import { stateManager } from '../packages/server/dist/stateManager.js';
 import { execSync } from 'child_process';
-import { resolve, dirname, basename } from 'path';
+import { request } from 'node:https';
+import { resolve, dirname, basename, join } from 'path';
+import { homedir } from 'node:os';
 import { fileURLToPath } from 'url';
-import { existsSync, readFileSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const ROOT = resolve(__dirname, '..');
@@ -30,6 +32,106 @@ function getVersion() {
     const pkg = JSON.parse(raw);
     return pkg.version ?? '0.0.1';
 }
+/** Cache path for the npm update check so we don't hit the registry on every launch. */
+const UPDATE_CACHE_DIR = process.env.NOTER_UPDATE_CACHE_DIR ?? join(homedir(), '.noter');
+const UPDATE_CACHE_FILE = join(UPDATE_CACHE_DIR, 'update-check.json');
+const UPDATE_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+const UPDATE_CHECK_TIMEOUT_MS = 2500;
+const NPM_PACKAGE = 'noterai';
+function readUpdateCache() {
+    try {
+        const raw = readFileSync(UPDATE_CACHE_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.lastChecked === 'number') {
+            return { lastChecked: parsed.lastChecked, latestVersion: parsed.latestVersion ?? null };
+        }
+    }
+    catch {
+        // ignore missing/corrupt cache
+    }
+    return null;
+}
+function writeUpdateCache(cache) {
+    try {
+        if (!existsSync(UPDATE_CACHE_DIR))
+            mkdirSync(UPDATE_CACHE_DIR, { recursive: true });
+        writeFileSync(UPDATE_CACHE_FILE, JSON.stringify(cache));
+    }
+    catch {
+        // cache is best-effort; never block launch on it
+    }
+}
+/** Fetch latest published version from the npm registry. Resolves to null on any error. */
+function fetchLatestVersion() {
+    return new Promise((resolvePromise) => {
+        let settled = false;
+        const finish = (v) => {
+            if (!settled) {
+                settled = true;
+                resolvePromise(v);
+            }
+        };
+        const timer = setTimeout(() => finish(null), UPDATE_CHECK_TIMEOUT_MS);
+        try {
+            const req = request({
+                hostname: 'registry.npmjs.org',
+                path: `/${NPM_PACKAGE}/latest`,
+                method: 'GET',
+                headers: { 'accept': 'application/json' },
+            }, (res) => {
+                let body = '';
+                res.setEncoding('utf-8');
+                res.on('data', (chunk) => { body += chunk; });
+                res.on('end', () => {
+                    clearTimeout(timer);
+                    try {
+                        const data = JSON.parse(body);
+                        finish(typeof data.version === 'string' ? data.version : null);
+                    }
+                    catch {
+                        finish(null);
+                    }
+                });
+            });
+            req.on('error', () => { clearTimeout(timer); finish(null); });
+            req.end();
+        }
+        catch {
+            clearTimeout(timer);
+            finish(null);
+        }
+    });
+}
+/** Simple semver "is b newer than a" comparator (major.minor.patch, no pre-release). */
+function isNewerVersion(current, latest) {
+    const parse = (v) => v.split('-')[0].split('.').map((n) => parseInt(n, 10) || 0);
+    const [a0, a1, a2] = parse(current);
+    const [b0, b1, b2] = parse(latest);
+    if (b0 !== a0)
+        return b0 > a0;
+    if (b1 !== a1)
+        return b1 > a1;
+    return b2 > a2;
+}
+/**
+ * Non-blocking launch-time update check. Checks the npm registry at most once per
+ * UPDATE_CACHE_TTL_MS and prints an upgrade hint if a newer version of `noterai`
+ * is published. Never throws or blocks startup.
+ */
+async function checkForUpdate() {
+    const current = getVersion();
+    const cache = readUpdateCache();
+    let latest = cache?.latestVersion ?? null;
+    const stale = !cache || Date.now() - cache.lastChecked > UPDATE_CACHE_TTL_MS;
+    if (stale) {
+        latest = await fetchLatestVersion();
+        writeUpdateCache({ lastChecked: Date.now(), latestVersion: latest });
+    }
+    if (latest && isNewerVersion(current, latest)) {
+        console.log(`update  noterai v${latest} available (you have v${current})`);
+        console.log('        run `npm install -g noterai` to upgrade');
+    }
+}
 function showHelp() {
     const version = getVersion();
     const help = `
@@ -46,6 +148,12 @@ Commands:
   help         Show this help message
   version      Print the version number
 
+Update Behavior:
+  On launch, noter checks the npm registry (at most once per 24h) for a newer
+  "noterai" release and prints an upgrade hint. Disable by deleting
+  ~/.noter/update-check.json or setting NOTER_UPDATE_CACHE_DIR. To upgrade:
+  npm install -g noterai
+
 Options:
   serve --open     Open the browser after starting the server
   serve --no-open  Do not open the browser (default for 'serve')
@@ -182,6 +290,9 @@ async function serve(openBrowser) {
     console.log(`port    ${portLine}`);
     console.log(divider);
     console.log('ready. press ctrl+c to stop.');
+    // Non-blocking update check — prints an upgrade hint if a newer noterai is on npm.
+    // Fire-and-forget so it never delays startup; output may land just after "ready".
+    void checkForUpdate();
     if (openBrowser) {
         const url = `http://localhost:${resolvedPort}`;
         const opener = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noterai",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Locally-run, browser-based AI agent dashboard for developers using LLM coding assistants",
   "type": "module",
   "license": "MIT",
@@ -28,7 +28,6 @@
   },
   "files": [
     "bin/noter.js",
-    "bin/noter.js.map",
     "packages/client/dist",
     "packages/server/dist",
     "packages/shared/dist",