p-dev-harness 0.3.0 → 0.4.0

package/dist/setup/runner-upgrade-three-way.js

@@ -0,0 +1,102 @@
+export function extractFileHashesFromManifest(manifest) {
+    const hashes = {};
+    for (const file of manifest.files) {
+        hashes[file.path] = file.sha256;
+    }
+    return hashes;
+}
+export function extractFileHashesFromMarker(marker) {
+    const fileHashes = marker.createdFromPackageSnapshot?.fileHashes;
+    if (!fileHashes || typeof fileHashes !== "object") {
+        return null;
+    }
+    const entries = Object.entries(fileHashes).filter(([path, hash]) => typeof path === "string" && path.length > 0 && typeof hash === "string" && hash.length > 0);
+    if (entries.length === 0) {
+        return null;
+    }
+    return Object.fromEntries(entries);
+}
+function sortedPaths(map) {
+    return Object.keys(map).sort();
+}
+function collectChangedPaths(input) {
+    const replacePaths = [];
+    const deletePaths = [];
+    const allPaths = new Set([
+        ...sortedPaths(input.previousHashes),
+        ...sortedPaths(input.nextHashes),
+    ]);
+    for (const filePath of [...allPaths].sort()) {
+        const previousHash = input.previousHashes[filePath];
+        const nextHash = input.nextHashes[filePath];
+        if (previousHash === nextHash) {
+            continue;
+        }
+        if (nextHash === undefined) {
+            deletePaths.push(filePath);
+            continue;
+        }
+        replacePaths.push(filePath);
+    }
+    return { replacePaths, deletePaths };
+}
+function resolvePreviousHashesForCompare(input) {
+    if (input.previousHashes) {
+        return { hashes: input.previousHashes };
+    }
+    const remoteTreeExactMatch = Boolean(input.remoteTreeSha) &&
+        Boolean(input.previousTreeSha) &&
+        input.remoteTreeSha === input.previousTreeSha;
+    const snapshotIdentityMatch = Boolean(input.previousSnapshotContentId) &&
+        Boolean(input.remoteSnapshotContentId) &&
+        input.remoteSnapshotContentId === input.previousSnapshotContentId;
+    if (snapshotIdentityMatch && remoteTreeExactMatch) {
+        return { hashes: input.remoteHashes };
+    }
+    return {
+        ok: false,
+        code: "legacy_unsafe",
+        conflictPaths: [],
+        message: "legacy_marker_without_hashes",
+    };
+}
+export function compareThreeWayUpgrade(input) {
+    const previousResolved = resolvePreviousHashesForCompare(input);
+    if ("ok" in previousResolved) {
+        return previousResolved;
+    }
+    const previousHashes = previousResolved.hashes;
+    const { replacePaths, deletePaths } = collectChangedPaths({
+        previousHashes,
+        nextHashes: input.nextHashes,
+    });
+    const managedChangePaths = [...replacePaths, ...deletePaths];
+    const conflictPaths = [];
+    for (const filePath of managedChangePaths) {
+        const previousHash = previousHashes[filePath];
+        const remoteHash = input.remoteHashes[filePath];
+        if (previousHash === undefined) {
+            if (remoteHash !== undefined) {
+                conflictPaths.push(filePath);
+            }
+            continue;
+        }
+        if (remoteHash !== previousHash) {
+            conflictPaths.push(filePath);
+        }
+    }
+    if (conflictPaths.length > 0) {
+        return {
+            ok: false,
+            code: "operator_conflicts",
+            conflictPaths: [...new Set(conflictPaths)].sort(),
+            message: "Operator edits conflict with the packaged runner upgrade.",
+        };
+    }
+    return {
+        ok: true,
+        replacePaths,
+        deletePaths,
+    };
+}
+//# sourceMappingURL=runner-upgrade-three-way.js.map

package/dist/setup/runner-upgrade-three-way.js.map

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

package/dist/setup/runner-upgrade-timeouts.d.ts

@@ -0,0 +1,72 @@
+export declare const RUNNER_UPGRADE_STATUS_PROVIDER_TIMEOUT_MS = 5000;
+export declare const RUNNER_UPGRADE_STATUS_OVERALL_DEADLINE_MS = 8000;
+export declare const RUNNER_UPGRADE_WORKER_PROVIDER_TIMEOUT_MS = 60000;
+export declare const RUNNER_UPGRADE_WORKER_COMPARE_BATCH_TIMEOUT_MS = 30000;
+export declare const RUNNER_UPGRADE_NO_PROGRESS_STALE_MS = 30000;
+export declare const RUNNER_UPGRADE_HEARTBEAT_EVERY_FILES = 5;
+export type RunnerUpgradeStatusStage = "local_state_reads" | "embedded_snapshot_identity" | "provider_wrapper" | "timeout_wrapper" | "context_normalization" | "marker_parsing" | "status_conversion" | "reconciliation_enqueue" | "mutex_acquisition" | "response_serialization";
+export declare class RunnerUpgradeTimeoutError extends Error {
+    readonly callName: string;
+    readonly timeoutMs: number;
+    readonly unresolvedStage?: RunnerUpgradeStatusStage | undefined;
+    readonly code = "runner_upgrade_timeout";
+    readonly retryable = true;
+    constructor(message: string, callName: string, timeoutMs: number, unresolvedStage?: RunnerUpgradeStatusStage | undefined);
+}
+export interface RunnerUpgradeCallTiming {
+    call: string;
+    durationMs: number;
+    timedOut: boolean;
+}
+export interface RunnerUpgradeStageTiming {
+    stage: string;
+    durationMs: number;
+    timedOut?: boolean;
+}
+export declare function getLastRunnerUpgradeStatusCallTimings(): RunnerUpgradeCallTiming[];
+export declare function recordRunnerUpgradeStatusCallTimings(timings: RunnerUpgradeCallTiming[]): void;
+export declare function getLastRunnerUpgradeStatusStageTimings(): RunnerUpgradeStageTiming[];
+export declare function getLastUnresolvedRunnerUpgradeStatusStage(): RunnerUpgradeStatusStage | undefined;
+export declare function resetRunnerUpgradeStatusStageTrackerForTests(): void;
+export declare class RunnerUpgradeStatusStageTracker {
+    private readonly timings;
+    private current;
+    unresolvedStage: RunnerUpgradeStatusStage | undefined;
+    begin(stage: RunnerUpgradeStatusStage): void;
+    end(timedOut?: boolean): void;
+    markTimedOut(): void;
+    snapshot(): RunnerUpgradeStageTiming[];
+    commit(): void;
+}
+export declare function throwIfRunnerUpgradeAborted(signal?: AbortSignal): void;
+/**
+ * Race-only timeout. Never awaits the original operation after timeout.
+ * Honors an optional parent signal; clears its timer on settle.
+ */
+export declare function withRunnerUpgradeTimeout<T>(callName: string, timeoutMs: number, operation: (signal: AbortSignal) => Promise<T>, parentSignal?: AbortSignal): Promise<T>;
+export declare function withTimedRunnerUpgradeCall<T>(callName: string, timeoutMs: number, operation: (signal: AbortSignal) => Promise<T>, onTiming?: (timing: RunnerUpgradeCallTiming) => void, parentSignal?: AbortSignal): Promise<T>;
+export declare function abortInFlightRunnerUpgradeStatus(workspaceKey: string): void;
+export declare function beginRunnerUpgradeStatusRequest(workspaceKey: string): {
+    signal: AbortSignal;
+    controller: AbortController;
+};
+export declare function endRunnerUpgradeStatusRequest(workspaceKey: string, controller: AbortController): void;
+/**
+ * Absolute deadline around an entire status load. On timeout, aborts the
+ * request signal and returns without awaiting abandoned work.
+ */
+export declare function withRunnerUpgradeStatusDeadline<T>(deadlineMs: number, signal: AbortSignal, abortRequest: () => void, operation: (signal: AbortSignal) => Promise<T>, onTimeout: (unresolvedStage?: RunnerUpgradeStatusStage) => T | Promise<T>, tracker?: RunnerUpgradeStatusStageTracker): Promise<T>;
+export declare function isRunnerUpgradeProgressStale(input: {
+    updatedAt?: string;
+    lastSuccessfulProviderCallAt?: string;
+    workerHeartbeatAt?: string;
+    nowMs?: number;
+    staleMs?: number;
+}): boolean;
+/** Client-safe: no Node fs imports. */
+export declare function runnerUpgradeProgressShowsNoProgress(progress: {
+    updatedAt?: string;
+    lastSuccessfulProviderCallAt?: string;
+    workerHeartbeatAt?: string;
+} | null | undefined, nowMs?: number): boolean;
+//# sourceMappingURL=runner-upgrade-timeouts.d.ts.map

package/dist/setup/runner-upgrade-timeouts.d.ts.map

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

package/dist/setup/runner-upgrade-timeouts.js

@@ -0,0 +1,261 @@
+export const RUNNER_UPGRADE_STATUS_PROVIDER_TIMEOUT_MS = 5_000;
+export const RUNNER_UPGRADE_STATUS_OVERALL_DEADLINE_MS = 8_000;
+export const RUNNER_UPGRADE_WORKER_PROVIDER_TIMEOUT_MS = 60_000;
+export const RUNNER_UPGRADE_WORKER_COMPARE_BATCH_TIMEOUT_MS = 30_000;
+export const RUNNER_UPGRADE_NO_PROGRESS_STALE_MS = 30_000;
+export const RUNNER_UPGRADE_HEARTBEAT_EVERY_FILES = 5;
+export class RunnerUpgradeTimeoutError extends Error {
+    callName;
+    timeoutMs;
+    unresolvedStage;
+    code = "runner_upgrade_timeout";
+    retryable = true;
+    constructor(message, callName, timeoutMs, unresolvedStage) {
+        super(message);
+        this.callName = callName;
+        this.timeoutMs = timeoutMs;
+        this.unresolvedStage = unresolvedStage;
+        this.name = "RunnerUpgradeTimeoutError";
+    }
+}
+let lastStatusCallTimings = [];
+let lastStatusStageTimings = [];
+let lastUnresolvedStage;
+export function getLastRunnerUpgradeStatusCallTimings() {
+    return [...lastStatusCallTimings];
+}
+export function recordRunnerUpgradeStatusCallTimings(timings) {
+    lastStatusCallTimings = [...timings];
+}
+export function getLastRunnerUpgradeStatusStageTimings() {
+    return [...lastStatusStageTimings];
+}
+export function getLastUnresolvedRunnerUpgradeStatusStage() {
+    return lastUnresolvedStage;
+}
+export function resetRunnerUpgradeStatusStageTrackerForTests() {
+    lastStatusCallTimings = [];
+    lastStatusStageTimings = [];
+    lastUnresolvedStage = undefined;
+}
+export class RunnerUpgradeStatusStageTracker {
+    timings = [];
+    current = null;
+    unresolvedStage;
+    begin(stage) {
+        if (this.current) {
+            this.end(false);
+        }
+        this.current = { stage, started: Date.now() };
+        this.unresolvedStage = stage;
+    }
+    end(timedOut = false) {
+        if (!this.current) {
+            return;
+        }
+        this.timings.push({
+            stage: this.current.stage,
+            durationMs: Date.now() - this.current.started,
+            timedOut: timedOut || undefined,
+        });
+        if (!timedOut) {
+            this.unresolvedStage = undefined;
+        }
+        this.current = null;
+    }
+    markTimedOut() {
+        if (this.current) {
+            this.end(true);
+        }
+    }
+    snapshot() {
+        return [...this.timings];
+    }
+    commit() {
+        lastStatusStageTimings = this.snapshot();
+        lastUnresolvedStage = this.unresolvedStage;
+    }
+}
+function combineAbortSignals(...signals) {
+    const active = signals.filter((signal) => Boolean(signal));
+    if (active.length === 0) {
+        return undefined;
+    }
+    if (active.length === 1) {
+        return active[0];
+    }
+    if (typeof AbortSignal.any === "function") {
+        return AbortSignal.any(active);
+    }
+    const controller = new AbortController();
+    for (const signal of active) {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        signal.addEventListener("abort", () => {
+            controller.abort(signal.reason);
+        }, { once: true });
+    }
+    return controller.signal;
+}
+export function throwIfRunnerUpgradeAborted(signal) {
+    if (signal?.aborted) {
+        throw new RunnerUpgradeTimeoutError("Runner upgrade status request was aborted.", "aborted", 0);
+    }
+}
+/**
+ * Race-only timeout. Never awaits the original operation after timeout.
+ * Honors an optional parent signal; clears its timer on settle.
+ */
+export async function withRunnerUpgradeTimeout(callName, timeoutMs, operation, parentSignal) {
+    throwIfRunnerUpgradeAborted(parentSignal);
+    const controller = new AbortController();
+    const combined = combineAbortSignals(controller.signal, parentSignal);
+    let timer = setTimeout(() => {
+        controller.abort();
+    }, timeoutMs);
+    const timeoutPromise = new Promise((_resolve, reject) => {
+        const onAbort = () => {
+            reject(new RunnerUpgradeTimeoutError(parentSignal?.aborted && !controller.signal.aborted
+                ? `${callName} aborted.`
+                : `${callName} timed out after ${timeoutMs}ms.`, callName, timeoutMs));
+        };
+        if (combined.aborted) {
+            onAbort();
+            return;
+        }
+        combined.addEventListener("abort", onAbort, { once: true });
+    });
+    const operationPromise = operation(combined).catch((error) => {
+        // If this loses the race, swallow later; if it wins, rethrow.
+        if (combined.aborted) {
+            throw error instanceof RunnerUpgradeTimeoutError
+                ? error
+                : new RunnerUpgradeTimeoutError(`${callName} aborted.`, callName, timeoutMs);
+        }
+        throw error;
+    });
+    try {
+        return await Promise.race([operationPromise, timeoutPromise]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        // Abort so abandoned fetch/work stops; do not await operationPromise.
+        if (!controller.signal.aborted) {
+            controller.abort();
+        }
+        void operationPromise.catch(() => {
+            // Swallow abandoned rejection after the race has settled.
+        });
+    }
+}
+export async function withTimedRunnerUpgradeCall(callName, timeoutMs, operation, onTiming, parentSignal) {
+    const started = Date.now();
+    try {
+        const result = await withRunnerUpgradeTimeout(callName, timeoutMs, operation, parentSignal);
+        onTiming?.({
+            call: callName,
+            durationMs: Date.now() - started,
+            timedOut: false,
+        });
+        return result;
+    }
+    catch (error) {
+        const timedOut = error instanceof RunnerUpgradeTimeoutError;
+        onTiming?.({
+            call: callName,
+            durationMs: Date.now() - started,
+            timedOut,
+        });
+        throw error;
+    }
+}
+const statusControllersByWorkspace = new Map();
+export function abortInFlightRunnerUpgradeStatus(workspaceKey) {
+    const previous = statusControllersByWorkspace.get(workspaceKey);
+    if (previous && !previous.signal.aborted) {
+        previous.abort();
+    }
+    statusControllersByWorkspace.delete(workspaceKey);
+}
+export function beginRunnerUpgradeStatusRequest(workspaceKey) {
+    abortInFlightRunnerUpgradeStatus(workspaceKey);
+    const controller = new AbortController();
+    statusControllersByWorkspace.set(workspaceKey, controller);
+    return { signal: controller.signal, controller };
+}
+export function endRunnerUpgradeStatusRequest(workspaceKey, controller) {
+    if (statusControllersByWorkspace.get(workspaceKey) === controller) {
+        statusControllersByWorkspace.delete(workspaceKey);
+    }
+}
+/**
+ * Absolute deadline around an entire status load. On timeout, aborts the
+ * request signal and returns without awaiting abandoned work.
+ */
+export async function withRunnerUpgradeStatusDeadline(deadlineMs, signal, abortRequest, operation, onTimeout, tracker) {
+    let timer;
+    let settled = false;
+    const deadlinePromise = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            tracker?.markTimedOut();
+            const unresolved = tracker?.unresolvedStage;
+            abortRequest();
+            void Promise.resolve(onTimeout(unresolved)).then((value) => {
+                if (!settled) {
+                    settled = true;
+                    resolve(value);
+                }
+            });
+        }, deadlineMs);
+    });
+    const operationPromise = operation(signal).then((value) => {
+        settled = true;
+        return value;
+    }, (error) => {
+        if (signal.aborted) {
+            // Abandoned after deadline — never surface into the request path.
+            return onTimeout(tracker?.unresolvedStage);
+        }
+        throw error;
+    });
+    try {
+        return await Promise.race([operationPromise, deadlinePromise]);
+    }
+    finally {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+        }
+        void operationPromise.catch(() => {
+            // Swallow abandoned rejection after the race has settled.
+        });
+    }
+}
+export function isRunnerUpgradeProgressStale(input) {
+    const staleMs = input.staleMs ?? RUNNER_UPGRADE_NO_PROGRESS_STALE_MS;
+    const nowMs = input.nowMs ?? Date.now();
+    const updatedAtMs = input.updatedAt ? Date.parse(input.updatedAt) : Number.NaN;
+    const heartbeatSource = input.lastSuccessfulProviderCallAt ?? input.workerHeartbeatAt;
+    const heartbeatMs = heartbeatSource ? Date.parse(heartbeatSource) : Number.NaN;
+    if (!Number.isFinite(updatedAtMs) || !Number.isFinite(heartbeatMs)) {
+        return false;
+    }
+    return nowMs - updatedAtMs >= staleMs && nowMs - heartbeatMs >= staleMs;
+}
+/** Client-safe: no Node fs imports. */
+export function runnerUpgradeProgressShowsNoProgress(progress, nowMs = Date.now()) {
+    if (!progress) {
+        return false;
+    }
+    return isRunnerUpgradeProgressStale({
+        updatedAt: progress.updatedAt,
+        lastSuccessfulProviderCallAt: progress.lastSuccessfulProviderCallAt,
+        workerHeartbeatAt: progress.workerHeartbeatAt,
+        nowMs,
+    });
+}
+//# sourceMappingURL=runner-upgrade-timeouts.js.map

package/dist/setup/runner-upgrade-timeouts.js.map

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

package/dist/setup/runner-upgrade-types.d.ts

@@ -0,0 +1,84 @@
+export declare const RUNNER_UPGRADE_CANARY_WORKFLOW_PATH = ".github/workflows/p-dev-runner-config-canary.yml";
+export type RunnerUpgradePhase = "verifying-managed-repository" | "comparing-runner-snapshots" | "preparing-upgrade-commit" | "updating-managed-runner" | "verifying-runner-on-production-branch" | "synchronizing-cloud-configuration" | "running-configuration-canary";
+export type RunnerUpgradeUiPhase = RunnerUpgradePhase;
+export type RunnerUpgradeStatus = "up_to_date" | "update_available" | "checking" | "updating" | "partially_updated" | "failed" | "blocked_non_managed" | "blocked_unexpected_remote" | "blocked_operator_conflicts";
+export declare function buildRunnerUpgradePrMarker(repositoryId: number, snapshotContentId: string): string;
+export declare function parseRunnerUpgradePrMarker(body: string): {
+    repositoryId: number;
+    snapshotContentId: string;
+} | null;
+export declare function buildRunnerUpgradeBranchName(snapshotContentId: string): string;
+export declare function runnerUpgradePhaseLabel(phase: RunnerUpgradePhase): string;
+export declare function runnerUpgradeStatusLabel(status: RunnerUpgradeStatus): string;
+export interface RunnerUpgradeSnapshotSummary {
+    snapshotContentId: string;
+    packageVersion: string;
+    sourceCommit: string;
+}
+export interface RunnerUpgradeImpactSummary {
+    replacePathCount: number;
+    deletePathCount: number;
+    sampleReplacePaths: string[];
+    sampleDeletePaths: string[];
+}
+export interface RunnerUpgradeStatusResult {
+    status: RunnerUpgradeStatus;
+    statusLabel: string;
+    currentSnapshot?: RunnerUpgradeSnapshotSummary;
+    availableSnapshot?: RunnerUpgradeSnapshotSummary;
+    pendingOperationId?: string;
+    pendingPhase?: RunnerUpgradePhase;
+    conflictPaths?: string[];
+    blockedReason?: string;
+    canaryRunUrl?: string;
+    prUrl?: string;
+    retryGuidance?: string;
+    degraded?: boolean;
+    /** True when local managed-repo marker/evidence exists (not remote-verified). */
+    localManagedRepoEvidence?: boolean;
+    /** True when currentSnapshot comes from last-verified cache, not this request. */
+    currentSnapshotCached?: boolean;
+    /** ISO timestamp when cached/live current identity was last verified remotely. */
+    currentSnapshotVerifiedAt?: string;
+    /** Last status pipeline stage that had not completed when the request timed out. */
+    unresolvedStage?: string;
+    /** Present when debug timings are enabled (env or query flag). */
+    debugTimings?: Array<{
+        stage: string;
+        durationMs: number;
+        timedOut?: boolean;
+    }>;
+    /** Client/UI hint: Retry status control should be shown. */
+    retryAvailable?: boolean;
+}
+export interface RunnerUpgradeAcceptResult {
+    operationId: string;
+    status: "updating";
+    phase: RunnerUpgradePhase;
+    previewFingerprint: string;
+    message: string;
+}
+export interface RunnerUpgradePreviewResult {
+    previewFingerprint: string;
+    targetSnapshotContentId: string;
+    currentSnapshotContentId?: string;
+    impact: RunnerUpgradeImpactSummary;
+    phases: RunnerUpgradePhase[];
+    blocked?: boolean;
+    blockedStatus?: RunnerUpgradeStatus;
+    conflictPaths?: string[];
+    message?: string;
+}
+export interface RunnerUpgradeApplyResult {
+    operationId: string;
+    status: RunnerUpgradeStatus;
+    phase: RunnerUpgradePhase;
+    previewFingerprint: string;
+    prUrl?: string;
+    prNumber?: number;
+    branchName?: string;
+    canaryRunId?: string;
+    canaryRunUrl?: string;
+    message?: string;
+}
+//# sourceMappingURL=runner-upgrade-types.d.ts.map

package/dist/setup/runner-upgrade-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-upgrade-types.d.ts","sourceRoot":"","sources":["../../src/setup/runner-upgrade-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mCAAmC,qDACI,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAC1B,8BAA8B,GAC9B,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,GACzB,uCAAuC,GACvC,mCAAmC,GACnC,8BAA8B,CAAC;AAEnC,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,mBAAmB,GACnB,QAAQ,GACR,qBAAqB,GACrB,2BAA2B,GAC3B,4BAA4B,CAAC;AAKjC,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAER;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,IAAI,CAcP;AAED,wBAAgB,4BAA4B,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAiBzE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAqB5E;AAED,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kFAAkF;IAClF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/setup/runner-upgrade-types.js

@@ -0,0 +1,64 @@
+export const RUNNER_UPGRADE_CANARY_WORKFLOW_PATH = ".github/workflows/p-dev-runner-config-canary.yml";
+const RUNNER_UPGRADE_PR_MARKER_PATTERN = /<!--\s*p-dev-runner-upgrade:(\d+):([^\s>]+)\s*-->/;
+export function buildRunnerUpgradePrMarker(repositoryId, snapshotContentId) {
+    return `<!-- p-dev-runner-upgrade:${repositoryId}:${snapshotContentId} -->`;
+}
+export function parseRunnerUpgradePrMarker(body) {
+    const match = body.match(RUNNER_UPGRADE_PR_MARKER_PATTERN);
+    if (!match) {
+        return null;
+    }
+    const repositoryId = Number(match[1]);
+    if (!Number.isInteger(repositoryId) || repositoryId <= 0) {
+        return null;
+    }
+    const snapshotContentId = match[2]?.trim();
+    if (!snapshotContentId) {
+        return null;
+    }
+    return { repositoryId, snapshotContentId };
+}
+export function buildRunnerUpgradeBranchName(snapshotContentId) {
+    return `harness/update-runner-${snapshotContentId.slice(0, 12)}`;
+}
+export function runnerUpgradePhaseLabel(phase) {
+    switch (phase) {
+        case "verifying-managed-repository":
+            return "Verifying managed repository";
+        case "comparing-runner-snapshots":
+            return "Comparing runner snapshots";
+        case "preparing-upgrade-commit":
+            return "Preparing upgrade commit";
+        case "updating-managed-runner":
+            return "Updating managed runner";
+        case "verifying-runner-on-production-branch":
+            return "Verifying runner on production branch";
+        case "synchronizing-cloud-configuration":
+            return "Synchronizing cloud configuration";
+        case "running-configuration-canary":
+            return "Running configuration canary";
+    }
+}
+export function runnerUpgradeStatusLabel(status) {
+    switch (status) {
+        case "up_to_date":
+            return "Up to date";
+        case "update_available":
+            return "Update available";
+        case "checking":
+            return "Checking runner version";
+        case "updating":
+            return "Updating";
+        case "partially_updated":
+            return "Partially updated";
+        case "failed":
+            return "Failed";
+        case "blocked_non_managed":
+            return "Blocked — repository is not managed";
+        case "blocked_unexpected_remote":
+            return "Blocked — unexpected remote changes";
+        case "blocked_operator_conflicts":
+            return "Blocked — operator conflicts";
+    }
+}
+//# sourceMappingURL=runner-upgrade-types.js.map

package/dist/setup/runner-upgrade-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-upgrade-types.js","sourceRoot":"","sources":["../../src/setup/runner-upgrade-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mCAAmC,GAC9C,kDAAkD,CAAC;AAwBrD,MAAM,gCAAgC,GACpC,mDAAmD,CAAC;AAEtD,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,iBAAyB;IAEzB,OAAO,6BAA6B,YAAY,IAAI,iBAAiB,MAAM,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IAIrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,iBAAyB;IACpE,OAAO,yBAAyB,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAyB;IAC/D,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,8BAA8B;YACjC,OAAO,8BAA8B,CAAC;QACxC,KAAK,4BAA4B;YAC/B,OAAO,4BAA4B,CAAC;QACtC,KAAK,0BAA0B;YAC7B,OAAO,0BAA0B,CAAC;QACpC,KAAK,yBAAyB;YAC5B,OAAO,yBAAyB,CAAC;QACnC,KAAK,uCAAuC;YAC1C,OAAO,uCAAuC,CAAC;QACjD,KAAK,mCAAmC;YACtC,OAAO,mCAAmC,CAAC;QAC7C,KAAK,8BAA8B;YACjC,OAAO,8BAA8B,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA2B;IAClE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB,KAAK,kBAAkB;YACrB,OAAO,kBAAkB,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,yBAAyB,CAAC;QACnC,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,qBAAqB;YACxB,OAAO,qCAAqC,CAAC;QAC/C,KAAK,2BAA2B;YAC9B,OAAO,qCAAqC,CAAC;QAC/C,KAAK,4BAA4B;YAC/B,OAAO,8BAA8B,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/setup/runner-upgrade-worker.d.ts

@@ -0,0 +1,17 @@
+import type { RunnerUpgradeGitHubProvider } from "./runner-upgrade-provider.js";
+export type RunnerUpgradeWorkerProviderResolver = (cwd: string | undefined) => Promise<RunnerUpgradeGitHubProvider | undefined>;
+export type RunnerUpgradeWorkerExecutor = (cwd: string | undefined, provider: RunnerUpgradeGitHubProvider) => Promise<unknown>;
+export declare function configureRunnerUpgradeWorker(input: {
+    resolveProvider: RunnerUpgradeWorkerProviderResolver;
+    execute: RunnerUpgradeWorkerExecutor;
+}): void;
+export declare function isRunnerUpgradeOperationActive(operationId: string): boolean;
+export declare function listActiveRunnerUpgradeOperationIds(): string[];
+export declare function enqueueRunnerUpgradeOperation(operationId: string, cwd?: string): void;
+export declare function ensureRunnerUpgradeWorkerStarted(): void;
+export declare function reconcileAbandonedRunnerUpgrades(cwd?: string): Promise<void>;
+/** Test-only: reset process-level worker state between cases. */
+export declare function resetRunnerUpgradeWorkerForTests(): void;
+/** Test-only: wait until the queue and active set are empty. */
+export declare function waitForRunnerUpgradeWorkerIdle(timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=runner-upgrade-worker.d.ts.map

package/dist/setup/runner-upgrade-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-upgrade-worker.d.ts","sourceRoot":"","sources":["../../src/setup/runner-upgrade-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAEhF,MAAM,MAAM,mCAAmC,GAAG,CAChD,GAAG,EAAE,MAAM,GAAG,SAAS,KACpB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GAAG,CACxC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,2BAA2B,KAClC,OAAO,CAAC,OAAO,CAAC,CAAC;AAgBtB,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,eAAe,EAAE,mCAAmC,CAAC;IACrD,OAAO,EAAE,2BAA2B,CAAC;CACtC,GAAG,IAAI,CAGP;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAE9D;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAON;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAMvD;AAED,wBAAsB,gCAAgC,CACpD,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAaf;AA6CD,iEAAiE;AACjE,wBAAgB,gCAAgC,IAAI,IAAI,CAQvD;AAED,gEAAgE;AAChE,wBAAsB,8BAA8B,CAClD,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,CAYf"}