@arizeai/phoenix-cli 1.8.0 → 1.9.0

package/build/setup/runSetup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The setup step sequence, and nothing else.
+ *
+ * All effects flow through `SetupDeps`; all strings live in `copy.ts`;
+ * cancellation unwinds via `SetupCancelledError` to the command handler.
+ *
+ * Three entry points, composed from the same steps:
+ *   - `runSetup`      — the whole flow (`px setup`)
+ *   - `runInstrument` — register, then instrument and verify (`px setup instrument`)
+ *   - `runSkills`     — the tooling installs alone (`px setup skills`)
+ * Each returns a {@link SetupReport}, which the command layer renders in the
+ * requested `--format`.
+ */
+import type { DocsPrefetchResult, SetupDeps } from "./deps/index.js";
+import type { SetupInputs } from "./options.js";
+import type { Connection } from "./steps/establishConnection.js";
+import { type ToolingResult } from "./steps/installTooling.js";
+import { type InstrumentationLane } from "./steps/instrumentApp.js";
+/** Everything a run did, in the shape the summary and `--format json` print. */
+export interface SetupReport {
+    connection: Connection;
+    authEnabled: boolean;
+    headless: boolean;
+    /** Files setup wrote into the repo. */
+    files: string[];
+    /** Paths appended to a .gitignore. */
+    gitignored: string[];
+    docs?: DocsPrefetchResult;
+    instrumentation?: InstrumentationLane;
+    /** True once the API confirmed a trace arrived after this run started. */
+    tracesVerified?: boolean;
+    tooling?: ToolingResult;
+    tracesUrl: string;
+}
+/** `px setup` — the whole flow. */
+export declare function runSetup(deps: SetupDeps, inputs: SetupInputs): Promise<SetupReport>;
+/**
+ * `px setup instrument` — the instrumentation slice, re-runnable on a repo that
+ * is already registered. Registration still runs: it is idempotent, and it is
+ * what produces the connection the agent and the verification step need.
+ */
+export declare function runInstrument(deps: SetupDeps, resolved: SetupInputs): Promise<SetupReport>;
+/** `px setup skills` — the tooling installs alone; no connection needed. */
+export declare function runSkills(deps: SetupDeps, inputs: SetupInputs): Promise<ToolingResult>;
+//# sourceMappingURL=runSetup.d.ts.map

package/build/setup/runSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSetup.d.ts","sourceRoot":"","sources":["../../src/setup/runSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAUhF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD,mCAAmC;AACnC,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CA8CtB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAetB;AAED,4EAA4E;AAC5E,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/build/setup/runSetup.js

@@ -0,0 +1,212 @@
+/**
+ * The setup step sequence, and nothing else.
+ *
+ * All effects flow through `SetupDeps`; all strings live in `copy.ts`;
+ * cancellation unwinds via `SetupCancelledError` to the command handler.
+ *
+ * Three entry points, composed from the same steps:
+ *   - `runSetup`      — the whole flow (`px setup`)
+ *   - `runInstrument` — register, then instrument and verify (`px setup instrument`)
+ *   - `runSkills`     — the tooling installs alone (`px setup skills`)
+ * Each returns a {@link SetupReport}, which the command layer renders in the
+ * requested `--format`.
+ */
+import { detectCodingAgents, probeGlobalBinary, } from "./agents/registry.js";
+import * as COPY from "./copy.js";
+import { SetupCancelledError } from "./errors.js";
+import { assertAgentForHeadlessInstrument } from "./options.js";
+import { chooseEndpoint } from "./steps/chooseEndpoint.js";
+import { confirmGitSafety } from "./steps/confirmGitSafety.js";
+import { establishConnection } from "./steps/establishConnection.js";
+import { offerToolingInstalls, } from "./steps/installTooling.js";
+import { instrumentApp } from "./steps/instrumentApp.js";
+import { offerPxProfile } from "./steps/offerPxProfile.js";
+import { prefetchDocs } from "./steps/prefetchDocs.js";
+import { hasSpansInSkewWindow, waitForFirstTrace, tracesUrl, } from "./steps/verifyTraces.js";
+import { ENV_FILE_NAME, writeEnvFile } from "./steps/writeEnvFile.js";
+/**
+ * Detect the installed agents — but only when the lane is still open. `--agent`
+ * pins it, and the pinned agent probes its own binary, so the sweep's four
+ * subprocess spawns would be thrown away. Every headless instrumentation run
+ * names an agent, so that is exactly where the waste would land.
+ */
+function detectAgentsUnlessPinned(deps, inputs) {
+    return inputs.agent ? Promise.resolve([]) : detectCodingAgents(deps);
+}
+/** `px setup` — the whole flow. */
+export async function runSetup(deps, inputs) {
+    // Started before the first prompt so the probes finish behind it; awaited
+    // by the instrumentation and tooling steps.
+    const agentDetection = detectAgentsUnlessPinned(deps, inputs);
+    // Probed with package-runner bin dirs stripped from PATH — under
+    // `npx @arizeai/phoenix-cli setup`, the package's own `px` shim must not
+    // masquerade as a global install and suppress the CLI-install offer.
+    const pxOnPath = probeGlobalBinary(deps, "px");
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO);
+    }
+    const report = await registerAndInstrument(deps, inputs, { agentDetection });
+    // A headless run stops here: the tooling offers are prompts, and its stdout
+    // belongs to the summary.
+    if (inputs.headless) {
+        return report;
+    }
+    // Tooling opt-ins come after the verified-trace moment so nothing stands
+    // between launch and first trace: point px at this project, then install the
+    // CLI and skills so the user (and their coding agent) can look at the traces
+    // now flowing.
+    await offerPxProfile(deps, {
+        connection: report.connection,
+        settingsPath: deps.context.settingsPath,
+    });
+    const tooling = await offerToolingInstalls(deps, {
+        pxOnPath,
+        skills: inputs.skills,
+        canPrompt: true,
+    });
+    deps.prompter.note(report.authEnabled
+        ? COPY.PRODUCTION.bodyAuthOn
+        : COPY.PRODUCTION.bodyAuthOff, COPY.PRODUCTION.title);
+    // Untitled: the outro below already says it, and closes the rail.
+    deps.prompter.note(COPY.OUTRO_BODY);
+    deps.prompter.outro(COPY.OUTRO_TITLE);
+    return { ...report, tooling };
+}
+/**
+ * `px setup instrument` — the instrumentation slice, re-runnable on a repo that
+ * is already registered. Registration still runs: it is idempotent, and it is
+ * what produces the connection the agent and the verification step need.
+ */
+export async function runInstrument(deps, resolved) {
+    // This lane instruments by definition, so it never passes `--instrument` for
+    // `resolveSetupInputs` to have guarded — check the headless rule here.
+    assertAgentForHeadlessInstrument(resolved);
+    const inputs = { ...resolved, instrument: true };
+    const agentDetection = detectAgentsUnlessPinned(deps, inputs);
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO_INSTRUMENT);
+    }
+    const report = await registerAndInstrument(deps, inputs, { agentDetection });
+    if (!inputs.headless) {
+        deps.prompter.outro(COPY.OUTRO_TITLE);
+    }
+    return report;
+}
+/** `px setup skills` — the tooling installs alone; no connection needed. */
+export async function runSkills(deps, inputs) {
+    const pxOnPath = probeGlobalBinary(deps, "px");
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO_SKILLS);
+    }
+    const tooling = await offerToolingInstalls(deps, {
+        pxOnPath,
+        skills: inputs.skills,
+        canPrompt: !inputs.headless,
+    });
+    if (!inputs.headless) {
+        deps.prompter.outro(COPY.OUTRO_TITLE);
+    }
+    return tooling;
+}
+/**
+ * Register, then — when asked — prefetch docs, hand off to the agent, and
+ * verify traces. The shared spine of `px setup` and `px setup instrument`.
+ */
+async function registerAndInstrument(deps, inputs, { agentDetection }) {
+    const registration = await register(deps, inputs);
+    const { connection, authEnabled, gitignoreAppended } = registration;
+    const base = {
+        connection,
+        authEnabled,
+        headless: inputs.headless,
+        files: [ENV_FILE_NAME],
+        gitignored: gitignoreAppended,
+        tracesUrl: tracesUrl(connection),
+    };
+    if (!inputs.instrument) {
+        return base;
+    }
+    // Only after registration's git-safety gate: the docs fetch writes into
+    // `.px/`, which an earlier download can make look like a pre-existing dirty
+    // tree in a fast or cached headless run.
+    const docs = await prefetchDocs(deps, {
+        docs: inputs.docs,
+        isGitRepository: registration.isGitRepository,
+    });
+    const startedAt = deps.clock.now();
+    // Any span already visible inside the clock-skew window predates this run —
+    // verification must then require spans strictly after the start time, or a
+    // pre-existing trace would falsely verify the hand-off.
+    const hadRecentSpans = await hasSpansInSkewWindow(deps, connection, {
+        sinceMs: startedAt,
+    });
+    const instrumentation = await instrumentApp(deps, connection, {
+        authEnabled,
+        agentDetection,
+        agent: inputs.agent,
+        languages: inputs.languages,
+        mode: {
+            background: inputs.background,
+            bypassPermissions: inputs.bypassPermissions,
+        },
+        ...(docs ? { docs } : {}),
+    });
+    // The return value is setup's definition of done — a trace the API confirmed
+    // arriving, not the agent's own claim that it finished. It is reported, not
+    // thrown on: the connection and hand-off files are real work worth keeping
+    // even when no trace showed up.
+    const tracesVerified = await waitForFirstTrace(deps, connection, {
+        sinceMs: startedAt,
+        allowClockSkew: !hadRecentSpans,
+        headless: inputs.headless,
+    });
+    return {
+        ...base,
+        ...(docs ? { docs } : {}),
+        // The docs step gitignores its own output dir, so the report has to fold
+        // those appends in or it under-states what setup touched.
+        gitignored: [...base.gitignored, ...(docs?.gitignoreAppended ?? [])],
+        instrumentation,
+        tracesVerified,
+    };
+}
+/**
+ * Git safety, endpoint, connection, env file — the part every lane shares, and
+ * all a registration-only run performs.
+ */
+async function register(deps, inputs) {
+    const { headless } = inputs;
+    const git = await confirmGitSafety(deps, { headless });
+    if (!git.proceed) {
+        throw new SetupCancelledError();
+    }
+    // The hidden --api-url dev flag never reaches this endpoint — it is applied
+    // as the client's base URL in buildDefaultDeps, so API traffic is rerouted
+    // while hand-off files, the px profile, and traces URLs keep the endpoint
+    // resolved here.
+    const endpointChoice = await chooseEndpoint(deps, {
+        presetEndpoint: inputs.endpoint,
+        headless,
+    });
+    const connection = await establishConnection(deps, {
+        endpoint: endpointChoice.endpoint,
+        authEnabled: endpointChoice.authEnabled,
+        inputs,
+    });
+    const envFile = writeEnvFile(deps, connection, {
+        isGitRepository: git.isGitRepository,
+    });
+    if (!headless) {
+        deps.prompter.line(COPY.ENV_FILE.wrote([ENV_FILE_NAME]));
+        if (envFile.gitignoreAppended.length > 0) {
+            deps.prompter.line(COPY.ENV_FILE.gitignored(envFile.gitignoreAppended));
+        }
+    }
+    return {
+        connection,
+        authEnabled: endpointChoice.authEnabled,
+        gitignoreAppended: envFile.gitignoreAppended,
+        isGitRepository: git.isGitRepository,
+    };
+}
+//# sourceMappingURL=runSetup.js.map

package/build/setup/runSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSetup.js","sourceRoot":"","sources":["../../src/setup/runSetup.ts"],"names":[],"mappings":"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"}

package/build/setup/steps/chooseEndpoint.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Choose the endpoint: where Phoenix is, and whether it wants an API key.
+ *
+ * Two options — Local or Remote ("paste your instance URL"). The probe is
+ * an unauthenticated
+ * `GET /v1/projects?limit=1`: 200 → auth off, 401/403 → auth on, anything
+ * else → troubleshoot copy and re-ask (max 3 attempts).
+ */
+import type { SetupDeps } from "../deps/index.js";
+export interface EndpointChoice {
+    /** Normalized origin, no trailing slash. */
+    endpoint: string;
+    authEnabled: boolean;
+}
+export type ProbeOutcome = {
+    kind: "authOff";
+} | {
+    kind: "authOn";
+} | {
+    kind: "unreachable";
+    detail: string;
+} | {
+    kind: "notPhoenix";
+    detail: string;
+};
+/**
+ * Probe an endpoint to determine reachability and whether auth is enabled.
+ */
+export declare function probeEndpoint(deps: Pick<SetupDeps, "createClient">, endpoint: string): Promise<ProbeOutcome>;
+export interface ChooseEndpointArgs {
+    /** Pre-answered endpoint from --endpoint / env (skips the select). */
+    presetEndpoint?: string;
+    headless: boolean;
+}
+export declare function chooseEndpoint(deps: Pick<SetupDeps, "createClient" | "prompter">, { presetEndpoint, headless }: ChooseEndpointArgs): Promise<EndpointChoice>;
+//# sourceMappingURL=chooseEndpoint.d.ts.map

package/build/setup/steps/chooseEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chooseEndpoint.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/chooseEndpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAsBvB;AA+BD,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,CAAC,EAClD,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAC/C,OAAO,CAAC,cAAc,CAAC,CA+DzB"}

package/build/setup/steps/chooseEndpoint.js

@@ -0,0 +1,125 @@
+/**
+ * Choose the endpoint: where Phoenix is, and whether it wants an API key.
+ *
+ * Two options — Local or Remote ("paste your instance URL"). The probe is
+ * an unauthenticated
+ * `GET /v1/projects?limit=1`: 200 → auth off, 401/403 → auth on, anything
+ * else → troubleshoot copy and re-ask (max 3 attempts).
+ */
+import { HttpError } from "@arizeai/phoenix-client";
+import { isEndpointUrl, normalizeEndpoint } from "../../validation/endpoint.js";
+import * as COPY from "../copy.js";
+import { HeadlessInputError, SetupCancelledError, SetupFatalError, } from "../errors.js";
+import { redactForDisplay } from "../util/redact.js";
+const PROBE_TIMEOUT_MS = 10_000;
+const MAX_ATTEMPTS = 3;
+const DEFAULT_LOCAL_ENDPOINT = "http://localhost:6006";
+/**
+ * Probe an endpoint to determine reachability and whether auth is enabled.
+ */
+export async function probeEndpoint(deps, endpoint) {
+    const client = deps.createClient({ endpoint });
+    try {
+        await client.GET("/v1/projects", {
+            params: { query: { limit: 1 } },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        return { kind: "authOff" };
+    }
+    catch (error) {
+        if (error instanceof HttpError) {
+            if (error.status === 401 || error.status === 403) {
+                return { kind: "authOn" };
+            }
+            return { kind: "notPhoenix", detail: `HTTP ${error.status}` };
+        }
+        // A 2xx whose body will not parse: something is listening, but it is not
+        // the Phoenix API.
+        if (error instanceof SyntaxError) {
+            return { kind: "notPhoenix", detail: COPY.ENDPOINT.unexpectedBody };
+        }
+        return { kind: "unreachable", detail: redactForDisplay(String(error)) };
+    }
+}
+async function promptForEndpoint(deps) {
+    const choice = await deps.prompter.select({
+        message: COPY.ENDPOINT.selectMessage,
+        options: [
+            {
+                value: "local",
+                label: COPY.ENDPOINT.localLabel,
+                hint: COPY.ENDPOINT.localHint,
+            },
+            {
+                value: "remote",
+                label: COPY.ENDPOINT.remoteLabel,
+                hint: COPY.ENDPOINT.remoteHint,
+            },
+        ],
+    });
+    if (choice === "local") {
+        return DEFAULT_LOCAL_ENDPOINT;
+    }
+    const url = await deps.prompter.textInput({
+        message: COPY.ENDPOINT.remoteUrlMessage,
+        validate: (value) => isEndpointUrl(value) ? undefined : COPY.ENDPOINT.remoteUrlInvalid,
+    });
+    return url;
+}
+export async function chooseEndpoint(deps, { presetEndpoint, headless }) {
+    let attempts = 0;
+    let candidate = presetEndpoint;
+    for (;;) {
+        if (candidate === undefined) {
+            if (headless) {
+                throw new HeadlessInputError(COPY.ENDPOINT.headlessNeedsEndpoint);
+            }
+            candidate = await promptForEndpoint(deps);
+        }
+        let endpoint;
+        try {
+            endpoint = normalizeEndpoint(candidate);
+        }
+        catch {
+            if (headless) {
+                throw new HeadlessInputError(COPY.ENDPOINT.remoteUrlInvalid);
+            }
+            deps.prompter.line(COPY.ENDPOINT.remoteUrlInvalid);
+            candidate = undefined;
+            continue;
+        }
+        deps.prompter.line(COPY.ENDPOINT.probing(endpoint));
+        const outcome = await probeEndpoint(deps, endpoint);
+        if (outcome.kind === "authOff") {
+            deps.prompter.line(COPY.ENDPOINT.authOff);
+            return { endpoint, authEnabled: false };
+        }
+        if (outcome.kind === "authOn") {
+            deps.prompter.line(COPY.ENDPOINT.authOn);
+            return { endpoint, authEnabled: true };
+        }
+        if (headless) {
+            throw new SetupFatalError(COPY.ENDPOINT.headlessUnreachable(endpoint));
+        }
+        attempts += 1;
+        deps.prompter.line(outcome.kind === "unreachable"
+            ? COPY.ENDPOINT.unreachable(endpoint)
+            : COPY.ENDPOINT.notPhoenix(endpoint, outcome.detail));
+        if (attempts >= MAX_ATTEMPTS) {
+            deps.prompter.line(COPY.ENDPOINT.gaveUp);
+            throw new SetupCancelledError();
+        }
+        const retry = await deps.prompter.select({
+            message: COPY.ENDPOINT.retryMessage,
+            options: [
+                { value: true, label: COPY.ENDPOINT.retryYes },
+                { value: false, label: COPY.ENDPOINT.retryNo },
+            ],
+        });
+        if (!retry) {
+            throw new SetupCancelledError();
+        }
+        candidate = undefined;
+    }
+}
+//# sourceMappingURL=chooseEndpoint.js.map

package/build/setup/steps/chooseEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chooseEndpoint.js","sourceRoot":"","sources":["../../../src/setup/steps/chooseEndpoint.ts"],"names":[],"mappings":"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"}

package/build/setup/steps/confirmGitSafety.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Confirm git can undo whatever setup is about to do.
+ *
+ * A coding agent may be about to edit files in this directory; git is the
+ * undo button. Both gates are opt-in selects with the safe option first.
+ * Headless mode proceeds only on a clean repo.
+ */
+import type { SetupDeps } from "../deps/index.js";
+export interface GitSafetyResult {
+    isGitRepository: boolean;
+    /** False when the user chose to stop at a gate. */
+    proceed: boolean;
+}
+export declare function confirmGitSafety(deps: Pick<SetupDeps, "context" | "processes" | "prompter">, { headless }: {
+    headless: boolean;
+}): Promise<GitSafetyResult>;
+//# sourceMappingURL=confirmGitSafety.d.ts.map

package/build/setup/steps/confirmGitSafety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmGitSafety.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/confirmGitSafety.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,EAC3D,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,eAAe,CAAC,CAmE1B"}

package/build/setup/steps/confirmGitSafety.js

@@ -0,0 +1,73 @@
+/**
+ * Confirm git can undo whatever setup is about to do.
+ *
+ * A coding agent may be about to edit files in this directory; git is the
+ * undo button. Both gates are opt-in selects with the safe option first.
+ * Headless mode proceeds only on a clean repo.
+ */
+import * as COPY from "../copy.js";
+import { SetupFatalError } from "../errors.js";
+import { selectBoolean } from "../ui/selectBoolean.js";
+const MAX_LISTED_FILES = 20;
+export async function confirmGitSafety(deps, { headless }) {
+    const repoCheck = await deps.processes.exec({
+        command: "git",
+        args: ["rev-parse", "--is-inside-work-tree"],
+        cwd: deps.context.cwd,
+    });
+    const isGitRepository = repoCheck.exitCode === 0 && repoCheck.stdout.trim() === "true";
+    if (!isGitRepository) {
+        // `git` missing entirely is treated the same as "not a repo".
+        if (headless) {
+            throw new SetupFatalError(COPY.GIT.headlessNotARepo);
+        }
+        const proceed = await selectBoolean({
+            prompter: deps.prompter,
+            message: COPY.GIT.notARepoMessage,
+            noFirst: true,
+            noLabel: COPY.GIT.notARepoNo,
+            noHint: COPY.GIT.notARepoNoHint,
+            yesLabel: COPY.GIT.notARepoYes,
+            yesHint: COPY.GIT.notARepoYesHint,
+        });
+        if (!proceed) {
+            deps.prompter.line(COPY.GIT.stopped);
+        }
+        return { isGitRepository, proceed };
+    }
+    const statusCheck = await deps.processes.exec({
+        command: "git",
+        args: ["status", "--porcelain=v1"],
+        cwd: deps.context.cwd,
+    });
+    const dirtyPaths = statusCheck.stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (dirtyPaths.length === 0) {
+        return { isGitRepository, proceed: true };
+    }
+    if (headless) {
+        throw new SetupFatalError(COPY.GIT.headlessDirty);
+    }
+    const shown = dirtyPaths.slice(0, MAX_LISTED_FILES);
+    const lines = [...shown];
+    if (dirtyPaths.length > MAX_LISTED_FILES) {
+        lines.push(COPY.GIT.andMore(dirtyPaths.length - MAX_LISTED_FILES));
+    }
+    deps.prompter.note(lines.join("\n"), COPY.GIT.dirtyFileListTitle);
+    const proceed = await selectBoolean({
+        prompter: deps.prompter,
+        message: COPY.GIT.dirtyMessage(dirtyPaths.length),
+        noFirst: true,
+        noLabel: COPY.GIT.dirtyNo,
+        noHint: COPY.GIT.dirtyNoHint,
+        yesLabel: COPY.GIT.dirtyYes,
+        yesHint: COPY.GIT.dirtyYesHint,
+    });
+    if (!proceed) {
+        deps.prompter.line(COPY.GIT.stopped);
+    }
+    return { isGitRepository, proceed };
+}
+//# sourceMappingURL=confirmGitSafety.js.map

package/build/setup/steps/confirmGitSafety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmGitSafety.js","sourceRoot":"","sources":["../../../src/setup/steps/confirmGitSafety.ts"],"names":[],"mappings":"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"}

package/build/setup/steps/establishConnection.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Establish the connection.
+ *
+ * The project itself is never created here — Phoenix creates a project on
+ * first ingestion, so setup only needs to settle on a *name* and hand it
+ * to the app via `PHOENIX_PROJECT_NAME`. What remains is credential
+ * acquisition: the auth-on lanes verify the key with a read-only probe so a
+ * bad paste is caught here rather than at first trace. Future OAuth
+ * acquisition plugs into the auth-on interactive lane unchanged.
+ */
+import type { SetupDeps } from "../deps/index.js";
+import type { SetupInputs } from "../options.js";
+export interface Connection {
+    /** Normalized origin, no trailing slash. */
+    endpoint: string;
+    projectName: string;
+    /** Present iff auth is enabled on the deployment. */
+    apiKey?: string;
+}
+/** Names are used as URL path identifiers; '/', '?', '#' are invalid. */
+export declare function validateProjectName(value: string): string | undefined;
+export declare function defaultProjectName(cwd: string): string;
+export interface EstablishConnectionArgs {
+    endpoint: string;
+    authEnabled: boolean;
+    inputs: SetupInputs;
+}
+export declare function establishConnection(deps: Pick<SetupDeps, "context" | "createClient" | "prompter">, { endpoint, authEnabled, inputs }: EstablishConnectionArgs): Promise<Connection>;
+//# sourceMappingURL=establishConnection.d.ts.map

package/build/setup/steps/establishConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"establishConnection.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/establishConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AA+ID,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC,EAC9D,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,uBAAuB,GACzD,OAAO,CAAC,UAAU,CAAC,CAgBrB"}