neon-init 0.4.0 → 0.4.1

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { init } from "./index.js";
+
+//#region src/cli.ts
+await init();
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { init } from \"./index.js\";\n\nawait init();\n"],"mappings":";;;;AAIA,MAAM,MAAM"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 //#region src/index.d.ts
-declare function init(): void;
+/**
+ * Initialize Neon projects with MCP Server and AI assistant rules
+ */
+declare function init(): Promise<void>;
 //#endregion
 export { init };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";iBAAgB,IAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;AA6bA;;iBAAsB,IAAA,CAAA,GAAQ"}

package/dist/index.js

@@ -1,6 +1,307 @@
+import { exec } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { confirm, intro, isCancel, log, outro, select, spinner } from "@clack/prompts";
+
 //#region src/index.ts
-function init() {
-	console.log("Hello world from `neon-init`!");
+const execAsync = promisify(exec);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+* Ensures neonctl is authenticated by running a command that triggers auth if needed
+* This will automatically start the OAuth flow if the user isn't already authenticated
+*/
+async function ensureNeonctlAuth() {
+	try {
+		const { spawn } = await import("node:child_process");
+		await new Promise((resolve$1, reject) => {
+			const meProcess = spawn("npx", [
+				"-y",
+				"neon",
+				"me",
+				"--output",
+				"json",
+				"--no-analytics"
+			], { stdio: "inherit" });
+			meProcess.on("close", (code) => {
+				if (code === 0) resolve$1();
+				else reject(/* @__PURE__ */ new Error(`Authentication failed with exit code ${code}`));
+			});
+			meProcess.on("error", reject);
+		});
+		return true;
+	} catch (error) {
+		log.error(`Authentication failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+		return false;
+	}
+}
+/**
+* Gets the OAuth access token from neonctl's stored credentials
+*/
+async function getNeonctlAccessToken() {
+	try {
+		const homeDir = process.env.HOME || process.env.USERPROFILE;
+		if (!homeDir) return null;
+		const credentialsPath = resolve(homeDir, ".config", "neonctl", "credentials.json");
+		if (!existsSync(credentialsPath)) return null;
+		return JSON.parse(readFileSync(credentialsPath, "utf-8")).access_token || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Creates an API key using the Neon API with the OAuth token from neonctl
+*/
+async function createApiKeyFromNeonctl() {
+	try {
+		const accessToken = await getNeonctlAccessToken();
+		if (!accessToken) {
+			log.error("Could not find OAuth token from neonctl");
+			return null;
+		}
+		const keyName = `neonctl-init-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, -5)}`;
+		const response = await fetch("https://console.neon.tech/api/v2/api_keys", {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${accessToken}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({ key_name: keyName })
+		});
+		if (!response.ok) {
+			const errorText = await response.text();
+			log.error(`Failed to create API key: ${response.status} ${errorText}`);
+			return null;
+		}
+		return (await response.json()).key || null;
+	} catch (error) {
+		log.error(`Failed to create API key: ${error instanceof Error ? error.message : "Unknown error"}`);
+		return null;
+	}
+}
+async function fetchOrganizations() {
+	try {
+		const { stdout } = await execAsync("npx -y neon orgs list --output json --no-analytics", { maxBuffer: 1024 * 1024 });
+		const data = JSON.parse(stdout);
+		return Array.isArray(data) ? data.map((org) => ({
+			id: org.id,
+			name: org.name || org.id
+		})) : [];
+	} catch (error) {
+		log.warn(`Unable to fetch organizations: ${error instanceof Error ? error.message : "Unknown error"}`);
+		return [];
+	}
+}
+/**
+* Gets or creates the .cursor/mcp.json configuration
+*/
+function getMCPConfig(cursorDir) {
+	const mcpConfigPath = resolve(cursorDir, "mcp.json");
+	if (existsSync(mcpConfigPath)) try {
+		const content = readFileSync(mcpConfigPath, "utf-8");
+		return JSON.parse(content);
+	} catch (_error) {
+		log.warn("Failed to parse existing mcp.json. Creating a new configuration.");
+		return { mcpServers: {} };
+	}
+	return { mcpServers: {} };
+}
+/**
+* Writes the MCP configuration to .cursor/mcp.json
+*/
+function writeMCPConfig(cursorDir, config) {
+	const mcpConfigPath = resolve(cursorDir, "mcp.json");
+	if (!existsSync(cursorDir)) mkdirSync(cursorDir, { recursive: true });
+	writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+* Gets the AGENTS.md template with Neon-specific best practices
+*/
+function getAgentsMdTemplate() {
+	return readFileSync(resolve(__dirname, "../src/agents-template.md"), "utf-8");
+}
+/**
+* Generates the organization configuration section for AGENTS.md
+*/
+function getOrgConfigSection(orgId) {
+	return `## Neon Project Configuration
+
+> **🔴 IMPORTANT: You MUST use this organization for all Neon operations in this project.**
+
+**Organization ID:** \`${orgId}\`
+
+When using any Neon MCP tools or API calls, always pass this \`org_id\` parameter. The MCP server is pre-configured with this organization.
+
+**Example:**
+- When listing projects: Use \`mcp_Neon_list_projects\` with \`org_id: "${orgId}"\`
+- When creating resources: Always include \`org_id: "${orgId}"\` in your tool calls
+
+---
+
+`;
+}
+/**
+* Creates or updates AGENTS.md with Neon-specific best practices
+*/
+async function createAgentsMd(orgId) {
+	const agentsPath = resolve(process.cwd(), "AGENTS.md");
+	try {
+		if (existsSync(agentsPath)) {
+			const existingContent = readFileSync(agentsPath, "utf-8");
+			if (existingContent.includes("## Neon Database Guidelines")) {
+				log.info("Neon guidelines already exist in AGENTS.md");
+				return true;
+			}
+			const separator = "\n\n---\n\n";
+			let content = "";
+			if (orgId) content += getOrgConfigSection(orgId);
+			content += getAgentsMdTemplate();
+			writeFileSync(agentsPath, existingContent + separator + content, "utf-8");
+			log.success(`Appended Neon best practices to existing AGENTS.md at ${agentsPath}`);
+		} else {
+			let content = "";
+			if (orgId) content += getOrgConfigSection(orgId);
+			content += getAgentsMdTemplate();
+			writeFileSync(agentsPath, `# AGENTS.md
+
+This file provides guidance to AI coding assistants when working with code in this project.
+
+---
+
+${content}`, "utf-8");
+			log.success(`Created AGENTS.md with Neon best practices at ${agentsPath}`);
+		}
+		return true;
+	} catch (error) {
+		log.error(`Failed to create/update AGENTS.md: ${error instanceof Error ? error.message : "Unknown error"}`);
+		return false;
+	}
+}
+/**
+* Installs Neon's MCP Server by configuring it globally in ~/.cursor/mcp.json
+* Returns the selected organization ID if one was chosen
+*/
+async function installMCPServer() {
+	const homeDir = process.env.HOME || process.env.USERPROFILE;
+	if (!homeDir) {
+		log.error("Could not determine home directory");
+		return { success: false };
+	}
+	const cursorDir = resolve(homeDir, ".cursor");
+	const config = getMCPConfig(cursorDir);
+	const alreadyConfigured = Boolean(config.mcpServers.Neon);
+	let shouldReconfigure = false;
+	if (alreadyConfigured) {
+		log.info("Neon MCP Server is already configured globally");
+		const response = await confirm({
+			message: "Would you like to reconfigure it?",
+			initialValue: false
+		});
+		if (isCancel(response)) return { success: false };
+		shouldReconfigure = response;
+		if (!shouldReconfigure) log.info("Keeping existing global configuration.");
+	}
+	log.step("Authenticating with Neon...");
+	log.info("The authentication URL will be displayed below if needed.");
+	log.info("");
+	const authSpinner = spinner();
+	authSpinner.start("Waiting for authentication...");
+	if (!await ensureNeonctlAuth()) {
+		authSpinner.stop("Authentication failed");
+		return { success: false };
+	}
+	authSpinner.stop("Authentication successful ✓");
+	let selectedOrgId;
+	const orgSpinner = spinner();
+	orgSpinner.start("Fetching your organizations...");
+	const organizations = await fetchOrganizations();
+	orgSpinner.stop(`Found ${organizations.length} organization${organizations.length !== 1 ? "s" : ""}`);
+	if (organizations.length > 1) {
+		const orgChoice = await select({
+			message: "Select an organization for this project:",
+			options: organizations.map((org) => ({
+				value: org.id,
+				label: org.name
+			}))
+		});
+		if (isCancel(orgChoice)) return { success: false };
+		selectedOrgId = orgChoice.toString();
+		const selectedOrg = organizations.find((org) => org.id === selectedOrgId);
+		log.success(`Selected organization: ${selectedOrg?.name}`);
+	} else if (organizations.length === 1) {
+		selectedOrgId = organizations[0].id;
+		log.info(`Using organization: ${organizations[0].name}`);
+	} else log.info("Using personal account");
+	if (alreadyConfigured && !shouldReconfigure) return {
+		success: true,
+		orgId: selectedOrgId
+	};
+	const s = spinner();
+	s.start("Creating API key...");
+	const apiKey = await createApiKeyFromNeonctl();
+	s.stop(apiKey ? "API key created successfully ✓" : "Failed to create API key");
+	if (!apiKey) {
+		log.error("Could not create API key after authentication.");
+		log.info("You can manually create one at: https://console.neon.tech/app/settings/api-keys");
+		return { success: false };
+	}
+	const args = [
+		"-y",
+		"@neondatabase/mcp-server-neon",
+		"start",
+		apiKey
+	];
+	config.mcpServers.Neon = {
+		command: "npx",
+		args
+	};
+	try {
+		writeMCPConfig(cursorDir, config);
+		log.success(`Neon MCP Server configured globally at ${resolve(cursorDir, "mcp.json")}`);
+		log.info("This configuration will be available in all your projects.");
+		return {
+			success: true,
+			orgId: selectedOrgId
+		};
+	} catch (error) {
+		log.error(`Failed to write global configuration: ${error instanceof Error ? error.message : "Unknown error"}`);
+		return { success: false };
+	}
+}
+/**
+* Initialize Neon projects with MCP Server and AI assistant rules
+*/
+async function init() {
+	intro("🚀 Neon Project Initialization");
+	log.info("This will set up your project with Neon's MCP Server and AI coding best practices.");
+	log.step("Step 1/2: Configuring Neon MCP Server");
+	const { success: mcpSuccess, orgId } = await installMCPServer();
+	if (!mcpSuccess) {
+		outro("❌ Initialization cancelled or failed.");
+		process.exit(1);
+	}
+	log.step("Step 2/2: Creating AGENTS.md with Neon best practices");
+	if (!await createAgentsMd(orgId)) log.warn("Failed to create AGENTS.md, but MCP Server is configured.");
+	outro("Success! Neon project initialized.");
+	console.log("");
+	console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+	console.log("");
+	console.log("Next steps:");
+	console.log("");
+	console.log("    1. Restart your AI coding assistant (Cursor, Windsurf, etc.)");
+	console.log("");
+	console.log("    2. Type this in your AI chat to begin:");
+	console.log("");
+	console.log("       ┌──────────────────────────────────────┐");
+	console.log("       │                                      │");
+	console.log("       │    Get started with Neon             │");
+	console.log("       │                                      │");
+	console.log("       └──────────────────────────────────────┘");
+	console.log("");
+	console.log("Your AI assistant now has access to Neon best practices via AGENTS.md");
+	console.log("");
+	console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
 }
 
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export function init() {\n\tconsole.log(\"Hello world from `neon-init`!\");\n}\n"],"mappings":";AAAA,SAAgB,OAAO;AACtB,SAAQ,IAAI,gCAAgC"}
+{"version":3,"file":"index.js","names":["selectedOrgId: string | undefined"],"sources":["../src/index.ts"],"sourcesContent":["import { exec } from \"node:child_process\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { promisify } from \"node:util\";\nimport {\n\tconfirm,\n\tintro,\n\tisCancel,\n\tlog,\n\toutro,\n\tselect,\n\tspinner,\n} from \"@clack/prompts\";\n\nconst execAsync = promisify(exec);\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\ninterface MCPConfig {\n\tmcpServers: {\n\t\t[key: string]: {\n\t\t\tcommand: string;\n\t\t\targs: string[];\n\t\t\tenv?: Record<string, string>;\n\t\t};\n\t};\n}\n\ninterface NeonOrganization {\n\tid: string;\n\tname: string;\n}\n\n/**\n * Ensures neonctl is authenticated by running a command that triggers auth if needed\n * This will automatically start the OAuth flow if the user isn't already authenticated\n */\nasync function ensureNeonctlAuth(): Promise<boolean> {\n\ttry {\n\t\t// Use spawn to show OAuth URL if authentication is needed\n\t\tconst { spawn } = await import(\"node:child_process\");\n\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tconst meProcess = spawn(\n\t\t\t\t\"npx\",\n\t\t\t\t[\"-y\", \"neon\", \"me\", \"--output\", \"json\", \"--no-analytics\"],\n\t\t\t\t{\n\t\t\t\t\tstdio: \"inherit\", // Shows OAuth URL and prompts to the user\n\t\t\t\t},\n\t\t\t);\n\n\t\t\tmeProcess.on(\"close\", (code) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolve();\n\t\t\t\t} else {\n\t\t\t\t\treject(\n\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t`Authentication failed with exit code ${code}`,\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t});\n\n\t\t\tmeProcess.on(\"error\", reject);\n\t\t});\n\n\t\treturn true;\n\t} catch (error) {\n\t\tlog.error(\n\t\t\t`Authentication failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t);\n\t\treturn false;\n\t}\n}\n\n/**\n * Gets the OAuth access token from neonctl's stored credentials\n */\nasync function getNeonctlAccessToken(): Promise<string | null> {\n\ttry {\n\t\tconst homeDir = process.env.HOME || process.env.USERPROFILE;\n\t\tif (!homeDir) return null;\n\n\t\tconst credentialsPath = resolve(\n\t\t\thomeDir,\n\t\t\t\".config\",\n\t\t\t\"neonctl\",\n\t\t\t\"credentials.json\",\n\t\t);\n\t\tif (!existsSync(credentialsPath)) return null;\n\n\t\tconst credentials = JSON.parse(readFileSync(credentialsPath, \"utf-8\"));\n\t\treturn credentials.access_token || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Creates an API key using the Neon API with the OAuth token from neonctl\n */\nasync function createApiKeyFromNeonctl(): Promise<string | null> {\n\ttry {\n\t\tconst accessToken = await getNeonctlAccessToken();\n\t\tif (!accessToken) {\n\t\t\tlog.error(\"Could not find OAuth token from neonctl\");\n\t\t\treturn null;\n\t\t}\n\n\t\t// Generate a unique key name with timestamp\n\t\tconst timestamp = new Date()\n\t\t\t.toISOString()\n\t\t\t.replace(/[:.]/g, \"-\")\n\t\t\t.slice(0, -5); // e.g., 2024-10-08T15-30-45\n\t\tconst keyName = `neonctl-init-${timestamp}`;\n\n\t\t// Call Neon API to create an API key\n\t\tconst response = await fetch(\n\t\t\t\"https://console.neon.tech/api/v2/api_keys\",\n\t\t\t{\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: {\n\t\t\t\t\tAuthorization: `Bearer ${accessToken}`,\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tkey_name: keyName,\n\t\t\t\t}),\n\t\t\t},\n\t\t);\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tlog.error(\n\t\t\t\t`Failed to create API key: ${response.status} ${errorText}`,\n\t\t\t);\n\t\t\treturn null;\n\t\t}\n\n\t\tconst data = await response.json();\n\t\treturn data.key || null;\n\t} catch (error) {\n\t\tlog.error(\n\t\t\t`Failed to create API key: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t);\n\t\treturn null;\n\t}\n}\n\nasync function fetchOrganizations(): Promise<NeonOrganization[]> {\n\ttry {\n\t\tconst { stdout } = await execAsync(\n\t\t\t\"npx -y neon orgs list --output json --no-analytics\",\n\t\t\t{ maxBuffer: 1024 * 1024 },\n\t\t);\n\n\t\tconst data = JSON.parse(stdout);\n\n\t\t// The neon CLI returns an array of organizations\n\t\tconst organizations: NeonOrganization[] = Array.isArray(data)\n\t\t\t? data.map((org: { id: string; name?: string }) => ({\n\t\t\t\t\tid: org.id,\n\t\t\t\t\tname: org.name || org.id,\n\t\t\t\t}))\n\t\t\t: [];\n\n\t\treturn organizations;\n\t} catch (error) {\n\t\tlog.warn(\n\t\t\t`Unable to fetch organizations: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t);\n\t\treturn [];\n\t}\n}\n\n/**\n * Gets or creates the .cursor/mcp.json configuration\n */\nfunction getMCPConfig(cursorDir: string): MCPConfig {\n\tconst mcpConfigPath = resolve(cursorDir, \"mcp.json\");\n\n\tif (existsSync(mcpConfigPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(mcpConfigPath, \"utf-8\");\n\t\t\treturn JSON.parse(content);\n\t\t} catch (_error) {\n\t\t\tlog.warn(\n\t\t\t\t\"Failed to parse existing mcp.json. Creating a new configuration.\",\n\t\t\t);\n\t\t\treturn { mcpServers: {} };\n\t\t}\n\t}\n\n\treturn { mcpServers: {} };\n}\n\n/**\n * Writes the MCP configuration to .cursor/mcp.json\n */\nfunction writeMCPConfig(cursorDir: string, config: MCPConfig): void {\n\tconst mcpConfigPath = resolve(cursorDir, \"mcp.json\");\n\n\tif (!existsSync(cursorDir)) {\n\t\tmkdirSync(cursorDir, { recursive: true });\n\t}\n\n\twriteFileSync(mcpConfigPath, JSON.stringify(config, null, 2), \"utf-8\");\n}\n\n/**\n * Gets the AGENTS.md template with Neon-specific best practices\n */\nfunction getAgentsMdTemplate(): string {\n\tconst templatePath = resolve(__dirname, \"../src/agents-template.md\");\n\treturn readFileSync(templatePath, \"utf-8\");\n}\n\n/**\n * Generates the organization configuration section for AGENTS.md\n */\nfunction getOrgConfigSection(orgId: string): string {\n\treturn `## Neon Project Configuration\n\n> **🔴 IMPORTANT: You MUST use this organization for all Neon operations in this project.**\n\n**Organization ID:** \\`${orgId}\\`\n\nWhen using any Neon MCP tools or API calls, always pass this \\`org_id\\` parameter. The MCP server is pre-configured with this organization.\n\n**Example:**\n- When listing projects: Use \\`mcp_Neon_list_projects\\` with \\`org_id: \"${orgId}\"\\`\n- When creating resources: Always include \\`org_id: \"${orgId}\"\\` in your tool calls\n\n---\n\n`;\n}\n\n/**\n * Creates or updates AGENTS.md with Neon-specific best practices\n */\nasync function createAgentsMd(orgId?: string): Promise<boolean> {\n\tconst agentsPath = resolve(process.cwd(), \"AGENTS.md\");\n\n\ttry {\n\t\t// Check if AGENTS.md already exists\n\t\tif (existsSync(agentsPath)) {\n\t\t\t// Append to existing file\n\t\t\tconst existingContent = readFileSync(agentsPath, \"utf-8\");\n\n\t\t\t// Check if Neon section already exists to avoid duplicates\n\t\t\tif (existingContent.includes(\"## Neon Database Guidelines\")) {\n\t\t\t\tlog.info(\"Neon guidelines already exist in AGENTS.md\");\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst separator = \"\\n\\n---\\n\\n\";\n\t\t\tlet content = \"\";\n\n\t\t\t// Add org ID context if provided\n\t\t\tif (orgId) {\n\t\t\t\tcontent += getOrgConfigSection(orgId);\n\t\t\t}\n\n\t\t\tcontent += getAgentsMdTemplate();\n\n\t\t\tconst updatedContent = existingContent + separator + content;\n\t\t\twriteFileSync(agentsPath, updatedContent, \"utf-8\");\n\t\t\tlog.success(\n\t\t\t\t`Appended Neon best practices to existing AGENTS.md at ${agentsPath}`,\n\t\t\t);\n\t\t} else {\n\t\t\t// Create new file with proper header\n\t\t\tlet content = \"\";\n\n\t\t\t// Add org ID context if provided\n\t\t\tif (orgId) {\n\t\t\t\tcontent += getOrgConfigSection(orgId);\n\t\t\t}\n\n\t\t\tcontent += getAgentsMdTemplate();\n\n\t\t\tconst newContent = `# AGENTS.md\n\nThis file provides guidance to AI coding assistants when working with code in this project.\n\n---\n\n${content}`;\n\t\t\twriteFileSync(agentsPath, newContent, \"utf-8\");\n\t\t\tlog.success(\n\t\t\t\t`Created AGENTS.md with Neon best practices at ${agentsPath}`,\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t} catch (error) {\n\t\tlog.error(\n\t\t\t`Failed to create/update AGENTS.md: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t);\n\t\treturn false;\n\t}\n}\n\n/**\n * Installs Neon's MCP Server by configuring it globally in ~/.cursor/mcp.json\n * Returns the selected organization ID if one was chosen\n */\nasync function installMCPServer(): Promise<{\n\tsuccess: boolean;\n\torgId?: string;\n}> {\n\tconst homeDir = process.env.HOME || process.env.USERPROFILE;\n\tif (!homeDir) {\n\t\tlog.error(\"Could not determine home directory\");\n\t\treturn { success: false };\n\t}\n\tconst cursorDir = resolve(homeDir, \".cursor\");\n\tconst config = getMCPConfig(cursorDir);\n\n\t// Check if already configured\n\tconst alreadyConfigured = Boolean(config.mcpServers.Neon);\n\tlet shouldReconfigure = false;\n\n\tif (alreadyConfigured) {\n\t\tlog.info(\"Neon MCP Server is already configured globally\");\n\t\tconst response = await confirm({\n\t\t\tmessage: \"Would you like to reconfigure it?\",\n\t\t\tinitialValue: false,\n\t\t});\n\n\t\tif (isCancel(response)) {\n\t\t\treturn { success: false };\n\t\t}\n\n\t\tshouldReconfigure = response as boolean;\n\n\t\tif (!shouldReconfigure) {\n\t\t\tlog.info(\"Keeping existing global configuration.\");\n\t\t}\n\t}\n\n\t// Step 1: Ensure authentication (will trigger OAuth if needed)\n\tlog.step(\"Authenticating with Neon...\");\n\tlog.info(\"The authentication URL will be displayed below if needed.\");\n\tlog.info(\"\");\n\n\tconst authSpinner = spinner();\n\tauthSpinner.start(\"Waiting for authentication...\");\n\n\tconst authSuccess = await ensureNeonctlAuth();\n\n\tif (!authSuccess) {\n\t\tauthSpinner.stop(\"Authentication failed\");\n\t\treturn { success: false };\n\t}\n\n\tauthSpinner.stop(\"Authentication successful ✓\");\n\n\t// Step 2: Fetch organizations and let user select\n\tlet selectedOrgId: string | undefined;\n\n\tconst orgSpinner = spinner();\n\torgSpinner.start(\"Fetching your organizations...\");\n\tconst organizations = await fetchOrganizations();\n\torgSpinner.stop(\n\t\t`Found ${organizations.length} organization${organizations.length !== 1 ? \"s\" : \"\"}`,\n\t);\n\n\tif (organizations.length > 1) {\n\t\tconst orgChoice = await select({\n\t\t\tmessage: \"Select an organization for this project:\",\n\t\t\toptions: organizations.map((org) => ({\n\t\t\t\tvalue: org.id,\n\t\t\t\tlabel: org.name,\n\t\t\t})),\n\t\t});\n\n\t\tif (isCancel(orgChoice)) {\n\t\t\treturn { success: false };\n\t\t}\n\n\t\tselectedOrgId = orgChoice.toString();\n\t\tconst selectedOrg = organizations.find(\n\t\t\t(org) => org.id === selectedOrgId,\n\t\t);\n\t\tlog.success(`Selected organization: ${selectedOrg?.name}`);\n\t} else if (organizations.length === 1) {\n\t\t// Only one org, auto-select it\n\t\tselectedOrgId = organizations[0].id;\n\t\tlog.info(`Using organization: ${organizations[0].name}`);\n\t} else {\n\t\t// No organizations found (personal account)\n\t\tlog.info(\"Using personal account\");\n\t}\n\n\t// If user chose not to reconfigure, we're done (but we still return the org ID)\n\tif (alreadyConfigured && !shouldReconfigure) {\n\t\treturn { success: true, orgId: selectedOrgId };\n\t}\n\n\t// Step 3: Create API key using the OAuth token\n\tconst s = spinner();\n\ts.start(\"Creating API key...\");\n\tconst apiKey = await createApiKeyFromNeonctl();\n\ts.stop(\n\t\tapiKey ? \"API key created successfully ✓\" : \"Failed to create API key\",\n\t);\n\n\tif (!apiKey) {\n\t\tlog.error(\"Could not create API key after authentication.\");\n\t\tlog.info(\n\t\t\t\"You can manually create one at: https://console.neon.tech/app/settings/api-keys\",\n\t\t);\n\t\treturn { success: false };\n\t}\n\n\t// Step 4: Configure Neon MCP Server\n\tconst args = [\"-y\", \"@neondatabase/mcp-server-neon\", \"start\", apiKey];\n\n\tconfig.mcpServers.Neon = {\n\t\tcommand: \"npx\",\n\t\targs,\n\t};\n\n\t// Write configuration\n\ttry {\n\t\twriteMCPConfig(cursorDir, config);\n\t\tlog.success(\n\t\t\t`Neon MCP Server configured globally at ${resolve(cursorDir, \"mcp.json\")}`,\n\t\t);\n\t\tlog.info(\"This configuration will be available in all your projects.\");\n\t\treturn { success: true, orgId: selectedOrgId };\n\t} catch (error) {\n\t\tlog.error(\n\t\t\t`Failed to write global configuration: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t);\n\t\treturn { success: false };\n\t}\n}\n\n/**\n * Initialize Neon projects with MCP Server and AI assistant rules\n */\nexport async function init(): Promise<void> {\n\tintro(\"🚀 Neon Project Initialization\");\n\n\tlog.info(\n\t\t\"This will set up your project with Neon's MCP Server and AI coding best practices.\",\n\t);\n\n\tlog.step(\"Step 1/2: Configuring Neon MCP Server\");\n\tconst { success: mcpSuccess, orgId } = await installMCPServer();\n\n\tif (!mcpSuccess) {\n\t\toutro(\"❌ Initialization cancelled or failed.\");\n\t\tprocess.exit(1);\n\t}\n\n\tlog.step(\"Step 2/2: Creating AGENTS.md with Neon best practices\");\n\tconst agentsSuccess = await createAgentsMd(orgId);\n\n\tif (!agentsSuccess) {\n\t\tlog.warn(\"Failed to create AGENTS.md, but MCP Server is configured.\");\n\t}\n\n\toutro(\"Success! Neon project initialized.\");\n\tconsole.log(\"\");\n\tconsole.log(\n\t\t\"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\",\n\t);\n\tconsole.log(\"\");\n\tconsole.log(\"Next steps:\");\n\tconsole.log(\"\");\n\tconsole.log(\n\t\t\"    1. Restart your AI coding assistant (Cursor, Windsurf, etc.)\",\n\t);\n\tconsole.log(\"\");\n\tconsole.log(\"    2. Type this in your AI chat to begin:\");\n\tconsole.log(\"\");\n\tconsole.log(\"       ┌──────────────────────────────────────┐\");\n\tconsole.log(\"       │                                      │\");\n\tconsole.log(\"       │    Get started with Neon             │\");\n\tconsole.log(\"       │                                      │\");\n\tconsole.log(\"       └──────────────────────────────────────┘\");\n\tconsole.log(\"\");\n\tconsole.log(\n\t\t\"Your AI assistant now has access to Neon best practices via AGENTS.md\",\n\t);\n\tconsole.log(\"\");\n\tconsole.log(\n\t\t\"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\",\n\t);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon-init",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Initialize Neon projects",
   "keywords": [
     "neon",