@origintrail-official/dkg-agent 10.0.13 → 10.0.15

package/dist/active-public-context-graph-chain-proof.d.ts

@@ -0,0 +1,22 @@
+import type { OperationContext } from '@origintrail-official/dkg-core';
+export type ActivePublicContextGraphChainProof = {
+    state: 'public';
+} | {
+    state: 'not-public';
+    reason: 'private' | 'unregistered';
+} | {
+    state: 'unknown';
+    reason: 'unprovable' | 'rpc-failure';
+    detail?: string;
+};
+export type OnChainAccessPolicyState = 0 | 1 | 'unregistered' | 'unknown';
+export type OnChainAccessPolicyStateResolver = (contextGraphId: string, operationContext: OperationContext, options: {
+    slotBindingMode: 'chain-attested-repair';
+}) => Promise<OnChainAccessPolicyState>;
+export type OperationAwareActivePublicChainProofResolver = (contextGraphId: string, operationContext: OperationContext) => Promise<ActivePublicContextGraphChainProof>;
+export type BoundActivePublicChainProofResolver = (operationContext: OperationContext) => Promise<ActivePublicContextGraphChainProof>;
+/** Strict proof boundary: owns binding policy, RPC classification, and state conversion. */
+export declare function resolveActivePublicContextGraphChainProof(resolveOnChainAccessPolicyState: OnChainAccessPolicyStateResolver, contextGraphId: string, operationContext: OperationContext): Promise<ActivePublicContextGraphChainProof>;
+/** Bind one lazy proof promise to one normalized graph for repair + confirmation reuse. */
+export declare function memoizeActivePublicContextGraphChainProof(contextGraphId: string, resolveProof: OperationAwareActivePublicChainProofResolver): BoundActivePublicChainProofResolver;
+//# sourceMappingURL=active-public-context-graph-chain-proof.d.ts.map

package/dist/active-public-context-graph-chain-proof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-public-context-graph-chain-proof.d.ts","sourceRoot":"","sources":["../src/active-public-context-graph-chain-proof.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,MAAM,kCAAkC,GAC1C;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAAA;CAAE,GAC3D;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,CAAC,GAAG,cAAc,GAAG,SAAS,CAAC;AAE1E,MAAM,MAAM,gCAAgC,GAAG,CAC7C,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,gBAAgB,EAClC,OAAO,EAAE;IAAE,eAAe,EAAE,uBAAuB,CAAA;CAAE,KAClD,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEvC,MAAM,MAAM,4CAA4C,GAAG,CACzD,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,gBAAgB,KAC/B,OAAO,CAAC,kCAAkC,CAAC,CAAC;AAEjD,MAAM,MAAM,mCAAmC,GAAG,CAChD,gBAAgB,EAAE,gBAAgB,KAC/B,OAAO,CAAC,kCAAkC,CAAC,CAAC;AAEjD,4FAA4F;AAC5F,wBAAsB,yCAAyC,CAC7D,+BAA+B,EAAE,gCAAgC,EACjE,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,kCAAkC,CAAC,CAqB7C;AAED,2FAA2F;AAC3F,wBAAgB,yCAAyC,CACvD,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,4CAA4C,GACzD,mCAAmC,CAMrC"}

package/dist/active-public-context-graph-chain-proof.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: Apache-2.0
+/** Strict proof boundary: owns binding policy, RPC classification, and state conversion. */
+export async function resolveActivePublicContextGraphChainProof(resolveOnChainAccessPolicyState, contextGraphId, operationContext) {
+    let state;
+    try {
+        state = await resolveOnChainAccessPolicyState(contextGraphId, operationContext, { slotBindingMode: 'chain-attested-repair' });
+    }
+    catch (error) {
+        return {
+            state: 'unknown',
+            reason: 'rpc-failure',
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+    if (state === 0)
+        return { state: 'public' };
+    if (state === 1)
+        return { state: 'not-public', reason: 'private' };
+    if (state === 'unregistered') {
+        return { state: 'not-public', reason: 'unregistered' };
+    }
+    return { state: 'unknown', reason: 'unprovable' };
+}
+/** Bind one lazy proof promise to one normalized graph for repair + confirmation reuse. */
+export function memoizeActivePublicContextGraphChainProof(contextGraphId, resolveProof) {
+    let proof;
+    return (operationContext) => {
+        proof ??= resolveProof(contextGraphId, operationContext);
+        return proof;
+    };
+}
+//# sourceMappingURL=active-public-context-graph-chain-proof.js.map

package/dist/active-public-context-graph-chain-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-public-context-graph-chain-proof.js","sourceRoot":"","sources":["../src/active-public-context-graph-chain-proof.ts"],"names":[],"mappings":"AAAA,sCAAsC;AA0BtC,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAC7D,+BAAiE,EACjE,cAAsB,EACtB,gBAAkC;IAElC,IAAI,KAA+B,CAAC;IACpC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,+BAA+B,CAC3C,cAAc,EACd,gBAAgB,EAChB,EAAE,eAAe,EAAE,uBAAuB,EAAE,CAC7C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC/D,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC5C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACnE,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yCAAyC,CACvD,cAAsB,EACtB,YAA0D;IAE1D,IAAI,KAA8D,CAAC;IACnE,OAAO,CAAC,gBAAgB,EAAE,EAAE;QAC1B,KAAK,KAAK,YAAY,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/bounded-operation.d.ts

@@ -0,0 +1,23 @@
+/** A timeout raised by {@link runBoundedOperation}. */
+export declare class BoundedOperationTimeoutError extends Error {
+    readonly operationLabel: string;
+    readonly timeoutMs: number;
+    readonly code = "BOUNDED_OPERATION_TIMEOUT";
+    constructor(operationLabel: string, timeoutMs: number);
+}
+export declare function isBoundedOperationTimeoutError(error: unknown): error is BoundedOperationTimeoutError;
+export declare function createAbortError(reason: unknown): Error;
+/**
+ * Run one lazily-started operation with a caller-abort and deadline boundary.
+ *
+ * The operation is not started when the caller is already aborted. Once it is
+ * started it receives a signal that aborts with either boundary. Late
+ * fulfillment or rejection is consumed after timeout/abort so a non-cooperative
+ * dependency cannot create an unhandled rejection.
+ */
+export declare function runBoundedOperation<T>(start: (signal: AbortSignal) => T | PromiseLike<T>, options: {
+    timeoutMs: number;
+    label: string;
+    signal?: AbortSignal;
+}): Promise<T>;
+//# sourceMappingURL=bounded-operation.d.ts.map

package/dist/bounded-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-operation.d.ts","sourceRoot":"","sources":["../src/bounded-operation.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,qBAAa,4BAA6B,SAAQ,KAAK;IAInD,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAJ5B,QAAQ,CAAC,IAAI,+BAA+B;gBAGjC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM;CAK7B;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAMvC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAWvD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAClD,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,CAAC,CAAC,CA2DZ"}

package/dist/bounded-operation.js

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: Apache-2.0
+/** A timeout raised by {@link runBoundedOperation}. */
+export class BoundedOperationTimeoutError extends Error {
+    operationLabel;
+    timeoutMs;
+    code = 'BOUNDED_OPERATION_TIMEOUT';
+    constructor(operationLabel, timeoutMs) {
+        super(`${operationLabel} timed out after ${timeoutMs}ms`);
+        this.operationLabel = operationLabel;
+        this.timeoutMs = timeoutMs;
+        this.name = 'BoundedOperationTimeoutError';
+    }
+}
+export function isBoundedOperationTimeoutError(error) {
+    return error instanceof BoundedOperationTimeoutError
+        || (error instanceof Error
+            && error.code === 'BOUNDED_OPERATION_TIMEOUT');
+}
+export function createAbortError(reason) {
+    if (reason instanceof Error) {
+        if (reason.name === 'AbortError')
+            return reason;
+        const error = new Error(reason.message || 'aborted');
+        error.name = 'AbortError';
+        error.cause = reason;
+        return error;
+    }
+    const error = new Error(typeof reason === 'string' ? reason : 'aborted');
+    error.name = 'AbortError';
+    return error;
+}
+/**
+ * Run one lazily-started operation with a caller-abort and deadline boundary.
+ *
+ * The operation is not started when the caller is already aborted. Once it is
+ * started it receives a signal that aborts with either boundary. Late
+ * fulfillment or rejection is consumed after timeout/abort so a non-cooperative
+ * dependency cannot create an unhandled rejection.
+ */
+export function runBoundedOperation(start, options) {
+    const { timeoutMs, label, signal } = options;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        return Promise.reject(new RangeError('timeoutMs must be a positive finite number'));
+    }
+    if (signal?.aborted)
+        return Promise.reject(createAbortError(signal.reason));
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let timer;
+        const operationController = new AbortController();
+        const finish = (complete) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+            complete();
+        };
+        const abortOperation = (reason) => {
+            if (!operationController.signal.aborted)
+                operationController.abort(reason);
+        };
+        const onAbort = () => {
+            const error = createAbortError(signal?.reason);
+            abortOperation(signal?.reason ?? error);
+            finish(() => reject(error));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        timer = setTimeout(() => {
+            const error = new BoundedOperationTimeoutError(label, timeoutMs);
+            abortOperation(error);
+            finish(() => reject(error));
+        }, timeoutMs);
+        timer.unref?.();
+        // Cover an abort between the initial check and listener registration
+        // without starting dependency work.
+        if (signal?.aborted) {
+            onAbort();
+            return;
+        }
+        let work;
+        try {
+            work = Promise.resolve(start(operationController.signal));
+        }
+        catch (error) {
+            finish(() => reject(error));
+            return;
+        }
+        work.catch(() => {
+            // The boundary may already have rejected on timeout or caller abort.
+        });
+        work.then((value) => finish(() => resolve(value)), (error) => finish(() => reject(error)));
+    });
+}
+//# sourceMappingURL=bounded-operation.js.map

package/dist/bounded-operation.js.map

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

package/dist/ccl-policy.d.ts

@@ -1,4 +1,11 @@
 import type { Quad } from '@origintrail-official/dkg-storage';
+export type CclMissingResource = 'policy' | 'policy_binding' | 'approved_policy';
+/** A requested CCL resource is absent; safe for HTTP boundaries to map to 404. */
+export declare class CclResourceNotFoundError extends Error {
+    readonly resource: CclMissingResource;
+    readonly code: "CCL_RESOURCE_NOT_FOUND";
+    constructor(resource: CclMissingResource, message: string);
+}
 export interface PublishCclPolicyInput {
     contextGraphId: string;
     name: string;

package/dist/ccl-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ccl-policy.d.ts","sourceRoot":"","sources":["../src/ccl-policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IACpH,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAqCA;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAwBxC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,EAAE,CAOT"}
+{"version":3,"file":"ccl-policy.d.ts","sourceRoot":"","sources":["../src/ccl-policy.ts"],"names":[],"mappings":"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"}

package/dist/ccl-policy.js

@@ -1,5 +1,15 @@
 import { createHash } from 'node:crypto';
 import { DKG_ONTOLOGY, sparqlString } from '@origintrail-official/dkg-core';
+/** A requested CCL resource is absent; safe for HTTP boundaries to map to 404. */
+export class CclResourceNotFoundError extends Error {
+    resource;
+    code = 'CCL_RESOURCE_NOT_FOUND';
+    constructor(resource, message) {
+        super(message);
+        this.resource = resource;
+        this.name = 'CclResourceNotFoundError';
+    }
+}
 export function hashCclPolicy(content) {
     return `sha256:${createHash('sha256').update(content).digest('hex')}`;
 }

package/dist/ccl-policy.js.map

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

package/dist/chain-reconciler.d.ts

@@ -66,6 +66,12 @@ export interface PendingOrdinalRecoveryResult {
      * instead of snapping back to the watermark.
      */
     continuationOrdinal: number | undefined;
+    /**
+     * Recovery has bounded work that should be scheduled immediately. This is
+     * deliberately separate from the ordered scan cursor so implementation-
+     * specific retries cannot starve untouched ordinals.
+     */
+    hasImmediateRecoveryWork: boolean;
     /**
      * True only when recovery intentionally skipped networking because its
      * per-CG cooldown is active. This preserves the continuation without
@@ -96,6 +102,15 @@ export interface ChainReconcilerDeps {
     maxOrdinalsPerPass?: number;
     /** Maximum ordinal reconciliations allowed to run concurrently in one pass. */
     maxOrdinalConcurrency?: number;
+    /**
+     * Number of slots in a bounded pass reserved for the newest outstanding
+     * ordinals. The remaining slots keep advancing the historical scan cursor.
+     *
+     * This is intentionally opt-in. Ordinary member/Core reconciliation keeps
+     * strict oldest-first behaviour, while an explicitly selected cold Edge can
+     * make the current head useful quickly without starving durable history.
+     */
+    recentOrdinalsPerPass?: number;
     /**
      * Fetch one exact batch containing only locally-missing KAs, then re-run
      * local verification for those ordinals. Undefined preserves scan-only
@@ -119,8 +134,15 @@ export interface ReconcileResult {
     reconciled: number;
     pending: number;
     processed: number;
-    /** True when another bounded slice should be queued immediately. */
+    /**
+     * True when the bounded inventory has more work under the historical result
+     * contract. Retained for package-subpath compatibility; new scheduler code
+     * should consume `shouldContinueImmediately` instead.
+     * @deprecated Use `shouldContinueImmediately` for dispatch decisions.
+     */
     hasMore: boolean;
+    /** Canonical two-way scheduling decision after this bounded slice. */
+    shouldContinueImmediately: boolean;
     /** True when this pass stopped because its captured chain binding changed. */
     staleTarget: boolean;
 }

package/dist/chain-reconciler.d.ts.map

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

package/dist/chain-reconciler.js

@@ -24,6 +24,95 @@
  */
 import { recordCompletion, absorbConfirmed, ordinalsToReconcile, } from './reconcile-cursor.js';
 import { VmReconcileQueueClosedError, VmReconcileQueueFullError, } from './vm-reconcile-service.js';
+/**
+ * Normalize the recovery executor's compatibility result once at its boundary.
+ * Cursor and scheduling policy consume this semantic state instead of
+ * independently interpreting the legacy result fields.
+ */
+function recoveryDisposition(result) {
+    if (result.cooldownOnly === true) {
+        return { kind: 'cooldown', continuationOrdinal: result.continuationOrdinal };
+    }
+    if (result.attemptedOrdinals.length === 0)
+        return { kind: 'not-attempted' };
+    if (result.continuationOrdinal !== undefined) {
+        return {
+            kind: 'ordinal-continuation',
+            continuationOrdinal: result.continuationOrdinal,
+        };
+    }
+    if (result.hasImmediateRecoveryWork)
+        return { kind: 'provider-continuation' };
+    return { kind: 'exhausted' };
+}
+/**
+ * Build one bounded ordinal pass without mutating cursor state.
+ *
+ * The recent lane is a latency sample, not a second cursor. Keeping that
+ * distinction explicit prevents a continuation from the recent-first exact
+ * recovery queue from jumping the durable historical scan over older gaps.
+ */
+function planOrdinalPass(candidates, passLimit, requestedRecent, watermark) {
+    const recentCount = Number.isFinite(passLimit) && passLimit >= 2
+        ? Math.min(requestedRecent, passLimit - 1)
+        : 0;
+    let historicalOrdinals;
+    let recentOrdinals = [];
+    if (recentCount > 0 && candidates.length > passLimit) {
+        const historicalCount = passLimit - recentCount;
+        historicalOrdinals = candidates.slice(0, historicalCount);
+        const historicalSet = new Set(historicalOrdinals);
+        recentOrdinals = candidates
+            .slice(-recentCount)
+            .filter((ordinal) => !historicalSet.has(ordinal));
+    }
+    else {
+        historicalOrdinals = candidates.slice(0, passLimit);
+    }
+    const ordinals = [...historicalOrdinals, ...recentOrdinals]
+        .sort((a, b) => a - b);
+    const recentOrdinalSet = new Set(recentOrdinals);
+    const usesRecentLane = recentOrdinals.length > 0;
+    const hasUnvisitedCandidates = candidates.length > ordinals.length;
+    const historicalContinuationOrdinal = historicalOrdinals.length > 0
+        ? historicalOrdinals[historicalOrdinals.length - 1] + 1
+        : watermark;
+    return {
+        historicalOrdinals,
+        recentOrdinals,
+        ordinals,
+        usesRecentLane,
+        hasUnvisitedCandidates,
+        historicalContinuationOrdinal,
+        compareRecoveryTargets: (left, right) => {
+            const leftRecent = recentOrdinalSet.has(left.ordinal);
+            const rightRecent = recentOrdinalSet.has(right.ordinal);
+            if (leftRecent !== rightRecent)
+                return leftRecent ? -1 : 1;
+            return leftRecent ? right.ordinal - left.ordinal : left.ordinal - right.ordinal;
+        },
+        nextScanOrdinal: ({ watermark: currentWatermark, recovery, }) => {
+            if (usesRecentLane) {
+                return hasUnvisitedCandidates
+                    ? Math.max(currentWatermark, historicalContinuationOrdinal)
+                    : currentWatermark;
+            }
+            if (recovery.kind === 'ordinal-continuation') {
+                return Math.max(currentWatermark, recovery.continuationOrdinal);
+            }
+            if (recovery.kind === 'cooldown'
+                && recovery.continuationOrdinal !== undefined) {
+                return Math.max(currentWatermark, recovery.continuationOrdinal);
+            }
+            if (!hasUnvisitedCandidates)
+                return currentWatermark;
+            if (ordinals.length > 0) {
+                return Math.max(currentWatermark, historicalContinuationOrdinal);
+            }
+            return undefined;
+        },
+    };
+}
 /**
  * One bounded sweep slice for a single CG: reconcile up to
  * `maxOrdinalsPerPass` ordinals in `[watermark, head)` (skipping ones already
@@ -47,6 +136,7 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
             pending: 0,
             processed: 0,
             hasMore: false,
+            shouldContinueImmediately: false,
             staleTarget: false,
         };
     }
@@ -71,9 +161,7 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
     let reconciled = 0;
     let processed = 0;
     let staleTarget = false;
-    let recoveryContinuationOrdinal;
-    let recoveryAttempted = false;
-    let recoveryCooldownOnly = false;
+    let recovery = { kind: 'not-attempted' };
     const outstandingBefore = ordinalsToReconcile(state, head);
     const configuredLimit = deps.maxOrdinalsPerPass;
     const passLimit = configuredLimit === undefined
@@ -87,8 +175,11 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
         state.scanOrdinal = state.watermark;
         candidates = outstandingBefore;
     }
-    const ordinals = candidates.slice(0, passLimit);
-    const hasUnvisitedCandidates = candidates.length > ordinals.length;
+    const requestedRecent = Number.isFinite(deps.recentOrdinalsPerPass)
+        ? Math.max(0, Math.floor(deps.recentOrdinalsPerPass ?? 0))
+        : 0;
+    const passPlan = planOrdinalPass(candidates, passLimit, requestedRecent, state.watermark);
+    const { ordinals, hasUnvisitedCandidates, } = passPlan;
     if (headUnavailable) {
         state.scanOrdinal = state.watermark;
     }
@@ -141,9 +232,15 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
         const recoveryTargets = ordinals
             .map((ordinal) => outcomes.get(ordinal))
             .filter((outcome) => outcome?.status === 'pending' && outcome.recovery !== undefined)
-            .map((outcome) => outcome.recovery);
+            .map((outcome) => outcome.recovery)
+            // The exact-recovery executor has a tighter physical peer/request budget
+            // than the ordinal scanner. Spend that scarce budget on the recent slots
+            // this selected pass deliberately reserved, then use any remainder for
+            // the historical side. Cursor completion is still merged below in
+            // ordinal order, so this changes latency rather than correctness.
+            .sort(passPlan.compareRecoveryTargets);
         if (!staleTarget && recoveryTargets.length > 0 && deps.recoverPendingOrdinals) {
-            const recovery = await deps.recoverPendingOrdinals(localCgId, onChainCgId, recoveryTargets, headBlock);
+            const recoveryResult = await deps.recoverPendingOrdinals(localCgId, onChainCgId, recoveryTargets, headBlock);
             // Recovery is the longest await in the pass; the binding can be repaired
             // while it runs. Outcomes recovered under the old binding must never
             // advance or persist cursor state for the rebound CG, so re-check before
@@ -152,11 +249,10 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
                 staleTarget = true;
             }
             else {
-                for (const [ordinal, outcome] of recovery.outcomes)
+                for (const [ordinal, outcome] of recoveryResult.outcomes) {
                     outcomes.set(ordinal, outcome);
-                recoveryContinuationOrdinal = recovery.continuationOrdinal;
-                recoveryAttempted = recovery.attemptedOrdinals.length > 0;
-                recoveryCooldownOnly = recovery.cooldownOnly === true;
+                }
+                recovery = recoveryDisposition(recoveryResult);
             }
         }
         // Cursor state is deliberately updated in ordinal order even though chain
@@ -180,23 +276,36 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
     if (staleTarget || headUnavailable) {
         state.scanOrdinal = state.watermark;
     }
-    else if (recoveryContinuationOrdinal !== undefined
-        && (recoveryAttempted || recoveryCooldownOnly || !hasUnvisitedCandidates)) {
-        state.scanOrdinal = Math.max(state.watermark, recoveryContinuationOrdinal);
-    }
-    else if (!hasUnvisitedCandidates) {
-        state.scanOrdinal = state.watermark;
-    }
-    else if (ordinals.length > 0) {
-        state.scanOrdinal = ordinals[ordinals.length - 1] + 1;
+    else {
+        // The recovery executor consumes recent targets first and therefore its
+        // continuation is ordered by recovery priority, not by chain ordinal. It
+        // must never become the durable scan cursor: on a growing graph that would
+        // move the cursor near the head and starve the untouched historical gap.
+        // Advance only from the oldest-side slice. The recovery continuation still
+        // contributes to the continuation decision below, while pending outcomes
+        // remain in the inventory and are revisited on a later historical cycle.
+        const nextScanOrdinal = passPlan.nextScanOrdinal({
+            watermark: state.watermark,
+            recovery,
+        });
+        if (nextScanOrdinal !== undefined)
+            state.scanOrdinal = nextScanOrdinal;
     }
     const pending = ordinalsToReconcile(state, head).length;
+    const recoveryAttempted = recovery.kind === 'ordinal-continuation'
+        || recovery.kind === 'provider-continuation'
+        || recovery.kind === 'exhausted';
+    const hasImmediateRecoveryContinuation = recovery.kind === 'ordinal-continuation'
+        || recovery.kind === 'provider-continuation';
     const hasMore = !headUnavailable
         && !staleTarget
-        && !recoveryCooldownOnly
+        && recovery.kind !== 'cooldown'
         && (recoveryAttempted
-            ? recoveryContinuationOrdinal !== undefined || hasUnvisitedCandidates
+            ? hasImmediateRecoveryContinuation
+                || hasUnvisitedCandidates
             : hasUnvisitedCandidates);
+    const shouldContinueImmediately = staleTarget
+        || (hasMore && (reconciled > 0 || hasImmediateRecoveryContinuation));
     if (state.watermark !== before) {
         deps.persistWatermark(localCgId, state.watermark);
         deps.log(`reconcile ${localCgId}: watermark ${before} -> ${state.watermark} (head=${head}, processed=${processed}, reconciled=${reconciled}, pending=${pending})`);
@@ -211,6 +320,7 @@ export async function reconcileContextGraph(deps, state, localCgId, onChainCgId)
         pending,
         processed,
         hasMore,
+        shouldContinueImmediately,
         staleTarget,
     };
 }