neon 5.0.0 → 6.0.0

package/dist/init/wizard.js

@@ -1,96 +1,254 @@
+import { CONFIG_INIT_SERVICES } from "../config_template.js";
+import { InitCancelled, restoreCursorVisibilityOnAbort } from "./cancelled.js";
+import { AGENT_DETECTED_DESCRIPTION, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, PACKAGE_MANAGER_MESSAGE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE } from "./copy.js";
+import { installedPackageManagers } from "../utils/package_manager.js";
+import { POSTGRES_SERVICE_CHOICE, keepPostgresSelected } from "../utils/service_picker.js";
+import { getAgentDisplayName, listMcpAgentIds } from "../mcp/agents.js";
 import { INIT_NEEDS_YES_OR_TERMINAL } from "./plan.js";
-import { SKIP_TEMPLATE_VALUE, formatTemplateTitle } from "./template_title.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { NEON_PLUGIN_NAME } from "../plugins/run.js";
+import { NEON_SKILL_CATALOG, listSkillIds } from "../skills/catalog.js";
 import chalk from "chalk";
 import prompts from "prompts";
 //#region src/init/wizard.ts
 const restoreCursorOnAbort = (state) => {
-	if (state.aborted) {
-		process.stdout.write("\x1B[?25h");
-		process.stdout.write("\n");
-		process.exit(1);
-	}
+	restoreCursorVisibilityOnAbort(state);
 };
 const requireInteractive = () => {
 	if (!canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
 };
+const aborted = () => {
+	throw new InitCancelled();
+};
+const pickInitModeInteractively = async () => {
+	requireInteractive();
+	const { mode } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "mode",
+		message: MODE_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: MODE_RECOMMENDED_TITLE,
+			value: "recommended",
+			description: MODE_RECOMMENDED_DESCRIPTION
+		}, {
+			title: MODE_CUSTOM_TITLE,
+			value: "custom",
+			description: MODE_CUSTOM_DESCRIPTION
+		}]
+	});
+	if (mode !== "recommended" && mode !== "custom") return aborted();
+	return mode;
+};
 const pickAgentSetupInteractively = async () => {
 	requireInteractive();
 	const { setup } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "select",
 		name: "setup",
-		message: "How would you like to set up your coding agents?",
+		message: AGENT_SETUP_MESSAGE,
 		initial: 0,
 		choices: [
 			{
-				title: "Neon plugin (recommended)",
+				title: AGENT_SETUP_PLUGIN_TITLE,
 				value: "plugin",
-				description: `Install ${NEON_PLUGIN_NAME} (skills and MCP together)`
+				description: AGENT_SETUP_PLUGIN_DESCRIPTION
 			},
 			{
-				title: "Skills and MCP separately",
+				title: AGENT_SETUP_SKILLS_TITLE,
 				value: "skills-mcp",
-				description: "Install skills, then the MCP server"
+				description: AGENT_SETUP_SKILLS_DESCRIPTION
 			},
 			{
-				title: "Skip agent setup",
+				title: AGENT_SETUP_SKIP_TITLE,
 				value: "skip",
-				description: "Continue to project setup"
+				description: AGENT_SETUP_SKIP_DESCRIPTION
 			}
 		]
 	});
-	if (setup !== "plugin" && setup !== "skills-mcp" && setup !== "skip") throw new Error("Aborted.");
+	if (setup !== "plugin" && setup !== "skills-mcp" && setup !== "skip") return aborted();
 	return setup;
 };
-/** First catalog template; skip is index 0 so it stays on the first screen. */
-const INIT_TEMPLATE_PICKER_INITIAL = 1;
-const initTemplatePickerChoices = (templates) => {
-	if (templates.length === 0) throw new Error("No templates available to scaffold from.");
-	return [{
-		title: "Skip the template",
-		value: SKIP_TEMPLATE_VALUE,
-		description: "Set up agents and link a Neon project without copying template files."
-	}, ...templates.map((template) => ({
-		title: formatTemplateTitle(template),
-		value: template.id,
-		description: template.description ?? ""
-	}))];
+const pickInitAgentsInteractively = async (input) => {
+	requireInteractive();
+	if (input.available.length === 0) throw new Error("No coding agents are available to pick.");
+	const detected = new Set(input.detected);
+	const { agents } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "multiselect",
+		name: "agents",
+		message: AGENT_PICKER_MESSAGE,
+		instructions: false,
+		min: 1,
+		choices: input.available.map((id) => ({
+			value: id,
+			title: `${getAgentDisplayName(id)} (${id})`,
+			description: detected.has(id) ? AGENT_DETECTED_DESCRIPTION : AGENT_OTHER_DESCRIPTION,
+			selected: detected.has(id)
+		}))
+	});
+	if (!Array.isArray(agents)) return aborted();
+	return agents.filter((id) => typeof id === "string");
+};
+const pickInitSkillsInteractively = async () => {
+	requireInteractive();
+	const { skills } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "multiselect",
+		name: "skills",
+		message: SKILLS_PICKER_MESSAGE,
+		instructions: false,
+		min: 1,
+		choices: NEON_SKILL_CATALOG.map((entry) => ({
+			value: entry.skill,
+			title: entry.skill,
+			selected: entry.defaultSelected
+		}))
+	});
+	if (!Array.isArray(skills)) return aborted();
+	const allowed = new Set(listSkillIds());
+	return skills.filter((skill) => typeof skill === "string" && allowed.has(skill));
+};
+const pickInitMcpConfigLocationInteractively = async () => {
+	requireInteractive();
+	const { scope } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "scope",
+		message: MCP_SCOPE_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: MCP_SCOPE_GLOBAL_TITLE,
+			value: "global",
+			description: MCP_SCOPE_GLOBAL_DESCRIPTION
+		}, {
+			title: MCP_SCOPE_PROJECT_TITLE,
+			value: "project",
+			description: MCP_SCOPE_PROJECT_DESCRIPTION
+		}]
+	});
+	if (scope !== "global" && scope !== "project") return aborted();
+	return scope;
+};
+const pickInitMcpAuthInteractively = async (input) => {
+	requireInteractive();
+	const { auth } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "auth",
+		message: MCP_AUTH_MESSAGE,
+		initial: input.authenticated ? 1 : 0,
+		choices: [{
+			title: MCP_AUTH_OAUTH_TITLE,
+			value: "oauth",
+			description: MCP_AUTH_OAUTH_DESCRIPTION
+		}, {
+			title: MCP_AUTH_API_KEY_TITLE,
+			value: "api-key",
+			description: MCP_AUTH_API_KEY_DESCRIPTION
+		}]
+	});
+	if (auth !== "oauth" && auth !== "api-key") return aborted();
+	return auth;
 };
-const pickInitTemplateInteractively = async (templates) => {
+const pickInitProjectSetupInteractively = async () => {
 	requireInteractive();
-	const choices = initTemplatePickerChoices(templates);
-	const { id } = await prompts({
+	const { setup } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "select",
-		name: "id",
-		message: "How would you like to set up this directory?",
-		initial: 1,
-		choices
+		name: "setup",
+		message: PROJECT_SETUP_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: PROJECT_SETUP_LINK_TITLE,
+			value: "link",
+			description: PROJECT_SETUP_LINK_DESCRIPTION
+		}, {
+			title: PROJECT_SETUP_CLAIMABLE_TITLE,
+			value: "claimable",
+			description: PROJECT_SETUP_CLAIMABLE_DESCRIPTION
+		}]
 	});
-	if (id === "skip") return { kind: "skip" };
-	if (typeof id !== "string" || id.length === 0) throw new Error("Aborted.");
-	const selected = templates.find((template) => template.id === id);
-	if (selected === void 0) throw new Error("Aborted.");
-	return {
-		kind: "template",
-		template: selected
-	};
+	if (setup !== "link" && setup !== "claimable") return aborted();
+	return setup;
 };
 const pickInitConfigInteractively = async () => {
 	requireInteractive();
-	process.stdout.write(`${chalk.dim("Choose services, then edit neon.ts and apply changes with neon config apply.")}\n`);
+	process.stdout.write(`${chalk.dim(CONFIG_CONFIRM_HINT)}\n`);
 	const { value } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "confirm",
 		name: "value",
-		message: "Create neon.ts to manage this project's Neon setup as code?",
+		message: CONFIG_CONFIRM_MESSAGE,
 		initial: true
 	});
-	if (value === void 0) throw new Error("Aborted.");
+	if (value === void 0) return aborted();
 	return value === true;
 };
+const pickInitServicesInteractively = async () => {
+	requireInteractive();
+	process.stdout.write(`${chalk.dim(SERVICES_HINT)}\n`);
+	const { services } = await prompts({
+		onState: restoreCursorOnAbort,
+		onRender() {
+			keepPostgresSelected(this);
+		},
+		type: "multiselect",
+		name: "services",
+		message: SERVICES_MESSAGE,
+		instructions: false,
+		cursor: 1,
+		choices: [
+			POSTGRES_SERVICE_CHOICE,
+			{
+				value: "auth",
+				title: "Managed Better Auth",
+				description: "Declare managed authentication for users and sessions."
+			},
+			{
+				value: "data-api",
+				title: "Data API",
+				description: "Declare an HTTP API for Postgres. Also declares Managed Better Auth."
+			},
+			{
+				value: "functions",
+				title: "Functions",
+				description: "Declare a hello function and add its source file."
+			},
+			{
+				value: "object-storage",
+				title: "Object Storage",
+				description: "Declare a private S3-compatible bucket named assets."
+			},
+			{
+				value: "ai-gateway",
+				title: "AI Gateway",
+				description: "Declare AI Gateway access. Requires an eligible Neon plan."
+			}
+		]
+	});
+	if (!Array.isArray(services)) return aborted();
+	return CONFIG_INIT_SERVICES.filter((service) => services.includes(service));
+};
+const pickInitPackageManagerInteractively = async () => {
+	requireInteractive();
+	const available = installedPackageManagers();
+	if (available.length <= 1) return available[0];
+	const initial = Math.max(0, available.indexOf("npm"));
+	const { pm } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "pm",
+		message: PACKAGE_MANAGER_MESSAGE,
+		initial,
+		choices: available.map((id) => ({
+			title: id,
+			value: id
+		}))
+	});
+	if (pm !== "npm" && pm !== "pnpm" && pm !== "yarn" && pm !== "bun") return aborted();
+	return pm;
+};
 const pickInitLinkInteractively = async () => {
 	requireInteractive();
 	const { value } = await prompts({
@@ -100,8 +258,9 @@ const pickInitLinkInteractively = async () => {
 		message: "Link this project to a Neon project now?",
 		initial: true
 	});
-	if (value === void 0) throw new Error("Aborted.");
+	if (value === void 0) return aborted();
 	return value === true;
 };
+const initAgentIds = () => listMcpAgentIds();
 //#endregion
-export { INIT_TEMPLATE_PICKER_INITIAL, initTemplatePickerChoices, pickAgentSetupInteractively, pickInitConfigInteractively, pickInitLinkInteractively, pickInitTemplateInteractively };
+export { initAgentIds, pickAgentSetupInteractively, pickInitAgentsInteractively, pickInitConfigInteractively, pickInitLinkInteractively, pickInitMcpAuthInteractively, pickInitMcpConfigLocationInteractively, pickInitModeInteractively, pickInitPackageManagerInteractively, pickInitProjectSetupInteractively, pickInitServicesInteractively, pickInitSkillsInteractively };

package/dist/mcp/wizard.js

@@ -1,4 +1,3 @@
-import { getAgentDisplayName } from "./agents.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import prompts from "prompts";
 //#region src/mcp/wizard.ts
@@ -62,30 +61,5 @@ const pickMcpProjectPin = async (linkedProjectId, willMintKey = false) => {
 	});
 	return pin === true;
 };
-const mcpInstallSummary = (options) => {
-	const agents = options.install.map(getAgentDisplayName).join(", ");
-	const auth = options.auth === "oauth" ? "OAuth, agent signs in on first use" : options.reuse ? "reuse the API key already in agent config" : options.mintProjectId ? `mint an API key limited to ${options.mintProjectId}` : "mint an account-wide API key that reaches every organization";
-	const rows = [
-		["Config", options.scope === "project" ? "this directory" : "user-level"],
-		["Agents", agents],
-		["Auth", auth],
-		["URL", options.url]
-	];
-	if (options.skipped.length > 0) rows.push(["Skipped", options.skipped.map((row) => `${getAgentDisplayName(row.agent)} (${row.error})`).join("; ")]);
-	const labelWidth = Math.max(...rows.map(([label]) => label.length));
-	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
-};
-const confirmMcpInstall = async (options) => {
-	if (!canPickAgentsInteractively()) return true;
-	process.stdout.write(`\n${mcpInstallSummary(options)}\n\n`);
-	const { ok } = await prompts({
-		onState: restoreCursorOnAbort,
-		type: "confirm",
-		name: "ok",
-		message: "Write the Neon MCP server into these agents?",
-		initial: true
-	});
-	return ok === true;
-};
 //#endregion
-export { confirmMcpInstall, mcpInstallSummary, pickMcpAuth, pickMcpProjectPin, pickMcpScope };
+export { pickMcpAuth, pickMcpProjectPin, pickMcpScope };

package/dist/skills/wizard.js

@@ -1,5 +1,3 @@
-import { getAgentDisplayName } from "../mcp/agents.js";
-import "../init/agents.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_SKILL_CATALOG } from "./catalog.js";
 import prompts from "prompts";
@@ -34,28 +32,6 @@ const isSkillEntry = (value) => {
 	if (!("source" in value) || !("skill" in value)) return false;
 	return typeof value.source === "string" && typeof value.skill === "string" && value.source.length > 0 && value.skill.length > 0;
 };
-const skillsInstallSummary = (options) => {
-	const skills = options.invocations.flatMap((invocation) => invocation.skills).join(", ");
-	const rows = [
-		["Config", options.scope === "project" ? "this directory" : "user-level"],
-		["Agents", options.agents.map(getAgentDisplayName).join(", ")],
-		["Skills", skills]
-	];
-	const labelWidth = Math.max(...rows.map(([label]) => label.length));
-	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
-};
-const confirmSkillsInstall = async (options) => {
-	if (!canPickAgentsInteractively()) return true;
-	process.stdout.write(`\n${skillsInstallSummary(options)}\n\n`);
-	const { ok } = await prompts({
-		onState: restoreCursorOnAbort,
-		type: "confirm",
-		name: "ok",
-		message: "Write Neon agent skills into these agents?",
-		initial: true
-	});
-	return ok === true;
-};
 const confirmSkillsUpdate = async (options) => {
 	if (!canPickAgentsInteractively()) return true;
 	const config = options.scope === "project" ? "this directory" : "user-level";
@@ -70,4 +46,4 @@ const confirmSkillsUpdate = async (options) => {
 	return ok === true;
 };
 //#endregion
-export { confirmSkillsInstall, confirmSkillsUpdate, pickSkillsInteractively, skillsInstallSummary };
+export { confirmSkillsUpdate, pickSkillsInteractively };

package/dist/test_utils/npm_env.js

@@ -0,0 +1,26 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+//#region src/test_utils/npm_env.ts
+const isNpmEnvKey = (key) => {
+	const lower = key.toLowerCase();
+	return lower.startsWith("npm_config_") || lower === "node_auth_token" || lower === "npm_token";
+};
+/**
+* Keep registry auth when a test replaces HOME. Isolated agent detection
+* otherwise drops ~/.npmrc and `npx`/skills fail with E401 or hang.
+*/
+const npmEnvForIsolatedHome = () => {
+	const env = {};
+	for (const [key, value] of Object.entries(process.env)) {
+		if (value === void 0 || !isNpmEnvKey(key)) continue;
+		env[key] = value;
+	}
+	if (env.npm_config_userconfig === void 0 && env.NPM_CONFIG_USERCONFIG === void 0) {
+		const src = join(homedir(), ".npmrc");
+		if (existsSync(src)) env.npm_config_userconfig = src;
+	}
+	return env;
+};
+//#endregion
+export { npmEnvForIsolatedHome };

package/dist/update_check_worker.js

@@ -0,0 +1,47 @@
+import { recordLatestVersion } from "./update_notifier.js";
+import { promisify } from "node:util";
+import { pathToFileURL } from "node:url";
+import { execFile } from "node:child_process";
+//#region src/update_check_worker.ts
+const execFileAsync = promisify(execFile);
+const LOOKUP_TIMEOUT_MS = 5e3;
+const npmViewInvocation = (platform) => ({
+	args: [
+		"view",
+		"neon",
+		"version",
+		"--json"
+	],
+	command: platform === "win32" ? "npm.cmd" : "npm",
+	shell: platform === "win32"
+});
+const npmLatestVersion = async () => {
+	const invocation = npmViewInvocation(process.platform);
+	const { stdout } = await execFileAsync(invocation.command, invocation.args, {
+		encoding: "utf8",
+		shell: invocation.shell,
+		timeout: LOOKUP_TIMEOUT_MS,
+		windowsHide: true
+	});
+	const value = JSON.parse(stdout);
+	return typeof value === "string" ? value : void 0;
+};
+const homebrewLatestVersion = async () => {
+	const response = await fetch("https://formulae.brew.sh/api/formula/neonctl.json", { signal: AbortSignal.timeout(LOOKUP_TIMEOUT_MS) });
+	if (!response.ok) return void 0;
+	const value = await response.json();
+	if (typeof value !== "object" || value === null || !("versions" in value) || typeof value.versions !== "object" || value.versions === null || !("stable" in value.versions) || typeof value.versions.stable !== "string") return;
+	return value.versions.stable;
+};
+const run = async () => {
+	const [cachePath, source] = process.argv.slice(2);
+	if (cachePath === void 0 || source !== "homebrew" && source !== "npm") return;
+	try {
+		const latestVersion = source === "homebrew" ? await homebrewLatestVersion() : await npmLatestVersion();
+		if (latestVersion !== void 0) recordLatestVersion(cachePath, source, latestVersion);
+	} catch {}
+};
+const entry = process.argv[1];
+if (entry !== void 0 && import.meta.url === pathToFileURL(entry).href) run();
+//#endregion
+export { npmViewInvocation };

package/dist/update_notifier.js

@@ -0,0 +1,145 @@
+import { isCi } from "./env.js";
+import { log } from "./log.js";
+import { recommendedCliUpgradeCommand } from "./utils/package_manager.js";
+import { existsSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import semver from "semver";
+//#region src/update_notifier.ts
+const CHECK_INTERVAL_MS = 864e5;
+const NOTIFY_INTERVAL_MS = 3 * CHECK_INTERVAL_MS;
+const CACHE_FILE = "update-check.json";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseUpdateCheckCache = (raw) => {
+	try {
+		const value = JSON.parse(raw);
+		if (!isRecord(value) || typeof value.checkedAt !== "number" || !Number.isFinite(value.checkedAt) || value.source !== "homebrew" && value.source !== "npm" || value.latestVersion !== void 0 && typeof value.latestVersion !== "string" || value.notifiedAt !== void 0 && (typeof value.notifiedAt !== "number" || !Number.isFinite(value.notifiedAt))) return;
+		return {
+			checkedAt: value.checkedAt,
+			source: value.source,
+			...value.latestVersion === void 0 ? {} : { latestVersion: value.latestVersion },
+			...value.notifiedAt === void 0 ? {} : { notifiedAt: value.notifiedAt }
+		};
+	} catch {
+		return;
+	}
+};
+const readUpdateCheckCache = (cachePath) => {
+	try {
+		return parseUpdateCheckCache(readFileSync(cachePath, "utf8"));
+	} catch {
+		return;
+	}
+};
+const writeUpdateCheckCache = (cachePath, cache) => {
+	const temporaryPath = `${cachePath}.${process.pid}.tmp`;
+	try {
+		writeFileSync(temporaryPath, `${JSON.stringify(cache)}\n`, { mode: 384 });
+		renameSync(temporaryPath, cachePath);
+		return true;
+	} catch (error) {
+		try {
+			rmSync(temporaryPath, { force: true });
+		} catch {}
+		log.debug("Could not write the CLI update cache: %s", error instanceof Error ? error.message : String(error));
+		return false;
+	}
+};
+const formatUpdateNotice = ({ currentVersion, latestVersion, upgradeCommand }) => {
+	if (semver.valid(currentVersion) === null || semver.valid(latestVersion) === null || !semver.gt(latestVersion, currentVersion)) return;
+	return `Neon CLI update available: ${currentVersion} → ${latestVersion}\n${upgradeCommand}`;
+};
+const shouldRefreshUpdateCheck = (cache, now) => cache === void 0 || now - cache.checkedAt >= CHECK_INTERVAL_MS;
+const cacheForUpdateSource = (cache, source) => cache?.source === source ? cache : void 0;
+const isCurrentBranchProbe = ({ commandPath, currentBranch }) => currentBranch && (commandPath[0] === "status" || commandPath[0] === "config" && commandPath[1] === "status");
+const updateSource = (command) => command.startsWith("brew ") ? "homebrew" : "npm";
+const spawnUpdateWorkerProcess = ({ cachePath, executablePath, source, workerPath }) => {
+	const child = spawn(executablePath, [
+		workerPath,
+		cachePath,
+		source
+	], {
+		detached: true,
+		stdio: "ignore",
+		windowsHide: true
+	});
+	child.on("error", (error) => {
+		log.debug("CLI update check failed to start: %s", error.message);
+	});
+	child.unref();
+	return child;
+};
+const spawnUpdateWorker = (cachePath, source) => {
+	const workerPath = fileURLToPath(new URL("./update_check_worker.js", import.meta.url));
+	if (!existsSync(workerPath)) return;
+	try {
+		spawnUpdateWorkerProcess({
+			cachePath,
+			executablePath: process.execPath,
+			source,
+			workerPath
+		});
+	} catch (error) {
+		log.debug("Could not start the CLI update check: %s", error instanceof Error ? error.message : String(error));
+	}
+};
+const isPackagedExecutable = () => "pkg" in process;
+const shouldRunUpdateNotifier = ({ commandPath, currentBranch, disabled, isCi: runningInCi, isPackaged, output, stderrIsTty, stdoutIsTty }) => !runningInCi && !disabled && !isPackaged && output === "table" && stdoutIsTty && stderrIsTty && commandPath.length > 0 && commandPath[0] !== "completion" && !isCurrentBranchProbe({
+	commandPath,
+	currentBranch
+});
+const notifyIfUpdateAvailable = ({ commandPath, configDir, currentBranch, currentVersion, output }) => {
+	if (!shouldRunUpdateNotifier({
+		commandPath,
+		currentBranch,
+		disabled: "NO_UPDATE_NOTIFIER" in process.env,
+		isCi: isCi(),
+		isPackaged: isPackagedExecutable(),
+		output,
+		stderrIsTty: process.stderr.isTTY === true,
+		stdoutIsTty: process.stdout.isTTY === true
+	})) return;
+	const command = recommendedCliUpgradeCommand(fileURLToPath(import.meta.url));
+	if (command === void 0) return;
+	const cachePath = join(configDir, CACHE_FILE);
+	const now = Date.now();
+	const source = updateSource(command);
+	const cache = cacheForUpdateSource(readUpdateCheckCache(cachePath), source);
+	let nextCache = cache;
+	if (cache?.latestVersion !== void 0 && (cache.notifiedAt === void 0 || now - cache.notifiedAt >= NOTIFY_INTERVAL_MS)) {
+		const notice = formatUpdateNotice({
+			currentVersion,
+			latestVersion: cache.latestVersion,
+			upgradeCommand: command
+		});
+		if (notice !== void 0) {
+			log.warning("%s", notice);
+			nextCache = {
+				...cache,
+				notifiedAt: now
+			};
+		}
+	}
+	if (!shouldRefreshUpdateCheck(cache, now)) {
+		if (nextCache !== cache && nextCache !== void 0) writeUpdateCheckCache(cachePath, nextCache);
+		return;
+	}
+	nextCache = {
+		...nextCache,
+		checkedAt: now,
+		source
+	};
+	if (writeUpdateCheckCache(cachePath, nextCache)) spawnUpdateWorker(cachePath, source);
+};
+const recordLatestVersion = (cachePath, source, latestVersion) => {
+	if (semver.valid(latestVersion) === null) return;
+	const cache = cacheForUpdateSource(readUpdateCheckCache(cachePath), source);
+	if (cache === void 0) return;
+	writeUpdateCheckCache(cachePath, {
+		...cache,
+		latestVersion
+	});
+};
+//#endregion
+export { cacheForUpdateSource, formatUpdateNotice, notifyIfUpdateAvailable, parseUpdateCheckCache, recordLatestVersion, shouldRefreshUpdateCheck, shouldRunUpdateNotifier, spawnUpdateWorkerProcess, writeUpdateCheckCache };

package/dist/utils/package_manager.js

@@ -159,6 +159,13 @@ const resolvePackageManager = (cwd) => inferPackageManager(cwd) ?? installedPack
 * as {@link resolvePackageManager} minus the lockfile walk.
 */
 const resolveInvokingPackageManager = () => detectInvokingPackageManager() ?? installedPackageManagers()[0] ?? "npm";
+const recommendedCliUpgradeCommand = (modulePath) => {
+	const path = modulePath.replace(/\\/g, "/").toLowerCase();
+	if (path.includes("/cellar/neonctl/")) return "brew upgrade neonctl";
+	if (path.includes("/.bun/install/global/node_modules/neon/")) return "bun i -g neon@latest";
+	if (path.includes("/pnpm/global/") && path.includes("/.pnpm/neon@") && path.includes("/node_modules/neon/")) return "pnpm i -g neon@latest";
+	if (path.includes("/lib/node_modules/neon/") || path.includes("/npm/node_modules/neon/")) return "npm i -g neon@latest";
+};
 /**
 * The argv for an install with `pm`: every dependency in the manifest when
 * `packages` is empty, otherwise those packages added to it. npm spells the add
@@ -326,4 +333,4 @@ const runCommand = (cmd, args, cwd, env) => new Promise((resolvePromise) => {
 	});
 });
 //#endregion
-export { DO_NOT_SUBSTITUTE_HINT, MISSING_BINARY_HINT, commandEnv, detectInvokingPackageManager, detectProjectPackageManager, formatExecCommand, formatInstallCommand, globalInstallCommand, inferPackageManager, installArgs, installedPackageManagers, resolveInvokingPackageManager, resolvePackageManager, runCommand };
+export { DO_NOT_SUBSTITUTE_HINT, MISSING_BINARY_HINT, commandEnv, detectInvokingPackageManager, detectProjectPackageManager, formatExecCommand, formatInstallCommand, globalInstallCommand, inferPackageManager, installArgs, installedPackageManagers, recommendedCliUpgradeCommand, resolveInvokingPackageManager, resolvePackageManager, runCommand };