@origintrail-official/dkg-agent 10.0.19 → 10.0.21

package/dist/finalization-handler.js

@@ -1,68 +1,18 @@
-import { SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE, SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE, } from './finalization-annotations.js';
-import { decodeFinalizationMessage, contextGraphWorkspaceGraphUri, contextGraphWorkspaceMetaGraphUri, contextGraphDataUri, contextGraphMetaUri, contextGraphOnChainIdBindingQuery, contextGraphSubGraphUri, validateSubGraphName, validateContextGraphId, DKGEvent, Logger, createOperationContext, assertSafeIri, isSafeIri, GRAPH_KA_CONTENT_SCOPE_VERSION, MemoryLayer, createGraphKnowledgeAssetScope, knowledgeAssetLayerGraphUri, DKG_ENTITY, DKG_ROOT_ENTITY_LEGACY, ENTITY_PRED_ALT, getMetrics, sparqlString, } from '@origintrail-official/dkg-core';
-import { deleteByPatternWithoutCount, GraphManager, loadSelectedSharedMemoryQuads, loadSharedMemorySliceWithKaBoundFallback, asGraphWriteRevisionSource, resolveGraphScopedOrLegacyMetadata, resolveSharedMemoryScopeGraphs, tryReplaceGraphAtomically, tryReplaceGraphAndSubjectAtomically, StoreSchedulerBusyError, } from '@origintrail-official/dkg-storage';
+import { decodeFinalizationMessage, contextGraphMetaUri, validateSubGraphName, validateContextGraphId, DKGEvent, Logger, createOperationContext, assertSafeIri, GRAPH_KA_CONTENT_SCOPE_VERSION, MemoryLayer, createGraphKnowledgeAssetScope, knowledgeAssetLayerGraphUri, sparqlString, } from '@origintrail-official/dkg-core';
+import { GraphManager, resolveGraphScopedOrLegacyMetadata, resolveSharedMemoryScopeGraphs, tryReplaceGraphAtomically, tryReplaceGraphAndSubjectAtomically, StoreSchedulerBusyError, } from '@origintrail-official/dkg-storage';
 import { resolvePublicFinalizedMaterializationAuthority, } from '@origintrail-official/dkg-chain';
-import { computeFlatKCRootV10 as computeFlatKCRoot, skolemizeByEntity, generatedPrivateCatalogFloorQuads, generatedPrivateCatalogTripleKeys, generateConfirmedFullMetadata, generateGraphKnowledgeAssetMetadata, buildDeterministicTokenRows, compareRootIris, getTentativeStatusQuad, insertBoundedAgentRegistryMeta, generateSubGraphRegistration, splitTrustedGeneratedCatalogRootMap, compareMaterializedVersion, readMaterializedVersion, shouldApplyMaterialization, writeMaterializedVersion, materializedVersionQuad, withMaterializationLock, workspacePublicQuadsDigest, KnowledgeAssetWorkspaceHeadCorruptError, isKnowledgeAssetWorkspaceHeadCorruptError, resolveKnowledgeAssetWorkspaceHead, } from '@origintrail-official/dkg-publisher';
+import { generateGraphKnowledgeAssetMetadata, compareMaterializedVersion, readMaterializedVersion, writeMaterializedVersion, materializedVersionQuad, withMaterializationLock, workspacePublicQuadsDigest, KnowledgeAssetWorkspaceHeadCorruptError, isKnowledgeAssetWorkspaceHeadCorruptError, resolveKnowledgeAssetWorkspaceHead, } from '@origintrail-official/dkg-publisher';
 const DKG_NS = 'http://dkg.io/ontology/';
 const PROV_NS = 'http://www.w3.org/ns/prov#';
 const CHAIN_FINALIZED_RECONCILE_PEER_ID = 'chain-finalized-reconcile-v1';
-// Slow-query / canary tags for the finalization SWM slice (#1549). A healthy fleet
-// sees `.fallbackUnbounded` at ~0 relative to `.bounded`; a spike means the bound is
-// mis-derived or recurrence is common, and `DKG_DISABLE_SWM_KA_BOUND=1` is the lever.
-const SWM_SLICE_SOURCE = 'agent.finalization.sharedMemorySlice';
-const SWM_SLICE_SOURCE_BOUNDED = `${SWM_SLICE_SOURCE}.bounded`;
-const SWM_SLICE_SOURCE_WIDENED = `${SWM_SLICE_SOURCE}.fallbackUnbounded`;
 import { ethers } from 'ethers';
-import { createHash } from 'node:crypto';
-import { deriveSwmKaGraphBound } from './swm-ka-bound.js';
 import { FinalizationLifecycleLogger, finalizationLifecycleDecision, } from './finalization-lifecycle-logger.js';
 import { FinalizationRecoveryCapacityError, FinalizationRecovery, } from './finalization-recovery.js';
 import { FinalizationRecoveryWorker, } from './finalization-recovery-worker.js';
 import { recoverReceiptBackedGraphScopedEvidence } from './receipt-backed-graph-scoped-evidence.js';
 import { resolveConfirmedGraphScopedVm, resolveLocallyConfirmedGraphScopedVm, } from './confirmed-graph-scoped-vm-resolver.js';
 import { verifyExactGraphContent, } from './exact-graph-content-verifier.js';
-import { protobufScalarToBigInt, protobufScalarToNumber } from './protobuf-scalars.js';
 import { createDurableFinalizationRecoveryEligibility, } from './finalization-recovery-eligibility.js';
-/**
- * Predicate for the durable per-root keep-root-copy signal the publisher
- * persists into SWM workspace meta at publish time (the chain-driven
- * reconcile path's equivalent of the gossip envelope's `keepRootCopyOnLabel`).
- * Shared with `DKGAgent` so the write and read sites can't drift.
- */
-export const KEEP_ROOT_COPY_PREDICATE = `${DKG_NS}keepRootCopyOnLabel`;
-/**
- * Reader-maintained memo (#1609): the flat-KC merkle root a WorkspaceOperation's
- * SWM snapshot hashes to, paired with `SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE` (a
- * cheap digest of the exact content that produced it), stamped onto the op subject
- * (`urn:dkg:share:<cg>:<id>`) the first time `findSwmSnapshotInNamespace` computes
- * it. Lets a chain-reconcile lookup (a) resolve a *present* KA's op by root
- * directly (fast path), and (b) skip the expensive `computeFlatKCRoot` recompute
- * for an op whose content is unchanged (the digest still matches) — the recompute
- * that dominates beacon reconcile load when a KA published elsewhere forces a full
- * O(#WorkspaceOperations) scan to conclude "not here".
- *
- * This memo is a bridge, NOT the durable fix (see OT-RFC-60): a WorkspaceOperation
- * is assembled incrementally (data quads and private roots arrive over time via
- * *entity-keyed* writes that do NOT rewrite the op subject), so the stamp can go
- * stale without a structural invalidation. Correctness therefore does NOT rely on
- * the stamp being fresh:
- *   - `verifyMerkleMatch` stays authoritative on the fast path — a stale stamp can
- *     only ever cause a *missed* promotion, never a wrong one.
- *   - the fallback scan re-reads EVERY op (it never excludes on stamp-presence) and
- *     trusts the memoized root only when the content digest still matches; any
- *     content change flips the digest → full recompute → the op is re-evaluated and
- *     re-stamped. An op can never be stranded by a stale stamp.
- * The durable fix (OT-RFC-60) makes the root a write-maintained, indexed property
- * stamped once when an op becomes complete-and-immutable, removing both the
- * recompute AND the staleness by construction.
- *
- * Deliberately invisible to the sibling VM-reconcile negative cache: its
- * `readVmReconcileSwmGen` / `vmReconcileWorkspaceOperationPattern` fingerprints
- * select only `rootEntity`/`publishedAt` on the op subject (plus the separate data
- * graph), so stamping these predicates into the meta graph does not perturb the
- * generation signal the negative cache keys on — the two mechanisms don't fight.
- */
-export { SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE, SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE, } from './finalization-annotations.js';
 function stripOptionalLiteral(value) {
     if (!value)
         return undefined;
@@ -101,45 +51,6 @@ function resolveGraphScopedAccessEnvelope(head, requestedAccess) {
 function normalizedHex(value) {
     return value.replace(/^0x/i, '').toLowerCase();
 }
-/**
- * Ops kill-switch for the #1549 bounded SWM read. Set `DKG_DISABLE_SWM_KA_BOUND=1`
- * to fall back to the unbounded read with no redeploy. Read here at the
- * orchestration boundary so `deriveSwmKaGraphBound` (in `swm-ka-bound.ts`) stays a
- * deterministic identity transform.
- */
-function swmKaBoundDisabled() {
-    return process.env.DKG_DISABLE_SWM_KA_BOUND === '1';
-}
-/**
- * TTL cap on the in-memory negative reconcile memo (#1609) — the longest a
- * "no local SWM snapshot" verdict may be trusted without a fresh scan even
- * when no write-generation change was observed. Bounds the exposure to any
- * SWM writer invisible to the adapter's write-generation counter (e.g. a
- * second process mutating a shared oxigraph-server) to "≤ TTL late", never
- * "never". Read per call (like `swmKaBoundDisabled`) so ops and tests can
- * retune it without a redeploy.
- */
-const VM_RECONCILE_NEGATIVE_TTL_MS_DEFAULT = 600_000;
-function vmReconcileNegativeTtlMs() {
-    const raw = Number(process.env['DKG_VM_RECONCILE_NEGATIVE_TTL_MS']);
-    return Number.isFinite(raw) && raw > 0 ? raw : VM_RECONCILE_NEGATIVE_TTL_MS_DEFAULT;
-}
-/** LRU cap for the negative reconcile memo — bounds memory across CGs × roots. */
-const VM_RECONCILE_NEGATIVE_MEMO_MAX_ENTRIES = 4096;
-const FINALIZATION_SWM_PAGE_ROWS_DEFAULT = 1_000;
-const FINALIZATION_SWM_MAX_ROWS_DEFAULT = 250_000;
-const FINALIZATION_SWM_MAX_BYTES_DEFAULT = 128 * 1024 * 1024;
-function positiveIntegerEnv(name, fallback) {
-    const parsed = Number(process.env[name]);
-    return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
-}
-function finalizationSwmResultBudget() {
-    return {
-        pageRows: positiveIntegerEnv('DKG_FINALIZATION_SWM_PAGE_ROWS', FINALIZATION_SWM_PAGE_ROWS_DEFAULT),
-        maxRows: positiveIntegerEnv('DKG_FINALIZATION_SWM_MAX_ROWS', FINALIZATION_SWM_MAX_ROWS_DEFAULT),
-        maxBytesEstimate: positiveIntegerEnv('DKG_FINALIZATION_SWM_MAX_BYTES', FINALIZATION_SWM_MAX_BYTES_DEFAULT),
-    };
-}
 function isLegacyFinalizationEventBus(value) {
     return value !== undefined
         && typeof value.emit === 'function';
@@ -172,32 +83,15 @@ export class FinalizationHandler {
     lifecycle;
     processedUals = new Set();
     // Forward-prevention for the cgId-resolution race (RS heal): chain-authoritative
-    // Legacy batch-id or graph-scoped KA-id -> cgId bindings, cached
-    // POSITIVE-ONLY. A 0/miss is NEVER cached: caching a miss before the on-chain
-    // KA->CG binding lands would pin finalization to the legacy fallback forever.
+    // KA-id -> cgId bindings, cached POSITIVE-ONLY. A 0/miss is NEVER cached:
+    // caching a miss before the on-chain KA->CG binding lands would pin
+    // finalization to the local fallback forever.
     chainCgIdByLookupId = new Map();
-    // #1609 (2026-07-11/12 testnet incident): the write-generation source backing
-    // the negative reconcile memo below. `null` when the store's adapter doesn't
-    // track write generations — the memo is then DISABLED and every reconcile
-    // scans (fail-open), matching pre-memo behavior.
-    graphWriteGen;
-    // Negative memo for `findSwmSnapshotForMerkleRoot`: "this (cg, namespace,
-    // root) had NO matching local SWM snapshot at write generation G". Unlike
-    // `chainCgIdByLookupId` above, caching the negative here is sound BECAUSE it
-    // is generation-gated: the verdict is only replayed while the store proves
-    // no local write has touched the CG since the scan. LRU, in-memory only —
-    // a restart clears it (fail-open).
-    negativeSnapshotMemo = new Map();
-    /** Legacy WorkspaceOperation presence per (cg, namespace), gated the same way. */
-    legacySwmOperationsMemo = new Map();
-    /** Equivalent finalization/reconcile reads share one promise until it settles. */
-    scanSingleFlights = new Map();
     recoveryWorker;
     finalizationRecoveryEligibility;
     constructor(store, chain, optionsOrEventBus, legacyResolveContextGraphOnChainId, legacyMarkContextGraphMetaDirtyFromQuads, legacyLifecycleLogOptions) {
         const options = normalizeFinalizationHandlerOptions(optionsOrEventBus, legacyResolveContextGraphOnChainId, legacyMarkContextGraphMetaDirtyFromQuads, legacyLifecycleLogOptions);
         this.store = store;
-        this.graphWriteGen = asGraphWriteRevisionSource(store);
         this.chain = chain;
         this.eventBus = options.eventBus;
         this.resolveContextGraphOnChainId = options.resolveContextGraphOnChainId;
@@ -256,7 +150,6 @@ export class FinalizationHandler {
         });
         if (liveAdmission.status === 'invalid')
             return;
-        let envelope;
         let candidate;
         if (liveAdmission.status === 'admitted') {
             const liveCandidate = liveAdmission.input.candidate;
@@ -317,22 +210,16 @@ export class FinalizationHandler {
                     throw new Error(`Unhandled finalization recovery result: ${JSON.stringify(exhaustive)}`);
                 }
             }
-            envelope = {
-                rawMessage: data,
-                msg: liveAdmission.message,
-                graphAdmission: { ok: true, value: candidate },
-            };
         }
         else {
-            envelope = this.decodeFinalizationEnvelope(data);
-        }
-        if (!envelope)
+            this.ignoreUnscopedFinalization(data, contextGraphId);
             return;
-        // Compatibility path for legacy envelopes and deployments without the
-        // durable recovery inbox.
+        }
+        // A deployment without the durable recovery inbox applies the envelope
+        // unjournaled.
         for (let attempt = 0; attempt < 2; attempt += 1) {
             try {
-                await this.processFinalizationEnvelope(envelope, contextGraphId, sourcePeerId);
+                await this.processUnjournaledFinalization(liveAdmission.input);
                 return;
             }
             catch (error) {
@@ -350,13 +237,9 @@ export class FinalizationHandler {
             }
         }
     }
-    decodeFinalizationEnvelope(rawMessage) {
+    decodeFinalizationMessageOrWarn(rawMessage) {
         try {
-            const msg = decodeFinalizationMessage(rawMessage);
-            return {
-                rawMessage,
-                msg,
-            };
+            return decodeFinalizationMessage(rawMessage);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -443,276 +326,14 @@ export class FinalizationHandler {
             return undefined;
         }
     }
-    async processFinalizationEnvelope(envelope, contextGraphId, sourcePeerId) {
-        let ctx = createOperationContext('gossip');
-        let resolvedTargetContextGraphId;
-        const { rawMessage, msg, graphAdmission } = envelope;
+    /** Apply a graph-scoped envelope on a deployment without the durable recovery inbox. */
+    async processUnjournaledFinalization(input) {
+        const { msg } = input.candidate;
+        const ctx = msg.operationId
+            ? createOperationContext('gossip', msg.operationId)
+            : createOperationContext('gossip');
         try {
-            resolvedTargetContextGraphId = msg.targetContextGraphId || undefined;
-            if (msg.operationId) {
-                ctx = createOperationContext('gossip', msg.operationId);
-            }
-            const isGraphScoped = msg.contentScopeVersion === GRAPH_KA_CONTENT_SCOPE_VERSION;
-            if (isGraphScoped) {
-                if (!graphAdmission?.ok) {
-                    this.log.warn(ctx, `Finalization: invalid graph-scoped envelope for ${msg.ual || '(missing UAL)'}: `
-                        + `${graphAdmission?.reason ?? 'decode-failed'}`);
-                    return 'deferred';
-                }
-                return await this.recovery.processUnjournaled({
-                    rawMessage,
-                    contextGraphId,
-                    ...(sourcePeerId ? { sourcePeerId } : {}),
-                    candidate: graphAdmission.value,
-                });
-            }
-            if (msg.contextGraphId && msg.contextGraphId !== contextGraphId) {
-                // #1100: same guard as GossipPublishHandler — frames of other gossip
-                // message types decode "successfully" with garbage in this field, so
-                // only WARN when the mismatched value is a plausible CG id.
-                if (!validateContextGraphId(msg.contextGraphId).valid)
-                    return 'deferred';
-                this.log.warn(ctx, `Finalization: contextGraphId "${msg.contextGraphId.slice(0, 120)}" does not match topic "${contextGraphId}", ignoring`);
-                return 'deferred';
-            }
-            // Deduplicate: skip if we already successfully processed this UAL
-            const dedupeKey = `${msg.ual}:${msg.txHash}`;
-            if (this.processedUals.has(dedupeKey)) {
-                this.log.info(ctx, `Finalization: already processed ${msg.ual}, skipping duplicate`);
-                return 'already-confirmed';
-            }
-            if (msg.contentScopeVersion !== undefined
-                && msg.contentScopeVersion !== 0) {
-                this.log.warn(ctx, `Finalization: unsupported content scope version ${msg.contentScopeVersion}, ignoring`);
-                return 'deferred';
-            }
-            if (!msg.ual || !msg.txHash || msg.rootEntities.length === 0) {
-                this.log.warn(ctx, `Finalization: incomplete message (ual=${msg.ual}, txHash=${msg.txHash}, roots=${msg.rootEntities.length}, scope=${msg.contentScopeVersion ?? 0}), ignoring`);
-                return 'deferred';
-            }
-            const blockNumber = protobufScalarToNumber(msg.blockNumber);
-            const startKAId = protobufScalarToBigInt(msg.startKAId);
-            const endKAId = protobufScalarToBigInt(msg.endKAId);
-            let batchIdForResolve = 0n;
-            try {
-                batchIdForResolve = protobufScalarToBigInt(msg.batchId);
-            }
-            catch {
-                batchIdForResolve = 0n;
-            }
-            const ctxGraphId = await this.resolveFinalizationContextGraphId(contextGraphId, msg.targetContextGraphId || undefined, batchIdForResolve, ctx);
-            resolvedTargetContextGraphId = ctxGraphId;
-            // Validate sub-graph name from gossip — reject invalid names entirely
-            let subGraphName;
-            if (msg.subGraphName) {
-                const sgVal = validateSubGraphName(msg.subGraphName);
-                if (sgVal.valid) {
-                    subGraphName = msg.subGraphName;
-                }
-                else {
-                    this.log.warn(ctx, `Finalization: rejected message with invalid subGraphName "${msg.subGraphName}": ${sgVal.reason}`);
-                    return 'deferred';
-                }
-            }
-            // Dedup guard: skip if this batch was already promoted (e.g. by ChainEventPoller).
-            // Read-both (review F5): also ASK the label `_meta` — the minimal
-            // per-cgId partition shape carries no `dkg:status` row.
-            const targetMetaGraph = ctxGraphId
-                ? contextGraphMetaUri(contextGraphId, ctxGraphId)
-                : `did:dkg:context-graph:${contextGraphId}/_meta`;
-            const alreadyPromoted = await this.isAlreadyConfirmed(msg.ual, targetMetaGraph, `did:dkg:context-graph:${contextGraphId}/_meta`);
-            if (alreadyPromoted) {
-                this.markProcessed(dedupeKey);
-                this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_already_confirmed', {
-                    ...msg,
-                    targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                }));
-                this.log.info(ctx, `Finalization: ${msg.ual} already confirmed in ${ctxGraphId ? `context graph ${ctxGraphId}` : 'context graph'}, skipping`);
-                return 'already-confirmed';
-            }
-            // #1549: read this KA's per-author SWM under-graphs first, widening to today's
-            // unbounded read on empty-or-mismatch. All of the bound/widen policy — and the
-            // reasoning for why it is safe — lives in storage's
-            // `loadSharedMemorySliceWithKaBoundFallback`, which owns the widen.
-            const { quads: sharedMemoryQuads, matched: merkleMatchedQuads } = await this.loadFinalizationSwmSlice(contextGraphId, msg.rootEntities, subGraphName, swmKaBoundDisabled() ? undefined : deriveSwmKaGraphBound(startKAId, endKAId), msg.kcMerkleRoot, async () => {
-                const privateRoots = await this.getPrivateRootsFromMeta(contextGraphId, msg.rootEntities, subGraphName);
-                const allowGeneratedCatalogFloor = await this.allowsGeneratedCatalogFloor(contextGraphId, ctxGraphId);
-                return (quads) => this.sharedMemoryQuadsMatchingMerkle(contextGraphId, quads, privateRoots, msg.kcMerkleRoot, allowGeneratedCatalogFloor);
-            });
-            if (sharedMemoryQuads.length > 0) {
-                if (merkleMatchedQuads) {
-                    const batchId = protobufScalarToBigInt(msg.batchId);
-                    // PR #845 review #9: derive `txIndex` from the verified receipt
-                    // (via `verifyOnChain`), NOT from gossip-supplied `msg.txIndex`.
-                    // The latter is trust-based; a peer can forge an inflated index
-                    // for a real publish `txHash` and lock out a legitimate
-                    // same-block update on the receiver. The verified value comes
-                    // from the on-chain log we matched (`log.transactionIndex`).
-                    const { verified, authorAddress, txIndex: verifiedTxIndex } = await this.verifyOnChain(msg.txHash, blockNumber, msg.kcMerkleRoot, msg.publisherAddress, startKAId, endKAId, ctx, ctxGraphId, batchId);
-                    if (verified) {
-                        // Codex r5b — drop the rolling-upgrade legacy-publisher
-                        // fallback. Earlier rounds inferred same-graph intent from
-                        // `targetContextGraphId === local-on-chain-id-for(contextGraphId)`,
-                        // but Codex r5b correctly observed that signal is ambiguous:
-                        // it ALSO matches an explicit-remap-to-self publish (one where
-                        // the legacy publisher passed `subContextGraphId === ownCG's
-                        // own on-chain id` to deliberately drop the root copy). Both
-                        // shapes hit `targetContextGraphId === local id` on the wire,
-                        // so the fallback would re-add a root copy that the publisher
-                        // had intentionally removed — a data-isolation regression.
-                        //
-                        // The cure is worse than the disease: trading a hard
-                        // data-isolation bug for a soft query-discoverability gap is
-                        // unacceptable. Without an unambiguous version/intent signal
-                        // on the wire, a legacy publisher's same-graph publish stays
-                        // queryable on receivers via per-cgId partitions but not via
-                        // the bare `<cg>` label until the publisher upgrades to a
-                        // tristate-emitting build and re-emits. New publishers always
-                        // set the tristate (encoded with explicit KEEP/DROP) so the
-                        // gap is bounded by the upgrade window. PR #779 has not
-                        // shipped to any production peer yet, so this is the right
-                        // moment to harden the contract.
-                        const requestedKeepRootCopyOnLabel = msg.keepRootCopyOnLabel === true;
-                        // PR #845 review #9: tiebreaker comes from chain-truth.
-                        // verifyOnChain may not yield a txIndex if the matched event
-                        // shape didn't carry it (e.g. mocks). Fall back to 0 in that
-                        // case — matches pre-#845 ordering.
-                        const finalizationVersion = {
-                            blockNumber,
-                            txIndex: typeof verifiedTxIndex === 'number' ? verifiedTxIndex : 0,
-                        };
-                        // PR #845 review #10: when same-graph dual-write is requested,
-                        // BOTH the per-cgId target meta and the root label meta
-                        // (`<cg>/_meta`) get rewritten. The pre-#845 code only guarded
-                        // the per-cgId target, so a stale finalization could pass that
-                        // check while an update had already stamped a newer version in
-                        // the root label meta — the dual-write then re-inserted the
-                        // old root-label data + meta on top of the update. Acquire the
-                        // label-meta lock too (when dual-writing), and downgrade to
-                        // per-cgId-only if the label projection is newer.
-                        const isDualWrite = requestedKeepRootCopyOnLabel
-                            && !!ctxGraphId
-                            && !subGraphName;
-                        const defaultMeta = `did:dkg:context-graph:${contextGraphId}/_meta`;
-                        // PR #845 review #7: TOCTOU — serialise check + promotion +
-                        // version stamp under the per-KA materialization lock so a
-                        // concurrent stale writer cannot interleave between our
-                        // `shouldApplyMaterialization` and `writeMaterializedVersion`.
-                        const outcome = await this.applyVerifiedFinalization({
-                            contextGraphId,
-                            sharedMemoryQuads: merkleMatchedQuads,
-                            ual: msg.ual,
-                            rootEntities: msg.rootEntities,
-                            publisherAddress: msg.publisherAddress,
-                            txHash: msg.txHash,
-                            blockNumber,
-                            startKAId,
-                            endKAId,
-                            batchId: protobufScalarToBigInt(msg.batchId),
-                            ctxGraphId,
-                            subGraphName,
-                            authorAddress,
-                            finalizationVersion,
-                            targetMetaGraph,
-                            defaultMeta,
-                            isDualWrite,
-                            ctx,
-                        });
-                        if (outcome === 'stale-target') {
-                            this.markProcessed(dedupeKey);
-                            this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_stale_target', {
-                                ...msg,
-                                targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                                rootEntityCount: msg.rootEntities.length,
-                                swmStatementCount: merkleMatchedQuads.length,
-                                subGraphName,
-                                blockNumber,
-                                batchId,
-                                outcome,
-                                reason: 'newer update already materialized',
-                            }));
-                            this.log.info(ctx, `Finalization: a newer update is already materialised for ${msg.ual}, skipping stale publish promotion`);
-                            return 'already-confirmed';
-                        }
-                        this.markProcessed(dedupeKey);
-                        this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_applied', {
-                            ...msg,
-                            targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                            rootEntityCount: msg.rootEntities.length,
-                            swmStatementCount: merkleMatchedQuads.length,
-                            subGraphName,
-                            blockNumber,
-                            batchId,
-                            outcome,
-                            retryable: false,
-                        }));
-                        this.log.info(ctx, `Finalization: promoted SWM snapshot to ${ctxGraphId ? `context graph ${ctxGraphId}` : 'canonical'} for ${msg.ual} (tx=${msg.txHash.slice(0, 10)}…)`);
-                        return 'applied';
-                    }
-                    this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_verification_failed', {
-                        ...msg,
-                        targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                        rootEntityCount: msg.rootEntities.length,
-                        swmStatementCount: merkleMatchedQuads.length,
-                        subGraphName,
-                        blockNumber,
-                        batchId,
-                        outcome: 'deferred',
-                        retryable: true,
-                        reason: 'on-chain verification failed',
-                        level: 'warn',
-                    }));
-                    this.log.info(ctx, `Finalization: on-chain verification failed for ${msg.ual}, will retry via ChainEventPoller`);
-                    return 'deferred';
-                }
-                this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_merkle_mismatch', {
-                    ...msg,
-                    targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                    rootEntityCount: msg.rootEntities.length,
-                    swmStatementCount: sharedMemoryQuads.length,
-                    subGraphName,
-                    blockNumber,
-                    batchId: protobufScalarToBigInt(msg.batchId),
-                    outcome: 'deferred',
-                    retryable: true,
-                    reason: 'shared memory merkle root mismatch',
-                    level: 'warn',
-                }));
-                this.log.info(ctx, `Finalization: merkle mismatch for ${msg.ual}, shared memory data differs from published`);
-            }
-            else {
-                this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_no_data', {
-                    ...msg,
-                    targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                    rootEntityCount: msg.rootEntities.length,
-                    swmStatementCount: 0,
-                    subGraphName,
-                    blockNumber,
-                    batchId: protobufScalarToBigInt(msg.batchId),
-                    outcome: 'deferred',
-                    retryable: true,
-                    reason: 'no shared memory data',
-                    level: 'warn',
-                }));
-                this.log.info(ctx, `Finalization: no shared memory data for ${msg.ual}, peer missed SWM sharing`);
-            }
-            // Fallback: no matching shared memory data. The data will arrive via
-            // the regular publish topic broadcast or ChainEventPoller sync.
-            this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_payload_sync_required', {
-                ...msg,
-                targetContextGraphId: ctxGraphId ?? msg.targetContextGraphId,
-                rootEntityCount: msg.rootEntities.length,
-                swmStatementCount: sharedMemoryQuads.length,
-                subGraphName,
-                blockNumber,
-                batchId: protobufScalarToBigInt(msg.batchId),
-                outcome: 'deferred',
-                retryable: true,
-                reason: 'no matching SWM snapshot',
-                level: 'warn',
-            }));
-            this.log.info(ctx, `Finalization: ${msg.ual} requires full payload sync (no matching SWM snapshot)`);
-            return 'deferred';
+            return await this.recovery.processUnjournaled(input);
         }
         catch (err) {
             if (err instanceof StoreSchedulerBusyError)
@@ -720,8 +341,7 @@ export class FinalizationHandler {
             const errMsg = err instanceof Error ? err.message : String(err);
             this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_failed', {
                 ...msg,
-                contextGraphId: msg.contextGraphId || contextGraphId,
-                targetContextGraphId: resolvedTargetContextGraphId ?? msg.targetContextGraphId,
+                contextGraphId: msg.contextGraphId || input.contextGraphId,
                 rootEntityCount: msg.rootEntities.length,
                 outcome: 'failed',
                 retryable: true,
@@ -732,6 +352,36 @@ export class FinalizationHandler {
             return 'deferred';
         }
     }
+    /**
+     * Only graph-scoped finalization is materialized. A message without that
+     * scope names root entities instead of the KA's own graph, so this node
+     * holds no exact copy to verify it against. Its KA reaches Verified Memory
+     * through chain reconcile, which fetches it from peers.
+     */
+    ignoreUnscopedFinalization(data, contextGraphId) {
+        const msg = this.decodeFinalizationMessageOrWarn(data);
+        // Frames of other gossip message types decode "successfully" with garbage
+        // fields (#1100), so only report what plausibly is a finalization.
+        if (!msg
+            || !msg.ual
+            || !msg.txHash
+            || (msg.contextGraphId && !validateContextGraphId(msg.contextGraphId).valid)) {
+            return;
+        }
+        const ctx = msg.operationId
+            ? createOperationContext('gossip', msg.operationId)
+            : createOperationContext('gossip');
+        const reason = `content scope ${msg.contentScopeVersion ?? 0} is not graph-scoped`;
+        this.lifecycle.record(ctx, finalizationLifecycleDecision('finalization_unsupported_scope', {
+            ...msg,
+            contextGraphId: msg.contextGraphId || contextGraphId,
+            rootEntityCount: msg.rootEntities.length,
+            outcome: 'ignored',
+            retryable: false,
+            reason,
+        }));
+        this.log.info(ctx, `Finalization: ignoring ${msg.ual}: ${reason}`);
+    }
     /** Resolve and verify the exact RDF state that a graph-scoped command may apply. */
     async prepareGraphScopedMaterialization(input) {
         const { candidate: parsed, contextGraphId, sourcePeerId } = input;
@@ -1017,8 +667,14 @@ export class FinalizationHandler {
         if (resolution.status === 'absent')
             return undefined;
         if (resolution.status === 'invalid') {
-            this.log.warn(ctx, `Chain-reconcile: confirmed graph-scoped VM is invalid for ${input.ual} `
-                + `(${resolution.reason})`);
+            if (resolution.reason === 'not-current') {
+                // An intact copy of an earlier version: the caller fetches the current one.
+                this.log.info(ctx, `Chain-reconcile: confirmed graph-scoped VM for ${input.ual} is not the current version`);
+            }
+            else {
+                this.log.warn(ctx, `Chain-reconcile: confirmed graph-scoped VM is invalid for ${input.ual} `
+                    + `(${resolution.reason})`);
+            }
             return 'no-swm';
         }
         await this.advanceExactGraphScopedVersion({
@@ -1124,14 +780,13 @@ export class FinalizationHandler {
     }
     /**
      * Resolve and promote the exact graph-scoped SWM assertion for a chain-known
-     * KA. `undefined` means no V2 head exists and the caller may try the legacy
-     * root-operation recovery path; every other result is authoritative for V2.
+     * KA. `undefined` means no V2 head exists and the caller answers `no-swm`;
+     * every other result is authoritative for V2.
      */
     async reconcileGraphScopedKC(input, ctx) {
         const { contextGraphId, onChainCgId, ual, assertionVersion, merkleRoot, publisherAddress, kaId, batchId, versionBlock, authorAddress, versionSnapshot, signal, subGraphName, trustedAssertionEvidence, } = input;
-        // Historical UAL shapes can be valid inputs to the legacy root-scoped
-        // recovery code but cannot name a V2 per-KA graph. Do not let the strict
-        // V2 parser turn those into a terminal "corrupt head" result.
+        // Historical UAL shapes cannot name a V2 per-KA graph. Do not let the
+        // strict V2 parser turn those into a terminal "corrupt head" result.
         try {
             createGraphKnowledgeAssetScope(ual, 1);
         }
@@ -1160,8 +815,7 @@ export class FinalizationHandler {
                 // post-fetch check runs. Re-read the immutable confirmed envelope and
                 // verify the exact VM graph against current chain truth. This remains
                 // fail-closed: absent, invalid, stale, or root-mismatched VM state is
-                // still reported as no-swm, and the legacy all-workspace scan stays
-                // disabled for exact fetch callers.
+                // still reported as no-swm.
                 return (await this.reconcileConfirmedGraphScopedVmWithoutWorkspaceHead({
                     contextGraphId,
                     ual,
@@ -2044,353 +1698,6 @@ export class FinalizationHandler {
             return false;
         }
     }
-    finalizationSwmBucketUri(contextGraphId, subGraphName) {
-        return subGraphName
-            ? new GraphManager(this.store).sharedMemoryUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceGraphUri(contextGraphId);
-    }
-    /**
-     * Read the finalization SWM slice, preferring this KA's per-author under-graphs
-     * and widening to the complete read on empty-or-mismatch (#1549). The widen — and
-     * the reasoning for why the bound is a safe pure accelerator (INV-1 is refuted
-     * under root recurrence, so the bounded read may miss and must widen before the
-     * caller records anything) — lives in storage's
-     * `loadSharedMemorySliceWithKaBoundFallback`. This method only resolves the bucket
-     * URI and the accept predicate; it is a thin finalization-specific adapter.
-     *
-     * #1098/#1099: replicas store gossiped SWM shares in the PER-KA graphs
-     * `…/_shared_memory/{author}/{number}`, not the bare bucket, so the read must span
-     * bucket + per-KA graphs or a replica reports "no shared memory data" and never
-     * materialises the KA into VM.
-     */
-    async loadFinalizationSwmSlice(contextGraphId, rootEntities, subGraphName, kaGraphBound, expectedMerkleRoot, createAccept) {
-        const safeRoots = rootEntities.filter(isSafeIri);
-        if (safeRoots.length === 0)
-            return { quads: [], matched: null };
-        const writeRevision = this.graphWriteGen?.getWriteRevision(`${contextGraphDataUri(contextGraphId)}/`);
-        const key = [
-            'finalization',
-            contextGraphId,
-            subGraphName ?? '',
-            safeRoots.slice().sort().join('\u0001'),
-            kaGraphBound ? `${kaGraphBound.agentAddress}:${kaGraphBound.startNumber}:${kaGraphBound.endNumber}` : '*',
-            ethers.hexlify(expectedMerkleRoot),
-            writeRevision
-                ? `${writeRevision.generation}:${writeRevision.stable ? 'stable' : 'unstable'}`
-                : 'unknown',
-        ].join('\u0000');
-        return this.runScanSingleFlight(key, async () => {
-            const { quads, accepted } = await loadSharedMemorySliceWithKaBoundFallback(this.store, this.finalizationSwmBucketUri(contextGraphId, subGraphName), { rootEntities: safeRoots }, kaGraphBound, {
-                sources: {
-                    bounded: SWM_SLICE_SOURCE_BOUNDED,
-                    widened: SWM_SLICE_SOURCE_WIDENED,
-                    unbounded: SWM_SLICE_SOURCE,
-                },
-                createAccept,
-                queryOptions: { priority: 'background' },
-                resultBudget: finalizationSwmResultBudget(),
-            });
-            return { quads, matched: accepted };
-        });
-    }
-    /** Complete (unbounded) SWM read for the chain-reconcile backstop. */
-    async getSharedMemoryQuadsForRoots(contextGraphId, rootEntities, subGraphName) {
-        const safeRoots = rootEntities.filter(isSafeIri);
-        if (safeRoots.length === 0)
-            return [];
-        return loadSelectedSharedMemoryQuads(this.store, this.finalizationSwmBucketUri(contextGraphId, subGraphName), { rootEntities: safeRoots }, {
-            querySource: SWM_SLICE_SOURCE,
-            queryOptions: { priority: 'background' },
-            resultBudget: finalizationSwmResultBudget(),
-        });
-    }
-    runScanSingleFlight(key, work) {
-        const scope = key.startsWith('finalization\u0000') ? 'finalization' : 'reconcile';
-        const existing = this.scanSingleFlights.get(key);
-        if (existing) {
-            getMetrics().storeScanSingleFlightJoinsTotal.add(1, { scope });
-            return existing;
-        }
-        getMetrics().storeScanSingleFlightActive.add(1, { scope });
-        const running = work().finally(() => {
-            if (this.scanSingleFlights.get(key) === running)
-                this.scanSingleFlights.delete(key);
-            getMetrics().storeScanSingleFlightActive.add(-1, { scope });
-        });
-        this.scanSingleFlights.set(key, running);
-        return running;
-    }
-    verifyMerkleMatch(sharedMemoryQuads, privateRoots, expectedMerkleRoot) {
-        const computedRoot = computeFlatKCRoot(sharedMemoryQuads, privateRoots);
-        return ethers.hexlify(computedRoot) === ethers.hexlify(expectedMerkleRoot);
-    }
-    sharedMemoryQuadsMatchingMerkle(contextGraphId, sharedMemoryQuads, privateRoots, expectedMerkleRoot, allowGeneratedCatalogFloor) {
-        if (this.verifyMerkleMatch(sharedMemoryQuads, privateRoots, expectedMerkleRoot)) {
-            return sharedMemoryQuads;
-        }
-        if (!allowGeneratedCatalogFloor)
-            return null;
-        const withGeneratedCatalog = [
-            ...sharedMemoryQuads,
-            ...generatedPrivateCatalogFloorQuads(contextGraphId),
-        ];
-        if (this.verifyMerkleMatch(withGeneratedCatalog, privateRoots, expectedMerkleRoot)) {
-            return withGeneratedCatalog;
-        }
-        return null;
-    }
-    async storedOnChainContextGraphId(contextGraphId) {
-        const result = await this.store.query(contextGraphOnChainIdBindingQuery(contextGraphId), { source: 'agent.finalization.contextGraphOnChainId' });
-        if (result.type !== 'bindings' || result.bindings.length === 0)
-            return undefined;
-        return stripOptionalLiteral(result.bindings[0]?.['id'])?.trim();
-    }
-    async onChainContextGraphMatchesLocalId(contextGraphId, onChainCgId) {
-        if (onChainCgId === undefined || onChainCgId === null)
-            return false;
-        const normalizedOnChainId = String(onChainCgId).trim();
-        const normalizedContextGraphId = contextGraphId.trim();
-        if (/^\d+$/.test(normalizedContextGraphId) && normalizedContextGraphId === normalizedOnChainId)
-            return true;
-        const liveNameHashMatches = async () => {
-            if (typeof this.chain?.getContextGraphNameHash !== 'function')
-                return false;
-            try {
-                const nameHash = await this.chain.getContextGraphNameHash(BigInt(normalizedOnChainId));
-                return typeof nameHash === 'string' &&
-                    nameHash.toLowerCase() === ethers.keccak256(ethers.toUtf8Bytes(normalizedContextGraphId)).toLowerCase();
-            }
-            catch {
-                return false;
-            }
-        };
-        let resolvedOnChainId;
-        try {
-            resolvedOnChainId = await this.resolveContextGraphOnChainId?.(contextGraphId);
-        }
-        catch {
-            resolvedOnChainId = undefined;
-        }
-        if (sameBigIntLiteral(resolvedOnChainId, normalizedOnChainId)) {
-            return typeof this.chain?.getContextGraphNameHash === 'function'
-                ? liveNameHashMatches()
-                : true;
-        }
-        const storedOnChainId = await this.storedOnChainContextGraphId(contextGraphId);
-        if (sameBigIntLiteral(storedOnChainId, normalizedOnChainId)) {
-            return typeof this.chain?.getContextGraphNameHash === 'function'
-                ? liveNameHashMatches()
-                : true;
-        }
-        return liveNameHashMatches();
-    }
-    async allowsGeneratedCatalogFloor(contextGraphId, onChainCgId) {
-        if (onChainCgId === undefined || onChainCgId === null)
-            return false;
-        if (!this.chain || this.chain.chainId === 'none')
-            return false;
-        const normalizedContextGraphId = contextGraphId.trim();
-        const normalizedOnChainId = String(onChainCgId).trim();
-        const readFinalizedCreation = this.chain.getContextGraphFinalizedCreation;
-        if (typeof readFinalizedCreation === 'function') {
-            try {
-                const creation = await readFinalizedCreation.call(this.chain, BigInt(normalizedOnChainId));
-                if (creation !== undefined) {
-                    const idMatches = /^\d+$/.test(normalizedContextGraphId)
-                        ? normalizedContextGraphId === normalizedOnChainId
-                        : creation.nameHash.toLowerCase() === ethers.keccak256(ethers.toUtf8Bytes(normalizedContextGraphId)).toLowerCase();
-                    return idMatches && creation.accessPolicy === 1;
-                }
-            }
-            catch {
-                // Never mix a partial/failing finalized creation proof with a latest
-                // point read: that can splice two forks into a false-private result.
-                return false;
-            }
-        }
-        if (typeof this.chain.getContextGraphAccessPolicy !== 'function')
-            return false;
-        if (!await this.onChainContextGraphMatchesLocalId(contextGraphId, onChainCgId))
-            return false;
-        try {
-            return Number(await this.chain.getContextGraphAccessPolicy(BigInt(onChainCgId))) === 1;
-        }
-        catch {
-            return false;
-        }
-    }
-    async getPrivateRootsFromMeta(contextGraphId, rootEntities, subGraphName) {
-        const graphManager = new GraphManager(this.store);
-        const wsMetaGraph = subGraphName
-            ? graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceMetaGraphUri(contextGraphId);
-        const safeRoots = rootEntities.filter(isSafeIri);
-        if (safeRoots.length === 0)
-            return [];
-        const values = safeRoots.map(r => `<${r}>`).join(' ');
-        const sparql = `SELECT ?entity ?root WHERE {
-      GRAPH <${wsMetaGraph}> {
-        VALUES ?entity { ${values} }
-        ?entity <${DKG_NS}privateMerkleRoot> ?root .
-      }
-    }`;
-        const roots = [];
-        try {
-            const result = await this.store.query(sparql, { source: 'agent.finalization.privateRoots' });
-            if (result.type === 'bindings') {
-                for (const row of result.bindings) {
-                    const hex = row['root'].replace(/^"(.*)".*$/, '$1').replace(/^0x/, '');
-                    if (hex.length === 64) {
-                        const bytes = new Uint8Array(32);
-                        for (let i = 0; i < 32; i++)
-                            bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-                        roots.push(bytes);
-                    }
-                }
-            }
-        }
-        catch { /* metadata may not exist */ }
-        return roots;
-    }
-    /**
-     * Recover the publisher's `keepRootCopyOnLabel` decision for these roots from
-     * SWM workspace meta. The publisher persists `<root> dkg:keepRootCopyOnLabel
-     * "true"|"false"` at publish time — the durable equivalent of the gossip
-     * envelope flag — and it replicates to subscribers alongside the per-root
-     * `privateMerkleRoot`. Returns:
-     *   - `true`      — a matched root explicitly kept the root-label copy,
-     *   - `false`     — explicitly dropped (remap / explicit-subCG publish),
-     *   - `undefined` — no signal persisted (legacy publish); the caller defaults
-     *                   to per-cgId-only so a dropped root copy is never re-added.
-     * An explicit `true` wins over `false` across the matched roots: a same-graph
-     * publish demands the root copy exist.
-     */
-    async getKeepRootCopySignal(contextGraphId, rootEntities, subGraphName) {
-        const graphManager = new GraphManager(this.store);
-        const wsMetaGraph = subGraphName
-            ? graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceMetaGraphUri(contextGraphId);
-        const safeRoots = rootEntities.filter(isSafeIri);
-        if (safeRoots.length === 0)
-            return undefined;
-        const values = safeRoots.map(r => `<${r}>`).join(' ');
-        const sparql = `SELECT ?v WHERE {
-      GRAPH <${assertSafeIri(wsMetaGraph)}> {
-        VALUES ?root { ${values} }
-        ?root <${KEEP_ROOT_COPY_PREDICATE}> ?v .
-      }
-    }`;
-        try {
-            const result = await this.store.query(sparql, { source: 'agent.finalization.keepRootCopySignal' });
-            if (result.type !== 'bindings' || result.bindings.length === 0)
-                return undefined;
-            let sawFalse = false;
-            for (const row of result.bindings) {
-                const v = String(row['v']).replace(/^"(.*)".*$/, '$1');
-                if (v === 'true')
-                    return true;
-                if (v === 'false')
-                    sawFalse = true;
-            }
-            return sawFalse ? false : undefined;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    async getPublisherPeerIdFromMeta(contextGraphId, rootEntities, subGraphName) {
-        const graphManager = new GraphManager(this.store);
-        const wsMetaGraph = subGraphName
-            ? graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceMetaGraphUri(contextGraphId);
-        const safeRoots = rootEntities.filter(isSafeIri);
-        if (safeRoots.length === 0)
-            return undefined;
-        const values = safeRoots.map(r => `<${r}>`).join(' ');
-        const PROV = 'http://www.w3.org/ns/prov#';
-        // GH #748: prefer the dedicated `dkg:publisherPeerId` field (peer-ID
-        // literal); fall back to literal-form `prov:wasAttributedTo` for legacy
-        // un-migrated SWM rows. Skip URI form — that's an agent DID, not a
-        // peer ID, and downstream dials a libp2p peer with this value.
-        //
-        // `FILTER(BOUND(?peerId))` guards the LIMIT 1: without it, an op with
-        // `rootEntity` but neither peer-ID source produces an unbound `?peerId`
-        // that LIMIT could pick. The caller's `wsPeerId || publisherAddress`
-        // fallback would then store an EVM address where a libp2p peer ID is
-        // expected. With BOUND, only ops carrying a real peer-ID match.
-        const sparql = `SELECT ?peerId WHERE {
-      GRAPH <${wsMetaGraph}> {
-        VALUES ?root { ${values} }
-        ?op <${DKG_NS}rootEntity> ?root .
-        OPTIONAL { ?op <${DKG_NS}publisherPeerId> ?pidField }
-        OPTIONAL { ?op <${PROV}wasAttributedTo> ?attrField . FILTER(isLiteral(?attrField)) }
-        BIND(COALESCE(?pidField, ?attrField) AS ?peerId)
-        FILTER(BOUND(?peerId))
-      }
-    } LIMIT 1`;
-        try {
-            const result = await this.store.query(sparql, { source: 'agent.finalization.publisherPeerId' });
-            if (result.type === 'bindings' && result.bindings.length > 0) {
-                const raw = result.bindings[0]['peerId'];
-                const peerId = raw.replace(/^"(.*)".*$/, '$1');
-                if (peerId && peerId !== 'unknown')
-                    return peerId;
-            }
-        }
-        catch { /* shared memory metadata may not exist */ }
-        return undefined;
-    }
-    /**
-     * Shared SWM→VM promotion under the per-KA materialization lock(s).
-     *
-     * Extracted verbatim from the former `promoteUnderLocks`/`runUnderLocks`
-     * inline closure in `handleFinalizationMessage` (PR #845's TOCTOU-safe
-     * promotion) so BOTH the gossip path and the chain-driven reconciliation
-     * path (`handleChainReconciledKC`) share one implementation. Behavior is
-     * identical to the gossip path; the only change is that the captured locals
-     * are now explicit params.
-     *
-     * Serialises check + promotion + version stamp under the per-KA lock so a
-     * concurrent stale writer cannot interleave between `shouldApplyMaterialization`
-     * and `writeMaterializedVersion`. When dual-writing (same-graph keep-root),
-     * both the per-cgId target meta and the root-label meta are guarded; if the
-     * root label has a newer projection (an applied update), the dual-write
-     * portion is skipped so we don't clobber it.
-     */
-    async applyVerifiedFinalization(input) {
-        const { contextGraphId, sharedMemoryQuads, ual, rootEntities, publisherAddress, txHash, blockNumber, startKAId, endKAId, batchId, ctxGraphId, subGraphName, authorAddress, finalizationVersion, targetMetaGraph, defaultMeta, isDualWrite, ctx, } = input;
-        const promoteUnderLocks = async () => {
-            if (!(await shouldApplyMaterialization(this.store, targetMetaGraph, ual, finalizationVersion))) {
-                return 'stale-target';
-            }
-            let effectiveKeepRoot = isDualWrite;
-            if (isDualWrite) {
-                if (!(await shouldApplyMaterialization(this.store, defaultMeta, ual, finalizationVersion))) {
-                    // Per-cgId is stale-or-equal but ROOT label has a
-                    // newer projection (an applied update). Skip the
-                    // dual-write portion so we don't clobber it.
-                    effectiveKeepRoot = false;
-                    this.log.info(ctx, `Finalization: root-label projection is newer for ${ual}; downgrading to per-cgId-only promotion`);
-                }
-            }
-            await this.promoteSharedMemoryToCanonical(contextGraphId, sharedMemoryQuads, ual, rootEntities, publisherAddress, txHash, blockNumber, startKAId, endKAId, batchId, ctx, ctxGraphId, subGraphName, authorAddress, effectiveKeepRoot);
-            await writeMaterializedVersion(this.store, targetMetaGraph, ual, finalizationVersion);
-            if (effectiveKeepRoot) {
-                await writeMaterializedVersion(this.store, defaultMeta, ual, finalizationVersion);
-            }
-            return 'promoted';
-        };
-        // Nested per-graph locks. Acquired in sorted order to prevent
-        // cross-deadlock with any other call site that might one day
-        // also lock multiple metas.
-        const lockOrder = isDualWrite
-            ? [defaultMeta, targetMetaGraph].sort()
-            : [targetMetaGraph];
-        if (lockOrder.length === 1) {
-            return withMaterializationLock(lockOrder[0], ual, promoteUnderLocks);
-        }
-        return withMaterializationLock(lockOrder[0], ual, () => withMaterializationLock(lockOrder[1], ual, promoteUnderLocks));
-    }
     /**
      * Resolve the exact graph namespace from canonical graph-scoped metadata.
      * A named assertion stores its namespace in the root metadata graph, so this
@@ -2448,30 +1755,27 @@ export class FinalizationHandler {
             return null;
         }
     }
-    /**
-     * Constant-time exact graph-scoped reconciliation. This method never enters
-     * the legacy workspace-operation scan.
-     */
+    /** Constant-time exact graph-scoped reconciliation. */
     async reconcileExactChainRegisteredKC(rawInput, ctx) {
         const resolvedInput = await this.resolveExactChainReconcileInput(rawInput, ctx);
         if (!resolvedInput) {
-            return { outcome: 'no-swm', legacyEligible: false, input: rawInput };
+            return { outcome: 'no-swm', legacyMarkerEligible: false, input: rawInput };
         }
         const input = resolvedInput;
         const { contextGraphId, onChainCgId, ual, merkleRoot, publisherAddress, kaId, batchId, versionBlock, authorAddress, subGraphName, trustedAssertionEvidence, assertionVersion, versionSnapshot, signal, } = input;
         if (!(await this.verifyChainCgBinding(kaId, onChainCgId, ctx))) {
             this.log.info(ctx, `Chain-reconcile: chain CG binding for ${ual} (ka=${kaId}) not confirmed against cg ${onChainCgId}; deferring to sweep retry`);
-            return { outcome: 'unverified', legacyEligible: false, input };
+            return { outcome: 'unverified', legacyMarkerEligible: false, input };
         }
         const journalReplay = await this.replayMatchingRecoveryEntries(input, ctx);
         // The recovery index predates exact chain-rootCount evidence. Exact asset
         // inspection must therefore verify the resulting local assertion version
         // below instead of treating a same-root replay as sufficient on its own.
         if (journalReplay === 'recovered' && assertionVersion === undefined) {
-            return { outcome: 'already-confirmed', legacyEligible: false, input };
+            return { outcome: 'already-confirmed', legacyMarkerEligible: false, input };
         }
         if (journalReplay === 'retry-pending' && assertionVersion === undefined) {
-            return { outcome: 'receipt-revalidation-pending', legacyEligible: false, input };
+            return { outcome: 'receipt-revalidation-pending', legacyMarkerEligible: false, input };
         }
         if (journalReplay === 'invalidated') {
             this.log.info(ctx, `Chain-reconcile: stale finalization evidence for ${ual} was invalidated; `
@@ -2494,14 +1798,14 @@ export class FinalizationHandler {
             trustedAssertionEvidence,
         }, ctx);
         if (graphScopedOutcome !== undefined) {
-            return { outcome: graphScopedOutcome, legacyEligible: false, input };
+            return { outcome: graphScopedOutcome, legacyMarkerEligible: false, input };
         }
         if (await this.hasGraphScopedMetadata(contextGraphId, ual)) {
             this.log.info(ctx, `Chain-reconcile: graph-scoped metadata exists for ${ual} but its durable workspace head is missing`);
-            return { outcome: 'no-swm', legacyEligible: false, input };
+            return { outcome: 'no-swm', legacyMarkerEligible: false, input };
         }
-        this.log.info(ctx, `Chain-reconcile: exact graph-scoped state is absent for ${ual}; legacy scan is not part of the exact operation`);
-        return { outcome: 'no-swm', legacyEligible: true, input };
+        this.log.info(ctx, `Chain-reconcile: no local graph-scoped state for ${ual}`);
+        return { outcome: 'no-swm', legacyMarkerEligible: true, input };
     }
     /**
      * Reconcile only the exact graph-scoped state named by one UAL. This is the
@@ -2511,64 +1815,28 @@ export class FinalizationHandler {
         return (await this.reconcileExactChainRegisteredKC(input, ctx)).outcome;
     }
     /**
-     * Normal chain reconciliation composes the exact operation with the legacy
-     * workspace scan. The scan remains available only through this ordinary path.
+     * Normal chain reconciliation: the exact operation, then the historical
+     * confirmed marker of a KA materialized before per-KA graphs. A KA with no
+     * local graph-scoped state answers `no-swm` and the caller fetches it from
+     * peers; historical workspace operations are never searched for it.
      */
     async handleChainReconciledKC(rawInput, ctx) {
         const exact = await this.reconcileExactChainRegisteredKC(rawInput, ctx);
-        if (!exact.legacyEligible)
+        if (!exact.legacyMarkerEligible)
             return exact.outcome;
-        const { contextGraphId, onChainCgId, ual, merkleRoot, publisherAddress, kaId, batchId, versionBlock, authorAddress, subGraphName, } = exact.input;
-        const ctxGraphId = onChainCgId.length > 0 ? onChainCgId : undefined;
-        const targetMetaGraph = ctxGraphId
-            ? contextGraphMetaUri(contextGraphId, ctxGraphId)
-            : `did:dkg:context-graph:${contextGraphId}/_meta`;
+        const { contextGraphId, onChainCgId, ual } = exact.input;
+        const rootMetaGraph = `did:dkg:context-graph:${contextGraphId}/_meta`;
+        const targetMetaGraph = onChainCgId.length > 0
+            ? contextGraphMetaUri(contextGraphId, onChainCgId)
+            : rootMetaGraph;
         // The ordinary compatibility path may retain the historical confirmed
         // marker shortcut. Exact RFC-64 fetch cannot use this marker because it
         // proves neither the current assertion version nor the current chain root.
-        if (await this.isAlreadyConfirmed(ual, targetMetaGraph, `did:dkg:context-graph:${contextGraphId}/_meta`)) {
+        if (await this.isAlreadyConfirmed(ual, targetMetaGraph, rootMetaGraph)) {
             this.log.info(ctx, `Chain-reconcile: legacy ${ual} already confirmed in VM, skipping`);
             return 'already-confirmed';
         }
-        // Recover the published roots from the legacy local SWM snapshot. This is
-        // the only operation that may scan historical workspace operations.
-        const snapshot = await this.findSwmSnapshotForMerkleRoot(contextGraphId, merkleRoot, subGraphName, onChainCgId);
-        if (!snapshot) {
-            this.log.info(ctx, `Chain-reconcile: no local SWM snapshot matches the published merkleRoot for ${ual}; deferring to sweep retry`);
-            return 'no-swm';
-        }
-        const { rootEntities, sharedMemoryQuads } = snapshot;
-        const resolvedSubGraphName = snapshot.subGraphName ?? subGraphName;
-        const finalizationVersion = { blockNumber: versionBlock, txIndex: 0 };
-        const keepRootCopyOnLabel = await this.getKeepRootCopySignal(contextGraphId, rootEntities, resolvedSubGraphName);
-        const isDualWrite = keepRootCopyOnLabel === true && !!ctxGraphId && !resolvedSubGraphName;
-        const defaultMeta = `did:dkg:context-graph:${contextGraphId}/_meta`;
-        const outcome = await this.applyVerifiedFinalization({
-            contextGraphId,
-            sharedMemoryQuads,
-            ual,
-            rootEntities,
-            publisherAddress,
-            txHash: '',
-            blockNumber: versionBlock,
-            startKAId: kaId,
-            endKAId: kaId,
-            batchId,
-            ctxGraphId,
-            subGraphName: resolvedSubGraphName,
-            authorAddress,
-            finalizationVersion,
-            targetMetaGraph,
-            defaultMeta,
-            isDualWrite,
-            ctx,
-        });
-        if (outcome === 'stale-target') {
-            this.log.info(ctx, `Chain-reconcile: a newer update is already materialised for ${ual}, skipping`);
-            return 'stale-target';
-        }
-        this.log.info(ctx, `Chain-reconcile: promoted SWM snapshot to VM for ${ual} (ka=${kaId}, cg=${onChainCgId})`);
-        return 'promoted';
+        return exact.outcome;
     }
     /**
      * Decide from local state alone whether an ordinary chain reconcile of one
@@ -2587,14 +1855,16 @@ export class FinalizationHandler {
      *  4. graph-scoped metadata without a head or confirmed copy;
      *  5. the legacy confirmed marker, which that path answers
      *     `already-confirmed` without reading the root;
-     *  6. legacy workspace operations, the root-matched scan: with none in the
-     *     namespaces it searches, nothing local can match any root, so `none`.
+     *  6. nothing else is searched, so everything left is `none`.
      *
      * `confirmed-vm` trusts the root the local copy was confirmed at; a newer
-     * on-chain version is not looked for here. The ordinal walk never revisits a
-     * settled ordinal, so an update already reaches VM through finalization
-     * gossip, the StorageACK pending-update lane, or, when its SWM head is local,
-     * the chain-backed path this method routes it to (`present`).
+     * on-chain version is not looked for here, which keeps the walk free of
+     * chain reads for copies it already holds. The walk never revisits a settled
+     * ordinal either, so an update reaches a held copy through finalization
+     * gossip, the StorageACK pending-update lane, the chain-backed path this
+     * method routes a local SWM head to (`present`) while its ordinal is still
+     * walked, and, for any confirmed copy, the `KnowledgeAssetUpdated` refresh
+     * (`handleKAUpdatedNudge` in the agent's SWM host).
      *
      * Any read failure answers `present`, keeping the caller on its chain path.
      */
@@ -2662,9 +1932,7 @@ export class FinalizationHandler {
         if (await this.isAlreadyConfirmed(ual, targetMetaGraph, rootMetaGraph)) {
             return { kind: 'confirmed-vm', layout: 'legacy' };
         }
-        return await this.hasLegacySwmOperations(contextGraphId, subGraphName)
-            ? LOCAL_CANDIDATE_PRESENT
-            : { kind: 'none' };
+        return { kind: 'none' };
     }
     /**
      * Whether the headless-VM retirement in the chain-backed path would find an
@@ -2681,53 +1949,6 @@ export class FinalizationHandler {
         const result = await this.store.query(`ASK { ${graphs.map((graph) => `{ GRAPH <${assertSafeIri(graph)}> { ?s ?p ?o } }`).join(' UNION ')} }`, { source: 'agent.finalization.localCandidate.swmTwin' });
         return result.type !== 'boolean' || result.value;
     }
-    /**
-     * Whether the root-matched legacy scan (`findSwmSnapshotForMerkleRoot`) has
-     * any WorkspaceOperation to look at: the given namespace, or the root and
-     * every listed sub-graph when none is known. Memoized per CG write
-     * generation, like that scan's negative memo, so a quiet graph answers from
-     * memory for the whole sweep.
-     */
-    async hasLegacySwmOperations(contextGraphId, subGraphName) {
-        const memoKey = `${contextGraphId}\0${subGraphName ?? ''}`;
-        const revision = this.graphWriteGen?.getWriteRevision(`${contextGraphDataUri(contextGraphId)}/`);
-        if (revision?.stable) {
-            const memo = this.legacySwmOperationsMemo.get(memoKey);
-            if (memo
-                && memo.writeGen === revision.generation
-                && Date.now() - memo.recordedAt < vmReconcileNegativeTtlMs()) {
-                return memo.present;
-            }
-        }
-        const graphManager = new GraphManager(this.store);
-        const metaGraphs = subGraphName
-            ? [graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)]
-            : [
-                contextGraphWorkspaceMetaGraphUri(contextGraphId),
-                ...(await graphManager.listSubGraphs(contextGraphId))
-                    .map((name) => graphManager.sharedMemoryMetaUri(contextGraphId, name)),
-            ];
-        const result = await this.store.query(`ASK { ${metaGraphs
-            .map((graph) => `{ GRAPH <${assertSafeIri(graph)}> { ?op <${DKG_NS}rootEntity> ?root } }`)
-            .join(' UNION ')} }`, { source: 'agent.finalization.localCandidate.legacySwmOperations' });
-        const present = result.type !== 'boolean' || result.value;
-        if (revision?.stable) {
-            // Recorded at the pre-probe generation: a racing write flips the gate.
-            this.legacySwmOperationsMemo.delete(memoKey);
-            this.legacySwmOperationsMemo.set(memoKey, {
-                writeGen: revision.generation,
-                recordedAt: Date.now(),
-                present,
-            });
-            while (this.legacySwmOperationsMemo.size > VM_RECONCILE_NEGATIVE_MEMO_MAX_ENTRIES) {
-                const oldest = this.legacySwmOperationsMemo.keys().next().value;
-                if (oldest === undefined)
-                    break;
-                this.legacySwmOperationsMemo.delete(oldest);
-            }
-        }
-        return present;
-    }
     async verifyChainCgBinding(kaId, onChainCgId, ctx) {
         if (!this.chain || this.chain.chainId === 'none' || typeof this.chain.getKAContextGraphId !== 'function') {
             return false;
@@ -2741,784 +1962,5 @@ export class FinalizationHandler {
             return false;
         }
     }
-    /**
-     * Find the local SWM snapshot whose KC merkle root matches the chain
-     * `merkleRoot`, returning its root entities + shared-memory quads.
-     *
-     * SWM workspace meta is written at share-time (before publish), so it carries
-     * no merkle root to look up by — only `?op a dkg:WorkspaceOperation ;
-     * dkg:rootEntity <root>`. We therefore enumerate the candidate operations,
-     * gather each one's SWM quads + private roots, recompute the flat-KC root
-     * (`computeFlatKCRoot`, the same function the gossip path verifies against),
-     * and return the first operation whose computed root equals the chain root.
-     * A match is an authoritative merkle verification.
-     *
-     * Returns `null` when no local operation matches — either the snapshot hasn't
-     * been synced yet (the caller's active-fetch missed / is in flight) or this
-     * KA belongs to a publish this node never shared. Either way the B.2 sweep
-     * retries later.
-     *
-     * Cost note (#1609): the recompute is memoized (`SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE`
-     * + content digest). A *present* KA is resolved by its stamped root directly (fast
-     * path, no scan); the fallback still enumerates every op — it must, because ops
-     * assemble incrementally — but reuses each op's memoized root whenever its content
-     * digest is unchanged, skipping the expensive `computeFlatKCRoot`. So steady-state
-     * reconcile pays one bounded read + a cheap digest per op instead of a full merkle
-     * recompute per op. This is a bridge; OT-RFC-60 makes the root a write-maintained,
-     * indexed property (stamped once at op completion) so the fallback disappears
-     * entirely. The generated-catalog-floor variant keeps the exhaustive recompute
-     * (its match is over quads+floor, not the op's intrinsic stamped root).
-     *
-     * READ memo (#1609, 2026-07-11/12 testnet incident): the #1612 digest memo skips
-     * only the merkle recompute — a never-match KA (a publish this node never shared,
-     * exactly the beacon shape) still paid O(#ops) unbounded SWM CONSTRUCTs on EVERY
-     * sweep tick, forever, stalling the event loop and dropping storage-ACK streams
-     * on big stores. This wrapper adds a write-generation-gated NEGATIVE memo over
-     * the whole scan (floor retry included): a "no match" verdict is replayed
-     * without touching the store while (a) the adapter's write generation for the
-     * CG's graph prefix is unchanged — new SWM only arrives via local writes
-     * (gossip receive, publish share, active fetch), all of which pass the adapter
-     * choke points and bump the generation, so the next call rescans — (b) the
-     * catalog-floor eligibility is unchanged, and (c) the entry is younger than
-     * `vmReconcileNegativeTtlMs()`. A MATCH is never memoized. Stores without the
-     * write-generation capability disable the memo entirely (always scan), and a
-     * restart clears it — every failure mode degrades to a rescan, never a miss.
-     */
-    async findSwmSnapshotForMerkleRoot(contextGraphId, merkleRoot, subGraphName, onChainCgId) {
-        const allowGeneratedCatalogFloor = await this.allowsGeneratedCatalogFloor(contextGraphId, onChainCgId);
-        // Every graph the scan reads — root/sub-graph SWM buckets, their per-KA
-        // under-graphs and `_shared_memory_meta` (op rows, `privateMerkleRoot`,
-        // stamps) — lives under the CG's URI subtree, so one prefix covers all
-        // namespaces of this call. Broader than strictly needed (any CG-local
-        // write invalidates) — that only costs an extra rescan.
-        const memoKey = `${contextGraphId}\0${subGraphName ?? ''}\0${ethers.hexlify(merkleRoot)}`;
-        const swmWritePrefix = `${contextGraphDataUri(contextGraphId)}/`;
-        const preScanRevision = this.graphWriteGen?.getWriteRevision(swmWritePrefix);
-        const preScanGen = preScanRevision?.generation;
-        if (preScanRevision?.stable) {
-            const memo = this.negativeSnapshotMemo.get(memoKey);
-            if (memo) {
-                if (memo.writeGen === preScanGen &&
-                    memo.allowGeneratedCatalogFloor === allowGeneratedCatalogFloor &&
-                    Date.now() - memo.recordedAt < vmReconcileNegativeTtlMs()) {
-                    // Refresh LRU recency; recordedAt stays — the TTL runs from the scan.
-                    this.negativeSnapshotMemo.delete(memoKey);
-                    this.negativeSnapshotMemo.set(memoKey, memo);
-                    return null;
-                }
-                this.negativeSnapshotMemo.delete(memoKey);
-            }
-        }
-        const hit = await this.runScanSingleFlight(['reconcile', memoKey, String(allowGeneratedCatalogFloor), String(preScanGen ?? 'unknown')].join('\u0000'), () => this.scanForSwmSnapshot(contextGraphId, merkleRoot, subGraphName, allowGeneratedCatalogFloor));
-        if (hit)
-            return hit;
-        if (preScanRevision?.stable) {
-            // Record at the PRE-scan generation: any write that raced the scan (or
-            // the scan's own best-effort restamps) flips the gate above, so the next
-            // call rescans rather than replaying a verdict that may predate the write.
-            this.negativeSnapshotMemo.set(memoKey, {
-                writeGen: preScanRevision.generation,
-                recordedAt: Date.now(),
-                allowGeneratedCatalogFloor,
-            });
-            while (this.negativeSnapshotMemo.size > VM_RECONCILE_NEGATIVE_MEMO_MAX_ENTRIES) {
-                const oldest = this.negativeSnapshotMemo.keys().next().value;
-                if (oldest === undefined)
-                    break;
-                this.negativeSnapshotMemo.delete(oldest);
-            }
-        }
-        return null;
-    }
-    /** The authoritative full scan behind {@link findSwmSnapshotForMerkleRoot}. */
-    async scanForSwmSnapshot(contextGraphId, merkleRoot, subGraphName, allowGeneratedCatalogFloor) {
-        // Caller knows the exact namespace → search only that one.
-        if (subGraphName) {
-            const hit = await this.findSwmSnapshotInNamespace(contextGraphId, merkleRoot, subGraphName, allowGeneratedCatalogFloor);
-            return hit ? { ...hit, subGraphName } : null;
-        }
-        // No namespace supplied (the chain-driven path never knows it). Try the
-        // root workspace first, then fall back to every registered sub-graph —
-        // otherwise a KA published into a named sub-graph would stay `no-swm`
-        // forever because its SWM snapshot lives under a sub-graph meta graph,
-        // not the root workspace meta. Return the namespace we matched in so the
-        // caller promotes into the correct data graph.
-        const rootHit = await this.findSwmSnapshotInNamespace(contextGraphId, merkleRoot, undefined, allowGeneratedCatalogFloor);
-        if (rootHit)
-            return { ...rootHit, subGraphName: undefined };
-        let subGraphNames = [];
-        try {
-            subGraphNames = await new GraphManager(this.store).listSubGraphs(contextGraphId);
-        }
-        catch { /* no sub-graphs / store can't enumerate */ }
-        for (const sg of subGraphNames) {
-            const hit = await this.findSwmSnapshotInNamespace(contextGraphId, merkleRoot, sg, allowGeneratedCatalogFloor);
-            if (hit)
-                return { ...hit, subGraphName: sg };
-        }
-        return null;
-    }
-    /**
-     * Search a single SWM namespace (root workspace when `subGraphName` is
-     * undefined, otherwise the named sub-graph's shared-memory meta) for a
-     * WorkspaceOperation whose recomputed flat-KC root matches `merkleRoot`.
-     */
-    async findSwmSnapshotInNamespace(contextGraphId, merkleRoot, subGraphName, allowGeneratedCatalogFloor = false) {
-        const graphManager = new GraphManager(this.store);
-        const wsMetaGraph = subGraphName
-            ? graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceMetaGraphUri(contextGraphId);
-        // The generated-catalog-floor variant matches over quads+floor rather than an
-        // op's intrinsic root, so it cannot be resolved by the stamped intrinsic root —
-        // those CGs (a stable per-CG access policy) keep the exhaustive recompute scan.
-        const useStampIndex = !allowGeneratedCatalogFloor;
-        // FAST PATH — resolve a *present* KA whose op is stamped with the target root via
-        // one indexed lookup (verified authoritatively), instead of recomputing every op's
-        // root. On a miss it falls through to the memoized fallback scan below.
-        if (useStampIndex) {
-            const stamped = await this.findStampedSwmSnapshot(contextGraphId, wsMetaGraph, merkleRoot, subGraphName);
-            if (stamped)
-                return stamped;
-        }
-        const opsBySubject = new Map();
-        try {
-            const memoPatterns = useStampIndex
-                ? `OPTIONAL { ?op <${SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE}> ?memoRoot . }
-          OPTIONAL { ?op <${SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE}> ?memoDigest . }`
-                : '';
-            const result = await this.store.query(`SELECT ?op ?root ?memoRoot ?memoDigest WHERE {
-          GRAPH <${assertSafeIri(wsMetaGraph)}> {
-            ?op <${DKG_NS}rootEntity> ?root .
-            ${memoPatterns}
-          }
-        }`, { source: 'agent.finalization.swmSnapshotCandidates' });
-            if (result.type === 'bindings') {
-                for (const row of result.bindings) {
-                    const op = typeof row['op'] === 'string' ? row['op'].replace(/^<(.*)>$/, '$1') : '';
-                    const root = typeof row['root'] === 'string' ? row['root'].replace(/^<(.*)>$/, '$1') : '';
-                    if (!op || !isSafeIri(root))
-                        continue;
-                    const memo = opsBySubject.get(op) ?? { roots: [] };
-                    if (!memo.roots.includes(root))
-                        memo.roots.push(root);
-                    if (memo.memoRoot === undefined && typeof row['memoRoot'] === 'string') {
-                        memo.memoRoot = row['memoRoot'].replace(/^"(.*)".*$/, '$1');
-                    }
-                    if (memo.memoDigest === undefined && typeof row['memoDigest'] === 'string') {
-                        memo.memoDigest = row['memoDigest'].replace(/^"(.*)".*$/, '$1');
-                    }
-                    opsBySubject.set(op, memo);
-                }
-            }
-        }
-        catch { /* SWM meta may not exist yet */ }
-        if (opsBySubject.size === 0)
-            return null;
-        const opsSorted = [...opsBySubject.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
-        // Ops whose content changed (or were never stamped) get a fresh (root, digest)
-        // memo written after the loop — best-effort: a store hiccup on the memo must
-        // never fail reconcile (correctness comes from the recompute here).
-        const restamp = new Map();
-        const targetHex = ethers.hexlify(merkleRoot);
-        let hit = null;
-        for (const [op, memo] of opsSorted) {
-            const roots = memo.roots;
-            const sharedMemoryQuads = await this.getSharedMemoryQuadsForRoots(contextGraphId, roots, subGraphName);
-            if (sharedMemoryQuads.length === 0)
-                continue;
-            const privateRoots = await this.getPrivateRootsFromMeta(contextGraphId, roots, subGraphName);
-            if (useStampIndex) {
-                const digest = this.swmContentDigest(sharedMemoryQuads, privateRoots);
-                let computedHex;
-                if (memo.memoRoot !== undefined && memo.memoDigest === digest) {
-                    // Content unchanged since the memo was written → reuse the root and skip
-                    // the expensive computeFlatKCRoot. The digest is a pure function of the
-                    // same (quads, privateRoots) computeFlatKCRoot consumes, so digest-equal
-                    // ⇒ root-equal.
-                    computedHex = memo.memoRoot;
-                }
-                else {
-                    computedHex = this.computeOpMerkleRoot(sharedMemoryQuads, privateRoots);
-                    restamp.set(op, { root: computedHex, digest });
-                }
-                if (computedHex === targetHex) {
-                    hit = { rootEntities: roots, sharedMemoryQuads };
-                    break;
-                }
-            }
-            else {
-                const merkleMatchedQuads = this.sharedMemoryQuadsMatchingMerkle(contextGraphId, sharedMemoryQuads, privateRoots, merkleRoot, allowGeneratedCatalogFloor);
-                if (merkleMatchedQuads) {
-                    return { rootEntities: roots, sharedMemoryQuads: merkleMatchedQuads };
-                }
-            }
-        }
-        await this.persistSwmStamps(wsMetaGraph, restamp);
-        return hit;
-    }
-    /**
-     * Cheap content fingerprint of an op's SWM snapshot — a pure function of the same
-     * `(sharedMemoryQuads, privateRoots)` that `computeFlatKCRoot` consumes, but a
-     * plain sorted-sha256 rather than the full skolemize + merkle construction. Used
-     * only to decide whether a memoized root is still valid (digest-equal ⇒ the
-     * content, hence its flat-KC root, is unchanged), never as an authoritative root.
-     */
-    /**
-     * The op's intrinsic flat-KC merkle root (hex) — the expensive recompute the
-     * content-digest memo lets us skip for unchanged ops. A named seam so callers and
-     * tests can attribute the cost.
-     */
-    computeOpMerkleRoot(sharedMemoryQuads, privateRoots) {
-        return ethers.hexlify(computeFlatKCRoot(sharedMemoryQuads, privateRoots));
-    }
-    swmContentDigest(sharedMemoryQuads, privateRoots) {
-        // Unambiguous encoding (NUL field-sep, NL row-sep) matching the SWM-generation
-        // fingerprint convention in `readVmReconcileSwmGen`, so distinct contents cannot
-        // collide to the same digest and cause a wrong memoized-root reuse.
-        const quadLines = sharedMemoryQuads
-            .map((q) => [q.subject, q.predicate, typeof q.object === 'string' ? q.object : String(q.object), q.graph ?? ''].join('\0'))
-            .sort();
-        const privateLines = privateRoots.map((r) => ethers.hexlify(r)).sort();
-        const payload = `${quadLines.join('\n')}\0\0private\0\0${privateLines.join('\n')}`;
-        return createHash('sha256').update(payload, 'utf8').digest('hex');
-    }
-    /**
-     * Replace the (root, content-digest) memo for each op — delete-then-insert so an
-     * op never accumulates duplicate/stale stamp triples. Best-effort; a failure here
-     * leaves the memo absent (next pass recomputes), never wrong.
-     */
-    async persistSwmStamps(wsMetaGraph, restamp) {
-        if (restamp.size === 0)
-            return;
-        try {
-            const quads = [];
-            for (const [op, { root, digest }] of restamp) {
-                await deleteByPatternWithoutCount(this.store, { graph: wsMetaGraph, subject: op, predicate: SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE });
-                await deleteByPatternWithoutCount(this.store, { graph: wsMetaGraph, subject: op, predicate: SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE });
-                quads.push({ subject: op, predicate: SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE, object: `"${root}"`, graph: wsMetaGraph }, { subject: op, predicate: SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE, object: `"${digest}"`, graph: wsMetaGraph });
-            }
-            await this.store.insert(quads);
-        }
-        catch { /* memo is best-effort; the recompute is the source of truth */ }
-    }
-    /**
-     * Fast path for `findSwmSnapshotInNamespace`: resolve the WorkspaceOperation
-     * whose stamped intrinsic root equals `merkleRoot` without recomputing every
-     * op's root. Re-verifies with `verifyMerkleMatch` (authoritative) so a stale
-     * stamp can never promote the wrong snapshot; a stamp that no longer verifies is
-     * dropped so the op falls back into the recompute scan this same pass.
-     */
-    async findStampedSwmSnapshot(contextGraphId, wsMetaGraph, merkleRoot, subGraphName) {
-        const targetHex = ethers.hexlify(merkleRoot);
-        const rootsByOp = new Map();
-        try {
-            const result = await this.store.query(`SELECT ?op ?root WHERE {
-          GRAPH <${assertSafeIri(wsMetaGraph)}> {
-            ?op <${SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE}> "${targetHex}" .
-            ?op <${DKG_NS}rootEntity> ?root .
-          }
-        }`, { source: 'agent.finalization.stampedSwmSnapshot' });
-            if (result.type === 'bindings') {
-                for (const row of result.bindings) {
-                    const op = typeof row['op'] === 'string' ? row['op'].replace(/^<(.*)>$/, '$1') : '';
-                    const root = typeof row['root'] === 'string' ? row['root'].replace(/^<(.*)>$/, '$1') : '';
-                    if (!op || !isSafeIri(root))
-                        continue;
-                    const list = rootsByOp.get(op) ?? [];
-                    list.push(root);
-                    rootsByOp.set(op, list);
-                }
-            }
-        }
-        catch {
-            return null;
-        }
-        for (const [op, roots] of rootsByOp) {
-            const sharedMemoryQuads = await this.getSharedMemoryQuadsForRoots(contextGraphId, roots, subGraphName);
-            if (sharedMemoryQuads.length > 0) {
-                const privateRoots = await this.getPrivateRootsFromMeta(contextGraphId, roots, subGraphName);
-                if (this.verifyMerkleMatch(sharedMemoryQuads, privateRoots, merkleRoot)) {
-                    return { rootEntities: roots, sharedMemoryQuads };
-                }
-            }
-            // The stamp no longer reflects the op's content — drop the whole (root, digest)
-            // memo so the recompute scan re-evaluates and re-stamps it this pass.
-            try {
-                await deleteByPatternWithoutCount(this.store, { graph: wsMetaGraph, subject: op, predicate: SWM_SNAPSHOT_MERKLE_ROOT_PREDICATE });
-                await deleteByPatternWithoutCount(this.store, { graph: wsMetaGraph, subject: op, predicate: SWM_SNAPSHOT_CONTENT_DIGEST_PREDICATE });
-            }
-            catch { /* best-effort self-heal */ }
-        }
-        return null;
-    }
-    async verifyOnChain(txHash, blockNumber, expectedMerkleRoot, expectedPublisher, expectedStartKAId, expectedEndKAId, ctx, ctxGraphId, expectedBatchId) {
-        if (!this.chain || this.chain.chainId === 'none')
-            return { verified: false };
-        if (blockNumber <= 0)
-            return { verified: false };
-        try {
-            // Verify KnowledgeBatchCreated or KCCreated (V10) at the specific block
-            const batchFilter = {
-                eventTypes: ['KnowledgeBatchCreated', 'KCCreated'],
-                fromBlock: blockNumber,
-                toBlock: blockNumber,
-            };
-            let batchVerified = false;
-            // Round 5 review §10 — capture the indexed `author` from the matched
-            // KCCreated event so the caller can populate `dkg:Publication` /
-            // `dkg:authoredBy` provenance on the replica side, mirroring the
-            // originator. `address(0)` here is the unattributed-publish sentinel
-            // (RFC-001 §3.6) and is correctly preserved.
-            let authorAddress;
-            // PR #845 review #9: capture the chain-truth `transactionIndex` from
-            // the matched event so the materialization-version guard does not
-            // have to trust the gossip-supplied `msg.txIndex` (which a peer can
-            // inflate to lock out a legitimate same-block update).
-            let verifiedTxIndex;
-            for await (const event of this.chain.listenForEvents(batchFilter)) {
-                if (event.blockNumber !== blockNumber)
-                    continue;
-                if (txHash && (!event.data['txHash'] || event.data['txHash'].toLowerCase() !== txHash.toLowerCase())) {
-                    continue;
-                }
-                const eventMerkle = typeof event.data['merkleRoot'] === 'string'
-                    ? ethers.getBytes(event.data['merkleRoot'])
-                    : event.data['merkleRoot'];
-                const eventPublisher = event.data['publisherAddress'] ?? '';
-                const eventStartKAId = BigInt(event.data['startKAId'] ?? '0');
-                const eventEndKAId = BigInt(event.data['endKAId'] ?? '0');
-                const merkleMatch = ethers.hexlify(eventMerkle) === ethers.hexlify(expectedMerkleRoot);
-                const publisherMatch = eventPublisher.toLowerCase() === expectedPublisher.toLowerCase();
-                const rangeMatch = eventStartKAId === expectedStartKAId && eventEndKAId === expectedEndKAId;
-                if (merkleMatch && publisherMatch && rangeMatch) {
-                    batchVerified = true;
-                    const eventAuthor = event.data['author'] ?? '';
-                    if (eventAuthor)
-                        authorAddress = eventAuthor;
-                    const rawTxIdx = event.data['txIndex'];
-                    if (typeof rawTxIdx === 'number' && Number.isFinite(rawTxIdx) && rawTxIdx >= 0) {
-                        verifiedTxIndex = rawTxIdx;
-                    }
-                    break;
-                }
-            }
-            if (!batchVerified)
-                return { verified: false };
-            // V10 publish registers the KC to the context graph internally
-            // (no separate addBatchToContextGraph tx / ContextGraphExpanded event).
-            // Skip the legacy ContextGraphExpanded check — the batch verification
-            // above is sufficient for V10.
-            if (ctxGraphId) {
-                if (typeof this.chain.isV10Ready === 'function' && this.chain.isV10Ready()) {
-                    return { verified: true, authorAddress, txIndex: verifiedTxIndex };
-                }
-                try {
-                    const scanWindow = 256;
-                    const headBlock = typeof this.chain.getBlockNumber === 'function'
-                        ? await this.chain.getBlockNumber()
-                        : blockNumber + scanWindow;
-                    const cgFilter = {
-                        eventTypes: ['ContextGraphExpanded'],
-                        fromBlock: blockNumber,
-                        toBlock: Math.min(blockNumber + scanWindow, headBlock),
-                    };
-                    for await (const event of this.chain.listenForEvents(cgFilter)) {
-                        const eventCGId = String(event.data['contextGraphId'] ?? '');
-                        const eventBatchId = BigInt(event.data['batchId'] ?? '0');
-                        if (eventCGId === ctxGraphId && (expectedBatchId === undefined || eventBatchId === expectedBatchId)) {
-                            return { verified: true, authorAddress, txIndex: verifiedTxIndex };
-                        }
-                    }
-                    return { verified: false };
-                }
-                catch {
-                    return { verified: true, authorAddress, txIndex: verifiedTxIndex };
-                }
-            }
-            return { verified: true, authorAddress, txIndex: verifiedTxIndex };
-        }
-        catch (err) {
-            this.log.info(ctx, `Finalization on-chain verification pending (RPC may be lagging): ${err instanceof Error ? err.message : String(err)}`);
-        }
-        return { verified: false };
-    }
-    async promoteSharedMemoryToCanonical(contextGraphId, sharedMemoryQuads, ual, msgRootEntities, publisherAddress, txHash, blockNumber, startKAId, endKAId, batchId, ctx, ctxGraphId, subGraphName, 
-    /**
-     * EIP-712-attested author recovered from `KnowledgeAssetCreated.author`.
-     * Round 5 review §10 — when set, the replica emits matching
-     * `dkg:Publication` / `dkg:authoredBy` triples so agent-provenance via the
-     * `_meta` triplestore is consistent across the originator and every replica.
-     * `address(0)` and missing/empty values are skipped (preserves the
-     * unattributed-publish path's no-author behaviour from RFC-001 §3.6).
-     */
-    authorAddress, 
-    /**
-     * PR #779 same-graph signal: when `true` the publisher kept a root-graph
-     * copy of the canonical quads, so receivers mirror the dual-write so
-     * label-scoped queries resolve. When `false` (or omitted on older
-     * publishers) the publisher used the explicit-`subContextGraphId` /
-     * remap path and deleted its own root copy on purpose — receivers
-     * MUST NOT dual-write or they re-expose the KC under the source CG
-     * label and double-count it in unscoped queries.
-     */
-    keepRootCopyOnLabel) {
-        const graphManager = new GraphManager(this.store);
-        await graphManager.ensureContextGraph(contextGraphId);
-        if (subGraphName) {
-            await graphManager.ensureSubGraph(contextGraphId, subGraphName);
-            const sgUri = contextGraphSubGraphUri(contextGraphId, subGraphName);
-            const metaGraph = `did:dkg:context-graph:${assertSafeIri(contextGraphId)}/_meta`;
-            const alreadyRegistered = await this.store.query(`ASK { GRAPH <${metaGraph}> {
-          <${assertSafeIri(sgUri)}> a <http://dkg.io/ontology/SubGraph> ;
-            <http://schema.org/name> ${JSON.stringify(subGraphName)} ;
-            <http://dkg.io/ontology/createdBy> ?createdBy .
-        } }`, { source: 'agent.finalization.subGraphRegistration' });
-            if (alreadyRegistered.type !== 'boolean' || !alreadyRegistered.value) {
-                const regQuads = generateSubGraphRegistration({
-                    contextGraphId,
-                    subGraphName,
-                    createdBy: publisherAddress || 'finalization-discovery',
-                    timestamp: new Date(),
-                });
-                await this.store.insert(regQuads);
-                this.markContextGraphMetaDirtyFromQuads?.(regQuads);
-                this.log.info(ctx, `Finalization: auto-registered sub-graph "${subGraphName}" in context graph "${contextGraphId}"`);
-            }
-        }
-        const dataGraph = subGraphName
-            ? contextGraphSubGraphUri(contextGraphId, subGraphName)
-            : ctxGraphId
-                ? contextGraphDataUri(contextGraphId, ctxGraphId)
-                : graphManager.dataGraphUri(contextGraphId);
-        // Devnet test #774-followup (v10-rc-validation §5 gossip replication):
-        // when `ctxGraphId` is set on a non-sub-graph publish, the canonical
-        // data lands in the per-on-chain-id partition
-        // `<cg>/context/<ctxGraphId>` only. The publisher path
-        // (`dkg-publisher.ts` ~line 1382) intentionally ALSO writes the same
-        // quads to the root `<cg>` graph "so `agent.query(label)` (which
-        // resolves to `did:dkg:context-graph:<label>` without a
-        // `/context/<id>` suffix) still finds the just-published triples"
-        // (commit c2abbc9a). Replicas were never updated to mirror that
-        // dual-write — so a CG-scoped query against a label on a recipient
-        // node finds 0 bindings even though the data is local in
-        // `<cg>/context/<ctxGraphId>`. The query engine cannot widen its
-        // allow set to `<cg>/context/<num>` without a CG-registry lookup
-        // (id-prefix collisions, see PR #776 r6 in dkg-query-engine.ts).
-        // Mirroring the publisher's same-graph dual-write fixes the
-        // visibility asymmetry without re-introducing that ambiguity.
-        //
-        // Critical scoping (Codex review on PR #779): the recipient dual-write
-        // MUST only fire for same-graph publishes (the publisher kept the
-        // root copy too). Explicit-`subContextGraphId` / remap publishes
-        // delete the root copy on purpose (`dkg-publisher.ts` ~line 1393),
-        // and a recipient that re-adds it would re-expose the KC under the
-        // source CG's label on every replica — leaking remap intent and
-        // double-counting the same triples in unscoped queries. The
-        // publisher signals same-graph vs remap on the wire via
-        // `keepRootCopyOnLabel`; missing/false (older publishers, or any
-        // remap publish) → no dual-write.
-        const rootDataGraphForLabel = (!subGraphName && ctxGraphId && keepRootCopyOnLabel === true)
-            ? graphManager.dataGraphUri(contextGraphId)
-            : null;
-        // Compute canonical quads now, but defer the `store.insert` until AFTER
-        // the confirmed-meta write and SWM cleanup (see bottom of this method).
-        //
-        // Rationale: on a replica the three store mutations (canonical insert,
-        // confirmed-meta insert, SWM cleanup) happen as three sequential awaits.
-        // Readers polling the canonical graph (e.g. downstream consumers waiting
-        // for "KC landed") can observe the canonical insert before the meta flip
-        // to `confirmed` or before SWM has been drained, producing a visible
-        // "data-without-confirmed-meta" intermediate state that is wrong from a
-        // causal-consistency standpoint (the whole point of the finalization
-        // gossip is that by the time data is canonical on a replica, the chain
-        // proof is durable too). On fast dev machines the window is sub-
-        // millisecond and invisible; on slower CI runners it widens to ~70 ms
-        // and a poll that happens to land there sees `tentative` instead of
-        // `confirmed` (flipped the `Tornado EVM integration: agent`
-        // e2e-finalization suite red on every PR-224 run since the
-        // sync-refactor merge at `bc65c3ae`).
-        //
-        // Ordering meta+cleanup BEFORE canonical insert makes the public state
-        // transition single-stepped from an observer's point of view: either
-        // you don't see the data yet, or you see data + confirmed meta + empty
-        // SWM. The only user-visible partial state that remains (confirmed
-        // meta + no data) is naturally recovered by `isAlreadyConfirmed` on the
-        // next retry path, and it's strictly less broken than the converse.
-        const canonicalQuads = sharedMemoryQuads.map(q => ({ ...q, graph: dataGraph }));
-        const privateRoots = await this.getPrivateRootsFromMeta(contextGraphId, msgRootEntities, subGraphName);
-        const merkleRoot = computeFlatKCRoot(canonicalQuads, privateRoots);
-        const partitioned = skolemizeByEntity(canonicalQuads);
-        const localRootSet = new Set(partitioned.keys());
-        const rootEntities = msgRootEntities.length > 0
-            ? msgRootEntities
-            : [...partitioned.keys()];
-        if (msgRootEntities.length > 0) {
-            const msgSet = new Set(msgRootEntities);
-            const extraInMsg = msgRootEntities.filter(r => !localRootSet.has(r));
-            let generatedCatalogRootSet = new Set();
-            try {
-                generatedCatalogRootSet = new Set(splitTrustedGeneratedCatalogRootMap(partitioned, generatedPrivateCatalogTripleKeys(contextGraphId)).generatedCatalogRootEntities);
-            }
-            catch {
-                generatedCatalogRootSet = new Set();
-            }
-            const missingInMsg = [...localRootSet].filter(r => !msgSet.has(r) && !generatedCatalogRootSet.has(r));
-            if (extraInMsg.length > 0 || missingInMsg.length > 0) {
-                this.log.warn(ctx, `Finalization: root entity set mismatch — extra in msg: [${extraInMsg.join(', ')}], missing: [${missingInMsg.join(', ')}]`);
-            }
-        }
-        const kaMetadata = [];
-        // GH #936 — assign per-root tokenIds over a CANONICAL (lexicographic) root
-        // order, NOT the SPARQL/gossip binding order. oxigraph binding order is
-        // store-history-dependent, so two replicas reconciling the same KC from
-        // chain would otherwise mint divergent root→tokenId maps. These tokenIds are
-        // local compatibility labels (the on-chain KA count is 1, no on-chain
-        // dependency — see dkg-publisher.ts), so a content-derived sort makes the
-        // map a pure function of the root SET: identical on every replica and on
-        // both the gossip and chain-reconcile promotion paths.
-        const orderedRoots = [...rootEntities].sort(compareRootIris);
-        for (let tokenIdx = 0; tokenIdx < orderedRoots.length; tokenIdx++) {
-            const rootEntity = orderedRoots[tokenIdx];
-            const entityQuads = partitioned.get(rootEntity) ?? [];
-            if (entityQuads.length === 0)
-                continue;
-            kaMetadata.push({
-                rootEntity,
-                kcUal: ual,
-                tokenId: BigInt(tokenIdx + 1),
-                publicTripleCount: entityQuads.length,
-                privateTripleCount: 0,
-                privateMerkleRoot: undefined,
-            });
-        }
-        const wsPeerId = await this.getPublisherPeerIdFromMeta(contextGraphId, msgRootEntities, subGraphName);
-        // Round 5 review §10 — propagate the on-chain-attested author into the
-        // confirmed `_meta` block so replicas emit a `prov:wasAttributedTo`
-        // matching the originator's. We treat `address(0)` (the
-        // unattributed-publish sentinel) as "no author" by skipping the field,
-        // so the legacy no-author behaviour is preserved verbatim. (The former
-        // `dkg:Publication` / `dkg:authoredBy` mirror was dropped — RFC
-        // ka-metadata-trim Phase 1, zero readers.)
-        const isUnattributed = !authorAddress
-            || authorAddress === '0x0000000000000000000000000000000000000000'
-            || authorAddress.toLowerCase() === '0x0000000000000000000000000000000000000000';
-        const kcMeta = {
-            ual,
-            contextGraphId,
-            merkleRoot,
-            publisherPeerId: wsPeerId || publisherAddress,
-            timestamp: new Date(),
-            subGraphName,
-            ...(isUnattributed
-                ? {}
-                : { authorAddress }),
-        };
-        let blockTimestamp = Math.floor(Date.now() / 1000);
-        if (this.chain && typeof this.chain.getBlockTimestamp === 'function') {
-            try {
-                blockTimestamp = await this.chain.getBlockTimestamp(blockNumber);
-            }
-            catch {
-                this.log.info(ctx, `Could not fetch block timestamp for block ${blockNumber}, using local time`);
-            }
-        }
-        const provenance = {
-            txHash,
-            blockNumber,
-            blockTimestamp,
-            publisherAddress,
-            batchId,
-            chainId: this.chain?.chainId ?? 'unknown',
-        };
-        // Remove any existing tentative status for this UAL before inserting
-        // confirmed metadata. Two graph locations can carry it on this replica:
-        //   1. Root `<cg>/_meta` — gossip-publish-handler ALWAYS writes
-        //      `generateTentativeMetadata(...)` here (via `getTentativeStatusQuad`,
-        //      which hardcodes the root `_meta` graph). This applies to every
-        //      gossip-replicated KC regardless of `ctxGraphId` / dual-write mode.
-        //   2. Per-cgId `<cg>/context/<id>/_meta` — older code paths (and any
-        //      future writer that respects the same partition split as canonical
-        //      data) may park a tentative quad here when `ctxGraphId` is set.
-        //
-        // Codex r5 on PR #779: the previous form mutated `tentativeQuad.graph`
-        // to the per-cgId URI when `ctxGraphId` was set and deleted ONLY that
-        // copy. The root tentative survived. With the same-graph dual-write
-        // path (`keepRootCopyOnLabel === true`) we then re-inserted confirmed
-        // `_meta` into root `<cg>/_meta`, leaving `tentative` AND `confirmed`
-        // status quads coexisting on the same UAL in the root meta graph —
-        // label-scoped status reads were non-deterministic. Even on the
-        // `keepRootCopyOnLabel === false` path the leftover root tentative was
-        // wrong (the publisher had moved/dropped its root copy on remap).
-        //
-        // Fix: always queue the root tentative for deletion AND, when ctxGraphId
-        // is set, also queue the per-cgId variant. Single `store.delete` call so
-        // all stale tentative copies are reaped in one shot — `delete` no-ops on
-        // missing quads, so it's safe to enumerate both regardless of which
-        // writer actually populated them.
-        const rootTentativeQuad = getTentativeStatusQuad(ual, contextGraphId);
-        const tentativesToDelete = [rootTentativeQuad];
-        if (ctxGraphId) {
-            tentativesToDelete.push({
-                ...rootTentativeQuad,
-                graph: contextGraphMetaUri(contextGraphId, ctxGraphId),
-            });
-        }
-        try {
-            await this.store.delete(tentativesToDelete);
-        }
-        catch { /* tentative status may not exist */ }
-        let metaQuads = generateConfirmedFullMetadata(kcMeta, kaMetadata, provenance);
-        // GH #936 — append the SHARED deterministic per-root token rows (no-op for
-        // single-root). This is the SAME helper the publisher uses on the originator
-        // path, so a locally-published and a chain-reconciled multi-root KC expose
-        // an identical, queryable rootEntity→tokenId map. graph = the default
-        // `<cg>/_meta` so the ctxGraphId remap below routes them to the per-cgId
-        // `_meta` (and dual-writes a root copy when keepRootCopyOnLabel).
-        metaQuads.push(...buildDeterministicTokenRows(ual, kaMetadata, `did:dkg:context-graph:${contextGraphId}/_meta`));
-        if (ctxGraphId) {
-            const defaultMeta = `did:dkg:context-graph:${contextGraphId}/_meta`;
-            const targetMeta = contextGraphMetaUri(contextGraphId, ctxGraphId);
-            // Codex r3 on PR #779: the publisher's same-graph path keeps the
-            // confirmed `_meta` triples in BOTH the root `<cg>/_meta` and
-            // the per-cgId `<cg>/context/<cgId>/_meta` graphs (see the
-            // matching dual-write in `dkg-publisher.ts` ~line 1419, comment
-            // "on remap publishes the original copy at `<NAME>/_meta` is
-            // also moved; on same-graph publishes we leave the default copy
-            // in place"). Replicas were only writing the per-cgId copy, so
-            // label-only `_meta` reads (status / UAL / authoredBy lookups
-            // that don't know the on-chain id) diverged between publisher
-            // and recipients. Mirror the publisher's same-graph dual-write
-            // here too — gated on the same `keepRootCopyOnLabel` signal as
-            // the data-graph dual-write below, and folded into a single
-            // `store.insert` for the same retry-safety reason (`_meta`
-            // tentative→confirmed flip is supposed to be the durable point
-            // post-this-call; splitting the writes would re-introduce a
-            // partial-state window).
-            if (keepRootCopyOnLabel === true) {
-                const rootCopies = metaQuads
-                    .filter((q) => q.graph === defaultMeta)
-                    .map((q) => ({ ...q }));
-                const perCgIdCopies = metaQuads.map((q) => q.graph === defaultMeta ? { ...q, graph: targetMeta } : q);
-                metaQuads = [...perCgIdCopies, ...rootCopies];
-            }
-            else {
-                metaQuads = metaQuads.map((q) => q.graph === defaultMeta ? { ...q, graph: targetMeta } : q);
-            }
-        }
-        // #1233 follow-up — bound agents/_meta: this confirmed-metadata restatement
-        // is load-bearing (prior-root cleanup + the tentative→confirmed flip), so it
-        // cannot be skipped for the agents CG. INSERT then PRUNE (insert-first) via
-        // the helper: the just-inserted UAL is `recordUal` so the prune protects it,
-        // and a post-insert prune failure is swallowed (warned) inside the helper so
-        // it can never abort this promotion. agents/_meta
-        // stays O(agents), not O(agents × heartbeats); no-op prune for every other CG
-        // (so it just inserts). For the agents CG `ctxGraphId` is always undefined
-        // (never on-chain), so `metaQuads` land in the default `<cg>/_meta` graph —
-        // the graph bounded here.
-        // NOTE: the agents CG is always-tentative and never confirms on-chain, so in
-        // practice this promotion is not reached for it (see report); this is a
-        // defensive, lifecycle-preserving bound that keeps the invariant robust.
-        // The bound derives its lock + prune roots from `metaQuads` itself, so the
-        // dropped zero-public-triple roots (the `continue` above) are naturally excluded
-        // from the prune — it can only evict superseded records for roots THIS record
-        // covers, never zero a root the record omits. (Previously this call passed a
-        // separate rootEntities list, which risked exactly that drift.)
-        await insertBoundedAgentRegistryMeta({
-            store: this.store,
-            contextGraphId,
-            metaGraph: `did:dkg:context-graph:${contextGraphId}/_meta`,
-            recordUal: ual,
-            metadataQuads: metaQuads,
-        });
-        // Clean up promoted shared memory entries
-        const sharedMemoryGraph = subGraphName
-            ? graphManager.sharedMemoryUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceGraphUri(contextGraphId);
-        const swmMetaGraph = subGraphName
-            ? graphManager.sharedMemoryMetaUri(contextGraphId, subGraphName)
-            : contextGraphWorkspaceMetaGraphUri(contextGraphId);
-        // #1099: replicas hold the gossiped SWM copy in PER-KA graphs
-        // `…/_shared_memory/{author}/{number}` (workspace-handler.ts ~line 987),
-        // but this cleanup only drained the bare bucket. The stale per-KA copy
-        // survived every publish, kept being served to late subscribers via the
-        // PROTOCOL_SYNC SWM responder (which reads the whole `…/_shared_memory/`
-        // prefix), and re-poisoned even the publisher's own SWM on resync —
-        // publisher and replicas permanently disagreed about SWM content.
-        // Mirror DKGPublisher's `swmGraphsUnder`: drain the bucket AND every
-        // graph under its `/` prefix.
-        const allGraphs = await this.store.listGraphs();
-        const swmGraphsForClear = allGraphs.filter((g) => g === sharedMemoryGraph || g.startsWith(`${sharedMemoryGraph}/`));
-        for (const rootEntity of rootEntities) {
-            for (const g of swmGraphsForClear) {
-                await deleteByPatternWithoutCount(this.store, { graph: g, subject: rootEntity });
-                await this.store.deleteBySubjectPrefix(g, rootEntity + '/.well-known/genid/');
-                await deleteByPatternWithoutCount(this.store, {
-                    graph: g, subject: rootEntity, predicate: 'http://dkg.io/ontology/workspaceOwner',
-                });
-            }
-            await deleteByPatternWithoutCount(this.store, {
-                graph: swmMetaGraph, subject: rootEntity, predicate: 'http://dkg.io/ontology/workspaceOwner',
-            });
-            await this.deleteMetaForRoot(swmMetaGraph, rootEntity);
-        }
-        // Canonical insert LAST — see the comment above `const canonicalQuads`.
-        // By the time any reader observes these quads in the canonical graph,
-        // `_meta` already carries `confirmed` status + chain provenance and the
-        // matching SWM entries have been drained.
-        //
-        // Codex r2 on PR #779: when same-graph dual-write is in play, both
-        // copies (per-cgId partition + root label graph) MUST land in a single
-        // `store.insert` so a crash or store-write failure between them
-        // cannot leave the replica with the per-cgId copy but no root copy.
-        // The previous split form would be skipped on retry by
-        // `isAlreadyConfirmed()` (`_meta` already confirmed) and the root
-        // copy would never be back-filled — a permanent label-scoped query
-        // miss on that replica. Folding both into one insert call ties their
-        // durability to the same store-write transaction (Oxigraph's `load`
-        // and SPARQL-backend bulk insert are both atomic at the call level).
-        const allCanonicalQuads = rootDataGraphForLabel
-            ? [
-                ...canonicalQuads,
-                ...canonicalQuads.map(q => ({ ...q, graph: rootDataGraphForLabel })),
-            ]
-            : canonicalQuads;
-        await this.store.insert(allCanonicalQuads);
-        this.log.info(ctx, `Promoted ${canonicalQuads.length} quads from shared memory to canonical for ${ual}`);
-        this.eventBus?.emit(DKGEvent.MEMORY_GRAPH_CHANGED, {
-            contextGraphId,
-            layers: ['swm', 'vm'],
-            subGraphName,
-            operation: 'verifiable_memory_finalized',
-            source: 'finalization',
-            counts: {
-                roots: rootEntities.length,
-                triples: canonicalQuads.length,
-            },
-        });
-    }
-    async deleteMetaForRoot(metaGraph, rootEntity) {
-        const result = await this.store.query(`SELECT DISTINCT ?op WHERE { GRAPH <${assertSafeIri(metaGraph)}> { ?op ${ENTITY_PRED_ALT} <${assertSafeIri(rootEntity)}> } }`, { source: 'agent.finalization.rootMetadataOperations' });
-        if (result.type !== 'bindings')
-            return;
-        for (const row of result.bindings) {
-            const op = row['op'];
-            if (!op)
-                continue;
-            // OT-RFC-43 §10.1 — dual-write migration: remove BOTH the legacy
-            // dkg:rootEntity and the new dkg:entity for this op/entity pair.
-            await this.store.delete([
-                { subject: op, predicate: DKG_ROOT_ENTITY_LEGACY, object: rootEntity, graph: metaGraph },
-                { subject: op, predicate: DKG_ENTITY, object: rootEntity, graph: metaGraph },
-            ]);
-            const remaining = await this.store.query(`SELECT (COUNT(DISTINCT ?r) AS ?c) WHERE { GRAPH <${assertSafeIri(metaGraph)}> { <${assertSafeIri(op)}> ${ENTITY_PRED_ALT} ?r } }`, { source: 'agent.finalization.remainingOperationRoots' });
-            const rawCount = remaining.type === 'bindings' && remaining.bindings[0]?.['c'];
-            const countVal = typeof rawCount === 'string'
-                ? Number(rawCount.replace(/^"/, '').replace(/"(\^\^<[^>]+>)?$/, ''))
-                : NaN;
-            if (countVal === 0) {
-                await deleteByPatternWithoutCount(this.store, { graph: metaGraph, subject: op });
-            }
-        }
-    }
 }
 //# sourceMappingURL=finalization-handler.js.map