neon-init 0.18.0 → 0.19.0

package/dist/interactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.d.ts","names":[],"sources":["../src/interactive.ts"],"mappings":";;AAkFA;AAIA;;AACU,UALO,sBAAA,CAKP;SACP,CAAA,EAAA,OAAA;AAAO;iBAFY,eAAA,WACZ,yBACP"}
+{"version":3,"file":"interactive.d.ts","names":[],"sources":["../src/interactive.ts"],"mappings":";;AAwLA;AAIA;;AACU,UALO,sBAAA,CAKP;SACP,CAAA,EAAA,OAAA;AAAO;iBAFY,eAAA,WACZ,yBACP"}

package/dist/interactive.js

@@ -9,9 +9,10 @@ import { ensureNeonctl } from "./lib/neonctl.js";
 import { ensureSkillsUpToDate, installAgentSkills } from "./lib/skills.js";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
+import { SelectPrompt } from "@clack/core";
 import { confirm, isCancel, log, multiselect, outro, select, spinner } from "@clack/prompts";
 import { execa } from "execa";
-import { bold, dim } from "yoctocolors";
+import { bold, dim, gray, italic } from "yoctocolors";
 import picocolors from "picocolors";
 //#region src/interactive.ts
 /**
@@ -44,6 +45,56 @@ function patchClackColors() {
 		pc.magenta = originalMagenta;
 	};
 }
+const S_BAR = "│";
+const S_BAR_END = "└";
+const S_STEP_ACTIVE = "◆";
+const S_STEP_SUBMIT = "◇";
+const S_STEP_CANCEL = "■";
+const S_RADIO_ACTIVE = "●";
+const S_RADIO_INACTIVE = "○";
+const SENTINEL_NONE = "none";
+/**
+* Bespoke template picker built on @clack/core's `SelectPrompt`.
+*
+* The stock `@clack/prompts` `select` can only render an option on a single
+* line (title + a parenthesized hint on the focused row), which can't express
+* what we want here: a clean title-only list, and a focused row that expands to
+* `Title (tools)` with the description on its own italic line beneath. Driving
+* the core prompt directly lets us own the frame, so we emit a second
+* gutter-aligned line for the active option only.
+*/
+async function selectTemplate(templates, message) {
+	const options = [...templates.map((t) => ({
+		value: t.id,
+		label: t.title,
+		tools: t.tools,
+		description: t.description
+	})), {
+		value: SENTINEL_NONE,
+		label: "No thanks — continue without scaffolding"
+	}];
+	const green = neonGreenFn;
+	const descIndent = "    ";
+	const descWidth = Math.max(24, (process.stdout.columns || 80) - 8);
+	const renderActive = (option) => {
+		const tools = option.tools && option.tools.length > 0 ? ` ${dim(`(${option.tools.join(", ")})`)}` : "";
+		const head = `${green(S_RADIO_ACTIVE)} ${option.label}${tools}`;
+		if (!option.description) return head;
+		return `${head}\n${wordWrap(option.description, descWidth).split("\n").map((line) => `${green(S_BAR)}${descIndent}${italic(dim(line))}`).join("\n")}`;
+	};
+	return new SelectPrompt({
+		options,
+		initialValue: options[0]?.value,
+		render() {
+			const active = this.options[this.cursor];
+			const heading = (symbol) => `${gray(S_BAR)}\n${symbol}  ${message}\n`;
+			if (this.state === "submit") return `${heading(green(S_STEP_SUBMIT))}${gray(S_BAR)}  ${dim(active?.label ?? "")}`;
+			if (this.state === "cancel") return `${heading(green(S_STEP_CANCEL))}${gray(S_BAR)}  ${dim(active?.label ?? "")}\n${gray(S_BAR)}`;
+			const body = this.options.map((option) => option === active ? renderActive(option) : `${dim(S_RADIO_INACTIVE)} ${dim(option.label)}`).join(`\n${green(S_BAR)}  `);
+			return `${heading(green(S_STEP_ACTIVE))}${green(S_BAR)}  ${body}\n${green(S_BAR_END)}\n`;
+		}
+	}).prompt();
+}
 async function interactiveInit(options = {}) {
 	const restoreColors = patchClackColors();
 	try {
@@ -114,18 +165,7 @@ async function interactiveInitInner(options) {
 			const fetched = await fetchTemplates();
 			if (fetched && fetched.length > 0) templates = fetched;
 		} catch {}
-		const templateResult = await select({
-			message: "No application detected. Would you like to scaffold a new project from a template?",
-			options: [...templates.map((t) => ({
-				value: t.id,
-				label: t.title,
-				hint: t.description
-			})), {
-				value: "none",
-				label: "No thanks — continue without scaffolding"
-			}],
-			initialValue: templates[0]?.id ?? "none"
-		});
+		const templateResult = await selectTemplate(templates, "No application detected. Would you like to scaffold a new project from a template?");
 		if (isCancel(templateResult)) {
 			outro("Setup cancelled.");
 			return;

package/dist/interactive.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive.js","names":[],"sources":["../src/interactive.ts"],"sourcesContent":["/**\n * Interactive v2 CLI — purpose-built guided flow for humans.\n * Uses the same underlying install functions but with a clean clack-based UX.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport {\n\tconfirm,\n\tisCancel,\n\tlog,\n\tmultiselect,\n\toutro,\n\tselect,\n\tspinner,\n} from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { bold, dim } from \"yoctocolors\";\nimport { ALL_CONFIGURABLE_AGENTS, getAddMcpAgentId } from \"./lib/agents.js\";\nimport { ensureNeonctlAuth, isAuthenticated } from \"./lib/auth.js\";\nimport {\n\ttype BootstrapTemplate,\n\tFALLBACK_TEMPLATES,\n\tfetchTemplates,\n\ttype NeonFeature,\n\tscaffoldTemplate,\n} from \"./lib/bootstrap.js\";\nimport { detectAgent, detectIde } from \"./lib/detect-agent.js\";\nimport { detectAvailableEditors } from \"./lib/editors.js\";\nimport {\n\tinstallExtension,\n\tisExtensionInstalled,\n\tusesExtension,\n} from \"./lib/extension.js\";\nimport { inspectProject } from \"./lib/inspect.js\";\nimport { ensureNeonctl } from \"./lib/neonctl.js\";\nimport { ensureSkillsUpToDate, installAgentSkills } from \"./lib/skills.js\";\nimport type { Editor } from \"./lib/types.js\";\n\nfunction wordWrap(text: string, width: number): string {\n\treturn text\n\t\t.split(\"\\n\")\n\t\t.map((line) => {\n\t\t\tif (line.length <= width) return line;\n\t\t\tconst words = line.split(\" \");\n\t\t\tconst lines: string[] = [];\n\t\t\tlet current = \"\";\n\t\t\tfor (const word of words) {\n\t\t\t\tif (\n\t\t\t\t\tcurrent.length + word.length + 1 > width &&\n\t\t\t\t\tcurrent.length > 0\n\t\t\t\t) {\n\t\t\t\t\tlines.push(current);\n\t\t\t\t\tcurrent = word;\n\t\t\t\t} else {\n\t\t\t\t\tcurrent = current.length > 0 ? `${current} ${word}` : word;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (current.length > 0) lines.push(current);\n\t\t\treturn lines.join(\"\\n\");\n\t\t})\n\t\t.join(\"\\n\");\n}\n\n// Patch picocolors (used by @clack/prompts) to use Neon green instead of cyan/magenta.\n// clack hardcodes picocolors.cyan() with no theme API, so this is the least invasive override.\nimport picocolors from \"picocolors\";\n\nconst neonGreenFn = (s: string) => `\\x1b[38;2;75;181;120m${s}\\x1b[39m`;\nconst originalCyan = picocolors.cyan;\nconst originalMagenta = picocolors.magenta;\n\nfunction patchClackColors(): () => void {\n\tconst pc = picocolors as unknown as Record<string, unknown>;\n\tpc.cyan = neonGreenFn;\n\tpc.magenta = neonGreenFn;\n\treturn () => {\n\t\tpc.cyan = originalCyan;\n\t\tpc.magenta = originalMagenta;\n\t};\n}\n\nexport interface InteractiveInitOptions {\n\tpreview?: boolean;\n}\n\nexport async function interactiveInit(\n\toptions: InteractiveInitOptions = {},\n): Promise<void> {\n\tconst restoreColors = patchClackColors();\n\ttry {\n\t\tawait interactiveInitInner(options);\n\t} finally {\n\t\trestoreColors();\n\t}\n}\n\nasync function interactiveInitInner(\n\toptions: InteractiveInitOptions,\n): Promise<void> {\n\tconsole.log();\n\tconsole.log(\n\t\t\"\\x1b[38;2;75;181;120m\" +\n\t\t\t[\n\t\t\t\t\" ██╗  ██╗██████╗  ██████╗ ██╗  ██╗\",\n\t\t\t\t\" ███╗ ██║██╔═══╝ ██╔═══██╗███╗ ██║\",\n\t\t\t\t\" ████╗██║██████╗ ██║   ██║████╗██║\",\n\t\t\t\t\" ██╔████║██╔═══╝ ██║   ██║██╔████║\",\n\t\t\t\t\" ██║╚███║██████╗ ╚██████╔╝██║╚███║\",\n\t\t\t\t\" ╚═╝ ╚══╝╚═════╝  ╚═════╝ ╚═╝ ╚══╝\",\n\t\t\t].join(\"\\n\") +\n\t\t\t\"\\x1b[0m\",\n\t);\n\tconsole.log(\n\t\tdim(\n\t\t\twordWrap(\n\t\t\t\t\"\\nLet's get your project set up with Neon. We'll install the MCP server, agent skills, and IDE extension, then connect your app to a database.\\n\",\n\t\t\t\tprocess.stdout.columns || 80,\n\t\t\t),\n\t\t),\n\t);\n\n\tconst detectedAgentId = detectAgent();\n\tconst detectedEditor = detectedAgentId\n\t\t? agentIdToEditor(detectedAgentId)\n\t\t: null;\n\n\t// -----------------------------------------------------------------------\n\t// Step 1: Inspect what's already in place\n\t// -----------------------------------------------------------------------\n\tconst inspectSpinner = spinner();\n\tinspectSpinner.start(\"Checking existing configuration...\");\n\tconst inspection = await inspectProject([\n\t\t{ id: \"has_app\", description: \"\", lookFor: [] },\n\t\t{ id: \"mcp_server\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"connection_string\", description: \"\", lookFor: [] },\n\t\t{ id: \"project_stack\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t\t{ id: \"ide_type\", description: \"\", lookFor: [] },\n\t]);\n\tinspectSpinner.stop(dim(\"Configuration checked ✓\"));\n\n\tconst hasApp = inspection.hasApp === true;\n\tlet selectedFeatures: NeonFeature[] = [];\n\tlet selectedTemplate: BootstrapTemplate | null = null;\n\n\t// Preview mode: bootstrap from template if no app detected\n\tif (options.preview && !hasApp) {\n\t\tlet templates = FALLBACK_TEMPLATES;\n\t\ttry {\n\t\t\tconst fetched = await fetchTemplates();\n\t\t\tif (fetched && fetched.length > 0) templates = fetched;\n\t\t} catch {}\n\n\t\tconst templateResult = await select({\n\t\t\tmessage:\n\t\t\t\t\"No application detected. Would you like to scaffold a new project from a template?\",\n\t\t\toptions: [\n\t\t\t\t...templates.map((t) => ({\n\t\t\t\t\tvalue: t.id,\n\t\t\t\t\tlabel: t.title,\n\t\t\t\t\thint: t.description,\n\t\t\t\t})),\n\t\t\t\t{\n\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\tlabel: \"No thanks — continue without scaffolding\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tinitialValue: templates[0]?.id ?? \"none\",\n\t\t});\n\t\tif (isCancel(templateResult)) {\n\t\t\toutro(\"Setup cancelled.\");\n\t\t\treturn;\n\t\t}\n\t\tif (templateResult !== \"none\") {\n\t\t\tselectedTemplate =\n\t\t\t\ttemplates.find((t) => t.id === templateResult) ?? null;\n\t\t\tif (selectedTemplate) {\n\t\t\t\tselectedFeatures = selectedTemplate.requires;\n\t\t\t\tconst bootstrapS = spinner();\n\t\t\t\tbootstrapS.start(\n\t\t\t\t\t`Scaffolding project from template \"${selectedTemplate.title}\"...`,\n\t\t\t\t);\n\t\t\t\ttry {\n\t\t\t\t\tawait scaffoldTemplate(selectedTemplate, \".\", {\n\t\t\t\t\t\tonWarn: (message) => log.warn(message),\n\t\t\t\t\t});\n\t\t\t\t\tbootstrapS.stop(\n\t\t\t\t\t\tdim(\n\t\t\t\t\t\t\t`Scaffolded project from \"${selectedTemplate.title}\" ✓`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst msg =\n\t\t\t\t\t\terr instanceof Error ? err.message : \"Unknown error\";\n\t\t\t\t\tbootstrapS.stop(\"Failed to scaffold project\");\n\t\t\t\t\tlog.error(msg);\n\t\t\t\t\toutro(\"Setup failed.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// For brownfield flows (existing app), ask which features to enable\n\tif (!selectedTemplate && hasApp) {\n\t\tconst featuresResult = await select({\n\t\t\tmessage:\n\t\t\t\t\"Which Neon features would you like to enable for this project?\",\n\t\t\toptions: [\n\t\t\t\t{ value: \"database\", label: \"Database\" },\n\t\t\t\t{\n\t\t\t\t\tvalue: \"database,auth\",\n\t\t\t\t\tlabel: \"Database + Neon Auth (adds authentication via Neon)\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tinitialValue: \"database\",\n\t\t});\n\t\tif (isCancel(featuresResult)) {\n\t\t\toutro(\"Setup cancelled.\");\n\t\t\treturn;\n\t\t}\n\t\tselectedFeatures = (featuresResult as string).split(\n\t\t\t\",\",\n\t\t) as NeonFeature[];\n\t}\n\n\t// Write _init metadata to .neon\n\tif (selectedFeatures.length > 0) {\n\t\tconst neonPath = resolve(process.cwd(), \".neon\");\n\t\tlet existing: Record<string, unknown> = {};\n\t\tif (existsSync(neonPath)) {\n\t\t\ttry {\n\t\t\t\texisting = JSON.parse(readFileSync(neonPath, \"utf-8\"));\n\t\t\t} catch {}\n\t\t}\n\t\texisting._init = { features: selectedFeatures };\n\t\twriteFileSync(neonPath, `${JSON.stringify(existing, null, 2)}\\n`);\n\t}\n\n\tconst mcpAlready = inspection.mcpConfigured === true;\n\t// If we bootstrapped, skills come from the template\n\tconst skillsAlready =\n\t\tinspection.skillsInstalled === true || selectedTemplate !== null;\n\tconst hasNeonConnection = inspection.connectionString === true;\n\tlet needsMcp = !mcpAlready;\n\tconst needsSkills = !skillsAlready;\n\tconst needsInstall = needsMcp || needsSkills;\n\n\t// Check if .neon context file exists\n\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\tconst hasNeonContext =\n\t\texistsSync(neonContextPath) &&\n\t\t(() => {\n\t\t\ttry {\n\t\t\t\tconst content = JSON.parse(\n\t\t\t\t\treadFileSync(neonContextPath, \"utf-8\"),\n\t\t\t\t);\n\t\t\t\treturn !!content.projectId;\n\t\t\t} catch {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t})();\n\n\t// Check if Neon Auth is configured\n\tconst hasNeonAuth = (() => {\n\t\tfor (const envFile of [\".env\", \".env.local\"]) {\n\t\t\tconst envPath = resolve(process.cwd(), envFile);\n\t\t\tif (existsSync(envPath)) {\n\t\t\t\ttry {\n\t\t\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\t\t\tif (/^NEON_AUTH_/m.test(content)) return true;\n\t\t\t\t} catch {}\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t})();\n\n\t// Check if extension is installed for the detected editor\n\tlet extensionAlready = false;\n\tif (detectedEditor && usesExtension(detectedEditor)) {\n\t\textensionAlready = await isExtensionInstalled(detectedEditor);\n\t}\n\n\t// If tooling + database are configured, check if there's anything left to do\n\tif (mcpAlready && skillsAlready && hasNeonConnection && hasNeonContext) {\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon MCP server already configured (${inspection.mcpScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon agent skills already installed (${inspection.skillsScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\t\tif (extensionAlready)\n\t\t\tlog.step(dim(\"Neon editor extension installed ✓\"));\n\t\tlog.step(dim(\"Neon database connected ✓\"));\n\n\t\tif (hasNeonAuth) {\n\t\t\tlog.step(dim(\"Neon Auth configured ✓\"));\n\t\t\toutro(\n\t\t\t\tdim(\n\t\t\t\t\t\"Your project is fully configured with Neon. Nothing to do.\",\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Neon Auth not configured — ask if they want it\n\t\tconst authResult = await select({\n\t\t\tmessage:\n\t\t\t\t\"Would you like to set up Neon Auth for user authentication?\",\n\t\t\toptions: [\n\t\t\t\t{ value: \"yes\", label: \"Yes, set up Neon Auth\" },\n\t\t\t\t{ value: \"no\", label: \"No, skip for now\" },\n\t\t\t],\n\t\t\tinitialValue: \"no\",\n\t\t});\n\n\t\tif (isCancel(authResult) || authResult === \"no\") {\n\t\t\toutro(\n\t\t\t\tdim(\n\t\t\t\t\t`Your project is configured with Neon. You can set up Neon Auth later by having your agent run: neonctl init --agent --data '{\"step\":\"neon-auth\"}'`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Read .neon for project context\n\t\tlet projectId: string | null = null;\n\t\ttry {\n\t\t\tconst neonCtx = JSON.parse(readFileSync(neonContextPath, \"utf-8\"));\n\t\t\tprojectId = neonCtx.projectId ?? null;\n\t\t} catch {}\n\n\t\tlog.step(\"Next steps\");\n\t\tconst promptLines = [\"Set up Neon Auth for this project.\"];\n\t\tif (projectId) promptLines.push(`Project ID: ${projectId}.`);\n\t\tlog.message(dim(\"Copy the following into your agent chat:\"));\n\t\tlog.message(\n\t\t\tpromptLines.map((line) => bold(neonGreenFn(line))).join(\"\\n\"),\n\t\t);\n\t\toutro(dim(\"Have feedback? Email us at feedback@neon.tech\"));\n\t\treturn;\n\t}\n\n\t// Log what's already in place\n\tif (mcpAlready)\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon MCP server already configured (${inspection.mcpScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\tif (skillsAlready)\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon agent skills already installed (${inspection.skillsScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\n\t// -----------------------------------------------------------------------\n\t// Step 3–5: Install what's missing (skip entirely if everything is configured)\n\t// -----------------------------------------------------------------------\n\tif (needsInstall) {\n\t\tconst homeDir = process.env.HOME || process.env.USERPROFILE;\n\t\tif (!homeDir) {\n\t\t\tlog.error(\"Could not determine home directory.\");\n\t\t\toutro(\"Setup failed.\");\n\t\t\treturn;\n\t\t}\n\n\t\tlet selectedEditors: Editor[];\n\t\tif (detectedEditor) {\n\t\t\tselectedEditors = [detectedEditor];\n\t\t} else {\n\t\t\tconst availableEditors = await detectAvailableEditors(homeDir);\n\t\t\tconst editorResponse = await multiselect({\n\t\t\t\tmessage: \"Which editor(s) would you like to configure?\",\n\t\t\t\toptions: ALL_CONFIGURABLE_AGENTS.map((agent) => ({\n\t\t\t\t\tvalue: agent.editor,\n\t\t\t\t\tlabel: agent.editor,\n\t\t\t\t\thint: agent.hint,\n\t\t\t\t})),\n\t\t\t\tinitialValues: availableEditors,\n\t\t\t\trequired: true,\n\t\t\t});\n\t\t\tif (isCancel(editorResponse)) {\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tselectedEditors = editorResponse as Editor[];\n\t\t\tif (selectedEditors.length === 0) {\n\t\t\t\tlog.warn(\"No editors selected.\");\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Check extension status\n\t\tconst vscodeEditors = selectedEditors.filter(usesExtension);\n\t\tlet extensionAlreadyInstalled = false;\n\t\tif (vscodeEditors.length > 0) {\n\t\t\tconst checks = await Promise.all(\n\t\t\t\tvscodeEditors.map((e) => isExtensionInstalled(e)),\n\t\t\t);\n\t\t\textensionAlreadyInstalled = checks.every(Boolean);\n\t\t\tif (extensionAlreadyInstalled) {\n\t\t\t\tlog.step(dim(\"Neon editor extension already installed ✓\"));\n\t\t\t}\n\t\t}\n\t\tlet doInstallExtension =\n\t\t\tvscodeEditors.length > 0 && !extensionAlreadyInstalled;\n\n\t\t// Build hint showing only what needs installing\n\t\tconst hintParts: string[] = [];\n\t\tif (needsMcp) hintParts.push(\"MCP server (global)\");\n\t\tif (needsSkills) hintParts.push(\"agent skills (project)\");\n\t\tif (doInstallExtension) hintParts.push(\"editor extension\");\n\n\t\t// Installation preferences\n\t\tlet mcpScope: \"global\" | \"project\" | \"none\" = \"global\";\n\t\tlet skillsScope: \"global\" | \"project\" = \"project\";\n\n\t\tlet modeResult: string;\n\t\twhile (true) {\n\t\t\tconst editorName = selectedEditors.join(\", \");\n\t\t\tconst result = await select({\n\t\t\t\tmessage: `Configure ${editorName} for Neon:`,\n\t\t\t\toptions: [\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\t\tlabel: \"Install with defaults\",\n\t\t\t\t\t\thint: hintParts.join(\", \"),\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\tlabel: \"Customize installation\",\n\t\t\t\t\t\thint: \"choose scopes and options\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"change_editor\",\n\t\t\t\t\t\tlabel: \"Configure a different editor\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tinitialValue: \"defaults\",\n\t\t\t});\n\n\t\t\tif (isCancel(result)) {\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (result === \"change_editor\") {\n\t\t\t\tconst availableEditors = await detectAvailableEditors(homeDir);\n\t\t\t\tconst editorResponse = await multiselect({\n\t\t\t\t\tmessage: \"Which editor(s) would you like to configure?\",\n\t\t\t\t\toptions: ALL_CONFIGURABLE_AGENTS.map((agent) => ({\n\t\t\t\t\t\tvalue: agent.editor,\n\t\t\t\t\t\tlabel: agent.editor,\n\t\t\t\t\t\thint: agent.hint,\n\t\t\t\t\t})),\n\t\t\t\t\tinitialValues: availableEditors,\n\t\t\t\t\trequired: true,\n\t\t\t\t});\n\t\t\t\tif (isCancel(editorResponse)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tselectedEditors = editorResponse as Editor[];\n\t\t\t\tif (selectedEditors.length === 0) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tmodeResult = result as string;\n\t\t\tbreak;\n\t\t}\n\n\t\tif (modeResult === \"customize\") {\n\t\t\tif (needsMcp) {\n\t\t\t\tconst scopeResult = await select({\n\t\t\t\t\tmessage: \"Where should the Neon MCP server be configured?\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\t\t\tlabel: \"Skip — do not install the MCP server\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t});\n\t\t\t\tif (isCancel(scopeResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tmcpScope = scopeResult as \"global\" | \"project\" | \"none\";\n\t\t\t\tif (mcpScope === \"none\") needsMcp = false;\n\t\t\t}\n\n\t\t\tif (needsSkills) {\n\t\t\t\tconst skillsScopeResult = await select({\n\t\t\t\t\tmessage: \"Where should Neon agent skills be installed?\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tinitialValue: \"project\",\n\t\t\t\t});\n\t\t\t\tif (isCancel(skillsScopeResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tskillsScope = skillsScopeResult as \"global\" | \"project\";\n\t\t\t}\n\n\t\t\tif (doInstallExtension) {\n\t\t\t\tconst extResult = await confirm({\n\t\t\t\t\tmessage: `Install the Neon extension for ${vscodeEditors.join(\", \")}?`,\n\t\t\t\t});\n\t\t\t\tif (isCancel(extResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tdoInstallExtension = extResult;\n\t\t\t}\n\t\t}\n\n\t\t// Auth check before install\n\t\tconst installAuthed = await isAuthenticated();\n\t\tif (!installAuthed) {\n\t\t\tconst authS = spinner();\n\t\t\tauthS.start(\"Authenticating with Neon...\");\n\t\t\tconst authSuccess = await ensureNeonctlAuth();\n\t\t\tif (!authSuccess) {\n\t\t\t\tauthS.stop(\"Authentication failed.\");\n\t\t\t\toutro(\"Run neon-init again after signing in.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tauthS.stop(\"Authenticated.\");\n\t\t}\n\n\t\t// Ensure neonctl CLI is installed and up to date\n\t\tconst nctlS = spinner();\n\t\tnctlS.start(\"Checking neonctl CLI...\");\n\t\tconst nctlResult = await ensureNeonctl();\n\t\tswitch (nctlResult.status) {\n\t\t\tcase \"already_current\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`neonctl CLI is up to date (v${nctlResult.version}) ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"installed\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`Installed neonctl CLI (v${nctlResult.version}) ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"updated\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`Updated neonctl CLI to v${nctlResult.version} ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"failed\":\n\t\t\t\tnctlS.stop(\"Failed to install neonctl CLI\");\n\t\t\t\tlog.warn(\n\t\t\t\t\t\"neonctl could not be installed automatically. The setup will continue using npx.\",\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// Install only what's missing\n\t\tfor (const editor of selectedEditors) {\n\t\t\tif (needsMcp) {\n\t\t\t\tconst mcpAgentId = getAddMcpAgentId(editor);\n\t\t\t\tconst mcpArgs = [\n\t\t\t\t\t\"-y\",\n\t\t\t\t\t\"add-mcp\",\n\t\t\t\t\t\"https://mcp.neon.tech/mcp\",\n\t\t\t\t\t\"-n\",\n\t\t\t\t\t\"Neon\",\n\t\t\t\t\t\"-y\",\n\t\t\t\t\t\"-a\",\n\t\t\t\t\tmcpAgentId,\n\t\t\t\t];\n\t\t\t\tif (mcpScope === \"global\") mcpArgs.splice(5, 0, \"-g\");\n\n\t\t\t\tconst mcpS = spinner();\n\t\t\t\tmcpS.start(`Installing Neon MCP server for ${editor}...`);\n\t\t\t\ttry {\n\t\t\t\t\tawait execa(\"npx\", mcpArgs, {\n\t\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\t\ttimeout: 60000,\n\t\t\t\t\t});\n\t\t\t\t\tmcpS.stop(\n\t\t\t\t\t\tdim(\n\t\t\t\t\t\t\t`Neon MCP server configured for ${editor} (${mcpScope}) ✓`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst msg =\n\t\t\t\t\t\terr instanceof Error ? err.message : \"Unknown error\";\n\t\t\t\t\tmcpS.stop(`Failed to configure MCP server for ${editor}`);\n\t\t\t\t\tlog.error(msg);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (needsSkills) {\n\t\t\t\tawait installAgentSkills([editor], {\n\t\t\t\t\tscope: skillsScope,\n\t\t\t\t\tpreview: options.preview,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (doInstallExtension && usesExtension(editor)) {\n\t\t\t\tconst extS = spinner();\n\t\t\t\textS.start(`Installing Neon extension for ${editor}...`);\n\t\t\t\tconst extOk = await installExtension(editor);\n\t\t\t\tif (extOk) {\n\t\t\t\t\textS.stop(dim(`Neon extension installed for ${editor} ✓`));\n\t\t\t\t} else {\n\t\t\t\t\textS.stop(\n\t\t\t\t\t\t`Extension install failed — install manually from the extensions panel.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Ensure all required skills are present (fills in any missing ones).\n\t// detectAgent() returns null in a human terminal (TTY), so fall back\n\t// to IDE detection which works regardless of TTY.\n\tconst ide = detectIde();\n\tconst agentForSkills =\n\t\tdetectAgent() ??\n\t\t(ide === \"Cursor\"\n\t\t\t? \"cursor\"\n\t\t\t: ide === \"VS Code\"\n\t\t\t\t? \"vscode\"\n\t\t\t\t: ide === \"Windsurf\"\n\t\t\t\t\t? \"windsurf\"\n\t\t\t\t\t: null);\n\tif (agentForSkills) {\n\t\tconst detectedSkillsScope =\n\t\t\tinspection.skillsScope === \"global\" ? \"global\" : undefined;\n\t\tawait ensureSkillsUpToDate(\n\t\t\tagentForSkills,\n\t\t\tdetectedSkillsScope,\n\t\t\toptions.preview,\n\t\t);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Step 6: Done — build prompt for the agent to continue\n\t// -----------------------------------------------------------------------\n\n\t// Build the getting-started data payload (same as agent mode)\n\tconst gettingStartedData: Record<string, unknown> = {};\n\tif (hasNeonConnection) gettingStartedData.hasConnectionString = true;\n\tif (inspection.framework && inspection.framework !== \"none\")\n\t\tgettingStartedData.framework = inspection.framework;\n\tif (inspection.orm && inspection.orm !== \"none\")\n\t\tgettingStartedData.orm = inspection.orm;\n\tif (inspection.migrationTool && inspection.migrationTool !== \"none\")\n\t\tgettingStartedData.migrationTool = inspection.migrationTool;\n\tif (inspection.migrationDir && inspection.migrationDir !== \"none\")\n\t\tgettingStartedData.migrationDir = inspection.migrationDir;\n\tif (selectedFeatures.length > 0)\n\t\tgettingStartedData.features = selectedFeatures;\n\tif (options.preview) gettingStartedData.preview = true;\n\n\t// Build a prompt for the user to paste into their agent chat\n\tconst cmd = `neonctl init --agent --data '${JSON.stringify({ step: \"getting-started\", ...gettingStartedData })}'`;\n\t// Account for clack's \"│  \" prefix (3 chars) when wrapping\n\tconst cols = (process.stdout.columns || 80) - 3;\n\tconst promptText = `To finish setting up Neon using Neon's agent-guided onboarding experience, have your agent run this shell command: ${cmd}`;\n\n\tlog.step(\"Next steps\");\n\tlog.message(dim(\"Copy the following into your agent chat:\"));\n\tlog.message(\n\t\twordWrap(promptText, cols)\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => bold(neonGreenFn(line)))\n\t\t\t.join(\"\\n\"),\n\t);\n\toutro(dim(\"Have feedback? Email us at feedback@neon.tech\"));\n}\n\nfunction agentIdToEditor(agentId: string): Editor | null {\n\tswitch (agentId) {\n\t\tcase \"cursor\":\n\t\t\treturn \"Cursor\";\n\t\tcase \"vscode\":\n\t\t\treturn \"VS Code\";\n\t\tcase \"claude-code\":\n\t\t\treturn \"Claude CLI\";\n\t\tcase \"windsurf\":\n\t\t\t// Windsurf not in Editor type yet — fall back to prompt\n\t\t\treturn null;\n\t\tcase \"codex\":\n\t\t\treturn \"Codex\";\n\t\tcase \"cline\":\n\t\t\treturn \"Cline\";\n\t\tdefault:\n\t\t\treturn null;\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"interactive.js","names":[],"sources":["../src/interactive.ts"],"sourcesContent":["/**\n * Interactive v2 CLI — purpose-built guided flow for humans.\n * Uses the same underlying install functions but with a clean clack-based UX.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { SelectPrompt } from \"@clack/core\";\nimport {\n\tconfirm,\n\tisCancel,\n\tlog,\n\tmultiselect,\n\toutro,\n\tselect,\n\tspinner,\n} from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { bold, dim, gray, italic } from \"yoctocolors\";\nimport { ALL_CONFIGURABLE_AGENTS, getAddMcpAgentId } from \"./lib/agents.js\";\nimport { ensureNeonctlAuth, isAuthenticated } from \"./lib/auth.js\";\nimport {\n\ttype BootstrapTemplate,\n\tFALLBACK_TEMPLATES,\n\tfetchTemplates,\n\ttype NeonFeature,\n\tscaffoldTemplate,\n} from \"./lib/bootstrap.js\";\nimport { detectAgent, detectIde } from \"./lib/detect-agent.js\";\nimport { detectAvailableEditors } from \"./lib/editors.js\";\nimport {\n\tinstallExtension,\n\tisExtensionInstalled,\n\tusesExtension,\n} from \"./lib/extension.js\";\nimport { inspectProject } from \"./lib/inspect.js\";\nimport { ensureNeonctl } from \"./lib/neonctl.js\";\nimport { ensureSkillsUpToDate, installAgentSkills } from \"./lib/skills.js\";\nimport type { Editor } from \"./lib/types.js\";\n\nfunction wordWrap(text: string, width: number): string {\n\treturn text\n\t\t.split(\"\\n\")\n\t\t.map((line) => {\n\t\t\tif (line.length <= width) return line;\n\t\t\tconst words = line.split(\" \");\n\t\t\tconst lines: string[] = [];\n\t\t\tlet current = \"\";\n\t\t\tfor (const word of words) {\n\t\t\t\tif (\n\t\t\t\t\tcurrent.length + word.length + 1 > width &&\n\t\t\t\t\tcurrent.length > 0\n\t\t\t\t) {\n\t\t\t\t\tlines.push(current);\n\t\t\t\t\tcurrent = word;\n\t\t\t\t} else {\n\t\t\t\t\tcurrent = current.length > 0 ? `${current} ${word}` : word;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (current.length > 0) lines.push(current);\n\t\t\treturn lines.join(\"\\n\");\n\t\t})\n\t\t.join(\"\\n\");\n}\n\n// Patch picocolors (used by @clack/prompts) to use Neon green instead of cyan/magenta.\n// clack hardcodes picocolors.cyan() with no theme API, so this is the least invasive override.\nimport picocolors from \"picocolors\";\n\nconst neonGreenFn = (s: string) => `\\x1b[38;2;75;181;120m${s}\\x1b[39m`;\nconst originalCyan = picocolors.cyan;\nconst originalMagenta = picocolors.magenta;\n\nfunction patchClackColors(): () => void {\n\tconst pc = picocolors as unknown as Record<string, unknown>;\n\tpc.cyan = neonGreenFn;\n\tpc.magenta = neonGreenFn;\n\treturn () => {\n\t\tpc.cyan = originalCyan;\n\t\tpc.magenta = originalMagenta;\n\t};\n}\n\n// clack box-drawing glyphs, mirrored from @clack/prompts so our custom\n// template picker lines up with every other step in the flow.\nconst S_BAR = \"│\";\nconst S_BAR_END = \"└\";\nconst S_STEP_ACTIVE = \"◆\";\nconst S_STEP_SUBMIT = \"◇\";\nconst S_STEP_CANCEL = \"■\";\nconst S_RADIO_ACTIVE = \"●\";\nconst S_RADIO_INACTIVE = \"○\";\n\ninterface TemplateOption {\n\tvalue: string;\n\tlabel: string;\n\ttools?: string[];\n\tdescription?: string;\n}\n\nconst SENTINEL_NONE = \"none\";\n\n/**\n * Bespoke template picker built on @clack/core's `SelectPrompt`.\n *\n * The stock `@clack/prompts` `select` can only render an option on a single\n * line (title + a parenthesized hint on the focused row), which can't express\n * what we want here: a clean title-only list, and a focused row that expands to\n * `Title (tools)` with the description on its own italic line beneath. Driving\n * the core prompt directly lets us own the frame, so we emit a second\n * gutter-aligned line for the active option only.\n */\nasync function selectTemplate(\n\ttemplates: BootstrapTemplate[],\n\tmessage: string,\n): Promise<string | symbol> {\n\tconst options: TemplateOption[] = [\n\t\t...templates.map((t) => ({\n\t\t\tvalue: t.id,\n\t\t\tlabel: t.title,\n\t\t\ttools: t.tools,\n\t\t\tdescription: t.description,\n\t\t})),\n\t\t{\n\t\t\tvalue: SENTINEL_NONE,\n\t\t\tlabel: \"No thanks — continue without scaffolding\",\n\t\t},\n\t];\n\n\tconst green = neonGreenFn;\n\t// Title sits at column 6 (\"│  ● \"), so wrapped description lines indent four\n\t// spaces past the gutter to line up under it.\n\tconst descIndent = \"    \";\n\tconst descWidth = Math.max(24, (process.stdout.columns || 80) - 8);\n\n\tconst renderActive = (option: TemplateOption): string => {\n\t\tconst tools =\n\t\t\toption.tools && option.tools.length > 0\n\t\t\t\t? ` ${dim(`(${option.tools.join(\", \")})`)}`\n\t\t\t\t: \"\";\n\t\tconst head = `${green(S_RADIO_ACTIVE)} ${option.label}${tools}`;\n\t\tif (!option.description) return head;\n\t\tconst body = wordWrap(option.description, descWidth)\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => `${green(S_BAR)}${descIndent}${italic(dim(line))}`)\n\t\t\t.join(\"\\n\");\n\t\treturn `${head}\\n${body}`;\n\t};\n\n\tconst prompt = new SelectPrompt<TemplateOption>({\n\t\toptions,\n\t\tinitialValue: options[0]?.value,\n\t\trender() {\n\t\t\tconst active = this.options[this.cursor];\n\t\t\tconst heading = (symbol: string) =>\n\t\t\t\t`${gray(S_BAR)}\\n${symbol}  ${message}\\n`;\n\n\t\t\tif (this.state === \"submit\") {\n\t\t\t\treturn `${heading(green(S_STEP_SUBMIT))}${gray(S_BAR)}  ${dim(\n\t\t\t\t\tactive?.label ?? \"\",\n\t\t\t\t)}`;\n\t\t\t}\n\t\t\tif (this.state === \"cancel\") {\n\t\t\t\treturn `${heading(green(S_STEP_CANCEL))}${gray(S_BAR)}  ${dim(\n\t\t\t\t\tactive?.label ?? \"\",\n\t\t\t\t)}\\n${gray(S_BAR)}`;\n\t\t\t}\n\n\t\t\tconst body = this.options\n\t\t\t\t.map((option) =>\n\t\t\t\t\toption === active\n\t\t\t\t\t\t? renderActive(option)\n\t\t\t\t\t\t: `${dim(S_RADIO_INACTIVE)} ${dim(option.label)}`,\n\t\t\t\t)\n\t\t\t\t.join(`\\n${green(S_BAR)}  `);\n\t\t\treturn `${heading(green(S_STEP_ACTIVE))}${green(S_BAR)}  ${body}\\n${green(\n\t\t\t\tS_BAR_END,\n\t\t\t)}\\n`;\n\t\t},\n\t});\n\n\treturn prompt.prompt();\n}\n\nexport interface InteractiveInitOptions {\n\tpreview?: boolean;\n}\n\nexport async function interactiveInit(\n\toptions: InteractiveInitOptions = {},\n): Promise<void> {\n\tconst restoreColors = patchClackColors();\n\ttry {\n\t\tawait interactiveInitInner(options);\n\t} finally {\n\t\trestoreColors();\n\t}\n}\n\nasync function interactiveInitInner(\n\toptions: InteractiveInitOptions,\n): Promise<void> {\n\tconsole.log();\n\tconsole.log(\n\t\t\"\\x1b[38;2;75;181;120m\" +\n\t\t\t[\n\t\t\t\t\" ██╗  ██╗██████╗  ██████╗ ██╗  ██╗\",\n\t\t\t\t\" ███╗ ██║██╔═══╝ ██╔═══██╗███╗ ██║\",\n\t\t\t\t\" ████╗██║██████╗ ██║   ██║████╗██║\",\n\t\t\t\t\" ██╔████║██╔═══╝ ██║   ██║██╔████║\",\n\t\t\t\t\" ██║╚███║██████╗ ╚██████╔╝██║╚███║\",\n\t\t\t\t\" ╚═╝ ╚══╝╚═════╝  ╚═════╝ ╚═╝ ╚══╝\",\n\t\t\t].join(\"\\n\") +\n\t\t\t\"\\x1b[0m\",\n\t);\n\tconsole.log(\n\t\tdim(\n\t\t\twordWrap(\n\t\t\t\t\"\\nLet's get your project set up with Neon. We'll install the MCP server, agent skills, and IDE extension, then connect your app to a database.\\n\",\n\t\t\t\tprocess.stdout.columns || 80,\n\t\t\t),\n\t\t),\n\t);\n\n\tconst detectedAgentId = detectAgent();\n\tconst detectedEditor = detectedAgentId\n\t\t? agentIdToEditor(detectedAgentId)\n\t\t: null;\n\n\t// -----------------------------------------------------------------------\n\t// Step 1: Inspect what's already in place\n\t// -----------------------------------------------------------------------\n\tconst inspectSpinner = spinner();\n\tinspectSpinner.start(\"Checking existing configuration...\");\n\tconst inspection = await inspectProject([\n\t\t{ id: \"has_app\", description: \"\", lookFor: [] },\n\t\t{ id: \"mcp_server\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"connection_string\", description: \"\", lookFor: [] },\n\t\t{ id: \"project_stack\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t\t{ id: \"ide_type\", description: \"\", lookFor: [] },\n\t]);\n\tinspectSpinner.stop(dim(\"Configuration checked ✓\"));\n\n\tconst hasApp = inspection.hasApp === true;\n\tlet selectedFeatures: NeonFeature[] = [];\n\tlet selectedTemplate: BootstrapTemplate | null = null;\n\n\t// Preview mode: bootstrap from template if no app detected\n\tif (options.preview && !hasApp) {\n\t\tlet templates = FALLBACK_TEMPLATES;\n\t\ttry {\n\t\t\tconst fetched = await fetchTemplates();\n\t\t\tif (fetched && fetched.length > 0) templates = fetched;\n\t\t} catch {}\n\n\t\tconst templateResult = await selectTemplate(\n\t\t\ttemplates,\n\t\t\t\"No application detected. Would you like to scaffold a new project from a template?\",\n\t\t);\n\t\tif (isCancel(templateResult)) {\n\t\t\toutro(\"Setup cancelled.\");\n\t\t\treturn;\n\t\t}\n\t\tif (templateResult !== \"none\") {\n\t\t\tselectedTemplate =\n\t\t\t\ttemplates.find((t) => t.id === templateResult) ?? null;\n\t\t\tif (selectedTemplate) {\n\t\t\t\tselectedFeatures = selectedTemplate.requires;\n\t\t\t\tconst bootstrapS = spinner();\n\t\t\t\tbootstrapS.start(\n\t\t\t\t\t`Scaffolding project from template \"${selectedTemplate.title}\"...`,\n\t\t\t\t);\n\t\t\t\ttry {\n\t\t\t\t\tawait scaffoldTemplate(selectedTemplate, \".\", {\n\t\t\t\t\t\tonWarn: (message) => log.warn(message),\n\t\t\t\t\t});\n\t\t\t\t\tbootstrapS.stop(\n\t\t\t\t\t\tdim(\n\t\t\t\t\t\t\t`Scaffolded project from \"${selectedTemplate.title}\" ✓`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst msg =\n\t\t\t\t\t\terr instanceof Error ? err.message : \"Unknown error\";\n\t\t\t\t\tbootstrapS.stop(\"Failed to scaffold project\");\n\t\t\t\t\tlog.error(msg);\n\t\t\t\t\toutro(\"Setup failed.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// For brownfield flows (existing app), ask which features to enable\n\tif (!selectedTemplate && hasApp) {\n\t\tconst featuresResult = await select({\n\t\t\tmessage:\n\t\t\t\t\"Which Neon features would you like to enable for this project?\",\n\t\t\toptions: [\n\t\t\t\t{ value: \"database\", label: \"Database\" },\n\t\t\t\t{\n\t\t\t\t\tvalue: \"database,auth\",\n\t\t\t\t\tlabel: \"Database + Neon Auth (adds authentication via Neon)\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tinitialValue: \"database\",\n\t\t});\n\t\tif (isCancel(featuresResult)) {\n\t\t\toutro(\"Setup cancelled.\");\n\t\t\treturn;\n\t\t}\n\t\tselectedFeatures = (featuresResult as string).split(\n\t\t\t\",\",\n\t\t) as NeonFeature[];\n\t}\n\n\t// Write _init metadata to .neon\n\tif (selectedFeatures.length > 0) {\n\t\tconst neonPath = resolve(process.cwd(), \".neon\");\n\t\tlet existing: Record<string, unknown> = {};\n\t\tif (existsSync(neonPath)) {\n\t\t\ttry {\n\t\t\t\texisting = JSON.parse(readFileSync(neonPath, \"utf-8\"));\n\t\t\t} catch {}\n\t\t}\n\t\texisting._init = { features: selectedFeatures };\n\t\twriteFileSync(neonPath, `${JSON.stringify(existing, null, 2)}\\n`);\n\t}\n\n\tconst mcpAlready = inspection.mcpConfigured === true;\n\t// If we bootstrapped, skills come from the template\n\tconst skillsAlready =\n\t\tinspection.skillsInstalled === true || selectedTemplate !== null;\n\tconst hasNeonConnection = inspection.connectionString === true;\n\tlet needsMcp = !mcpAlready;\n\tconst needsSkills = !skillsAlready;\n\tconst needsInstall = needsMcp || needsSkills;\n\n\t// Check if .neon context file exists\n\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\tconst hasNeonContext =\n\t\texistsSync(neonContextPath) &&\n\t\t(() => {\n\t\t\ttry {\n\t\t\t\tconst content = JSON.parse(\n\t\t\t\t\treadFileSync(neonContextPath, \"utf-8\"),\n\t\t\t\t);\n\t\t\t\treturn !!content.projectId;\n\t\t\t} catch {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t})();\n\n\t// Check if Neon Auth is configured\n\tconst hasNeonAuth = (() => {\n\t\tfor (const envFile of [\".env\", \".env.local\"]) {\n\t\t\tconst envPath = resolve(process.cwd(), envFile);\n\t\t\tif (existsSync(envPath)) {\n\t\t\t\ttry {\n\t\t\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\t\t\tif (/^NEON_AUTH_/m.test(content)) return true;\n\t\t\t\t} catch {}\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t})();\n\n\t// Check if extension is installed for the detected editor\n\tlet extensionAlready = false;\n\tif (detectedEditor && usesExtension(detectedEditor)) {\n\t\textensionAlready = await isExtensionInstalled(detectedEditor);\n\t}\n\n\t// If tooling + database are configured, check if there's anything left to do\n\tif (mcpAlready && skillsAlready && hasNeonConnection && hasNeonContext) {\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon MCP server already configured (${inspection.mcpScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon agent skills already installed (${inspection.skillsScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\t\tif (extensionAlready)\n\t\t\tlog.step(dim(\"Neon editor extension installed ✓\"));\n\t\tlog.step(dim(\"Neon database connected ✓\"));\n\n\t\tif (hasNeonAuth) {\n\t\t\tlog.step(dim(\"Neon Auth configured ✓\"));\n\t\t\toutro(\n\t\t\t\tdim(\n\t\t\t\t\t\"Your project is fully configured with Neon. Nothing to do.\",\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Neon Auth not configured — ask if they want it\n\t\tconst authResult = await select({\n\t\t\tmessage:\n\t\t\t\t\"Would you like to set up Neon Auth for user authentication?\",\n\t\t\toptions: [\n\t\t\t\t{ value: \"yes\", label: \"Yes, set up Neon Auth\" },\n\t\t\t\t{ value: \"no\", label: \"No, skip for now\" },\n\t\t\t],\n\t\t\tinitialValue: \"no\",\n\t\t});\n\n\t\tif (isCancel(authResult) || authResult === \"no\") {\n\t\t\toutro(\n\t\t\t\tdim(\n\t\t\t\t\t`Your project is configured with Neon. You can set up Neon Auth later by having your agent run: neonctl init --agent --data '{\"step\":\"neon-auth\"}'`,\n\t\t\t\t),\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Read .neon for project context\n\t\tlet projectId: string | null = null;\n\t\ttry {\n\t\t\tconst neonCtx = JSON.parse(readFileSync(neonContextPath, \"utf-8\"));\n\t\t\tprojectId = neonCtx.projectId ?? null;\n\t\t} catch {}\n\n\t\tlog.step(\"Next steps\");\n\t\tconst promptLines = [\"Set up Neon Auth for this project.\"];\n\t\tif (projectId) promptLines.push(`Project ID: ${projectId}.`);\n\t\tlog.message(dim(\"Copy the following into your agent chat:\"));\n\t\tlog.message(\n\t\t\tpromptLines.map((line) => bold(neonGreenFn(line))).join(\"\\n\"),\n\t\t);\n\t\toutro(dim(\"Have feedback? Email us at feedback@neon.tech\"));\n\t\treturn;\n\t}\n\n\t// Log what's already in place\n\tif (mcpAlready)\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon MCP server already configured (${inspection.mcpScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\tif (skillsAlready)\n\t\tlog.step(\n\t\t\tdim(\n\t\t\t\t`Neon agent skills already installed (${inspection.skillsScope || \"detected\"}) ✓`,\n\t\t\t),\n\t\t);\n\n\t// -----------------------------------------------------------------------\n\t// Step 3–5: Install what's missing (skip entirely if everything is configured)\n\t// -----------------------------------------------------------------------\n\tif (needsInstall) {\n\t\tconst homeDir = process.env.HOME || process.env.USERPROFILE;\n\t\tif (!homeDir) {\n\t\t\tlog.error(\"Could not determine home directory.\");\n\t\t\toutro(\"Setup failed.\");\n\t\t\treturn;\n\t\t}\n\n\t\tlet selectedEditors: Editor[];\n\t\tif (detectedEditor) {\n\t\t\tselectedEditors = [detectedEditor];\n\t\t} else {\n\t\t\tconst availableEditors = await detectAvailableEditors(homeDir);\n\t\t\tconst editorResponse = await multiselect({\n\t\t\t\tmessage: \"Which editor(s) would you like to configure?\",\n\t\t\t\toptions: ALL_CONFIGURABLE_AGENTS.map((agent) => ({\n\t\t\t\t\tvalue: agent.editor,\n\t\t\t\t\tlabel: agent.editor,\n\t\t\t\t\thint: agent.hint,\n\t\t\t\t})),\n\t\t\t\tinitialValues: availableEditors,\n\t\t\t\trequired: true,\n\t\t\t});\n\t\t\tif (isCancel(editorResponse)) {\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tselectedEditors = editorResponse as Editor[];\n\t\t\tif (selectedEditors.length === 0) {\n\t\t\t\tlog.warn(\"No editors selected.\");\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\t// Check extension status\n\t\tconst vscodeEditors = selectedEditors.filter(usesExtension);\n\t\tlet extensionAlreadyInstalled = false;\n\t\tif (vscodeEditors.length > 0) {\n\t\t\tconst checks = await Promise.all(\n\t\t\t\tvscodeEditors.map((e) => isExtensionInstalled(e)),\n\t\t\t);\n\t\t\textensionAlreadyInstalled = checks.every(Boolean);\n\t\t\tif (extensionAlreadyInstalled) {\n\t\t\t\tlog.step(dim(\"Neon editor extension already installed ✓\"));\n\t\t\t}\n\t\t}\n\t\tlet doInstallExtension =\n\t\t\tvscodeEditors.length > 0 && !extensionAlreadyInstalled;\n\n\t\t// Build hint showing only what needs installing\n\t\tconst hintParts: string[] = [];\n\t\tif (needsMcp) hintParts.push(\"MCP server (global)\");\n\t\tif (needsSkills) hintParts.push(\"agent skills (project)\");\n\t\tif (doInstallExtension) hintParts.push(\"editor extension\");\n\n\t\t// Installation preferences\n\t\tlet mcpScope: \"global\" | \"project\" | \"none\" = \"global\";\n\t\tlet skillsScope: \"global\" | \"project\" = \"project\";\n\n\t\tlet modeResult: string;\n\t\twhile (true) {\n\t\t\tconst editorName = selectedEditors.join(\", \");\n\t\t\tconst result = await select({\n\t\t\t\tmessage: `Configure ${editorName} for Neon:`,\n\t\t\t\toptions: [\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\t\tlabel: \"Install with defaults\",\n\t\t\t\t\t\thint: hintParts.join(\", \"),\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\tlabel: \"Customize installation\",\n\t\t\t\t\t\thint: \"choose scopes and options\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"change_editor\",\n\t\t\t\t\t\tlabel: \"Configure a different editor\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tinitialValue: \"defaults\",\n\t\t\t});\n\n\t\t\tif (isCancel(result)) {\n\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (result === \"change_editor\") {\n\t\t\t\tconst availableEditors = await detectAvailableEditors(homeDir);\n\t\t\t\tconst editorResponse = await multiselect({\n\t\t\t\t\tmessage: \"Which editor(s) would you like to configure?\",\n\t\t\t\t\toptions: ALL_CONFIGURABLE_AGENTS.map((agent) => ({\n\t\t\t\t\t\tvalue: agent.editor,\n\t\t\t\t\t\tlabel: agent.editor,\n\t\t\t\t\t\thint: agent.hint,\n\t\t\t\t\t})),\n\t\t\t\t\tinitialValues: availableEditors,\n\t\t\t\t\trequired: true,\n\t\t\t\t});\n\t\t\t\tif (isCancel(editorResponse)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tselectedEditors = editorResponse as Editor[];\n\t\t\t\tif (selectedEditors.length === 0) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tmodeResult = result as string;\n\t\t\tbreak;\n\t\t}\n\n\t\tif (modeResult === \"customize\") {\n\t\t\tif (needsMcp) {\n\t\t\t\tconst scopeResult = await select({\n\t\t\t\t\tmessage: \"Where should the Neon MCP server be configured?\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\t\t\tlabel: \"Skip — do not install the MCP server\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t});\n\t\t\t\tif (isCancel(scopeResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tmcpScope = scopeResult as \"global\" | \"project\" | \"none\";\n\t\t\t\tif (mcpScope === \"none\") needsMcp = false;\n\t\t\t}\n\n\t\t\tif (needsSkills) {\n\t\t\t\tconst skillsScopeResult = await select({\n\t\t\t\t\tmessage: \"Where should Neon agent skills be installed?\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tinitialValue: \"project\",\n\t\t\t\t});\n\t\t\t\tif (isCancel(skillsScopeResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tskillsScope = skillsScopeResult as \"global\" | \"project\";\n\t\t\t}\n\n\t\t\tif (doInstallExtension) {\n\t\t\t\tconst extResult = await confirm({\n\t\t\t\t\tmessage: `Install the Neon extension for ${vscodeEditors.join(\", \")}?`,\n\t\t\t\t});\n\t\t\t\tif (isCancel(extResult)) {\n\t\t\t\t\toutro(\"Setup cancelled.\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tdoInstallExtension = extResult;\n\t\t\t}\n\t\t}\n\n\t\t// Auth check before install\n\t\tconst installAuthed = await isAuthenticated();\n\t\tif (!installAuthed) {\n\t\t\tconst authS = spinner();\n\t\t\tauthS.start(\"Authenticating with Neon...\");\n\t\t\tconst authSuccess = await ensureNeonctlAuth();\n\t\t\tif (!authSuccess) {\n\t\t\t\tauthS.stop(\"Authentication failed.\");\n\t\t\t\toutro(\"Run neon-init again after signing in.\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tauthS.stop(\"Authenticated.\");\n\t\t}\n\n\t\t// Ensure neonctl CLI is installed and up to date\n\t\tconst nctlS = spinner();\n\t\tnctlS.start(\"Checking neonctl CLI...\");\n\t\tconst nctlResult = await ensureNeonctl();\n\t\tswitch (nctlResult.status) {\n\t\t\tcase \"already_current\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`neonctl CLI is up to date (v${nctlResult.version}) ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"installed\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`Installed neonctl CLI (v${nctlResult.version}) ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"updated\":\n\t\t\t\tnctlS.stop(\n\t\t\t\t\tdim(`Updated neonctl CLI to v${nctlResult.version} ✓`),\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t\tcase \"failed\":\n\t\t\t\tnctlS.stop(\"Failed to install neonctl CLI\");\n\t\t\t\tlog.warn(\n\t\t\t\t\t\"neonctl could not be installed automatically. The setup will continue using npx.\",\n\t\t\t\t);\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// Install only what's missing\n\t\tfor (const editor of selectedEditors) {\n\t\t\tif (needsMcp) {\n\t\t\t\tconst mcpAgentId = getAddMcpAgentId(editor);\n\t\t\t\tconst mcpArgs = [\n\t\t\t\t\t\"-y\",\n\t\t\t\t\t\"add-mcp\",\n\t\t\t\t\t\"https://mcp.neon.tech/mcp\",\n\t\t\t\t\t\"-n\",\n\t\t\t\t\t\"Neon\",\n\t\t\t\t\t\"-y\",\n\t\t\t\t\t\"-a\",\n\t\t\t\t\tmcpAgentId,\n\t\t\t\t];\n\t\t\t\tif (mcpScope === \"global\") mcpArgs.splice(5, 0, \"-g\");\n\n\t\t\t\tconst mcpS = spinner();\n\t\t\t\tmcpS.start(`Installing Neon MCP server for ${editor}...`);\n\t\t\t\ttry {\n\t\t\t\t\tawait execa(\"npx\", mcpArgs, {\n\t\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\t\ttimeout: 60000,\n\t\t\t\t\t});\n\t\t\t\t\tmcpS.stop(\n\t\t\t\t\t\tdim(\n\t\t\t\t\t\t\t`Neon MCP server configured for ${editor} (${mcpScope}) ✓`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst msg =\n\t\t\t\t\t\terr instanceof Error ? err.message : \"Unknown error\";\n\t\t\t\t\tmcpS.stop(`Failed to configure MCP server for ${editor}`);\n\t\t\t\t\tlog.error(msg);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (needsSkills) {\n\t\t\t\tawait installAgentSkills([editor], {\n\t\t\t\t\tscope: skillsScope,\n\t\t\t\t\tpreview: options.preview,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (doInstallExtension && usesExtension(editor)) {\n\t\t\t\tconst extS = spinner();\n\t\t\t\textS.start(`Installing Neon extension for ${editor}...`);\n\t\t\t\tconst extOk = await installExtension(editor);\n\t\t\t\tif (extOk) {\n\t\t\t\t\textS.stop(dim(`Neon extension installed for ${editor} ✓`));\n\t\t\t\t} else {\n\t\t\t\t\textS.stop(\n\t\t\t\t\t\t`Extension install failed — install manually from the extensions panel.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Ensure all required skills are present (fills in any missing ones).\n\t// detectAgent() returns null in a human terminal (TTY), so fall back\n\t// to IDE detection which works regardless of TTY.\n\tconst ide = detectIde();\n\tconst agentForSkills =\n\t\tdetectAgent() ??\n\t\t(ide === \"Cursor\"\n\t\t\t? \"cursor\"\n\t\t\t: ide === \"VS Code\"\n\t\t\t\t? \"vscode\"\n\t\t\t\t: ide === \"Windsurf\"\n\t\t\t\t\t? \"windsurf\"\n\t\t\t\t\t: null);\n\tif (agentForSkills) {\n\t\tconst detectedSkillsScope =\n\t\t\tinspection.skillsScope === \"global\" ? \"global\" : undefined;\n\t\tawait ensureSkillsUpToDate(\n\t\t\tagentForSkills,\n\t\t\tdetectedSkillsScope,\n\t\t\toptions.preview,\n\t\t);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Step 6: Done — build prompt for the agent to continue\n\t// -----------------------------------------------------------------------\n\n\t// Build the getting-started data payload (same as agent mode)\n\tconst gettingStartedData: Record<string, unknown> = {};\n\tif (hasNeonConnection) gettingStartedData.hasConnectionString = true;\n\tif (inspection.framework && inspection.framework !== \"none\")\n\t\tgettingStartedData.framework = inspection.framework;\n\tif (inspection.orm && inspection.orm !== \"none\")\n\t\tgettingStartedData.orm = inspection.orm;\n\tif (inspection.migrationTool && inspection.migrationTool !== \"none\")\n\t\tgettingStartedData.migrationTool = inspection.migrationTool;\n\tif (inspection.migrationDir && inspection.migrationDir !== \"none\")\n\t\tgettingStartedData.migrationDir = inspection.migrationDir;\n\tif (selectedFeatures.length > 0)\n\t\tgettingStartedData.features = selectedFeatures;\n\tif (options.preview) gettingStartedData.preview = true;\n\n\t// Build a prompt for the user to paste into their agent chat\n\tconst cmd = `neonctl init --agent --data '${JSON.stringify({ step: \"getting-started\", ...gettingStartedData })}'`;\n\t// Account for clack's \"│  \" prefix (3 chars) when wrapping\n\tconst cols = (process.stdout.columns || 80) - 3;\n\tconst promptText = `To finish setting up Neon using Neon's agent-guided onboarding experience, have your agent run this shell command: ${cmd}`;\n\n\tlog.step(\"Next steps\");\n\tlog.message(dim(\"Copy the following into your agent chat:\"));\n\tlog.message(\n\t\twordWrap(promptText, cols)\n\t\t\t.split(\"\\n\")\n\t\t\t.map((line) => bold(neonGreenFn(line)))\n\t\t\t.join(\"\\n\"),\n\t);\n\toutro(dim(\"Have feedback? Email us at feedback@neon.tech\"));\n}\n\nfunction agentIdToEditor(agentId: string): Editor | null {\n\tswitch (agentId) {\n\t\tcase \"cursor\":\n\t\t\treturn \"Cursor\";\n\t\tcase \"vscode\":\n\t\t\treturn \"VS Code\";\n\t\tcase \"claude-code\":\n\t\t\treturn \"Claude CLI\";\n\t\tcase \"windsurf\":\n\t\t\t// Windsurf not in Editor type yet — fall back to prompt\n\t\t\treturn null;\n\t\tcase \"codex\":\n\t\t\treturn \"Codex\";\n\t\tcase \"cline\":\n\t\t\treturn \"Cline\";\n\t\tdefault:\n\t\t\treturn null;\n\t}\n}\n"],"mappings":"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"}

package/dist/lib/bootstrap.d.ts

@@ -25,8 +25,15 @@ interface BootstrapTemplate {
   /** One-line description shown under the title in the selector. */
   description: string;
   /**
-   * Neon services the template uses (e.g. "Postgres", "Functions"). Shown as a
-   * badge next to the title in the picker. Optional — older manifests omit it.
+   * Libraries/frameworks that shape the project (e.g. "Hono", "Drizzle").
+   * Rendered next to the title in the picker so the row reads
+   * "Title (tools)". Optional — older manifests omit it.
+   */
+  tools?: string[];
+  /**
+   * Neon services the template uses (e.g. "Postgres", "Functions"). Surfaced
+   * alongside the description in the focused row's hint. Optional — older
+   * manifests omit it.
    */
   services?: string[];
   /** Neon features this template needs (defaults to ["database"]). */

package/dist/lib/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","names":[],"sources":["../../src/lib/bootstrap.ts"],"mappings":";;AAiCA;AAUA;AA8BA;AA6CA;AAGA;;;;AAGoB;AAGpB;AAkEA;AAoDA;;;;AAA+C;AAsB1C,KA1OO,WAAA,GAoPL,UAAM,GAAA,MAAA,GAAA,WAAA,GAAA,YAAA,GAAA,gBAAA;AAuDA,UAjSI,iBAAA,CAqVhB;EAAA;MApD6B,MAAA;;EAAiB,KAAA,EAAA,MAAA;EA4DlC;EA4BZ,WAAA,EAAA,MAAA;;;AAzBc;AAoDf;EAoCC,QAAA,CAAA,EAAA,MAAA,EAAA;;UAlCU,EAzYA,WAyYA,EAAA;QAAR,EAAA;IAAO,KAAA,EAAA,MAAA;IA8CG,IAAA,EAAA,MAAA;IAeA;IA4DI,GAAA,EAAA,MAAA;IAYJ;IAmBZ,MAAA,EAAA,MAAA;;;;AAfS;;;;;cAjgBG,oBAAoB;cA6CpB,yBAA0B;cAG1B,0BACD,oCAET;;KAGS,YAAA;;;;SAKF;;;;;;;;iBA6DM,aAAA,gBAA6B;;;;;;;iBAoDvB,cAAA,CAAA,GAAkB,QAAQ;;KAsB3C,QAAA;;;;;;;;;;QAUE;;;;;;;;;cAuDM,gBAAiB,WAAS;;;;;;;cA4D1B,+BACH,+BAEP;;;;;;;cAoDU,6BACF,sBACR,QAAQ;;;;;;;cA8CE,mBAAA,SAA4B,KAAK;;;;;;;;;;cAejC;UA4DI,eAAA;;;;;;;;;;;cAYJ,6BACF,gDAED,oBACP"}
+{"version":3,"file":"bootstrap.d.ts","names":[],"sources":["../../src/lib/bootstrap.ts"],"mappings":";;AAiCA;AAUA;AAqCA;AAgDA;AAGA;;;;AAGoB;AAGpB;AAkEA;AAsDA;;;;AAA+C;AAsB1C,KAtPO,WAAA,GAgQL,UAAM,GAAA,MAAA,GAAA,WAAA,GAAA,YAAA,GAAA,gBAAA;AAuDA,UA7SI,iBAAA,CAiWhB;EAAA;MApD6B,MAAA;;EAAiB,KAAA,EAAA,MAAA;EA4DlC;EA4BZ,WAAA,EAAA,MAAA;;;AAzBc;AAoDf;;OACW,CAAA,EAAA,MAAA,EAAA;;;AACD;AA8CV;AAeA;EA4DiB,QAAA,CAAA,EAAA,MAAA,EAAe;EAYnB;EAmBZ,QAAA,EAtiBU,WAsiBV,EAAA;QAlBU,EAAA;IAED,KAAA,EAAA,MAAA;IACP,IAAA,EAAA,MAAA;IAAO;;;;;;;;;;;;cAtgBG,oBAAoB;cAgDpB,yBAA0B;cAG1B,0BACD,oCAET;;KAGS,YAAA;;;;SAKF;;;;;;;;iBA6DM,aAAA,gBAA6B;;;;;;;iBAsDvB,cAAA,CAAA,GAAkB,QAAQ;;KAsB3C,QAAA;;;;;;;;;;QAUE;;;;;;;;;cAuDM,gBAAiB,WAAS;;;;;;;cA4D1B,+BACH,+BAEP;;;;;;;cAoDU,6BACF,sBACR,QAAQ;;;;;;;cA8CE,mBAAA,SAA4B,KAAK;;;;;;;;;;cAejC;UA4DI,eAAA;;;;;;;;;;;cAYJ,6BACF,gDAED,oBACP"}

package/dist/lib/bootstrap.js

@@ -14,8 +14,9 @@ const DEFAULT_REQUIRES = ["database"];
 const FALLBACK_TEMPLATES = [
 	{
 		id: "hono",
-		title: "Hono API (Drizzle, Neon Postgres) on Neon Functions",
-		description: "A Hono API using Drizzle ORM and Neon Postgres, ready to deploy as a Neon Function.",
+		title: "REST API",
+		description: "A Hono REST API on Neon Functions, backed by Neon Postgres via Drizzle.",
+		tools: ["Hono", "Drizzle"],
 		services: ["Postgres", "Functions"],
 		requires: ["database", "functions"],
 		source: {
@@ -27,8 +28,9 @@ const FALLBACK_TEMPLATES = [
 	},
 	{
 		id: "ai-sdk",
-		title: "AI SDK agent (AI Gateway, object storage, Drizzle) on Neon Functions",
-		description: "A Vercel AI SDK agent on Neon Functions: streams chat through the Neon AI Gateway, generates an image with OpenAI image generation, and stores it in Neon object storage indexed in Postgres via Drizzle.",
+		title: "Image-generation agent",
+		description: "A Vercel AI SDK agent that streams chat through the Neon AI Gateway and stores generated images in Neon object storage, indexed in Postgres via Drizzle.",
+		tools: ["AI SDK", "Drizzle"],
 		services: [
 			"Postgres",
 			"Functions",
@@ -50,8 +52,9 @@ const FALLBACK_TEMPLATES = [
 	},
 	{
 		id: "mastra",
-		title: "Mastra personal agent (AI Gateway, Mastra Memory) on Neon Functions",
-		description: "A Mastra personal-assistant agent on Neon Functions: streams chat through the Neon AI Gateway and uses Mastra Memory — backed by Neon Postgres — to remember the user across conversation threads via resource-scoped working memory.",
+		title: "Personal-assistant agent",
+		description: "A Mastra agent that streams chat through the Neon AI Gateway and uses Mastra Memory on Neon Postgres to remember you across threads.",
+		tools: ["Mastra", "Mastra Memory"],
 		services: [
 			"Postgres",
 			"Functions",
@@ -80,15 +83,15 @@ const downloadHeaders = () => ({
 const codeloadBase = () => process.env.NEON_BOOTSTRAP_GITHUB_CODELOAD ?? "https://codeload.github.com";
 const isRecord = (value) => typeof value === "object" && value !== null;
 /**
-* Normalize a manifest entry's `services` into a clean string list. Tolerant by
-* design: a missing or non-array value yields `undefined`, and non-string items
-* are dropped, so a malformed `services` never sinks an otherwise-valid
-* template (it just renders without its badge).
+* Normalize a manifest entry's string list (`tools` or `services`) into a clean
+* array. Tolerant by design: a missing or non-array value yields `undefined`,
+* and non-string/blank items are dropped, so a malformed list never sinks an
+* otherwise-valid template (it just renders without that detail).
 */
-const parseServices = (value) => {
+const parseStringList = (value) => {
 	if (!Array.isArray(value)) return void 0;
-	const services = value.filter((item) => typeof item === "string" && item.trim() !== "");
-	return services.length > 0 ? services : void 0;
+	const items = value.filter((item) => typeof item === "string" && item.trim() !== "");
+	return items.length > 0 ? items : void 0;
 };
 const NEON_MANIFEST_URL = "https://neon.com/bootstrap/templates.yaml";
 const GITHUB_RAW_MANIFEST_URL = "https://raw.githubusercontent.com/neondatabase/examples/main/bootstrap.yaml";
@@ -104,11 +107,13 @@ function parseManifest(text) {
 	for (const item of data.templates) {
 		if (!isRecord(item) || typeof item.id !== "string" || typeof item.title !== "string" || typeof item.description !== "string" || !isRecord(item.source) || typeof item.source.owner !== "string" || typeof item.source.repo !== "string" || typeof item.source.ref !== "string" || typeof item.source.subdir !== "string") continue;
 		const requires = Array.isArray(item.requires) && item.requires.every((r) => typeof r === "string") ? item.requires : DEFAULT_REQUIRES;
-		const services = parseServices(item.services);
+		const tools = parseStringList(item.tools);
+		const services = parseStringList(item.services);
 		templates.push({
 			id: item.id,
 			title: item.title,
 			description: item.description,
+			...tools ? { tools } : {},
 			...services ? { services } : {},
 			requires,
 			source: {

package/dist/lib/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","names":[],"sources":["../../src/lib/bootstrap.ts"],"sourcesContent":["import {\n\tchmodSync,\n\texistsSync,\n\tlstatSync,\n\tmkdirSync,\n\treaddirSync,\n\trmSync,\n\tstatSync,\n\tsymlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { gunzipSync } from \"fflate\";\nimport YAML from \"yaml\";\n\n/**\n * A scaffold template that lives in a subdirectory of a public GitHub repo we\n * control. Bootstrapping copies that subdirectory into a target folder —\n * conceptually the same as `degit user/repo/subdir`, but implemented in-house.\n *\n * The whole template is pulled in a single request: we download the repo's\n * gzipped tarball from `codeload.github.com` and extract only the subdir we\n * want. That endpoint is unauthenticated and is NOT subject to the 60-requests\n * per-hour limit of the REST API (`api.github.com`), so bootstrapping works out\n * of the box on shared/corporate networks without a GITHUB_TOKEN. We lean on\n * `fflate` for gunzip and parse the tar in-house, so we never pull in a heavy\n * dependency tree just to copy a few files.\n */\n\n/**\n * Neon features that a template or project may require.\n * Each feature maps to a setup phase that the orchestrator can run.\n */\nexport type NeonFeature =\n\t| \"database\"\n\t| \"auth\"\n\t| \"functions\"\n\t| \"ai-gateway\"\n\t| \"object-storage\";\n\n/** Default features when a template doesn't specify `requires`. */\nconst DEFAULT_REQUIRES: NeonFeature[] = [\"database\"];\n\nexport interface BootstrapTemplate {\n\t/** Stable id used by `--template` and analytics. */\n\tid: string;\n\t/** Human label shown in the interactive selector. */\n\ttitle: string;\n\t/** One-line description shown under the title in the selector. */\n\tdescription: string;\n\t/**\n\t * Neon services the template uses (e.g. \"Postgres\", \"Functions\"). Shown as a\n\t * badge next to the title in the picker. Optional — older manifests omit it.\n\t */\n\tservices?: string[];\n\t/** Neon features this template needs (defaults to [\"database\"]). */\n\trequires: NeonFeature[];\n\tsource: {\n\t\towner: string;\n\t\trepo: string;\n\t\t/** Branch (or tag) the template is pulled from. */\n\t\tref: string;\n\t\t/** Subdirectory within the repo to copy (no leading/trailing slash). */\n\t\tsubdir: string;\n\t};\n}\n\n/**\n * Hardcoded fallback used when every remote manifest source is unreachable.\n * Kept in sync with `neondatabase/examples/bootstrap.yaml` (the source of\n * truth) so that, even fully offline from the manifest, the picker still offers\n * the full set of starters rather than a single template.\n */\nexport const FALLBACK_TEMPLATES: BootstrapTemplate[] = [\n\t{\n\t\tid: \"hono\",\n\t\ttitle: \"Hono API (Drizzle, Neon Postgres) on Neon Functions\",\n\t\tdescription:\n\t\t\t\"A Hono API using Drizzle ORM and Neon Postgres, ready to deploy as a Neon Function.\",\n\t\tservices: [\"Postgres\", \"Functions\"],\n\t\trequires: [\"database\", \"functions\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-hono\",\n\t\t},\n\t},\n\t{\n\t\tid: \"ai-sdk\",\n\t\ttitle: \"AI SDK agent (AI Gateway, object storage, Drizzle) on Neon Functions\",\n\t\tdescription:\n\t\t\t\"A Vercel AI SDK agent on Neon Functions: streams chat through the Neon AI Gateway, generates an image with OpenAI image generation, and stores it in Neon object storage indexed in Postgres via Drizzle.\",\n\t\tservices: [\"Postgres\", \"Functions\", \"Object Storage\", \"AI Gateway\"],\n\t\trequires: [\"database\", \"functions\", \"object-storage\", \"ai-gateway\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-ai-sdk\",\n\t\t},\n\t},\n\t{\n\t\tid: \"mastra\",\n\t\ttitle: \"Mastra personal agent (AI Gateway, Mastra Memory) on Neon Functions\",\n\t\tdescription:\n\t\t\t\"A Mastra personal-assistant agent on Neon Functions: streams chat through the Neon AI Gateway and uses Mastra Memory — backed by Neon Postgres — to remember the user across conversation threads via resource-scoped working memory.\",\n\t\tservices: [\"Postgres\", \"Functions\", \"AI Gateway\"],\n\t\trequires: [\"database\", \"functions\", \"ai-gateway\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-mastra\",\n\t\t},\n\t},\n];\n\nexport const templateIds = (templates: BootstrapTemplate[]): string =>\n\ttemplates.map((t) => t.id).join(\", \");\n\nexport const findTemplate = (\n\ttemplates: BootstrapTemplate[],\n\tid: string,\n): BootstrapTemplate | undefined => templates.find((t) => t.id === id);\n\n/** A single file or symlink to materialize, already resolved with its bytes. */\nexport type TemplateFile =\n\t| {\n\t\t\tkind: \"file\";\n\t\t\t/** Path relative to the target directory (subdir prefix stripped). */\n\t\t\tpath: string;\n\t\t\tbytes: Buffer;\n\t\t\texecutable: boolean;\n\t  }\n\t| {\n\t\t\tkind: \"symlink\";\n\t\t\tpath: string;\n\t\t\t/** The (relative) link target. */\n\t\t\ttarget: string;\n\t  };\n\nconst githubToken = (): string =>\n\tprocess.env.GITHUB_TOKEN ?? process.env.GH_TOKEN ?? \"\";\n\n// A token is never required for public templates, but we forward it when\n// present so the same code path works behind proxies that authenticate, and\n// (in future) for private template repos.\nconst downloadHeaders = (): Record<string, string> => ({\n\t\"User-Agent\": \"neon-init\",\n\t...(githubToken() ? { Authorization: `Bearer ${githubToken()}` } : {}),\n});\n\n// The codeload host is overridable so the e2e tests can point the downloader at\n// a local server (the same trick `--api-host` uses to redirect the Neon API).\nconst codeloadBase = (): string =>\n\tprocess.env.NEON_BOOTSTRAP_GITHUB_CODELOAD ?? \"https://codeload.github.com\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === \"object\" && value !== null;\n\n/**\n * Normalize a manifest entry's `services` into a clean string list. Tolerant by\n * design: a missing or non-array value yields `undefined`, and non-string items\n * are dropped, so a malformed `services` never sinks an otherwise-valid\n * template (it just renders without its badge).\n */\nconst parseServices = (value: unknown): string[] | undefined => {\n\tif (!Array.isArray(value)) return undefined;\n\tconst services = value.filter(\n\t\t(item): item is string =>\n\t\t\ttypeof item === \"string\" && item.trim() !== \"\",\n\t);\n\treturn services.length > 0 ? services : undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Remote template manifest\n// ---------------------------------------------------------------------------\n\n// Primary manifest host is neon.com (CDN-backed, no GitHub rate limiting), with\n// the raw GitHub copy as a fallback and the hardcoded list as the last resort.\n// A single env override (used by tests) short-circuits the chain.\nconst NEON_MANIFEST_URL = \"https://neon.com/bootstrap/templates.yaml\";\nconst GITHUB_RAW_MANIFEST_URL =\n\t\"https://raw.githubusercontent.com/neondatabase/examples/main/bootstrap.yaml\";\n\nfunction manifestUrls(): string[] {\n\tconst override = process.env.NEON_BOOTSTRAP_MANIFEST_URL;\n\tif (override) return [override];\n\treturn [NEON_MANIFEST_URL, GITHUB_RAW_MANIFEST_URL];\n}\n\nexport function parseManifest(text: string): BootstrapTemplate[] {\n\tconst data: unknown = YAML.parse(text);\n\tif (!isRecord(data) || !Array.isArray(data.templates)) {\n\t\tthrow new Error(\n\t\t\t'Invalid bootstrap manifest: missing \"templates\" array.',\n\t\t);\n\t}\n\tconst templates: BootstrapTemplate[] = [];\n\tfor (const item of data.templates) {\n\t\tif (\n\t\t\t!isRecord(item) ||\n\t\t\ttypeof item.id !== \"string\" ||\n\t\t\ttypeof item.title !== \"string\" ||\n\t\t\ttypeof item.description !== \"string\" ||\n\t\t\t!isRecord(item.source) ||\n\t\t\ttypeof item.source.owner !== \"string\" ||\n\t\t\ttypeof item.source.repo !== \"string\" ||\n\t\t\ttypeof item.source.ref !== \"string\" ||\n\t\t\ttypeof item.source.subdir !== \"string\"\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\t// Parse requires — accept a string array, default to [\"database\"].\n\t\tconst requires: NeonFeature[] =\n\t\t\tArray.isArray(item.requires) &&\n\t\t\titem.requires.every((r: unknown) => typeof r === \"string\")\n\t\t\t\t? (item.requires as NeonFeature[])\n\t\t\t\t: DEFAULT_REQUIRES;\n\t\tconst services = parseServices(item.services);\n\t\ttemplates.push({\n\t\t\tid: item.id,\n\t\t\ttitle: item.title,\n\t\t\tdescription: item.description,\n\t\t\t...(services ? { services } : {}),\n\t\t\trequires,\n\t\t\tsource: {\n\t\t\t\towner: item.source.owner,\n\t\t\t\trepo: item.source.repo,\n\t\t\t\tref: item.source.ref,\n\t\t\t\tsubdir: item.source.subdir,\n\t\t\t},\n\t\t});\n\t}\n\treturn templates;\n}\n\n/**\n * Fetch the template manifest, trying each source in {@link manifestUrls} in\n * order and returning the first that yields a non-empty template list. Falls\n * back to the hardcoded list when every source is unreachable or empty, so the\n * picker never fails just because a host is down.\n */\nexport async function fetchTemplates(): Promise<BootstrapTemplate[]> {\n\tfor (const url of manifestUrls()) {\n\t\ttry {\n\t\t\tconst res = await fetch(url, {\n\t\t\t\theaders: downloadHeaders(),\n\t\t\t\tsignal: AbortSignal.timeout(10_000),\n\t\t\t});\n\t\t\tif (!res.ok) throw new Error(`HTTP ${res.status}`);\n\t\t\tconst templates = parseManifest(await res.text());\n\t\t\tif (templates.length > 0) return templates;\n\t\t} catch {\n\t\t\t// Try the next source.\n\t\t}\n\t}\n\treturn FALLBACK_TEMPLATES;\n}\n\n// ---------------------------------------------------------------------------\n// Tar parsing\n// ---------------------------------------------------------------------------\n\n/** A raw entry decoded from a tar stream, before subdir filtering. */\ntype TarEntry = {\n\t/** Full path as stored in the archive (includes the top-level dir). */\n\tname: string;\n\t/** POSIX type flag: '0' file, '5' directory, '2' symlink, etc. */\n\ttype: string;\n\t/** File permission bits. */\n\tmode: number;\n\t/** Symlink target (for type '2'). */\n\tlinkname: string;\n\t/** File contents (for type '0'). */\n\tdata: Buffer;\n};\n\nconst TAR_BLOCK = 512;\n\nconst readTarString = (buf: Buffer, offset: number, length: number): string => {\n\tlet end = offset;\n\tconst max = offset + length;\n\twhile (end < max && buf[end] !== 0) end++;\n\treturn buf.toString(\"utf8\", offset, end);\n};\n\nconst readTarOctal = (buf: Buffer, offset: number, length: number): number => {\n\tconst text = readTarString(buf, offset, length).trim();\n\tif (text === \"\") return 0;\n\tconst value = parseInt(text, 8);\n\treturn Number.isNaN(value) ? 0 : value;\n};\n\nconst isZeroBlock = (buf: Buffer, offset: number): boolean => {\n\tfor (let i = offset; i < offset + TAR_BLOCK; i++) {\n\t\tif (buf[i] !== 0) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Parse pax extended-header records (\"<len> <key>=<value>\\n\"). GitHub uses\n * these for the global header and for any path that doesn't fit the legacy\n * 100-byte name field, so we must honor at least `path` and `linkpath`.\n */\nconst parsePaxRecords = (data: Buffer): Record<string, string> => {\n\tconst records: Record<string, string> = {};\n\tlet pos = 0;\n\tconst text = data.toString(\"utf8\");\n\twhile (pos < text.length) {\n\t\tconst space = text.indexOf(\" \", pos);\n\t\tif (space === -1) break;\n\t\tconst len = parseInt(text.slice(pos, space), 10);\n\t\tif (Number.isNaN(len) || len <= 0) break;\n\t\tconst record = text.slice(space + 1, pos + len - 1); // drop trailing \"\\n\"\n\t\tconst eq = record.indexOf(\"=\");\n\t\tif (eq !== -1) records[record.slice(0, eq)] = record.slice(eq + 1);\n\t\tpos += len;\n\t}\n\treturn records;\n};\n\n/**\n * Decode a (decompressed) tar archive into its file/symlink entries. Pure and\n * dependency-free so it can be unit tested without touching the network.\n * Handles the ustar `prefix` field, pax extended headers (type 'x'/'g'), and\n * GNU long-name/long-link headers (type 'L'/'K') so deep template paths and\n * long symlink targets round-trip correctly.\n */\nexport const parseTar = (buf: Buffer): TarEntry[] => {\n\tconst entries: TarEntry[] = [];\n\t// Overrides carried from a preceding pax/GNU header to the next real entry.\n\tlet overridePath: string | undefined;\n\tlet overrideLink: string | undefined;\n\tlet offset = 0;\n\n\twhile (offset + TAR_BLOCK <= buf.length) {\n\t\tif (isZeroBlock(buf, offset)) break;\n\n\t\tlet name = readTarString(buf, offset, 100);\n\t\tconst mode = readTarOctal(buf, offset + 100, 8);\n\t\tconst size = readTarOctal(buf, offset + 124, 12);\n\t\tconst typeByte = buf[offset + 156];\n\t\tconst type = typeByte === 0 ? \"0\" : String.fromCharCode(typeByte);\n\t\tlet linkname = readTarString(buf, offset + 157, 100);\n\t\tconst magic = readTarString(buf, offset + 257, 6);\n\t\tif (magic.startsWith(\"ustar\")) {\n\t\t\tconst prefix = readTarString(buf, offset + 345, 155);\n\t\t\tif (prefix !== \"\") name = `${prefix}/${name}`;\n\t\t}\n\n\t\toffset += TAR_BLOCK;\n\t\tconst data = buf.subarray(offset, offset + size);\n\t\toffset += Math.ceil(size / TAR_BLOCK) * TAR_BLOCK;\n\n\t\tif (type === \"x\") {\n\t\t\tconst records = parsePaxRecords(data);\n\t\t\tif (records.path !== undefined) overridePath = records.path;\n\t\t\tif (records.linkpath !== undefined) overrideLink = records.linkpath;\n\t\t\tcontinue;\n\t\t}\n\t\tif (type === \"g\") {\n\t\t\t// Global pax header (e.g. GitHub's comment block): not per-entry state.\n\t\t\tcontinue;\n\t\t}\n\t\tif (type === \"L\" || type === \"K\") {\n\t\t\tconst longValue = data.toString(\"utf8\").replace(/\\0+$/, \"\");\n\t\t\tif (type === \"L\") overridePath = longValue;\n\t\t\telse overrideLink = longValue;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (overridePath !== undefined) name = overridePath;\n\t\tif (overrideLink !== undefined) linkname = overrideLink;\n\t\toverridePath = undefined;\n\t\toverrideLink = undefined;\n\n\t\tentries.push({ name, type, mode, linkname, data: Buffer.from(data) });\n\t}\n\n\treturn entries;\n};\n\n/**\n * Map decoded tar entries to the files under `subdir`, with the top-level\n * archive directory and the `subdir/` prefix stripped from each path. Pure so\n * it can be unit tested. Directory and other non-regular entries are dropped —\n * writing files re-creates their parent directories.\n */\nexport const selectTemplateFiles = (\n\tentries: TarEntry[],\n\tsubdir: string,\n): TemplateFile[] => {\n\tconst prefix = `${subdir.replace(/^\\/+|\\/+$/g, \"\")}/`;\n\tconst files: TemplateFile[] = [];\n\tfor (const entry of entries) {\n\t\t// codeload wraps everything in a single top-level dir (\"<repo>-<ref>/\");\n\t\t// strip that first segment to get the repo-relative path.\n\t\tconst slash = entry.name.indexOf(\"/\");\n\t\tif (slash === -1) continue;\n\t\tconst repoPath = entry.name.slice(slash + 1);\n\t\tif (!repoPath.startsWith(prefix)) continue;\n\t\tconst path = repoPath.slice(prefix.length);\n\t\tif (path === \"\") continue;\n\t\tif (entry.type === \"2\") {\n\t\t\tfiles.push({ kind: \"symlink\", path, target: entry.linkname });\n\t\t} else if (entry.type === \"0\" || entry.type === \"7\") {\n\t\t\tfiles.push({\n\t\t\t\tkind: \"file\",\n\t\t\t\tpath,\n\t\t\t\tbytes: entry.data,\n\t\t\t\texecutable: (entry.mode & 0o111) !== 0,\n\t\t\t});\n\t\t}\n\t\t// Directories ('5') and any other node types are intentionally skipped.\n\t}\n\treturn files;\n};\n\nconst tarballUrl = (template: BootstrapTemplate): string => {\n\tconst { owner, repo, ref } = template.source;\n\treturn `${codeloadBase()}/${owner}/${repo}/tar.gz/${ref}`;\n};\n\nconst friendlyGithubError = (status: number, url: string): Error => {\n\tif (status === 404) {\n\t\treturn new Error(\n\t\t\t`GitHub returned 404 for ${url}. The template repo or ref may have moved.`,\n\t\t);\n\t}\n\tif (status === 403 || status === 429) {\n\t\treturn new Error(\n\t\t\t`GitHub rate limited the template download (${url}). Set a GITHUB_TOKEN environment variable to raise the limit, then retry.`,\n\t\t);\n\t}\n\treturn new Error(`GitHub returned HTTP ${status} for ${url}.`);\n};\n\n/**\n * Download a template and resolve it to the exact set of files to write. The\n * entire subtree is captured in one tarball request, so the copy is atomically\n * consistent: a push to the template repo mid-download cannot produce a\n * mismatched checkout (unlike fetching a file list and then each blob).\n */\nexport const downloadTemplate = async (\n\ttemplate: BootstrapTemplate,\n): Promise<TemplateFile[]> => {\n\tconst url = tarballUrl(template);\n\n\tlet gzipped: Buffer;\n\ttry {\n\t\tconst res = await fetch(url, {\n\t\t\theaders: downloadHeaders(),\n\t\t\tsignal: AbortSignal.timeout(30_000),\n\t\t});\n\t\tif (!res.ok) throw friendlyGithubError(res.status, url);\n\t\tgzipped = Buffer.from(await res.arrayBuffer());\n\t} catch (err) {\n\t\tthrow err instanceof Error ? err : new Error(String(err));\n\t}\n\n\tlet tar: Buffer;\n\ttry {\n\t\ttar = Buffer.from(gunzipSync(new Uint8Array(gzipped)));\n\t} catch (err) {\n\t\tthrow new Error(\n\t\t\t`Failed to decompress the template archive from ${url}: ${\n\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t}`,\n\t\t);\n\t}\n\n\tconst { owner, repo, ref, subdir } = template.source;\n\tconst files = selectTemplateFiles(parseTar(tar), subdir);\n\tif (files.length === 0) {\n\t\tthrow new Error(\n\t\t\t`Template subdirectory \"${subdir}\" was not found in ${owner}/${repo}@${ref}.`,\n\t\t);\n\t}\n\treturn files;\n};\n\n// ---------------------------------------------------------------------------\n// Target validation + scaffolding to disk\n// ---------------------------------------------------------------------------\n\n/**\n * A bad caller-supplied input that an agent (or human) can correct: an unknown\n * template id or a non-empty target directory. Carries an `agentCode` so an\n * agent surface can report a precise error code instead of a generic\n * INTERNAL_ERROR, while a human path just surfaces the clear `message`.\n */\nexport class BootstrapInputError extends Error {\n\treadonly agentCode: string;\n\tconstructor(message: string, agentCode: string) {\n\t\tsuper(message);\n\t\tthis.name = \"BootstrapInputError\";\n\t\tthis.agentCode = agentCode;\n\t}\n}\n\n/**\n * Ensure `dir` is safe to scaffold into: it must be missing, or an empty\n * directory (a lone `.git` is ignored so you can scaffold into a freshly\n * `git init`ed folder). `force` allows scaffolding into a non-empty directory,\n * overwriting colliding files. Throws a {@link BootstrapInputError} otherwise.\n */\nexport const ensureTargetUsable = (dir: string, force: boolean): void => {\n\tif (!existsSync(dir)) return;\n\tif (!statSync(dir).isDirectory()) {\n\t\tthrow new BootstrapInputError(\n\t\t\t`Target ${dir} already exists and is not a directory.`,\n\t\t\t\"TARGET_NOT_DIRECTORY\",\n\t\t);\n\t}\n\tconst contents = readdirSync(dir).filter((name) => name !== \".git\");\n\tif (contents.length > 0 && !force) {\n\t\tthrow new BootstrapInputError(\n\t\t\t`Target directory ${dir} is not empty. Use --force to scaffold into it anyway (colliding files will be overwritten), or choose an empty directory.`,\n\t\t\t\"TARGET_NOT_EMPTY\",\n\t\t);\n\t}\n};\n\nconst isSymlink = (path: string): boolean => {\n\ttry {\n\t\treturn lstatSync(path).isSymbolicLink();\n\t} catch {\n\t\treturn false;\n\t}\n};\n\nconst errnoCode = (err: unknown): string | undefined => {\n\tif (\n\t\ttypeof err === \"object\" &&\n\t\terr !== null &&\n\t\t\"code\" in err &&\n\t\ttypeof err.code === \"string\"\n\t) {\n\t\treturn err.code;\n\t}\n\treturn undefined;\n};\n\nconst writeSymlink = (\n\tdest: string,\n\ttarget: string,\n\tonWarn?: (message: string) => void,\n): void => {\n\tif (isSymlink(dest)) rmSync(dest, { force: true });\n\ttry {\n\t\tsymlinkSync(target, dest);\n\t} catch (err) {\n\t\t// Windows refuses symlinks without elevated rights / developer mode. The\n\t\t// template still works for most tooling if we drop a regular file holding\n\t\t// the link target, so we degrade gracefully instead of failing the copy.\n\t\tif (errnoCode(err) === \"EPERM\" || process.platform === \"win32\") {\n\t\t\tonWarn?.(\n\t\t\t\t`Could not create symlink ${dest} -> ${target}; wrote it as a regular file instead.`,\n\t\t\t);\n\t\t\twriteFileSync(dest, target);\n\t\t\treturn;\n\t\t}\n\t\tthrow err;\n\t}\n};\n\nexport interface ScaffoldOptions {\n\t/** Called for non-fatal warnings (e.g. a symlink that fell back to a file). */\n\tonWarn?: (message: string) => void;\n}\n\n/**\n * Download `template` and materialize its files into `targetDir`, creating\n * parent directories, preserving executable bits, and recreating symlinks\n * (with a graceful regular-file fallback on platforms that disallow them).\n * Returns the number of files written. The caller is responsible for any\n * target validation ({@link ensureTargetUsable}) and user-facing progress.\n */\nexport const scaffoldTemplate = async (\n\ttemplate: BootstrapTemplate,\n\ttargetDir: string,\n\toptions: ScaffoldOptions = {},\n): Promise<number> => {\n\tconst files = await downloadTemplate(template);\n\n\tmkdirSync(targetDir, { recursive: true });\n\tfor (const file of files) {\n\t\tconst dest = join(targetDir, file.path);\n\t\tmkdirSync(dirname(dest), { recursive: true });\n\t\tif (file.kind === \"symlink\") {\n\t\t\twriteSymlink(dest, file.target, options.onWarn);\n\t\t} else {\n\t\t\twriteFileSync(dest, file.bytes);\n\t\t\tif (file.executable) chmodSync(dest, 0o755);\n\t\t}\n\t}\n\treturn files.length;\n};\n"],"mappings":";;;;;;AAyCA,MAAM,mBAAkC,CAAC,UAAU;;;;;;;AAgCnD,MAAa,qBAA0C;CACtD;EACC,IAAI;EACJ,OAAO;EACP,aACC;EACD,UAAU,CAAC,YAAY,WAAW;EAClC,UAAU,CAAC,YAAY,WAAW;EAClC,QAAQ;GACP,OAAO;GACP,MAAM;GACN,KAAK;GACL,QAAQ;EACT;CACD;CACA;EACC,IAAI;EACJ,OAAO;EACP,aACC;EACD,UAAU;GAAC;GAAY;GAAa;GAAkB;EAAY;EAClE,UAAU;GAAC;GAAY;GAAa;GAAkB;EAAY;EAClE,QAAQ;GACP,OAAO;GACP,MAAM;GACN,KAAK;GACL,QAAQ;EACT;CACD;CACA;EACC,IAAI;EACJ,OAAO;EACP,aACC;EACD,UAAU;GAAC;GAAY;GAAa;EAAY;EAChD,UAAU;GAAC;GAAY;GAAa;EAAY;EAChD,QAAQ;GACP,OAAO;GACP,MAAM;GACN,KAAK;GACL,QAAQ;EACT;CACD;AACD;AAEA,MAAa,eAAe,cAC3B,UAAU,KAAK,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI;AAErC,MAAa,gBACZ,WACA,OACmC,UAAU,MAAM,MAAM,EAAE,OAAO,EAAE;AAkBrE,MAAM,oBACL,QAAQ,IAAI,gBAAgB,QAAQ,IAAI,YAAY;AAKrD,MAAM,yBAAiD;CACtD,cAAc;CACd,GAAI,YAAY,IAAI,EAAE,eAAe,UAAU,YAAY,IAAI,IAAI,CAAC;AACrE;AAIA,MAAM,qBACL,QAAQ,IAAI,kCAAkC;AAE/C,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU;;;;;;;AAQxC,MAAM,iBAAiB,UAAyC;CAC/D,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAA;CAClC,MAAM,WAAW,MAAM,QACrB,SACA,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,EAC9C;CACA,OAAO,SAAS,SAAS,IAAI,WAAW,KAAA;AACzC;AASA,MAAM,oBAAoB;AAC1B,MAAM,0BACL;AAED,SAAS,eAAyB;CACjC,MAAM,WAAW,QAAQ,IAAI;CAC7B,IAAI,UAAU,OAAO,CAAC,QAAQ;CAC9B,OAAO,CAAC,mBAAmB,uBAAuB;AACnD;AAEA,SAAgB,cAAc,MAAmC;CAChE,MAAM,OAAgB,KAAK,MAAM,IAAI;CACrC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,QAAQ,KAAK,SAAS,GACnD,MAAM,IAAI,MACT,0DACD;CAED,MAAM,YAAiC,CAAC;CACxC,KAAK,MAAM,QAAQ,KAAK,WAAW;EAClC,IACC,CAAC,SAAS,IAAI,KACd,OAAO,KAAK,OAAO,YACnB,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,gBAAgB,YAC5B,CAAC,SAAS,KAAK,MAAM,KACrB,OAAO,KAAK,OAAO,UAAU,YAC7B,OAAO,KAAK,OAAO,SAAS,YAC5B,OAAO,KAAK,OAAO,QAAQ,YAC3B,OAAO,KAAK,OAAO,WAAW,UAE9B;EAGD,MAAM,WACL,MAAM,QAAQ,KAAK,QAAQ,KAC3B,KAAK,SAAS,OAAO,MAAe,OAAO,MAAM,QAAQ,IACrD,KAAK,WACN;EACJ,MAAM,WAAW,cAAc,KAAK,QAAQ;EAC5C,UAAU,KAAK;GACd,IAAI,KAAK;GACT,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;GAC/B;GACA,QAAQ;IACP,OAAO,KAAK,OAAO;IACnB,MAAM,KAAK,OAAO;IAClB,KAAK,KAAK,OAAO;IACjB,QAAQ,KAAK,OAAO;GACrB;EACD,CAAC;CACF;CACA,OAAO;AACR;;;;;;;AAQA,eAAsB,iBAA+C;CACpE,KAAK,MAAM,OAAO,aAAa,GAC9B,IAAI;EACH,MAAM,MAAM,MAAM,MAAM,KAAK;GAC5B,SAAS,gBAAgB;GACzB,QAAQ,YAAY,QAAQ,GAAM;EACnC,CAAC;EACD,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,MAAM,QAAQ,IAAI,QAAQ;EACjD,MAAM,YAAY,cAAc,MAAM,IAAI,KAAK,CAAC;EAChD,IAAI,UAAU,SAAS,GAAG,OAAO;CAClC,QAAQ,CAER;CAED,OAAO;AACR;AAoBA,MAAM,YAAY;AAElB,MAAM,iBAAiB,KAAa,QAAgB,WAA2B;CAC9E,IAAI,MAAM;CACV,MAAM,MAAM,SAAS;CACrB,OAAO,MAAM,OAAO,IAAI,SAAS,GAAG;CACpC,OAAO,IAAI,SAAS,QAAQ,QAAQ,GAAG;AACxC;AAEA,MAAM,gBAAgB,KAAa,QAAgB,WAA2B;CAC7E,MAAM,OAAO,cAAc,KAAK,QAAQ,MAAM,CAAC,CAAC,KAAK;CACrD,IAAI,SAAS,IAAI,OAAO;CACxB,MAAM,QAAQ,SAAS,MAAM,CAAC;CAC9B,OAAO,OAAO,MAAM,KAAK,IAAI,IAAI;AAClC;AAEA,MAAM,eAAe,KAAa,WAA4B;CAC7D,KAAK,IAAI,IAAI,QAAQ,IAAI,SAAS,WAAW,KAC5C,IAAI,IAAI,OAAO,GAAG,OAAO;CAE1B,OAAO;AACR;;;;;;AAOA,MAAM,mBAAmB,SAAyC;CACjE,MAAM,UAAkC,CAAC;CACzC,IAAI,MAAM;CACV,MAAM,OAAO,KAAK,SAAS,MAAM;CACjC,OAAO,MAAM,KAAK,QAAQ;EACzB,MAAM,QAAQ,KAAK,QAAQ,KAAK,GAAG;EACnC,IAAI,UAAU,IAAI;EAClB,MAAM,MAAM,SAAS,KAAK,MAAM,KAAK,KAAK,GAAG,EAAE;EAC/C,IAAI,OAAO,MAAM,GAAG,KAAK,OAAO,GAAG;EACnC,MAAM,SAAS,KAAK,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;EAClD,MAAM,KAAK,OAAO,QAAQ,GAAG;EAC7B,IAAI,OAAO,IAAI,QAAQ,OAAO,MAAM,GAAG,EAAE,KAAK,OAAO,MAAM,KAAK,CAAC;EACjE,OAAO;CACR;CACA,OAAO;AACR;;;;;;;;AASA,MAAa,YAAY,QAA4B;CACpD,MAAM,UAAsB,CAAC;CAE7B,IAAI;CACJ,IAAI;CACJ,IAAI,SAAS;CAEb,OAAO,SAAS,aAAa,IAAI,QAAQ;EACxC,IAAI,YAAY,KAAK,MAAM,GAAG;EAE9B,IAAI,OAAO,cAAc,KAAK,QAAQ,GAAG;EACzC,MAAM,OAAO,aAAa,KAAK,SAAS,KAAK,CAAC;EAC9C,MAAM,OAAO,aAAa,KAAK,SAAS,KAAK,EAAE;EAC/C,MAAM,WAAW,IAAI,SAAS;EAC9B,MAAM,OAAO,aAAa,IAAI,MAAM,OAAO,aAAa,QAAQ;EAChE,IAAI,WAAW,cAAc,KAAK,SAAS,KAAK,GAAG;EAEnD,IADc,cAAc,KAAK,SAAS,KAAK,CACvC,CAAC,CAAC,WAAW,OAAO,GAAG;GAC9B,MAAM,SAAS,cAAc,KAAK,SAAS,KAAK,GAAG;GACnD,IAAI,WAAW,IAAI,OAAO,GAAG,OAAO,GAAG;EACxC;EAEA,UAAU;EACV,MAAM,OAAO,IAAI,SAAS,QAAQ,SAAS,IAAI;EAC/C,UAAU,KAAK,KAAK,OAAO,SAAS,IAAI;EAExC,IAAI,SAAS,KAAK;GACjB,MAAM,UAAU,gBAAgB,IAAI;GACpC,IAAI,QAAQ,SAAS,KAAA,GAAW,eAAe,QAAQ;GACvD,IAAI,QAAQ,aAAa,KAAA,GAAW,eAAe,QAAQ;GAC3D;EACD;EACA,IAAI,SAAS,KAEZ;EAED,IAAI,SAAS,OAAO,SAAS,KAAK;GACjC,MAAM,YAAY,KAAK,SAAS,MAAM,CAAC,CAAC,QAAQ,QAAQ,EAAE;GAC1D,IAAI,SAAS,KAAK,eAAe;QAC5B,eAAe;GACpB;EACD;EAEA,IAAI,iBAAiB,KAAA,GAAW,OAAO;EACvC,IAAI,iBAAiB,KAAA,GAAW,WAAW;EAC3C,eAAe,KAAA;EACf,eAAe,KAAA;EAEf,QAAQ,KAAK;GAAE;GAAM;GAAM;GAAM;GAAU,MAAM,OAAO,KAAK,IAAI;EAAE,CAAC;CACrE;CAEA,OAAO;AACR;;;;;;;AAQA,MAAa,uBACZ,SACA,WACoB;CACpB,MAAM,SAAS,GAAG,OAAO,QAAQ,cAAc,EAAE,EAAE;CACnD,MAAM,QAAwB,CAAC;CAC/B,KAAK,MAAM,SAAS,SAAS;EAG5B,MAAM,QAAQ,MAAM,KAAK,QAAQ,GAAG;EACpC,IAAI,UAAU,IAAI;EAClB,MAAM,WAAW,MAAM,KAAK,MAAM,QAAQ,CAAC;EAC3C,IAAI,CAAC,SAAS,WAAW,MAAM,GAAG;EAClC,MAAM,OAAO,SAAS,MAAM,OAAO,MAAM;EACzC,IAAI,SAAS,IAAI;EACjB,IAAI,MAAM,SAAS,KAClB,MAAM,KAAK;GAAE,MAAM;GAAW;GAAM,QAAQ,MAAM;EAAS,CAAC;OACtD,IAAI,MAAM,SAAS,OAAO,MAAM,SAAS,KAC/C,MAAM,KAAK;GACV,MAAM;GACN;GACA,OAAO,MAAM;GACb,aAAa,MAAM,OAAO,QAAW;EACtC,CAAC;CAGH;CACA,OAAO;AACR;AAEA,MAAM,cAAc,aAAwC;CAC3D,MAAM,EAAE,OAAO,MAAM,QAAQ,SAAS;CACtC,OAAO,GAAG,aAAa,EAAE,GAAG,MAAM,GAAG,KAAK,UAAU;AACrD;AAEA,MAAM,uBAAuB,QAAgB,QAAuB;CACnE,IAAI,WAAW,KACd,uBAAO,IAAI,MACV,2BAA2B,IAAI,2CAChC;CAED,IAAI,WAAW,OAAO,WAAW,KAChC,uBAAO,IAAI,MACV,8CAA8C,IAAI,2EACnD;CAED,uBAAO,IAAI,MAAM,wBAAwB,OAAO,OAAO,IAAI,EAAE;AAC9D;;;;;;;AAQA,MAAa,mBAAmB,OAC/B,aAC6B;CAC7B,MAAM,MAAM,WAAW,QAAQ;CAE/B,IAAI;CACJ,IAAI;EACH,MAAM,MAAM,MAAM,MAAM,KAAK;GAC5B,SAAS,gBAAgB;GACzB,QAAQ,YAAY,QAAQ,GAAM;EACnC,CAAC;EACD,IAAI,CAAC,IAAI,IAAI,MAAM,oBAAoB,IAAI,QAAQ,GAAG;EACtD,UAAU,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC;CAC9C,SAAS,KAAK;EACb,MAAM,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;CACzD;CAEA,IAAI;CACJ,IAAI;EACH,MAAM,OAAO,KAAK,WAAW,IAAI,WAAW,OAAO,CAAC,CAAC;CACtD,SAAS,KAAK;EACb,MAAM,IAAI,MACT,kDAAkD,IAAI,IACrD,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,GAEjD;CACD;CAEA,MAAM,EAAE,OAAO,MAAM,KAAK,WAAW,SAAS;CAC9C,MAAM,QAAQ,oBAAoB,SAAS,GAAG,GAAG,MAAM;CACvD,IAAI,MAAM,WAAW,GACpB,MAAM,IAAI,MACT,0BAA0B,OAAO,qBAAqB,MAAM,GAAG,KAAK,GAAG,IAAI,EAC5E;CAED,OAAO;AACR;;;;;;;AAYA,IAAa,sBAAb,cAAyC,MAAM;CAC9C;CACA,YAAY,SAAiB,WAAmB;EAC/C,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,YAAY;CAClB;AACD;;;;;;;AAQA,MAAa,sBAAsB,KAAa,UAAyB;CACxE,IAAI,CAAC,WAAW,GAAG,GAAG;CACtB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,YAAY,GAC9B,MAAM,IAAI,oBACT,UAAU,IAAI,0CACd,sBACD;CAGD,IADiB,YAAY,GAAG,CAAC,CAAC,QAAQ,SAAS,SAAS,MACjD,CAAC,CAAC,SAAS,KAAK,CAAC,OAC3B,MAAM,IAAI,oBACT,oBAAoB,IAAI,6HACxB,kBACD;AAEF;AAEA,MAAM,aAAa,SAA0B;CAC5C,IAAI;EACH,OAAO,UAAU,IAAI,CAAC,CAAC,eAAe;CACvC,QAAQ;EACP,OAAO;CACR;AACD;AAEA,MAAM,aAAa,QAAqC;CACvD,IACC,OAAO,QAAQ,YACf,QAAQ,QACR,UAAU,OACV,OAAO,IAAI,SAAS,UAEpB,OAAO,IAAI;AAGb;AAEA,MAAM,gBACL,MACA,QACA,WACU;CACV,IAAI,UAAU,IAAI,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,CAAC;CACjD,IAAI;EACH,YAAY,QAAQ,IAAI;CACzB,SAAS,KAAK;EAIb,IAAI,UAAU,GAAG,MAAM,WAAW,QAAQ,aAAa,SAAS;GAC/D,SACC,4BAA4B,KAAK,MAAM,OAAO,sCAC/C;GACA,cAAc,MAAM,MAAM;GAC1B;EACD;EACA,MAAM;CACP;AACD;;;;;;;;AAcA,MAAa,mBAAmB,OAC/B,UACA,WACA,UAA2B,CAAC,MACP;CACrB,MAAM,QAAQ,MAAM,iBAAiB,QAAQ;CAE7C,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;CACxC,KAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,OAAO,KAAK,WAAW,KAAK,IAAI;EACtC,UAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;EAC5C,IAAI,KAAK,SAAS,WACjB,aAAa,MAAM,KAAK,QAAQ,QAAQ,MAAM;OACxC;GACN,cAAc,MAAM,KAAK,KAAK;GAC9B,IAAI,KAAK,YAAY,UAAU,MAAM,GAAK;EAC3C;CACD;CACA,OAAO,MAAM;AACd"}
+{"version":3,"file":"bootstrap.js","names":[],"sources":["../../src/lib/bootstrap.ts"],"sourcesContent":["import {\n\tchmodSync,\n\texistsSync,\n\tlstatSync,\n\tmkdirSync,\n\treaddirSync,\n\trmSync,\n\tstatSync,\n\tsymlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { gunzipSync } from \"fflate\";\nimport YAML from \"yaml\";\n\n/**\n * A scaffold template that lives in a subdirectory of a public GitHub repo we\n * control. Bootstrapping copies that subdirectory into a target folder —\n * conceptually the same as `degit user/repo/subdir`, but implemented in-house.\n *\n * The whole template is pulled in a single request: we download the repo's\n * gzipped tarball from `codeload.github.com` and extract only the subdir we\n * want. That endpoint is unauthenticated and is NOT subject to the 60-requests\n * per-hour limit of the REST API (`api.github.com`), so bootstrapping works out\n * of the box on shared/corporate networks without a GITHUB_TOKEN. We lean on\n * `fflate` for gunzip and parse the tar in-house, so we never pull in a heavy\n * dependency tree just to copy a few files.\n */\n\n/**\n * Neon features that a template or project may require.\n * Each feature maps to a setup phase that the orchestrator can run.\n */\nexport type NeonFeature =\n\t| \"database\"\n\t| \"auth\"\n\t| \"functions\"\n\t| \"ai-gateway\"\n\t| \"object-storage\";\n\n/** Default features when a template doesn't specify `requires`. */\nconst DEFAULT_REQUIRES: NeonFeature[] = [\"database\"];\n\nexport interface BootstrapTemplate {\n\t/** Stable id used by `--template` and analytics. */\n\tid: string;\n\t/** Human label shown in the interactive selector. */\n\ttitle: string;\n\t/** One-line description shown under the title in the selector. */\n\tdescription: string;\n\t/**\n\t * Libraries/frameworks that shape the project (e.g. \"Hono\", \"Drizzle\").\n\t * Rendered next to the title in the picker so the row reads\n\t * \"Title (tools)\". Optional — older manifests omit it.\n\t */\n\ttools?: string[];\n\t/**\n\t * Neon services the template uses (e.g. \"Postgres\", \"Functions\"). Surfaced\n\t * alongside the description in the focused row's hint. Optional — older\n\t * manifests omit it.\n\t */\n\tservices?: string[];\n\t/** Neon features this template needs (defaults to [\"database\"]). */\n\trequires: NeonFeature[];\n\tsource: {\n\t\towner: string;\n\t\trepo: string;\n\t\t/** Branch (or tag) the template is pulled from. */\n\t\tref: string;\n\t\t/** Subdirectory within the repo to copy (no leading/trailing slash). */\n\t\tsubdir: string;\n\t};\n}\n\n/**\n * Hardcoded fallback used when every remote manifest source is unreachable.\n * Kept in sync with `neondatabase/examples/bootstrap.yaml` (the source of\n * truth) so that, even fully offline from the manifest, the picker still offers\n * the full set of starters rather than a single template.\n */\nexport const FALLBACK_TEMPLATES: BootstrapTemplate[] = [\n\t{\n\t\tid: \"hono\",\n\t\ttitle: \"REST API\",\n\t\tdescription:\n\t\t\t\"A Hono REST API on Neon Functions, backed by Neon Postgres via Drizzle.\",\n\t\ttools: [\"Hono\", \"Drizzle\"],\n\t\tservices: [\"Postgres\", \"Functions\"],\n\t\trequires: [\"database\", \"functions\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-hono\",\n\t\t},\n\t},\n\t{\n\t\tid: \"ai-sdk\",\n\t\ttitle: \"Image-generation agent\",\n\t\tdescription:\n\t\t\t\"A Vercel AI SDK agent that streams chat through the Neon AI Gateway and stores generated images in Neon object storage, indexed in Postgres via Drizzle.\",\n\t\ttools: [\"AI SDK\", \"Drizzle\"],\n\t\tservices: [\"Postgres\", \"Functions\", \"Object Storage\", \"AI Gateway\"],\n\t\trequires: [\"database\", \"functions\", \"object-storage\", \"ai-gateway\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-ai-sdk\",\n\t\t},\n\t},\n\t{\n\t\tid: \"mastra\",\n\t\ttitle: \"Personal-assistant agent\",\n\t\tdescription:\n\t\t\t\"A Mastra agent that streams chat through the Neon AI Gateway and uses Mastra Memory on Neon Postgres to remember you across threads.\",\n\t\ttools: [\"Mastra\", \"Mastra Memory\"],\n\t\tservices: [\"Postgres\", \"Functions\", \"AI Gateway\"],\n\t\trequires: [\"database\", \"functions\", \"ai-gateway\"],\n\t\tsource: {\n\t\t\towner: \"neondatabase\",\n\t\t\trepo: \"examples\",\n\t\t\tref: \"main\",\n\t\t\tsubdir: \"with-mastra\",\n\t\t},\n\t},\n];\n\nexport const templateIds = (templates: BootstrapTemplate[]): string =>\n\ttemplates.map((t) => t.id).join(\", \");\n\nexport const findTemplate = (\n\ttemplates: BootstrapTemplate[],\n\tid: string,\n): BootstrapTemplate | undefined => templates.find((t) => t.id === id);\n\n/** A single file or symlink to materialize, already resolved with its bytes. */\nexport type TemplateFile =\n\t| {\n\t\t\tkind: \"file\";\n\t\t\t/** Path relative to the target directory (subdir prefix stripped). */\n\t\t\tpath: string;\n\t\t\tbytes: Buffer;\n\t\t\texecutable: boolean;\n\t  }\n\t| {\n\t\t\tkind: \"symlink\";\n\t\t\tpath: string;\n\t\t\t/** The (relative) link target. */\n\t\t\ttarget: string;\n\t  };\n\nconst githubToken = (): string =>\n\tprocess.env.GITHUB_TOKEN ?? process.env.GH_TOKEN ?? \"\";\n\n// A token is never required for public templates, but we forward it when\n// present so the same code path works behind proxies that authenticate, and\n// (in future) for private template repos.\nconst downloadHeaders = (): Record<string, string> => ({\n\t\"User-Agent\": \"neon-init\",\n\t...(githubToken() ? { Authorization: `Bearer ${githubToken()}` } : {}),\n});\n\n// The codeload host is overridable so the e2e tests can point the downloader at\n// a local server (the same trick `--api-host` uses to redirect the Neon API).\nconst codeloadBase = (): string =>\n\tprocess.env.NEON_BOOTSTRAP_GITHUB_CODELOAD ?? \"https://codeload.github.com\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === \"object\" && value !== null;\n\n/**\n * Normalize a manifest entry's string list (`tools` or `services`) into a clean\n * array. Tolerant by design: a missing or non-array value yields `undefined`,\n * and non-string/blank items are dropped, so a malformed list never sinks an\n * otherwise-valid template (it just renders without that detail).\n */\nconst parseStringList = (value: unknown): string[] | undefined => {\n\tif (!Array.isArray(value)) return undefined;\n\tconst items = value.filter(\n\t\t(item): item is string =>\n\t\t\ttypeof item === \"string\" && item.trim() !== \"\",\n\t);\n\treturn items.length > 0 ? items : undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Remote template manifest\n// ---------------------------------------------------------------------------\n\n// Primary manifest host is neon.com (CDN-backed, no GitHub rate limiting), with\n// the raw GitHub copy as a fallback and the hardcoded list as the last resort.\n// A single env override (used by tests) short-circuits the chain.\nconst NEON_MANIFEST_URL = \"https://neon.com/bootstrap/templates.yaml\";\nconst GITHUB_RAW_MANIFEST_URL =\n\t\"https://raw.githubusercontent.com/neondatabase/examples/main/bootstrap.yaml\";\n\nfunction manifestUrls(): string[] {\n\tconst override = process.env.NEON_BOOTSTRAP_MANIFEST_URL;\n\tif (override) return [override];\n\treturn [NEON_MANIFEST_URL, GITHUB_RAW_MANIFEST_URL];\n}\n\nexport function parseManifest(text: string): BootstrapTemplate[] {\n\tconst data: unknown = YAML.parse(text);\n\tif (!isRecord(data) || !Array.isArray(data.templates)) {\n\t\tthrow new Error(\n\t\t\t'Invalid bootstrap manifest: missing \"templates\" array.',\n\t\t);\n\t}\n\tconst templates: BootstrapTemplate[] = [];\n\tfor (const item of data.templates) {\n\t\tif (\n\t\t\t!isRecord(item) ||\n\t\t\ttypeof item.id !== \"string\" ||\n\t\t\ttypeof item.title !== \"string\" ||\n\t\t\ttypeof item.description !== \"string\" ||\n\t\t\t!isRecord(item.source) ||\n\t\t\ttypeof item.source.owner !== \"string\" ||\n\t\t\ttypeof item.source.repo !== \"string\" ||\n\t\t\ttypeof item.source.ref !== \"string\" ||\n\t\t\ttypeof item.source.subdir !== \"string\"\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\t// Parse requires — accept a string array, default to [\"database\"].\n\t\tconst requires: NeonFeature[] =\n\t\t\tArray.isArray(item.requires) &&\n\t\t\titem.requires.every((r: unknown) => typeof r === \"string\")\n\t\t\t\t? (item.requires as NeonFeature[])\n\t\t\t\t: DEFAULT_REQUIRES;\n\t\tconst tools = parseStringList(item.tools);\n\t\tconst services = parseStringList(item.services);\n\t\ttemplates.push({\n\t\t\tid: item.id,\n\t\t\ttitle: item.title,\n\t\t\tdescription: item.description,\n\t\t\t...(tools ? { tools } : {}),\n\t\t\t...(services ? { services } : {}),\n\t\t\trequires,\n\t\t\tsource: {\n\t\t\t\towner: item.source.owner,\n\t\t\t\trepo: item.source.repo,\n\t\t\t\tref: item.source.ref,\n\t\t\t\tsubdir: item.source.subdir,\n\t\t\t},\n\t\t});\n\t}\n\treturn templates;\n}\n\n/**\n * Fetch the template manifest, trying each source in {@link manifestUrls} in\n * order and returning the first that yields a non-empty template list. Falls\n * back to the hardcoded list when every source is unreachable or empty, so the\n * picker never fails just because a host is down.\n */\nexport async function fetchTemplates(): Promise<BootstrapTemplate[]> {\n\tfor (const url of manifestUrls()) {\n\t\ttry {\n\t\t\tconst res = await fetch(url, {\n\t\t\t\theaders: downloadHeaders(),\n\t\t\t\tsignal: AbortSignal.timeout(10_000),\n\t\t\t});\n\t\t\tif (!res.ok) throw new Error(`HTTP ${res.status}`);\n\t\t\tconst templates = parseManifest(await res.text());\n\t\t\tif (templates.length > 0) return templates;\n\t\t} catch {\n\t\t\t// Try the next source.\n\t\t}\n\t}\n\treturn FALLBACK_TEMPLATES;\n}\n\n// ---------------------------------------------------------------------------\n// Tar parsing\n// ---------------------------------------------------------------------------\n\n/** A raw entry decoded from a tar stream, before subdir filtering. */\ntype TarEntry = {\n\t/** Full path as stored in the archive (includes the top-level dir). */\n\tname: string;\n\t/** POSIX type flag: '0' file, '5' directory, '2' symlink, etc. */\n\ttype: string;\n\t/** File permission bits. */\n\tmode: number;\n\t/** Symlink target (for type '2'). */\n\tlinkname: string;\n\t/** File contents (for type '0'). */\n\tdata: Buffer;\n};\n\nconst TAR_BLOCK = 512;\n\nconst readTarString = (buf: Buffer, offset: number, length: number): string => {\n\tlet end = offset;\n\tconst max = offset + length;\n\twhile (end < max && buf[end] !== 0) end++;\n\treturn buf.toString(\"utf8\", offset, end);\n};\n\nconst readTarOctal = (buf: Buffer, offset: number, length: number): number => {\n\tconst text = readTarString(buf, offset, length).trim();\n\tif (text === \"\") return 0;\n\tconst value = parseInt(text, 8);\n\treturn Number.isNaN(value) ? 0 : value;\n};\n\nconst isZeroBlock = (buf: Buffer, offset: number): boolean => {\n\tfor (let i = offset; i < offset + TAR_BLOCK; i++) {\n\t\tif (buf[i] !== 0) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Parse pax extended-header records (\"<len> <key>=<value>\\n\"). GitHub uses\n * these for the global header and for any path that doesn't fit the legacy\n * 100-byte name field, so we must honor at least `path` and `linkpath`.\n */\nconst parsePaxRecords = (data: Buffer): Record<string, string> => {\n\tconst records: Record<string, string> = {};\n\tlet pos = 0;\n\tconst text = data.toString(\"utf8\");\n\twhile (pos < text.length) {\n\t\tconst space = text.indexOf(\" \", pos);\n\t\tif (space === -1) break;\n\t\tconst len = parseInt(text.slice(pos, space), 10);\n\t\tif (Number.isNaN(len) || len <= 0) break;\n\t\tconst record = text.slice(space + 1, pos + len - 1); // drop trailing \"\\n\"\n\t\tconst eq = record.indexOf(\"=\");\n\t\tif (eq !== -1) records[record.slice(0, eq)] = record.slice(eq + 1);\n\t\tpos += len;\n\t}\n\treturn records;\n};\n\n/**\n * Decode a (decompressed) tar archive into its file/symlink entries. Pure and\n * dependency-free so it can be unit tested without touching the network.\n * Handles the ustar `prefix` field, pax extended headers (type 'x'/'g'), and\n * GNU long-name/long-link headers (type 'L'/'K') so deep template paths and\n * long symlink targets round-trip correctly.\n */\nexport const parseTar = (buf: Buffer): TarEntry[] => {\n\tconst entries: TarEntry[] = [];\n\t// Overrides carried from a preceding pax/GNU header to the next real entry.\n\tlet overridePath: string | undefined;\n\tlet overrideLink: string | undefined;\n\tlet offset = 0;\n\n\twhile (offset + TAR_BLOCK <= buf.length) {\n\t\tif (isZeroBlock(buf, offset)) break;\n\n\t\tlet name = readTarString(buf, offset, 100);\n\t\tconst mode = readTarOctal(buf, offset + 100, 8);\n\t\tconst size = readTarOctal(buf, offset + 124, 12);\n\t\tconst typeByte = buf[offset + 156];\n\t\tconst type = typeByte === 0 ? \"0\" : String.fromCharCode(typeByte);\n\t\tlet linkname = readTarString(buf, offset + 157, 100);\n\t\tconst magic = readTarString(buf, offset + 257, 6);\n\t\tif (magic.startsWith(\"ustar\")) {\n\t\t\tconst prefix = readTarString(buf, offset + 345, 155);\n\t\t\tif (prefix !== \"\") name = `${prefix}/${name}`;\n\t\t}\n\n\t\toffset += TAR_BLOCK;\n\t\tconst data = buf.subarray(offset, offset + size);\n\t\toffset += Math.ceil(size / TAR_BLOCK) * TAR_BLOCK;\n\n\t\tif (type === \"x\") {\n\t\t\tconst records = parsePaxRecords(data);\n\t\t\tif (records.path !== undefined) overridePath = records.path;\n\t\t\tif (records.linkpath !== undefined) overrideLink = records.linkpath;\n\t\t\tcontinue;\n\t\t}\n\t\tif (type === \"g\") {\n\t\t\t// Global pax header (e.g. GitHub's comment block): not per-entry state.\n\t\t\tcontinue;\n\t\t}\n\t\tif (type === \"L\" || type === \"K\") {\n\t\t\tconst longValue = data.toString(\"utf8\").replace(/\\0+$/, \"\");\n\t\t\tif (type === \"L\") overridePath = longValue;\n\t\t\telse overrideLink = longValue;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (overridePath !== undefined) name = overridePath;\n\t\tif (overrideLink !== undefined) linkname = overrideLink;\n\t\toverridePath = undefined;\n\t\toverrideLink = undefined;\n\n\t\tentries.push({ name, type, mode, linkname, data: Buffer.from(data) });\n\t}\n\n\treturn entries;\n};\n\n/**\n * Map decoded tar entries to the files under `subdir`, with the top-level\n * archive directory and the `subdir/` prefix stripped from each path. Pure so\n * it can be unit tested. Directory and other non-regular entries are dropped —\n * writing files re-creates their parent directories.\n */\nexport const selectTemplateFiles = (\n\tentries: TarEntry[],\n\tsubdir: string,\n): TemplateFile[] => {\n\tconst prefix = `${subdir.replace(/^\\/+|\\/+$/g, \"\")}/`;\n\tconst files: TemplateFile[] = [];\n\tfor (const entry of entries) {\n\t\t// codeload wraps everything in a single top-level dir (\"<repo>-<ref>/\");\n\t\t// strip that first segment to get the repo-relative path.\n\t\tconst slash = entry.name.indexOf(\"/\");\n\t\tif (slash === -1) continue;\n\t\tconst repoPath = entry.name.slice(slash + 1);\n\t\tif (!repoPath.startsWith(prefix)) continue;\n\t\tconst path = repoPath.slice(prefix.length);\n\t\tif (path === \"\") continue;\n\t\tif (entry.type === \"2\") {\n\t\t\tfiles.push({ kind: \"symlink\", path, target: entry.linkname });\n\t\t} else if (entry.type === \"0\" || entry.type === \"7\") {\n\t\t\tfiles.push({\n\t\t\t\tkind: \"file\",\n\t\t\t\tpath,\n\t\t\t\tbytes: entry.data,\n\t\t\t\texecutable: (entry.mode & 0o111) !== 0,\n\t\t\t});\n\t\t}\n\t\t// Directories ('5') and any other node types are intentionally skipped.\n\t}\n\treturn files;\n};\n\nconst tarballUrl = (template: BootstrapTemplate): string => {\n\tconst { owner, repo, ref } = template.source;\n\treturn `${codeloadBase()}/${owner}/${repo}/tar.gz/${ref}`;\n};\n\nconst friendlyGithubError = (status: number, url: string): Error => {\n\tif (status === 404) {\n\t\treturn new Error(\n\t\t\t`GitHub returned 404 for ${url}. The template repo or ref may have moved.`,\n\t\t);\n\t}\n\tif (status === 403 || status === 429) {\n\t\treturn new Error(\n\t\t\t`GitHub rate limited the template download (${url}). Set a GITHUB_TOKEN environment variable to raise the limit, then retry.`,\n\t\t);\n\t}\n\treturn new Error(`GitHub returned HTTP ${status} for ${url}.`);\n};\n\n/**\n * Download a template and resolve it to the exact set of files to write. The\n * entire subtree is captured in one tarball request, so the copy is atomically\n * consistent: a push to the template repo mid-download cannot produce a\n * mismatched checkout (unlike fetching a file list and then each blob).\n */\nexport const downloadTemplate = async (\n\ttemplate: BootstrapTemplate,\n): Promise<TemplateFile[]> => {\n\tconst url = tarballUrl(template);\n\n\tlet gzipped: Buffer;\n\ttry {\n\t\tconst res = await fetch(url, {\n\t\t\theaders: downloadHeaders(),\n\t\t\tsignal: AbortSignal.timeout(30_000),\n\t\t});\n\t\tif (!res.ok) throw friendlyGithubError(res.status, url);\n\t\tgzipped = Buffer.from(await res.arrayBuffer());\n\t} catch (err) {\n\t\tthrow err instanceof Error ? err : new Error(String(err));\n\t}\n\n\tlet tar: Buffer;\n\ttry {\n\t\ttar = Buffer.from(gunzipSync(new Uint8Array(gzipped)));\n\t} catch (err) {\n\t\tthrow new Error(\n\t\t\t`Failed to decompress the template archive from ${url}: ${\n\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t}`,\n\t\t);\n\t}\n\n\tconst { owner, repo, ref, subdir } = template.source;\n\tconst files = selectTemplateFiles(parseTar(tar), subdir);\n\tif (files.length === 0) {\n\t\tthrow new Error(\n\t\t\t`Template subdirectory \"${subdir}\" was not found in ${owner}/${repo}@${ref}.`,\n\t\t);\n\t}\n\treturn files;\n};\n\n// ---------------------------------------------------------------------------\n// Target validation + scaffolding to disk\n// ---------------------------------------------------------------------------\n\n/**\n * A bad caller-supplied input that an agent (or human) can correct: an unknown\n * template id or a non-empty target directory. Carries an `agentCode` so an\n * agent surface can report a precise error code instead of a generic\n * INTERNAL_ERROR, while a human path just surfaces the clear `message`.\n */\nexport class BootstrapInputError extends Error {\n\treadonly agentCode: string;\n\tconstructor(message: string, agentCode: string) {\n\t\tsuper(message);\n\t\tthis.name = \"BootstrapInputError\";\n\t\tthis.agentCode = agentCode;\n\t}\n}\n\n/**\n * Ensure `dir` is safe to scaffold into: it must be missing, or an empty\n * directory (a lone `.git` is ignored so you can scaffold into a freshly\n * `git init`ed folder). `force` allows scaffolding into a non-empty directory,\n * overwriting colliding files. Throws a {@link BootstrapInputError} otherwise.\n */\nexport const ensureTargetUsable = (dir: string, force: boolean): void => {\n\tif (!existsSync(dir)) return;\n\tif (!statSync(dir).isDirectory()) {\n\t\tthrow new BootstrapInputError(\n\t\t\t`Target ${dir} already exists and is not a directory.`,\n\t\t\t\"TARGET_NOT_DIRECTORY\",\n\t\t);\n\t}\n\tconst contents = readdirSync(dir).filter((name) => name !== \".git\");\n\tif (contents.length > 0 && !force) {\n\t\tthrow new BootstrapInputError(\n\t\t\t`Target directory ${dir} is not empty. Use --force to scaffold into it anyway (colliding files will be overwritten), or choose an empty directory.`,\n\t\t\t\"TARGET_NOT_EMPTY\",\n\t\t);\n\t}\n};\n\nconst isSymlink = (path: string): boolean => {\n\ttry {\n\t\treturn lstatSync(path).isSymbolicLink();\n\t} catch {\n\t\treturn false;\n\t}\n};\n\nconst errnoCode = (err: unknown): string | undefined => {\n\tif (\n\t\ttypeof err === \"object\" &&\n\t\terr !== null &&\n\t\t\"code\" in err &&\n\t\ttypeof err.code === \"string\"\n\t) {\n\t\treturn err.code;\n\t}\n\treturn undefined;\n};\n\nconst writeSymlink = (\n\tdest: string,\n\ttarget: string,\n\tonWarn?: (message: string) => void,\n): void => {\n\tif (isSymlink(dest)) rmSync(dest, { force: true });\n\ttry {\n\t\tsymlinkSync(target, dest);\n\t} catch (err) {\n\t\t// Windows refuses symlinks without elevated rights / developer mode. The\n\t\t// template still works for most tooling if we drop a regular file holding\n\t\t// the link target, so we degrade gracefully instead of failing the copy.\n\t\tif (errnoCode(err) === \"EPERM\" || process.platform === \"win32\") {\n\t\t\tonWarn?.(\n\t\t\t\t`Could not create symlink ${dest} -> ${target}; wrote it as a regular file instead.`,\n\t\t\t);\n\t\t\twriteFileSync(dest, target);\n\t\t\treturn;\n\t\t}\n\t\tthrow err;\n\t}\n};\n\nexport interface ScaffoldOptions {\n\t/** Called for non-fatal warnings (e.g. a symlink that fell back to a file). */\n\tonWarn?: (message: string) => void;\n}\n\n/**\n * Download `template` and materialize its files into `targetDir`, creating\n * parent directories, preserving executable bits, and recreating symlinks\n * (with a graceful regular-file fallback on platforms that disallow them).\n * Returns the number of files written. The caller is responsible for any\n * target validation ({@link ensureTargetUsable}) and user-facing progress.\n */\nexport const scaffoldTemplate = async (\n\ttemplate: BootstrapTemplate,\n\ttargetDir: string,\n\toptions: ScaffoldOptions = {},\n): Promise<number> => {\n\tconst files = await downloadTemplate(template);\n\n\tmkdirSync(targetDir, { recursive: true });\n\tfor (const file of files) {\n\t\tconst dest = join(targetDir, file.path);\n\t\tmkdirSync(dirname(dest), { recursive: true });\n\t\tif (file.kind === \"symlink\") {\n\t\t\twriteSymlink(dest, file.target, options.onWarn);\n\t\t} else {\n\t\t\twriteFileSync(dest, file.bytes);\n\t\t\tif (file.executable) chmodSync(dest, 0o755);\n\t\t}\n\t}\n\treturn files.length;\n};\n"],"mappings":"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"}

package/dist/lib/phases/setup.js

@@ -54,10 +54,13 @@ function buildTemplatePreference(templates) {
 		id: "template",
 		question: "No application was detected in this directory. Would you like to scaffold a new project from a template?",
 		phase: "before_checks",
-		options: [...templates.map((t) => ({
-			value: t.id,
-			label: `${t.title} — ${t.description}`
-		})), {
+		options: [...templates.map((t) => {
+			const tools = t.tools && t.tools.length > 0 ? ` (${t.tools.join(", ")})` : "";
+			return {
+				value: t.id,
+				label: `${t.title}${tools} — ${t.description}`
+			};
+		}), {
 			value: "none",
 			label: "No thanks — continue without scaffolding"
 		}],

package/dist/lib/phases/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","names":[],"sources":["../../../src/lib/phases/setup.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { execa } from \"execa\";\nimport { resolveAddMcpAgentId } from \"../agents.js\";\nimport {\n\tFALLBACK_TEMPLATES,\n\tfetchTemplates,\n\tfindTemplate,\n\ttype NeonFeature,\n\tscaffoldTemplate,\n} from \"../bootstrap.js\";\nimport {\n\tdetectIde,\n\tisCursorInstalled,\n\tisVSCodeInstalled,\n} from \"../detect-agent.js\";\nimport { findEditorCommand } from \"../extension.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport { ensureNeonctl } from \"../neonctl.js\";\nimport { ensureSkillsUpToDate } from \"../skills.js\";\nimport type { Editor, PhaseResponse } from \"../types.js\";\nimport { downloadVsix, NEON_EXTENSION_ID } from \"../vsix.js\";\n\nexport interface SetupPhaseOptions {\n\tagent?: string;\n\t/** The IDE/editor the user is running in (e.g. \"cursor\", \"vscode\") — reported by agent */\n\tide?: string;\n\t/** Enable preview skills (neon-object-storage, neon-functions, neon-ai-gateway) */\n\tpreview?: boolean;\n\t/** Whether the directory already contains an application */\n\thasApp?: boolean;\n\t/** Template ID to scaffold (when bootstrapping a new project) */\n\ttemplate?: string;\n\t/** Neon features required by the selected template */\n\ttemplateRequires?: NeonFeature[];\n\t/** Neon features selected by the user (brownfield flows) */\n\tfeatures?: NeonFeature[];\n\t// Inspection results — pre-filled by orchestrator or reported by agent\n\tmcpConfigured?: boolean | null;\n\tskillsInstalled?: boolean | null;\n\tconnectionString?: boolean | null;\n\tconnectionParams?: string; // JSON with host/dbname/etc if found\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\tisVscodeIde?: boolean | null;\n\t// User preferences (also used for pre-detected scope from inspection)\n\tmode?: string;\n\tmcpScope?: string;\n\tskillsScope?: string;\n\tinstallExtension?: boolean;\n\t// Execution flags\n\texecute?: boolean;\n}\n\n/**\n * Comprehensive setup phase: inspects repo state, collects user preferences,\n * then batches all installation commands together.\n *\n * With --data JSON, the agent sends inspection results AND user preferences\n * in a single call, so the CLI can go straight to installation.\n */\nexport async function handleSetupPhase(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\t// Parse features from comma-separated string (e.g. \"database,auth\" from agent --data)\n\tif (typeof options.features === \"string\") {\n\t\toptions.features = (options.features as unknown as string)\n\t\t\t.split(\",\")\n\t\t\t.map((f) => f.trim()) as NeonFeature[];\n\t}\n\n\t// Treat \"none\" as no template selected\n\tconst templateWasAnswered = options.template !== undefined;\n\tif (options.template === \"none\") {\n\t\toptions.template = undefined;\n\t}\n\n\t// Resolve template requirements if a template was selected but requires not yet populated\n\tif (options.template && !options.templateRequires) {\n\t\tconst templates = await fetchTemplates();\n\t\tconst selected = templates.find((t) => t.id === options.template);\n\t\tif (selected) {\n\t\t\toptions.templateRequires = selected.requires;\n\t\t}\n\t}\n\n\t// --execute: run the batched installation (legacy path)\n\tif (options.execute) {\n\t\treturn executeBatchedInstallation(await mergeCliInspection(options));\n\t}\n\n\t// Treat any explicit mode value that isn't \"customize\"/\"custom\" as defaults.\n\t// Also treat as defaults when mode is missing but agent reported back\n\t// (template was answered, nothing left to customize).\n\tconst hasReportedBack = options.mode || templateWasAnswered;\n\tif (\n\t\thasReportedBack &&\n\t\toptions.mode !== \"customize\" &&\n\t\toptions.mode !== \"custom\"\n\t) {\n\t\tconst merged = await mergeCliInspection(options);\n\t\tconst shouldInstallExt =\n\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\treturn executeBatchedInstallation({\n\t\t\t...merged,\n\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\tinstallExtension: shouldInstallExt,\n\t\t});\n\t}\n\n\t// User chose \"customize\" (also accept \"custom\" — agents sometimes truncate)\n\tif (options.mode === \"customize\" || options.mode === \"custom\") {\n\t\tconst merged = await mergeCliInspection(options);\n\t\tconst shouldInstallExt =\n\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\treturn executeBatchedInstallation({\n\t\t\t...merged,\n\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\tinstallExtension: shouldInstallExt,\n\t\t});\n\t}\n\n\t// Default: send inspection checks with user preferences (all in one response)\n\treturn buildBulkInspection(options);\n}\n\nfunction buildTemplatePreference(\n\ttemplates: { id: string; title: string; description: string }[],\n) {\n\treturn [\n\t\t{\n\t\t\tid: \"template\",\n\t\t\tquestion:\n\t\t\t\t\"No application was detected in this directory. Would you like to scaffold a new project from a template?\",\n\t\t\tphase: \"before_checks\" as const,\n\t\t\toptions: [\n\t\t\t\t...templates.map((t) => ({\n\t\t\t\t\tvalue: t.id,\n\t\t\t\t\tlabel: `${t.title} — ${t.description}`,\n\t\t\t\t})),\n\t\t\t\t{\n\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\tlabel: \"No thanks — continue without scaffolding\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tdefault: \"none\",\n\t\t},\n\t];\n}\n\nasync function buildBulkInspection(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst hasApp = options.hasApp !== false;\n\tconst detectedIde = detectIde();\n\n\t// If no IDE detected (e.g. standalone terminal), check what's installed\n\tconst installedEditors: string[] = [];\n\tif (!detectedIde) {\n\t\tif (isCursorInstalled()) installedEditors.push(\"cursor\");\n\t\tif (isVSCodeInstalled()) installedEditors.push(\"vscode\");\n\t}\n\n\t// Fetch available templates when no app is detected\n\tlet templatePreferences: ReturnType<typeof buildTemplatePreference> = [];\n\tif (!hasApp) {\n\t\tlet templates = FALLBACK_TEMPLATES;\n\t\ttry {\n\t\t\tconst fetched = await fetchTemplates();\n\t\t\tif (fetched && fetched.length > 0) templates = fetched;\n\t\t} catch {}\n\t\ttemplatePreferences = buildTemplatePreference(templates);\n\t}\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: hasApp ? \"pending\" : \"bootstrap_needed\",\n\t\tdetectedIde: detectedIde?.toLowerCase() ?? null,\n\t\tinstalledEditors: installedEditors.length > 0 ? installedEditors : null,\n\t\t// Pre-detected state from filesystem inspection\n\t\tmcpConfigured: options.mcpConfigured ?? null,\n\t\tmcpScope: options.mcpScope ?? null,\n\t\tskillsInstalled: options.skillsInstalled ?? null,\n\t\tskillsScope: options.skillsScope ?? null,\n\t\tnextAction: {\n\t\t\ttype: \"agent_check\",\n\t\t\tinstructions: [\n\t\t\t\t\"IMPORTANT: Do NOT summarize this response or ask the user for consent/confirmation before starting. Proceed IMMEDIATELY with the first userPreference question.\",\n\t\t\t\t\"\",\n\t\t\t\thasApp\n\t\t\t\t\t? \"Perform the agent checks listed above (MCP server status and your agent identity), then present each userPreference question to the user ONE AT A TIME, in order. Wait for the user's answer before showing the next question. Respect the `condition` field — only show a question if its condition is met.\"\n\t\t\t\t\t: \"No application was detected in this directory. Ask the user if they'd like to scaffold a new project from a template (the `template` preference). Present ALL template options and the 'No thanks' option — do NOT auto-select even if there is only one template. If the user selects a template, the scaffolded template includes agent skills so skills installation will be skipped. If the user chooses 'none', continue with the remaining setup preferences normally. Then perform the agent checks and present the remaining preferences ONE AT A TIME.\",\n\t\t\t\t\"\",\n\t\t\t\t`The CLI has pre-detected the following from the filesystem: MCP server: ${options.mcpConfigured ? `configured (${options.mcpScope})` : \"not configured\"}. Agent skills: ${options.skillsInstalled ? `installed (${options.skillsScope})` : String(options.skillsScope ?? \"\").includes(\"partial\") ? `partially installed (${options.skillsScope}) — missing skills will be auto-installed to the same scope` : \"not installed\"}. Report these findings to the user before asking preferences. Only ask about scope/options for components that are NOT already configured. Do NOT ask about skills scope if skills are partially installed — they will be completed automatically.`,\n\t\t\t\t\"\",\n\t\t\t\t\"IMPORTANT (Cursor users): Cursor disables project-level MCP servers by default as a security measure. If the user is in Cursor and chooses project-level MCP scope, warn them that they will need to manually enable the Neon server in Cursor Settings > MCP after installation. Recommend global scope for Cursor to avoid this extra step.\",\n\t\t\t\t\"\",\n\t\t\t\t\"GROUPING: Preferences that share the same `group` field should be presented together in a single message (e.g. list all customize options at once and let the user answer them together). Preferences without a `group` must be asked individually.\",\n\t\t\t\t\"\",\n\t\t\t\tdetectedIde\n\t\t\t\t\t? `The CLI has detected the IDE as: ${detectedIde.toLowerCase()}. Include this as the \"ide\" field in your reportBack data. IMPORTANT: The IDE and the agent are different — you may be Claude Code (agent) running inside Cursor (IDE). The extension installs into the IDE, so if the IDE is Cursor/VS Code/Windsurf, the extension IS applicable even if you are Claude Code.`\n\t\t\t\t\t: installedEditors.length > 0\n\t\t\t\t\t\t? `No IDE detected, but the following editors are installed: ${installedEditors.join(\", \")}. The \"installedEditors\" field in this response lists them. If the user wants the extension installed, ask which editor to install it for and include that as the \"ide\" field in your reportBack data. If not, set \"ide\" to \"none\".`\n\t\t\t\t\t\t: `No IDE or supported editors detected. Set \"ide\" to \"none\" in your reportBack data.`,\n\t\t\t\t\"\",\n\t\t\t\t\"After all questions are answered, call reportBack with a single --data JSON containing: agent, ide, mcpConfigured, and all preference answers. The CLI will inspect the project and merge results automatically.\",\n\t\t\t].join(\"\\n\"),\n\t\t\tchecks: [\n\t\t\t\t{\n\t\t\t\t\tid: \"neonctl\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"The neonctl CLI will be installed or updated automatically (no action needed from the agent)\",\n\t\t\t\t\tlookFor: [],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"mcp_server\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Check if the Neon MCP server is already configured in your MCP server list\",\n\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\"An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"agent_type\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Identify which coding agent is running this command\",\n\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\"Determine which agent you are: cursor, claude-code, copilot, vscode, windsurf, codex, cline, gemini-cli, goose, opencode, or antigravity\",\n\t\t\t\t\t\t\"Report your own agent identifier — this is used to configure the MCP server for the correct tool\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...(detectedIde\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"extension_installed\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Check if the Neon editor extension (databricks.neon-local-connect) is already installed in the IDE (NOT the agent — e.g. if you are Claude Code running inside Cursor, check Cursor's extensions)\",\n\t\t\t\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\t\t\t\"Run the IDE's --list-extensions command or check installed extensions for 'databricks.neon-local-connect' or 'Neon Local Connect'\",\n\t\t\t\t\t\t\t\t\t\"If the extension is found, set installExtension to false in your reportBack data and SKIP the installExtension question\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t],\n\t\t\tuserPreferences: [\n\t\t\t\t...templatePreferences,\n\t\t\t\t// For brownfield flows, ask which Neon features to enable\n\t\t\t\t...(hasApp\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"features\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"Which Neon features would you like to enable for this project?\",\n\t\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"database\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Database (always included)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"database,auth\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Database + Neon Auth (adds authentication via Neon)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdefault: \"database\",\n\t\t\t\t\t\t\t\tcontext:\n\t\t\t\t\t\t\t\t\t\"Database connectivity is always set up. Neon Auth adds user authentication powered by Neon. More features (Functions, AI Gateway, Object Storage) will be available soon.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t// Only show defaults/customize when there's something to customize:\n\t\t\t\t// MCP not configured, skills need scope choice, or extension not detected.\n\t\t\t\t...(() => {\n\t\t\t\t\tconst isPartialSkills = String(\n\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t).includes(\"partial\");\n\t\t\t\t\tconst needsMcpChoice = !options.mcpConfigured;\n\t\t\t\t\tconst needsSkillsChoice =\n\t\t\t\t\t\t!options.skillsInstalled && !isPartialSkills;\n\t\t\t\t\tconst hasCustomizableOptions =\n\t\t\t\t\t\tneedsMcpChoice || needsSkillsChoice;\n\t\t\t\t\tif (!hasCustomizableOptions) return [];\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"mode\",\n\t\t\t\t\t\t\tquestion: \"Use default settings or customize?\",\n\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\t\t\t\t\tlabel: hasApp\n\t\t\t\t\t\t\t\t\t\t? \"Use defaults (neonctl CLI, MCP: global, skills: project-level, extension if applicable — already-configured components will be skipped)\"\n\t\t\t\t\t\t\t\t\t\t: \"Use defaults (neonctl CLI, MCP: global, extension if applicable — skills included in template)\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tdefault: \"defaults\",\n\t\t\t\t\t\t},\n\t\t\t\t\t];\n\t\t\t\t})(),\n\t\t\t\t{\n\t\t\t\t\tid: \"mcpScope\",\n\t\t\t\t\tquestion: \"Where should the Neon MCP server be configured?\",\n\t\t\t\t\tcontext:\n\t\t\t\t\t\t\"SKIP this question entirely if the mcp_server check found it is already configured. Only ask if MCP is NOT yet configured. NOTE: Cursor disables project-level MCP servers by default — if the user is in Cursor, recommend global scope or warn that they will need to manually enable the server in Cursor Settings > MCP.\",\n\t\t\t\t\tphase: \"after_checks\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (scoped to this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\t\t\tlabel: \"Skip — do not install the MCP server\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"global\",\n\t\t\t\t\tcondition: { preferenceId: \"mode\", equals: \"customize\" },\n\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t},\n\t\t\t\t// Show skills scope when skills aren't detected and no partial install exists.\n\t\t\t\t// Partial installations are auto-completed to the same scope silently.\n\t\t\t\t...(!options.skillsInstalled &&\n\t\t\t\t!String(options.skillsScope ?? \"\").includes(\"partial\")\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"skillsScope\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"Where should Neon agent skills be installed?\",\n\t\t\t\t\t\t\t\tcontext:\n\t\t\t\t\t\t\t\t\t\"Only ask if skills are not already installed.\",\n\t\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Project-level (scoped to this project only)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdefault: \"project\",\n\t\t\t\t\t\t\t\tcondition: {\n\t\t\t\t\t\t\t\t\tpreferenceId: \"mode\",\n\t\t\t\t\t\t\t\t\tequals: \"customize\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t{\n\t\t\t\t\tid: \"installExtension\",\n\t\t\t\t\tquestion:\n\t\t\t\t\t\t\"Install the Neon editor extension for local database browsing?\",\n\t\t\t\t\tphase: \"after_checks\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{ value: \"true\", label: \"Yes\" },\n\t\t\t\t\t\t{ value: \"false\", label: \"No\" },\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"true\",\n\t\t\t\t\tcontext:\n\t\t\t\t\t\t\"The extension installs into the IDE, NOT the agent. If the CLI detected the IDE (see detectedIde field), use that — e.g. Claude Code running inside Cursor means the IDE is Cursor and the extension IS applicable. Only applicable for VS Code-based IDEs (VS Code, Cursor, Windsurf). SKIP this question if the user is NOT in a VS Code-based IDE, or if the extension_installed check found it is already installed. Set installExtension to false in reportBack if skipped.\",\n\t\t\t\t\tcondition: { preferenceId: \"mode\", equals: \"customize\" },\n\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t},\n\t\t\t],\n\t\t\treportBack: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\n\t\t\t\t\t\"setup\",\n\t\t\t\t\t\"--json\",\n\t\t\t\t\t\"--data\",\n\t\t\t\t\t(() => {\n\t\t\t\t\t\tconst partialScope = String(\n\t\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t\t).replace(\"-partial\", \"\");\n\t\t\t\t\t\tconst hasPartial = String(\n\t\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t\t).includes(\"partial\");\n\t\t\t\t\t\tconst previewFlag = options.preview\n\t\t\t\t\t\t\t? \", preview: true\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst needsMcpChoice = !options.mcpConfigured;\n\t\t\t\t\t\tconst needsSkillsChoice =\n\t\t\t\t\t\t\t!options.skillsInstalled && !hasPartial;\n\t\t\t\t\t\tconst hasModeQuestion =\n\t\t\t\t\t\t\tneedsMcpChoice || needsSkillsChoice;\n\t\t\t\t\t\tconst modeField = hasModeQuestion\n\t\t\t\t\t\t\t? \", mode: string\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst mcpField = hasModeQuestion\n\t\t\t\t\t\t\t? \", mcpScope?: 'global'|'project'|'none'\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst skillsField = needsSkillsChoice\n\t\t\t\t\t\t\t? \", skillsScope?: string\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst extField = hasModeQuestion\n\t\t\t\t\t\t\t? \", installExtension?: bool\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst prefilledSkills =\n\t\t\t\t\t\t\toptions.skillsInstalled || hasPartial\n\t\t\t\t\t\t\t\t? `, skillsScope: \"${options.skillsInstalled ? options.skillsScope || \"project\" : partialScope}\"`\n\t\t\t\t\t\t\t\t: skillsField;\n\t\t\t\t\t\treturn `<json: { agent: string, ide: string, mcpConfigured: bool${prefilledSkills}${previewFlag}${modeField}${mcpField}${extField}${hasApp ? \", features?: string\" : \", template: string\"} }>`;\n\t\t\t\t\t})(),\n\t\t\t\t],\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction _buildModeQuestion(options: SetupPhaseOptions): PhaseResponse {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\n\t// Build a context summary from what the agent found\n\tconst findings: string[] = [];\n\tif (options.mcpConfigured) {\n\t\tfindings.push(\n\t\t\t\"Neon MCP server is already configured (will be upgraded to evergreen)\",\n\t\t);\n\t} else {\n\t\tfindings.push(\"Neon MCP server is not configured\");\n\t}\n\tif (options.connectionString) {\n\t\tfindings.push(\"A Neon connection string was found in the project\");\n\t} else {\n\t\tfindings.push(\"No Neon connection string found — will need to add one\");\n\t}\n\tif (options.framework && options.framework !== \"none\") {\n\t\tfindings.push(`Framework detected: ${options.framework}`);\n\t}\n\tif (options.orm && options.orm !== \"none\") {\n\t\tfindings.push(`ORM detected: ${options.orm}`);\n\t}\n\tif (options.migrationTool && options.migrationTool !== \"none\") {\n\t\tfindings.push(`Migration tool detected: ${options.migrationTool}`);\n\t}\n\tif (options.isVscodeIde) {\n\t\tfindings.push(\"VS Code-based IDE detected — Neon extension available\");\n\t}\n\n\tconst inspectionArgs = buildInspectionArgs(options);\n\n\t// Build defaults label showing only what will be installed\n\tconst defaultsParts: string[] = [\"neonctl CLI\"];\n\tif (!options.mcpConfigured) defaultsParts.push(\"MCP global\");\n\tdefaultsParts.push(\"skills in project\");\n\tif (options.isVscodeIde) defaultsParts.push(\"install extension\");\n\tconst defaultsLabel =\n\t\tdefaultsParts.length > 0\n\t\t\t? `Use defaults (${defaultsParts.join(\", \")})`\n\t\t\t: \"Use defaults\";\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"preferences_needed\",\n\t\tinspection: {\n\t\t\tmcpConfigured: options.mcpConfigured,\n\t\t\tconnectionString: options.connectionString,\n\t\t\tframework: options.framework,\n\t\t\torm: options.orm,\n\t\t\tmigrationTool: options.migrationTool,\n\t\t\tmigrationDir: options.migrationDir,\n\t\t\tisVscodeIde: options.isVscodeIde,\n\t\t},\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion: \"Use default settings or customize?\",\n\t\t\toptions: [\n\t\t\t\t{\n\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\tlabel: defaultsLabel,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tcontext: `Project inspection results:\\n${findings.map((f) => `- ${f}`).join(\"\\n\")}`,\n\t\t\tresponseMapping: {\n\t\t\t\tdefaults: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"setup\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...agentArgs,\n\t\t\t\t\t\t...inspectionArgs,\n\t\t\t\t\t\t\"--mode\",\n\t\t\t\t\t\t\"defaults\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tcustomize: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"setup\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...agentArgs,\n\t\t\t\t\t\t...inspectionArgs,\n\t\t\t\t\t\t\"--mode\",\n\t\t\t\t\t\t\"customize\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction _buildCustomizeQuestions(options: SetupPhaseOptions): PhaseResponse {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\tconst inspectionArgs = buildInspectionArgs(options);\n\n\tconst needsMcp = !options.mcpConfigured;\n\tconst mcpScopes = needsMcp ? [\"global\", \"project\", \"none\"] : [\"skip\"];\n\tconst skillsScopes = [\"global\", \"project\"];\n\tconst extOptions = options.isVscodeIde ? [\"ext\", \"noext\"] : [\"ext\"];\n\n\t// Build all combinations of configurable options\n\tconst customOptions: { value: string; label: string }[] = [];\n\tfor (const mcp of mcpScopes) {\n\t\tfor (const skills of skillsScopes) {\n\t\t\tfor (const ext of extOptions) {\n\t\t\t\tconst parts: string[] = [];\n\t\t\t\tif (mcp === \"none\") parts.push(\"Skip MCP\");\n\t\t\t\telse if (mcp !== \"skip\") parts.push(`MCP: ${mcp}`);\n\t\t\t\tif (skills !== \"skip\")\n\t\t\t\t\tparts.push(\n\t\t\t\t\t\t`Skills: ${skills === \"project\" ? \"project-level\" : skills}`,\n\t\t\t\t\t);\n\t\t\t\tif (options.isVscodeIde) {\n\t\t\t\t\tparts.push(\n\t\t\t\t\t\text === \"ext\" ? \"Install extension\" : \"Skip extension\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcustomOptions.push({\n\t\t\t\t\tvalue: `${mcp}_${skills}_${ext}`,\n\t\t\t\t\tlabel: parts.join(\", \"),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\tconst responseMapping: Record<string, { args: string[] }> = {};\n\n\tfor (const opt of customOptions) {\n\t\tconst parts = opt.value.split(\"_\");\n\t\tconst mcpScope = parts[0] === \"skip\" ? \"global\" : parts[0]; // \"none\" passes through\n\t\tconst skillsScope = parts[1] === \"skip\" ? \"project\" : parts[1];\n\t\tconst installExt = parts[2] === \"ext\";\n\n\t\tresponseMapping[opt.value] = {\n\t\t\targs: [\n\t\t\t\t\"setup\",\n\t\t\t\t\"--json\",\n\t\t\t\t...agentArgs,\n\t\t\t\t...inspectionArgs,\n\t\t\t\t\"--mode\",\n\t\t\t\t\"customize\",\n\t\t\t\t\"--mcp-scope\",\n\t\t\t\tmcpScope,\n\t\t\t\t\"--skills-scope\",\n\t\t\t\tskillsScope,\n\t\t\t\t...(options.isVscodeIde\n\t\t\t\t\t? [\"--install-extension\", installExt ? \"true\" : \"false\"]\n\t\t\t\t\t: []),\n\t\t\t\t\"--execute\",\n\t\t\t],\n\t\t};\n\t}\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"customizing\",\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion: \"Choose your installation configuration:\",\n\t\t\toptions: customOptions,\n\t\t\tcontext:\n\t\t\t\t\"Global scope means settings apply across all your projects. Project-level means settings are scoped to this project only.\" +\n\t\t\t\t(options.mcpConfigured\n\t\t\t\t\t? \"\\nSince Neon tools are already installed, they will be upgraded to the latest evergreen version.\"\n\t\t\t\t\t: \"\") +\n\t\t\t\t(isCursorAgent(options)\n\t\t\t\t\t? \"\\nNote: Cursor disables project-level MCP servers by default. If you choose project scope, you will need to manually enable the Neon server in Cursor Settings > MCP.\"\n\t\t\t\t\t: \"\"),\n\t\t\tresponseMapping,\n\t\t},\n\t};\n}\n\ninterface InstallResult {\n\tid: string;\n\tdescription: string;\n\tstatus: \"success\" | \"failed\";\n\terror?: string;\n\t/** True when the step wasn't automated — the description contains manual instructions for the user */\n\tmanualAction?: boolean;\n\t/** Shell commands the agent can run to complete this step manually */\n\tcommands?: string[];\n}\n\n/**\n * Executes the batched installation of MCP server, skills, and extension.\n * Runs commands directly in the CLI process — the agent does NOT run these.\n * Returns results and chains to the getting-started phase.\n */\nasync function executeBatchedInstallation(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst mcpScope = options.mcpScope ?? \"global\";\n\tconst agentId = options.agent ?? \"cursor\";\n\tconst mcpAgentId = resolveAddMcpAgentId(agentId);\n\tconst installExt = options.installExtension === true;\n\n\tconst results: InstallResult[] = [];\n\tconst isBootstrap = !!options.template;\n\n\t// Step 0: Bootstrap project from template if specified\n\tif (isBootstrap && options.template) {\n\t\ttry {\n\t\t\tconst templates = await fetchTemplates();\n\t\t\tconst template =\n\t\t\t\tfindTemplate(templates, options.template) ??\n\t\t\t\tfindTemplate(FALLBACK_TEMPLATES, options.template);\n\t\t\tif (!template) {\n\t\t\t\tthrow new Error(`Unknown template \"${options.template}\".`);\n\t\t\t}\n\t\t\tawait scaffoldTemplate(template, \".\");\n\t\t\tresults.push({\n\t\t\t\tid: \"bootstrap\",\n\t\t\t\tdescription: `Scaffolded project from template \"${options.template}\"`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\n\t\t\t// Write template features to .neon under _init (ephemeral, cleaned up when init completes)\n\t\t\tif (options.templateRequires) {\n\t\t\t\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\t\t\t\tconst context: Record<string, unknown> = {\n\t\t\t\t\t_init: { features: options.templateRequires },\n\t\t\t\t};\n\t\t\t\twriteFileSync(\n\t\t\t\t\tneonContextPath,\n\t\t\t\t\t`${JSON.stringify(context, null, 2)}\\n`,\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tresults.push({\n\t\t\t\tid: \"bootstrap\",\n\t\t\t\tdescription: `Failed to scaffold project from template \"${options.template}\"`,\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: err instanceof Error ? err.message : \"Unknown error\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 1: Ensure neonctl CLI is installed and up to date\n\tconst neonctlResult = await ensureNeonctl();\n\tswitch (neonctlResult.status) {\n\t\tcase \"already_current\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `neonctl CLI is up to date (v${neonctlResult.version})`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"installed\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `Installed neonctl CLI (v${neonctlResult.version})`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"updated\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `Updated neonctl CLI to v${neonctlResult.version}`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"failed\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: \"Failed to install neonctl CLI\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: neonctlResult.error,\n\t\t\t});\n\t\t\tbreak;\n\t}\n\n\t// Step 2: Install MCP server (skip if already configured)\n\tconst isCursor =\n\t\tmcpAgentId === \"cursor\" ||\n\t\toptions.ide?.toLowerCase() === \"cursor\" ||\n\t\toptions.agent?.toLowerCase() === \"cursor\";\n\n\tif (mcpScope === \"none\") {\n\t\tresults.push({\n\t\t\tid: \"skip_mcp\",\n\t\t\tdescription: \"Neon MCP server installation skipped by user\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else if (options.mcpConfigured) {\n\t\tresults.push({\n\t\t\tid: \"skip_mcp\",\n\t\t\tdescription: \"Neon MCP server already configured\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else {\n\t\tconst mcpArgs = [\n\t\t\t\"-y\",\n\t\t\t\"add-mcp\",\n\t\t\t\"https://mcp.neon.tech/mcp\",\n\t\t\t...(mcpScope === \"global\" ? [\"-g\"] : []),\n\t\t\t\"-n\",\n\t\t\t\"Neon\",\n\t\t\t\"-y\",\n\t\t\t\"-a\",\n\t\t\tmcpAgentId,\n\t\t];\n\t\ttry {\n\t\t\tawait execa(\"npx\", mcpArgs, { stdio: \"pipe\", timeout: 60000 });\n\t\t\tresults.push({\n\t\t\t\tid: \"install_mcp\",\n\t\t\t\tdescription: `Installed Neon MCP server (${mcpScope} scope)`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\n\t\t\t// Some editors disable newly added MCP servers by default.\n\t\t\t// Cursor: project-level servers are always disabled initially.\n\t\t\t// Claude Code: newly added servers require user approval.\n\t\t\tconst isClaudeCode =\n\t\t\t\tmcpAgentId === \"claude-code\" ||\n\t\t\t\toptions.agent?.toLowerCase() === \"claude-code\";\n\n\t\t\tif (isCursor && mcpScope === \"project\") {\n\t\t\t\tresults.push({\n\t\t\t\t\tid: \"enable_mcp\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'Cursor disables project-level MCP servers by default. Open Cursor Settings > MCP and toggle the \"Neon\" server on.',\n\t\t\t\t\tstatus: \"success\",\n\t\t\t\t\tmanualAction: true,\n\t\t\t\t});\n\t\t\t} else if (isClaudeCode) {\n\t\t\t\tresults.push({\n\t\t\t\t\tid: \"enable_mcp\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" MCP server to enable it. You can check MCP server status with /mcp in Claude Code.',\n\t\t\t\t\tstatus: \"success\",\n\t\t\t\t\tmanualAction: true,\n\t\t\t\t});\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tresults.push({\n\t\t\t\tid: \"install_mcp\",\n\t\t\t\tdescription: \"Failed to install Neon MCP server\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: err instanceof Error ? err.message : \"Unknown error\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 3: Install/update skills (skip when bootstrapping — templates bundle skills)\n\tif (isBootstrap) {\n\t\tresults.push({\n\t\t\tid: \"install_skills\",\n\t\t\tdescription: \"Neon agent skills included in template\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else {\n\t\tconst skillsScope = (options.skillsScope ?? \"project\") as\n\t\t\t| \"global\"\n\t\t\t| \"project\";\n\t\tconst skillsOk = await ensureSkillsUpToDate(\n\t\t\tagentId,\n\t\t\tskillsScope,\n\t\t\toptions.preview,\n\t\t);\n\t\tif (skillsOk) {\n\t\t\tresults.push({\n\t\t\t\tid: \"install_skills\",\n\t\t\t\tdescription: \"Neon agent skills installed\",\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t} else {\n\t\t\t// Build the install commands for the agent to run directly\n\t\t\t// (sandboxed environments may block child process writes)\n\t\t\tconst { getSkillList } = await import(\"../skills.js\");\n\t\t\tconst skillList = getSkillList(options.preview);\n\t\t\tconst cmds = skillList.map(\n\t\t\t\t(s) =>\n\t\t\t\t\t`skills add neondatabase/agent-skills --skill ${s} --agent ${agentId}${skillsScope === \"global\" ? \" -g\" : \"\"} -y`,\n\t\t\t);\n\t\t\tresults.push({\n\t\t\t\tid: \"install_skills\",\n\t\t\t\tdescription:\n\t\t\t\t\t\"Failed to install Neon agent skills automatically. Run these commands to install manually:\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tcommands: cmds,\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 4: Install editor extension if requested\n\t// Use the agent-reported IDE (not agent identity) — e.g. Claude Code running in\n\t// Cursor should install the extension for Cursor, not skip it.\n\tif (installExt) {\n\t\tconst extResult = await installExtensionForIde(options.ide ?? agentId);\n\t\tresults.push(extResult);\n\t}\n\n\t// Step 5: Write selected features to .neon under _init for brownfield flows\n\t// (Bootstrap flows already wrote _init in step 0)\n\tif (!isBootstrap && options.features && options.features.length > 0) {\n\t\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\t\tconst context: Record<string, unknown> = {\n\t\t\t_init: { features: options.features },\n\t\t};\n\t\twriteFileSync(neonContextPath, `${JSON.stringify(context, null, 2)}\\n`);\n\t}\n\n\tconst allSucceeded = results.every((r) => r.status === \"success\");\n\n\t// Build args to chain to the getting-started phase as a separate CLI call.\n\t// This ensures the agent gets a clean response with ONLY the getting-started\n\t// action — no competing \"results\" array to distract it.\n\tconst gettingStartedData: Record<string, unknown> = {};\n\tif (options.connectionString) gettingStartedData.hasConnectionString = true;\n\tif (options.framework) gettingStartedData.framework = options.framework;\n\tif (options.orm) gettingStartedData.orm = options.orm;\n\tif (options.migrationTool)\n\t\tgettingStartedData.migrationTool = options.migrationTool;\n\tif (options.migrationDir)\n\t\tgettingStartedData.migrationDir = options.migrationDir;\n\t// Pass features so getting-started knows which phases to chain to\n\tconst resolvedFeatures = options.templateRequires ?? options.features;\n\tif (resolvedFeatures && resolvedFeatures.length > 0)\n\t\tgettingStartedData.features = resolvedFeatures;\n\t// Bootstrap implies preview mode (new project in us-east required)\n\tif (isBootstrap) gettingStartedData.preview = true;\n\tconst gettingStartedArgs = [\n\t\t\"getting-started\",\n\t\t\"--json\",\n\t\t\"--data\",\n\t\tJSON.stringify(gettingStartedData),\n\t];\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: allSucceeded ? \"installed\" : \"partial\",\n\t\tresults,\n\t\tnextAction: {\n\t\t\ttype: \"run_neon_init\",\n\t\t\targs: gettingStartedArgs,\n\t\t},\n\t};\n}\n\nfunction buildInspectionArgs(options: SetupPhaseOptions): string[] {\n\tconst args: string[] = [];\n\tif (options.mcpConfigured !== null && options.mcpConfigured !== undefined) {\n\t\targs.push(\"--mcp-configured\", options.mcpConfigured ? \"true\" : \"false\");\n\t}\n\tif (\n\t\toptions.connectionString !== null &&\n\t\toptions.connectionString !== undefined\n\t) {\n\t\targs.push(\n\t\t\t\"--connection-string\",\n\t\t\toptions.connectionString ? \"true\" : \"false\",\n\t\t);\n\t}\n\tif (options.framework) {\n\t\targs.push(\"--framework\", options.framework);\n\t}\n\tif (options.orm) {\n\t\targs.push(\"--orm\", options.orm);\n\t}\n\tif (options.migrationTool) {\n\t\targs.push(\"--migration-tool\", options.migrationTool);\n\t}\n\tif (options.migrationDir) {\n\t\targs.push(\"--migration-dir\", options.migrationDir);\n\t}\n\tif (options.isVscodeIde !== null && options.isVscodeIde !== undefined) {\n\t\targs.push(\"--is-vscode-ide\", options.isVscodeIde ? \"true\" : \"false\");\n\t}\n\treturn args;\n}\n\n/**\n * Fills in missing filesystem inspection fields by running inspectProject().\n * Agent-reported data (mcpConfigured, agent, mode, scopes) is preserved.\n * CLI-detectable fields (framework, orm, migrations, connectionString, isVscodeIde)\n * are filled in only if not already present.\n */\nasync function mergeCliInspection(\n\toptions: SetupPhaseOptions,\n): Promise<SetupPhaseOptions> {\n\t// If the agent already provided these, no need to re-inspect\n\tif (options.framework !== undefined && options.orm !== undefined) {\n\t\treturn options;\n\t}\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"connection_string\", description: \"\", lookFor: [] },\n\t\t{ id: \"project_stack\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t\t{ id: \"ide_type\", description: \"\", lookFor: [] },\n\t]);\n\n\t// Also detect IDE if not already reported by the agent\n\tconst ide =\n\t\toptions.ide?.toLowerCase().replace(/\\s+/g, \"-\") ||\n\t\tdetectIde()?.toLowerCase().replace(/\\s+/g, \"-\") ||\n\t\tundefined;\n\n\treturn {\n\t\t...options,\n\t\tide,\n\t\tconnectionString:\n\t\t\toptions.connectionString ??\n\t\t\t(inspection.connectionString as boolean | undefined),\n\t\tframework:\n\t\t\toptions.framework ?? (inspection.framework as string | undefined),\n\t\torm: options.orm ?? (inspection.orm as string | undefined),\n\t\tmigrationTool:\n\t\t\toptions.migrationTool ??\n\t\t\t(inspection.migrationTool as string | undefined),\n\t\tmigrationDir:\n\t\t\toptions.migrationDir ??\n\t\t\t(inspection.migrationDir as string | undefined),\n\t\tisVscodeIde:\n\t\t\toptions.isVscodeIde ??\n\t\t\t(inspection.isVscodeIde as boolean | undefined),\n\t};\n}\n\n/**\n * Checks whether the user is in a VS Code-based IDE that supports extensions.\n * Uses agent-reported `ide` field first, then falls back to `isVscodeIde` from inspection.\n */\nfunction isCursorAgent(options: SetupPhaseOptions): boolean {\n\tconst ide = options.ide?.toLowerCase();\n\tif (ide === \"cursor\") return true;\n\tconst agent = options.agent?.toLowerCase();\n\tif (agent === \"cursor\") return true;\n\treturn false;\n}\n\nfunction isVscodeBasedIde(options: SetupPhaseOptions): boolean {\n\tif (options.ide) {\n\t\tconst ide = options.ide.toLowerCase();\n\t\treturn (\n\t\t\tide === \"cursor\" ||\n\t\t\tide === \"vscode\" ||\n\t\t\tide === \"vs-code\" ||\n\t\t\tide === \"windsurf\"\n\t\t);\n\t}\n\treturn options.isVscodeIde === true;\n}\n\n/**\n * Resolves which IDE to install the extension for.\n * Accepts the agent-reported IDE value (preferred), the agent ID, or\n * falls back to env-var detection.\n */\nfunction resolveEditorForExtension(ideOrAgentId: string): Editor | null {\n\t// Map known IDE/agent identifiers to Editor types\n\tswitch (ideOrAgentId.toLowerCase()) {\n\t\tcase \"cursor\":\n\t\t\treturn \"Cursor\";\n\t\tcase \"vscode\":\n\t\tcase \"vs-code\":\n\t\tcase \"copilot\":\n\t\tcase \"github-copilot\":\n\t\tcase \"github-copilot-cli\":\n\t\t\treturn \"VS Code\";\n\t\tdefault:\n\t\t\tbreak;\n\t}\n\n\t// Fall back to env-var detection\n\tconst ide = detectIde();\n\tif (ide === \"Cursor\" || ide === \"VS Code\") return ide;\n\n\treturn null;\n}\n\nconst MANUAL_INSTALL_MSG = `Search for \"Neon\" in the extensions panel (Cmd+Shift+X / Ctrl+Shift+X) and install \"Neon Local Connect\" by Databricks.`;\n\n/**\n * Installs the Neon extension for the detected IDE.\n *\n * Uses env-var detection to determine the IDE (not the agent identity),\n * so Claude Code running in Cursor correctly installs for Cursor.\n *\n * Strategy:\n * 1. Try `<editor> --install-extension <id>` directly (uses editor's configured marketplace)\n * 2. If that fails, download .vsix (from proxy or Open VSX) and install via local file\n * 3. If all else fails: return manual install instructions\n */\nasync function installExtensionForIde(agentId: string): Promise<InstallResult> {\n\tconst editorType = resolveEditorForExtension(agentId);\n\tif (!editorType) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\tconst editorCmd = await findEditorCommand(editorType);\n\tif (!editorCmd) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\t// Try direct marketplace install first (works if editor has marketplace configured)\n\ttry {\n\t\tawait execa(editorCmd, [\"--install-extension\", NEON_EXTENSION_ID], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: `Installed Neon extension for ${editorType}`,\n\t\t\tstatus: \"success\",\n\t\t};\n\t} catch {\n\t\t// Fall through to VSIX download approach\n\t}\n\n\t// Download .vsix and install locally\n\tconst vsixPath = await downloadVsix();\n\tif (!vsixPath) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\ttry {\n\t\tawait execa(editorCmd, [\"--install-extension\", vsixPath], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: `Installed Neon extension for ${editorType}`,\n\t\t\tstatus: \"success\",\n\t\t};\n\t} catch {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t} finally {\n\t\ttry {\n\t\t\tawait unlink(vsixPath);\n\t\t} catch {}\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"setup.js","names":[],"sources":["../../../src/lib/phases/setup.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { execa } from \"execa\";\nimport { resolveAddMcpAgentId } from \"../agents.js\";\nimport {\n\tFALLBACK_TEMPLATES,\n\tfetchTemplates,\n\tfindTemplate,\n\ttype NeonFeature,\n\tscaffoldTemplate,\n} from \"../bootstrap.js\";\nimport {\n\tdetectIde,\n\tisCursorInstalled,\n\tisVSCodeInstalled,\n} from \"../detect-agent.js\";\nimport { findEditorCommand } from \"../extension.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport { ensureNeonctl } from \"../neonctl.js\";\nimport { ensureSkillsUpToDate } from \"../skills.js\";\nimport type { Editor, PhaseResponse } from \"../types.js\";\nimport { downloadVsix, NEON_EXTENSION_ID } from \"../vsix.js\";\n\nexport interface SetupPhaseOptions {\n\tagent?: string;\n\t/** The IDE/editor the user is running in (e.g. \"cursor\", \"vscode\") — reported by agent */\n\tide?: string;\n\t/** Enable preview skills (neon-object-storage, neon-functions, neon-ai-gateway) */\n\tpreview?: boolean;\n\t/** Whether the directory already contains an application */\n\thasApp?: boolean;\n\t/** Template ID to scaffold (when bootstrapping a new project) */\n\ttemplate?: string;\n\t/** Neon features required by the selected template */\n\ttemplateRequires?: NeonFeature[];\n\t/** Neon features selected by the user (brownfield flows) */\n\tfeatures?: NeonFeature[];\n\t// Inspection results — pre-filled by orchestrator or reported by agent\n\tmcpConfigured?: boolean | null;\n\tskillsInstalled?: boolean | null;\n\tconnectionString?: boolean | null;\n\tconnectionParams?: string; // JSON with host/dbname/etc if found\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\tisVscodeIde?: boolean | null;\n\t// User preferences (also used for pre-detected scope from inspection)\n\tmode?: string;\n\tmcpScope?: string;\n\tskillsScope?: string;\n\tinstallExtension?: boolean;\n\t// Execution flags\n\texecute?: boolean;\n}\n\n/**\n * Comprehensive setup phase: inspects repo state, collects user preferences,\n * then batches all installation commands together.\n *\n * With --data JSON, the agent sends inspection results AND user preferences\n * in a single call, so the CLI can go straight to installation.\n */\nexport async function handleSetupPhase(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\t// Parse features from comma-separated string (e.g. \"database,auth\" from agent --data)\n\tif (typeof options.features === \"string\") {\n\t\toptions.features = (options.features as unknown as string)\n\t\t\t.split(\",\")\n\t\t\t.map((f) => f.trim()) as NeonFeature[];\n\t}\n\n\t// Treat \"none\" as no template selected\n\tconst templateWasAnswered = options.template !== undefined;\n\tif (options.template === \"none\") {\n\t\toptions.template = undefined;\n\t}\n\n\t// Resolve template requirements if a template was selected but requires not yet populated\n\tif (options.template && !options.templateRequires) {\n\t\tconst templates = await fetchTemplates();\n\t\tconst selected = templates.find((t) => t.id === options.template);\n\t\tif (selected) {\n\t\t\toptions.templateRequires = selected.requires;\n\t\t}\n\t}\n\n\t// --execute: run the batched installation (legacy path)\n\tif (options.execute) {\n\t\treturn executeBatchedInstallation(await mergeCliInspection(options));\n\t}\n\n\t// Treat any explicit mode value that isn't \"customize\"/\"custom\" as defaults.\n\t// Also treat as defaults when mode is missing but agent reported back\n\t// (template was answered, nothing left to customize).\n\tconst hasReportedBack = options.mode || templateWasAnswered;\n\tif (\n\t\thasReportedBack &&\n\t\toptions.mode !== \"customize\" &&\n\t\toptions.mode !== \"custom\"\n\t) {\n\t\tconst merged = await mergeCliInspection(options);\n\t\tconst shouldInstallExt =\n\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\treturn executeBatchedInstallation({\n\t\t\t...merged,\n\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\tinstallExtension: shouldInstallExt,\n\t\t});\n\t}\n\n\t// User chose \"customize\" (also accept \"custom\" — agents sometimes truncate)\n\tif (options.mode === \"customize\" || options.mode === \"custom\") {\n\t\tconst merged = await mergeCliInspection(options);\n\t\tconst shouldInstallExt =\n\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\treturn executeBatchedInstallation({\n\t\t\t...merged,\n\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\tinstallExtension: shouldInstallExt,\n\t\t});\n\t}\n\n\t// Default: send inspection checks with user preferences (all in one response)\n\treturn buildBulkInspection(options);\n}\n\nfunction buildTemplatePreference(\n\ttemplates: {\n\t\tid: string;\n\t\ttitle: string;\n\t\tdescription: string;\n\t\ttools?: string[];\n\t}[],\n) {\n\treturn [\n\t\t{\n\t\t\tid: \"template\",\n\t\t\tquestion:\n\t\t\t\t\"No application was detected in this directory. Would you like to scaffold a new project from a template?\",\n\t\t\tphase: \"before_checks\" as const,\n\t\t\toptions: [\n\t\t\t\t...templates.map((t) => {\n\t\t\t\t\tconst tools =\n\t\t\t\t\t\tt.tools && t.tools.length > 0\n\t\t\t\t\t\t\t? ` (${t.tools.join(\", \")})`\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\treturn {\n\t\t\t\t\t\tvalue: t.id,\n\t\t\t\t\t\tlabel: `${t.title}${tools} — ${t.description}`,\n\t\t\t\t\t};\n\t\t\t\t}),\n\t\t\t\t{\n\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\tlabel: \"No thanks — continue without scaffolding\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tdefault: \"none\",\n\t\t},\n\t];\n}\n\nasync function buildBulkInspection(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst hasApp = options.hasApp !== false;\n\tconst detectedIde = detectIde();\n\n\t// If no IDE detected (e.g. standalone terminal), check what's installed\n\tconst installedEditors: string[] = [];\n\tif (!detectedIde) {\n\t\tif (isCursorInstalled()) installedEditors.push(\"cursor\");\n\t\tif (isVSCodeInstalled()) installedEditors.push(\"vscode\");\n\t}\n\n\t// Fetch available templates when no app is detected\n\tlet templatePreferences: ReturnType<typeof buildTemplatePreference> = [];\n\tif (!hasApp) {\n\t\tlet templates = FALLBACK_TEMPLATES;\n\t\ttry {\n\t\t\tconst fetched = await fetchTemplates();\n\t\t\tif (fetched && fetched.length > 0) templates = fetched;\n\t\t} catch {}\n\t\ttemplatePreferences = buildTemplatePreference(templates);\n\t}\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: hasApp ? \"pending\" : \"bootstrap_needed\",\n\t\tdetectedIde: detectedIde?.toLowerCase() ?? null,\n\t\tinstalledEditors: installedEditors.length > 0 ? installedEditors : null,\n\t\t// Pre-detected state from filesystem inspection\n\t\tmcpConfigured: options.mcpConfigured ?? null,\n\t\tmcpScope: options.mcpScope ?? null,\n\t\tskillsInstalled: options.skillsInstalled ?? null,\n\t\tskillsScope: options.skillsScope ?? null,\n\t\tnextAction: {\n\t\t\ttype: \"agent_check\",\n\t\t\tinstructions: [\n\t\t\t\t\"IMPORTANT: Do NOT summarize this response or ask the user for consent/confirmation before starting. Proceed IMMEDIATELY with the first userPreference question.\",\n\t\t\t\t\"\",\n\t\t\t\thasApp\n\t\t\t\t\t? \"Perform the agent checks listed above (MCP server status and your agent identity), then present each userPreference question to the user ONE AT A TIME, in order. Wait for the user's answer before showing the next question. Respect the `condition` field — only show a question if its condition is met.\"\n\t\t\t\t\t: \"No application was detected in this directory. Ask the user if they'd like to scaffold a new project from a template (the `template` preference). Present ALL template options and the 'No thanks' option — do NOT auto-select even if there is only one template. If the user selects a template, the scaffolded template includes agent skills so skills installation will be skipped. If the user chooses 'none', continue with the remaining setup preferences normally. Then perform the agent checks and present the remaining preferences ONE AT A TIME.\",\n\t\t\t\t\"\",\n\t\t\t\t`The CLI has pre-detected the following from the filesystem: MCP server: ${options.mcpConfigured ? `configured (${options.mcpScope})` : \"not configured\"}. Agent skills: ${options.skillsInstalled ? `installed (${options.skillsScope})` : String(options.skillsScope ?? \"\").includes(\"partial\") ? `partially installed (${options.skillsScope}) — missing skills will be auto-installed to the same scope` : \"not installed\"}. Report these findings to the user before asking preferences. Only ask about scope/options for components that are NOT already configured. Do NOT ask about skills scope if skills are partially installed — they will be completed automatically.`,\n\t\t\t\t\"\",\n\t\t\t\t\"IMPORTANT (Cursor users): Cursor disables project-level MCP servers by default as a security measure. If the user is in Cursor and chooses project-level MCP scope, warn them that they will need to manually enable the Neon server in Cursor Settings > MCP after installation. Recommend global scope for Cursor to avoid this extra step.\",\n\t\t\t\t\"\",\n\t\t\t\t\"GROUPING: Preferences that share the same `group` field should be presented together in a single message (e.g. list all customize options at once and let the user answer them together). Preferences without a `group` must be asked individually.\",\n\t\t\t\t\"\",\n\t\t\t\tdetectedIde\n\t\t\t\t\t? `The CLI has detected the IDE as: ${detectedIde.toLowerCase()}. Include this as the \"ide\" field in your reportBack data. IMPORTANT: The IDE and the agent are different — you may be Claude Code (agent) running inside Cursor (IDE). The extension installs into the IDE, so if the IDE is Cursor/VS Code/Windsurf, the extension IS applicable even if you are Claude Code.`\n\t\t\t\t\t: installedEditors.length > 0\n\t\t\t\t\t\t? `No IDE detected, but the following editors are installed: ${installedEditors.join(\", \")}. The \"installedEditors\" field in this response lists them. If the user wants the extension installed, ask which editor to install it for and include that as the \"ide\" field in your reportBack data. If not, set \"ide\" to \"none\".`\n\t\t\t\t\t\t: `No IDE or supported editors detected. Set \"ide\" to \"none\" in your reportBack data.`,\n\t\t\t\t\"\",\n\t\t\t\t\"After all questions are answered, call reportBack with a single --data JSON containing: agent, ide, mcpConfigured, and all preference answers. The CLI will inspect the project and merge results automatically.\",\n\t\t\t].join(\"\\n\"),\n\t\t\tchecks: [\n\t\t\t\t{\n\t\t\t\t\tid: \"neonctl\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"The neonctl CLI will be installed or updated automatically (no action needed from the agent)\",\n\t\t\t\t\tlookFor: [],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"mcp_server\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Check if the Neon MCP server is already configured in your MCP server list\",\n\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\"An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"agent_type\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Identify which coding agent is running this command\",\n\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\"Determine which agent you are: cursor, claude-code, copilot, vscode, windsurf, codex, cline, gemini-cli, goose, opencode, or antigravity\",\n\t\t\t\t\t\t\"Report your own agent identifier — this is used to configure the MCP server for the correct tool\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...(detectedIde\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"extension_installed\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Check if the Neon editor extension (databricks.neon-local-connect) is already installed in the IDE (NOT the agent — e.g. if you are Claude Code running inside Cursor, check Cursor's extensions)\",\n\t\t\t\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\t\t\t\"Run the IDE's --list-extensions command or check installed extensions for 'databricks.neon-local-connect' or 'Neon Local Connect'\",\n\t\t\t\t\t\t\t\t\t\"If the extension is found, set installExtension to false in your reportBack data and SKIP the installExtension question\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t],\n\t\t\tuserPreferences: [\n\t\t\t\t...templatePreferences,\n\t\t\t\t// For brownfield flows, ask which Neon features to enable\n\t\t\t\t...(hasApp\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"features\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"Which Neon features would you like to enable for this project?\",\n\t\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"database\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Database (always included)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"database,auth\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Database + Neon Auth (adds authentication via Neon)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdefault: \"database\",\n\t\t\t\t\t\t\t\tcontext:\n\t\t\t\t\t\t\t\t\t\"Database connectivity is always set up. Neon Auth adds user authentication powered by Neon. More features (Functions, AI Gateway, Object Storage) will be available soon.\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t// Only show defaults/customize when there's something to customize:\n\t\t\t\t// MCP not configured, skills need scope choice, or extension not detected.\n\t\t\t\t...(() => {\n\t\t\t\t\tconst isPartialSkills = String(\n\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t).includes(\"partial\");\n\t\t\t\t\tconst needsMcpChoice = !options.mcpConfigured;\n\t\t\t\t\tconst needsSkillsChoice =\n\t\t\t\t\t\t!options.skillsInstalled && !isPartialSkills;\n\t\t\t\t\tconst hasCustomizableOptions =\n\t\t\t\t\t\tneedsMcpChoice || needsSkillsChoice;\n\t\t\t\t\tif (!hasCustomizableOptions) return [];\n\t\t\t\t\treturn [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"mode\",\n\t\t\t\t\t\t\tquestion: \"Use default settings or customize?\",\n\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\t\t\t\t\tlabel: hasApp\n\t\t\t\t\t\t\t\t\t\t? \"Use defaults (neonctl CLI, MCP: global, skills: project-level, extension if applicable — already-configured components will be skipped)\"\n\t\t\t\t\t\t\t\t\t\t: \"Use defaults (neonctl CLI, MCP: global, extension if applicable — skills included in template)\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tdefault: \"defaults\",\n\t\t\t\t\t\t},\n\t\t\t\t\t];\n\t\t\t\t})(),\n\t\t\t\t{\n\t\t\t\t\tid: \"mcpScope\",\n\t\t\t\t\tquestion: \"Where should the Neon MCP server be configured?\",\n\t\t\t\t\tcontext:\n\t\t\t\t\t\t\"SKIP this question entirely if the mcp_server check found it is already configured. Only ask if MCP is NOT yet configured. NOTE: Cursor disables project-level MCP servers by default — if the user is in Cursor, recommend global scope or warn that they will need to manually enable the server in Cursor Settings > MCP.\",\n\t\t\t\t\tphase: \"after_checks\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\tlabel: \"Project-level (scoped to this project only)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"none\",\n\t\t\t\t\t\t\tlabel: \"Skip — do not install the MCP server\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"global\",\n\t\t\t\t\tcondition: { preferenceId: \"mode\", equals: \"customize\" },\n\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t},\n\t\t\t\t// Show skills scope when skills aren't detected and no partial install exists.\n\t\t\t\t// Partial installations are auto-completed to the same scope silently.\n\t\t\t\t...(!options.skillsInstalled &&\n\t\t\t\t!String(options.skillsScope ?? \"\").includes(\"partial\")\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"skillsScope\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"Where should Neon agent skills be installed?\",\n\t\t\t\t\t\t\t\tcontext:\n\t\t\t\t\t\t\t\t\t\"Only ask if skills are not already installed.\",\n\t\t\t\t\t\t\t\tphase: \"after_checks\" as const,\n\t\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"global\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Global (available in all projects)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tvalue: \"project\",\n\t\t\t\t\t\t\t\t\t\tlabel: \"Project-level (scoped to this project only)\",\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\tdefault: \"project\",\n\t\t\t\t\t\t\t\tcondition: {\n\t\t\t\t\t\t\t\t\tpreferenceId: \"mode\",\n\t\t\t\t\t\t\t\t\tequals: \"customize\",\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t]\n\t\t\t\t\t: []),\n\t\t\t\t{\n\t\t\t\t\tid: \"installExtension\",\n\t\t\t\t\tquestion:\n\t\t\t\t\t\t\"Install the Neon editor extension for local database browsing?\",\n\t\t\t\t\tphase: \"after_checks\",\n\t\t\t\t\toptions: [\n\t\t\t\t\t\t{ value: \"true\", label: \"Yes\" },\n\t\t\t\t\t\t{ value: \"false\", label: \"No\" },\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"true\",\n\t\t\t\t\tcontext:\n\t\t\t\t\t\t\"The extension installs into the IDE, NOT the agent. If the CLI detected the IDE (see detectedIde field), use that — e.g. Claude Code running inside Cursor means the IDE is Cursor and the extension IS applicable. Only applicable for VS Code-based IDEs (VS Code, Cursor, Windsurf). SKIP this question if the user is NOT in a VS Code-based IDE, or if the extension_installed check found it is already installed. Set installExtension to false in reportBack if skipped.\",\n\t\t\t\t\tcondition: { preferenceId: \"mode\", equals: \"customize\" },\n\t\t\t\t\tgroup: \"customize\",\n\t\t\t\t},\n\t\t\t],\n\t\t\treportBack: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\n\t\t\t\t\t\"setup\",\n\t\t\t\t\t\"--json\",\n\t\t\t\t\t\"--data\",\n\t\t\t\t\t(() => {\n\t\t\t\t\t\tconst partialScope = String(\n\t\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t\t).replace(\"-partial\", \"\");\n\t\t\t\t\t\tconst hasPartial = String(\n\t\t\t\t\t\t\toptions.skillsScope ?? \"\",\n\t\t\t\t\t\t).includes(\"partial\");\n\t\t\t\t\t\tconst previewFlag = options.preview\n\t\t\t\t\t\t\t? \", preview: true\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst needsMcpChoice = !options.mcpConfigured;\n\t\t\t\t\t\tconst needsSkillsChoice =\n\t\t\t\t\t\t\t!options.skillsInstalled && !hasPartial;\n\t\t\t\t\t\tconst hasModeQuestion =\n\t\t\t\t\t\t\tneedsMcpChoice || needsSkillsChoice;\n\t\t\t\t\t\tconst modeField = hasModeQuestion\n\t\t\t\t\t\t\t? \", mode: string\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst mcpField = hasModeQuestion\n\t\t\t\t\t\t\t? \", mcpScope?: 'global'|'project'|'none'\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst skillsField = needsSkillsChoice\n\t\t\t\t\t\t\t? \", skillsScope?: string\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst extField = hasModeQuestion\n\t\t\t\t\t\t\t? \", installExtension?: bool\"\n\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\tconst prefilledSkills =\n\t\t\t\t\t\t\toptions.skillsInstalled || hasPartial\n\t\t\t\t\t\t\t\t? `, skillsScope: \"${options.skillsInstalled ? options.skillsScope || \"project\" : partialScope}\"`\n\t\t\t\t\t\t\t\t: skillsField;\n\t\t\t\t\t\treturn `<json: { agent: string, ide: string, mcpConfigured: bool${prefilledSkills}${previewFlag}${modeField}${mcpField}${extField}${hasApp ? \", features?: string\" : \", template: string\"} }>`;\n\t\t\t\t\t})(),\n\t\t\t\t],\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction _buildModeQuestion(options: SetupPhaseOptions): PhaseResponse {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\n\t// Build a context summary from what the agent found\n\tconst findings: string[] = [];\n\tif (options.mcpConfigured) {\n\t\tfindings.push(\n\t\t\t\"Neon MCP server is already configured (will be upgraded to evergreen)\",\n\t\t);\n\t} else {\n\t\tfindings.push(\"Neon MCP server is not configured\");\n\t}\n\tif (options.connectionString) {\n\t\tfindings.push(\"A Neon connection string was found in the project\");\n\t} else {\n\t\tfindings.push(\"No Neon connection string found — will need to add one\");\n\t}\n\tif (options.framework && options.framework !== \"none\") {\n\t\tfindings.push(`Framework detected: ${options.framework}`);\n\t}\n\tif (options.orm && options.orm !== \"none\") {\n\t\tfindings.push(`ORM detected: ${options.orm}`);\n\t}\n\tif (options.migrationTool && options.migrationTool !== \"none\") {\n\t\tfindings.push(`Migration tool detected: ${options.migrationTool}`);\n\t}\n\tif (options.isVscodeIde) {\n\t\tfindings.push(\"VS Code-based IDE detected — Neon extension available\");\n\t}\n\n\tconst inspectionArgs = buildInspectionArgs(options);\n\n\t// Build defaults label showing only what will be installed\n\tconst defaultsParts: string[] = [\"neonctl CLI\"];\n\tif (!options.mcpConfigured) defaultsParts.push(\"MCP global\");\n\tdefaultsParts.push(\"skills in project\");\n\tif (options.isVscodeIde) defaultsParts.push(\"install extension\");\n\tconst defaultsLabel =\n\t\tdefaultsParts.length > 0\n\t\t\t? `Use defaults (${defaultsParts.join(\", \")})`\n\t\t\t: \"Use defaults\";\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"preferences_needed\",\n\t\tinspection: {\n\t\t\tmcpConfigured: options.mcpConfigured,\n\t\t\tconnectionString: options.connectionString,\n\t\t\tframework: options.framework,\n\t\t\torm: options.orm,\n\t\t\tmigrationTool: options.migrationTool,\n\t\t\tmigrationDir: options.migrationDir,\n\t\t\tisVscodeIde: options.isVscodeIde,\n\t\t},\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion: \"Use default settings or customize?\",\n\t\t\toptions: [\n\t\t\t\t{\n\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\tlabel: defaultsLabel,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tcontext: `Project inspection results:\\n${findings.map((f) => `- ${f}`).join(\"\\n\")}`,\n\t\t\tresponseMapping: {\n\t\t\t\tdefaults: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"setup\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...agentArgs,\n\t\t\t\t\t\t...inspectionArgs,\n\t\t\t\t\t\t\"--mode\",\n\t\t\t\t\t\t\"defaults\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tcustomize: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"setup\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...agentArgs,\n\t\t\t\t\t\t...inspectionArgs,\n\t\t\t\t\t\t\"--mode\",\n\t\t\t\t\t\t\"customize\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction _buildCustomizeQuestions(options: SetupPhaseOptions): PhaseResponse {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\tconst inspectionArgs = buildInspectionArgs(options);\n\n\tconst needsMcp = !options.mcpConfigured;\n\tconst mcpScopes = needsMcp ? [\"global\", \"project\", \"none\"] : [\"skip\"];\n\tconst skillsScopes = [\"global\", \"project\"];\n\tconst extOptions = options.isVscodeIde ? [\"ext\", \"noext\"] : [\"ext\"];\n\n\t// Build all combinations of configurable options\n\tconst customOptions: { value: string; label: string }[] = [];\n\tfor (const mcp of mcpScopes) {\n\t\tfor (const skills of skillsScopes) {\n\t\t\tfor (const ext of extOptions) {\n\t\t\t\tconst parts: string[] = [];\n\t\t\t\tif (mcp === \"none\") parts.push(\"Skip MCP\");\n\t\t\t\telse if (mcp !== \"skip\") parts.push(`MCP: ${mcp}`);\n\t\t\t\tif (skills !== \"skip\")\n\t\t\t\t\tparts.push(\n\t\t\t\t\t\t`Skills: ${skills === \"project\" ? \"project-level\" : skills}`,\n\t\t\t\t\t);\n\t\t\t\tif (options.isVscodeIde) {\n\t\t\t\t\tparts.push(\n\t\t\t\t\t\text === \"ext\" ? \"Install extension\" : \"Skip extension\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcustomOptions.push({\n\t\t\t\t\tvalue: `${mcp}_${skills}_${ext}`,\n\t\t\t\t\tlabel: parts.join(\", \"),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\tconst responseMapping: Record<string, { args: string[] }> = {};\n\n\tfor (const opt of customOptions) {\n\t\tconst parts = opt.value.split(\"_\");\n\t\tconst mcpScope = parts[0] === \"skip\" ? \"global\" : parts[0]; // \"none\" passes through\n\t\tconst skillsScope = parts[1] === \"skip\" ? \"project\" : parts[1];\n\t\tconst installExt = parts[2] === \"ext\";\n\n\t\tresponseMapping[opt.value] = {\n\t\t\targs: [\n\t\t\t\t\"setup\",\n\t\t\t\t\"--json\",\n\t\t\t\t...agentArgs,\n\t\t\t\t...inspectionArgs,\n\t\t\t\t\"--mode\",\n\t\t\t\t\"customize\",\n\t\t\t\t\"--mcp-scope\",\n\t\t\t\tmcpScope,\n\t\t\t\t\"--skills-scope\",\n\t\t\t\tskillsScope,\n\t\t\t\t...(options.isVscodeIde\n\t\t\t\t\t? [\"--install-extension\", installExt ? \"true\" : \"false\"]\n\t\t\t\t\t: []),\n\t\t\t\t\"--execute\",\n\t\t\t],\n\t\t};\n\t}\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"customizing\",\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion: \"Choose your installation configuration:\",\n\t\t\toptions: customOptions,\n\t\t\tcontext:\n\t\t\t\t\"Global scope means settings apply across all your projects. Project-level means settings are scoped to this project only.\" +\n\t\t\t\t(options.mcpConfigured\n\t\t\t\t\t? \"\\nSince Neon tools are already installed, they will be upgraded to the latest evergreen version.\"\n\t\t\t\t\t: \"\") +\n\t\t\t\t(isCursorAgent(options)\n\t\t\t\t\t? \"\\nNote: Cursor disables project-level MCP servers by default. If you choose project scope, you will need to manually enable the Neon server in Cursor Settings > MCP.\"\n\t\t\t\t\t: \"\"),\n\t\t\tresponseMapping,\n\t\t},\n\t};\n}\n\ninterface InstallResult {\n\tid: string;\n\tdescription: string;\n\tstatus: \"success\" | \"failed\";\n\terror?: string;\n\t/** True when the step wasn't automated — the description contains manual instructions for the user */\n\tmanualAction?: boolean;\n\t/** Shell commands the agent can run to complete this step manually */\n\tcommands?: string[];\n}\n\n/**\n * Executes the batched installation of MCP server, skills, and extension.\n * Runs commands directly in the CLI process — the agent does NOT run these.\n * Returns results and chains to the getting-started phase.\n */\nasync function executeBatchedInstallation(\n\toptions: SetupPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst mcpScope = options.mcpScope ?? \"global\";\n\tconst agentId = options.agent ?? \"cursor\";\n\tconst mcpAgentId = resolveAddMcpAgentId(agentId);\n\tconst installExt = options.installExtension === true;\n\n\tconst results: InstallResult[] = [];\n\tconst isBootstrap = !!options.template;\n\n\t// Step 0: Bootstrap project from template if specified\n\tif (isBootstrap && options.template) {\n\t\ttry {\n\t\t\tconst templates = await fetchTemplates();\n\t\t\tconst template =\n\t\t\t\tfindTemplate(templates, options.template) ??\n\t\t\t\tfindTemplate(FALLBACK_TEMPLATES, options.template);\n\t\t\tif (!template) {\n\t\t\t\tthrow new Error(`Unknown template \"${options.template}\".`);\n\t\t\t}\n\t\t\tawait scaffoldTemplate(template, \".\");\n\t\t\tresults.push({\n\t\t\t\tid: \"bootstrap\",\n\t\t\t\tdescription: `Scaffolded project from template \"${options.template}\"`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\n\t\t\t// Write template features to .neon under _init (ephemeral, cleaned up when init completes)\n\t\t\tif (options.templateRequires) {\n\t\t\t\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\t\t\t\tconst context: Record<string, unknown> = {\n\t\t\t\t\t_init: { features: options.templateRequires },\n\t\t\t\t};\n\t\t\t\twriteFileSync(\n\t\t\t\t\tneonContextPath,\n\t\t\t\t\t`${JSON.stringify(context, null, 2)}\\n`,\n\t\t\t\t);\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tresults.push({\n\t\t\t\tid: \"bootstrap\",\n\t\t\t\tdescription: `Failed to scaffold project from template \"${options.template}\"`,\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: err instanceof Error ? err.message : \"Unknown error\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 1: Ensure neonctl CLI is installed and up to date\n\tconst neonctlResult = await ensureNeonctl();\n\tswitch (neonctlResult.status) {\n\t\tcase \"already_current\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `neonctl CLI is up to date (v${neonctlResult.version})`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"installed\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `Installed neonctl CLI (v${neonctlResult.version})`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"updated\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: `Updated neonctl CLI to v${neonctlResult.version}`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t\tbreak;\n\t\tcase \"failed\":\n\t\t\tresults.push({\n\t\t\t\tid: \"neonctl\",\n\t\t\t\tdescription: \"Failed to install neonctl CLI\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: neonctlResult.error,\n\t\t\t});\n\t\t\tbreak;\n\t}\n\n\t// Step 2: Install MCP server (skip if already configured)\n\tconst isCursor =\n\t\tmcpAgentId === \"cursor\" ||\n\t\toptions.ide?.toLowerCase() === \"cursor\" ||\n\t\toptions.agent?.toLowerCase() === \"cursor\";\n\n\tif (mcpScope === \"none\") {\n\t\tresults.push({\n\t\t\tid: \"skip_mcp\",\n\t\t\tdescription: \"Neon MCP server installation skipped by user\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else if (options.mcpConfigured) {\n\t\tresults.push({\n\t\t\tid: \"skip_mcp\",\n\t\t\tdescription: \"Neon MCP server already configured\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else {\n\t\tconst mcpArgs = [\n\t\t\t\"-y\",\n\t\t\t\"add-mcp\",\n\t\t\t\"https://mcp.neon.tech/mcp\",\n\t\t\t...(mcpScope === \"global\" ? [\"-g\"] : []),\n\t\t\t\"-n\",\n\t\t\t\"Neon\",\n\t\t\t\"-y\",\n\t\t\t\"-a\",\n\t\t\tmcpAgentId,\n\t\t];\n\t\ttry {\n\t\t\tawait execa(\"npx\", mcpArgs, { stdio: \"pipe\", timeout: 60000 });\n\t\t\tresults.push({\n\t\t\t\tid: \"install_mcp\",\n\t\t\t\tdescription: `Installed Neon MCP server (${mcpScope} scope)`,\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\n\t\t\t// Some editors disable newly added MCP servers by default.\n\t\t\t// Cursor: project-level servers are always disabled initially.\n\t\t\t// Claude Code: newly added servers require user approval.\n\t\t\tconst isClaudeCode =\n\t\t\t\tmcpAgentId === \"claude-code\" ||\n\t\t\t\toptions.agent?.toLowerCase() === \"claude-code\";\n\n\t\t\tif (isCursor && mcpScope === \"project\") {\n\t\t\t\tresults.push({\n\t\t\t\t\tid: \"enable_mcp\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'Cursor disables project-level MCP servers by default. Open Cursor Settings > MCP and toggle the \"Neon\" server on.',\n\t\t\t\t\tstatus: \"success\",\n\t\t\t\t\tmanualAction: true,\n\t\t\t\t});\n\t\t\t} else if (isClaudeCode) {\n\t\t\t\tresults.push({\n\t\t\t\t\tid: \"enable_mcp\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t'Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" MCP server to enable it. You can check MCP server status with /mcp in Claude Code.',\n\t\t\t\t\tstatus: \"success\",\n\t\t\t\t\tmanualAction: true,\n\t\t\t\t});\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tresults.push({\n\t\t\t\tid: \"install_mcp\",\n\t\t\t\tdescription: \"Failed to install Neon MCP server\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\terror: err instanceof Error ? err.message : \"Unknown error\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 3: Install/update skills (skip when bootstrapping — templates bundle skills)\n\tif (isBootstrap) {\n\t\tresults.push({\n\t\t\tid: \"install_skills\",\n\t\t\tdescription: \"Neon agent skills included in template\",\n\t\t\tstatus: \"success\",\n\t\t});\n\t} else {\n\t\tconst skillsScope = (options.skillsScope ?? \"project\") as\n\t\t\t| \"global\"\n\t\t\t| \"project\";\n\t\tconst skillsOk = await ensureSkillsUpToDate(\n\t\t\tagentId,\n\t\t\tskillsScope,\n\t\t\toptions.preview,\n\t\t);\n\t\tif (skillsOk) {\n\t\t\tresults.push({\n\t\t\t\tid: \"install_skills\",\n\t\t\t\tdescription: \"Neon agent skills installed\",\n\t\t\t\tstatus: \"success\",\n\t\t\t});\n\t\t} else {\n\t\t\t// Build the install commands for the agent to run directly\n\t\t\t// (sandboxed environments may block child process writes)\n\t\t\tconst { getSkillList } = await import(\"../skills.js\");\n\t\t\tconst skillList = getSkillList(options.preview);\n\t\t\tconst cmds = skillList.map(\n\t\t\t\t(s) =>\n\t\t\t\t\t`skills add neondatabase/agent-skills --skill ${s} --agent ${agentId}${skillsScope === \"global\" ? \" -g\" : \"\"} -y`,\n\t\t\t);\n\t\t\tresults.push({\n\t\t\t\tid: \"install_skills\",\n\t\t\t\tdescription:\n\t\t\t\t\t\"Failed to install Neon agent skills automatically. Run these commands to install manually:\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tcommands: cmds,\n\t\t\t});\n\t\t}\n\t}\n\n\t// Step 4: Install editor extension if requested\n\t// Use the agent-reported IDE (not agent identity) — e.g. Claude Code running in\n\t// Cursor should install the extension for Cursor, not skip it.\n\tif (installExt) {\n\t\tconst extResult = await installExtensionForIde(options.ide ?? agentId);\n\t\tresults.push(extResult);\n\t}\n\n\t// Step 5: Write selected features to .neon under _init for brownfield flows\n\t// (Bootstrap flows already wrote _init in step 0)\n\tif (!isBootstrap && options.features && options.features.length > 0) {\n\t\tconst neonContextPath = resolve(process.cwd(), \".neon\");\n\t\tconst context: Record<string, unknown> = {\n\t\t\t_init: { features: options.features },\n\t\t};\n\t\twriteFileSync(neonContextPath, `${JSON.stringify(context, null, 2)}\\n`);\n\t}\n\n\tconst allSucceeded = results.every((r) => r.status === \"success\");\n\n\t// Build args to chain to the getting-started phase as a separate CLI call.\n\t// This ensures the agent gets a clean response with ONLY the getting-started\n\t// action — no competing \"results\" array to distract it.\n\tconst gettingStartedData: Record<string, unknown> = {};\n\tif (options.connectionString) gettingStartedData.hasConnectionString = true;\n\tif (options.framework) gettingStartedData.framework = options.framework;\n\tif (options.orm) gettingStartedData.orm = options.orm;\n\tif (options.migrationTool)\n\t\tgettingStartedData.migrationTool = options.migrationTool;\n\tif (options.migrationDir)\n\t\tgettingStartedData.migrationDir = options.migrationDir;\n\t// Pass features so getting-started knows which phases to chain to\n\tconst resolvedFeatures = options.templateRequires ?? options.features;\n\tif (resolvedFeatures && resolvedFeatures.length > 0)\n\t\tgettingStartedData.features = resolvedFeatures;\n\t// Bootstrap implies preview mode (new project in us-east required)\n\tif (isBootstrap) gettingStartedData.preview = true;\n\tconst gettingStartedArgs = [\n\t\t\"getting-started\",\n\t\t\"--json\",\n\t\t\"--data\",\n\t\tJSON.stringify(gettingStartedData),\n\t];\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: allSucceeded ? \"installed\" : \"partial\",\n\t\tresults,\n\t\tnextAction: {\n\t\t\ttype: \"run_neon_init\",\n\t\t\targs: gettingStartedArgs,\n\t\t},\n\t};\n}\n\nfunction buildInspectionArgs(options: SetupPhaseOptions): string[] {\n\tconst args: string[] = [];\n\tif (options.mcpConfigured !== null && options.mcpConfigured !== undefined) {\n\t\targs.push(\"--mcp-configured\", options.mcpConfigured ? \"true\" : \"false\");\n\t}\n\tif (\n\t\toptions.connectionString !== null &&\n\t\toptions.connectionString !== undefined\n\t) {\n\t\targs.push(\n\t\t\t\"--connection-string\",\n\t\t\toptions.connectionString ? \"true\" : \"false\",\n\t\t);\n\t}\n\tif (options.framework) {\n\t\targs.push(\"--framework\", options.framework);\n\t}\n\tif (options.orm) {\n\t\targs.push(\"--orm\", options.orm);\n\t}\n\tif (options.migrationTool) {\n\t\targs.push(\"--migration-tool\", options.migrationTool);\n\t}\n\tif (options.migrationDir) {\n\t\targs.push(\"--migration-dir\", options.migrationDir);\n\t}\n\tif (options.isVscodeIde !== null && options.isVscodeIde !== undefined) {\n\t\targs.push(\"--is-vscode-ide\", options.isVscodeIde ? \"true\" : \"false\");\n\t}\n\treturn args;\n}\n\n/**\n * Fills in missing filesystem inspection fields by running inspectProject().\n * Agent-reported data (mcpConfigured, agent, mode, scopes) is preserved.\n * CLI-detectable fields (framework, orm, migrations, connectionString, isVscodeIde)\n * are filled in only if not already present.\n */\nasync function mergeCliInspection(\n\toptions: SetupPhaseOptions,\n): Promise<SetupPhaseOptions> {\n\t// If the agent already provided these, no need to re-inspect\n\tif (options.framework !== undefined && options.orm !== undefined) {\n\t\treturn options;\n\t}\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"connection_string\", description: \"\", lookFor: [] },\n\t\t{ id: \"project_stack\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t\t{ id: \"ide_type\", description: \"\", lookFor: [] },\n\t]);\n\n\t// Also detect IDE if not already reported by the agent\n\tconst ide =\n\t\toptions.ide?.toLowerCase().replace(/\\s+/g, \"-\") ||\n\t\tdetectIde()?.toLowerCase().replace(/\\s+/g, \"-\") ||\n\t\tundefined;\n\n\treturn {\n\t\t...options,\n\t\tide,\n\t\tconnectionString:\n\t\t\toptions.connectionString ??\n\t\t\t(inspection.connectionString as boolean | undefined),\n\t\tframework:\n\t\t\toptions.framework ?? (inspection.framework as string | undefined),\n\t\torm: options.orm ?? (inspection.orm as string | undefined),\n\t\tmigrationTool:\n\t\t\toptions.migrationTool ??\n\t\t\t(inspection.migrationTool as string | undefined),\n\t\tmigrationDir:\n\t\t\toptions.migrationDir ??\n\t\t\t(inspection.migrationDir as string | undefined),\n\t\tisVscodeIde:\n\t\t\toptions.isVscodeIde ??\n\t\t\t(inspection.isVscodeIde as boolean | undefined),\n\t};\n}\n\n/**\n * Checks whether the user is in a VS Code-based IDE that supports extensions.\n * Uses agent-reported `ide` field first, then falls back to `isVscodeIde` from inspection.\n */\nfunction isCursorAgent(options: SetupPhaseOptions): boolean {\n\tconst ide = options.ide?.toLowerCase();\n\tif (ide === \"cursor\") return true;\n\tconst agent = options.agent?.toLowerCase();\n\tif (agent === \"cursor\") return true;\n\treturn false;\n}\n\nfunction isVscodeBasedIde(options: SetupPhaseOptions): boolean {\n\tif (options.ide) {\n\t\tconst ide = options.ide.toLowerCase();\n\t\treturn (\n\t\t\tide === \"cursor\" ||\n\t\t\tide === \"vscode\" ||\n\t\t\tide === \"vs-code\" ||\n\t\t\tide === \"windsurf\"\n\t\t);\n\t}\n\treturn options.isVscodeIde === true;\n}\n\n/**\n * Resolves which IDE to install the extension for.\n * Accepts the agent-reported IDE value (preferred), the agent ID, or\n * falls back to env-var detection.\n */\nfunction resolveEditorForExtension(ideOrAgentId: string): Editor | null {\n\t// Map known IDE/agent identifiers to Editor types\n\tswitch (ideOrAgentId.toLowerCase()) {\n\t\tcase \"cursor\":\n\t\t\treturn \"Cursor\";\n\t\tcase \"vscode\":\n\t\tcase \"vs-code\":\n\t\tcase \"copilot\":\n\t\tcase \"github-copilot\":\n\t\tcase \"github-copilot-cli\":\n\t\t\treturn \"VS Code\";\n\t\tdefault:\n\t\t\tbreak;\n\t}\n\n\t// Fall back to env-var detection\n\tconst ide = detectIde();\n\tif (ide === \"Cursor\" || ide === \"VS Code\") return ide;\n\n\treturn null;\n}\n\nconst MANUAL_INSTALL_MSG = `Search for \"Neon\" in the extensions panel (Cmd+Shift+X / Ctrl+Shift+X) and install \"Neon Local Connect\" by Databricks.`;\n\n/**\n * Installs the Neon extension for the detected IDE.\n *\n * Uses env-var detection to determine the IDE (not the agent identity),\n * so Claude Code running in Cursor correctly installs for Cursor.\n *\n * Strategy:\n * 1. Try `<editor> --install-extension <id>` directly (uses editor's configured marketplace)\n * 2. If that fails, download .vsix (from proxy or Open VSX) and install via local file\n * 3. If all else fails: return manual install instructions\n */\nasync function installExtensionForIde(agentId: string): Promise<InstallResult> {\n\tconst editorType = resolveEditorForExtension(agentId);\n\tif (!editorType) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\tconst editorCmd = await findEditorCommand(editorType);\n\tif (!editorCmd) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\t// Try direct marketplace install first (works if editor has marketplace configured)\n\ttry {\n\t\tawait execa(editorCmd, [\"--install-extension\", NEON_EXTENSION_ID], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: `Installed Neon extension for ${editorType}`,\n\t\t\tstatus: \"success\",\n\t\t};\n\t} catch {\n\t\t// Fall through to VSIX download approach\n\t}\n\n\t// Download .vsix and install locally\n\tconst vsixPath = await downloadVsix();\n\tif (!vsixPath) {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t}\n\n\ttry {\n\t\tawait execa(editorCmd, [\"--install-extension\", vsixPath], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: `Installed Neon extension for ${editorType}`,\n\t\t\tstatus: \"success\",\n\t\t};\n\t} catch {\n\t\treturn {\n\t\t\tid: \"install_extension\",\n\t\t\tdescription: MANUAL_INSTALL_MSG,\n\t\t\tstatus: \"success\",\n\t\t\tmanualAction: true,\n\t\t};\n\t} finally {\n\t\ttry {\n\t\t\tawait unlink(vsixPath);\n\t\t} catch {}\n\t}\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon-init",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Initialize Neon projects",
   "keywords": [
     "neon",
@@ -47,6 +47,7 @@
     "vitest": "^3.0.9"
   },
   "dependencies": {
+    "@clack/core": "0.4.2",
     "@clack/prompts": "0.10.1",
     "add-mcp": "^1.5.1",
     "execa": "^9.5.2",