p-dev-harness 0.3.0

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

@@ -0,0 +1,88 @@
+import { type RequiredWorkflowStatus } from "./linear-status-contract.js";
+import { getLinearSetupCapabilities, listLinearWebhooks, type LinearProjectSummary, type LinearTeamSummary, type LinearWorkflowStateSummary } from "./linear-setup-client.js";
+import { SETUP_PERMISSIONS } from "./permission-model.js";
+export declare const LINEAR_SETUP_ACTIONS: {
+    readonly preview: {
+        readonly id: "preview-linear-setup";
+        readonly permission: {
+            readonly scope: "remote-read";
+            readonly confirmation: "standard";
+            readonly manualAlternative: true;
+        };
+    };
+    readonly apply: {
+        readonly id: "apply-linear-setup";
+        readonly permission: {
+            readonly scope: "linear-write";
+            readonly confirmation: "high-risk";
+            readonly manualAlternative: true;
+        };
+    };
+};
+export interface LinearTeamPlanInput {
+    mode: "existing" | "create";
+    teamId?: string;
+    teamKey?: string;
+    teamName?: string;
+}
+export interface LinearProjectPlanInput {
+    mode: "existing" | "create";
+    projectId?: string;
+    projectName?: string;
+    description?: string;
+}
+export interface LinearSetupPlanInput {
+    linearApiKey: string;
+    team: LinearTeamPlanInput;
+    project: LinearProjectPlanInput;
+}
+export interface WorkflowStatusPlanEntry {
+    name: string;
+    category: RequiredWorkflowStatus["category"];
+    role: RequiredWorkflowStatus["role"];
+    present: boolean;
+    existingType?: string;
+    action: "skip" | "create" | "manual";
+    creatable: boolean;
+}
+export interface LinearSetupPreview {
+    actionId: string;
+    capabilities: ReturnType<typeof getLinearSetupCapabilities>;
+    teams: LinearTeamSummary[];
+    projects: LinearProjectSummary[];
+    selectedTeam?: LinearTeamSummary;
+    selectedProject?: LinearProjectSummary;
+    workflowStates: WorkflowStatusPlanEntry[];
+    dispatchTriggerStatuses: readonly string[];
+    missingStatuses: string[];
+    createActions: Array<{
+        kind: "team" | "project" | "workflow-state";
+        name: string;
+    }>;
+    manualSteps: string[];
+    fingerprint: string;
+    permission: typeof SETUP_PERMISSIONS.remoteRead;
+    validationError?: string;
+}
+export declare function normalizeLinearName(name: string): string;
+export declare function matchWorkflowStates(existing: LinearWorkflowStateSummary[]): WorkflowStatusPlanEntry[];
+export declare function findExistingTeamForCreateInput(teams: LinearTeamSummary[], input: {
+    teamKey: string;
+    teamName: string;
+}): LinearTeamSummary | undefined;
+export declare function findExistingProjectForCreateInput(projects: LinearProjectSummary[], input: {
+    projectName: string;
+    teamId?: string;
+}): LinearProjectSummary | undefined;
+export declare function isWorkflowStatusCoverageComplete(workflowStates: WorkflowStatusPlanEntry[]): boolean;
+export declare function previewLinearSetup(input: LinearSetupPlanInput): Promise<LinearSetupPreview>;
+export declare function summarizeLinearWebhookReadiness(input: {
+    linearApiKey: string;
+    webhookUrl: string;
+    teamId?: string;
+}): Promise<{
+    webhooks: Awaited<ReturnType<typeof listLinearWebhooks>>;
+    matchingWebhook?: Awaited<ReturnType<typeof listLinearWebhooks>>[number];
+    manualSteps: string[];
+}>;
+//# sourceMappingURL=linear-setup-plan.d.ts.map

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

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

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

@@ -0,0 +1,239 @@
+import { createHash } from "node:crypto";
+import { lookupRequiredStatus, requiredCreatableStatuses, getDispatchTriggerStatuses, } from "./linear-status-contract.js";
+import { createLinearSetupClient, getLinearSetupCapabilities, listLinearProjects, listLinearTeams, listLinearWebhooks, listTeamWorkflowStates, } from "./linear-setup-client.js";
+import { SETUP_PERMISSIONS } from "./permission-model.js";
+import { tokenizeSecretInput } from "./secret-change-token.js";
+export const LINEAR_SETUP_ACTIONS = {
+    preview: {
+        id: "preview-linear-setup",
+        permission: SETUP_PERMISSIONS.remoteRead,
+    },
+    apply: {
+        id: "apply-linear-setup",
+        permission: SETUP_PERMISSIONS.linearWrite,
+    },
+};
+function hashPreview(input) {
+    return createHash("sha256")
+        .update(JSON.stringify(input))
+        .digest("hex")
+        .slice(0, 16);
+}
+export function normalizeLinearName(name) {
+    return name.trim().toLowerCase();
+}
+export function matchWorkflowStates(existing) {
+    const byName = new Map(existing.map((state) => [normalizeLinearName(state.name), state]));
+    return requiredCreatableStatuses().map((required) => {
+        const match = byName.get(normalizeLinearName(required.name));
+        const present = Boolean(match);
+        let action = "skip";
+        if (!present) {
+            action = required.creatable ? "create" : "manual";
+        }
+        return {
+            name: required.name,
+            category: required.category,
+            role: required.role,
+            present,
+            existingType: match?.type,
+            action,
+            creatable: required.creatable,
+        };
+    });
+}
+export function findExistingTeamForCreateInput(teams, input) {
+    const key = input.teamKey.trim().toLowerCase();
+    const name = normalizeLinearName(input.teamName);
+    return (teams.find((team) => team.key.trim().toLowerCase() === key) ??
+        teams.find((team) => normalizeLinearName(team.name) === name));
+}
+export function findExistingProjectForCreateInput(projects, input) {
+    const name = normalizeLinearName(input.projectName);
+    return projects.find((project) => {
+        if (normalizeLinearName(project.name) !== name) {
+            return false;
+        }
+        if (!input.teamId) {
+            return true;
+        }
+        if (project.teamIds.length === 0) {
+            return true;
+        }
+        return project.teamIds.includes(input.teamId);
+    });
+}
+export function isWorkflowStatusCoverageComplete(workflowStates) {
+    return workflowStates.every((entry) => entry.present || !entry.creatable);
+}
+export async function previewLinearSetup(input) {
+    const capabilities = getLinearSetupCapabilities();
+    const manualSteps = [];
+    const createActions = [];
+    if (!input.linearApiKey.trim()) {
+        return {
+            actionId: LINEAR_SETUP_ACTIONS.preview.id,
+            capabilities,
+            teams: [],
+            projects: [],
+            workflowStates: [],
+            dispatchTriggerStatuses: getDispatchTriggerStatuses(),
+            missingStatuses: requiredCreatableStatuses()
+                .filter((status) => status.creatable)
+                .map((status) => status.name),
+            createActions: [],
+            manualSteps: ["Add LINEAR_API_KEY in Step 1 before previewing Linear setup."],
+            fingerprint: hashPreview({ invalid: "missing-linear-key" }),
+            permission: LINEAR_SETUP_ACTIONS.preview.permission,
+            validationError: "LINEAR_API_KEY is required for Linear setup preview.",
+        };
+    }
+    const client = createLinearSetupClient(input.linearApiKey);
+    const teams = await listLinearTeams(client);
+    const projects = await listLinearProjects(client);
+    let selectedTeam;
+    if (input.team.mode === "existing") {
+        selectedTeam = teams.find((team) => team.id === input.team.teamId);
+        if (!selectedTeam && input.team.teamId) {
+            return {
+                actionId: LINEAR_SETUP_ACTIONS.preview.id,
+                capabilities,
+                teams,
+                projects,
+                workflowStates: [],
+                dispatchTriggerStatuses: getDispatchTriggerStatuses(),
+                missingStatuses: [],
+                createActions: [],
+                manualSteps: [],
+                fingerprint: hashPreview({ invalid: "team-not-found" }),
+                permission: LINEAR_SETUP_ACTIONS.preview.permission,
+                validationError: "Selected Linear team was not found.",
+            };
+        }
+    }
+    else if (input.team.teamName && input.team.teamKey) {
+        const existingTeam = findExistingTeamForCreateInput(teams, {
+            teamKey: input.team.teamKey,
+            teamName: input.team.teamName,
+        });
+        if (existingTeam) {
+            selectedTeam = existingTeam;
+        }
+        else {
+            createActions.push({
+                kind: "team",
+                name: `${input.team.teamName} (${input.team.teamKey})`,
+            });
+            selectedTeam = {
+                id: "pending-team",
+                key: input.team.teamKey,
+                name: input.team.teamName,
+            };
+        }
+    }
+    let selectedProject;
+    if (input.project.mode === "existing") {
+        selectedProject = projects.find((project) => project.id === input.project.projectId);
+    }
+    else if (input.project.projectName && selectedTeam) {
+        const existingProject = findExistingProjectForCreateInput(projects, {
+            projectName: input.project.projectName,
+            teamId: selectedTeam.id === "pending-team" ? undefined : selectedTeam.id,
+        });
+        if (existingProject) {
+            selectedProject = existingProject;
+        }
+        else {
+            createActions.push({
+                kind: "project",
+                name: input.project.projectName,
+            });
+            selectedProject = {
+                id: "pending-project",
+                name: input.project.projectName,
+                teamIds: selectedTeam.id === "pending-team" ? [] : [selectedTeam.id],
+            };
+        }
+    }
+    let workflowStates = [];
+    if (selectedTeam && selectedTeam.id !== "pending-team") {
+        const existingStates = await listTeamWorkflowStates(client, selectedTeam.id);
+        workflowStates = matchWorkflowStates(existingStates);
+        for (const entry of workflowStates) {
+            if (entry.action === "create") {
+                createActions.push({ kind: "workflow-state", name: entry.name });
+            }
+            if (entry.action === "manual") {
+                manualSteps.push(`${entry.name} is Linear-managed and must be verified manually in the workspace.`);
+            }
+            if (entry.present &&
+                entry.existingType &&
+                lookupRequiredStatus(entry.name)?.category !== entry.existingType) {
+                manualSteps.push(`${entry.name} exists but uses category ${entry.existingType}; harness expects ${lookupRequiredStatus(entry.name)?.category}. Rename manually if needed.`);
+            }
+        }
+    }
+    else if (selectedTeam) {
+        workflowStates = requiredCreatableStatuses().map((required) => ({
+            name: required.name,
+            category: required.category,
+            role: required.role,
+            present: false,
+            action: required.creatable ? "create" : "manual",
+            creatable: required.creatable,
+        }));
+        for (const entry of workflowStates) {
+            if (entry.action === "create") {
+                createActions.push({ kind: "workflow-state", name: entry.name });
+            }
+        }
+    }
+    const missingStatuses = workflowStates
+        .filter((entry) => !entry.present && entry.creatable)
+        .map((entry) => entry.name);
+    const fingerprint = hashPreview({
+        actionId: LINEAR_SETUP_ACTIONS.preview.id,
+        team: input.team,
+        project: input.project,
+        workflowStates: workflowStates.map((entry) => ({
+            name: entry.name,
+            action: entry.action,
+        })),
+        linearApiKeyToken: tokenizeSecretInput(input.linearApiKey),
+    });
+    return {
+        actionId: LINEAR_SETUP_ACTIONS.preview.id,
+        capabilities,
+        teams,
+        projects,
+        selectedTeam,
+        selectedProject,
+        workflowStates,
+        dispatchTriggerStatuses: getDispatchTriggerStatuses(),
+        missingStatuses,
+        createActions,
+        manualSteps,
+        fingerprint,
+        permission: LINEAR_SETUP_ACTIONS.preview.permission,
+    };
+}
+export async function summarizeLinearWebhookReadiness(input) {
+    const client = createLinearSetupClient(input.linearApiKey);
+    const webhooks = await listLinearWebhooks(client);
+    const normalizedTarget = input.webhookUrl.trim().replace(/\/$/, "");
+    const matchingWebhook = webhooks.find((webhook) => {
+        const normalized = webhook.url.trim().replace(/\/$/, "");
+        const teamMatches = input.teamId ? webhook.teamId === input.teamId : true;
+        return (teamMatches &&
+            normalized === normalizedTarget &&
+            webhook.enabled &&
+            webhook.resourceTypes.includes("Issue"));
+    });
+    const manualSteps = [];
+    if (!matchingWebhook) {
+        manualSteps.push(`Create a Linear Issue webhook pointing at ${input.webhookUrl}.`);
+        manualSteps.push("Copy the webhook signing secret into Vercel production env var LINEAR_WEBHOOK_SECRET.");
+    }
+    return { webhooks, matchingWebhook, manualSteps };
+}
+//# sourceMappingURL=linear-setup-plan.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { ControlPlaneSetupState } from "./control-plane-types.js";
+import { getLinearSetupCapabilities } from "./linear-setup-client.js";
+import { summarizeLinearWorkspaceStatus } from "./control-plane-readiness.js";
+export interface LinearSetupSummary {
+    capabilities: ReturnType<typeof getLinearSetupCapabilities>;
+    controlPlane: ControlPlaneSetupState | null;
+    workspace: ReturnType<typeof summarizeLinearWorkspaceStatus>;
+    dispatchTriggerStatuses: readonly string[];
+    linearApiKeyConfigured: boolean;
+}
+export declare function buildLinearSetupSummary(cwd?: string): Promise<LinearSetupSummary>;
+//# sourceMappingURL=linear-setup-summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-setup-summary.d.ts","sourceRoot":"","sources":["../../src/setup/linear-setup-summary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAI9E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;IAC5D,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,SAAS,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC;IAC7D,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

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

@@ -0,0 +1,21 @@
+import { readExistingEnvFile } from "./env-merge.js";
+import { readControlPlaneSetupState } from "./control-plane-setup-state.js";
+import { getLinearSetupCapabilities } from "./linear-setup-client.js";
+import { summarizeLinearWorkspaceStatus } from "./control-plane-readiness.js";
+import { getDispatchTriggerStatuses } from "./linear-status-contract.js";
+import { resolveLocalFilePaths } from "./setup-state.js";
+export async function buildLinearSetupSummary(cwd) {
+    const paths = resolveLocalFilePaths(cwd);
+    const existingEnv = await readExistingEnvFile(paths);
+    const controlPlane = await readControlPlaneSetupState(cwd);
+    return {
+        capabilities: getLinearSetupCapabilities(),
+        controlPlane,
+        workspace: summarizeLinearWorkspaceStatus({
+            state: controlPlane,
+        }),
+        dispatchTriggerStatuses: getDispatchTriggerStatuses(),
+        linearApiKeyConfigured: Boolean(existingEnv?.presence.LINEAR_API_KEY),
+    };
+}
+//# sourceMappingURL=linear-setup-summary.js.map

package/dist/setup/linear-setup-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-setup-summary.js","sourceRoot":"","sources":["../../src/setup/linear-setup-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAUzD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAY;IAEZ,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,MAAM,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAE3D,OAAO;QACL,YAAY,EAAE,0BAA0B,EAAE;QAC1C,YAAY;QACZ,SAAS,EAAE,8BAA8B,CAAC;YACxC,KAAK,EAAE,YAAY;SACpB,CAAC;QACF,uBAAuB,EAAE,0BAA0B,EAAE;QACrD,sBAAsB,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC;KACtE,CAAC;AACJ,CAAC"}

package/dist/setup/linear-status-contract.d.ts

@@ -0,0 +1,15 @@
+export type LinearWorkflowStateCategory = "backlog" | "unstarted" | "started" | "completed" | "canceled";
+export interface RequiredWorkflowStatus {
+    name: string;
+    category: LinearWorkflowStateCategory;
+    role: "dispatch-trigger" | "transitional" | "human-gate" | "terminal" | "system-managed";
+    creatable: boolean;
+}
+export declare const DEPRECATED_STATUS_NAMES: readonly ["Plan Review"];
+export declare const REQUIRED_WORKFLOW_STATUSES: readonly RequiredWorkflowStatus[];
+export declare function getDispatchTriggerStatuses(): readonly string[];
+export declare function isDispatchTriggerStatusName(name: string): boolean;
+export declare function requiredStatusNames(): string[];
+export declare function requiredCreatableStatuses(): RequiredWorkflowStatus[];
+export declare function lookupRequiredStatus(name: string): RequiredWorkflowStatus | undefined;
+//# sourceMappingURL=linear-status-contract.d.ts.map

package/dist/setup/linear-status-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-status-contract.d.ts","sourceRoot":"","sources":["../../src/setup/linear-status-contract.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,2BAA2B,GACnC,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,2BAA2B,CAAC;IACtC,IAAI,EACA,kBAAkB,GAClB,cAAc,GACd,YAAY,GACZ,UAAU,GACV,gBAAgB,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,uBAAuB,0BAA2B,CAAC;AAEhE,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EA0D9D,CAAC;AAEX,wBAAgB,0BAA0B,IAAI,SAAS,MAAM,EAAE,CAE9D;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,EAAE,CAEpE;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX,sBAAsB,GAAG,SAAS,CAKpC"}

package/dist/setup/linear-status-contract.js

@@ -0,0 +1,79 @@
+import { DISPATCH_TRIGGER_STATUSES } from "../webhook/dispatch-statuses.js";
+export const DEPRECATED_STATUS_NAMES = ["Plan Review"];
+export const REQUIRED_WORKFLOW_STATUSES = [
+    { name: "Backlog", category: "backlog", role: "transitional", creatable: true },
+    {
+        name: "Ready for Planning",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+    },
+    { name: "Planning", category: "started", role: "transitional", creatable: true },
+    {
+        name: "Ready for Build",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+    },
+    { name: "Building", category: "started", role: "transitional", creatable: true },
+    { name: "PR Open", category: "started", role: "dispatch-trigger", creatable: true },
+    { name: "PM Review", category: "started", role: "transitional", creatable: true },
+    {
+        name: "Engineering Review",
+        category: "started",
+        role: "human-gate",
+        creatable: true,
+    },
+    {
+        name: "Needs Revision",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+    },
+    { name: "Revising", category: "started", role: "transitional", creatable: true },
+    {
+        name: "Ready to Merge",
+        category: "started",
+        role: "dispatch-trigger",
+        creatable: true,
+    },
+    { name: "Merging", category: "started", role: "transitional", creatable: true },
+    {
+        name: "Merged to Dev",
+        category: "completed",
+        role: "transitional",
+        creatable: true,
+    },
+    {
+        name: "Merged / Deployed",
+        category: "completed",
+        role: "transitional",
+        creatable: true,
+    },
+    { name: "Blocked", category: "started", role: "terminal", creatable: true },
+    { name: "Canceled", category: "canceled", role: "terminal", creatable: true },
+    {
+        name: "Duplicate",
+        category: "canceled",
+        role: "system-managed",
+        creatable: false,
+    },
+];
+export function getDispatchTriggerStatuses() {
+    return DISPATCH_TRIGGER_STATUSES;
+}
+export function isDispatchTriggerStatusName(name) {
+    const normalized = name.trim().toLowerCase();
+    return DISPATCH_TRIGGER_STATUSES.some((status) => status.toLowerCase() === normalized);
+}
+export function requiredStatusNames() {
+    return REQUIRED_WORKFLOW_STATUSES.map((status) => status.name);
+}
+export function requiredCreatableStatuses() {
+    return REQUIRED_WORKFLOW_STATUSES.filter((status) => status.creatable);
+}
+export function lookupRequiredStatus(name) {
+    const normalized = name.trim().toLowerCase();
+    return REQUIRED_WORKFLOW_STATUSES.find((status) => status.name.toLowerCase() === normalized);
+}
+//# sourceMappingURL=linear-status-contract.js.map

package/dist/setup/linear-status-contract.js.map

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

package/dist/setup/linear-webhook-env-local.d.ts

@@ -0,0 +1,10 @@
+export declare function upsertLinearWebhookSecretInEnvContent(existingContent: string | null, secret: string): string;
+export declare function readLinearWebhookSecretFromEnvLocal(input?: {
+    cwd?: string;
+}): Promise<string | undefined>;
+export declare function persistGeneratedLinearWebhookSecret(input: {
+    cwd?: string;
+    secret: string;
+    overwriteExisting?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=linear-webhook-env-local.d.ts.map

package/dist/setup/linear-webhook-env-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-webhook-env-local.d.ts","sourceRoot":"","sources":["../../src/setup/linear-webhook-env-local.ts"],"names":[],"mappings":"AASA,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,MAAM,EAAE,MAAM,GACb,MAAM,CAiDR;AAED,wBAAsB,mCAAmC,CAAC,KAAK,CAAC,EAAE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU9B;AAED,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBnB"}

package/dist/setup/linear-webhook-env-local.js

@@ -0,0 +1,74 @@
+import { writeFile } from "node:fs/promises";
+import { parseEnvFileContent, readExistingEnvFileContent, } from "./env-merge.js";
+import { resolveLocalFilePaths } from "./setup-state.js";
+const LINEAR_WEBHOOK_SECRET_KEY = "LINEAR_WEBHOOK_SECRET";
+export function upsertLinearWebhookSecretInEnvContent(existingContent, secret) {
+    if (existingContent === null) {
+        return `# Operator local setup — harness Step 3 generated secret
+# Do not commit .env.local (gitignored).
+
+${LINEAR_WEBHOOK_SECRET_KEY}=${secret}
+`;
+    }
+    const lines = existingContent.split("\n");
+    const outputLines = [];
+    let sawKey = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            outputLines.push(line);
+            continue;
+        }
+        const separator = trimmed.indexOf("=");
+        if (separator === -1) {
+            outputLines.push(line);
+            continue;
+        }
+        const key = trimmed.slice(0, separator).trim();
+        if (key === LINEAR_WEBHOOK_SECRET_KEY) {
+            sawKey = true;
+            outputLines.push(`${LINEAR_WEBHOOK_SECRET_KEY}=${secret}`);
+            continue;
+        }
+        outputLines.push(line);
+    }
+    if (!sawKey) {
+        if (outputLines.length > 0 && outputLines[outputLines.length - 1] !== "") {
+            outputLines.push("");
+        }
+        outputLines.push(`# --- Harness Step 3 generated secret ---`);
+        outputLines.push(`${LINEAR_WEBHOOK_SECRET_KEY}=${secret}`);
+    }
+    let result = outputLines.join("\n");
+    if (existingContent.endsWith("\n") && !result.endsWith("\n")) {
+        result += "\n";
+    }
+    return result;
+}
+export async function readLinearWebhookSecretFromEnvLocal(input) {
+    const paths = resolveLocalFilePaths(input?.cwd);
+    const existingContent = await readExistingEnvFileContent(paths);
+    if (existingContent === null) {
+        return undefined;
+    }
+    const value = parseEnvFileContent(existingContent).values[LINEAR_WEBHOOK_SECRET_KEY]?.trim();
+    return value || undefined;
+}
+export async function persistGeneratedLinearWebhookSecret(input) {
+    const trimmed = input.secret.trim();
+    if (!trimmed) {
+        return false;
+    }
+    const paths = resolveLocalFilePaths(input.cwd);
+    const existingContent = await readExistingEnvFileContent(paths);
+    const existingSecret = existingContent
+        ? parseEnvFileContent(existingContent).values[LINEAR_WEBHOOK_SECRET_KEY]?.trim()
+        : undefined;
+    if (existingSecret && input.overwriteExisting !== true) {
+        return false;
+    }
+    const nextContent = upsertLinearWebhookSecretInEnvContent(existingContent, trimmed);
+    await writeFile(paths.envLocal, nextContent, "utf8");
+    return true;
+}
+//# sourceMappingURL=linear-webhook-env-local.js.map

package/dist/setup/linear-webhook-env-local.js.map

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