@wascartech/devbot 0.0.0-stage → 2.1.1

package/dist/volume-gc.js

@@ -0,0 +1,193 @@
+import { config } from "./config.js";
+import { runtime } from "./runtime-state.js";
+import { log } from "./logger.js";
+import { podman } from "./podman.js";
+import { getPlatform } from "./platform/index.js";
+import { volumeName, volumeExists, podmanVolumeName, xdgVolumeName } from "./git.js";
+import { destroyWorkItemVolume } from "./runner.js";
+import { listInactiveVolumes, listTrackedVolumes, deleteVolumeRow, recordOrphanVolume, realWorkItemIds, } from "./volume-store.js";
+// Sweep all volumes eligible for purging. A row is eligible when EITHER:
+//   - it has been inactive for at least VOLUME_GC_TTL_MS (the normal TTL path),
+//     or
+//   - its work item is closed or deleted (liveness path — a deleted work item
+//     can never run again, and a closed one shouldn't keep a volume, matching
+//     the close hook). This reclaims volumes promptly instead of waiting out
+//     the TTL.
+// Orphans (project_id === 0) have no thread to query and only qualify via TTL.
+//
+// For each eligible row:
+//   - if the volume is already gone (close/reset removed it), just drop the
+//     ledger row;
+//   - else destroyWorkItemVolume (force-stop in-flight containers + volume rm);
+//   - on success, post a top-level purge note to the work item when the row
+//     carries a real (projectId, iid) and the item still exists — reconciled
+//     orphans (0/0) and deleted items are purged silently;
+//   - drop the ledger row regardless of note success.
+// Each row is isolated in try/catch so one failure doesn't abort the sweep.
+// DRY_RUN: log intent, skip rm + note. GC disabled: no-op.
+export async function purgeInactiveVolumes() {
+    if (!runtime().volumeGcEnabled)
+        return;
+    const inactive = new Set(listInactiveVolumes(runtime().volumeGcTtlMs).map((r) => r.work_item_id));
+    const tracked = listTrackedVolumes();
+    // Classify every tracked row: TTL-inactive and/or closed/deleted. The state
+    //   read is per-row and bounded (one GET each, once a day); a failure on one
+    //   row leaves it on the TTL path instead of aborting the sweep.
+    const eligible = [];
+    for (const row of tracked) {
+        const ttl = inactive.has(row.work_item_id);
+        // Orphans carry no project/iid → TTL only, no API call.
+        if (row.project_id === 0) {
+            if (ttl)
+                eligible.push({ row, deleted: false });
+            continue;
+        }
+        // undefined = the check itself failed (network/5xx). Fail closed: fall back
+        //   to the TTL path so an unverifiable read never purges the volume. null
+        //   is an authoritative 404 (deleted).
+        let state;
+        try {
+            state = await getPlatform().workItems.getWorkItemStateOrNull(row.project_id, row.work_item_iid);
+        }
+        catch (e) {
+            log.warn("volume gc liveness check failed", { workItemId: row.work_item_id, err: e });
+            state = undefined;
+        }
+        if (state === "closed" || state === null) {
+            eligible.push({ row, deleted: state === null });
+        }
+        else if (ttl) {
+            eligible.push({ row, deleted: false });
+        }
+    }
+    if (eligible.length === 0)
+        return;
+    log.info("volume gc sweep", { candidates: eligible.length, tracked: tracked.length, ttlMs: runtime().volumeGcTtlMs });
+    for (const { row, deleted } of eligible) {
+        try {
+            await purgeOne(row, deleted);
+        }
+        catch (e) {
+            log.warn("volume gc row failed", { workItemId: row.work_item_id, err: e });
+        }
+    }
+}
+async function purgeOne(row, deleted = false) {
+    const { work_item_id: workItemId, project_id: projectId, work_item_iid: workItemNumber, last_run_at: lastRunAt } = row;
+    // Already gone (close/reset beat the sweep): just clean the ledger row. The
+    // sibling volumes (nested-Podman store, xdg config/data) are removed
+    // alongside, if they exist.
+    if (!(await volumeExists(volumeName(workItemId)))) {
+        for (const sibling of [podmanVolumeName(workItemId), xdgVolumeName(workItemId)]) {
+            if (await volumeExists(sibling)) {
+                await podman(["volume", "rm", sibling]).catch(() => { });
+            }
+        }
+        deleteVolumeRow(workItemId);
+        return;
+    }
+    if (config.DRY_RUN) {
+        log.debug("DRY_RUN — would purge volume", { workItemId, vol: volumeName(workItemId) });
+        return;
+    }
+    const result = await destroyWorkItemVolume(workItemId);
+    if (!result.ok) {
+        log.warn("volume gc destroy failed", { workItemId, message: result.message });
+        return;
+    }
+    // Post a note only for tracked volumes (projectId != 0) whose work item still
+    // exists. Reconciled orphans (projectId === 0) carry no resolvable thread and
+    // deleted work items have nowhere to post → purge silently.
+    if (projectId !== 0 && !deleted) {
+        const days = Math.max(1, Math.round((Date.now() / 1000 - lastRunAt) / (24 * 60 * 60)));
+        const body = `🧹 Volume purged after ${days} day(s) of inactivity. Mention @devbot to resume.`;
+        await getPlatform().workItems.postComment(projectId, workItemNumber, body).catch((e) => log.warn("volume gc note failed", { workItemId, err: e }));
+    }
+    deleteVolumeRow(workItemId);
+    log.info("volume gc purged", { workItemId, orphan: projectId === 0, deleted });
+}
+// Parse a `devbot-wi-<id>`, `devbot-wi-<id>-podman`, or `devbot-wi-<id>-xdg`
+// volume name into its work item id. Returns null for anything that isn't one
+// of those shapes (other names, empty id, non-numeric id, unknown suffixes,
+// id <= 0). Exported as a pure helper so the reconciler's suffix handling is
+// unit-testable. The `-podman` suffix is the private nested-Podman store
+// (created when dev containers are enabled) and `-xdg` is the out-of-tree
+// opencode config/data volume; both map back to the same ledger row as the
+// workspace volume.
+export function parseVolumeWorkItemId(name, prefix) {
+    if (!name.startsWith(prefix))
+        return null;
+    const rest = name.slice(prefix.length);
+    const m = /^(\d+)(?:-podman|-xdg)?$/.exec(rest);
+    if (!m)
+        return null;
+    const id = Number(m[1]);
+    if (!Number.isFinite(id) || id <= 0)
+        return null;
+    return id;
+}
+// Parse podman's volume CreatedAt into unix seconds. podman reports ISO-8601
+// with a numeric offset and nanosecond precision (e.g.
+// "2026-07-30T23:02:46.330803742+02:00"), which `new Date` parses fine. Returns
+// null for anything unparseable so the caller can fall back to `now` (a volume
+// with an unknown age must not be trusted as fresh, but it also must not crash
+// the reconcile). Exported pure for unit testing.
+export function parseVolumeCreatedAt(raw) {
+    const d = new Date(raw);
+    if (Number.isNaN(d.getTime()))
+        return null;
+    return Math.floor(d.getTime() / 1000);
+}
+// One-time reconciliation at startup: discover devbot-wi-* volumes that exist
+// in podman but have no ledger row (created before the tracking table existed,
+// or via a path that bypassed recordVolume) and insert orphan placeholders so
+// the TTL sweep can eventually free them. The volume's ACTUAL CreatedAt is
+// recorded (not reconcile time) so a months-old orphan is immediately TTL-
+// eligible rather than getting a fresh clock on every reconcile. project_id=0
+// → silent purge later. Existing real rows are left untouched (the orphan
+// upsert only rewrites project_id=0 rows). Cheap (one podman volume ls) and
+// runs only at startup. Best-effort: a podman failure just skips reconcile.
+export async function reconcileVolumes() {
+    if (!runtime().volumeGcEnabled)
+        return;
+    const prefix = config.INSTANCE_ID ? `${config.INSTANCE_ID}-devbot-wi-` : "devbot-wi-";
+    // JSON so we get CreatedAt alongside Name; `--format {{.Name}}` omits it,
+    // which is what forced the old `now` stamp.
+    const ls = await podman(["volume", "ls", "--filter", `name=${prefix}`, "--format", "json"]);
+    if (ls.code !== 0) {
+        log.warn("volume reconcile: podman volume ls failed, skipping", { code: ls.code });
+        return;
+    }
+    let entries;
+    try {
+        entries = JSON.parse(ls.stdout);
+        if (!Array.isArray(entries))
+            throw new Error("not an array");
+    }
+    catch (e) {
+        log.warn("volume reconcile: could not parse podman volume ls json, skipping", { err: e });
+        return;
+    }
+    // Skip work items backed by a real row; revisit orphan rows so a previously
+    //   mis-stamped orphan is self-healed with the volume's real CreatedAt.
+    const real = new Set(realWorkItemIds());
+    const nowSec = Math.floor(Date.now() / 1000);
+    let inserted = 0;
+    for (const entry of entries) {
+        const name = typeof entry.Name === "string" ? entry.Name : "";
+        if (!name)
+            continue;
+        const workItemId = parseVolumeWorkItemId(name, prefix);
+        if (workItemId === null)
+            continue;
+        if (real.has(workItemId))
+            continue;
+        const createdAt = typeof entry.CreatedAt === "string" ? parseVolumeCreatedAt(entry.CreatedAt) : null;
+        recordOrphanVolume(workItemId, createdAt ?? nowSec);
+        inserted++;
+    }
+    if (inserted > 0) {
+        log.info("volume reconcile: reconciled orphan placeholders", { count: inserted });
+    }
+}
+//# sourceMappingURL=volume-gc.js.map

package/dist/volume-gc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume-gc.js","sourceRoot":"","sources":["../src/volume-gc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,GAEhB,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,gFAAgF;AAChF,SAAS;AACT,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,eAAe;AACf,+EAA+E;AAC/E,EAAE;AACF,yBAAyB;AACzB,4EAA4E;AAC5E,kBAAkB;AAClB,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,2DAA2D;AAC3D,sDAAsD;AACtD,4EAA4E;AAC5E,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC,eAAe;QAAE,OAAO;IAEvC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,4EAA4E;IAC5E,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,QAAQ,GAAgD,EAAE,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3C,wDAAwD;QACxD,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,GAAG;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QACD,4EAA4E;QAC5E,0EAA0E;QAC1E,uCAAuC;QACvC,IAAI,KAA2C,CAAC;QAChD,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;QAClG,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CAAC;YAC/F,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;QACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;IAEtH,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAc,EAAE,OAAO,GAAG,KAAK;IACrD,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IAEvH,4EAA4E;IAC5E,qEAAqE;IACrE,4BAA4B;IAC5B,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAChF,IAAI,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,MAAM,MAAM,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,eAAe,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,4DAA4D;IAC5D,IAAI,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,0BAA0B,IAAI,mDAAmD,CAAC;QAC/F,MAAM,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACrF,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CACnE,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,UAAU,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,oBAAoB;AACpB,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAc;IAChE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,6EAA6E;AAC7E,uDAAuD;AACvD,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,kDAAkD;AAClD,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACxC,CAAC;AAOD,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC,eAAe;QAAE,OAAO;IAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;IACtF,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5F,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,qDAAqD,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO;IACT,CAAC;IAED,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAA4B,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,mEAAmE,EAAE,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CAAC;QACnG,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,UAAU,KAAK,IAAI;YAAE,SAAS;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACnC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrG,kBAAkB,CAAC,UAAU,EAAE,SAAS,IAAI,MAAM,CAAC,CAAC;QACpD,QAAQ,EAAE,CAAC;IACb,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,kDAAkD,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/volume-manage.js

@@ -0,0 +1,191 @@
+import { config } from "./config.js";
+import { runtime } from "./runtime-state.js";
+import { log } from "./logger.js";
+import { podman } from "./podman.js";
+import { getPlatform } from "./platform/index.js";
+import { volumeName } from "./git.js";
+import { parseVolumeWorkItemId } from "./volume-gc.js";
+import { destroyWorkItemVolume } from "./runner.js";
+import { getProject } from "./token-store.js";
+import { db } from "./db.js";
+import { getVolumeRow, listTrackedVolumes, deleteVolumeRow } from "./volume-store.js";
+function volumePrefix() {
+    return config.INSTANCE_ID ? `${config.INSTANCE_ID}-devbot-wi-` : "devbot-wi-";
+}
+// Most recent run-history title for a work item, if the store has one. Best-
+// effort: a pre-#61 DB without run_history still renders the row without a title.
+function workItemTitle(workItemId) {
+    try {
+        const row = db
+            .prepare("SELECT work_item_title FROM run_history WHERE work_item_id = ? ORDER BY id DESC LIMIT 1")
+            .get(workItemId);
+        return row?.work_item_title ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+// Map of workItemId -> set of podman volume suffixes present ("" = workspace,
+// "-podman" = nested store, "-xdg" = opencode config/data). A failed ls returns
+// null (podman unavailable), distinct from an empty map ("no volumes").
+async function listPodmanVolumes() {
+    const prefix = volumePrefix();
+    const ls = await podman(["volume", "ls", "--filter", `name=${prefix}`, "--format", "json"]);
+    if (ls.code !== 0) {
+        log.warn("volume manage: podman volume ls failed", { code: ls.code });
+        return null;
+    }
+    let entries;
+    try {
+        entries = JSON.parse(ls.stdout);
+        if (!Array.isArray(entries))
+            throw new Error("not an array");
+    }
+    catch (e) {
+        log.warn("volume manage: could not parse podman volume ls json", { err: e });
+        return null;
+    }
+    const map = new Map();
+    for (const entry of entries) {
+        const name = typeof entry.Name === "string" ? entry.Name : "";
+        if (!name)
+            continue;
+        const id = parseVolumeWorkItemId(name, prefix);
+        if (id === null)
+            continue;
+        const suffix = name.slice(prefix.length + String(id).length);
+        let set = map.get(id);
+        if (!set) {
+            set = new Set();
+            map.set(id, set);
+        }
+        set.add(suffix);
+    }
+    return map;
+}
+// Classify a tracked row from its ledger timestamps. Orphans (projectId 0) have
+// no resolvable work item — the sweep purges them silently on TTL only, so they
+// report `unmapped` rather than a TTL countdown.
+function classify(row, podmanExists, nowMs, ttlMs) {
+    if (!row.project_id) {
+        return { state: "unmapped", purgeEligibleAt: null, remainingMs: null };
+    }
+    if (!podmanExists) {
+        return { state: "missing", purgeEligibleAt: null, remainingMs: null };
+    }
+    const eligibleAt = (row.last_run_at + Math.ceil(ttlMs / 1000)) * 1000;
+    const remaining = Math.max(0, eligibleAt - nowMs);
+    return { state: remaining > 0 ? "expiring" : "eligible", purgeEligibleAt: eligibleAt, remainingMs: remaining };
+}
+// Build the full, unpaginated list. The admin route slices it for the page, so
+// the total is exact without a second podman call.
+export async function listVolumeViews() {
+    const ttlMs = runtime().volumeGcTtlMs;
+    const nowMs = Date.now();
+    const rows = listTrackedVolumes();
+    const podmanMap = await listPodmanVolumes();
+    const podmanAvailable = podmanMap !== null;
+    const podman = podmanMap ?? new Map();
+    const byId = new Map();
+    for (const row of rows) {
+        const id = row.work_item_id;
+        const suffixes = podman.get(id) ?? new Set();
+        const podmanExists = suffixes.has("") || suffixes.has("-podman") || suffixes.has("-xdg");
+        const cls = classify(row, podmanExists, nowMs, ttlMs);
+        const projectPath = getProject(row.project_id)?.projectPath ?? "";
+        const workItemUrl = row.project_id
+            ? getPlatform().links.workItemUrl(projectPath, row.work_item_iid)
+            : "";
+        byId.set(id, {
+            workItemId: id,
+            projectId: row.project_id,
+            workItemNumber: row.work_item_iid,
+            workItemTitle: workItemTitle(id),
+            workItemUrl,
+            projectPath,
+            createdAt: row.created_at,
+            lastRunAt: row.last_run_at,
+            purgeEligibleAt: cls.purgeEligibleAt,
+            remainingMs: cls.remainingMs,
+            tracked: true,
+            podmanExists,
+            volumes: {
+                workspace: suffixes.has(""),
+                podman: suffixes.has("-podman"),
+                xdg: suffixes.has("-xdg"),
+            },
+            state: cls.state,
+        });
+    }
+    // Podman-only volumes: present but with no ledger row (GC disabled, or a
+    // volume created by a path that bypassed recordVolume). Shown as `untracked`
+    // and silently deletable; the startup reconcile would only adopt them when GC
+    // is enabled.
+    for (const [id, suffixes] of podman) {
+        if (byId.has(id))
+            continue;
+        byId.set(id, {
+            workItemId: id,
+            projectId: 0,
+            workItemNumber: 0,
+            workItemTitle: "",
+            workItemUrl: "",
+            projectPath: "",
+            createdAt: 0,
+            lastRunAt: 0,
+            purgeEligibleAt: null,
+            remainingMs: null,
+            tracked: false,
+            podmanExists: true,
+            volumes: {
+                workspace: suffixes.has(""),
+                podman: suffixes.has("-podman"),
+                xdg: suffixes.has("-xdg"),
+            },
+            state: "untracked",
+        });
+    }
+    // Newest activity first; untracked rows (no timestamps) sort last, then by id.
+    const volumes = [...byId.values()].sort((a, b) => {
+        if (a.lastRunAt !== b.lastRunAt)
+            return b.lastRunAt - a.lastRunAt;
+        return b.workItemId - a.workItemId;
+    });
+    return { volumes, total: volumes.length, gcEnabled: runtime().volumeGcEnabled, ttlMs, podmanAvailable };
+}
+export function filterVolumeViews(views, f) {
+    return views.filter((v) => {
+        if (f.state !== undefined && v.state !== f.state)
+            return false;
+        if (f.projectId !== undefined && v.projectId !== f.projectId)
+            return false;
+        if (f.title !== undefined && !v.workItemTitle.toLowerCase().includes(f.title.toLowerCase()))
+            return false;
+        return true;
+    });
+}
+// Delete one work item's volumes from the WebUI. Reuses the /reset teardown and
+// then drops the ledger row. When the ledger row maps to a real work item that
+// is still open, posts a note in the thread naming the admin who removed it;
+// closed/deleted items and untracked volumes are removed silently. Never throws.
+export async function deleteVolumeForWebUi(workItemId, actorUsername) {
+    const row = getVolumeRow(workItemId);
+    const result = await destroyWorkItemVolume(workItemId);
+    deleteVolumeRow(workItemId);
+    let notePosted = false;
+    if (result.ok && row && row.project_id !== 0) {
+        try {
+            const state = await getPlatform().workItems.getWorkItemStateOrNull(row.project_id, row.work_item_iid);
+            if (state === "open") {
+                const body = `🧹 Volume \`${volumeName(workItemId)}\` removed from the WebUI by ${actorUsername}. Mention @devbot to resume.`;
+                await getPlatform().workItems.postComment(row.project_id, row.work_item_iid, body);
+                notePosted = true;
+            }
+        }
+        catch (e) {
+            log.warn("volume manage: delete note failed", { workItemId, err: e });
+        }
+    }
+    return { ok: result.ok, message: result.message, notePosted };
+}
+//# sourceMappingURL=volume-manage.js.map

package/dist/volume-manage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume-manage.js","sourceRoot":"","sources":["../src/volume-manage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAoDtG,SAAS,YAAY;IACnB,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;AAChF,CAAC;AAED,6EAA6E;AAC7E,kFAAkF;AAClF,SAAS,aAAa,CAAC,UAAkB;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,yFAAyF,CAAC;aAClG,GAAG,CAAC,UAAU,CAA4C,CAAC;QAC9D,OAAO,GAAG,EAAE,eAAe,IAAI,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,gFAAgF;AAChF,wEAAwE;AACxE,KAAK,UAAU,iBAAiB;IAC9B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5F,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAA4B,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAwB,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,sDAAsD,EAAE,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACnB,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,iDAAiD;AACjD,SAAS,QAAQ,CAAC,GAAc,EAAE,YAAqB,EAAE,KAAa,EAAE,KAAa;IAKnF,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;IAClD,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACjH,CAAC;AAED,+EAA+E;AAC/E,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,aAAa,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC5C,MAAM,eAAe,GAAG,SAAS,KAAK,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,SAAS,IAAI,IAAI,GAAG,EAAuB,CAAC;IAE3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QACrD,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,WAAW,IAAI,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,GAAG,CAAC,UAAU;YAChC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC;YACjE,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,cAAc,EAAE,GAAG,CAAC,aAAa;YACjC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;YAChC,WAAW;YACX,WAAW;YACX,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,WAAW;YAC1B,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,IAAI;YACb,YAAY;YACZ,OAAO,EAAE;gBACP,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC/B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;aAC1B;YACD,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,6EAA6E;IAC7E,8EAA8E;IAC9E,cAAc;IACd,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC;YACZ,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,EAAE;YACjB,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;YACZ,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE;gBACP,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC/B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;aAC1B;YACD,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;IAED,+EAA+E;IAC/E,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/C,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;QAClE,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;AAC1G,CAAC;AAUD,MAAM,UAAU,iBAAiB,CAAC,KAAmB,EAAE,CAAe;IACpE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAC/D,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC3E,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB,EAAE,aAAqB;IAClF,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACvD,eAAe,CAAC,UAAU,CAAC,CAAC;IAE5B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YACtG,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,eAAe,UAAU,CAAC,UAAU,CAAC,gCAAgC,aAAa,8BAA8B,CAAC;gBAC9H,MAAM,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;gBACnF,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAU,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;AAChE,CAAC"}

package/dist/volume-store.js

@@ -0,0 +1,122 @@
+import { db } from "./db.js";
+import { log } from "./logger.js";
+// Per-work-item volume ledger. Tracks (projectId, workItemNumber, workItemId)
+// so the GC sweep can post a purge note for the tracked work item without
+// needing to re-resolve it from the forge. Timestamps are unix seconds
+// (INTEGER), matching the mcp_thread_tokens / project_mcp_servers convention.
+// Same DB file (devbot.db, 0600).
+//
+// The DB column stays `work_item_iid` (a storage name predating the neutral
+// `number` rename); the TS-facing parameter is `workItemNumber`.
+//
+// Orphan rows: volumes created before this table existed (or via /reset
+// re-creation outside the runner) are reconciled at startup with
+// project_id=0, work_item_iid=0. purgeInactiveVolumes skips the note for
+// those rows (no project/number to post to) but still frees the volume and the
+// row — so pre-feature orphans stop leaking without a misleading note.
+export function initVolumeTables() {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS work_item_volumes (
+      work_item_id  INTEGER PRIMARY KEY,
+      project_id    INTEGER NOT NULL,
+      work_item_iid INTEGER NOT NULL,
+      created_at    INTEGER NOT NULL,
+      last_run_at   INTEGER NOT NULL
+    )
+  `);
+}
+// Record a volume on first creation (or first observed run for a reconciled
+// orphan). Upsert: preserves created_at if the row already exists, otherwise
+// sets both created_at and last_run_at to now. Sets project_id + work_item_iid
+// — overwrites the 0/0 placeholder for a reconciled orphan once a real run
+// lands, so future purges can post a note.
+export function recordVolume(workItemId, projectId, workItemNumber) {
+    const now = Math.floor(Date.now() / 1000);
+    db.prepare(`INSERT OR REPLACE INTO work_item_volumes
+       (work_item_id, project_id, work_item_iid, created_at, last_run_at)
+     VALUES (?, ?, ?,
+       COALESCE((SELECT created_at FROM work_item_volumes WHERE work_item_id = ?), ?),
+       ?)`).run(workItemId, projectId, workItemNumber, workItemId, now, now);
+}
+// Reconciled-orphan insert: project_id=0, work_item_iid=0 (unmappable). The GC
+// sweep purges these silently (no note). If a real run lands on the same
+// workItemId later, recordVolume overwrites the 0/0 with the real ids.
+//
+// createdAtSec is the volume's ACTUAL creation time (from `podman volume ls`),
+// not reconcile time. Using `now` here is the bug that stranded pre-feature
+// orphans: a volume created months ago got a fresh TTL clock every reconcile
+// and never became eligible. `now` is only a last-resort fallback.
+//
+// Self-heal: ON CONFLICT UPDATE corrects a previously mis-stamped orphan row
+// (project_id = 0 only). The WHERE guard means a real row — a live work item
+// tracked by recordVolume — is never overwritten, preserving the "orphan never
+// clobbers real" invariant.
+export function recordOrphanVolume(workItemId, createdAtSec) {
+    const created = Number.isFinite(createdAtSec) && createdAtSec > 0
+        ? Math.floor(createdAtSec)
+        : Math.floor(Date.now() / 1000);
+    db.prepare(`INSERT INTO work_item_volumes
+       (work_item_id, project_id, work_item_iid, created_at, last_run_at)
+     VALUES (?, 0, 0, ?, ?)
+     ON CONFLICT(work_item_id) DO UPDATE SET
+       created_at  = excluded.created_at,
+       last_run_at = excluded.last_run_at
+     WHERE work_item_volumes.project_id = 0`).run(workItemId, created, created);
+}
+// Bump last_run_at for a volume the runner is about to use / has just used.
+// No-op if the row doesn't exist (shouldn't happen — recordVolume runs at
+// creation; harmless if it does, the sweep will just use created_at).
+export function touchVolume(workItemId) {
+    const now = Math.floor(Date.now() / 1000);
+    db.prepare("UPDATE work_item_volumes SET last_run_at = ? WHERE work_item_id = ?").run(now, workItemId);
+}
+// Return rows whose last_run_at is older than or equal to (now - maxAgeMs). The
+// sweep uses last_run_at as the inactivity clock; a volume inactive for *at
+// least* TTL qualifies, hence `<=` (not `<`). A volume with zero runs relies on
+// created_at, but recordVolume sets last_run_at = created_at at creation, so
+// the single column covers both.
+export function listInactiveVolumes(maxAgeMs) {
+    const cutoff = Math.floor((Date.now() - maxAgeMs) / 1000);
+    return db
+        .prepare("SELECT work_item_id, project_id, work_item_iid, created_at, last_run_at FROM work_item_volumes WHERE last_run_at <= ?")
+        .all(cutoff);
+}
+// Every tracked row, regardless of age. The sweep needs the full set to run its
+// liveness pass (closed/deleted work items are purged immediately, before the
+// TTL is due), not just the TTL-inactive subset.
+export function listTrackedVolumes() {
+    return db
+        .prepare("SELECT work_item_id, project_id, work_item_iid, created_at, last_run_at FROM work_item_volumes")
+        .all();
+}
+// One ledger row by work item id, or null when untracked. Backs the WebUI
+// volume manager, which needs the stored (projectId, workItemNumber) to decide
+// whether a manual delete may post a note.
+export function getVolumeRow(workItemId) {
+    const row = db
+        .prepare("SELECT work_item_id, project_id, work_item_iid, created_at, last_run_at FROM work_item_volumes WHERE work_item_id = ?")
+        .get(workItemId);
+    return row ?? null;
+}
+// Has a row for this workItemId? Used by reconciliation to decide whether to
+// insert an orphan placeholder.
+export function hasVolumeRow(workItemId) {
+    const r = db.prepare("SELECT 1 FROM work_item_volumes WHERE work_item_id = ?").get(workItemId);
+    return r !== undefined;
+}
+// work_item_ids backed by a REAL row (project_id != 0), i.e. a live work item
+// the runner recorded. Reconciliation must never touch these. Orphan rows
+// (project_id = 0) are intentionally excluded so they can be re-examined and
+// self-healed with the volume's real creation time.
+export function realWorkItemIds() {
+    const rows = db
+        .prepare("SELECT work_item_id FROM work_item_volumes WHERE project_id != 0")
+        .all();
+    return rows.map((r) => r.work_item_id);
+}
+export function deleteVolumeRow(workItemId) {
+    const r = db.prepare("DELETE FROM work_item_volumes WHERE work_item_id = ?").run(workItemId);
+    if (r.changes > 0)
+        log.debug("volume ledger row deleted", { workItemId });
+}
+//# sourceMappingURL=volume-store.js.map

package/dist/volume-store.js.map

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