lua-cli 3.5.0-alpha.9 → 3.5.0

package/dist/utils/version-check.js

@@ -0,0 +1,120 @@
+/**
+ * Version Check Utilities
+ * Checks npm registry for the latest lua-cli version and caches the result.
+ * Used by the update command (LUA-123) and the outdated version warning (LUA-124).
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { compareVersions, parseVersion } from './semver.js';
+const CACHE_DIR = join(homedir(), '.lua-cli');
+const CACHE_FILE = join(CACHE_DIR, 'version-check.json');
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const NPM_REGISTRY_BASE = 'https://registry.npmjs.org/lua-cli';
+const FETCH_TIMEOUT_MS = 3000;
+/**
+ * Get the npm registry URL for the appropriate dist-tag.
+ * If currentVersion has a pre-release tag (e.g. "alpha"), use that dist-tag.
+ * Otherwise use "latest" (stable releases).
+ */
+function getRegistryUrl(currentVersion) {
+    const { preRelease } = parseVersion(currentVersion);
+    if (preRelease) {
+        // Extract tag name from pre-release (e.g. "alpha.9" → "alpha", "beta.1" → "beta")
+        const tag = preRelease.split('.')[0].replace(/[0-9]/g, '');
+        if (tag)
+            return `${NPM_REGISTRY_BASE}/${tag}`;
+    }
+    return `${NPM_REGISTRY_BASE}/latest`;
+}
+/**
+ * Read cached version check result.
+ * Returns null if cache is missing, corrupt, or expired.
+ */
+export function getCachedVersionCheck() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return null;
+        const raw = readFileSync(CACHE_FILE, 'utf8');
+        const cache = JSON.parse(raw);
+        if (Date.now() - cache.checkedAt > CHECK_INTERVAL_MS)
+            return null;
+        return cache;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save version check result to cache file.
+ */
+export function saveCachedVersionCheck(latestVersion) {
+    try {
+        if (!existsSync(CACHE_DIR)) {
+            mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        writeFileSync(CACHE_FILE, JSON.stringify({ latestVersion, checkedAt: Date.now() }), 'utf8');
+    }
+    catch {
+        // Silently ignore write failures (permissions, disk full, etc.)
+    }
+}
+/**
+ * Fetch the latest version from npm registry.
+ * Uses the dist-tag matching the current version's pre-release channel (e.g. "alpha").
+ * Returns null on any failure (network, timeout, parse error).
+ */
+export async function fetchLatestVersion(currentVersion) {
+    try {
+        const url = getRegistryUrl(currentVersion ?? '0.0.0');
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if an update is available. Uses 24h cache to avoid hitting npm on every run.
+ */
+export async function isUpdateAvailable(currentVersion) {
+    const cached = getCachedVersionCheck();
+    if (cached) {
+        return {
+            available: compareVersions(currentVersion, cached.latestVersion) < 0,
+            latest: cached.latestVersion,
+        };
+    }
+    const latest = await fetchLatestVersion(currentVersion);
+    if (!latest)
+        return { available: false, latest: null };
+    saveCachedVersionCheck(latest);
+    return {
+        available: compareVersions(currentVersion, latest) < 0,
+        latest,
+    };
+}
+/**
+ * Print a boxed update warning to stderr (so piped --json stdout is not corrupted).
+ */
+export function printUpdateWarning(currentVersion, latestVersion) {
+    const msg = `Update available: ${currentVersion} → ${latestVersion}`;
+    const tip = 'Run `lua update` to install the latest version';
+    const width = Math.max(msg.length, tip.length) + 6;
+    const pad = (s) => s + ' '.repeat(width - s.length);
+    console.error('');
+    console.error(`  ╭${'─'.repeat(width)}╮`);
+    console.error(`  │${' '.repeat(width)}│`);
+    console.error(`  │${pad('   ' + msg)}│`);
+    console.error(`  │${pad('   ' + tip)}│`);
+    console.error(`  │${' '.repeat(width)}│`);
+    console.error(`  ╰${'─'.repeat(width)}╯`);
+    console.error('');
+}
+//# sourceMappingURL=version-check.js.map

package/dist/utils/version-check.js.map

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

package/docs/README.md

@@ -1,6 +1,6 @@
 # Lua CLI - Complete API Documentation
 
-Welcome to the comprehensive API documentation for lua-cli v3.5.0-alpha.9. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.5.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 
@@ -245,7 +245,7 @@ Each API doc includes:
 
 ---
 
-**Version:** 3.5.0-alpha.9
+**Version:** 3.5.0
 **Last Updated:** February 2026
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.5.0-alpha.9",
+  "version": "3.5.0",
   "description": "Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs. Features LuaAgent unified configuration, streaming chat, and batch deployment.",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.5.0-alpha.9",
+    "lua-cli": "^3.5.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"