@claudexor/daemon 3.24.0 → 4.0.0

package/dist/store/cursors.js

@@ -0,0 +1,82 @@
+import { BlobFiles } from "./blob-files.js";
+import { StoreError } from "./errors.js";
+import { currentGeneration } from "./partitions.js";
+/** 409 + `resnapshot`, byte-for-byte the journal's refusal of today. */
+export class JournalCursorError extends StoreError {
+    requiredActions = ["resnapshot"];
+    constructor(detail) {
+        super("journal_cursor_invalid", 409, true, `journal cursor is ${detail}; resnapshot is required`);
+        this.name = "JournalCursorError";
+    }
+}
+/** The opaque cursor is unchanged: base64url of `{v:1, p, e, s}`. */
+export function encodeJournalCursor(partition, epoch, seq) {
+    return Buffer.from(JSON.stringify({ v: 1, p: partition, e: epoch, s: seq })).toString("base64url");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate a cursor against the current generation and return the sequence to
+ * resume after — the same checks in the same order as the journal package:
+ * malformed, unsupported shape, stale partition/epoch, ahead of the durable
+ * sequence, non-canonical encoding.
+ */
+export function decodeJournalCursor(cursor, partition, epoch, nextSeq) {
+    if (!cursor)
+        return 0;
+    if (!/^[A-Za-z0-9_-]{1,4096}$/.test(cursor))
+        throw new JournalCursorError("malformed");
+    let value;
+    try {
+        value = JSON.parse(Buffer.from(cursor, "base64url").toString("utf8"));
+    }
+    catch {
+        throw new JournalCursorError("malformed");
+    }
+    if (!isRecord(value) || Object.keys(value).sort().join(",") !== "e,p,s,v" || value["v"] !== 1) {
+        throw new JournalCursorError("unsupported");
+    }
+    if (value["p"] !== partition || value["e"] !== epoch)
+        throw new JournalCursorError("stale epoch");
+    const seq = value["s"];
+    if (!Number.isSafeInteger(seq) || Number(seq) < 0 || Number(seq) >= nextSeq) {
+        throw new JournalCursorError("ahead of the durable partition");
+    }
+    if (encodeJournalCursor(value["p"], value["e"], seq) !== cursor) {
+        throw new JournalCursorError("not canonically encoded");
+    }
+    return seq;
+}
+/** Map `{v,p,e,s}` onto the current generation's `pid` and resume sequence. */
+export function resolveJournalCursor(store, partition, cursor) {
+    const generation = currentGeneration(store, partition);
+    if (!generation)
+        throw new JournalCursorError("stale epoch");
+    return {
+        generation,
+        afterSeq: decodeJournalCursor(cursor, partition, generation.epoch, generation.nextSeq),
+    };
+}
+/** The retained events after a cursor, as the global/project SSE replays them today. */
+export function readJournalEvents(store, partition, afterCursor, blobs = new BlobFiles(store)) {
+    const { generation, afterSeq } = resolveJournalCursor(store, partition, afterCursor);
+    const rows = store
+        .prepare("SELECT seq, time, type, payload, payload_sha FROM event WHERE pid = ? AND seq > ? ORDER BY seq")
+        .all(generation.pid, afterSeq);
+    return rows.map((row) => ({
+        schemaVersion: 1,
+        cursor: encodeJournalCursor(partition, generation.epoch, Number(row.seq)),
+        partition,
+        type: row.type,
+        observedAt: row.time,
+        payload: readStoredEventPayload(row, blobs),
+    }));
+}
+/** Both cursor/SSE and reducer reads hydrate the same logical payload. A digest
+ * reference is authoritative; missing or corrupt bytes remain typed failures. */
+export function readStoredEventPayload(row, blobs) {
+    const bytes = row.payload_sha === null ? Buffer.from(row.payload) : blobs.read(row.payload_sha);
+    return JSON.parse(bytes.toString("utf8"));
+}
+//# sourceMappingURL=cursors.js.map

package/dist/store/cursors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.js","sourceRoot":"","sources":["../../src/store/cursors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAA4B,MAAM,iBAAiB,CAAC;AAG9E,wEAAwE;AACxE,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IACvC,eAAe,GAAG,CAAC,YAAY,CAAC,CAAC;IAE1C,YAAY,MAAc;QACxB,KAAK,CACH,wBAAwB,EACxB,GAAG,EACH,IAAI,EACJ,qBAAqB,MAAM,0BAA0B,CACtD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAAa,EAAE,GAAW;IAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CACnF,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,SAAiB,EACjB,KAAa,EACb,OAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvF,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5E,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAW,EAAE,KAAK,CAAC,GAAG,CAAW,EAAE,GAAa,CAAC,KAAK,MAAM,EAAE,CAAC;QAC9F,MAAM,IAAI,kBAAkB,CAAC,yBAAyB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAa,CAAC;AACvB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAClC,KAAkB,EAClB,SAAiB,EACjB,MAAiC;IAEjC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC7D,OAAO;QACL,UAAU;QACV,QAAQ,EAAE,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,SAAiB,EACjB,WAA2B,EAC3B,KAAK,GAA4B,IAAI,SAAS,CAAC,KAAK,CAAC;IAErD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,KAAK;SACf,OAAO,CACN,gGAAgG,CACjG;SACA,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAM7B,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACxB,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzE,SAAS;QACT,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,IAAI;QACpB,OAAO,EAAE,sBAAsB,CAAC,GAAG,EAAE,KAAK,CAAC;KAC5C,CAAC,CAAC,CAAC;AACN,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,sBAAsB,CACpC,GAAwD,EACxD,KAA8B;IAE9B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChG,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAY,CAAC;AACvD,CAAC"}

package/dist/store/engine-recovery-files.d.ts

@@ -0,0 +1,14 @@
+export declare const ENGINE_STATE_FILES: readonly ["engine.sqlite", "engine.sqlite-wal", "engine.sqlite-shm"];
+export interface EngineFileEvidence {
+    name: (typeof ENGINE_STATE_FILES)[number];
+    bytes: number | null;
+    sha256: string | null;
+}
+/** Only the SQLite file set, never root authority, credentials or retained artifacts. */
+export declare function engineFileEvidence(root: string): EngineFileEvidence[];
+export declare function engineFingerprint(files: readonly EngineFileEvidence[]): string;
+/** The explicit closed-file recovery path must persist checkpointed DB pages,
+ * not infer their durability from a WAL-only barrier. */
+export declare function syncEngineFiles(root: string, files: readonly EngineFileEvidence[]): void;
+export declare function parseEngineFiles(value: unknown): EngineFileEvidence[];
+//# sourceMappingURL=engine-recovery-files.d.ts.map

package/dist/store/engine-recovery-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-recovery-files.d.ts","sourceRoot":"","sources":["../../src/store/engine-recovery-files.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,YAC7B,eAAe,EACf,mBAAmB,EACnB,mBAAmB,CACX,CAAC;AACX,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAOrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAE9E;AAED;yDACyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAUxF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,EAAE,CA0BrE"}

package/dist/store/engine-recovery-files.js

@@ -0,0 +1,53 @@
+import { closeSync, existsSync, fsyncSync, openSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { sha256, sha256File } from "../journal-recovery-files.js";
+import { typedError } from "../journal-recovery-operation.js";
+export const ENGINE_STATE_FILES = [
+    "engine.sqlite",
+    "engine.sqlite-wal",
+    "engine.sqlite-shm",
+];
+/** Only the SQLite file set, never root authority, credentials or retained artifacts. */
+export function engineFileEvidence(root) {
+    return ENGINE_STATE_FILES.map((name) => {
+        const path = join(root, name);
+        if (!existsSync(path))
+            return { name, bytes: null, sha256: null };
+        const digest = sha256File(path); // Existing owned/no-follow, stable, bounded reader.
+        return { name, bytes: statSync(path).size, sha256: digest };
+    });
+}
+export function engineFingerprint(files) {
+    return sha256(Buffer.from(JSON.stringify(files)));
+}
+/** The explicit closed-file recovery path must persist checkpointed DB pages,
+ * not infer their durability from a WAL-only barrier. */
+export function syncEngineFiles(root, files) {
+    for (const file of files) {
+        if (file.sha256 === null)
+            continue;
+        const fd = openSync(join(root, file.name), "r+");
+        try {
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+}
+export function parseEngineFiles(value) {
+    if (!Array.isArray(value) || value.length !== ENGINE_STATE_FILES.length)
+        throw typedError("recovery_operation_malformed", 503, "closed engine file inventory is incomplete");
+    return value.map((row, index) => {
+        if (!row ||
+            row.name !== ENGINE_STATE_FILES[index] ||
+            !((row.sha256 === null && row.bytes === null) ||
+                (typeof row.sha256 === "string" &&
+                    /^[a-f0-9]{64}$/.test(row.sha256) &&
+                    Number.isSafeInteger(row.bytes) &&
+                    row.bytes >= 0)))
+            throw typedError("recovery_operation_malformed", 503, "closed engine file inventory is invalid");
+        return { name: row.name, bytes: row.bytes, sha256: row.sha256 };
+    });
+}
+//# sourceMappingURL=engine-recovery-files.js.map

package/dist/store/engine-recovery-files.js.map

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

package/dist/store/engine-state-recovery.d.ts

@@ -0,0 +1,71 @@
+import { ControlJournalExportReceipt, ControlJournalInspection, ControlJournalQuarantineReceipt, ControlJournalValidation, type ControlJournalEvent } from "@claudexor/schema";
+import type { JournalRecoveryState } from "./errors.js";
+import { type JournalQuarantineRequest } from "../journal-recovery-operation.js";
+import type { PartitionControlPort } from "../store-contracts.js";
+export interface EngineRecoveryLifecycle {
+    state(): {
+        generation: number;
+        recovery: JournalRecoveryState;
+    };
+    validate(): Promise<{
+        ok: boolean;
+        detail: string | null;
+    }>;
+    /** Fence ingress and close every SQL connection/worker, preserving root authority. */
+    close(): Promise<void>;
+    /** Durably create/verify this exact fresh generation and prepare its graph.
+     * Parent opens normal admission only after the final receipt. Never import legacy. */
+    createFresh(input: {
+        operationId: string;
+        newEpoch: string;
+    }): Promise<void>;
+}
+export interface EngineRecoveryOptions {
+    now?: () => Date;
+    /** Fault injection around real durable transitions; no runtime policy. */
+    fault?(stage: "intent" | "closed" | "closed_record" | "renamed" | "archived_record" | "fresh" | "receipt", name?: string): void;
+}
+/** Existing recovery API's physical target. Its one external operation record
+ * survives corruption/replacement of the database whose recovery it authorizes. */
+export declare class EngineStateRecovery implements PartitionControlPort {
+    readonly rootDir: string;
+    private readonly lifecycle;
+    private readonly options;
+    readonly partition = "engine-state";
+    private readonly operationsDir;
+    private readonly quarantineDir;
+    private readonly now;
+    private tail;
+    constructor(rootDir: string, lifecycle: EngineRecoveryLifecycle, options?: EngineRecoveryOptions);
+    inspect(): ControlJournalInspection;
+    validate(): Promise<ControlJournalValidation>;
+    events(): ControlJournalEvent[];
+    exportRecovery(): ControlJournalExportReceipt;
+    preflightQuarantine(input: JournalQuarantineRequest): {
+        disposition: string;
+        receipt: {
+            schemaVersion: 1;
+            operationId: string;
+            partition: string;
+            previousFingerprint: string;
+            quarantineArtifactId: string;
+            quarantinePath: string;
+            newEpoch: string;
+            completedAt: string;
+        };
+    } | {
+        disposition: string;
+        receipt: null;
+    };
+    quarantineAndStartFresh(input: JournalQuarantineRequest): Promise<ControlJournalQuarantineReceipt>;
+    /** Startup reconciles accepted intent before any ordinary open/import choice. */
+    resumePending(): Promise<ControlJournalQuarantineReceipt | null>;
+    private resume;
+    private operationPath;
+    private archiveResourceStore;
+    private syncOperationCustody;
+    private read;
+    private pending;
+    private exclusive;
+}
+//# sourceMappingURL=engine-state-recovery.d.ts.map

package/dist/store/engine-state-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-state-recovery.d.ts","sourceRoot":"","sources":["../../src/store/engine-state-recovery.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAUxD,OAAO,EAOL,KAAK,wBAAwB,EAE9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAkBlE,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAChE,QAAQ,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5D,sFAAsF;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;0FACsF;IACtF,WAAW,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AACD,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,CACJ,KAAK,EACH,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,iBAAiB,GAAG,OAAO,GAAG,SAAS,EAC7F,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAAC;CACT;AAED;mFACmF;AACnF,qBAAa,mBAAoB,YAAW,oBAAoB;IAO5D,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,QAAQ,CAAC,SAAS,kBAAa;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,IAAI,CAAoC;IAChD,YACW,OAAO,EAAE,MAAM,EACP,SAAS,EAAE,uBAAuB,EAClC,OAAO,GAAE,qBAA0B,EAOrD;IAED,OAAO,IAAI,wBAAwB,CAalC;IACK,QAAQ,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA4BlD;IACD,MAAM,IAAI,mBAAmB,EAAE,CAM9B;IAED,cAAc,IAAI,2BAA2B,CA8C5C;IAED,mBAAmB,CAAC,KAAK,EAAE,wBAAwB;;;;;;;;;;;;;;;MA6BlD;IAED,uBAAuB,CACrB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,+BAA+B,CAAC,CA+B1C;IAED,iFAAiF;IACjF,aAAa,IAAI,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAW/D;YAEa,MAAM;IA+EpB,OAAO,CAAC,aAAa;IAGrB,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,IAAI;IAgCZ,OAAO,CAAC,OAAO;YAOD,SAAS;CAaxB"}

package/dist/store/engine-state-recovery.js

@@ -0,0 +1,318 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, realpathSync, renameSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { ControlJournalExportReceipt, ControlJournalInspection, ControlJournalQuarantineReceipt, ControlJournalValidation, } from "@claudexor/schema";
+import { ensureCanonicalPrivateDirectory, fsyncDirectory } from "@claudexor/util";
+import { cloneRecovery, copyOwnedFile, sha256, sha256File, writeAtomicPrivateJson, writeExclusiveFile, } from "../journal-recovery-files.js";
+import { conflict, matchingReceipt, quarantineRequestDigest, readOperation, typedError, validateRequest, } from "../journal-recovery-operation.js";
+import { engineFileEvidence, engineFingerprint, parseEngineFiles, syncEngineFiles, } from "./engine-recovery-files.js";
+const PARTITION = "engine-state";
+const PREFIX = "engine";
+/** Existing recovery API's physical target. Its one external operation record
+ * survives corruption/replacement of the database whose recovery it authorizes. */
+export class EngineStateRecovery {
+    rootDir;
+    lifecycle;
+    options;
+    partition = PARTITION;
+    operationsDir;
+    quarantineDir;
+    now;
+    tail = Promise.resolve();
+    constructor(rootDir, lifecycle, options = {}) {
+        this.rootDir = rootDir;
+        this.lifecycle = lifecycle;
+        this.options = options;
+        if (realpathSync(rootDir) !== rootDir)
+            throw new Error("engine recovery requires its canonical data root");
+        this.operationsDir = join(rootDir, "recovery-operations", PARTITION);
+        this.quarantineDir = join(rootDir, "journal-quarantine");
+        this.now = options.now ?? (() => new Date());
+    }
+    inspect() {
+        const { generation, recovery } = this.lifecycle.state();
+        const fingerprint = engineFingerprint(engineFileEvidence(this.rootDir));
+        return ControlJournalInspection.parse({
+            schemaVersion: 1,
+            partition: PARTITION,
+            generation,
+            status: recovery.status,
+            recovery: cloneRecovery(recovery),
+            fingerprint,
+            observedAt: this.now().toISOString(),
+            evidenceRefs: [`recovery:${PARTITION}:${fingerprint}`],
+        });
+    }
+    async validate() {
+        let result;
+        try {
+            result = await this.lifecycle.validate();
+        }
+        catch (error) {
+            result = { ok: false, detail: error instanceof Error ? error.message : String(error) };
+        }
+        const inspected = this.inspect();
+        const recovery = result.ok
+            ? inspected.recovery
+            : {
+                status: "recovery_required",
+                location: { kind: "byte", byteOffset: 0 },
+                reason: result.detail ?? "engine state could not be validated",
+                discardedTailBytes: 0,
+            };
+        return ControlJournalValidation.parse({
+            ...inspected,
+            status: recovery.status,
+            recovery,
+            projectionStatus: [
+                {
+                    name: "sqlite.integrity",
+                    status: result.ok ? "valid" : "invalid",
+                    detail: result.detail,
+                },
+            ],
+        });
+    }
+    events() {
+        throw typedError("recovery_events_unavailable", 409, "engine-state is a physical diagnostic target; journal events belong to logical partitions");
+    }
+    exportRecovery() {
+        const inspection = this.inspect();
+        const files = engineFileEvidence(this.rootDir);
+        if (engineFingerprint(files) !== inspection.fingerprint)
+            throw conflict("recovery_fingerprint_mismatch");
+        const exportId = `engine-export-${this.now().getTime().toString(36)}-${randomUUID()}`;
+        const exportsRoot = join(this.rootDir, "recovery-exports");
+        ensureCanonicalPrivateDirectory(exportsRoot);
+        const bundlePath = join(exportsRoot, exportId);
+        mkdirSync(bundlePath, { mode: 0o700 });
+        try {
+            for (const file of files) {
+                if (file.sha256 === null)
+                    continue;
+                if (copyOwnedFile(join(this.rootDir, file.name), join(bundlePath, file.name), 0o400) !==
+                    file.sha256)
+                    throw conflict("recovery_fingerprint_mismatch");
+            }
+            if (engineFingerprint(engineFileEvidence(this.rootDir)) !== inspection.fingerprint)
+                throw conflict("recovery_fingerprint_mismatch");
+            const createdAt = this.now().toISOString();
+            const path = join(bundlePath, "manifest.json");
+            writeExclusiveFile(path, Buffer.from(`${JSON.stringify({ schemaVersion: 1, exportId, partition: PARTITION, fingerprint: inspection.fingerprint, recovery: inspection.recovery, createdAt, diagnosticOnly: true, integrity: "not_verified", entries: files, externalEvidence: "SQL body blobs, uploads, per-run and setup artifacts remain in their existing locations; this is a raw corruption diagnostic, not a restorable complete store snapshot." }, null, 2)}\n`), 0o400);
+            fsyncDirectory(bundlePath);
+            fsyncDirectory(exportsRoot);
+            fsyncDirectory(this.rootDir);
+            return ControlJournalExportReceipt.parse({
+                schemaVersion: 1,
+                exportId,
+                partition: PARTITION,
+                fingerprint: inspection.fingerprint,
+                bundlePath,
+                manifestSha256: sha256File(path),
+                createdAt,
+            });
+        }
+        catch (error) {
+            rmSync(bundlePath, { recursive: true, force: true });
+            throw error;
+        }
+    }
+    preflightQuarantine(input) {
+        validateRequest(input);
+        const operation = this.read(this.operationPath(sha256(Buffer.from(input.idempotencyKey))));
+        if (operation) {
+            if (operation.requestDigest !== quarantineRequestDigest(PARTITION, input))
+                throw conflict("idempotency_conflict");
+            return operation.status === "completed"
+                ? {
+                    disposition: "completed",
+                    receipt: matchingReceipt(operation, undefined, PARTITION, PREFIX),
+                }
+                : { disposition: "prepared", receipt: null };
+        }
+        if (this.pending().length)
+            throw typedError("recovery_operation_pending", 409, "an earlier engine-state recovery operation must finish first");
+        const current = this.inspect();
+        if (current.status !== "recovery_required")
+            throw typedError("journal_partition_ready", 409, "only corrupt engine state can be quarantined");
+        if (current.fingerprint !== input.expectedFingerprint)
+            throw conflict("recovery_fingerprint_mismatch");
+        return { disposition: "new", receipt: null };
+    }
+    quarantineAndStartFresh(input) {
+        return this.exclusive(async () => {
+            const preflight = this.preflightQuarantine(input);
+            if (preflight.disposition === "completed") {
+                this.syncOperationCustody("completed");
+                return preflight.receipt;
+            }
+            const keyDigest = sha256(Buffer.from(input.idempotencyKey));
+            const path = this.operationPath(keyDigest);
+            let operation = this.read(path);
+            if (!operation) {
+                const operationId = randomUUID();
+                operation = {
+                    schemaVersion: 1,
+                    operationId,
+                    keyDigest,
+                    requestDigest: quarantineRequestDigest(PARTITION, input),
+                    expectedFingerprint: input.expectedFingerprint,
+                    quarantinePath: join(this.quarantineDir, `${PREFIX}-${operationId}`),
+                    status: "prepared",
+                    receipt: null,
+                    phase: "intent",
+                    newEpoch: randomUUID().replaceAll("-", ""),
+                };
+                ensureCanonicalPrivateDirectory(dirname(this.operationsDir));
+                writeAtomicPrivateJson(path, operation, true);
+                this.syncOperationCustody("intent");
+                this.options.fault?.("intent");
+            }
+            return this.resume(operation, path);
+        });
+    }
+    /** Startup reconciles accepted intent before any ordinary open/import choice. */
+    resumePending() {
+        return this.exclusive(async () => {
+            const pending = this.pending();
+            if (pending.length > 1)
+                throw typedError("recovery_operation_ambiguous", 503, "multiple pending engine-state recovery operations");
+            return pending[0] ? this.resume(pending[0], this.operationPath(pending[0].keyDigest)) : null;
+        });
+    }
+    async resume(operation, path) {
+        this.syncOperationCustody(operation.phase);
+        await this.lifecycle.close();
+        this.options.fault?.("closed");
+        if (operation.phase === "intent") {
+            const closedFiles = engineFileEvidence(this.rootDir);
+            syncEngineFiles(this.rootDir, closedFiles);
+            fsyncDirectory(this.rootDir);
+            operation = {
+                ...operation,
+                phase: "closed",
+                closedFiles,
+                closedResourceStore: existsSync(join(this.rootDir, "resource-store")),
+            };
+            writeAtomicPrivateJson(path, operation, false);
+            this.options.fault?.("closed_record");
+        }
+        if (operation.phase === "closed") {
+            ensureCanonicalPrivateDirectory(this.quarantineDir);
+            ensureCanonicalPrivateDirectory(operation.quarantinePath);
+            // Persist the destination directory name before source entries disappear.
+            fsyncDirectory(operation.quarantinePath);
+            fsyncDirectory(this.quarantineDir);
+            fsyncDirectory(this.rootDir);
+            for (const file of operation.closedFiles) {
+                const source = join(this.rootDir, file.name), target = join(operation.quarantinePath, file.name);
+                if (existsSync(target)) {
+                    if (file.sha256 === null || existsSync(source) || sha256File(target) !== file.sha256)
+                        throw typedError("recovery_quarantine_mismatch", 503, "archived engine file differs from the closed source inventory");
+                    continue;
+                }
+                if (file.sha256 === null) {
+                    if (existsSync(source))
+                        throw conflict("recovery_fingerprint_mismatch");
+                    continue;
+                }
+                if (!existsSync(source) || sha256File(source) !== file.sha256)
+                    throw conflict("recovery_fingerprint_mismatch");
+                renameSync(source, target);
+                fsyncDirectory(operation.quarantinePath);
+                fsyncDirectory(this.rootDir);
+                this.options.fault?.("renamed", file.name);
+            }
+            this.archiveResourceStore(operation);
+            operation = { ...operation, phase: "archived" };
+            writeAtomicPrivateJson(path, operation, false);
+            this.options.fault?.("archived_record");
+        }
+        await this.lifecycle.createFresh({
+            operationId: operation.operationId,
+            newEpoch: operation.newEpoch,
+        });
+        this.options.fault?.("fresh");
+        const receipt = ControlJournalQuarantineReceipt.parse({
+            schemaVersion: 1,
+            operationId: operation.operationId,
+            partition: PARTITION,
+            previousFingerprint: operation.expectedFingerprint,
+            quarantineArtifactId: `${PREFIX}-${operation.operationId}`,
+            quarantinePath: operation.quarantinePath,
+            newEpoch: operation.newEpoch,
+            completedAt: this.now().toISOString(),
+        });
+        writeAtomicPrivateJson(path, { ...operation, status: "completed", phase: "completed", receipt }, false);
+        this.options.fault?.("receipt");
+        return receipt;
+    }
+    operationPath(keyDigest) {
+        return join(this.operationsDir, `${keyDigest}.json`);
+    }
+    archiveResourceStore(operation) {
+        // External bodies, upload parts and legacy bindings belong with the DB
+        // whose owners they describe. Keep the canonical relative layout; the
+        // fresh graph must never collect bytes from this closed generation.
+        const source = join(this.rootDir, "resource-store"), target = join(operation.quarantinePath, "resource-store");
+        const atSource = existsSync(source), atTarget = existsSync(target);
+        if (operation.closedResourceStore ? atSource === atTarget : atSource || atTarget)
+            throw typedError("recovery_quarantine_mismatch", 503, "resource-store custody differs from the closed generation inventory");
+        if (!atSource)
+            return;
+        renameSync(source, target);
+        fsyncDirectory(operation.quarantinePath);
+        fsyncDirectory(this.rootDir);
+        this.options.fault?.("renamed", "resource-store");
+    }
+    syncOperationCustody(phase) {
+        // A failed directory sync can leave renamed JSON visible but not yet durable.
+        fsyncDirectory(this.operationsDir);
+        if (phase === "intent") {
+            fsyncDirectory(dirname(this.operationsDir));
+            fsyncDirectory(this.rootDir);
+        }
+    }
+    read(path) {
+        const base = readOperation(path, this.quarantineDir, PARTITION, PREFIX);
+        if (!base)
+            return null;
+        const op = base;
+        if (!/^[a-f0-9]{32}$/.test(op.newEpoch) ||
+            !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(op.operationId) ||
+            !["intent", "closed", "archived", "completed"].includes(op.phase) ||
+            (op.status === "completed") !== (op.phase === "completed"))
+            throw typedError("recovery_operation_malformed", 503, "engine recovery operation has invalid progress metadata");
+        if (op.phase !== "intent") {
+            op.closedFiles = parseEngineFiles(op.closedFiles);
+            if (typeof op.closedResourceStore !== "boolean")
+                throw typedError("recovery_operation_malformed", 503, "closed resource-store inventory is missing or invalid");
+        }
+        if (op.receipt && op.receipt.newEpoch !== op.newEpoch)
+            throw typedError("recovery_receipt_mismatch", 503, "engine recovery receipt has another epoch");
+        return op;
+    }
+    pending() {
+        if (!existsSync(this.operationsDir))
+            return [];
+        return readdirSync(this.operationsDir)
+            .filter((name) => name.endsWith(".json"))
+            .map((name) => this.read(join(this.operationsDir, name)))
+            .filter((op) => op !== null && op.status !== "completed");
+    }
+    async exclusive(body) {
+        const before = this.tail;
+        let release;
+        this.tail = new Promise((done) => {
+            release = done;
+        });
+        await before;
+        try {
+            return await body();
+        }
+        finally {
+            release();
+        }
+    }
+}
+//# sourceMappingURL=engine-state-recovery.js.map

package/dist/store/engine-state-recovery.js.map

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