eve 0.6.0-beta.9 → 0.7.2

package/dist/src/setup/onboarding.d.ts

@@ -1,6 +1,6 @@
 import type { Prompter } from "./prompter.js";
 import type { AnySetupBox } from "./runner.js";
-import type { ArgsHeadlessAiGateway, ArgsHeadlessProject, ChannelKind, ChatPreference, SetupState } from "./state.js";
+import type { ArgsHeadlessAiGateway, ArgsHeadlessProject, ChannelKind, ChatPreference, SetupMode, SetupState } from "./state.js";
 /**
  * Options for {@link composeOnboardingBoxes}. These carry exactly what the
  * create flow's options carried: the preset answers that let each box resolve
@@ -10,6 +10,8 @@ export interface OnboardingBoxesOptions {
     prompter: Prompter;
     /** Skip the name prompt and use this value. */
     presetName?: string;
+    /** Skip the setup-mode prompt and use this value. */
+    presetMode?: SetupMode;
     /** Skip the model prompt and use this value. */
     presetModel?: string;
     /** Skip the channels prompt and use these kinds. */
@@ -43,14 +45,15 @@ export interface OnboardingBoxesOptions {
     evePackageVersion: string;
 }
 /**
- * Composes the full onboarding flow shared by `create-eve` and `eve setup`:
+ * Composes the full programmatic onboarding flow.
  *
- * 1. Name + provisioning + model + channel prompts (the interview phase).
+ * 1. The interview phase: name, then the agent itself (model, channels,
+ *    connections), then where it runs (the provisioning plans).
  * 2. Input preflight before filesystem writes.
  * 3. The scaffold box writes or reuses the agent template.
  * 4. Project and gateway facts are detected and executed from the plans.
  * 5. Channel setup writes Web/Slack surfaces and returns setup facts.
- * 6. Deploy runs once when any deployable channel was added.
+ * 6. Deploy runs once when Slack was added (the connector needs a public URL).
  * 7. Chat preference is picked from the final channel state.
  */
 export declare function composeOnboardingBoxes(options: OnboardingBoxesOptions): AnySetupBox<SetupState>[];

package/dist/src/setup/onboarding.js

@@ -1 +1 @@
-import{addChannels}from"./boxes/add-channels.js";import{addConnections}from"./boxes/add-connections.js";import{detectAiGateway}from"./boxes/detect-ai-gateway.js";import{applyAiGatewayCredential}from"./boxes/apply-ai-gateway-credential.js";import{deployProject}from"./boxes/deploy-project.js";import{linkVercelProject}from"./boxes/link-project.js";import{preflight}from"./boxes/preflight.js";import{resolveProvisioning}from"./boxes/resolve-provisioning.js";import{resolveTarget}from"./boxes/resolve-target.js";import{scaffold}from"./boxes/scaffold.js";import{selectChannels}from"./boxes/select-channels.js";import{selectChat}from"./boxes/select-chat.js";import{selectModel}from"./boxes/select-model.js";import{resolve}from"node:path";function composeOnboardingBoxes(e){let t=e.headless?{headless:!0,project:e.provisioning?.project??{},aiGateway:e.provisioning?.aiGateway??{}}:{headless:!1};return[resolveTarget({prompter:e.prompter,presetName:e.presetName,targetDirectory:e.targetDirectory,inPlace:e.inPlace}),resolveProvisioning({prompter:e.prompter,targetDirectory:e.targetDirectory,mode:t}),selectModel({prompter:e.prompter,presetModel:e.presetModel}),selectChannels({prompter:e.prompter,presetChannels:e.presetChannels}),preflight({cwd:resolve(e.targetDirectory??process.cwd())}),scaffold({prompter:e.prompter,evePackageVersion:e.evePackageVersion,targetDirectory:e.targetDirectory,overwriteExisting:e.overwriteExisting}),detectAiGateway(),linkVercelProject({prompter:e.prompter}),applyAiGatewayCredential({prompter:e.prompter}),addChannels({prompter:e.prompter,evePackageVersion:e.evePackageVersion,presetCreateSlackbot:e.presetCreateSlackbot}),addConnections({prompter:e.prompter,presetConnections:e.presetConnections}),deployProject({prompter:e.prompter,skip:e.presetNoDeploy}),selectChat({prompter:e.prompter,presetPreference:e.presetChatPreference})]}export{composeOnboardingBoxes};
+import{headlessAsker,interactiveAsker}from"./ask.js";import{addChannels}from"./boxes/add-channels.js";import{selectConnections}from"./boxes/select-connections.js";import{addConnections}from"./boxes/add-connections.js";import{detectAiGateway}from"./boxes/detect-ai-gateway.js";import{applyAiGatewayCredential}from"./boxes/apply-ai-gateway-credential.js";import{deployProject}from"./boxes/deploy-project.js";import{linkVercelProject}from"./boxes/link-project.js";import{oneShotNextSteps}from"./boxes/one-shot-next-steps.js";import{preflight}from"./boxes/preflight.js";import{resolveProvisioning}from"./boxes/resolve-provisioning.js";import{resolveTarget}from"./boxes/resolve-target.js";import{scaffold}from"./boxes/scaffold.js";import{selectChannels}from"./boxes/select-channels.js";import{selectChat}from"./boxes/select-chat.js";import{selectModel}from"./boxes/select-model.js";import{selectSetupMode}from"./boxes/select-setup-mode.js";import{resolve}from"node:path";function onlyWhen(e,t){return{...t,shouldRun:n=>e(n)&&(t.shouldRun?.(n)??!0)}}function completeSetupOnly(e){return onlyWhen(e=>e.setupMode===`complete`,e)}function composeOnboardingBoxes(r){let i=r.headless?{headless:!0,project:r.provisioning?.project??{},aiGateway:r.provisioning?.aiGateway??{}}:{headless:!1},a=r.headless?headlessAsker():interactiveAsker(r.prompter);return[resolveTarget({asker:a,notify:e=>r.prompter.note(e),presetName:r.presetName,targetDirectory:r.targetDirectory,inPlace:r.inPlace,resumeExisting:r.headless}),selectSetupMode({asker:a,presetMode:r.presetMode,presetModel:r.presetModel}),...[selectModel({asker:a,presetModel:r.presetModel}),selectChannels({asker:a,presetChannels:r.presetChannels,variant:`onboarding`}),selectConnections({asker:a,presetConnections:r.presetConnections,headless:r.headless}),resolveProvisioning({asker:a,prompter:r.prompter,targetDirectory:r.targetDirectory,mode:i})].map(completeSetupOnly),preflight({cwd:resolve(r.targetDirectory??process.cwd()),headless:r.headless}),scaffold({prompter:r.prompter,evePackageVersion:r.evePackageVersion,targetDirectory:r.targetDirectory,overwriteExisting:r.overwriteExisting,headless:r.headless}),...[detectAiGateway(),linkVercelProject({prompter:r.prompter}),applyAiGatewayCredential({prompter:r.prompter}),addChannels({asker:a,prompter:r.prompter,evePackageVersion:r.evePackageVersion,presetCreateSlackbot:r.presetCreateSlackbot,headless:r.headless,slackbotFailure:`warn-and-continue`}),addConnections({prompter:r.prompter})].map(completeSetupOnly),completeSetupOnly(onlyWhen(e=>e.slackScaffolded,deployProject({prompter:r.prompter,skip:r.presetNoDeploy,headless:r.headless}))),completeSetupOnly(selectChat({asker:a,presetPreference:r.presetChatPreference})),oneShotNextSteps({prompter:r.prompter})]}export{composeOnboardingBoxes};

package/dist/src/setup/package-manager.d.ts

@@ -0,0 +1,27 @@
+export type PackageManagerKind = "bun" | "npm" | "pnpm" | "yarn";
+/** How a project's package manager was identified, most authoritative first. */
+export type PackageManagerSource = "package-manager-field" | "lockfile" | "default";
+export interface DetectedPackageManager {
+    kind: PackageManagerKind;
+    source: PackageManagerSource;
+}
+/**
+ * Resolves a project's package manager from gathered facts: an explicit
+ * `packageManager` field wins, then the first known lockfile, then pnpm.
+ */
+export declare function resolvePackageManager(input: {
+    packageManagerField?: string;
+    lockfiles: readonly string[];
+}): DetectedPackageManager;
+/**
+ * Identifies the package manager that launched the current process from an
+ * npm user-agent string. Every manager advertises itself there when running
+ * a binary (`npx`, `pnpm dlx`, `yarn dlx`, `bunx`, run-scripts), e.g.
+ * `"pnpm/10.4.0 npm/? node/v24.0.0 darwin arm64"` → pnpm. A binary executed
+ * directly carries no user agent and yields undefined.
+ */
+export declare function packageManagerFromUserAgent(userAgent: string | undefined): PackageManagerKind | undefined;
+/** Reads {@link packageManagerFromUserAgent} from the process environment. */
+export declare function detectInvokingPackageManager(): PackageManagerKind | undefined;
+/** Reads the detection facts for {@link resolvePackageManager} from `projectRoot`. */
+export declare function detectPackageManager(projectRoot: string): Promise<DetectedPackageManager>;

package/dist/src/setup/package-manager.js

@@ -0,0 +1 @@
+import{pathExists}from"./path-exists.js";import{join}from"node:path";import{readFile}from"node:fs/promises";const LOCKFILE_MANAGERS=[[`pnpm-lock.yaml`,`pnpm`],[`package-lock.json`,`npm`],[`yarn.lock`,`yarn`],[`bun.lock`,`bun`],[`bun.lockb`,`bun`]];function isPackageManagerKind(e){return e===`bun`||e===`npm`||e===`pnpm`||e===`yarn`}function resolvePackageManager(e){let t=e.packageManagerField?.split(`@`,1)[0]?.trim();if(t!==void 0&&isPackageManagerKind(t))return{kind:t,source:`package-manager-field`};for(let[t,n]of LOCKFILE_MANAGERS)if(e.lockfiles.includes(t))return{kind:n,source:`lockfile`};return{kind:`pnpm`,source:`default`}}function packageManagerFromUserAgent(e){let t=e?.split(`/`,1)[0];return t!==void 0&&isPackageManagerKind(t)?t:void 0}function detectInvokingPackageManager(){return packageManagerFromUserAgent(process.env.npm_config_user_agent)}async function detectPackageManager(r){let i;try{let e=JSON.parse(await readFile(join(r,`package.json`),`utf8`));typeof e==`object`&&e&&`packageManager`in e&&typeof e.packageManager==`string`&&(i=e.packageManager)}catch{}let a=[];for(let[n]of LOCKFILE_MANAGERS)await pathExists(join(r,n))&&a.push(n);return resolvePackageManager({packageManagerField:i,lockfiles:a})}export{detectInvokingPackageManager,detectPackageManager,packageManagerFromUserAgent,resolvePackageManager};

package/dist/src/setup/primitives/index.d.ts

@@ -0,0 +1,3 @@
+export { eveDevArguments, runPackageManagerInstall, runPnpmInstall, spawnPackageManager, spawnPnpm, type RunInstallOptions, type RunPackageManagerOptions, type RunPnpmOptions, } from "./pm/run.js";
+export { getPackageManagerStrategy, type PackageManagerConfigurationResult, type PackageManagerInvocation, type PackageManagerStrategy, } from "./pm/index.js";
+export { captureVercel, runVercel, type RunVercelOptions, type VercelCaptureFailure, type VercelCaptureResult, } from "./run-vercel.js";

package/dist/src/setup/primitives/index.js

@@ -0,0 +1 @@
+import{captureVercel,runVercel}from"./run-vercel.js";import{getPackageManagerStrategy}from"./pm/index.js";import{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm}from"./pm/run.js";export{captureVercel,eveDevArguments,getPackageManagerStrategy,runPackageManagerInstall,runPnpmInstall,runVercel,spawnPackageManager,spawnPnpm};

package/dist/src/setup/primitives/pm/bun.d.ts

@@ -0,0 +1,10 @@
+import { applyNoProjectConfiguration } from "./shared.js";
+export declare const bunPackageManager: {
+    kind: "bun";
+    scaffoldFiles: {};
+    applyProjectConfiguration: typeof applyNoProjectConfiguration;
+    devArguments: () => string[];
+    installArguments: () => string[];
+    prepareArguments: (_projectRoot: string, args: readonly string[]) => readonly string[];
+    resolveInvocation: (args: readonly string[]) => import("./types.js").PackageManagerInvocation;
+};

package/dist/src/setup/primitives/pm/bun.js

@@ -0,0 +1 @@
+import{applyNoProjectConfiguration,resolveStandardInvocation}from"./shared.js";const bunPackageManager={kind:`bun`,scaffoldFiles:{},applyProjectConfiguration:applyNoProjectConfiguration,devArguments:()=>[`x`,`eve`,`dev`],installArguments:()=>[`install`],prepareArguments:(e,t)=>t,resolveInvocation:e=>resolveStandardInvocation(`bun`,e)};export{bunPackageManager};

package/dist/src/setup/primitives/pm/index.d.ts

@@ -0,0 +1,11 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+import { bunPackageManager } from "./bun.js";
+import { npmPackageManager } from "./npm.js";
+import { pnpmPackageManager } from "./pnpm.js";
+import type { PackageManagerStrategy } from "./types.js";
+import { yarnPackageManager } from "./yarn.js";
+/** Returns the strategy that owns command and project-file behavior for `kind`. */
+export declare function getPackageManagerStrategy(kind: PackageManagerKind): PackageManagerStrategy;
+export { bunPackageManager, npmPackageManager, pnpmPackageManager, yarnPackageManager };
+export { PNPM_WORKSPACE_CONTENT, PNPM_WORKSPACE_PATH } from "./pnpm.js";
+export type { PackageManagerConfigurationResult, PackageManagerInstallOptions, PackageManagerInvocation, PackageManagerStrategy, } from "./types.js";

package/dist/src/setup/primitives/pm/index.js

@@ -0,0 +1 @@
+import{bunPackageManager}from"./bun.js";import{npmPackageManager}from"./npm.js";import{PNPM_WORKSPACE_CONTENT,PNPM_WORKSPACE_PATH,pnpmPackageManager}from"./pnpm.js";import{yarnPackageManager}from"./yarn.js";function getPackageManagerStrategy(e){switch(e){case`bun`:return bunPackageManager;case`npm`:return npmPackageManager;case`pnpm`:return pnpmPackageManager;case`yarn`:return yarnPackageManager;default:return e}}export{PNPM_WORKSPACE_CONTENT,PNPM_WORKSPACE_PATH,bunPackageManager,getPackageManagerStrategy,npmPackageManager,pnpmPackageManager,yarnPackageManager};

package/dist/src/setup/primitives/pm/npm.d.ts

@@ -0,0 +1,10 @@
+import { applyNoProjectConfiguration } from "./shared.js";
+export declare const npmPackageManager: {
+    kind: "npm";
+    scaffoldFiles: {};
+    applyProjectConfiguration: typeof applyNoProjectConfiguration;
+    devArguments: () => string[];
+    installArguments: (options: import("./types.js").PackageManagerInstallOptions) => string[];
+    prepareArguments: (_projectRoot: string, args: readonly string[]) => readonly string[];
+    resolveInvocation: (args: readonly string[]) => import("./types.js").PackageManagerInvocation;
+};

package/dist/src/setup/primitives/pm/npm.js

@@ -0,0 +1 @@
+import{applyNoProjectConfiguration,resolveStandardInvocation}from"./shared.js";const npmPackageManager={kind:`npm`,scaffoldFiles:{},applyProjectConfiguration:applyNoProjectConfiguration,devArguments:()=>[`exec`,`--`,`eve`,`dev`],installArguments:e=>[`install`,...e.bypassMinimumReleaseAge===!0?[`--min-release-age=0`]:[]],prepareArguments:(e,t)=>t,resolveInvocation:e=>resolveStandardInvocation(`npm`,e)};export{npmPackageManager};

package/dist/src/setup/primitives/pm/pnpm.d.ts

@@ -0,0 +1,27 @@
+export declare const PNPM_WORKSPACE_PATH = "pnpm-workspace.yaml";
+export declare const PNPM_WORKSPACE_CONTENT: string;
+export declare const pnpmPackageManager: {
+    kind: "pnpm";
+    scaffoldFiles: {
+        "pnpm-workspace.yaml": string;
+    };
+    applyProjectConfiguration(projectRoot: string): Promise<{
+        filesSkipped: never[];
+        filesWritten: string[];
+    } | {
+        filesSkipped: string[];
+        filesWritten: never[];
+    }>;
+    devArguments: () => string[];
+    installArguments: (options: import("./types.js").PackageManagerInstallOptions) => string[];
+    prepareArguments: (projectRoot: string, args: readonly string[]) => string[];
+    resolveInvocation(args: readonly string[]): {
+        args: readonly string[];
+        command: string;
+        shell: boolean;
+    } | {
+        shell?: undefined;
+        args: readonly string[];
+        command: string;
+    };
+};

package/dist/src/setup/primitives/pm/pnpm.js

@@ -0,0 +1,8 @@
+import{pathExists}from"../../path-exists.js";import{extname,join}from"node:path";import{existsSync}from"node:fs";import{readFile,writeFile}from"node:fs/promises";const PNPM_WORKSPACE_PATH=`pnpm-workspace.yaml`,PNPM_WORKSPACE_CONTENT=[`minimumReleaseAgeExclude:`,`  - eve`,`allowBuilds:`,`  sharp: false`,`# Compatibility for Eve releases with an incomplete runtime manifest.`,`packageExtensions:`,`  "eve@>=0.6.0-beta.13 <=0.7.0":`,`    dependencies:`,`      oxc-parser: 0.134.0`,``].join(`
+`),EVE_RELEASE_AGE_EXCLUSION=`  - eve`,SHARP_BUILD_POLICY=`  sharp: false`;function findYamlBlockEnd(e,t){let n=t+1;for(;n<e.length;){let t=e[n]??``;if(t.length>0&&!t.startsWith(` `)&&!t.startsWith(`	`))break;n+=1}return n}function withSharpBuildPolicy(e){let t=e.endsWith(`
+`)?e:`${e}\n`,n=t.split(`
+`),r=n.findIndex(e=>e===`allowBuilds:`);if(r<0)return`${t.trim().length===0?``:`${t}\n`}allowBuilds:\n${SHARP_BUILD_POLICY}\n`;let i=findYamlBlockEnd(n,r);if(n.slice(r+1,i).some(e=>/^\s+sharp:/.test(e)))return e;let a=i;for(;a>r+1&&n[a-1]===``;)--a;return n.splice(a,0,SHARP_BUILD_POLICY),n.join(`
+`)}function withExperimentalEveReleaseAgeExclusion(e){let t=e.endsWith(`
+`)?e:`${e}\n`,n=t.split(`
+`),r=n.findIndex(e=>e===`minimumReleaseAgeExclude:`);if(r<0)return`${t.trim().length===0?``:`${t}\n`}minimumReleaseAgeExclude:\n${EVE_RELEASE_AGE_EXCLUSION}\n`;let i=findYamlBlockEnd(n,r);if(n.slice(r+1,i).some(e=>e.trim()===`- eve`))return e;let a=i;for(;a>r+1&&n[a-1]===``;)--a;return n.splice(a,0,EVE_RELEASE_AGE_EXCLUSION),n.join(`
+`)}async function ensurePnpmWorkspacePolicy(t){if(!await pathExists(t))return await writeFile(t,PNPM_WORKSPACE_CONTENT,`utf8`),`written`;let n=await readFile(t,`utf8`),r=withExperimentalEveReleaseAgeExclusion(withSharpBuildPolicy(n));return r===n?`skipped`:(await writeFile(t,r,`utf8`),`written`)}const pnpmPackageManager={kind:`pnpm`,scaffoldFiles:{[PNPM_WORKSPACE_PATH]:PNPM_WORKSPACE_CONTENT},async applyProjectConfiguration(e){let t=join(e,PNPM_WORKSPACE_PATH);return await ensurePnpmWorkspacePolicy(t)===`written`?{filesSkipped:[],filesWritten:[t]}:{filesSkipped:[t],filesWritten:[]}},devArguments:()=>[`exec`,`eve`,`dev`],installArguments:e=>[`install`,`--no-frozen-lockfile`,...e.bypassMinimumReleaseAge===!0?[`--config.minimum-release-age=0`]:[]],prepareArguments:(e,t)=>[`--dir`,e,...existsSync(join(e,`pnpm-workspace.yaml`))?[]:[`--ignore-workspace`],...t],resolveInvocation(e){let i=process.env.PNPM_HOME;if(i!==void 0){let t=join(i,process.platform===`win32`?`pnpm.CMD`:`pnpm`);if(existsSync(t))return{args:e,command:t,shell:process.platform===`win32`}}let a=process.env.npm_execpath;if(a!==void 0&&a.toLowerCase().includes(`pnpm`)){let n=extname(a).toLowerCase();return n===`.cjs`||n===`.js`?{args:[a,...e],command:process.execPath}:{args:e,command:a,shell:process.platform===`win32`}}return{args:e,command:`pnpm`}}};export{PNPM_WORKSPACE_CONTENT,PNPM_WORKSPACE_PATH,pnpmPackageManager};

package/dist/src/setup/primitives/pm/run.d.ts

@@ -0,0 +1,23 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+import { type ProcessOutputHandler } from "../process-output.js";
+/** Output routing options for setup-owned package manager commands. */
+export interface RunPackageManagerOptions {
+    /** Streams command output to a parent-owned renderer instead of writing outside it. */
+    onOutput?: ProcessOutputHandler;
+}
+/** @deprecated Use {@link RunPackageManagerOptions}. */
+export type RunPnpmOptions = RunPackageManagerOptions;
+/** Runs the selected package manager in `projectRoot`. */
+export declare function spawnPackageManager(kind: PackageManagerKind, projectRoot: string, args: readonly string[], options?: RunPackageManagerOptions): Promise<boolean>;
+export interface RunInstallOptions extends RunPackageManagerOptions {
+    /** Disables the manager's minimum-release-age cooldown for this run when supported. */
+    bypassMinimumReleaseAge?: boolean;
+}
+/** Installs project dependencies using the selected package-manager strategy. */
+export declare function runPackageManagerInstall(kind: PackageManagerKind, projectRoot: string, options?: RunInstallOptions): Promise<boolean>;
+/** The argv that runs the locally installed Eve binary's `dev` command. */
+export declare function eveDevArguments(kind: PackageManagerKind): readonly string[];
+/** Compatibility wrapper for callers that still explicitly require pnpm. */
+export declare function spawnPnpm(projectRoot: string, args: readonly string[], options?: RunPackageManagerOptions): Promise<boolean>;
+/** Compatibility wrapper for callers that still explicitly require pnpm. */
+export declare function runPnpmInstall(projectRoot: string, options?: RunPackageManagerOptions): Promise<boolean>;

package/dist/src/setup/primitives/pm/run.js

@@ -0,0 +1 @@
+import{createProcessOutputBuffer}from"../process-output.js";import{getPackageManagerStrategy}from"./index.js";import{spawn}from"node:child_process";function spawnPackageManager(r,i,a,o={}){return new Promise(s=>{let c=getPackageManagerStrategy(r),l=c.prepareArguments(i,a),u=c.resolveInvocation(l),d=o.onOutput&&createProcessOutputBuffer(o.onOutput),f=spawn(u.command,[...u.args],{cwd:i,stdio:o.onOutput?[`inherit`,`pipe`,`pipe`]:`inherit`,shell:u.shell});f.stdout?.on(`data`,e=>d?.write(`stdout`,e)),f.stderr?.on(`data`,e=>d?.write(`stderr`,e));let p=!1;function settle(e){p||(p=!0,d?.flush(),s(e))}function reportFailure(e){o.onOutput?o.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}f.on(`error`,e=>{e.code===`ENOENT`?reportFailure(`${r} not found. Install it before running this step.`):reportFailure(`${r} ${a.join(` `)} failed: ${e.message}`),settle(!1)}),f.on(`close`,e=>settle(e===0))})}function runPackageManagerInstall(e,n,r={}){return spawnPackageManager(e,n,getPackageManagerStrategy(e).installArguments(r),{onOutput:r.onOutput})}function eveDevArguments(e){return getPackageManagerStrategy(e).devArguments()}function spawnPnpm(e,t,n={}){return spawnPackageManager(`pnpm`,e,t,n)}function runPnpmInstall(e,t={}){return runPackageManagerInstall(`pnpm`,e,t)}export{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm};

package/dist/src/setup/primitives/pm/shared.d.ts

@@ -0,0 +1,8 @@
+import type { PackageManagerInvocation } from "./types.js";
+export type StandardExecutablePackageManager = "bun" | "npm" | "yarn";
+/** Resolves a manager executable, preserving test and package-runner interposition. */
+export declare function resolveStandardInvocation(kind: StandardExecutablePackageManager, args: readonly string[]): PackageManagerInvocation;
+export declare function applyNoProjectConfiguration(): Promise<{
+    filesSkipped: [];
+    filesWritten: [];
+}>;

package/dist/src/setup/primitives/pm/shared.js

@@ -0,0 +1 @@
+import{extname}from"node:path";function resolveStandardInvocation(e,t){let n=process.env.npm_execpath,r=n?.toLowerCase(),i=r!==void 0&&(e===`npm`?r.includes(`npm`)&&!r.includes(`pnpm`):r.includes(e));if(n!==void 0&&i){let e=extname(n).toLowerCase();return e===`.cjs`||e===`.js`?{args:[n,...t],command:process.execPath}:{args:t,command:n,shell:process.platform===`win32`}}return{args:t,command:e,shell:process.platform===`win32`}}async function applyNoProjectConfiguration(){return{filesSkipped:[],filesWritten:[]}}export{applyNoProjectConfiguration,resolveStandardInvocation};

package/dist/src/setup/primitives/pm/types.d.ts

@@ -0,0 +1,37 @@
+import type { PackageManagerKind } from "../../package-manager.js";
+/** Executable and arguments used to invoke a package manager. */
+export interface PackageManagerInvocation {
+    readonly args: readonly string[];
+    readonly command: string;
+    readonly shell?: boolean;
+}
+/** Files changed while applying package-manager-owned project configuration. */
+export interface PackageManagerConfigurationResult {
+    readonly filesSkipped: readonly string[];
+    readonly filesWritten: readonly string[];
+}
+export interface PackageManagerInstallOptions {
+    readonly bypassMinimumReleaseAge?: boolean;
+}
+/**
+ * Package-manager-specific command and generated-project behavior.
+ *
+ * Process lifecycle and output handling remain shared; each strategy owns the
+ * arguments, executable resolution, and project files understood by its manager.
+ */
+export interface PackageManagerStrategy {
+    /** Package manager represented by this strategy. */
+    readonly kind: PackageManagerKind;
+    /** Manager-owned files included when creating a fresh project. */
+    readonly scaffoldFiles: Readonly<Record<string, string>>;
+    /** Adds or reconciles manager-owned configuration in an existing project. */
+    applyProjectConfiguration(projectRoot: string): Promise<PackageManagerConfigurationResult>;
+    /** Arguments that run the project-local Eve development command. */
+    devArguments(): readonly string[];
+    /** Arguments that install project dependencies. */
+    installArguments(options: PackageManagerInstallOptions): readonly string[];
+    /** Adds any project-scoping arguments required before command execution. */
+    prepareArguments(projectRoot: string, args: readonly string[]): readonly string[];
+    /** Resolves the executable exposed by the current host environment. */
+    resolveInvocation(args: readonly string[]): PackageManagerInvocation;
+}

package/dist/src/setup/primitives/pm/types.js

@@ -0,0 +1 @@
+export{};

package/dist/src/setup/primitives/pm/yarn.d.ts

@@ -0,0 +1,10 @@
+import { applyNoProjectConfiguration } from "./shared.js";
+export declare const yarnPackageManager: {
+    kind: "yarn";
+    scaffoldFiles: {};
+    applyProjectConfiguration: typeof applyNoProjectConfiguration;
+    devArguments: () => string[];
+    installArguments: () => string[];
+    prepareArguments: (_projectRoot: string, args: readonly string[]) => readonly string[];
+    resolveInvocation: (args: readonly string[]) => import("./types.js").PackageManagerInvocation;
+};

package/dist/src/setup/primitives/pm/yarn.js

@@ -0,0 +1 @@
+import{applyNoProjectConfiguration,resolveStandardInvocation}from"./shared.js";const yarnPackageManager={kind:`yarn`,scaffoldFiles:{},applyProjectConfiguration:applyNoProjectConfiguration,devArguments:()=>[`eve`,`dev`],installArguments:()=>[`install`],prepareArguments:(e,t)=>t,resolveInvocation:e=>resolveStandardInvocation(`yarn`,e)};export{yarnPackageManager};

package/dist/src/setup/primitives/run-pnpm.d.ts

@@ -0,0 +1 @@
+export { eveDevArguments, runPackageManagerInstall, runPnpmInstall, spawnPackageManager, spawnPnpm, type RunInstallOptions, type RunPackageManagerOptions as RunPnpmOptions, } from "./pm/run.js";

package/dist/src/setup/primitives/run-pnpm.js

@@ -0,0 +1 @@
+import{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm}from"./pm/run.js";export{eveDevArguments,runPackageManagerInstall,runPnpmInstall,spawnPackageManager,spawnPnpm};

package/dist/src/setup/{scaffold/primitives → primitives}/run-vercel.d.ts

@@ -7,6 +7,13 @@ export interface RunVercelOptions {
     nonInteractive?: boolean;
     /** Streams command output to a parent-owned renderer instead of writing outside it. */
     onOutput?: ProcessOutputHandler;
+    /**
+     * Hard deadline for the whole command. When it elapses the run settles as a
+     * failure and the child is killed (SIGTERM, then SIGKILL after a short
+     * grace). Unbounded when omitted — only safe for commands that cannot wait
+     * on external action, e.g. a Connect create parked on a browser OAuth.
+     */
+    timeoutMs?: number;
 }
 /**
  * Runs a Vercel CLI command with the Connect feature flag enabled.

package/dist/src/setup/primitives/run-vercel.js

@@ -0,0 +1 @@
+import{createProcessOutputBuffer}from"./process-output.js";import{dirname,join,resolve}from"node:path";import{spawn}from"node:child_process";import{accessSync,constants,existsSync,statSync}from"node:fs";const CONNECT_FEATURE_FLAG_ENV={FF_CONNECT_ENABLED:`1`},VERCEL_NOT_FOUND_MESSAGE=`Vercel CLI not found. Install with: npm i -g vercel@latest`;function buildSpawnEnv(e){return{...process.env,...CONNECT_FEATURE_FLAG_ENV,...e}}function existingDir(e){let n=resolve(e);for(;!existsSync(n);){let e=dirname(n);if(e===n)break;n=e}return n}function armDeadline(e,t,n){if(t===void 0)return()=>{};let r=setTimeout(()=>{n(),e.kill(`SIGTERM`);let t=setTimeout(()=>e.kill(`SIGKILL`),5e3);t.unref(),e.once(`close`,()=>clearTimeout(t))},t);return r.unref(),()=>clearTimeout(r)}function timeoutMessage(e,t){return`vercel ${e.join(` `)} timed out after ${Math.round(t/1e3)}s and was aborted.`}function ancestorDirectories(e){let n=[],i=resolve(e);for(;;){n.push(i);let e=dirname(i);if(e===i)return n;i=e}}function findExecutable(e){try{if(accessSync(e,constants.F_OK|constants.X_OK),statSync(e).isFile())return e}catch{return}}function findLocalVercel(e){for(let t of ancestorDirectories(e)){let e=findExecutable(join(t,`node_modules`,`.bin`,`vercel`));if(e!==void 0)return e}}function resolveVercelInvocation(e){let t=findLocalVercel(e);return t===void 0?{command:`vercel`,commandArgs:[]}:{command:t,commandArgs:[]}}function stdioForRun(e){return e.onOutput?[e.nonInteractive?`ignore`:`inherit`,`pipe`,`pipe`]:e.nonInteractive?[`ignore`,`pipe`,`pipe`]:`inherit`}async function runVercel(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:stdioForRun(n),env:buildSpawnEnv(n.extraEnv??{})});c.stdout?.on(`data`,e=>s?.write(`stdout`,e)),c.stderr?.on(`data`,e=>s?.write(`stderr`,e));let l=!1;function settle(e){l||(l=!0,s?.flush(),r(e))}function reportFailure(e){n.onOutput?n.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}let u=armDeadline(c,n.timeoutMs,()=>{reportFailure(timeoutMessage(t,n.timeoutMs??0)),settle(!1)});c.on(`error`,e=>{u(),e.code===`ENOENT`?reportFailure(VERCEL_NOT_FOUND_MESSAGE):reportFailure(`vercel ${t.join(` `)} failed: ${e.message}`),settle(!1)}),c.on(`close`,e=>{u(),!l&&e!==0&&e!==null&&(s?.flush(),reportFailure(`vercel ${t.join(` `)} exited with code ${e}.`)),settle(e===0)})})}async function runVercelCaptureStdout(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:[n.nonInteractive?`ignore`:`inherit`,`pipe`,n.onOutput?`pipe`:`inherit`],env:buildSpawnEnv(n.extraEnv??{})}),l=[];c.stdout?.on(`data`,e=>l.push(e.toString(`utf8`))),c.stderr?.on(`data`,e=>s?.write(`stderr`,e));let u=!1;function settle(e){u||(u=!0,s?.flush(),r({ok:e,stdout:l.join(``)}))}function reportFailure(e){n.onOutput?n.onOutput({stream:`stderr`,text:e}):process.stderr.write(`\n${e}\n`)}let d=armDeadline(c,n.timeoutMs,()=>{reportFailure(timeoutMessage(t,n.timeoutMs??0)),settle(!1)});c.on(`error`,e=>{d(),reportFailure(e.code===`ENOENT`?VERCEL_NOT_FOUND_MESSAGE:`vercel ${t.join(` `)} failed: ${e.message}`),settle(!1)}),c.on(`close`,e=>{d(),!u&&e!==0&&e!==null&&reportFailure(`vercel ${t.join(` `)} exited with code ${e}.`),settle(e===0)})})}async function captureVercel(t,n){return new Promise(r=>{let a=existingDir(n.cwd),o=resolveVercelInvocation(a),s=n.onOutput&&createProcessOutputBuffer(n.onOutput),c=spawn(o.command,[...o.commandArgs,...t],{cwd:a,stdio:[`ignore`,`pipe`,`pipe`],env:buildSpawnEnv(n.extraEnv??{})}),l=[],u=[];c.stdout?.on(`data`,e=>l.push(e.toString(`utf8`))),c.stderr?.on(`data`,e=>{u.push(e.toString(`utf8`)),s?.write(`stderr`,e)});let d=!1;function fail(e){d||(d=!0,s?.flush(),n.onOutput?.({stream:`stderr`,text:e.message}),r({ok:!1,failure:e}))}function succeed(){d||(d=!0,s?.flush(),r({ok:!0,stdout:l.join(``)}))}let f=armDeadline(c,n.timeoutMs,()=>{fail({code:null,stdout:l.join(``),stderr:u.join(``),message:timeoutMessage(t,n.timeoutMs??0)})});c.on(`error`,e=>{f(),fail({errno:e.code,stdout:l.join(``),stderr:u.join(``),message:e.code===`ENOENT`?VERCEL_NOT_FOUND_MESSAGE:`vercel ${t.join(` `)} failed: ${e.message}`})}),c.on(`close`,e=>{if(f(),e!==0&&e!==null){fail({code:e,stdout:l.join(``),stderr:u.join(``),message:`vercel ${t.join(` `)} exited with code ${e}.`});return}succeed()})})}export{captureVercel,runVercel,runVercelCaptureStdout};

package/dist/src/setup/project-name.d.ts

@@ -0,0 +1,4 @@
+/** Returns an error message when a project name is not a safe single path segment. */
+export declare function validateProjectName(value: string): string | undefined;
+/** Parses and normalizes a project name at an external input boundary. */
+export declare function parseProjectName(value: string): string;

package/dist/src/setup/project-name.js

@@ -0,0 +1 @@
+const PROJECT_NAME_REGEX=/^(?!.*---)[a-z0-9-_.]+$/;function validateProjectName(t){let n=t.trim();if(n.length===0)return`Project name cannot be empty.`;if(n===`.`||n===`..`)return`Project name cannot be '${n}'.`;if(!PROJECT_NAME_REGEX.test(n)||n.length>100)return`Project name can only contain up to 100 lowercase letters, digits, and the characters '.', '_', '-'.`}function parseProjectName(e){let t=e.trim(),n=validateProjectName(t);if(n!==void 0)throw Error(n);return t}export{parseProjectName,validateProjectName};

package/dist/src/setup/project-resolution.d.ts

@@ -0,0 +1,54 @@
+/** Link and production-deployment status for a Vercel project directory. */
+export type DeploymentState = "unlinked" | "linked" | "deployed";
+/** Vercel project data resolved from local link metadata and the API. */
+export interface DeploymentInfo {
+    state: DeploymentState;
+    projectId?: string;
+    orgId?: string;
+    productionUrl?: string;
+}
+/**
+ * Reads local Vercel link metadata and checks whether the linked project has a production alias.
+ */
+export declare function detectDeployment(projectPath: string): Promise<DeploymentInfo>;
+/** Human-readable identity of a linked Vercel project, for the dashboard status bar. */
+export interface ProjectIdentity {
+    projectName: string;
+    /** The team's display name; absent for a personal-account project. */
+    teamName?: string;
+}
+/**
+ * Resolves a linked project's human-readable name and team for the dashboard
+ * status bar, from local `.vercel/project.json` plus the Vercel API. A
+ * personal-account project (a non-`team_` org) carries no team, so `teamName`
+ * is absent; the project name falls back to its id if the API call fails.
+ *
+ * Returns `undefined` when the directory is not linked. Network-bound: callers
+ * render a loading affordance and cache the result.
+ *
+ * @param projectPath Absolute path of the linked project directory.
+ */
+export declare function detectProjectIdentity(projectPath: string): Promise<ProjectIdentity | undefined>;
+export type ProjectResolution = {
+    kind: "unresolved";
+} | {
+    kind: "linked";
+    projectId: string;
+} | {
+    kind: "deployed";
+    projectId: string;
+    productionUrl: string;
+};
+export declare function projectResolutionFromDeployment(deployment: DeploymentInfo): ProjectResolution;
+/**
+ * Side-effect-free fact gathering after a link: reads `.vercel/project.json`
+ * to resolve the project. The on-disk link is the single source of truth.
+ */
+export declare function detectProjectResolution(projectRoot: string): Promise<ProjectResolution>;
+export declare function mergeProjectResolution(current: ProjectResolution, next: ProjectResolution): ProjectResolution;
+export declare function projectResolutionFromDeployResult(project: ProjectResolution, deploy: {
+    deployed: boolean;
+    productionUrl?: string;
+}): ProjectResolution;
+export declare function isProjectResolved(project: ProjectResolution): boolean;
+export declare function projectProductionUrlFromResolution(project: ProjectResolution): string | undefined;

package/dist/src/setup/project-resolution.js

@@ -0,0 +1 @@
+import{captureVercel}from"./primitives/run-vercel.js";import{join}from"node:path";import{readFile}from"node:fs/promises";function pickShortestAlias(e){if(!Array.isArray(e))return;let t;for(let n of e)typeof n!=`string`||n.length===0||(t===void 0||n.length<t.length)&&(t=n);return t}async function fetchProductionAlias(t,n,r){let i=await captureVercel([`api`,`/v9/projects/${t}?teamId=${n}`,`--scope`,n],{cwd:r});if(i.ok)try{let e=pickShortestAlias(JSON.parse(i.stdout).targets?.production?.alias);return e?`https://${e}`:void 0}catch{return}}async function detectDeployment(e){let r;try{r=await readFile(join(e,`.vercel`,`project.json`),`utf8`)}catch{return{state:`unlinked`}}let i;try{i=JSON.parse(r)}catch{return{state:`unlinked`}}let a=typeof i.projectId==`string`?i.projectId:void 0,o=typeof i.orgId==`string`?i.orgId:void 0;if(!a||!o)return{state:`unlinked`};let s=await fetchProductionAlias(a,o,e);return{state:s?`deployed`:`linked`,projectId:a,orgId:o,productionUrl:s}}async function fetchVercelName(t,n,r){let i=await captureVercel([`api`,t,`--scope`,n],{cwd:r});if(i.ok)try{let e=JSON.parse(i.stdout);return typeof e.name==`string`&&e.name.length>0?e.name:typeof e.slug==`string`&&e.slug.length>0?e.slug:void 0}catch{return}}async function detectProjectIdentity(e){let r;try{r=await readFile(join(e,`.vercel`,`project.json`),`utf8`)}catch{return}let i;try{i=JSON.parse(r)}catch{return}let a=typeof i.projectId==`string`?i.projectId:void 0,o=typeof i.orgId==`string`?i.orgId:void 0;if(!a||!o)return;let[s,c]=await Promise.all([fetchVercelName(`/v9/projects/${a}?teamId=${o}`,o,e).then(e=>e??a),o.startsWith(`team_`)?fetchVercelName(`/v2/teams/${o}`,o,e):Promise.resolve(void 0)]);return{projectName:s,teamName:c}}function projectResolutionFromDeployment(e){return e.state===`unlinked`||e.projectId===void 0?{kind:`unresolved`}:e.state===`deployed`&&e.productionUrl!==void 0?{kind:`deployed`,projectId:e.projectId,productionUrl:e.productionUrl}:{kind:`linked`,projectId:e.projectId}}async function detectProjectResolution(e){return projectResolutionFromDeployment(await detectDeployment(e))}function mergeProjectResolution(e,t){return t.kind===`unresolved`||e.kind===`deployed`&&e.projectId===t.projectId?e:t}function projectResolutionFromDeployResult(e,t){return e.kind===`unresolved`||!t.deployed||t.productionUrl===void 0?e:{kind:`deployed`,projectId:e.projectId,productionUrl:t.productionUrl}}function isProjectResolved(e){return e.kind!==`unresolved`}function projectProductionUrlFromResolution(e){return e.kind===`deployed`?e.productionUrl:void 0}export{detectDeployment,detectProjectIdentity,detectProjectResolution,isProjectResolved,mergeProjectResolution,projectProductionUrlFromResolution,projectResolutionFromDeployResult,projectResolutionFromDeployment};

package/dist/src/setup/prompter.d.ts

@@ -1,4 +1,4 @@
-import { type RailSpinner } from "#setup/scaffold/cli/index.js";
+import { type RailSpinner } from "#setup/cli/index.js";
 /**
  * Clack constrains option values to readonly primitives. Our scaffold flow
  * only ever uses string-valued options (`ChannelKind`, `SetupMode`,
@@ -25,6 +25,22 @@ export interface SelectOption<T extends PrompterValue> {
     locked?: boolean;
     /** Parenthetical shown after a locked option's label, e.g. "always available". */
     lockedReason?: string;
+    /**
+     * A leading run of featured options forms a searchable picker's default
+     * viewport: with no filter typed, only they are in view, and scrolling or
+     * filtering reaches the rest of the list. Featured options must be sorted
+     * to the front. Meaningless without `search`.
+     */
+    featured?: boolean;
+}
+/**
+ * An outcome line from an earlier lap of a looping menu, shown with the
+ * repainted question: the TUI panel renders it beneath the options, the CLI
+ * prints it to scrollback before the prompt.
+ */
+export interface SelectNotice {
+    tone: "success" | "info" | "warning";
+    text: string;
 }
 /** Options common to every {@link Prompter.select} call. */
 export interface SelectCommonOptions<T extends PrompterValue> {
@@ -43,6 +59,15 @@ export interface SelectCommonOptions<T extends PrompterValue> {
      * so it is inherently satisfied.
      */
     required?: boolean;
+    /**
+     * "stacked" renders each option's hint on its own line below the label with
+     * a blank line between options — for small action menus whose hints carry
+     * current values. A TUI-panel affordance: the CLI prompter keeps its inline
+     * hint rendering.
+     */
+    layout?: "stacked";
+    /** Outcome lines from earlier laps of a looping menu. */
+    notices?: readonly SelectNotice[];
 }
 /** Single-select form: navigate, then enter picks the highlighted option. */
 export interface SingleSelectOptions<T extends PrompterValue> extends SelectCommonOptions<T> {
@@ -50,12 +75,19 @@ export interface SingleSelectOptions<T extends PrompterValue> extends SelectComm
     /** Pre-position the cursor on the option whose value matches. */
     initialValue?: T;
 }
-/** Multi-select form: space toggles rows, enter confirms the marked set. */
+/** Multi-select form: space or enter toggles rows; enter on the trailing Submit row confirms the marked set. */
 export interface MultiSelectOptions<T extends PrompterValue> extends SelectCommonOptions<T> {
     multiple: true;
     /** Pre-mark these values as selected. */
     initialValues?: T[];
 }
+/** Color intent for {@link Prompter.note}: red warning (default) or green success. */
+export type NoteTone = "warning" | "success";
+/** Input for {@link Prompter.acknowledge}: a heading plus optional body lines. */
+export interface AcknowledgeOptions {
+    message: string;
+    lines?: readonly string[];
+}
 export interface Prompter {
     text(opts: {
         message: string;
@@ -69,13 +101,29 @@ export interface Prompter {
     }): Promise<string>;
     /**
      * Unified picker. Defaults to single-select (enter picks the highlighted row);
-     * pass `multiple: true` for a checklist (space toggles, enter confirms). Add
+     * pass `multiple: true` for a checklist (space or enter toggles, enter on
+     * the trailing Submit row confirms). Add
      * `search: true` for a type-ahead filter. `required` gates an empty
      * multi-select submission.
      */
     select<T extends PrompterValue>(opts: SingleSelectOptions<T>): Promise<T>;
     select<T extends PrompterValue>(opts: MultiSelectOptions<T>): Promise<T[]>;
-    note(message: string, title?: string): void;
+    /**
+     * Static instructions the user dismisses before the flow moves on. The TUI
+     * renders them in the question slot of the flow panel (the text takes the
+     * place of option rows) until enter; the CLI prints them to scrollback and
+     * resolves immediately, since printed text persists there. Optional so
+     * lightweight test fakes can omit it — flows fall back to {@link note}.
+     */
+    acknowledge?(opts: AcknowledgeOptions): Promise<void>;
+    /**
+     * Rail-attached notice, no bullet — reads as a follow-up to the previous
+     * step. Red by default (warnings, collisions); pass `tone: "success"` for a
+     * green closing note like the one-shot next steps.
+     */
+    note(message: string, title?: string, options?: {
+        tone?: NoteTone;
+    }): void;
     /** Prints the Vercel ▲ logo + title + subtitle banner. */
     intro(title: string, subtitle?: string): void;
     /** Prints a final green ● end-cap with the message. */

package/dist/src/setup/prompter.js

@@ -1 +1 @@
-import{__toESM}from"../_virtual/_rolldown/runtime.js";import{WizardCancelledError}from"./step.js";import{h,ht,q}from"../node_modules/.pnpm/@clack_core@1.3.1/node_modules/@clack/core/dist/index.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/scaffold/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);function guardCancel(e){if(q(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,import_picocolors.default)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(h.aliases.delete(`escape`),!0)}function attachQuitGuard(e){let t=initialQuitGuardState;return e.on(`key`,(n,r)=>{let{state:i,action:a}=reduceQuitGuard(t,r?.name===`escape`?{type:`escape`}:{type:`other-key`});t=i,a===`quit`&&(e.state=`cancel`)}),{note:()=>quitHintNote(t,import_picocolors.default)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),import_picocolors.default)}function cornerForState(e){return cornerFor(toPromptState(e),import_picocolors.default)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:import_picocolors.default,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,i=new ht({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?import_picocolors.default.inverse(t.placeholder[0])+import_picocolors.default.dim(t.placeholder.slice(1)):import_picocolors.default.inverse(import_picocolors.default.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=t.mask?a:this.value?this.userInputWithCursor:i;switch(this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${import_picocolors.default.red(this.error)}\n`;case`submit`:{let n=t.mask?this.value?REDACTED_DISPLAY:t.placeholder||``:this.value||t.placeholder||``;return formatPromptSubmission(this.state,t.message,n,{colors:import_picocolors.default,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(t.mask&&this.value?REDACTED_DISPLAY:this.value??``))}${this.value?.trim()?`\n${railForState(this.state)}`:``}`;default:return`${r}${railForState(this.state)}  ${o}\n${cornerForState(this.state)}${cornerNote(n?.note())}\n`}}});return n=attachQuitGuard(i),i.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:import_picocolors.default,output:process.stdout});return{async text(n){t.settle();let r=guardCancel(await textPrompt(e,n));return e+=1,r??``},async password(n){t.settle();let r=guardCancel(await textPrompt(e,{message:n.message,mask:!0,validate:n.validate}));return e+=1,r??``},async select(n){t.settle();let r=guardCancel(await runSelectComponent({message:n.message,options:n.options,multiple:n.multiple===!0,search:n.search??!1,required:n.required??!1,placeholder:n.placeholder,defaultValue:n.multiple===!0?void 0:n.initialValue,initialValues:n.multiple===!0?n.initialValues:void 0,leadingRail:e===0?`white`:`green`,attachGuard:e=>attachQuitGuard(e)}));return e+=1,r},note(e,n){t.settle(),n&&process.stdout.write(formatRailLine(import_picocolors.default.red(import_picocolors.default.bold(n)),import_picocolors.default,process.stdout)),process.stdout.write(formatRailLine(import_picocolors.default.red(e),import_picocolors.default,process.stdout))},intro(e,n=`Eve by Vercel: like Next.js, but for agents.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,import_picocolors.default))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,import_picocolors.default))},log:t}}export{createPrompter};
+import{__toESM}from"../_virtual/_rolldown/runtime.js";import{require_picocolors}from"../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js";import{h,ht,q}from"../node_modules/.pnpm/@clack_core@1.3.1/node_modules/@clack/core/dist/index.js";import{WizardCancelledError}from"./step.js";import{initialQuitGuardState,quitHintNote,reduceQuitGuard}from"./quit-guard.js";import{cornerFor,createRailLog,formatPromptCancellation,formatPromptHeader,formatPromptOpener,formatPromptOutro,formatPromptSubmission,formatRailLine,railFor,runSelectComponent}from"#setup/cli/index.js";var import_picocolors=__toESM(require_picocolors(),1);function guardCancel(e){if(q(e))throw process.stdout.write(formatPromptCancellation(`Setup cancelled.`,import_picocolors.default)),new WizardCancelledError;return e}let escapeCancelDisabled=!1;function disableEscapeCancel(){escapeCancelDisabled||=(h.aliases.delete(`escape`),!0)}function attachQuitGuard(e){let t=initialQuitGuardState;return e.on(`key`,(n,r)=>{let{state:i,action:a}=reduceQuitGuard(t,r?.name===`escape`?{type:`escape`}:{type:`other-key`});t=i,a===`quit`&&(e.state=`cancel`)}),{note:()=>quitHintNote(t,import_picocolors.default)}}function toPromptState(e){return e}function railForState(e){return railFor(toPromptState(e),import_picocolors.default)}function cornerForState(e){return cornerFor(toPromptState(e),import_picocolors.default)}function header(e,t,n){return formatPromptHeader(toPromptState(e),t,{colors:import_picocolors.default,leadingRail:n===0?`white`:`green`})}const REDACTED_DISPLAY=`••••••••`;function textPrompt(e,t){let n,i=new ht({validate:t.validate?e=>t.validate?.(e??``):void 0,placeholder:t.placeholder,defaultValue:t.defaultValue,render(){let r=header(this.state,t.message,e),i=t.placeholder?import_picocolors.default.inverse(t.placeholder[0])+import_picocolors.default.dim(t.placeholder.slice(1)):import_picocolors.default.inverse(import_picocolors.default.hidden(`_`)),a=this.value?`•`.repeat(this.value.length):i,o=t.mask?a:this.value?this.userInputWithCursor:i;switch(this.state){case`error`:return`${r.trim()}\n${railForState(this.state)}  ${o}\n${cornerForState(this.state)}  ${import_picocolors.default.red(this.error)}\n`;case`submit`:{let n=t.mask?this.value?REDACTED_DISPLAY:t.placeholder||``:this.value||t.placeholder||``;return formatPromptSubmission(this.state,t.message,n,{colors:import_picocolors.default,leadingRail:e===0?`white`:`green`})}case`cancel`:return`${r}${railForState(this.state)}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim(t.mask&&this.value?REDACTED_DISPLAY:this.value??``))}${this.value?.trim()?`\n${railForState(this.state)}`:``}`;default:return`${r}${railForState(this.state)}  ${o}\n${cornerForState(this.state)}${cornerNote(n?.note())}\n`}}});return n=attachQuitGuard(i),i.prompt()}function cornerNote(e){return e?`  ${e}`:``}function createPrompter(){disableEscapeCancel();let e=0,t=createRailLog({colors:import_picocolors.default,output:process.stdout});return{async text(n){t.settle();let r=guardCancel(await textPrompt(e,n));return e+=1,r??``},async password(n){t.settle();let r=guardCancel(await textPrompt(e,{message:n.message,mask:!0,validate:n.validate}));return e+=1,r??``},async select(n){t.settle();for(let e of n.notices??[])e.tone===`success`?t.success(e.text):e.tone===`warning`?t.warning(e.text):t.message(e.text);let r=guardCancel(await runSelectComponent({message:n.message,options:n.options,multiple:n.multiple===!0,search:n.search??!1,required:n.required??!1,placeholder:n.placeholder,defaultValue:n.multiple===!0?void 0:n.initialValue,initialValues:n.multiple===!0?n.initialValues:void 0,leadingRail:e===0?`white`:`green`,attachGuard:e=>attachQuitGuard(e)}));return e+=1,r},async acknowledge(e){t.settle(),process.stdout.write(formatRailLine(import_picocolors.default.bold(e.message),import_picocolors.default,process.stdout));for(let t of e.lines??[])process.stdout.write(formatRailLine(import_picocolors.default.dim(t),import_picocolors.default,process.stdout))},note(e,n,r){t.settle();let i=r?.tone===`success`?import_picocolors.default.green:import_picocolors.default.red;n&&process.stdout.write(formatRailLine(i(import_picocolors.default.bold(n)),import_picocolors.default,process.stdout)),process.stdout.write(formatRailLine(i(e),import_picocolors.default,process.stdout))},intro(e,n=`Production-grade agent framework.`){t.settle(),process.stdout.write(formatPromptOpener(e,n,import_picocolors.default))},outro(e){t.settle(),process.stdout.write(formatPromptOutro(e,import_picocolors.default))},log:t}}export{createPrompter};

package/dist/src/setup/quit-guard.d.ts

@@ -1,4 +1,4 @@
-import type { PromptColors } from "#setup/scaffold/cli/index.js";
+import type { PromptColors } from "#setup/cli/index.js";
 /**
  * Two-stage Escape-to-quit state for an interactive prompt.
  *

package/dist/src/setup/run-vercel-link.d.ts

@@ -1,4 +1,4 @@
-import { type RunVercelOptions } from "#setup/scaffold/primitives/index.js";
+import { type RunVercelOptions } from "#setup/primitives/index.js";
 type VercelOutputHandler = NonNullable<RunVercelOptions["onOutput"]>;
 /**
  * Runs `vercel env pull --yes` inside a linked project so `.env.local`

package/dist/src/setup/run-vercel-link.js

@@ -1 +1 @@
-import{runVercel}from"#setup/scaffold/primitives/index.js";async function runVercelEnvPull(e,t){return runVercel([`env`,`pull`,`--yes`],{cwd:e,onOutput:t})}export{runVercelEnvPull};
+import{runVercel}from"#setup/primitives/index.js";async function runVercelEnvPull(e,t){return runVercel([`env`,`pull`,`--yes`],{cwd:e,onOutput:t})}export{runVercelEnvPull};

package/dist/src/setup/runner.d.ts

@@ -36,14 +36,15 @@ export interface RunnerOptions<State> {
 /**
  * Linear interactive runner: walk the boxes in order, prompting for each. A box
  * whose `perform` throws a {@link RetryableSetupError} is re-gathered with the
- * prior input as the default; a cancel (returned as an outcome, or thrown by a
- * prompter) ends the whole run. There is no back navigation: side effects are
- * not undone by restoring in-memory state.
+ * prior input as the default; a cancel (a {@link WizardCancelledError} thrown
+ * by a prompter) ends the whole run. There is no back navigation: side effects
+ * are not undone by restoring in-memory state.
  */
 export declare function runInteractive<State>(boxes: readonly AnySetupBox<State>[], initialState: State, sink: OutputSink, options?: RunnerOptions<State>): Promise<RunResult<State>>;
 /**
  * Non-interactive runner: derive each box's input from its options and apply
  * it. No retry loop and no prompts; a box that cannot proceed without a human
- * is expected to throw from `gatherHeadless`/`perform`.
+ * is expected to throw from its gather (a unified box's headless-based asker
+ * refuses required questions with `InteractionRequired`) or from `perform`.
  */
 export declare function runHeadless<State>(boxes: readonly AnySetupBox<State>[], initialState: State, sink: OutputSink, options?: RunnerOptions<State>): Promise<State>;

package/dist/src/setup/runner.js

@@ -1 +1 @@
-import{WizardCancelledError}from"./step.js";import{ChannelAddCancelledError}from"#setup/scaffold/cli/index.js";function isCancellation(n){return n instanceof WizardCancelledError||n instanceof ChannelAddCancelledError}var RetryableSetupError=class extends Error{constructor(e,t){super(e,t),this.name=`RetryableSetupError`}};function isRetryable(e){return e instanceof RetryableSetupError}async function runInteractive(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i,a={};try{for(let t of e)if(t.shouldRun?.(view())!==!1)for(;;){let e=await t.gatherInteractive({state:view(),initial:a[t.id]});if(e.kind===`cancelled`)return{kind:`cancelled`};a[t.id]=e.input;try{let r=await t.perform({state:view(),input:e.input,sink:n});i=t.apply(i,r);break}catch(e){if(!isRetryable(e))throw e;n.write(e instanceof Error?e.message:String(e))}}}catch(e){if(isCancellation(e))return{kind:`cancelled`};throw e}return{kind:`done`,state:i}}async function runHeadless(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i;for(let t of e){if(t.shouldRun?.(view())===!1)continue;let e=await t.gatherHeadless({state:view()}),r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r)}return i}export{RetryableSetupError,runHeadless,runInteractive};
+import{WizardCancelledError}from"./step.js";function isCancellation(t){return t instanceof WizardCancelledError}var RetryableSetupError=class extends Error{constructor(e,t){super(e,t),this.name=`RetryableSetupError`}};function isRetryable(e){return e instanceof RetryableSetupError}async function runInteractive(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i,a={};try{for(let t of e)if(t.shouldRun?.(view())!==!1)for(;;){let e=await t.gather({state:view(),initial:a[t.id]});a[t.id]=e;try{let r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r);break}catch(e){if(!isRetryable(e))throw e;n.write(e instanceof Error?e.message:String(e))}}}catch(e){if(isCancellation(e))return{kind:`cancelled`};throw e}return{kind:`done`,state:i}}async function runHeadless(e,t,n,r){let i=t,view=()=>r?.snapshot?r.snapshot(i):i;for(let t of e){if(t.shouldRun?.(view())===!1)continue;let e=await t.gather({state:view()}),r=await t.perform({state:view(),input:e,sink:n});i=t.apply(i,r)}return i}export{RetryableSetupError,runHeadless,runInteractive};

package/dist/src/setup/scaffold/channels-catalog.d.ts

@@ -1,6 +1,6 @@
 /**
- * Build-time catalog of the channels the onboarding CLI can scaffold. It drives
- * the `Select channels` picker shown during create and `eve channels add`.
+ * Build-time catalog of channels used by programmatic setup and
+ * `eve channels add`.
  *
  * Channel *identity* (slug, name, and whether it is scaffoldable) is owned by
  * `@vercel/eve-catalog`, the cross-surface source of truth shared with the docs
@@ -9,7 +9,7 @@
  * as `web`), the picker copy, and the picker order — and validates that the
  * overlay and the catalog cannot drift apart.
  */
-import type { ChannelKind } from "./channels.js";
+import type { ChannelKind } from "./update/channels.js";
 /** A catalog channel the CLI can scaffold, paired with its picker presentation. */
 export interface ScaffoldableChannel {
     /** Catalog slug. */

package/dist/src/setup/scaffold/channels-catalog.js

@@ -1 +1 @@
-import{channelEntries}from"../../packages/eve-catalog/src/index.js";const CHANNEL_SCAFFOLDS=[{slug:`eve`,kind:`web`,label:`Web Chat`},{slug:`slack`,kind:`slack`,label:`Slack`,hint:`creates slackbot and deploys to Vercel`}];function buildScaffoldableChannels(){let n=new Set(channelEntries().filter(e=>e.surfaces.scaffoldable).map(e=>e.slug)),r=[];for(let e of CHANNEL_SCAFFOLDS){if(!n.delete(e.slug))throw Error(`Channel overlay "${e.slug}" is not a scaffoldable channel in @vercel/eve-catalog.`);let t={slug:e.slug,kind:e.kind,label:e.label};e.hint!==void 0&&(t.hint=e.hint),r.push(t)}if(n.size>0){let e=[...n].sort().join(`, `);throw Error(`Scaffoldable catalog channels missing a scaffolder overlay: ${e}.`)}return r}const SCAFFOLDABLE_CHANNELS=buildScaffoldableChannels();export{SCAFFOLDABLE_CHANNELS};
+import{channelEntries}from"../../packages/eve-catalog/src/index.js";const CHANNEL_SCAFFOLDS=[{slug:`eve`,kind:`web`,label:`Web Chat`,hint:`Next.js app`},{slug:`slack`,kind:`slack`,label:`Slack`,hint:`creates slackbot and deploys to Vercel`}];function buildScaffoldableChannels(){let n=new Set(channelEntries().filter(e=>e.surfaces.scaffoldable).map(e=>e.slug)),r=[];for(let e of CHANNEL_SCAFFOLDS){if(!n.delete(e.slug))throw Error(`Channel overlay "${e.slug}" is not a scaffoldable channel in @vercel/eve-catalog.`);let t={slug:e.slug,kind:e.kind,label:e.label};e.hint!==void 0&&(t.hint=e.hint),r.push(t)}if(n.size>0){let e=[...n].sort().join(`, `);throw Error(`Scaffoldable catalog channels missing a scaffolder overlay: ${e}.`)}return r}const SCAFFOLDABLE_CHANNELS=buildScaffoldableChannels();export{SCAFFOLDABLE_CHANNELS};