octwin-cli 0.1.6 → 0.1.8

package/dist/index.js

@@ -7,6 +7,7 @@
  * tenant. Standalone: no platform checkout, no build step for the developer —
  * `npx octwin-cli <cmd>` (published as `octwin-cli`, command `octwin`).
  *
+ *   octwin --version | -v           # print the CLI version (+ any upgrade notice)
  *   octwin init <dir> [--id my-pack] [--description "..."] [--display-name "..."]
  *   octwin validate [--dir .] [--remote]   # --remote → the platform's FULL schema check, all errors at once
  *   octwin login   --url <platformUrl> --token oct_…
@@ -37,6 +38,17 @@ import { validatePackBundle } from './lib/validate.js';
 // level under the package root), so `../templates/starter` resolves for the
 // built CLI and `tsx` dev alike.
 const TEMPLATE_DIR = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'templates', 'starter');
+/** This CLI's version — read from its own package.json (one level up from dist/,
+ *  always shipped in the npm tarball). Falls back to '0.0.0' if unreadable. */
+const VERSION = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
+        return typeof pkg?.version === 'string' ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
 function parseFlags(argv) {
     const f = { _: [] };
     for (let i = 0; i < argv.length; i++) {
@@ -119,6 +131,78 @@ function writeCreds(map) {
     mkdirSync(join(homedir(), '.octwin'), { recursive: true });
     writeFileSync(credsPath(), JSON.stringify(map, null, 2), 'utf8');
 }
+// ── update check (daily, fail-silent, TTY-only) ──────────────────────────────
+function updateCachePath() { return join(homedir(), '.octwin', 'update-check.json'); }
+/** True when semver `a` is strictly greater than `b` (simple x.y.z compare). */
+function isNewer(a, b) {
+    const pa = a.split('.').map(n => parseInt(n, 10));
+    const pb = b.split('.').map(n => parseInt(n, 10));
+    for (let i = 0; i < 3; i++) {
+        const x = pa[i] ?? 0, y = pb[i] ?? 0;
+        if (Number.isNaN(x) || Number.isNaN(y))
+            return false;
+        if (x !== y)
+            return x > y;
+    }
+    return false;
+}
+/** The latest published `octwin-cli` version, cached for a day. Fail-silent:
+ *  returns null on any error / offline — a version check must never break a command. */
+async function latestPublishedVersion() {
+    const DAY = 24 * 60 * 60 * 1000;
+    try {
+        const cache = JSON.parse(readFileSync(updateCachePath(), 'utf8'));
+        if (cache.latest && typeof cache.checkedAt === 'number' && Date.now() - cache.checkedAt < DAY)
+            return cache.latest;
+    }
+    catch { /* no / stale cache → fetch below */ }
+    try {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), 1500);
+        const res = await fetch('https://registry.npmjs.org/octwin-cli/latest', { signal: ctrl.signal });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const latest = (await res.json()).version;
+        if (typeof latest !== 'string')
+            return null;
+        try {
+            mkdirSync(join(homedir(), '.octwin'), { recursive: true });
+            writeFileSync(updateCachePath(), JSON.stringify({ checkedAt: Date.now(), latest }), 'utf8');
+        }
+        catch { /* cache is best-effort */ }
+        return latest;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when running via `npx` — the CLI's own file lives in npx's cache dir, or npm
+ *  ran it as `npm exec`. Under npx there is no persistent install to upgrade
+ *  (`@latest` already resolves the newest), so an upgrade notice would be
+ *  misleading — stay silent. The notice is for a GLOBAL install (`npm i -g`). */
+function isNpx() {
+    try {
+        return fileURLToPath(import.meta.url).includes('_npx') || process.env.npm_command === 'exec';
+    }
+    catch {
+        return false;
+    }
+}
+/** Print a one-line upgrade notice (to stderr) when a newer octwin-cli is published.
+ *  Skipped when piped/CI (not a TTY) or run via npx (nothing to upgrade). Never throws. */
+async function notifyIfOutdated() {
+    if (!process.stdout.isTTY || isNpx())
+        return;
+    try {
+        const latest = await latestPublishedVersion();
+        if (latest && isNewer(latest, VERSION)) {
+            console.error(`\n⬆ octwin-cli ${latest} is available (you have ${VERSION}).`);
+            console.error('  Upgrade: npm i -g octwin-cli@latest   (or just use npx octwin-cli@latest)');
+        }
+    }
+    catch { /* a version check must never break the CLI */ }
+}
 // ── commands ────────────────────────────────────────────────────────────────
 function cmdInit(flags) {
     const target = flags._[0] ?? die('usage: octwin init <dir> [--id my-pack]');
@@ -643,8 +727,9 @@ async function cmdChat(flags) {
     }
 }
 function help() {
-    console.log(`octwin — Octwin external-pack developer CLI (by CEQUENS)
+    console.log(`octwin ${VERSION} — Octwin external-pack developer CLI (by CEQUENS)
 
+  octwin --version                                      # print the CLI version (+ any upgrade notice)
   octwin init <dir> [--id my-pack] [--description "..."] [--display-name "..."]
   octwin validate [--dir .] [--remote]                  # --remote runs the platform's FULL schema check (all errors at once)
   octwin login   --url <platformUrl> --token oct_…      # a deploy token from the console
@@ -698,6 +783,11 @@ async function main() {
         case 'test':
             await cmdValidate({ ...flags, remote: true });
             break; // A6: `test` = the full remote validate, not a validate-clone
+        case '-v':
+        case '--version':
+        case 'version':
+            console.log(`octwin-cli ${VERSION}`);
+            break;
         case undefined:
         case 'help':
         case '--help':
@@ -706,5 +796,6 @@ async function main() {
             break;
         default: die(`unknown command '${command}' — run \`octwin help\``);
     }
+    await notifyIfOutdated(); // trailing, fail-silent, TTY-only "newer version available" notice
 }
 main().catch((err) => die(err?.message ?? String(err)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octwin-cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
   "type": "module",
   "bin": {