neon 4.10.0 → 4.10.2

package/README.md

@@ -683,7 +683,7 @@ When a package cannot be bundled — a native addon with no esbuild loader, or a
 
 `neon bootstrap` copies a Neon starter template into a new (or current) directory — conceptually like `degit`, but it only pulls from a small set of templates we maintain in the public [`neondatabase/examples`](https://github.com/neondatabase/examples) repo. The template copy needs no Neon login: it downloads files from GitHub.
 
-After scaffolding, an interactive terminal offers agent tooling (the Neon plugin, or skills and MCP separately — never both) and then `neon link`. `--default` / `-y` skips the template, install, git, and agent pickers, then runs `link --yes`. `link --yes` still asks for a project unless one is already linked. `--no-agent-setup` and `--no-link` skip those. Non-interactive without `--default` prints next steps and does not install, set up agents, or link.
+After scaffolding, an interactive terminal asks about dependency install, git, agent tooling (the Neon plugin, or skills and MCP separately — never both), and `neon link` before running those steps. Dependency install is last, except when the template has a `neon.ts` and you chose to link — then install runs first so link can pull env. `--default` / `-y` skips the template, install, git, and agent pickers, then runs `link --yes`. `link --yes` still asks for a project unless one is already linked. `--no-agent-setup` and `--no-link` skip those. Non-interactive without `--default` prints next steps and does not install, set up agents, or link.
 
 Pass a target directory (or `.` for the current one). In an interactive terminal you pick the template from a list; in CI / non-interactive contexts pass `--template <id>`.
 
@@ -707,7 +707,7 @@ The target directory must be empty unless you pass `--force` (a lone `.git` is i
 
 `neon init` sets up this directory for Neon.
 
-An empty directory (nothing except `.git`) runs `neon bootstrap .` and stops. With `-y` that is `neon bootstrap . --default`. Bootstrap handles scaffolding, agent tooling, and linking.
+An empty directory (nothing except `.git`) runs `neon bootstrap .` and stops. With `-y` that is `neon bootstrap . --default`. Bootstrap handles scaffolding, agent tooling, and linking. Interactive bootstrap prints a NEON banner, asks every setup question, then runs the work — dependency install last, except when a `neon.ts` needs deps before `link`.
 
 An existing app installs agent tooling, then `neon link` unless `.neon` already has a projectId, then `neon config init`. Interactive `config init` opens the services picker; `-y` uses `--services none` (starter policy).
 
@@ -791,7 +791,7 @@ On a TTY the command asks which agents and which skills, then shows a summary to
 
 `-y` skips those questions and installs the default skills. `--skill` / `-s` names specific skills and skips the skill picker. `--agent` and `--global` still apply. Without a TTY, pass `-y` or `--skill`. `--agent` alone is not enough.
 
-`--skill` names by source repo: `neondatabase/agent-skills` (`claimable-postgres`, `neon`, `neon-ai-gateway`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`); `neondatabase/neon-for-agent-platforms` (`neon-postgres-agent-platforms`).
+`--skill` names by source repo: `neondatabase/agent-skills` (`neon`, `neon-ai-gateway`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`); `neondatabase/neon-for-agent-platforms` (`neon-postgres-agent-platforms`).
 
 `--agent` names match `neon mcp`, minus agents that cannot install skills: `antigravity`, `cline`, `cline-cli`, `claude-code`, `claude-desktop`, `codex`, `cursor`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `opencode`, `vscode`, `windsurf`, `zed`. `mcporter` is a known MCP name that is then skipped. `neon skills --help` lists the same skill and agent values, and that `-y` leaves out `neon-postgres-agent-platforms`.
 
@@ -821,7 +821,7 @@ Default scope is `project`. `--global` is `user`. On macOS and Linux, Cursor and
 
 `--agent` names with a plugins mapping: `claude-code`, `claude-desktop`, `codex`, `cursor`, `github-copilot-cli`, `grok-build`, `vscode`. `claude-desktop` installs as Claude Code; naming both produces one install and lists both names in the table. `mcporter` is a known MCP name that is then skipped.
 
-The plugins CLI installs every plugin it finds in the Neon plugin package. Today that is `neon-postgres` from `neondatabase/agent-skills`. It includes the Neon MCP server (`https://mcp.neon.tech/mcp`) and these skills: `neon`, `neon-ai-gateway`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`. It does not include `claimable-postgres` or `neon-postgres-agent-platforms`.
+The plugins CLI installs every plugin it finds in the Neon plugin package. Today that is `neon-postgres` from `neondatabase/agent-skills`. It includes the Neon MCP server (`https://mcp.neon.tech/mcp`) and these skills: `neon`, `neon-ai-gateway`, `neon-functions`, `neon-object-storage`, `neon-postgres`, `neon-postgres-branches`, `neon-postgres-egress-optimizer`. It does not include `neon-postgres-agent-platforms`.
 
 `neon plugins --help` lists the plugin, those contents, and the supported `--agent` names.
 
@@ -871,7 +871,7 @@ All sub-commands honor the [global options](#global-options), including `--outpu
 
 ## Database diagnostics (`inspect`)
 
-`neon inspect db stalled-queries` takes a read-only snapshot of active queries that have run for more than 30 seconds and groups parallel workers with their leader. Table output shows duration, wait event, blocking pids, role, query group, and query. `--output json` adds timestamps, query IDs, pids, database, and the rest of the row. A blocking pid can belong to an idle-in-transaction backend this command does not list; `neon inspect db locks` shows lock holders.
+`neon inspect db stalled-queries` takes a read-only snapshot of active queries that have run for more than 30 seconds and groups parallel workers with their leader. Oldest group first. Table output shows duration, wait event, blocking pids, role, query group, and query. `--output json` adds timestamps, query IDs, pids, database, and the rest of the row. A blocking pid can belong to an idle-in-transaction backend this command does not list; `neon inspect db locks` shows lock holders.
 
 ```bash
 neon inspect db stalled-queries

package/dist/commands/bootstrap.js

@@ -6,8 +6,10 @@ import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { writer } from "../writer.js";
 import { FALLBACK_TEMPLATES, ensureTargetUsable, fetchTemplates, findTemplate, scaffoldTemplate, templateIds } from "../init/bootstrap.js";
 import { spawnCliChild } from "../init/child.js";
-import { projectContextFile } from "../init/plan.js";
-import { runScaffoldFollowUp } from "../init/tooling.js";
+import { agentSetupDoneLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
+import { postScaffoldActions, projectContextFile } from "../init/plan.js";
+import { pickAgentSetupInteractively } from "../init/wizard.js";
+import { runAgentTooling, runInitSteps } from "../init/tooling.js";
 import { formatInstallCommand, inferPackageManager, installArgs, installedPackageManagers, resolvePackageManager, runCommand } from "../utils/package_manager.js";
 import { existsSync } from "node:fs";
 import { join, relative, resolve } from "node:path";
@@ -63,7 +65,7 @@ const builder = (argv) => argv.usage("$0 bootstrap [directory] [options]").posit
 		default: true
 	},
 	link: {
-		describe: `Run \`${getCliName()} link\` in the scaffolded directory after installing. In interactive mode this is offered as a prompt; use --no-link to skip without being asked.`,
+		describe: `Run \`${getCliName()} link\` after scaffolding. Templates with neon.ts link after install so env pull works; otherwise link runs before install. In interactive mode this is offered as a prompt; use --no-link to skip without being asked.`,
 		type: "boolean",
 		default: true
 	},
@@ -99,6 +101,7 @@ const handler = async (props) => {
 		}
 		return;
 	}
+	if (shouldPrintInitBanner(props.default)) printInitBanner();
 	const templates = await resolveTemplateList(props);
 	const interactive = !props.default && Boolean(process.stdout.isTTY) && !isCi();
 	const template = await resolveSelectedTemplate(props, interactive, templates);
@@ -106,7 +109,7 @@ const handler = async (props) => {
 	ensureTargetUsable(targetDir, props.force);
 	await scaffold(template, targetDir);
 	printScaffolded(template, targetDir);
-	await runPostScaffoldSteps(props, targetDir, interactive);
+	await runPostScaffoldSteps(props, targetDir, interactive, template);
 };
 /**
 * The template list to choose from. When --template is given we try the
@@ -179,84 +182,150 @@ const scaffold = async (template, targetDir) => {
 	log.info("Scaffolded %d files into %s.", filesWritten, targetDir);
 	return filesWritten;
 };
-const runPostScaffoldSteps = async (props, targetDir, interactive) => {
+const runPostScaffoldSteps = async (props, targetDir, interactive, template) => {
 	const inferred = inferPackageManager(targetDir);
 	const defaultPm = resolvePackageManager(targetDir);
+	const neonConfig = hasNeonConfig(targetDir);
 	if (props.default) {
-		await runDefaultSteps(props, targetDir, defaultPm);
+		await runDefaultSteps(props, targetDir, defaultPm, neonConfig, template);
 		return;
 	}
 	if (!interactive) {
-		printNextSteps(targetDir, defaultPm, {
+		printDoneSummary({
+			heading: "Project scaffolded.",
+			template,
+			targetDir,
+			pm: defaultPm,
 			installed: false,
-			suggestLink: true
+			installFailed: false,
+			gitFailed: false,
+			git: false,
+			agentSetup: "skip",
+			linked: false,
+			skippedLinkForDeps: false,
+			suggestLink: true,
+			agentsRan: false
 		});
 		return;
 	}
 	let pm = defaultPm;
-	let installed = false;
-	if (props.install && await confirm(installPrompt(inferred))) {
-		pm = inferred ?? await selectPackageManager();
-		installed = await runCommand(pm, installArgs(pm), targetDir);
-	}
-	if (props.git && !isGitRepo(targetDir) && await confirm("Initialize a git repository?")) await initGitRepo(targetDir);
-	const skipLink = shouldSkipLinkForDeps(targetDir, installed);
-	if (props.link && skipLink) logSkippedLink(pm);
-	const kids = bootstrapChildren(props, targetDir);
-	await runScaffoldFollowUp({
-		cwd: targetDir,
+	const wantInstall = props.install && await confirm(installPrompt(inferred));
+	if (wantInstall) pm = inferred ?? await selectPackageManager();
+	const wantGit = props.git && !isGitRepo(targetDir) && await confirm("Initialize a git repository?");
+	const agentSetup = props.agentSetup === false ? "skip" : await (props.pickAgentSetup ?? pickAgentSetupInteractively)();
+	const canLink = props.link && !(neonConfig && !wantInstall);
+	if (props.link && !canLink) logSkippedLink(pm);
+	const wantLink = canLink && await confirm(`Link this project to a Neon project now? (runs ${getCliName()} link)`);
+	const outcome = await executePostScaffold(props, targetDir, {
 		yes: false,
-		skipAgentSetup: props.agentSetup === false,
-		shouldLink: false,
-		linkYes: false,
-		...kids,
-		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
+		lockAgentSetup: true,
+		pm,
+		git: wantGit,
+		agentSetup,
+		install: wantInstall,
+		link: wantLink,
+		hasNeonConfig: neonConfig
 	});
-	if (props.link && !skipLink && await confirm(`Link this project to a Neon project now? (runs ${getCliName()} link)`)) {
-		await runScaffoldFollowUp({
-			cwd: targetDir,
-			yes: false,
-			skipAgentSetup: true,
-			shouldLink: true,
-			linkYes: false,
-			...kids
-		});
-		printNextSteps(targetDir, pm, {
-			installed,
-			suggestLink: false
-		});
-		return;
-	}
-	printNextSteps(targetDir, pm, {
-		installed,
-		suggestLink: true
+	finishPostScaffold({
+		heading: "Project scaffolded.",
+		template,
+		targetDir,
+		pm,
+		...outcome,
+		suggestLink: !outcome.linked
 	});
 };
 const installPrompt = (inferred) => inferred ? `Install dependencies with ${inferred}?` : "Install dependencies?";
 /** `link --yes` still asks for a project unless one is already linked. */
-const runDefaultSteps = async (props, targetDir, pm) => {
+const runDefaultSteps = async (props, targetDir, pm, neonConfig, template) => {
 	log.info("Quick start (--default): skipping the template, install, git, and agent pickers. link --yes still asks for a project unless one is already linked.");
-	let installed = false;
-	if (props.install) installed = await runCommand(pm, installArgs(pm), targetDir);
-	if (props.git && !isGitRepo(targetDir)) await initGitRepo(targetDir);
-	const skipLink = shouldSkipLinkForDeps(targetDir, installed);
-	if (props.link && skipLink) logSkippedLink(pm);
-	await runScaffoldFollowUp({
-		cwd: targetDir,
+	const wantGit = props.git && !isGitRepo(targetDir);
+	const agentSetup = props.agentSetup === false ? "skip" : "skills-mcp";
+	const outcome = await executePostScaffold(props, targetDir, {
 		yes: true,
-		skipAgentSetup: props.agentSetup === false,
-		shouldLink: props.link && !skipLink,
-		linkYes: true,
-		...bootstrapChildren(props, targetDir),
-		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
+		lockAgentSetup: false,
+		pm,
+		git: wantGit,
+		agentSetup,
+		install: props.install,
+		link: props.link,
+		hasNeonConfig: neonConfig
 	});
-	printNextSteps(targetDir, pm, {
-		installed,
-		suggestLink: !(props.link && !skipLink)
+	finishPostScaffold({
+		heading: "Project scaffolded.",
+		template,
+		targetDir,
+		pm,
+		...outcome,
+		suggestLink: !outcome.linked
 	});
 };
+const executePostScaffold = async (props, targetDir, choices) => {
+	const kids = bootstrapChildren(props, targetDir);
+	let installed = false;
+	let installFailed = false;
+	let gitFailed = false;
+	let git = false;
+	let linked = false;
+	let skippedLinkForDeps = false;
+	let agentSetup = choices.agentSetup;
+	let agentsRan = false;
+	const actions = postScaffoldActions({
+		git: choices.git,
+		agentSetup: choices.agentSetup,
+		install: choices.install,
+		link: choices.link,
+		hasNeonConfig: choices.hasNeonConfig
+	});
+	for (const action of actions) {
+		if (action === "git") {
+			git = await initGitRepo(targetDir);
+			if (!git) {
+				gitFailed = true;
+				break;
+			}
+			continue;
+		}
+		if (action === "agent") {
+			agentSetup = await runAgentTooling({
+				cwd: targetDir,
+				yes: choices.yes,
+				...choices.lockAgentSetup ? { agentSetup: choices.agentSetup } : {},
+				...kids,
+				...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
+				...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
+			});
+			agentsRan = true;
+			continue;
+		}
+		if (action === "install") {
+			installed = await runCommand(choices.pm, installArgs(choices.pm), targetDir);
+			if (!installed) installFailed = true;
+			continue;
+		}
+		if (action !== "link") throw new Error(`Unhandled post-scaffold action: ${action}`);
+		if (choices.hasNeonConfig && !installed) {
+			skippedLinkForDeps = true;
+			logSkippedLink(choices.pm);
+			continue;
+		}
+		await runInitSteps([choices.yes ? ["link", "--yes"] : ["link"]], {
+			cwd: targetDir,
+			...kids
+		});
+		linked = true;
+	}
+	return {
+		installed,
+		installFailed,
+		gitFailed,
+		git,
+		linked,
+		skippedLinkForDeps,
+		agentSetup,
+		agentsRan
+	};
+};
 const isGitRepo = (dir) => existsSync(join(dir, ".git"));
 const NEON_CONFIG_FILENAMES = [
 	"neon.ts",
@@ -265,7 +334,6 @@ const NEON_CONFIG_FILENAMES = [
 	"neon.mjs"
 ];
 const hasNeonConfig = (dir) => NEON_CONFIG_FILENAMES.some((name) => existsSync(join(dir, name)));
-const shouldSkipLinkForDeps = (dir, installed) => !installed && hasNeonConfig(dir);
 const logSkippedLink = (pm) => {
 	log.info(`Skipping the Neon link step: \`${getCliName()} link\` reads this project's neon.ts to pull env vars, which needs its dependencies. Run \`${formatInstallCommand(pm)}\`, then \`${getCliName()} link\`.`);
 };
@@ -288,9 +356,7 @@ const bootstrapChildren = (props, targetDir) => {
 * deliberately don't auto-commit, both to avoid failing on a machine with no
 * git identity configured and to leave the first commit to the user.
 */
-const initGitRepo = async (dir) => {
-	await runCommand("git", ["init"], dir);
-};
+const initGitRepo = async (dir) => runCommand("git", ["init"], dir);
 const confirm = async (message) => {
 	const { value } = await prompts({
 		onState: onPromptState,
@@ -324,22 +390,56 @@ const selectPackageManager = async () => {
 	return pm ?? "npm";
 };
 const printScaffolded = (template, targetDir) => {
-	log.info("");
-	log.info("Done. Scaffolded \"%s\" into %s.", template.title, isCurrentDir(targetDir) ? "the current directory" : displayDir(targetDir));
+	log.info("Scaffolded \"%s\" into %s.", template.title, isCurrentDir(targetDir) ? "the current directory" : displayDir(targetDir));
 };
-/**
-* The closing "Next steps" hint. Skips `cd` for the current directory, omits
-* the install line once deps are in, and only nudges `neon link` when linking
-* wasn't already offered/run — so the user never sees a step they just did.
-*/
-const printNextSteps = (targetDir, pm, opts) => {
-	log.info("");
-	log.info("Next steps:");
-	if (!isCurrentDir(targetDir)) log.info("  cd %s", displayDir(targetDir));
-	if (!opts.installed) log.info("  %s", formatInstallCommand(pm));
-	if (opts.suggestLink) log.info(`  ${getCliName()} link`);
-	log.info("  See the README to run it.");
-	log.info("");
+const printDoneSummary = (input) => {
+	const unfinished = input.installFailed || input.gitFailed;
+	const heading = unfinished ? "Setup did not finish." : input.heading;
+	const deps = input.installFailed ? "install failed" : input.installed ? `installed with ${input.pm}` : "skipped";
+	const git = input.gitFailed ? "init failed" : input.git ? "initialized" : "skipped";
+	const project = input.linked ? "linked" : input.skippedLinkForDeps ? "skipped (needs dependencies)" : "not linked";
+	const next = [];
+	if (!isCurrentDir(input.targetDir)) next.push(`cd ${displayDir(input.targetDir)}`);
+	if (!input.installed) next.push(formatInstallCommand(input.pm));
+	if (input.suggestLink) next.push(`${getCliName()} link`);
+	if (!unfinished) next.push("See the README to run it.");
+	printInitDone(formatInitDone({
+		heading,
+		rows: [
+			{
+				label: "Template",
+				value: input.template.title
+			},
+			{
+				label: "Directory",
+				value: displayDir(input.targetDir)
+			},
+			{
+				label: "Dependencies",
+				value: deps
+			},
+			{
+				label: "Git",
+				value: git
+			},
+			{
+				label: "Agents",
+				value: agentSetupDoneLabel({
+					setup: input.agentSetup,
+					ran: input.agentsRan
+				})
+			},
+			{
+				label: "Project",
+				value: project
+			}
+		],
+		next
+	}));
+};
+const finishPostScaffold = (input) => {
+	printDoneSummary(input);
+	if (input.installFailed || input.gitFailed) throw new Error("Setup did not finish.");
 };
 const isCurrentDir = (targetDir) => relative(process.cwd(), targetDir) === "";
 /**

package/dist/commands/init.js

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { log } from "../log.js";
 import { readContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { initChildEnv, spawnCliChild } from "../init/child.js";
+import { agentSetupLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
 import { bootstrapInitStep, directoryIsEmpty, planExistingInit } from "../init/plan.js";
 import { runAgentTooling, runInitSteps } from "../init/tooling.js";
 import { helpEpilogue } from "../utils/help_text.js";
@@ -67,10 +67,11 @@ const handler = async (props) => {
 			forward,
 			authEnv
 		});
-		log.info("Done.");
 		return;
 	}
-	await runAgentTooling({
+	if (shouldPrintInitBanner(yes)) printInitBanner();
+	const alreadyLinked = isLinked(contextFile);
+	const agentSetup = await runAgentTooling({
 		cwd,
 		yes,
 		run,
@@ -80,7 +81,7 @@ const handler = async (props) => {
 		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
 	});
 	await runInitSteps(planExistingInit({
-		linked: isLinked(contextFile),
+		linked: alreadyLinked,
 		yes,
 		agentSetup: "skip"
 	}), {
@@ -89,7 +90,24 @@ const handler = async (props) => {
 		forward,
 		authEnv
 	});
-	log.info("Done.");
+	printInitDone(formatInitDone({
+		heading: "Configured this directory for Neon.",
+		rows: [
+			{
+				label: "Agents",
+				value: agentSetupLabel(agentSetup)
+			},
+			{
+				label: "Project",
+				value: alreadyLinked ? "already linked" : "linked"
+			},
+			{
+				label: "Config",
+				value: "neon.ts"
+			}
+		],
+		next: []
+	}));
 };
 //#endregion
 export { builder, command, describe, handler, initChildEnv, init_exports as t };

package/dist/errors.js

@@ -2,7 +2,8 @@
 const ERROR_MATCHERS = [
 	[/^Unknown command: (.*)$/, "UNKNOWN_COMMAND"],
 	[/^Missing required argument: (.*)$/, "MISSING_ARGUMENT"],
-	[/^Failed to open web browser. (.*)$/, "AUTH_BROWSER_FAILED"]
+	[/^Failed to open web browser. (.*)$/, "AUTH_BROWSER_FAILED"],
+	[/^Setup did not finish\.$/, "NEON_INIT_FAILED"]
 ];
 const matchErrorCode = (message) => {
 	if (!message) return "UNKNOWN_ERROR";

package/dist/index.js

@@ -162,8 +162,9 @@ async function handleError(msg, err) {
 		}
 	} else {
 		const error = err instanceof Error ? err : new Error(msg || "Unknown error");
-		sendError(error, matchErrorCode(error.message));
-		log.error(error.message);
+		const code = matchErrorCode(error.message);
+		sendError(error, code);
+		if (code !== "NEON_INIT_FAILED") log.error(error.message);
 		return false;
 	}
 }

package/dist/init/chrome.js

@@ -0,0 +1,44 @@
+import { isCi } from "../env.js";
+import chalk from "chalk";
+//#region src/init/chrome.ts
+const NEON_GREEN = "#4BB578";
+const INIT_BANNER_LINES = [
+	" ██╗  ██╗██████╗  ██████╗ ██╗  ██╗",
+	" ███╗ ██║██╔═══╝ ██╔═══██╗███╗ ██║",
+	" ████╗██║██████╗ ██║   ██║████╗██║",
+	" ██╔████║██╔═══╝ ██║   ██║██╔████║",
+	" ██║╚███║██████╗ ╚██████╔╝██║╚███║",
+	" ╚═╝ ╚══╝╚═════╝  ╚═════╝ ╚═╝ ╚══╝"
+];
+const formatInitBanner = () => INIT_BANNER_LINES.join("\n");
+const shouldPrintInitBanner = (yes) => !yes && !isCi() && Boolean(process.stdout.isTTY);
+const printInitBanner = () => {
+	process.stdout.write(`\n${chalk.hex(NEON_GREEN)(formatInitBanner())}\n\n${chalk.dim("Let's get this directory set up with Neon.")}\n\n`);
+};
+const formatInitDone = (input) => {
+	const labelWidth = Math.max(0, ...input.rows.map((row) => row.label.length));
+	const body = input.rows.length === 0 ? "" : `\n\n${input.rows.map((row) => `  ${row.label.padEnd(labelWidth)}  ${row.value}`).join("\n")}`;
+	const next = input.next.length === 0 ? "" : `\n\nNext:\n${input.next.map((line) => `  ${line}`).join("\n")}`;
+	const rule = "-".repeat(input.heading.length);
+	return `${input.heading}\n${rule}${body}${next}\n`;
+};
+const printInitDone = (text) => {
+	const painted = (text.endsWith("\n") ? text.slice(0, -1) : text).split("\n").map((line, index) => {
+		if (index === 0) return chalk.hex(NEON_GREEN).bold(line);
+		if (/^-{3,}$/.test(line)) return chalk.hex(NEON_GREEN)(line);
+		if (line === "Next:") return chalk.bold(line);
+		return line;
+	});
+	process.stdout.write(`\n${painted.join("\n")}\n\n`);
+};
+const agentSetupLabel = (setup) => {
+	if (setup === "plugin") return "plugin";
+	if (setup === "skills-mcp") return "skills and MCP";
+	return "skipped";
+};
+const agentSetupDoneLabel = (input) => {
+	if (!input.ran && input.setup !== "skip") return "not run";
+	return agentSetupLabel(input.setup);
+};
+//#endregion
+export { INIT_BANNER_LINES, NEON_GREEN, agentSetupDoneLabel, agentSetupLabel, formatInitBanner, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner };

package/dist/init/plan.js

@@ -12,6 +12,21 @@ const projectContextFile = (projectDir, contextFile) => {
 	if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) return join(projectDir, ".neon");
 	return resolved;
 };
+/** Linking a template with neon.ts requires installed dependencies because env pull evaluates it. */
+const postScaffoldActions = (input) => {
+	const actions = [];
+	if (input.git) actions.push("git");
+	if (input.agentSetup !== "skip") actions.push("agent");
+	const canLink = input.link && !(input.hasNeonConfig && !input.install);
+	if (canLink && input.hasNeonConfig && input.install) {
+		actions.push("install");
+		actions.push("link");
+		return actions;
+	}
+	if (canLink) actions.push("link");
+	if (input.install) actions.push("install");
+	return actions;
+};
 const planAgentSteps = (input) => {
 	const y = input.yes ? ["-y"] : [];
 	if (input.agentSetup === "plugin") return [["plugins", ...y]];
@@ -44,4 +59,4 @@ const childArgv = (step, forward) => {
 	return args;
 };
 //#endregion
-export { bootstrapInitStep, childArgv, directoryIsEmpty, planAgentSteps, planExistingInit, projectContextFile, resolveInitAgentSetup };
+export { bootstrapInitStep, childArgv, directoryIsEmpty, planAgentSteps, planExistingInit, postScaffoldActions, projectContextFile, resolveInitAgentSetup };

package/dist/init/tooling.js

@@ -24,7 +24,7 @@ const runAgentTooling = async (options) => {
 	const yes = options.yes;
 	const hasProjectPlugins = yes ? await (options.hasProjectPlugins ?? defaultHasProjectPlugins)(options.cwd) : false;
 	const interactive = !yes && (options.pickAgentSetup !== void 0 || canPickAgentsInteractively());
-	const agentSetup = await resolveInitAgentSetup({
+	const agentSetup = options.agentSetup ?? await resolveInitAgentSetup({
 		yes,
 		interactive,
 		hasProjectPlugins,
@@ -34,6 +34,7 @@ const runAgentTooling = async (options) => {
 		yes,
 		agentSetup
 	}), options);
+	return agentSetup;
 };
 const runScaffoldFollowUp = async (options) => {
 	if (!options.skipAgentSetup) await runAgentTooling(options);

package/dist/skills/catalog.js

@@ -3,11 +3,6 @@ import { helpCsv } from "../utils/help_text.js";
 const AGENT_SKILLS_SOURCE = "neondatabase/agent-skills";
 const PLATFORMS_SKILLS_SOURCE = "neondatabase/neon-for-agent-platforms";
 const NEON_SKILL_CATALOG = [
-	{
-		skill: "claimable-postgres",
-		source: AGENT_SKILLS_SOURCE,
-		defaultSelected: true
-	},
 	{
 		skill: "neon",
 		source: AGENT_SKILLS_SOURCE,

package/dist/utils/inspect_queries.js

@@ -112,7 +112,7 @@ const INSPECT_QUERIES = {
 		`
 	},
 	"stalled-queries": {
-		describe: "Active queries running longer than 30 seconds with parallel workers, waits, and blockers (compute-wide)",
+		describe: "Active queries running longer than 30 seconds with parallel workers, waits, and blockers, oldest group first (compute-wide)",
 		scope: "compute",
 		fields: [
 			"duration",
@@ -132,9 +132,12 @@ const INSPECT_QUERIES = {
 					AND pid <> pg_backend_pid()
 			),
 			stalled_groups AS (
-				SELECT DISTINCT COALESCE(leader_pid, pid) AS query_group
+				SELECT
+					COALESCE(leader_pid, pid) AS query_group,
+					min(query_start) AS group_start
 				FROM activity
 				WHERE query_start <= statement_timestamp() - interval '30 seconds'
+				GROUP BY COALESCE(leader_pid, pid)
 			)
 			SELECT
 				statement_timestamp() AS observed_at,
@@ -159,7 +162,7 @@ const INSPECT_QUERIES = {
 			FROM activity a
 			JOIN stalled_groups g
 				ON g.query_group = COALESCE(a.leader_pid, a.pid)
-			ORDER BY g.query_group, a.leader_pid NULLS FIRST, a.pid;
+			ORDER BY g.group_start, g.query_group, a.leader_pid NULLS FIRST, a.pid;
 		`
 	},
 	locks: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "4.10.0",
+  "version": "4.10.2",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -64,8 +64,8 @@
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
     "@neon/config": "1.0.5",
-    "@neon/sdk": "3.0.0",
-    "@neon/config-runtime": "1.0.5"
+    "@neon/config-runtime": "1.0.5",
+    "@neon/sdk": "3.0.0"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",