@cleocode/core 2026.9.7 → 2026.9.9

package/dist/store/background-ops.js

@@ -27,41 +27,485 @@
  * @task T10490
  * @see packages/core/src/store/__tests__/test-db-helper.ts (flush wiring)
  */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { isAbsolute } from 'node:path';
+import { registerTeardownAbort } from '../teardown-signal.js';
 /** Promises for best-effort background work that has not yet settled. */
 const inFlight = new Set();
+const backgroundCommitBoundary = new AsyncLocalStorage();
 /**
- * Register a best-effort background promise so a later {@link awaitBackgroundOps}
- * can flush it. The promise is wrapped so a rejection never escapes the
- * registry (callers keep their own `.catch`); the wrapper removes itself from
- * the set once settled.
- *
- * @param op - the detached best-effort promise to track
+ * Stage lazy effects until the supplied transaction has actually committed.
+ * @typeParam T - Committed transaction result.
+ * @param native - Existing writer handle whose nested savepoints share this boundary.
+ * @param commit - Existing transaction implementation, including commit or rollback.
+ * @param execution - Existing captured budget; never replaced with a fresh context.
+ * @param schedule - Existing writer queue admission for committed effects.
+ * @returns The original committed result; deferred failures never undo it.
+ * @remarks Call around the actual transaction, not an individual row write. Nested
+ * successful savepoints transfer effects to their parent; rollback discards them.
+ * This adds no deadline and never executes eager promises again.
+ * @example
+ * ```ts
+ * await withBackgroundOpCommitBoundary(native, () => executeTransaction());
+ * ```
  */
-export function trackBackgroundOp(op) {
-    const tracked = Promise.resolve(op).catch(() => {
-        /* Best-effort — the caller owns error handling; never reject the registry. */
-    });
+export async function withBackgroundOpCommitBoundary(native, commit, execution, schedule) {
+    const inherited = backgroundCommitBoundary.getStore();
+    const parent = inherited?.active && inherited.native === native ? inherited : undefined;
+    const boundary = {
+        native,
+        execution: execution ?? parent?.execution,
+        schedule: schedule ?? parent?.schedule,
+        parent,
+        active: true,
+        deferred: [],
+    };
+    try {
+        const result = await backgroundCommitBoundary.run(boundary, commit);
+        boundary.active = false;
+        if (parent)
+            parent.deferred.push(...boundary.deferred);
+        else
+            for (const operation of boundary.deferred)
+                operation.start();
+        return result;
+    }
+    catch (error) {
+        boundary.active = false;
+        boundary.rollback = new Error('Background operation discarded because its transaction rolled back', { cause: error });
+        for (const operation of boundary.deferred)
+            operation.discard(boundary.rollback);
+        throw error;
+    }
+}
+/**
+ * Track an eager legacy promise or defer a lazy effect until outer transaction commit.
+ * @param op - Existing promise, or lazy operation that must not run before commit.
+ * @param execution - Optional original budget, otherwise inherited from the transaction.
+ * @returns An inspectable settled result, including rollback, cancellation and failures.
+ * @remarks Lazy work retains captured async context and the original execution budget.
+ * The registry counts staged work as pending. Eager promises have already started
+ * and cannot gain rollback safety. Results are process-local, not durable job receipts.
+ * @example
+ * ```ts
+ * const outcome = trackBackgroundOp(() => writeProjection());
+ * const result = await outcome;
+ * ```
+ */
+export function trackBackgroundOp(op, execution) {
+    const completion = Promise.withResolvers();
+    const tracked = completion.promise;
     inFlight.add(tracked);
-    void tracked.finally(() => {
-        inFlight.delete(tracked);
-    });
+    void tracked.then(() => inFlight.delete(tracked));
+    const settle = (work) => {
+        void work.then(() => completion.resolve({ status: 'fulfilled', value: undefined }), (reason) => completion.resolve({ status: 'rejected', reason }));
+    };
+    if (typeof op !== 'function') {
+        settle(op);
+        return tracked;
+    }
+    const resume = AsyncLocalStorage.snapshot();
+    const capturedBoundary = backgroundCommitBoundary.getStore();
+    const capturedExecution = execution ?? capturedBoundary?.execution;
+    const schedule = capturedBoundary?.schedule;
+    let started = false;
+    const operation = {
+        start() {
+            if (started)
+                return;
+            started = true;
+            settle(Promise.resolve().then(() => resume(() => {
+                capturedExecution?.assertActive();
+                const invoke = async () => {
+                    capturedExecution?.assertActive();
+                    return op();
+                };
+                return schedule ? schedule(invoke) : invoke();
+            })));
+        },
+        discard(error) {
+            if (started)
+                return;
+            started = true;
+            completion.resolve({ status: 'rejected', reason: error });
+        },
+    };
+    let boundary = backgroundCommitBoundary.getStore();
+    while (boundary && !boundary.active) {
+        if (boundary.rollback) {
+            operation.discard(boundary.rollback);
+            return tracked;
+        }
+        boundary = boundary.parent;
+    }
+    if (boundary)
+        boundary.deferred.push(operation);
+    else
+        operation.start();
+    return tracked;
 }
 /**
  * Await every currently in-flight background op, then return. Safe to call
  * repeatedly and when nothing is pending. Loops until the set drains so an op
  * that schedules further tracked work during the flush is also awaited.
+ * @remarks This legacy barrier can wait indefinitely on any one promise. It is
+ * not the foreground maintenance budget or proof that untracked work stopped.
+ * @example
+ * ```ts
+ * await awaitBackgroundOps();
+ * ```
  */
 export async function awaitBackgroundOps() {
-    // Bound the drain so a pathological self-rescheduling op cannot spin forever.
+    if (backgroundCommitBoundary.getStore()?.active) {
+        throw new Error('Cannot drain background work before its transaction commits');
+    }
+    // Bound rescheduling rounds only; a round itself can wait indefinitely.
     for (let i = 0; i < 100 && inFlight.size > 0; i++) {
         await Promise.allSettled(Array.from(inFlight));
     }
 }
 /**
  * Number of background ops currently in flight. Diagnostic/test use — assert it
- * is `0` after a flush to prove no detached promise survives a test boundary.
+ * is `0` after a flush to account for the tracked subset at a test boundary.
+ * @returns Number of registered, unsettled promises.
+ * @remarks Unregistered work is not included in this count.
+ * @example
+ * ```ts
+ * const pending = pendingBackgroundOpCount();
+ * ```
  */
 export function pendingBackgroundOpCount() {
     return inFlight.size;
 }
+/**
+ * Stable refusal at a cooperating operation boundary.
+ * @remarks A refusal does not roll back work already committed by another stage.
+ * @example
+ * ```ts
+ * if (error instanceof OperationExecutionError) record(error.code);
+ * ```
+ */
+export class OperationExecutionError extends Error {
+    /** Machine-readable reason that a new stage was refused. */
+    code;
+    /**
+     * Construct a boundary refusal.
+     * @param code - Stable cancellation/deadline/limit reason.
+     * @param message - Specific diagnostic for the caller.
+     */
+    constructor(code, message) {
+        super(message);
+        this.name = 'OperationExecutionError';
+        this.code = code;
+    }
+}
+/**
+ * Capture one immutable scope and cooperative foreground lifetime.
+ * @param identity - Explicit routing and caller identity, captured before awaiting.
+ * @param options - Shared deadline, caller cancellation and admission limits.
+ * @returns One context to pass unchanged through nested stages; close it in finally.
+ * @remarks The timer requests cancellation; boundary checks independently inspect
+ * wall time. Neither can preempt synchronous work. Resource limits count declared
+ * bytes/items, not actual process memory. This creates no executor or background job.
+ * @example
+ * ```ts
+ * const context = createOperationExecutionContext(identity, { budgetMs: 2000 });
+ * try { context.assertActive(); await inspect(context); }
+ * finally { context.close(); }
+ * ```
+ */
+export function createOperationExecutionContext(identity, options = {}) {
+    for (const key of ['projectId', 'projectRoot', 'actor', 'operation', 'idempotencyKey']) {
+        const value = identity[key];
+        if (typeof value !== 'string' || value.trim().length === 0)
+            throw new TypeError(`Operation ${key} must be a nonempty string`);
+    }
+    if (!isAbsolute(identity.projectRoot))
+        throw new TypeError('Operation projectRoot must be absolute');
+    const budgetMs = options.budgetMs ?? 2000;
+    if (!Number.isSafeInteger(budgetMs) || budgetMs < 0)
+        throw new TypeError('Operation budgetMs must be a nonnegative safe integer');
+    if (options.deadlineAt !== undefined && !Number.isSafeInteger(options.deadlineAt))
+        throw new TypeError('Operation deadlineAt must be a safe integer');
+    const resources = Object.freeze({ ...options.resources });
+    for (const value of Object.values(resources)) {
+        if (value !== undefined && (!Number.isSafeInteger(value) || value < 0))
+            throw new TypeError('Operation resource limits must be nonnegative safe integers');
+    }
+    const deadlineAt = Math.min(Date.now() + budgetMs, options.deadlineAt ?? Infinity);
+    if (!Number.isSafeInteger(deadlineAt))
+        throw new TypeError('Operation deadline exceeds safe range');
+    const writeFence = captureWriteFence(options.writeFence);
+    const callerSignal = options.signal;
+    const controller = new AbortController();
+    let bytes = 0;
+    let items = 0;
+    let closed = false;
+    let timer;
+    const stop = (code, message) => {
+        if (!controller.signal.aborted)
+            controller.abort(new OperationExecutionError(code, message));
+    };
+    const cancel = () => stop('E_OPERATION_CANCELLED', 'Operation cancelled by its caller');
+    const expire = () => stop('E_OPERATION_DEADLINE', 'Shared operation deadline reached');
+    const remainingMs = () => {
+        const remaining = Math.max(0, deadlineAt - Date.now());
+        if (remaining === 0)
+            expire();
+        return remaining;
+    };
+    const assertActive = () => {
+        if (closed)
+            throw new OperationExecutionError('E_OPERATION_CLOSED', 'Operation scope is closed');
+        remainingMs();
+        if (controller.signal.aborted) {
+            const reason = controller.signal.reason;
+            throw reason instanceof OperationExecutionError
+                ? reason
+                : new OperationExecutionError('E_OPERATION_CANCELLED', 'Operation cancelled during teardown');
+        }
+    };
+    const consume = (usage) => {
+        assertActive();
+        const addBytes = usage.bytes ?? 0;
+        const addItems = usage.items ?? 0;
+        if (!Number.isSafeInteger(addBytes) ||
+            addBytes < 0 ||
+            !Number.isSafeInteger(addItems) ||
+            addItems < 0)
+            throw new TypeError('Operation resource usage must be nonnegative safe integers');
+        const nextBytes = bytes + addBytes;
+        const nextItems = items + addItems;
+        if (!Number.isSafeInteger(nextBytes) ||
+            !Number.isSafeInteger(nextItems) ||
+            nextBytes > (resources.maxBytes ?? Infinity) ||
+            nextItems > (resources.maxItems ?? Infinity)) {
+            stop('E_OPERATION_RESOURCE_LIMIT', 'Operation resource admission limit exceeded');
+            assertActive();
+        }
+        bytes = nextBytes;
+        items = nextItems;
+    };
+    const deregister = registerTeardownAbort(controller);
+    callerSignal?.addEventListener('abort', cancel, { once: true });
+    if (callerSignal?.aborted)
+        cancel();
+    // setTimeout cannot represent arbitrary long deadlines. Recheck instead of
+    // allowing overflow to cancel a long-lived explicitly bounded invocation early.
+    const schedule = () => {
+        const remaining = remainingMs();
+        if (remaining > 0 && !controller.signal.aborted && !closed) {
+            timer = setTimeout(schedule, Math.min(remaining, 2_147_483_647));
+            timer.unref();
+        }
+    };
+    schedule();
+    return Object.freeze({
+        identity: Object.freeze({ ...identity }),
+        ...(writeFence ? { writeFence } : {}),
+        deadlineAt,
+        signal: controller.signal,
+        resources,
+        remainingMs,
+        assertActive,
+        consume,
+        close: () => {
+            if (closed)
+                return;
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            callerSignal?.removeEventListener('abort', cancel);
+            deregister();
+            stop('E_OPERATION_CLOSED', 'Operation scope is closed');
+        },
+    });
+}
+/** Copy and validate an optional authority reference without admitting work. */
+function captureWriteFence(input) {
+    const writeFence = input
+        ? Object.freeze({
+            ...input,
+            lease: Object.freeze({ ...input.lease }),
+        })
+        : undefined;
+    if (writeFence &&
+        (!isAbsolute(writeFence.dbPath) ||
+            !/^[a-f0-9]{64}$/.test(writeFence.proposalHash) ||
+            !writeFence.lease.jobId?.trim() ||
+            !writeFence.lease.ownerId?.trim() ||
+            !Number.isSafeInteger(writeFence.lease.epoch) ||
+            writeFence.lease.epoch < 1 ||
+            !Number.isSafeInteger(writeFence.lease.expiresAt) ||
+            writeFence.lease.expiresAt <= 0))
+        throw new TypeError('Invalid operation write fence');
+    return writeFence;
+}
+/**
+ * Bind a newly claimed job fence without replacing the caller's lifetime or budget.
+ * @param context - Original captured operation whose accounting remains authoritative.
+ * @param writeFence - Persisted attempt reference to check at domain write boundaries.
+ * @param allowCancelledOutcome - Permit an already cancelled scope solely for bounded outcome bookkeeping.
+ * @returns Immutable scoped view sharing the original deadline, cancellation and accounting.
+ * @throws Error if the scope is inactive, already fenced, or the reference is malformed.
+ * @remarks This does not renew a lease or authorize mutation. Binding changes only
+ * the immutable authority reference; closing either view invalidates both. The
+ * outcome option requires an aborted signal and remaining deadline/lease time,
+ * preserves the original failing domain guards, and does not prove persisted ownership.
+ * @example
+ * ```ts
+ * const guarded = bindOperationWriteFence(context, fence);
+ * await existingDomainOperation(guarded);
+ * ```
+ */
+export function bindOperationWriteFence(context, writeFence, allowCancelledOutcome = false) {
+    if (typeof allowCancelledOutcome !== 'boolean')
+        throw new TypeError('Outcome binding requires an explicit boolean');
+    if (context.writeFence)
+        throw new Error('Operation already has an immutable write fence');
+    const captured = captureWriteFence(writeFence);
+    if (!captured)
+        throw new TypeError('A claimed operation write fence is required');
+    if (allowCancelledOutcome) {
+        if (Date.now() >= context.deadlineAt)
+            throw new OperationExecutionError('E_OPERATION_DEADLINE', 'Outcome binding deadline elapsed');
+        if (!context.signal.aborted)
+            throw new TypeError('Outcome-only binding requires an already cancelled operation');
+        if (captured.lease.expiresAt <= Date.now())
+            throw new TypeError('Outcome binding lease reference expired');
+    }
+    else
+        context.assertActive();
+    return Object.freeze({ ...context, writeFence: captured });
+}
+/**
+ * Observe supplied work until it settles or the shared scope is cancelled.
+ * @typeParam T - Supplied promise's result type.
+ * @param context - Existing operation context; this does not start a new budget.
+ * @param work - Already accepted work whose outcome is being observed.
+ * @returns Actual settlement or an explicit unresolved observation, never fake cancellation.
+ * @remarks The underlying promise may continue. Its rejection remains handled,
+ * but preventing later writes requires guarded executor/chokepoint boundaries.
+ * A synchronous overrun is reported after returning control, not called preemption.
+ * @example
+ * ```ts
+ * const observed = await observeOperation(context, verification);
+ * if (!observed.settled) reportPending(operationId);
+ * ```
+ */
+export function observeOperation(context, work) {
+    return new Promise((resolve) => {
+        let observed = false;
+        const finish = (result) => {
+            if (observed)
+                return;
+            observed = true;
+            context.signal.removeEventListener('abort', abort);
+            resolve(result);
+        };
+        const abort = () => {
+            const reason = context.signal.reason;
+            finish({
+                settled: false,
+                reason: reason instanceof OperationExecutionError ? reason.code : 'E_OPERATION_CANCELLED',
+                deadlineExceeded: Date.now() >= context.deadlineAt,
+            });
+        };
+        void work.then((value) => finish({
+            settled: true,
+            success: true,
+            value,
+            deadlineExceeded: Date.now() >= context.deadlineAt,
+        }), (error) => finish({
+            settled: true,
+            success: false,
+            error: error instanceof Error ? error : new Error(String(error)),
+            deadlineExceeded: Date.now() >= context.deadlineAt,
+        }));
+        context.signal.addEventListener('abort', abort, { once: true });
+        if (context.signal.aborted)
+            abort();
+    });
+}
+/**
+ * Reserve a worker stage in the original resource budget and link cancellation.
+ * @param context - Origin-owned operation context.
+ * @param usage - Complete declared stage admission charged before the transfer exists.
+ * @returns Structured-cloneable scope and listener cleanup owned by the originating caller.
+ * @remarks The shared flag is cooperative evidence, not synchronous preemption or
+ * permission to write. Executors still validate domain fences at the commit boundary.
+ * Release only after observing actual completion or explicitly reporting unresolved work.
+ * @example
+ * ```ts
+ * const usage = { bytes: payloadBytes, items: 1 };
+ * const link = transferOperationContext(context, usage);
+ * try { await existingWorker.enqueue(link.transfer); } finally { link.release(); }
+ * ```
+ */
+export function transferOperationContext(context, usage) {
+    context.consume(usage);
+    const cancellation = new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT);
+    const state = new Int32Array(cancellation);
+    const cancel = () => {
+        Atomics.store(state, 0, 1);
+    };
+    context.signal.addEventListener('abort', cancel, { once: true });
+    if (context.signal.aborted)
+        cancel();
+    return Object.freeze({
+        transfer: Object.freeze({
+            identity: context.identity,
+            ...(context.writeFence ? { writeFence: context.writeFence } : {}),
+            deadlineAt: context.deadlineAt,
+            cancellation,
+        }),
+        release: () => {
+            cancel();
+            context.signal.removeEventListener('abort', cancel);
+        },
+    });
+}
+/**
+ * Receive an admitted worker scope without granting another resource budget.
+ * @param transfer - Serialized identity/deadline plus the origin-owned cancellation flag.
+ * @returns Cooperating worker context with no additional byte/item admission allowance.
+ * @throws TypeError - Malformed shared cancellation storage or identity/deadline.
+ * @remarks The origin must reserve the complete stage before sending it. Positive
+ * receiver resource charges refuse rather than reset the original aggregate limits.
+ * A busy worker observes cancellation when it next checks a boundary; a committed
+ * result must still be reported as committed if cancellation arrives afterwards.
+ * @example
+ * ```ts
+ * const context = receiveOperationContext(envelope.execution);
+ * try { context.assertActive(); await existingHandler(context); } finally { context.close(); }
+ * ```
+ */
+export function receiveOperationContext(transfer) {
+    if (!(transfer.cancellation instanceof SharedArrayBuffer) ||
+        transfer.cancellation.byteLength !== Int32Array.BYTES_PER_ELEMENT) {
+        throw new TypeError('Invalid operation cancellation transfer');
+    }
+    const state = new Int32Array(transfer.cancellation);
+    const controller = new AbortController();
+    const context = createOperationExecutionContext(transfer.identity, {
+        deadlineAt: transfer.deadlineAt,
+        writeFence: transfer.writeFence,
+        budgetMs: Math.max(0, transfer.deadlineAt - Date.now()),
+        signal: controller.signal,
+        resources: { maxBytes: 0, maxItems: 0 },
+    });
+    const assertActive = () => {
+        if (Atomics.load(state, 0) !== 0)
+            controller.abort();
+        context.assertActive();
+    };
+    return Object.freeze({
+        ...context,
+        assertActive,
+        consume: (usage) => {
+            assertActive();
+            context.consume(usage);
+        },
+    });
+}
 //# sourceMappingURL=background-ops.js.map

package/dist/store/background-ops.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-ops.js","sourceRoot":"","sources":["../../src/store/background-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,yEAAyE;AACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAoB;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAC7C,8EAA8E;IAChF,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;QACxB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,8EAA8E;IAC9E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}
+{"version":3,"file":"background-ops.js","sourceRoot":"","sources":["../../src/store/background-ops.ts"],"names":[],"mappings":"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"}

package/dist/store/backup-inspect.d.ts

@@ -1,11 +1,13 @@
 /**
  * Backup bundle inspect primitives (SDK).
  *
- * Pure manifest-parsing helpers extracted from
+ * Manifest parsing helpers and exact read-only observation inspection.
+ *
+ * Manifest helpers were extracted from
  * `packages/cleo/src/cli/commands/backup-inspect.ts` per the AGENTS.md
- * Package-Boundary Check (T9985 / E8-CLI-LAYERING). These functions never
- * touch process state, citty, or any CLI renderer — they read raw buffers
- * and return values, so they are unit-testable without spinning up the CLI.
+ * Package-Boundary Check (T9985 / E8-CLI-LAYERING). The snapshot inspector
+ * accepts explicit paths, validates a private copy through the canonical opener,
+ * and returns provenance without live-store routing or CLI rendering.
  *
  * The CLI command file retains the orchestrator (`inspectAction`,
  * `inspectTarball`, `printInspectReport`) because those bind to
@@ -18,6 +20,7 @@
  * @saga T9977 (SG-WORKTRUNK-OWN)
  * @see packages/cleo/src/cli/commands/backup-inspect.ts — CLI orchestrator
  */
+import type { BackupObservationInspectFailure, BackupObservationInspection, BackupObservationInspectOptions } from '@cleocode/contracts/backup-manifest';
 /** Magic string that identifies a CLEO encrypted bundle (ASCII "CLEOENC1"). */
 export declare const CLEO_ENC_MAGIC = "CLEOENC1";
 /** Byte offset of the format-version byte in the encrypted header. */
@@ -75,4 +78,45 @@ export declare function fmtBytes(bytes: number): string;
  * @public
  */
 export declare function detectEncryption(filePath: string): boolean;
+/**
+ * Explicit inspection failure; callers must not translate this into not-found.
+ *
+ * @remarks
+ * The code describes a refusal or failed diagnostic within the requested snapshot
+ * scope. It does not establish whether the historical record exists elsewhere.
+ */
+export declare class BackupObservationInspectionError extends Error {
+    readonly code: BackupObservationInspectFailure;
+    /**
+     * Construct a scoped inspection diagnostic.
+     * @param code - Stable failure category.
+     * @param message - Specific refusal or observed failure.
+     * @remarks No error category establishes absence of the requested record.
+     * @example
+     * ```ts
+     * throw new BackupObservationInspectionError('SOURCE_CHANGED', 'Snapshot changed during copy.');
+     * ```
+     */
+    constructor(code: BackupObservationInspectFailure, message: string);
+}
+/**
+ * Inspect one exact historical observation without opening or restoring a live store.
+ * @param options - Explicit snapshot identity, record ID and byte ceilings.
+ * @returns Scoped authentic payload and provenance, or scoped not-found.
+ * @throws BackupObservationInspectionError - The source, schema, identity or bounds are unproven.
+ * @remarks Linux O_NOFOLLOW protects source identity; O_NOATIME is requested as a
+ * best effort. Access-time changes are reported separately from content changes and
+ * never restored. Unsupported platforms fail explicitly. Queries are synchronous
+ * and are not claimed to be preemptible;
+ * source/payload sizes and indexed exact lookups bound the accepted workload.
+ * @example
+ * ```ts
+ * const evidence = await inspectBackupObservation({
+ *   snapshotPath: '/authorized/backups/tasks-20260919-120000.db',
+ *   recordId: 'O-mspmgvbg-0',
+ * });
+ * // evidence.status concerns only evidence.inspectedTables in this snapshot.
+ * ```
+ */
+export declare function inspectBackupObservation(options: BackupObservationInspectOptions): Promise<BackupObservationInspection>;
 //# sourceMappingURL=backup-inspect.d.ts.map

package/dist/store/backup-inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup-inspect.d.ts","sourceRoot":"","sources":["../../src/store/backup-inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,+EAA+E;AAC/E,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,IAAO,CAAC;AAE1C,4FAA4F;AAC5F,eAAO,MAAM,cAAc,QAA2B,CAAC;AAwBvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgDpE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsB1F;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS1D"}
+{"version":3,"file":"backup-inspect.d.ts","sourceRoot":"","sources":["../../src/store/backup-inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EACV,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAGhC,MAAM,qCAAqC,CAAC;AAO7C,+EAA+E;AAC/E,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,IAAO,CAAC;AAE1C,4FAA4F;AAC5F,eAAO,MAAM,cAAc,QAA2B,CAAC;AAwBvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgDpE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsB1F;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS1D;AAED;;;;;;GAMG;AACH,qBAAa,gCAAiC,SAAQ,KAAK;aAYvC,IAAI,EAAE,+BAA+B;IAXvD;;;;;;;;;OASG;gBAEe,IAAI,EAAE,+BAA+B,EACrD,OAAO,EAAE,MAAM;CAKlB;AAkKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,2BAA2B,CAAC,CAsOtC"}