neon 4.7.0 → 4.8.0

package/dist/init/phases/getting_started.js

@@ -1,218 +0,0 @@
-import { DO_NOT_SUBSTITUTE_HINT, MISSING_BINARY_HINT, formatExecCommand, formatInstallCommand, resolvePackageManager } from "../../utils/package_manager.js";
-import { neonctlCmd } from "../neonctl.js";
-import { SKILL_REFERENCE_URLS, ensureSkillsUpToDate } from "../skills.js";
-//#region src/init/phases/getting_started.ts
-/**
-* Initiates the "Get started with Neon" workflow.
-*
-* Steps are concrete and executable — each has a CLI command to run
-* or a specific file operation. The agent should attempt each step
-* in order and actually perform the action using the Neon CLI.
-*/
-async function handleGettingStartedPhase(options) {
-	if (options.agent) await ensureSkillsUpToDate(options.agent);
-	const steps = [];
-	const installPm = resolvePackageManager(options.cwd);
-	if (!options.hasConnectionString) {
-		if (options.preview) steps.push({
-			id: "select_org",
-			description: [
-				"List the user's Neon organizations using the CLI command below.",
-				"If only one org exists, use it automatically.",
-				"If multiple orgs exist, ask the user which one to use.",
-				"Remember the selected org ID for the next steps."
-			].join(" "),
-			command: `${neonctlCmd()} orgs list --output json`
-		}, {
-			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: Neon features (Functions, Object Storage, and AI Gateway) are currently in beta and only available in the AWS us-east-2 region (more regions coming shortly). Projects must have region_id 'aws-us-east-2' and be 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."
-			].join(" "),
-			command: `${neonctlCmd()} projects list --org-id <org-id> --output json`
-		}, {
-			id: "create_project_if_needed",
-			description: [
-				"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>).",
-				"Ask the user for a project name (suggest the current directory name).",
-				"If the user chose an existing eligible project, skip this step."
-			].join(" "),
-			command: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --region-id aws-us-east-2 --output json`
-		});
-		else steps.push({
-			id: "select_org",
-			description: [
-				"List the user's Neon organizations using the CLI command below.",
-				"If only one org exists, use it automatically.",
-				"If multiple orgs exist, ask the user which one to use.",
-				"Remember the selected org ID for the next steps."
-			].join(" "),
-			command: `${neonctlCmd()} orgs list --output json`
-		}, {
-			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).",
-				"Ask the user whether they want to use an existing project or create a new one.",
-				"If creating new, ask the user for a project name (suggest the current directory name).",
-				"IMPORTANT: Always include --org-id when creating a project to avoid interactive prompts."
-			].join(" "),
-			command: `${neonctlCmd()} projects list --org-id <org-id> --output json`
-		}, {
-			id: "create_project_if_needed",
-			description: ["If the user chose to create a new project, create it using the CLI command below (replace <org-id> and <project-name>).", "If the user chose an existing project, skip this step."].join(" "),
-			command: `${neonctlCmd()} projects create --name <project-name> --org-id <org-id> --output json`
-		});
-		steps.push({
-			id: "create_neon_context",
-			description: [
-				"Update the .neon context file in the project root with the selected org and project IDs.",
-				"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.",
-				"If no .neon file exists, create one.",
-				"The file is JSON. Add/update only the orgId and projectId fields: {\"orgId\": \"<org-id>\", \"projectId\": \"<project-id>\", ...existing fields}.",
-				"This file is safe to commit — it contains no secrets."
-			].join(" ")
-		});
-		steps.push({
-			id: "install_dependencies",
-			description: [
-				"Check if node_modules exists in the project root. If not, install the project's dependencies.",
-				DO_NOT_SUBSTITUTE_HINT,
-				"This must be done before `neon env pull` because the project's Neon config file may import packages that need to be installed first."
-			].join(" "),
-			command: formatInstallCommand(installPm)
-		});
-		steps.push({
-			id: "pull_env",
-			description: [
-				"Now that the .neon context file is in place and dependencies are installed, run `neon env pull` to populate the project's environment variables.",
-				"This automatically writes the database connection string (and any other Neon-managed env vars) to the correct env file.",
-				"It reads the .neon context file to determine the project, and writes to the appropriate env file for the project.",
-				"Ensure the target env file is listed in .gitignore."
-			].join(" "),
-			command: `${neonctlCmd()} env pull`
-		});
-		if (options.orm === "prisma") steps.push({
-			id: "install_driver",
-			description: [
-				"Install the @neondatabase/serverless driver adapter for Prisma.",
-				"This enables Prisma to use Neon's serverless driver for edge/serverless deployments.",
-				DO_NOT_SUBSTITUTE_HINT
-			].join(" "),
-			command: formatInstallCommand(installPm, ["@neondatabase/serverless", "@prisma/adapter-neon"])
-		});
-		else if (options.orm === "drizzle" || options.orm === "drizzle-orm") steps.push({
-			id: "install_driver",
-			description: `Install the Neon serverless driver for Drizzle. ${DO_NOT_SUBSTITUTE_HINT}`,
-			command: formatInstallCommand(installPm, ["@neondatabase/serverless"])
-		});
-		else if (!options.orm || options.orm === "none") steps.push({
-			id: "install_driver",
-			description: `Install the Neon serverless driver for direct database access. ${DO_NOT_SUBSTITUTE_HINT}`,
-			command: formatInstallCommand(installPm, ["@neondatabase/serverless"])
-		});
-	}
-	if (options.migrationTool && options.migrationTool !== "none") {
-		const tool = options.migrationTool.toLowerCase();
-		const migrationDir = options.migrationDir;
-		const hasMigrationDir = migrationDir && migrationDir !== "none";
-		if (tool === "drizzle") {
-			const migrate = formatExecCommand(installPm, "drizzle-kit", ["migrate"]);
-			const generate = formatExecCommand(installPm, "drizzle-kit", ["generate"]);
-			steps.push({
-				id: "run_migrations",
-				description: [
-					hasMigrationDir ? `Check if the ${migrationDir} directory contains .sql migration files.` : "Check if a drizzle migrations directory exists with .sql files.",
-					`If .sql files exist, apply them with \`${migrate}\`.`,
-					`If the directory is empty or missing but a drizzle schema file exists (e.g. src/db/schema.ts, drizzle/schema.ts), run \`${generate}\` first to create migrations, then \`${migrate}\` to apply them.`,
-					"If neither schema nor migrations exist, skip this step.",
-					MISSING_BINARY_HINT
-				].join(" "),
-				command: migrate
-			});
-		} else if (tool === "prisma") {
-			const deploy = formatExecCommand(installPm, "prisma", ["migrate", "deploy"]);
-			steps.push({
-				id: "run_migrations",
-				description: [
-					hasMigrationDir ? `Check if the ${migrationDir} directory contains migration folders.` : "Check if prisma/migrations contains migration folders.",
-					`If migrations exist, apply them with \`${deploy}\`.`,
-					`If the migrations directory is empty or missing but prisma/schema.prisma has models defined, run \`${formatExecCommand(installPm, "prisma", [
-						"migrate",
-						"dev",
-						"--name",
-						"init"
-					])}\` to create and apply the initial migration.`,
-					"If no models are defined, skip this step.",
-					MISSING_BINARY_HINT
-				].join(" "),
-				command: deploy
-			});
-		} else if (tool === "knex") steps.push({
-			id: "run_migrations",
-			description: `Apply existing knex migrations to the Neon database. ${MISSING_BINARY_HINT}`,
-			command: formatExecCommand(installPm, "knex", ["migrate:latest"])
-		});
-	} else if (options.preview) steps.push({
-		id: "run_migrations",
-		description: [
-			"Check the scaffolded project for a migration tool and schema.",
-			"Look for: drizzle.config.ts/js (Drizzle), prisma/schema.prisma (Prisma), or knexfile.ts/js (Knex).",
-			`If Drizzle is found: check if a drizzle migrations directory exists with .sql files. If .sql files exist, run \`${formatExecCommand(installPm, "drizzle-kit", ["migrate"])}\`. If the directory is empty or missing but a schema file exists, run \`${formatExecCommand(installPm, "drizzle-kit", ["generate"])}\` first, then \`${formatExecCommand(installPm, "drizzle-kit", ["migrate"])}\`.`,
-			`If Prisma is found: check if prisma/migrations contains migration folders. If yes, run \`${formatExecCommand(installPm, "prisma", ["migrate", "deploy"])}\`. If not but models exist, run \`${formatExecCommand(installPm, "prisma", [
-				"migrate",
-				"dev",
-				"--name",
-				"init"
-			])}\`.`,
-			"If no migration tool is found, skip this step.",
-			MISSING_BINARY_HINT
-		].join(" ")
-	});
-	steps.push({
-		id: "verify_connection",
-		description: [
-			"Verify the database connection works by running a SQL query against the Neon database.",
-			"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).",
-			"Do NOT use the Neon CLI or MCP tools for this — use a direct database connection to verify end-to-end connectivity."
-		].join(" ")
-	});
-	return {
-		phase: "setup",
-		status: "getting_started",
-		nextAction: {
-			type: "agent_action",
-			prerequisite: SKILL_REFERENCE_URLS.gettingStarted,
-			steps,
-			onComplete: buildOnComplete(options)
-		}
-	};
-}
-function buildOnComplete(options) {
-	const agentArgs = options.agent ? ["--agent", options.agent] : [];
-	const features = options.features ?? [];
-	const hasFeatureRequirements = features.length > 0;
-	if (hasFeatureRequirements && !features.includes("auth")) return {
-		type: "run_neon_init",
-		args: [
-			"finalize",
-			"--json",
-			...agentArgs
-		]
-	};
-	const authSetup = hasFeatureRequirements && features.includes("auth") ? ["--setup"] : [];
-	return {
-		type: "run_neon_init",
-		args: [
-			"neon-auth",
-			"--json",
-			...agentArgs,
-			...authSetup
-		]
-	};
-}
-//#endregion
-export { handleGettingStartedPhase };

package/dist/init/phases/mcp.js

@@ -1,219 +0,0 @@
-import { installNeonMcpServer } from "../../mcp/install.js";
-import { agentSupportsHttpMcp, agentSupportsProjectMcp, getAgentDisplayName, resolveAddMcpAgentId, tryResolveAddMcpAgentId } from "../../mcp/agents.js";
-import { getSkillsAgentName } from "../agents.js";
-import { isAuthenticated } from "../auth.js";
-//#region src/init/phases/mcp.ts
-function skillsFollowUp(agent) {
-	if (agent && !getSkillsAgentName(agent)) return agent ? [
-		"--agent",
-		agent,
-		"--json"
-	] : ["--json"];
-	return [
-		"skills",
-		"--json",
-		...agent ? ["--agent", agent] : [],
-		"--install"
-	];
-}
-async function handleMcpPhase(options) {
-	const agentArgs = options.agent ? [
-		"--agent",
-		options.agent,
-		"--json"
-	] : ["--json"];
-	if (options.status) return {
-		phase: "tooling",
-		status: "status",
-		nextAction: {
-			type: "agent_check",
-			checks: [{
-				id: "mcp_server",
-				description: "Check if the Neon MCP server is already configured in your MCP server list",
-				lookFor: ["An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'"]
-			}],
-			reportBack: {
-				type: "run_neon_init",
-				args: [
-					"mcp",
-					"--json",
-					...options.agent ? ["--agent", options.agent] : [],
-					"--mcp-configured",
-					"<true|false>"
-				]
-			}
-		}
-	};
-	if (options.install) {
-		if (!await isAuthenticated()) return {
-			phase: "tooling",
-			status: "auth_required",
-			nextAction: {
-				type: "run_neon_init",
-				args: ["auth", "--json"]
-			}
-		};
-		const scope = options.scope ?? "global";
-		const mcpAgentId = resolveAddMcpAgentId(options.agent ?? "claude-code");
-		const installed = installNeonMcpServer({
-			agent: mcpAgentId,
-			scope,
-			cwd: process.cwd()
-		});
-		if (!installed.ok) {
-			if (installed.unsupported) {
-				if (scope === "project" && !agentSupportsProjectMcp(mcpAgentId) && agentSupportsHttpMcp(mcpAgentId)) return {
-					phase: "tooling",
-					status: "unsupported",
-					error: installed.error,
-					nextAction: {
-						type: "ask_user",
-						question: `${getAgentDisplayName(mcpAgentId)} does not support project-level MCP. Install the Neon MCP server globally instead?`,
-						options: [{
-							value: "global",
-							label: "Install globally"
-						}, {
-							value: "skip",
-							label: "Skip MCP install"
-						}],
-						responseMapping: {
-							global: { args: [
-								"mcp",
-								"--json",
-								...options.agent ? ["--agent", options.agent] : [],
-								"--install"
-							] },
-							skip: { args: skillsFollowUp(options.agent) }
-						}
-					}
-				};
-				return {
-					phase: "tooling",
-					status: "unsupported",
-					error: installed.error,
-					nextAction: {
-						type: "run_neon_init",
-						args: skillsFollowUp(options.agent)
-					}
-				};
-			}
-			return {
-				phase: "tooling",
-				status: "failed",
-				error: installed.error,
-				nextAction: {
-					type: "ask_user",
-					question: "Failed to install the Neon MCP server automatically. Would you like to try again or configure it manually?",
-					options: [{
-						value: "retry",
-						label: "Try again"
-					}, {
-						value: "manual",
-						label: "I'll configure it manually"
-					}],
-					responseMapping: {
-						retry: { args: [
-							"mcp",
-							"--json",
-							...options.agent ? ["--agent", options.agent] : [],
-							"--install",
-							...scope === "project" ? ["--scope", "project"] : []
-						] },
-						manual: { args: agentArgs }
-					}
-				}
-			};
-		}
-		const isCursor = mcpAgentId === "cursor" || options.agent?.toLowerCase() === "cursor";
-		const isClaudeCode = mcpAgentId === "claude-code" || options.agent?.toLowerCase() === "claude-code";
-		let enableNote = "";
-		if (isCursor && scope === "project") enableNote = " Cursor disables project-level MCP servers by default — open Cursor Settings > MCP and toggle the \"Neon\" server on.";
-		else if (isClaudeCode) enableNote = " Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" server to enable it.";
-		return {
-			phase: "tooling",
-			status: "installed",
-			path: installed.path,
-			nextAction: {
-				type: "run_neon_init",
-				args: skillsFollowUp(options.agent)
-			},
-			message: `Installed Neon MCP server (${scope} scope) for ${mcpAgentId}.${enableNote}`
-		};
-	}
-	if (options.mcpConfigured === true) return {
-		phase: "tooling",
-		status: "mcp_configured",
-		nextAction: {
-			type: "run_neon_init",
-			args: skillsFollowUp(options.agent)
-		}
-	};
-	if (options.mcpConfigured === false) return {
-		phase: "tooling",
-		status: "install_needed",
-		nextAction: {
-			type: "ask_user",
-			question: "The Neon MCP server is not yet configured. Would you like to install it?",
-			options: [
-				{
-					value: "defaults",
-					label: "Yes, install with default settings"
-				},
-				...(() => {
-					const known = options.agent ? tryResolveAddMcpAgentId(options.agent) : void 0;
-					if (known && !agentSupportsProjectMcp(known)) return [];
-					return [{
-						value: "project_scope",
-						label: "Yes, install for this project only"
-					}];
-				})(),
-				{
-					value: "skip",
-					label: "Skip for now"
-				}
-			],
-			context: "The Neon MCP server gives your AI assistant direct access to Neon database operations like creating projects, running queries, and managing branches." + (options.agent?.toLowerCase() === "cursor" || options.editor?.toLowerCase() === "cursor" ? " Note: 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. Global scope is recommended for Cursor." : ""),
-			responseMapping: {
-				defaults: { args: [
-					"mcp",
-					"--json",
-					...options.agent ? ["--agent", options.agent] : [],
-					"--install"
-				] },
-				project_scope: { args: [
-					"mcp",
-					"--json",
-					...options.agent ? ["--agent", options.agent] : [],
-					"--install",
-					"--scope",
-					"project"
-				] },
-				skip: { args: skillsFollowUp(options.agent) }
-			}
-		}
-	};
-	return {
-		phase: "tooling",
-		status: "detection_needed",
-		nextAction: {
-			type: "agent_check",
-			checks: [{
-				id: "mcp_server",
-				description: "Check if the Neon MCP server is already configured in your MCP server list",
-				lookFor: ["An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'"]
-			}],
-			reportBack: {
-				type: "run_neon_init",
-				args: [
-					"mcp",
-					"--json",
-					...options.agent ? ["--agent", options.agent] : [],
-					"--mcp-configured",
-					"<true|false>"
-				]
-			}
-		}
-	};
-}
-//#endregion
-export { handleMcpPhase };

package/dist/init/phases/migrations.js

@@ -1,250 +0,0 @@
-import { DO_NOT_SUBSTITUTE_HINT, MISSING_BINARY_HINT, formatExecCommand, formatInstallCommand, resolvePackageManager } from "../../utils/package_manager.js";
-import { ensureSkillsUpToDate } from "../skills.js";
-//#region src/init/phases/migrations.ts
-async function handleMigrationsPhase(options) {
-	if (options.agent) await ensureSkillsUpToDate(options.agent);
-	const agentArgs = options.agent ? [
-		"--agent",
-		options.agent,
-		"--json"
-	] : ["--json"];
-	const pm = resolvePackageManager(options.cwd);
-	if (options.scaffold) {
-		if (options.scaffold === "prisma") return {
-			phase: "migrations",
-			status: "scaffolding",
-			tool: "prisma",
-			nextAction: {
-				type: "agent_action",
-				steps: [
-					{
-						id: "install_prisma",
-						description: `Install Prisma as a dev dependency. ${DO_NOT_SUBSTITUTE_HINT}`,
-						command: formatInstallCommand(pm, ["prisma"], { dev: true })
-					},
-					{
-						id: "init_prisma",
-						description: `Initialize Prisma with PostgreSQL provider. ${MISSING_BINARY_HINT}`,
-						command: formatExecCommand(pm, "prisma", [
-							"init",
-							"--datasource-provider",
-							"postgresql"
-						])
-					},
-					{
-						id: "configure_env",
-						description: "Ensure DATABASE_URL in .env points to your Neon database. The prisma init command may have created a placeholder — replace it with the real connection string if needed."
-					},
-					{
-						id: "create_schema",
-						description: "Help the user define their initial schema in prisma/schema.prisma based on their application needs."
-					},
-					{
-						id: "run_migration",
-						description: `Create and apply the initial migration. ${MISSING_BINARY_HINT}`,
-						command: formatExecCommand(pm, "prisma", [
-							"migrate",
-							"dev",
-							"--name",
-							"init"
-						])
-					}
-				],
-				onComplete: {
-					type: "complete",
-					message: `Prisma is set up with your Neon database. You can now define models in schema.prisma and run migrations with \`${formatExecCommand(pm, "prisma", ["migrate", "dev"])}\`.`
-				}
-			}
-		};
-		return {
-			phase: "migrations",
-			status: "scaffolding",
-			tool: "drizzle",
-			nextAction: {
-				type: "agent_action",
-				steps: [
-					{
-						id: "install_drizzle",
-						description: `Install Drizzle ORM, drizzle-kit, and the Neon serverless driver. ${DO_NOT_SUBSTITUTE_HINT}`,
-						command: [formatInstallCommand(pm, ["drizzle-orm", "@neondatabase/serverless"]), formatInstallCommand(pm, ["drizzle-kit"], { dev: true })].join(" && ")
-					},
-					{
-						id: "create_config",
-						description: "Create drizzle.config.ts at the project root. Set the dialect to 'postgresql' and dbCredentials.url to process.env.DATABASE_URL."
-					},
-					{
-						id: "create_schema",
-						description: "Create a schema file (e.g. src/db/schema.ts) and help the user define their initial tables using Drizzle's table builder."
-					},
-					{
-						id: "run_migration",
-						description: `Generate and apply the initial migration. ${MISSING_BINARY_HINT}`,
-						command: drizzleGenerateAndMigrate(pm)
-					}
-				],
-				onComplete: {
-					type: "complete",
-					message: `Drizzle ORM is set up with your Neon database. Define tables in your schema file and run migrations with \`${drizzleGenerateAndMigrate(pm)}\`.`
-				}
-			}
-		};
-	}
-	if (options.apply && options.tool) {
-		const applySteps = getMigrationApplySteps(options.tool, pm);
-		return {
-			phase: "migrations",
-			status: "applying",
-			tool: options.tool,
-			nextAction: {
-				type: "agent_action",
-				steps: applySteps,
-				onComplete: {
-					type: "complete",
-					message: "Database migrations applied successfully."
-				}
-			}
-		};
-	}
-	if (options.tool && options.tool !== "none") return {
-		phase: "migrations",
-		status: "found",
-		detected: {
-			tool: options.tool,
-			migrationDir: options.migrationDir ?? null
-		},
-		nextAction: {
-			type: "ask_user",
-			question: `Found ${options.tool} migrations${options.migrationDir ? ` in ${options.migrationDir}` : ""}. Would you like to apply them to your Neon database?`,
-			options: [{
-				value: "apply",
-				label: "Yes, apply migrations"
-			}, {
-				value: "skip",
-				label: "Skip for now"
-			}],
-			responseMapping: {
-				apply: { args: [
-					"migrations",
-					"--json",
-					"--apply",
-					"--tool",
-					options.tool
-				] },
-				skip: { args: [...agentArgs, "--skip-migrations"] }
-			}
-		}
-	};
-	if (options.tool === "none") return {
-		phase: "migrations",
-		status: "none_found",
-		nextAction: {
-			type: "ask_user",
-			question: "No existing database migrations were found. Would you like to set up a migration framework?",
-			options: [
-				{
-					value: "prisma",
-					label: "Prisma (recommended for TypeScript)"
-				},
-				{
-					value: "drizzle",
-					label: "Drizzle ORM"
-				},
-				{
-					value: "skip",
-					label: "Skip - I'll handle migrations myself"
-				}
-			],
-			context: "A migration framework helps you version-control your database schema changes.",
-			responseMapping: {
-				prisma: { args: [
-					"migrations",
-					"--json",
-					"--scaffold",
-					"prisma"
-				] },
-				drizzle: { args: [
-					"migrations",
-					"--json",
-					"--scaffold",
-					"drizzle"
-				] },
-				skip: { args: [...agentArgs, "--skip-migrations"] }
-			}
-		}
-	};
-	return {
-		phase: "migrations",
-		status: "detection_needed",
-		nextAction: {
-			type: "agent_check",
-			checks: [{
-				id: "existing_migrations",
-				description: "Check if the project has existing database migrations",
-				lookFor: [
-					"prisma/migrations/ directory or schema.prisma file",
-					"drizzle/ directory or drizzle.config.ts",
-					"migrations/ or db/migrations/ directory",
-					"knex migration files (knexfile.js/ts)"
-				]
-			}],
-			reportBack: {
-				type: "run_neon_init",
-				args: [
-					"migrations",
-					"--json",
-					"--tool",
-					"<prisma|drizzle|knex|none>",
-					"--migration-dir",
-					"<path|none>"
-				]
-			}
-		}
-	};
-}
-/** `drizzle-kit generate` then `migrate`, both through the project's runner. */
-const drizzleGenerateAndMigrate = (pm) => [formatExecCommand(pm, "drizzle-kit", ["generate"]), formatExecCommand(pm, "drizzle-kit", ["migrate"])].join(" && ");
-function getMigrationApplySteps(tool, pm) {
-	switch (tool) {
-		case "prisma": return [
-			{
-				id: "ensure_env",
-				description: "Verify DATABASE_URL is set in .env"
-			},
-			{
-				id: "apply",
-				description: `Apply migrations to the Neon database. ${MISSING_BINARY_HINT}`,
-				command: formatExecCommand(pm, "prisma", ["migrate", "deploy"])
-			},
-			{
-				id: "generate",
-				description: "Generate the Prisma client.",
-				command: formatExecCommand(pm, "prisma", ["generate"])
-			}
-		];
-		case "drizzle": return [{
-			id: "ensure_env",
-			description: "Verify DATABASE_URL is set in .env"
-		}, {
-			id: "apply",
-			description: `Apply migrations to the Neon database. ${MISSING_BINARY_HINT}`,
-			command: formatExecCommand(pm, "drizzle-kit", ["migrate"])
-		}];
-		case "knex": return [{
-			id: "ensure_env",
-			description: "Verify DATABASE_URL is set in .env"
-		}, {
-			id: "apply",
-			description: `Apply migrations to the Neon database. ${MISSING_BINARY_HINT}`,
-			command: formatExecCommand(pm, "knex", ["migrate:latest"])
-		}];
-		default: return [{
-			id: "ensure_env",
-			description: "Verify DATABASE_URL is set in .env"
-		}, {
-			id: "apply",
-			description: `Apply ${tool} migrations to the Neon database using the appropriate command for your migration tool.`
-		}];
-	}
-}
-//#endregion
-export { handleMigrationsPhase };