p-dev-harness 0.3.0

package/dist/setup/config-local-editor.js

@@ -0,0 +1,187 @@
+import { access } from "node:fs/promises";
+import { loadHarnessConfig } from "../config/load-config.js";
+import { DEFAULT_MODEL_ID } from "../config/defaults.js";
+import { loadHarnessDotenv } from "../config/load-dotenv.js";
+import { resolveConfigSource } from "../config/resolve-config.js";
+import { buildHarnessConfig, buildHarnessConfigJson } from "./config-builder.js";
+import { resolveLocalFilePaths, } from "./setup-state.js";
+const EXAMPLE_TARGET_REPO = "https://github.com/owner/example-target-app";
+const EXAMPLE_REPO_ID = "target-app";
+const EXAMPLE_LINEAR_PROJECT = "Example Target App";
+const EXAMPLE_LINEAR_TEAM_KEYS = new Set(["TEAM", "WES"]);
+const EXAMPLE_URL_FRAGMENTS = [
+    "staging.example.com",
+    "www.example.com",
+    "example.com",
+];
+function splitListField(value) {
+    if (!value?.trim()) {
+        return undefined;
+    }
+    const items = value
+        .split(/[,\n]/)
+        .map((item) => item.trim())
+        .filter(Boolean);
+    return items.length > 0 ? items : undefined;
+}
+function splitCommandLines(value) {
+    if (!value?.trim()) {
+        return undefined;
+    }
+    const commands = value
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    return commands.length > 0 ? commands : undefined;
+}
+export function normalizeTargetRepoFormInput(input) {
+    return {
+        id: input.id.trim(),
+        targetRepo: input.targetRepo.trim(),
+        linearProjects: splitListField(input.linearProjects),
+        linearTeams: splitListField(input.linearTeams),
+        baseBranch: input.baseBranch?.trim() || undefined,
+        productionBranch: input.productionBranch?.trim() || undefined,
+        previewProvider: input.previewProvider?.trim() || undefined,
+        integrationPreviewUrl: input.integrationPreviewUrl?.trim() || undefined,
+        productionUrl: input.productionUrl?.trim() || undefined,
+        integrationSuccessStatus: input.integrationSuccessStatus?.trim() || undefined,
+        productionSuccessStatus: input.productionSuccessStatus?.trim() || undefined,
+        validationCommands: splitCommandLines(input.validationCommands),
+    };
+}
+export function normalizeConfigFormInput(input) {
+    if (!input.repos.length) {
+        throw new Error("At least one target repo is required");
+    }
+    return {
+        repos: input.repos.map(normalizeTargetRepoFormInput),
+        linearTeamKey: input.linearTeamKey?.trim() || undefined,
+        modelId: input.modelId?.trim() || undefined,
+    };
+}
+export function validateConfigFormInput(input) {
+    const normalized = normalizeConfigFormInput(input);
+    const config = buildHarnessConfig(normalized);
+    const json = buildHarnessConfigJson(normalized);
+    return { config, json };
+}
+export function createEmptyConfigFormInput() {
+    return {
+        repos: [{ id: "", targetRepo: "" }],
+    };
+}
+export function isExampleHarnessConfig(config) {
+    if (config.repos.length === 0) {
+        return false;
+    }
+    return config.repos.every((repo) => {
+        const isExampleTarget = repo.targetRepo === EXAMPLE_TARGET_REPO ||
+            repo.targetRepo.includes("owner/example-target-app");
+        const isExampleId = repo.id === EXAMPLE_REPO_ID;
+        const hasExampleProject = repo.linearProjects?.some((project) => project === EXAMPLE_LINEAR_PROJECT);
+        const hasExampleUrl = [repo.integrationPreviewUrl, repo.productionUrl].some((url) => url &&
+            EXAMPLE_URL_FRAGMENTS.some((fragment) => url.includes(fragment)));
+        return isExampleTarget || isExampleId || hasExampleProject || hasExampleUrl;
+    });
+}
+export function sanitizeConfigFormInputForFirstRun(input) {
+    const repo = input.repos[0];
+    if (!repo) {
+        return createEmptyConfigFormInput();
+    }
+    const sanitizedRepo = {
+        ...repo,
+        id: isExampleTemplateValue(repo.id) ? "" : repo.id,
+        targetRepo: isExampleTemplateValue(repo.targetRepo) ? "" : repo.targetRepo,
+        linearProjects: isExampleTemplateValue(repo.linearProjects)
+            ? undefined
+            : repo.linearProjects,
+        linearTeams: isExampleTemplateValue(repo.linearTeams)
+            ? undefined
+            : repo.linearTeams,
+        integrationPreviewUrl: isExampleTemplateValue(repo.integrationPreviewUrl)
+            ? undefined
+            : repo.integrationPreviewUrl,
+        productionUrl: isExampleTemplateValue(repo.productionUrl)
+            ? undefined
+            : repo.productionUrl,
+    };
+    return {
+        linearTeamKey: input.linearTeamKey && !EXAMPLE_LINEAR_TEAM_KEYS.has(input.linearTeamKey)
+            ? input.linearTeamKey
+            : undefined,
+        modelId: input.modelId,
+        repos: [sanitizedRepo],
+    };
+}
+export function isExampleTemplateValue(value) {
+    if (!value?.trim()) {
+        return false;
+    }
+    const trimmed = value.trim();
+    return (trimmed === EXAMPLE_TARGET_REPO ||
+        trimmed === EXAMPLE_REPO_ID ||
+        trimmed === EXAMPLE_LINEAR_PROJECT ||
+        trimmed === "TEAM" ||
+        trimmed === "WES" ||
+        EXAMPLE_URL_FRAGMENTS.some((fragment) => trimmed.includes(fragment)) ||
+        trimmed.includes("owner/example-target-app"));
+}
+async function operatorConfigLocalExists(cwd) {
+    const paths = resolveLocalFilePaths(cwd);
+    try {
+        await access(paths.configLocal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function configToFormInput(config) {
+    return {
+        linearTeamKey: config.linear?.teamKey,
+        modelId: config.agentProvider?.model?.id ??
+            config.defaultModel?.id ??
+            DEFAULT_MODEL_ID,
+        repos: config.repos.map((repo) => ({
+            id: repo.id,
+            targetRepo: repo.targetRepo,
+            linearProjects: repo.linearProjects?.join(", "),
+            linearTeams: repo.linearTeams?.join(", "),
+            baseBranch: repo.baseBranch,
+            productionBranch: repo.productionBranch,
+            previewProvider: repo.previewProvider,
+            integrationPreviewUrl: repo.integrationPreviewUrl,
+            productionUrl: repo.productionUrl,
+            integrationSuccessStatus: repo.integrationSuccessStatus,
+            productionSuccessStatus: repo.productionSuccessStatus,
+            validationCommands: repo.validation?.commands?.join("\n"),
+        })),
+    };
+}
+export async function loadConfigFormDefaults(options) {
+    const cwd = options?.cwd;
+    const paths = resolveLocalFilePaths(cwd);
+    const hasOperatorConfigLocal = await operatorConfigLocalExists(cwd);
+    if (cwd) {
+        loadHarnessDotenv(cwd);
+        if (hasOperatorConfigLocal && !process.env.HARNESS_CONFIG_PATH?.trim()) {
+            process.env.HARNESS_CONFIG_PATH = paths.configLocal;
+        }
+    }
+    try {
+        const source = resolveConfigSource({ baseDir: cwd });
+        const loaded = await loadHarnessConfig({ baseDir: cwd });
+        if (source.kind === "default-file" ||
+            isExampleHarnessConfig(loaded.config) ||
+            (source.kind === "HARNESS_CONFIG_PATH" && !hasOperatorConfigLocal)) {
+            return createEmptyConfigFormInput();
+        }
+        return sanitizeConfigFormInputForFirstRun(configToFormInput(loaded.config));
+    }
+    catch {
+        return createEmptyConfigFormInput();
+    }
+}
+//# sourceMappingURL=config-local-editor.js.map

package/dist/setup/config-local-editor.js.map

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

package/dist/setup/config-writer.d.ts

@@ -0,0 +1,20 @@
+import { buildHarnessConfig } from "./config-builder.js";
+import type { SetupActionResult } from "./setup-actions.js";
+import { type LocalFilePaths, type SetupConfigBuildInput, type SetupExecutionMode } from "./setup-state.js";
+export interface WriteConfigLocalOptions {
+    paths: LocalFilePaths;
+    force?: boolean;
+    mode?: SetupExecutionMode;
+    input?: SetupConfigBuildInput;
+    content?: string;
+}
+export declare function readConfigExampleContent(paths: LocalFilePaths): Promise<string>;
+export declare function scaffoldConfigFromExample(options: {
+    paths: LocalFilePaths;
+    force?: boolean;
+    mode?: SetupExecutionMode;
+}): Promise<SetupActionResult>;
+export declare function writeConfigLocal(options: WriteConfigLocalOptions): Promise<SetupActionResult>;
+export declare function previewGeneratedConfig(input: SetupConfigBuildInput): string;
+export declare function previewFormattedConfig(config: ReturnType<typeof buildHarnessConfig>): string;
+//# sourceMappingURL=config-writer.d.ts.map

package/dist/setup/config-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.d.ts","sourceRoot":"","sources":["../../src/setup/config-writer.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,EAGnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAW1B,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyBD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0C7B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA2C5B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAE3E;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAC5C,MAAM,CAER"}

package/dist/setup/config-writer.js

@@ -0,0 +1,132 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { loadConfig } from "../config/load-config.js";
+import { SETUP_PERMISSIONS } from "./permission-model.js";
+import { buildHarnessConfigJson, formatHarnessConfigJson, } from "./config-builder.js";
+import { CONFIG_LOCAL, } from "./setup-state.js";
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function buildContent(options) {
+    if (options.content) {
+        return options.content.endsWith("\n")
+            ? options.content
+            : `${options.content}\n`;
+    }
+    if (options.input) {
+        return buildHarnessConfigJson(options.input);
+    }
+    throw new Error("writeConfigLocal requires content or structured input");
+}
+async function validateConfigContent(content) {
+    const tempDir = await mkdtemp(path.join(tmpdir(), "harness-setup-config-"));
+    const tempPath = path.join(tempDir, "config.local.json");
+    try {
+        await writeFile(tempPath, content, "utf8");
+        await loadConfig(tempPath);
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+export async function readConfigExampleContent(paths) {
+    if (!(await fileExists(paths.configExample))) {
+        throw new Error(`Missing source file: ${paths.configExample}`);
+    }
+    const raw = await readFile(paths.configExample, "utf8");
+    return raw.endsWith("\n") ? raw : `${raw}\n`;
+}
+export async function scaffoldConfigFromExample(options) {
+    const { paths, force = false, mode = "apply" } = options;
+    const label = CONFIG_LOCAL;
+    const destExists = await fileExists(paths.configLocal);
+    if (destExists && !force) {
+        return {
+            actionId: "scaffold-config-local",
+            outcome: "skipped",
+            targetPath: paths.configLocal,
+            permission: SETUP_PERMISSIONS.localFileWrite,
+            reason: "already exists",
+            logMessage: `skipped ${label} (already exists)`,
+        };
+    }
+    const content = await readConfigExampleContent(paths);
+    if (mode === "dry-run") {
+        return {
+            actionId: "scaffold-config-local",
+            outcome: destExists ? "wouldChange" : "preview",
+            targetPath: paths.configLocal,
+            content,
+            permission: SETUP_PERMISSIONS.localFileWrite,
+            reason: destExists ? "would overwrite with --force" : "would create",
+            logMessage: destExists
+                ? `would overwrite ${label}`
+                : `would create ${label}`,
+        };
+    }
+    await writeFile(paths.configLocal, content, "utf8");
+    return {
+        actionId: "scaffold-config-local",
+        outcome: "changed",
+        targetPath: paths.configLocal,
+        content,
+        permission: SETUP_PERMISSIONS.localFileWrite,
+        reason: destExists ? "overwrote existing file" : "created new file",
+        logMessage: `${destExists ? "overwrote" : "created"} ${label}`,
+    };
+}
+export async function writeConfigLocal(options) {
+    const { paths, force = false, mode = "apply" } = options;
+    const label = CONFIG_LOCAL;
+    const destExists = await fileExists(paths.configLocal);
+    if (destExists && !force) {
+        return {
+            actionId: "write-config-local",
+            outcome: "skipped",
+            targetPath: paths.configLocal,
+            permission: SETUP_PERMISSIONS.localFileWrite,
+            reason: "already exists",
+            logMessage: `skipped ${label} (already exists)`,
+        };
+    }
+    const content = buildContent(options);
+    await validateConfigContent(content);
+    if (mode === "dry-run") {
+        return {
+            actionId: "write-config-local",
+            outcome: destExists ? "wouldChange" : "preview",
+            targetPath: paths.configLocal,
+            content,
+            permission: SETUP_PERMISSIONS.localFileWrite,
+            reason: destExists ? "would overwrite with --force" : "would create",
+            logMessage: destExists
+                ? `would overwrite ${label}`
+                : `would create ${label}`,
+        };
+    }
+    await writeFile(paths.configLocal, content, "utf8");
+    return {
+        actionId: "write-config-local",
+        outcome: "changed",
+        targetPath: paths.configLocal,
+        content,
+        permission: SETUP_PERMISSIONS.localFileWrite,
+        reason: destExists ? "overwrote existing file" : "created new file",
+        logMessage: `${destExists ? "overwrote" : "created"} ${label}`,
+    };
+}
+export function previewGeneratedConfig(input) {
+    return buildHarnessConfigJson(input);
+}
+export function previewFormattedConfig(config) {
+    return formatHarnessConfigJson(config);
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/setup/config-writer.js.map

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

package/dist/setup/control-plane-readiness-server.d.ts

@@ -0,0 +1,5 @@
+import type { SetupGuiViewModel } from "./gui-view-model.js";
+import type { ControlPlaneReadinessContext } from "./control-plane-types.js";
+export declare function loadControlPlaneReadinessContext(cwd?: string, summary?: SetupGuiViewModel): Promise<ControlPlaneReadinessContext>;
+export type { ControlPlaneReadinessContext } from "./control-plane-types.js";
+//# sourceMappingURL=control-plane-readiness-server.d.ts.map

package/dist/setup/control-plane-readiness-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-readiness-server.d.ts","sourceRoot":"","sources":["../../src/setup/control-plane-readiness-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE7E,wBAAsB,gCAAgC,CACpD,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,4BAA4B,CAAC,CAMvC;AAED,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/setup/control-plane-readiness-server.js

@@ -0,0 +1,9 @@
+import { readControlPlaneSetupState } from "./control-plane-setup-state.js";
+export async function loadControlPlaneReadinessContext(cwd, summary) {
+    const state = await readControlPlaneSetupState(cwd);
+    return {
+        state,
+        linearTeamKeyFromConfig: summary?.configSummary?.linearTeamKey,
+    };
+}
+//# sourceMappingURL=control-plane-readiness-server.js.map

package/dist/setup/control-plane-readiness-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-readiness-server.js","sourceRoot":"","sources":["../../src/setup/control-plane-readiness-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAG5E,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,GAAY,EACZ,OAA2B;IAE3B,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO;QACL,KAAK;QACL,uBAAuB,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa;KAC/D,CAAC;AACJ,CAAC"}

package/dist/setup/control-plane-readiness.d.ts

@@ -0,0 +1,23 @@
+import type { SetupGuiViewModel } from "./gui-view-model.js";
+import type { ControlPlaneReadinessContext } from "./control-plane-types.js";
+import type { ReadinessBlocker } from "./first-run-readiness.js";
+export declare function collectConnectServicesBlockers(summary: SetupGuiViewModel): ReadinessBlocker[];
+export declare function collectLinearWorkspaceBlockers(context: ControlPlaneReadinessContext, uiState?: {
+    linearPreviewStale?: boolean;
+}): ReadinessBlocker[];
+export declare function collectVercelBridgeBlockers(context: ControlPlaneReadinessContext, uiState?: {
+    vercelPreviewStale?: boolean;
+}): ReadinessBlocker[];
+export declare function computeCloudSecretsConfigStateFingerprint(input: {
+    setupSummary: SetupGuiViewModel;
+    controlPlaneContext?: ControlPlaneReadinessContext;
+}): string;
+export declare function isCloudSecretsStaleFromControlPlane(context: ControlPlaneReadinessContext): boolean;
+export declare function summarizeLinearWorkspaceStatus(context: ControlPlaneReadinessContext): {
+    configured: boolean;
+    teamKey?: string;
+    projectName?: string;
+    statusCoverageComplete: boolean;
+    requiredStatusCount: number;
+};
+//# sourceMappingURL=control-plane-readiness.d.ts.map

package/dist/setup/control-plane-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane-readiness.d.ts","sourceRoot":"","sources":["../../src/setup/control-plane-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAG7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAgBjE,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,EAAE,CA4CpB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GACzC,gBAAgB,EAAE,CAoCpB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GACzC,gBAAgB,EAAE,CAiHpB;AA2BD,wBAAgB,yCAAyC,CAAC,KAAK,EAAE;IAC/D,YAAY,EAAE,iBAAiB,CAAC;IAChC,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;CACpD,GAAG,MAAM,CAGT;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAOT;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,4BAA4B,GACpC;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAWA"}

package/dist/setup/control-plane-readiness.js

@@ -0,0 +1,216 @@
+import { requiredStatusNames } from "./linear-status-contract.js";
+import { isVercelBridgeStale } from "./vercel-bridge-readiness.js";
+function pushBlocker(blockers, blocker) {
+    blockers.push({
+        blocking: true,
+        tone: blocker.tone ?? "setup_needed",
+        ...blocker,
+    });
+}
+export function collectConnectServicesBlockers(summary) {
+    const blockers = [];
+    if (!summary.envKeyPresence.LINEAR_API_KEY) {
+        pushBlocker(blockers, {
+            id: "missing-linear-key",
+            stepId: "connect-services",
+            message: "Setup needed: LINEAR_API_KEY is not configured yet.",
+            action: "Add it in Step 1 · Connect services.",
+            priority: 103,
+        });
+    }
+    if (!summary.envKeyPresence.CURSOR_API_KEY) {
+        pushBlocker(blockers, {
+            id: "missing-cursor-key",
+            stepId: "connect-services",
+            message: "Setup needed: CURSOR_API_KEY is not configured yet.",
+            action: "Add it in Step 1 · Connect services.",
+            priority: 104,
+        });
+    }
+    if (!summary.envKeyPresence.GITHUB_TOKEN) {
+        pushBlocker(blockers, {
+            id: "missing-github-token",
+            stepId: "connect-services",
+            message: "Setup needed: GITHUB_TOKEN is not configured yet.",
+            action: "Add it in Step 1 · Connect services.",
+            priority: 105,
+        });
+    }
+    if (!summary.envKeyPresence.VERCEL_TOKEN) {
+        pushBlocker(blockers, {
+            id: "missing-vercel-token",
+            stepId: "connect-services",
+            message: "Setup needed: VERCEL_TOKEN is not configured yet.",
+            action: "Add it in Step 1 · Connect services.",
+            priority: 106,
+        });
+    }
+    return blockers.sort((left, right) => left.priority - right.priority);
+}
+export function collectLinearWorkspaceBlockers(context, uiState) {
+    const blockers = [];
+    const linear = context.state?.linear;
+    if (!linear?.teamKey) {
+        pushBlocker(blockers, {
+            id: "linear-workspace-not-applied",
+            stepId: "linear-workspace",
+            message: "Setup needed: Linear workspace setup is not complete yet.",
+            action: "Next: Preview and apply Linear team, project, and workflow statuses.",
+            priority: 150,
+        });
+    }
+    else if (!linear.statusCoverageComplete && !linear.manualComplete) {
+        pushBlocker(blockers, {
+            id: "linear-status-coverage-incomplete",
+            stepId: "linear-workspace",
+            message: "Blocked: Required Linear workflow statuses are still missing.",
+            action: "Next: Complete Linear workspace setup or confirm manual status coverage.",
+            priority: 151,
+        });
+    }
+    if (uiState?.linearPreviewStale) {
+        pushBlocker(blockers, {
+            id: "linear-preview-stale",
+            stepId: "linear-workspace",
+            message: "Blocked: Linear setup preview is out of date.",
+            action: "Next: Regenerate the Linear setup preview, then confirm and apply.",
+            priority: 152,
+            tone: "error",
+        });
+    }
+    return blockers.sort((left, right) => left.priority - right.priority);
+}
+export function collectVercelBridgeBlockers(context, uiState) {
+    const blockers = [];
+    const vercel = context.state?.vercel;
+    const linearTeamKey = context.state?.linear?.teamKey;
+    if (!vercel?.projectId) {
+        pushBlocker(blockers, {
+            id: "vercel-bridge-not-applied",
+            stepId: "vercel-bridge",
+            message: "Setup needed: Vercel webhook bridge setup is not complete yet.",
+            action: "Next: Preview and apply Vercel bridge env vars and webhook readiness.",
+            priority: 160,
+        });
+    }
+    else {
+        if (!vercel.endpointReachable) {
+            pushBlocker(blockers, {
+                id: "vercel-endpoint-unreachable",
+                stepId: "vercel-bridge",
+                message: "Blocked: Vercel /api/linear-webhook endpoint is not reachable yet.",
+                action: "Next: Deploy the bridge project and confirm the public webhook route is reachable.",
+                priority: 161,
+                tone: "error",
+            });
+        }
+        for (const [key, status] of Object.entries(vercel.envVarPresence ?? {})) {
+            if (status === "missing") {
+                pushBlocker(blockers, {
+                    id: `vercel-env-missing-${key}`,
+                    stepId: "vercel-bridge",
+                    message: `Blocked: Vercel production env var ${key} is missing.`,
+                    action: "Next: Apply Vercel bridge env vars or set them manually.",
+                    priority: 162,
+                    tone: "error",
+                });
+            }
+        }
+        if (!vercel.linearWebhookVerified) {
+            pushBlocker(blockers, {
+                id: "linear-webhook-unverified",
+                stepId: "vercel-bridge",
+                message: "Blocked: Linear Issue webhook is not verified for the Vercel bridge URL.",
+                action: "Next: Create or verify the Linear webhook, then refresh bridge readiness.",
+                priority: 163,
+                tone: "error",
+            });
+        }
+        if (!vercel.signedProbeVerified) {
+            pushBlocker(blockers, {
+                id: "signed-probe-unverified",
+                stepId: "vercel-bridge",
+                message: "Blocked: Signed webhook delivery verification has not passed against production.",
+                action: "Next: Apply Vercel bridge settings and wait for signed probe verification to pass.",
+                priority: 164,
+                tone: "error",
+            });
+        }
+        if (vercel.deploymentRedeployRequired) {
+            pushBlocker(blockers, {
+                id: "vercel-redeploy-required",
+                stepId: "vercel-bridge",
+                message: "Blocked: Vercel production must be redeployed after env var changes before signed verification can pass.",
+                action: "Next: Redeploy production, then retry Vercel bridge apply.",
+                priority: 165,
+                tone: "error",
+            });
+        }
+        if (linearTeamKey &&
+            vercel.envVarPresence?.HARNESS_TEAM_KEY === "present" &&
+            context.state?.linear?.teamKey &&
+            isVercelBridgeStale({
+                configuredTeamKey: context.state.linear.teamKey,
+                selectedTeamKey: linearTeamKey,
+            })) {
+            pushBlocker(blockers, {
+                id: "vercel-team-key-stale",
+                stepId: "vercel-bridge",
+                message: "Blocked: Vercel HARNESS_TEAM_KEY may be stale after Linear team changes.",
+                action: "Next: Re-apply Vercel bridge setup with the current team key.",
+                priority: 166,
+                tone: "error",
+            });
+        }
+    }
+    if (uiState?.vercelPreviewStale) {
+        pushBlocker(blockers, {
+            id: "vercel-preview-stale",
+            stepId: "vercel-bridge",
+            message: "Blocked: Vercel bridge preview is out of date.",
+            action: "Next: Regenerate the Vercel bridge preview, then confirm and apply.",
+            priority: 167,
+            tone: "error",
+        });
+    }
+    return blockers.sort((left, right) => left.priority - right.priority);
+}
+function normalizeCloudSecretsConfigState(input) {
+    const configSummary = input.setupSummary.configSummary;
+    return {
+        configResolved: input.setupSummary.overview.configResolved,
+        operatorConfigResolved: input.setupSummary.overview.operatorConfigResolved,
+        linearTeamKeyFromConfig: input.controlPlaneContext?.linearTeamKeyFromConfig ?? null,
+        linearTeamKeyFromControlPlane: input.controlPlaneContext?.state?.linear?.teamKey ?? null,
+        repoIds: (configSummary?.repos ?? [])
+            .map((repo) => repo.id)
+            .sort((left, right) => left.localeCompare(right)),
+        repoTargets: (configSummary?.repos ?? [])
+            .map((repo) => ({ id: repo.id, targetRepo: repo.targetRepo }))
+            .sort((left, right) => left.id.localeCompare(right.id)),
+        allowedTargetRepos: [...(configSummary?.allowedTargetRepos ?? [])].sort((left, right) => left.localeCompare(right)),
+    };
+}
+export function computeCloudSecretsConfigStateFingerprint(input) {
+    // JSON snapshot only — used for equality checks in client + server bundles.
+    return JSON.stringify(normalizeCloudSecretsConfigState(input));
+}
+export function isCloudSecretsStaleFromControlPlane(context) {
+    const linearTeamKey = context.state?.linear?.teamKey;
+    const configTeamKey = context.linearTeamKeyFromConfig;
+    if (linearTeamKey && configTeamKey && linearTeamKey !== configTeamKey) {
+        return true;
+    }
+    return false;
+}
+export function summarizeLinearWorkspaceStatus(context) {
+    const linear = context.state?.linear;
+    return {
+        configured: Boolean(linear?.teamKey),
+        teamKey: linear?.teamKey,
+        projectName: linear?.projectName,
+        statusCoverageComplete: Boolean(linear?.statusCoverageComplete || linear?.manualComplete),
+        requiredStatusCount: requiredStatusNames().length,
+    };
+}
+//# sourceMappingURL=control-plane-readiness.js.map

package/dist/setup/control-plane-readiness.js.map

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