@hone-ai/cli 1.17.0 → 1.18.0

package/hone-cli.js

@@ -55,8 +55,28 @@ function getConfig() {
   return { token, apiUrl };
 }
 
+// HC-019y-followup-3: module-level upgrade-warning bucket. Set by the
+// axios response interceptor when the server's X-CLI-Latest-Version
+// header reports a newer version than ours. Printed once at process
+// exit so the warning lands AFTER the command's normal output and
+// doesn't fight for attention with whatever the user is doing.
+let _outdatedWarning = null;
+
+function _compareSemverMinor(a, b) {
+  // Returns true if `a` is strictly older than `b` for major.minor.patch.
+  // Liberal-parse: anything we can't make sense of → false (don't warn).
+  const re = /^(\d+)\.(\d+)\.(\d+)/;
+  const ma = re.exec(String(a || '')), mb = re.exec(String(b || ''));
+  if (!ma || !mb) return false;
+  const [, aMaj, aMin, aPat] = ma.map(Number);
+  const [, bMaj, bMin, bPat] = mb.map(Number);
+  if (aMaj !== bMaj) return aMaj < bMaj;
+  if (aMin !== bMin) return aMin < bMin;
+  return aPat < bPat;
+}
+
 function api(config) {
-  return axios.create({
+  const client = axios.create({
     baseURL: config.apiUrl,
     headers: {
       Authorization: `Bearer ${config.token}`,
@@ -64,8 +84,35 @@ function api(config) {
     },
     timeout: 30_000,
   });
+  // HC-019y-followup-3: response interceptor reads server's
+  // X-CLI-Latest-Version, sets the upgrade-warning bucket if outdated.
+  // Fire-and-forget — never throws. Captures errors silently so a
+  // missing/malformed header can't break the command.
+  client.interceptors.response.use(
+    (response) => {
+      try {
+        const latest = response?.headers?.['x-cli-latest-version'];
+        if (latest && _compareSemverMinor(pkg.version, latest)) {
+          _outdatedWarning =
+            `  ⚠ @hone-ai/cli ${latest} is available — you have ${pkg.version}\n` +
+            `    Run: npm install -g @hone-ai/cli@latest`;
+        }
+      } catch { /* never break the response path */ }
+      return response;
+    },
+    (error) => Promise.reject(error)
+  );
+  return client;
 }
 
+// HC-019y-followup-3: emit the upgrade warning at process exit if set.
+// Wrapped in try/catch — a failed warning is fundamentally non-critical.
+process.on('exit', () => {
+  if (_outdatedWarning) {
+    try { console.error('\n' + _outdatedWarning); } catch { /* swallow */ }
+  }
+});
+
 // ── SETUP command ─────────────────────────────────────────────────────────────
 program
   .command('setup')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hone-ai/cli",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Hone AI — Enterprise SDLC Pipeline CLI",
   "main": "hone-cli.js",
   "bin": {
@@ -16,6 +16,8 @@
   "scripts": {
     "test": "echo \"No tests yet\" && exit 0",
     "link": "npm link",
+    "sync-server-cli-version": "node scripts/sync-server-cli-version.js",
+    "prepublishOnly": "node scripts/sync-server-cli-version.js",
     "postinstall": "echo '\\n  Hone AI CLI installed successfully.\\n  Next: run `hone init --token <YOUR_TOKEN>` to configure.\\n  Docs: https://github.com/subbareddyvani/hone-server\\n'"
   },
   "dependencies": {