neon 5.0.1 → 6.1.0

package/dist/commands/init.js

@@ -1,62 +1,57 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { log } from "../log.js";
-import { contextBranch, readContextFile } from "../context.js";
-import { recordCommandSuccessExtras } from "../analytics.js";
-import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { getCliName } from "../utils/cli_name.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
-import { deprecatedServiceMessage, parseServices, servicesFlagValue, servicesOption } from "../neon_services.js";
-import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES, CONFIG_INIT_UNAVAILABLE } from "../config_template.js";
-import { fetchTemplates } from "../init/bootstrap.js";
-import { initChildEnv, spawnCliChild } from "../init/child.js";
-import { agentSetupLabel, configSummaryLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
-import { hasNeonConfigFile } from "./config.js";
-import { runAuthenticatedLink } from "../init/link.js";
+import { servicesOption } from "../neon_services.js";
+import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES } from "../config_template.js";
 import { coerceAgentFlag } from "../utils/agent_flag.js";
-import { INIT_NEEDS_YES_OR_TERMINAL, assertNamedAgentTooling, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, planExistingInit, resolveNamedAgents } from "../init/plan.js";
-import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { pickInitConfigInteractively, pickInitLinkInteractively, pickInitTemplateInteractively } from "../init/wizard.js";
-import { runAgentTooling, runInitSteps } from "../init/tooling.js";
-import { handler as handler$1 } from "./bootstrap.js";
-import { INIT_CONFIG_SERVICES_CONFLICT, INIT_TEMPLATE_KEEPS_CONFIG, configPlanFromResolution, resolveInitConfigChoice, resolveInitTemplateChoice, shouldRefreshEnvAfterNewConfig } from "../init/choices.js";
-import { existsSync, readdirSync } from "node:fs";
-import { resolve } from "node:path";
+import { initPluginAgents, initSkillsMcpAgents } from "../init/plan.js";
+import { listSkillIds } from "../skills/catalog.js";
+import { runInit } from "../init/run.js";
 //#region src/commands/init.ts
 var init_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,
 	command: () => command,
 	describe: () => describe,
-	handler: () => handler,
-	initChildEnv: () => initChildEnv
+	handler: () => handler
 });
 const command = "init";
-const describe = "Set up this directory for Neon: agent tooling, a linked project, and optionally neon.ts. In an empty directory, pick a template or skip scaffolding.";
+const describe = "Set up coding agents and this directory for Neon. -y is Recommended. -y with Custom flags applies those answers without prompts.";
 const removedProtocol = () => `\`${getCliName()} init --data\` was removed. Run \`${getCliName()} init\` or \`${getCliName()} init -y\`.`;
 const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file", { hidden: true }).option("yes", {
 	alias: "y",
 	type: "boolean",
 	default: false,
-	describe: "Empty dir: scaffold the default template. --skip-template: plugin, or skills and MCP, for project folders, else the host CLI agent. Exits if none. Then link with defaults and create the bare neon.ts policy. If several organizations or projects exist, link prints IDs and exits"
-}).option("skip-template", {
+	describe: "Skip prompts. Alone: Recommended (detected agents, link when authenticated, default neon.ts). With --skill, MCP flags, --no-agent-setup, or --claimable: Custom using those flags"
+}).option("agent-setup", {
+	type: "boolean",
+	default: true,
+	describe: "Install Neon into coding agents. Use --no-agent-setup to skip. Plugin vs skills is inferred from --skill and MCP flags"
+}).option("claimable", {
 	type: "boolean",
 	default: false,
-	describe: "Do not scaffold a template. Set up agents, link a project, and optionally neon.ts in this directory"
-}).option("template", {
+	describe: "Create a claimable project that expires in 72 hours unless claimed. Selects Custom"
+}).option("package-manager", {
 	type: "string",
-	describe: "Template to scaffold into an empty directory. Conflicts with --skip-template"
+	choices: [
+		"npm",
+		"pnpm",
+		"yarn",
+		"bun"
+	],
+	describe: "Package manager for neon.ts dependencies. -y uses this without asking. Custom asks only when none is detected"
 }).option("link", {
 	type: "boolean",
 	default: true,
 	describe: "Link a Neon project during setup. Use --no-link to skip without being asked"
 }).option("config", {
 	type: "boolean",
-	describe: "Existing app or --skip-template: create neon.ts after linking. Use --no-config to skip. Omitted in a terminal: you will be asked. Scaffolding a template keeps that template's neon.ts"
+	describe: "Create neon.ts after linking. Use --no-config to skip. Omitted in Custom: you will be asked"
 }).option("services", servicesOption({
 	key: "services",
 	allowed: CONFIG_INIT_SERVICES,
-	describe: "Existing app or --skip-template: services to declare in neon.ts",
+	describe: "Services to declare in neon.ts",
 	noneMeans: CONFIG_INIT_NONE_MEANS,
-	also: "Implies creating neon.ts. Cannot be combined with --no-config. Ignored when scaffolding a template."
+	also: "Implies creating neon.ts. Cannot be combined with --no-config."
 })).option("org-id", {
 	describe: "Forwarded to link: organization ID to link to",
 	type: "string"
@@ -77,8 +72,24 @@ const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file
 	alias: "a",
 	type: "array",
 	string: true,
-	describe: "Coding agent to install into (repeatable). Forwarded to plugins, or to skills and mcp. Skips agent selection. Values listed below",
+	describe: "Coding agent to install into (repeatable). Skips agent selection. Values listed below",
 	coerce: coerceAgentFlag
+}).option("skill", {
+	type: "array",
+	string: true,
+	describe: "Neon skill to install (repeatable). Selects skills setup (not the plugin) and skips the skills picker. With MCP flags, also configures MCP. Values listed below"
+}).option("mcp-config-location", {
+	type: "string",
+	choices: ["global", "project"],
+	describe: "Where to configure the Neon MCP server: global (user config, same as neon mcp) or project (this directory, same as neon mcp --project). Selects skills and MCP setup"
+}).option("mcp-auth", {
+	type: "string",
+	choices: ["oauth", "api-key"],
+	describe: "MCP authentication. Selects skills and MCP setup. oauth is neon mcp --oauth"
+}).option("mcp-project-scoped", {
+	type: "boolean",
+	default: false,
+	describe: "Limit MCP tools to the linked project, same as neon mcp --project-id. Selects skills and MCP setup"
 }).option("data", {
 	hidden: true,
 	type: "string"
@@ -86,281 +97,13 @@ const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file
 	alias: "o",
 	hidden: true,
 	describe: "Not supported; the commands init runs print their own output"
-}).example("$0 init", "Set up this directory (template picker if empty)").example("$0 init --skip-template", "Empty dir: agents, link, and neon.ts — no template files").example("$0 init -y", "Default template, or existing-app defaults").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("Empty directory: pick a starter template, or skip scaffolding and only set up agents, a Neon project, and neon.ts. That skip is not on `neon bootstrap`.", "Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "neon.ts is optional when you skip the template or set up an existing app. Saying no skips the services picker and does not write the file. Scaffolding a template keeps that template's neon.ts.", "-y installs the plugin when Cursor, Claude Code, or Codex is in project folders, else the host CLI agent. Otherwise skills and MCP. If none are found, it exits: pass --agent <name>, run from a supported agent, or omit -y in a terminal to pick. Then link unless already linked. If several organizations or projects exist, link prints IDs and exits.", "--agent / -a is forwarded to plugins, or to skills and mcp, not both. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()))).check((argv) => {
+}).example("$0 init", "Recommended or Custom setup").example("$0 init -y", "Recommended setup without prompts").example("$0 init -y --skill neon --mcp-auth oauth --mcp-config-location project", "Custom: those skills and MCP, Recommended defaults for the rest").example("$0 init --no-agent-setup --claimable", "Skip agent setup and create a claimable project").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install tooling for those agents").epilogue(helpEpilogue("Recommended setup installs tooling for detected coding agents, links a Neon project when the CLI is authenticated or the session is interactive, and writes a default neon.ts.", "init sets up the current directory in place. It does not scaffold starter files.", "-y alone is Recommended. -y with --skill, MCP flags, --no-agent-setup, or --claimable is Custom: those flags, Recommended defaults for unanswered questions. -y never opens a browser.", "--skill selects skills (not the plugin). MCP flags select skills and MCP. --no-agent-setup skips agent setup. --agent without those flags installs the plugin (and skills/MCP for agents the plugin cannot cover).", "Without a TTY, pass -y or enough flags to answer every question.", "--agent / -a is forwarded to plugins, or to skills and mcp. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()), helpCsv("Skills", listSkillIds()))).check((argv) => {
 	if (argv.data !== void 0) throw new Error(removedProtocol());
 	if (argv.help !== true && (argv.output === "json" || argv.output === "yaml")) throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
 	return true;
 }).strict();
-const isLinked = (contextFile) => {
-	const projectId = readContextFile(contextFile).projectId;
-	return typeof projectId === "string" && projectId.length > 0;
-};
-const nestedBootstrapDirectory = (cwd) => resolve(cwd) === resolve(process.cwd()) ? "." : cwd;
-const parsedInitServices = (raw) => {
-	const values = servicesFlagValue(raw);
-	if (values === void 0) return;
-	return parseServices(values, {
-		allowed: CONFIG_INIT_SERVICES,
-		whyUnavailable: CONFIG_INIT_UNAVAILABLE,
-		flag: "--services",
-		noneMeans: CONFIG_INIT_NONE_MEANS,
-		onDeprecated: (used, canonical) => log.warning(deprecatedServiceMessage(used, canonical))
-	});
-};
-const nestedBootstrapProps = (props, cwd, contextFile, template, linkInputs) => ({
-	apiClient: props.apiClient,
-	apiKey: props.apiKey,
-	apiHost: props.apiHost,
-	output: props.output,
-	contextFile,
-	directory: nestedBootstrapDirectory(cwd),
-	force: false,
-	listTemplates: false,
-	default: template.useDefault,
-	install: true,
-	git: true,
-	link: props.link !== false,
-	printBanner: false,
-	skipDoneSummary: true,
-	linkNoConfig: true,
-	narrate: "human",
-	...template.selected ? { selectedTemplate: template.selected } : {},
-	...!template.selected && template.id !== void 0 ? { template: template.id } : {},
-	linkInputs,
-	...props.agent !== void 0 ? { agent: props.agent } : {},
-	...props.configDir ? { configDir: props.configDir } : {},
-	...props.profile ? { profile: props.profile } : {},
-	...props.oauthHost ? { oauthHost: props.oauthHost } : {},
-	...props.clientId ? { clientId: props.clientId } : {},
-	...props.forceAuth !== void 0 ? { forceAuth: props.forceAuth } : {},
-	...props.allowUnsafeTls !== void 0 ? { allowUnsafeTls: props.allowUnsafeTls } : {},
-	...props.analytics === false ? { analytics: false } : {},
-	...props.run ? { run: props.run } : {},
-	...props.linkProject ? { linkProject: props.linkProject } : {},
-	...props.pickLink ? { pickLink: props.pickLink } : {},
-	...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-	...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
-	...props.detectAgent ? { detectAgent: props.detectAgent } : {},
-	...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
-});
-const projectRow = (input) => {
-	if (input.alreadyLinked) return "already linked";
-	if (input.linkedNow) return "linked";
-	return "not linked";
-};
-const configSummary = (input) => {
-	if (input.plan.kind === "skip") return "skipped";
-	if (input.existingConfig) return "existing";
-	return "created";
-};
-const printNestedBootstrapDone = (result, cwd, fallbackTitle) => {
-	const hasConfig = result?.hasNeonConfig === true || hasNeonConfigFile(cwd);
-	printInitDone(formatInitDone({
-		heading: "Neon setup complete.",
-		rows: [
-			{
-				label: "Template",
-				value: result?.templateTitle ?? fallbackTitle
-			},
-			{
-				label: "Agents",
-				value: agentSetupLabel(result?.agentSetup ?? "skip")
-			},
-			{
-				label: "Project",
-				value: projectRow({
-					alreadyLinked: false,
-					linkedNow: result?.linked === true
-				})
-			},
-			{
-				label: "Config",
-				value: configSummaryLabel(hasConfig ? "template" : "skipped")
-			}
-		],
-		next: []
-	}));
-};
-const noteTemplateKeepsShippedConfig = (config, services) => {
-	if (config === void 0 && services === void 0) return;
-	log.warning(INIT_TEMPLATE_KEEPS_CONFIG);
-};
-const recordInitSuccess = (kind, agentSetup) => {
-	recordCommandSuccessExtras({
-		init_kind: kind,
-		...agentSetup !== void 0 ? { agent_setup: agentSetup } : {}
-	});
-};
 const handler = async (props) => {
-	if (props.output === "json" || props.output === "yaml") throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
-	const cwd = props.cwd ?? process.cwd();
-	const names = existsSync(cwd) ? readdirSync(cwd) : [];
-	const contextFile = resolve(cwd, props.contextFile);
-	const yes = props.yes === true;
-	const named = resolveNamedAgents(props.agent ?? []);
-	assertNamedAgentTooling(named, "init", yes ? { yes: true } : void 0);
-	const run = props.run ?? spawnCliChild;
-	const explicitKey = props.profile ? "" : credentialInputs().apiKeyFlag;
-	const authEnv = explicitKey ? { NEON_API_KEY: explicitKey } : void 0;
-	const forward = {
-		...props.configDir ? { configDir: props.configDir } : {},
-		...props.profile ? { profile: props.profile } : {},
-		apiHost: props.apiHost,
-		contextFile,
-		...props.analytics === false ? { analytics: false } : {}
-	};
-	const services = parsedInitServices(props.services);
-	if (props.config === false && services !== void 0) throw new Error(INIT_CONFIG_SERVICES_CONFLICT);
-	const linkInputs = {
-		...props.orgId ? { orgId: props.orgId } : {},
-		...props.projectId ? { projectId: props.projectId } : {},
-		...props.projectName ? { projectName: props.projectName } : {},
-		...props.regionId ? { regionId: props.regionId } : {},
-		...props.branch ? { branch: props.branch } : {}
-	};
-	const hasExplicitLinkInputs = props.orgId !== void 0 || props.projectId !== void 0 || props.projectName !== void 0 || props.regionId !== void 0 || props.branch !== void 0;
-	const templateChoice = resolveInitTemplateChoice({
-		empty: directoryIsEmpty(names),
-		yes,
-		skipTemplate: props.skipTemplate === true,
-		template: props.template
-	});
-	if (shouldPrintInitBanner(yes)) printInitBanner();
-	if (templateChoice.kind === "default" || templateChoice.kind === "template") {
-		if (templateChoice.kind === "template" && !yes && props.runBootstrap === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
-		const runBootstrap = props.runBootstrap ?? handler$1;
-		noteTemplateKeepsShippedConfig(props.config, services);
-		const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
-			useDefault: yes,
-			...templateChoice.kind === "template" ? { id: templateChoice.id } : {}
-		}, linkInputs));
-		printNestedBootstrapDone(result, cwd, templateChoice.kind === "template" ? templateChoice.id : "default");
-		recordInitSuccess("empty-template", result?.agentSetup);
-		return;
-	}
-	if (templateChoice.kind === "ask") {
-		if (props.pickTemplate === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
-		const templates = await (props.fetchTemplates ?? fetchTemplates)();
-		const picked = await (props.pickTemplate ?? pickInitTemplateInteractively)(templates);
-		if (picked.kind === "template") {
-			const runBootstrap = props.runBootstrap ?? handler$1;
-			noteTemplateKeepsShippedConfig(props.config, services);
-			const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
-				selected: picked.template,
-				useDefault: false
-			}, linkInputs));
-			printNestedBootstrapDone(result, cwd, picked.template.id);
-			recordInitSuccess("empty-template", result?.agentSetup);
-			return;
-		}
-	}
-	const alreadyLinked = isLinked(contextFile);
-	const shouldLink = props.link !== false && (!alreadyLinked || hasExplicitLinkInputs);
-	const existingConfig = hasNeonConfigFile(cwd);
-	const canAskConfig = props.pickConfig !== void 0 || canPickAgentsInteractively();
-	const agentSetup = await runAgentTooling({
-		cwd,
-		yes,
-		run,
-		forward,
-		authEnv,
-		narrate: "human",
-		command: "init",
-		...named.length > 0 ? { agents: named } : {},
-		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
-		...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
-		...props.detectAgent ? { detectAgent: props.detectAgent } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
-	});
-	const canAskLink = props.pickLink !== void 0 || canPickAgentsInteractively();
-	const acceptedLink = shouldLink && (yes || !canAskLink || await (props.pickLink ?? pickInitLinkInteractively)());
-	if (acceptedLink) await (props.linkProject ?? runAuthenticatedLink)({
-		apiClient: props.apiClient,
-		apiKey: props.apiKey,
-		apiHost: props.apiHost,
-		output: props.output,
-		contextFile,
-		yes,
-		clear: false,
-		checks: true,
-		envPull: true,
-		config: false,
-		cwd,
-		...linkInputs,
-		...props.configDir ? { configDir: props.configDir } : {},
-		...props.profile ? { profile: props.profile } : {},
-		...props.oauthHost ? { oauthHost: props.oauthHost } : {},
-		...props.clientId ? { clientId: props.clientId } : {},
-		...props.forceAuth !== void 0 ? { forceAuth: props.forceAuth } : {},
-		...props.allowUnsafeTls !== void 0 ? { allowUnsafeTls: props.allowUnsafeTls } : {}
-	});
-	const configResolution = resolveInitConfigChoice({
-		flag: props.config,
-		yes,
-		canAsk: canAskConfig,
-		existingConfig,
-		...services !== void 0 ? { services } : {}
-	});
-	const accepted = configResolution.kind === "ask" ? await (props.pickConfig ?? pickInitConfigInteractively)() : void 0;
-	const configPlan = configPlanFromResolution(configResolution, accepted);
-	if (configPlan.kind === "write") {
-		await runInitSteps(planExistingInit({
-			linked: true,
-			yes,
-			agentSetup: "skip",
-			config: configPlan
-		}), {
-			cwd,
-			run,
-			forward,
-			authEnv,
-			narrate: "human"
-		});
-		const context = readContextFile(contextFile);
-		const branch = contextBranch(context);
-		if (shouldRefreshEnvAfterNewConfig({
-			wroteNewFile: !existingConfig,
-			projectId: context.projectId,
-			branch
-		})) try {
-			await runInitSteps([["env", "pull"]], {
-				cwd,
-				run,
-				forward,
-				authEnv,
-				narrate: "human"
-			});
-		} catch (err) {
-			const message = err instanceof Error ? err.message : String(err);
-			log.warning(`Created neon.ts, but pulling its Neon env vars failed: %s
-Run \`${getCliName()} env pull\` once resolved.`, message);
-		}
-	}
-	printInitDone(formatInitDone({
-		heading: "Neon setup complete.",
-		rows: [
-			{
-				label: "Agents",
-				value: agentSetupLabel(agentSetup)
-			},
-			{
-				label: "Project",
-				value: projectRow({
-					alreadyLinked,
-					linkedNow: acceptedLink
-				})
-			},
-			{
-				label: "Config",
-				value: configSummaryLabel(configSummary({
-					plan: configPlan,
-					existingConfig
-				}))
-			}
-		],
-		next: []
-	}));
-	recordInitSuccess(templateChoice.kind === "existing" ? "existing" : "empty-skip", agentSetup);
+	await runInit(props);
 };
 //#endregion
-export { builder, command, describe, handler, initChildEnv, init_exports as t };
+export { builder, command, describe, handler, init_exports as t };

package/dist/commands/mcp.js

@@ -8,16 +8,18 @@ import { writer } from "../writer.js";
 import { noPassthrough, single } from "../utils/flags.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 { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { mintMcpApiKey, mintedKeyRevokeCommand, withdrawMintedKey } from "../mcp/mint.js";
-import { confirmMcpInstall } from "../mcp/wizard.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { resolveMcpPlan } from "../mcp/plan.js";
 //#region src/commands/mcp.ts
 var mcp_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,
 	command: () => "mcp",
 	describe: () => describe,
-	handler: () => handler
+	handler: () => handler,
+	mcpInstallError: () => mcpInstallError,
+	reportMcpInstall: () => reportMcpInstall,
+	setupNeonMcp: () => setupNeonMcp
 });
 const command = "mcp";
 const describe = "Install the Neon MCP server into coding agents";
@@ -87,21 +89,30 @@ const builder = (argv) => argv.usage("$0 mcp [options]").options({
 			return parseMcpCategories(parts);
 		}
 	}
-}).example("$0 mcp", "Interactive: config location, agents, auth, then confirm").example("$0 mcp -y", "Global config, installed apps else the host CLI agent, reuse or mint an API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").example("$0 mcp --project", "Write project-level config").example("$0 mcp --read-only", "Hide write tools via ?readonly=true").example("$0 mcp --project-id <id>", "Pin tools to one project via ?projectId=").example("$0 mcp --category querying --category schema", "Limit tools to those categories").epilogue(helpEpilogue(`Installs ${NEON_MCP_URL}`, helpCsv("Supported agents at global scope", mcpGlobalAgents), helpCsv("--project does not support", mcpProjectDroppedAgents), helpCsv("Supported categories", NEON_MCP_CATEGORIES), "neon mcp -y:", "  global config", "  globally installed apps, else the host CLI agent", "  reuse an existing Neon MCP API key, else mint an account-wide key", "  write tools on, all categories", "  no project pin (including from .neon)")).strict().check(noPassthrough("mcp"));
-const handler = async (props) => {
-	const cwd = process.cwd();
-	const interactive = canPickAgentsInteractively() && props.yes !== true;
-	const linkedProjectId = readContextFile(props.contextFile).projectId;
+}).example("$0 mcp", "Interactive: config location, agents, then auth").example("$0 mcp -y", "Global config, installed apps else the host CLI agent, reuse or mint an API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").example("$0 mcp --project", "Write project-level config").example("$0 mcp --read-only", "Hide write tools via ?readonly=true").example("$0 mcp --project-id <id>", "Pin tools to one project via ?projectId=").example("$0 mcp --category querying --category schema", "Limit tools to those categories").epilogue(helpEpilogue(`Installs ${NEON_MCP_URL}`, helpCsv("Supported agents at global scope", mcpGlobalAgents), helpCsv("--project does not support", mcpProjectDroppedAgents), helpCsv("Supported categories", NEON_MCP_CATEGORIES), "neon mcp -y:", "  global config", "  globally installed apps, else the host CLI agent", "  reuse an existing Neon MCP API key, else mint an account-wide key", "  write tools on, all categories", "  no project pin (including from .neon)")).strict().check(noPassthrough("mcp"));
+/**
+* Resolves auth, mints or reuses an API key, and writes the Neon MCP server into every
+* resolved agent. 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.
+*
+* Throws directly when zero agents succeed, since that path never reaches a results table
+* worth showing (same as the CLI handler always did).
+*/
+const setupNeonMcp = async (options) => {
+	const cwd = options.cwd ?? process.cwd();
+	const interactive = canPickAgentsInteractively() && options.yes !== true;
+	const linkedProjectId = readContextFile(options.contextFile).projectId;
 	const plan = await resolveMcpPlan({
-		project: props.project === true,
-		oauth: props.oauth === true,
-		agents: props.agent ?? [],
-		yes: props.yes === true,
+		project: options.project === true,
+		oauth: options.oauth === true,
+		agents: options.agent ?? [],
+		yes: options.yes === true,
 		cwd,
 		interactive,
-		readOnly: props.readOnly === true,
-		projectId: props.projectId,
-		categories: props.category ?? [],
+		readOnly: options.readOnly === true,
+		projectId: options.projectId,
+		categories: options.category ?? [],
 		linkedProjectId
 	});
 	const { install, skipped } = resolveInstallTargets({
@@ -126,22 +137,8 @@ const handler = async (props) => {
 		cwd
 	}) : void 0;
 	if (plan.auth === "api-key" && !existing) {
-		if (!props.apiClient || !props.apiKey) throw new Error(`Authentication required. Run \`${getCliName()} auth\`, pass --api-key or use --oauth to install without a Neon credential.`);
-		if (!canPickAgentsInteractively() && props.yes !== true && (props.agent ?? []).length === 0) throw new Error("No interactive terminal. Pass -y to mint into every detected agent, --agent <name> to name them or --oauth to install without minting.");
-	}
-	if (interactive) {
-		if (!await confirmMcpInstall({
-			scope: plan.scope,
-			install,
-			skipped,
-			auth: plan.auth,
-			reuse: existing !== void 0,
-			url,
-			mintProjectId: plan.urlProjectId
-		})) {
-			log.info("Aborted. Nothing was written.");
-			return;
-		}
+		if (!options.apiClient || !options.apiKey) throw new Error(`Authentication required. Run \`${getCliName()} auth\`, pass --api-key or use --oauth to install without a Neon credential.`);
+		if (!canPickAgentsInteractively() && options.yes !== true && (options.agent ?? []).length === 0) throw new Error("No interactive terminal. Pass -y to mint into every detected agent, --agent <name> to name them or --oauth to install without minting.");
 	}
 	let auth;
 	let minted;
@@ -155,7 +152,7 @@ const handler = async (props) => {
 		if (plan.urlProjectId) log.warning("That key keeps its existing scope. Remove the Neon MCP entry to mint a project-scoped key, or pass --oauth to pin tools without a key.");
 	} else {
 		minted = await mintMcpApiKey({
-			apiClient: props.apiClient,
+			apiClient: options.apiClient,
 			projectId: plan.urlProjectId
 		});
 		auth = {
@@ -198,15 +195,28 @@ const handler = async (props) => {
 		error: row.error
 	});
 	if (successes === 0) {
-		if (minted && props.apiClient) {
-			const withdrawn = await withdrawMintedKey(props.apiClient, minted);
+		if (minted && options.apiClient) {
+			const withdrawn = await withdrawMintedKey(options.apiClient, minted);
 			throw new Error(withdrawn ? "Failed to write Neon MCP config to any agent. The minted API key has been revoked." : `Failed to write Neon MCP config to any agent. The minted API key could NOT be revoked. Remove it with \`${mintedKeyRevokeCommand(minted)}\`.`);
 		}
 		throw new Error("Failed to write Neon MCP config to any agent.");
 	}
-	log.info("URL: %s", url);
+	return {
+		scope: plan.scope,
+		rows,
+		failedAgents,
+		url,
+		auth: auth.kind,
+		...minted ? { minted } : {}
+	};
+};
+/** The exact error `neon mcp` throws when some (not all) agents failed, or `undefined` on full success. */
+const mcpInstallError = (outcome) => outcome.failedAgents.length > 0 ? /* @__PURE__ */ new Error(`Failed to write Neon MCP config for: ${outcome.failedAgents.join(", ")}.`) : void 0;
+/** Writes the results table plus the URL/minted-key/OAuth notices. Shared by `neon mcp` and any in-process caller that wants the same human output. */
+const reportMcpInstall = (props, outcome) => {
+	log.info("URL: %s", outcome.url);
 	const out = writer(props);
-	out.write(rows, {
+	out.write(outcome.rows, {
 		fields: [
 			"agent",
 			"status",
@@ -215,10 +225,27 @@ const handler = async (props) => {
 		title: "MCP"
 	});
 	out.end();
-	if (minted) log.info("Minted API key %s (id %d, %s). Revoke with: %s", minted.name, minted.id, minted.projectId ? "project" : "account", mintedKeyRevokeCommand(minted));
-	if (plan.auth === "oauth") log.info("The agent will prompt for Neon sign-in on first use.");
-	if (failedAgents.length > 0) throw new Error(`Failed to write Neon MCP config for: ${failedAgents.join(", ")}.`);
-	recordCommandSuccessExtras({ scope: plan.scope });
+	if (outcome.minted) log.info("Minted API key %s (id %d, %s). Revoke with: %s", outcome.minted.name, outcome.minted.id, outcome.minted.projectId ? "project" : "account", mintedKeyRevokeCommand(outcome.minted));
+	if (outcome.auth === "oauth") log.info("The agent will prompt for Neon sign-in on first use.");
+};
+const handler = async (props) => {
+	const outcome = await setupNeonMcp({
+		apiClient: props.apiClient,
+		apiKey: props.apiKey,
+		contextFile: props.contextFile,
+		cwd: props.cwd,
+		yes: props.yes,
+		oauth: props.oauth,
+		project: props.project,
+		agent: props.agent,
+		readOnly: props.readOnly,
+		projectId: props.projectId,
+		category: props.category
+	});
+	reportMcpInstall(props, outcome);
+	const error = mcpInstallError(outcome);
+	if (error) throw error;
+	recordCommandSuccessExtras({ scope: outcome.scope });
 };
 //#endregion
-export { builder, command, describe, handler, mcp_exports as t };
+export { builder, command, describe, handler, mcpInstallError, reportMcpInstall, setupNeonMcp, mcp_exports as t };