neon 7.0.2 → 7.0.4

package/dist/commands/api.js

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { describeOperation, getEndpoints, loadSpec } from "../utils/openapi.js";
 import { writer } from "../writer.js";
+import { describeOperation, getEndpoints, loadSpec } from "../utils/openapi.js";
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import YAML from "yaml";

package/dist/commands/bootstrap.js

@@ -4,13 +4,13 @@ import { log } from "../log.js";
 import { recordCommandSuccessExtras, recordScaffoldedTemplate } from "../analytics.js";
 import { getCliName } from "../utils/cli_name.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
+import { coerceAgentFlag } from "../utils/agent_flag.js";
+import { assertNamedAgentTooling, chooseYesAgentTooling, initPluginAgents, initSkillsMcpAgents, postScaffoldActions, projectContextFile, resolveNamedAgents } from "../init/plan.js";
+import { formatInstallCommand, inferPackageManager, installArgs, installedPackageManagers, resolvePackageManager, runCommand } from "../utils/package_manager.js";
 import { writer } from "../writer.js";
 import { FALLBACK_TEMPLATES, ensureTargetUsable, fetchTemplates, findTemplate, scaffoldTemplate, templateIds } from "../init/bootstrap.js";
 import { agentSetupDoneLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
-import { formatInstallCommand, inferPackageManager, installArgs, installedPackageManagers, resolvePackageManager, runCommand } from "../utils/package_manager.js";
 import { runAuthenticatedLink } from "../init/link.js";
-import { coerceAgentFlag } from "../utils/agent_flag.js";
-import { assertNamedAgentTooling, chooseYesAgentTooling, initPluginAgents, initSkillsMcpAgents, postScaffoldActions, projectContextFile, resolveNamedAgents } from "../init/plan.js";
 import { formatTemplateTitle } from "../init/template_title.js";
 import { pickAgentSetupInteractively, pickInitLinkInteractively } from "../init/wizard.js";
 import { runAgentTooling } from "../init/tooling.js";

package/dist/commands/branches.js

@@ -2,15 +2,16 @@ import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { retryOnLock } from "../api.js";
 import { contextBranch, readContextFile } from "../context.js";
+import { branchCreateRequest } from "../parameters.gen.js";
 import { writer } from "../writer.js";
 import { EndpointType } from "../utils/api_enums.js";
 import { looksLikeBranchId, looksLikeLSN, looksLikeTimestamp } from "../utils/formats.js";
-import { branchIdFromProps, branchIdResolve, fillSingleProject } from "../utils/enrichers.js";
-import { branchCreateRequest } from "../parameters.gen.js";
+import { branchIdFromProps, fillSingleProject, resolveBranchFromProps } from "../utils/enrichers.js";
 import { getComputeUnits } from "../utils/compute_units.js";
 import { psql } from "../utils/psql.js";
 import { parsePointInTime } from "../utils/point_in_time.js";
 import { parseSchemaDiffParams, schemaDiff } from "./schema_diff.js";
+import chalk from "chalk";
 //#region src/commands/branches.ts
 var branches_exports = /* @__PURE__ */ __exportAll({
 	BRANCH_FIELDS: () => BRANCH_FIELDS,
@@ -27,14 +28,64 @@ const BRANCH_FIELDS = [
 	"expires_at",
 	"created_at"
 ];
-const BRANCH_FIELDS_RESET = [
+const BRANCH_FIELDS_RESET = [...BRANCH_FIELDS, "last_reset_at"];
+const BRANCH_DETAIL_FIELDS = [
 	"name",
 	"id",
-	"default",
+	"parent_id",
 	"current_state",
+	"expires_at",
 	"created_at",
-	"last_reset_at"
+	"created_by",
+	"last_reset_at",
+	"logical_size"
 ];
+/**
+* The branch `.neon` pins, by name (preferred) or id, when `.neon` links this same project;
+* a `--project-id` pointing elsewhere makes its branch not current.
+*/
+const currentBranchOf = (props) => {
+	const context = readContextFile(props.contextFile);
+	return context.projectId === props.projectId ? contextBranch(context) : void 0;
+};
+const branchNameCell = (br, labels) => {
+	const tags = [];
+	if (br.default) tags.push(chalk.cyan("[default]"));
+	if (br.protected) tags.push(chalk.yellow("[protected]"));
+	if (labels.annotations?.[br.id]?.value.anonymized) tags.push(chalk.dim("[anon]"));
+	if (labels.current !== void 0 && (br.id === labels.current || br.name === labels.current)) tags.push(chalk.green("[current]"));
+	tags.push(br.name);
+	return tags.join(" ");
+};
+const stateCell = (state) => {
+	if (!state) return "";
+	if (state === "ready") return chalk.green(state);
+	if (state === "init" || state === "resetting") return chalk.yellow(state);
+	return chalk.dim(state);
+};
+const formatBytes = (bytes) => {
+	const units = [
+		"bytes",
+		"KiB",
+		"MiB",
+		"GiB",
+		"TiB"
+	];
+	let value = bytes;
+	let unit = 0;
+	while (value >= 1024 && unit < units.length - 1) {
+		value /= 1024;
+		unit++;
+	}
+	return unit === 0 ? `${bytes} bytes` : `${value.toFixed(1)} ${units[unit]}`;
+};
+const branchColumns = (labels) => ({
+	name: (br) => branchNameCell(br, labels),
+	current_state: (br) => stateCell(br.current_state),
+	expires_at: (br) => br.expires_at || "never",
+	created_by: (br) => br.created_by?.name ?? "",
+	logical_size: (br) => br.logical_size === void 0 ? "" : formatBytes(br.logical_size)
+});
 const command = "branches";
 const describe = "Manage branches";
 const aliases = ["branch"];
@@ -171,22 +222,12 @@ const handler = (args) => {
 };
 const list = async (props) => {
 	const { data: { branches, annotations } } = await props.apiClient.listProjectBranches({ projectId: props.projectId });
-	const currentBranch = contextBranch(readContextFile(props.contextFile));
 	writer(props).end(branches, {
 		fields: BRANCH_FIELDS,
-		renderColumns: {
-			expires_at: (br) => br.expires_at || "never",
-			name: (br) => {
-				const isAnon = annotations[br.id]?.value.anonymized;
-				const labels = [];
-				if (br.default) labels.push("[default]");
-				if (br.protected) labels.push("[protected]");
-				if (isAnon) labels.push("[anon]");
-				if (currentBranch !== void 0 && (br.id === currentBranch || br.name === currentBranch)) labels.push("[current]");
-				labels.push(br.name);
-				return labels.join(" ");
-			}
-		}
+		renderColumns: branchColumns({
+			annotations,
+			current: currentBranchOf(props)
+		})
 	});
 };
 const create = async (props) => {
@@ -237,16 +278,20 @@ const create = async (props) => {
 		out.write(data.branch, {
 			fields: BRANCH_FIELDS,
 			title: "branch",
-			emptyMessage: "No branches have been found."
+			humanTitle: "Branch",
+			emptyMessage: "No branches have been found.",
+			renderColumns: branchColumns({ current: currentBranchOf(props) })
 		});
 		if (writeEndpoints) out.write(endpoints, {
 			fields: ["id", "created_at"],
 			title: "endpoints",
+			humanTitle: "Compute",
 			emptyMessage: "No endpoints have been found."
 		});
 		if (writeUris) out.write(connectionUris, {
 			fields: ["connection_uri"],
 			title: "connection_uris",
+			humanTitle: "Connection string",
 			emptyMessage: "No connection uris have been found"
 		});
 	}
@@ -259,24 +304,54 @@ const create = async (props) => {
 	}
 };
 const rename = async (props) => {
-	const branchId = await branchIdFromProps(props);
+	const { branchId, listing } = await resolveBranchFromProps(props);
 	const { data } = await retryOnLock(() => props.apiClient.updateProjectBranch(props.projectId, branchId, { branch: { name: props.newName } }));
-	writer(props).end(data.branch, { fields: BRANCH_FIELDS });
+	writer(props).end(data.branch, {
+		fields: BRANCH_FIELDS,
+		renderColumns: branchColumns({
+			annotations: listing?.annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 const setDefault = async (props) => {
-	const branchId = await branchIdFromProps(props);
+	const { branchId, listing } = await resolveBranchFromProps(props);
 	const { data } = await retryOnLock(() => props.apiClient.setDefaultProjectBranch(props.projectId, branchId));
-	writer(props).end(data.branch, { fields: BRANCH_FIELDS });
+	writer(props).end(data.branch, {
+		fields: BRANCH_FIELDS,
+		renderColumns: branchColumns({
+			annotations: listing?.annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 const deleteBranch = async (props) => {
-	const branchId = await branchIdFromProps(props);
+	const { branchId, listing } = await resolveBranchFromProps(props);
 	const { data } = await retryOnLock(() => props.apiClient.deleteProjectBranch(props.projectId, branchId));
-	if (data) writer(props).end(data.branch, { fields: BRANCH_FIELDS });
+	if (data) writer(props).end(data.branch, {
+		fields: BRANCH_FIELDS,
+		renderColumns: branchColumns({
+			annotations: listing?.annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 const get = async (props) => {
-	const branchId = await branchIdFromProps(props);
-	const { data } = await props.apiClient.getProjectBranch(props.projectId, branchId);
-	writer(props).end(data.branch, { fields: BRANCH_FIELDS });
+	const resolved = await resolveBranchFromProps(props);
+	let branch = resolved.branch;
+	let annotations = resolved.listing?.annotations;
+	if (!branch) {
+		const { data } = await props.apiClient.getProjectBranch(props.projectId, resolved.branchId);
+		branch = data.branch;
+		annotations = data.annotation ? { [data.branch.id]: data.annotation } : void 0;
+	}
+	writer(props).end(branch, {
+		fields: BRANCH_DETAIL_FIELDS,
+		renderColumns: branchColumns({
+			annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 const addCompute = async (props) => {
 	const branchId = await branchIdFromProps(props);
@@ -291,34 +366,50 @@ const addCompute = async (props) => {
 };
 const reset = async (props) => {
 	if (!props.parent) throw new Error("Only resetting to parent is supported for now");
-	const branchId = await branchIdFromProps(props);
-	const { data: { branch: { parent_id } } } = await props.apiClient.getProjectBranch(props.projectId, branchId);
+	const { branchId, branch, listing } = await resolveBranchFromProps(props);
+	const parent_id = branch?.parent_id ?? (await props.apiClient.getProjectBranch(props.projectId, branchId)).data.branch.parent_id;
 	if (!parent_id) throw new Error("Branch has no parent");
 	const { data } = await retryOnLock(() => props.apiClient.restoreProjectBranch(props.projectId, branchId, {
 		source_branch_id: parent_id,
 		preserve_under_name: props.preserveUnderName || void 0
 	}));
-	writer(props).end(data.branch, { fields: BRANCH_FIELDS_RESET });
+	writer(props).end(data.branch, {
+		fields: BRANCH_FIELDS_RESET,
+		renderColumns: branchColumns({
+			annotations: listing?.annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 const restore = async (props) => {
-	const targetBranchId = await branchIdResolve({
-		branch: props.id,
+	const { branchId: targetBranchId, branch: targetBranch, listing } = await resolveBranchFromProps({
+		apiClient: props.apiClient,
 		projectId: props.projectId,
-		apiClient: props.apiClient
+		id: props.id
 	});
 	const pointInTime = await parsePointInTime({
 		pointInTime: props.pointInTime,
 		targetBranchId,
 		projectId: props.projectId,
-		api: props.apiClient
+		api: props.apiClient,
+		branches: listing?.branches,
+		targetBranch
 	});
-	log.info(`Restoring branch ${targetBranchId} to the branch ${pointInTime.branchId} ${pointInTime.tag === "lsn" && "LSN " + pointInTime.lsn || pointInTime.tag === "timestamp" && "timestamp " + pointInTime.timestamp || "head"}`);
+	if (props.output === "table") {
+		const nameOf = (id) => listing?.branches.find((b) => b.id === id)?.name ?? id;
+		const point = pointInTime.tag === "lsn" ? `LSN ${pointInTime.lsn} of` : pointInTime.tag === "timestamp" ? `timestamp ${pointInTime.timestamp} of` : "the head of";
+		log.info(`Restoring ${nameOf(targetBranchId)} to ${point} ${nameOf(pointInTime.branchId)}`);
+	} else log.info(`Restoring branch ${targetBranchId} to the branch ${pointInTime.branchId} ${pointInTime.tag === "lsn" && "LSN " + pointInTime.lsn || pointInTime.tag === "timestamp" && "timestamp " + pointInTime.timestamp || "head"}`);
 	const { data } = await retryOnLock(() => props.apiClient.restoreProjectBranch(props.projectId, targetBranchId, {
 		source_branch_id: pointInTime.branchId,
 		preserve_under_name: props.preserveUnderName || void 0,
 		...pointInTime.tag === "lsn" && { source_lsn: pointInTime.lsn },
 		...pointInTime.tag === "timestamp" && { source_timestamp: pointInTime.timestamp }
 	}));
+	const labels = {
+		annotations: listing?.annotations,
+		current: currentBranchOf(props)
+	};
 	const writeInst = writer(props).write(data.branch, {
 		title: "Restored branch",
 		fields: [
@@ -326,7 +417,8 @@ const restore = async (props) => {
 			"name",
 			"last_reset_at"
 		],
-		emptyMessage: "No branches have been restored."
+		emptyMessage: "No branches have been restored.",
+		renderColumns: branchColumns(labels)
 	});
 	const parentId = data.branch.parent_id;
 	if (props.preserveUnderName && parentId) {
@@ -334,19 +426,26 @@ const restore = async (props) => {
 		writeInst.write(data.branch, {
 			title: "Backup branch",
 			fields: ["id", "name"],
-			emptyMessage: "Backup branch has not been found."
+			emptyMessage: "Backup branch has not been found.",
+			renderColumns: branchColumns(labels)
 		});
 	}
 	writeInst.end();
 };
 const setExpiration = async (props) => {
-	const branchId = await branchIdFromProps({
+	const { branchId, listing } = await resolveBranchFromProps({
 		...props,
 		id: props.branchId
 	});
 	const expiresAt = typeof props.expiresAt === "string" ? new Date(props.expiresAt).toISOString() : null;
 	const { data } = await retryOnLock(() => props.apiClient.updateProjectBranch(props.projectId, branchId, { branch: { expires_at: expiresAt } }));
-	writer(props).end(data.branch, { fields: BRANCH_FIELDS });
+	writer(props).end(data.branch, {
+		fields: BRANCH_FIELDS,
+		renderColumns: branchColumns({
+			annotations: listing?.annotations,
+			current: currentBranchOf(props)
+		})
+	});
 };
 //#endregion
 export { BRANCH_FIELDS, aliases, builder, command, describe, handler, branches_exports as t };

package/dist/commands/bucket.js

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { isNeonApiError, retryOnLock } from "../api.js";
+import { createProjectBranchBucket, deleteProjectBranchBucket, deleteProjectBranchBucketObject, deleteProjectBranchBucketObjectsByPrefix, getProjectBranchBucketObject, listProjectBranchBucketObjects, listProjectBranchBuckets, presignUpload } from "../storage_api.js";
 import { writer } from "../writer.js";
 import { branchIdFromProps, fillSingleProject } from "../utils/enrichers.js";
-import { createProjectBranchBucket, deleteProjectBranchBucket, deleteProjectBranchBucketObject, deleteProjectBranchBucketObjectsByPrefix, getProjectBranchBucketObject, listProjectBranchBucketObjects, listProjectBranchBuckets, presignUpload } from "../storage_api.js";
 import { createReadStream, createWriteStream } from "node:fs";
 import { basename } from "node:path";
 import { stat, unlink } from "node:fs/promises";

package/dist/commands/config.js

@@ -10,12 +10,12 @@ import { editNeonConfig } from "../config_edit.js";
 import { toNeonConfigView } from "../config_format.js";
 import { declaredNeonServices } from "../config_services.js";
 import { loadEnvFileIntoProcess } from "../env_file.js";
+import { formatInstallCommand, installArgs, resolvePackageManager, runCommand } from "../utils/package_manager.js";
 import { writer } from "../writer.js";
 import { fillSingleProject, resolveBranchRef } from "../utils/enrichers.js";
 import { assertAiGatewayProvisionable, warnAiGateway } from "../utils/ai_gateway_notice.js";
 import { announceTargetBranch } from "../utils/branch_notice.js";
 import { renderAppliedChanges, renderBranchSettingConflicts, renderCustomDomainFollowup } from "../utils/config_diff.js";
-import { formatInstallCommand, installArgs, resolvePackageManager, runCommand } from "../utils/package_manager.js";
 import { bundleEntry } from "../utils/esbuild.js";
 import { readGitContext } from "../utils/git.js";
 import { resolveHookEnv, runDeployAfterHook, runDeployBeforeHook } from "../utils/hooks.js";

package/dist/commands/dev.js

@@ -13,8 +13,8 @@ import { existsSync, mkdirSync, rmSync, statSync, writeFileSync } from "node:fs"
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import chalk from "chalk";
-import { bundleAsIs, describeNativeFinding, findUndeclaredNativePackages, resolveEsbuildEntry } from "@neon/config-runtime";
 import { spawn, spawnSync } from "node:child_process";
+import { bundleAsIs, describeNativeFinding, findUndeclaredNativePackages, resolveEsbuildEntry } from "@neon/config-runtime";
 import { once } from "node:events";
 import { createServer } from "node:net";
 //#region src/commands/dev.ts

package/dist/commands/ip_allow.js

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { getCliName } from "../utils/cli_name.js";
+import { projectUpdateRequest } from "../parameters.gen.js";
 import { writer } from "../writer.js";
 import { fillSingleProject } from "../utils/enrichers.js";
-import { projectUpdateRequest } from "../parameters.gen.js";
 //#region src/commands/ip_allow.ts
 var ip_allow_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,

package/dist/commands/manifest.js

@@ -0,0 +1,316 @@
+import { getCliName } from "../utils/cli_name.js";
+import { Parser } from "yargs/helpers";
+//#region src/commands/manifest.ts
+/**
+* Every top-level command, in help order, with the metadata yargs needs to list and route it.
+* A command's module (and everything it imports) loads only when yargs selects that command,
+* so `neon --help` and `neon projects list` don't pay for `init`, `dev`, or `psql`.
+*
+* `command`, `aliases`, and `describe` must equal the module's own exports; `manifest.test.ts`
+* enforces that. `load` uses a literal specifier so bundlers can see and package each chunk.
+*/
+const commandManifest = [
+	{
+		command: "auth",
+		aliases: ["login"],
+		describe: "Sign in with a browser. See --help for API keys and profiles",
+		load: () => import("./auth.js")
+	},
+	{
+		command: "profile",
+		aliases: ["profiles"],
+		describe: "Manage named sets of Neon credentials",
+		load: () => import("./profile.js")
+	},
+	{
+		command: "api-keys",
+		aliases: ["api-key"],
+		describe: "Manage API keys",
+		load: () => import("./api_keys.js")
+	},
+	{
+		command: "api [path]",
+		describe: "Call any Neon API route directly (authenticated passthrough)",
+		load: () => import("./api.js")
+	},
+	{
+		command: "me",
+		describe: "Show current user",
+		load: () => import("./user.js")
+	},
+	{
+		command: "orgs",
+		aliases: ["org"],
+		describe: "Manage organizations",
+		load: () => import("./orgs.js")
+	},
+	{
+		command: "projects",
+		aliases: ["project"],
+		describe: "Manage projects",
+		load: () => import("./projects.js")
+	},
+	{
+		command: "ip-allow",
+		describe: "Manage IP Allow",
+		load: () => import("./ip_allow.js")
+	},
+	{
+		command: "vpc",
+		describe: "Manage VPC endpoints and project VPC restrictions",
+		load: () => import("./vpc_endpoints.js")
+	},
+	{
+		command: "neon-auth",
+		describe: "Manage Neon Auth",
+		load: () => import("./neon_auth.js")
+	},
+	{
+		command: "branches",
+		aliases: ["branch"],
+		describe: "Manage branches",
+		load: () => import("./branches.js")
+	},
+	{
+		command: "databases",
+		aliases: ["database", "db"],
+		describe: "Manage databases",
+		load: () => import("./databases.js")
+	},
+	{
+		command: "roles",
+		aliases: ["role"],
+		describe: "Manage roles",
+		load: () => import("./roles.js")
+	},
+	{
+		command: "operations",
+		aliases: ["operation"],
+		describe: "Manage operations",
+		load: () => import("./operations.js")
+	},
+	{
+		command: "logs",
+		describe: "Query branch logs",
+		load: () => import("./logs.js")
+	},
+	{
+		command: "snapshots",
+		aliases: ["snapshot"],
+		describe: "Manage snapshots",
+		load: () => import("./snapshots.js")
+	},
+	{
+		command: "inspect",
+		aliases: ["inspection"],
+		describe: "Inspect a branch's Postgres health and configuration",
+		load: () => import("./inspect.js")
+	},
+	{
+		command: "connection-string [branch]",
+		aliases: ["cs"],
+		describe: "Get connection string",
+		load: () => import("./connection_string.js")
+	},
+	{
+		command: "psql [branch]",
+		describe: "Connect to a database via psql",
+		load: () => import("./psql.js")
+	},
+	{
+		command: "set-context",
+		describe: `Deprecated: use \`${getCliName()} link\`. Set the .neon context (raw write).`,
+		load: () => import("./set_context.js")
+	},
+	{
+		command: "checkout [id|name]",
+		describe: "Pin a branch in the local context (.neon) so subsequent commands target it",
+		load: () => import("./checkout.js")
+	},
+	{
+		command: "git",
+		aliases: [],
+		describe: "Sync the checked-out Neon branch to your git branch (Preview)",
+		load: () => import("./git.js")
+	},
+	{
+		command: "link",
+		describe: "Link the current directory to a Neon project",
+		load: () => import("./link.js")
+	},
+	{
+		command: "open",
+		describe: "Open the linked project in the Neon Console",
+		load: () => import("./open.js")
+	},
+	{
+		command: "claim",
+		aliases: ["claimable"],
+		describe: "Create and claim temporary Neon projects",
+		load: () => import("./claim.js")
+	},
+	{
+		command: "init",
+		describe: "Set up coding agents and this directory for Neon. -y is Recommended. -y with Custom flags applies those answers without prompts.",
+		load: () => import("./init.js")
+	},
+	{
+		command: "mcp",
+		describe: "Install the Neon MCP server into coding agents",
+		load: () => import("./mcp.js")
+	},
+	{
+		command: "plugins",
+		aliases: ["plugin"],
+		describe: "Install the Neon plugin into coding agents",
+		load: () => import("./plugins.js")
+	},
+	{
+		command: "skills",
+		aliases: ["skill"],
+		describe: "Install Neon agent skills into coding agents",
+		load: () => import("./skills.js")
+	},
+	{
+		command: "ask",
+		describe: "Ask a question about Neon",
+		load: () => import("./ask.js")
+	},
+	{
+		command: "data-api",
+		describe: "Manage the Neon Data API for a database",
+		load: () => import("./data_api.js")
+	},
+	{
+		command: "functions",
+		aliases: ["function"],
+		describe: "Manage Neon Functions",
+		load: () => import("./functions.js")
+	},
+	{
+		command: "triggers",
+		aliases: ["trigger"],
+		describe: "Manage function triggers",
+		load: () => import("./triggers.js")
+	},
+	{
+		command: "credentials",
+		aliases: ["credential"],
+		describe: "Manage branch credentials",
+		load: () => import("./credentials.js")
+	},
+	{
+		command: "dev",
+		describe: "Run Neon Functions locally with a dev server",
+		load: () => import("./dev.js")
+	},
+	{
+		command: "diff [compare-branch]",
+		describe: "Show a git-style schema diff between the current branch and another branch",
+		load: () => import("./diff.js")
+	},
+	{
+		command: "config",
+		describe: "Manage a branch with a neon.ts policy",
+		load: () => import("./config.js")
+	},
+	{
+		command: "status",
+		describe: "Show the branch's live Neon state (alias of `config status`)",
+		load: () => import("./status.js")
+	},
+	{
+		command: "deploy",
+		describe: "Apply a neon.ts policy to a branch (alias for `config apply`)",
+		load: () => import("./deploy.js")
+	},
+	{
+		command: "env",
+		describe: "Manage a branch's Neon env variables locally",
+		load: () => import("./env.js")
+	},
+	{
+		command: "buckets",
+		aliases: ["bucket"],
+		describe: "Manage branch object-storage buckets and their objects",
+		load: () => import("./bucket.js")
+	},
+	{
+		command: "bootstrap [directory]",
+		describe: "Scaffold a new project from a Neon starter template, then install agent tooling and link a Neon project",
+		load: () => import("./bootstrap.js")
+	}
+];
+const COMPLETION_COMMAND = "completion";
+const COMPLETION_FLAG = "--get-yargs-completions";
+const verbOf = (entry) => entry.command.split(" ")[0];
+const entryByName = new Map(commandManifest.flatMap((entry) => [verbOf(entry), ...entry.aliases ?? []].map((name) => [name, entry])));
+/**
+* The command yargs 17 will run for these top-level positionals: it walks them in order,
+* skips `completion`, runs the first one that names a command, and stops at the first one
+* that doesn't (`kRunYargsParserAndExecuteCommands` in yargs-factory.js).
+*/
+const selectCommand = (positionals) => {
+	const first = positionals.find((p) => String(p) !== COMPLETION_COMMAND);
+	return first === void 0 ? void 0 : entryByName.get(String(first));
+};
+/**
+* The command whose builder yargs 17 runs to complete `--get-yargs-completions <words>`: the
+* first word that is a command's canonical name, at any position; aliases don't count there
+* (`defaultCompletion` in completion.js looks words up in the handler map, keyed by name).
+*/
+const selectCompletionCommand = (words) => words.map((word) => commandManifest.find((entry) => verbOf(entry) === word)).find((entry) => entry);
+function assertHasGetOptions(argv) {
+	if (!("getOptions" in argv) || typeof argv.getOptions !== "function") throw new Error("yargs no longer exposes getOptions(); update preloadCommand for the installed yargs");
+}
+const loaded = /* @__PURE__ */ new Map();
+/**
+* Import the module of the command yargs is about to run, before it runs, so its builder can
+* stay synchronous. Parses argv with yargs' own parser and the top-level options yargs will
+* use, so an option value that happens to be a command name (`--api-key projects`) can't
+* change the answer.
+*/
+const preloadCommand = async (cli, args) => {
+	const doubleDash = args.indexOf("--");
+	const completionAt = (doubleDash === -1 ? args : args.slice(0, doubleDash)).indexOf(COMPLETION_FLAG);
+	let entry;
+	if (completionAt >= 0) entry = selectCompletionCommand(args.slice(completionAt + 1));
+	else {
+		assertHasGetOptions(cli);
+		const options = cli.getOptions();
+		const { argv } = Parser.detailed([...args], {
+			...options,
+			configuration: {
+				...options?.configuration,
+				"populate--": true,
+				"parse-positional-numbers": false
+			}
+		});
+		entry = selectCommand(argv._);
+	}
+	if (entry && !loaded.has(entry)) loaded.set(entry, await entry.load());
+	return entry;
+};
+/**
+* The manifest as yargs command modules. The builder is synchronous when `preloadCommand`
+* already imported the module, which is every invocation it predicts correctly. A mispredicted
+* command still runs, because yargs 17 awaits a builder's promise when it runs a command; shell
+* completion does not await it, so a mispredicted completion lists no subcommands.
+*/
+const lazyCommands = commandManifest.map((entry) => ({
+	command: entry.command,
+	aliases: entry.aliases,
+	describe: entry.describe,
+	builder: (argv) => {
+		const mod = loaded.get(entry);
+		return mod ? mod.builder(argv) : entry.load().then((m) => {
+			loaded.set(entry, m);
+			return m.builder(argv);
+		});
+	},
+	handler: async (args) => {
+		return (loaded.get(entry) ?? await entry.load()).handler?.(args);
+	}
+}));
+//#endregion
+export { commandManifest, lazyCommands, preloadCommand, selectCommand, selectCompletionCommand };

package/dist/commands/mcp.js

@@ -4,11 +4,11 @@ import { readContextFile } from "../context.js";
 import { recordCommandSuccessExtras } from "../analytics.js";
 import { getCliName } from "../utils/cli_name.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
+import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpServer, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
+import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { writer } from "../writer.js";
 import { noPassthrough, single } from "../utils/flags.js";
 import { AGENT_MCP_SKIP_MESSAGE } from "../init/copy.js";
-import { NEON_MCP_CATEGORIES, NEON_MCP_URL, existingNeonApiKey, installNeonMcpServer, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
-import { mcpInstallableAgents, resolveInstallTargets } from "../mcp/targets.js";
 import { mintMcpApiKey, mintedKeyRevokeCommand, withdrawMintedKey } from "../mcp/mint.js";
 import { canPickAgentsInteractively, skippableAgentPicker } from "../utils/agent_picker.js";
 import { resolveMcpPlan } from "../mcp/plan.js";

package/dist/commands/plugins.js

@@ -2,13 +2,13 @@ import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { recordCommandSuccessExtras } from "../analytics.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { writer } from "../writer.js";
-import { noPassthrough } from "../utils/flags.js";
-import { AGENT_PLUGIN_SKIP_MESSAGE } from "../init/copy.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import { NEON_MCP_URL } from "../mcp/install.js";
 import "../init/agents.js";
 import { pluginsInstallableAgents } from "../plugins/targets.js";
+import { writer } from "../writer.js";
+import { noPassthrough } from "../utils/flags.js";
+import { AGENT_PLUGIN_SKIP_MESSAGE } from "../init/copy.js";
 import { canPickAgentsInteractively, skippableAgentPicker } from "../utils/agent_picker.js";
 import { resolvePluginsPlan } from "../plugins/plan.js";
 import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";

package/dist/commands/profile.js

@@ -11,10 +11,10 @@ import { auth, revokeToken } from "../auth.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { readOutgoingCredential, retirePreviousCredential, revokeTokenSet, withdrawKey } from "../retire_credential.js";
 import { authFlow, usableCredential } from "./auth.js";
+import { identityFromAuthDetails, isApiKeyMethod, mintedKeyName, notAnApiKeyMessage } from "../profile_keys.js";
 import { writer } from "../writer.js";
 import { noPassthrough, single } from "../utils/flags.js";
 import { orgIdForProject } from "./api_keys.js";
-import { identityFromAuthDetails, isApiKeyMethod, mintedKeyName, notAnApiKeyMessage } from "../profile_keys.js";
 import { existsSync, readFileSync, rmSync } from "node:fs";
 import { isAbsolute, relative } from "node:path";
 import prompts from "prompts";

package/dist/commands/projects.js

@@ -4,8 +4,8 @@ import { log } from "../log.js";
 import { isNeonApiError, messageFromBody } from "../api.js";
 import { updateContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
-import { writer } from "../writer.js";
 import { projectCreateRequest, projectUpdateRequest } from "../parameters.gen.js";
+import { writer } from "../writer.js";
 import { getComputeUnits } from "../utils/compute_units.js";
 import { psql } from "../utils/psql.js";
 import prompts from "prompts";

package/dist/commands/schema_diff.js

@@ -2,7 +2,7 @@ import { log } from "../log.js";
 import { isNeonApiError, messageFromBody } from "../api.js";
 import { sendError } from "../analytics.js";
 import { writer } from "../writer.js";
-import { branchIdFromProps, listAllProjectBranches } from "../utils/enrichers.js";
+import { listAllProjectBranchesWithAnnotations, resolveBranchFromProps } from "../utils/enrichers.js";
 import { parsePointInTime } from "../utils/point_in_time.js";
 import chalk from "chalk";
 import { createPatch } from "diff";
@@ -15,12 +15,14 @@ const COLORS = {
 };
 const schemaDiff = async (props) => {
 	props.branch = props.baseBranch || props.branch;
-	const baseBranch = await branchIdFromProps(props);
+	const { branchId: baseBranch, branch: baseBranchData, listing } = await resolveBranchFromProps(props, props.branchListing);
 	let pointInTime = await parsePointInTime({
 		pointInTime: props.compareSource,
 		targetBranchId: baseBranch,
 		projectId: props.projectId,
-		api: props.apiClient
+		api: props.apiClient,
+		branches: listing?.branches,
+		targetBranch: baseBranchData
 	});
 	const comparingWithParent = props.compareSource.startsWith("^parent");
 	let baseBranchPoint = {
@@ -32,21 +34,35 @@ const schemaDiff = async (props) => {
 	if (props.database) {
 		const database = baseDatabases.find((db) => db.name === props.database);
 		if (!database) throw new Error(`Database ${props.database} does not exist in base branch ${baseBranch}`);
-		const patch = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
-		writer(props).text(colorize(patch));
+		const diff = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
+		writer(props).text(colorize(diff.patch));
+		reportUnchanged(diff, [baseBranchPoint, pointInTime], database, props, listing);
 		return;
 	}
 	await Promise.all(baseDatabases.map(async (database) => {
-		const patch = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
-		writer(props).text(colorize(patch));
+		const diff = await createSchemaDiff(baseBranchPoint, pointInTime, database, props);
+		writer(props).text(colorize(diff.patch));
+		reportUnchanged(diff, [baseBranchPoint, pointInTime], database, props, listing);
 	}));
 };
+/** The patch alone is two header lines when nothing differs, which reads like missing output. */
+const reportUnchanged = (diff, [base, compare], database, props, listing) => {
+	if (!diff.unchanged || props.output !== "table") return;
+	const label = (point) => {
+		const name = listing?.branches.find((b) => b.id === point.branchId)?.name ?? point.branchId;
+		return point.tag === "lsn" ? `${name} at ${point.lsn}` : point.tag === "timestamp" ? `${name} at ${point.timestamp}` : name;
+	};
+	log.info(`No schema differences for database ${database.name} between ${label(base)} and ${label(compare)}.`);
+};
 const fetchDatabases = async (branch, props) => {
 	return props.apiClient.listProjectBranchDatabases(props.projectId, branch).then((response) => response.data.databases);
 };
 const createSchemaDiff = async (baseBranch, pointInTime, database, props) => {
 	const [baseSchema, compareSchema] = await Promise.all([fetchSchema(baseBranch, database, props), fetchSchema(pointInTime, database, props)]);
-	return createPatch(`Database: ${database.name}`, baseSchema, compareSchema, generateHeader(baseBranch), generateHeader(pointInTime));
+	return {
+		patch: createPatch(`Database: ${database.name}`, baseSchema, compareSchema, generateHeader(baseBranch), generateHeader(pointInTime)),
+		unchanged: baseSchema === compareSchema
+	};
 };
 const fetchSchema = async (pointInTime, database, props) => {
 	try {
@@ -68,6 +84,7 @@ const colorize = (patch) => {
 	return patch.replace(/^([^\n]+)\n([^\n]+)\n/m, "").replace(/^-.*/gm, colorizer("removed")).replace(/^\+.*/gm, colorizer("added")).replace(/^@@.+@@.*/gm, colorizer("section"));
 };
 const colorizer = (colorId) => {
+	if (process.env.NO_COLOR) return (line) => line;
 	const color = COLORS[colorId];
 	return (line) => color(line);
 };
@@ -92,11 +109,13 @@ const parseSchemaDiffParams = async (props) => {
 			props.compareSource = props.baseBranch;
 			props.baseBranch = props.branch;
 		} else if (props.branch) {
-			if ((await listAllProjectBranches(props.apiClient, props.projectId)).find((b) => b.id === props.branch || b.name === props.branch)?.parent_id == void 0) throw new Error(`No branch specified. Your context branch (${props.branch}) has no parent, so no comparison is possible.`);
+			props.branchListing = await listAllProjectBranchesWithAnnotations(props.apiClient, props.projectId);
+			if (props.branchListing.branches.find((b) => b.id === props.branch || b.name === props.branch)?.parent_id == void 0) throw new Error(`No branch specified. Your context branch (${props.branch}) has no parent, so no comparison is possible.`);
 			log.info(`No branches specified. Comparing your context branch '${props.branch}' with its parent`);
 			props.compareSource = "^parent";
 		} else {
-			if ((await listAllProjectBranches(props.apiClient, props.projectId)).find((b) => b.default)?.parent_id == void 0) throw new Error("No branch specified. Include a base branch or add a set-context branch to continue. Your default branch has no parent, so no comparison is possible.");
+			props.branchListing = await listAllProjectBranchesWithAnnotations(props.apiClient, props.projectId);
+			if (props.branchListing.branches.find((b) => b.default)?.parent_id == void 0) throw new Error("No branch specified. Include a base branch or add a set-context branch to continue. Your default branch has no parent, so no comparison is possible.");
 			log.info(`No branches specified. Comparing default branch with its parent`);
 			props.compareSource = "^parent";
 		}

package/dist/commands/skills.js

@@ -2,12 +2,12 @@ import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { recordCommandSuccessExtras } from "../analytics.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { writer } from "../writer.js";
-import { noPassthrough } from "../utils/flags.js";
-import { AGENT_SKILLS_SKIP_MESSAGE } from "../init/copy.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import "../init/agents.js";
 import { mappedSkillsAgentNames, skillsInstallableAgents } from "../skills/targets.js";
+import { writer } from "../writer.js";
+import { noPassthrough } from "../utils/flags.js";
+import { AGENT_SKILLS_SKIP_MESSAGE } from "../init/copy.js";
 import { canPickAgentsInteractively, skippableAgentPicker } from "../utils/agent_picker.js";
 import { skillsHelpValues, skillsYesHelp } from "../skills/catalog.js";
 import { confirmSkillsUpdate } from "../skills/wizard.js";

package/dist/human_table.js

@@ -22,8 +22,11 @@ function parseColumns(value) {
 	if (!Number.isFinite(n) || n <= 0) return;
 	return n;
 }
+function stripAnsi(s) {
+	return s.replace(ANSI_RE, "");
+}
 function displayWidth(s) {
-	const plain = s.replace(ANSI_RE, "");
+	const plain = stripAnsi(s);
 	let width = 0;
 	for (const char of plain) {
 		const code = char.codePointAt(0);
@@ -203,4 +206,4 @@ function charWidth(code) {
 	return 1;
 }
 //#endregion
-export { displayWidth, formatHumanChunk, parseColumns, resolveOutputWidth };
+export { displayWidth, formatHumanChunk, parseColumns, resolveOutputWidth, stripAnsi };

package/dist/index.js

@@ -12,8 +12,8 @@ import { getCliName } from "./utils/cli_name.js";
 import { ensureAuth } from "./commands/auth.js";
 import { recoverFrom401 } from "./auth_recovery.js";
 import { UsageError, failOnUsageError, isBareParentCommand, showHelp, showUsageErrorHelp } from "./help.js";
+import { lazyCommands, preloadCommand } from "./commands/manifest.js";
 import { rewriteUnknownAgentArg } from "./init/plan.js";
-import commands_default from "./commands/index.js";
 import { recoverFromSSO } from "./sso_recovery.js";
 import { notifyIfUpdateAvailable } from "./update_notifier.js";
 import { fillInArgs, resolveApiKeyFromEnv } from "./utils/middlewares.js";
@@ -128,7 +128,7 @@ builder = builder.scriptName(pkg_default.name).locale("en").usage("$0 <command>
 	if (args.help) await showHelp(builder);
 }, true).middleware(async (args) => {
 	if (args._.length === 1 && !NO_SUBCOMMANDS_VERBS.includes(args._[0]) || args._.length > 1 && isBareParentCommand(builder, args._)) await showHelp(builder);
-}).middleware(ensureAuth).middleware(enrichFromContext).middleware(analyticsMiddleware).command(commands_default).strictCommands().version(pkg_default.version).group("version", "Global options:").alias("version", "v").completion().scriptName(getCliName()).epilog("For more information, visit https://neon.com/docs/reference/neon-cli").wrap(null).fail(failOnUsageError);
+}).middleware(ensureAuth).middleware(enrichFromContext).middleware(analyticsMiddleware).command(lazyCommands).strictCommands().version(pkg_default.version).group("version", "Global options:").alias("version", "v").completion().scriptName(getCliName()).epilog("For more information, visit https://neon.com/docs/reference/neon-cli").wrap(null).fail(failOnUsageError);
 async function handleError(msg, err, canRetry) {
 	if (process.argv.some((arg) => arg === "--help" || arg === "-h")) {
 		await showHelp(builder);
@@ -194,6 +194,7 @@ async function handleError(msg, err, canRetry) {
 (async () => {
 	let attempts = 0;
 	const MAX_ATTEMPTS = 2;
+	await preloadCommand(builder, hideBin(process.argv));
 	while (attempts < MAX_ATTEMPTS) try {
 		const args = await builder.argv;
 		trackEvent("cli_command_success", commandSuccessProperties(args));

package/dist/init/mode.js

@@ -1,5 +1,5 @@
-import { NON_TTY_AGENT_SETUP, NO_AGENT_SETUP_CONFLICT } from "./copy.js";
 import { INIT_NEEDS_YES_OR_TERMINAL } from "./plan.js";
+import { NON_TTY_AGENT_SETUP, NO_AGENT_SETUP_CONFLICT } from "./copy.js";
 //#region src/init/mode.ts
 const hasInitMcpFlags = (input) => input.mcpConfigLocation !== void 0 || input.mcpAuth !== void 0 || input.mcpProjectScoped === true;
 const hasSkillsFlag = (skills) => skills !== void 0 && skills.length > 0;

package/dist/init/run.js

@@ -8,16 +8,16 @@ import { readLinkedClaimableCredentials } from "../claimable/state.js";
 import { getCliName } from "../utils/cli_name.js";
 import { deprecatedServiceMessage, parseServices, servicesFlagValue } from "../neon_services.js";
 import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES, CONFIG_INIT_UNAVAILABLE } from "../config_template.js";
-import { CANCELLED_BODY, CLAIMABLE_ACCOUNT_FLAGS, CLAIMABLE_ALREADY_LINKED, CLAIMABLE_MCP_API_KEY, CLAIMABLE_NO_LINK, MCP_SCOPED_NEEDS_PROJECT, NON_TTY_LINK_NEEDS_AUTH, NO_AGENTS_FALLBACK_STATUS, PROGRESS, YES_LINK_NEEDS_AUTH, claimableNext, claimableThenServicesNext, envPullFailedNext, existingConfigNext, extraServicesNext, installFailedNext, mcpConfigLocationSkipped, mcpConfigLocationUnavailable, namedAgentsUnavailable, skippedLinkNext, unattendedUnauthedNext } from "./copy.js";
-import { agentsRowValue, configRowValue, formatInitDone, headingForKind, printInitBanner, printInitDone, printInitProgress, projectRowValue, shouldPrintInitBanner } from "./chrome.js";
-import { inferPackageManager, resolvePackageManager } from "../utils/package_manager.js";
-import { ConfigInstallFailed, hasNeonConfigFile, initCmd, neonConfigFilename } from "../commands/config.js";
-import { runAuthenticatedLink } from "./link.js";
 import { getAgentDisplayName } from "../mcp/agents.js";
 import { mcpInstallableAgents } from "../mcp/targets.js";
 import { missingPluginsCommands, pluginsInstallableAgents } from "../plugins/targets.js";
 import { skillsInstallableAgents } from "../skills/targets.js";
 import { FALLBACK_SKILLS_AGENTS, assertNamedAgentTooling, funnelAgentSetup, planInitToolingSteps, recommendedTooling, resolveNamedAgents, splitInitTooling } from "./plan.js";
+import { inferPackageManager, resolvePackageManager } from "../utils/package_manager.js";
+import { CANCELLED_BODY, CLAIMABLE_ACCOUNT_FLAGS, CLAIMABLE_ALREADY_LINKED, CLAIMABLE_MCP_API_KEY, CLAIMABLE_NO_LINK, MCP_SCOPED_NEEDS_PROJECT, NON_TTY_LINK_NEEDS_AUTH, NO_AGENTS_FALLBACK_STATUS, PROGRESS, YES_LINK_NEEDS_AUTH, claimableNext, claimableThenServicesNext, envPullFailedNext, existingConfigNext, extraServicesNext, installFailedNext, mcpConfigLocationSkipped, mcpConfigLocationUnavailable, namedAgentsUnavailable, skippedLinkNext, unattendedUnauthedNext } from "./copy.js";
+import { agentsRowValue, configRowValue, formatInitDone, headingForKind, printInitBanner, printInitDone, printInitProgress, projectRowValue, shouldPrintInitBanner } from "./chrome.js";
+import { ConfigInstallFailed, hasNeonConfigFile, initCmd, neonConfigFilename } from "../commands/config.js";
+import { runAuthenticatedLink } from "./link.js";
 import { pullInitEnv } from "./auth.js";
 import { InitCancelled, raceSigint, restoreCursor } from "./cancelled.js";
 import { pickAgentSetupInteractively, pickInitAgentsInteractively, pickInitConfigInteractively, pickInitMcpAuthInteractively, pickInitMcpConfigLocationInteractively, pickInitModeInteractively, pickInitPackageManagerInteractively, pickInitProjectSetupInteractively, pickInitServicesInteractively, pickInitSkillsInteractively } from "./wizard.js";

package/dist/init/tooling.js

@@ -1,7 +1,7 @@
 import { log } from "../log.js";
 import { getCliName } from "../utils/cli_name.js";
-import { PROGRESS } from "./copy.js";
 import { assertNamedAgentTooling, chooseYesAgentTooling, collectYesAgents, initYesSupportedAgents, noDetectedAgentsMessage, planAgentSteps, planToolingSteps, planYesAgentSteps, resolveInitAgentSetup } from "./plan.js";
+import { PROGRESS } from "./copy.js";
 import { detectAgent } from "./detect_host.js";
 import { AgentSelectionSkipped, canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { mcpInstallError, reportMcpInstall } from "../commands/mcp.js";

package/dist/init/wizard.js

@@ -1,9 +1,9 @@
 import { CONFIG_INIT_SERVICES } from "../config_template.js";
-import { AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_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, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, 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, agentMissingCommandDescription } 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 { installedPackageManagers } from "../utils/package_manager.js";
+import { AGENT_DETECTED_DESCRIPTION, AGENT_MCP_PICKER_MESSAGE, AGENT_MCP_SKIP_MESSAGE, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_PLUGIN_SKIP_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, AGENT_SKILLS_PICKER_MESSAGE, AGENT_SKILLS_SKIP_MESSAGE, 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, agentMissingCommandDescription } from "./copy.js";
+import { POSTGRES_SERVICE_CHOICE, keepPostgresSelected } from "../utils/service_picker.js";
 import { canPickAgentsInteractively, pickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_SKILL_CATALOG, listSkillIds } from "../skills/catalog.js";
 import { InitCancelled, restoreCursorVisibilityOnAbort } from "./cancelled.js";

package/dist/mcp/install.js

@@ -1,7 +1,7 @@
 import { chmodSync, existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
-import { execFileSync } from "node:child_process";
 import { agents, upsertServer } from "add-mcp";
+import { execFileSync } from "node:child_process";
 //#region src/mcp/install.ts
 const NEON_MCP_URL = "https://mcp.neon.tech/mcp";
 const NEON_MCP_NAME = "Neon";

package/dist/mcp/mint.js

@@ -1,8 +1,8 @@
 import { log } from "../log.js";
 import { isNeonApiError } from "../api.js";
 import { getCliName } from "../utils/cli_name.js";
-import { orgIdForProject } from "../commands/api_keys.js";
 import { mintedKeyName } from "../profile_keys.js";
+import { orgIdForProject } from "../commands/api_keys.js";
 //#region src/mcp/mint.ts
 const cannotMintMessage = "This CLI credential cannot mint API keys. Organization and project-scoped keys cannot create other keys. Sign in with `neon auth` or pass a personal API key.";
 function mintedKeyRevokeCommand(key) {

package/dist/plugins/targets.js

@@ -1,8 +1,8 @@
 import { detectInstalledAgents, listMcpAgentIds, tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
 import "../init/agents.js";
 import { delimiter, dirname, join, resolve } from "node:path";
-import which from "which";
 import { detectProjectAgents } from "add-mcp";
+import which from "which";
 //#region src/plugins/targets.ts
 const CLAUDE_CODE = { target: "claude-code" };
 const PLUGINS_TARGET_BY_TYPE = {

package/dist/test_utils/fixtures.js

@@ -26,8 +26,15 @@ const reserveClosedPort = () => new Promise((resolve, reject) => {
 const test = test$1.extend({
 	runMockServer: async ({}, use) => {
 		let startedServer;
-		await use(async (mockDir) => {
+		await use(async (mockDir, onRequest) => {
 			const app = express();
+			if (onRequest) app.use((req, _res, next) => {
+				onRequest({
+					method: req.method,
+					path: req.path
+				});
+				next();
+			});
 			app.use(express.json());
 			app.use("/", emocks(join(process.cwd(), "mocks", mockDir), { "404": (_req, res) => res.status(404).send({ message: "Not Found" }) }));
 			const server = await new Promise((resolve) => {

package/dist/update_notifier.js

@@ -1,8 +1,8 @@
 import { isCi } from "./env.js";
 import { log } from "./log.js";
-import { detectCliInstallMethod, recommendedCliUpgradeCommand } from "./utils/package_manager.js";
 import { writeJsonFile } from "./utils/json_file.js";
 import { showNotice } from "./notices.js";
+import { detectCliInstallMethod, recommendedCliUpgradeCommand } from "./utils/package_manager.js";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/utils/enrichers.js

@@ -7,8 +7,9 @@ const BRANCHES_LIST_LIMIT = 100;
 * Branch list pages cap at 100. A name stored in `.neon` can live on a later
 * page, so resolution has to walk `pagination.next` before treating it as missing.
 */
-const listAllProjectBranches = async (apiClient, projectId) => {
-	const result = [];
+const listAllProjectBranchesWithAnnotations = async (apiClient, projectId) => {
+	const branches = [];
+	const annotations = {};
 	let cursor;
 	while (true) {
 		const { data } = await apiClient.listProjectBranches({
@@ -16,16 +17,21 @@ const listAllProjectBranches = async (apiClient, projectId) => {
 			limit: BRANCHES_LIST_LIMIT,
 			cursor
 		});
-		result.push(...data.branches);
+		branches.push(...data.branches);
+		Object.assign(annotations, data.annotations);
 		cursor = data.pagination?.next;
 		if (!cursor || data.branches.length === 0) break;
 	}
-	return result;
+	return {
+		branches,
+		annotations
+	};
 };
-const branchIdResolve = async ({ branch, apiClient, projectId }) => {
+const listAllProjectBranches = async (apiClient, projectId) => (await listAllProjectBranchesWithAnnotations(apiClient, projectId)).branches;
+const branchIdResolve = async ({ branch, apiClient, projectId, branches: listed }) => {
 	branch = branch.toString();
 	if (looksLikeBranchId(branch)) return branch;
-	const branches = await listAllProjectBranches(apiClient, projectId);
+	const branches = listed ?? await listAllProjectBranches(apiClient, projectId);
 	const branchData = branches.find((b) => b.name === branch);
 	if (!branchData) throw new Error(`Branch ${branch} not found.\nAvailable branches: ${branches.map((b) => b.name).join(", ")}`);
 	return branchData.id;
@@ -45,6 +51,33 @@ const branchIdFromProps = async (props) => {
 	props.branchId = await getBranchIdFromProps(props);
 	return props.branchId;
 };
+/**
+* {@link branchIdFromProps}, plus whatever the resolution already fetched: a name or the
+* default branch is resolved from a listing, so the branch object and the listing come back
+* with the id and callers need not fetch them again. An explicit `br-…` id is not listed.
+*/
+const resolveBranchFromProps = async (props, known) => {
+	const ref = typeof props.branch === "string" ? props.branch : props.id;
+	const explicit = ref ? String(ref) : void 0;
+	if (explicit !== void 0 && looksLikeBranchId(explicit)) {
+		props.branchId = explicit;
+		const branch = known?.branches.find((b) => b.id === explicit);
+		return branch ? {
+			branchId: explicit,
+			branch,
+			listing: known
+		} : { branchId: explicit };
+	}
+	const listing = known ?? await listAllProjectBranchesWithAnnotations(props.apiClient, props.projectId);
+	const branch = explicit === void 0 ? listing.branches.find((b) => b.default) : listing.branches.find((b) => b.name === explicit);
+	if (!branch) throw new Error(explicit === void 0 ? "No default branch found" : `Branch ${explicit} not found.\nAvailable branches: ${listing.branches.map((b) => b.name).join(", ")}`);
+	props.branchId = branch.id;
+	return {
+		branchId: branch.id,
+		branch,
+		listing
+	};
+};
 const resolveBranchRef = async (props) => {
 	const branch = typeof props.branch === "string" ? props.branch : props.id;
 	const branches = await listAllProjectBranches(props.apiClient, props.projectId);
@@ -130,4 +163,4 @@ const fillSingleOrg = async (props) => {
 	};
 };
 //#endregion
-export { branchIdFromProps, branchIdResolve, fillSingleOrg, fillSingleProject, listAllProjectBranches, resolveBranchRef, resolveSingleDatabase };
+export { branchIdFromProps, branchIdResolve, fillSingleOrg, fillSingleProject, listAllProjectBranches, listAllProjectBranchesWithAnnotations, resolveBranchFromProps, resolveBranchRef, resolveSingleDatabase };

package/dist/utils/point_in_time.js

@@ -28,19 +28,19 @@ const parsePITBranch = (input) => {
 	}
 	return result;
 };
-const parsePointInTime = async ({ pointInTime, targetBranchId, projectId, api }) => {
+const parsePointInTime = async ({ pointInTime, targetBranchId, projectId, api, branches, targetBranch }) => {
 	const parsedPIT = parsePITBranch(pointInTime);
 	let branchId = "";
 	if (parsedPIT.branch === "^self") branchId = targetBranchId;
 	else if (parsedPIT.branch === "^parent") {
-		const { data } = await api.getProjectBranch(projectId, targetBranchId);
-		const { parent_id: parentId } = data.branch;
+		const parentId = (targetBranch?.id === targetBranchId ? targetBranch : (await api.getProjectBranch(projectId, targetBranchId)).data.branch).parent_id;
 		if (parentId == null) throw new PointInTimeParseError("Branch has no parent");
 		branchId = parentId;
 	} else branchId = await branchIdResolve({
 		branch: parsedPIT.branch,
 		projectId,
-		apiClient: api
+		apiClient: api,
+		branches
 	});
 	delete parsedPIT.branch;
 	return {

package/dist/writer.js

@@ -1,6 +1,6 @@
 import { isCi } from "./env.js";
 import { toSnakeCase } from "./utils/string.js";
-import { formatHumanChunk, resolveOutputWidth } from "./human_table.js";
+import { formatHumanChunk, resolveOutputWidth, stripAnsi } from "./human_table.js";
 import YAML from "yaml";
 //#region src/writer.ts
 const writeYaml = (chunks) => {
@@ -11,17 +11,20 @@ const writeJson = (chunks) => {
 	return json === void 0 ? json : `${json}\n`;
 };
 const writeTable = (chunks, out, width) => {
+	const noColor = Boolean(process.env.NO_COLOR);
 	chunks.forEach(({ data, config }, i) => {
-		out.write(formatHumanChunk({
+		const title = config.humanTitle ?? config.title;
+		const text = formatHumanChunk({
 			data,
 			fields: config.fields,
-			title: config.title,
+			title,
 			emptyMessage: config.emptyMessage,
 			renderColumns: config.renderColumns,
 			width,
 			colorTitle: !isCi(),
-			leadingBlank: i > 0 && Boolean(config.title)
-		}));
+			leadingBlank: i > 0 && Boolean(title)
+		});
+		out.write(noColor ? stripAnsi(text) : text);
 	});
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "7.0.2",
+  "version": "7.0.4",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -64,9 +64,9 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
+    "@neon/config-runtime": "1.7.3",
     "@neon/config": "1.8.3",
-    "@neon/sdk": "7.0.0",
-    "@neon/config-runtime": "1.7.3"
+    "@neon/sdk": "7.0.0"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",
@@ -134,6 +134,9 @@
     "test": "pnpm --filter neonctl... build && vitest run",
     "test:ci": "pnpm build && vitest run",
     "test:e2e": "pnpm build && vitest run --config vitest.e2e.config.ts",
+    "test:perf": "pnpm --filter neon... build && vitest run src/perf_budget.test.ts",
+    "perf": "tsx scripts/perf/perf.ts",
+    "perf:ci-report": "tsx scripts/perf/ci-report.ts",
     "test:conformance": "vitest run --config tests/psql-conformance/vitest.config.ts"
   }
 }