@theholocron/cli 2.0.0-alpha.74 → 2.0.0-alpha.75

package/dist/cli.mjs

@@ -16,6 +16,7 @@ import { execFile, execFileSync, spawnSync } from "node:child_process";
 import { access, copyFile, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { pathToFileURL } from "node:url";
 import { promisify } from "node:util";
+import { homedir } from "node:os";
 //#region src/capabilities/index.ts
 const CARDINALITY = {
 	source: "single",
@@ -4113,6 +4114,118 @@ function parseTokenArgs(tokens) {
 	return result;
 }
 //#endregion
+//#region src/update-notifier.ts
+const PACKAGE_NAME = "@theholocron/cli";
+const CACHE_TTL_MS = 1440 * 60 * 1e3;
+const FETCH_TIMEOUT_MS = 3e3;
+function getCacheDir() {
+	return process.env["HOLOCRON_CACHE_DIR"] ?? join(homedir(), ".cache", "holocron");
+}
+function getCachePath() {
+	return join(getCacheDir(), "update-check.json");
+}
+function readCache() {
+	try {
+		return JSON.parse(readFileSync(getCachePath(), "utf8"));
+	} catch {
+		return null;
+	}
+}
+function writeCache(entry) {
+	try {
+		mkdirSync(getCacheDir(), { recursive: true });
+		writeFileSync(getCachePath(), JSON.stringify(entry));
+	} catch {}
+}
+async function fetchLatestVersion(channel) {
+	try {
+		const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(PACKAGE_NAME)}`, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+		if (!res.ok) return null;
+		const data = await res.json();
+		return data["dist-tags"][channel] ?? data["dist-tags"]["latest"] ?? null;
+	} catch {
+		return null;
+	}
+}
+function getChannel(version) {
+	return /^[^-]+-([a-zA-Z]+)/.exec(version)?.[1] ?? "latest";
+}
+function isUpdateAvailable(current, latest) {
+	const normalize = (v) => v.replace(/^v/, "");
+	const c = normalize(current);
+	const l = normalize(latest);
+	if (c === l) return false;
+	const splitPre = (v) => {
+		const idx = v.indexOf("-");
+		return idx === -1 ? [v, ""] : [v.slice(0, idx), v.slice(idx + 1)];
+	};
+	const [cRelease, cPre] = splitPre(c);
+	const [lRelease, lPre] = splitPre(l);
+	const parseRelease = (r) => r.split(".").map(Number);
+	const cParts = parseRelease(cRelease);
+	const lParts = parseRelease(lRelease);
+	for (let i = 0; i < Math.max(cParts.length, lParts.length); i++) {
+		const cv = cParts[i] ?? 0;
+		const lv = lParts[i] ?? 0;
+		if (lv > cv) return true;
+		if (lv < cv) return false;
+	}
+	if (!lPre && cPre) return true;
+	if (lPre && !cPre) return false;
+	const cPreParts = cPre.split(".");
+	const lPreParts = lPre.split(".");
+	for (let i = 0; i < Math.max(cPreParts.length, lPreParts.length); i++) {
+		const cv = cPreParts[i] ?? "";
+		const lv = lPreParts[i] ?? "";
+		const cvNum = Number(cv);
+		const lvNum = Number(lv);
+		if (!isNaN(cvNum) && !isNaN(lvNum)) {
+			if (lvNum > cvNum) return true;
+			if (lvNum < cvNum) return false;
+		} else {
+			if (lv > cv) return true;
+			if (lv < cv) return false;
+		}
+	}
+	return false;
+}
+function formatNotice(current, latest) {
+	const installCmd = `npm install -g ${PACKAGE_NAME}`;
+	const raw1 = `Update available: ${current} → ${latest}`;
+	const raw2 = `Run ${installCmd} to update`;
+	const width = Math.max(raw1.length, raw2.length) + 4;
+	const bar = chalk.yellow("─".repeat(width));
+	const border = chalk.yellow("│");
+	const pad = (raw, styled) => `${border} ${styled}${" ".repeat(width - 2 - raw.length)} ${border}`;
+	return [
+		"",
+		chalk.yellow(`╭${bar}╮`),
+		pad(raw1, `Update available: ${chalk.dim(current)} → ${chalk.green(latest)}`),
+		pad(raw2, `Run ${chalk.cyan(installCmd)} to update`),
+		chalk.yellow(`╰${bar}╯`),
+		""
+	].join("\n");
+}
+async function checkForUpdates(currentVersion) {
+	if (process.env["CI"] || process.env["NO_UPDATE_NOTIFIER"]) return null;
+	const channel = getChannel(currentVersion);
+	const cache = readCache();
+	const now = Date.now();
+	let latestVersion = null;
+	if (cache && now - cache.checkedAt < CACHE_TTL_MS) latestVersion = cache.latestVersion;
+	else {
+		latestVersion = await fetchLatestVersion(channel);
+		if (latestVersion) writeCache({
+			latestVersion,
+			checkedAt: now
+		});
+	}
+	if (!latestVersion || !isUpdateAvailable(currentVersion, latestVersion)) return null;
+	return () => {
+		process.stderr.write(formatNotice(currentVersion, latestVersion) + "\n");
+	};
+}
+//#endregion
 //#region src/cli.ts
 const { version: CLI_VERSION } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 /** Parses --token values and returns the context spread, or null on parse error (exits with code 1). */
@@ -4129,6 +4242,7 @@ function tokenContext(rawTokens) {
 		throw err;
 	}
 }
+const updateCheckPromise = checkForUpdates(CLI_VERSION);
 await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [options]").option("dry-run", {
 	type: "boolean",
 	default: false,
@@ -4491,6 +4605,7 @@ await yargs(hideBin(process.argv)).scriptName("holocron").usage("$0 <command> [o
 }).command("list", "List every provider with a stored bootstrap token", () => {}, async () => {
 	await runAuthList();
 }).demandCommand(1, "Run `holocron auth --help` to see available auth subcommands."), () => {}).demandCommand(1, "Run `holocron --help` to see available commands.").strict().help().parse();
+(await updateCheckPromise)?.();
 /**
 * Parse `--scope` strings: `repo` | `env=NAME` | `org=NAME`.
 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "2.0.0-alpha.74",
+  "version": "2.0.0-alpha.75",
   "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",