p-dev-harness 0.3.0

package/dist/setup/target-workflow-finalization-lock.js

@@ -0,0 +1,72 @@
+const activeLocks = new Set();
+const latestResults = new Map();
+export function buildFinalizationLockKey(targetRepoSlug, repoConfigId) {
+    return `${targetRepoSlug}:${repoConfigId}`;
+}
+export function isFinalizationLockActive(key) {
+    return activeLocks.has(key);
+}
+export function getCachedFinalizationResult(key) {
+    return latestResults.get(key);
+}
+export function setCachedFinalizationResult(key, result) {
+    latestResults.set(key, result);
+}
+export function clearCachedFinalizationResult(key) {
+    latestResults.delete(key);
+}
+/**
+ * Serializes finalization for one target repo config. Concurrent callers wait for
+ * the in-flight advancement, then receive the latest cached result without
+ * issuing duplicate mutations.
+ */
+export async function withTargetWorkflowFinalizationLock(key, fn) {
+    if (activeLocks.has(key)) {
+        const cached = latestResults.get(key);
+        if (cached) {
+            return { result: cached, lockContended: true };
+        }
+        await waitForLockRelease(key);
+        const afterWait = latestResults.get(key);
+        if (afterWait) {
+            return { result: afterWait, lockContended: true };
+        }
+    }
+    activeLocks.add(key);
+    try {
+        const result = await fn();
+        if (typeof result === "object" &&
+            result !== null &&
+            "lifecycle" in result) {
+            const finalization = result;
+            latestResults.set(key, finalization);
+            if (finalization.lifecycle === "complete") {
+                latestResults.delete(key);
+            }
+        }
+        return { result, lockContended: false };
+    }
+    finally {
+        activeLocks.delete(key);
+        notifyLockReleased(key);
+    }
+}
+const lockWaiters = new Map();
+function waitForLockRelease(key) {
+    if (!activeLocks.has(key)) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        const waiters = lockWaiters.get(key) ?? [];
+        waiters.push(resolve);
+        lockWaiters.set(key, waiters);
+    });
+}
+export function notifyLockReleased(key) {
+    const waiters = lockWaiters.get(key) ?? [];
+    lockWaiters.delete(key);
+    for (const resolve of waiters) {
+        resolve();
+    }
+}
+//# sourceMappingURL=target-workflow-finalization-lock.js.map

package/dist/setup/target-workflow-finalization-lock.js.map

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

package/dist/setup/target-workflow-finalization-types.d.ts

@@ -0,0 +1,32 @@
+export type WorkflowInstallLifecycle = "preparing" | "pr-created" | "pr-updated" | "waiting-for-checks" | "updating-branch" | "merging" | "verifying" | "complete" | "blocked";
+export type WorkflowInstallBlockedCategory = "checks-pending" | "checks-failing" | "mergeability-pending" | "branch-behind" | "review-required" | "permission-denied" | "merge-conflict" | "unexpected-pr-content" | "merge-queue-required" | "merge-api-failure" | "verification-failed";
+export interface TargetWorkflowFinalizationResult {
+    repoConfigId: string;
+    targetRepo: string;
+    targetRepoSlug: string;
+    productionBranch: string;
+    branchName: string;
+    lifecycle: WorkflowInstallLifecycle;
+    blockedCategory?: WorkflowInstallBlockedCategory;
+    message: string;
+    prUrl?: string;
+    prNumber?: number;
+    validatedHeadSha?: string;
+    workflowStatus: "present" | "missing" | "differs" | "unknown";
+    canRetry: boolean;
+    requiresGitHubIntervention: boolean;
+    advancedThisRequest: boolean;
+    lockContended: boolean;
+}
+export interface TargetWorkflowFinalizeInput {
+    repoConfigId: string;
+    targetRepo: string;
+    productionBranch: string;
+    manualHarnessDispatchRepo?: string;
+    prUrl?: string;
+    branchName?: string;
+}
+export declare const WORKFLOW_INSTALL_CHECK_POLL_TIMEOUT_MS = 120000;
+export declare const WORKFLOW_INSTALL_VERIFICATION_TIMEOUT_MS = 60000;
+export declare const WORKFLOW_INSTALL_SHORT_POLL_INTERVAL_MS = 2000;
+//# sourceMappingURL=target-workflow-finalization-types.d.ts.map

package/dist/setup/target-workflow-finalization-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-workflow-finalization-types.d.ts","sourceRoot":"","sources":["../../src/setup/target-workflow-finalization-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,iBAAiB,GACjB,SAAS,GACT,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,8BAA8B,GACtC,gBAAgB,GAChB,gBAAgB,GAChB,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,uBAAuB,GACvB,sBAAsB,GACtB,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,wBAAwB,CAAC;IACpC,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,0BAA0B,EAAE,OAAO,CAAC;IACpC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sCAAsC,SAAU,CAAC;AAC9D,eAAO,MAAM,wCAAwC,QAAS,CAAC;AAC/D,eAAO,MAAM,uCAAuC,OAAQ,CAAC"}

package/dist/setup/target-workflow-finalization-types.js

@@ -0,0 +1,4 @@
+export const WORKFLOW_INSTALL_CHECK_POLL_TIMEOUT_MS = 120_000;
+export const WORKFLOW_INSTALL_VERIFICATION_TIMEOUT_MS = 60_000;
+export const WORKFLOW_INSTALL_SHORT_POLL_INTERVAL_MS = 2_000;
+//# sourceMappingURL=target-workflow-finalization-types.js.map

package/dist/setup/target-workflow-finalization-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-workflow-finalization-types.js","sourceRoot":"","sources":["../../src/setup/target-workflow-finalization-types.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,sCAAsC,GAAG,OAAO,CAAC;AAC9D,MAAM,CAAC,MAAM,wCAAwC,GAAG,MAAM,CAAC;AAC/D,MAAM,CAAC,MAAM,uCAAuC,GAAG,KAAK,CAAC"}

package/dist/setup/target-workflow-finalization.d.ts

@@ -0,0 +1,19 @@
+import { type GitHubClient } from "../github/client.js";
+import type { GitHubRemoteSetupProvider } from "./github-remote-provider.js";
+import type { TargetWorkflowFinalizeInput, TargetWorkflowFinalizationResult } from "./target-workflow-finalization-types.js";
+export interface AdvanceTargetWorkflowFinalizationOptions {
+    cwd?: string;
+    input: TargetWorkflowFinalizeInput;
+    provider: GitHubRemoteSetupProvider;
+    client: GitHubClient;
+    lockContended?: boolean;
+}
+export declare function advanceTargetWorkflowFinalizationStep(options: AdvanceTargetWorkflowFinalizationOptions): Promise<TargetWorkflowFinalizationResult>;
+export declare function finalizeTargetWorkflowRemote(options: {
+    cwd?: string;
+    input: TargetWorkflowFinalizeInput;
+    provider: GitHubRemoteSetupProvider;
+    client: GitHubClient;
+}): Promise<TargetWorkflowFinalizationResult>;
+export declare function resetTargetWorkflowFinalizationSessionsForTests(): void;
+//# sourceMappingURL=target-workflow-finalization.d.ts.map

package/dist/setup/target-workflow-finalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-workflow-finalization.d.ts","sourceRoot":"","sources":["../../src/setup/target-workflow-finalization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA+BxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAK7E,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAGjC,MAAM,yCAAyC,CAAC;AA4KjD,MAAM,WAAW,wCAAwC;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,wCAAwC,GAChD,OAAO,CAAC,gCAAgC,CAAC,CA6nB3C;AAED,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAuB5C;AAED,wBAAgB,+CAA+C,IAAI,IAAI,CAEtE"}