neon 2.47.0 → 3.1.0

package/dist/init/phases/skills.js

@@ -1,89 +1,78 @@
 import { getSkillsAgentName } from "../agents.js";
 import { SKILL_REFERENCE_URLS } from "../skills.js";
-export async function handleSkillsPhase(options) {
-    const agentArgs = options.agent
-        ? ["--agent", options.agent, "--json"]
-        : ["--json"];
-    const skillsAgent = options.agent
-        ? getSkillsAgentName(options.agent)
-        : "claude-code";
-    // --status: ask agent to check
-    if (options.status) {
-        return {
-            phase: "tooling",
-            status: "skills_check",
-            nextAction: {
-                type: "agent_check",
-                checks: [
-                    {
-                        id: "skills",
-                        description: "Check if Neon agent skills are installed in this project",
-                        lookFor: [
-                            "A skill file referencing 'neon-postgres' (e.g. .cursor/skills/, CLAUDE.md, .cursorrules)",
-                            "A .skills/ directory with neon-related content",
-                        ],
-                    },
-                ],
-                reportBack: {
-                    type: "run_neon_init",
-                    args: [
-                        "skills",
-                        "--json",
-                        ...(options.agent ? ["--agent", options.agent] : []),
-                        ...(options.update ? ["--update"] : ["--install"]),
-                    ],
-                },
-            },
-        };
-    }
-    // --install or --update: run the skills CLI
-    if (options.install || options.update) {
-        const installCmd = `npx -y skills add neondatabase/agent-skills --skill neon-postgres --agent ${skillsAgent} -y`;
-        return {
-            phase: "tooling",
-            status: "installing_skills",
-            nextAction: {
-                type: "run_command",
-                command: installCmd,
-                description: `Installing Neon agent skills for ${skillsAgent}.`,
-                timeout: 30000,
-                onSuccess: {
-                    type: "run_neon_init",
-                    args: agentArgs,
-                },
-                onFailure: {
-                    other: {
-                        type: "run_neon_init",
-                        args: agentArgs,
-                    },
-                },
-            },
-            skillReferences: SKILL_REFERENCE_URLS,
-        };
-    }
-    // Default: ask if they want skills installed
-    return {
-        phase: "tooling",
-        status: "skills_available",
-        nextAction: {
-            type: "ask_user",
-            question: "Would you like to install Neon agent skills for this project? Skills provide your AI assistant with Neon-specific knowledge.",
-            options: [
-                { value: "yes", label: "Yes, install skills" },
-                { value: "skip", label: "Skip for now" },
-            ],
-            context: "Agent skills include guides for connection patterns, Neon Auth setup, branching, migrations, and more.",
-            responseMapping: {
-                yes: {
-                    args: [
-                        "skills",
-                        "--json",
-                        ...(options.agent ? ["--agent", options.agent] : []),
-                        "--install",
-                    ],
-                },
-                skip: { args: agentArgs },
-            },
-        },
-    };
+//#region src/init/phases/skills.ts
+async function handleSkillsPhase(options) {
+	const agentArgs = options.agent ? [
+		"--agent",
+		options.agent,
+		"--json"
+	] : ["--json"];
+	const skillsAgent = options.agent ? getSkillsAgentName(options.agent) : "claude-code";
+	if (options.status) return {
+		phase: "tooling",
+		status: "skills_check",
+		nextAction: {
+			type: "agent_check",
+			checks: [{
+				id: "skills",
+				description: "Check if Neon agent skills are installed in this project",
+				lookFor: ["A skill file referencing 'neon-postgres' (e.g. .cursor/skills/, CLAUDE.md, .cursorrules)", "A .skills/ directory with neon-related content"]
+			}],
+			reportBack: {
+				type: "run_neon_init",
+				args: [
+					"skills",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					...options.update ? ["--update"] : ["--install"]
+				]
+			}
+		}
+	};
+	if (options.install || options.update) return {
+		phase: "tooling",
+		status: "installing_skills",
+		nextAction: {
+			type: "run_command",
+			command: `npx -y skills add neondatabase/agent-skills --skill neon-postgres --agent ${skillsAgent} -y`,
+			description: `Installing Neon agent skills for ${skillsAgent}.`,
+			timeout: 3e4,
+			onSuccess: {
+				type: "run_neon_init",
+				args: agentArgs
+			},
+			onFailure: { other: {
+				type: "run_neon_init",
+				args: agentArgs
+			} }
+		},
+		skillReferences: SKILL_REFERENCE_URLS
+	};
+	return {
+		phase: "tooling",
+		status: "skills_available",
+		nextAction: {
+			type: "ask_user",
+			question: "Would you like to install Neon agent skills for this project? Skills provide your AI assistant with Neon-specific knowledge.",
+			options: [{
+				value: "yes",
+				label: "Yes, install skills"
+			}, {
+				value: "skip",
+				label: "Skip for now"
+			}],
+			context: "Agent skills include guides for connection patterns, Neon Auth setup, branching, migrations, and more.",
+			responseMapping: {
+				yes: { args: [
+					"skills",
+					"--json",
+					...options.agent ? ["--agent", options.agent] : [],
+					"--install"
+				] },
+				skip: { args: agentArgs }
+			}
+		}
+	};
 }
+//#endregion
+export { handleSkillsPhase };

package/dist/init/phases/status.js

@@ -1,70 +1,75 @@
 import { isAuthenticated } from "../auth.js";
 import { inspectProject } from "../inspect.js";
-export async function handleStatusPhase(_options) {
-    const authed = await isAuthenticated();
-    const inspection = await inspectProject([
-        { id: "mcp_server", description: "", lookFor: [] },
-        { id: "database_url", description: "", lookFor: [] },
-        { id: "skills", description: "", lookFor: [] },
-        { id: "migrations", description: "", lookFor: [] },
-    ]);
-    const hasDatabaseUrl = inspection.databaseUrl === true;
-    const mcpConfigured = inspection.mcpConfigured === true;
-    const skillsInstalled = inspection.skillsInstalled === true;
-    const migrationTool = inspection.migrationTool ?? null;
-    const hasMigrations = migrationTool !== null &&
-        migrationTool !== "none" &&
-        inspection.migrationDir !== "none";
-    const recommendations = [];
-    if (!authed) {
-        recommendations.push({
-            priority: "high",
-            message: "Not authenticated with Neon",
-            command: `neon init --agent --data '{"step":"auth"}'`,
-        });
-    }
-    if (!hasDatabaseUrl) {
-        recommendations.push({
-            priority: "high",
-            message: "No DATABASE_URL found in .env",
-            command: `neon init --agent --data '{"step":"db"}'`,
-        });
-    }
-    if (!skillsInstalled) {
-        recommendations.push({
-            priority: "medium",
-            message: "Neon agent skills not detected in this project",
-            command: `neon init --agent --data '{"step":"skills","install":true}'`,
-        });
-    }
-    if (migrationTool && !hasMigrations) {
-        recommendations.push({
-            priority: "medium",
-            message: `${migrationTool} detected but no migrations found`,
-            command: `neon init --agent --data '{"step":"migrations"}'`,
-        });
-    }
-    return {
-        auth: {
-            authenticated: authed,
-        },
-        tooling: {
-            mcpServer: {
-                configured: mcpConfigured,
-                scope: inspection.mcpScope || null,
-            },
-            skills: {
-                installed: skillsInstalled,
-                scope: inspection.skillsScope || null,
-            },
-        },
-        project: {
-            databaseUrl: hasDatabaseUrl,
-        },
-        migrations: {
-            tool: migrationTool,
-            hasMigrations,
-        },
-        recommendations,
-    };
+//#region src/init/phases/status.ts
+async function handleStatusPhase(_options) {
+	const authed = await isAuthenticated();
+	const inspection = await inspectProject([
+		{
+			id: "mcp_server",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "database_url",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "skills",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "migrations",
+			description: "",
+			lookFor: []
+		}
+	]);
+	const hasDatabaseUrl = inspection.databaseUrl === true;
+	const mcpConfigured = inspection.mcpConfigured === true;
+	const skillsInstalled = inspection.skillsInstalled === true;
+	const migrationTool = inspection.migrationTool ?? null;
+	const hasMigrations = migrationTool !== null && migrationTool !== "none" && inspection.migrationDir !== "none";
+	const recommendations = [];
+	if (!authed) recommendations.push({
+		priority: "high",
+		message: "Not authenticated with Neon",
+		command: `neon init --agent --data '{"step":"auth"}'`
+	});
+	if (!hasDatabaseUrl) recommendations.push({
+		priority: "high",
+		message: "No DATABASE_URL found in .env",
+		command: `neon init --agent --data '{"step":"db"}'`
+	});
+	if (!skillsInstalled) recommendations.push({
+		priority: "medium",
+		message: "Neon agent skills not detected in this project",
+		command: `neon init --agent --data '{"step":"skills","install":true}'`
+	});
+	if (migrationTool && !hasMigrations) recommendations.push({
+		priority: "medium",
+		message: `${migrationTool} detected but no migrations found`,
+		command: `neon init --agent --data '{"step":"migrations"}'`
+	});
+	return {
+		auth: { authenticated: authed },
+		tooling: {
+			mcpServer: {
+				configured: mcpConfigured,
+				scope: inspection.mcpScope || null
+			},
+			skills: {
+				installed: skillsInstalled,
+				scope: inspection.skillsScope || null
+			}
+		},
+		project: { databaseUrl: hasDatabaseUrl },
+		migrations: {
+			tool: migrationTool,
+			hasMigrations
+		},
+		recommendations
+	};
 }
+//#endregion
+export { handleStatusPhase };

package/dist/init/resolve_context.js

@@ -1,107 +1,110 @@
-/**
- * Resolves the Neon org/project from a DATABASE_URL in .env.
- * Parses the endpoint hostname, then queries the Neon API to find
- * which project it belongs to.
- */
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { execa } from "execa";
+//#region src/init/resolve_context.ts
+/**
+* Resolves the Neon org/project from a DATABASE_URL in .env.
+* Parses the endpoint hostname, then queries the Neon API to find
+* which project it belongs to.
+*/
 /**
- * Extracts the Neon endpoint host from .env's DATABASE_URL or PGHOST.
- * Returns the hostname (e.g. "ep-cool-name-12345.us-east-2.aws.neon.tech") or null.
- */
+* Extracts the Neon endpoint host from .env's DATABASE_URL or PGHOST.
+* Returns the hostname (e.g. "ep-cool-name-12345.us-east-2.aws.neon.tech") or null.
+*/
 function extractNeonHost(cwd) {
-    for (const envFile of [".env", ".env.local"]) {
-        const envPath = resolve(cwd, envFile);
-        if (!existsSync(envPath))
-            continue;
-        try {
-            const content = readFileSync(envPath, "utf-8");
-            // Try DATABASE_URL
-            const dbUrlMatch = content.match(/^DATABASE_URL=.*@([^/:\s]+\.neon\.tech)/m);
-            if (dbUrlMatch)
-                return dbUrlMatch[1];
-            // Try PGHOST
-            const pgHostMatch = content.match(/^PGHOST=([^\s]+\.neon\.tech)/m);
-            if (pgHostMatch)
-                return pgHostMatch[1];
-        }
-        catch { }
-    }
-    return null;
+	for (const envFile of [".env", ".env.local"]) {
+		const envPath = resolve(cwd, envFile);
+		if (!existsSync(envPath)) continue;
+		try {
+			const content = readFileSync(envPath, "utf-8");
+			const dbUrlMatch = content.match(/^DATABASE_URL=.*@([^/:\s]+\.neon\.tech)/m);
+			if (dbUrlMatch) return dbUrlMatch[1];
+			const pgHostMatch = content.match(/^PGHOST=([^\s]+\.neon\.tech)/m);
+			if (pgHostMatch) return pgHostMatch[1];
+		} catch {}
+	}
+	return null;
 }
 /**
- * Resolves the Neon org and project that own the endpoint in DATABASE_URL.
- *
- * Strategy:
- * 1. Extract endpoint hostname from .env
- * 2. List orgs via neonctl
- * 3. For each org, list projects
- * 4. For each project, get connection string and compare hostnames
- * 5. Return the matching org/project
- */
-export async function resolveNeonContext(cwd) {
-    const neonHost = extractNeonHost(cwd);
-    if (!neonHost)
-        return null;
-    // List orgs
-    let orgs;
-    try {
-        const result = await execa("npx", ["-y", "neonctl", "orgs", "list", "--output", "json"], {
-            stdio: "pipe",
-            timeout: 30000,
-            env: { ...process.env, CI: undefined },
-        });
-        orgs = JSON.parse(result.stdout);
-    }
-    catch {
-        return null;
-    }
-    if (orgs.length === 0)
-        return null;
-    // Search each org's projects for a matching endpoint
-    for (const org of orgs) {
-        let projects;
-        try {
-            const result = await execa("npx", [
-                "-y",
-                "neonctl",
-                "projects",
-                "list",
-                "--org-id",
-                org.id,
-                "--output",
-                "json",
-            ], {
-                stdio: "pipe",
-                timeout: 30000,
-                env: { ...process.env, CI: undefined },
-            });
-            projects = JSON.parse(result.stdout);
-        }
-        catch {
-            continue;
-        }
-        for (const project of projects) {
-            try {
-                const result = await execa("npx", [
-                    "-y",
-                    "neonctl",
-                    "connection-string",
-                    "--project-id",
-                    project.id,
-                ], {
-                    stdio: "pipe",
-                    timeout: 15000,
-                    env: { ...process.env, CI: undefined },
-                });
-                const connStr = result.stdout.trim();
-                if (connStr.includes(neonHost)) {
-                    return { orgId: org.id, projectId: project.id };
-                }
-            }
-            catch { }
-        }
-    }
-    return null;
+* Resolves the Neon org and project that own the endpoint in DATABASE_URL.
+*
+* Strategy:
+* 1. Extract endpoint hostname from .env
+* 2. List orgs via neonctl
+* 3. For each org, list projects
+* 4. For each project, get connection string and compare hostnames
+* 5. Return the matching org/project
+*/
+async function resolveNeonContext(cwd) {
+	const neonHost = extractNeonHost(cwd);
+	if (!neonHost) return null;
+	let orgs;
+	try {
+		const result = await execa("npx", [
+			"-y",
+			"neonctl",
+			"orgs",
+			"list",
+			"--output",
+			"json"
+		], {
+			stdio: "pipe",
+			timeout: 3e4,
+			env: {
+				...process.env,
+				CI: void 0
+			}
+		});
+		orgs = JSON.parse(result.stdout);
+	} catch {
+		return null;
+	}
+	if (orgs.length === 0) return null;
+	for (const org of orgs) {
+		let projects;
+		try {
+			const result = await execa("npx", [
+				"-y",
+				"neonctl",
+				"projects",
+				"list",
+				"--org-id",
+				org.id,
+				"--output",
+				"json"
+			], {
+				stdio: "pipe",
+				timeout: 3e4,
+				env: {
+					...process.env,
+					CI: void 0
+				}
+			});
+			projects = JSON.parse(result.stdout);
+		} catch {
+			continue;
+		}
+		for (const project of projects) try {
+			if ((await execa("npx", [
+				"-y",
+				"neonctl",
+				"connection-string",
+				"--project-id",
+				project.id
+			], {
+				stdio: "pipe",
+				timeout: 15e3,
+				env: {
+					...process.env,
+					CI: void 0
+				}
+			})).stdout.trim().includes(neonHost)) return {
+				orgId: org.id,
+				projectId: project.id
+			};
+		} catch {}
+	}
+	return null;
 }
+//#endregion
+export { resolveNeonContext };