@openagt/dashboard 0.0.0-stage → 0.9.0

package/dist/cloud-run-state.js

@@ -0,0 +1,36 @@
+// What a Claude web run is doing, read off facts the daemon already holds (#1668).
+//
+// A web run's local half ends at its hand-off (#1231), so its stored status is `done` from that
+// moment on — which said nothing about the session still working on claude.ai, parked on a
+// question, or long finished. The rail wrote "in cloud" over every such run, forever. This is the
+// one place that turns the record into the word a local run's row would show, and it is node-free
+// so the dashboard client, the rail and the Overview all derive the same word from the same rule.
+/**
+ * How long after its start a run's cloud session is still assumed to be alive. The same window
+ * the browser bridge watches a session for (`bridge-sessions`): past it nothing could learn the
+ * session is parked, so "in cloud" would be a guess nobody can correct — hence "done".
+ */
+export const CLOUD_SESSION_WINDOW_MS = 12 * 60 * 60 * 1000;
+/**
+ * The cloud state of a web run whose local half is over, or undefined for any other run — a
+ * local run, or a web run still handing off, stopped or failed — whose stored status is the word.
+ */
+export function cloudRunState(meta, now) {
+    if (meta.target !== 'web' || meta.status !== 'done')
+        return undefined;
+    if (meta.cloudWaiting)
+        return 'waiting';
+    if (meta.mergeOutcome === 'merged')
+        return 'merged';
+    // A recorded pull request's state is not on the record — it is read live wherever the PR badge
+    // shows — so the row says only that the run is over, exactly as a local run with a PR does.
+    if (meta.pr)
+        return 'done';
+    const started = Date.parse(meta.startedAt);
+    return Number.isFinite(started) && now - started <= CLOUD_SESSION_WINDOW_MS ? 'in-cloud' : 'done';
+}
+/** Whether the cloud side still counts as an agent at work: in its session, or waiting on a human. */
+export function cloudRunActive(state) {
+    return state === 'waiting' || state === 'in-cloud';
+}
+//# sourceMappingURL=cloud-run-state.js.map

package/dist/cloud-run-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-run-state.js","sourceRoot":"","sources":["../src/cloud-run-state.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,EAAE;AACF,gGAAgG;AAChG,2FAA2F;AAC3F,kGAAkG;AAClG,kGAAkG;AAClG,kGAAkG;AAElG;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAgB1D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,GAAW;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAA;IACrE,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAA;IACvC,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACnD,+FAA+F;IAC/F,4FAA4F;IAC5F,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,IAAI,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAA;AACnG,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC7D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,CAAA;AACpD,CAAC"}

package/dist/cloud-scratch-refs.d.ts

@@ -0,0 +1,85 @@
+import { type GitRunner } from '@openagt/agent-data';
+import { type LinkedPr } from './dashboard/pull-requests.js';
+import { type AgentMeta } from './store/index.js';
+import { type ProjectPass, type ProjectsSource } from './project-pass.js';
+/** How long a scratch ref is left alone before it may go: safely past any provisioning. */
+export declare const SCRATCH_REF_SAFE_AGE_MS: number;
+/**
+ * The shape of the pre-hand-off ref the cloud driver pushes: its own session id, a counter plus
+ * the 8-hex tag (`cloud-1-3955352b`). Anchored tightly so a user's own `cloud-…` branch that does
+ * not match the driver's naming is never even a candidate.
+ */
+export declare const CLOUD_SCRATCH_REF: RegExp;
+/** Minimal fs seam so the state IO is unit-testable without touching disk. */
+export interface ScratchFs {
+    read(path: string): Promise<string>;
+    write(path: string, contents: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+}
+/** The first-seen state file path for a repo. */
+export declare function cloudRefsStatePath(cwd: string): string;
+/** Why a candidate ref was kept this sweep. Every one of these is retried on a later pass. */
+export type ScratchKeptReason = 
+/** Not past the safe age yet — the window a provisioning session could still be reading it. */
+'young'
+/** Its agent is one the daemon is still responsible for. */
+ | 'busy'
+/** Its tip is not provably on the default branch, so it may hold work. */
+ | 'holds-work'
+/** It has an open PR, which a deletion would close. */
+ | 'open-pr';
+/** What {@link sweepCloudScratchRefs} did to one repo's origin. */
+export interface ScratchSweepResult {
+    /** Refs deleted from origin (short names). */
+    deleted: string[];
+    /** Candidate refs kept, and why. Refs matching neither naming are never listed at all. */
+    kept: {
+        ref: string;
+        reason: ScratchKeptReason;
+    }[];
+    /** Refs the sweep decided to delete but could not; retried next sweep. */
+    failed: {
+        ref: string;
+        error: string;
+    }[];
+}
+/** Injectable seams so the sweep is unit-testable off disk, off the network and off the git host. */
+export interface ScratchSweepDeps {
+    git?: GitRunner;
+    /** The branch's full PR history (default {@link prsForBranch}). */
+    prs?: (cwd: string, branch: string) => Promise<LinkedPr[]>;
+    fs?: ScratchFs;
+    /** The current time in ms (injected so tests can age refs deterministically). */
+    now?: () => number;
+    /** Override {@link SCRATCH_REF_SAFE_AGE_MS}. */
+    ageMs?: number;
+    /** Agent ids the daemon is still responsible for, whose run branches this must not touch. */
+    busy?: ReadonlySet<string>;
+    /** The project's runs, whose recorded branches are the run branches on origin (default {@link listAgents}). */
+    agents?: (cwd: string) => Promise<AgentMeta[]>;
+}
+/**
+ * Sweep one repo's origin for the dead refs cloud hand-offs left behind (#1547), deleting the
+ * ones that clear every gate. Never throws: a repo with no remote (or offline) sweeps nothing,
+ * and a failed deletion is reported and retried next sweep.
+ */
+export declare function sweepCloudScratchRefs(cwd: string, deps?: ScratchSweepDeps): Promise<ScratchSweepResult>;
+/** What {@link startCloudScratchSweep} needs from the daemon. */
+export interface CloudScratchSweepOptions {
+    /** The registered projects to sweep. */
+    projects: ProjectsSource;
+    log: (message: string) => void;
+    /** The agents the daemon is still responsible for, whose run branches this must not touch. */
+    busy?: () => ReadonlySet<string>;
+    /** The per-project sweep (default {@link sweepCloudScratchRefs}). */
+    sweep?: (cwd: string) => Promise<ScratchSweepResult>;
+}
+/**
+ * Sweep every registered project's leftover cloud scratch refs (#1547), one turn per call.
+ *
+ * Deletions and failures are said out loud, kept refs are not: a candidate that is merely not old
+ * enough yet is the normal state of every ref this watches, and a line per tick about it would be
+ * noise. A ref vanishing from origin with no line explaining why would read as a bug.
+ */
+export declare function startCloudScratchSweep(opts: CloudScratchSweepOptions): ProjectPass;
+//# sourceMappingURL=cloud-scratch-refs.d.ts.map

package/dist/cloud-scratch-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-scratch-refs.d.ts","sourceRoot":"","sources":["../src/cloud-scratch-refs.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEhF,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG7D,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AA8B3F,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,QAAsB,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAA4B,CAAA;AAe1D,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAQD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AA4BD,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB;AAC3B,+FAA+F;AAC7F,OAAO;AACT,4DAA4D;GAC1D,MAAM;AACR,0EAA0E;GACxE,YAAY;AACd,uDAAuD;GACrD,SAAS,CAAA;AAEb,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,0FAA0F;IAC1F,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,EAAE,CAAA;IAClD,0EAA0E;IAC1E,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACzC;AAED,qGAAqG;AACrG,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,mEAAmE;IACnE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1D,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B,+GAA+G;IAC/G,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;CAC/C;AAkFD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgGjH;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,QAAQ,EAAE,cAAc,CAAA;IACxB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,WAAW,CAalF"}

package/dist/cloud-scratch-refs.js

@@ -0,0 +1,275 @@
+import { join } from 'node:path';
+import { DATA_BRANCH, nodeGitRunner } from '@openagt/agent-data';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+import { prsForBranch } from './dashboard/pull-requests.js';
+import { listAgents } from './store/index.js';
+import { nodeFs } from './node-fs.js';
+import { errorMessage } from './error-message.js';
+import { startProjectPass } from './project-pass.js';
+// Sweep the scratch refs a cloud hand-off leaves on origin (#1547).
+//
+// Every "Run on: Claude web" run pushes two refs that nothing ever consumes again: the slash-free
+// `cloud-*` ref the driver pushes so the cloud session has a ref it can clone at (#1320,
+// anthropics/claude-code#87235), and the run branch (`agent-…`) pushed beside it. The session does its work on its own `claude/*`
+// branch and opens its PR from there, so once provisioning settles both refs are dead names on
+// origin — one pair per web run, accumulating forever.
+//
+// The driver cannot safely delete its own ref: session creation only signals "session created",
+// not "clone finished", and a ref deleted in that window strands the session (recoverable only
+// with `claude --teleport`). So the daemon sweeps instead, and every deletion has to clear four
+// gates:
+//
+// - **Old enough** (~a day) that no provisioning can still be reading it. A run branch is aged
+//   from its run's start, off the run's record (the records are shared across machines, so every
+//   machine's runs are known here); a `cloud-*` ref carries nothing, so the sweep remembers when
+//   it first saw one and only ages it from there — which also keeps a ref pushed by *another*
+//   machine safe, since each machine only deletes what it has itself watched for a day.
+// - **Holds no work**: its tip is already reachable from origin's default branch. That is what
+//   separates a web run's empty scratch branch from a local run's branch holding unmerged commits —
+//   the one thing this sweep must never delete.
+// - **No open PR**, so a deletion can never close one.
+// - **Not a live agent's**: a run the caller names as `busy` keeps its branch. The daemon names
+//   none, since it runs no agent.
+//
+// Never throws, and conservative on every unprovable case: a ref it cannot prove dead simply
+// stays, and the next sweep asks again.
+/** How long a scratch ref is left alone before it may go: safely past any provisioning. */
+export const SCRATCH_REF_SAFE_AGE_MS = 24 * 60 * 60 * 1000;
+/**
+ * The shape of the pre-hand-off ref the cloud driver pushes: its own session id, a counter plus
+ * the 8-hex tag (`cloud-1-3955352b`). Anchored tightly so a user's own `cloud-…` branch that does
+ * not match the driver's naming is never even a candidate.
+ */
+export const CLOUD_SCRATCH_REF = /^cloud-\d+-[0-9a-f]{8}$/;
+/**
+ * Where the sweep remembers when it first saw each `cloud-*` ref, under `.openagent/`
+ * (gitignored, like the other per-repo bookkeeping). Needed because the ref's name carries no
+ * timestamp and its commit date says nothing — the driver pushes the worktree's HEAD, which is
+ * however old the base commit happens to be, not when the hand-off happened.
+ */
+const CLOUD_REFS_FILE = 'cloud-refs.json';
+/** A {@link ScratchFs} backed by `node:fs/promises`. See {@link nodeFs}. */
+function nodeScratchFs() {
+    const { read, write, mkdir } = nodeFs();
+    return { read, write, mkdir };
+}
+/** The first-seen state file path for a repo. */
+export function cloudRefsStatePath(cwd) {
+    return join(cwd, OPENAGENT_DIR, CLOUD_REFS_FILE);
+}
+/** Read a repo's first-seen state. Forgiving: missing/unreadable/malformed yields an empty one. */
+async function readState(cwd, fs) {
+    try {
+        const parsed = JSON.parse(await fs.read(cloudRefsStatePath(cwd)));
+        if (parsed && typeof parsed === 'object') {
+            const record = parsed['firstSeen'];
+            if (record && typeof record === 'object') {
+                const firstSeen = {};
+                for (const [ref, at] of Object.entries(record)) {
+                    if (typeof at === 'string')
+                        firstSeen[ref] = at;
+                }
+                return { firstSeen };
+            }
+        }
+    }
+    catch {
+        // absent / unreadable / malformed -> nothing seen yet
+    }
+    return { firstSeen: {} };
+}
+/** Record a repo's first-seen state, creating `.openagent/` as needed. */
+async function writeState(cwd, state, fs) {
+    await fs.mkdir(join(cwd, OPENAGENT_DIR));
+    await fs.write(cloudRefsStatePath(cwd), JSON.stringify(state, null, 2));
+}
+/**
+ * Parse `git ls-remote --symref origin HEAD 'refs/heads/*'`: the branch HEAD points at (the
+ * default branch) plus every branch with its tip. One listing answers everything the
+ * classification needs, in one network round-trip.
+ */
+function parseLsRemote(listing) {
+    const heads = [];
+    let defaultBranch;
+    for (const line of listing.split('\n')) {
+        const symref = /^ref:\s+refs\/heads\/(\S+)\s+HEAD$/.exec(line);
+        if (symref) {
+            defaultBranch = symref[1];
+            continue;
+        }
+        const head = /^([0-9a-f]{40,64})\t+refs\/heads\/(.+)$/.exec(line);
+        if (head)
+            heads.push({ ref: head[2], sha: head[1] });
+    }
+    // A remote that answers no symref (some mirrors) still usually has a conventional default.
+    if (!defaultBranch)
+        defaultBranch = ['main', 'master'].find(name => heads.some(h => h.ref === name));
+    return { ...(defaultBranch !== undefined ? { defaultBranch } : {}), heads };
+}
+/**
+ * Whether `sha` is already reachable from the default branch — the proof the ref holds no work.
+ * Tried against the remote's own tip first (the freshest answer, when its object is local because
+ * this machine pushed or fetched it), then against the local `origin/<default>` tracking ref
+ * (stale is fine: reachable from a stale tip is reachable from a newer one). Unprovable — objects
+ * missing, no default branch at all — reads as "not landed", which keeps the ref.
+ */
+async function landed(git, cwd, sha, defaultBranch, heads) {
+    if (defaultBranch === undefined)
+        return false;
+    const remoteTip = heads.find(h => h.ref === defaultBranch)?.sha;
+    for (const tip of [remoteTip, `refs/remotes/origin/${defaultBranch}`]) {
+        if (!tip)
+            continue;
+        const ancestor = await git(['merge-base', '--is-ancestor', sha, tip], cwd).then(() => true, () => false);
+        if (ancestor)
+            return true;
+    }
+    return false;
+}
+/**
+ * Whether `sha` is an empty commit sitting on a landed parent — the hand-off anchor's shape
+ * (#1601): its tree is its parent's tree, so it holds no work of its own, and the parent being
+ * on the default branch means everything under it landed. The commit object may not be local
+ * (another machine pushed the ref), so the ref is fetched first when needed; anything still
+ * unprovable reads as "holds work", which keeps the ref for a later sweep.
+ */
+async function emptyTipOnLandedParent(git, cwd, ref, sha, defaultBranch, heads) {
+    const present = await git(['cat-file', '-e', `${sha}^{commit}`], cwd).then(() => true, () => false);
+    if (!present && !(await git(['fetch', 'origin', `refs/heads/${ref}`], cwd).then(() => true, () => false)))
+        return false;
+    try {
+        const tree = (await git(['rev-parse', `${sha}^{tree}`], cwd)).trim();
+        const parent = (await git(['rev-parse', `${sha}^`], cwd)).trim();
+        const parentTree = (await git(['rev-parse', `${sha}^^{tree}`], cwd)).trim();
+        if (!tree || !parent || tree !== parentTree)
+            return false;
+        return await landed(git, cwd, parent, defaultBranch, heads);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sweep one repo's origin for the dead refs cloud hand-offs left behind (#1547), deleting the
+ * ones that clear every gate. Never throws: a repo with no remote (or offline) sweeps nothing,
+ * and a failed deletion is reported and retried next sweep.
+ */
+export async function sweepCloudScratchRefs(cwd, deps = {}) {
+    const git = deps.git ?? nodeGitRunner();
+    const prs = deps.prs ?? prsForBranch;
+    const fs = deps.fs ?? nodeScratchFs();
+    const now = deps.now ? deps.now() : Date.now();
+    const ageMs = deps.ageMs ?? SCRATCH_REF_SAFE_AGE_MS;
+    const result = { deleted: [], kept: [], failed: [] };
+    let listing;
+    try {
+        listing = await git(['ls-remote', '--symref', 'origin', 'HEAD', 'refs/heads/*'], cwd);
+    }
+    catch {
+        return result; // no remote, or it cannot be reached: nothing to sweep
+    }
+    const { defaultBranch, heads } = parseLsRemote(listing);
+    const state = await readState(cwd, fs);
+    // A run branch is one a run's record names (#1774): the record says when the run started, and
+    // whose it is. A branch no record names is nobody's to delete.
+    const runs = new Map();
+    for (const run of await (deps.agents ?? listAgents)(cwd).catch(() => []))
+        if (run.branch && !runs.has(run.branch))
+            runs.set(run.branch, run);
+    // Rebuilt from what origin actually has, so entries for refs deleted (by us or anyone) fall away.
+    const firstSeen = {};
+    const candidates = [];
+    for (const head of heads) {
+        if (CLOUD_SCRATCH_REF.test(head.ref)) {
+            const seenAt = state.firstSeen[head.ref];
+            const seenMs = seenAt === undefined ? NaN : Date.parse(seenAt);
+            if (!Number.isFinite(seenMs)) {
+                // First sight (or a hand-edited timestamp): the day starts now.
+                firstSeen[head.ref] = new Date(now).toISOString();
+                result.kept.push({ ref: head.ref, reason: 'young' });
+                continue;
+            }
+            firstSeen[head.ref] = seenAt;
+            if (now - seenMs < ageMs) {
+                result.kept.push({ ref: head.ref, reason: 'young' });
+                continue;
+            }
+            candidates.push(head);
+            continue;
+        }
+        // The default branch and the data branch are nobody's scratch, whatever a run's record says: a
+        // run that recorded `main` as its branch (one that never left it) must not turn the sweep on main.
+        if (head.ref === defaultBranch || head.ref === DATA_BRANCH)
+            continue;
+        const run = runs.get(head.ref);
+        if (run) {
+            const startedMs = Date.parse(run.startedAt);
+            if (!Number.isFinite(startedMs))
+                continue; // a run whose age is unknowable is not ours to delete
+            if (deps.busy?.has(run.id)) {
+                result.kept.push({ ref: head.ref, reason: 'busy' });
+                continue;
+            }
+            if (now - startedMs < ageMs) {
+                result.kept.push({ ref: head.ref, reason: 'young' });
+                continue;
+            }
+            candidates.push(head);
+        }
+        // Every other branch — the default, `claude/*`, a branch no run's record names — is not a
+        // scratch ref and is never even considered.
+    }
+    for (const { ref, sha } of candidates) {
+        // The work gate first: it is local and free, and it is the one that must never be wrong.
+        // A tip the default branch never absorbs still clears it when it is a hand-off anchor
+        // (#1601): an empty commit whose parent landed changes nothing, and no merge ever lands
+        // the anchor itself — a squash merge rewrites the session's history without it.
+        if (!(await landed(git, cwd, sha, defaultBranch, heads)) && !(await emptyTipOnLandedParent(git, cwd, ref, sha, defaultBranch, heads))) {
+            result.kept.push({ ref, reason: 'holds-work' });
+            continue;
+        }
+        // prsForBranch resolves [] when the git host cannot answer, so a hiccup here fails toward
+        // deletion — acceptable only because the work gate already proved the ref holds nothing.
+        const history = await prs(cwd, ref).catch(() => []);
+        if (history.some(pr => pr.state === 'OPEN')) {
+            result.kept.push({ ref, reason: 'open-pr' });
+            continue;
+        }
+        try {
+            await git(['push', 'origin', '--delete', ref], cwd);
+            result.deleted.push(ref);
+            delete firstSeen[ref];
+        }
+        catch (err) {
+            // The first-seen entry stays, so the retry next sweep does not restart the day.
+            result.failed.push({ ref, error: errorMessage(err) });
+        }
+    }
+    if (JSON.stringify(firstSeen) !== JSON.stringify(state.firstSeen)) {
+        await writeState(cwd, { firstSeen }, fs).catch(() => {
+            // Best effort: an unwritable state file only delays deletions, never loses work.
+        });
+    }
+    return result;
+}
+/**
+ * Sweep every registered project's leftover cloud scratch refs (#1547), one turn per call.
+ *
+ * Deletions and failures are said out loud, kept refs are not: a candidate that is merely not old
+ * enough yet is the normal state of every ref this watches, and a line per tick about it would be
+ * noise. A ref vanishing from origin with no line explaining why would read as a bug.
+ */
+export function startCloudScratchSweep(opts) {
+    const sweep = opts.sweep ?? ((cwd) => sweepCloudScratchRefs(cwd, { ...(opts.busy ? { busy: opts.busy() } : {}) }));
+    // No timer of its own (E4): the daemon's one clock calls `tick`.
+    return startProjectPass(opts.projects, async (cwd) => {
+        const { deleted, failed } = await sweep(cwd).catch(() => ({ deleted: [], kept: [], failed: [] }));
+        for (const ref of deleted) {
+            opts.log(`[openagent] deleted the leftover cloud hand-off ref ${ref} on origin: its session settled long ago and nothing consumes it (#1547).`);
+        }
+        for (const item of failed) {
+            opts.log(`[openagent] could not delete the leftover ref ${item.ref} on origin: ${item.error}`);
+        }
+    });
+}
+//# sourceMappingURL=cloud-scratch-refs.js.map

package/dist/cloud-scratch-refs.js.map

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

package/dist/cloud-work.d.ts

@@ -0,0 +1,66 @@
+import { type GitRunner } from '@openagt/agent-data';
+import { type LinkedPr } from './dashboard/pull-requests.js';
+import { type HandoffResult } from './dashboard/agent-handoff.js';
+import { type AgentMeta, type RunPatch } from './store/index.js';
+import { type ProjectPass, type ProjectsSource } from './project-pass.js';
+/** How long after its start a run is still asked about: safely past any cloud session's life. */
+export declare const CLOUD_ADOPTION_WINDOW_MS: number;
+/** What one adoption did, for the daemon to say out loud. */
+export interface CloudAdoption {
+    agentId: string;
+    branch: string;
+    /** The PR now on the run's record, when one was found or opened. */
+    pr?: {
+        number: number;
+        url: string;
+    };
+    /** True when the PR above was opened by this pass (the armed draft), not found. */
+    opened?: boolean;
+}
+/** What {@link adoptCloudWork} did to one project. */
+export interface CloudWorkResult {
+    adopted: CloudAdoption[];
+    /** Failures worth a log line; unmatched runs are not one, they are the normal waiting state. */
+    failed: {
+        agentId: string;
+        error: string;
+    }[];
+}
+/** Injectable seams so the pass is unit-testable off disk, off the network and off the git host. */
+export interface CloudWorkDeps {
+    git?: GitRunner;
+    /** The branch's full PR history; a listing that fails must throw (default {@link prsForBranchOrThrow}). */
+    prs?: (cwd: string, branch: string) => Promise<LinkedPr[]>;
+    /** The project's run records, none older than `since` in epoch ms (default {@link listAgents}). */
+    agents?: (cwd: string, since: number) => Promise<AgentMeta[]>;
+    /** Record the adopted branch and PR on the run's card, as one commit on the data branch (default the `logs` skill's {@link patchRun}). */
+    patch?: (cwd: string, agentId: string, patch: RunPatch) => Promise<boolean>;
+    /** Open the armed draft PR for a remote-only branch (default {@link openRemoteBranchPullRequest}). */
+    openPr?: (cwd: string, agent: AgentMeta, branch: string) => Promise<HandoffResult>;
+    /** The current time in ms (injected so tests can age runs deterministically). */
+    now?: () => number;
+}
+/**
+ * Adopt one project's cloud work (#1601): match each waiting web run to the `claude/*` head
+ * descending from its hand-off anchor, and record the branch and its PR onto the run's archive —
+ * opening the armed draft PR when the session never did. Never throws: a repo with no remote
+ * (or offline) adopts nothing, and every unmatched run is retried next pass.
+ */
+export declare function adoptCloudWork(cwd: string, deps?: CloudWorkDeps): Promise<CloudWorkResult>;
+/** What {@link startCloudWorkAdoption} needs from the daemon. */
+export interface CloudWorkAdoptionOptions {
+    /** The registered projects to pass over. */
+    projects: ProjectsSource;
+    log: (message: string) => void;
+    /** The per-project pass (default {@link adoptCloudWork}). */
+    adopt?: (cwd: string) => Promise<CloudWorkResult>;
+}
+/**
+ * Adopt every registered project's cloud work (#1601), one turn per call.
+ *
+ * Adoptions and failures are said out loud, unmatched runs are not: a session that has not
+ * pushed yet is the normal state of every run this watches, and a line per tick about it would
+ * be noise. A run's row changing branch with no line explaining why would read as a bug.
+ */
+export declare function startCloudWorkAdoption(opts: CloudWorkAdoptionOptions): ProjectPass;
+//# sourceMappingURL=cloud-work.d.ts.map

package/dist/cloud-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-work.d.ts","sourceRoot":"","sources":["../src/cloud-work.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EAAiD,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE/G,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAuB3F,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,QAAsB,CAAA;AAE3D,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,EAAE,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,gGAAgG;IAChG,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC7C;AAED,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,2GAA2G;IAC3G,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1D,mGAAmG;IACnG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC7D,0IAA0I;IAC1I,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3E,sGAAsG;IACtG,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IAClF,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAuFD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+EpG;AAED,iEAAiE;AACjE,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAA;IACxB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,wBAAwB,GAAG,WAAW,CAclF"}