p-dev-harness 0.3.0

package/dist/setup/vercel-setup-plan.d.ts

@@ -0,0 +1,132 @@
+import { listVercelProjects, listVercelTeams, type VercelProductionUrlSource } from "./vercel-setup-client.js";
+import { deriveVercelBridgeReadiness, OPTIONAL_VERCEL_BRIDGE_ENV_VARS, type VercelBridgeEnvVarName } from "./vercel-bridge-readiness.js";
+import { SETUP_PERMISSIONS } from "./permission-model.js";
+export declare const VERCEL_SETUP_ACTIONS: {
+    readonly preview: {
+        readonly id: "preview-vercel-bridge";
+        readonly permission: {
+            readonly scope: "remote-read";
+            readonly confirmation: "standard";
+            readonly manualAlternative: true;
+        };
+    };
+    readonly apply: {
+        readonly id: "apply-vercel-bridge";
+        readonly permission: {
+            readonly scope: "remote-secret-write";
+            readonly confirmation: "strong";
+            readonly manualAlternative: true;
+        };
+    };
+};
+export interface VercelBridgeEnvInput {
+    LINEAR_WEBHOOK_SECRET?: string;
+    GITHUB_DISPATCH_TOKEN?: string;
+    HARNESS_TEAM_KEY?: string;
+    GITHUB_DISPATCH_REPOSITORY?: string;
+    GITHUB_DISPATCH_EVENT_TYPE?: string;
+    LINEAR_WEBHOOK_TIMESTAMP_TOLERANCE_MS?: string;
+}
+export interface VercelBridgeTeamInput {
+    mode: "existing" | "create";
+    teamId?: string;
+    teamName?: string;
+    teamSlug?: string;
+}
+export interface VercelBridgeProjectInput {
+    mode: "existing" | "create";
+    projectId?: string;
+    projectName?: string;
+}
+export interface VercelBridgePlanInput {
+    vercelToken: string;
+    teamId?: string;
+    projectId?: string;
+    projectName?: string;
+    team?: VercelBridgeTeamInput;
+    project?: VercelBridgeProjectInput;
+    linearApiKey?: string;
+    linearTeamId?: string;
+    envInput?: VercelBridgeEnvInput;
+    derivedHarnessTeamKey?: string;
+    derivedGithubDispatchToken?: string;
+    willGenerateLinearWebhookSecret?: boolean;
+    /** Raw secret for verify/retry paths only; does not affect preview fingerprinting. */
+    verificationLinearWebhookSecret?: string;
+    /** Keep generated-secret preview semantics ("generate-on-apply") while verifying. */
+    preserveGeneratedWebhookSecretFingerprint?: boolean;
+    /** When set, resolve production URL from this READY deployment (post-redeploy verify). */
+    preferredProductionDeploymentId?: string;
+}
+export interface VercelEnvWritePlanEntry {
+    key: VercelBridgeEnvVarName | (typeof OPTIONAL_VERCEL_BRIDGE_ENV_VARS)[number];
+    action: "create" | "update" | "skip";
+    source: "operator-input" | "default" | "preserve-existing" | "missing-input" | "derived" | "generated";
+    existingType?: string;
+    desiredType?: string;
+}
+export interface VercelBridgePreview {
+    actionId: string;
+    teams: Awaited<ReturnType<typeof listVercelTeams>>;
+    projects: Awaited<ReturnType<typeof listVercelProjects>>;
+    selectedProject?: Awaited<ReturnType<typeof listVercelProjects>>[number];
+    productionUrl?: string;
+    webhookUrl?: string;
+    productionUrlSource?: VercelProductionUrlSource;
+    canonicalDeploymentId?: string;
+    deploymentStatus: "ready" | "missing" | "project-will-be-created";
+    deploymentRequired?: {
+        message: string;
+        nextSteps: string[];
+    };
+    endpointReachable: boolean;
+    endpointStatusCode?: number;
+    envWritePlan: VercelEnvWritePlanEntry[];
+    requiredEnvPresence: Record<VercelBridgeEnvVarName, "present" | "missing">;
+    linearWebhookVerified: boolean;
+    signedProbeVerified?: boolean;
+    deploymentRedeployRequired?: boolean;
+    signedProbeReason?: string;
+    linearWebhookSecretMode?: "automated" | "existing-unverified" | "manual-copy";
+    githubDispatchSource?: "saved-github-token" | "operator-input" | "missing";
+    readiness: ReturnType<typeof deriveVercelBridgeReadiness>;
+    manualSteps: string[];
+    fingerprint: string;
+    permission: typeof SETUP_PERMISSIONS.remoteRead;
+    validationError?: string;
+}
+export declare function buildVercelBridgePreviewFingerprintInput(input: {
+    teamId?: string;
+    teamMode?: string;
+    teamSlug?: string;
+    projectId: string;
+    projectMode?: string;
+    projectName?: string;
+    envWritePlan: VercelEnvWritePlanEntry[];
+    willGenerateLinearWebhookSecret: boolean;
+    linearWebhookSecretFromEnv?: string;
+    githubDispatchTokenFromEnv?: string;
+    derivedGithubDispatchToken?: string;
+    harnessTeamKey?: string;
+    derivedHarnessTeamKey?: string;
+    vercelToken: string;
+}): import("./control-plane-types.js").VercelBridgePreviewFingerprintInputs;
+export declare function hashVercelBridgePreviewFingerprint(input: import("./control-plane-types.js").VercelBridgePreviewFingerprintInputs): string;
+export declare function diffVercelBridgePreviewFingerprintInputs(original: import("./control-plane-types.js").VercelBridgePreviewFingerprintInputs, reconstructed: import("./control-plane-types.js").VercelBridgePreviewFingerprintInputs): string[];
+export declare function buildDeploymentRequiredDetail(input: {
+    projectName: string;
+    projectJustCreated: boolean;
+}): {
+    message: string;
+    nextSteps: string[];
+};
+export declare function normalizeVercelBridgePlanInput(input: VercelBridgePlanInput): VercelBridgePlanInput;
+export declare function resolveVercelBridgeEnvValue(input: {
+    key: VercelEnvWritePlanEntry["key"];
+    envInput?: VercelBridgeEnvInput;
+    derivedHarnessTeamKey?: string;
+    derivedGithubDispatchToken?: string;
+    generatedLinearWebhookSecret?: string;
+}): string | undefined;
+export declare function previewVercelBridgeSetup(input: VercelBridgePlanInput): Promise<VercelBridgePreview>;
+//# sourceMappingURL=vercel-setup-plan.d.ts.map

package/dist/setup/vercel-setup-plan.d.ts.map

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

package/dist/setup/vercel-setup-plan.js

@@ -0,0 +1,452 @@
+import { createHash } from "node:crypto";
+import { checkWebhookEndpointReachable, findExistingProjectByName, findExistingTeamBySlug, getDefaultEnvVarType, listVercelProjectEnvVars, listVercelProjects, listVercelTeams, resolveCanonicalProductionTarget, summarizeRequiredEnvPresence, } from "./vercel-setup-client.js";
+import { DEFAULT_VERCEL_BRIDGE_ENV_DEFAULTS, deriveVercelBridgeReadiness, OPTIONAL_VERCEL_BRIDGE_ENV_VARS, REQUIRED_VERCEL_BRIDGE_ENV_VARS, } from "./vercel-bridge-readiness.js";
+import { summarizeLinearWebhookReadiness } from "./linear-setup-plan.js";
+import { planLinearWebhookSecret } from "./linear-webhook-secret.js";
+import { SETUP_PERMISSIONS } from "./permission-model.js";
+import { tokenizeSecretInput } from "./secret-change-token.js";
+export const VERCEL_SETUP_ACTIONS = {
+    preview: {
+        id: "preview-vercel-bridge",
+        permission: SETUP_PERMISSIONS.remoteRead,
+    },
+    apply: {
+        id: "apply-vercel-bridge",
+        permission: SETUP_PERMISSIONS.remoteSecretWrite,
+    },
+};
+function hashPreview(input) {
+    return createHash("sha256")
+        .update(JSON.stringify(input))
+        .digest("hex")
+        .slice(0, 16);
+}
+export function buildVercelBridgePreviewFingerprintInput(input) {
+    return {
+        actionId: VERCEL_SETUP_ACTIONS.preview.id,
+        teamId: input.teamId,
+        teamMode: input.teamMode,
+        teamSlug: input.teamSlug,
+        projectId: input.projectId,
+        projectMode: input.projectMode,
+        projectName: input.projectName,
+        envWritePlan: input.envWritePlan.map((entry) => ({
+            key: entry.key,
+            action: entry.action,
+            source: entry.source,
+            existingType: entry.existingType,
+            desiredType: entry.desiredType,
+        })),
+        linearWebhookSecretToken: input.willGenerateLinearWebhookSecret
+            ? "generate-on-apply"
+            : tokenizeSecretInput(input.linearWebhookSecretFromEnv),
+        githubDispatchTokenToken: tokenizeSecretInput(input.githubDispatchTokenFromEnv ?? input.derivedGithubDispatchToken),
+        harnessTeamKey: input.harnessTeamKey ?? input.derivedHarnessTeamKey ?? "",
+        vercelTokenToken: tokenizeSecretInput(input.vercelToken),
+    };
+}
+export function hashVercelBridgePreviewFingerprint(input) {
+    return hashPreview(input);
+}
+export function diffVercelBridgePreviewFingerprintInputs(original, reconstructed) {
+    const differingKeys = [];
+    const keys = new Set([
+        ...Object.keys(original),
+        ...Object.keys(reconstructed),
+    ]);
+    for (const key of keys) {
+        const left = original[key];
+        const right = reconstructed[key];
+        if (JSON.stringify(left) !== JSON.stringify(right)) {
+            differingKeys.push(String(key));
+        }
+    }
+    return differingKeys;
+}
+export function buildDeploymentRequiredDetail(input) {
+    if (input.projectJustCreated) {
+        return {
+            message: `Project "${input.projectName}" was created in Vercel, but it has no production deployment yet.`,
+            nextSteps: [
+                "Deploy or connect the project in Vercel so it has a production URL.",
+                "Return here, select the project under Use existing project, and apply again.",
+            ],
+        };
+    }
+    return {
+        message: `Project "${input.projectName}" exists in Vercel but has no production deployment yet.`,
+        nextSteps: [
+            "Deploy the project in Vercel before applying settings.",
+            "After deployment completes, preview and apply again.",
+        ],
+    };
+}
+export function normalizeVercelBridgePlanInput(input) {
+    const teamMode = input.team?.mode ?? "existing";
+    const projectMode = input.project?.mode ?? "existing";
+    return {
+        ...input,
+        teamId: teamMode === "existing"
+            ? (input.team?.teamId ?? input.teamId)
+            : input.teamId,
+        projectId: projectMode === "existing"
+            ? (input.project?.projectId ?? input.projectId)
+            : input.projectId,
+        projectName: projectMode === "create"
+            ? (input.project?.projectName ?? input.projectName)
+            : input.projectName,
+        team: input.team ?? {
+            mode: "existing",
+            teamId: input.teamId,
+        },
+        project: input.project ?? {
+            mode: "existing",
+            projectId: input.projectId,
+            projectName: input.projectName,
+        },
+    };
+}
+function validateTeamProjectSelection(input) {
+    const normalized = normalizeVercelBridgePlanInput(input);
+    if (normalized.team?.mode === "create") {
+        if (!normalized.team.teamSlug?.trim()) {
+            return "New Vercel team requires a team slug.";
+        }
+    }
+    else if (!normalized.teamId && normalized.team?.teamId !== "") {
+        // Personal account uses empty string teamId; undefined means not selected when teams exist
+    }
+    if (normalized.project?.mode === "create") {
+        if (!normalized.project.projectName?.trim()) {
+            return "New Vercel project requires a project name.";
+        }
+    }
+    else if (!normalized.projectId?.trim()) {
+        return "Vercel project is required.";
+    }
+    return undefined;
+}
+function buildEnvWritePlan(input) {
+    const plan = [];
+    const existingKeys = new Set(input.existingEnvByKey.keys());
+    const resolveRequired = (key) => {
+        const operatorValue = input.envInput?.[key]?.trim();
+        if (operatorValue) {
+            return { value: operatorValue, source: "operator-input" };
+        }
+        if (key === "HARNESS_TEAM_KEY" && input.derivedHarnessTeamKey?.trim()) {
+            return {
+                value: input.derivedHarnessTeamKey.trim(),
+                source: "derived",
+            };
+        }
+        if (key === "GITHUB_DISPATCH_TOKEN" &&
+            input.derivedGithubDispatchToken?.trim()) {
+            return {
+                value: input.derivedGithubDispatchToken.trim(),
+                source: "derived",
+            };
+        }
+        if (key === "LINEAR_WEBHOOK_SECRET" &&
+            input.willGenerateLinearWebhookSecret) {
+            return { value: "<generated-on-apply>", source: "generated" };
+        }
+        if (existingKeys.has(key)) {
+            return { value: undefined, source: "preserve-existing" };
+        }
+        return { value: undefined, source: "missing-input" };
+    };
+    for (const key of REQUIRED_VERCEL_BRIDGE_ENV_VARS) {
+        const resolved = resolveRequired(key);
+        const existing = input.existingEnvByKey.get(key);
+        const desiredType = getDefaultEnvVarType(key);
+        if (resolved.source === "preserve-existing") {
+            plan.push({
+                key,
+                action: "skip",
+                source: "preserve-existing",
+                existingType: existing?.type,
+                desiredType,
+            });
+            continue;
+        }
+        if (resolved.source === "missing-input" || !resolved.value) {
+            plan.push({ key, action: "skip", source: "missing-input", desiredType });
+            continue;
+        }
+        plan.push({
+            key,
+            action: existingKeys.has(key) ? "update" : "create",
+            source: resolved.source,
+            existingType: existing?.type,
+            desiredType: existing?.type ?? desiredType,
+        });
+    }
+    for (const key of OPTIONAL_VERCEL_BRIDGE_ENV_VARS) {
+        const value = input.envInput?.[key]?.trim() ?? DEFAULT_VERCEL_BRIDGE_ENV_DEFAULTS[key];
+        const existing = input.existingEnvByKey.get(key);
+        const desiredType = getDefaultEnvVarType(key);
+        if (!value) {
+            plan.push({ key, action: "skip", source: "missing-input", desiredType });
+            continue;
+        }
+        if (existingKeys.has(key)) {
+            plan.push({
+                key,
+                action: "skip",
+                source: "preserve-existing",
+                existingType: existing?.type,
+                desiredType,
+            });
+            continue;
+        }
+        plan.push({
+            key,
+            action: "create",
+            source: input.envInput?.[key]?.trim() ? "operator-input" : "default",
+            desiredType,
+        });
+    }
+    return plan;
+}
+export function resolveVercelBridgeEnvValue(input) {
+    const operatorValue = input.envInput?.[input.key]?.trim();
+    if (operatorValue) {
+        return operatorValue;
+    }
+    if (input.key === "HARNESS_TEAM_KEY" && input.derivedHarnessTeamKey?.trim()) {
+        return input.derivedHarnessTeamKey.trim();
+    }
+    if (input.key === "GITHUB_DISPATCH_TOKEN" &&
+        input.derivedGithubDispatchToken?.trim()) {
+        return input.derivedGithubDispatchToken.trim();
+    }
+    if (input.key === "LINEAR_WEBHOOK_SECRET" &&
+        input.generatedLinearWebhookSecret?.trim()) {
+        return input.generatedLinearWebhookSecret.trim();
+    }
+    if (input.key in DEFAULT_VERCEL_BRIDGE_ENV_DEFAULTS) {
+        return DEFAULT_VERCEL_BRIDGE_ENV_DEFAULTS[input.key];
+    }
+    return undefined;
+}
+export async function previewVercelBridgeSetup(input) {
+    const normalized = normalizeVercelBridgePlanInput(input);
+    if (!normalized.vercelToken.trim()) {
+        return {
+            actionId: VERCEL_SETUP_ACTIONS.preview.id,
+            teams: [],
+            projects: [],
+            deploymentStatus: "missing",
+            endpointReachable: false,
+            envWritePlan: [],
+            requiredEnvPresence: {
+                LINEAR_WEBHOOK_SECRET: "missing",
+                GITHUB_DISPATCH_TOKEN: "missing",
+                HARNESS_TEAM_KEY: "missing",
+            },
+            linearWebhookVerified: false,
+            readiness: deriveVercelBridgeReadiness({}),
+            manualSteps: ["Add VERCEL_TOKEN in Step 1 before configuring Vercel settings."],
+            fingerprint: hashPreview({ invalid: "missing-vercel-token" }),
+            permission: VERCEL_SETUP_ACTIONS.preview.permission,
+            validationError: "VERCEL_TOKEN is required for Vercel settings preview.",
+        };
+    }
+    const selectionError = validateTeamProjectSelection(normalized);
+    if (selectionError) {
+        return {
+            actionId: VERCEL_SETUP_ACTIONS.preview.id,
+            teams: [],
+            projects: [],
+            deploymentStatus: "missing",
+            endpointReachable: false,
+            envWritePlan: [],
+            requiredEnvPresence: {
+                LINEAR_WEBHOOK_SECRET: "missing",
+                GITHUB_DISPATCH_TOKEN: "missing",
+                HARNESS_TEAM_KEY: "missing",
+            },
+            linearWebhookVerified: false,
+            readiness: deriveVercelBridgeReadiness({}),
+            manualSteps: [selectionError],
+            fingerprint: hashPreview({ invalid: "invalid-selection" }),
+            permission: VERCEL_SETUP_ACTIONS.preview.permission,
+            validationError: selectionError,
+        };
+    }
+    const teams = await listVercelTeams(normalized.vercelToken);
+    const teamIdForProjects = normalized.team?.mode === "create"
+        ? findExistingTeamBySlug(teams, normalized.team.teamSlug ?? "")?.id
+        : normalized.teamId?.trim()
+            ? normalized.teamId
+            : undefined;
+    const projects = await listVercelProjects(normalized.vercelToken, teamIdForProjects);
+    let selectedProject = normalized.project?.mode === "existing"
+        ? projects.find((project) => project.id === normalized.projectId) ??
+            projects.find((project) => project.id === normalized.project?.projectId)
+        : findExistingProjectByName(projects, normalized.project?.projectName ?? "");
+    if (!selectedProject && normalized.project?.mode === "create") {
+        selectedProject = undefined;
+    }
+    if (!selectedProject) {
+        const manualSteps = normalized.project?.mode === "create"
+            ? [
+                `Project "${normalized.project?.projectName}" will be created during apply if it does not already exist.`,
+            ]
+            : ["Select or enter the Vercel project for automation and preview checks."];
+        return {
+            actionId: VERCEL_SETUP_ACTIONS.preview.id,
+            teams,
+            projects,
+            deploymentStatus: normalized.project?.mode === "create"
+                ? "project-will-be-created"
+                : "missing",
+            endpointReachable: false,
+            envWritePlan: [],
+            requiredEnvPresence: {
+                LINEAR_WEBHOOK_SECRET: "missing",
+                GITHUB_DISPATCH_TOKEN: "missing",
+                HARNESS_TEAM_KEY: "missing",
+            },
+            linearWebhookVerified: false,
+            readiness: deriveVercelBridgeReadiness({}),
+            manualSteps,
+            fingerprint: hashPreview({
+                invalid: "missing-project",
+                teamId: teamIdForProjects,
+                teamMode: normalized.team?.mode,
+                teamSlug: normalized.team?.teamSlug,
+                projectMode: normalized.project?.mode,
+                projectName: normalized.project?.projectName,
+            }),
+            permission: VERCEL_SETUP_ACTIONS.preview.permission,
+            validationError: normalized.project?.mode === "create"
+                ? undefined
+                : "Vercel project is required.",
+        };
+    }
+    const productionTarget = await resolveCanonicalProductionTarget({
+        vercelToken: normalized.vercelToken,
+        projectId: selectedProject.id,
+        teamId: teamIdForProjects,
+        preferredDeploymentId: normalized.preferredProductionDeploymentId,
+    });
+    const productionUrl = productionTarget?.productionUrl;
+    const webhookUrl = productionTarget?.webhookUrl;
+    const deploymentStatus = webhookUrl ? "ready" : "missing";
+    const deploymentRequired = webhookUrl
+        ? undefined
+        : buildDeploymentRequiredDetail({
+            projectName: selectedProject.name,
+            projectJustCreated: normalized.project?.mode === "create",
+        });
+    const endpoint = webhookUrl
+        ? await checkWebhookEndpointReachable(webhookUrl)
+        : { reachable: false };
+    const envVars = await listVercelProjectEnvVars(normalized.vercelToken, selectedProject.id, teamIdForProjects);
+    const existingEnvByKey = new Map(envVars.map((env) => [env.key, env]));
+    const requiredEnvPresence = summarizeRequiredEnvPresence(envVars);
+    let linearWebhookVerified = false;
+    let linearWebhookSecretMode;
+    let secretPlan;
+    const manualSteps = [];
+    if (normalized.team?.mode === "create" && !teamIdForProjects) {
+        manualSteps.push(`Team "${normalized.team.teamSlug}" will be created during apply if it does not already exist.`);
+    }
+    if (normalized.linearApiKey && webhookUrl) {
+        const webhookSummary = await summarizeLinearWebhookReadiness({
+            linearApiKey: normalized.linearApiKey,
+            webhookUrl,
+            teamId: normalized.linearTeamId,
+        });
+        secretPlan = await planLinearWebhookSecret({
+            linearApiKey: normalized.linearApiKey,
+            webhookUrl,
+            linearTeamId: normalized.linearTeamId,
+        });
+        linearWebhookSecretMode = secretPlan.mode;
+        linearWebhookVerified = false;
+        if (secretPlan.mode === "existing-unverified") {
+            linearWebhookVerified = false;
+        }
+        manualSteps.push(...webhookSummary.manualSteps, ...secretPlan.manualSteps);
+    }
+    else if (!webhookUrl) {
+        manualSteps.push(deploymentRequired?.message ??
+            "No production deployment was found for the selected Vercel project yet. Deploy the project before automation checks can pass.", ...(deploymentRequired?.nextSteps ?? []));
+        linearWebhookSecretMode = "manual-copy";
+    }
+    else {
+        manualSteps.push("After Vercel env vars are configured, create or verify the Linear Issue webhook.");
+        linearWebhookSecretMode = "manual-copy";
+    }
+    const willGenerateLinearWebhookSecret = normalized.willGenerateLinearWebhookSecret ??
+        (secretPlan?.willGenerateOnApply ??
+            !normalized.envInput?.LINEAR_WEBHOOK_SECRET?.trim());
+    const envWritePlan = buildEnvWritePlan({
+        existingEnvByKey,
+        envInput: normalized.envInput,
+        derivedHarnessTeamKey: normalized.derivedHarnessTeamKey,
+        derivedGithubDispatchToken: normalized.derivedGithubDispatchToken,
+        willGenerateLinearWebhookSecret,
+    });
+    const githubDispatchSource = normalized.envInput?.GITHUB_DISPATCH_TOKEN?.trim()
+        ? "operator-input"
+        : normalized.derivedGithubDispatchToken?.trim()
+            ? "saved-github-token"
+            : "missing";
+    const readiness = deriveVercelBridgeReadiness({
+        projectId: selectedProject.id,
+        productionUrl,
+        webhookUrl,
+        endpointReachable: endpoint.reachable,
+        requiredEnvPresence,
+        linearWebhookVerified,
+        signedProbeVerified: false,
+        deploymentRedeployRequired: false,
+    });
+    const fingerprintInputs = buildVercelBridgePreviewFingerprintInput({
+        teamId: teamIdForProjects,
+        teamMode: normalized.team?.mode,
+        teamSlug: normalized.team?.teamSlug,
+        projectId: selectedProject.id,
+        projectMode: normalized.project?.mode,
+        projectName: normalized.project?.projectName,
+        envWritePlan,
+        willGenerateLinearWebhookSecret,
+        linearWebhookSecretFromEnv: normalized.envInput?.LINEAR_WEBHOOK_SECRET,
+        githubDispatchTokenFromEnv: normalized.envInput?.GITHUB_DISPATCH_TOKEN,
+        derivedGithubDispatchToken: normalized.derivedGithubDispatchToken,
+        harnessTeamKey: normalized.envInput?.HARNESS_TEAM_KEY,
+        derivedHarnessTeamKey: normalized.derivedHarnessTeamKey,
+        vercelToken: normalized.vercelToken,
+    });
+    const fingerprint = hashVercelBridgePreviewFingerprint(fingerprintInputs);
+    return {
+        actionId: VERCEL_SETUP_ACTIONS.preview.id,
+        teams,
+        projects,
+        selectedProject,
+        productionUrl,
+        webhookUrl,
+        productionUrlSource: productionTarget?.source,
+        canonicalDeploymentId: productionTarget?.deploymentId,
+        deploymentStatus,
+        deploymentRequired,
+        endpointReachable: endpoint.reachable,
+        endpointStatusCode: endpoint.statusCode,
+        envWritePlan,
+        requiredEnvPresence,
+        linearWebhookVerified,
+        signedProbeVerified: false,
+        deploymentRedeployRequired: false,
+        linearWebhookSecretMode,
+        githubDispatchSource,
+        readiness,
+        manualSteps,
+        fingerprint,
+        permission: VERCEL_SETUP_ACTIONS.preview.permission,
+    };
+}
+//# sourceMappingURL=vercel-setup-plan.js.map

package/dist/setup/vercel-setup-plan.js.map

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

package/dist/setup/vercel-setup-summary.d.ts

@@ -0,0 +1,11 @@
+import type { ControlPlaneSetupState } from "./control-plane-types.js";
+import { deriveVercelBridgeReadiness } from "./vercel-bridge-readiness.js";
+export interface VercelSetupSummary {
+    controlPlane: ControlPlaneSetupState | null;
+    vercelTokenConfigured: boolean;
+    linearApiKeyConfigured: boolean;
+    readiness: ReturnType<typeof deriveVercelBridgeReadiness>;
+    linearTeamKey?: string;
+}
+export declare function buildVercelSetupSummary(cwd?: string): Promise<VercelSetupSummary>;
+//# sourceMappingURL=vercel-setup-summary.d.ts.map

package/dist/setup/vercel-setup-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-setup-summary.d.ts","sourceRoot":"","sources":["../../src/setup/vercel-setup-summary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAG3E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;IAChC,SAAS,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAyB7B"}

package/dist/setup/vercel-setup-summary.js

@@ -0,0 +1,29 @@
+import { readExistingEnvFile } from "./env-merge.js";
+import { readControlPlaneSetupState } from "./control-plane-setup-state.js";
+import { deriveVercelBridgeReadiness } from "./vercel-bridge-readiness.js";
+import { resolveLocalFilePaths } from "./setup-state.js";
+export async function buildVercelSetupSummary(cwd) {
+    const paths = resolveLocalFilePaths(cwd);
+    const existingEnv = await readExistingEnvFile(paths);
+    const controlPlane = await readControlPlaneSetupState(cwd);
+    const vercel = controlPlane?.vercel;
+    const readiness = deriveVercelBridgeReadiness({
+        projectId: vercel?.projectId,
+        productionUrl: vercel?.productionUrl,
+        webhookUrl: vercel?.webhookUrl,
+        endpointReachable: vercel?.endpointReachable,
+        requiredEnvPresence: vercel?.envVarPresence,
+        linearWebhookVerified: vercel?.linearWebhookVerified,
+        signedProbeVerified: vercel?.signedProbeVerified,
+        deploymentRedeployRequired: vercel?.deploymentRedeployRequired,
+        manualComplete: vercel?.manualComplete,
+    });
+    return {
+        controlPlane,
+        vercelTokenConfigured: Boolean(existingEnv?.presence.VERCEL_TOKEN),
+        linearApiKeyConfigured: Boolean(existingEnv?.presence.LINEAR_API_KEY),
+        readiness,
+        linearTeamKey: controlPlane?.linear?.teamKey,
+    };
+}
+//# sourceMappingURL=vercel-setup-summary.js.map