neon-init 0.16.1 → 0.16.3

package/dist/lib/phases/auth.js

@@ -2,8 +2,7 @@ import { isAuthenticated } from "../auth.js";
 import { neonctlCmd } from "../neonctl.js";
 //#region src/lib/phases/auth.ts
 function getSignupUrl() {
-	const base = process.env.NEON_API_HOST?.replace(/\/+$/, "");
-	return base ? `${base}/signup` : "https://console.neon.tech/signup";
+	return process.env.NEON_API_HOST ? `${new URL(process.env.NEON_API_HOST).origin}/signup` : "https://console.neon.tech/signup";
 }
 function getSignupCommands() {
 	const url = getSignupUrl();
@@ -118,6 +117,7 @@ async function handleAuthPhase(options) {
 		status: "required",
 		nextAction: {
 			type: "ask_user",
+			instructions: "IMPORTANT: You MUST present this question to the user and WAIT for their response before proceeding. Do NOT assume the answer or auto-select an option. The user's answer determines the next step.",
 			question: "Do you have an existing Neon account, or do you need to create one?",
 			options: [{
 				value: "existing_account",

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

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":[],"sources":["../../../src/lib/phases/auth.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { neonctlCmd } from \"../neonctl.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nfunction getSignupUrl(): string {\n\tconst base = process.env.NEON_API_HOST?.replace(/\\/+$/, \"\");\n\treturn base ? `${base}/signup` : \"https://console.neon.tech/signup\";\n}\n\nfunction getSignupCommands(): Record<string, string> {\n\tconst url = getSignupUrl();\n\treturn {\n\t\tdarwin: `open ${url}`,\n\t\tlinux: `xdg-open ${url}`,\n\t\twin32: `start ${url}`,\n\t};\n}\n\nexport interface AuthPhaseOptions {\n\tagent?: string;\n\tmethod?: \"existing\" | \"new\";\n\tverify?: boolean;\n}\n\nexport async function handleAuthPhase(\n\toptions: AuthPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst agentArgs = options.agent\n\t\t? [\"--agent\", options.agent, \"--json\"]\n\t\t: [\"--json\"];\n\n\t// --verify: just check if credentials exist\n\tif (options.verify) {\n\t\tconst authed = await isAuthenticated();\n\t\tif (authed) {\n\t\t\t// Continue the flow immediately — don't use \"complete\" which\n\t\t\t// causes agents to stop and get distracted by neonctl output.\n\t\t\treturn {\n\t\t\t\tphase: \"auth\",\n\t\t\t\tstatus: \"verified\",\n\t\t\t\tnextAction: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: agentArgs,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"not_authenticated\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\"auth\", \"--json\"],\n\t\t\t},\n\t\t};\n\t}\n\n\t// Check if already authenticated\n\tconst authed = await isAuthenticated();\n\tif (authed) {\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"verified\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: agentArgs,\n\t\t\t},\n\t\t};\n\t}\n\n\t// --method new: guide through signup\n\tif (options.method === \"new\") {\n\t\tconst openCmd =\n\t\t\tgetSignupCommands()[process.platform] ?? getSignupCommands().linux;\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"in_progress\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"agent_action\",\n\t\t\t\tsteps: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"open_signup\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Open the Neon sign-up page in the user's browser\",\n\t\t\t\t\t\tcommand: openCmd,\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"wait_for_signup\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Tell the user: 'I've opened the Neon sign-up page. Create your account and verify your email, then let me know when you're ready.'\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tonComplete: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"existing\"],\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// --method existing: run OAuth flow\n\tif (options.method === \"existing\") {\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"in_progress\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_command\",\n\t\t\t\tcommand: `${neonctlCmd()} auth`,\n\t\t\t\tdescription:\n\t\t\t\t\t\"This will open your browser for Neon OAuth sign-in.\",\n\t\t\t\ttimeout: 120000,\n\t\t\t\tonSuccess: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\"auth\", \"--json\", \"--verify\"],\n\t\t\t\t},\n\t\t\t\tonFailure: {\n\t\t\t\t\t\"2\": {\n\t\t\t\t\t\ttype: \"ask_user\",\n\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\"The sign-in timed out. Did you complete the sign-in in your browser?\",\n\t\t\t\t\t\toptions: [\"yes_retry\", \"need_help\"],\n\t\t\t\t\t\tresponseMapping: {\n\t\t\t\t\t\t\tyes_retry: {\n\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\"existing\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tneed_help: {\n\t\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"new\"],\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\tother: {\n\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\targs: [\"auth\", \"--json\"],\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// No method specified: ask the user, then launch OAuth directly for\n\t// \"existing account\" without an intermediate CLI round-trip.\n\tconst openCmd =\n\t\tgetSignupCommands()[process.platform] ?? getSignupCommands().linux;\n\treturn {\n\t\tphase: \"auth\",\n\t\tstatus: \"required\",\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion:\n\t\t\t\t\"Do you have an existing Neon account, or do you need to create one?\",\n\t\t\toptions: [\n\t\t\t\t{\n\t\t\t\t\tvalue: \"existing_account\",\n\t\t\t\t\tlabel: \"I have an existing Neon account\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tvalue: \"new_account\",\n\t\t\t\t\tlabel: \"I need to create a new account\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tcontext:\n\t\t\t\t\"Neon is a serverless Postgres provider. A free account is required to continue.\",\n\t\t\tresponseMapping: {\n\t\t\t\texisting_account: {\n\t\t\t\t\taction: {\n\t\t\t\t\t\ttype: \"run_command\",\n\t\t\t\t\t\tcommand: `${neonctlCmd()} auth`,\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"This will open your browser for Neon OAuth sign-in.\",\n\t\t\t\t\t\ttimeout: 120000,\n\t\t\t\t\t\tonSuccess: {\n\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--verify\"],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tonFailure: {\n\t\t\t\t\t\t\t\"2\": {\n\t\t\t\t\t\t\t\ttype: \"ask_user\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"The sign-in timed out. Did you complete the sign-in in your browser?\",\n\t\t\t\t\t\t\t\toptions: [\"yes_retry\", \"need_help\"],\n\t\t\t\t\t\t\t\tresponseMapping: {\n\t\t\t\t\t\t\t\t\tyes_retry: {\n\t\t\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\t\t\"existing\",\n\t\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\tneed_help: {\n\t\t\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\t\t\"new\",\n\t\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},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tother: {\n\t\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\t\targs: [\"auth\", \"--json\"],\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\tnew_account: {\n\t\t\t\t\taction: {\n\t\t\t\t\t\ttype: \"agent_action\",\n\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"open_signup\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Open the Neon sign-up page in the user's browser\",\n\t\t\t\t\t\t\t\tcommand: openCmd,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"wait_for_signup\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Tell the user: 'I've opened the Neon sign-up page. Create your account and verify your email, then let me know when you're ready.'\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tonComplete: {\n\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"existing\"],\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n"],"mappings":"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"}
+{"version":3,"file":"auth.js","names":[],"sources":["../../../src/lib/phases/auth.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { neonctlCmd } from \"../neonctl.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nfunction getSignupUrl(): string {\n\treturn process.env.NEON_API_HOST\n\t\t? `${new URL(process.env.NEON_API_HOST).origin}/signup`\n\t\t: \"https://console.neon.tech/signup\";\n}\n\nfunction getSignupCommands(): Record<string, string> {\n\tconst url = getSignupUrl();\n\treturn {\n\t\tdarwin: `open ${url}`,\n\t\tlinux: `xdg-open ${url}`,\n\t\twin32: `start ${url}`,\n\t};\n}\n\nexport interface AuthPhaseOptions {\n\tagent?: string;\n\tmethod?: \"existing\" | \"new\";\n\tverify?: boolean;\n}\n\nexport async function handleAuthPhase(\n\toptions: AuthPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst agentArgs = options.agent\n\t\t? [\"--agent\", options.agent, \"--json\"]\n\t\t: [\"--json\"];\n\n\t// --verify: just check if credentials exist\n\tif (options.verify) {\n\t\tconst authed = await isAuthenticated();\n\t\tif (authed) {\n\t\t\t// Continue the flow immediately — don't use \"complete\" which\n\t\t\t// causes agents to stop and get distracted by neonctl output.\n\t\t\treturn {\n\t\t\t\tphase: \"auth\",\n\t\t\t\tstatus: \"verified\",\n\t\t\t\tnextAction: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: agentArgs,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"not_authenticated\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\"auth\", \"--json\"],\n\t\t\t},\n\t\t};\n\t}\n\n\t// Check if already authenticated\n\tconst authed = await isAuthenticated();\n\tif (authed) {\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"verified\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: agentArgs,\n\t\t\t},\n\t\t};\n\t}\n\n\t// --method new: guide through signup\n\tif (options.method === \"new\") {\n\t\tconst openCmd =\n\t\t\tgetSignupCommands()[process.platform] ?? getSignupCommands().linux;\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"in_progress\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"agent_action\",\n\t\t\t\tsteps: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"open_signup\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Open the Neon sign-up page in the user's browser\",\n\t\t\t\t\t\tcommand: openCmd,\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"wait_for_signup\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Tell the user: 'I've opened the Neon sign-up page. Create your account and verify your email, then let me know when you're ready.'\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tonComplete: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"existing\"],\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// --method existing: run OAuth flow\n\tif (options.method === \"existing\") {\n\t\treturn {\n\t\t\tphase: \"auth\",\n\t\t\tstatus: \"in_progress\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_command\",\n\t\t\t\tcommand: `${neonctlCmd()} auth`,\n\t\t\t\tdescription:\n\t\t\t\t\t\"This will open your browser for Neon OAuth sign-in.\",\n\t\t\t\ttimeout: 120000,\n\t\t\t\tonSuccess: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\"auth\", \"--json\", \"--verify\"],\n\t\t\t\t},\n\t\t\t\tonFailure: {\n\t\t\t\t\t\"2\": {\n\t\t\t\t\t\ttype: \"ask_user\",\n\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\"The sign-in timed out. Did you complete the sign-in in your browser?\",\n\t\t\t\t\t\toptions: [\"yes_retry\", \"need_help\"],\n\t\t\t\t\t\tresponseMapping: {\n\t\t\t\t\t\t\tyes_retry: {\n\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\"existing\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tneed_help: {\n\t\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"new\"],\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\tother: {\n\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\targs: [\"auth\", \"--json\"],\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// No method specified: ask the user, then launch OAuth directly for\n\t// \"existing account\" without an intermediate CLI round-trip.\n\tconst openCmd =\n\t\tgetSignupCommands()[process.platform] ?? getSignupCommands().linux;\n\treturn {\n\t\tphase: \"auth\",\n\t\tstatus: \"required\",\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tinstructions:\n\t\t\t\t\"IMPORTANT: You MUST present this question to the user and WAIT for their response before proceeding. Do NOT assume the answer or auto-select an option. The user's answer determines the next step.\",\n\t\t\tquestion:\n\t\t\t\t\"Do you have an existing Neon account, or do you need to create one?\",\n\t\t\toptions: [\n\t\t\t\t{\n\t\t\t\t\tvalue: \"existing_account\",\n\t\t\t\t\tlabel: \"I have an existing Neon account\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tvalue: \"new_account\",\n\t\t\t\t\tlabel: \"I need to create a new account\",\n\t\t\t\t},\n\t\t\t],\n\t\t\tcontext:\n\t\t\t\t\"Neon is a serverless Postgres provider. A free account is required to continue.\",\n\t\t\tresponseMapping: {\n\t\t\t\texisting_account: {\n\t\t\t\t\taction: {\n\t\t\t\t\t\ttype: \"run_command\",\n\t\t\t\t\t\tcommand: `${neonctlCmd()} auth`,\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"This will open your browser for Neon OAuth sign-in.\",\n\t\t\t\t\t\ttimeout: 120000,\n\t\t\t\t\t\tonSuccess: {\n\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--verify\"],\n\t\t\t\t\t\t},\n\t\t\t\t\t\tonFailure: {\n\t\t\t\t\t\t\t\"2\": {\n\t\t\t\t\t\t\t\ttype: \"ask_user\",\n\t\t\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\t\t\"The sign-in timed out. Did you complete the sign-in in your browser?\",\n\t\t\t\t\t\t\t\toptions: [\"yes_retry\", \"need_help\"],\n\t\t\t\t\t\t\t\tresponseMapping: {\n\t\t\t\t\t\t\t\t\tyes_retry: {\n\t\t\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\t\t\"existing\",\n\t\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\tneed_help: {\n\t\t\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\t\t\"auth\",\n\t\t\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t\t\t\"--method\",\n\t\t\t\t\t\t\t\t\t\t\t\"new\",\n\t\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},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tother: {\n\t\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\t\targs: [\"auth\", \"--json\"],\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\tnew_account: {\n\t\t\t\t\taction: {\n\t\t\t\t\t\ttype: \"agent_action\",\n\t\t\t\t\t\tsteps: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"open_signup\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Open the Neon sign-up page in the user's browser\",\n\t\t\t\t\t\t\t\tcommand: openCmd,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tid: \"wait_for_signup\",\n\t\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\t\"Tell the user: 'I've opened the Neon sign-up page. Create your account and verify your email, then let me know when you're ready.'\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tonComplete: {\n\t\t\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\t\t\targs: [\"auth\", \"--json\", \"--method\", \"existing\"],\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n"],"mappings":";;;AAIA,SAAS,eAAuB;CAC/B,OAAO,QAAQ,IAAI,gBAChB,GAAG,IAAI,IAAI,QAAQ,IAAI,aAAa,CAAC,CAAC,OAAO,WAC7C;AACJ;AAEA,SAAS,oBAA4C;CACpD,MAAM,MAAM,aAAa;CACzB,OAAO;EACN,QAAQ,QAAQ;EAChB,OAAO,YAAY;EACnB,OAAO,SAAS;CACjB;AACD;AAQA,eAAsB,gBACrB,SACyB;CACzB,MAAM,YAAY,QAAQ,QACvB;EAAC;EAAW,QAAQ;EAAO;CAAQ,IACnC,CAAC,QAAQ;CAGZ,IAAI,QAAQ,QAAQ;EAEnB,IAAI,MADiB,gBAAgB,GAIpC,OAAO;GACN,OAAO;GACP,QAAQ;GACR,YAAY;IACX,MAAM;IACN,MAAM;GACP;EACD;EAED,OAAO;GACN,OAAO;GACP,QAAQ;GACR,YAAY;IACX,MAAM;IACN,MAAM,CAAC,QAAQ,QAAQ;GACxB;EACD;CACD;CAIA,IAAI,MADiB,gBAAgB,GAEpC,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,MAAM;EACP;CACD;CAID,IAAI,QAAQ,WAAW,OAGtB,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,OAAO,CACN;IACC,IAAI;IACJ,aACC;IACD,SAXH,kBAAkB,CAAC,CAAC,QAAQ,aAAa,kBAAkB,CAAC,CAAC;GAY3D,GACA;IACC,IAAI;IACJ,aACC;GACF,CACD;GACA,YAAY;IACX,MAAM;IACN,MAAM;KAAC;KAAQ;KAAU;KAAY;IAAU;GAChD;EACD;CACD;CAID,IAAI,QAAQ,WAAW,YACtB,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,SAAS,GAAG,WAAW,EAAE;GACzB,aACC;GACD,SAAS;GACT,WAAW;IACV,MAAM;IACN,MAAM;KAAC;KAAQ;KAAU;IAAU;GACpC;GACA,WAAW;IACV,KAAK;KACJ,MAAM;KACN,UACC;KACD,SAAS,CAAC,aAAa,WAAW;KAClC,iBAAiB;MAChB,WAAW,EACV,MAAM;OACL;OACA;OACA;OACA;MACD,EACD;MACA,WAAW,EACV,MAAM;OAAC;OAAQ;OAAU;OAAY;MAAK,EAC3C;KACD;IACD;IACA,OAAO;KACN,MAAM;KACN,MAAM,CAAC,QAAQ,QAAQ;IACxB;GACD;EACD;CACD;CAKD,MAAM,UACL,kBAAkB,CAAC,CAAC,QAAQ,aAAa,kBAAkB,CAAC,CAAC;CAC9D,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,cACC;GACD,UACC;GACD,SAAS,CACR;IACC,OAAO;IACP,OAAO;GACR,GACA;IACC,OAAO;IACP,OAAO;GACR,CACD;GACA,SACC;GACD,iBAAiB;IAChB,kBAAkB,EACjB,QAAQ;KACP,MAAM;KACN,SAAS,GAAG,WAAW,EAAE;KACzB,aACC;KACD,SAAS;KACT,WAAW;MACV,MAAM;MACN,MAAM;OAAC;OAAQ;OAAU;MAAU;KACpC;KACA,WAAW;MACV,KAAK;OACJ,MAAM;OACN,UACC;OACD,SAAS,CAAC,aAAa,WAAW;OAClC,iBAAiB;QAChB,WAAW,EACV,MAAM;SACL;SACA;SACA;SACA;QACD,EACD;QACA,WAAW,EACV,MAAM;SACL;SACA;SACA;SACA;QACD,EACD;OACD;MACD;MACA,OAAO;OACN,MAAM;OACN,MAAM,CAAC,QAAQ,QAAQ;MACxB;KACD;IACD,EACD;IACA,aAAa,EACZ,QAAQ;KACP,MAAM;KACN,OAAO,CACN;MACC,IAAI;MACJ,aACC;MACD,SAAS;KACV,GACA;MACC,IAAI;MACJ,aACC;KACF,CACD;KACA,YAAY;MACX,MAAM;MACN,MAAM;OAAC;OAAQ;OAAU;OAAY;MAAU;KAChD;IACD,EACD;GACD;EACD;CACD;AACD"}

package/dist/lib/phases/getting-started.js

@@ -25,8 +25,8 @@ async function handleGettingStartedPhase(options) {
 			id: "select_or_create_project",
 			description: [
 				"List existing Neon projects in the selected organization using the CLI command below (replace <org-id> with the selected org ID).",
-				"IMPORTANT: Preview features require a project in the AWS us-east-2 region created on or after 2026-06-11.",
-				"Filter the project list to ONLY show projects where region_id is 'aws-us-east-2' AND created_at is on or after '2026-06-11'.",
+				"IMPORTANT: Preview features require a project in the AWS us-east-2 region created on or after 2026-06-15.",
+				"Filter the project list to ONLY show projects where region_id is 'aws-us-east-2' AND created_at is on or after '2026-06-15'.",
 				"If eligible projects exist, present them alongside a 'Create new project' option.",
 				"If no eligible projects exist, tell the user and proceed directly to creating a new one.",
 				"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts."

package/dist/lib/phases/getting-started.js.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.js","names":[],"sources":["../../../src/lib/phases/getting-started.ts"],"sourcesContent":["import { neonctlCmd } from \"../neonctl.js\";\nimport { ensureSkillsUpToDate, SKILL_REFERENCE_URLS } from \"../skills.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nexport interface GettingStartedPhaseOptions {\n\tagent?: string;\n\thasConnectionString?: boolean;\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\t/** Neon features required by the project (from .neon or template) */\n\tfeatures?: string[];\n\t/** Preview mode — restricts project creation to new projects in AWS us-east */\n\tpreview?: boolean;\n}\n\n/**\n * Initiates the \"Get started with Neon\" workflow.\n *\n * Steps are concrete and executable — each has a CLI command to run\n * or a specific file operation. The agent should attempt each step\n * in order and actually perform the action using the neonctl CLI.\n */\nexport async function handleGettingStartedPhase(\n\toptions: GettingStartedPhaseOptions,\n): Promise<PhaseResponse> {\n\t// Ensure skills are up to date (no-op if recently updated)\n\tif (options.agent) {\n\t\tawait ensureSkillsUpToDate(options.agent);\n\t}\n\tconst steps: { id: string; description: string; command?: string }[] = [];\n\n\tif (!options.hasConnectionString) {\n\t\tif (options.preview) {\n\t\t\t// Preview mode: new project in AWS us-east-2, or existing eligible project\n\t\t\tsteps.push(\n\t\t\t\t{\n\t\t\t\t\tid: \"select_org\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List the user's Neon organizations using the CLI command below.\",\n\t\t\t\t\t\t\"If only one org exists, use it automatically.\",\n\t\t\t\t\t\t\"If multiple orgs exist, ask the user which one to use.\",\n\t\t\t\t\t\t\"Remember the selected org ID for the next steps.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} orgs list --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"select_or_create_project\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List existing Neon projects in the selected organization using the CLI command below (replace <org-id> with the selected org ID).\",\n\t\t\t\t\t\t\"IMPORTANT: Preview features require a project in the AWS us-east-2 region created on or after 2026-06-11.\",\n\t\t\t\t\t\t\"Filter the project list to ONLY show projects where region_id is 'aws-us-east-2' AND created_at is on or after '2026-06-11'.\",\n\t\t\t\t\t\t\"If eligible projects exist, present them alongside a 'Create new project' option.\",\n\t\t\t\t\t\t\"If no eligible projects exist, tell the user and proceed directly to creating a new one.\",\n\t\t\t\t\t\t\"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects list --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"create_project_if_needed\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"If the user chose to create a new project, create it in the AWS us-east-2 region using the CLI command below (replace <org-id> and <project-name>).\",\n\t\t\t\t\t\t\"Ask the user for a project name (suggest the current directory name).\",\n\t\t\t\t\t\t\"If the user chose an existing eligible project, skip this step.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --region-id aws-us-east-2 --output json`,\n\t\t\t\t},\n\t\t\t);\n\t\t} else {\n\t\t\t// Standard mode: let user choose existing or create new\n\t\t\tsteps.push(\n\t\t\t\t{\n\t\t\t\t\tid: \"select_org\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List the user's Neon organizations using the CLI command below.\",\n\t\t\t\t\t\t\"If only one org exists, use it automatically.\",\n\t\t\t\t\t\t\"If multiple orgs exist, ask the user which one to use.\",\n\t\t\t\t\t\t\"Remember the selected org ID for the next steps.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} orgs list --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"select_or_create_project\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List existing Neon projects in the selected organization using the CLI command below (replace <org-id> with the selected org ID).\",\n\t\t\t\t\t\t\"Ask the user whether they want to use an existing project or create a new one.\",\n\t\t\t\t\t\t\"If creating new, ask the user for a project name (suggest the current directory name).\",\n\t\t\t\t\t\t\"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects list --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"create_project_if_needed\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"If the user chose to create a new project, create it using the CLI command below (replace <org-id> and <project-name>).\",\n\t\t\t\t\t\t\"If the user chose an existing project, skip this step.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\t// Create/update .neon context file\n\t\tsteps.push({\n\t\t\tid: \"create_neon_context\",\n\t\t\tdescription: [\n\t\t\t\t\"Update the .neon context file in the project root with the selected org and project IDs.\",\n\t\t\t\t\"IMPORTANT: If a .neon file already exists, you MUST read it first, then merge the new orgId and projectId into the existing content. Do NOT overwrite the file — other fields (like _init, branch, etc.) must be preserved.\",\n\t\t\t\t\"If no .neon file exists, create one.\",\n\t\t\t\t'The file is JSON. Add/update only the orgId and projectId fields: {\"orgId\": \"<org-id>\", \"projectId\": \"<project-id>\", ...existing fields}.',\n\t\t\t\t\"This file is safe to commit — it contains no secrets.\",\n\t\t\t].join(\" \"),\n\t\t});\n\n\t\t// Install project dependencies (required before env pull — config files may import packages)\n\t\tsteps.push({\n\t\t\tid: \"install_dependencies\",\n\t\t\tdescription: [\n\t\t\t\t\"Check if node_modules exists in the project root.\",\n\t\t\t\t\"If not, install project dependencies using the appropriate package manager (check for pnpm-lock.yaml, yarn.lock, bun.lockb, or default to npm).\",\n\t\t\t\t\"This must be done before `neonctl env pull` because the project's Neon config file may import packages that need to be installed first.\",\n\t\t\t].join(\" \"),\n\t\t\tcommand: \"npm install\",\n\t\t});\n\n\t\t// Pull environment variables (connection string, etc.) from Neon\n\t\tsteps.push({\n\t\t\tid: \"pull_env\",\n\t\t\tdescription: [\n\t\t\t\t\"Now that the .neon context file is in place and dependencies are installed, run `neonctl env pull` to populate the project's environment variables.\",\n\t\t\t\t\"This automatically writes the database connection string (and any other Neon-managed env vars) to the correct env file.\",\n\t\t\t\t\"It reads the .neon context file to determine the project, and writes to the appropriate env file for the project.\",\n\t\t\t\t\"Ensure the target env file is listed in .gitignore.\",\n\t\t\t].join(\" \"),\n\t\t\tcommand: `${neonctlCmd()} env pull`,\n\t\t});\n\n\t\t// Step 6: Install Neon serverless driver if needed\n\t\tif (options.orm === \"prisma\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription: [\n\t\t\t\t\t\"Install the @neondatabase/serverless driver adapter for Prisma.\",\n\t\t\t\t\t\"This enables Prisma to use Neon's serverless driver for edge/serverless deployments.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand:\n\t\t\t\t\t\"npm install @neondatabase/serverless @prisma/adapter-neon\",\n\t\t\t});\n\t\t} else if (options.orm === \"drizzle\" || options.orm === \"drizzle-orm\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription: \"Install the Neon serverless driver for Drizzle.\",\n\t\t\t\tcommand: \"npm install @neondatabase/serverless\",\n\t\t\t});\n\t\t} else if (!options.orm || options.orm === \"none\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription:\n\t\t\t\t\t\"Install the Neon serverless driver for direct database access.\",\n\t\t\t\tcommand: \"npm install @neondatabase/serverless\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Run migrations if applicable\n\tif (options.migrationTool && options.migrationTool !== \"none\") {\n\t\tconst tool = options.migrationTool.toLowerCase();\n\t\tconst migrationDir = options.migrationDir;\n\t\tconst hasMigrationDir = migrationDir && migrationDir !== \"none\";\n\n\t\tif (tool === \"drizzle\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: [\n\t\t\t\t\thasMigrationDir\n\t\t\t\t\t\t? `Check if the ${migrationDir} directory contains .sql migration files.`\n\t\t\t\t\t\t: \"Check if a drizzle migrations directory exists with .sql files.\",\n\t\t\t\t\t\"If .sql files exist, apply them with `npx drizzle-kit migrate`.\",\n\t\t\t\t\t\"If the directory is empty or missing but a drizzle schema file exists (e.g. src/db/schema.ts, drizzle/schema.ts), run `npx drizzle-kit generate` first to create migrations, then `npx drizzle-kit migrate` to apply them.\",\n\t\t\t\t\t\"If neither schema nor migrations exist, skip this step.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand: \"npx drizzle-kit migrate\",\n\t\t\t});\n\t\t} else if (tool === \"prisma\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: [\n\t\t\t\t\thasMigrationDir\n\t\t\t\t\t\t? `Check if the ${migrationDir} directory contains migration folders.`\n\t\t\t\t\t\t: \"Check if prisma/migrations contains migration folders.\",\n\t\t\t\t\t\"If migrations exist, apply them with `npx prisma migrate deploy`.\",\n\t\t\t\t\t\"If the migrations directory is empty or missing but prisma/schema.prisma has models defined, run `npx prisma migrate dev --name init` to create and apply the initial migration.\",\n\t\t\t\t\t\"If no models are defined, skip this step.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand: \"npx prisma migrate deploy\",\n\t\t\t});\n\t\t} else if (tool === \"knex\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: `Apply existing knex migrations to the Neon database.`,\n\t\t\t\tcommand: \"npx knex migrate:latest\",\n\t\t\t});\n\t\t}\n\t} else if (options.preview) {\n\t\t// Bootstrap flow: migration tool wasn't detected because the project was\n\t\t// inspected before scaffolding. Detect and run migrations from the scaffolded template.\n\t\tsteps.push({\n\t\t\tid: \"run_migrations\",\n\t\t\tdescription: [\n\t\t\t\t\"Check the scaffolded project for a migration tool and schema.\",\n\t\t\t\t\"Look for: drizzle.config.ts/js (Drizzle), prisma/schema.prisma (Prisma), or knexfile.ts/js (Knex).\",\n\t\t\t\t\"If Drizzle is found: check if a drizzle migrations directory exists with .sql files. If .sql files exist, run `npx drizzle-kit migrate`. If the directory is empty or missing but a schema file exists, run `npx drizzle-kit generate` first, then `npx drizzle-kit migrate`.\",\n\t\t\t\t\"If Prisma is found: check if prisma/migrations contains migration folders. If yes, run `npx prisma migrate deploy`. If not but models exist, run `npx prisma migrate dev --name init`.\",\n\t\t\t\t\"If no migration tool is found, skip this step.\",\n\t\t\t].join(\" \"),\n\t\t});\n\t}\n\n\t// Verify the connection\n\tsteps.push({\n\t\tid: \"verify_connection\",\n\t\tdescription: [\n\t\t\t\"Verify the database connection works by running a SQL query against the Neon database.\",\n\t\t\t\"Write and run a short script that connects using DATABASE_URL from the project's env file and executes `SELECT 1` (or queries a table from the migration if migrations were run).\",\n\t\t\t\"Do NOT use the neonctl CLI or MCP tools for this — use a direct database connection to verify end-to-end connectivity.\",\n\t\t].join(\" \"),\n\t});\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"getting_started\",\n\t\tnextAction: {\n\t\t\ttype: \"agent_action\",\n\t\t\tprerequisite: SKILL_REFERENCE_URLS.gettingStarted,\n\t\t\tsteps,\n\t\t\tonComplete: buildOnComplete(options),\n\t\t},\n\t};\n}\n\nfunction buildOnComplete(\n\toptions: GettingStartedPhaseOptions,\n): import(\"../types.js\").RunNeonInitAction {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\tconst features = options.features ?? [];\n\tconst hasFeatureRequirements = features.length > 0;\n\n\t// If features are specified and auth is not required, go to finalize\n\tif (hasFeatureRequirements && !features.includes(\"auth\")) {\n\t\treturn {\n\t\t\ttype: \"run_neon_init\",\n\t\t\targs: [\"finalize\", \"--json\", ...agentArgs],\n\t\t};\n\t}\n\n\t// Chain to neon-auth — if user already selected auth via features, go straight to setup\n\tconst authSetup =\n\t\thasFeatureRequirements && features.includes(\"auth\") ? [\"--setup\"] : [];\n\treturn {\n\t\ttype: \"run_neon_init\",\n\t\targs: [\"neon-auth\", \"--json\", ...agentArgs, ...authSetup],\n\t};\n}\n"],"mappings":"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"}
+{"version":3,"file":"getting-started.js","names":[],"sources":["../../../src/lib/phases/getting-started.ts"],"sourcesContent":["import { neonctlCmd } from \"../neonctl.js\";\nimport { ensureSkillsUpToDate, SKILL_REFERENCE_URLS } from \"../skills.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nexport interface GettingStartedPhaseOptions {\n\tagent?: string;\n\thasConnectionString?: boolean;\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\t/** Neon features required by the project (from .neon or template) */\n\tfeatures?: string[];\n\t/** Preview mode — restricts project creation to new projects in AWS us-east */\n\tpreview?: boolean;\n}\n\n/**\n * Initiates the \"Get started with Neon\" workflow.\n *\n * Steps are concrete and executable — each has a CLI command to run\n * or a specific file operation. The agent should attempt each step\n * in order and actually perform the action using the neonctl CLI.\n */\nexport async function handleGettingStartedPhase(\n\toptions: GettingStartedPhaseOptions,\n): Promise<PhaseResponse> {\n\t// Ensure skills are up to date (no-op if recently updated)\n\tif (options.agent) {\n\t\tawait ensureSkillsUpToDate(options.agent);\n\t}\n\tconst steps: { id: string; description: string; command?: string }[] = [];\n\n\tif (!options.hasConnectionString) {\n\t\tif (options.preview) {\n\t\t\t// Preview mode: new project in AWS us-east-2, or existing eligible project\n\t\t\tsteps.push(\n\t\t\t\t{\n\t\t\t\t\tid: \"select_org\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List the user's Neon organizations using the CLI command below.\",\n\t\t\t\t\t\t\"If only one org exists, use it automatically.\",\n\t\t\t\t\t\t\"If multiple orgs exist, ask the user which one to use.\",\n\t\t\t\t\t\t\"Remember the selected org ID for the next steps.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} orgs list --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"select_or_create_project\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List existing Neon projects in the selected organization using the CLI command below (replace <org-id> with the selected org ID).\",\n\t\t\t\t\t\t\"IMPORTANT: Preview features require a project in the AWS us-east-2 region created on or after 2026-06-15.\",\n\t\t\t\t\t\t\"Filter the project list to ONLY show projects where region_id is 'aws-us-east-2' AND created_at is on or after '2026-06-15'.\",\n\t\t\t\t\t\t\"If eligible projects exist, present them alongside a 'Create new project' option.\",\n\t\t\t\t\t\t\"If no eligible projects exist, tell the user and proceed directly to creating a new one.\",\n\t\t\t\t\t\t\"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects list --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"create_project_if_needed\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"If the user chose to create a new project, create it in the AWS us-east-2 region using the CLI command below (replace <org-id> and <project-name>).\",\n\t\t\t\t\t\t\"Ask the user for a project name (suggest the current directory name).\",\n\t\t\t\t\t\t\"If the user chose an existing eligible project, skip this step.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --region-id aws-us-east-2 --output json`,\n\t\t\t\t},\n\t\t\t);\n\t\t} else {\n\t\t\t// Standard mode: let user choose existing or create new\n\t\t\tsteps.push(\n\t\t\t\t{\n\t\t\t\t\tid: \"select_org\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List the user's Neon organizations using the CLI command below.\",\n\t\t\t\t\t\t\"If only one org exists, use it automatically.\",\n\t\t\t\t\t\t\"If multiple orgs exist, ask the user which one to use.\",\n\t\t\t\t\t\t\"Remember the selected org ID for the next steps.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} orgs list --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"select_or_create_project\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"List existing Neon projects in the selected organization using the CLI command below (replace <org-id> with the selected org ID).\",\n\t\t\t\t\t\t\"Ask the user whether they want to use an existing project or create a new one.\",\n\t\t\t\t\t\t\"If creating new, ask the user for a project name (suggest the current directory name).\",\n\t\t\t\t\t\t\"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects list --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"create_project_if_needed\",\n\t\t\t\t\tdescription: [\n\t\t\t\t\t\t\"If the user chose to create a new project, create it using the CLI command below (replace <org-id> and <project-name>).\",\n\t\t\t\t\t\t\"If the user chose an existing project, skip this step.\",\n\t\t\t\t\t].join(\" \"),\n\t\t\t\t\tcommand: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --output json`,\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\n\t\t// Create/update .neon context file\n\t\tsteps.push({\n\t\t\tid: \"create_neon_context\",\n\t\t\tdescription: [\n\t\t\t\t\"Update the .neon context file in the project root with the selected org and project IDs.\",\n\t\t\t\t\"IMPORTANT: If a .neon file already exists, you MUST read it first, then merge the new orgId and projectId into the existing content. Do NOT overwrite the file — other fields (like _init, branch, etc.) must be preserved.\",\n\t\t\t\t\"If no .neon file exists, create one.\",\n\t\t\t\t'The file is JSON. Add/update only the orgId and projectId fields: {\"orgId\": \"<org-id>\", \"projectId\": \"<project-id>\", ...existing fields}.',\n\t\t\t\t\"This file is safe to commit — it contains no secrets.\",\n\t\t\t].join(\" \"),\n\t\t});\n\n\t\t// Install project dependencies (required before env pull — config files may import packages)\n\t\tsteps.push({\n\t\t\tid: \"install_dependencies\",\n\t\t\tdescription: [\n\t\t\t\t\"Check if node_modules exists in the project root.\",\n\t\t\t\t\"If not, install project dependencies using the appropriate package manager (check for pnpm-lock.yaml, yarn.lock, bun.lockb, or default to npm).\",\n\t\t\t\t\"This must be done before `neonctl env pull` because the project's Neon config file may import packages that need to be installed first.\",\n\t\t\t].join(\" \"),\n\t\t\tcommand: \"npm install\",\n\t\t});\n\n\t\t// Pull environment variables (connection string, etc.) from Neon\n\t\tsteps.push({\n\t\t\tid: \"pull_env\",\n\t\t\tdescription: [\n\t\t\t\t\"Now that the .neon context file is in place and dependencies are installed, run `neonctl env pull` to populate the project's environment variables.\",\n\t\t\t\t\"This automatically writes the database connection string (and any other Neon-managed env vars) to the correct env file.\",\n\t\t\t\t\"It reads the .neon context file to determine the project, and writes to the appropriate env file for the project.\",\n\t\t\t\t\"Ensure the target env file is listed in .gitignore.\",\n\t\t\t].join(\" \"),\n\t\t\tcommand: `${neonctlCmd()} env pull`,\n\t\t});\n\n\t\t// Step 6: Install Neon serverless driver if needed\n\t\tif (options.orm === \"prisma\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription: [\n\t\t\t\t\t\"Install the @neondatabase/serverless driver adapter for Prisma.\",\n\t\t\t\t\t\"This enables Prisma to use Neon's serverless driver for edge/serverless deployments.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand:\n\t\t\t\t\t\"npm install @neondatabase/serverless @prisma/adapter-neon\",\n\t\t\t});\n\t\t} else if (options.orm === \"drizzle\" || options.orm === \"drizzle-orm\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription: \"Install the Neon serverless driver for Drizzle.\",\n\t\t\t\tcommand: \"npm install @neondatabase/serverless\",\n\t\t\t});\n\t\t} else if (!options.orm || options.orm === \"none\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"install_driver\",\n\t\t\t\tdescription:\n\t\t\t\t\t\"Install the Neon serverless driver for direct database access.\",\n\t\t\t\tcommand: \"npm install @neondatabase/serverless\",\n\t\t\t});\n\t\t}\n\t}\n\n\t// Run migrations if applicable\n\tif (options.migrationTool && options.migrationTool !== \"none\") {\n\t\tconst tool = options.migrationTool.toLowerCase();\n\t\tconst migrationDir = options.migrationDir;\n\t\tconst hasMigrationDir = migrationDir && migrationDir !== \"none\";\n\n\t\tif (tool === \"drizzle\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: [\n\t\t\t\t\thasMigrationDir\n\t\t\t\t\t\t? `Check if the ${migrationDir} directory contains .sql migration files.`\n\t\t\t\t\t\t: \"Check if a drizzle migrations directory exists with .sql files.\",\n\t\t\t\t\t\"If .sql files exist, apply them with `npx drizzle-kit migrate`.\",\n\t\t\t\t\t\"If the directory is empty or missing but a drizzle schema file exists (e.g. src/db/schema.ts, drizzle/schema.ts), run `npx drizzle-kit generate` first to create migrations, then `npx drizzle-kit migrate` to apply them.\",\n\t\t\t\t\t\"If neither schema nor migrations exist, skip this step.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand: \"npx drizzle-kit migrate\",\n\t\t\t});\n\t\t} else if (tool === \"prisma\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: [\n\t\t\t\t\thasMigrationDir\n\t\t\t\t\t\t? `Check if the ${migrationDir} directory contains migration folders.`\n\t\t\t\t\t\t: \"Check if prisma/migrations contains migration folders.\",\n\t\t\t\t\t\"If migrations exist, apply them with `npx prisma migrate deploy`.\",\n\t\t\t\t\t\"If the migrations directory is empty or missing but prisma/schema.prisma has models defined, run `npx prisma migrate dev --name init` to create and apply the initial migration.\",\n\t\t\t\t\t\"If no models are defined, skip this step.\",\n\t\t\t\t].join(\" \"),\n\t\t\t\tcommand: \"npx prisma migrate deploy\",\n\t\t\t});\n\t\t} else if (tool === \"knex\") {\n\t\t\tsteps.push({\n\t\t\t\tid: \"run_migrations\",\n\t\t\t\tdescription: `Apply existing knex migrations to the Neon database.`,\n\t\t\t\tcommand: \"npx knex migrate:latest\",\n\t\t\t});\n\t\t}\n\t} else if (options.preview) {\n\t\t// Bootstrap flow: migration tool wasn't detected because the project was\n\t\t// inspected before scaffolding. Detect and run migrations from the scaffolded template.\n\t\tsteps.push({\n\t\t\tid: \"run_migrations\",\n\t\t\tdescription: [\n\t\t\t\t\"Check the scaffolded project for a migration tool and schema.\",\n\t\t\t\t\"Look for: drizzle.config.ts/js (Drizzle), prisma/schema.prisma (Prisma), or knexfile.ts/js (Knex).\",\n\t\t\t\t\"If Drizzle is found: check if a drizzle migrations directory exists with .sql files. If .sql files exist, run `npx drizzle-kit migrate`. If the directory is empty or missing but a schema file exists, run `npx drizzle-kit generate` first, then `npx drizzle-kit migrate`.\",\n\t\t\t\t\"If Prisma is found: check if prisma/migrations contains migration folders. If yes, run `npx prisma migrate deploy`. If not but models exist, run `npx prisma migrate dev --name init`.\",\n\t\t\t\t\"If no migration tool is found, skip this step.\",\n\t\t\t].join(\" \"),\n\t\t});\n\t}\n\n\t// Verify the connection\n\tsteps.push({\n\t\tid: \"verify_connection\",\n\t\tdescription: [\n\t\t\t\"Verify the database connection works by running a SQL query against the Neon database.\",\n\t\t\t\"Write and run a short script that connects using DATABASE_URL from the project's env file and executes `SELECT 1` (or queries a table from the migration if migrations were run).\",\n\t\t\t\"Do NOT use the neonctl CLI or MCP tools for this — use a direct database connection to verify end-to-end connectivity.\",\n\t\t].join(\" \"),\n\t});\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"getting_started\",\n\t\tnextAction: {\n\t\t\ttype: \"agent_action\",\n\t\t\tprerequisite: SKILL_REFERENCE_URLS.gettingStarted,\n\t\t\tsteps,\n\t\t\tonComplete: buildOnComplete(options),\n\t\t},\n\t};\n}\n\nfunction buildOnComplete(\n\toptions: GettingStartedPhaseOptions,\n): import(\"../types.js\").RunNeonInitAction {\n\tconst agentArgs = options.agent ? [\"--agent\", options.agent] : [];\n\tconst features = options.features ?? [];\n\tconst hasFeatureRequirements = features.length > 0;\n\n\t// If features are specified and auth is not required, go to finalize\n\tif (hasFeatureRequirements && !features.includes(\"auth\")) {\n\t\treturn {\n\t\t\ttype: \"run_neon_init\",\n\t\t\targs: [\"finalize\", \"--json\", ...agentArgs],\n\t\t};\n\t}\n\n\t// Chain to neon-auth — if user already selected auth via features, go straight to setup\n\tconst authSetup =\n\t\thasFeatureRequirements && features.includes(\"auth\") ? [\"--setup\"] : [];\n\treturn {\n\t\ttype: \"run_neon_init\",\n\t\targs: [\"neon-auth\", \"--json\", ...agentArgs, ...authSetup],\n\t};\n}\n"],"mappings":"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"}

package/dist/lib/phases/setup.js

@@ -364,7 +364,8 @@ async function executeBatchedInstallation(options) {
 	const isBootstrap = !!options.template;
 	if (isBootstrap && options.template) try {
 		await execa("npx", [
-			"neonctl",
+			"-y",
+			"neonctl@latest",
 			"bootstrap",
 			".",
 			"--template",

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\ttype NeonFeature,\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/** 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\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\n\tmode?: \"defaults\" | \"customize\";\n\tmcpScope?: \"global\" | \"project\" | \"none\";\n\tskillsScope?: \"global\" | \"project\";\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\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// User chose \"defaults\" — batch install with default settings\n\tif (options.mode === \"defaults\") {\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\" with scopes already provided (via --data) — go straight to install\n\tif (options.mode === \"customize\") {\n\t\tif (\n\t\t\toptions.mcpScope !== undefined ||\n\t\t\toptions.skillsScope !== undefined\n\t\t) {\n\t\t\tconst merged = await mergeCliInspection(options);\n\t\t\tconst shouldInstallExt =\n\t\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\t\treturn executeBatchedInstallation({\n\t\t\t\t...merged,\n\t\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\t\tinstallExtension: shouldInstallExt,\n\t\t\t});\n\t\t}\n\t\t// Legacy path: scopes not yet chosen, ask follow-up\n\t\treturn buildCustomizeQuestions(options);\n\t}\n\n\t// Agent has reported inspection results (via legacy individual flags), but user hasn't chosen mode yet.\n\t// Only go to mode question if the agent explicitly reported back (not pre-filled by orchestrator).\n\t// Agent has reported inspection results (via legacy individual flags), but user hasn't chosen mode yet\n\tif (options.mcpConfigured !== null && options.mcpConfigured !== undefined) {\n\t\treturn buildModeQuestion(options);\n\t}\n\n\t// Default: send inspection checks with user preferences\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\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\"If the MCP server is already configured, tell the user and note that it will be kept up to date. IMPORTANT: If you find neon-postgres in skills-lock.json, you MUST verify the actual SKILL.md file exists on disk (e.g. .agents/skills/neon-postgres/SKILL.md or .cursor/skills/neon-postgres/SKILL.md). If the lock file references it but the file is missing, report skills as NOT installed. Only ask about scope/options for components that are NOT already configured.\",\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{\n\t\t\t\t\tid: \"mode\",\n\t\t\t\t\tquestion: \"Use default settings or customize?\",\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: \"defaults\",\n\t\t\t\t\t\t\tlabel: hasApp\n\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: \"Use defaults (neonctl CLI, MCP: global, extension if applicable — skills included in template)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"defaults\",\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// Only show skills scope when there's an existing app (templates bundle skills)\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: \"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\"Always ask this question — the CLI handles skill detection and freshness automatically.\",\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`<json: { agent: string, ide: string, mcpConfigured: bool, mode: string, mcpScope?: 'global'|'project'|'none', skillsScope?: string, installExtension?: bool${hasApp ? \", features?: string\" : \", template: string\"} }>`,\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}\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 ?? \"claude-code\";\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\tawait execa(\n\t\t\t\t\"npx\",\n\t\t\t\t[\n\t\t\t\t\t\"neonctl\",\n\t\t\t\t\t\"bootstrap\",\n\t\t\t\t\t\".\",\n\t\t\t\t\t\"--template\",\n\t\t\t\t\toptions.template,\n\t\t\t\t\t\"--force\",\n\t\t\t\t],\n\t\t\t\t{ stdio: \"pipe\", timeout: 120000 },\n\t\t\t);\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\";\n\t\tconst skillsOk = await ensureSkillsUpToDate(agentId, skillsScope);\n\t\tresults.push({\n\t\t\tid: \"install_skills\",\n\t\t\tdescription: skillsOk\n\t\t\t\t? \"Neon agent skills installed\"\n\t\t\t\t: \"Failed to install Neon agent skills\",\n\t\t\tstatus: skillsOk ? \"success\" : \"failed\",\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\ttype NeonFeature,\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/** 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\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\n\tmode?: \"defaults\" | \"customize\";\n\tmcpScope?: \"global\" | \"project\" | \"none\";\n\tskillsScope?: \"global\" | \"project\";\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\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// User chose \"defaults\" — batch install with default settings\n\tif (options.mode === \"defaults\") {\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\" with scopes already provided (via --data) — go straight to install\n\tif (options.mode === \"customize\") {\n\t\tif (\n\t\t\toptions.mcpScope !== undefined ||\n\t\t\toptions.skillsScope !== undefined\n\t\t) {\n\t\t\tconst merged = await mergeCliInspection(options);\n\t\t\tconst shouldInstallExt =\n\t\t\t\tmerged.installExtension ?? isVscodeBasedIde(merged);\n\t\t\treturn executeBatchedInstallation({\n\t\t\t\t...merged,\n\t\t\t\tmcpScope: merged.mcpScope ?? \"global\",\n\t\t\t\tskillsScope: merged.skillsScope ?? \"project\",\n\t\t\t\tinstallExtension: shouldInstallExt,\n\t\t\t});\n\t\t}\n\t\t// Legacy path: scopes not yet chosen, ask follow-up\n\t\treturn buildCustomizeQuestions(options);\n\t}\n\n\t// Agent has reported inspection results (via legacy individual flags), but user hasn't chosen mode yet.\n\t// Only go to mode question if the agent explicitly reported back (not pre-filled by orchestrator).\n\t// Agent has reported inspection results (via legacy individual flags), but user hasn't chosen mode yet\n\tif (options.mcpConfigured !== null && options.mcpConfigured !== undefined) {\n\t\treturn buildModeQuestion(options);\n\t}\n\n\t// Default: send inspection checks with user preferences\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\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\"If the MCP server is already configured, tell the user and note that it will be kept up to date. IMPORTANT: If you find neon-postgres in skills-lock.json, you MUST verify the actual SKILL.md file exists on disk (e.g. .agents/skills/neon-postgres/SKILL.md or .cursor/skills/neon-postgres/SKILL.md). If the lock file references it but the file is missing, report skills as NOT installed. Only ask about scope/options for components that are NOT already configured.\",\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{\n\t\t\t\t\tid: \"mode\",\n\t\t\t\t\tquestion: \"Use default settings or customize?\",\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: \"defaults\",\n\t\t\t\t\t\t\tlabel: hasApp\n\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: \"Use defaults (neonctl CLI, MCP: global, extension if applicable — skills included in template)\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tvalue: \"customize\",\n\t\t\t\t\t\t\tlabel: \"Customize installation settings\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdefault: \"defaults\",\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// Only show skills scope when there's an existing app (templates bundle skills)\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: \"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\"Always ask this question — the CLI handles skill detection and freshness automatically.\",\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`<json: { agent: string, ide: string, mcpConfigured: bool, mode: string, mcpScope?: 'global'|'project'|'none', skillsScope?: string, installExtension?: bool${hasApp ? \", features?: string\" : \", template: string\"} }>`,\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}\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 ?? \"claude-code\";\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\t// Pin @latest (and -y) so a stale globally-installed neonctl can't be\n\t\t\t// picked up by npx — bootstrap's rate-limit fix lives in recent\n\t\t\t// neonctl, and this runs before ensureNeonctl() updates the global.\n\t\t\tawait execa(\n\t\t\t\t\"npx\",\n\t\t\t\t[\n\t\t\t\t\t\"-y\",\n\t\t\t\t\t\"neonctl@latest\",\n\t\t\t\t\t\"bootstrap\",\n\t\t\t\t\t\".\",\n\t\t\t\t\t\"--template\",\n\t\t\t\t\toptions.template,\n\t\t\t\t\t\"--force\",\n\t\t\t\t],\n\t\t\t\t{ stdio: \"pipe\", timeout: 120000 },\n\t\t\t);\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\";\n\t\tconst skillsOk = await ensureSkillsUpToDate(agentId, skillsScope);\n\t\tresults.push({\n\t\t\tid: \"install_skills\",\n\t\t\tdescription: skillsOk\n\t\t\t\t? \"Neon agent skills installed\"\n\t\t\t\t: \"Failed to install Neon agent skills\",\n\t\t\tstatus: skillsOk ? \"success\" : \"failed\",\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/dist/lib/phases/status.d.ts

@@ -4,7 +4,7 @@ import { StatusResponse } from "../types.js";
 interface StatusOptions {
   agent?: string;
 }
-declare function handleStatusPhase(options: StatusOptions): Promise<StatusResponse>;
+declare function handleStatusPhase(_options: StatusOptions): Promise<StatusResponse>;
 //#endregion
 export { StatusOptions, handleStatusPhase };
 //# sourceMappingURL=status.d.ts.map

package/dist/lib/phases/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","names":[],"sources":["../../../src/lib/phases/status.ts"],"mappings":";;;UAIiB,aAAA;;AAAjB;AAIsB,iBAAA,iBAAA,CAAiB,OAAA,EAC7B,aAD6B,CAAA,EAEpC,OAFoC,CAE5B,cAF4B,CAAA"}
+{"version":3,"file":"status.d.ts","names":[],"sources":["../../../src/lib/phases/status.ts"],"mappings":";;;UAIiB,aAAA;;AAAjB;AAIsB,iBAAA,iBAAA,CAAiB,QAAA,EAC5B,aAD4B,CAAA,EAEpC,OAFoC,CAE5B,cAF4B,CAAA"}

package/dist/lib/phases/status.js

@@ -1,7 +1,7 @@
 import { isAuthenticated } from "../auth.js";
 import { inspectProject } from "../inspect.js";
 //#region src/lib/phases/status.ts
-async function handleStatusPhase(options) {
+async function handleStatusPhase(_options) {
 	const authed = await isAuthenticated();
 	const inspection = await inspectProject([
 		{
@@ -28,22 +28,22 @@ async function handleStatusPhase(options) {
 	if (!authed) recommendations.push({
 		priority: "high",
 		message: "Not authenticated with Neon",
-		command: "neon-init auth --json"
+		command: `neonctl init --agent --json --data '{"step":"auth"}'`
 	});
 	if (!hasDatabaseUrl) recommendations.push({
 		priority: "high",
 		message: "No DATABASE_URL found in .env",
-		command: "neon-init db --json"
+		command: `neonctl init --agent --json --data '{"step":"db"}'`
 	});
 	if (!skillsInstalled) recommendations.push({
 		priority: "medium",
 		message: "Neon agent skills not detected in this project",
-		command: options.agent ? `neon-init skills --json --agent ${options.agent} --install` : "neon-init skills --json --install"
+		command: `neonctl init --agent --json --data '{"step":"skills","install":true}'`
 	});
 	if (migrationTool && !hasMigrations) recommendations.push({
 		priority: "medium",
 		message: `${migrationTool} detected but no migrations found`,
-		command: "neon-init migrations --json"
+		command: `neonctl init --agent --json --data '{"step":"migrations"}'`
 	});
 	return {
 		auth: { authenticated: authed },

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

@@ -1 +1 @@
-{"version":3,"file":"status.js","names":[],"sources":["../../../src/lib/phases/status.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport type { StatusResponse } from \"../types.js\";\n\nexport interface StatusOptions {\n\tagent?: string;\n}\n\nexport async function handleStatusPhase(\n\toptions: StatusOptions,\n): Promise<StatusResponse> {\n\tconst authed = await isAuthenticated();\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"database_url\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t]);\n\n\tconst hasDatabaseUrl = inspection.databaseUrl === true;\n\tconst skillsInstalled = inspection.skillsInstalled === true;\n\tconst migrationTool = (inspection.migrationTool as string | null) ?? null;\n\tconst hasMigrations =\n\t\tmigrationTool !== null &&\n\t\tmigrationTool !== \"none\" &&\n\t\tinspection.migrationDir !== \"none\";\n\n\tconst recommendations: StatusResponse[\"recommendations\"] = [];\n\n\tif (!authed) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"Not authenticated with Neon\",\n\t\t\tcommand: \"neon-init auth --json\",\n\t\t});\n\t}\n\n\tif (!hasDatabaseUrl) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"No DATABASE_URL found in .env\",\n\t\t\tcommand: \"neon-init db --json\",\n\t\t});\n\t}\n\n\tif (!skillsInstalled) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: \"Neon agent skills not detected in this project\",\n\t\t\tcommand: options.agent\n\t\t\t\t? `neon-init skills --json --agent ${options.agent} --install`\n\t\t\t\t: \"neon-init skills --json --install\",\n\t\t});\n\t}\n\n\tif (migrationTool && !hasMigrations) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: `${migrationTool} detected but no migrations found`,\n\t\t\tcommand: \"neon-init migrations --json\",\n\t\t});\n\t}\n\n\treturn {\n\t\tauth: {\n\t\t\tauthenticated: authed,\n\t\t},\n\t\ttooling: {\n\t\t\tmcpServer: { configured: null },\n\t\t\tskills: { installed: skillsInstalled },\n\t\t},\n\t\tproject: {\n\t\t\tdatabaseUrl: hasDatabaseUrl,\n\t\t},\n\t\tmigrations: {\n\t\t\ttool: migrationTool,\n\t\t\thasMigrations,\n\t\t},\n\t\trecommendations,\n\t};\n}\n"],"mappings":";;;AAQA,eAAsB,kBACrB,SAC0B;CAC1B,MAAM,SAAS,MAAM,gBAAgB;CAErC,MAAM,aAAa,MAAM,eAAe;EACvC;GAAE,IAAI;GAAgB,aAAa;GAAI,SAAS,CAAC;EAAE;EACnD;GAAE,IAAI;GAAU,aAAa;GAAI,SAAS,CAAC;EAAE;EAC7C;GAAE,IAAI;GAAc,aAAa;GAAI,SAAS,CAAC;EAAE;CAClD,CAAC;CAED,MAAM,iBAAiB,WAAW,gBAAgB;CAClD,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,gBAAiB,WAAW,iBAAmC;CACrE,MAAM,gBACL,kBAAkB,QAClB,kBAAkB,UAClB,WAAW,iBAAiB;CAE7B,MAAM,kBAAqD,CAAC;CAE5D,IAAI,CAAC,QACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,gBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,iBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS,QAAQ,QACd,mCAAmC,QAAQ,MAAM,cACjD;CACJ,CAAC;CAGF,IAAI,iBAAiB,CAAC,eACrB,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS,GAAG,cAAc;EAC1B,SAAS;CACV,CAAC;CAGF,OAAO;EACN,MAAM,EACL,eAAe,OAChB;EACA,SAAS;GACR,WAAW,EAAE,YAAY,KAAK;GAC9B,QAAQ,EAAE,WAAW,gBAAgB;EACtC;EACA,SAAS,EACR,aAAa,eACd;EACA,YAAY;GACX,MAAM;GACN;EACD;EACA;CACD;AACD"}
+{"version":3,"file":"status.js","names":[],"sources":["../../../src/lib/phases/status.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport type { StatusResponse } from \"../types.js\";\n\nexport interface StatusOptions {\n\tagent?: string;\n}\n\nexport async function handleStatusPhase(\n\t_options: StatusOptions,\n): Promise<StatusResponse> {\n\tconst authed = await isAuthenticated();\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"database_url\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t]);\n\n\tconst hasDatabaseUrl = inspection.databaseUrl === true;\n\tconst skillsInstalled = inspection.skillsInstalled === true;\n\tconst migrationTool = (inspection.migrationTool as string | null) ?? null;\n\tconst hasMigrations =\n\t\tmigrationTool !== null &&\n\t\tmigrationTool !== \"none\" &&\n\t\tinspection.migrationDir !== \"none\";\n\n\tconst recommendations: StatusResponse[\"recommendations\"] = [];\n\n\tif (!authed) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"Not authenticated with Neon\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"auth\"}'`,\n\t\t});\n\t}\n\n\tif (!hasDatabaseUrl) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"No DATABASE_URL found in .env\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"db\"}'`,\n\t\t});\n\t}\n\n\tif (!skillsInstalled) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: \"Neon agent skills not detected in this project\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"skills\",\"install\":true}'`,\n\t\t});\n\t}\n\n\tif (migrationTool && !hasMigrations) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: `${migrationTool} detected but no migrations found`,\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"migrations\"}'`,\n\t\t});\n\t}\n\n\treturn {\n\t\tauth: {\n\t\t\tauthenticated: authed,\n\t\t},\n\t\ttooling: {\n\t\t\tmcpServer: { configured: null },\n\t\t\tskills: { installed: skillsInstalled },\n\t\t},\n\t\tproject: {\n\t\t\tdatabaseUrl: hasDatabaseUrl,\n\t\t},\n\t\tmigrations: {\n\t\t\ttool: migrationTool,\n\t\t\thasMigrations,\n\t\t},\n\t\trecommendations,\n\t};\n}\n"],"mappings":";;;AAQA,eAAsB,kBACrB,UAC0B;CAC1B,MAAM,SAAS,MAAM,gBAAgB;CAErC,MAAM,aAAa,MAAM,eAAe;EACvC;GAAE,IAAI;GAAgB,aAAa;GAAI,SAAS,CAAC;EAAE;EACnD;GAAE,IAAI;GAAU,aAAa;GAAI,SAAS,CAAC;EAAE;EAC7C;GAAE,IAAI;GAAc,aAAa;GAAI,SAAS,CAAC;EAAE;CAClD,CAAC;CAED,MAAM,iBAAiB,WAAW,gBAAgB;CAClD,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,gBAAiB,WAAW,iBAAmC;CACrE,MAAM,gBACL,kBAAkB,QAClB,kBAAkB,UAClB,WAAW,iBAAiB;CAE7B,MAAM,kBAAqD,CAAC;CAE5D,IAAI,CAAC,QACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,gBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,iBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,iBAAiB,CAAC,eACrB,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS,GAAG,cAAc;EAC1B,SAAS;CACV,CAAC;CAGF,OAAO;EACN,MAAM,EACL,eAAe,OAChB;EACA,SAAS;GACR,WAAW,EAAE,YAAY,KAAK;GAC9B,QAAQ,EAAE,WAAW,gBAAgB;EACtC;EACA,SAAS,EACR,aAAa,eACd;EACA,YAAY;GACX,MAAM;GACN;EACD;EACA;CACD;AACD"}

package/dist/lib/route-command.d.ts

@@ -3,6 +3,13 @@ import { PhaseResponse } from "./types.js";
 //#region src/lib/route-command.d.ts
 
 declare function routeCommand(args: string[]): Promise<PhaseResponse>;
+/**
+ * Routes a --data JSON payload with a "step" field to the appropriate phase
+ * handler. This lets agents use a single command surface:
+ *   neon-init --agent --json --data '{"step":"auth"}'
+ *   neon-init --agent --json --data '{"step":"db","projectId":"xyz"}'
+ */
+declare function routeDataStep(data: Record<string, unknown>, agent: string | undefined): Promise<unknown>;
 //#endregion
-export { routeCommand };
+export { routeCommand, routeDataStep };
 //# sourceMappingURL=route-command.d.ts.map

package/dist/lib/route-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-command.d.ts","names":[],"sources":["../../src/lib/route-command.ts"],"mappings":";;;;AAuEoD,iBAA9B,YAAA,CAA8B,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,OAAA,CAAQ,aAAR,CAAA"}
+{"version":3,"file":"route-command.d.ts","names":[],"sources":["../../src/lib/route-command.ts"],"mappings":";;;;AAuEoD,iBAA9B,YAAA,CAA8B,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,OAAA,CAAQ,aAAR,CAAA;AAAO;AAiL3D;;;;AAGU;iBAHY,aAAA,OACf,qDAEJ"}