neon-init 0.13.1 → 0.15.0

package/dist/lib/vsix.d.ts

@@ -0,0 +1,15 @@
+//#region src/lib/vsix.d.ts
+declare const NEON_EXTENSION_ID = "databricks.neon-local-connect";
+/**
+ * Downloads a .vsix file for the Neon extension.
+ *
+ * Strategy:
+ * 1. If NEON_VSX_GALLERY_URL is set, download from the corporate proxy gallery
+ * 2. Otherwise, download from the public Open VSX API
+ *
+ * Returns the path to the temp .vsix file, or null on failure.
+ */
+declare function downloadVsix(): Promise<string | null>;
+//#endregion
+export { NEON_EXTENSION_ID, downloadVsix };
+//# sourceMappingURL=vsix.d.ts.map

package/dist/lib/vsix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsix.d.ts","names":[],"sources":["../../src/lib/vsix.ts"],"mappings":";cASa,iBAAA;AAAb;AAYA;;;;;;;;iBAAsB,YAAA,CAAA,GAAgB"}

package/dist/lib/vsix.js

@@ -0,0 +1,91 @@
+import { createWriteStream } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { pipeline } from "node:stream/promises";
+//#region src/lib/vsix.ts
+/**
+* Shared VSIX download utilities for extension installation.
+* Supports corporate proxy via NEON_VSX_GALLERY_URL env var.
+*/
+const NEON_EXTENSION_ID = "databricks.neon-local-connect";
+const OPEN_VSX_API = "https://open-vsx.org/api";
+/**
+* Downloads a .vsix file for the Neon extension.
+*
+* Strategy:
+* 1. If NEON_VSX_GALLERY_URL is set, download from the corporate proxy gallery
+* 2. Otherwise, download from the public Open VSX API
+*
+* Returns the path to the temp .vsix file, or null on failure.
+*/
+async function downloadVsix() {
+	const { INTERNAL_VSX_GALLERY } = await import("./build-config.js");
+	const proxyGallery = process.env.NEON_VSX_GALLERY_URL || INTERNAL_VSX_GALLERY || "";
+	if (proxyGallery) return downloadFromGallery(proxyGallery);
+	return downloadFromOpenVsx();
+}
+/**
+* Downloads from a VS Code marketplace-compatible gallery API (corporate proxy).
+* Uses the VS Code extensionquery POST API to find the VSIX download URL.
+*/
+async function downloadFromGallery(galleryUrl) {
+	const [publisher, name] = NEON_EXTENSION_ID.split(".");
+	const queryUrl = `${galleryUrl.replace(/\/+$/, "")}/extensionquery`;
+	try {
+		const queryRes = await fetch(queryUrl, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: "application/json;api-version=6.1-preview.1"
+			},
+			body: JSON.stringify({
+				filters: [{ criteria: [{
+					filterType: 7,
+					value: `${publisher}.${name}`
+				}] }],
+				flags: 914
+			}),
+			signal: AbortSignal.timeout(15e3)
+		});
+		if (!queryRes.ok) return null;
+		const vsixFile = (((await queryRes.json()).results?.[0]?.extensions?.[0])?.versions?.[0])?.files?.find((f) => f.assetType === "Microsoft.VisualStudio.Services.VSIXPackage");
+		if (!vsixFile?.source) return null;
+		const vsixRes = await fetch(vsixFile.source, {
+			signal: AbortSignal.timeout(3e4),
+			redirect: "follow"
+		});
+		if (!vsixRes.ok || !vsixRes.body) return null;
+		const tmpPath = join(tmpdir(), `${NEON_EXTENSION_ID}-proxy.vsix`);
+		const fileStream = createWriteStream(tmpPath);
+		await pipeline(vsixRes.body, fileStream);
+		return tmpPath;
+	} catch {
+		return null;
+	}
+}
+/**
+* Downloads from the public Open VSX API.
+*/
+async function downloadFromOpenVsx() {
+	const [publisher, name] = NEON_EXTENSION_ID.split(".");
+	const metaUrl = `${OPEN_VSX_API}/${publisher}/${name}/latest`;
+	try {
+		const metaRes = await fetch(metaUrl, { signal: AbortSignal.timeout(1e4) });
+		if (!metaRes.ok) return null;
+		const meta = await metaRes.json();
+		const downloadUrl = meta.files?.download;
+		if (!downloadUrl) return null;
+		const vsixRes = await fetch(downloadUrl, { signal: AbortSignal.timeout(3e4) });
+		if (!vsixRes.ok || !vsixRes.body) return null;
+		const tmpPath = join(tmpdir(), `${NEON_EXTENSION_ID}-${meta.version ?? "latest"}.vsix`);
+		const fileStream = createWriteStream(tmpPath);
+		await pipeline(vsixRes.body, fileStream);
+		return tmpPath;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { NEON_EXTENSION_ID, downloadVsix };
+
+//# sourceMappingURL=vsix.js.map

package/dist/lib/vsix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsix.js","names":[],"sources":["../../src/lib/vsix.ts"],"sourcesContent":["/**\n * Shared VSIX download utilities for extension installation.\n * Supports corporate proxy via NEON_VSX_GALLERY_URL env var.\n */\nimport { createWriteStream } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { pipeline } from \"node:stream/promises\";\n\nexport const NEON_EXTENSION_ID = \"databricks.neon-local-connect\";\nconst OPEN_VSX_API = \"https://open-vsx.org/api\";\n\n/**\n * Downloads a .vsix file for the Neon extension.\n *\n * Strategy:\n * 1. If NEON_VSX_GALLERY_URL is set, download from the corporate proxy gallery\n * 2. Otherwise, download from the public Open VSX API\n *\n * Returns the path to the temp .vsix file, or null on failure.\n */\nexport async function downloadVsix(): Promise<string | null> {\n\t// Runtime env var takes priority, then build-time baked value\n\tconst { INTERNAL_VSX_GALLERY } = await import(\"./build-config.js\");\n\tconst proxyGallery =\n\t\tprocess.env.NEON_VSX_GALLERY_URL || INTERNAL_VSX_GALLERY || \"\";\n\tif (proxyGallery) {\n\t\treturn downloadFromGallery(proxyGallery);\n\t}\n\treturn downloadFromOpenVsx();\n}\n\n/**\n * Downloads from a VS Code marketplace-compatible gallery API (corporate proxy).\n * Uses the VS Code extensionquery POST API to find the VSIX download URL.\n */\nasync function downloadFromGallery(galleryUrl: string): Promise<string | null> {\n\tconst [publisher, name] = NEON_EXTENSION_ID.split(\".\");\n\tconst baseUrl = galleryUrl.replace(/\\/+$/, \"\");\n\tconst queryUrl = `${baseUrl}/extensionquery`;\n\n\ttry {\n\t\t// Query the marketplace API for the extension\n\t\tconst queryRes = await fetch(queryUrl, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\tAccept: \"application/json;api-version=6.1-preview.1\",\n\t\t\t},\n\t\t\tbody: JSON.stringify({\n\t\t\t\tfilters: [\n\t\t\t\t\t{\n\t\t\t\t\t\tcriteria: [\n\t\t\t\t\t\t\t{ filterType: 7, value: `${publisher}.${name}` },\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tflags: 914,\n\t\t\t}),\n\t\t\tsignal: AbortSignal.timeout(15000),\n\t\t});\n\n\t\tif (!queryRes.ok) return null;\n\n\t\tconst data = (await queryRes.json()) as {\n\t\t\tresults?: {\n\t\t\t\textensions?: {\n\t\t\t\t\tversions?: {\n\t\t\t\t\t\tfiles?: { assetType: string; source: string }[];\n\t\t\t\t\t}[];\n\t\t\t\t}[];\n\t\t\t}[];\n\t\t};\n\n\t\t// Find the VSIX download URL from the response\n\t\tconst extension = data.results?.[0]?.extensions?.[0];\n\t\tconst latestVersion = extension?.versions?.[0];\n\t\tconst vsixFile = latestVersion?.files?.find(\n\t\t\t(f) =>\n\t\t\t\tf.assetType === \"Microsoft.VisualStudio.Services.VSIXPackage\",\n\t\t);\n\n\t\tif (!vsixFile?.source) return null;\n\n\t\t// Download the VSIX\n\t\tconst vsixRes = await fetch(vsixFile.source, {\n\t\t\tsignal: AbortSignal.timeout(30000),\n\t\t\tredirect: \"follow\",\n\t\t});\n\t\tif (!vsixRes.ok || !vsixRes.body) return null;\n\n\t\tconst tmpPath = join(tmpdir(), `${NEON_EXTENSION_ID}-proxy.vsix`);\n\t\tconst fileStream = createWriteStream(tmpPath);\n\t\tawait pipeline(\n\t\t\tvsixRes.body as unknown as NodeJS.ReadableStream,\n\t\t\tfileStream,\n\t\t);\n\t\treturn tmpPath;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Downloads from the public Open VSX API.\n */\nasync function downloadFromOpenVsx(): Promise<string | null> {\n\tconst [publisher, name] = NEON_EXTENSION_ID.split(\".\");\n\tconst metaUrl = `${OPEN_VSX_API}/${publisher}/${name}/latest`;\n\n\ttry {\n\t\tconst metaRes = await fetch(metaUrl, {\n\t\t\tsignal: AbortSignal.timeout(10000),\n\t\t});\n\t\tif (!metaRes.ok) return null;\n\n\t\tconst meta = (await metaRes.json()) as {\n\t\t\tfiles?: { download?: string };\n\t\t\tversion?: string;\n\t\t};\n\t\tconst downloadUrl = meta.files?.download;\n\t\tif (!downloadUrl) return null;\n\n\t\tconst vsixRes = await fetch(downloadUrl, {\n\t\t\tsignal: AbortSignal.timeout(30000),\n\t\t});\n\t\tif (!vsixRes.ok || !vsixRes.body) return null;\n\n\t\tconst tmpPath = join(\n\t\t\ttmpdir(),\n\t\t\t`${NEON_EXTENSION_ID}-${meta.version ?? \"latest\"}.vsix`,\n\t\t);\n\t\tconst fileStream = createWriteStream(tmpPath);\n\t\tawait pipeline(\n\t\t\tvsixRes.body as unknown as NodeJS.ReadableStream,\n\t\t\tfileStream,\n\t\t);\n\t\treturn tmpPath;\n\t} catch {\n\t\treturn null;\n\t}\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,oBAAoB;AACjC,MAAM,eAAe;;;;;;;;;;AAWrB,eAAsB,eAAuC;CAE5D,MAAM,EAAE,yBAAyB,MAAM,OAAO;CAC9C,MAAM,eACL,QAAQ,IAAI,wBAAwB,wBAAwB;CAC7D,IAAI,cACH,OAAO,oBAAoB,YAAY;CAExC,OAAO,oBAAoB;AAC5B;;;;;AAMA,eAAe,oBAAoB,YAA4C;CAC9E,MAAM,CAAC,WAAW,QAAQ,kBAAkB,MAAM,GAAG;CAErD,MAAM,WAAW,GADD,WAAW,QAAQ,QAAQ,EACjB,EAAE;CAE5B,IAAI;EAEH,MAAM,WAAW,MAAM,MAAM,UAAU;GACtC,QAAQ;GACR,SAAS;IACR,gBAAgB;IAChB,QAAQ;GACT;GACA,MAAM,KAAK,UAAU;IACpB,SAAS,CACR,EACC,UAAU,CACT;KAAE,YAAY;KAAG,OAAO,GAAG,UAAU,GAAG;IAAO,CAChD,EACD,CACD;IACA,OAAO;GACR,CAAC;GACD,QAAQ,YAAY,QAAQ,IAAK;EAClC,CAAC;EAED,IAAI,CAAC,SAAS,IAAI,OAAO;EAezB,MAAM,cAFY,MAXE,SAAS,KAAK,EAAA,CAWX,UAAU,EAAE,EAAE,aAAa,EAAE,GACnB,WAAW,EAAE,GACd,OAAO,MACrC,MACA,EAAE,cAAc,6CAClB;EAEA,IAAI,CAAC,UAAU,QAAQ,OAAO;EAG9B,MAAM,UAAU,MAAM,MAAM,SAAS,QAAQ;GAC5C,QAAQ,YAAY,QAAQ,GAAK;GACjC,UAAU;EACX,CAAC;EACD,IAAI,CAAC,QAAQ,MAAM,CAAC,QAAQ,MAAM,OAAO;EAEzC,MAAM,UAAU,KAAK,OAAO,GAAG,GAAG,kBAAkB,YAAY;EAChE,MAAM,aAAa,kBAAkB,OAAO;EAC5C,MAAM,SACL,QAAQ,MACR,UACD;EACA,OAAO;CACR,QAAQ;EACP,OAAO;CACR;AACD;;;;AAKA,eAAe,sBAA8C;CAC5D,MAAM,CAAC,WAAW,QAAQ,kBAAkB,MAAM,GAAG;CACrD,MAAM,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,KAAK;CAErD,IAAI;EACH,MAAM,UAAU,MAAM,MAAM,SAAS,EACpC,QAAQ,YAAY,QAAQ,GAAK,EAClC,CAAC;EACD,IAAI,CAAC,QAAQ,IAAI,OAAO;EAExB,MAAM,OAAQ,MAAM,QAAQ,KAAK;EAIjC,MAAM,cAAc,KAAK,OAAO;EAChC,IAAI,CAAC,aAAa,OAAO;EAEzB,MAAM,UAAU,MAAM,MAAM,aAAa,EACxC,QAAQ,YAAY,QAAQ,GAAK,EAClC,CAAC;EACD,IAAI,CAAC,QAAQ,MAAM,CAAC,QAAQ,MAAM,OAAO;EAEzC,MAAM,UAAU,KACf,OAAO,GACP,GAAG,kBAAkB,GAAG,KAAK,WAAW,SAAS,MAClD;EACA,MAAM,aAAa,kBAAkB,OAAO;EAC5C,MAAM,SACL,QAAQ,MACR,UACD;EACA,OAAO;CACR,QAAQ;EACP,OAAO;CACR;AACD"}

package/dist/v2.d.ts

@@ -0,0 +1,31 @@
+import { PhaseResponse } from "./lib/types.js";
+
+//#region src/v2.d.ts
+interface OrchestratorOptions {
+  agent?: string;
+  skipNeonAuth?: boolean;
+  skipMigrations?: boolean;
+  /** Enable preview features (e.g. project bootstrapping from templates) */
+  preview?: boolean;
+}
+/**
+ * v2 orchestrator: checks phases in order and returns the first that needs attention.
+ *
+ * Phase order:
+ *   auth -> setup (if tooling not installed)
+ *        -> getting-started (if tooling installed but no Neon connection string)
+ *        -> resolve .neon context (if connection string exists but no .neon file)
+ *        -> neon_auth (optional) -> complete
+ *
+ * Each call is stateless — it re-checks everything from the file system and credentials.
+ *
+ * The orchestrator uses filesystem inspection to decide what to do:
+ * - No app detected → bootstrap phase (scaffold from template)
+ * - MCP not configured → full setup flow (inspect → install → getting-started)
+ * - MCP configured, no connection string → skip install, go to getting-started
+ * - MCP configured + connection string → fall through to neon-auth/migrations/complete
+ */
+declare function orchestrate(options: OrchestratorOptions): Promise<PhaseResponse>;
+//#endregion
+export { OrchestratorOptions, orchestrate };
+//# sourceMappingURL=v2.d.ts.map

package/dist/v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.ts","names":[],"sources":["../src/v2.ts"],"mappings":";;;UAYiB,mBAAA;;EAAA,YAAA,CAAA,EAAA,OAAmB;EAyBd,cAAW,CAAA,EAAA,OAAA;EAAA;SACvB,CAAA,EAAA,OAAA;;;AACA;;;;;;;;;;;;;;;;iBAFY,WAAA,UACZ,sBACP,QAAQ"}

package/dist/v2.js

@@ -0,0 +1,147 @@
+import { isAuthenticated } from "./lib/auth.js";
+import { inspectProject } from "./lib/inspect.js";
+import { handleAuthPhase } from "./lib/phases/auth.js";
+import { handleGettingStartedPhase } from "./lib/phases/getting-started.js";
+import { handleMigrationsPhase } from "./lib/phases/migrations.js";
+import { handleNeonAuthPhase } from "./lib/phases/neon-auth.js";
+import { handleSetupPhase } from "./lib/phases/setup.js";
+import { resolveNeonContext } from "./lib/resolve-context.js";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+//#region src/v2.ts
+/**
+* v2 orchestrator: checks phases in order and returns the first that needs attention.
+*
+* Phase order:
+*   auth -> setup (if tooling not installed)
+*        -> getting-started (if tooling installed but no Neon connection string)
+*        -> resolve .neon context (if connection string exists but no .neon file)
+*        -> neon_auth (optional) -> complete
+*
+* Each call is stateless — it re-checks everything from the file system and credentials.
+*
+* The orchestrator uses filesystem inspection to decide what to do:
+* - No app detected → bootstrap phase (scaffold from template)
+* - MCP not configured → full setup flow (inspect → install → getting-started)
+* - MCP configured, no connection string → skip install, go to getting-started
+* - MCP configured + connection string → fall through to neon-auth/migrations/complete
+*/
+async function orchestrate(options) {
+	if (!await isAuthenticated()) return handleAuthPhase({ agent: options.agent });
+	const cwd = process.cwd();
+	const inspection = await inspectProject([
+		{
+			id: "has_app",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "mcp_server",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "skills",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "connection_string",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "project_stack",
+			description: "",
+			lookFor: []
+		},
+		{
+			id: "migrations",
+			description: "",
+			lookFor: []
+		}
+	]);
+	const hasApp = options.preview ? inspection.hasApp === true : true;
+	const toolingInstalled = inspection.mcpConfigured && inspection.skillsInstalled;
+	const hasNeonConnection = inspection.connectionString === true;
+	if (!hasApp || !toolingInstalled) {
+		cleanupInitState(resolve(cwd, ".neon"));
+		return handleSetupPhase({
+			agent: options.agent,
+			hasApp
+		});
+	}
+	const neonContextPath = resolve(cwd, ".neon");
+	const neonContext = readNeonContext(neonContextPath);
+	const initState = typeof neonContext._init === "object" && neonContext._init !== null ? neonContext._init : {};
+	const features = Array.isArray(initState.features) ? initState.features : [];
+	if (!hasNeonConnection) return handleGettingStartedPhase({
+		agent: options.agent,
+		hasConnectionString: false,
+		framework: inspection.framework,
+		orm: inspection.orm,
+		migrationTool: inspection.migrationTool,
+		migrationDir: inspection.migrationDir,
+		features,
+		preview: options.preview
+	});
+	if (!neonContext.projectId) try {
+		const resolved = await resolveNeonContext(cwd);
+		if (resolved) {
+			const merged = { ...neonContext };
+			if (resolved.orgId) merged.orgId = resolved.orgId;
+			if (resolved.projectId) merged.projectId = resolved.projectId;
+			writeFileSync(neonContextPath, `${JSON.stringify(merged, null, 2)}\n`);
+		}
+	} catch {}
+	const hasFeatureRequirements = features.length > 0;
+	if (hasFeatureRequirements ? features.includes("auth") : !options.skipNeonAuth) {
+		if (!checkNeonAuth(cwd)) return handleNeonAuthPhase({
+			agent: options.agent,
+			setup: hasFeatureRequirements
+		});
+	}
+	if (!options.skipMigrations) return handleMigrationsPhase({ agent: options.agent });
+	cleanupInitState(neonContextPath);
+	return {
+		phase: "setup",
+		status: "complete",
+		nextAction: {
+			type: "complete",
+			message: "Neon setup is complete. Your database is configured and your agent has the Neon MCP server and skills available."
+		}
+	};
+}
+/** Remove the ephemeral _init key from .neon, preserving other fields. */
+function cleanupInitState(neonContextPath) {
+	if (!existsSync(neonContextPath)) return;
+	try {
+		const context = JSON.parse(readFileSync(neonContextPath, "utf-8"));
+		if (context._init !== void 0) {
+			delete context._init;
+			writeFileSync(neonContextPath, `${JSON.stringify(context, null, 2)}\n`);
+		}
+	} catch {}
+}
+function readNeonContext(neonContextPath) {
+	if (!existsSync(neonContextPath)) return {};
+	try {
+		return JSON.parse(readFileSync(neonContextPath, "utf-8"));
+	} catch {
+		return {};
+	}
+}
+function checkNeonAuth(cwd) {
+	const envPath = resolve(cwd, ".env");
+	if (!existsSync(envPath)) return false;
+	try {
+		const content = readFileSync(envPath, "utf-8");
+		return /^NEON_AUTH_/m.test(content);
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { orchestrate };
+
+//# sourceMappingURL=v2.js.map

package/dist/v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.js","names":[],"sources":["../src/v2.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { isAuthenticated } from \"./lib/auth.js\";\nimport { inspectProject } from \"./lib/inspect.js\";\nimport { handleAuthPhase } from \"./lib/phases/auth.js\";\nimport { handleGettingStartedPhase } from \"./lib/phases/getting-started.js\";\nimport { handleMigrationsPhase } from \"./lib/phases/migrations.js\";\nimport { handleNeonAuthPhase } from \"./lib/phases/neon-auth.js\";\nimport { handleSetupPhase } from \"./lib/phases/setup.js\";\nimport { resolveNeonContext } from \"./lib/resolve-context.js\";\nimport type { PhaseResponse } from \"./lib/types.js\";\n\nexport interface OrchestratorOptions {\n\tagent?: string;\n\tskipNeonAuth?: boolean;\n\tskipMigrations?: boolean;\n\t/** Enable preview features (e.g. project bootstrapping from templates) */\n\tpreview?: boolean;\n}\n\n/**\n * v2 orchestrator: checks phases in order and returns the first that needs attention.\n *\n * Phase order:\n *   auth -> setup (if tooling not installed)\n *        -> getting-started (if tooling installed but no Neon connection string)\n *        -> resolve .neon context (if connection string exists but no .neon file)\n *        -> neon_auth (optional) -> complete\n *\n * Each call is stateless — it re-checks everything from the file system and credentials.\n *\n * The orchestrator uses filesystem inspection to decide what to do:\n * - No app detected → bootstrap phase (scaffold from template)\n * - MCP not configured → full setup flow (inspect → install → getting-started)\n * - MCP configured, no connection string → skip install, go to getting-started\n * - MCP configured + connection string → fall through to neon-auth/migrations/complete\n */\nexport async function orchestrate(\n\toptions: OrchestratorOptions,\n): Promise<PhaseResponse> {\n\t// Phase 1: Auth\n\tconst authed = await isAuthenticated();\n\tif (!authed) {\n\t\treturn handleAuthPhase({ agent: options.agent });\n\t}\n\n\tconst cwd = process.cwd();\n\n\t// Phase 2: Inspect what's already in place\n\tconst inspection = await inspectProject([\n\t\t{ id: \"has_app\", description: \"\", lookFor: [] },\n\t\t{ id: \"mcp_server\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"connection_string\", description: \"\", lookFor: [] },\n\t\t{ id: \"project_stack\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t]);\n\n\t// Only detect empty projects when --preview is enabled\n\tconst hasApp = options.preview ? inspection.hasApp === true : true;\n\tconst toolingInstalled =\n\t\tinspection.mcpConfigured && inspection.skillsInstalled;\n\tconst hasNeonConnection = inspection.connectionString === true;\n\n\t// Phase 3a: No app or tooling not installed → setup flow\n\t// When !hasApp (preview mode), setup will offer template selection before asking about tooling.\n\t// Clean up any stale _init state from a previous run.\n\tif (!hasApp || !toolingInstalled) {\n\t\tcleanupInitState(resolve(cwd, \".neon\"));\n\t\treturn handleSetupPhase({ agent: options.agent, hasApp });\n\t}\n\n\t// Read .neon context early — needed for feature-based routing\n\tconst neonContextPath = resolve(cwd, \".neon\");\n\tconst neonContext = readNeonContext(neonContextPath);\n\tconst initState =\n\t\ttypeof neonContext._init === \"object\" && neonContext._init !== null\n\t\t\t? (neonContext._init as Record<string, unknown>)\n\t\t\t: {};\n\tconst features: string[] = Array.isArray(initState.features)\n\t\t? initState.features\n\t\t: [];\n\n\t// Phase 3b: Tooling installed but no Neon connection string → getting-started\n\tif (!hasNeonConnection) {\n\t\treturn handleGettingStartedPhase({\n\t\t\tagent: options.agent,\n\t\t\thasConnectionString: false,\n\t\t\tframework: inspection.framework as string | undefined,\n\t\t\torm: inspection.orm as string | undefined,\n\t\t\tmigrationTool: inspection.migrationTool as string | undefined,\n\t\t\tmigrationDir: inspection.migrationDir as string | undefined,\n\t\t\tfeatures,\n\t\t\tpreview: options.preview,\n\t\t});\n\t}\n\n\t// Phase 3c: Neon connection exists but no .neon context file → resolve project\n\n\tif (!neonContext.projectId) {\n\t\t// Resolve the project from the connection string and merge into .neon\n\t\ttry {\n\t\t\tconst resolved = await resolveNeonContext(cwd);\n\t\t\tif (resolved) {\n\t\t\t\tconst merged = { ...neonContext };\n\t\t\t\tif (resolved.orgId) merged.orgId = resolved.orgId;\n\t\t\t\tif (resolved.projectId) merged.projectId = resolved.projectId;\n\t\t\t\twriteFileSync(\n\t\t\t\t\tneonContextPath,\n\t\t\t\t\t`${JSON.stringify(merged, null, 2)}\\n`,\n\t\t\t\t);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Continue the flow regardless — missing .neon is not a blocker\n\t\t}\n\t}\n\n\t// Phase 4: Neon Auth — skip if template/user doesn't require it\n\tconst hasFeatureRequirements = features.length > 0;\n\tconst needsAuth = hasFeatureRequirements\n\t\t? features.includes(\"auth\")\n\t\t: !options.skipNeonAuth;\n\tif (needsAuth) {\n\t\tconst hasNeonAuth = checkNeonAuth(cwd);\n\t\tif (!hasNeonAuth) {\n\t\t\t// If auth was already selected via features, go straight to setup\n\t\t\t// (don't re-ask the user)\n\t\t\treturn handleNeonAuthPhase({\n\t\t\t\tagent: options.agent,\n\t\t\t\tsetup: hasFeatureRequirements,\n\t\t\t});\n\t\t}\n\t}\n\n\t// Phase 5: Migrations\n\tif (!options.skipMigrations) {\n\t\treturn handleMigrationsPhase({ agent: options.agent });\n\t}\n\n\t// All done — clean up ephemeral _init state from .neon\n\tcleanupInitState(neonContextPath);\n\n\treturn {\n\t\tphase: \"setup\",\n\t\tstatus: \"complete\",\n\t\tnextAction: {\n\t\t\ttype: \"complete\",\n\t\t\tmessage:\n\t\t\t\t\"Neon setup is complete. Your database is configured and your agent has the Neon MCP server and skills available.\",\n\t\t},\n\t};\n}\n\n/** Remove the ephemeral _init key from .neon, preserving other fields. */\nfunction cleanupInitState(neonContextPath: string): void {\n\tif (!existsSync(neonContextPath)) return;\n\ttry {\n\t\tconst context = JSON.parse(readFileSync(neonContextPath, \"utf-8\"));\n\t\tif (context._init !== undefined) {\n\t\t\tdelete context._init;\n\t\t\twriteFileSync(\n\t\t\t\tneonContextPath,\n\t\t\t\t`${JSON.stringify(context, null, 2)}\\n`,\n\t\t\t);\n\t\t}\n\t} catch {}\n}\n\nfunction readNeonContext(neonContextPath: string): Record<string, unknown> {\n\tif (!existsSync(neonContextPath)) return {};\n\ttry {\n\t\treturn JSON.parse(readFileSync(neonContextPath, \"utf-8\"));\n\t} catch {\n\t\treturn {};\n\t}\n}\n\nfunction checkNeonAuth(cwd: string): boolean {\n\tconst envPath = resolve(cwd, \".env\");\n\tif (!existsSync(envPath)) return false;\n\ttry {\n\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\treturn /^NEON_AUTH_/m.test(content);\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon-init",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "description": "Initialize Neon projects",
   "keywords": [
     "neon",
@@ -10,7 +10,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/neondatabase/neondb-cli.git"
+    "url": "git+https://github.com/neondatabase/neon-pkgs.git"
   },
   "license": "Apache-2.0",
   "author": {
@@ -44,7 +44,10 @@
   },
   "dependencies": {
     "@clack/prompts": "0.10.1",
+    "add-mcp": "^1.5.1",
     "execa": "^9.5.2",
+    "picocolors": "^1.1.1",
+    "yaml": "^2.9.0",
     "yargs": "^18.0.0",
     "yoctocolors": "^2.1.2"
   },
@@ -55,9 +58,11 @@
     "provenance": false
   },
   "scripts": {
-    "build": "tsc --noEmit && tsdown",
+    "build": "node scripts/set-vsx-gallery.mjs && tsc --noEmit && tsdown",
+    "build:internal": "node scripts/set-vsx-gallery.mjs https://cursor-vsx-proxy.cloud.databricks.com/gallery && tsc --noEmit && tsdown",
+    "pretest": "node scripts/set-vsx-gallery.mjs",
     "test": "vitest --passWithNoTests",
     "test:ci": "vitest run --passWithNoTests",
-    "tsc": "tsc"
+    "tsc": "node scripts/set-vsx-gallery.mjs && tsc"
   }
 }

package/dist/lib/mcp-config.d.ts

@@ -1,24 +0,0 @@
-import { Editor, MCPConfig } from "./types.js";
-
-//#region src/lib/mcp-config.d.ts
-
-/**
- * Gets or creates the MCP configuration for a specific editor
- * - Cursor: Global config at ~/.cursor/mcp.json
- * - VS Code: Try global config first, then workspace
- * - Claude CLI: Global config at ~/.claude.json
- */
-declare function getMCPConfig(homeDir: string, workspaceDir: string, editor: Editor): {
-  config: MCPConfig;
-  configPath: string;
-};
-/**
- * Writes the MCP configuration to the appropriate location
- * - Cursor: Global config at ~/.cursor/mcp.json
- * - VS Code: Global config (preferred) or workspace config (fallback)
- * - Claude CLI: Global config at ~/.claude.json
- */
-declare function writeMCPConfig(configPath: string, config: MCPConfig): void;
-//#endregion
-export { getMCPConfig, writeMCPConfig };
-//# sourceMappingURL=mcp-config.d.ts.map

package/dist/lib/mcp-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-config.d.ts","names":[],"sources":["../../src/lib/mcp-config.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;;;;AAIsB,iBAJN,YAAA,CAIM,OAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,MAAA,EADb,MACa,CAAA,EAAA;EAgDN,MAAA,EAhDH,SAgDiB;;;;;;;;;iBAAd,cAAA,6BAA2C"}

package/dist/lib/mcp-config.js

@@ -1,51 +0,0 @@
-import { getVSCodeGlobalConfigDir } from "./editors.js";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-
-//#region src/lib/mcp-config.ts
-/**
-* Gets or creates the MCP configuration for a specific editor
-* - Cursor: Global config at ~/.cursor/mcp.json
-* - VS Code: Try global config first, then workspace
-* - Claude CLI: Global config at ~/.claude.json
-*/
-function getMCPConfig(homeDir, workspaceDir, editor) {
-	let mcpConfigPath;
-	if (editor === "VS Code") {
-		const vscodeGlobalDir = getVSCodeGlobalConfigDir(homeDir);
-		if (vscodeGlobalDir && existsSync(vscodeGlobalDir)) mcpConfigPath = resolve(vscodeGlobalDir, "mcp.json");
-		else mcpConfigPath = resolve(workspaceDir, ".vscode", "mcp.json");
-	} else if (editor === "Claude CLI") mcpConfigPath = resolve(homeDir, ".claude.json");
-	else mcpConfigPath = resolve(homeDir, ".cursor", "mcp.json");
-	if (existsSync(mcpConfigPath)) try {
-		const content = readFileSync(mcpConfigPath, "utf-8");
-		return {
-			config: JSON.parse(content),
-			configPath: mcpConfigPath
-		};
-	} catch (_error) {
-		return {
-			config: editor === "VS Code" ? { servers: {} } : { mcpServers: {} },
-			configPath: mcpConfigPath
-		};
-	}
-	return {
-		config: editor === "VS Code" ? { servers: {} } : { mcpServers: {} },
-		configPath: mcpConfigPath
-	};
-}
-/**
-* Writes the MCP configuration to the appropriate location
-* - Cursor: Global config at ~/.cursor/mcp.json
-* - VS Code: Global config (preferred) or workspace config (fallback)
-* - Claude CLI: Global config at ~/.claude.json
-*/
-function writeMCPConfig(configPath, config) {
-	const editorDir = dirname(configPath);
-	if (!existsSync(editorDir)) mkdirSync(editorDir, { recursive: true });
-	writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-}
-
-//#endregion
-export { getMCPConfig, writeMCPConfig };
-//# sourceMappingURL=mcp-config.js.map

package/dist/lib/mcp-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-config.js","names":[],"sources":["../../src/lib/mcp-config.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { getVSCodeGlobalConfigDir } from \"./editors.js\";\nimport type { Editor, MCPConfig } from \"./types.js\";\n\n/**\n * Gets or creates the MCP configuration for a specific editor\n * - Cursor: Global config at ~/.cursor/mcp.json\n * - VS Code: Try global config first, then workspace\n * - Claude CLI: Global config at ~/.claude.json\n */\nexport function getMCPConfig(\n\thomeDir: string,\n\tworkspaceDir: string,\n\teditor: Editor,\n): { config: MCPConfig; configPath: string } {\n\tlet mcpConfigPath: string;\n\n\tif (editor === \"VS Code\") {\n\t\t// Try global config first\n\t\tconst vscodeGlobalDir = getVSCodeGlobalConfigDir(homeDir);\n\t\tif (vscodeGlobalDir && existsSync(vscodeGlobalDir)) {\n\t\t\tmcpConfigPath = resolve(vscodeGlobalDir, \"mcp.json\");\n\t\t} else {\n\t\t\t// Fall back to workspace\n\t\t\tmcpConfigPath = resolve(workspaceDir, \".vscode\", \"mcp.json\");\n\t\t}\n\t} else if (editor === \"Claude CLI\") {\n\t\t// Claude CLI uses ~/.claude.json\n\t\tmcpConfigPath = resolve(homeDir, \".claude.json\");\n\t} else {\n\t\t// Cursor uses ~/.cursor/mcp.json\n\t\tmcpConfigPath = resolve(homeDir, \".cursor\", \"mcp.json\");\n\t}\n\n\tif (existsSync(mcpConfigPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(mcpConfigPath, \"utf-8\");\n\t\t\treturn {\n\t\t\t\tconfig: JSON.parse(content),\n\t\t\t\tconfigPath: mcpConfigPath,\n\t\t\t};\n\t\t} catch (_error) {\n\t\t\treturn {\n\t\t\t\tconfig:\n\t\t\t\t\teditor === \"VS Code\" ? { servers: {} } : { mcpServers: {} },\n\t\t\t\tconfigPath: mcpConfigPath,\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\tconfig: editor === \"VS Code\" ? { servers: {} } : { mcpServers: {} },\n\t\tconfigPath: mcpConfigPath,\n\t};\n}\n\n/**\n * Writes the MCP configuration to the appropriate location\n * - Cursor: Global config at ~/.cursor/mcp.json\n * - VS Code: Global config (preferred) or workspace config (fallback)\n * - Claude CLI: Global config at ~/.claude.json\n */\nexport function writeMCPConfig(configPath: string, config: MCPConfig): void {\n\tconst editorDir = dirname(configPath);\n\n\tif (!existsSync(editorDir)) {\n\t\tmkdirSync(editorDir, { recursive: true });\n\t}\n\n\twriteFileSync(configPath, JSON.stringify(config, null, 2), \"utf-8\");\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,aACf,SACA,cACA,QAC4C;CAC5C,IAAI;AAEJ,KAAI,WAAW,WAAW;EAEzB,MAAM,kBAAkB,yBAAyB,QAAQ;AACzD,MAAI,mBAAmB,WAAW,gBAAgB,CACjD,iBAAgB,QAAQ,iBAAiB,WAAW;MAGpD,iBAAgB,QAAQ,cAAc,WAAW,WAAW;YAEnD,WAAW,aAErB,iBAAgB,QAAQ,SAAS,eAAe;KAGhD,iBAAgB,QAAQ,SAAS,WAAW,WAAW;AAGxD,KAAI,WAAW,cAAc,CAC5B,KAAI;EACH,MAAM,UAAU,aAAa,eAAe,QAAQ;AACpD,SAAO;GACN,QAAQ,KAAK,MAAM,QAAQ;GAC3B,YAAY;GACZ;UACO,QAAQ;AAChB,SAAO;GACN,QACC,WAAW,YAAY,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE;GAC5D,YAAY;GACZ;;AAIH,QAAO;EACN,QAAQ,WAAW,YAAY,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE;EACnE,YAAY;EACZ;;;;;;;;AASF,SAAgB,eAAe,YAAoB,QAAyB;CAC3E,MAAM,YAAY,QAAQ,WAAW;AAErC,KAAI,CAAC,WAAW,UAAU,CACzB,WAAU,WAAW,EAAE,WAAW,MAAM,CAAC;AAG1C,eAAc,YAAY,KAAK,UAAU,QAAQ,MAAM,EAAE,EAAE,QAAQ"}