neon-init 0.14.0 → 0.16.0

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":";;;UAIiB,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,118 @@
+import { neonctlCmd } from "../neonctl.js";
+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: \`${neonctlCmd()} neon-auth enable --project-id <project-id> --output json\`. You can check current status with: \`${neonctlCmd()} 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 \`${neonctlCmd()} 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: `${neonctlCmd()} 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 { neonctlCmd } from \"../neonctl.js\";\nimport { 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: \\`${neonctlCmd()} neon-auth enable --project-id <project-id> --output json\\`. ` +\n\t\t\t\t\t\t\t`You can check current status with: \\`${neonctlCmd()} 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: `Run \\`${neonctlCmd()} 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: `${neonctlCmd()} 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":";;;AAWA,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,iEACU,WAAW,EAAE,oGACiB,WAAW,EAAE,iEACpD,QAAQ,YACN,gBAAgB,QAAQ,UAAU,KAClC;IACL;IACA;KACC,IAAI;KACJ,aACC;IACF;IACA;KACC,IAAI;KACJ,aACC;IACF;IACA;KACC,IAAI;KACJ,aAAa,SAAS,WAAW,EAAE;KACnC,SAAS,GAAG,WAAW,EAAE;IAC1B;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"}

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

@@ -0,0 +1,41 @@
+import { PhaseResponse } from "../types.js";
+import { NeonFeature } from "../bootstrap.js";
+
+//#region src/lib/phases/setup.d.ts
+interface SetupPhaseOptions {
+  agent?: string;
+  /** The IDE/editor the user is running in (e.g. "cursor", "vscode") — reported by agent */
+  ide?: string;
+  /** Whether the directory already contains an application */
+  hasApp?: boolean;
+  /** Template ID to scaffold (when bootstrapping a new project) */
+  template?: string;
+  /** Neon features required by the selected template */
+  templateRequires?: NeonFeature[];
+  /** Neon features selected by the user (brownfield flows) */
+  features?: NeonFeature[];
+  mcpConfigured?: boolean | null;
+  connectionString?: boolean | null;
+  connectionParams?: string;
+  framework?: string;
+  orm?: string;
+  migrationTool?: string;
+  migrationDir?: string;
+  isVscodeIde?: boolean | null;
+  mode?: "defaults" | "customize";
+  mcpScope?: "global" | "project" | "none";
+  skillsScope?: "global" | "project";
+  installExtension?: boolean;
+  execute?: boolean;
+}
+/**
+ * Comprehensive setup phase: inspects repo state, collects user preferences,
+ * then batches all installation commands together.
+ *
+ * With --data JSON, the agent sends inspection results AND user preferences
+ * in a single call, so the CLI can go straight to installation.
+ */
+declare function handleSetupPhase(options: SetupPhaseOptions): Promise<PhaseResponse>;
+//#endregion
+export { SetupPhaseOptions, handleSetupPhase };
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","names":[],"sources":["../../../src/lib/phases/setup.ts"],"mappings":";;;;UAsBiB,iBAAA;;EAAA;EAAiB,GAAA,CAAA,EAAA,MAAA;;QAWtB,CAAA,EAAA,OAAA;EAAW;EA0BD,QAAA,CAAA,EAAA,MAAA;EAAgB;kBAC5B,CAAA,EA7BU,WA6BV,EAAA;;UACP,CAAA,EA5BS,WA4BT,EAAA;EAAO,aAAA,CAAA,EAAA,OAAA,GAAA,IAAA;;;;;;;;;;;;;;;;;;;;;iBAFY,gBAAA,UACZ,oBACP,QAAQ"}