neon 5.0.1 → 6.1.0

package/dist/commands/plugins.js

@@ -9,16 +9,18 @@ import { NEON_MCP_URL } from "../mcp/install.js";
 import "../init/agents.js";
 import { pluginsInstallableAgents } from "../plugins/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
 import { resolvePluginsPlan } from "../plugins/plan.js";
-import { confirmPluginsInstall } from "../plugins/wizard.js";
+import { NEON_PLUGIN_NAME, PLUGIN_SKILLS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
 //#region src/commands/plugins.ts
 var plugins_exports = /* @__PURE__ */ __exportAll({
 	aliases: () => aliases,
 	builder: () => builder,
 	command: () => command,
 	describe: () => describe,
-	handler: () => handler
+	handler: () => handler,
+	installPlugins: () => installPlugins,
+	pluginsInstallError: () => pluginsInstallError,
+	reportPluginsInstall: () => reportPluginsInstall
 });
 const coerceAgents = (value) => {
 	if (value === void 0) return [];
@@ -54,38 +56,36 @@ const builder = (argv) => argv.usage("$0 plugins [options]").options({
 		describe: "Coding agent to install into (repeatable). Skips the agent picker. Values listed below",
 		coerce: coerceAgents
 	}
-}).example("$0 plugins", "Interactive: agents, then confirm").example("$0 plugins -y", "Detected agents (project folders, else the host CLI agent), skip prompts").example("$0 plugins --agent cursor --agent claude-code", "Install into specific agents").example("$0 plugins --global", "Install user-level").epilogue(helpEpilogue(helpCsv("Supported agents at project scope", pluginProjectAgents), helpCsv("Also with --global", pluginGlobalOnlyAgents), `Currently one plugin: ${NEON_PLUGIN_NAME} from ${PLUGIN_SOURCE}.`, `It includes the Neon MCP server (${NEON_MCP_URL})`, helpCsv("and these skills", PLUGIN_SKILLS))).strict().check(noPassthrough("plugins"));
-const handler = async (props) => {
-	const cwd = process.cwd();
-	const yes = props.yes === true;
+}).example("$0 plugins", "Interactive: pick agents, then install").example("$0 plugins -y", "Detected agents (project folders, else the host CLI agent), skip prompts").example("$0 plugins --agent cursor --agent claude-code", "Install into specific agents").example("$0 plugins --global", "Install user-level").epilogue(helpEpilogue(helpCsv("Supported agents at project scope", pluginProjectAgents), helpCsv("Also with --global", pluginGlobalOnlyAgents), `Currently one plugin: ${NEON_PLUGIN_NAME} from ${PLUGIN_SOURCE}.`, `It includes the Neon MCP server (${NEON_MCP_URL})`, helpCsv("and these skills", PLUGIN_SKILLS))).strict().check(noPassthrough("plugins"));
+/**
+* Plans and runs the plugin install for every resolved target. No CLI-only concerns here
+* (no `writer` table, no `recordCommandSuccessExtras`): a caller that only wants the
+* outcome — `neon init` / `neon bootstrap` — gets it without rendering a result table.
+*/
+const installPlugins = async (options) => {
+	const cwd = options.cwd ?? process.cwd();
+	const yes = options.yes === true;
 	const interactive = canPickAgentsInteractively() && !yes;
 	const plan = await resolvePluginsPlan({
-		global: props.global === true,
-		agents: props.agent ?? [],
+		global: options.global === true,
+		agents: options.agents ?? [],
 		yes,
 		cwd,
 		interactive
 	});
 	for (const agent of plan.skipped) log.warning("Skipping %s: no plugins mapping.", getAgentDisplayName(agent));
 	for (const agent of plan.userScopeSkipped) log.warning("Skipping %s: plugins are user-level. Pass --global.", getAgentDisplayName(agent));
-	if (interactive) {
-		if (!await confirmPluginsInstall({
-			scope: plan.scope,
-			agents: plan.agents
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
-	}
 	const rows = [];
 	const failed = [];
 	const scope = scopeLabel(plan.scope);
-	for (const mapped of plan.targets) {
+	for (const [index, mapped] of plan.targets.entries()) {
 		const args = pluginsAddArgs({
 			target: mapped.target,
 			global: plan.scope === "global"
 		});
 		const agent = mapped.agents.join(", ");
+		const displayNames = mapped.agents.map((id) => getAgentDisplayName(id)).join(", ");
+		log.info("Installing the Neon plugin for %s (%d/%d)...", displayNames, index + 1, plan.targets.length);
 		try {
 			await runPluginsCli({
 				args,
@@ -112,8 +112,31 @@ const handler = async (props) => {
 			});
 		}
 	}
+	return {
+		scope: plan.scope,
+		rows,
+		failed
+	};
+};
+/** The exact error `neon plugins` throws for a failed outcome, or `undefined` on success. */
+const pluginsInstallError = (outcome) => {
+	const { failed, rows, scope } = outcome;
+	if (failed.length === 0) return;
+	const first = failed[0];
+	if (first === void 0) return /* @__PURE__ */ new Error("Failed to install the Neon plugin.");
+	const retry = neonPluginsRetryCommand({
+		agents: failed.flatMap((row) => row.agents),
+		global: scope === "global"
+	});
+	if (first.message.includes("needs npx (Node.js)")) return new Error(first.message);
+	const detail = failed.map((row) => row.message).join("\n");
+	if (failed.length === rows.length) return /* @__PURE__ */ new Error(`${detail}\nRetry with: ${retry}`);
+	return /* @__PURE__ */ new Error(`Failed to install the Neon plugin for: ${failed.flatMap((row) => row.agents).join(", ")}.\n${detail}\nRetry with: ${retry}`);
+};
+/** Writes the results table and, on success, the "Installed the Neon plugin" line. Shared by `neon plugins` and any in-process caller that wants the same human output. */
+const reportPluginsInstall = (props, outcome) => {
 	const out = writer(props);
-	out.write(rows, {
+	out.write(outcome.rows, {
 		fields: [
 			"scope",
 			"plugin",
@@ -124,21 +147,19 @@ const handler = async (props) => {
 		title: "Plugins"
 	});
 	out.end();
-	if (failed.length === 0) {
-		recordCommandSuccessExtras({ scope: plan.scope });
-		log.info(plan.scope === "project" ? "Installed the Neon plugin (project)." : "Installed the Neon plugin (user).");
-		return;
-	}
-	const first = failed[0];
-	if (first === void 0) throw new Error("Failed to install the Neon plugin.");
-	const retry = neonPluginsRetryCommand({
-		agents: failed.flatMap((row) => row.agents),
-		global: plan.scope === "global"
+	if (outcome.failed.length === 0) log.info(outcome.scope === "project" ? "Installed the Neon plugin (project)." : "Installed the Neon plugin (user).");
+};
+const handler = async (props) => {
+	const outcome = await installPlugins({
+		cwd: props.cwd,
+		yes: props.yes,
+		global: props.global,
+		agents: props.agent
 	});
-	if (first.message.includes("needs npx (Node.js)")) throw new Error(first.message);
-	const detail = failed.map((row) => row.message).join("\n");
-	if (failed.length === rows.length) throw new Error(`${detail}\nRetry with: ${retry}`);
-	throw new Error(`Failed to install the Neon plugin for: ${failed.flatMap((row) => row.agents).join(", ")}.\n${detail}\nRetry with: ${retry}`);
+	reportPluginsInstall(props, outcome);
+	const error = pluginsInstallError(outcome);
+	if (error) throw error;
+	recordCommandSuccessExtras({ scope: outcome.scope });
 };
 //#endregion
-export { aliases, builder, command, describe, handler, plugins_exports as t };
+export { aliases, builder, command, describe, handler, installPlugins, pluginsInstallError, reportPluginsInstall, plugins_exports as t };

package/dist/commands/skills.js

@@ -9,7 +9,7 @@ import "../init/agents.js";
 import { mappedSkillsAgentNames, skillsInstallableAgents } from "../skills/targets.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { skillsHelpValues, skillsYesHelp } from "../skills/catalog.js";
-import { confirmSkillsInstall, confirmSkillsUpdate } from "../skills/wizard.js";
+import { confirmSkillsUpdate } from "../skills/wizard.js";
 import { assertSkillsCanRun, resolveSkillsPlan } from "../skills/plan.js";
 import { assertSkillsNode, neonSkillsRetryCommand, neonSkillsUpdateRetryCommand, runSkillsCli, skillsAddArgs, skillsMetadata, skillsUpdateArgs, skillsUpdateDetail, skillsUpdateHadNothing } from "../skills/run.js";
 //#region src/commands/skills.ts
@@ -18,7 +18,10 @@ var skills_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,
 	command: () => command,
 	describe: () => describe,
-	handler: () => handler
+	handler: () => handler,
+	installSkills: () => installSkills,
+	reportSkillsInstall: () => reportSkillsInstall,
+	skillsInstallError: () => skillsInstallError
 });
 const scopeLabel = (scope) => scope === "project" ? "this directory" : "user-level";
 const coerceAgents = (value) => {
@@ -82,32 +85,27 @@ const builder = (argv) => argv.usage("$0 skills [command] [options]").command("u
 		describe: "Skill to install (repeatable). Skips the skill picker. Does not select agents. Values listed below",
 		coerce: coerceSkills
 	}
-}).example("$0 skills", "Interactive: this directory, agents, skills, then confirm").example("$0 skills -y", "This directory, detected agents (project folders, else the host CLI agent), the default skills").example("$0 skills -y -s neon -s neon-ai-gateway", "Named skills into detected agents").example("$0 skills -s neon -s neon-ai-gateway --agent cursor", "Named skills into a named agent").example("$0 skills --global", "Install user-level skills").epilogue(helpEpilogue(helpCsv("Supported agents", skillsInstallableAgents()), "Supported skills, by source repo:", skillsHelpValues(), skillsYesHelp())).strict().check(noPassthrough("skills"));
-const handler = async (props) => {
+}).example("$0 skills", "Interactive: this directory, then agents, then skills").example("$0 skills -y", "This directory, detected agents (project folders, else the host CLI agent), the default skills").example("$0 skills -y -s neon -s neon-ai-gateway", "Named skills into detected agents").example("$0 skills -s neon -s neon-ai-gateway --agent cursor", "Named skills into a named agent").example("$0 skills --global", "Install user-level skills").epilogue(helpEpilogue(helpCsv("Supported agents", skillsInstallableAgents()), "Supported skills, by source repo:", skillsHelpValues(), skillsYesHelp())).strict().check(noPassthrough("skills"));
+/**
+* Plans and runs the skills install for every resolved source/invocation. No CLI-only
+* concerns here (no `writer` table, no `recordCommandSuccessExtras`): a caller that only
+* wants the outcome — `neon init` / `neon bootstrap` — gets it without rendering a table.
+*/
+const installSkills = async (options) => {
 	assertSkillsNode();
-	const cwd = process.cwd();
-	const yes = props.yes === true;
+	const cwd = options.cwd ?? process.cwd();
+	const yes = options.yes === true;
 	const interactive = canPickAgentsInteractively() && !yes;
 	const plan = await resolveSkillsPlan({
-		global: props.global === true,
-		agents: props.agent ?? [],
-		skills: props.skill ?? [],
+		global: options.global === true,
+		agents: options.agents ?? [],
+		skills: options.skills ?? [],
 		yes,
 		cwd,
 		interactive
 	});
 	const mapped = mappedSkillsAgentNames(plan.agents);
 	for (const agent of plan.skipped) log.warning("Skipping %s: no skills mapping.", getAgentDisplayName(agent));
-	if (interactive) {
-		if (!await confirmSkillsInstall({
-			scope: plan.scope,
-			agents: plan.agents,
-			invocations: plan.invocations
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
-	}
 	const metadata = skillsMetadata("skills");
 	const rows = [];
 	const failed = [];
@@ -148,8 +146,32 @@ const handler = async (props) => {
 			});
 		}
 	}
+	return {
+		scope: plan.scope,
+		agents: plan.agents,
+		rows,
+		failed
+	};
+};
+/** The exact error `neon skills` throws for a failed outcome, or `undefined` on success. */
+const skillsInstallError = (outcome) => {
+	const { failed, rows, scope, agents } = outcome;
+	if (failed.length === 0) return;
+	const first = failed[0];
+	if (first === void 0) return /* @__PURE__ */ new Error("Failed to install Neon agent skills.");
+	const retry = neonSkillsRetryCommand({
+		skills: failed.flatMap((row) => row.skills),
+		agents,
+		global: scope === "global"
+	});
+	if (first.message.includes("needs npx (Node.js)") || first.message.includes("needs Node.js")) return new Error(first.message);
+	if (failed.length === rows.length) return /* @__PURE__ */ new Error(`${first.message}\nRetry with: ${retry}`);
+	return /* @__PURE__ */ new Error(`Failed to install Neon agent skills for: ${failed.map((row) => row.label).join(", ")}.\n${first.message}\nRetry with: ${retry}`);
+};
+/** Writes the results table and, on success, the "Wrote ... skills" line. Shared by `neon skills` and any in-process caller that wants the same human output. */
+const reportSkillsInstall = (props, outcome) => {
 	const out = writer(props);
-	out.write(rows, {
+	out.write(outcome.rows, {
 		fields: [
 			"scope",
 			"skills",
@@ -160,21 +182,20 @@ const handler = async (props) => {
 		title: "Skills"
 	});
 	out.end();
-	if (failed.length === 0) {
-		recordCommandSuccessExtras({ scope: plan.scope });
-		log.info(plan.scope === "project" ? "Wrote skills in this directory." : "Wrote user-level skills.");
-		return;
-	}
-	const first = failed[0];
-	if (first === void 0) throw new Error("Failed to install Neon agent skills.");
-	const retry = neonSkillsRetryCommand({
-		skills: failed.flatMap((row) => row.skills),
-		agents: plan.agents,
-		global: plan.scope === "global"
+	if (outcome.failed.length === 0) log.info(outcome.scope === "project" ? "Wrote skills in this directory." : "Wrote user-level skills.");
+};
+const handler = async (props) => {
+	const outcome = await installSkills({
+		cwd: props.cwd,
+		yes: props.yes,
+		global: props.global,
+		agents: props.agent,
+		skills: props.skill
 	});
-	if (first.message.includes("needs npx (Node.js)") || first.message.includes("needs Node.js")) throw new Error(first.message);
-	if (failed.length === rows.length) throw new Error(`${first.message}\nRetry with: ${retry}`);
-	throw new Error(`Failed to install Neon agent skills for: ${failed.map((row) => row.label).join(", ")}.\n${first.message}\nRetry with: ${retry}`);
+	reportSkillsInstall(props, outcome);
+	const error = skillsInstallError(outcome);
+	if (error) throw error;
+	recordCommandSuccessExtras({ scope: outcome.scope });
 };
 const updateHandler = async (props) => {
 	assertSkillsNode();
@@ -229,4 +250,4 @@ const updateHandler = async (props) => {
 	if (failure !== void 0) throw new Error(failure.includes("needs npx (Node.js)") || failure.includes("needs Node.js") ? failure : `${failure}\nRetry with: ${neonSkillsUpdateRetryCommand(scope === "global")}`);
 };
 //#endregion
-export { aliases, builder, command, describe, handler, skills_exports as t };
+export { aliases, builder, command, describe, handler, installSkills, reportSkillsInstall, skillsInstallError, skills_exports as t };

package/dist/commands/snapshots.js

@@ -17,6 +17,7 @@ var snapshots_exports = /* @__PURE__ */ __exportAll({
 const SNAPSHOT_FIELDS = [
 	"id",
 	"name",
+	"slug",
 	"source_branch_id",
 	"expires_at",
 	"created_at"
@@ -38,6 +39,12 @@ const SNAPSHOT_FREQUENCIES = [
 	"weekly",
 	"monthly"
 ];
+/** Matches createSnapshot.query.slug in the Management API spec. */
+const SNAPSHOT_SLUG = /^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/;
+const SNAPSHOT_REF = {
+	describe: "Snapshot id, unique name, or slug. Lookup order: id, unique name, slug.",
+	type: "string"
+};
 /** Narrow an arbitrary string to a supported {@link SnapshotFrequency}. */
 const isSnapshotFrequency = (value) => SNAPSHOT_FREQUENCIES.some((frequency) => frequency === value);
 const command = "snapshots";
@@ -46,7 +53,7 @@ const aliases = ["snapshot"];
 const builder = (argv) => argv.usage("$0 snapshots <sub-command> [options]").options({ "project-id": {
 	describe: "Project ID",
 	type: "string"
-} }).middleware(fillSingleProject).command("list", "List snapshots in the project", (yargs) => yargs, (args) => list(args)).command("get <id>", "Get a snapshot by id or name", (yargs) => yargs, (args) => get(args)).command("create", "Create a snapshot from a branch", (yargs) => yargs.options({
+} }).middleware(fillSingleProject).command("list", "List snapshots in the project", (yargs) => yargs, (args) => list(args)).command("get <id>", "Get a snapshot by id, unique name, or slug", (yargs) => yargs.positional("id", SNAPSHOT_REF), (args) => get(args)).command("create", "Create a snapshot from a branch", (yargs) => yargs.options({
 	branch: {
 		alias: "b",
 		describe: "Branch id or name to snapshot. Defaults to the branch in your context, or the project's default branch.",
@@ -56,6 +63,10 @@ const builder = (argv) => argv.usage("$0 snapshots <sub-command> [options]").opt
 		describe: "A name for the snapshot",
 		type: "string"
 	},
+	slug: {
+		describe: "User-defined resource ID, unique in the project (1-63 characters: start with a lowercase letter, then lowercase letters, digits, or hyphens, ending with a letter or digit). Omit to let the API generate one. It cannot be changed later.",
+		type: "string"
+	},
 	timestamp: {
 		describe: "Take the snapshot at this point in time (RFC 3339, e.g. 2025-01-01T00:00:00Z). Must fall within the branch's restore window. Mutually exclusive with --lsn.",
 		type: "string"
@@ -71,9 +82,10 @@ const builder = (argv) => argv.usage("$0 snapshots <sub-command> [options]").opt
 }).conflicts("timestamp", "lsn").example([
 	["$0 snapshots create", "Snapshot the head of the context/default branch"],
 	["$0 snapshots create --branch main --name pre-migration", "Snapshot the head of main with a name"],
+	["$0 snapshots create --branch main --name \"Before migration\" --slug before-migration", "Snapshot main with a display name and a slug"],
 	["$0 snapshots create --branch main --timestamp 2025-01-01T00:00:00Z", "Snapshot main at a point in time"],
 	["$0 snapshots create --branch main --lsn 0/1F3C8A0 --expires-at 2025-12-31T23:59:59Z", "Snapshot main at an LSN, auto-deleting at the given time"]
-]), (args) => create(args)).command("update <id>", "Update a snapshot's name or expiration", (yargs) => yargs.options({
+]), (args) => create(args)).command("update <id>", "Update a snapshot's name or expiration by id, unique name, or slug", (yargs) => yargs.positional("id", SNAPSHOT_REF).options({
 	name: {
 		describe: "Rename the snapshot",
 		type: "string"
@@ -86,7 +98,7 @@ const builder = (argv) => argv.usage("$0 snapshots <sub-command> [options]").opt
 		describe: "Clear the expiration so the snapshot is kept indefinitely.",
 		type: "boolean"
 	}
-}).conflicts("expires-at", "clear-expiration"), (args) => update(args)).command("delete <id>", "Delete a snapshot by id or name", (yargs) => yargs, (args) => deleteSnapshot(args)).command("restore <id>", "Restore a snapshot into a branch", (yargs) => yargs.options({
+}).conflicts("expires-at", "clear-expiration"), (args) => update(args)).command("delete <id>", "Delete a snapshot by id, unique name, or slug", (yargs) => yargs.positional("id", SNAPSHOT_REF), (args) => deleteSnapshot(args)).command("restore <id>", "Restore a snapshot (id, unique name, or slug) into a branch", (yargs) => yargs.positional("id", SNAPSHOT_REF).options({
 	name: {
 		describe: "Name for the newly restored branch. Auto-generated when omitted.",
 		type: "string"
@@ -155,9 +167,8 @@ const toIso = (value, flag) => {
 	return new Date(ms).toISOString();
 };
 /**
-* Resolve a snapshot from an id **or** a name. Snapshot names are not guaranteed
-* unique, so an id match wins; a name that resolves to more than one snapshot is a
-* hard error asking the user to disambiguate by id.
+* Unique names precede slugs so existing name-based commands keep targeting
+* the named snapshot when another snapshot's slug matches that name.
 */
 const resolveSnapshot = async (props) => {
 	const { data: { snapshots } } = await props.apiClient.listSnapshots(props.projectId);
@@ -166,8 +177,11 @@ const resolveSnapshot = async (props) => {
 	const byName = snapshots.filter((s) => s.name === props.id);
 	if (byName.length === 1) return byName[0];
 	if (byName.length > 1) throw new Error(`Multiple snapshots are named "${props.id}". Re-run with the snapshot id:\n${byName.map((s) => `  ${s.id}`).join("\n")}`);
-	throw new Error(`Snapshot "${props.id}" not found.\nAvailable snapshots: ${snapshots.map((s) => `${s.name} (${s.id})`).join(", ") || "none"}`);
+	const bySlug = snapshots.find((s) => s.slug === props.id);
+	if (bySlug) return bySlug;
+	throw new Error(`Snapshot "${props.id}" not found.\nAvailable snapshots: ${snapshots.map((s) => formatSnapshotRef(s)).join(", ") || "none"}`);
 };
+const formatSnapshotRef = (snapshot) => snapshot.slug ? `${snapshot.name} (${snapshot.id}, slug: ${snapshot.slug})` : `${snapshot.name} (${snapshot.id})`;
 const list = async (props) => {
 	const { data: { snapshots } } = await props.apiClient.listSnapshots(props.projectId);
 	writer(props).end(snapshots, {
@@ -187,12 +201,14 @@ const get = async (props) => {
 const create = async (props) => {
 	if (props.lsn !== void 0 && !looksLikeLSN(props.lsn)) throw new Error(`Invalid --lsn value: "${props.lsn}". Expected an LSN like 0/1F3C8A0.`);
 	if (props.timestamp !== void 0 && !looksLikeTimestamp(props.timestamp)) throw new Error(`Invalid --timestamp value: "${props.timestamp}". Use an RFC 3339 timestamp, e.g. 2025-01-01T00:00:00Z.`);
+	if (props.slug !== void 0 && !SNAPSHOT_SLUG.test(props.slug)) throw new Error(`Invalid --slug value: "${props.slug}". Use 1-63 characters: start with a lowercase letter, then lowercase letters, digits, or hyphens, and end with a letter or digit.`);
 	const { branchId } = await resolveBranchRef({
 		...props,
 		branch: props.branch
 	});
 	const { data } = await retryOnLock(() => props.apiClient.createSnapshot(props.projectId, branchId, {
 		name: props.name,
+		slug: props.slug,
 		timestamp: props.timestamp,
 		lsn: props.lsn,
 		expires_at: props.expiresAt ? toIso(props.expiresAt, "--expires-at") : void 0

package/dist/index.js

@@ -14,6 +14,7 @@ import { recoverFrom401 } from "./auth_recovery.js";
 import { showHelp } from "./help.js";
 import { rewriteUnknownAgentArg } from "./init/plan.js";
 import commands_default from "./commands/index.js";
+import { notifyIfUpdateAvailable } from "./update_notifier.js";
 import { fillInArgs, resolveApiKeyFromEnv } from "./utils/middlewares.js";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -193,6 +194,13 @@ async function handleError(msg, err, canRetry) {
 			process.exit(0);
 		}
 		await closeAnalytics();
+		notifyIfUpdateAvailable({
+			commandPath: args._.map(String),
+			configDir: typeof args.configDir === "string" ? args.configDir : defaultDir,
+			currentBranch: Boolean(args.currentBranch),
+			currentVersion: pkg_default.version,
+			output: typeof args.output === "string" ? args.output : "table"
+		});
 		break;
 	} catch (err) {
 		takeCommandSuccessExtras();

package/dist/init/auth.js

@@ -0,0 +1,84 @@
+import { isNeonApiError } from "../api.js";
+import { r as defaultDir } from "../_chunks/paths-DMq0Lt7a.js";
+import "../config.js";
+import "../auth.js";
+import { ensureAuth } from "../commands/auth.js";
+import { recoverFrom401 } from "../auth_recovery.js";
+import { pull } from "../commands/env.js";
+import { setupNeonMcp } from "../commands/mcp.js";
+//#region src/init/auth.ts
+const isUnauthorized = (error) => isNeonApiError(error) && error.status === 401;
+const authenticationFailed = () => /* @__PURE__ */ new Error("Authentication failed.");
+/**
+* Fills in the fields `ensureAuth` requires beyond `InitAuthOptions`, and sets `_` so
+* `ensureAuth`'s per-command branches (`isMcpCommand`, `isSkillsCommand`, ...) treat this
+* exactly like the standalone command it names — mirrors `init/link.ts`'s `runAuthenticatedLink`.
+*/
+const authContext = (options, command) => ({
+	...options,
+	_: [...command],
+	configDir: options.configDir ?? defaultDir,
+	oauthHost: options.oauthHost ?? process.env.NEON_OAUTH_HOST ?? "https://oauth2.neon.tech",
+	clientId: options.clientId ?? "neonctl",
+	help: false
+});
+/**
+* Resolves Neon auth the same way a standalone `neon mcp` invocation would, then runs
+* `setupNeonMcp`. `init`/`bootstrap` never resolve a shared `apiClient` of their own for
+* this (see `InitAuthOptions` above), so this is what does it, per call.
+*
+* Skips `ensureAuth` entirely when `options.oauth` is true: `setupNeonMcp`'s oauth branch
+* never reads `apiClient`/`apiKey`, and `ensureAuth`'s own `isMcpOauth` skip reads the real
+* `process.argv` for `--oauth` (documented there as required because that middleware runs
+* before flag parsing) — which never contains it for a `neon init`/`bootstrap` process, so
+* `ensureAuth` would otherwise try to resolve credentials it doesn't need and can fail on
+* an unrelated bad profile or expired session.
+*/
+const runAuthenticatedMcp = async (options) => {
+	if (options.oauth === true) return setupNeonMcp(options);
+	const authenticated = authContext(options, ["mcp"]);
+	await ensureAuth(authenticated);
+	try {
+		return await setupNeonMcp(authenticated);
+	} catch (error) {
+		if (!isUnauthorized(error)) throw error;
+		if (!await recoverFrom401(true)) throw authenticationFailed();
+	}
+	await ensureAuth(authenticated);
+	try {
+		return await setupNeonMcp(authenticated);
+	} catch (error) {
+		if (!isUnauthorized(error)) throw error;
+		await recoverFrom401(false);
+		throw authenticationFailed();
+	}
+};
+/**
+* Resolves Neon auth the same way a standalone `neon env pull` invocation would, then runs
+* `pull` — the same function `link`/`checkout` already call directly via
+* `autoPullEnvAfterPin` (see `commands/env.ts`).
+*/
+const pullInitEnv = async (props) => {
+	const authenticated = authContext(props, ["env", "pull"]);
+	await ensureAuth(authenticated);
+	const opts = {
+		announce: true,
+		implyAiGateway: true
+	};
+	try {
+		return await pull(authenticated, opts);
+	} catch (error) {
+		if (!isUnauthorized(error)) throw error;
+		if (!await recoverFrom401(true)) throw authenticationFailed();
+	}
+	await ensureAuth(authenticated);
+	try {
+		return await pull(authenticated, opts);
+	} catch (error) {
+		if (!isUnauthorized(error)) throw error;
+		await recoverFrom401(false);
+		throw authenticationFailed();
+	}
+};
+//#endregion
+export { pullInitEnv, runAuthenticatedMcp };

package/dist/init/cancelled.js

@@ -0,0 +1,41 @@
+//#region src/init/cancelled.ts
+var InitCancelled = class extends Error {
+	constructor() {
+		super("Aborted.");
+		this.name = "InitCancelled";
+	}
+};
+/**
+* Rejects with {@link InitCancelled} on SIGINT while `work` is pending, so a step that runs
+* fully in-process (no spawned child of its own to die and report the signal back) still
+* unwinds through `runInit`'s normal cancellation handling — the "Neon setup cancelled."
+* summary and the funnel's final telemetry — instead of Node's default SIGINT disposition
+* killing the process with no chance to run either.
+*
+* Does not cancel `work` itself: there is no cooperative cancellation to ask for here, so a
+* lost race leaves it running in the background, its eventual settlement discarded. That is
+* fine — the process is already unwinding to exit on the `InitCancelled` path.
+*/
+const raceSigint = (work) => new Promise((resolve, reject) => {
+	const onSigint = () => reject(new InitCancelled());
+	process.once("SIGINT", onSigint);
+	const stop = () => {
+		process.removeListener("SIGINT", onSigint);
+	};
+	work.then((value) => {
+		stop();
+		resolve(value);
+	}, (error) => {
+		stop();
+		reject(error);
+	});
+});
+const restoreCursor = () => {
+	process.stdout.write("\x1B[?25h");
+	process.stdout.write("\n");
+};
+const restoreCursorVisibilityOnAbort = (state) => {
+	if (state.aborted) process.stdout.write("\x1B[?25h");
+};
+//#endregion
+export { InitCancelled, raceSigint, restoreCursor, restoreCursorVisibilityOnAbort };

package/dist/init/choices.js

@@ -1,25 +1,5 @@
-import { getCliName } from "../utils/cli_name.js";
 //#region src/init/choices.ts
-const INIT_TEMPLATE_CONFLICT = "--skip-template cannot be combined with --template.";
 const INIT_CONFIG_SERVICES_CONFLICT = "--no-config cannot be combined with --services.";
-const INIT_TEMPLATE_KEEPS_CONFIG = "A scaffolded template keeps the neon.ts it ships. --config, --no-config, and --services apply when you skip the template or set up an existing app.";
-const initTemplateInNonEmptyMessage = () => `--template is only for an empty directory. This directory already has files, so there is nothing to scaffold. Omit --template, or run \`${getCliName()} bootstrap\` in an empty folder.`;
-const resolveInitTemplateChoice = (input) => {
-	const id = input.template?.trim();
-	const hasTemplate = id !== void 0 && id.length > 0;
-	if (input.skipTemplate && hasTemplate) throw new Error(INIT_TEMPLATE_CONFLICT);
-	if (!input.empty) {
-		if (hasTemplate) throw new Error(initTemplateInNonEmptyMessage());
-		return { kind: "existing" };
-	}
-	if (input.skipTemplate) return { kind: "skip" };
-	if (hasTemplate) return {
-		kind: "template",
-		id
-	};
-	if (input.yes) return { kind: "default" };
-	return { kind: "ask" };
-};
 const resolveInitConfigChoice = (input) => {
 	if (input.flag === false && input.services !== void 0) throw new Error(INIT_CONFIG_SERVICES_CONFLICT);
 	if (input.flag === false) return { kind: "skip" };
@@ -41,6 +21,15 @@ const configPlanFromResolution = (resolution, accepted) => {
 	if (resolution.kind === "skip") return { kind: "skip" };
 	return resolution;
 };
+const isBareInitServices = (services) => {
+	if (services === void 0 || services.length === 0) return true;
+	return services.every((service) => service === "none");
+};
 const shouldRefreshEnvAfterNewConfig = (input) => input.wroteNewFile && typeof input.projectId === "string" && input.projectId.length > 0 && typeof input.branch === "string" && input.branch.length > 0;
+const shouldPullEnvAfterInitConfig = (input) => !input.extraServices && !input.alreadyPulled && shouldRefreshEnvAfterNewConfig({
+	wroteNewFile: input.wroteNewFile,
+	...input.projectId !== void 0 ? { projectId: input.projectId } : {},
+	...input.branch !== void 0 ? { branch: input.branch } : {}
+});
 //#endregion
-export { INIT_CONFIG_SERVICES_CONFLICT, INIT_TEMPLATE_CONFLICT, INIT_TEMPLATE_KEEPS_CONFIG, configPlanFromResolution, initTemplateInNonEmptyMessage, resolveInitConfigChoice, resolveInitTemplateChoice, shouldRefreshEnvAfterNewConfig };
+export { INIT_CONFIG_SERVICES_CONFLICT, configPlanFromResolution, isBareInitServices, resolveInitConfigChoice, shouldPullEnvAfterInitConfig, shouldRefreshEnvAfterNewConfig };