neon-init 0.14.0 → 0.16.0

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

@@ -0,0 +1,196 @@
+import { neonctlCmd } from "../neonctl.js";
+import { SKILL_REFERENCE_URLS, ensureSkillsUpToDate } from "../skills.js";
+//#region src/lib/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 neonctl CLI.
+*/
+async function handleGettingStartedPhase(options) {
+	if (options.agent) await ensureSkillsUpToDate(options.agent);
+	const steps = [];
+	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: 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'.",
+				"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 project dependencies using the appropriate package manager (check for pnpm-lock.yaml, yarn.lock, bun.lockb, or default to npm).",
+				"This must be done before `neonctl env pull` because the project's Neon config file may import packages that need to be installed first."
+			].join(" "),
+			command: "npm install"
+		});
+		steps.push({
+			id: "pull_env",
+			description: [
+				"Now that the .neon context file is in place and dependencies are installed, run `neonctl 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."].join(" "),
+			command: "npm install @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.",
+			command: "npm install @neondatabase/serverless"
+		});
+		else if (!options.orm || options.orm === "none") steps.push({
+			id: "install_driver",
+			description: "Install the Neon serverless driver for direct database access.",
+			command: "npm install @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") 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 `npx drizzle-kit migrate`.",
+				"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.",
+				"If neither schema nor migrations exist, skip this step."
+			].join(" "),
+			command: "npx drizzle-kit migrate"
+		});
+		else if (tool === "prisma") 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 `npx prisma migrate deploy`.",
+				"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.",
+				"If no models are defined, skip this step."
+			].join(" "),
+			command: "npx prisma migrate deploy"
+		});
+		else if (tool === "knex") steps.push({
+			id: "run_migrations",
+			description: `Apply existing knex migrations to the Neon database.`,
+			command: "npx 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 `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`.",
+			"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`.",
+			"If no migration tool is found, skip this step."
+		].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 neonctl 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 };
+
+//# sourceMappingURL=getting-started.js.map

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

@@ -0,0 +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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"}

package/dist/lib/phases/mcp.d.ts

@@ -0,0 +1,15 @@
+import { Editor, PhaseResponse } from "../types.js";
+
+//#region src/lib/phases/mcp.d.ts
+interface McpPhaseOptions {
+  agent?: string;
+  editor?: Editor;
+  status?: boolean;
+  install?: boolean;
+  scope?: "global" | "project";
+  mcpConfigured?: boolean | null;
+}
+declare function handleMcpPhase(options: McpPhaseOptions): Promise<PhaseResponse>;
+//#endregion
+export { McpPhaseOptions, handleMcpPhase };
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","names":[],"sources":["../../../src/lib/phases/mcp.ts"],"mappings":";;;UAIiB,eAAA;;EAAA,MAAA,CAAA,EAEP,MAFO;EASK,MAAA,CAAA,EAAA,OAAA;EAAc,OAAA,CAAA,EAAA,OAAA;OAC1B,CAAA,EAAA,QAAA,GAAA,SAAA;eACC,CAAA,EAAA,OAAA,GAAA,IAAA;;AAAD,iBAFY,cAAA,CAEZ,OAAA,EADA,eACA,CAAA,EAAP,OAAO,CAAC,aAAD,CAAA"}

package/dist/lib/phases/mcp.js

@@ -0,0 +1,179 @@
+import { resolveAddMcpAgentId } from "../agents.js";
+import { isAuthenticated } from "../auth.js";
+//#region src/lib/phases/mcp.ts
+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 isCursor = mcpAgentId === "cursor" || options.agent?.toLowerCase() === "cursor";
+		const isClaudeCode = mcpAgentId === "claude-code" || options.agent?.toLowerCase() === "claude-code";
+		const installCmd = [
+			"npx -y add-mcp https://mcp.neon.tech/mcp",
+			scope === "global" ? "-g" : "",
+			"-n Neon",
+			"-y",
+			`-a ${mcpAgentId}`
+		].filter(Boolean).join(" ");
+		let enableNote = "";
+		if (isCursor && scope === "project") enableNote = " Note: Cursor disables project-level MCP servers by default — after installation, open Cursor Settings > MCP and toggle the \"Neon\" server on.";
+		else if (isClaudeCode) enableNote = " Note: Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" server to enable it.";
+		return {
+			phase: "tooling",
+			status: "installing",
+			nextAction: {
+				type: "run_command",
+				command: installCmd,
+				description: `Installing Neon MCP server (${scope} scope) for ${mcpAgentId}.${enableNote}`,
+				timeout: 6e4,
+				onSuccess: {
+					type: "run_neon_init",
+					args: [
+						"skills",
+						"--json",
+						...options.agent ? ["--agent", options.agent] : [],
+						"--install"
+					]
+				},
+				onFailure: { other: {
+					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"
+						] },
+						manual: { args: agentArgs }
+					}
+				} }
+			}
+		};
+	}
+	if (options.mcpConfigured === true) return {
+		phase: "tooling",
+		status: "mcp_configured",
+		nextAction: {
+			type: "run_neon_init",
+			args: [
+				"skills",
+				"--json",
+				...options.agent ? ["--agent", options.agent] : [],
+				"--install"
+			]
+		}
+	};
+	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"
+				},
+				{
+					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: [
+					"skills",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					"--install"
+				] }
+			}
+		}
+	};
+	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 };
+
+//# sourceMappingURL=mcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","names":[],"sources":["../../../src/lib/phases/mcp.ts"],"sourcesContent":["import { resolveAddMcpAgentId } from \"../agents.js\";\nimport { isAuthenticated } from \"../auth.js\";\nimport type { Editor, PhaseResponse } from \"../types.js\";\n\nexport interface McpPhaseOptions {\n\tagent?: string;\n\teditor?: Editor;\n\tstatus?: boolean;\n\tinstall?: boolean;\n\tscope?: \"global\" | \"project\";\n\tmcpConfigured?: boolean | null;\n}\n\nexport async function handleMcpPhase(\n\toptions: McpPhaseOptions,\n): Promise<PhaseResponse> {\n\tconst agentArgs = options.agent\n\t\t? [\"--agent\", options.agent, \"--json\"]\n\t\t: [\"--json\"];\n\n\t// --status: just report what we know\n\tif (options.status) {\n\t\treturn {\n\t\t\tphase: \"tooling\",\n\t\t\tstatus: \"status\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"agent_check\",\n\t\t\t\tchecks: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"mcp_server\",\n\t\t\t\t\t\tdescription:\n\t\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\t\tlookFor: [\n\t\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\t],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\treportBack: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"mcp\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...(options.agent ? [\"--agent\", options.agent] : []),\n\t\t\t\t\t\t\"--mcp-configured\",\n\t\t\t\t\t\t\"<true|false>\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// --install: proceed with installation\n\tif (options.install) {\n\t\tconst authed = await isAuthenticated();\n\t\tif (!authed) {\n\t\t\treturn {\n\t\t\t\tphase: \"tooling\",\n\t\t\t\tstatus: \"auth_required\",\n\t\t\t\tnextAction: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\"auth\", \"--json\"],\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\t// Build the add-mcp command\n\t\tconst scope = options.scope ?? \"global\";\n\t\tconst mcpAgentId = resolveAddMcpAgentId(options.agent ?? \"claude-code\");\n\t\tconst isCursor =\n\t\t\tmcpAgentId === \"cursor\" ||\n\t\t\toptions.agent?.toLowerCase() === \"cursor\";\n\t\tconst isClaudeCode =\n\t\t\tmcpAgentId === \"claude-code\" ||\n\t\t\toptions.agent?.toLowerCase() === \"claude-code\";\n\t\tconst installCmd = [\n\t\t\t\"npx -y add-mcp https://mcp.neon.tech/mcp\",\n\t\t\tscope === \"global\" ? \"-g\" : \"\",\n\t\t\t\"-n Neon\",\n\t\t\t\"-y\",\n\t\t\t`-a ${mcpAgentId}`,\n\t\t]\n\t\t\t.filter(Boolean)\n\t\t\t.join(\" \");\n\n\t\tlet enableNote = \"\";\n\t\tif (isCursor && scope === \"project\") {\n\t\t\tenableNote =\n\t\t\t\t' Note: Cursor disables project-level MCP servers by default — after installation, open Cursor Settings > MCP and toggle the \"Neon\" server on.';\n\t\t} else if (isClaudeCode) {\n\t\t\tenableNote =\n\t\t\t\t' Note: Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" server to enable it.';\n\t\t}\n\n\t\treturn {\n\t\t\tphase: \"tooling\",\n\t\t\tstatus: \"installing\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_command\",\n\t\t\t\tcommand: installCmd,\n\t\t\t\tdescription: `Installing Neon MCP server (${scope} scope) for ${mcpAgentId}.${enableNote}`,\n\t\t\t\ttimeout: 60000,\n\t\t\t\tonSuccess: {\n\t\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t...(options.agent ? [\"--agent\", options.agent] : []),\n\t\t\t\t\t\t\"--install\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tonFailure: {\n\t\t\t\t\tother: {\n\t\t\t\t\t\ttype: \"ask_user\",\n\t\t\t\t\t\tquestion:\n\t\t\t\t\t\t\t\"Failed to install the Neon MCP server automatically. Would you like to try again or configure it manually?\",\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ value: \"retry\", label: \"Try again\" },\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tvalue: \"manual\",\n\t\t\t\t\t\t\t\tlabel: \"I'll configure it manually\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\tresponseMapping: {\n\t\t\t\t\t\t\tretry: {\n\t\t\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\t\t\"mcp\",\n\t\t\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\t\t...(options.agent\n\t\t\t\t\t\t\t\t\t\t? [\"--agent\", options.agent]\n\t\t\t\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t\t\t\t\"--install\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tmanual: {\n\t\t\t\t\t\t\t\targs: agentArgs,\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},\n\t\t};\n\t}\n\n\t// Agent reported detection result via --mcp-configured\n\tif (options.mcpConfigured === true) {\n\t\t// MCP is done — chain to skills installation (not back to orchestrator,\n\t\t// which would re-check MCP and loop since skills aren't installed yet).\n\t\treturn {\n\t\t\tphase: \"tooling\",\n\t\t\tstatus: \"mcp_configured\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\n\t\t\t\t\t\"skills\",\n\t\t\t\t\t\"--json\",\n\t\t\t\t\t...(options.agent ? [\"--agent\", options.agent] : []),\n\t\t\t\t\t\"--install\",\n\t\t\t\t],\n\t\t\t},\n\t\t};\n\t}\n\n\tif (options.mcpConfigured === false) {\n\t\treturn {\n\t\t\tphase: \"tooling\",\n\t\t\tstatus: \"install_needed\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"ask_user\",\n\t\t\t\tquestion:\n\t\t\t\t\t\"The Neon MCP server is not yet configured. Would you like to install it?\",\n\t\t\t\toptions: [\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"defaults\",\n\t\t\t\t\t\tlabel: \"Yes, install with default settings\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"project_scope\",\n\t\t\t\t\t\tlabel: \"Yes, install for this project only\",\n\t\t\t\t\t},\n\t\t\t\t\t{ value: \"skip\", label: \"Skip for now\" },\n\t\t\t\t],\n\t\t\t\tcontext:\n\t\t\t\t\t\"The Neon MCP server gives your AI assistant direct access to Neon database operations like creating projects, running queries, and managing branches.\" +\n\t\t\t\t\t(options.agent?.toLowerCase() === \"cursor\" ||\n\t\t\t\t\toptions.editor?.toLowerCase() === \"cursor\"\n\t\t\t\t\t\t? \" 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.\"\n\t\t\t\t\t\t: \"\"),\n\t\t\t\tresponseMapping: {\n\t\t\t\t\tdefaults: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"mcp\",\n\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t...(options.agent\n\t\t\t\t\t\t\t\t? [\"--agent\", options.agent]\n\t\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t\t\"--install\",\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t\tproject_scope: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"mcp\",\n\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t...(options.agent\n\t\t\t\t\t\t\t\t? [\"--agent\", options.agent]\n\t\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t\t\"--install\",\n\t\t\t\t\t\t\t\"--scope\",\n\t\t\t\t\t\t\t\"project\",\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t\tskip: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t...(options.agent\n\t\t\t\t\t\t\t\t? [\"--agent\", options.agent]\n\t\t\t\t\t\t\t\t: []),\n\t\t\t\t\t\t\t\"--install\",\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\t// Default: ask the agent to check\n\treturn {\n\t\tphase: \"tooling\",\n\t\tstatus: \"detection_needed\",\n\t\tnextAction: {\n\t\t\ttype: \"agent_check\",\n\t\t\tchecks: [\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],\n\t\t\treportBack: {\n\t\t\t\ttype: \"run_neon_init\",\n\t\t\t\targs: [\n\t\t\t\t\t\"mcp\",\n\t\t\t\t\t\"--json\",\n\t\t\t\t\t...(options.agent ? [\"--agent\", options.agent] : []),\n\t\t\t\t\t\"--mcp-configured\",\n\t\t\t\t\t\"<true|false>\",\n\t\t\t\t],\n\t\t\t},\n\t\t},\n\t};\n}\n"],"mappings":"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"}

package/dist/lib/phases/migrations.d.ts

@@ -0,0 +1,14 @@
+import { PhaseResponse } from "../types.js";
+
+//#region src/lib/phases/migrations.d.ts
+interface MigrationsPhaseOptions {
+  agent?: string;
+  tool?: string;
+  migrationDir?: string;
+  scaffold?: "prisma" | "drizzle";
+  apply?: boolean;
+}
+declare function handleMigrationsPhase(options: MigrationsPhaseOptions): Promise<PhaseResponse>;
+//#endregion
+export { MigrationsPhaseOptions, handleMigrationsPhase };
+//# sourceMappingURL=migrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","names":[],"sources":["../../../src/lib/phases/migrations.ts"],"mappings":";;;UAGiB,sBAAA;;EAAA,IAAA,CAAA,EAAA,MAAA;EAQK,YAAA,CAAA,EAAA,MAAA;EAAqB,QAAA,CAAA,EAAA,QAAA,GAAA,SAAA;OACjC,CAAA,EAAA,OAAA;;AACP,iBAFmB,qBAAA,CAEnB,OAAA,EADO,sBACP,CAAA,EAAA,OAAA,CAAQ,aAAR,CAAA"}