@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/core/history/replay.js

@@ -1,440 +1,3 @@
-/**
- * @module core/history/replay
- *
- * Implements append-only history and replay behavior for Replay.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b0230e20-93c4-531c-9cc1-85f85c1def7a")}catch(e){}}();
-import jsonPatch from "fast-json-patch";
-import { findHistoryIdentityDiscontinuities } from "./identity.js";
-import { ITEM_METADATA_KEY_ORDER } from "../shared/constants.js";
-import { canonicalDocument } from "../item/item-format.js";
-import { toItemRecord } from "../item/item-record.js";
-import { orderObject, sha256Hex, stableStringify, } from "../shared/serialization.js";
-import { CURRENT_HISTORY_ITEM_HASH_VERSION, SUPPORTED_HISTORY_ITEM_HASH_VERSIONS, hashDocumentVerificationCandidates, resealHistoryRewrite, verifyHistoryRecordHash, verifyHistoryRewriteEvidence, } from "./history.js";
-/** Public contract for empty replay document, shared by SDK and presentation-layer consumers. */
-export const EMPTY_REPLAY_DOCUMENT = {
-    metadata: {},
-    body: "",
-};
-/** Implements clone empty replay document for the public runtime surface of this module. */
-export function cloneEmptyReplayDocument() {
-    return structuredClone(EMPTY_REPLAY_DOCUMENT);
-}
-/** Implements replay hash for the public runtime surface of this module. */
-export function replayHash(document, version = CURRENT_HISTORY_ITEM_HASH_VERSION) {
-    return replayHashVerificationCandidates(document, version)[0];
-}
-/**
- * Return hash candidates that preserve the semantic variant within an epoch.
- * Duplicate values are intentional: before and after candidates use the same
- * index when a patch introduces a field that distinguishes legacy epoch 2.
- */
-export function replayHashVerificationCandidates(document, version) {
-    if (Object.keys(document.metadata).length === 0 ||
-        Array.isArray(document.metadata.tags)) {
-        try {
-            return hashDocumentVerificationCandidates(replayToItemDocument(document), version);
-        }
-        catch {
-            // Fall through when another malformed legacy field cannot be canonicalized.
-        }
-    }
-    const fallback = sha256Hex(stableStringify({
-        replay_fallback: true,
-        metadata: document.metadata,
-        body: document.body,
-    }));
-    return version === 2 ? [fallback, fallback] : [fallback];
-}
-/** Match one recorded entry against corresponding before/after hash variants. */
-function matchReplayHashCandidates(before, after, version, entry) {
-    const beforeHashes = replayHashVerificationCandidates(before, version);
-    const afterHashes = replayHashVerificationCandidates(after, version);
-    return {
-        beforeHashes,
-        afterHashes,
-        pairIndex: beforeHashes.findIndex((beforeHash, hashIndex) => beforeHash === entry.before_hash &&
-            afterHashes[hashIndex] === entry.after_hash),
-        beforeIndex: beforeHashes.indexOf(entry.before_hash),
-        afterIndex: afterHashes.indexOf(entry.after_hash),
-    };
-}
-/** Implements replay to item document for the public runtime surface of this module. */
-export function replayToItemDocument(document) {
-    return {
-        metadata: document.metadata,
-        body: document.body,
-    };
-}
-/** Converts a materialized replay document into a canonical item document. Use this when callers have already rejected the empty/deleted replay state and need restored metadata validated through the normal item-metadata rules. */
-export function replayToCanonicalItemDocument(document, options = {}) {
-    return canonicalDocument(replayToItemDocument(document), options);
-}
-/** Canonicalize an item document into the ordered replay form used when comparing a replayed chain against the on-disk item (restore + history-repair reconciliation). */
-export function toReplayDocument(document) {
-    if (!document.metadata || Object.keys(document.metadata).length === 0) {
-        return {
-            metadata: {},
-            body: document.body ?? "",
-        };
-    }
-    const canonical = canonicalDocument(document);
-    return {
-        metadata: orderObject(toItemRecord(canonical.metadata), ITEM_METADATA_KEY_ORDER),
-        body: canonical.body,
-    };
-}
-/** Implements normalize replay patch path for the public runtime surface of this module. */
-export function normalizeReplayPatchPath(path) {
-    if (path === "/front_matter") {
-        return "/metadata";
-    }
-    if (path.startsWith("/front_matter/")) {
-        return `/metadata/${path.slice("/front_matter/".length)}`;
-    }
-    return path;
-}
-function isHistoryPatchOp(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        typeof value.op === "string" &&
-        typeof value.path === "string");
-}
-/** Implements normalize replay patch ops for the public runtime surface of this module. */
-export function normalizeReplayPatchOps(patch) {
-    if (!Array.isArray(patch)) {
-        return [];
-    }
-    return patch.filter(isHistoryPatchOp).map((operation) => ({
-        ...operation,
-        path: normalizeReplayPatchPath(operation.path),
-        from: typeof operation.from === "string"
-            ? normalizeReplayPatchPath(operation.from)
-            : undefined,
-    }));
-}
-function isReplayDocumentShape(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "metadata" in value &&
-        "body" in value &&
-        typeof value.body === "string" &&
-        typeof value.metadata === "object" &&
-        value.metadata !== null);
-}
-/** Strictly apply a history patch (front_matter->metadata normalized) to a replay document. Returns a result envelope rather than throwing so each caller can format its own error contract. */
-export function tryApplyReplayPatch(current, patch) {
-    try {
-        const normalizedPatch = normalizeReplayPatchOps(patch);
-        const applied = jsonPatch.applyPatch(structuredClone(current), normalizedPatch, true, false).newDocument;
-        if (!isReplayDocumentShape(applied)) {
-            return {
-                ok: false,
-                error: new Error("history_replay_invalid_document_shape"),
-            };
-        }
-        return {
-            ok: true,
-            document: { metadata: applied.metadata, body: applied.body },
-        };
-    }
-    catch (error) {
-        return { ok: false, error };
-    }
-}
-/** Return the distinct supported hash epochs explicitly declared by a stream. */
-function supportedExplicitHistoryItemHashVersions(entries) {
-    return [
-        ...new Set(entries
-            .map((entry) => entry.item_hash_version)
-            .filter((version) => version !== undefined &&
-            SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version))),
-    ];
-}
-/** Return whether an explicit hash epoch cannot be replayed by this build. */
-function isUnsupportedExplicitHistoryItemHashVersion(version) {
-    return (version !== undefined &&
-        !SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version));
-}
-/** Select the hash epochs allowed for one entry under an authoritative stream marker. */
-function historyEntryHashCandidates(explicitVersion, authoritativeVersion) {
-    if (explicitVersion !== undefined) {
-        return [explicitVersion];
-    }
-    return authoritativeVersion === undefined
-        ? [...SUPPORTED_HISTORY_ITEM_HASH_VERSIONS]
-        : [authoritativeVersion];
-}
-/** Return the first record or retained-rewrite integrity failure for one entry. */
-function historyEntryIntegrityError(entry) {
-    const recordVerification = verifyHistoryRecordHash(entry);
-    if (!recordVerification.ok)
-        return recordVerification.error;
-    const rewriteVerification = verifyHistoryRewriteEvidence(entry);
-    return rewriteVerification.ok ? undefined : rewriteVerification.error;
-}
-/** Validate immutable metadata and apply one patch for chain verification. */
-function verifyHistoryEntryInput(entry, replay) {
-    const integrityError = historyEntryIntegrityError(entry);
-    if (integrityError)
-        return { ok: false, error: integrityError };
-    const applied = tryApplyReplayPatch(replay, entry.patch);
-    return applied.ok
-        ? { ok: true, document: applied.document }
-        : { ok: false, error: "patch_apply_failed" };
-}
-/** Refuse any entry whose current or retained immutable envelope is invalid. */
-function assertHistoryEntryIntegrity(entry, index) {
-    const integrityError = historyEntryIntegrityError(entry);
-    if (integrityError) {
-        throw new TypeError(`${integrityError}:entry_${index + 1}`);
-    }
-}
-/** Verify a chain and report the explicit or auto-detected item hash epoch. */
-export function verifyHistoryChainWithVersion(entries) {
-    let replay = cloneEmptyReplayDocument();
-    let detectedVersion;
-    let authoritativeExplicitVersion;
-    const errors = findHistoryIdentityDiscontinuities(entries).map((finding) => `verify_failed:duplicate_create:entry_${finding.repeated_create_index}:prior_${finding.prior_genesis_index}`);
-    for (let index = 0; index < entries.length; index += 1) {
-        const entry = entries[index];
-        const explicitVersion = entry.item_hash_version;
-        const unsupportedVersion = isUnsupportedExplicitHistoryItemHashVersion(explicitVersion);
-        if (unsupportedVersion) {
-            errors.push(`verify_failed:unsupported_item_hash_version:${String(explicitVersion)}:entry_${index + 1}`);
-        }
-        const input = verifyHistoryEntryInput(entry, replay);
-        if (!input.ok) {
-            return {
-                ok: false,
-                errors: [...errors, `verify_failed:${input.error}:entry_${index + 1}`],
-            };
-        }
-        if (unsupportedVersion) {
-            replay = input.document;
-            detectedVersion = undefined;
-            authoritativeExplicitVersion = undefined;
-            continue;
-        }
-        // Prefer legacy epoch 1 when an unversioned entry is valid under both
-        // algorithms, but retain compatibility with transitional epoch-2 writers
-        // that shipped before item_hash_version became explicit.
-        const candidates = historyEntryHashCandidates(explicitVersion, authoritativeExplicitVersion);
-        const candidateMatches = candidates.map((version) => ({
-            version,
-            match: matchReplayHashCandidates(replay, input.document, version, entry),
-        }));
-        const matchingVersion = candidateMatches.find(({ match }) => match.pairIndex >= 0);
-        if (matchingVersion === undefined) {
-            const beforeMatches = candidateMatches.some(({ match }) => match.beforeIndex >= 0);
-            return {
-                ok: false,
-                errors: [
-                    ...errors,
-                    `verify_failed:${beforeMatches ? "after" : "before"}_hash_mismatch:entry_${index + 1}`,
-                ],
-            };
-        }
-        const version = matchingVersion.version;
-        replay = input.document;
-        detectedVersion = version;
-        authoritativeExplicitVersion =
-            explicitVersion ??
-                authoritativeExplicitVersion;
-    }
-    if (errors.length > 0) {
-        return {
-            ok: false,
-            errors,
-            ...(detectedVersion === undefined
-                ? {}
-                : { item_hash_version: detectedVersion }),
-        };
-    }
-    return {
-        ok: true,
-        errors: [],
-        ...(detectedVersion === undefined
-            ? {}
-            : { item_hash_version: detectedVersion }),
-    };
-}
-/** Deterministically verify a history chain while preserving the legacy result shape. */
-export function verifyHistoryChain(entries) {
-    const result = verifyHistoryChainWithVersion(entries);
-    return { ok: result.ok, errors: result.errors };
-}
-function tryApplySingleOp(document, op) {
-    try {
-        const applied = jsonPatch.applyPatch(structuredClone(document), [op], true, false).newDocument;
-        return { ok: true, document: applied };
-    }
-    catch {
-        return { ok: false };
-    }
-}
-/** Apply a legacy patch op-by-op, recovering from drift that strict replay rejects: a `replace` whose path no longer exists is retried as `add`, and any op that still cannot apply against the current replay state is skipped. The resulting document is what the repaired entry's recomputed patch should target. */
-export function lenientApplyReplayPatch(current, patch) {
-    let working = structuredClone(current);
-    let convertedReplaceToAdd = 0;
-    let skippedOps = 0;
-    for (const op of normalizeReplayPatchOps(patch)) {
-        const direct = tryApplySingleOp(working, op);
-        if (direct.ok) {
-            working = direct.document;
-            continue;
-        }
-        if (op.op === "replace") {
-            const asAdd = tryApplySingleOp(working, { ...op, op: "add" });
-            if (asAdd.ok) {
-                working = asAdd.document;
-                convertedReplaceToAdd += 1;
-                continue;
-            }
-        }
-        skippedOps += 1;
-    }
-    const candidate = working;
-    const document = {
-        metadata: typeof candidate.metadata === "object" && candidate.metadata !== null
-            ? candidate.metadata
-            : {},
-        body: typeof candidate.body === "string" ? candidate.body : current.body,
-    };
-    return { document, convertedReplaceToAdd, skippedOps };
-}
-/**
- * Resolve the hash epoch a repair must retain.
- *
- * A valid stream is authoritative even when legacy entries omit the version
- * field. For a broken stream, one consistent explicit epoch remains
- * authoritative; fully implicit legacy streams stay on epoch 1. Only an
- * irreconcilably mixed stream falls forward to the current epoch.
- */
-export function resolveHistoryRepairItemHashVersion(entries) {
-    const explicitVersions = supportedExplicitHistoryItemHashVersions(entries);
-    if (explicitVersions.length === 1) {
-        return explicitVersions[0];
-    }
-    const verified = verifyHistoryChainWithVersion(entries);
-    if (verified.ok && verified.item_hash_version !== undefined) {
-        return verified.item_hash_version;
-    }
-    if (explicitVersions.length === 0) {
-        return 1;
-    }
-    return CURRENT_HISTORY_ITEM_HASH_VERSION;
-}
-/** Apply one patch strictly or return its deterministic lenient repair projection. */
-function applyReanchorPatch(replay, entry) {
-    const strict = tryApplyReplayPatch(replay, entry.patch);
-    if (strict.ok) {
-        return {
-            next: strict.document,
-            patch: entry.patch,
-            repaired: false,
-            converted: 0,
-            skipped: 0,
-        };
-    }
-    const lenient = lenientApplyReplayPatch(replay, entry.patch);
-    return {
-        next: lenient.document,
-        patch: jsonPatch.compare(replay, lenient.document),
-        repaired: true,
-        converted: lenient.convertedReplaceToAdd,
-        skipped: lenient.skippedOps,
-    };
-}
-/** Re-anchor a drifted history chain: replay every entry from empty, recompute the before/after hashes, and only rewrite a patch when the original op set no longer strictly applies (legacy drift). Clean entries keep their patch verbatim so the on-disk diff stays minimal. The returned chain verifies via verifyHistoryChain. */
-export function reanchorHistoryEntries(entries, itemHashVersion = resolveHistoryRepairItemHashVersion(entries), options = {}) {
-    const unsupportedIndex = entries.findIndex((entry) => isUnsupportedExplicitHistoryItemHashVersion(entry.item_hash_version));
-    if (unsupportedIndex >= 0) {
-        throw new TypeError(`unsupported_item_hash_version:${String(entries[unsupportedIndex]?.item_hash_version)}:entry_${unsupportedIndex + 1}`);
-    }
-    let replay = cloneEmptyReplayDocument();
-    const rewritten = [];
-    const details = [];
-    let entriesRehashed = 0;
-    let entriesPatchRepaired = 0;
-    let convertedReplaceToAdd = 0;
-    let skippedOps = 0;
-    let semanticIndex;
-    const explicitItemHashVersion = itemHashVersion !== 1 ||
-        entries.some((entry) => entry.item_hash_version !== undefined);
-    for (let index = 0; index < entries.length; index += 1) {
-        const entry = entries[index];
-        assertHistoryEntryIntegrity(entry, index);
-        const patchApplication = applyReanchorPatch(replay, entry);
-        const { next, patch: outPatch, repaired: patchRepaired, converted: entryConverted, skipped: entrySkipped, } = patchApplication;
-        convertedReplaceToAdd += entryConverted;
-        skippedOps += entrySkipped;
-        entriesPatchRepaired += Number(patchRepaired);
-        const hashMatch = matchReplayHashCandidates(replay, next, itemHashVersion, entry);
-        if (semanticIndex === undefined || options.continuousHashSurface !== true) {
-            semanticIndex = [
-                hashMatch.pairIndex,
-                hashMatch.beforeIndex,
-                hashMatch.afterIndex,
-                Math.min(semanticIndex ?? 0, hashMatch.beforeHashes.length - 1),
-            ].find((candidate) => candidate >= 0);
-        }
-        else {
-            semanticIndex = Math.min(semanticIndex, hashMatch.beforeHashes.length - 1);
-        }
-        const beforeHash = hashMatch.beforeHashes[semanticIndex];
-        const afterHash = hashMatch.afterHashes[semanticIndex];
-        const rehashed = beforeHash !== entry.before_hash || afterHash !== entry.after_hash;
-        if (rehashed) {
-            entriesRehashed += 1;
-        }
-        let rewrittenEntry = {
-            ...entry,
-            patch: outPatch,
-            before_hash: beforeHash,
-            after_hash: afterHash,
-        };
-        if (explicitItemHashVersion) {
-            rewrittenEntry.item_hash_version = itemHashVersion;
-        }
-        else {
-            delete rewrittenEntry.item_hash_version;
-        }
-        const versionChanged = rewrittenEntry.item_hash_version !== entry.item_hash_version;
-        if (rehashed || patchRepaired || versionChanged) {
-            rewrittenEntry = resealHistoryRewrite(entry, rewrittenEntry, {
-                retainOriginalPatch: patchRepaired,
-            });
-        }
-        rewritten.push(rewrittenEntry);
-        details.push({
-            index: index + 1,
-            rehashed,
-            patch_repaired: patchRepaired,
-            converted_replace_to_add: entryConverted,
-            skipped_ops: entrySkipped,
-        });
-        replay = next;
-    }
-    return {
-        entries: rewritten,
-        finalDocument: replay,
-        entriesRehashed,
-        entriesPatchRepaired,
-        convertedReplaceToAdd,
-        skippedOps,
-        details,
-        itemHashVersion,
-        explicitItemHashVersion,
-    };
-}
-/** Implements history entries to raw for the public runtime surface of this module. */
-export function historyEntriesToRaw(entries) {
-    if (entries.length === 0) {
-        return "";
-    }
-    return `${entries.map((entry) => JSON.stringify(entry)).join("\n")}\n`;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="19838bc7-d35d-5fae-a023-2e39697ffec9")}catch(e2){}})();import jsonPatch from"fast-json-patch";import{findHistoryIdentityDiscontinuities}from"./identity.js";import{ITEM_METADATA_KEY_ORDER}from"../shared/constants.js";import{canonicalDocument}from"../item/item-format.js";import{toItemRecord}from"../item/item-record.js";import{orderObject,sha256Hex,stableStringify}from"../shared/serialization.js";import{CURRENT_HISTORY_ITEM_HASH_VERSION,SUPPORTED_HISTORY_ITEM_HASH_VERSIONS,hashDocumentVerificationCandidates,resealHistoryRewrite,verifyHistoryRecordHash,verifyHistoryRewriteEvidence}from"./history.js";const EMPTY_REPLAY_DOCUMENT={metadata:{},body:""};function cloneEmptyReplayDocument(){return structuredClone(EMPTY_REPLAY_DOCUMENT)}function replayHash(document,version=CURRENT_HISTORY_ITEM_HASH_VERSION){return replayHashVerificationCandidates(document,version)[0]}function replayHashVerificationCandidates(document,version){if(Object.keys(document.metadata).length===0||Array.isArray(document.metadata.tags)){try{return hashDocumentVerificationCandidates(replayToItemDocument(document),version)}catch{}}const fallback=sha256Hex(stableStringify({replay_fallback:true,metadata:document.metadata,body:document.body}));return version===2?[fallback,fallback]:[fallback]}function matchReplayHashCandidates(before,after,version,entry){const beforeHashes=replayHashVerificationCandidates(before,version);const afterHashes=replayHashVerificationCandidates(after,version);return{beforeHashes,afterHashes,pairIndex:beforeHashes.findIndex((beforeHash,hashIndex)=>beforeHash===entry.before_hash&&afterHashes[hashIndex]===entry.after_hash),beforeIndex:beforeHashes.indexOf(entry.before_hash),afterIndex:afterHashes.indexOf(entry.after_hash)}}function replayToItemDocument(document){return{metadata:document.metadata,body:document.body}}function replayToCanonicalItemDocument(document,options={}){return canonicalDocument(replayToItemDocument(document),options)}function toReplayDocument(document){if(!document.metadata||Object.keys(document.metadata).length===0){return{metadata:{},body:document.body??""}}const canonical=canonicalDocument(document);return{metadata:orderObject(toItemRecord(canonical.metadata),ITEM_METADATA_KEY_ORDER),body:canonical.body}}function normalizeReplayPatchPath(path){if(path==="/front_matter"){return"/metadata"}if(path.startsWith("/front_matter/")){return`/metadata/${path.slice("/front_matter/".length)}`}return path}function isHistoryPatchOp(value){return typeof value==="object"&&value!==null&&typeof value.op==="string"&&typeof value.path==="string"}function normalizeReplayPatchOps(patch){if(!Array.isArray(patch)){return[]}return patch.filter(isHistoryPatchOp).map(operation=>({...operation,path:normalizeReplayPatchPath(operation.path),from:typeof operation.from==="string"?normalizeReplayPatchPath(operation.from):void 0}))}function isReplayDocumentShape(value){return typeof value==="object"&&value!==null&&"metadata"in value&&"body"in value&&typeof value.body==="string"&&typeof value.metadata==="object"&&value.metadata!==null}function tryApplyReplayPatch(current,patch){try{const normalizedPatch=normalizeReplayPatchOps(patch);const applied=jsonPatch.applyPatch(structuredClone(current),normalizedPatch,true,false).newDocument;if(!isReplayDocumentShape(applied)){return{ok:false,error:new Error("history_replay_invalid_document_shape")}}return{ok:true,document:{metadata:applied.metadata,body:applied.body}}}catch(error){return{ok:false,error}}}function supportedExplicitHistoryItemHashVersions(entries){return[...new Set(entries.map(entry=>entry.item_hash_version).filter(version=>version!==void 0&&SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)))]}function isUnsupportedExplicitHistoryItemHashVersion(version){return version!==void 0&&!SUPPORTED_HISTORY_ITEM_HASH_VERSIONS.includes(version)}function historyEntryHashCandidates(explicitVersion,authoritativeVersion){if(explicitVersion!==void 0){return[explicitVersion]}return authoritativeVersion===void 0?[...SUPPORTED_HISTORY_ITEM_HASH_VERSIONS]:[authoritativeVersion]}function historyEntryIntegrityError(entry){const recordVerification=verifyHistoryRecordHash(entry);if(!recordVerification.ok)return recordVerification.error;const rewriteVerification=verifyHistoryRewriteEvidence(entry);return rewriteVerification.ok?void 0:rewriteVerification.error}function verifyHistoryEntryInput(entry,replay){const integrityError=historyEntryIntegrityError(entry);if(integrityError)return{ok:false,error:integrityError};const applied=tryApplyReplayPatch(replay,entry.patch);return applied.ok?{ok:true,document:applied.document}:{ok:false,error:"patch_apply_failed"}}function assertHistoryEntryIntegrity(entry,index){const integrityError=historyEntryIntegrityError(entry);if(integrityError){throw new TypeError(`${integrityError}:entry_${index+1}`)}}function verifyHistoryChainWithVersion(entries){let replay=cloneEmptyReplayDocument();let detectedVersion;let authoritativeExplicitVersion;const errors=findHistoryIdentityDiscontinuities(entries).map(finding=>`verify_failed:duplicate_create:entry_${finding.repeated_create_index}:prior_${finding.prior_genesis_index}`);for(let index=0;index<entries.length;index+=1){const entry=entries[index];const explicitVersion=entry.item_hash_version;const unsupportedVersion=isUnsupportedExplicitHistoryItemHashVersion(explicitVersion);if(unsupportedVersion){errors.push(`verify_failed:unsupported_item_hash_version:${String(explicitVersion)}:entry_${index+1}`)}const input=verifyHistoryEntryInput(entry,replay);if(!input.ok){return{ok:false,errors:[...errors,`verify_failed:${input.error}:entry_${index+1}`]}}if(unsupportedVersion){replay=input.document;detectedVersion=void 0;authoritativeExplicitVersion=void 0;continue}const candidates=historyEntryHashCandidates(explicitVersion,authoritativeExplicitVersion);const candidateMatches=candidates.map(version2=>({version:version2,match:matchReplayHashCandidates(replay,input.document,version2,entry)}));const matchingVersion=candidateMatches.find(({match})=>match.pairIndex>=0);if(matchingVersion===void 0){const beforeMatches=candidateMatches.some(({match})=>match.beforeIndex>=0);return{ok:false,errors:[...errors,`verify_failed:${beforeMatches?"after":"before"}_hash_mismatch:entry_${index+1}`]}}const version=matchingVersion.version;replay=input.document;detectedVersion=version;authoritativeExplicitVersion=explicitVersion??authoritativeExplicitVersion}if(errors.length>0){return{ok:false,errors,...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}}return{ok:true,errors:[],...detectedVersion===void 0?{}:{item_hash_version:detectedVersion}}}function verifyHistoryChain(entries){const result=verifyHistoryChainWithVersion(entries);return{ok:result.ok,errors:result.errors}}function tryApplySingleOp(document,op){try{const applied=jsonPatch.applyPatch(structuredClone(document),[op],true,false).newDocument;return{ok:true,document:applied}}catch{return{ok:false}}}function lenientApplyReplayPatch(current,patch){let working=structuredClone(current);let convertedReplaceToAdd=0;let skippedOps=0;for(const op of normalizeReplayPatchOps(patch)){const direct=tryApplySingleOp(working,op);if(direct.ok){working=direct.document;continue}if(op.op==="replace"){const asAdd=tryApplySingleOp(working,{...op,op:"add"});if(asAdd.ok){working=asAdd.document;convertedReplaceToAdd+=1;continue}}skippedOps+=1}const candidate=working;const document={metadata:typeof candidate.metadata==="object"&&candidate.metadata!==null?candidate.metadata:{},body:typeof candidate.body==="string"?candidate.body:current.body};return{document,convertedReplaceToAdd,skippedOps}}function resolveHistoryRepairItemHashVersion(entries){const explicitVersions=supportedExplicitHistoryItemHashVersions(entries);if(explicitVersions.length===1){return explicitVersions[0]}const verified=verifyHistoryChainWithVersion(entries);if(verified.ok&&verified.item_hash_version!==void 0){return verified.item_hash_version}if(explicitVersions.length===0){return 1}return CURRENT_HISTORY_ITEM_HASH_VERSION}function applyReanchorPatch(replay,entry){const strict=tryApplyReplayPatch(replay,entry.patch);if(strict.ok){return{next:strict.document,patch:entry.patch,repaired:false,converted:0,skipped:0}}const lenient=lenientApplyReplayPatch(replay,entry.patch);return{next:lenient.document,patch:jsonPatch.compare(replay,lenient.document),repaired:true,converted:lenient.convertedReplaceToAdd,skipped:lenient.skippedOps}}function reanchorHistoryEntries(entries,itemHashVersion=resolveHistoryRepairItemHashVersion(entries),options={}){const unsupportedIndex=entries.findIndex(entry=>isUnsupportedExplicitHistoryItemHashVersion(entry.item_hash_version));if(unsupportedIndex>=0){throw new TypeError(`unsupported_item_hash_version:${String(entries[unsupportedIndex]?.item_hash_version)}:entry_${unsupportedIndex+1}`)}let replay=cloneEmptyReplayDocument();const rewritten=[];const details=[];let entriesRehashed=0;let entriesPatchRepaired=0;let convertedReplaceToAdd=0;let skippedOps=0;let semanticIndex;const explicitItemHashVersion=itemHashVersion!==1||entries.some(entry=>entry.item_hash_version!==void 0);for(let index=0;index<entries.length;index+=1){const entry=entries[index];assertHistoryEntryIntegrity(entry,index);const patchApplication=applyReanchorPatch(replay,entry);const{next,patch:outPatch,repaired:patchRepaired,converted:entryConverted,skipped:entrySkipped}=patchApplication;convertedReplaceToAdd+=entryConverted;skippedOps+=entrySkipped;entriesPatchRepaired+=Number(patchRepaired);const hashMatch=matchReplayHashCandidates(replay,next,itemHashVersion,entry);if(semanticIndex===void 0||options.continuousHashSurface!==true){semanticIndex=[hashMatch.pairIndex,hashMatch.beforeIndex,hashMatch.afterIndex,Math.min(semanticIndex??0,hashMatch.beforeHashes.length-1)].find(candidate=>candidate>=0)}else{semanticIndex=Math.min(semanticIndex,hashMatch.beforeHashes.length-1)}const beforeHash=hashMatch.beforeHashes[semanticIndex];const afterHash=hashMatch.afterHashes[semanticIndex];const rehashed=beforeHash!==entry.before_hash||afterHash!==entry.after_hash;if(rehashed){entriesRehashed+=1}let rewrittenEntry={...entry,patch:outPatch,before_hash:beforeHash,after_hash:afterHash};if(explicitItemHashVersion){rewrittenEntry.item_hash_version=itemHashVersion}else{delete rewrittenEntry.item_hash_version}const versionChanged=rewrittenEntry.item_hash_version!==entry.item_hash_version;if(rehashed||patchRepaired||versionChanged){rewrittenEntry=resealHistoryRewrite(entry,rewrittenEntry,{retainOriginalPatch:patchRepaired})}rewritten.push(rewrittenEntry);details.push({index:index+1,rehashed,patch_repaired:patchRepaired,converted_replace_to_add:entryConverted,skipped_ops:entrySkipped});replay=next}return{entries:rewritten,finalDocument:replay,entriesRehashed,entriesPatchRepaired,convertedReplaceToAdd,skippedOps,details,itemHashVersion,explicitItemHashVersion}}function historyEntriesToRaw(entries){if(entries.length===0){return""}return`${entries.map(entry=>JSON.stringify(entry)).join("\n")}
+`}export{EMPTY_REPLAY_DOCUMENT,cloneEmptyReplayDocument,historyEntriesToRaw,lenientApplyReplayPatch,normalizeReplayPatchOps,normalizeReplayPatchPath,reanchorHistoryEntries,replayHash,replayHashVerificationCandidates,replayToCanonicalItemDocument,replayToItemDocument,resolveHistoryRepairItemHashVersion,toReplayDocument,tryApplyReplayPatch,verifyHistoryChain,verifyHistoryChainWithVersion};
 //# sourceMappingURL=replay.js.map
-//# debugId=b0230e20-93c4-531c-9cc1-85f85c1def7a

package/dist/core/history/version-address.js

@@ -1,33 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7ad4e6c0-7545-51cb-9af7-4ba1ad4c4758")}catch(e){}}();
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-/** Resolve the checkpoint offset with an explicit opt-in for unknown legacy addresses. */
-export function historyVersionOffset(history, allowUnknown = false) {
-    const first = history[0];
-    if (first?.op !== "history_compact_baseline")
-        return 0;
-    const receipt = first.context?.history_compaction;
-    const offset = typeof receipt === "object" &&
-        receipt !== null &&
-        "version_offset" in receipt
-        ? receipt.version_offset
-        : undefined;
-    if (typeof offset === "number" &&
-        Number.isSafeInteger(offset) &&
-        offset >= 0 &&
-        Number.isSafeInteger(offset + history.length)) {
-        return offset;
-    }
-    if (allowUnknown)
-        return null;
-    throw new PmCliError("This compacted stream has no trustworthy version offset; numeric history addresses are unavailable.", EXIT_CODE.USAGE, {
-        code: "history_version_mapping_unavailable",
-        required: "Use a retained timestamp or recover the pre-compaction stream from version control.",
-        nextSteps: [
-            "Run pm history <id> --full to inspect the retained timestamps and checkpoint evidence.",
-        ],
-    });
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cb9a55d6-9ba9-50af-a54f-2bba5d076fdb")}catch(e2){}})();import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";function historyVersionOffset(history,allowUnknown=false){const first=history[0];if(first?.op!=="history_compact_baseline")return 0;const receipt=first.context?.history_compaction;const offset=typeof receipt==="object"&&receipt!==null&&"version_offset"in receipt?receipt.version_offset:void 0;if(typeof offset==="number"&&Number.isSafeInteger(offset)&&offset>=0&&Number.isSafeInteger(offset+history.length)){return offset}if(allowUnknown)return null;throw new PmCliError("This compacted stream has no trustworthy version offset; numeric history addresses are unavailable.",EXIT_CODE.USAGE,{code:"history_version_mapping_unavailable",required:"Use a retained timestamp or recover the pre-compaction stream from version control.",nextSteps:["Run pm history <id> --full to inspect the retained timestamps and checkpoint evidence."]})}export{historyVersionOffset};
 //# sourceMappingURL=version-address.js.map
-//# debugId=7ad4e6c0-7545-51cb-9af7-4ba1ad4c4758