pr-shepherd 0.51.0 → 0.52.0

package/bin/state/bot-cr-seen.mjs

@@ -1,100 +0,0 @@
-/**
- * Persistent first-seen state for bot CHANGES_REQUESTED reviews.
- *
- * Bot CRs are auto-dismissed via `--dismiss-review-ids` in the post-push
- * `apply review:` command. If the agent drops that flag, the bot CR keeps the PR in
- * `CHANGES_REQUESTED` state. This file tracks when each bot CR was first
- * observed so the iterate loop can escalate after `iterate.stallTimeoutMinutes`
- * — independent of the broader fingerprint-based `stall-timeout` mechanism in
- * `iterate-stall.mts` (which only fires when no field of the iterate result
- * changed).
- *
- * State lives in
- * `$TMPDIR/pr-shepherd-state/<owner>-<repo>/<pr>/bot-cr-seen.json`.
- *
- * `bodyHash` lets us reset `firstSeenAt` when the bot re-issues the review
- * with a different body, so a fresh review gets the full timeout window.
- */
-import { readFile, writeFile, rename, unlink, mkdir } from "node:fs/promises";
-import { randomUUID } from "node:crypto";
-import { dirname } from "node:path";
-import { resolvePrStatePath } from "./base.mjs";
-import { hashBody } from "./seen-comments.mjs";
-export async function readBotCrSeenState(key) {
-    try {
-        const raw = await readFile(resolvePath(key), "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed === null || typeof parsed !== "object")
-            return null;
-        const reviews = parsed["reviews"];
-        if (reviews === null || typeof reviews !== "object" || Array.isArray(reviews))
-            return null;
-        const validated = {};
-        for (const [id, entry] of Object.entries(reviews)) {
-            if (entry === null || typeof entry !== "object")
-                continue;
-            const e = entry;
-            if (typeof e["firstSeenAt"] !== "number" || !Number.isFinite(e["firstSeenAt"]))
-                continue;
-            if (typeof e["bodyHash"] !== "string")
-                continue;
-            validated[id] = { firstSeenAt: e["firstSeenAt"], bodyHash: e["bodyHash"] };
-        }
-        return { reviews: validated };
-    }
-    catch {
-        return null;
-    }
-}
-export async function writeBotCrSeenState(key, state) {
-    let tmp;
-    try {
-        const path = resolvePath(key);
-        tmp = `${path}.${randomUUID()}.tmp`;
-        await mkdir(dirname(path), { recursive: true });
-        await writeFile(tmp, JSON.stringify(state), "utf8");
-        await rename(tmp, path);
-        tmp = undefined;
-    }
-    catch {
-        // best-effort
-    }
-    finally {
-        if (tmp !== undefined) {
-            try {
-                await unlink(tmp);
-            }
-            catch {
-                // best-effort cleanup
-            }
-        }
-    }
-}
-/**
- * Update tracked entries against the current set of bot CR reviews:
- * - Insert any new IDs with `firstSeenAt = now` and the current body hash.
- * - Reset `firstSeenAt` for entries whose body hash changed (review re-issued).
- * - Drop entries whose IDs are no longer in the input (review was dismissed
- *   or superseded by an approval).
- *
- * Pure function: returns the next state and the IDs whose age has reached the
- * `stallTimeoutSeconds` threshold (escalate candidates).
- */
-export function updateBotCrSeenState(previous, currentBotCrReviews, nowSeconds, stallTimeoutSeconds) {
-    const previousReviews = previous?.reviews ?? {};
-    const next = {};
-    const staleIds = [];
-    for (const r of currentBotCrReviews) {
-        const bodyHash = hashBody(r.body);
-        const prior = previousReviews[r.id];
-        const entry = prior && prior.bodyHash === bodyHash ? prior : { firstSeenAt: nowSeconds, bodyHash };
-        next[r.id] = entry;
-        if (stallTimeoutSeconds > 0 && nowSeconds - entry.firstSeenAt >= stallTimeoutSeconds) {
-            staleIds.push(r.id);
-        }
-    }
-    return { next: { reviews: next }, staleIds };
-}
-function resolvePath(key) {
-    return resolvePrStatePath(key, "bot-cr-seen.json");
-}