neon 8.11.1 → 8.11.2

package/dist/_chunks/bootstrap-wPZWa1sT.js

@@ -0,0 +1,499 @@
+import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
+import { isCi } from "../env.js";
+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 { runAuthenticatedLink } from "../init/link.js";
+import { formatTemplateTitle } from "../init/template_title.js";
+import { pickAgentSetupInteractively, pickInitLinkInteractively } from "../init/wizard.js";
+import { runAgentTooling } from "../init/tooling.js";
+import { existsSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import prompts from "prompts";
+//#region src/commands/bootstrap.ts
+var bootstrap_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler
+});
+const command = "bootstrap [directory]";
+const describe = "Scaffold a new project from a Neon starter template, then install agent tooling and link a Neon project";
+const builder = (argv) => argv.usage("$0 bootstrap [directory] [options]").positional("directory", {
+	describe: "Directory to scaffold into. Use \".\" for the current directory. Omit to be prompted.",
+	type: "string"
+}).options({
+	template: {
+		describe: "Template to use (skips the interactive picker). Run with --list-templates to see available templates.",
+		type: "string"
+	},
+	"list-templates": {
+		alias: ["list", "ls"],
+		describe: "List available templates and exit. --output json and --output yaml print a machine-readable catalog.",
+		type: "boolean",
+		default: false
+	},
+	force: {
+		describe: "Scaffold into the target directory even if it is not empty (colliding files are overwritten).",
+		type: "boolean",
+		default: false
+	},
+	default: {
+		alias: "y",
+		describe: "Quick start: scaffold the default template (or --template), then install, git, agent tooling (project folders, else the host CLI agent; if none, pass --agent or omit --default in a terminal), and link with defaults. If several organizations or projects exist, link prints IDs and exits",
+		type: "boolean",
+		default: false
+	},
+	install: {
+		describe: "Install dependencies after scaffolding. In interactive mode this is offered as a prompt; use --no-install to skip without being asked.",
+		type: "boolean",
+		default: true
+	},
+	git: {
+		describe: "Initialize a git repository after scaffolding. In interactive mode this is offered as a prompt; use --no-git to skip without being asked.",
+		type: "boolean",
+		default: true
+	},
+	link: {
+		describe: "Link a Neon project after scaffolding. Templates with neon.ts link after install so env pull works; otherwise linking happens before install. In interactive mode this is offered as a prompt; use --no-link to skip without being asked.",
+		type: "boolean",
+		default: true
+	},
+	"agent-setup": {
+		type: "boolean",
+		default: true,
+		describe: "After scaffolding, install the Neon plugin or skills and MCP. Use --no-agent-setup to skip"
+	},
+	agent: {
+		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",
+		coerce: coerceAgentFlag
+	}
+}).example("$0 bootstrap my-app", "Create ./my-app from an interactively chosen template").example("$0 bootstrap . --template hono", "Scaffold the Hono template into the current directory").example("$0 bootstrap my-app --default", "Skip the pickers; if several orgs or projects exist, link prints IDs and exits").example("$0 bootstrap --list-templates --output json", "Print the template catalog as JSON").example("$0 bootstrap my-app --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("--agent / -a is forwarded to plugins, or to skills and mcp, not both. It skips agent selection, including with --default.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()))).strict();
+const handler = async (props) => {
+	if (props.listTemplates) {
+		const templates = await fetchTemplates();
+		if (props.output === "json" || props.output === "yaml") {
+			writer(props).end(templates.map((t) => ({
+				id: t.id,
+				title: t.title,
+				description: t.description,
+				services: t.services ?? []
+			})), { fields: [
+				"id",
+				"title",
+				"description",
+				"services"
+			] });
+			return;
+		}
+		for (const t of templates) {
+			const services = t.services && t.services.length > 0 ? ` [${t.services.join(" · ")}]` : "";
+			process.stdout.write(`${t.id} — ${t.description}${services}\n`);
+		}
+		return;
+	}
+	if (props.printBanner !== false && shouldPrintInitBanner(props.default)) printInitBanner();
+	const named = resolveNamedAgents(props.agent ?? []);
+	if (props.agentSetup !== false) assertNamedAgentTooling(named, "bootstrap", {
+		...props.directory !== void 0 && props.directory.length > 0 ? { directory: props.directory } : {},
+		...props.default ? { yes: true } : {}
+	});
+	const interactive = !props.default && Boolean(process.stdout.isTTY) && !isCi();
+	const template = props.selectedTemplate ?? await resolveSelectedTemplate(props, interactive, await resolveTemplateList(props));
+	const targetDir = await resolveTargetDir(props, interactive, template);
+	ensureTargetUsable(targetDir, props.force);
+	await scaffold(template, targetDir);
+	recordScaffoldedTemplate(template.id);
+	printScaffolded(template, targetDir);
+	const result = await runPostScaffoldSteps(props, targetDir, interactive, template, named);
+	recordCommandSuccessExtras({ agent_setup: result.agentSetup });
+	return result;
+};
+/**
+* The template list to choose from. When --template is given we try the
+* built-in fallback list first to avoid a network round-trip, only fetching the
+* remote manifest if the id isn't one of the defaults.
+*/
+const resolveTemplateList = async (props) => props.template && findTemplate(FALLBACK_TEMPLATES, props.template) ? FALLBACK_TEMPLATES : fetchTemplates();
+const resolveSelectedTemplate = async (props, interactive, templates) => {
+	if (props.template) {
+		const template = findTemplate(templates, props.template);
+		if (!template) throw new Error(`Unknown template "${props.template}". Available templates: ${templateIds(templates)}.`);
+		return template;
+	}
+	if (props.default) {
+		const fallback = templates[0];
+		if (!fallback) throw new Error("No templates available to scaffold from.");
+		return fallback;
+	}
+	if (!interactive) throw new Error(`No template selected. Re-run in an interactive terminal to pick one, or pass --template <id>. Available templates: ${templateIds(templates)}.`);
+	const { id } = await prompts({
+		onState: onPromptState,
+		type: "select",
+		name: "id",
+		message: "Which template would you like to use?",
+		choices: templates.map((template) => ({
+			title: formatTemplateTitle(template),
+			value: template.id
+		})),
+		initial: 0
+	});
+	const template = findTemplate(templates, id);
+	if (!template) throw new Error("No template selected.");
+	return template;
+};
+const resolveTargetDir = async (props, interactive, template) => {
+	let dir = props.directory;
+	if (dir === void 0) {
+		if (props.default) return resolve(process.cwd(), defaultDirName(template));
+		if (!interactive) throw new Error(`No target directory given. Pass one, e.g. \`${getCliName()} bootstrap my-app\` (or "." for the current directory).`);
+		const { value } = await prompts({
+			onState: onPromptState,
+			type: "text",
+			name: "value",
+			message: "Where should we scaffold your project?",
+			initial: defaultDirName(template),
+			validate: (input) => input && input.trim().length > 0 ? true : "Enter a directory (use \".\" for the current directory)."
+		});
+		dir = String(value).trim();
+	}
+	return resolve(process.cwd(), dir === "." ? "" : dir);
+};
+const defaultDirName = (template) => template.source.subdir.split("/").pop() || template.id;
+const scaffold = async (template, targetDir) => {
+	log.info("Fetching template \"%s\" from GitHub…", template.id);
+	const filesWritten = await scaffoldTemplate(template, targetDir, { onWarn: (message) => {
+		log.warning(message);
+	} });
+	log.info("Scaffolded %d files into %s.", filesWritten, targetDir);
+	return filesWritten;
+};
+const nestedResult = (template, targetDir, hasNeonConfig, outcome) => ({
+	templateTitle: template.title,
+	targetDir,
+	hasNeonConfig,
+	...outcome
+});
+const runPostScaffoldSteps = async (props, targetDir, interactive, template, named) => {
+	const inferred = inferPackageManager(targetDir);
+	const defaultPm = resolvePackageManager(targetDir);
+	const neonConfig = hasNeonConfig(targetDir);
+	if (props.default) return runDefaultSteps(props, targetDir, defaultPm, neonConfig, template, named);
+	if (!interactive) {
+		const outcome = {
+			installed: false,
+			installFailed: false,
+			gitFailed: false,
+			git: false,
+			agentSetup: "skip",
+			linked: false,
+			skippedLinkForDeps: false,
+			agentsRan: false
+		};
+		finishPostScaffold({
+			heading: "Project scaffolded.",
+			template,
+			targetDir,
+			pm: defaultPm,
+			...outcome,
+			suggestLink: true,
+			skipPrint: props.skipDoneSummary === true
+		});
+		return nestedResult(template, targetDir, neonConfig, outcome);
+	}
+	let pm = defaultPm;
+	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" : named.length > 0 ? chooseYesAgentTooling(named).setup : await (props.pickAgentSetup ?? pickAgentSetupInteractively)();
+	const canLink = props.link && !(neonConfig && !wantInstall);
+	if (props.link && !canLink) logSkippedLink(pm);
+	const outcome = await executePostScaffold(props, targetDir, {
+		yes: false,
+		lockAgentSetup: named.length === 0,
+		pm,
+		git: wantGit,
+		agentSetup,
+		install: wantInstall,
+		link: canLink,
+		hasNeonConfig: neonConfig,
+		named
+	});
+	finishPostScaffold({
+		heading: "Project scaffolded.",
+		template,
+		targetDir,
+		pm,
+		...outcome,
+		suggestLink: !outcome.linked,
+		skipPrint: props.skipDoneSummary === true
+	});
+	return nestedResult(template, targetDir, neonConfig, outcome);
+};
+const installPrompt = (inferred) => inferred ? `Install dependencies with ${inferred}?` : "Install dependencies?";
+const runDefaultSteps = async (props, targetDir, pm, neonConfig, template, named) => {
+	log.info("Quick start (--default): skipping the template, install, git, and agent pickers. If several organizations or projects exist, link prints IDs and exits.");
+	const wantGit = props.git && !isGitRepo(targetDir);
+	const agentSetup = props.agentSetup === false ? "skip" : named.length > 0 ? chooseYesAgentTooling(named).setup : "skills-mcp";
+	const outcome = await executePostScaffold(props, targetDir, {
+		yes: true,
+		lockAgentSetup: false,
+		pm,
+		git: wantGit,
+		agentSetup,
+		install: props.install,
+		link: props.link,
+		hasNeonConfig: neonConfig,
+		named
+	});
+	finishPostScaffold({
+		heading: "Project scaffolded.",
+		template,
+		targetDir,
+		pm,
+		...outcome,
+		suggestLink: !outcome.linked,
+		skipPrint: props.skipDoneSummary === true
+	});
+	return nestedResult(template, targetDir, neonConfig, outcome);
+};
+const executePostScaffold = async (props, targetDir, choices) => {
+	const kids = {
+		output: "table",
+		auth: bootstrapAuth(props, targetDir),
+		operations: props.operations,
+		...props.narrate ? { narrate: props.narrate } : {}
+	};
+	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,
+				...choices.named.length > 0 ? { agents: choices.named } : {},
+				...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
+				...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {},
+				...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
+				...props.detectAgent ? { detectAgent: props.detectAgent } : {},
+				command: "bootstrap"
+			});
+			agentsRan = true;
+			continue;
+		}
+		if (action === "install") {
+			log.info("Installing dependencies with %s…", choices.pm);
+			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;
+		}
+		if (!(choices.yes || await (props.pickLink ?? pickInitLinkInteractively)())) continue;
+		await (props.linkProject ?? runAuthenticatedLink)({
+			apiClient: props.apiClient,
+			apiKey: props.apiKey,
+			apiHost: props.apiHost,
+			output: props.output,
+			contextFile: projectContextFile(targetDir, props.contextFile),
+			yes: choices.yes,
+			clear: false,
+			checks: true,
+			envPull: true,
+			config: props.linkNoConfig !== true,
+			cwd: targetDir,
+			...props.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 } : {}
+		});
+		linked = true;
+	}
+	return {
+		installed,
+		installFailed,
+		gitFailed,
+		git,
+		linked,
+		skippedLinkForDeps,
+		agentSetup,
+		agentsRan
+	};
+};
+const isGitRepo = (dir) => existsSync(join(dir, ".git"));
+const NEON_CONFIG_FILENAMES = [
+	"neon.ts",
+	"neon.mts",
+	"neon.js",
+	"neon.mjs"
+];
+const hasNeonConfig = (dir) => NEON_CONFIG_FILENAMES.some((name) => existsSync(join(dir, name)));
+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\`.`);
+};
+/**
+* plugins/skills need no Neon auth at all; mcp resolves it itself, in-process, exactly as
+* the standalone `neon mcp` does (see `init/auth.ts`) — this is that shared context.
+*/
+const bootstrapAuth = (props, targetDir) => ({
+	apiClient: props.apiClient,
+	apiKey: props.apiKey,
+	apiHost: props.apiHost,
+	contextFile: projectContextFile(targetDir, props.contextFile),
+	...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 } : {}
+});
+/**
+* Initialize a git repository in the scaffolded directory. Just `git init` — we
+* 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) => runCommand("git", ["init"], dir);
+const confirm = async (message) => {
+	const { value } = await prompts({
+		onState: onPromptState,
+		type: "confirm",
+		name: "value",
+		message,
+		initial: true
+	});
+	return value === true;
+};
+/**
+* Ask which package manager to install with when we couldn't infer one from the
+* invocation. Offers the managers actually installed (npm preselected); with
+* one or none installed there's nothing to choose, so it returns that one (or
+* npm) without prompting. A cancelled prompt falls back to npm.
+*/
+const selectPackageManager = async () => {
+	const installed = installedPackageManagers();
+	if (installed.length <= 1) return installed[0] ?? "npm";
+	const { pm } = await prompts({
+		onState: onPromptState,
+		type: "select",
+		name: "pm",
+		message: "Which package manager should we use?",
+		choices: installed.map((manager) => ({
+			title: manager,
+			value: manager
+		})),
+		initial: Math.max(0, installed.indexOf("npm"))
+	});
+	return pm ?? "npm";
+};
+const printScaffolded = (template, targetDir) => {
+	log.info("Scaffolded \"%s\" into %s.", template.title, isCurrentDir(targetDir) ? "the current directory" : displayDir(targetDir));
+};
+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) => {
+	if (!input.skipPrint) printDoneSummary(input);
+	if (input.installFailed || input.gitFailed) throw new Error("Setup did not finish.");
+};
+const isCurrentDir = (targetDir) => relative(process.cwd(), targetDir) === "";
+/**
+* The path to show the user: the bare relative path for the common
+* `bootstrap my-app` case, the absolute path when the target sits outside the
+* cwd (a deep `../../..` is noise), and "." for the current directory.
+*/
+const displayDir = (targetDir) => {
+	const rel = relative(process.cwd(), targetDir);
+	if (rel === "") return ".";
+	return rel.startsWith("..") ? targetDir : rel;
+};
+const onPromptState = (state) => {
+	if (state.aborted) {
+		process.stdout.write("\x1B[?25h");
+		process.stdout.write("\n");
+		process.exit(1);
+	}
+};
+//#endregion
+export { handler as a, describe as i, builder as n, command as r, bootstrap_exports as t };