neon 4.6.0 → 4.8.0

package/dist/init/interactive.js

@@ -1,529 +0,0 @@
-import { FALLBACK_TEMPLATES, fetchTemplates, scaffoldTemplate } from "./bootstrap.js";
-import { detectAgent, detectIde } from "./detect_agent.js";
-import { neonInitAgentCmd } from "./profile_cli.js";
-import { installNeonMcpServer } from "../mcp/install.js";
-import { agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
-import { getSkillsAgentName, mcpPickerOptions } from "./agents.js";
-import { ensureNeonctlAuth, isAuthenticated } from "./auth.js";
-import { installExtension, isExtensionInstalled } from "./extension.js";
-import { inspectProject } from "./inspect.js";
-import { ensureNeonctl } from "./neonctl.js";
-import { ensureSkillsUpToDate, installAgentSkills, skillsInstalledForAgent } from "./skills.js";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import which from "which";
-import { SelectPrompt } from "@clack/core";
-import { confirm, isCancel, log, multiselect, outro, select, spinner } from "@clack/prompts";
-import { bold, dim, gray, italic } from "yoctocolors";
-import picocolors from "picocolors";
-//#region src/init/interactive.ts
-/**
-* Interactive v2 CLI — purpose-built guided flow for humans.
-* Uses the same underlying install functions but with a clean clack-based UX.
-*/
-function wordWrap(text, width) {
-	return text.split("\n").map((line) => {
-		if (line.length <= width) return line;
-		const words = line.split(" ");
-		const lines = [];
-		let current = "";
-		for (const word of words) if (current.length + word.length + 1 > width && current.length > 0) {
-			lines.push(current);
-			current = word;
-		} else current = current.length > 0 ? `${current} ${word}` : word;
-		if (current.length > 0) lines.push(current);
-		return lines.join("\n");
-	}).join("\n");
-}
-const neonGreenFn = (s) => `\x1b[38;2;75;181;120m${s}\x1b[39m`;
-const originalCyan = picocolors.cyan;
-const originalMagenta = picocolors.magenta;
-function patchClackColors() {
-	const pc = picocolors;
-	pc.cyan = neonGreenFn;
-	pc.magenta = neonGreenFn;
-	return () => {
-		pc.cyan = originalCyan;
-		pc.magenta = originalMagenta;
-	};
-}
-const S_BAR = "│";
-const S_BAR_END = "└";
-const S_STEP_ACTIVE = "◆";
-const S_STEP_SUBMIT = "◇";
-const S_STEP_CANCEL = "■";
-const S_RADIO_ACTIVE = "●";
-const S_RADIO_INACTIVE = "○";
-const SENTINEL_NONE = "none";
-/**
-* Bespoke template picker built on @clack/core's `SelectPrompt`.
-*
-* The stock `@clack/prompts` `select` can only render an option on a single
-* line (title + a parenthesized hint on the focused row), which can't express
-* what we want here: a clean title-only list, and a focused row that expands to
-* `Title (tools)` with the description on its own italic line beneath. Driving
-* the core prompt directly lets us own the frame, so we emit a second
-* gutter-aligned line for the active option only.
-*/
-async function selectTemplate(templates, message) {
-	const options = [...templates.map((t) => ({
-		value: t.id,
-		label: t.title,
-		tools: t.tools,
-		description: t.description
-	})), {
-		value: SENTINEL_NONE,
-		label: "No thanks — continue without scaffolding"
-	}];
-	const green = neonGreenFn;
-	const descIndent = "    ";
-	const descWidth = Math.max(24, (process.stdout.columns || 80) - 8);
-	const renderActive = (option) => {
-		const tools = option.tools && option.tools.length > 0 ? ` ${dim(`(${option.tools.join(", ")})`)}` : "";
-		const head = `${green(S_RADIO_ACTIVE)} ${option.label}${tools}`;
-		if (!option.description) return head;
-		return `${head}\n${wordWrap(option.description, descWidth).split("\n").map((line) => `${green(S_BAR)}${descIndent}${italic(dim(line))}`).join("\n")}`;
-	};
-	return new SelectPrompt({
-		options,
-		initialValue: options[0]?.value,
-		render() {
-			const active = this.options[this.cursor];
-			const heading = (symbol) => `${gray(S_BAR)}\n${symbol}  ${message}\n`;
-			if (this.state === "submit") return `${heading(green(S_STEP_SUBMIT))}${gray(S_BAR)}  ${dim(active?.label ?? "")}`;
-			if (this.state === "cancel") return `${heading(green(S_STEP_CANCEL))}${gray(S_BAR)}  ${dim(active?.label ?? "")}\n${gray(S_BAR)}`;
-			const body = this.options.map((option) => option === active ? renderActive(option) : `${dim(S_RADIO_INACTIVE)} ${dim(option.label)}`).join(`\n${green(S_BAR)}  `);
-			return `${heading(green(S_STEP_ACTIVE))}${green(S_BAR)}  ${body}\n${green(S_BAR_END)}\n`;
-		}
-	}).prompt();
-}
-async function interactiveInit(options = {}) {
-	const restoreColors = patchClackColors();
-	try {
-		await interactiveInitInner(options);
-	} finally {
-		restoreColors();
-	}
-}
-async function interactiveInitInner(options) {
-	process.stdout.write(`\n\x1b[38;2;75;181;120m${[
-		" ██╗  ██╗██████╗  ██████╗ ██╗  ██╗",
-		" ███╗ ██║██╔═══╝ ██╔═══██╗███╗ ██║",
-		" ████╗██║██████╗ ██║   ██║████╗██║",
-		" ██╔████║██╔═══╝ ██║   ██║██╔████║",
-		" ██║╚███║██████╗ ╚██████╔╝██║╚███║",
-		" ╚═╝ ╚══╝╚═════╝  ╚═════╝ ╚═╝ ╚══╝"
-	].join("\n")}\x1b[0m\n`);
-	process.stdout.write(`${dim(wordWrap("\nLet's get your project set up with Neon. We'll install the MCP server, agent skills, and IDE extension, then connect your app to a database.\n", process.stdout.columns || 80))}\n`);
-	const detectedAgent = (() => {
-		const raw = detectAgent();
-		return raw ? tryResolveAddMcpAgentId(raw) : void 0;
-	})();
-	const inspectSpinner = spinner();
-	inspectSpinner.start("Checking existing configuration...");
-	const inspection = await inspectProject([
-		{
-			id: "has_app",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "mcp_server",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "skills",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "connection_string",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "project_stack",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "migrations",
-			description: "",
-			lookFor: []
-		},
-		{
-			id: "ide_type",
-			description: "",
-			lookFor: []
-		}
-	]);
-	inspectSpinner.stop(dim("Configuration checked ✓"));
-	const hasApp = inspection.hasApp === true;
-	let selectedFeatures = [];
-	let selectedTemplate = null;
-	if (options.preview && !hasApp) {
-		let templates = FALLBACK_TEMPLATES;
-		try {
-			const fetched = await fetchTemplates();
-			if (fetched && fetched.length > 0) templates = fetched;
-		} catch {}
-		const templateResult = await selectTemplate(templates, "No application detected. Would you like to scaffold a new project from a template?");
-		if (isCancel(templateResult)) {
-			outro("Setup cancelled.");
-			return;
-		}
-		if (templateResult !== "none") {
-			selectedTemplate = templates.find((t) => t.id === templateResult) ?? null;
-			if (selectedTemplate) {
-				selectedFeatures = selectedTemplate.requires;
-				const bootstrapS = spinner();
-				bootstrapS.start(`Scaffolding project from template "${selectedTemplate.title}"...`);
-				try {
-					await scaffoldTemplate(selectedTemplate, ".", { onWarn: (message) => log.warn(message) });
-					bootstrapS.stop(dim(`Scaffolded project from "${selectedTemplate.title}" ✓`));
-				} catch (err) {
-					const msg = err instanceof Error ? err.message : "Unknown error";
-					bootstrapS.stop("Failed to scaffold project");
-					log.error(msg);
-					outro("Setup failed.");
-					return;
-				}
-			}
-		}
-	}
-	if (!selectedTemplate && hasApp) {
-		const featuresResult = await select({
-			message: "Which Neon features would you like to enable for this project?",
-			options: [{
-				value: "database",
-				label: "Database"
-			}, {
-				value: "database,auth",
-				label: "Database + Neon Auth (adds authentication via Neon)"
-			}],
-			initialValue: "database"
-		});
-		if (isCancel(featuresResult)) {
-			outro("Setup cancelled.");
-			return;
-		}
-		selectedFeatures = featuresResult.split(",");
-	}
-	if (selectedFeatures.length > 0) {
-		const neonPath = resolve(process.cwd(), ".neon");
-		let existing = {};
-		if (existsSync(neonPath)) try {
-			existing = JSON.parse(readFileSync(neonPath, "utf-8"));
-		} catch {}
-		existing._init = { features: selectedFeatures };
-		writeFileSync(neonPath, `${JSON.stringify(existing, null, 2)}\n`);
-	}
-	const mcpHits = inspection.mcpAgents ?? [];
-	const detectedHasMcp = detectedAgent ? mcpHits.some((hit) => hit.agent === detectedAgent) : false;
-	const mcpAlready = detectedAgent ? detectedHasMcp : inspection.mcpConfigured === true;
-	const skillsAlready = selectedTemplate !== null || (detectedAgent ? skillsInstalledForAgent(detectedAgent, process.cwd(), options.preview) : inspection.skillsInstalled === true);
-	const hasNeonConnection = inspection.connectionString === true;
-	const needsInstall = !mcpAlready || !skillsAlready;
-	const neonContextPath = resolve(process.cwd(), ".neon");
-	const hasNeonContext = existsSync(neonContextPath) && (() => {
-		try {
-			return !!JSON.parse(readFileSync(neonContextPath, "utf-8")).projectId;
-		} catch {
-			return false;
-		}
-	})();
-	const hasNeonAuth = (() => {
-		for (const envFile of [".env", ".env.local"]) {
-			const envPath = resolve(process.cwd(), envFile);
-			if (existsSync(envPath)) try {
-				const content = readFileSync(envPath, "utf-8");
-				if (/^NEON_AUTH_/m.test(content)) return true;
-			} catch {}
-		}
-		return false;
-	})();
-	let extensionAlready = false;
-	const detectedIdeEditor = extensionEditorForAgent(detectedAgent);
-	if (detectedIdeEditor) extensionAlready = await isExtensionInstalled(detectedIdeEditor);
-	if (mcpAlready && skillsAlready && hasNeonConnection && hasNeonContext) {
-		log.step(dim(`Neon MCP server already configured (${inspection.mcpScope || "detected"}) ✓`));
-		log.step(dim(`Neon agent skills already installed (${inspection.skillsScope || "detected"}) ✓`));
-		if (extensionAlready) log.step(dim("Neon editor extension installed ✓"));
-		log.step(dim("Neon database connected ✓"));
-		if (hasNeonAuth) {
-			log.step(dim("Neon Auth configured ✓"));
-			outro(dim("Your project is fully configured with Neon. Nothing to do."));
-			return;
-		}
-		const authResult = await select({
-			message: "Would you like to set up Neon Auth for user authentication?",
-			options: [{
-				value: "yes",
-				label: "Yes, set up Neon Auth"
-			}, {
-				value: "no",
-				label: "No, skip for now"
-			}],
-			initialValue: "no"
-		});
-		if (isCancel(authResult) || authResult === "no") {
-			outro(dim(`Your project is configured with Neon. You can set up Neon Auth later by having your agent run: ${neonInitAgentCmd({ step: "neon-auth" })}`));
-			return;
-		}
-		let projectId = null;
-		try {
-			projectId = JSON.parse(readFileSync(neonContextPath, "utf-8")).projectId ?? null;
-		} catch {}
-		log.step("Next steps");
-		const promptLines = ["Set up Neon Auth for this project."];
-		if (projectId) promptLines.push(`Project ID: ${projectId}.`);
-		log.message(dim("Copy the following into your agent chat:"));
-		log.message(promptLines.map((line) => bold(neonGreenFn(line))).join("\n"));
-		outro(dim("Have feedback? Email us at feedback@neon.tech"));
-		return;
-	}
-	if (mcpAlready) log.step(dim(`Neon MCP server already configured (${inspection.mcpScope || "detected"}) ✓`));
-	if (skillsAlready) log.step(dim(`Neon agent skills already installed (${inspection.skillsScope || "detected"}) ✓`));
-	if (needsInstall) {
-		if (!(process.env.HOME || process.env.USERPROFILE)) {
-			log.error("Could not determine home directory.");
-			outro("Setup failed.");
-			return;
-		}
-		let selectedAgents;
-		if (detectedAgent) selectedAgents = [detectedAgent];
-		else {
-			const picked = await pickAgents();
-			if (!picked) {
-				outro("Setup cancelled.");
-				return;
-			}
-			selectedAgents = picked;
-		}
-		let vscodeEditors = extensionEditorsFor(selectedAgents);
-		let extensionAlreadyInstalled = false;
-		if (vscodeEditors.length > 0) {
-			extensionAlreadyInstalled = (await Promise.all(vscodeEditors.map((e) => isExtensionInstalled(e)))).every(Boolean);
-			if (extensionAlreadyInstalled) log.step(dim("Neon editor extension already installed ✓"));
-		}
-		let canInstallExtension = vscodeEditors.length > 0 && !extensionAlreadyInstalled;
-		let doInstallExtension = false;
-		let mcpScope = "global";
-		let skillsScope = "project";
-		let modeResult;
-		while (true) {
-			const hintParts = [];
-			if (selectedAgents.some((agent) => !mcpHits.some((hit) => hit.agent === agent))) hintParts.push("MCP server (global)");
-			if (selectedTemplate === null && selectedAgents.some((agent) => getSkillsAgentName(agent) && !skillsInstalledForAgent(agent, process.cwd(), options.preview))) hintParts.push("agent skills (project)");
-			const agentNames = selectedAgents.map((id) => getAgentDisplayName(id)).join(", ");
-			const result = await select({
-				message: `Configure ${agentNames} for Neon:`,
-				options: [
-					{
-						value: "defaults",
-						label: "Install with defaults",
-						hint: hintParts.join(", ")
-					},
-					{
-						value: "customize",
-						label: "Customize installation",
-						hint: canInstallExtension ? "choose scopes and optional editor extension" : "choose scopes and options"
-					},
-					{
-						value: "change_editor",
-						label: "Configure a different agent"
-					}
-				],
-				initialValue: "defaults"
-			});
-			if (isCancel(result)) {
-				outro("Setup cancelled.");
-				return;
-			}
-			if (result === "change_editor") {
-				const picked = await pickAgents();
-				if (!picked) {
-					outro("Setup cancelled.");
-					return;
-				}
-				selectedAgents = picked;
-				vscodeEditors = extensionEditorsFor(selectedAgents);
-				canInstallExtension = vscodeEditors.length > 0 && !extensionAlreadyInstalled;
-				continue;
-			}
-			modeResult = result;
-			break;
-		}
-		if (modeResult === "customize") {
-			if (selectedAgents.some((agent) => !mcpHits.some((hit) => hit.agent === agent))) {
-				const scopeResult = await select({
-					message: "Where should the Neon MCP server be configured?",
-					options: [
-						{
-							value: "global",
-							label: "Global (available in all projects)"
-						},
-						...selectedAgents.every(agentSupportsProjectMcp) ? [{
-							value: "project",
-							label: "Project-level (this project only)"
-						}] : [],
-						{
-							value: "none",
-							label: "Skip — do not install the MCP server"
-						}
-					]
-				});
-				if (isCancel(scopeResult)) {
-					outro("Setup cancelled.");
-					return;
-				}
-				mcpScope = scopeResult;
-			}
-			if (selectedTemplate === null && selectedAgents.some((agent) => getSkillsAgentName(agent) && !skillsInstalledForAgent(agent, process.cwd(), options.preview))) {
-				const skillsScopeResult = await select({
-					message: "Where should Neon agent skills be installed?",
-					options: [{
-						value: "global",
-						label: "Global (available in all projects)"
-					}, {
-						value: "project",
-						label: "Project-level (this project only)"
-					}],
-					initialValue: "project"
-				});
-				if (isCancel(skillsScopeResult)) {
-					outro("Setup cancelled.");
-					return;
-				}
-				skillsScope = skillsScopeResult;
-			}
-			if (canInstallExtension) {
-				const extResult = await confirm({ message: `Install the Neon extension for ${vscodeEditors.join(", ")}?` });
-				if (isCancel(extResult)) {
-					outro("Setup cancelled.");
-					return;
-				}
-				doInstallExtension = extResult;
-			}
-		}
-		if (!await isAuthenticated()) {
-			const authS = spinner();
-			authS.start("Authenticating with Neon...");
-			if (!await ensureNeonctlAuth()) {
-				authS.stop("Authentication failed.");
-				outro("Run `neon init` again after signing in.");
-				return;
-			}
-			authS.stop("Authenticated.");
-		}
-		const nctlS = spinner();
-		nctlS.start("Checking Neon CLI...");
-		const nctlResult = await ensureNeonctl((phase) => {
-			nctlS.message(phase === "installing" ? "Installing Neon CLI..." : "Updating Neon CLI...");
-		});
-		switch (nctlResult.status) {
-			case "already_current":
-				nctlS.stop(dim(`Neon CLI is up to date (v${nctlResult.version}) ✓`));
-				break;
-			case "installed":
-				nctlS.stop(dim(`Installed Neon CLI (v${nctlResult.version}) ✓`));
-				break;
-			case "updated":
-				nctlS.stop(dim(`Updated Neon CLI to v${nctlResult.version} ✓`));
-				break;
-			case "failed":
-				nctlS.stop(nctlResult.action === "updating" ? "Failed to update Neon CLI" : "Failed to install Neon CLI");
-				log.warn(nctlResult.error ?? "The Neon CLI could not be installed automatically.");
-				if (which.sync("npx", { nothrow: true })) log.warn("Setup will continue using npx.");
-		}
-		for (const agent of selectedAgents) {
-			const label = getAgentDisplayName(agent);
-			if (mcpScope !== "none" && !mcpHits.some((hit) => hit.agent === agent)) {
-				const mcpS = spinner();
-				mcpS.start(`Installing Neon MCP server for ${label}...`);
-				const installed = installNeonMcpServer({
-					agent,
-					scope: mcpScope === "project" ? "project" : "global",
-					cwd: process.cwd()
-				});
-				if (installed.ok) mcpS.stop(dim(`Neon MCP server configured for ${label} (${mcpScope}) ✓`));
-				else if (installed.unsupported) {
-					mcpS.stop(`Could not write MCP config for ${label}`);
-					log.warn(installed.error);
-				} else {
-					mcpS.stop(`Failed to configure MCP server for ${label}`);
-					log.error(installed.error);
-				}
-			}
-			if (selectedTemplate === null && getSkillsAgentName(agent) && !skillsInstalledForAgent(agent, process.cwd(), options.preview)) await installAgentSkills([agent], {
-				scope: skillsScope,
-				preview: options.preview
-			});
-		}
-		if (doInstallExtension) for (const editor of vscodeEditors) {
-			const extS = spinner();
-			extS.start(`Installing Neon extension for ${editor}...`);
-			if (await installExtension(editor)) extS.stop(dim(`Neon extension installed for ${editor} ✓`));
-			else extS.stop(`Extension install failed — install manually from the extensions panel.`);
-		}
-	}
-	const ide = detectIde();
-	const agentForSkills = detectAgent() ?? (ide === "Cursor" ? "cursor" : ide === "VS Code" ? "vscode" : ide === "Windsurf" ? "windsurf" : null);
-	if (agentForSkills) {
-		const detectedSkillsScope = inspection.skillsScope === "global" ? "global" : void 0;
-		await ensureSkillsUpToDate(agentForSkills, detectedSkillsScope, options.preview);
-	}
-	const gettingStartedData = {};
-	if (hasNeonConnection) gettingStartedData.hasConnectionString = true;
-	if (inspection.framework && inspection.framework !== "none") gettingStartedData.framework = inspection.framework;
-	if (inspection.orm && inspection.orm !== "none") gettingStartedData.orm = inspection.orm;
-	if (inspection.migrationTool && inspection.migrationTool !== "none") gettingStartedData.migrationTool = inspection.migrationTool;
-	if (inspection.migrationDir && inspection.migrationDir !== "none") gettingStartedData.migrationDir = inspection.migrationDir;
-	if (selectedFeatures.length > 0) gettingStartedData.features = selectedFeatures;
-	if (options.preview) gettingStartedData.preview = true;
-	const cmd = neonInitAgentCmd({
-		step: "getting-started",
-		...gettingStartedData
-	});
-	const cols = (process.stdout.columns || 80) - 3;
-	const promptText = `To finish setting up Neon using Neon's agent-guided onboarding experience, have your agent run this shell command: ${cmd}`;
-	log.step("Next steps");
-	log.message(dim("Copy the following into your agent chat:"));
-	log.message(wordWrap(promptText, cols).split("\n").map((line) => bold(neonGreenFn(line))).join("\n"));
-	outro(dim("Have feedback? Email us at feedback@neon.tech"));
-}
-function extensionEditorForAgent(agent) {
-	if (agent === "cursor") return "Cursor";
-	if (agent === "vscode") return "VS Code";
-	const ide = detectIde();
-	if (ide === "Cursor" || ide === "VS Code") return ide;
-	return null;
-}
-function extensionEditorsFor(selected) {
-	const out = [];
-	if (selected.includes("cursor")) out.push("Cursor");
-	if (selected.includes("vscode")) out.push("VS Code");
-	const ide = detectIde();
-	if ((ide === "Cursor" || ide === "VS Code") && !out.includes(ide)) out.push(ide);
-	return out;
-}
-async function pickAgents() {
-	const options = mcpPickerOptions();
-	const installed = await detectInstalledAgents();
-	const response = await multiselect({
-		message: "Which agent(s) would you like to configure?",
-		options,
-		initialValues: installed.filter((id) => options.some((option) => option.value === id)),
-		required: true
-	});
-	if (isCancel(response)) return null;
-	const selected = response;
-	if (selected.length === 0) {
-		log.warn("No agents selected.");
-		return null;
-	}
-	return selected;
-}
-//#endregion
-export { interactiveInit };

package/dist/init/neonctl.js

@@ -1,139 +0,0 @@
-import { globalInstallCommand, resolveInvokingPackageManager } from "../utils/package_manager.js";
-import { explicitConfigDirCli, explicitProfileCli } from "./profile_cli.js";
-import { lstatSync } from "node:fs";
-import { execa } from "execa";
-//#region src/init/neonctl.ts
-/**
-* `npx -y neon` avoids global-install assumptions, and `CI=` keeps emitted calls
-* non-interactive. API and OAuth hosts stay ambient because the CLI reads them directly.
-*/
-function neonctlCmd() {
-	return `CI= npx -y neon${explicitProfileCli()}${explicitConfigDirCli()}`;
-}
-/**
-* The global binaries that indicate the Neon CLI is installed. The current
-* package ships `neon`; `neonctl` is the legacy alias, kept in the probe so an
-* older global install still counts as "installed" (and isn't reinstalled).
-*/
-const NEON_CLI_BINARIES = ["neon", "neonctl"];
-/**
-* Gets the currently installed Neon CLI version, probing the `neon` binary
-* first and falling back to the legacy `neonctl` alias. Returns null when the
-* CLI isn't on PATH.
-*/
-async function getNeonCliVersion() {
-	for (const bin of NEON_CLI_BINARIES) try {
-		const match = (await execa(bin, ["--version"], {
-			stdio: "pipe",
-			timeout: 5e3
-		})).stdout.trim().match(/(\d+\.\d+\.\d+)/);
-		if (match) return match[1];
-	} catch {}
-	return null;
-}
-/**
-* Checks whether the Neon CLI is globally installed and whether it's up to date.
-*/
-async function checkNeonctl() {
-	const currentVersion = await getNeonCliVersion();
-	if (!currentVersion) return {
-		installed: false,
-		currentVersion: null,
-		latestVersion: null,
-		needsUpdate: true
-	};
-	let latestVersion = null;
-	try {
-		latestVersion = (await execa("npm", [
-			"view",
-			"neon",
-			"version"
-		], {
-			stdio: "pipe",
-			timeout: 1e4
-		})).stdout.trim();
-	} catch {
-		return {
-			installed: true,
-			currentVersion,
-			latestVersion: null,
-			needsUpdate: false
-		};
-	}
-	const needsUpdate = currentVersion !== null && latestVersion !== null && currentVersion !== latestVersion && isOlderVersion(currentVersion, latestVersion);
-	return {
-		installed: true,
-		currentVersion,
-		latestVersion,
-		needsUpdate
-	};
-}
-function isOlderVersion(current, latest) {
-	const c = current.split(".").map(Number);
-	const l = latest.split(".").map(Number);
-	for (let i = 0; i < 3; i++) {
-		if ((c[i] ?? 0) < (l[i] ?? 0)) return true;
-		if ((c[i] ?? 0) > (l[i] ?? 0)) return false;
-	}
-	return false;
-}
-/**
-* Checks if neonctl is installed via a local dev symlink.
-* If so, skip install/update — the developer manages it manually.
-*/
-function isLocalDevSymlink() {
-	try {
-		const home = process.env.HOME || process.env.USERPROFILE || "";
-		const roots = [`${process.env.NVM_DIR || `${home}/.nvm`}/versions/node/${process.version}/lib/node_modules`, `${home}/.nvm/versions/node/${process.version}/lib/node_modules`];
-		for (const root of roots) for (const pkg of NEON_CLI_BINARIES) try {
-			if (lstatSync(`${root}/${pkg}`).isSymbolicLink()) return true;
-		} catch {}
-		return false;
-	} catch {
-		return false;
-	}
-}
-/**
-* Ensures neonctl is globally installed and up to date.
-* Uses the same package manager that invoked the init command.
-*/
-async function ensureNeonctl(onProgress) {
-	if (isLocalDevSymlink()) return {
-		status: "already_current",
-		version: await getNeonCliVersion() ?? "dev"
-	};
-	const check = await checkNeonctl();
-	if (check.installed && !check.needsUpdate) return {
-		status: "already_current",
-		version: check.currentVersion ?? void 0
-	};
-	const pm = resolveInvokingPackageManager();
-	const install = globalInstallCommand(pm, "neon");
-	const action = check.installed ? "updating" : "installing";
-	if (!install) return {
-		status: "failed",
-		action,
-		error: `Could not ${action === "updating" ? "update" : "install"} the Neon CLI: this machine has no package manager that can perform a global install. npm, pnpm and bun are not on PATH (yarn Berry has no global install). Install npm, pnpm or bun, then run this again.`
-	};
-	const { command, args } = install;
-	onProgress?.(action);
-	try {
-		await execa(command, args, {
-			stdio: "pipe",
-			timeout: 6e4
-		});
-		const version = await getNeonCliVersion();
-		return {
-			status: check.installed ? "updated" : "installed",
-			version: version ?? void 0
-		};
-	} catch (err) {
-		return {
-			status: "failed",
-			action,
-			error: err instanceof Error ? err.message : "Unknown error"
-		};
-	}
-}
-//#endregion
-export { checkNeonctl, ensureNeonctl, neonctlCmd };