neon 4.15.0 → 4.17.0

package/dist/commands/init.js

@@ -1,14 +1,22 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { readContextFile } from "../context.js";
+import { log } from "../log.js";
+import { contextBranch, readContextFile } from "../context.js";
 import { getCliName } from "../utils/cli_name.js";
+import { deprecatedServiceMessage, parseServices, servicesFlagValue, servicesOption } from "../neon_services.js";
+import { CONFIG_INIT_NONE_MEANS, CONFIG_INIT_SERVICES, CONFIG_INIT_UNAVAILABLE } from "../config_template.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
+import { fetchTemplates } from "../init/bootstrap.js";
 import { initChildEnv, spawnCliChild } from "../init/child.js";
-import { agentSetupLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
+import { agentSetupLabel, configSummaryLabel, formatInitDone, printInitBanner, printInitDone, shouldPrintInitBanner } from "../init/chrome.js";
 import { coerceAgentFlag } from "../utils/agent_flag.js";
-import { INIT_NEEDS_YES_OR_TERMINAL, assertNamedAgentTooling, bootstrapInitStep, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, planExistingInit, resolveNamedAgents } from "../init/plan.js";
+import { INIT_NEEDS_YES_OR_TERMINAL, assertNamedAgentTooling, directoryIsEmpty, initPluginAgents, initSkillsMcpAgents, linkInputArgv, planExistingInit, resolveNamedAgents } from "../init/plan.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { pickInitConfigInteractively, pickInitTemplateInteractively } from "../init/wizard.js";
 import { runAgentTooling, runInitSteps } from "../init/tooling.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
+import { handler as handler$1 } from "./bootstrap.js";
+import { hasNeonConfigFile } from "./config.js";
+import { INIT_CONFIG_SERVICES_CONFLICT, INIT_TEMPLATE_KEEPS_CONFIG, configPlanFromResolution, resolveInitConfigChoice, resolveInitTemplateChoice, shouldRefreshEnvAfterNewConfig } from "../init/choices.js";
 import { existsSync, readdirSync } from "node:fs";
 import { resolve } from "node:path";
 //#region src/commands/init.ts
@@ -20,13 +28,45 @@ var init_exports = /* @__PURE__ */ __exportAll({
 	initChildEnv: () => initChildEnv
 });
 const command = "init";
-const describe = "Set up this directory for Neon: agent tooling, a linked project, and neon.ts. In an empty directory, scaffolds a template first. Skills needs Node.js 22.20 or newer.";
+const describe = "Set up this directory for Neon: agent tooling, a linked project, and optionally neon.ts. In an empty directory, pick a template or skip scaffolding.";
 const removedProtocol = () => `\`${getCliName()} init --data\` was removed. Run \`${getCliName()} init\` or \`${getCliName()} init -y\`.`;
 const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file", { hidden: true }).option("yes", {
 	alias: "y",
 	type: "boolean",
 	default: false,
-	describe: "Empty dir: bootstrap --default. Otherwise plugin, or skills and MCP, for project folders, else the host CLI agent. Exits if none. Then link --yes and config init --services none. link --yes still asks for a project unless one is already linked"
+	describe: "Empty dir: scaffold the default template. --skip-template: plugin, or skills and MCP, for project folders, else the host CLI agent. Exits if none. Then link --yes and config init --services none. link --yes still asks for a project unless one is already linked"
+}).option("skip-template", {
+	type: "boolean",
+	default: false,
+	describe: "Do not scaffold a template. Set up agents, link a project, and optionally neon.ts in this directory"
+}).option("template", {
+	type: "string",
+	describe: "Template to scaffold into an empty directory. Conflicts with --skip-template"
+}).option("config", {
+	type: "boolean",
+	describe: "Existing app or --skip-template: create neon.ts after linking. Use --no-config to skip. Omitted in a terminal: you will be asked. Scaffolding a template keeps that template's neon.ts"
+}).option("services", servicesOption({
+	key: "services",
+	allowed: CONFIG_INIT_SERVICES,
+	describe: "Existing app or --skip-template: services to declare in neon.ts",
+	noneMeans: CONFIG_INIT_NONE_MEANS,
+	also: "Implies creating neon.ts. Cannot be combined with --no-config. Ignored when scaffolding a template."
+})).option("org-id", {
+	describe: "Forwarded to link: organization ID to link to",
+	type: "string"
+}).option("project-id", {
+	describe: "Forwarded to link: existing project ID to link to",
+	type: "string"
+}).option("project-name", {
+	describe: "Forwarded to link: name for a new project",
+	type: "string"
+}).option("region-id", {
+	describe: "Forwarded to link: region for a new project",
+	type: "string"
+}).option("branch", {
+	alias: "branch-id",
+	describe: "Forwarded to link: branch name or ID to pin",
+	type: "string"
 }).option("agent", {
 	alias: "a",
 	type: "array",
@@ -40,7 +80,7 @@ const builder = (yargs) => yargs.usage("$0 init [options]").option("context-file
 	alias: "o",
 	hidden: true,
 	describe: "Not supported; the commands init runs print their own output"
-}).example("$0 init", "Empty dir: bootstrap (scaffold, agent tooling, link). Existing app: agent tooling, link, config init").example("$0 init -y", "Same steps, using each child's defaults").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "-y installs the plugin when Cursor, Claude Code, or Codex is in project folders, else the host CLI agent. Otherwise skills and MCP. If none are found, it exits: pass --agent <name>, run from a supported agent, or omit -y in a terminal to pick. Then link unless already linked. link --yes may still ask for a project.", "--agent / -a is forwarded to plugins, or to skills and mcp, not both. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()))).check((argv) => {
+}).example("$0 init", "Set up this directory (template picker if empty)").example("$0 init --skip-template", "Empty dir: agents, link, and neon.ts — no template files").example("$0 init -y", "Default template, or existing-app defaults").example("$0 init --agent cursor --agent claude-code", "Skip agent selection; install the plugin for those agents").epilogue(helpEpilogue("Empty directory: pick a starter template, or skip scaffolding and only set up agents, a Neon project, and neon.ts. That skip is not on `neon bootstrap`.", "Interactive agent setup: plugin (recommended), skills and MCP separately, or skip agent setup. Never both plugin and skills+MCP.", "neon.ts is optional when you skip the template or set up an existing app. Saying no skips the services picker and does not write the file. Scaffolding a template keeps that template's neon.ts.", "-y installs the plugin when Cursor, Claude Code, or Codex is in project folders, else the host CLI agent. Otherwise skills and MCP. If none are found, it exits: pass --agent <name>, run from a supported agent, or omit -y in a terminal to pick. Then link unless already linked. link --yes may still ask for a project.", "--agent / -a is forwarded to plugins, or to skills and mcp, not both. It skips agent selection, including with -y.", helpCsv("Plugin agents", initPluginAgents()), helpCsv("Skills and MCP agents", initSkillsMcpAgents()))).check((argv) => {
 	if (argv.data !== void 0) throw new Error(removedProtocol());
 	if (argv.help !== true && (argv.output === "json" || argv.output === "yaml")) throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
 	return true;
@@ -49,6 +89,90 @@ const isLinked = (contextFile) => {
 	const projectId = readContextFile(contextFile).projectId;
 	return typeof projectId === "string" && projectId.length > 0;
 };
+const nestedBootstrapDirectory = (cwd) => resolve(cwd) === resolve(process.cwd()) ? "." : cwd;
+const parsedInitServices = (raw) => {
+	const values = servicesFlagValue(raw);
+	if (values === void 0) return;
+	return parseServices(values, {
+		allowed: CONFIG_INIT_SERVICES,
+		whyUnavailable: CONFIG_INIT_UNAVAILABLE,
+		flag: "--services",
+		noneMeans: CONFIG_INIT_NONE_MEANS,
+		onDeprecated: (used, canonical) => log.warning(deprecatedServiceMessage(used, canonical))
+	});
+};
+const nestedBootstrapProps = (props, cwd, contextFile, template, linkExtra) => ({
+	apiClient: props.apiClient,
+	apiKey: props.apiKey,
+	apiHost: props.apiHost,
+	output: props.output,
+	contextFile,
+	directory: nestedBootstrapDirectory(cwd),
+	force: false,
+	listTemplates: false,
+	default: template.useDefault,
+	install: true,
+	git: true,
+	link: true,
+	printBanner: false,
+	skipDoneSummary: true,
+	linkNoConfig: true,
+	narrate: "human",
+	...template.selected ? { selectedTemplate: template.selected } : {},
+	...!template.selected && template.id !== void 0 ? { template: template.id } : {},
+	...linkExtra.length > 0 ? { linkExtra } : {},
+	...props.agent !== void 0 ? { agent: props.agent } : {},
+	...props.configDir ? { configDir: props.configDir } : {},
+	...props.profile ? { profile: props.profile } : {},
+	...props.analytics === false ? { analytics: false } : {},
+	...props.run ? { run: props.run } : {},
+	...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
+	...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
+	...props.detectAgent ? { detectAgent: props.detectAgent } : {},
+	...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
+});
+const projectRow = (input) => {
+	if (input.alreadyLinked) return "already linked";
+	if (input.linkedNow) return "linked";
+	return "not linked";
+};
+const configSummary = (input) => {
+	if (input.plan.kind === "skip") return "skipped";
+	if (input.existingConfig) return "existing";
+	return "created";
+};
+const printNestedBootstrapDone = (result, cwd, fallbackTitle) => {
+	const hasConfig = result?.hasNeonConfig === true || hasNeonConfigFile(cwd);
+	printInitDone(formatInitDone({
+		heading: "Neon setup complete.",
+		rows: [
+			{
+				label: "Template",
+				value: result?.templateTitle ?? fallbackTitle
+			},
+			{
+				label: "Agents",
+				value: agentSetupLabel(result?.agentSetup ?? "skip")
+			},
+			{
+				label: "Project",
+				value: projectRow({
+					alreadyLinked: false,
+					linkedNow: result?.linked === true
+				})
+			},
+			{
+				label: "Config",
+				value: configSummaryLabel(hasConfig ? "template" : "skipped")
+			}
+		],
+		next: []
+	}));
+};
+const noteTemplateKeepsShippedConfig = (config, services) => {
+	if (config === void 0 && services === void 0) return;
+	log.warning(INIT_TEMPLATE_KEEPS_CONFIG);
+};
 const handler = async (props) => {
 	if (props.output === "json" || props.output === "yaml") throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
 	const cwd = props.cwd ?? process.cwd();
@@ -67,43 +191,123 @@ const handler = async (props) => {
 		contextFile,
 		...props.analytics === false ? { analytics: false } : {}
 	};
-	if (directoryIsEmpty(names)) {
-		if (!yes && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
-		await runInitSteps([bootstrapInitStep(yes, named)], {
-			cwd,
-			run,
-			forward,
-			authEnv
-		});
+	const services = parsedInitServices(props.services);
+	if (props.config === false && services !== void 0) throw new Error(INIT_CONFIG_SERVICES_CONFLICT);
+	const linkExtra = linkInputArgv({
+		...props.orgId ? { orgId: props.orgId } : {},
+		...props.projectId ? { projectId: props.projectId } : {},
+		...props.projectName ? { projectName: props.projectName } : {},
+		...props.regionId ? { regionId: props.regionId } : {},
+		...props.branch ? { branch: props.branch } : {}
+	});
+	const templateChoice = resolveInitTemplateChoice({
+		empty: directoryIsEmpty(names),
+		yes,
+		skipTemplate: props.skipTemplate === true,
+		template: props.template
+	});
+	if (shouldPrintInitBanner(yes)) printInitBanner();
+	if (templateChoice.kind === "default" || templateChoice.kind === "template") {
+		if (templateChoice.kind === "template" && !yes && props.runBootstrap === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
+		const runBootstrap = props.runBootstrap ?? handler$1;
+		noteTemplateKeepsShippedConfig(props.config, services);
+		const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
+			useDefault: yes,
+			...templateChoice.kind === "template" ? { id: templateChoice.id } : {}
+		}, linkExtra));
+		printNestedBootstrapDone(result, cwd, templateChoice.kind === "template" ? templateChoice.id : "default");
 		return;
 	}
-	if (shouldPrintInitBanner(yes)) printInitBanner();
+	if (templateChoice.kind === "ask") {
+		if (props.pickTemplate === void 0 && !canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
+		const templates = await (props.fetchTemplates ?? fetchTemplates)();
+		const picked = await (props.pickTemplate ?? pickInitTemplateInteractively)(templates);
+		if (picked.kind === "template") {
+			const runBootstrap = props.runBootstrap ?? handler$1;
+			noteTemplateKeepsShippedConfig(props.config, services);
+			const result = await runBootstrap(nestedBootstrapProps(props, cwd, contextFile, {
+				selected: picked.template,
+				useDefault: false
+			}, linkExtra));
+			printNestedBootstrapDone(result, cwd, picked.template.id);
+			return;
+		}
+	}
 	const alreadyLinked = isLinked(contextFile);
+	const shouldLink = !alreadyLinked || linkExtra.length > 0;
+	const existingConfig = hasNeonConfigFile(cwd);
+	const canAskConfig = props.pickConfig !== void 0 || canPickAgentsInteractively();
 	const agentSetup = await runAgentTooling({
 		cwd,
 		yes,
 		run,
 		forward,
 		authEnv,
+		narrate: "human",
+		command: "init",
 		...named.length > 0 ? { agents: named } : {},
 		...props.pickAgentSetup ? { pickAgentSetup: props.pickAgentSetup } : {},
 		...props.detectProjectAgents ? { detectProjectAgents: props.detectProjectAgents } : {},
 		...props.detectAgent ? { detectAgent: props.detectAgent } : {},
-		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {},
-		command: "init"
+		...props.hasProjectPlugins ? { hasProjectPlugins: props.hasProjectPlugins } : {}
 	});
 	await runInitSteps(planExistingInit({
-		linked: alreadyLinked,
+		linked: !shouldLink,
 		yes,
-		agentSetup: "skip"
+		agentSetup: "skip",
+		config: { kind: "skip" },
+		...linkExtra.length > 0 ? { linkExtra } : {}
 	}), {
 		cwd,
 		run,
 		forward,
-		authEnv
+		authEnv,
+		narrate: "human"
+	});
+	const configResolution = resolveInitConfigChoice({
+		flag: props.config,
+		yes,
+		canAsk: canAskConfig,
+		existingConfig,
+		...services !== void 0 ? { services } : {}
 	});
+	const accepted = configResolution.kind === "ask" ? await (props.pickConfig ?? pickInitConfigInteractively)() : void 0;
+	const configPlan = configPlanFromResolution(configResolution, accepted);
+	if (configPlan.kind === "write") {
+		await runInitSteps(planExistingInit({
+			linked: true,
+			yes,
+			agentSetup: "skip",
+			config: configPlan
+		}), {
+			cwd,
+			run,
+			forward,
+			authEnv,
+			narrate: "human"
+		});
+		const context = readContextFile(contextFile);
+		const branch = contextBranch(context);
+		if (shouldRefreshEnvAfterNewConfig({
+			wroteNewFile: !existingConfig,
+			projectId: context.projectId,
+			branch
+		})) try {
+			await runInitSteps([["env", "pull"]], {
+				cwd,
+				run,
+				forward,
+				authEnv,
+				narrate: "human"
+			});
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			log.warning(`Created neon.ts, but pulling its Neon env vars failed: %s
+Run \`${getCliName()} env pull\` once resolved.`, message);
+		}
+	}
 	printInitDone(formatInitDone({
-		heading: "Configured this directory for Neon.",
+		heading: "Neon setup complete.",
 		rows: [
 			{
 				label: "Agents",
@@ -111,11 +315,17 @@ const handler = async (props) => {
 			},
 			{
 				label: "Project",
-				value: alreadyLinked ? "already linked" : "linked"
+				value: projectRow({
+					alreadyLinked,
+					linkedNow: shouldLink
+				})
 			},
 			{
 				label: "Config",
-				value: "neon.ts"
+				value: configSummaryLabel(configSummary({
+					plan: configPlan,
+					existingConfig
+				}))
 			}
 		],
 		next: []

package/dist/commands/link.js

@@ -15,7 +15,8 @@ var link_exports = /* @__PURE__ */ __exportAll({
 	builder: () => builder,
 	command: () => command,
 	describe: () => describe,
-	handler: () => handler
+	handler: () => handler,
+	shouldOfferConfigInit: () => shouldOfferConfigInit
 });
 const PROJECTS_LIST_LIMIT = 100;
 const CREATE_NEW_SENTINEL = "__create_new__";
@@ -79,6 +80,11 @@ const builder = (argv) => argv.usage("$0 link [options]").options({
 		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
+	},
+	config: {
+		describe: "Offer to create neon.ts after interactive linking. Use --no-config to skip the offer",
+		type: "boolean",
+		default: true
 	}
 }).example([
 	["$0 link --project-id polished-snowflake-12345678", "Link an existing project (org is inferred). Pins the only branch; several prompt in a TTY"],
@@ -725,8 +731,9 @@ const printSummary = (_props, summary) => {
 const finalizeLink = async (props, summary) => {
 	printSummary(props, summary);
 	if (!summary.branch || !summary.projectId) return;
+	const { config: _offerConfig, ...rest } = props;
 	await autoPullEnvAfterPin({
-		...props,
+		...rest,
 		projectId: summary.projectId,
 		branch: summary.branch,
 		envPull: props.envPull
@@ -743,16 +750,17 @@ const finalizeInteractiveLink = async (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`.
+* Interactive `link` offers neon.ts only when the directory has none and the
+* caller did not pass --no-config. Init always passes --no-config so it can ask
+* once after linking.
 */
+const shouldOfferConfigInit = (input) => !input.hasConfig && input.offer;
 const maybeOfferConfigInit = async (props, summary) => {
 	const cwd = process.cwd();
-	if (hasNeonConfigFile(cwd)) return;
+	if (!shouldOfferConfigInit({
+		hasConfig: hasNeonConfigFile(cwd),
+		offer: props.config !== false
+	})) return;
 	const { value } = await prompts({
 		onState: onPromptState,
 		type: "confirm",
@@ -765,12 +773,15 @@ const maybeOfferConfigInit = async (props, summary) => {
 		cwd,
 		install: true
 	});
-	if (summary.branch && summary.projectId) await autoPullEnvAfterPin({
-		...props,
-		projectId: summary.projectId,
-		branch: summary.branch,
-		envPull: props.envPull
-	});
+	if (summary.branch && summary.projectId) {
+		const { config: _offerConfig, ...rest } = props;
+		await autoPullEnvAfterPin({
+			...rest,
+			projectId: summary.projectId,
+			branch: summary.branch,
+			envPull: props.envPull
+		});
+	}
 };
 const onPromptState = (state) => {
 	if (state.aborted) {
@@ -784,4 +795,4 @@ const mustString = (value, name) => {
 	return value;
 };
 //#endregion
-export { builder, command, describe, handler, link_exports as t };
+export { builder, command, describe, handler, shouldOfferConfigInit, link_exports as t };

package/dist/commands/triggers.js

@@ -0,0 +1,182 @@
+import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
+import { log } from "../log.js";
+import { isNeonApiError, messageFromBody, retryOnLock } from "../api.js";
+import { writer } from "../writer.js";
+import { branchIdFromProps, fillSingleProject } from "../utils/enrichers.js";
+//#region src/commands/triggers.ts
+var triggers_exports = /* @__PURE__ */ __exportAll({
+	TRIGGER_FIELDS: () => TRIGGER_FIELDS,
+	aliases: () => aliases,
+	builder: () => builder,
+	command: () => command,
+	create: () => create,
+	deleteTrigger: () => deleteTrigger,
+	describe: () => describe,
+	get: () => get,
+	handler: () => handler,
+	list: () => list,
+	update: () => update
+});
+const TRIGGER_NOT_FOUND_MESSAGE = "function trigger not visible on branch";
+/** Translate the trigger-not-found 404 into a resource-specific message; re-throw everything else. */
+async function withTriggerNotFound(triggerId, branchId, run) {
+	try {
+		return await run();
+	} catch (err) {
+		if (isNeonApiError(err) && err.status === 404 && messageFromBody(err.data) === TRIGGER_NOT_FOUND_MESSAGE) throw new Error(`Trigger ${triggerId} not found on branch ${branchId}.`);
+		throw err;
+	}
+}
+const TRIGGER_FIELDS = [
+	"trigger_id",
+	"name",
+	"function_slug",
+	"function_path",
+	"schedule",
+	"enabled",
+	"inherited",
+	"next_run_at"
+];
+const renderColumns = { schedule: (t) => t.schedule?.cron ?? "" };
+const command = "triggers";
+const describe = "Manage function triggers";
+const aliases = ["trigger"];
+const builder = (argv) => argv.usage("$0 triggers <sub-command> [options]").options({
+	"project-id": {
+		describe: "Project ID",
+		type: "string"
+	},
+	branch: {
+		describe: "Branch ID or name",
+		type: "string"
+	}
+}).middleware(fillSingleProject).command("list", "List triggers on the branch", (yargs) => yargs, (args) => list(args)).command("get <id>", "Show a trigger", (yargs) => yargs.positional("id", {
+	describe: "Trigger ID",
+	type: "string"
+}), (args) => get(args)).command("create", "Create a trigger that invokes a function on a cron schedule", (yargs) => yargs.options({
+	"function-slug": {
+		describe: "Slug of the function to invoke",
+		type: "string",
+		demandOption: true
+	},
+	name: {
+		describe: "Trigger name (unique per branch)",
+		type: "string",
+		demandOption: true
+	},
+	cron: {
+		describe: "Five-field UTC cron expression, e.g. '*/15 * * * *'",
+		type: "string",
+		demandOption: true
+	},
+	"function-path": {
+		describe: "Path the invocation is sent to (default '/')",
+		type: "string"
+	},
+	enabled: {
+		describe: "Whether the trigger runs (default true)",
+		type: "boolean"
+	}
+}), (args) => create(args)).command("update <id>", "Update a trigger", (yargs) => yargs.positional("id", {
+	describe: "Trigger ID",
+	type: "string"
+}).options({
+	"function-slug": {
+		describe: "Slug of the function to invoke",
+		type: "string"
+	},
+	name: {
+		describe: "Trigger name (unique per branch)",
+		type: "string"
+	},
+	cron: {
+		describe: "Five-field UTC cron expression",
+		type: "string"
+	},
+	"function-path": {
+		describe: "Path the invocation is sent to",
+		type: "string"
+	},
+	enabled: {
+		describe: "Whether the trigger runs",
+		type: "boolean"
+	}
+}), (args) => update(args)).command("enable <id>", "Enable a trigger", (yargs) => yargs.positional("id", {
+	describe: "Trigger ID",
+	type: "string"
+}), (args) => setEnabled(args, true)).command("disable <id>", "Disable a trigger without deleting it", (yargs) => yargs.positional("id", {
+	describe: "Trigger ID",
+	type: "string"
+}), (args) => setEnabled(args, false)).command("delete <id>", "Delete a trigger", (yargs) => yargs.positional("id", {
+	describe: "Trigger ID",
+	type: "string"
+}), (args) => deleteTrigger(args));
+const handler = (args) => {
+	return args;
+};
+const list = async (props) => {
+	const branchId = await branchIdFromProps(props);
+	const { data } = await props.apiClient.listProjectBranchTriggers(props.projectId, branchId);
+	writer(props).end(data.triggers, {
+		fields: TRIGGER_FIELDS,
+		renderColumns,
+		emptyMessage: "No triggers found on this branch."
+	});
+};
+const get = async (props) => {
+	const branchId = await branchIdFromProps(props);
+	const { data } = await withTriggerNotFound(props.id, branchId, () => props.apiClient.getProjectBranchTrigger(props.projectId, branchId, props.id));
+	writer(props).end(data.trigger, {
+		fields: TRIGGER_FIELDS,
+		renderColumns
+	});
+};
+const create = async (props) => {
+	const branchId = await branchIdFromProps(props);
+	const body = {
+		type: "schedule",
+		function_slug: props["function-slug"],
+		name: props.name,
+		schedule: { cron: props.cron }
+	};
+	if (props["function-path"] !== void 0) body.function_path = props["function-path"];
+	if (props.enabled !== void 0) body.enabled = props.enabled;
+	const { data } = await retryOnLock(() => props.apiClient.createProjectBranchTrigger(props.projectId, branchId, body));
+	writer(props).end(data.trigger, {
+		fields: TRIGGER_FIELDS,
+		renderColumns
+	});
+};
+const update = async (props) => {
+	const branchId = await branchIdFromProps(props);
+	const body = { type: "schedule" };
+	if (props["function-slug"] !== void 0) body.function_slug = props["function-slug"];
+	if (props.name !== void 0) body.name = props.name;
+	if (props.cron !== void 0) body.schedule = { cron: props.cron };
+	if (props["function-path"] !== void 0) body.function_path = props["function-path"];
+	if (props.enabled !== void 0) body.enabled = props.enabled;
+	if (Object.keys(body).filter((k) => k !== "type").length === 0) throw new Error("No fields to update. Pass at least one of --function-slug, --name, --cron, --function-path, or --enabled.");
+	const { data } = await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.updateProjectBranchTrigger(props.projectId, branchId, props.id, body)));
+	writer(props).end(data.trigger, {
+		fields: TRIGGER_FIELDS,
+		renderColumns
+	});
+};
+const setEnabled = async (props, enabled) => {
+	const branchId = await branchIdFromProps(props);
+	const { data } = await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.updateProjectBranchTrigger(props.projectId, branchId, props.id, {
+		type: "schedule",
+		enabled
+	})));
+	writer(props).end(data.trigger, {
+		fields: TRIGGER_FIELDS,
+		renderColumns
+	});
+};
+const deleteTrigger = async (props) => {
+	const branchId = await branchIdFromProps(props);
+	await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.deleteProjectBranchTrigger(props.projectId, branchId, props.id)));
+	log.info(`Trigger ${props.id} deleted`);
+};
+//#endregion
+export { TRIGGER_FIELDS, aliases, builder, command, create, deleteTrigger, describe, get, handler, list, triggers_exports as t, update };

package/dist/context.js

@@ -137,6 +137,7 @@ const readContextFile = (file) => {
 };
 const enrichFromContext = (args) => {
 	if (args._[0] === "link" || args._[0] === "set-context") return;
+	if (args._[0] === "init") return;
 	if (isApiKeysCommand(args)) return;
 	if (isProfileCommand(args)) return;
 	if (isMcpCommand(args)) return;

package/dist/dev/env.js

@@ -1,2 +1,2 @@
-import { a as resolveDevEnv, i as dropClaimableUnsupported, n as MissingBranchContextError, o as resolveNeonEnvVars, r as ServiceNotOnBranchError, t as DevEnvMismatchError } from "../_chunks/env-DsakkOVZ.js";
+import { a as resolveDevEnv, i as dropClaimableUnsupported, n as MissingBranchContextError, o as resolveNeonEnvVars, r as ServiceNotOnBranchError, t as DevEnvMismatchError } from "../_chunks/env-B75xufe_.js";
 export { DevEnvMismatchError, MissingBranchContextError, ServiceNotOnBranchError, dropClaimableUnsupported, resolveDevEnv, resolveNeonEnvVars };

package/dist/env_services.js

@@ -1,2 +1,2 @@
-import { a as envKeysForSelection, c as ownedEnvServiceKeys, d as servicesForEnvKeys, i as ENV_PULL_SERVICES, l as parseEnvPullKeys, n as ENV_PULL_KEYS, o as envPullFlagValue, r as ENV_PULL_KEY_HELP, s as envServiceKeys, t as BRANCH_ENV_KEY, u as serviceForEnvKey } from "./_chunks/env_services-CAWrZTWa.js";
+import { a as envKeysForSelection, c as ownedEnvServiceKeys, d as servicesForEnvKeys, i as ENV_PULL_SERVICES, l as parseEnvPullKeys, n as ENV_PULL_KEYS, o as envPullFlagValue, r as ENV_PULL_KEY_HELP, s as envServiceKeys, t as BRANCH_ENV_KEY, u as serviceForEnvKey } from "./_chunks/env_services-CbARRnq9.js";
 export { BRANCH_ENV_KEY, ENV_PULL_KEYS, ENV_PULL_KEY_HELP, ENV_PULL_SERVICES, envKeysForSelection, envPullFlagValue, envServiceKeys, ownedEnvServiceKeys, parseEnvPullKeys, serviceForEnvKey, servicesForEnvKeys };

package/dist/init/child.js

@@ -3,7 +3,8 @@ import { spawn } from "node:child_process";
 const AUTH_CHILD = /* @__PURE__ */ new Set([
 	"bootstrap",
 	"link",
-	"mcp"
+	"mcp",
+	"env"
 ]);
 const initChildEnv = (command, overlay, base = process.env) => {
 	const child = { ...base };