neon-init 0.13.1 → 0.15.0

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"}

package/dist/lib/phases/migrations.js

@@ -0,0 +1,239 @@
+import { ensureSkillsUpToDate } from "../skills.js";
+//#region src/lib/phases/migrations.ts
+async function handleMigrationsPhase(options) {
+	if (options.agent) await ensureSkillsUpToDate(options.agent);
+	const agentArgs = options.agent ? [
+		"--agent",
+		options.agent,
+		"--json"
+	] : ["--json"];
+	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",
+						command: "npm install -D prisma"
+					},
+					{
+						id: "init_prisma",
+						description: "Initialize Prisma with PostgreSQL provider",
+						command: "npx 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",
+						command: "npx 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 `npx 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",
+						command: "npm install drizzle-orm @neondatabase/serverless && npm install -D drizzle-kit"
+					},
+					{
+						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",
+						command: "npx drizzle-kit generate && npx drizzle-kit migrate"
+					}
+				],
+				onComplete: {
+					type: "complete",
+					message: "Drizzle ORM is set up with your Neon database. Define tables in your schema file and run migrations with `npx drizzle-kit generate && npx drizzle-kit migrate`."
+				}
+			}
+		};
+	}
+	if (options.apply && options.tool) {
+		const applySteps = getMigrationApplySteps(options.tool);
+		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>"
+				]
+			}
+		}
+	};
+}
+function getMigrationApplySteps(tool) {
+	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",
+				command: "npx prisma migrate deploy"
+			},
+			{
+				id: "generate",
+				description: "Generate the Prisma client",
+				command: "npx 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",
+			command: "npx 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",
+			command: "npx 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 };
+
+//# sourceMappingURL=migrations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","names":[],"sources":["../../../src/lib/phases/migrations.ts"],"sourcesContent":["import { ensureSkillsUpToDate } from \"../skills.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nexport interface MigrationsPhaseOptions {\n\tagent?: string;\n\ttool?: string;\n\tmigrationDir?: string;\n\tscaffold?: \"prisma\" | \"drizzle\";\n\tapply?: boolean;\n}\n\nexport async function handleMigrationsPhase(\n\toptions: MigrationsPhaseOptions,\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 agentArgs = options.agent\n\t\t? [\"--agent\", options.agent, \"--json\"]\n\t\t: [\"--json\"];\n\n\t// --scaffold: set up a new migration framework\n\tif (options.scaffold) {\n\t\tif (options.scaffold === \"prisma\") {\n\t\t\treturn {\n\t\t\t\tphase: \"migrations\",\n\t\t\t\tstatus: \"scaffolding\",\n\t\t\t\ttool: \"prisma\",\n\t\t\t\tnextAction: {\n\t\t\t\t\ttype: \"agent_action\",\n\t\t\t\t\tsteps: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"install_prisma\",\n\t\t\t\t\t\t\tdescription: \"Install Prisma as a dev dependency\",\n\t\t\t\t\t\t\tcommand: \"npm install -D prisma\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"init_prisma\",\n\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\"Initialize Prisma with PostgreSQL provider\",\n\t\t\t\t\t\t\tcommand:\n\t\t\t\t\t\t\t\t\"npx prisma init --datasource-provider postgresql\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"configure_env\",\n\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\"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.\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"create_schema\",\n\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\"Help the user define their initial schema in prisma/schema.prisma based on their application needs.\",\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tid: \"run_migration\",\n\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t\"Create and apply the initial migration\",\n\t\t\t\t\t\t\tcommand: \"npx prisma migrate dev --name init\",\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tonComplete: {\n\t\t\t\t\t\ttype: \"complete\",\n\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\"Prisma is set up with your Neon database. You can now define models in schema.prisma and run migrations with `npx prisma migrate dev`.\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\t// drizzle\n\t\treturn {\n\t\t\tphase: \"migrations\",\n\t\t\tstatus: \"scaffolding\",\n\t\t\ttool: \"drizzle\",\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: \"install_drizzle\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Install Drizzle ORM, drizzle-kit, and the Neon serverless driver\",\n\t\t\t\t\t\tcommand:\n\t\t\t\t\t\t\t\"npm install drizzle-orm @neondatabase/serverless && npm install -D drizzle-kit\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"create_config\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Create drizzle.config.ts at the project root. Set the dialect to 'postgresql' and dbCredentials.url to process.env.DATABASE_URL.\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"create_schema\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Create a schema file (e.g. src/db/schema.ts) and help the user define their initial tables using Drizzle's table builder.\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"run_migration\",\n\t\t\t\t\t\tdescription: \"Generate and apply the initial migration\",\n\t\t\t\t\t\tcommand:\n\t\t\t\t\t\t\t\"npx drizzle-kit generate && npx drizzle-kit migrate\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tonComplete: {\n\t\t\t\t\ttype: \"complete\",\n\t\t\t\t\tmessage:\n\t\t\t\t\t\t\"Drizzle ORM is set up with your Neon database. Define tables in your schema file and run migrations with `npx drizzle-kit generate && npx drizzle-kit migrate`.\",\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// --apply: apply existing migrations\n\tif (options.apply && options.tool) {\n\t\tconst applySteps = getMigrationApplySteps(options.tool);\n\t\treturn {\n\t\t\tphase: \"migrations\",\n\t\t\tstatus: \"applying\",\n\t\t\ttool: options.tool,\n\t\t\tnextAction: {\n\t\t\t\ttype: \"agent_action\",\n\t\t\t\tsteps: applySteps,\n\t\t\t\tonComplete: {\n\t\t\t\t\ttype: \"complete\",\n\t\t\t\t\tmessage: \"Database migrations applied successfully.\",\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// Agent reported detection results via --tool and --migration-dir\n\tif (options.tool && options.tool !== \"none\") {\n\t\treturn {\n\t\t\tphase: \"migrations\",\n\t\t\tstatus: \"found\",\n\t\t\tdetected: {\n\t\t\t\ttool: options.tool,\n\t\t\t\tmigrationDir: options.migrationDir ?? null,\n\t\t\t},\n\t\t\tnextAction: {\n\t\t\t\ttype: \"ask_user\",\n\t\t\t\tquestion: `Found ${options.tool} migrations${options.migrationDir ? ` in ${options.migrationDir}` : \"\"}. Would you like to apply them to your Neon database?`,\n\t\t\t\toptions: [\n\t\t\t\t\t{ value: \"apply\", label: \"Yes, apply migrations\" },\n\t\t\t\t\t{ value: \"skip\", label: \"Skip for now\" },\n\t\t\t\t],\n\t\t\t\tresponseMapping: {\n\t\t\t\t\tapply: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"migrations\",\n\t\t\t\t\t\t\t\"--json\",\n\t\t\t\t\t\t\t\"--apply\",\n\t\t\t\t\t\t\t\"--tool\",\n\t\t\t\t\t\t\toptions.tool,\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t\tskip: { args: [...agentArgs, \"--skip-migrations\"] },\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\tif (options.tool === \"none\") {\n\t\treturn {\n\t\t\tphase: \"migrations\",\n\t\t\tstatus: \"none_found\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"ask_user\",\n\t\t\t\tquestion:\n\t\t\t\t\t\"No existing database migrations were found. Would you like to set up a migration framework?\",\n\t\t\t\toptions: [\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"prisma\",\n\t\t\t\t\t\tlabel: \"Prisma (recommended for TypeScript)\",\n\t\t\t\t\t},\n\t\t\t\t\t{ value: \"drizzle\", label: \"Drizzle ORM\" },\n\t\t\t\t\t{\n\t\t\t\t\t\tvalue: \"skip\",\n\t\t\t\t\t\tlabel: \"Skip - I'll handle migrations myself\",\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tcontext:\n\t\t\t\t\t\"A migration framework helps you version-control your database schema changes.\",\n\t\t\t\tresponseMapping: {\n\t\t\t\t\tprisma: {\n\t\t\t\t\t\targs: [\"migrations\", \"--json\", \"--scaffold\", \"prisma\"],\n\t\t\t\t\t},\n\t\t\t\t\tdrizzle: {\n\t\t\t\t\t\targs: [\"migrations\", \"--json\", \"--scaffold\", \"drizzle\"],\n\t\t\t\t\t},\n\t\t\t\t\tskip: { args: [...agentArgs, \"--skip-migrations\"] },\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// Default: ask agent to detect migration tooling\n\treturn {\n\t\tphase: \"migrations\",\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: \"existing_migrations\",\n\t\t\t\t\tdescription:\n\t\t\t\t\t\t\"Check if the project has existing database migrations\",\n\t\t\t\t\tlookFor: [\n\t\t\t\t\t\t\"prisma/migrations/ directory or schema.prisma file\",\n\t\t\t\t\t\t\"drizzle/ directory or drizzle.config.ts\",\n\t\t\t\t\t\t\"migrations/ or db/migrations/ directory\",\n\t\t\t\t\t\t\"knex migration files (knexfile.js/ts)\",\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\"migrations\",\n\t\t\t\t\t\"--json\",\n\t\t\t\t\t\"--tool\",\n\t\t\t\t\t\"<prisma|drizzle|knex|none>\",\n\t\t\t\t\t\"--migration-dir\",\n\t\t\t\t\t\"<path|none>\",\n\t\t\t\t],\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction getMigrationApplySteps(tool: string) {\n\tswitch (tool) {\n\t\tcase \"prisma\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tid: \"ensure_env\",\n\t\t\t\t\tdescription: \"Verify DATABASE_URL is set in .env\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"apply\",\n\t\t\t\t\tdescription: \"Apply migrations to the Neon database\",\n\t\t\t\t\tcommand: \"npx prisma migrate deploy\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"generate\",\n\t\t\t\t\tdescription: \"Generate the Prisma client\",\n\t\t\t\t\tcommand: \"npx prisma generate\",\n\t\t\t\t},\n\t\t\t];\n\t\tcase \"drizzle\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tid: \"ensure_env\",\n\t\t\t\t\tdescription: \"Verify DATABASE_URL is set in .env\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"apply\",\n\t\t\t\t\tdescription: \"Apply migrations to the Neon database\",\n\t\t\t\t\tcommand: \"npx drizzle-kit migrate\",\n\t\t\t\t},\n\t\t\t];\n\t\tcase \"knex\":\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tid: \"ensure_env\",\n\t\t\t\t\tdescription: \"Verify DATABASE_URL is set in .env\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"apply\",\n\t\t\t\t\tdescription: \"Apply migrations to the Neon database\",\n\t\t\t\t\tcommand: \"npx knex migrate:latest\",\n\t\t\t\t},\n\t\t\t];\n\t\tdefault:\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tid: \"ensure_env\",\n\t\t\t\t\tdescription: \"Verify DATABASE_URL is set in .env\",\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: \"apply\",\n\t\t\t\t\tdescription: `Apply ${tool} migrations to the Neon database using the appropriate command for your migration tool.`,\n\t\t\t\t},\n\t\t\t];\n\t}\n}\n"],"mappings":";;AAWA,eAAsB,sBACrB,SACyB;CAEzB,IAAI,QAAQ,OACX,MAAM,qBAAqB,QAAQ,KAAK;CAEzC,MAAM,YAAY,QAAQ,QACvB;EAAC;EAAW,QAAQ;EAAO;CAAQ,IACnC,CAAC,QAAQ;CAGZ,IAAI,QAAQ,UAAU;EACrB,IAAI,QAAQ,aAAa,UACxB,OAAO;GACN,OAAO;GACP,QAAQ;GACR,MAAM;GACN,YAAY;IACX,MAAM;IACN,OAAO;KACN;MACC,IAAI;MACJ,aAAa;MACb,SAAS;KACV;KACA;MACC,IAAI;MACJ,aACC;MACD,SACC;KACF;KACA;MACC,IAAI;MACJ,aACC;KACF;KACA;MACC,IAAI;MACJ,aACC;KACF;KACA;MACC,IAAI;MACJ,aACC;MACD,SAAS;KACV;IACD;IACA,YAAY;KACX,MAAM;KACN,SACC;IACF;GACD;EACD;EAID,OAAO;GACN,OAAO;GACP,QAAQ;GACR,MAAM;GACN,YAAY;IACX,MAAM;IACN,OAAO;KACN;MACC,IAAI;MACJ,aACC;MACD,SACC;KACF;KACA;MACC,IAAI;MACJ,aACC;KACF;KACA;MACC,IAAI;MACJ,aACC;KACF;KACA;MACC,IAAI;MACJ,aAAa;MACb,SACC;KACF;IACD;IACA,YAAY;KACX,MAAM;KACN,SACC;IACF;GACD;EACD;CACD;CAGA,IAAI,QAAQ,SAAS,QAAQ,MAAM;EAClC,MAAM,aAAa,uBAAuB,QAAQ,IAAI;EACtD,OAAO;GACN,OAAO;GACP,QAAQ;GACR,MAAM,QAAQ;GACd,YAAY;IACX,MAAM;IACN,OAAO;IACP,YAAY;KACX,MAAM;KACN,SAAS;IACV;GACD;EACD;CACD;CAGA,IAAI,QAAQ,QAAQ,QAAQ,SAAS,QACpC,OAAO;EACN,OAAO;EACP,QAAQ;EACR,UAAU;GACT,MAAM,QAAQ;GACd,cAAc,QAAQ,gBAAgB;EACvC;EACA,YAAY;GACX,MAAM;GACN,UAAU,SAAS,QAAQ,KAAK,aAAa,QAAQ,eAAe,OAAO,QAAQ,iBAAiB,GAAG;GACvG,SAAS,CACR;IAAE,OAAO;IAAS,OAAO;GAAwB,GACjD;IAAE,OAAO;IAAQ,OAAO;GAAe,CACxC;GACA,iBAAiB;IAChB,OAAO,EACN,MAAM;KACL;KACA;KACA;KACA;KACA,QAAQ;IACT,EACD;IACA,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,mBAAmB,EAAE;GACnD;EACD;CACD;CAGD,IAAI,QAAQ,SAAS,QACpB,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,UACC;GACD,SAAS;IACR;KACC,OAAO;KACP,OAAO;IACR;IACA;KAAE,OAAO;KAAW,OAAO;IAAc;IACzC;KACC,OAAO;KACP,OAAO;IACR;GACD;GACA,SACC;GACD,iBAAiB;IAChB,QAAQ,EACP,MAAM;KAAC;KAAc;KAAU;KAAc;IAAQ,EACtD;IACA,SAAS,EACR,MAAM;KAAC;KAAc;KAAU;KAAc;IAAS,EACvD;IACA,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,mBAAmB,EAAE;GACnD;EACD;CACD;CAID,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,QAAQ,CACP;IACC,IAAI;IACJ,aACC;IACD,SAAS;KACR;KACA;KACA;KACA;IACD;GACD,CACD;GACA,YAAY;IACX,MAAM;IACN,MAAM;KACL;KACA;KACA;KACA;KACA;KACA;IACD;GACD;EACD;CACD;AACD;AAEA,SAAS,uBAAuB,MAAc;CAC7C,QAAQ,MAAR;EACC,KAAK,UACJ,OAAO;GACN;IACC,IAAI;IACJ,aAAa;GACd;GACA;IACC,IAAI;IACJ,aAAa;IACb,SAAS;GACV;GACA;IACC,IAAI;IACJ,aAAa;IACb,SAAS;GACV;EACD;EACD,KAAK,WACJ,OAAO,CACN;GACC,IAAI;GACJ,aAAa;EACd,GACA;GACC,IAAI;GACJ,aAAa;GACb,SAAS;EACV,CACD;EACD,KAAK,QACJ,OAAO,CACN;GACC,IAAI;GACJ,aAAa;EACd,GACA;GACC,IAAI;GACJ,aAAa;GACb,SAAS;EACV,CACD;EACD,SACC,OAAO,CACN;GACC,IAAI;GACJ,aAAa;EACd,GACA;GACC,IAAI;GACJ,aAAa,SAAS,KAAK;EAC5B,CACD;CACF;AACD"}

package/dist/lib/phases/neon-auth.d.ts

@@ -0,0 +1,13 @@
+import { PhaseResponse } from "../types.js";
+
+//#region src/lib/phases/neon-auth.d.ts
+interface NeonAuthPhaseOptions {
+  agent?: string;
+  setup?: boolean;
+  info?: boolean;
+  projectId?: string;
+}
+declare function handleNeonAuthPhase(options: NeonAuthPhaseOptions): Promise<PhaseResponse>;
+//#endregion
+export { NeonAuthPhaseOptions, handleNeonAuthPhase };
+//# sourceMappingURL=neon-auth.d.ts.map

package/dist/lib/phases/neon-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon-auth.d.ts","names":[],"sources":["../../../src/lib/phases/neon-auth.ts"],"mappings":";;;UAGiB,oBAAA;;EAAA,KAAA,CAAA,EAAA,OAAA;EAOK,IAAA,CAAA,EAAA,OAAA;EAAmB,SAAA,CAAA,EAAA,MAAA;;AAE9B,iBAFW,mBAAA,CAEX,OAAA,EADD,oBACC,CAAA,EAAR,OAAQ,CAAA,aAAA,CAAA"}

package/dist/lib/phases/neon-auth.js

@@ -0,0 +1,117 @@
+import { SKILL_REFERENCE_URLS, ensureSkillsUpToDate } from "../skills.js";
+//#region src/lib/phases/neon-auth.ts
+async function handleNeonAuthPhase(options) {
+	if (options.projectId && !/^[\w.:-]+$/.test(options.projectId)) throw new Error(`Invalid project ID: "${options.projectId}". Expected alphanumeric, hyphens, underscores, dots, or colons.`);
+	if (options.agent) await ensureSkillsUpToDate(options.agent);
+	if (options.info) return {
+		phase: "neon_auth",
+		status: "info",
+		nextAction: {
+			type: "ask_user",
+			question: "Neon Auth provides drop-in user authentication that integrates with your Neon database. It handles user sign-up, sign-in, and session management. Would you like to set it up?",
+			options: [{
+				value: "yes",
+				label: "Yes, set up Neon Auth"
+			}, {
+				value: "no",
+				label: "No, skip for now"
+			}],
+			context: `Full documentation: ${SKILL_REFERENCE_URLS.neonAuth}`,
+			responseMapping: {
+				yes: { args: [
+					"neon-auth",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					"--setup",
+					...options.projectId ? ["--project-id", options.projectId] : []
+				] },
+				no: { args: [
+					"finalize",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : []
+				] }
+			}
+		}
+	};
+	if (options.setup) return {
+		phase: "neon_auth",
+		status: "in_progress",
+		nextAction: {
+			type: "agent_action",
+			prerequisite: SKILL_REFERENCE_URLS.neonAuth,
+			steps: [
+				{
+					id: "provision",
+					description: "Enable Neon Auth on the project using the neonctl CLI. Run: `CI= npx -y neonctl neon-auth enable --project-id <project-id> --output json`. You can check current status with: `CI= npx -y neonctl neon-auth status --project-id <project-id> --output json`." + (options.projectId ? ` Project ID: ${options.projectId}.` : " Determine the project ID from the .neon file in the project root, or from the DATABASE_URL in .env, or ask the user.")
+				},
+				{
+					id: "install_packages",
+					description: "Install required packages per the skill reference. The exact packages depend on the framework (Next.js, React, etc.)."
+				},
+				{
+					id: "create_components",
+					description: "Create auth components per the skill reference. Follow the exact patterns and imports specified."
+				},
+				{
+					id: "pull_env",
+					description: "Run `neonctl env pull` to populate the NEON_AUTH_BASE_URL, NEON_AUTH_JWKS_URL, and other Neon Auth environment variables. This reads the .neon context file and writes the auth URLs to the project's env file.",
+					command: "CI= npx -y neonctl env pull"
+				}
+			],
+			onComplete: {
+				type: "run_neon_init",
+				args: [
+					"finalize",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : []
+				]
+			}
+		}
+	};
+	return {
+		phase: "neon_auth",
+		status: "optional",
+		nextAction: {
+			type: "ask_user",
+			question: "Would you like to set up Neon Auth for user authentication in your app?",
+			options: [
+				{
+					value: "yes",
+					label: "Yes, set up Neon Auth"
+				},
+				{
+					value: "no",
+					label: "No, skip for now"
+				},
+				{
+					value: "info",
+					label: "Tell me more about Neon Auth"
+				}
+			],
+			context: "Neon Auth provides drop-in user authentication that integrates with your Neon database.",
+			responseMapping: {
+				yes: { args: [
+					"neon-auth",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					"--setup"
+				] },
+				no: { args: [
+					"finalize",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : []
+				] },
+				info: { args: [
+					"neon-auth",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					"--info"
+				] }
+			}
+		}
+	};
+}
+//#endregion
+export { handleNeonAuthPhase };
+
+//# sourceMappingURL=neon-auth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"neon-auth.js","names":[],"sources":["../../../src/lib/phases/neon-auth.ts"],"sourcesContent":["import { ensureSkillsUpToDate, SKILL_REFERENCE_URLS } from \"../skills.js\";\nimport type { PhaseResponse } from \"../types.js\";\n\nexport interface NeonAuthPhaseOptions {\n\tagent?: string;\n\tsetup?: boolean;\n\tinfo?: boolean;\n\tprojectId?: string;\n}\n\nexport async function handleNeonAuthPhase(\n\toptions: NeonAuthPhaseOptions,\n): Promise<PhaseResponse> {\n\t// Validate IDs that may be interpolated into instruction strings\n\tif (options.projectId && !/^[\\w.:-]+$/.test(options.projectId)) {\n\t\tthrow new Error(\n\t\t\t`Invalid project ID: \"${options.projectId}\". Expected alphanumeric, hyphens, underscores, dots, or colons.`,\n\t\t);\n\t}\n\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\t// --info: return information about Neon Auth\n\tif (options.info) {\n\t\treturn {\n\t\t\tphase: \"neon_auth\",\n\t\t\tstatus: \"info\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"ask_user\",\n\t\t\t\tquestion:\n\t\t\t\t\t\"Neon Auth provides drop-in user authentication that integrates with your Neon database. It handles user sign-up, sign-in, and session management. Would you like to set it up?\",\n\t\t\t\toptions: [\n\t\t\t\t\t{ value: \"yes\", label: \"Yes, set up Neon Auth\" },\n\t\t\t\t\t{ value: \"no\", label: \"No, skip for now\" },\n\t\t\t\t],\n\t\t\t\tcontext: `Full documentation: ${SKILL_REFERENCE_URLS.neonAuth}`,\n\t\t\t\tresponseMapping: {\n\t\t\t\t\tyes: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"neon-auth\",\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\"--setup\",\n\t\t\t\t\t\t\t...(options.projectId\n\t\t\t\t\t\t\t\t? [\"--project-id\", options.projectId]\n\t\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\tno: {\n\t\t\t\t\t\targs: [\n\t\t\t\t\t\t\t\"finalize\",\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],\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// --setup: guide through Neon Auth configuration\n\tif (options.setup) {\n\t\treturn {\n\t\t\tphase: \"neon_auth\",\n\t\t\tstatus: \"in_progress\",\n\t\t\tnextAction: {\n\t\t\t\ttype: \"agent_action\",\n\t\t\t\tprerequisite: SKILL_REFERENCE_URLS.neonAuth,\n\t\t\t\tsteps: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"provision\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Enable Neon Auth on the project using the neonctl CLI. \" +\n\t\t\t\t\t\t\t\"Run: `CI= npx -y neonctl neon-auth enable --project-id <project-id> --output json`. \" +\n\t\t\t\t\t\t\t\"You can check current status with: `CI= npx -y neonctl neon-auth status --project-id <project-id> --output json`.\" +\n\t\t\t\t\t\t\t(options.projectId\n\t\t\t\t\t\t\t\t? ` Project ID: ${options.projectId}.`\n\t\t\t\t\t\t\t\t: \" Determine the project ID from the .neon file in the project root, or from the DATABASE_URL in .env, or ask the user.\"),\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"install_packages\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Install required packages per the skill reference. The exact packages depend on the framework (Next.js, React, etc.).\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"create_components\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Create auth components per the skill reference. Follow the exact patterns and imports specified.\",\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"pull_env\",\n\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\"Run `neonctl env pull` to populate the NEON_AUTH_BASE_URL, NEON_AUTH_JWKS_URL, and other Neon Auth environment variables. This reads the .neon context file and writes the auth URLs to the project's env file.\",\n\t\t\t\t\t\tcommand: \"CI= npx -y neonctl env pull\",\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: [\n\t\t\t\t\t\t\"finalize\",\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],\n\t\t\t\t},\n\t\t\t},\n\t\t};\n\t}\n\n\t// Default: ask if they want Neon Auth\n\treturn {\n\t\tphase: \"neon_auth\",\n\t\tstatus: \"optional\",\n\t\tnextAction: {\n\t\t\ttype: \"ask_user\",\n\t\t\tquestion:\n\t\t\t\t\"Would you like to set up Neon Auth for user authentication in your app?\",\n\t\t\toptions: [\n\t\t\t\t{ value: \"yes\", label: \"Yes, set up Neon Auth\" },\n\t\t\t\t{ value: \"no\", label: \"No, skip for now\" },\n\t\t\t\t{ value: \"info\", label: \"Tell me more about Neon Auth\" },\n\t\t\t],\n\t\t\tcontext:\n\t\t\t\t\"Neon Auth provides drop-in user authentication that integrates with your Neon database.\",\n\t\t\tresponseMapping: {\n\t\t\t\tyes: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"neon-auth\",\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\"--setup\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tno: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"finalize\",\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],\n\t\t\t\t},\n\t\t\t\tinfo: {\n\t\t\t\t\targs: [\n\t\t\t\t\t\t\"neon-auth\",\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\"--info\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n"],"mappings":";;AAUA,eAAsB,oBACrB,SACyB;CAEzB,IAAI,QAAQ,aAAa,CAAC,aAAa,KAAK,QAAQ,SAAS,GAC5D,MAAM,IAAI,MACT,wBAAwB,QAAQ,UAAU,iEAC3C;CAID,IAAI,QAAQ,OACX,MAAM,qBAAqB,QAAQ,KAAK;CAGzC,IAAI,QAAQ,MACX,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,UACC;GACD,SAAS,CACR;IAAE,OAAO;IAAO,OAAO;GAAwB,GAC/C;IAAE,OAAO;IAAM,OAAO;GAAmB,CAC1C;GACA,SAAS,uBAAuB,qBAAqB;GACrD,iBAAiB;IAChB,KAAK,EACJ,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QACT,CAAC,WAAW,QAAQ,KAAK,IACzB,CAAC;KACJ;KACA,GAAI,QAAQ,YACT,CAAC,gBAAgB,QAAQ,SAAS,IAClC,CAAC;IACL,EACD;IACA,IAAI,EACH,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QACT,CAAC,WAAW,QAAQ,KAAK,IACzB,CAAC;IACL,EACD;GACD;EACD;CACD;CAID,IAAI,QAAQ,OACX,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,cAAc,qBAAqB;GACnC,OAAO;IACN;KACC,IAAI;KACJ,aACC,kQAGC,QAAQ,YACN,gBAAgB,QAAQ,UAAU,KAClC;IACL;IACA;KACC,IAAI;KACJ,aACC;IACF;IACA;KACC,IAAI;KACJ,aACC;IACF;IACA;KACC,IAAI;KACJ,aACC;KACD,SAAS;IACV;GACD;GACA,YAAY;IACX,MAAM;IACN,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QAAQ,CAAC,WAAW,QAAQ,KAAK,IAAI,CAAC;IACnD;GACD;EACD;CACD;CAID,OAAO;EACN,OAAO;EACP,QAAQ;EACR,YAAY;GACX,MAAM;GACN,UACC;GACD,SAAS;IACR;KAAE,OAAO;KAAO,OAAO;IAAwB;IAC/C;KAAE,OAAO;KAAM,OAAO;IAAmB;IACzC;KAAE,OAAO;KAAQ,OAAO;IAA+B;GACxD;GACA,SACC;GACD,iBAAiB;IAChB,KAAK,EACJ,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QAAQ,CAAC,WAAW,QAAQ,KAAK,IAAI,CAAC;KAClD;IACD,EACD;IACA,IAAI,EACH,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QAAQ,CAAC,WAAW,QAAQ,KAAK,IAAI,CAAC;IACnD,EACD;IACA,MAAM,EACL,MAAM;KACL;KACA;KACA,GAAI,QAAQ,QAAQ,CAAC,WAAW,QAAQ,KAAK,IAAI,CAAC;KAClD;IACD,EACD;GACD;EACD;CACD;AACD"}