neon 2.47.0 → 3.1.0

package/dist/commands/link.js

@@ -1,1122 +1,977 @@
-import prompts from "prompts";
-import { isNeonApiError, messageFromBody } from "../api.js";
-import { applyContext, contextBranch, readContextFile, setContext, updateContextFile, } from "../context.js";
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import { isCi } from "../env.js";
 import { log } from "../log.js";
-import { createBranch, pickBranchInteractively, } from "../utils/branch_picker.js";
+import { isNeonApiError, messageFromBody } from "../api.js";
+import { applyContext, contextBranch, readContextFile, setContext, updateContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
-import { hasNeonConfigFile, initCmd } from "./config.js";
+import { createBranch, pickBranchInteractively } from "../utils/branch_picker.js";
 import { autoPullEnvAfterPin, renderAgentPullNote } from "./env.js";
+import { hasNeonConfigFile, initCmd } from "./config.js";
 import { REGIONS } from "./projects.js";
+import prompts from "prompts";
+//#region src/commands/link.ts
+var link_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler
+});
 const PROJECTS_LIST_LIMIT = 100;
 const CREATE_NEW_SENTINEL = "__create_new__";
-export const command = "link";
-export const describe = "Link the current directory to a Neon project";
-export const builder = (argv) => argv
-    .usage("$0 link [options]")
-    .options({
-    "org-id": {
-        describe: "Organization ID to link to",
-        type: "string",
-    },
-    "project-id": {
-        describe: "Existing project ID to link to",
-        type: "string",
-    },
-    "project-name": {
-        describe: "Name for a new project to create and link to",
-        type: "string",
-    },
-    "region-id": {
-        describe: "Region ID for a new project (e.g. aws-us-east-2). Required with --project-name.",
-        type: "string",
-    },
-    branch: {
-        alias: "branch-id",
-        describe: "Branch name or ID to pin in the context (resolved to its ID before writing). " +
-            "Without it, link only resolves the org and project — pin a branch with " +
-            `\`${getCliName()} checkout <branch>\` (link never guesses a default).`,
-        type: "string",
-    },
-    params: {
-        describe: 'JSON object with link parameters, e.g. \'{"orgId":"...","projectId":"..."}\' or \'{"orgId":"...","projectName":"...","regionId":"..."}\'. Flags take precedence over fields in --params.',
-        type: "string",
-    },
-    agent: {
-        describe: "Emit a JSON state-machine response designed for AI agents instead of prompting. The output is a single JSON object with a discriminated `status` field describing the next step.",
-        type: "boolean",
-        default: false,
-    },
-    yes: {
-        alias: "y",
-        describe: 'Skip the "already linked" confirmation in interactive mode and re-link anyway.',
-        type: "boolean",
-        default: false,
-    },
-    clear: {
-        describe: "Remove the org/project/branch context (writes an empty context file) instead of linking.",
-        type: "boolean",
-        default: false,
-    },
-    checks: {
-        describe: "Verify the org/project/branch exist (and resolve the org from the project) before " +
-            "writing. On by default; use --no-checks to write the context offline with no API " +
-            "calls — it then requires --org-id and --project-id (--branch optional) and skips " +
-            "env pull.",
-        type: "boolean",
-        default: true,
-    },
-    "env-pull": {
-        describe: "Pull the linked branch's Neon env vars (DATABASE_URL, …) into a local .env after " +
-            "linking. On by default; use --no-env-pull to skip (e.g. when injecting env at " +
-            "runtime with `neon-env run` / `neon dev`). Only runs when a branch is pinned.",
-        type: "boolean",
-        default: true,
-    },
-})
-    .example([
-    [
-        "$0 link --project-id polished-snowflake-12345678",
-        `Link an existing project (org is inferred); pin a branch later with '${getCliName()} checkout'`,
-    ],
-    [
-        "$0 link --org-id org-… --project-name my-app --region-id aws-us-east-2",
-        "Create a new project and link it",
-    ],
-    [
-        "$0 link --branch-id br-…",
-        "Pin a branch in the already-linked project",
-    ],
-    [
-        "$0 link --no-checks --org-id org-… --project-id polished-snowflake-12345678",
-        "Write the context offline (no API calls, no verification)",
-    ],
-    [
-        "$0 link --clear",
-        "Forget the current org/project/branch context",
-    ],
+const command = "link";
+const describe = "Link the current directory to a Neon project";
+const builder = (argv) => argv.usage("$0 link [options]").options({
+	"org-id": {
+		describe: "Organization ID to link to",
+		type: "string"
+	},
+	"project-id": {
+		describe: "Existing project ID to link to",
+		type: "string"
+	},
+	"project-name": {
+		describe: "Name for a new project to create and link to",
+		type: "string"
+	},
+	"region-id": {
+		describe: "Region ID for a new project (e.g. aws-us-east-2). Required with --project-name.",
+		type: "string"
+	},
+	branch: {
+		alias: "branch-id",
+		describe: `Branch name or ID to pin in the context (resolved to its ID before writing). Without it, link only resolves the org and project — pin a branch with \`${getCliName()} checkout <branch>\` (link never guesses a default).`,
+		type: "string"
+	},
+	params: {
+		describe: "JSON object with link parameters, e.g. '{\"orgId\":\"...\",\"projectId\":\"...\"}' or '{\"orgId\":\"...\",\"projectName\":\"...\",\"regionId\":\"...\"}'. Flags take precedence over fields in --params.",
+		type: "string"
+	},
+	agent: {
+		describe: "Emit a JSON state-machine response designed for AI agents instead of prompting. The output is a single JSON object with a discriminated `status` field describing the next step.",
+		type: "boolean",
+		default: false
+	},
+	yes: {
+		alias: "y",
+		describe: "Skip the \"already linked\" confirmation in interactive mode and re-link anyway.",
+		type: "boolean",
+		default: false
+	},
+	clear: {
+		describe: "Remove the org/project/branch context (writes an empty context file) instead of linking.",
+		type: "boolean",
+		default: false
+	},
+	checks: {
+		describe: "Verify the org/project/branch exist (and resolve the org from the project) before writing. On by default; use --no-checks to write the context offline with no API calls — it then requires --org-id and --project-id (--branch optional) and skips env pull.",
+		type: "boolean",
+		default: true
+	},
+	"env-pull": {
+		describe: "Pull the linked branch's Neon env vars (DATABASE_URL, …) into a local .env after linking. On by default; use --no-env-pull to skip (e.g. when injecting env at runtime with `neon-env run` / `neon dev`). Only runs when a branch is pinned.",
+		type: "boolean",
+		default: true
+	}
+}).example([
+	["$0 link --project-id polished-snowflake-12345678", `Link an existing project (org is inferred); pin a branch later with '${getCliName()} checkout'`],
+	["$0 link --org-id org-… --project-name my-app --region-id aws-us-east-2", "Create a new project and link it"],
+	["$0 link --branch-id br-…", "Pin a branch in the already-linked project"],
+	["$0 link --no-checks --org-id org-… --project-id polished-snowflake-12345678", "Write the context offline (no API calls, no verification)"],
+	["$0 link --clear", "Forget the current org/project/branch context"]
 ]);
-export const handler = async (props) => {
-    if (props.clear) {
-        clearContext(props.contextFile);
-        return;
-    }
-    if (!props.checks) {
-        runWithoutChecks(props);
-        return;
-    }
-    if (props.agent) {
-        await runAgentSafely(props);
-        return;
-    }
-    const inputs = parseInputs(props);
-    validateInputs(inputs);
-    const existing = readContextFile(props.contextFile);
-    if (canResolveNonInteractively(inputs, existing)) {
-        await runNonInteractive(props, inputs, existing);
-        return;
-    }
-    if (isCi()) {
-        log.error([
-            "Missing inputs and CI environment detected (no TTY for prompts).",
-            "",
-            "Use one of:",
-            `  ${getCliName()} link --agent                                                    (JSON state machine for agents)`,
-            `  ${getCliName()} link --project-id <project>                                     (link to an existing project; org is inferred)`,
-            `  ${getCliName()} link --org-id <org> --project-name <name> --region-id <region>  (create a new project and link)`,
-        ].join("\n"));
-        process.exit(1);
-        return;
-    }
-    await runInteractive(props, inputs);
+const handler = async (props) => {
+	if (props.clear) {
+		clearContext(props.contextFile);
+		return;
+	}
+	if (!props.checks) {
+		runWithoutChecks(props);
+		return;
+	}
+	if (props.agent) {
+		await runAgentSafely(props);
+		return;
+	}
+	const inputs = parseInputs(props);
+	validateInputs(inputs);
+	const existing = readContextFile(props.contextFile);
+	if (canResolveNonInteractively(inputs, existing)) {
+		await runNonInteractive(props, inputs, existing);
+		return;
+	}
+	if (isCi()) {
+		log.error([
+			"Missing inputs and CI environment detected (no TTY for prompts).",
+			"",
+			"Use one of:",
+			`  ${getCliName()} link --agent                                                    (JSON state machine for agents)`,
+			`  ${getCliName()} link --project-id <project>                                     (link to an existing project; org is inferred)`,
+			`  ${getCliName()} link --org-id <org> --project-name <name> --region-id <region>  (create a new project and link)`
+		].join("\n"));
+		process.exit(1);
+		return;
+	}
+	await runInteractive(props, inputs);
 };
-// ----------------------------------------------------------------------------
-// Input parsing & validation
-// ----------------------------------------------------------------------------
 const parseInputs = (props) => {
-    let fromParams = {};
-    if (props.params !== undefined && props.params !== "") {
-        let parsed;
-        try {
-            parsed = JSON.parse(props.params);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            throw new Error(`Failed to parse --params JSON: ${message}`);
-        }
-        fromParams = extractParams(parsed);
-    }
-    return {
-        orgId: props.orgId ?? fromParams.orgId,
-        projectId: props.projectId ?? fromParams.projectId,
-        projectName: props.projectName ?? fromParams.projectName,
-        regionId: props.regionId ?? fromParams.regionId,
-        branch: props.branch ?? fromParams.branch,
-    };
+	let fromParams = {};
+	if (props.params !== void 0 && props.params !== "") {
+		let parsed;
+		try {
+			parsed = JSON.parse(props.params);
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			throw new Error(`Failed to parse --params JSON: ${message}`);
+		}
+		fromParams = extractParams(parsed);
+	}
+	return {
+		orgId: props.orgId ?? fromParams.orgId,
+		projectId: props.projectId ?? fromParams.projectId,
+		projectName: props.projectName ?? fromParams.projectName,
+		regionId: props.regionId ?? fromParams.regionId,
+		branch: props.branch ?? fromParams.branch
+	};
 };
 const extractParams = (raw) => {
-    if (raw === null || typeof raw !== "object") {
-        throw new Error("--params must be a JSON object");
-    }
-    const obj = raw;
-    const pickString = (key) => {
-        const value = obj[key];
-        if (value === undefined || value === null)
-            return undefined;
-        if (typeof value !== "string") {
-            throw new Error(`--params.${key} must be a string`);
-        }
-        return value;
-    };
-    return {
-        orgId: pickString("orgId"),
-        projectId: pickString("projectId"),
-        projectName: pickString("projectName"),
-        regionId: pickString("regionId"),
-        branch: pickString("branch") ?? pickString("branchId"),
-    };
+	if (raw === null || typeof raw !== "object") throw new Error("--params must be a JSON object");
+	const obj = raw;
+	const pickString = (key) => {
+		const value = obj[key];
+		if (value === void 0 || value === null) return void 0;
+		if (typeof value !== "string") throw new Error(`--params.${key} must be a string`);
+		return value;
+	};
+	return {
+		orgId: pickString("orgId"),
+		projectId: pickString("projectId"),
+		projectName: pickString("projectName"),
+		regionId: pickString("regionId"),
+		branch: pickString("branch") ?? pickString("branchId")
+	};
 };
 const validateInputs = (inputs) => {
-    if (inputs.projectId && (inputs.projectName || inputs.regionId)) {
-        throw new Error("Conflicting inputs: --project-id selects an existing project; --project-name and --region-id describe a new one. Pass only one set.");
-    }
-    if (inputs.projectName && inputs.branch) {
-        throw new Error(`Conflicting inputs: --branch pins a branch of an existing project, but --project-name creates a new one. Create the project first, then \`${getCliName()} checkout <branch>\`.`);
-    }
+	if (inputs.projectId && (inputs.projectName || inputs.regionId)) throw new Error("Conflicting inputs: --project-id selects an existing project; --project-name and --region-id describe a new one. Pass only one set.");
+	if (inputs.projectName && inputs.branch) throw new Error(`Conflicting inputs: --branch pins a branch of an existing project, but --project-name creates a new one. Create the project first, then \`${getCliName()} checkout <branch>\`.`);
 };
 /**
- * Whether the inputs (combined with the existing `.neon`) fully determine what
- * to write without prompting the user. Everything else falls back to the
- * interactive picker (TTY) or the CI guard.
- *
- * - `--project-id` is always enough: the org is inferred from the project and
- *   the branch is left to an explicit `checkout` (never auto-defaulted).
- * - `--org-id --project-name --region-id` fully describes a project to create.
- * - `--branch-id` needs a project, which it takes from the existing `.neon`.
- * - `--org-id` on its own just records the default org (merged into any
- *   existing context).
- */
+* Whether the inputs (combined with the existing `.neon`) fully determine what
+* to write without prompting the user. Everything else falls back to the
+* interactive picker (TTY) or the CI guard.
+*
+* - `--project-id` is always enough: the org is inferred from the project and
+*   the branch is left to an explicit `checkout` (never auto-defaulted).
+* - `--org-id --project-name --region-id` fully describes a project to create.
+* - `--branch-id` needs a project, which it takes from the existing `.neon`.
+* - `--org-id` on its own just records the default org (merged into any
+*   existing context).
+*/
 const canResolveNonInteractively = (inputs, existing) => {
-    if (inputs.projectId)
-        return true;
-    if (inputs.orgId && inputs.projectName && inputs.regionId)
-        return true;
-    if (inputs.branch && existing.projectId)
-        return true;
-    if (inputs.orgId && !inputs.projectName && !inputs.branch)
-        return true;
-    return false;
+	if (inputs.projectId) return true;
+	if (inputs.orgId && inputs.projectName && inputs.regionId) return true;
+	if (inputs.branch && existing.projectId) return true;
+	if (inputs.orgId && !inputs.projectName && !inputs.branch) return true;
+	return false;
 };
-// ----------------------------------------------------------------------------
-// Context helpers
-// ----------------------------------------------------------------------------
 const clearContext = (contextFile) => {
-    updateContextFile(contextFile, {});
-    process.stdout.write(`Cleared ${contextFile}. The directory is no longer linked to a Neon org/project/branch.\n`);
+	updateContextFile(contextFile, {});
+	process.stdout.write(`Cleared ${contextFile}. The directory is no longer linked to a Neon org/project/branch.\n`);
 };
 /**
- * `--no-checks`: write the context offline. Makes no API calls — so no org
- * inference, no existence/access verification, and no env pull — which means
- * the caller must supply both `--org-id` and `--project-id` (the org can't be
- * inferred without the network). `--branch` stays optional. This is the CLI
- * surface over {@link setContext}, useful for scripted/offline setups and for
- * re-creating a `.neon` from values you already trust.
- */
+* `--no-checks`: write the context offline. Makes no API calls — so no org
+* inference, no existence/access verification, and no env pull — which means
+* the caller must supply both `--org-id` and `--project-id` (the org can't be
+* inferred without the network). `--branch` stays optional. This is the CLI
+* surface over {@link setContext}, useful for scripted/offline setups and for
+* re-creating a `.neon` from values you already trust.
+*/
 const runWithoutChecks = (props) => {
-    const inputs = parseInputs(props);
-    validateInputs(inputs);
-    if (inputs.projectName) {
-        throw new Error("--no-checks can't create a project (that needs API access). Pass --org-id and --project-id for an existing project, or drop --no-checks.");
-    }
-    if (!inputs.orgId || !inputs.projectId) {
-        throw new Error("--no-checks writes the context with no API calls, so it needs both --org-id and --project-id (--branch is optional).");
-    }
-    setContext(props.contextFile, {
-        orgId: inputs.orgId,
-        projectId: inputs.projectId,
-        branch: inputs.branch,
-    });
-    if (props.agent) {
-        emitAgent({
-            status: "linked",
-            context_file: props.contextFile,
-            context: {
-                orgId: inputs.orgId,
-                projectId: inputs.projectId,
-                branch: inputs.branch,
-            },
-            project: { id: inputs.projectId },
-            message: `Wrote ${props.contextFile} without checks (org ${inputs.orgId}, project ${inputs.projectId}${inputs.branch ? `, branch ${inputs.branch}` : ""}). No verification or env pull was performed.`,
-        });
-        return;
-    }
-    printSummary(props, {
-        contextFile: props.contextFile,
-        orgId: inputs.orgId,
-        projectId: inputs.projectId,
-        branch: inputs.branch,
-        created: false,
-        noChecks: true,
-    });
+	const inputs = parseInputs(props);
+	validateInputs(inputs);
+	if (inputs.projectName) throw new Error("--no-checks can't create a project (that needs API access). Pass --org-id and --project-id for an existing project, or drop --no-checks.");
+	if (!inputs.orgId || !inputs.projectId) throw new Error("--no-checks writes the context with no API calls, so it needs both --org-id and --project-id (--branch is optional).");
+	setContext(props.contextFile, {
+		orgId: inputs.orgId,
+		projectId: inputs.projectId,
+		branch: inputs.branch
+	});
+	if (props.agent) {
+		emitAgent({
+			status: "linked",
+			context_file: props.contextFile,
+			context: {
+				orgId: inputs.orgId,
+				projectId: inputs.projectId,
+				branch: inputs.branch
+			},
+			project: { id: inputs.projectId },
+			message: `Wrote ${props.contextFile} without checks (org ${inputs.orgId}, project ${inputs.projectId}${inputs.branch ? `, branch ${inputs.branch}` : ""}). No verification or env pull was performed.`
+		});
+		return;
+	}
+	printSummary(props, {
+		contextFile: props.contextFile,
+		orgId: inputs.orgId,
+		projectId: inputs.projectId,
+		branch: inputs.branch,
+		created: false,
+		noChecks: true
+	});
 };
 /**
- * A bad user-supplied identifier (project/org/branch that doesn't exist or
- * isn't accessible). Carries an `agentCode` so `--agent` mode can report a
- * precise `status: error` code instead of a generic INTERNAL_ERROR, while the
- * human path just prints the clear `message`.
- */
-class LinkInputError extends Error {
-    constructor(message, agentCode) {
-        super(message);
-        this.name = "LinkInputError";
-        this.agentCode = agentCode;
-    }
-}
-const httpStatus = (err) => isNeonApiError(err) ? err.status : undefined;
+* A bad user-supplied identifier (project/org/branch that doesn't exist or
+* isn't accessible). Carries an `agentCode` so `--agent` mode can report a
+* precise `status: error` code instead of a generic INTERNAL_ERROR, while the
+* human path just prints the clear `message`.
+*/
+var LinkInputError = class extends Error {
+	constructor(message, agentCode) {
+		super(message);
+		this.name = "LinkInputError";
+		this.agentCode = agentCode;
+	}
+};
+const httpStatus = (err) => isNeonApiError(err) ? err.status : void 0;
 /**
- * Fetch a project, turning the common failure modes into clear, actionable
- * errors. 401 is rethrown so the global handler can refresh credentials;
- * everything else surfaces as a `LinkInputError` the user (or agent) can act on.
- */
+* Fetch a project, turning the common failure modes into clear, actionable
+* errors. 401 is rethrown so the global handler can refresh credentials;
+* everything else surfaces as a `LinkInputError` the user (or agent) can act on.
+*/
 const fetchProjectOrThrow = async (props, projectId) => {
-    try {
-        const { data } = await props.apiClient.getProject(projectId);
-        return data.project;
-    }
-    catch (err) {
-        const status = httpStatus(err);
-        if (status === 401) {
-            throw err;
-        }
-        if (status === 403) {
-            throw new LinkInputError(`You don't have access to project '${projectId}'. Check that your API key's account or organization can see it.`, "NO_ACCESS");
-        }
-        if (status === 404) {
-            throw new LinkInputError(`Project '${projectId}' not found. Double-check the project ID — or that your API key has access to it.`, "NOT_FOUND");
-        }
-        throw err;
-    }
+	try {
+		const { data } = await props.apiClient.getProject(projectId);
+		return data.project;
+	} catch (err) {
+		const status = httpStatus(err);
+		if (status === 401) throw err;
+		if (status === 403) throw new LinkInputError(`You don't have access to project '${projectId}'. Check that your API key's account or organization can see it.`, "NO_ACCESS");
+		if (status === 404) throw new LinkInputError(`Project '${projectId}' not found. Double-check the project ID — or that your API key has access to it.`, "NOT_FOUND");
+		throw err;
+	}
 };
 /**
- * Confirm the org exists and is reachable with the current API key by listing
- * its projects (allowed for both user and org-scoped keys). Maps 403/404 to a
- * clear message; 401 is rethrown for credential refresh.
- */
+* Confirm the org exists and is reachable with the current API key by listing
+* its projects (allowed for both user and org-scoped keys). Maps 403/404 to a
+* clear message; 401 is rethrown for credential refresh.
+*/
 const verifyOrgAccess = async (props, orgId) => {
-    try {
-        await props.apiClient.listProjects({
-            org_id: orgId,
-            limit: PROJECTS_LIST_LIMIT,
-        });
-    }
-    catch (err) {
-        const status = httpStatus(err);
-        if (status === 401) {
-            throw err;
-        }
-        if (status === 403 || status === 404) {
-            throw new LinkInputError(`Organization '${orgId}' not found, or your API key doesn't have access to it. Find your org ID in the Neon Console under Settings.`, status === 403 ? "NO_ACCESS" : "NOT_FOUND");
-        }
-        throw err;
-    }
+	try {
+		await props.apiClient.listProjects({
+			org_id: orgId,
+			limit: PROJECTS_LIST_LIMIT
+		});
+	} catch (err) {
+		const status = httpStatus(err);
+		if (status === 401) throw err;
+		if (status === 403 || status === 404) throw new LinkInputError(`Organization '${orgId}' not found, or your API key doesn't have access to it. Find your org ID in the Neon Console under Settings.`, status === 403 ? "NO_ACCESS" : "NOT_FOUND");
+		throw err;
+	}
 };
 /**
- * Resolve a branch reference (name *or* id) to the matching branch, while
- * confirming it actually exists in the project. Unlike the shared
- * `branchIdResolve`, this also verifies references that already look like ids
- * (so a typo'd `br-…` doesn't silently get written), and surfaces the available
- * branches when nothing matches so the user can correct it (or run `checkout`).
- */
+* Resolve a branch reference (name *or* id) to the matching branch, while
+* confirming it actually exists in the project. Unlike the shared
+* `branchIdResolve`, this also verifies references that already look like ids
+* (so a typo'd `br-…` doesn't silently get written), and surfaces the available
+* branches when nothing matches so the user can correct it (or run `checkout`).
+*/
 const resolveBranchRef = async (props, projectId, branchRef) => {
-    const { data } = await props.apiClient.listProjectBranches({ projectId });
-    const match = data.branches.find((b) => b.id === branchRef) ??
-        data.branches.find((b) => b.name === branchRef);
-    if (match) {
-        return match;
-    }
-    const available = data.branches.length > 0
-        ? data.branches
-            .map((b) => `${b.id}${b.name ? ` (${b.name})` : ""}`)
-            .join(", ")
-        : "(none)";
-    throw new LinkInputError(`Branch '${branchRef}' not found in project '${projectId}'. Available branches: ${available}. Pin one with \`${getCliName()} checkout <branch>\`.`, "NOT_FOUND");
+	const { data } = await props.apiClient.listProjectBranches({ projectId });
+	const match = data.branches.find((b) => b.id === branchRef) ?? data.branches.find((b) => b.name === branchRef);
+	if (match) return match;
+	throw new LinkInputError(`Branch '${branchRef}' not found in project '${projectId}'. Available branches: ${data.branches.length > 0 ? data.branches.map((b) => `${b.id}${b.name ? ` (${b.name})` : ""}`).join(", ") : "(none)"}. Pin one with \`${getCliName()} checkout <branch>\`.`, "NOT_FOUND");
 };
 /**
- * The value to persist for a branch: prefer its human-readable **name** (nicer
- * to read in `.neon`, and still resolvable by every command), falling back to
- * the id when the branch has no name.
- */
+* The value to persist for a branch: prefer its human-readable **name** (nicer
+* to read in `.neon`, and still resolvable by every command), falling back to
+* the id when the branch has no name.
+*/
 const branchPersistValue = (branch) => branch.name ?? branch.id;
 /**
- * Verify the project (and the org, when supplied) and resolve the org id to
- * persist.
- *
- * The project is always fetched, which both validates it and yields its
- * `org_id`. When `--org-id` is passed too: if the project reports an org it must
- * match (else a clear mismatch error); if it reports none, the supplied org is
- * verified on its own. Without `--org-id` the project's own org is used, falling
- * back to the org already recorded for the *same* project in `.neon`. Projects
- * on a personal account have no org, so `undefined` is a valid result — the
- * field is simply omitted.
- */
+* Verify the project (and the org, when supplied) and resolve the org id to
+* persist.
+*
+* The project is always fetched, which both validates it and yields its
+* `org_id`. When `--org-id` is passed too: if the project reports an org it must
+* match (else a clear mismatch error); if it reports none, the supplied org is
+* verified on its own. Without `--org-id` the project's own org is used, falling
+* back to the org already recorded for the *same* project in `.neon`. Projects
+* on a personal account have no org, so `undefined` is a valid result — the
+* field is simply omitted.
+*/
 const resolveOrgForProject = async (props, inputs, existing, projectId) => {
-    const project = await fetchProjectOrThrow(props, projectId);
-    const projectOrg = project.org_id ?? undefined;
-    if (inputs.orgId) {
-        if (projectOrg && projectOrg !== inputs.orgId) {
-            throw new LinkInputError(`Project '${projectId}' belongs to organization '${projectOrg}', not '${inputs.orgId}'. Omit --org-id to use the project's own org, or pass the matching ID.`, "ORG_MISMATCH");
-        }
-        if (!projectOrg) {
-            await verifyOrgAccess(props, inputs.orgId);
-        }
-        return inputs.orgId;
-    }
-    if (projectOrg) {
-        return projectOrg;
-    }
-    if (projectId === existing.projectId && existing.orgId) {
-        return existing.orgId;
-    }
-    return undefined;
+	const projectOrg = (await fetchProjectOrThrow(props, projectId)).org_id ?? void 0;
+	if (inputs.orgId) {
+		if (projectOrg && projectOrg !== inputs.orgId) throw new LinkInputError(`Project '${projectId}' belongs to organization '${projectOrg}', not '${inputs.orgId}'. Omit --org-id to use the project's own org, or pass the matching ID.`, "ORG_MISMATCH");
+		if (!projectOrg) await verifyOrgAccess(props, inputs.orgId);
+		return inputs.orgId;
+	}
+	if (projectOrg) return projectOrg;
+	if (projectId === existing.projectId && existing.orgId) return existing.orgId;
 };
 /**
- * Resolve the branch to persist alongside a project in non-interactive mode.
- *
- * `link` never guesses the project's default branch — that's `checkout`'s job —
- * so the only sources are an explicit `--branch` (name or id, verified and
- * normalized to its name) or a branch already pinned for the *same* project (so
- * re-linking it doesn't drop your checked-out branch). Reading the existing
- * branch via {@link contextBranch} also recovers a legacy `branchId` field.
- */
+* Resolve the branch to persist alongside a project in non-interactive mode.
+*
+* `link` never guesses the project's default branch — that's `checkout`'s job —
+* so the only sources are an explicit `--branch` (name or id, verified and
+* normalized to its name) or a branch already pinned for the *same* project (so
+* re-linking it doesn't drop your checked-out branch). Reading the existing
+* branch via {@link contextBranch} also recovers a legacy `branchId` field.
+*/
 const resolvePinnedBranch = async (props, inputs, existing, projectId) => {
-    if (inputs.branch) {
-        const branch = await resolveBranchRef(props, projectId, inputs.branch);
-        return branchPersistValue(branch);
-    }
-    if (projectId === existing.projectId) {
-        return contextBranch(existing);
-    }
-    return undefined;
+	if (inputs.branch) {
+		const branch = await resolveBranchRef(props, projectId, inputs.branch);
+		return branchPersistValue(branch);
+	}
+	if (projectId === existing.projectId) return contextBranch(existing);
 };
-// ----------------------------------------------------------------------------
-// Non-interactive flag-driven mode
-// ----------------------------------------------------------------------------
 const runNonInteractive = async (props, inputs, existing) => {
-    // Create a new project and link it.
-    if (inputs.projectName) {
-        const orgId = mustString(inputs.orgId, "orgId");
-        await verifyOrgAccess(props, orgId);
-        const created = await createProject(props, {
-            orgId,
-            name: inputs.projectName,
-            regionId: mustString(inputs.regionId, "regionId"),
-        });
-        applyContext(props.contextFile, {
-            orgId,
-            projectId: created.project.id,
-            branch: created.branchName,
-        });
-        await finalizeLink(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId: created.project.id,
-            branch: created.branchName,
-            created: true,
-            projectName: created.project.name,
-            regionId: created.project.region_id,
-        });
-        return;
-    }
-    // Link an explicitly named existing project.
-    if (inputs.projectId) {
-        const orgId = await resolveOrgForProject(props, inputs, existing, inputs.projectId);
-        const branch = await resolvePinnedBranch(props, inputs, existing, inputs.projectId);
-        applyContext(props.contextFile, {
-            orgId,
-            projectId: inputs.projectId,
-            branch,
-        });
-        await finalizeLink(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId: inputs.projectId,
-            branch,
-            created: false,
-        });
-        return;
-    }
-    // Pin a branch in the already-linked project.
-    if (inputs.branch && existing.projectId) {
-        const projectId = existing.projectId;
-        const orgId = await resolveOrgForProject(props, inputs, existing, projectId);
-        const branch = await resolvePinnedBranch(props, inputs, existing, projectId);
-        applyContext(props.contextFile, {
-            orgId,
-            projectId,
-            branch,
-        });
-        await finalizeLink(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId,
-            branch,
-            created: false,
-        });
-        return;
-    }
-    // Record the default org, preserving any existing project/branch.
-    if (inputs.orgId) {
-        const orgId = inputs.orgId;
-        await verifyOrgAccess(props, orgId);
-        const projectId = existing.projectId;
-        const branch = projectId ? contextBranch(existing) : undefined;
-        applyContext(props.contextFile, { orgId, projectId, branch });
-        printSummary(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId,
-            branch,
-            created: false,
-            orgOnly: true,
-        });
-        return;
-    }
+	if (inputs.projectName) {
+		const orgId = mustString(inputs.orgId, "orgId");
+		await verifyOrgAccess(props, orgId);
+		const created = await createProject(props, {
+			orgId,
+			name: inputs.projectName,
+			regionId: mustString(inputs.regionId, "regionId")
+		});
+		applyContext(props.contextFile, {
+			orgId,
+			projectId: created.project.id,
+			branch: created.branchName
+		});
+		await finalizeLink(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId: created.project.id,
+			branch: created.branchName,
+			created: true,
+			projectName: created.project.name,
+			regionId: created.project.region_id
+		});
+		return;
+	}
+	if (inputs.projectId) {
+		const orgId = await resolveOrgForProject(props, inputs, existing, inputs.projectId);
+		const branch = await resolvePinnedBranch(props, inputs, existing, inputs.projectId);
+		applyContext(props.contextFile, {
+			orgId,
+			projectId: inputs.projectId,
+			branch
+		});
+		await finalizeLink(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId: inputs.projectId,
+			branch,
+			created: false
+		});
+		return;
+	}
+	if (inputs.branch && existing.projectId) {
+		const projectId = existing.projectId;
+		const orgId = await resolveOrgForProject(props, inputs, existing, projectId);
+		const branch = await resolvePinnedBranch(props, inputs, existing, projectId);
+		applyContext(props.contextFile, {
+			orgId,
+			projectId,
+			branch
+		});
+		await finalizeLink(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId,
+			branch,
+			created: false
+		});
+		return;
+	}
+	if (inputs.orgId) {
+		const orgId = inputs.orgId;
+		await verifyOrgAccess(props, orgId);
+		const projectId = existing.projectId;
+		const branch = projectId ? contextBranch(existing) : void 0;
+		applyContext(props.contextFile, {
+			orgId,
+			projectId,
+			branch
+		});
+		printSummary(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId,
+			branch,
+			created: false,
+			orgOnly: true
+		});
+		return;
+	}
 };
-// ----------------------------------------------------------------------------
-// Interactive mode (TTY)
-// ----------------------------------------------------------------------------
 const runInteractive = async (props, inputs) => {
-    if (!props.yes) {
-        await confirmRelinkIfNeeded(props);
-    }
-    const orgResolution = await resolveOrg(props, inputs.orgId);
-    let orgId;
-    if (orgResolution.kind === "resolved") {
-        orgId = orgResolution.orgId;
-        if (orgResolution.autoDetected) {
-            log.info(`Detected organization ${orgId} from your existing projects (organization-scoped API key).`);
-        }
-    }
-    else if (orgResolution.orgKeyLimited) {
-        throw new Error("This API key is organization-scoped, so the CLI cannot list your organizations, " +
-            "and no existing project was found in this org to auto-detect the ID. " +
-            "Re-run with `--org-id <your_org_id>` (find it in the Neon Console under Settings).");
-    }
-    else {
-        orgId = await promptOrgFromList(orgResolution.orgs);
-    }
-    if (inputs.projectName && inputs.regionId) {
-        const created = await createProject(props, {
-            orgId,
-            name: inputs.projectName,
-            regionId: inputs.regionId,
-        });
-        applyContext(props.contextFile, {
-            orgId,
-            projectId: created.project.id,
-            branch: created.branchName,
-        });
-        await finalizeInteractiveLink(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId: created.project.id,
-            branch: created.branchName,
-            created: true,
-            projectName: created.project.name,
-            regionId: created.project.region_id,
-        });
-        return;
-    }
-    // Need to ask: existing project or create a new one?
-    const projects = await listAllProjects(props, orgId);
-    const action = await promptProjectChoice(projects, inputs.projectName);
-    if (action.type === "existing") {
-        const branch = await resolveInteractiveBranch(props, action.projectId);
-        applyContext(props.contextFile, {
-            orgId,
-            projectId: action.projectId,
-            branch,
-        });
-        await finalizeInteractiveLink(props, {
-            contextFile: props.contextFile,
-            orgId,
-            projectId: action.projectId,
-            branch,
-            created: false,
-            projectName: action.name,
-            regionId: action.regionId,
-        });
-        return;
-    }
-    const projectName = inputs.projectName ?? (await promptProjectName(action.suggestedName));
-    const regionId = inputs.regionId ?? (await promptRegion(props));
-    const created = await createProject(props, {
-        orgId,
-        name: projectName,
-        regionId,
-    });
-    applyContext(props.contextFile, {
-        orgId,
-        projectId: created.project.id,
-        branch: created.branchName,
-    });
-    await finalizeInteractiveLink(props, {
-        contextFile: props.contextFile,
-        orgId,
-        projectId: created.project.id,
-        branch: created.branchName,
-        created: true,
-        projectName: created.project.name,
-        regionId: created.project.region_id,
-    });
+	if (!props.yes) await confirmRelinkIfNeeded(props);
+	const orgResolution = await resolveOrg(props, inputs.orgId);
+	let orgId;
+	if (orgResolution.kind === "resolved") {
+		orgId = orgResolution.orgId;
+		if (orgResolution.autoDetected) log.info(`Detected organization ${orgId} from your existing projects (organization-scoped API key).`);
+	} else if (orgResolution.orgKeyLimited) throw new Error("This API key is organization-scoped, so the CLI cannot list your organizations, and no existing project was found in this org to auto-detect the ID. Re-run with `--org-id <your_org_id>` (find it in the Neon Console under Settings).");
+	else orgId = await promptOrgFromList(orgResolution.orgs);
+	if (inputs.projectName && inputs.regionId) {
+		const created = await createProject(props, {
+			orgId,
+			name: inputs.projectName,
+			regionId: inputs.regionId
+		});
+		applyContext(props.contextFile, {
+			orgId,
+			projectId: created.project.id,
+			branch: created.branchName
+		});
+		await finalizeInteractiveLink(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId: created.project.id,
+			branch: created.branchName,
+			created: true,
+			projectName: created.project.name,
+			regionId: created.project.region_id
+		});
+		return;
+	}
+	const projects = await listAllProjects(props, orgId);
+	const action = await promptProjectChoice(projects, inputs.projectName);
+	if (action.type === "existing") {
+		const branch = await resolveInteractiveBranch(props, action.projectId);
+		applyContext(props.contextFile, {
+			orgId,
+			projectId: action.projectId,
+			branch
+		});
+		await finalizeInteractiveLink(props, {
+			contextFile: props.contextFile,
+			orgId,
+			projectId: action.projectId,
+			branch,
+			created: false,
+			projectName: action.name,
+			regionId: action.regionId
+		});
+		return;
+	}
+	const projectName = inputs.projectName ?? await promptProjectName(action.suggestedName);
+	const regionId = inputs.regionId ?? await promptRegion(props);
+	const created = await createProject(props, {
+		orgId,
+		name: projectName,
+		regionId
+	});
+	applyContext(props.contextFile, {
+		orgId,
+		projectId: created.project.id,
+		branch: created.branchName
+	});
+	await finalizeInteractiveLink(props, {
+		contextFile: props.contextFile,
+		orgId,
+		projectId: created.project.id,
+		branch: created.branchName,
+		created: true,
+		projectName: created.project.name,
+		regionId: created.project.region_id
+	});
 };
 const confirmRelinkIfNeeded = async (props) => {
-    const existing = readContextFile(props.contextFile);
-    if (!existing.orgId || !existing.projectId) {
-        return;
-    }
-    const { proceed } = await prompts({
-        onState: onPromptState,
-        type: "confirm",
-        name: "proceed",
-        message: `${props.contextFile} is already linked to project ${existing.projectId} (org ${existing.orgId}). Re-link?`,
-        initial: true,
-    });
-    if (!proceed) {
-        process.stdout.write("Aborted. Existing link preserved.\n");
-        process.exit(0);
-    }
+	const existing = readContextFile(props.contextFile);
+	if (!existing.orgId || !existing.projectId) return;
+	const { proceed } = await prompts({
+		onState: onPromptState,
+		type: "confirm",
+		name: "proceed",
+		message: `${props.contextFile} is already linked to project ${existing.projectId} (org ${existing.orgId}). Re-link?`,
+		initial: true
+	});
+	if (!proceed) {
+		process.stdout.write("Aborted. Existing link preserved.\n");
+		process.exit(0);
+	}
 };
 const promptOrgFromList = async (orgs) => {
-    if (!orgs.length) {
-        throw new Error(`You don't belong to any organizations. Create one in the Neon Console first: https://console.neon.tech/`);
-    }
-    // A single organization leaves nothing to choose, so skip the prompt and link
-    // it directly — go straight on to the project step.
-    if (orgs.length === 1) {
-        const [only] = orgs;
-        log.info(`Linking organization ${only.name} (${only.id}).`);
-        return only.id;
-    }
-    const { orgId } = await prompts({
-        onState: onPromptState,
-        type: "select",
-        name: "orgId",
-        message: "Which organization would you like to link?",
-        choices: orgs.map((org) => ({
-            title: `${org.name} (${org.id})`,
-            value: org.id,
-        })),
-        initial: 0,
-    });
-    return orgId;
+	if (!orgs.length) throw new Error(`You don't belong to any organizations. Create one in the Neon Console first: https://console.neon.tech/`);
+	if (orgs.length === 1) {
+		const [only] = orgs;
+		log.info(`Linking organization ${only.name} (${only.id}).`);
+		return only.id;
+	}
+	const { orgId } = await prompts({
+		onState: onPromptState,
+		type: "select",
+		name: "orgId",
+		message: "Which organization would you like to link?",
+		choices: orgs.map((org) => ({
+			title: `${org.name} (${org.id})`,
+			value: org.id
+		})),
+		initial: 0
+	});
+	return orgId;
 };
 const promptProjectChoice = async (projects, suggestedName) => {
-    const choices = [
-        { title: "＋ Create new project…", value: CREATE_NEW_SENTINEL },
-        ...projects.map((project) => ({
-            title: `${project.name} (${project.id})`,
-            value: project.id,
-        })),
-    ];
-    // Create sits at the top, so default to the first existing project (index 1) when there
-    // is one; with no projects to show, the create option (index 0) is the only choice.
-    const { selection } = await prompts({
-        onState: onPromptState,
-        type: "select",
-        name: "selection",
-        message: "Which project would you like to link?",
-        choices,
-        initial: projects.length > 0 ? 1 : 0,
-    });
-    if (selection === CREATE_NEW_SENTINEL) {
-        return { type: "create", suggestedName };
-    }
-    const project = projects.find((p) => p.id === selection);
-    return {
-        type: "existing",
-        projectId: selection,
-        name: project?.name,
-        regionId: project?.region_id,
-    };
+	const choices = [{
+		title: "＋ Create new project…",
+		value: CREATE_NEW_SENTINEL
+	}, ...projects.map((project) => ({
+		title: `${project.name} (${project.id})`,
+		value: project.id
+	}))];
+	const { selection } = await prompts({
+		onState: onPromptState,
+		type: "select",
+		name: "selection",
+		message: "Which project would you like to link?",
+		choices,
+		initial: projects.length > 0 ? 1 : 0
+	});
+	if (selection === CREATE_NEW_SENTINEL) return {
+		type: "create",
+		suggestedName
+	};
+	const project = projects.find((p) => p.id === selection);
+	return {
+		type: "existing",
+		projectId: selection,
+		name: project?.name,
+		regionId: project?.region_id
+	};
 };
 const promptProjectName = async (suggestedName) => {
-    const { name } = await prompts({
-        onState: onPromptState,
-        type: "text",
-        name: "name",
-        message: "Name for the new project:",
-        initial: suggestedName,
-        validate: (value) => value && value.trim().length > 0
-            ? true
-            : "Project name is required",
-    });
-    return String(name).trim();
+	const { name } = await prompts({
+		onState: onPromptState,
+		type: "text",
+		name: "name",
+		message: "Name for the new project:",
+		initial: suggestedName,
+		validate: (value) => value && value.trim().length > 0 ? true : "Project name is required"
+	});
+	return String(name).trim();
 };
 const promptRegion = async (props) => {
-    const regions = await fetchRegions(props);
-    const defaultIndex = Math.max(0, regions.findIndex((r) => r.default));
-    const { regionId } = await prompts({
-        onState: onPromptState,
-        type: "select",
-        name: "regionId",
-        message: "Which region should the new project run in?",
-        choices: regions.map((region) => ({
-            title: `${region.name} (${region.region_id})`,
-            value: region.region_id,
-        })),
-        initial: defaultIndex,
-    });
-    return regionId;
+	const regions = await fetchRegions(props);
+	const defaultIndex = Math.max(0, regions.findIndex((r) => r.default));
+	const { regionId } = await prompts({
+		onState: onPromptState,
+		type: "select",
+		name: "regionId",
+		message: "Which region should the new project run in?",
+		choices: regions.map((region) => ({
+			title: `${region.name} (${region.region_id})`,
+			value: region.region_id
+		})),
+		initial: defaultIndex
+	});
+	return regionId;
 };
-// ----------------------------------------------------------------------------
-// Agent mode (JSON state machine)
-// ----------------------------------------------------------------------------
 const runAgentSafely = async (props) => {
-    try {
-        const inputs = parseInputs(props);
-        validateInputs(inputs);
-        await runAgent(props, inputs);
-    }
-    catch (err) {
-        emitAgent(toAgentError(err));
-        process.exit(1);
-    }
+	try {
+		const inputs = parseInputs(props);
+		validateInputs(inputs);
+		await runAgent(props, inputs);
+	} catch (err) {
+		emitAgent(toAgentError(err));
+		process.exit(1);
+	}
 };
 const runAgent = async (props, inputs) => {
-    const { projectId, projectName, regionId, branch } = inputs;
-    const existing = readContextFile(props.contextFile);
-    // Existing project: infer the org and link it. The branch is left to an
-    // explicit `checkout` unless one was passed or is already pinned.
-    if (projectId) {
-        const orgId = await resolveOrgForProject(props, inputs, existing, projectId);
-        const pinnedBranch = await resolvePinnedBranch(props, inputs, existing, projectId);
-        applyContext(props.contextFile, {
-            orgId,
-            projectId,
-            branch: pinnedBranch,
-        });
-        const orgSuffix = orgId ? ` (org ${orgId})` : "";
-        if (pinnedBranch) {
-            const pullNote = renderAgentPullNote(await autoPullEnvAfterPin({
-                ...props,
-                projectId,
-                branch: pinnedBranch,
-                envPull: props.envPull,
-            }));
-            emitAgent({
-                status: "linked",
-                context_file: props.contextFile,
-                context: { orgId, projectId, branch: pinnedBranch },
-                project: { id: projectId },
-                message: `Linked ${props.contextFile} to project ${projectId}${orgSuffix} on branch ${pinnedBranch}.${pullNote}`,
-            });
-            return;
-        }
-        emitAgent({
-            status: "linked",
-            context_file: props.contextFile,
-            context: { orgId, projectId },
-            project: { id: projectId },
-            message: `Linked ${props.contextFile} to project ${projectId}${orgSuffix}. No branch pinned — run \`${getCliName()} checkout <branch>\` (omit the branch to list options) to pin one and pull its env vars.`,
-        });
-        return;
-    }
-    const orgResolution = await resolveOrg(props, inputs.orgId);
-    if (orgResolution.kind === "needs_selection") {
-        emitAgent(buildNeedsOrgResponse(orgResolution));
-        return;
-    }
-    const orgId = orgResolution.orgId;
-    if (projectName && !regionId) {
-        const regions = await fetchRegions(props);
-        emitAgent({
-            status: "needs_project_details",
-            instruction: `Ask the user which region to create project "${projectName}" in. After they pick one, re-run the next_command_template with the chosen --region-id value.`,
-            regions: regions.map((region) => ({
-                id: region.region_id,
-                name: region.name,
-                default: region.default,
-            })),
-            next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-name ${shellArg(projectName)} --region-id <region_id>`,
-        });
-        return;
-    }
-    if (projectName && regionId) {
-        await verifyOrgAccess(props, orgId);
-        const created = await createProject(props, {
-            orgId,
-            name: projectName,
-            regionId,
-        });
-        applyContext(props.contextFile, {
-            orgId,
-            projectId: created.project.id,
-            branch: created.branchName,
-        });
-        const pullNote = renderAgentPullNote(await autoPullEnvAfterPin({
-            ...props,
-            projectId: created.project.id,
-            branch: created.branchName,
-            envPull: props.envPull,
-        }));
-        emitAgent({
-            status: "linked",
-            context_file: props.contextFile,
-            context: {
-                orgId,
-                projectId: created.project.id,
-                branch: created.branchName,
-            },
-            project: {
-                id: created.project.id,
-                name: created.project.name,
-                region_id: created.project.region_id,
-            },
-            message: `Created project ${created.project.id} ("${created.project.name ?? projectName}") in ${created.project.region_id ?? regionId} and linked ${props.contextFile} on branch ${created.branchName}.${pullNote}`,
-        });
-        return;
-    }
-    // orgId is set but no project info — list projects to choose from. A pending
-    // --branch can't be applied until a project is chosen, so it's surfaced in
-    // the instruction rather than silently dropped.
-    const projects = await listAllProjects(props, orgId);
-    const branchNote = branch
-        ? ` A branch was requested (--branch ${branch}) but a branch can only be pinned once a project is chosen — re-run with --project-id first, then \`${getCliName()} checkout ${branch}\`.`
-        : "";
-    emitAgent({
-        status: "needs_project",
-        instruction: (projects.length === 0
-            ? `Organization ${orgId} has no projects yet. Ask the user for a name for the new project, then re-run the create_option.next_command_template.`
-            : `Ask the user whether to link to one of these ${projects.length} existing projects (use next_command_template with --project-id) or create a new project (use create_option.next_command_template).`) +
-            branchNote,
-        options: projects.map((project) => ({
-            id: project.id,
-            name: project.name,
-            region_id: project.region_id,
-        })),
-        create_option: {
-            instruction: "To create a new project, ask the user for a project name. The region can be omitted to receive a follow-up needs_project_details response that lists available regions.",
-            next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-name <name> --region-id <region_id>`,
-        },
-        next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-id <project_id>`,
-    });
+	const { projectId, projectName, regionId, branch } = inputs;
+	const existing = readContextFile(props.contextFile);
+	if (projectId) {
+		const orgId = await resolveOrgForProject(props, inputs, existing, projectId);
+		const pinnedBranch = await resolvePinnedBranch(props, inputs, existing, projectId);
+		applyContext(props.contextFile, {
+			orgId,
+			projectId,
+			branch: pinnedBranch
+		});
+		const orgSuffix = orgId ? ` (org ${orgId})` : "";
+		if (pinnedBranch) {
+			const pullNote = renderAgentPullNote(await autoPullEnvAfterPin({
+				...props,
+				projectId,
+				branch: pinnedBranch,
+				envPull: props.envPull
+			}));
+			emitAgent({
+				status: "linked",
+				context_file: props.contextFile,
+				context: {
+					orgId,
+					projectId,
+					branch: pinnedBranch
+				},
+				project: { id: projectId },
+				message: `Linked ${props.contextFile} to project ${projectId}${orgSuffix} on branch ${pinnedBranch}.${pullNote}`
+			});
+			return;
+		}
+		emitAgent({
+			status: "linked",
+			context_file: props.contextFile,
+			context: {
+				orgId,
+				projectId
+			},
+			project: { id: projectId },
+			message: `Linked ${props.contextFile} to project ${projectId}${orgSuffix}. No branch pinned — run \`${getCliName()} checkout <branch>\` (omit the branch to list options) to pin one and pull its env vars.`
+		});
+		return;
+	}
+	const orgResolution = await resolveOrg(props, inputs.orgId);
+	if (orgResolution.kind === "needs_selection") {
+		emitAgent(buildNeedsOrgResponse(orgResolution));
+		return;
+	}
+	const orgId = orgResolution.orgId;
+	if (projectName && !regionId) {
+		const regions = await fetchRegions(props);
+		emitAgent({
+			status: "needs_project_details",
+			instruction: `Ask the user which region to create project "${projectName}" in. After they pick one, re-run the next_command_template with the chosen --region-id value.`,
+			regions: regions.map((region) => ({
+				id: region.region_id,
+				name: region.name,
+				default: region.default
+			})),
+			next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-name ${shellArg(projectName)} --region-id <region_id>`
+		});
+		return;
+	}
+	if (projectName && regionId) {
+		await verifyOrgAccess(props, orgId);
+		const created = await createProject(props, {
+			orgId,
+			name: projectName,
+			regionId
+		});
+		applyContext(props.contextFile, {
+			orgId,
+			projectId: created.project.id,
+			branch: created.branchName
+		});
+		const pullNote = renderAgentPullNote(await autoPullEnvAfterPin({
+			...props,
+			projectId: created.project.id,
+			branch: created.branchName,
+			envPull: props.envPull
+		}));
+		emitAgent({
+			status: "linked",
+			context_file: props.contextFile,
+			context: {
+				orgId,
+				projectId: created.project.id,
+				branch: created.branchName
+			},
+			project: {
+				id: created.project.id,
+				name: created.project.name,
+				region_id: created.project.region_id
+			},
+			message: `Created project ${created.project.id} ("${created.project.name ?? projectName}") in ${created.project.region_id ?? regionId} and linked ${props.contextFile} on branch ${created.branchName}.${pullNote}`
+		});
+		return;
+	}
+	const projects = await listAllProjects(props, orgId);
+	const branchNote = branch ? ` A branch was requested (--branch ${branch}) but a branch can only be pinned once a project is chosen — re-run with --project-id first, then \`${getCliName()} checkout ${branch}\`.` : "";
+	emitAgent({
+		status: "needs_project",
+		instruction: (projects.length === 0 ? `Organization ${orgId} has no projects yet. Ask the user for a name for the new project, then re-run the create_option.next_command_template.` : `Ask the user whether to link to one of these ${projects.length} existing projects (use next_command_template with --project-id) or create a new project (use create_option.next_command_template).`) + branchNote,
+		options: projects.map((project) => ({
+			id: project.id,
+			name: project.name,
+			region_id: project.region_id
+		})),
+		create_option: {
+			instruction: "To create a new project, ask the user for a project name. The region can be omitted to receive a follow-up needs_project_details response that lists available regions.",
+			next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-name <name> --region-id <region_id>`
+		},
+		next_command_template: `${getCliName()} link --agent --org-id ${shellArg(orgId)} --project-id <project_id>`
+	});
 };
 const emitAgent = (response) => {
-    process.stdout.write(`${JSON.stringify(response, null, 2)}\n`);
+	process.stdout.write(`${JSON.stringify(response, null, 2)}\n`);
 };
-// ----------------------------------------------------------------------------
-// API helpers
-// ----------------------------------------------------------------------------
 const ORG_KEY_LIMITED_FRAGMENT = "not allowed for organization API keys";
 const isOrgKeyLimitedError = (err) => {
-    if (!isNeonApiError(err))
-        return false;
-    const message = messageFromBody(err.data);
-    return (typeof message === "string" &&
-        message.includes(ORG_KEY_LIMITED_FRAGMENT));
+	if (!isNeonApiError(err)) return false;
+	const message = messageFromBody(err.data);
+	return typeof message === "string" && message.includes(ORG_KEY_LIMITED_FRAGMENT);
 };
 const fetchOrganizations = async (props) => {
-    const { data } = await props.apiClient.getCurrentUserOrganizations();
-    return data.organizations ?? [];
+	const { data } = await props.apiClient.getCurrentUserOrganizations();
+	return data.organizations ?? [];
 };
 /**
- * Resolves the org id from the explicit flag, falling back to listing user orgs.
- *
- * For organization-scoped API keys, `getCurrentUserOrganizations` is forbidden;
- * in that case we try to auto-detect the org from the first existing project
- * (since all projects of an org key live in the same org). If no project exists
- * yet, we return `needs_selection` with `orgKeyLimited: true` so callers can
- * give a precise instruction to the user.
- */
+* Resolves the org id from the explicit flag, falling back to listing user orgs.
+*
+* For organization-scoped API keys, `getCurrentUserOrganizations` is forbidden;
+* in that case we try to auto-detect the org from the first existing project
+* (since all projects of an org key live in the same org). If no project exists
+* yet, we return `needs_selection` with `orgKeyLimited: true` so callers can
+* give a precise instruction to the user.
+*/
 const resolveOrg = async (props, given) => {
-    if (given) {
-        return { kind: "resolved", orgId: given, autoDetected: false };
-    }
-    try {
-        const orgs = await fetchOrganizations(props);
-        return { kind: "needs_selection", orgs, orgKeyLimited: false };
-    }
-    catch (err) {
-        if (!isOrgKeyLimitedError(err)) {
-            throw err;
-        }
-        log.debug("getCurrentUserOrganizations not allowed (org-scoped API key); attempting to derive org from existing projects.");
-    }
-    const detected = await detectOrgIdFromProjects(props);
-    if (detected) {
-        return { kind: "resolved", orgId: detected, autoDetected: true };
-    }
-    return { kind: "needs_selection", orgs: [], orgKeyLimited: true };
+	if (given) return {
+		kind: "resolved",
+		orgId: given,
+		autoDetected: false
+	};
+	try {
+		return {
+			kind: "needs_selection",
+			orgs: await fetchOrganizations(props),
+			orgKeyLimited: false
+		};
+	} catch (err) {
+		if (!isOrgKeyLimitedError(err)) throw err;
+		log.debug("getCurrentUserOrganizations not allowed (org-scoped API key); attempting to derive org from existing projects.");
+	}
+	const detected = await detectOrgIdFromProjects(props);
+	if (detected) return {
+		kind: "resolved",
+		orgId: detected,
+		autoDetected: true
+	};
+	return {
+		kind: "needs_selection",
+		orgs: [],
+		orgKeyLimited: true
+	};
 };
 const detectOrgIdFromProjects = async (props) => {
-    try {
-        const { data } = await props.apiClient.listProjects({ limit: 1 });
-        return data.projects[0]?.org_id ?? undefined;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        log.debug("detectOrgIdFromProjects failed: %s", message);
-        return undefined;
-    }
+	try {
+		const { data } = await props.apiClient.listProjects({ limit: 1 });
+		return data.projects[0]?.org_id ?? void 0;
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		log.debug("detectOrgIdFromProjects failed: %s", message);
+		return;
+	}
 };
 const buildNeedsOrgResponse = (resolution) => {
-    if (resolution.orgKeyLimited) {
-        return {
-            status: "needs_org",
-            instruction: "This Neon API key is organization-scoped, so the CLI cannot list the user's organizations and no existing project was found to auto-detect the org ID. Ask the user for their Neon organization ID (visible in the Neon Console under the org's Settings page, formatted like `org-bitter-breeze-12345678`) and re-run the next_command_template with that --org-id.",
-            options: [],
-            next_command_template: `${getCliName()} link --agent --org-id <org_id>`,
-        };
-    }
-    const orgs = resolution.orgs;
-    return {
-        status: "needs_org",
-        instruction: orgs.length === 0
-            ? "The user does not belong to any organizations. Ask them to create one in the Neon Console (https://console.neon.tech/) before linking."
-            : `Ask the user which of these ${orgs.length} organization${orgs.length === 1 ? "" : "s"} they want to link the current directory to. After they pick one, re-run the next_command_template with the chosen --org-id value.`,
-        options: orgs.map((org) => ({ id: org.id, name: org.name })),
-        next_command_template: `${getCliName()} link --agent --org-id <org_id>`,
-    };
+	if (resolution.orgKeyLimited) return {
+		status: "needs_org",
+		instruction: "This Neon API key is organization-scoped, so the CLI cannot list the user's organizations and no existing project was found to auto-detect the org ID. Ask the user for their Neon organization ID (visible in the Neon Console under the org's Settings page, formatted like `org-bitter-breeze-12345678`) and re-run the next_command_template with that --org-id.",
+		options: [],
+		next_command_template: `${getCliName()} link --agent --org-id <org_id>`
+	};
+	const orgs = resolution.orgs;
+	return {
+		status: "needs_org",
+		instruction: orgs.length === 0 ? "The user does not belong to any organizations. Ask them to create one in the Neon Console (https://console.neon.tech/) before linking." : `Ask the user which of these ${orgs.length} organization${orgs.length === 1 ? "" : "s"} they want to link the current directory to. After they pick one, re-run the next_command_template with the chosen --org-id value.`,
+		options: orgs.map((org) => ({
+			id: org.id,
+			name: org.name
+		})),
+		next_command_template: `${getCliName()} link --agent --org-id <org_id>`
+	};
 };
 const toAgentError = (err) => {
-    if (err instanceof LinkInputError) {
-        return { status: "error", code: err.agentCode, message: err.message };
-    }
-    if (isNeonApiError(err)) {
-        const status = err.status;
-        const apiMessage = messageFromBody(err.data);
-        const message = apiMessage !== undefined && apiMessage.length > 0
-            ? apiMessage
-            : err.message;
-        let code = "API_ERROR";
-        if (status === 401 || status === 403) {
-            code = "AUTH_ERROR";
-        }
-        else if (status !== undefined && status >= 400 && status < 500) {
-            code = "CLIENT_ERROR";
-        }
-        else if (status !== undefined && status >= 500) {
-            code = "SERVER_ERROR";
-        }
-        else if (err.code === "ECONNABORTED") {
-            code = "TIMEOUT";
-        }
-        return { status: "error", code, message };
-    }
-    if (err instanceof Error) {
-        return {
-            status: "error",
-            code: "INTERNAL_ERROR",
-            message: err.message,
-        };
-    }
-    return {
-        status: "error",
-        code: "INTERNAL_ERROR",
-        message: String(err),
-    };
+	if (err instanceof LinkInputError) return {
+		status: "error",
+		code: err.agentCode,
+		message: err.message
+	};
+	if (isNeonApiError(err)) {
+		const status = err.status;
+		const apiMessage = messageFromBody(err.data);
+		const message = apiMessage !== void 0 && apiMessage.length > 0 ? apiMessage : err.message;
+		let code = "API_ERROR";
+		if (status === 401 || status === 403) code = "AUTH_ERROR";
+		else if (status !== void 0 && status >= 400 && status < 500) code = "CLIENT_ERROR";
+		else if (status !== void 0 && status >= 500) code = "SERVER_ERROR";
+		else if (err.code === "ECONNABORTED") code = "TIMEOUT";
+		return {
+			status: "error",
+			code,
+			message
+		};
+	}
+	if (err instanceof Error) return {
+		status: "error",
+		code: "INTERNAL_ERROR",
+		message: err.message
+	};
+	return {
+		status: "error",
+		code: "INTERNAL_ERROR",
+		message: String(err)
+	};
 };
 const listAllProjects = async (props, orgId) => {
-    const result = [];
-    let cursor;
-    while (true) {
-        const { data } = await props.apiClient.listProjects({
-            limit: PROJECTS_LIST_LIMIT,
-            org_id: orgId,
-            cursor,
-        });
-        result.push(...data.projects);
-        cursor = data.pagination?.cursor;
-        if (data.projects.length < PROJECTS_LIST_LIMIT) {
-            break;
-        }
-    }
-    return result;
+	const result = [];
+	let cursor;
+	while (true) {
+		const { data } = await props.apiClient.listProjects({
+			limit: PROJECTS_LIST_LIMIT,
+			org_id: orgId,
+			cursor
+		});
+		result.push(...data.projects);
+		cursor = data.pagination?.cursor;
+		if (data.projects.length < PROJECTS_LIST_LIMIT) break;
+	}
+	return result;
 };
 /**
- * Resolve which branch to pin for an interactively-chosen project, returned as the value to
- * persist (its name when known, see {@link branchPersistValue}). When the project has a
- * single branch there is nothing to choose, so we pin it silently. Otherwise we offer the
- * shared branch picker (the same "＋ Create a new branch…" + list as `neonctl checkout`),
- * creating the branch when the user opts to. This makes interactive `link` a full org →
- * project → branch flow; non-interactive `link` instead defers the branch to `checkout`.
- */
+* Resolve which branch to pin for an interactively-chosen project, returned as the value to
+* persist (its name when known, see {@link branchPersistValue}). When the project has a
+* single branch there is nothing to choose, so we pin it silently. Otherwise we offer the
+* shared branch picker (the same "＋ Create a new branch…" + list as `neonctl checkout`),
+* creating the branch when the user opts to. This makes interactive `link` a full org →
+* project → branch flow; non-interactive `link` instead defers the branch to `checkout`.
+*/
 const resolveInteractiveBranch = async (props, projectId) => {
-    const { data } = await props.apiClient.listProjectBranches({ projectId });
-    const branches = data.branches;
-    if (branches.length <= 1) {
-        const only = branches.find((b) => b.default) ?? branches[0];
-        if (!only) {
-            throw new Error(`Could not find a default branch for project ${projectId}.`);
-        }
-        return branchPersistValue(only);
-    }
-    const picked = await pickBranchInteractively(branches, {
-        message: "Which branch would you like to link?",
-        nonInteractiveMessage: "No branch could be selected without an interactive terminal. " +
-            `Re-run \`${getCliName()} link\` interactively, or \`${getCliName()} checkout <branch>\` to pin one.`,
-    });
-    if (picked.kind === "existing") {
-        const existing = branches.find((b) => b.id === picked.branchId);
-        return existing ? branchPersistValue(existing) : picked.branchId;
-    }
-    // A freshly-created branch: we already know the name the user typed.
-    await createBranch(props.apiClient, projectId, picked.name, branches);
-    return picked.name;
+	const { data } = await props.apiClient.listProjectBranches({ projectId });
+	const branches = data.branches;
+	if (branches.length <= 1) {
+		const only = branches.find((b) => b.default) ?? branches[0];
+		if (!only) throw new Error(`Could not find a default branch for project ${projectId}.`);
+		return branchPersistValue(only);
+	}
+	const picked = await pickBranchInteractively(branches, {
+		message: "Which branch would you like to link?",
+		nonInteractiveMessage: `No branch could be selected without an interactive terminal. Re-run \`${getCliName()} link\` interactively, or \`${getCliName()} checkout <branch>\` to pin one.`
+	});
+	if (picked.kind === "existing") {
+		const existing = branches.find((b) => b.id === picked.branchId);
+		return existing ? branchPersistValue(existing) : picked.branchId;
+	}
+	await createBranch(props.apiClient, projectId, picked.name, branches);
+	return picked.name;
 };
 const fetchRegions = async (props) => {
-    try {
-        const { data } = await props.apiClient.getActiveRegions();
-        if (data.regions && data.regions.length > 0) {
-            return data.regions;
-        }
-    }
-    catch (err) {
-        if (isNeonApiError(err)) {
-            log.debug("getActiveRegions failed (%s), falling back to the static region list.", err.status ?? err.code ?? err.message);
-        }
-        else {
-            const message = err instanceof Error ? err.message : String(err);
-            log.debug("getActiveRegions failed (%s), falling back to the static region list.", message);
-        }
-    }
-    return staticRegionsFallback();
+	try {
+		const { data } = await props.apiClient.getActiveRegions();
+		if (data.regions && data.regions.length > 0) return data.regions;
+	} catch (err) {
+		if (isNeonApiError(err)) log.debug("getActiveRegions failed (%s), falling back to the static region list.", err.status ?? err.code ?? err.message);
+		else {
+			const message = err instanceof Error ? err.message : String(err);
+			log.debug("getActiveRegions failed (%s), falling back to the static region list.", message);
+		}
+	}
+	return staticRegionsFallback();
 };
 const staticRegionsFallback = () => REGIONS.map((id) => ({
-    region_id: id,
-    name: id,
-    default: id === "aws-us-east-2",
-    geo_lat: "",
-    geo_long: "",
+	region_id: id,
+	name: id,
+	default: id === "aws-us-east-2",
+	geo_lat: "",
+	geo_long: ""
 }));
 const createProject = async (props, args) => {
-    const project = {
-        name: args.name,
-        region_id: args.regionId,
-        org_id: args.orgId,
-        branch: {},
-    };
-    const { data } = await props.apiClient.createProject({ project });
-    if (!data.branch?.id) {
-        throw new Error("Project was created but the API response did not include a default branch id.");
-    }
-    return {
-        project: {
-            id: data.project.id,
-            name: data.project.name,
-            region_id: data.project.region_id,
-        },
-        branchId: data.branch.id,
-        branchName: data.branch.name ?? data.branch.id,
-    };
+	const project = {
+		name: args.name,
+		region_id: args.regionId,
+		org_id: args.orgId,
+		branch: {}
+	};
+	const { data } = await props.apiClient.createProject({ project });
+	if (!data.branch?.id) throw new Error("Project was created but the API response did not include a default branch id.");
+	return {
+		project: {
+			id: data.project.id,
+			name: data.project.name,
+			region_id: data.project.region_id
+		},
+		branchId: data.branch.id,
+		branchName: data.branch.name ?? data.branch.id
+	};
 };
 const printSummary = (_props, summary) => {
-    const lines = [];
-    if (summary.created) {
-        lines.push(`Created project ${summary.projectId}${summary.projectName ? ` ("${summary.projectName}")` : ""}${summary.regionId ? ` in ${summary.regionId}` : ""}.`);
-    }
-    lines.push(`${summary.orgOnly ? "Updated" : "Linked"} ${summary.contextFile}:`);
-    if (summary.orgId) {
-        lines.push(`  orgId:     ${summary.orgId}`);
-    }
-    if (summary.projectId) {
-        lines.push(`  projectId: ${summary.projectId}`);
-    }
-    if (summary.branch) {
-        lines.push(`  branch:    ${summary.branch}`);
-    }
-    if (summary.noChecks) {
-        lines.push("");
-        lines.push("Written offline (--no-checks): nothing was verified.");
-    }
-    else if (summary.projectId && !summary.branch && !summary.orgOnly) {
-        lines.push("");
-        lines.push(`No branch pinned. Run \`${getCliName()} checkout <branch>\` to pin a branch and pull its env vars.`);
-    }
-    lines.push("");
-    process.stdout.write(`${lines.join("\n")}\n`);
+	const lines = [];
+	if (summary.created) lines.push(`Created project ${summary.projectId}${summary.projectName ? ` ("${summary.projectName}")` : ""}${summary.regionId ? ` in ${summary.regionId}` : ""}.`);
+	lines.push(`${summary.orgOnly ? "Updated" : "Linked"} ${summary.contextFile}:`);
+	if (summary.orgId) lines.push(`  orgId:     ${summary.orgId}`);
+	if (summary.projectId) lines.push(`  projectId: ${summary.projectId}`);
+	if (summary.branch) lines.push(`  branch:    ${summary.branch}`);
+	if (summary.noChecks) {
+		lines.push("");
+		lines.push("Written offline (--no-checks): nothing was verified.");
+	} else if (summary.projectId && !summary.branch && !summary.orgOnly) {
+		lines.push("");
+		lines.push(`No branch pinned. Run \`${getCliName()} checkout <branch>\` to pin a branch and pull its env vars.`);
+	}
+	lines.push("");
+	process.stdout.write(`${lines.join("\n")}\n`);
 };
 /**
- * Print the link summary, then run the bundled `env pull` so a human `link` that pinned a
- * branch ends with the branch's connection string already on disk. When no branch was pinned
- * there is nothing to pull, so env pull is skipped and the summary nudges `checkout` instead.
- * `--no-env-pull` opts out (env pull's own status / skip hint is logged to stderr).
- */
+* Print the link summary, then run the bundled `env pull` so a human `link` that pinned a
+* branch ends with the branch's connection string already on disk. When no branch was pinned
+* there is nothing to pull, so env pull is skipped and the summary nudges `checkout` instead.
+* `--no-env-pull` opts out (env pull's own status / skip hint is logged to stderr).
+*/
 const finalizeLink = async (props, summary) => {
-    printSummary(props, summary);
-    if (!summary.branch || !summary.projectId) {
-        return;
-    }
-    await autoPullEnvAfterPin({
-        ...props,
-        projectId: summary.projectId,
-        branch: summary.branch,
-        envPull: props.envPull,
-    });
+	printSummary(props, summary);
+	if (!summary.branch || !summary.projectId) return;
+	await autoPullEnvAfterPin({
+		...props,
+		projectId: summary.projectId,
+		branch: summary.branch,
+		envPull: props.envPull
+	});
 };
 /**
- * Interactive `link` finalize: the shared {@link finalizeLink} (summary + env
- * pull), then — as the last step — offer to manage the project's Neon setup as
- * code with a `neon.ts`. Kept out of {@link finalizeLink} so the non-interactive
- * paths never prompt.
- */
+* Interactive `link` finalize: the shared {@link finalizeLink} (summary + env
+* pull), then — as the last step — offer to manage the project's Neon setup as
+* code with a `neon.ts`. Kept out of {@link finalizeLink} so the non-interactive
+* paths never prompt.
+*/
 const finalizeInteractiveLink = async (props, summary) => {
-    await finalizeLink(props, summary);
-    await maybeOfferConfigInit(props, summary);
+	await finalizeLink(props, summary);
+	await maybeOfferConfigInit(props, summary);
 };
 /**
- * Offer to set up infrastructure-as-code at the end of an interactive `link` —
- * the natural moment, since the project is now linked. Skipped when the project
- * already has a `neon.ts` (nothing to scaffold). On yes, `config init` writes the
- * starter `neon.ts` and installs the config packages, then env is pulled again so
- * the local `.env` reflects the policy — the same pull `link` runs when a project
- * already ships a `neon.ts`.
- */
+* Offer to set up infrastructure-as-code at the end of an interactive `link` —
+* the natural moment, since the project is now linked. Skipped when the project
+* already has a `neon.ts` (nothing to scaffold). On yes, `config init` writes the
+* starter `neon.ts` and installs the config packages, then env is pulled again so
+* the local `.env` reflects the policy — the same pull `link` runs when a project
+* already ships a `neon.ts`.
+*/
 const maybeOfferConfigInit = async (props, summary) => {
-    const cwd = process.cwd();
-    if (hasNeonConfigFile(cwd)) {
-        return;
-    }
-    const { value } = await prompts({
-        onState: onPromptState,
-        type: "confirm",
-        name: "value",
-        message: "Manage this project's Neon setup as code? Adds a neon.ts you can edit and apply with `neon config apply`.",
-        initial: true,
-    });
-    if (value !== true) {
-        return;
-    }
-    await initCmd({ cwd, install: true });
-    // The neon.ts (and its deps) now exist — pull env again so the local .env
-    // reflects the policy, matching how `link` pulls when a project already ships
-    // a neon.ts. Only meaningful when a branch was pinned (same guard as finalize).
-    if (summary.branch && summary.projectId) {
-        await autoPullEnvAfterPin({
-            ...props,
-            projectId: summary.projectId,
-            branch: summary.branch,
-            envPull: props.envPull,
-        });
-    }
+	const cwd = process.cwd();
+	if (hasNeonConfigFile(cwd)) return;
+	const { value } = await prompts({
+		onState: onPromptState,
+		type: "confirm",
+		name: "value",
+		message: "Manage this project's Neon setup as code? Adds a neon.ts you can edit and apply with `neon config apply`.",
+		initial: true
+	});
+	if (value !== true) return;
+	await initCmd({
+		cwd,
+		install: true
+	});
+	if (summary.branch && summary.projectId) await autoPullEnvAfterPin({
+		...props,
+		projectId: summary.projectId,
+		branch: summary.branch,
+		envPull: props.envPull
+	});
 };
 const onPromptState = (state) => {
-    if (state.aborted) {
-        process.stdout.write("\x1B[?25h");
-        process.stdout.write("\n");
-        process.exit(1);
-    }
+	if (state.aborted) {
+		process.stdout.write("\x1B[?25h");
+		process.stdout.write("\n");
+		process.exit(1);
+	}
 };
 const shellArg = (value) => {
-    if (/^[A-Za-z0-9._:/-]+$/.test(value)) {
-        return value;
-    }
-    return `'${value.replace(/'/g, `'\\''`)}'`;
+	if (/^[A-Za-z0-9._:/-]+$/.test(value)) return value;
+	return `'${value.replace(/'/g, `'\\''`)}'`;
 };
 const mustString = (value, name) => {
-    if (value === undefined) {
-        throw new Error(`Internal error: expected ${name} to be set.`);
-    }
-    return value;
+	if (value === void 0) throw new Error(`Internal error: expected ${name} to be set.`);
+	return value;
 };
+//#endregion
+export { builder, command, describe, handler, link_exports };