@nookplot/cli 0.6.8 → 0.6.11

package/dist/utils/updateCheck.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Non-blocking CLI update checker.
+ *
+ * Checks npm registry for newer @nookplot/cli version and prints
+ * a notice to stderr if one is available. Never blocks the CLI —
+ * network fetch fires asynchronously with a short timeout.
+ *
+ * Cache: ~/.nookplot/update-check.json (24hr TTL)
+ *
+ * @module utils/updateCheck
+ */
+/**
+ * Compare two semver strings. Returns true if `a` < `b`.
+ * Only handles MAJOR.MINOR.PATCH — no prerelease/build metadata.
+ */
+export declare function isNewer(current: string, latest: string): boolean;
+/**
+ * Check for updates and print a notice if a newer version is available.
+ *
+ * This function is synchronous from the caller's perspective — it reads
+ * the cache synchronously and fires a background fetch if needed. It
+ * NEVER blocks the CLI and NEVER throws.
+ */
+export declare function checkForUpdate(currentVersion: string): void;

package/dist/utils/updateCheck.js

@@ -0,0 +1,115 @@
+/**
+ * Non-blocking CLI update checker.
+ *
+ * Checks npm registry for newer @nookplot/cli version and prints
+ * a notice to stderr if one is available. Never blocks the CLI —
+ * network fetch fires asynchronously with a short timeout.
+ *
+ * Cache: ~/.nookplot/update-check.json (24hr TTL)
+ *
+ * @module utils/updateCheck
+ */
+import fs from "fs";
+import path from "path";
+import os from "os";
+const CACHE_DIR = path.join(os.homedir(), ".nookplot");
+const CACHE_FILE = path.join(CACHE_DIR, "update-check.json");
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const FETCH_TIMEOUT_MS = 3000;
+const REGISTRY_URL = "https://registry.npmjs.org/@nookplot/cli/latest";
+/**
+ * Compare two semver strings. Returns true if `a` < `b`.
+ * Only handles MAJOR.MINOR.PATCH — no prerelease/build metadata.
+ */
+export function isNewer(current, latest) {
+    const parse = (v) => {
+        const parts = v.replace(/^v/, "").split(".");
+        return {
+            major: parseInt(parts[0], 10) || 0,
+            minor: parseInt(parts[1], 10) || 0,
+            patch: parseInt(parts[2], 10) || 0,
+        };
+    };
+    const c = parse(current);
+    const l = parse(latest);
+    if (l.major !== c.major)
+        return l.major > c.major;
+    if (l.minor !== c.minor)
+        return l.minor > c.minor;
+    return l.patch > c.patch;
+}
+/** Read the cached version data, if valid and not expired. */
+function readCache() {
+    try {
+        const raw = fs.readFileSync(CACHE_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        if (typeof data.latestVersion === "string" &&
+            typeof data.checkedAt === "number" &&
+            Date.now() - data.checkedAt < CACHE_TTL_MS) {
+            return data;
+        }
+    }
+    catch {
+        // Cache doesn't exist or is invalid
+    }
+    return null;
+}
+/** Write version data to cache. */
+function writeCache(latestVersion) {
+    try {
+        if (!fs.existsSync(CACHE_DIR)) {
+            fs.mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        fs.writeFileSync(CACHE_FILE, JSON.stringify({ latestVersion, checkedAt: Date.now() }));
+    }
+    catch {
+        // Non-critical — cache write failure is fine
+    }
+}
+/**
+ * Check for updates and print a notice if a newer version is available.
+ *
+ * This function is synchronous from the caller's perspective — it reads
+ * the cache synchronously and fires a background fetch if needed. It
+ * NEVER blocks the CLI and NEVER throws.
+ */
+export function checkForUpdate(currentVersion) {
+    try {
+        const cached = readCache();
+        if (cached) {
+            // Show notice if cached version is newer
+            if (isNewer(currentVersion, cached.latestVersion)) {
+                process.stderr.write(`\nUpdate available: @nookplot/cli ${currentVersion} → ${cached.latestVersion}\n` +
+                    `Run: npm update -g @nookplot/cli\n\n`);
+            }
+            return; // Cache is fresh, no network call needed
+        }
+        // Cache is stale or missing — fire background fetch (never await)
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        fetch(REGISTRY_URL, {
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
+        })
+            .then((res) => {
+            clearTimeout(timeout);
+            if (!res.ok)
+                return;
+            return res.json();
+        })
+            .then((data) => {
+            if (data?.version) {
+                writeCache(data.version);
+                // Don't show notice on first fetch — show on next invocation
+            }
+        })
+            .catch(() => {
+            clearTimeout(timeout);
+            // Network error — silently ignore
+        });
+    }
+    catch {
+        // Never crash the CLI
+    }
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/utils/updateCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCheck.js","sourceRoot":"","sources":["../../src/utils/updateCheck.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nookplot/cli",
-  "version": "0.6.8",
+  "version": "0.6.11",
   "description": "CLI toolkit for NookPlot agent developers — scaffold, register, sync, and monitor agents",
   "author": "nookplot",
   "type": "module",
@@ -20,10 +20,11 @@
     "build": "tsc",
     "clean": "rm -rf dist",
     "dev": "tsx src/index.ts",
+    "test": "vitest run",
     "postinstall": "node dist/postinstall.js 2>/dev/null || true"
   },
   "dependencies": {
-    "@nookplot/runtime": "^0.2.16",
+    "@nookplot/runtime": "file:../runtime",
     "chalk": "5.6.2",
     "commander": "12.1.0",
     "dotenv": "16.6.1",
@@ -37,7 +38,8 @@
     "@types/inquirer": "^9.0.7",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "20.14.10",
-    "typescript": "5.5.4"
+    "typescript": "5.5.4",
+    "vitest": "3.0.5"
   },
   "engines": {
     "node": ">=18.0.0"