neon-init 0.16.3 → 0.17.1

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

@@ -1 +1 @@
-{"version":3,"file":"status.js","names":[],"sources":["../../../src/lib/phases/status.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport type { StatusResponse } from \"../types.js\";\n\nexport interface StatusOptions {\n\tagent?: string;\n}\n\nexport async function handleStatusPhase(\n\t_options: StatusOptions,\n): Promise<StatusResponse> {\n\tconst authed = await isAuthenticated();\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"database_url\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t]);\n\n\tconst hasDatabaseUrl = inspection.databaseUrl === true;\n\tconst skillsInstalled = inspection.skillsInstalled === true;\n\tconst migrationTool = (inspection.migrationTool as string | null) ?? null;\n\tconst hasMigrations =\n\t\tmigrationTool !== null &&\n\t\tmigrationTool !== \"none\" &&\n\t\tinspection.migrationDir !== \"none\";\n\n\tconst recommendations: StatusResponse[\"recommendations\"] = [];\n\n\tif (!authed) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"Not authenticated with Neon\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"auth\"}'`,\n\t\t});\n\t}\n\n\tif (!hasDatabaseUrl) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"No DATABASE_URL found in .env\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"db\"}'`,\n\t\t});\n\t}\n\n\tif (!skillsInstalled) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: \"Neon agent skills not detected in this project\",\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"skills\",\"install\":true}'`,\n\t\t});\n\t}\n\n\tif (migrationTool && !hasMigrations) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: `${migrationTool} detected but no migrations found`,\n\t\t\tcommand: `neonctl init --agent --json --data '{\"step\":\"migrations\"}'`,\n\t\t});\n\t}\n\n\treturn {\n\t\tauth: {\n\t\t\tauthenticated: authed,\n\t\t},\n\t\ttooling: {\n\t\t\tmcpServer: { configured: null },\n\t\t\tskills: { installed: skillsInstalled },\n\t\t},\n\t\tproject: {\n\t\t\tdatabaseUrl: hasDatabaseUrl,\n\t\t},\n\t\tmigrations: {\n\t\t\ttool: migrationTool,\n\t\t\thasMigrations,\n\t\t},\n\t\trecommendations,\n\t};\n}\n"],"mappings":";;;AAQA,eAAsB,kBACrB,UAC0B;CAC1B,MAAM,SAAS,MAAM,gBAAgB;CAErC,MAAM,aAAa,MAAM,eAAe;EACvC;GAAE,IAAI;GAAgB,aAAa;GAAI,SAAS,CAAC;EAAE;EACnD;GAAE,IAAI;GAAU,aAAa;GAAI,SAAS,CAAC;EAAE;EAC7C;GAAE,IAAI;GAAc,aAAa;GAAI,SAAS,CAAC;EAAE;CAClD,CAAC;CAED,MAAM,iBAAiB,WAAW,gBAAgB;CAClD,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,gBAAiB,WAAW,iBAAmC;CACrE,MAAM,gBACL,kBAAkB,QAClB,kBAAkB,UAClB,WAAW,iBAAiB;CAE7B,MAAM,kBAAqD,CAAC;CAE5D,IAAI,CAAC,QACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,gBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,iBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,iBAAiB,CAAC,eACrB,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS,GAAG,cAAc;EAC1B,SAAS;CACV,CAAC;CAGF,OAAO;EACN,MAAM,EACL,eAAe,OAChB;EACA,SAAS;GACR,WAAW,EAAE,YAAY,KAAK;GAC9B,QAAQ,EAAE,WAAW,gBAAgB;EACtC;EACA,SAAS,EACR,aAAa,eACd;EACA,YAAY;GACX,MAAM;GACN;EACD;EACA;CACD;AACD"}
+{"version":3,"file":"status.js","names":[],"sources":["../../../src/lib/phases/status.ts"],"sourcesContent":["import { isAuthenticated } from \"../auth.js\";\nimport { inspectProject } from \"../inspect.js\";\nimport type { StatusResponse } from \"../types.js\";\n\nexport interface StatusOptions {\n\tagent?: string;\n}\n\nexport async function handleStatusPhase(\n\t_options: StatusOptions,\n): Promise<StatusResponse> {\n\tconst authed = await isAuthenticated();\n\n\tconst inspection = await inspectProject([\n\t\t{ id: \"mcp_server\", description: \"\", lookFor: [] },\n\t\t{ id: \"database_url\", description: \"\", lookFor: [] },\n\t\t{ id: \"skills\", description: \"\", lookFor: [] },\n\t\t{ id: \"migrations\", description: \"\", lookFor: [] },\n\t]);\n\n\tconst hasDatabaseUrl = inspection.databaseUrl === true;\n\tconst mcpConfigured = inspection.mcpConfigured === true;\n\tconst skillsInstalled = inspection.skillsInstalled === true;\n\tconst migrationTool = (inspection.migrationTool as string | null) ?? null;\n\tconst hasMigrations =\n\t\tmigrationTool !== null &&\n\t\tmigrationTool !== \"none\" &&\n\t\tinspection.migrationDir !== \"none\";\n\n\tconst recommendations: StatusResponse[\"recommendations\"] = [];\n\n\tif (!authed) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"Not authenticated with Neon\",\n\t\t\tcommand: `neonctl init --agent --data '{\"step\":\"auth\"}'`,\n\t\t});\n\t}\n\n\tif (!hasDatabaseUrl) {\n\t\trecommendations.push({\n\t\t\tpriority: \"high\",\n\t\t\tmessage: \"No DATABASE_URL found in .env\",\n\t\t\tcommand: `neonctl init --agent --data '{\"step\":\"db\"}'`,\n\t\t});\n\t}\n\n\tif (!skillsInstalled) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: \"Neon agent skills not detected in this project\",\n\t\t\tcommand: `neonctl init --agent --data '{\"step\":\"skills\",\"install\":true}'`,\n\t\t});\n\t}\n\n\tif (migrationTool && !hasMigrations) {\n\t\trecommendations.push({\n\t\t\tpriority: \"medium\",\n\t\t\tmessage: `${migrationTool} detected but no migrations found`,\n\t\t\tcommand: `neonctl init --agent --data '{\"step\":\"migrations\"}'`,\n\t\t});\n\t}\n\n\treturn {\n\t\tauth: {\n\t\t\tauthenticated: authed,\n\t\t},\n\t\ttooling: {\n\t\t\tmcpServer: {\n\t\t\t\tconfigured: mcpConfigured,\n\t\t\t\tscope: inspection.mcpScope || null,\n\t\t\t},\n\t\t\tskills: {\n\t\t\t\tinstalled: skillsInstalled,\n\t\t\t\tscope: inspection.skillsScope || null,\n\t\t\t},\n\t\t},\n\t\tproject: {\n\t\t\tdatabaseUrl: hasDatabaseUrl,\n\t\t},\n\t\tmigrations: {\n\t\t\ttool: migrationTool,\n\t\t\thasMigrations,\n\t\t},\n\t\trecommendations,\n\t};\n}\n"],"mappings":";;;AAQA,eAAsB,kBACrB,UAC0B;CAC1B,MAAM,SAAS,MAAM,gBAAgB;CAErC,MAAM,aAAa,MAAM,eAAe;EACvC;GAAE,IAAI;GAAc,aAAa;GAAI,SAAS,CAAC;EAAE;EACjD;GAAE,IAAI;GAAgB,aAAa;GAAI,SAAS,CAAC;EAAE;EACnD;GAAE,IAAI;GAAU,aAAa;GAAI,SAAS,CAAC;EAAE;EAC7C;GAAE,IAAI;GAAc,aAAa;GAAI,SAAS,CAAC;EAAE;CAClD,CAAC;CAED,MAAM,iBAAiB,WAAW,gBAAgB;CAClD,MAAM,gBAAgB,WAAW,kBAAkB;CACnD,MAAM,kBAAkB,WAAW,oBAAoB;CACvD,MAAM,gBAAiB,WAAW,iBAAmC;CACrE,MAAM,gBACL,kBAAkB,QAClB,kBAAkB,UAClB,WAAW,iBAAiB;CAE7B,MAAM,kBAAqD,CAAC;CAE5D,IAAI,CAAC,QACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,gBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,CAAC,iBACJ,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS;EACT,SAAS;CACV,CAAC;CAGF,IAAI,iBAAiB,CAAC,eACrB,gBAAgB,KAAK;EACpB,UAAU;EACV,SAAS,GAAG,cAAc;EAC1B,SAAS;CACV,CAAC;CAGF,OAAO;EACN,MAAM,EACL,eAAe,OAChB;EACA,SAAS;GACR,WAAW;IACV,YAAY;IACZ,OAAO,WAAW,YAAY;GAC/B;GACA,QAAQ;IACP,WAAW;IACX,OAAO,WAAW,eAAe;GAClC;EACD;EACA,SAAS,EACR,aAAa,eACd;EACA,YAAY;GACX,MAAM;GACN;EACD;EACA;CACD;AACD"}

package/dist/lib/route-command.d.ts

@@ -6,8 +6,8 @@ declare function routeCommand(args: string[]): Promise<PhaseResponse>;
 /**
  * Routes a --data JSON payload with a "step" field to the appropriate phase
  * handler. This lets agents use a single command surface:
- *   neon-init --agent --json --data '{"step":"auth"}'
- *   neon-init --agent --json --data '{"step":"db","projectId":"xyz"}'
+ *   neon-init --agent --data '{"step":"auth"}'
+ *   neon-init --agent --data '{"step":"db","projectId":"xyz"}'
  */
 declare function routeDataStep(data: Record<string, unknown>, agent: string | undefined): Promise<unknown>;
 //#endregion

package/dist/lib/route-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-command.d.ts","names":[],"sources":["../../src/lib/route-command.ts"],"mappings":";;;;AAuEoD,iBAA9B,YAAA,CAA8B,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,OAAA,CAAQ,aAAR,CAAA;AAAO;AAiL3D;;;;AAGU;iBAHY,aAAA,OACf,qDAEJ"}
+{"version":3,"file":"route-command.d.ts","names":[],"sources":["../../src/lib/route-command.ts"],"mappings":";;;;AAuEoD,iBAA9B,YAAA,CAA8B,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,OAAA,CAAQ,aAAR,CAAA;AAAO;AAgL3D;;;;AAGU;iBAHY,aAAA,OACf,qDAEJ"}

package/dist/lib/route-command.js

@@ -182,7 +182,6 @@ async function routeCommand(args) {
 			const { orchestrate } = await import("../v2.js");
 			return orchestrate({
 				agent,
-				skipNeonAuth: parsed.skipNeonAuth === true,
 				skipMigrations: parsed.skipMigrations === true,
 				preview: parsed.preview === true
 			});
@@ -192,11 +191,12 @@ async function routeCommand(args) {
 /**
 * Routes a --data JSON payload with a "step" field to the appropriate phase
 * handler. This lets agents use a single command surface:
-*   neon-init --agent --json --data '{"step":"auth"}'
-*   neon-init --agent --json --data '{"step":"db","projectId":"xyz"}'
+*   neon-init --agent --data '{"step":"auth"}'
+*   neon-init --agent --data '{"step":"db","projectId":"xyz"}'
 */
 async function routeDataStep(data, agent) {
-	const { step, ...rest } = data;
+	const { step, agentId, ...rest } = data;
+	const resolvedAgent = typeof agentId === "string" ? agentId : agent;
 	if (rest.data !== void 0 && Object.keys(rest).length === 1) {
 		let nested = rest.data;
 		if (typeof nested === "string") try {
@@ -211,62 +211,62 @@ async function routeDataStep(data, agent) {
 		case "auth": {
 			const { handleAuthPhase } = await import("./phases/auth.js");
 			return handleAuthPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "db": {
 			const { handleDbPhase } = await import("./phases/db.js");
 			return handleDbPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "setup": {
 			const { handleSetupPhase } = await import("./phases/setup.js");
 			return handleSetupPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "getting-started": {
 			const { handleGettingStartedPhase } = await import("./phases/getting-started.js");
 			return handleGettingStartedPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "mcp": {
 			const { handleMcpPhase } = await import("./phases/mcp.js");
 			return handleMcpPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "skills": {
 			const { handleSkillsPhase } = await import("./phases/skills.js");
 			return handleSkillsPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "migrations": {
 			const { handleMigrationsPhase } = await import("./phases/migrations.js");
 			return handleMigrationsPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "neon-auth": {
 			const { handleNeonAuthPhase } = await import("./phases/neon-auth.js");
 			return handleNeonAuthPhase({
-				agent,
+				agent: resolvedAgent,
 				...rest
 			});
 		}
 		case "status": {
 			const { handleStatusPhase } = await import("./phases/status.js");
-			return handleStatusPhase({ agent });
+			return handleStatusPhase({ agent: resolvedAgent });
 		}
 		case "finalize": {
 			const { handleCleanup } = await import("./phases/cleanup.js");

package/dist/lib/route-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-command.js","names":[],"sources":["../../src/lib/route-command.ts"],"sourcesContent":["/**\n * Routes neon-init CLI args to the appropriate phase handler directly,\n * without shelling out. This is the in-process equivalent of calling\n * `neon-init <subcommand> <flags>`.\n */\n\nimport { detectAgent } from \"./detect-agent.js\";\nimport type { PhaseResponse } from \"./types.js\";\n\nfunction resolveAgent(explicit: string | undefined): string | undefined {\n\treturn explicit ?? detectAgent() ?? undefined;\n}\n\n/** Known short flag aliases (mirrors yargs config in cli.ts) */\nconst SHORT_FLAG_MAP: Record<string, string> = {\n\ta: \"agent\",\n};\n\nfunction parseArgs(args: string[]): Record<string, string | boolean> {\n\tconst result: Record<string, string | boolean> = {};\n\tlet i = 0;\n\n\t// First arg may be the subcommand\n\tif (args.length > 0 && !args[0].startsWith(\"-\")) {\n\t\tresult._command = args[0];\n\t\ti = 1;\n\t}\n\n\twhile (i < args.length) {\n\t\tconst arg = args[i];\n\t\tif (arg.startsWith(\"--\")) {\n\t\t\tconst key = arg\n\t\t\t\t.slice(2)\n\t\t\t\t.replace(/-([a-z])/g, (_, c) => c.toUpperCase());\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[key] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[key] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else if (\n\t\t\targ.startsWith(\"-\") &&\n\t\t\t!arg.startsWith(\"--\") &&\n\t\t\targ.length === 2\n\t\t) {\n\t\t\tconst shortKey = arg[1];\n\t\t\tconst longKey = SHORT_FLAG_MAP[shortKey] ?? shortKey;\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[longKey] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[longKey] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else {\n\t\t\ti += 1;\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction toBool(val: string | boolean | undefined): boolean | null {\n\tif (val === true || val === \"true\") return true;\n\tif (val === false || val === \"false\") return false;\n\treturn null;\n}\n\nexport async function routeCommand(args: string[]): Promise<PhaseResponse> {\n\tconst parsed = parseArgs(args);\n\tconst command = parsed._command as string | undefined;\n\tconst agent = resolveAgent(parsed.agent as string | undefined);\n\n\tswitch (command) {\n\t\tcase \"finalize\": {\n\t\t\tconst { handleCleanup } = await import(\"./phases/cleanup.js\");\n\t\t\treturn handleCleanup();\n\t\t}\n\n\t\tcase \"auth\": {\n\t\t\tconst { handleAuthPhase } = await import(\"./phases/auth.js\");\n\t\t\treturn handleAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tmethod: parsed.method as \"existing\" | \"new\" | undefined,\n\t\t\t\tverify: parsed.verify === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"mcp\": {\n\t\t\tconst { handleMcpPhase } = await import(\"./phases/mcp.js\");\n\t\t\treturn handleMcpPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true || parsed.update === true,\n\t\t\t\tscope: (parsed.scope as \"global\" | \"project\") ?? \"global\",\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t});\n\t\t}\n\n\t\tcase \"skills\": {\n\t\t\tconst { handleSkillsPhase } = await import(\"./phases/skills.js\");\n\t\t\treturn handleSkillsPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true,\n\t\t\t\tupdate: parsed.update === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"setup\": {\n\t\t\tconst { handleSetupPhase } = await import(\"./phases/setup.js\");\n\n\t\t\t// --data JSON path\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\n\t\t\t\t// Normalize string booleans\n\t\t\t\tfor (const key of [\n\t\t\t\t\t\"mcpConfigured\",\n\t\t\t\t\t\"connectionString\",\n\t\t\t\t\t\"isVscodeIde\",\n\t\t\t\t\t\"installExtension\",\n\t\t\t\t\t\"execute\",\n\t\t\t\t]) {\n\t\t\t\t\tif (data[key] === \"true\") data[key] = true;\n\t\t\t\t\telse if (data[key] === \"false\") data[key] = false;\n\t\t\t\t}\n\n\t\t\t\treturn handleSetupPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleSetupPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleSetupPhase({\n\t\t\t\tagent,\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t\tconnectionString: toBool(parsed.connectionString),\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tisVscodeIde: toBool(parsed.isVscodeIde),\n\t\t\t\tmode: parsed.mode as \"defaults\" | \"customize\" | undefined,\n\t\t\t\tmcpScope: parsed.mcpScope as \"global\" | \"project\" | undefined,\n\t\t\t\tskillsScope: parsed.skillsScope as\n\t\t\t\t\t| \"global\"\n\t\t\t\t\t| \"project\"\n\t\t\t\t\t| undefined,\n\t\t\t\tinstallExtension: toBool(parsed.installExtension) === true,\n\t\t\t\texecute: parsed.execute === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"getting-started\": {\n\t\t\tconst { handleGettingStartedPhase } = await import(\n\t\t\t\t\"./phases/getting-started.js\"\n\t\t\t);\n\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\t\t\t\treturn handleGettingStartedPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleGettingStartedPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleGettingStartedPhase({\n\t\t\t\tagent,\n\t\t\t\thasConnectionString: parsed.hasConnectionString === true,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"db\": {\n\t\t\tconst { handleDbPhase } = await import(\"./phases/db.js\");\n\t\t\treturn handleDbPhase({\n\t\t\t\tagent,\n\t\t\t\torgId: parsed.orgId as string | undefined,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t\torgsResult: parsed.orgsResult as string | undefined,\n\t\t\t\tprojectsResult: parsed.projectsResult as string | undefined,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\terror: parsed.error as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"neon-auth\": {\n\t\t\tconst { handleNeonAuthPhase } = await import(\n\t\t\t\t\"./phases/neon-auth.js\"\n\t\t\t);\n\t\t\treturn handleNeonAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tsetup: parsed.setup === true,\n\t\t\t\tinfo: parsed.info === true,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"migrations\": {\n\t\t\tconst { handleMigrationsPhase } = await import(\n\t\t\t\t\"./phases/migrations.js\"\n\t\t\t);\n\t\t\treturn handleMigrationsPhase({\n\t\t\t\tagent,\n\t\t\t\ttool: parsed.tool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tscaffold: parsed.scaffold as \"prisma\" | \"drizzle\" | undefined,\n\t\t\t\tapply: parsed.apply === true,\n\t\t\t});\n\t\t}\n\n\t\tdefault: {\n\t\t\t// No subcommand — run the orchestrator\n\t\t\tconst { orchestrate } = await import(\"../v2.js\");\n\t\t\treturn orchestrate({\n\t\t\t\tagent,\n\t\t\t\tskipNeonAuth: parsed.skipNeonAuth === true,\n\t\t\t\tskipMigrations: parsed.skipMigrations === true,\n\t\t\t\tpreview: parsed.preview === true,\n\t\t\t});\n\t\t}\n\t}\n}\n\n/**\n * Routes a --data JSON payload with a \"step\" field to the appropriate phase\n * handler. This lets agents use a single command surface:\n *   neon-init --agent --json --data '{\"step\":\"auth\"}'\n *   neon-init --agent --json --data '{\"step\":\"db\",\"projectId\":\"xyz\"}'\n */\nexport async function routeDataStep(\n\tdata: Record<string, unknown>,\n\tagent: string | undefined,\n): Promise<unknown> {\n\tconst { step, ...rest } = data;\n\n\t// Agents sometimes nest the actual payload inside a \"data\" key:\n\t//   {\"step\":\"setup\",\"data\":{\"mode\":\"defaults\",...}}\n\t// or as a JSON string:\n\t//   {\"step\":\"setup\",\"data\":\"{\\\"mode\\\":\\\"defaults\\\",...}\"}\n\t// Unwrap it so the phase handler gets the right options.\n\tif (rest.data !== undefined && Object.keys(rest).length === 1) {\n\t\tlet nested = rest.data;\n\t\tif (typeof nested === \"string\") {\n\t\t\ttry {\n\t\t\t\tnested = JSON.parse(nested);\n\t\t\t} catch {\n\t\t\t\t// leave as-is\n\t\t\t}\n\t\t}\n\t\tif (typeof nested === \"object\" && nested !== null) {\n\t\t\tObject.assign(rest, nested);\n\t\t\tdelete rest.data;\n\t\t}\n\t}\n\n\tswitch (step) {\n\t\tcase \"auth\": {\n\t\t\tconst { handleAuthPhase } = await import(\"./phases/auth.js\");\n\t\t\treturn handleAuthPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleAuthPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"db\": {\n\t\t\tconst { handleDbPhase } = await import(\"./phases/db.js\");\n\t\t\treturn handleDbPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleDbPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"setup\": {\n\t\t\tconst { handleSetupPhase } = await import(\"./phases/setup.js\");\n\t\t\treturn handleSetupPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleSetupPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"getting-started\": {\n\t\t\tconst { handleGettingStartedPhase } = await import(\n\t\t\t\t\"./phases/getting-started.js\"\n\t\t\t);\n\t\t\treturn handleGettingStartedPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleGettingStartedPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"mcp\": {\n\t\t\tconst { handleMcpPhase } = await import(\"./phases/mcp.js\");\n\t\t\treturn handleMcpPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleMcpPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"skills\": {\n\t\t\tconst { handleSkillsPhase } = await import(\"./phases/skills.js\");\n\t\t\treturn handleSkillsPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleSkillsPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"migrations\": {\n\t\t\tconst { handleMigrationsPhase } = await import(\n\t\t\t\t\"./phases/migrations.js\"\n\t\t\t);\n\t\t\treturn handleMigrationsPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleMigrationsPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"neon-auth\": {\n\t\t\tconst { handleNeonAuthPhase } = await import(\n\t\t\t\t\"./phases/neon-auth.js\"\n\t\t\t);\n\t\t\treturn handleNeonAuthPhase({ agent, ...rest } as Parameters<\n\t\t\t\ttypeof handleNeonAuthPhase\n\t\t\t>[0]);\n\t\t}\n\n\t\tcase \"status\": {\n\t\t\tconst { handleStatusPhase } = await import(\"./phases/status.js\");\n\t\t\treturn handleStatusPhase({ agent });\n\t\t}\n\n\t\tcase \"finalize\": {\n\t\t\tconst { handleCleanup } = await import(\"./phases/cleanup.js\");\n\t\t\treturn handleCleanup();\n\t\t}\n\n\t\tdefault:\n\t\t\tthrow new Error(\n\t\t\t\t`Unknown step: \"${step}\". Valid steps: auth, db, setup, getting-started, mcp, skills, migrations, neon-auth, status, finalize`,\n\t\t\t);\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"route-command.js","names":[],"sources":["../../src/lib/route-command.ts"],"sourcesContent":["/**\n * Routes neon-init CLI args to the appropriate phase handler directly,\n * without shelling out. This is the in-process equivalent of calling\n * `neon-init <subcommand> <flags>`.\n */\n\nimport { detectAgent } from \"./detect-agent.js\";\nimport type { PhaseResponse } from \"./types.js\";\n\nfunction resolveAgent(explicit: string | undefined): string | undefined {\n\treturn explicit ?? detectAgent() ?? undefined;\n}\n\n/** Known short flag aliases (mirrors yargs config in cli.ts) */\nconst SHORT_FLAG_MAP: Record<string, string> = {\n\ta: \"agent\",\n};\n\nfunction parseArgs(args: string[]): Record<string, string | boolean> {\n\tconst result: Record<string, string | boolean> = {};\n\tlet i = 0;\n\n\t// First arg may be the subcommand\n\tif (args.length > 0 && !args[0].startsWith(\"-\")) {\n\t\tresult._command = args[0];\n\t\ti = 1;\n\t}\n\n\twhile (i < args.length) {\n\t\tconst arg = args[i];\n\t\tif (arg.startsWith(\"--\")) {\n\t\t\tconst key = arg\n\t\t\t\t.slice(2)\n\t\t\t\t.replace(/-([a-z])/g, (_, c) => c.toUpperCase());\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[key] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[key] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else if (\n\t\t\targ.startsWith(\"-\") &&\n\t\t\t!arg.startsWith(\"--\") &&\n\t\t\targ.length === 2\n\t\t) {\n\t\t\tconst shortKey = arg[1];\n\t\t\tconst longKey = SHORT_FLAG_MAP[shortKey] ?? shortKey;\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[longKey] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[longKey] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else {\n\t\t\ti += 1;\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction toBool(val: string | boolean | undefined): boolean | null {\n\tif (val === true || val === \"true\") return true;\n\tif (val === false || val === \"false\") return false;\n\treturn null;\n}\n\nexport async function routeCommand(args: string[]): Promise<PhaseResponse> {\n\tconst parsed = parseArgs(args);\n\tconst command = parsed._command as string | undefined;\n\tconst agent = resolveAgent(parsed.agent as string | undefined);\n\n\tswitch (command) {\n\t\tcase \"finalize\": {\n\t\t\tconst { handleCleanup } = await import(\"./phases/cleanup.js\");\n\t\t\treturn handleCleanup();\n\t\t}\n\n\t\tcase \"auth\": {\n\t\t\tconst { handleAuthPhase } = await import(\"./phases/auth.js\");\n\t\t\treturn handleAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tmethod: parsed.method as \"existing\" | \"new\" | undefined,\n\t\t\t\tverify: parsed.verify === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"mcp\": {\n\t\t\tconst { handleMcpPhase } = await import(\"./phases/mcp.js\");\n\t\t\treturn handleMcpPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true || parsed.update === true,\n\t\t\t\tscope: (parsed.scope as \"global\" | \"project\") ?? \"global\",\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t});\n\t\t}\n\n\t\tcase \"skills\": {\n\t\t\tconst { handleSkillsPhase } = await import(\"./phases/skills.js\");\n\t\t\treturn handleSkillsPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true,\n\t\t\t\tupdate: parsed.update === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"setup\": {\n\t\t\tconst { handleSetupPhase } = await import(\"./phases/setup.js\");\n\n\t\t\t// --data JSON path\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\n\t\t\t\t// Normalize string booleans\n\t\t\t\tfor (const key of [\n\t\t\t\t\t\"mcpConfigured\",\n\t\t\t\t\t\"connectionString\",\n\t\t\t\t\t\"isVscodeIde\",\n\t\t\t\t\t\"installExtension\",\n\t\t\t\t\t\"execute\",\n\t\t\t\t]) {\n\t\t\t\t\tif (data[key] === \"true\") data[key] = true;\n\t\t\t\t\telse if (data[key] === \"false\") data[key] = false;\n\t\t\t\t}\n\n\t\t\t\treturn handleSetupPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleSetupPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleSetupPhase({\n\t\t\t\tagent,\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t\tconnectionString: toBool(parsed.connectionString),\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tisVscodeIde: toBool(parsed.isVscodeIde),\n\t\t\t\tmode: parsed.mode as \"defaults\" | \"customize\" | undefined,\n\t\t\t\tmcpScope: parsed.mcpScope as \"global\" | \"project\" | undefined,\n\t\t\t\tskillsScope: parsed.skillsScope as\n\t\t\t\t\t| \"global\"\n\t\t\t\t\t| \"project\"\n\t\t\t\t\t| undefined,\n\t\t\t\tinstallExtension: toBool(parsed.installExtension) === true,\n\t\t\t\texecute: parsed.execute === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"getting-started\": {\n\t\t\tconst { handleGettingStartedPhase } = await import(\n\t\t\t\t\"./phases/getting-started.js\"\n\t\t\t);\n\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\t\t\t\treturn handleGettingStartedPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleGettingStartedPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleGettingStartedPhase({\n\t\t\t\tagent,\n\t\t\t\thasConnectionString: parsed.hasConnectionString === true,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"db\": {\n\t\t\tconst { handleDbPhase } = await import(\"./phases/db.js\");\n\t\t\treturn handleDbPhase({\n\t\t\t\tagent,\n\t\t\t\torgId: parsed.orgId as string | undefined,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t\torgsResult: parsed.orgsResult as string | undefined,\n\t\t\t\tprojectsResult: parsed.projectsResult as string | undefined,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\terror: parsed.error as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"neon-auth\": {\n\t\t\tconst { handleNeonAuthPhase } = await import(\n\t\t\t\t\"./phases/neon-auth.js\"\n\t\t\t);\n\t\t\treturn handleNeonAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tsetup: parsed.setup === true,\n\t\t\t\tinfo: parsed.info === true,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"migrations\": {\n\t\t\tconst { handleMigrationsPhase } = await import(\n\t\t\t\t\"./phases/migrations.js\"\n\t\t\t);\n\t\t\treturn handleMigrationsPhase({\n\t\t\t\tagent,\n\t\t\t\ttool: parsed.tool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tscaffold: parsed.scaffold as \"prisma\" | \"drizzle\" | undefined,\n\t\t\t\tapply: parsed.apply === true,\n\t\t\t});\n\t\t}\n\n\t\tdefault: {\n\t\t\t// No subcommand — run the orchestrator\n\t\t\tconst { orchestrate } = await import(\"../v2.js\");\n\t\t\treturn orchestrate({\n\t\t\t\tagent,\n\t\t\t\tskipMigrations: parsed.skipMigrations === true,\n\t\t\t\tpreview: parsed.preview === true,\n\t\t\t});\n\t\t}\n\t}\n}\n\n/**\n * Routes a --data JSON payload with a \"step\" field to the appropriate phase\n * handler. This lets agents use a single command surface:\n *   neon-init --agent --data '{\"step\":\"auth\"}'\n *   neon-init --agent --data '{\"step\":\"db\",\"projectId\":\"xyz\"}'\n */\nexport async function routeDataStep(\n\tdata: Record<string, unknown>,\n\tagent: string | undefined,\n): Promise<unknown> {\n\tconst { step, agentId, ...rest } = data;\n\n\t// Allow agentId override from data JSON, fall back to caller-provided agent\n\tconst resolvedAgent = typeof agentId === \"string\" ? agentId : agent;\n\n\t// Agents sometimes nest the actual payload inside a \"data\" key:\n\t//   {\"step\":\"setup\",\"data\":{\"mode\":\"defaults\",...}}\n\t// or as a JSON string:\n\t//   {\"step\":\"setup\",\"data\":\"{\\\"mode\\\":\\\"defaults\\\",...}\"}\n\t// Unwrap it so the phase handler gets the right options.\n\tif (rest.data !== undefined && Object.keys(rest).length === 1) {\n\t\tlet nested = rest.data;\n\t\tif (typeof nested === \"string\") {\n\t\t\ttry {\n\t\t\t\tnested = JSON.parse(nested);\n\t\t\t} catch {\n\t\t\t\t// leave as-is\n\t\t\t}\n\t\t}\n\t\tif (typeof nested === \"object\" && nested !== null) {\n\t\t\tObject.assign(rest, nested);\n\t\t\tdelete rest.data;\n\t\t}\n\t}\n\n\tswitch (step) {\n\t\tcase \"auth\": {\n\t\t\tconst { handleAuthPhase } = await import(\"./phases/auth.js\");\n\t\t\treturn handleAuthPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleAuthPhase>[0]);\n\t\t}\n\n\t\tcase \"db\": {\n\t\t\tconst { handleDbPhase } = await import(\"./phases/db.js\");\n\t\t\treturn handleDbPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleDbPhase>[0]);\n\t\t}\n\n\t\tcase \"setup\": {\n\t\t\tconst { handleSetupPhase } = await import(\"./phases/setup.js\");\n\t\t\treturn handleSetupPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleSetupPhase>[0]);\n\t\t}\n\n\t\tcase \"getting-started\": {\n\t\t\tconst { handleGettingStartedPhase } = await import(\n\t\t\t\t\"./phases/getting-started.js\"\n\t\t\t);\n\t\t\treturn handleGettingStartedPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleGettingStartedPhase>[0]);\n\t\t}\n\n\t\tcase \"mcp\": {\n\t\t\tconst { handleMcpPhase } = await import(\"./phases/mcp.js\");\n\t\t\treturn handleMcpPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleMcpPhase>[0]);\n\t\t}\n\n\t\tcase \"skills\": {\n\t\t\tconst { handleSkillsPhase } = await import(\"./phases/skills.js\");\n\t\t\treturn handleSkillsPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleSkillsPhase>[0]);\n\t\t}\n\n\t\tcase \"migrations\": {\n\t\t\tconst { handleMigrationsPhase } = await import(\n\t\t\t\t\"./phases/migrations.js\"\n\t\t\t);\n\t\t\treturn handleMigrationsPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleMigrationsPhase>[0]);\n\t\t}\n\n\t\tcase \"neon-auth\": {\n\t\t\tconst { handleNeonAuthPhase } = await import(\n\t\t\t\t\"./phases/neon-auth.js\"\n\t\t\t);\n\t\t\treturn handleNeonAuthPhase({\n\t\t\t\tagent: resolvedAgent,\n\t\t\t\t...rest,\n\t\t\t} as Parameters<typeof handleNeonAuthPhase>[0]);\n\t\t}\n\n\t\tcase \"status\": {\n\t\t\tconst { handleStatusPhase } = await import(\"./phases/status.js\");\n\t\t\treturn handleStatusPhase({ agent: resolvedAgent });\n\t\t}\n\n\t\tcase \"finalize\": {\n\t\t\tconst { handleCleanup } = await import(\"./phases/cleanup.js\");\n\t\t\treturn handleCleanup();\n\t\t}\n\n\t\tdefault:\n\t\t\tthrow new Error(\n\t\t\t\t`Unknown step: \"${step}\". Valid steps: auth, db, setup, getting-started, mcp, skills, migrations, neon-auth, status, finalize`,\n\t\t\t);\n\t}\n}\n"],"mappings":"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"}

package/dist/lib/skills.d.ts

@@ -1,6 +1,8 @@
 import { Editor } from "./types.js";
 
 //#region src/lib/skills.d.ts
+/** Returns the skill list based on whether preview mode is active */
+declare function getSkillList(preview?: boolean): string[];
 declare const SKILL_REFERENCE_URLS: Record<string, string>;
 /**
  * Fetches the "Getting Started with Neon" skill content from the public URL.
@@ -10,6 +12,7 @@ declare function fetchSkillContent(): Promise<string | null>;
 interface InstallSkillsOptions {
   json?: boolean;
   scope?: "global" | "project";
+  preview?: boolean;
 }
 /**
  * Installs Neon agent skills using Vercel's skills CLI.
@@ -22,7 +25,7 @@ declare function installAgentSkills(selectedEditors: Editor[], options?: Install
  * Designed to be called from any phase handler — cheap to call repeatedly
  * since it's a no-op when skills are fresh.
  */
-declare function ensureSkillsUpToDate(agent: string, scope?: "global" | "project"): Promise<boolean>;
+declare function ensureSkillsUpToDate(agent: string | undefined, scope?: "global" | "project", preview?: boolean): Promise<boolean>;
 //#endregion
-export { InstallSkillsOptions, SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, installAgentSkills };
+export { InstallSkillsOptions, SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, getSkillList, installAgentSkills };
 //# sourceMappingURL=skills.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","names":[],"sources":["../../src/lib/skills.ts"],"mappings":";;;cAWa,sBAAsB;;AAAnC;AAeA;AAiDA;AAQsB,iBAzDA,iBAAA,CAAA,CAyDkB,EAzDG,OAyDH,CAAA,MAAA,GAAA,IAAA,CAAA;AAAA,UARvB,oBAAA,CAQuB;MACtB,CAAA,EAAA,OAAA;OACP,CAAA,EAAA,QAAA,GAAA,SAAA;;AACD;AA8JV;;iBAjKsB,kBAAA,kBACJ,oBACP,uBACR;;;;;;;;iBA8JmB,oBAAA,+CAGnB"}
+{"version":3,"file":"skills.d.ts","names":[],"sources":["../../src/lib/skills.ts"],"mappings":";;;;iBAuCgB,YAAA;AAAA,cAOH,oBAPe,EAOO,MAPP,CAAA,MAAA,EAAA,MAAA,CAAA;AAO5B;AAeA;AAiDA;AASA;AAAwC,iBA1DlB,iBAAA,CAAA,CA0DkB,EA1DG,OA0DH,CAAA,MAAA,GAAA,IAAA,CAAA;AACtB,UAVD,oBAAA,CAUC;MACP,CAAA,EAAA,OAAA;OACR,CAAA,EAAA,QAAA,GAAA,SAAA;EAAO,OAAA,CAAA,EAAA,OAAA;AAmJV;;;;iBAtJsB,kBAAA,kBACJ,oBACP,uBACR;;;;;;;;iBAmJmB,oBAAA,8EAInB"}

package/dist/lib/skills.js

@@ -1,10 +1,45 @@
 import { getSkillsAgentName } from "./agents.js";
-import { existsSync, readFileSync, statSync } from "node:fs";
+import { existsSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { log, spinner } from "@clack/prompts";
 import { execa } from "execa";
 import { dim } from "yoctocolors";
 //#region src/lib/skills.ts
+/**
+* Ensures the `skills` CLI is globally installed so npx doesn't need
+* to download it (which can fail behind corporate proxies / sandboxes).
+*/
+async function ensureSkillsCli() {
+	try {
+		await execa("skills", ["--version"], {
+			stdio: "pipe",
+			timeout: 5e3
+		});
+	} catch {
+		try {
+			await execa("npm", [
+				"install",
+				"-g",
+				"skills"
+			], {
+				stdio: "pipe",
+				timeout: 6e4
+			});
+		} catch {}
+	}
+}
+/** Base skills installed for all invocations */
+const BASE_SKILLS = ["neon", "neon-postgres"];
+/** Additional skills installed for preview (non-bootstrap) invocations */
+const PREVIEW_SKILLS = [
+	"neon-object-storage",
+	"neon-functions",
+	"neon-ai-gateway"
+];
+/** Returns the skill list based on whether preview mode is active */
+function getSkillList(preview) {
+	return preview ? [...BASE_SKILLS, ...PREVIEW_SKILLS] : BASE_SKILLS;
+}
 const SKILL_BASE_URL = "https://neon.com/docs/ai/skills/neon-postgres/references";
 const SKILL_REFERENCE_URLS = {
 	gettingStarted: `${SKILL_BASE_URL}/getting-started.md`,
@@ -62,31 +97,32 @@ async function installAgentSkills(selectedEditors, options) {
 	const skillsSpinner = quiet ? null : spinner();
 	skillsSpinner?.start("Installing agent skills for Neon in this project...");
 	let anyFailed = false;
+	await ensureSkillsCli();
+	const skills = getSkillList(options?.preview);
 	for (const editor of editorsWithSkills) {
 		const agentName = editorToSkillsAgent(editor);
-		try {
-			await execa("npx", [
-				"skills",
+		for (const skill of skills) try {
+			await execa("skills", [
 				"add",
 				"neondatabase/agent-skills",
 				"--skill",
-				"neon-postgres",
+				skill,
 				"--agent",
 				agentName,
 				...options?.scope === "global" ? ["-g"] : [],
 				"-y"
 			], {
 				stdio: "pipe",
-				timeout: 1e4
+				timeout: 12e4
 			});
 		} catch (error) {
-			if (!quiet) log.error(`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : "Unknown error"}`);
+			if (!quiet) log.error(`Failed to install skill ${skill} for ${editor}: ${error instanceof Error ? error.message : "Unknown error"}`);
 			anyFailed = true;
 		}
 	}
 	if (anyFailed) {
 		skillsSpinner?.stop("Agent skills installation for this project completed with errors");
-		if (!quiet) log.info("You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres");
+		if (!quiet) log.info("You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon --skill neon-postgres");
 		return false;
 	}
 	skillsSpinner?.stop(dim("Agent skills installed ✓"));
@@ -99,36 +135,37 @@ const SKILLS_FRESHNESS_MS = 720 * 60 * 1e3;
 */
 const GLOBAL_SKILLS_DIRS = (() => {
 	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const agentsDir = resolve(home, ".agents", "skills");
 	return {
-		cursor: [resolve(home, ".cursor", "skills")],
-		"claude-code": [resolve(home, ".claude", "skills")],
-		"github-copilot": [resolve(home, ".vscode", "skills")],
-		codex: [resolve(home, ".codex", "skills")],
-		cline: [resolve(home, ".cline", "skills")]
+		cursor: [resolve(home, ".cursor", "skills"), agentsDir],
+		"claude-code": [resolve(home, ".claude", "skills"), agentsDir],
+		"github-copilot": [resolve(home, ".vscode", "skills"), agentsDir],
+		codex: [resolve(home, ".codex", "skills"), agentsDir],
+		cline: [resolve(home, ".cline", "skills"), agentsDir]
 	};
 })();
 /**
 * Checks whether skills were recently updated (within the freshness window).
 * Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).
 */
-function skillsAreFresh(agent) {
+function skillsAreFresh(agent, requiredSkills) {
 	const now = Date.now();
 	const cwd = process.cwd();
+	const projectSkillDirs = [
+		".agents",
+		".cursor",
+		".claude"
+	];
 	const lockPath = resolve(cwd, "skills-lock.json");
 	if (existsSync(lockPath)) try {
-		if (readFileSync(lockPath, "utf-8").includes("neon-postgres")) {
-			if (existsSync(resolve(cwd, ".agents", "skills", "neon-postgres", "SKILL.md")) || existsSync(resolve(cwd, ".cursor", "skills", "neon-postgres", "SKILL.md")) || existsSync(resolve(cwd, ".claude", "skills", "neon-postgres", "SKILL.md"))) {
-				if (now - statSync(lockPath).mtimeMs < SKILLS_FRESHNESS_MS) return true;
-			}
+		if (now - statSync(lockPath).mtimeMs < SKILLS_FRESHNESS_MS) {
+			if (requiredSkills.every((skill) => projectSkillDirs.some((dir) => existsSync(resolve(cwd, dir, "skills", skill, "SKILL.md"))))) return true;
 		}
 	} catch {}
 	const globalDirs = GLOBAL_SKILLS_DIRS[getSkillsAgentName(agent)] ?? [];
-	for (const dir of globalDirs) {
-		const neonSkillMd = resolve(dir, "neon-postgres", "SKILL.md");
-		if (existsSync(neonSkillMd)) try {
-			if (now - statSync(neonSkillMd).mtimeMs < SKILLS_FRESHNESS_MS) return true;
-		} catch {}
-	}
+	for (const dir of globalDirs) if (requiredSkills.every((skill) => existsSync(resolve(dir, skill, "SKILL.md")))) try {
+		if (now - statSync(resolve(dir, requiredSkills[0], "SKILL.md")).mtimeMs < SKILLS_FRESHNESS_MS) return true;
+	} catch {}
 	return false;
 }
 /**
@@ -138,31 +175,46 @@ function skillsAreFresh(agent) {
 * Designed to be called from any phase handler — cheap to call repeatedly
 * since it's a no-op when skills are fresh.
 */
-async function ensureSkillsUpToDate(agent, scope) {
-	if (skillsAreFresh(agent)) return true;
-	const agentName = getSkillsAgentName(agent);
-	try {
-		await execa("npx", [
-			"-y",
-			"skills",
+async function ensureSkillsUpToDate(agent, scope, preview) {
+	const resolvedAgent = agent || "cursor";
+	const skills = getSkillList(preview);
+	if (skillsAreFresh(resolvedAgent, skills)) return true;
+	await ensureSkillsCli();
+	const agentName = getSkillsAgentName(resolvedAgent);
+	let allOk = true;
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const cwd = process.cwd();
+	const checkDirs = scope === "global" ? [
+		resolve(home, ".cursor", "skills"),
+		resolve(home, ".claude", "skills"),
+		resolve(home, ".agents", "skills")
+	] : [
+		resolve(cwd, ".cursor", "skills"),
+		resolve(cwd, ".claude", "skills"),
+		resolve(cwd, ".agents", "skills")
+	];
+	const missingSkills = skills.filter((skill) => !checkDirs.some((dir) => existsSync(resolve(dir, skill, "SKILL.md"))));
+	if (missingSkills.length === 0) return true;
+	for (const skill of missingSkills) try {
+		await execa("skills", [
 			"add",
 			"neondatabase/agent-skills",
 			"--skill",
-			"neon-postgres",
+			skill,
 			"--agent",
 			agentName,
 			...scope === "global" ? ["-g"] : [],
 			"-y"
 		], {
 			stdio: "pipe",
-			timeout: 6e4
+			timeout: 12e4
 		});
-		return true;
 	} catch {
-		return false;
+		allOk = false;
 	}
+	return allOk;
 }
 //#endregion
-export { SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, installAgentSkills };
+export { SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, getSkillList, installAgentSkills };
 
 //# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","names":["getSkillsAgentNameFromId"],"sources":["../../src/lib/skills.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { dim } from \"yoctocolors\";\nimport { getSkillsAgentName as getSkillsAgentNameFromId } from \"./agents.js\";\nimport type { Editor } from \"./types.js\";\n\nconst SKILL_BASE_URL =\n\t\"https://neon.com/docs/ai/skills/neon-postgres/references\";\n\nexport const SKILL_REFERENCE_URLS: Record<string, string> = {\n\tgettingStarted: `${SKILL_BASE_URL}/getting-started.md`,\n\tconnectionMethods: `${SKILL_BASE_URL}/connection-methods.md`,\n\tneonAuth: `${SKILL_BASE_URL}/neon-auth.md`,\n\tserverlessDriver: `${SKILL_BASE_URL}/neon-serverless.md`,\n\tneonCli: `${SKILL_BASE_URL}/neon-cli.md`,\n\tdevtools: `${SKILL_BASE_URL}/devtools.md`,\n\tbranching: `${SKILL_BASE_URL}/branching.md`,\n\tneonJs: `${SKILL_BASE_URL}/neon-js.md`,\n};\n\n/**\n * Fetches the \"Getting Started with Neon\" skill content from the public URL.\n * Returns the markdown content, or null if the fetch fails.\n */\nexport async function fetchSkillContent(): Promise<string | null> {\n\ttry {\n\t\tconst response = await fetch(SKILL_REFERENCE_URLS.gettingStarted, {\n\t\t\tsignal: AbortSignal.timeout(10000),\n\t\t});\n\t\tif (!response.ok) return null;\n\t\treturn await response.text();\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Maps Editor display names to the skills CLI agent name.\n * Used only by the v1 installAgentSkills function.\n */\nfunction editorToSkillsAgent(editor: Editor): string {\n\tswitch (editor) {\n\t\tcase \"Cursor\":\n\t\t\treturn \"cursor\";\n\t\tcase \"VS Code\":\n\t\tcase \"GitHub Copilot CLI\":\n\t\t\treturn \"github-copilot\";\n\t\tcase \"Claude CLI\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"Codex\":\n\t\t\treturn \"codex\";\n\t\tcase \"OpenCode\":\n\t\t\treturn \"opencode\";\n\t\tcase \"Antigravity\":\n\t\t\treturn \"antigravity\";\n\t\tcase \"Cline\":\n\t\tcase \"Cline CLI\":\n\t\t\treturn \"cline\";\n\t\tcase \"Gemini CLI\":\n\t\t\treturn \"gemini-cli\";\n\t\tcase \"Goose\":\n\t\t\treturn \"goose\";\n\t\tcase \"Claude Desktop\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"MCPorter\":\n\t\t\treturn \"mcporter\";\n\t\tcase \"Zed\":\n\t\t\treturn \"zed\";\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\nexport interface InstallSkillsOptions {\n\tjson?: boolean;\n\tscope?: \"global\" | \"project\";\n}\n\n/**\n * Installs Neon agent skills using Vercel's skills CLI.\n */\nexport async function installAgentSkills(\n\tselectedEditors: Editor[],\n\toptions?: InstallSkillsOptions,\n): Promise<boolean> {\n\tconst quiet = options?.json === true;\n\n\tconst editorsWithSkills = selectedEditors.filter(\n\t\t(e) => editorToSkillsAgent(e) !== \"\",\n\t);\n\n\tif (editorsWithSkills.length === 0) {\n\t\treturn true;\n\t}\n\n\tconst skillsSpinner = quiet ? null : spinner();\n\tskillsSpinner?.start(\"Installing agent skills for Neon in this project...\");\n\n\tlet anyFailed = false;\n\n\tfor (const editor of editorsWithSkills) {\n\t\tconst agentName = editorToSkillsAgent(editor);\n\n\t\ttry {\n\t\t\tawait execa(\n\t\t\t\t\"npx\",\n\t\t\t\t[\n\t\t\t\t\t\"skills\",\n\t\t\t\t\t\"add\",\n\t\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\t\"--skill\",\n\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\"--agent\",\n\t\t\t\t\tagentName,\n\t\t\t\t\t...(options?.scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\t\"-y\",\n\t\t\t\t],\n\t\t\t\t{\n\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\ttimeout: 10000,\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tif (!quiet)\n\t\t\t\tlog.error(\n\t\t\t\t\t`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t\t\t);\n\t\t\tanyFailed = true;\n\t\t}\n\t}\n\n\tif (anyFailed) {\n\t\tskillsSpinner?.stop(\n\t\t\t\"Agent skills installation for this project completed with errors\",\n\t\t);\n\t\tif (!quiet)\n\t\t\tlog.info(\n\t\t\t\t\"You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres\",\n\t\t\t);\n\t\treturn false;\n\t}\n\n\tskillsSpinner?.stop(dim(\"Agent skills installed ✓\"));\n\treturn true;\n}\n\n// ---------------------------------------------------------------------------\n// Evergreen skills: ensure skills are up to date (at most once per 12 hours)\n// ---------------------------------------------------------------------------\n\nconst SKILLS_FRESHNESS_MS = 12 * 60 * 60 * 1000; // 12 hours\n\n/**\n * Agent skills directory paths by agent, keyed by scope.\n * These are the directories that `skills add` writes to.\n */\nconst GLOBAL_SKILLS_DIRS: Record<string, string[]> = (() => {\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\treturn {\n\t\tcursor: [resolve(home, \".cursor\", \"skills\")],\n\t\t\"claude-code\": [resolve(home, \".claude\", \"skills\")],\n\t\t\"github-copilot\": [resolve(home, \".vscode\", \"skills\")],\n\t\tcodex: [resolve(home, \".codex\", \"skills\")],\n\t\tcline: [resolve(home, \".cline\", \"skills\")],\n\t};\n})();\n\n/**\n * Checks whether skills were recently updated (within the freshness window).\n * Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).\n */\nfunction skillsAreFresh(agent: string): boolean {\n\tconst now = Date.now();\n\tconst cwd = process.cwd();\n\n\t// Check project-level: skills-lock.json must reference neon-postgres\n\t// AND the skill file must actually exist on disk\n\tconst lockPath = resolve(cwd, \"skills-lock.json\");\n\tif (existsSync(lockPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(lockPath, \"utf-8\");\n\t\t\tif (content.includes(\"neon-postgres\")) {\n\t\t\t\t// Verify the actual skill file exists (lock file can be stale)\n\t\t\t\tconst skillExists =\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".agents\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t) ||\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".cursor\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t) ||\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".claude\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\tif (skillExists) {\n\t\t\t\t\tconst mtime = statSync(lockPath).mtimeMs;\n\t\t\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) return true;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check global: neon-postgres SKILL.md inside agent-specific skills directories\n\tconst agentName = getSkillsAgentNameFromId(agent);\n\tconst globalDirs = GLOBAL_SKILLS_DIRS[agentName] ?? [];\n\tfor (const dir of globalDirs) {\n\t\tconst neonSkillMd = resolve(dir, \"neon-postgres\", \"SKILL.md\");\n\t\tif (existsSync(neonSkillMd)) {\n\t\t\ttry {\n\t\t\t\tconst mtime = statSync(neonSkillMd).mtimeMs;\n\t\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) return true;\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Ensures Neon agent skills are up to date. Runs `skills add` if the skills\n * haven't been updated within the freshness window (12 hours).\n *\n * Designed to be called from any phase handler — cheap to call repeatedly\n * since it's a no-op when skills are fresh.\n */\nexport async function ensureSkillsUpToDate(\n\tagent: string,\n\tscope?: \"global\" | \"project\",\n): Promise<boolean> {\n\tif (skillsAreFresh(agent)) return true;\n\n\tconst agentName = getSkillsAgentNameFromId(agent);\n\ttry {\n\t\tawait execa(\n\t\t\t\"npx\",\n\t\t\t[\n\t\t\t\t\"-y\",\n\t\t\t\t\"skills\",\n\t\t\t\t\"add\",\n\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\"--skill\",\n\t\t\t\t\"neon-postgres\",\n\t\t\t\t\"--agent\",\n\t\t\t\tagentName,\n\t\t\t\t...(scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\"-y\",\n\t\t\t],\n\t\t\t{ stdio: \"pipe\", timeout: 60000 },\n\t\t);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"skills.js","names":["getSkillsAgentNameFromId"],"sources":["../../src/lib/skills.ts"],"sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { dim } from \"yoctocolors\";\nimport { getSkillsAgentName as getSkillsAgentNameFromId } from \"./agents.js\";\nimport type { Editor } from \"./types.js\";\n\n/**\n * Ensures the `skills` CLI is globally installed so npx doesn't need\n * to download it (which can fail behind corporate proxies / sandboxes).\n */\nasync function ensureSkillsCli(): Promise<void> {\n\ttry {\n\t\tawait execa(\"skills\", [\"--version\"], { stdio: \"pipe\", timeout: 5000 });\n\t} catch {\n\t\t// Not installed — install it globally\n\t\ttry {\n\t\t\tawait execa(\"npm\", [\"install\", \"-g\", \"skills\"], {\n\t\t\t\tstdio: \"pipe\",\n\t\t\t\ttimeout: 60000,\n\t\t\t});\n\t\t} catch {\n\t\t\t// Best effort — npx will fall back to downloading\n\t\t}\n\t}\n}\n\n/** Base skills installed for all invocations */\nconst BASE_SKILLS = [\"neon\", \"neon-postgres\"];\n\n/** Additional skills installed for preview (non-bootstrap) invocations */\nconst PREVIEW_SKILLS = [\n\t\"neon-object-storage\",\n\t\"neon-functions\",\n\t\"neon-ai-gateway\",\n];\n\n/** Returns the skill list based on whether preview mode is active */\nexport function getSkillList(preview?: boolean): string[] {\n\treturn preview ? [...BASE_SKILLS, ...PREVIEW_SKILLS] : BASE_SKILLS;\n}\n\nconst SKILL_BASE_URL =\n\t\"https://neon.com/docs/ai/skills/neon-postgres/references\";\n\nexport const SKILL_REFERENCE_URLS: Record<string, string> = {\n\tgettingStarted: `${SKILL_BASE_URL}/getting-started.md`,\n\tconnectionMethods: `${SKILL_BASE_URL}/connection-methods.md`,\n\tneonAuth: `${SKILL_BASE_URL}/neon-auth.md`,\n\tserverlessDriver: `${SKILL_BASE_URL}/neon-serverless.md`,\n\tneonCli: `${SKILL_BASE_URL}/neon-cli.md`,\n\tdevtools: `${SKILL_BASE_URL}/devtools.md`,\n\tbranching: `${SKILL_BASE_URL}/branching.md`,\n\tneonJs: `${SKILL_BASE_URL}/neon-js.md`,\n};\n\n/**\n * Fetches the \"Getting Started with Neon\" skill content from the public URL.\n * Returns the markdown content, or null if the fetch fails.\n */\nexport async function fetchSkillContent(): Promise<string | null> {\n\ttry {\n\t\tconst response = await fetch(SKILL_REFERENCE_URLS.gettingStarted, {\n\t\t\tsignal: AbortSignal.timeout(10000),\n\t\t});\n\t\tif (!response.ok) return null;\n\t\treturn await response.text();\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Maps Editor display names to the skills CLI agent name.\n * Used only by the v1 installAgentSkills function.\n */\nfunction editorToSkillsAgent(editor: Editor): string {\n\tswitch (editor) {\n\t\tcase \"Cursor\":\n\t\t\treturn \"cursor\";\n\t\tcase \"VS Code\":\n\t\tcase \"GitHub Copilot CLI\":\n\t\t\treturn \"github-copilot\";\n\t\tcase \"Claude CLI\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"Codex\":\n\t\t\treturn \"codex\";\n\t\tcase \"OpenCode\":\n\t\t\treturn \"opencode\";\n\t\tcase \"Antigravity\":\n\t\t\treturn \"antigravity\";\n\t\tcase \"Cline\":\n\t\tcase \"Cline CLI\":\n\t\t\treturn \"cline\";\n\t\tcase \"Gemini CLI\":\n\t\t\treturn \"gemini-cli\";\n\t\tcase \"Goose\":\n\t\t\treturn \"goose\";\n\t\tcase \"Claude Desktop\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"MCPorter\":\n\t\t\treturn \"mcporter\";\n\t\tcase \"Zed\":\n\t\t\treturn \"zed\";\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\nexport interface InstallSkillsOptions {\n\tjson?: boolean;\n\tscope?: \"global\" | \"project\";\n\tpreview?: boolean;\n}\n\n/**\n * Installs Neon agent skills using Vercel's skills CLI.\n */\nexport async function installAgentSkills(\n\tselectedEditors: Editor[],\n\toptions?: InstallSkillsOptions,\n): Promise<boolean> {\n\tconst quiet = options?.json === true;\n\n\tconst editorsWithSkills = selectedEditors.filter(\n\t\t(e) => editorToSkillsAgent(e) !== \"\",\n\t);\n\n\tif (editorsWithSkills.length === 0) {\n\t\treturn true;\n\t}\n\n\tconst skillsSpinner = quiet ? null : spinner();\n\tskillsSpinner?.start(\"Installing agent skills for Neon in this project...\");\n\n\tlet anyFailed = false;\n\n\tawait ensureSkillsCli();\n\tconst skills = getSkillList(options?.preview);\n\n\tfor (const editor of editorsWithSkills) {\n\t\tconst agentName = editorToSkillsAgent(editor);\n\n\t\t// Install one skill at a time — the skills CLI has a bug with multiple\n\t\t// --skill flags where it creates directories but doesn't copy all SKILL.md files.\n\t\tfor (const skill of skills) {\n\t\t\ttry {\n\t\t\t\tawait execa(\n\t\t\t\t\t\"skills\",\n\t\t\t\t\t[\n\t\t\t\t\t\t\"add\",\n\t\t\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\t\t\"--skill\",\n\t\t\t\t\t\tskill,\n\t\t\t\t\t\t\"--agent\",\n\t\t\t\t\t\tagentName,\n\t\t\t\t\t\t...(options?.scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\t\t\"-y\",\n\t\t\t\t\t],\n\t\t\t\t\t{\n\t\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\t\ttimeout: 120000,\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tif (!quiet)\n\t\t\t\t\tlog.error(\n\t\t\t\t\t\t`Failed to install skill ${skill} for ${editor}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t\t\t\t);\n\t\t\t\tanyFailed = true;\n\t\t\t}\n\t\t}\n\t}\n\n\tif (anyFailed) {\n\t\tskillsSpinner?.stop(\n\t\t\t\"Agent skills installation for this project completed with errors\",\n\t\t);\n\t\tif (!quiet)\n\t\t\tlog.info(\n\t\t\t\t\"You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon --skill neon-postgres\",\n\t\t\t);\n\t\treturn false;\n\t}\n\n\tskillsSpinner?.stop(dim(\"Agent skills installed ✓\"));\n\treturn true;\n}\n\n// ---------------------------------------------------------------------------\n// Evergreen skills: ensure skills are up to date (at most once per 12 hours)\n// ---------------------------------------------------------------------------\n\nconst SKILLS_FRESHNESS_MS = 12 * 60 * 60 * 1000; // 12 hours\n\n/**\n * Agent skills directory paths by agent, keyed by scope.\n * These are the directories that `skills add` writes to.\n */\nconst GLOBAL_SKILLS_DIRS: Record<string, string[]> = (() => {\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\t// .agents/skills is the generic directory used by multiple agents\n\tconst agentsDir = resolve(home, \".agents\", \"skills\");\n\treturn {\n\t\tcursor: [resolve(home, \".cursor\", \"skills\"), agentsDir],\n\t\t\"claude-code\": [resolve(home, \".claude\", \"skills\"), agentsDir],\n\t\t\"github-copilot\": [resolve(home, \".vscode\", \"skills\"), agentsDir],\n\t\tcodex: [resolve(home, \".codex\", \"skills\"), agentsDir],\n\t\tcline: [resolve(home, \".cline\", \"skills\"), agentsDir],\n\t};\n})();\n\n/**\n * Checks whether skills were recently updated (within the freshness window).\n * Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).\n */\nfunction skillsAreFresh(agent: string, requiredSkills: string[]): boolean {\n\tconst now = Date.now();\n\tconst cwd = process.cwd();\n\tconst projectSkillDirs = [\".agents\", \".cursor\", \".claude\"];\n\n\t// Check project-level: ALL required skills must exist on disk\n\t// and skills-lock.json must be recent\n\tconst lockPath = resolve(cwd, \"skills-lock.json\");\n\tif (existsSync(lockPath)) {\n\t\ttry {\n\t\t\tconst mtime = statSync(lockPath).mtimeMs;\n\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) {\n\t\t\t\tconst allExist = requiredSkills.every((skill) =>\n\t\t\t\t\tprojectSkillDirs.some((dir) =>\n\t\t\t\t\t\texistsSync(\n\t\t\t\t\t\t\tresolve(cwd, dir, \"skills\", skill, \"SKILL.md\"),\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tif (allExist) return true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check global: ALL required skills must exist in agent-specific dirs\n\tconst agentName = getSkillsAgentNameFromId(agent);\n\tconst globalDirs = GLOBAL_SKILLS_DIRS[agentName] ?? [];\n\tfor (const dir of globalDirs) {\n\t\tconst allExist = requiredSkills.every((skill) =>\n\t\t\texistsSync(resolve(dir, skill, \"SKILL.md\")),\n\t\t);\n\t\tif (allExist) {\n\t\t\t// Check freshness of any one skill file\n\t\t\ttry {\n\t\t\t\tconst mtime = statSync(\n\t\t\t\t\tresolve(dir, requiredSkills[0], \"SKILL.md\"),\n\t\t\t\t).mtimeMs;\n\t\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) return true;\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Ensures Neon agent skills are up to date. Runs `skills add` if the skills\n * haven't been updated within the freshness window (12 hours).\n *\n * Designed to be called from any phase handler — cheap to call repeatedly\n * since it's a no-op when skills are fresh.\n */\nexport async function ensureSkillsUpToDate(\n\tagent: string | undefined,\n\tscope?: \"global\" | \"project\",\n\tpreview?: boolean,\n): Promise<boolean> {\n\tconst resolvedAgent = agent || \"cursor\";\n\tconst skills = getSkillList(preview);\n\tif (skillsAreFresh(resolvedAgent, skills)) return true;\n\n\tawait ensureSkillsCli();\n\tconst agentName = getSkillsAgentNameFromId(resolvedAgent);\n\tlet allOk = true;\n\n\t// Only install skills that don't already have SKILL.md on disk.\n\t// Re-installing existing skills can trigger sandbox permission prompts.\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\tconst cwd = process.cwd();\n\tconst checkDirs =\n\t\tscope === \"global\"\n\t\t\t? [\n\t\t\t\t\tresolve(home, \".cursor\", \"skills\"),\n\t\t\t\t\tresolve(home, \".claude\", \"skills\"),\n\t\t\t\t\tresolve(home, \".agents\", \"skills\"),\n\t\t\t\t]\n\t\t\t: [\n\t\t\t\t\tresolve(cwd, \".cursor\", \"skills\"),\n\t\t\t\t\tresolve(cwd, \".claude\", \"skills\"),\n\t\t\t\t\tresolve(cwd, \".agents\", \"skills\"),\n\t\t\t\t];\n\n\tconst missingSkills = skills.filter(\n\t\t(skill) =>\n\t\t\t!checkDirs.some((dir) =>\n\t\t\t\texistsSync(resolve(dir, skill, \"SKILL.md\")),\n\t\t\t),\n\t);\n\n\tif (missingSkills.length === 0) return true;\n\n\t// Install one skill at a time — the skills CLI has a bug with multiple\n\t// --skill flags where it creates directories but doesn't copy all SKILL.md files.\n\tfor (const skill of missingSkills) {\n\t\ttry {\n\t\t\tawait execa(\n\t\t\t\t\"skills\",\n\t\t\t\t[\n\t\t\t\t\t\"add\",\n\t\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\t\"--skill\",\n\t\t\t\t\tskill,\n\t\t\t\t\t\"--agent\",\n\t\t\t\t\tagentName,\n\t\t\t\t\t...(scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\t\"-y\",\n\t\t\t\t],\n\t\t\t\t{ stdio: \"pipe\", timeout: 120000 },\n\t\t\t);\n\t\t} catch {\n\t\t\tallOk = false;\n\t\t}\n\t}\n\n\treturn allOk;\n}\n"],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -128,10 +128,12 @@ interface StatusResponse {
   tooling: {
     mcpServer: {
       configured: boolean | null;
+      scope?: string | null;
       location?: string;
     };
     skills: {
       installed: boolean;
+      scope?: string | null;
     };
     extension?: {
       installed: boolean;

package/dist/v2.d.ts

@@ -3,7 +3,6 @@ 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;

package/dist/v2.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"v2.d.ts","names":[],"sources":["../src/v2.ts"],"mappings":";;;UAYiB,mBAAA;;EAAA,cAAA,CAAA,EAAA,OAAmB;EAwBd;EAAW,OAAA,CAAA,EAAA,OAAA;;;;AAEvB;;;;;;;;;;;;;;;iBAFY,WAAA,UACZ,sBACP,QAAQ"}

package/dist/v2.js

@@ -62,13 +62,39 @@ async function orchestrate(options) {
 		}
 	]);
 	const hasApp = options.preview ? inspection.hasApp === true : true;
-	const toolingInstalled = inspection.mcpConfigured && inspection.skillsInstalled;
+	let skillsInstalled = inspection.skillsInstalled;
+	if (options.preview && skillsInstalled && inspection.skillsScope) {
+		const { getSkillList } = await import("./lib/skills.js");
+		const previewSkills = getSkillList(true);
+		const { existsSync: exists } = await import("node:fs");
+		const { resolve: resolvePath } = await import("node:path");
+		const home = process.env.HOME || process.env.USERPROFILE || "";
+		const dirs = inspection.skillsScope === "project" ? [
+			resolvePath(cwd, ".cursor", "skills"),
+			resolvePath(cwd, ".claude", "skills"),
+			resolvePath(cwd, ".agents", "skills")
+		] : [
+			resolvePath(home, ".cursor", "skills"),
+			resolvePath(home, ".claude", "skills"),
+			resolvePath(home, ".agents", "skills")
+		];
+		if (!previewSkills.every((skill) => dirs.some((dir) => exists(resolvePath(dir, skill, "SKILL.md"))))) {
+			skillsInstalled = false;
+			inspection.skillsScope = `${inspection.skillsScope}-partial`;
+		}
+	}
+	const toolingInstalled = inspection.mcpConfigured && skillsInstalled;
 	const hasNeonConnection = inspection.connectionString === true;
 	if (!hasApp || !toolingInstalled) {
 		cleanupInitState(resolve(cwd, ".neon"));
 		return handleSetupPhase({
 			agent: options.agent,
-			hasApp
+			preview: options.preview,
+			hasApp,
+			mcpConfigured: inspection.mcpConfigured ?? null,
+			mcpScope: inspection.mcpScope || void 0,
+			skillsInstalled: skillsInstalled ?? null,
+			skillsScope: inspection.skillsScope || void 0
 		});
 	}
 	const neonContextPath = resolve(cwd, ".neon");
@@ -94,11 +120,10 @@ async function orchestrate(options) {
 			writeFileSync(neonContextPath, `${JSON.stringify(merged, null, 2)}\n`);
 		}
 	} catch {}
-	const hasFeatureRequirements = features.length > 0;
-	if (hasFeatureRequirements ? features.includes("auth") : !options.skipNeonAuth) {
+	if (features.includes("auth")) {
 		if (!checkNeonAuth(cwd)) return handleNeonAuthPhase({
 			agent: options.agent,
-			setup: hasFeatureRequirements
+			setup: true
 		});
 	}
 	if (!options.skipMigrations) return handleMigrationsPhase({ agent: options.agent });