@claudexor/daemon 3.24.0 → 4.0.0

package/dist/journal-maintenance.js

@@ -1,162 +0,0 @@
-import { lstat, readdir, unlink } from "node:fs/promises";
-import { join } from "node:path";
-import { setImmediate } from "node:timers/promises";
-import { ensureCanonicalPrivateDirectory } from "@claudexor/util";
-/** One cancelable maintenance flight under the daemon's existing root writer.
- * A manager creates a new journal object per generation and closes the old one;
- * those exact objects are the dedupe keys, never another durable authority. */
-export class JournalMaintenance {
-    log;
-    pending = new Set();
-    controller = new AbortController();
-    flight = null;
-    armed = false;
-    stopped = false;
-    cleaned = false;
-    stagingDir;
-    constructor(rootDir, 
-    /** One sink for failures, typed declines and `journal.records_retired`
-     * receipts (the daemon log plus startup diagnostics in the composition root). */
-    log) {
-        this.log = log;
-        this.stagingDir = join(rootDir, "journal-compaction");
-    }
-    /** Request one pass for this generation. Requests coalesce while pending; a
-     * request that arrives during the generation's own flight runs one more pass
-     * after it — the journal's threshold hook is edge-triggered, so that request
-     * means the file crossed the threshold again. */
-    request = (journal) => {
-        if (this.stopped)
-            return;
-        this.pending.add(journal);
-        this.startFlight();
-    };
-    /** Called only after normal admission, including recovery-route reopen. */
-    arm() {
-        if (this.armed || this.stopped)
-            return;
-        try {
-            // A sibling of journal/, so candidate churn never changes a concurrently
-            // prepared partition's journal-root directory fingerprint.
-            ensureCanonicalPrivateDirectory(this.stagingDir);
-            this.armed = true;
-            this.startFlight();
-        }
-        catch (error) {
-            this.warnFailure(error);
-        }
-    }
-    /** Synchronous prefix revokes new work and aborts bulk I/O. The existing
-     * daemon stop wrapper awaits cleanup before journals/root authority close. */
-    stop() {
-        this.stopped = true;
-        this.pending.clear();
-        this.controller.abort();
-        return this.flight ?? Promise.resolve();
-    }
-    startFlight() {
-        if (!this.armed || this.stopped || this.flight)
-            return;
-        const flight = this.run()
-            .catch((error) => {
-            if (!this.controller.signal.aborted)
-                this.warnFailure(error);
-        })
-            .finally(() => {
-            if (this.flight === flight)
-                this.flight = null;
-            if (this.pending.size > 0)
-                this.startFlight();
-        });
-        this.flight = flight;
-    }
-    async run() {
-        await setImmediate(undefined, { signal: this.controller.signal });
-        if (!this.cleaned) {
-            this.cleaned = true;
-            await this.removeCrashCandidates();
-        }
-        while (!this.stopped && this.pending.size > 0) {
-            const journal = this.pending.values().next().value;
-            this.pending.delete(journal);
-            try {
-                if (journal.state().status !== "ready")
-                    continue;
-            }
-            catch {
-                continue;
-            } // the manager retired this exact generation
-            try {
-                const outcome = await journal.compactInBackground({
-                    stagingDir: this.stagingDir,
-                    signal: this.controller.signal,
-                });
-                const line = describeCompactionOutcome(journal.options.partition, outcome, journal.retiredAtReplay());
-                if (line)
-                    this.log(line);
-            }
-            catch (error) {
-                this.warnFailure(error);
-            }
-        }
-    }
-    async removeCrashCandidates() {
-        for (const name of await readdir(this.stagingDir)) {
-            this.controller.signal.throwIfAborted();
-            // Only this producer's UUID-shaped scratch files, never journal.bin,
-            // append.pending.json, recovery receipts, archives or unrelated entries.
-            if (!/^journal-compaction-[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\.compact$/.test(name))
-                continue;
-            const path = join(this.stagingDir, name);
-            const stat = await lstat(path);
-            if (stat.isFile() && stat.nlink === 1)
-                await unlink(path);
-        }
-    }
-    warnFailure(error) {
-        this.log(`journal maintenance failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/** The process footprint as log-line fields (`rssMb=… heapUsedMb=… externalMb=…`,
- * whole mebibytes). The daemon's retained journal set lives on its heap, so
- * the lines that already exist — the normal-admission line and every journal
- * maintenance receipt — carry it, and the memory class stays observable on
- * every install without a new mechanism. */
-export function processMemoryFields(usage = process.memoryUsage()) {
-    const mb = (bytes) => Math.round(bytes / (1024 * 1024));
-    return `rssMb=${mb(usage.rss)} heapUsedMb=${mb(usage.heapUsed)} externalMb=${mb(usage.external)}`;
-}
-/** One log line per maintenance outcome: the typed decline with its reason and
- * bounds, or the `journal.records_retired` receipt — compaction-time counts
- * beside what the fold already retired while replaying this generation at
- * open (`retiredAtReplay`). Both end with the process memory fields. The quiet
- * no-ops (below the threshold, an empty journal) produce no line. */
-export function describeCompactionOutcome(partition, outcome, replay = { count: 0, bytes: 0 }, memory = processMemoryFields()) {
-    if ("declined" in outcome) {
-        if (outcome.reason === "below_threshold" || outcome.reason === "empty")
-            return null;
-        const bounds = [];
-        if (outcome.compressedBytes !== undefined)
-            bounds.push(`compressedBytes=${outcome.compressedBytes}`);
-        // Only a capacity decline names a cap that fired; a no-reclaim decline's
-        // cap is the current file size, which `compressedBytes` already exceeds.
-        if (outcome.reason === "capacity" && outcome.cap !== undefined)
-            bounds.push(`cap=${outcome.cap}`);
-        return ["journal.compaction_declined", `partition=${partition}`, `reason=${outcome.reason}`]
-            .concat(bounds, memory)
-            .join(" ");
-    }
-    return [
-        "journal.records_retired",
-        `partition=${partition}`,
-        `retainedCount=${outcome.retainedCount}`,
-        `retiredCount=${outcome.retiredCount}`,
-        `retiredBytes=${outcome.retiredBytes}`,
-        `retiredAtReplayCount=${replay.count}`,
-        `retiredAtReplayBytes=${replay.bytes}`,
-        `beforeBytes=${outcome.beforeBytes}`,
-        `afterBytes=${outcome.afterBytes}`,
-        memory,
-    ].join(" ");
-}
-//# sourceMappingURL=journal-maintenance.js.map

package/dist/journal-maintenance.js.map

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

package/dist/journal-manager-journal.d.ts

@@ -1,18 +0,0 @@
-import type { DurableJournal, DurableJournalOptions } from "@claudexor/journal";
-/**
- * The daemon's journal options for one manager: every partition replays and
- * compacts through the daemon fold policy (one frozen policy shared by every
- * manager and every pass), opts into deferred maintenance
- * whenever a maintenance callback exists, and re-requests maintenance for the
- * live generation when an append crosses the compaction threshold — the
- * journal fires that hook once per crossing and re-arms it when the pass
- * settles (install, typed decline or a failed pass).
- */
-export declare function daemonJournalOptions(input: {
-    rootDir: string;
-    partition: string;
-    now: () => Date;
-    requestMaintenance: ((journal: DurableJournal) => void) | undefined;
-    current: () => DurableJournal | null;
-}): DurableJournalOptions;
-//# sourceMappingURL=journal-manager-journal.d.ts.map

package/dist/journal-manager-journal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"journal-manager-journal.d.ts","sourceRoot":"","sources":["../src/journal-manager-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpE,OAAO,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;CACtC,GAAG,qBAAqB,CAYxB"}

package/dist/journal-manager-journal.js

@@ -1,25 +0,0 @@
-import { journalFoldPolicy } from "./journal-fold-policy.js";
-/**
- * The daemon's journal options for one manager: every partition replays and
- * compacts through the daemon fold policy (one frozen policy shared by every
- * manager and every pass), opts into deferred maintenance
- * whenever a maintenance callback exists, and re-requests maintenance for the
- * live generation when an append crosses the compaction threshold — the
- * journal fires that hook once per crossing and re-arms it when the pass
- * settles (install, typed decline or a failed pass).
- */
-export function daemonJournalOptions(input) {
-    return {
-        rootDir: input.rootDir,
-        partition: input.partition,
-        now: input.now,
-        deferCompaction: input.requestMaintenance !== undefined,
-        fold: journalFoldPolicy,
-        onCompactionThreshold: () => {
-            const journal = input.current();
-            if (journal)
-                input.requestMaintenance?.(journal);
-        },
-    };
-}
-//# sourceMappingURL=journal-manager-journal.js.map

package/dist/journal-manager-journal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"journal-manager-journal.js","sourceRoot":"","sources":["../src/journal-manager-journal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAMpC;IACC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,eAAe,EAAE,KAAK,CAAC,kBAAkB,KAAK,SAAS;QACvD,IAAI,EAAE,iBAAiB;QACvB,qBAAqB,EAAE,GAAG,EAAE;YAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,OAAO;gBAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/journal-manager-lifecycle.d.ts

@@ -1,11 +0,0 @@
-import type { DurableJournal } from "@claudexor/journal";
-export type JournalManagerFault = "afterQuarantineRename" | "afterQuarantineReceipt" | "beforeArchiveRename" | "beforeProjectionActivation";
-export type JournalManagerLifecycle = "idle" | "prepared" | "active" | "recovery_required" | "closed";
-export interface JournalManagerOptions {
-    partition?: string;
-    now?: () => Date;
-    faults?: Partial<Record<JournalManagerFault, () => void>>;
-    /** Called after projection recovery; the exact journal object owns this generation. */
-    requestMaintenance?: (journal: DurableJournal) => void;
-}
-//# sourceMappingURL=journal-manager-lifecycle.d.ts.map

package/dist/journal-manager-lifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"journal-manager-lifecycle.d.ts","sourceRoot":"","sources":["../src/journal-manager-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,wBAAwB,GACxB,qBAAqB,GACrB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,uBAAuB,GACjC,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAC1D,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACxD"}

package/dist/journal-manager-lifecycle.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=journal-manager-lifecycle.js.map

package/dist/journal-manager-lifecycle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"journal-manager-lifecycle.js","sourceRoot":"","sources":["../src/journal-manager-lifecycle.ts"],"names":[],"mappings":""}

package/dist/journal-manager.d.ts

@@ -1,99 +0,0 @@
-import { type ControlJournalExportReceipt, type ControlJournalInspection, type ControlJournalQuarantineReceipt, type ControlJournalValidation } from "@claudexor/schema";
-import { type JournalQuarantineRequest } from "./journal-recovery-operation.js";
-import type { JournalProjectionDescriptor, JournalProjectionSlot } from "./journal-projection.js";
-import type { JournalManagerOptions } from "./journal-manager-lifecycle.js";
-export type { JournalProjectionDescriptor, JournalProjectionSlot } from "./journal-projection.js";
-export type { JournalManagerOptions } from "./journal-manager-lifecycle.js";
-export type { JournalQuarantineRequest } from "./journal-recovery-operation.js";
-export interface JournalManagerPreparation {
-    partition: string;
-    coverage: "complete";
-    inspection: ControlJournalInspection;
-    validation: ControlJournalValidation;
-    preparationFingerprint: string;
-    virtual: boolean;
-}
-export declare class JournalManager {
-    private readonly options;
-    readonly rootDir: string;
-    readonly partition: string;
-    readonly journalRoot: string;
-    readonly partitionDir: string;
-    private readonly operationsDir;
-    private readonly quarantineDir;
-    private readonly artifactPrefix;
-    private readonly now;
-    private readonly faults;
-    private readonly registrations;
-    private readonly journalOptions;
-    private journal;
-    private recovery;
-    private generationValue;
-    private preparedOperation;
-    private preparationResult;
-    private lifecycle;
-    constructor(rootDir: string, options?: JournalManagerOptions);
-    registerProjection<T>(descriptor: JournalProjectionDescriptor<T>): JournalProjectionSlot<T>;
-    start(): ControlJournalInspection;
-    prepare(): JournalManagerPreparation;
-    revalidatePreparation(): void;
-    activatePrepared(): void;
-    recoverAfterStartup(): void;
-    inspect(): ControlJournalInspection;
-    ready(): boolean;
-    validate(): ControlJournalValidation;
-    events(afterCursor?: string): {
-        schemaVersion: 1;
-        cursor: string;
-        partition: string;
-        type: string;
-        observedAt: string;
-        payload?: unknown;
-    }[];
-    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): ControlJournalQuarantineReceipt;
-    close(): void;
-    /**
-     * Close the partition's generation and rename it into journal-archived/, never
-     * delete history. Missing source returns an existing archive path or null;
-     * a pre-existing archive for a re-registered id is preserved under a suffix.
-     */
-    archivePartition(): string | null;
-    /**
-     * Roll a just-archived partition back into the active journal tree — the
-     * removeProject rollback when the durable registry `unregister` fails AFTER a
-     * successful archive (Ф2 finding 4). Moves `archivedPath` back to
-     * `partitionDir` and reopens a fresh generation so the partition is usable
-     * again. Throws (leaving the archive in place) when the active slot is already
-     * occupied, so the caller can disclose the unrecoverable partial state.
-     */
-    restoreArchivedPartition(archivedPath: string): void;
-    private openGeneration;
-    private resume;
-    private completeFromReceipt;
-    private reconcilePrepared;
-    private inspection;
-    private enterRecovery;
-    private observeFingerprint;
-    private stableFingerprint;
-    private clearSlots;
-    private assertStarted;
-    private assertOpen;
-}
-//# sourceMappingURL=journal-manager.d.ts.map

package/dist/journal-manager.d.ts.map

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