@claudexor/daemon 4.3.1 → 4.5.0

package/dist/store/retention-command-references.js

@@ -0,0 +1,133 @@
+import { isTerminalLifecycle, RunLifecycle, RecordedControlRunStartRequest, } from "@claudexor/schema";
+import { readContinuationSources } from "@claudexor/workspace";
+import { setImmediate as yieldToAdmission } from "node:timers/promises";
+import { BlobFiles } from "./blob-files.js";
+import { retentionPages } from "./retention-pages.js";
+// Read the immutable request, not the public summary (which omits retry/plan
+// sources). Historical requests need not satisfy today's full run contract.
+const Dependencies = RecordedControlRunStartRequest.pick({
+    continueFrom: true,
+    retryOf: true,
+    planRef: true,
+    planRunId: true,
+}).strip();
+const COLUMNS = "id,pid,kind,run_id AS runId,run_dir AS runDir,state,finished_at AS finishedAt,continue_from,params_sha";
+export async function commandRetentionReferences(store, retained, referencedRunIds = new Set(), signal) {
+    const blobs = new BlobFiles(store);
+    const paramsByDigest = new Map();
+    const aliases = new Map();
+    const records = [];
+    const byRun = new Map();
+    const active = new Set();
+    const nativeRunDirs = new Set();
+    const nativeWatchRunDirs = new Set();
+    const uncertainNativeOwners = new Map();
+    const add = (id) => {
+        if (!id)
+            return;
+        referencedRunIds.add(id);
+        const runId = aliases.get(id);
+        if (runId)
+            referencedRunIds.add(runId);
+    };
+    const record = (row) => {
+        if (row.runId === null)
+            return;
+        const next = { runId: row.runId, state: row.state, finishedAt: row.finishedAt ?? undefined };
+        const previous = byRun.get(row.runId);
+        if (previous)
+            Object.assign(previous, next);
+        else {
+            records.push(next);
+            byRun.set(row.runId, next);
+        }
+    };
+    const readRow = (row, changed) => {
+        if (!retained(row.pid)) {
+            // Terminal timestamps can date old payloads without reading retired
+            // requests or treating their abandoned work as an active owner.
+            if (row.kind === "product" &&
+                isTerminalLifecycle(row.state) &&
+                row.runId &&
+                !byRun.has(row.runId))
+                record(row);
+            return;
+        }
+        // Delivery may read source files after awaits, including a repeated
+        // apply. Historical delivery params do not reliably name the source.
+        if (row.kind === "delivery" && !isTerminalLifecycle(row.state))
+            throw new Error("disk retention kept while a delivery command is unsettled");
+        if (row.kind !== "product")
+            return;
+        const terminal = isTerminalLifecycle(row.state);
+        if (terminal)
+            active.delete(row.id);
+        else
+            active.add(row.id);
+        uncertainNativeOwners.delete(row.id);
+        if (!RunLifecycle.safeParse(row.state).success ||
+            (!terminal && !row.runDir && (row.state !== "queued" || row.runId)))
+            uncertainNativeOwners.set(row.id, `native ownership unknown for command ${row.id} in partition ${row.pid}: ${row.state}, run directory ${row.runDir ?? "unbound"}`);
+        if (row.runDir) {
+            nativeRunDirs.add(row.runDir);
+            // Active producers can publish a capsule without another SQL write.
+            // A changed producer may already have finished by the final recheck.
+            if (!terminal || changed)
+                nativeWatchRunDirs.add(row.runDir);
+        }
+        if (row.runDir)
+            for (const source of readContinuationSources(row.runDir, { strict: true }))
+                add(source.runId);
+        let params = paramsByDigest.get(row.params_sha);
+        if (!params) {
+            params = Dependencies.parse(JSON.parse(blobs.read(row.params_sha).toString("utf8")));
+            paramsByDigest.set(row.params_sha, params);
+        }
+        if ((params.continueFrom ?? null) !== row.continue_from)
+            throw new Error(`command ${row.id} retention predecessor disagrees`);
+        [row.continue_from, params.retryOf, params.planRef?.runId, params.planRunId].forEach(add);
+        if (row.runId !== null) {
+            aliases.set(row.id, row.runId);
+            if (referencedRunIds.has(row.id))
+                add(row.runId);
+            // The pass's lookup retains these objects, so final lifecycle/age checks
+            // observe changes without rebuilding a map of the entire command store.
+            record(row);
+        }
+    };
+    const read = (row, changed = false) => {
+        try {
+            readRow(row, changed);
+        }
+        catch (error) {
+            throw new Error(`retention command ${row.id} in partition ${row.pid}, params ${row.params_sha}: ${String(error)}`, { cause: error });
+        }
+    };
+    for await (const rows of retentionPages(store, "command", COLUMNS, signal)) {
+        for (const row of rows) {
+            await yieldToAdmission();
+            signal?.throwIfAborted();
+            read(row);
+        }
+    }
+    for (const id of referencedRunIds)
+        add(id);
+    return {
+        records,
+        referencedRunIds,
+        nativeRunDirs,
+        nativeWatchRunDirs,
+        nativeReferenceError: () => [...uncertainNativeOwners.values()].join("; ") || null,
+        hasActiveCommands: () => active.size > 0,
+        refresh(id) {
+            const row = store.prepare(`SELECT ${COLUMNS} FROM command WHERE id=?`).get(id);
+            if (!row)
+                return; // Releases are recognized on the next pass.
+            // A newly bound run was absent from the pass's original lifecycle map.
+            if (retained(row.pid) && row.kind === "product" && row.runId && !byRun.has(row.runId))
+                add(row.runId);
+            read(row, true);
+        },
+    };
+}
+//# sourceMappingURL=retention-command-references.js.map

package/dist/store/retention-command-references.js.map

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

package/dist/store/retention-generations.d.ts

@@ -0,0 +1,13 @@
+import type { EngineStore } from "./store.js";
+/** Quarantine completes recovery: those rows are evidence, never live owners.
+ * Archived generations remain restorable owners. Unknown/pending states cannot
+ * prove absence and hold run retirement install-wide. */
+export declare function retentionGenerations(store: EngineStore): {
+    retained: (pid: number) => boolean;
+    registeredProjectRoots: Set<string>;
+    archivedProjectRoots: Set<string>;
+    protectedProjectRoots: Set<string>;
+    errors: string[];
+    blocked: string | undefined;
+};
+//# sourceMappingURL=retention-generations.d.ts.map

package/dist/store/retention-generations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-generations.d.ts","sourceRoot":"","sources":["../../src/store/retention-generations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;yDAEyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW;oBAmB9B,MAAM;;;;;;EA2D9B"}

package/dist/store/retention-generations.js

@@ -0,0 +1,60 @@
+/** Quarantine completes recovery: those rows are evidence, never live owners.
+ * Archived generations remain restorable owners. Unknown/pending states cannot
+ * prove absence and hold run retirement install-wide. */
+export function retentionGenerations(store) {
+    const rows = store
+        .prepare(`SELECT q.id,q.name,q.status,q.project_id,p.root,g.status AS registry_status FROM partition q
+    LEFT JOIN project p ON p.id=q.project_id LEFT JOIN partition g ON g.id=p.pid`)
+        .all();
+    const known = new Map(rows.map((row) => [row.id, row]));
+    // A completed global quarantine also retires its project descendants. Their
+    // own ready/archived/pending bits are historical, not an independent owner.
+    const retired = (row) => row.status === "quarantined" || row.registry_status === "quarantined";
+    const retained = (pid) => {
+        const row = known.get(pid);
+        if (!row)
+            throw new Error(`retention owner names missing partition ${pid}`);
+        return (!retired(row) &&
+            (!row.project_id || row.registry_status === "ready" || row.registry_status === "archived") &&
+            (row.status === "ready" || row.status === "archived"));
+    };
+    const registered = store
+        .prepare(`SELECT p.root,p.status FROM project p
+    JOIN partition g ON g.id=p.pid LEFT JOIN partition q ON q.id=p.current_pid
+    WHERE p.status IN ('active','archived') AND g.status IN ('ready','archived')
+      AND (q.id IS NULL OR q.status<>'quarantined')`)
+        .all();
+    const registeredProjectRoots = new Set(registered.map((row) => row.root));
+    const activeRoots = new Set(registered.filter((row) => row.status === "active").map((row) => row.root));
+    const archivedProjectRoots = new Set(registered
+        .filter((row) => row.status === "archived" && !activeRoots.has(row.root))
+        .map((row) => row.root));
+    const protectedProjectRoots = new Set();
+    const errors = [];
+    let blocked;
+    for (const row of rows) {
+        if (retained(row.id) || retired(row))
+            continue;
+        const reason = `partition ${row.name} (${row.id}, ${row.status}) awaits journal recovery`;
+        // Scope roots do not bound dependencies: a continuation may name any namespace.
+        blocked ??= reason;
+        errors.push(`all namespaces kept: ${reason}`);
+    }
+    for (const row of store
+        .prepare(`SELECT p.root,p.current_pid FROM project p
+    JOIN partition g ON g.id=p.pid LEFT JOIN partition q ON q.id=p.current_pid
+    WHERE g.status IN ('ready','archived') AND q.id IS NULL`)
+        .all()) {
+        protectedProjectRoots.add(row.root);
+        errors.push(`namespace ${row.root} kept: missing partition ${row.current_pid} awaits journal recovery`);
+    }
+    return {
+        retained,
+        registeredProjectRoots,
+        archivedProjectRoots,
+        protectedProjectRoots,
+        errors,
+        blocked,
+    };
+}
+//# sourceMappingURL=retention-generations.js.map

package/dist/store/retention-generations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-generations.js","sourceRoot":"","sources":["../../src/store/retention-generations.ts"],"names":[],"mappings":"AAEA;;yDAEyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,MAAM,IAAI,GAAG,KAAK;SACf,OAAO,CACN;iFAC2E,CAC5E;SACA,GAAG,EAOJ,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACxD,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,CAAC,GAA0B,EAAE,EAAE,CAC7C,GAAG,CAAC,MAAM,KAAK,aAAa,IAAI,GAAG,CAAC,eAAe,KAAK,aAAa,CAAC;IACxE,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;QAC5E,OAAO,CACL,CAAC,OAAO,CAAC,GAAG,CAAC;YACb,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,eAAe,KAAK,OAAO,IAAI,GAAG,CAAC,eAAe,KAAK,UAAU,CAAC;YAC1F,CAAC,GAAG,CAAC,MAAM,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CACtD,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK;SACrB,OAAO,CACN;;;oDAG8C,CAC/C;SACA,GAAG,EAA6C,CAAC;IACpD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAC3E,CAAC;IACF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC,UAAU;SACP,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SACxE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAC1B,CAAC;IACF,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAA2B,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/C,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,2BAA2B,CAAC;QAC1F,gFAAgF;QAChF,OAAO,KAAK,MAAM,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,KAAK;SACpB,OAAO,CACN;;4DAEsD,CACvD;SACA,GAAG,EAGJ,EAAE,CAAC;QACH,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,aAAa,GAAG,CAAC,IAAI,4BAA4B,GAAG,CAAC,WAAW,0BAA0B,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ;QACR,sBAAsB;QACtB,oBAAoB;QACpB,qBAAqB;QACrB,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/store/retention-pages.d.ts

@@ -0,0 +1,6 @@
+import type { EngineStore } from "./store.js";
+/** Bound each synchronous SQLite read, without holding a cursor/transaction
+ * across admission. Filter after paging so a sparse predicate cannot turn one
+ * page into an unbounded scan. This is an I/O batch, not a retention policy. */
+export declare function retentionPages<T>(store: EngineStore, table: "thread" | "command", columns: string, signal?: AbortSignal): AsyncGenerator<T[]>;
+//# sourceMappingURL=retention-pages.d.ts.map

package/dist/store/retention-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-pages.d.ts","sourceRoot":"","sources":["../../src/store/retention-pages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;gFAEgF;AAChF,wBAAuB,cAAc,CAAC,CAAC,EACrC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,CAAC,EAAE,CAAC,CAcrB"}

package/dist/store/retention-pages.js

@@ -0,0 +1,19 @@
+import { setImmediate as yieldToAdmission } from "node:timers/promises";
+/** Bound each synchronous SQLite read, without holding a cursor/transaction
+ * across admission. Filter after paging so a sparse predicate cannot turn one
+ * page into an unbounded scan. This is an I/O batch, not a retention policy. */
+export async function* retentionPages(store, table, columns, signal) {
+    const page = store.prepare(`SELECT rowid AS retention_rowid,${columns} FROM ${table} NOT INDEXED
+     WHERE rowid>? ORDER BY rowid LIMIT 100`);
+    let after = 0;
+    for (;;) {
+        signal?.throwIfAborted();
+        const rows = page.all(after);
+        if (!rows.length)
+            return;
+        yield rows;
+        after = rows[rows.length - 1].retention_rowid;
+        await yieldToAdmission();
+    }
+}
+//# sourceMappingURL=retention-pages.js.map

package/dist/store/retention-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-pages.js","sourceRoot":"","sources":["../../src/store/retention-pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE;;gFAEgF;AAChF,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,KAAkB,EAClB,KAA2B,EAC3B,OAAe,EACf,MAAoB;IAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CACxB,mCAAmC,OAAO,SAAS,KAAK;4CAChB,CACzC,CAAC;IACF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAA2C,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,IAAI,CAAC;QACX,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,eAAe,CAAC;QAC/C,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/store/retention-reference-reader.d.ts

@@ -0,0 +1,98 @@
+import { Thread } from "@claudexor/schema";
+import type { EngineStore } from "./store.js";
+type Body = {
+    id: string;
+    pid: number;
+    body: Uint8Array;
+};
+type ThreadRow = Body & {
+    state: string;
+};
+type SessionRow = Body & {
+    harness_id: string;
+    thread_id: string;
+};
+type TurnRow = Body & {
+    thread_id: string;
+};
+/** One typed reader for the initial inventory AND changed-owner rechecks.
+ * Protection only grows during a pass; release is recognized by the next pass. */
+export declare class RetentionReferenceReader {
+    private readonly store;
+    private readonly ignored;
+    private readonly retained;
+    readonly runs: Set<string>;
+    readonly sessions: Map<string, Set<string>>;
+    readonly roots: Set<string>;
+    readonly lanes: Map<string, Set<string>>;
+    constructor(store: EngineStore, ignored: ReadonlySet<string>, retained: (pid: number) => boolean);
+    add: (id: string | null | undefined) => void;
+    thread(row: ThreadRow): Thread | undefined;
+    turn(row: TurnRow, owner?: {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    } | undefined): void;
+    session(row: SessionRow, owner?: {
+        schema_version: 2;
+        id: string;
+        created_at: string;
+        updated_at: string;
+        repo: {
+            root: string;
+            base_ref: string;
+        } | null;
+        title: string | null;
+        folder: string | null;
+        mode: "agent" | "ask" | "plan";
+        auth_preference: "api_key" | "auto" | "subscription";
+        access: "external_sandbox_full" | "full" | "inherit_native" | "readonly" | "workspace_write" | null;
+        credential_profile_id: string | null;
+        primary_harness: string | null;
+        eligible_harnesses: string[];
+        workspace: {
+            mode: "delegated" | "in_place" | "isolated";
+            worktree_path: string | null;
+            base_sha: string | null;
+            delivered_through_run_id: string | null;
+            workspace_root: string | null;
+        };
+        run_ids: string[];
+        head_run_id: string | null;
+        state: "active" | "closed" | "purged" | "trashed";
+        trashed_at: string | null;
+        purge_after: string | null;
+        pre_trash_state: "active" | "closed" | null;
+    } | undefined): void;
+    refresh(table: "thread" | "turn" | "session" | "interaction", id: string): void;
+    private read;
+    private owner;
+}
+export {};
+//# sourceMappingURL=retention-reference-reader.d.ts.map

package/dist/store/retention-reference-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-reference-reader.d.ts","sourceRoot":"","sources":["../../src/store/retention-reference-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAc,MAAM,mBAAmB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,KAAK,IAAI,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAC1D,KAAK,SAAS,GAAG,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1C,KAAK,UAAU,GAAG,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,OAAO,GAAG,IAAI,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;kFACkF;AAClF,qBAAa,wBAAwB;IAOjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,QAAQ,CAAC,IAAI,cAAqB;IAClC,QAAQ,CAAC,QAAQ,2BAAkC;IACnD,QAAQ,CAAC,KAAK,cAAqB;IACnC,QAAQ,CAAC,KAAK,2BAAkC;IAEhD,YACmB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,EACjD;IAEJ,GAAG,OAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,UAElC;IAEF,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAgBzC;IAED,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA4B,GAAG,IAAI,CAM1D;IAED,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA4B,GAAG,IAAI,CAchE;IAED,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAmB9E;IAED,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,KAAK;CASd"}

package/dist/store/retention-reference-reader.js

@@ -0,0 +1,110 @@
+import { Session, Thread, ThreadTurn } from "@claudexor/schema";
+import { noProjectRepoRoot } from "@claudexor/util";
+import { decodeBody } from "./thread-rows.js";
+const RetainedTurn = ThreadTurn.omit({ prompt: true });
+/** One typed reader for the initial inventory AND changed-owner rechecks.
+ * Protection only grows during a pass; release is recognized by the next pass. */
+export class RetentionReferenceReader {
+    store;
+    ignored;
+    retained;
+    runs = new Set();
+    sessions = new Map();
+    roots = new Set();
+    lanes = new Map();
+    constructor(store, ignored, retained) {
+        this.store = store;
+        this.ignored = ignored;
+        this.retained = retained;
+    }
+    add = (id) => {
+        if (id)
+            this.runs.add(id);
+    };
+    thread(row) {
+        if (!this.retained(row.pid) || row.state === "purged")
+            return;
+        const thread = this.read("thread", row, () => Thread.parse(decodeBody(row)));
+        if (thread.state !== row.state || thread.id !== row.id)
+            throw new Error(`thread ${row.id} in partition ${row.pid}: retention state or identity disagrees`);
+        if (thread.repo)
+            this.roots.add(thread.repo.root);
+        const root = thread.repo?.root ?? noProjectRepoRoot();
+        const lanes = this.lanes.get(root) ?? new Set();
+        lanes.add(thread.id);
+        this.lanes.set(root, lanes);
+        if (this.ignored.has(thread.id) && thread.state === "trashed")
+            return;
+        thread.run_ids.forEach(this.add);
+        this.add(thread.head_run_id);
+        return thread;
+    }
+    turn(row, owner = this.owner(row.thread_id)) {
+        if (!this.retained(row.pid) || !owner)
+            return;
+        const turn = this.read("turn", row, () => RetainedTurn.parse(decodeBody(row)));
+        if (turn.thread_id !== owner.id || turn.id !== row.id)
+            throw new Error(`turn ${row.id} in partition ${row.pid}: retention owner disagrees`);
+        [turn.run_id, turn.parent_run_id, turn.answers_plan_run_id, turn.plan_run_id].forEach(this.add);
+    }
+    session(row, owner = this.owner(row.thread_id)) {
+        if (!this.retained(row.pid) || !owner)
+            return;
+        const session = this.read("session", row, () => Session.parse(decodeBody(row)));
+        if (session.thread_id !== owner.id ||
+            session.harness_id !== row.harness_id ||
+            session.id !== row.id)
+            throw new Error(`session ${row.id} in partition ${row.pid}: retention owner disagrees`);
+        if (session.native_session_id) {
+            const ids = this.sessions.get(session.harness_id) ?? new Set();
+            ids.add(session.native_session_id);
+            this.sessions.set(session.harness_id, ids);
+        }
+    }
+    refresh(table, id) {
+        if (table === "interaction") {
+            const row = this.store
+                .prepare("SELECT pid,run_id FROM interaction WHERE id=? AND state='pending'")
+                .get(id);
+            if (row && this.retained(row.pid))
+                this.add(row.run_id);
+        }
+        else if (table === "thread") {
+            this.owner(id);
+        }
+        else if (table === "turn") {
+            const row = this.store
+                .prepare("SELECT id,pid,thread_id,body FROM turn WHERE id=?")
+                .get(id);
+            if (row)
+                this.turn(row);
+        }
+        else {
+            const row = this.store
+                .prepare("SELECT id,pid,thread_id,harness_id,body FROM session WHERE id=?")
+                .get(id);
+            if (row)
+                this.session(row);
+        }
+    }
+    read(table, row, read) {
+        try {
+            return read();
+        }
+        catch (error) {
+            throw new Error(`retention ${table} ${row.id} in partition ${row.pid}: ${String(error)}`, {
+                cause: error,
+            });
+        }
+    }
+    owner(id) {
+        const row = this.store.prepare("SELECT id,pid,state,body FROM thread WHERE id=?").get(id);
+        if (!row)
+            return;
+        const thread = this.thread(row);
+        if (thread && thread.id !== id)
+            throw new Error(`thread ${id} in partition ${row.pid}: retention owner disagrees`);
+        return thread;
+    }
+}
+//# sourceMappingURL=retention-reference-reader.js.map

package/dist/store/retention-reference-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-reference-reader.js","sourceRoot":"","sources":["../../src/store/retention-reference-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAMvD;kFACkF;AAClF,MAAM,OAAO,wBAAwB;IAOhB,KAAK;IACL,OAAO;IACP,QAAQ;IARlB,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IACzB,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1B,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,YACmB,KAAkB,EAClB,OAA4B,EAC5B,QAAkC;qBAFlC,KAAK;uBACL,OAAO;wBACP,QAAQ;IACxB,CAAC;IAEJ,GAAG,GAAG,CAAC,EAA6B,EAAE,EAAE;QACtC,IAAI,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,CAAC,GAAc;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,IAAI,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE;YACpD,MAAM,IAAI,KAAK,CACb,UAAU,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,yCAAyC,CAClF,CAAC;QACJ,IAAI,MAAM,CAAC,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QACxD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO;QACtE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,GAAY,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/E,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE;YACnD,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,6BAA6B,CAAC,CAAC;QACvF,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,CAAC,GAAe,EAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChF,IACE,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,EAAE;YAC9B,OAAO,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU;YACrC,OAAO,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE;YAErB,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,6BAA6B,CAAC,CAAC;QAC1F,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YACvE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAoD,EAAE,EAAU;QACtE,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;iBACnB,OAAO,CAAC,mEAAmE,CAAC;iBAC5E,GAAG,CAAC,EAAE,CAAgD,CAAC;YAC1D,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;iBACnB,OAAO,CAAC,mDAAmD,CAAC;iBAC5D,GAAG,CAAC,EAAE,CAAwB,CAAC;YAClC,IAAI,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;iBACnB,OAAO,CAAC,iEAAiE,CAAC;iBAC1E,GAAG,CAAC,EAAE,CAA2B,CAAC;YACrC,IAAI,GAAG;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,IAAI,CAAI,KAAa,EAAE,GAAS,EAAE,IAAa;QACrD,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;gBACxF,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,EAAE,CACjE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE;YAC5B,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,iBAAiB,GAAG,CAAC,GAAG,6BAA6B,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/store/retention-references.d.ts

@@ -0,0 +1,42 @@
+import { Thread } from "@claudexor/schema";
+import type { EngineStore } from "./store.js";
+export interface DiskRetentionReferences {
+    /** Legacy exact inventory witness; current retirement rechecks changed owners. */
+    isCurrent: () => boolean;
+    /** Cooperatively absorb changed owners, then synchronously recheck before expiry. */
+    refresh?: () => Promise<void>;
+    recheck?: () => boolean;
+    /** Native callers absorb the same changed owners before per-file rechecks. */
+    nativeCurrent?: () => boolean;
+    /** Pass-local ownership, refreshed synchronously at each lane sweep boundary. */
+    laneThreadIds?: (root: string) => Set<string>;
+    nativeRunDirs?: ReadonlySet<string>;
+    nativeWatchRunDirs?: ReadonlySet<string>;
+    nativeReferenceError?: () => string | null;
+    hasActiveCommands?: () => boolean;
+    /** Caller releases the observation after all deletions, including error paths. */
+    close?: () => void;
+    /** Recovery holds are receipt facts; completed quarantine is not a hold. */
+    blocked?: string;
+    errors?: string[];
+    projectRoots: string[];
+    /** Retained active/archived registrations; thread root names alone are not ownership. */
+    registeredProjectRoots: Set<string>;
+    /** Archived-only registrations need an extant root to own recent history. */
+    archivedProjectRoots?: Set<string>;
+    protectedProjectRoots: Set<string>;
+    referencedRunIds: Set<string>;
+    nativeSessions: Map<string, Set<string>>;
+    records: Array<{
+        runId: string;
+        state: string;
+        finishedAt?: string;
+    }>;
+}
+/** Maintenance's served thread listing, including unfinished purges. Unlike
+ * public synchronous listing it does not stat every registered project root. */
+export declare function diskRetentionThreads(store: EngineStore, signal?: AbortSignal): Promise<Thread[]>;
+/** Retirement reads all retained generations, including archived projects. Public
+ * listing/admission remains served-generation-only. Any unreadable reference throws. */
+export declare function diskRetentionReferences(store: EngineStore, ignoreThreadIds?: ReadonlySet<string>, signal?: AbortSignal): Promise<DiskRetentionReferences>;
+//# sourceMappingURL=retention-references.d.ts.map

package/dist/store/retention-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention-references.d.ts","sourceRoot":"","sources":["../../src/store/retention-references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yFAAyF;IACzF,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED;gFACgF;AAChF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CA8CnB;AAED;wFACwF;AACxF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,WAAW,EAClB,eAAe,GAAE,WAAW,CAAC,MAAM,CAAa,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAyGlC"}