@origintrail-official/dkg-agent 10.0.19 → 10.0.21

package/dist/dkg-agent-rfc64-meta-bootstrap.d.ts

@@ -1,6 +1,11 @@
 import { DKGAgentBase } from './dkg-agent-base.js';
 import type { DKGAgent } from './dkg-agent.js';
 export type Rfc64CatalogMetadataBootstrapOutcomeV1 = 'system-graph' | 'local-author' | 'not-subscribed' | 'no-accepted-public-policy' | 'already-confirmed' | 'no-connected-peers' | 'fetched' | 'not-found';
+/** Public registration already authenticated by the explicit subscribe route. */
+export interface RegisteredPublicMetadataBootstrapProofV1 {
+    readonly contextGraphId: string;
+    readonly onChainId: string;
+}
 export declare class Rfc64MetaBootstrapMethods extends DKGAgentBase {
     /**
      * Pull `<cg>/_meta` for a newly active RFC-64 public replica from peers that
@@ -9,7 +14,7 @@ export declare class Rfc64MetaBootstrapMethods extends DKGAgentBase {
      * error, rejected snapshot) is a miss, and a miss keeps the local state
      * exactly as it was: no metadata is installed, no lane changes.
      */
-    bootstrapRfc64CatalogContextGraphMetadataFromPeersV1(this: DKGAgent, contextGraphId: string, signal?: AbortSignal): Promise<Rfc64CatalogMetadataBootstrapOutcomeV1>;
+    bootstrapRfc64CatalogContextGraphMetadataFromPeersV1(this: DKGAgent, contextGraphId: string, signal?: AbortSignal, registeredPublicProof?: Readonly<RegisteredPublicMetadataBootstrapProofV1>): Promise<Rfc64CatalogMetadataBootstrapOutcomeV1>;
     private runRfc64CatalogContextGraphMetadataBootstrapV1;
 }
 //# sourceMappingURL=dkg-agent-rfc64-meta-bootstrap.d.ts.map

package/dist/dkg-agent-rfc64-meta-bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dkg-agent-rfc64-meta-bootstrap.d.ts","sourceRoot":"","sources":["../src/dkg-agent-rfc64-meta-bootstrap.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,MAAM,MAAM,sCAAsC,GAC9C,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,2BAA2B,GAC3B,mBAAmB,GACnB,oBAAoB,GACpB,SAAS,GACT,WAAW,CAAC;AAQhB,qBAAa,yBAA0B,SAAQ,YAAY;IACzD;;;;;;OAMG;IACH,oDAAoD,CAClD,IAAI,EAAE,QAAQ,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sCAAsC,CAAC;YAgBpC,8CAA8C;CAwE7D"}
+{"version":3,"file":"dkg-agent-rfc64-meta-bootstrap.d.ts","sourceRoot":"","sources":["../src/dkg-agent-rfc64-meta-bootstrap.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,MAAM,MAAM,sCAAsC,GAC9C,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,2BAA2B,GAC3B,mBAAmB,GACnB,oBAAoB,GACpB,SAAS,GACT,WAAW,CAAC;AAEhB,iFAAiF;AACjF,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAWD,qBAAa,yBAA0B,SAAQ,YAAY;IACzD;;;;;;OAMG;IACH,oDAAoD,CAClD,IAAI,EAAE,QAAQ,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,qBAAqB,CAAC,EAAE,QAAQ,CAAC,wCAAwC,CAAC,GACzE,OAAO,CAAC,sCAAsC,CAAC;YA8BpC,8CAA8C;CA+E7D"}

package/dist/dkg-agent-rfc64-meta-bootstrap.js

@@ -32,7 +32,7 @@ import { SYSTEM_CONTEXT_GRAPHS, createOperationContext, } from '@origintrail-off
 import { DKGAgentBase } from './dkg-agent-base.js';
 import { runCuratorMetaRefreshFromPeer } from './curator-meta-refresh.js';
 import { rfc64UnregisteredAuthorityOwnerV1 } from './rfc64/unregistered-authority-transport-v1.js';
-/** One in-flight bootstrap per (agent, graph); concurrent callers share it. */
+/** One in-flight bootstrap per (agent, graph); only equivalent authority shares it. */
 const rfc64MetadataBootstrapsInFlightV1 = new WeakMap();
 export class Rfc64MetaBootstrapMethods extends DKGAgentBase {
     /**
@@ -42,24 +42,33 @@ export class Rfc64MetaBootstrapMethods extends DKGAgentBase {
      * error, rejected snapshot) is a miss, and a miss keeps the local state
      * exactly as it was: no metadata is installed, no lane changes.
      */
-    bootstrapRfc64CatalogContextGraphMetadataFromPeersV1(contextGraphId, signal) {
+    bootstrapRfc64CatalogContextGraphMetadataFromPeersV1(contextGraphId, signal, registeredPublicProof) {
         let inFlight = rfc64MetadataBootstrapsInFlightV1.get(this);
         if (inFlight === undefined) {
             inFlight = new Map();
             rfc64MetadataBootstrapsInFlightV1.set(this, inFlight);
         }
+        const proofKey = registeredPublicProof === undefined
+            ? undefined
+            : `${registeredPublicProof.contextGraphId}\0${registeredPublicProof.onChainId}`;
         const existing = inFlight.get(contextGraphId);
-        if (existing !== undefined)
-            return existing;
-        const run = this.runRfc64CatalogContextGraphMetadataBootstrapV1(contextGraphId, signal)
+        if (existing !== undefined) {
+            if (existing.proofKey === proofKey)
+                return existing.promise;
+            // An activation pull without chain admission may be in flight when an
+            // explicit subscribe proves public registration. Run that stronger pull
+            // after the first generation settles; never reuse its weaker outcome.
+            return existing.promise.catch(() => undefined).then(() => this.bootstrapRfc64CatalogContextGraphMetadataFromPeersV1(contextGraphId, signal, registeredPublicProof));
+        }
+        const run = this.runRfc64CatalogContextGraphMetadataBootstrapV1(contextGraphId, signal, registeredPublicProof)
             .finally(() => {
-            if (inFlight.get(contextGraphId) === run)
+            if (inFlight.get(contextGraphId)?.promise === run)
                 inFlight.delete(contextGraphId);
         });
-        inFlight.set(contextGraphId, run);
+        inFlight.set(contextGraphId, { proofKey, promise: run });
         return run;
     }
-    async runRfc64CatalogContextGraphMetadataBootstrapV1(contextGraphId, signal) {
+    async runRfc64CatalogContextGraphMetadataBootstrapV1(contextGraphId, signal, registeredPublicProof) {
         signal?.throwIfAborted();
         if (Object.values(SYSTEM_CONTEXT_GRAPHS).includes(contextGraphId)) {
             return 'system-graph';
@@ -70,19 +79,26 @@ export class Rfc64MetaBootstrapMethods extends DKGAgentBase {
         if (this.subscribedContextGraphs.get(contextGraphId)?.subscribed !== true) {
             return 'not-subscribed';
         }
-        // Fail closed: only an accepted PUBLIC policy may drive this pull. A
+        // Fail closed: only authenticated PUBLIC authority may drive this pull. A
         // private graph's metadata arrives through the authenticated join-approval
-        // path, and a graph with no accepted policy has no business fetching.
+        // path. An explicit subscribe may already have proved a registered public
+        // graph against current chain authority before the catalog service holds
+        // that policy. Carry that exact admission proof into this catch-up job;
+        // background activation without one never starts a new chain read here.
         const accepted = this.readAcceptedRfc64CatalogAccessSnapshotV1(contextGraphId);
-        if (accepted === null || accepted.policy.accessPolicy !== 0) {
+        if (accepted?.policy.accessPolicy === 1)
+            return 'no-accepted-public-policy';
+        if (accepted === null && !(registeredPublicProof?.contextGraphId === contextGraphId
+            && /^[1-9][0-9]*$/.test(registeredPublicProof.onChainId)))
             return 'no-accepted-public-policy';
-        }
         // The owner this node already authenticated: the seed signer for an
         // owner-signed policy, otherwise the wallet namespace of the id. A served
         // declaration that names a different curator is not this graph's.
-        const expectedCuratorAddress = accepted.policy.source.kind === 'owner-signed-unregistered'
+        const expectedCuratorAddress = accepted?.policy.source.kind === 'owner-signed-unregistered'
             ? accepted.policy.source.ownerAddress
             : rfc64UnregisteredAuthorityOwnerV1(contextGraphId) ?? undefined;
+        if (expectedCuratorAddress === undefined)
+            return 'no-accepted-public-policy';
         if (await this.hasConfirmedMetaState(contextGraphId).catch(() => false)) {
             return 'already-confirmed';
         }

package/dist/dkg-agent-rfc64-meta-bootstrap.js.map

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

package/dist/dkg-agent-rfc64-swm-catalog-projection-supervisor.d.ts

@@ -5,6 +5,7 @@ import type { DKGAgent } from './dkg-agent.js';
 import type { Rfc64CatalogBootstrapPartitionV1 } from './dkg-agent-rfc64-catalog-bootstrap.js';
 import type { Rfc64CatalogWorkloadOwnerV1 } from './rfc64/catalog-runtime-v1.js';
 import type { Rfc64FinalizedPrivatePlacementRepairV1 } from './rfc64/finalized-private-placement-repair-store-v1.js';
+import { type CatalogRepairDiagnosticV1 } from './rfc64/catalog-repair-diagnostics-v1.js';
 export type Rfc64PublicCatalogAuthorRepairOutcomeV1 = 'pending' | 'reconciled' | 'no-inventory' | 'failed';
 export interface Rfc64PublicCatalogAuthorRepairStatusV1 {
     readonly contextGraphId: ContextGraphIdV1;
@@ -16,6 +17,9 @@ export interface Rfc64PublicCatalogAuthorRepairStatusV1 {
     readonly inventoryRowCount: string | null;
     readonly lastError: string | null;
     readonly updatedAtMs: number | null;
+    readonly diagnostic: Readonly<CatalogRepairDiagnosticV1> | null;
+    readonly consecutiveFailures: number;
+    readonly nextAttemptAtMs: number | null;
 }
 export interface Rfc64SwmCatalogProjectionSupervisorStatusV1 {
     readonly running: boolean;
@@ -36,6 +40,7 @@ interface ProjectionOwnerDependenciesV1 {
     readonly listLocalAuthorAddresses: () => readonly EvmAddressV1[];
     readonly acceptsPublicRootLane: (contextGraphId: ContextGraphIdV1) => boolean;
     readonly acceptsFinalizedPrivateLane: (contextGraphId: ContextGraphIdV1) => boolean;
+    readonly readRepairRevision: (contextGraphId: ContextGraphIdV1, authorAddress: EvmAddressV1) => string | null;
     readonly listFinalizedPrivateRepairs: () => readonly Readonly<Rfc64FinalizedPrivatePlacementRepairV1>[];
     readonly repairFinalizedPrivatePlacement: (repair: Readonly<Rfc64FinalizedPrivatePlacementRepairV1>) => Promise<void>;
     readonly reconcile: (params: Readonly<{
@@ -49,6 +54,8 @@ interface ProjectionOwnerDependenciesV1 {
 export declare class Rfc64SwmCatalogProjectionOwnerV1 implements Rfc64CatalogWorkloadOwnerV1 {
     #private;
     constructor(dependencies: ProjectionOwnerDependenciesV1);
+    /** Observe a real inactive edge without reopening admission or starting work. */
+    observeLaneAvailability(contextGraphId: string): void;
     start(ctx: OperationContext): void;
     request(params: Readonly<{
         readonly contextGraphId: ContextGraphIdV1;
@@ -66,6 +73,7 @@ export declare class Rfc64SwmCatalogProjectionOwnerV1 implements Rfc64CatalogWor
 }
 export declare function bindRfc64SwmCatalogProjectionOwnerV1(agent: DKGAgent, owner: Rfc64SwmCatalogProjectionOwnerV1): Rfc64SwmCatalogProjectionOwnerV1;
 export declare class Rfc64SwmCatalogProjectionSupervisorMethods extends DKGAgentBase {
+    observeRfc64SwmCatalogProjectionLaneAvailabilityV1(this: DKGAgent, contextGraphId: string): void;
     /** Seed bounded local-author projection work from selected catalog scopes. */
     startRfc64SwmCatalogProjectionSupervisorV1(this: DKGAgent, ctx: OperationContext): void;
     /**

package/dist/dkg-agent-rfc64-swm-catalog-projection-supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dkg-agent-rfc64-swm-catalog-projection-supervisor.d.ts","sourceRoot":"","sources":["../src/dkg-agent-rfc64-swm-catalog-projection-supervisor.ts"],"names":[],"mappings":"AAEA,yEAAyE;AAEzE,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAC9C,wCAAwC,CAAC;AAE3C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,KAAK,EAAE,sCAAsC,EAAE,MACpD,wDAAwD,CAAC;AAS3D,MAAM,MAAM,uCAAuC,GAC/C,SAAS,GACT,YAAY,GACZ,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,uCAAuC,CAAC;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,yBAAyB,EAAE,UAAU,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,sCAAsC,EAAE,CAAC;CACrE;AA0BD,KAAK,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAClD,QAAQ,CAAC,+CAA+C,CAAC,CAC1D,CAAC,CAAC;AAEH,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,UAAU,6BAA6B;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,gCAAgC,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,wBAAwB,EAAE,MAAM,SAAS,YAAY,EAAE,CAAC;IACjE,QAAQ,CAAC,qBAAqB,EAAE,CAAC,cAAc,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAC9E,QAAQ,CAAC,2BAA2B,EAAE,CAAC,cAAc,EAAE,gBAAgB,KAAK,OAAO,CAAC;IACpF,QAAQ,CAAC,2BAA2B,EAAE,MAAM,SAAS,QAAQ,CAC3D,sCAAsC,CACvC,EAAE,CAAC;IACJ,QAAQ,CAAC,+BAA+B,EAAE,CACxC,MAAM,EAAE,QAAQ,CAAC,sCAAsC,CAAC,KACrD,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QACpC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;QAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;QACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;KAC9B,CAAC,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,0FAA0F;AAC1F,qBAAa,gCAAiC,YAAW,2BAA2B;;gBAKtE,YAAY,EAAE,6BAA6B;IAIvD,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAoElC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QACvB,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;QAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;QACrC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;KAChC,CAAC,GAAG,OAAO;IA6BZ,gFAAgF;IAChF,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC;QACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,sCAAsC,CAAC,CAAC;QAClE,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;KAChC,CAAC,GAAG,6CAA6C;IAgClD,MAAM,IAAI,QAAQ,CAAC,2CAA2C,CAAC,GAAG,IAAI;IAehE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAMzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0J7B;AAID,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,gCAAgC,GACtC,gCAAgC,CAMlC;AAsCD,qBAAa,0CAA2C,SAAQ,YAAY;IAC1E,8EAA8E;IAC9E,0CAA0C,CACxC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,gBAAgB,GACpB,IAAI;IAIP;;;;OAIG;IACH,kCAAkC,CAChC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,QAAQ,CAAC;QACf,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;QAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;QACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC;KACjC,CAAC,GACD,OAAO;IAWV,oDAAoD,CAClD,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,QAAQ,CAAC;QACf,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,sCAAsC,CAAC,CAAC;QAClE,QAAQ,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC;KACjC,CAAC,GACD,6CAA6C;IAOhD,+CAA+C,CAC7C,IAAI,EAAE,QAAQ,GACb,QAAQ,CAAC,2CAA2C,CAAC,GAAG,IAAI;IAIzD,6CAA6C,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,0CAA0C,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhF"}
+{"version":3,"file":"dkg-agent-rfc64-swm-catalog-projection-supervisor.d.ts","sourceRoot":"","sources":["../src/dkg-agent-rfc64-swm-catalog-projection-supervisor.ts"],"names":[],"mappings":"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"}

package/dist/dkg-agent-rfc64-swm-catalog-projection-supervisor.js

@@ -1,10 +1,12 @@
 // SPDX-License-Identifier: Apache-2.0
 /** Restart-safe local SWM-inventory to catalog projection supervisor. */
 import { assertCanonicalEvmAddress, assertContextGraphIdV1, createOperationContext, } from '@origintrail-official/dkg-core';
+import { withDefaultStoreWorkPriority } from '@origintrail-official/dkg-storage';
 import { DKGAgentBase } from './dkg-agent-base.js';
 import { mapWithConcurrency } from './map-with-concurrency.js';
 import { CoalescingRecurringTask } from './coalescing-recurring-task.js';
-import { boundedRfc64SupervisorErrorV1, rfc64SupervisorErrorMessageV1, } from './rfc64/supervisor-status-v1.js';
+import { catalogRepairDiagnosticV1, catalogRepairErrorSummaryV1, CatalogRepairLaneInactiveErrorV1, } from './rfc64/catalog-repair-diagnostics-v1.js';
+import { CatalogRepairRetryV1 } from './rfc64/catalog-repair-retry-v1.js';
 const MAX_CONCURRENT_REPAIRS_V1 = 4;
 const DEFAULT_PROJECTION_RETRY_INTERVAL_MS_V1 = 5_000;
 /** Feature-local owner for projection admission, mutable repair state, and its runner. */
@@ -15,6 +17,31 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
     constructor(dependencies) {
         this.#dependencies = dependencies;
     }
+    /** Observe a real inactive edge without reopening admission or starting work. */
+    observeLaneAvailability(contextGraphId) {
+        if (this.#admissionClosed || this.#state === undefined)
+            return;
+        for (const repair of this.#state.repairs) {
+            if (repair.contextGraphId !== contextGraphId)
+                continue;
+            try {
+                if (!this.#dependencies.acceptsPublicRootLane(repair.contextGraphId)) {
+                    repair.retry.observe(null);
+                }
+            }
+            catch { /* Scheduling hints must not reject a subscription transition. */ }
+        }
+        for (const entry of this.#state.finalizedPrivateRetries.values()) {
+            if (entry.contextGraphId !== contextGraphId)
+                continue;
+            try {
+                if (!this.#dependencies.acceptsFinalizedPrivateLane(entry.contextGraphId)) {
+                    entry.retry.observe(null);
+                }
+            }
+            catch { /* The periodic admission check remains authoritative. */ }
+        }
+    }
     start(ctx) {
         this.#admissionClosed = false;
         const partition = this.#dependencies.resolvePartition();
@@ -45,21 +72,10 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
                     existing.repairs.push(repair);
                     publicRepairRequested = true;
                 }
-                else if (current.outcome === 'failed') {
-                    // Re-entering start is an authorization/subscription transition, not
-                    // a new inventory observation. Retry a failed repair, but do not turn
-                    // a completed no-inventory or reconciled result into duplicate work.
-                    current.dirty = true;
-                    publicRepairRequested = true;
-                }
             }
-            // Release-native/default selection has no bootstrap partition to seed
-            // `repairs`. An authority transition must still revive a repair that
-            // failed while the lane was temporarily inactive.
             for (const current of existing.repairs) {
-                if (!repairKeys.has(`${current.contextGraphId}\n${current.authorAddress}`)
-                    && current.outcome === 'failed'
-                    && this.#dependencies.acceptsPublicRootLane(current.contextGraphId)) {
+                const changed = this.#observeRevision(current.retry, current.contextGraphId, current.authorAddress);
+                if ((changed || current.outcome === 'failed') && current.retry.eligible(Date.now())) {
                     current.dirty = true;
                     publicRepairRequested = true;
                 }
@@ -83,8 +99,11 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
     request(params) {
         if (this.#admissionClosed)
             return false;
-        if (!this.#dependencies.acceptsPublicRootLane(params.contextGraphId))
+        if (!this.#dependencies.acceptsPublicRootLane(params.contextGraphId)) {
+            this.#state?.repairs.find((repair) => repair.contextGraphId === params.contextGraphId
+                && repair.authorAddress === params.authorAddress)?.retry.observe(null);
             return false;
+        }
         let state = this.#state;
         if (state === undefined) {
             const retryIntervalMs = this.#dependencies.resolvePartition()?.retryIntervalMs
@@ -100,9 +119,19 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
             repair = newPendingRepairV1(params.contextGraphId, params.authorAddress);
             state.repairs.push(repair);
         }
-        else {
+        const changed = this.#observeRevision(repair.retry, repair.contextGraphId, repair.authorAddress);
+        if (changed === undefined) {
+            repair.pendingUnknownRequest = true;
             repair.dirty = true;
         }
+        if (!repair.retry.eligible(Date.now())) {
+            // A cheap pass arms the pending mutation's deadline without admitting
+            // canonical store work before the unchanged failure cooldown expires.
+            if (repair.pendingUnknownRequest)
+                state.runner.request();
+            return true;
+        }
+        repair.dirty = true;
         return state.runner.request();
     }
     /** Enqueue one already-durable chain-confirmed private placement transition. */
@@ -114,6 +143,8 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
         if (this.#admissionClosed)
             return rejected();
         if (!this.#dependencies.acceptsFinalizedPrivateLane(params.repair.contextGraphId)) {
+            this.#state?.finalizedPrivateRetries.get(finalizedPrivateRepairKeyV1(params.repair))
+                ?.retry.observe(null);
             return rejected();
         }
         let state = this.#state;
@@ -150,7 +181,8 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
             retryIntervalMs: state.retryIntervalMs ?? 0,
             lastPassStartedAtMs: state.lastPassStartedAtMs,
             lastPassCompletedAtMs: state.lastPassCompletedAtMs,
-            repairs: Object.freeze(state.repairs.map(({ dirty: _dirty, ...repair }) => (Object.freeze(repair)))),
+            repairs: Object.freeze(state.repairs.map(({ dirty: _dirty, pendingUnknownRequest: _pendingUnknownRequest, retry, ...repair }) => (Object.freeze({ ...repair, consecutiveFailures: retry.consecutiveFailures,
+                nextAttemptAtMs: retry.nextAttemptAtMs })))),
         });
     }
     async whenIdle() {
@@ -164,28 +196,43 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
         const state = this.#state;
         if (state === undefined)
             return;
+        clearTimeout(state.publicMutationTimer);
+        state.publicMutationTimer = undefined;
+        clearTimeout(state.finalizedPrivateWaiterTimer);
+        state.finalizedPrivateWaiterTimer = undefined;
         await Promise.all([state.runner.close(), state.finalizedPrivateRunner.close()]);
         for (const waiters of state.finalizedPrivateAttemptWaiters.values()) {
             for (const settle of waiters)
                 settle();
         }
         state.finalizedPrivateAttemptWaiters.clear();
+        state.finalizedPrivateRetries.clear();
         this.#state = undefined;
     }
     #createState(retryIntervalMs, finalizedPrivateRetryIntervalMs, repairs, ctx) {
         let state;
         const runner = new CoalescingRecurringTask({
             retryIntervalMs,
-            runPass: (signal) => this.#runPass(state, signal),
+            runPass: async (signal) => {
+                try {
+                    await this.#runPass(state, signal);
+                }
+                finally {
+                    this.#schedulePublicMutationWake(state);
+                }
+            },
             onError: (error) => {
-                this.#dependencies.warn(ctx, `RFC-64 SWM catalog projection pass failed: ${rfc64SupervisorErrorMessageV1(error)}`);
+                this.#dependencies.warn(ctx, JSON.stringify({ event: 'catalog_repair_pass_failed', diagnostic: catalogRepairDiagnosticV1(error) }));
             },
             beforePeriodicPass: () => {
                 // Live inventory mutations already dirty their exact scope. The timer
                 // is the bounded liveness path for failures, not a reason to rebuild
                 // every healthy catalog from its complete inventory every five seconds.
                 for (const repair of state.repairs) {
-                    if (repair.outcome === 'failed')
+                    if (repair.outcome !== 'failed')
+                        continue;
+                    this.#observeRevision(repair.retry, repair.contextGraphId, repair.authorAddress);
+                    if (repair.retry.eligible(Date.now()))
                         repair.dirty = true;
                 }
             },
@@ -193,9 +240,25 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
         });
         const finalizedPrivateRunner = new CoalescingRecurringTask({
             retryIntervalMs: finalizedPrivateRetryIntervalMs,
-            runPass: (signal) => this.#runFinalizedPrivatePass(state, signal),
+            runPass: async (signal) => {
+                let failed = false;
+                try {
+                    await this.#runFinalizedPrivatePass(state, signal);
+                }
+                catch (error) {
+                    failed = true;
+                    throw error;
+                }
+                finally {
+                    // A failed durable queue read must not spin on an already-due waiter.
+                    this.#schedulePrivateWaiterWake(state, failed
+                        ? (finalizedPrivateRetryIntervalMs > 0
+                            ? finalizedPrivateRetryIntervalMs : DEFAULT_PROJECTION_RETRY_INTERVAL_MS_V1)
+                        : 0);
+                }
+            },
             onError: (error) => {
-                this.#dependencies.warn(ctx, `RFC-64 finalized-private repair pass failed: ${rfc64SupervisorErrorMessageV1(error)}`);
+                this.#dependencies.warn(ctx, JSON.stringify({ event: 'catalog_private_repair_pass_failed', diagnostic: catalogRepairDiagnosticV1(error) }));
             },
             closingMessage: 'RFC-64 finalized-private placement repair closing',
         });
@@ -203,8 +266,11 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
             retryIntervalMs,
             repairs,
             runner,
+            publicMutationTimer: undefined,
             finalizedPrivateRunner,
             finalizedPrivateAttemptWaiters: new Map(),
+            finalizedPrivateWaiterTimer: undefined,
+            finalizedPrivateRetries: new Map(),
             pass: 0,
             lastPassStartedAtMs: null,
             lastPassCompletedAtMs: null,
@@ -212,7 +278,7 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
         return state;
     }
     async #runPass(state, signal) {
-        const pending = state.repairs.filter((repair) => repair.dirty);
+        const pending = state.repairs.filter((repair) => repair.dirty && repair.retry.eligible(Date.now()));
         if (pending.length === 0)
             return;
         for (const repair of pending)
@@ -223,7 +289,7 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
             await mapWithConcurrency(pending, MAX_CONCURRENT_REPAIRS_V1, async (repair) => {
                 if (signal.aborted)
                     return;
-                await this.#reconcile(repair, signal);
+                await this.#reconcile(repair, state.retryIntervalMs, signal);
             });
         }
         finally {
@@ -232,41 +298,154 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
     }
     async #runFinalizedPrivatePass(state, signal) {
         const repairs = this.#dependencies.listFinalizedPrivateRepairs();
+        const currentKeys = new Set(repairs.map(finalizedPrivateRepairKeyV1));
+        for (const key of state.finalizedPrivateRetries.keys()) {
+            if (!currentKeys.has(key))
+                state.finalizedPrivateRetries.delete(key);
+        }
+        for (const key of state.finalizedPrivateAttemptWaiters.keys()) {
+            if (!currentKeys.has(key))
+                this.#settlePrivateWaiters(state, key);
+        }
         await mapWithConcurrency(repairs, MAX_CONCURRENT_REPAIRS_V1, async (repair) => {
+            if (signal.aborted)
+                return;
             const key = finalizedPrivateRepairKeyV1(repair);
+            let entry = state.finalizedPrivateRetries.get(key);
+            if (entry === undefined) {
+                entry = { contextGraphId: repair.contextGraphId, retry: new CatalogRepairRetryV1(), attempts: 0 };
+                state.finalizedPrivateRetries.set(key, entry);
+            }
+            this.#observePrivateLane(entry.retry, repair.contextGraphId);
+            if (!entry.retry.eligible(Date.now()))
+                return;
+            const attemptGeneration = entry.retry.generation;
+            entry.attempts += 1;
             try {
-                if (signal.aborted)
-                    return;
-                await this.#dependencies.repairFinalizedPrivatePlacement(repair);
+                if (!this.#dependencies.acceptsFinalizedPrivateLane(repair.contextGraphId)) {
+                    throw new CatalogRepairLaneInactiveErrorV1();
+                }
+                await withDefaultStoreWorkPriority('background', () => (this.#dependencies.repairFinalizedPrivatePlacement(repair)));
+                state.finalizedPrivateRetries.delete(key);
             }
             catch (error) {
                 if (!signal.aborted) {
-                    this.#dependencies.warn(createOperationContext('system'), `RFC-64 finalized-private placement repair failed for ${repair.contextGraphId} / ${repair.kaUal}: ${boundedRfc64SupervisorErrorV1(error)}`);
+                    const changed = this.#observePrivateLane(entry.retry, repair.contextGraphId);
+                    entry.retry.fail(attemptGeneration, Date.now(), state.retryIntervalMs);
+                    if (changed)
+                        state.finalizedPrivateRunner.request();
+                    this.#warnFailure('catalog_private_repair_failed', error, entry.attempts, entry.retry);
                 }
             }
             finally {
-                const waiters = state.finalizedPrivateAttemptWaiters.get(key);
-                if (waiters !== undefined) {
-                    state.finalizedPrivateAttemptWaiters.delete(key);
-                    for (const settle of waiters)
-                        settle();
-                }
+                this.#settlePrivateWaiters(state, key);
             }
         });
     }
-    async #reconcile(repair, signal) {
+    #settlePrivateWaiters(state, key) {
+        const waiters = state.finalizedPrivateAttemptWaiters.get(key);
+        state.finalizedPrivateAttemptWaiters.delete(key);
+        if (waiters !== undefined)
+            for (const settle of waiters)
+                settle();
+    }
+    /** Retain explicit mutations whose revision hint was unavailable, even in one-pass mode. */
+    #schedulePublicMutationWake(state) {
+        clearTimeout(state.publicMutationTimer);
+        state.publicMutationTimer = undefined;
+        if (this.#state !== state || this.#admissionClosed || state.runner.closed)
+            return;
+        let earliest = Infinity;
+        for (const repair of state.repairs) {
+            if (repair.pendingUnknownRequest) {
+                earliest = Math.min(earliest, repair.retry.nextAttemptAtMs ?? Date.now());
+            }
+        }
+        if (!Number.isFinite(earliest))
+            return;
+        state.publicMutationTimer = setTimeout(() => {
+            state.publicMutationTimer = undefined;
+            if (this.#state !== state || this.#admissionClosed || state.runner.closed)
+                return;
+            for (const repair of state.repairs) {
+                if (repair.pendingUnknownRequest)
+                    repair.dirty = true;
+            }
+            state.runner.request();
+        }, Math.min(2_147_483_647, Math.max(0, earliest - Date.now())));
+        state.publicMutationTimer.unref?.();
+    }
+    /** Accepted cooldown requests need one wake even when periodic retries are disabled. */
+    #schedulePrivateWaiterWake(state, minimumDelayMs) {
+        clearTimeout(state.finalizedPrivateWaiterTimer);
+        state.finalizedPrivateWaiterTimer = undefined;
+        if (this.#state !== state || this.#admissionClosed || state.finalizedPrivateRunner.closed)
+            return;
+        let earliest = Infinity;
+        for (const key of state.finalizedPrivateAttemptWaiters.keys()) {
+            const deadline = state.finalizedPrivateRetries.get(key)?.retry.nextAttemptAtMs;
+            earliest = Math.min(earliest, deadline ?? Date.now());
+        }
+        if (!Number.isFinite(earliest))
+            return;
+        state.finalizedPrivateWaiterTimer = setTimeout(() => {
+            state.finalizedPrivateWaiterTimer = undefined;
+            if (this.#state === state && !this.#admissionClosed && !state.finalizedPrivateRunner.closed) {
+                state.finalizedPrivateRunner.request();
+            }
+        }, Math.min(2_147_483_647, Math.max(minimumDelayMs, earliest - Date.now())));
+        state.finalizedPrivateWaiterTimer.unref?.();
+    }
+    #observePrivateLane(retry, contextGraphId) {
+        try {
+            // Exact durable identity already partitions private retries. An unrelated
+            // mutation of the author's inventory must not reset this repair's backoff.
+            return retry.observe(this.#dependencies.acceptsFinalizedPrivateLane(contextGraphId) ? 'active' : null);
+        }
+        catch {
+            return false;
+        }
+    }
+    #observeRevision(retry, contextGraphId, authorAddress) {
+        try {
+            const active = this.#dependencies.acceptsPublicRootLane(contextGraphId);
+            return retry.observe(active
+                ? this.#dependencies.readRepairRevision(contextGraphId, authorAddress) : null);
+        }
+        catch {
+            // A hint failure must not reject the mutation caller or reset its cooldown.
+            return undefined;
+        }
+    }
+    #warnFailure(event, error, attempt, retry) {
+        try {
+            this.#dependencies.warn(createOperationContext('system'), JSON.stringify({
+                event, diagnostic: catalogRepairDiagnosticV1(error), attempt,
+                consecutiveFailures: retry.consecutiveFailures, nextAttemptAtMs: retry.nextAttemptAtMs,
+            }));
+        }
+        catch { /* Diagnostics must not alter repair state or waiter settlement. */ }
+    }
+    async #reconcile(repair, retryIntervalMs, signal) {
+        // Consume only at actual admission. A newer unknown mutation received
+        // during this attempt must survive both its success and failure paths.
+        repair.pendingUnknownRequest = false;
+        this.#observeRevision(repair.retry, repair.contextGraphId, repair.authorAddress);
+        const attemptGeneration = repair.retry.generation;
         repair.attempts += 1;
         try {
             if (!this.#dependencies.acceptsPublicRootLane(repair.contextGraphId)) {
-                throw new Error('RFC-64 SWM catalog projection lane is temporarily inactive');
+                throw new CatalogRepairLaneInactiveErrorV1();
             }
-            const reconciliation = await this.#dependencies.reconcile({
+            const reconciliation = await withDefaultStoreWorkPriority('background', () => this.#dependencies.reconcile({
                 contextGraphId: repair.contextGraphId,
                 authorAddress: repair.authorAddress,
                 signal,
-            });
+            }));
             if (signal.aborted)
                 return;
+            repair.retry.reset();
+            repair.diagnostic = null;
             if (reconciliation === null) {
                 Object.assign(repair, {
                     outcome: 'no-inventory',
@@ -291,15 +470,28 @@ export class Rfc64SwmCatalogProjectionOwnerV1 {
         catch (error) {
             if (signal.aborted)
                 return;
+            const changed = this.#observeRevision(repair.retry, repair.contextGraphId, repair.authorAddress);
+            if (repair.retry.fail(attemptGeneration, Date.now(), retryIntervalMs)) {
+                // Duplicate same-head wakes received while this attempt was active do
+                // not get to bypass the newly established failure deadline.
+                repair.dirty = repair.pendingUnknownRequest;
+            }
+            else {
+                repair.dirty = true;
+                // A head may change without an explicit notification while draining.
+                if (changed)
+                    this.#state?.runner.request();
+            }
             Object.assign(repair, {
                 outcome: 'failed',
                 inventoryHeadObjectDigest: null,
                 catalogVersion: null,
                 inventoryRowCount: null,
-                lastError: boundedRfc64SupervisorErrorV1(error),
+                lastError: catalogRepairErrorSummaryV1(error),
+                diagnostic: catalogRepairDiagnosticV1(error),
                 updatedAtMs: Date.now(),
             });
-            this.#dependencies.warn(createOperationContext('system'), `RFC-64 local SWM catalog projection failed for ${repair.contextGraphId} / ${repair.authorAddress}: ${rfc64SupervisorErrorMessageV1(error)}`);
+            this.#warnFailure('catalog_repair_failed', error, repair.attempts, repair.retry);
         }
     }
 }
@@ -329,18 +521,35 @@ function newPendingRepairV1(contextGraphId, authorAddress) {
         lastError: null,
         updatedAtMs: null,
         dirty: true,
+        pendingUnknownRequest: false,
+        diagnostic: null,
+        retry: new CatalogRepairRetryV1(),
     };
 }
 function finalizedPrivateRepairKeyV1(repair) {
     return JSON.stringify([
+        repair.version,
         repair.contextGraphId,
         repair.authorAddress,
+        repair.inventoryScope.networkId,
+        repair.inventoryScope.contextGraphId,
+        repair.inventoryScope.governanceChainId,
+        repair.inventoryScope.governanceContractAddress,
+        repair.inventoryScope.ownershipTransitionDigest,
+        repair.inventoryScope.authorAddress,
+        repair.inventoryScope.subGraphName,
+        repair.inventoryScope.era,
+        repair.assertionCoordinate,
         repair.kaUal,
         repair.assertionVersion,
         repair.sealDigest,
     ]);
 }
 export class Rfc64SwmCatalogProjectionSupervisorMethods extends DKGAgentBase {
+    observeRfc64SwmCatalogProjectionLaneAvailabilityV1(contextGraphId) {
+        // Subscription selection can be initialized before the workload is bound.
+        projectionOwnersV1.get(this)?.observeLaneAvailability(contextGraphId);
+    }
     /** Seed bounded local-author projection work from selected catalog scopes. */
     startRfc64SwmCatalogProjectionSupervisorV1(ctx) {
         projectionOwnerV1(this).start(ctx);