@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/history/identity.js

@@ -1,31 +1,2 @@
-/** Find every repeated genesis, including histories that start at a checkpoint. */
-
-!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]="ffaea7bd-daa4-5ff5-8cd5-82ad04e2256e")}catch(e){}}();
-export function findHistoryIdentityDiscontinuities(entries) {
-    const findings = [];
-    const checkpoint = entries[0]?.op === "history_compact_baseline";
-    let genesis = checkpoint ? 1 : undefined;
-    let deleted = false;
-    for (const [index, entry] of entries.entries()) {
-        if (entry.op === "delete")
-            deleted = true;
-        if (entry.op !== "create")
-            continue;
-        if (genesis !== undefined) {
-            findings.push({
-                prior_genesis_index: genesis,
-                repeated_create_index: index + 1,
-                sequence: deleted
-                    ? "delete_then_create"
-                    : checkpoint
-                        ? "checkpoint_then_create"
-                        : "multiple_creates",
-            });
-        }
-        genesis ??= index + 1;
-        deleted = false;
-    }
-    return findings;
-}
+!(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]="24b1fb96-5c1e-5669-be21-fdeef4d413a6")}catch(e2){}})();function findHistoryIdentityDiscontinuities(entries){const findings=[];const checkpoint=entries[0]?.op==="history_compact_baseline";let genesis=checkpoint?1:void 0;let deleted=false;for(const[index,entry]of entries.entries()){if(entry.op==="delete")deleted=true;if(entry.op!=="create")continue;if(genesis!==void 0){findings.push({prior_genesis_index:genesis,repeated_create_index:index+1,sequence:deleted?"delete_then_create":checkpoint?"checkpoint_then_create":"multiple_creates"})}genesis??=index+1;deleted=false}return findings}export{findHistoryIdentityDiscontinuities};
 //# sourceMappingURL=identity.js.map
-//# debugId=ffaea7bd-daa4-5ff5-8cd5-82ad04e2256e

package/dist/core/history/index.js

@@ -1,10 +1,2 @@
-/**
- * @module core/history/index
- *
- * Implements append-only history and replay behavior for Index.
- */
-
-!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]="845e18c4-e066-573a-9ae5-0a2fa283b62e")}catch(e){}}();
-export * from "./history.js";
+!(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]="2a41f316-31f0-5115-be8b-957da9e233ad")}catch(e2){}})();export*from"./history.js";
 //# sourceMappingURL=index.js.map
-//# debugId=845e18c4-e066-573a-9ae5-0a2fa283b62e

package/dist/core/history/projection.js

@@ -1,197 +1,2 @@
-/**
- * @module core/history/projection
- *
- * Reconstructs verified point-in-time item states from hash-chained history.
- * Restore, SDK reads, and future VCS-style integrations share this single
- * replay kernel so read and write paths cannot disagree about a version.
- */
-
-!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]="2efbffc1-722c-5f3a-9ca5-e4e7a4f97729")}catch(e){}}();
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-import { historyVersionOffset } from "./version-address.js";
-import { EMPTY_REPLAY_DOCUMENT, verifyHistoryChain, tryApplyReplayPatch, } from "./replay.js";
-/** Find the final history entry recorded at or before a parsed timestamp. */
-function findHistoryIndexAtTimestamp(history, parsedTarget) {
-    let historyIndex = -1;
-    history.forEach((entry, index) => {
-        const entryTimestamp = Date.parse(entry.ts);
-        if (!Number.isFinite(entryTimestamp)) {
-            throw new PmCliError(`History for this item contains invalid timestamp at entry ${index + 1}.`, EXIT_CODE.GENERIC_FAILURE);
-        }
-        if (entryTimestamp <= parsedTarget) {
-            historyIndex = index;
-        }
-    });
-    return historyIndex;
-}
-/** Build structured target-range guidance once for every resolver error path. */
-function buildHistoryTargetGuidance(history, offset) {
-    const firstTimestamp = history[0]?.ts ?? null;
-    const lastTimestamp = history.at(-1)?.ts ?? null;
-    const guidance = {
-        code: "history_target_out_of_range",
-        required: "Choose a target within the available item history.",
-        why: "Point-in-time reads and restores can only reconstruct recorded versions.",
-        examples: [],
-        nextSteps: [
-            "Run pm history <id> to inspect available versions and timestamps.",
-        ],
-        valid_range: {
-            first_version: null,
-            last_version: null,
-            first_timestamp: firstTimestamp,
-            last_timestamp: lastTimestamp,
-        },
-    };
-    if (lastTimestamp !== null) {
-        guidance.examples = [lastTimestamp];
-        if (offset !== null) {
-            guidance.examples.unshift(String(offset + 1), String(offset + history.length));
-            guidance.valid_range.first_version = offset + 1;
-            guidance.valid_range.last_version = offset + history.length;
-        }
-    }
-    return { guidance, lastTimestamp };
-}
-/** Extract best-effort JSON Patch position details for replay diagnostics. */
-export function extractPatchFailureContext(patch, error) {
-    const failure = {};
-    if (error instanceof Error && error.message.trim().length > 0) {
-        failure.reason = error.message.trim();
-    }
-    if (typeof error !== "object" || error === null) {
-        return failure;
-    }
-    const candidate = error;
-    if (typeof candidate.index === "number" &&
-        Number.isInteger(candidate.index) &&
-        candidate.index >= 0) {
-        failure.patchIndex = candidate.index;
-    }
-    if (typeof candidate.operation === "object" && candidate.operation !== null) {
-        const operation = candidate.operation;
-        Object.assign(failure, Object.fromEntries(["op", "path", "from"].flatMap((field) => {
-            const value = operation[field];
-            return typeof value === "string" ? [[field, value]] : [];
-        })));
-    }
-    if (failure.patchIndex !== undefined) {
-        const fallback = patch[failure.patchIndex];
-        if (fallback) {
-            failure.op ??= fallback.op;
-            failure.path ??= fallback.path;
-            failure.from ??= fallback.from;
-        }
-    }
-    return failure;
-}
-/**
- * Resolve a one-based version or ISO timestamp into a concrete history entry.
- * Errors include structured valid-range metadata for agent and SDK callers.
- */
-export function resolveHistoryTarget(target, history, options = {}) {
-    const trimmed = target.trim();
-    const errorSubject = options.errorSubject ?? "history";
-    const errorSubjectTitle = errorSubject === "restore" ? "Restore" : "History";
-    const { guidance, lastTimestamp } = buildHistoryTargetGuidance(history, historyVersionOffset(history, true));
-    if (!trimmed) {
-        throw new PmCliError(`Missing ${errorSubject} target. Use a timestamp or version number.`, EXIT_CODE.USAGE, guidance);
-    }
-    if (/^\d+$/.test(trimmed)) {
-        const offset = historyVersionOffset(history);
-        const version = Number(trimmed);
-        if (version >= 1 && version <= offset) {
-            throw new PmCliError(`History version ${version} was pruned by compaction.`, EXIT_CODE.USAGE, {
-                ...guidance,
-                code: "history_version_pruned",
-            });
-        }
-        if (!Number.isSafeInteger(version) ||
-            version < 1 ||
-            version > offset + history.length) {
-            throw new PmCliError(`${errorSubjectTitle} version must be between ${offset + 1} and ${offset + history.length} for this item.`, EXIT_CODE.USAGE, guidance);
-        }
-        return { kind: "version", raw: trimmed, historyIndex: version - offset - 1 };
-    }
-    const parsedTarget = Date.parse(trimmed);
-    if (!Number.isFinite(parsedTarget)) {
-        throw new PmCliError(`Invalid ${errorSubject} target "${target}". Use a positive version number or ISO timestamp.`, EXIT_CODE.USAGE, guidance);
-    }
-    const historyIndex = findHistoryIndexAtTimestamp(history, parsedTarget);
-    if (historyIndex < 0 ||
-        (options.allowFutureTimestamp !== true &&
-            parsedTarget > Date.parse(lastTimestamp))) {
-        throw new PmCliError(errorSubject === "restore"
-            ? `No history entries exist at or before timestamp ${trimmed}.`
-            : `No history entry exists at timestamp ${trimmed}.`, EXIT_CODE.USAGE, guidance);
-    }
-    return { kind: "timestamp", raw: trimmed, historyIndex };
-}
-/** Apply one normalized JSON Patch entry and retain actionable failure context. */
-export function applyHistoryPatch(current, patch, entryNumber, entryOp) {
-    const applied = tryApplyReplayPatch(current, patch);
-    if (applied.ok) {
-        return applied.document;
-    }
-    const failure = extractPatchFailureContext(patch, applied.error);
-    const tokens = [
-        `history_op=${entryOp}`,
-        failure.patchIndex === undefined
-            ? null
-            : `patch_index=${failure.patchIndex}`,
-        failure.op ? `op=${failure.op}` : null,
-        failure.path ? `path=${failure.path}` : null,
-        failure.from ? `from=${failure.from}` : null,
-    ].filter((token) => token !== null);
-    throw new PmCliError(`Failed to apply history patch at entry ${entryNumber} (${tokens.join(", ")}). ${failure.reason ?? String(applied.error)}`, EXIT_CODE.GENERIC_FAILURE);
-}
-/** Replay and hash-verify a history stream through a zero-based target entry. */
-export function replayHistoryToTarget(history, targetIndex) {
-    const first = history[0];
-    if (first && first.op !== "create" && first.op !== "history_compact_baseline") {
-        const baseline = tryApplyReplayPatch(EMPTY_REPLAY_DOCUMENT, first.patch);
-        if (!baseline.ok || typeof baseline.document.metadata.id !== "string") {
-            throw new PmCliError("History starts without a reconstructable item baseline.", EXIT_CODE.GENERIC_FAILURE, {
-                code: "history_baseline_unavailable",
-                required: "Recover the original create entry or a complete checkpoint from version control.",
-                nextSteps: ["Run pm history <id> --full to inspect the missing baseline."],
-            });
-        }
-    }
-    const selected = history.slice(0, targetIndex + 1);
-    const verification = verifyHistoryChain([...selected]);
-    let document = structuredClone(EMPTY_REPLAY_DOCUMENT);
-    for (let index = 0; index <= targetIndex; index += 1) {
-        const entry = history[index];
-        if (!entry) {
-            throw new PmCliError(`History target entry ${index + 1} does not exist.`, EXIT_CODE.USAGE);
-        }
-        document = applyHistoryPatch(document, entry.patch, index + 1, entry.op);
-    }
-    if (!verification.ok) {
-        throw new PmCliError(`History cannot be replayed: ${verification.errors.join(", ")}.`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "history_replay_invalid",
-            verification_errors: verification.errors,
-            required: "Inspect the history integrity findings before attempting recovery.",
-            nextSteps: ["Run pm history <id> --verify --full."],
-        });
-    }
-    return document;
-}
-/** Reject a version whose reconstructed state represents a deleted item. */
-export function ensureMaterializedHistoryTarget(replayDocument, target) {
-    if (Object.keys(replayDocument.metadata).length > 0) {
-        if (typeof replayDocument.metadata.id !== "string" || !Array.isArray(replayDocument.metadata.tags)) {
-            throw new PmCliError("History has no complete item baseline for this target.", EXIT_CODE.GENERIC_FAILURE, {
-                code: "history_baseline_unavailable",
-                required: "Recover the original create entry or a complete checkpoint from version control.",
-                nextSteps: ["Run pm history <id> --full to inspect the first recorded state."],
-            });
-        }
-        return replayDocument;
-    }
-    throw new PmCliError(`History target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`, EXIT_CODE.USAGE);
-}
+!(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]="8835b501-34c7-51ba-b02e-782f8a457e1b")}catch(e2){}})();import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{historyVersionOffset}from"./version-address.js";import{EMPTY_REPLAY_DOCUMENT,verifyHistoryChain,tryApplyReplayPatch}from"./replay.js";function findHistoryIndexAtTimestamp(history,parsedTarget){let historyIndex=-1;history.forEach((entry,index)=>{const entryTimestamp=Date.parse(entry.ts);if(!Number.isFinite(entryTimestamp)){throw new PmCliError(`History for this item contains invalid timestamp at entry ${index+1}.`,EXIT_CODE.GENERIC_FAILURE)}if(entryTimestamp<=parsedTarget){historyIndex=index}});return historyIndex}function buildHistoryTargetGuidance(history,offset){const firstTimestamp=history[0]?.ts??null;const lastTimestamp=history.at(-1)?.ts??null;const guidance={code:"history_target_out_of_range",required:"Choose a target within the available item history.",why:"Point-in-time reads and restores can only reconstruct recorded versions.",examples:[],nextSteps:["Run pm history <id> to inspect available versions and timestamps."],valid_range:{first_version:null,last_version:null,first_timestamp:firstTimestamp,last_timestamp:lastTimestamp}};if(lastTimestamp!==null){guidance.examples=[lastTimestamp];if(offset!==null){guidance.examples.unshift(String(offset+1),String(offset+history.length));guidance.valid_range.first_version=offset+1;guidance.valid_range.last_version=offset+history.length}}return{guidance,lastTimestamp}}function extractPatchFailureContext(patch,error){const failure={};if(error instanceof Error&&error.message.trim().length>0){failure.reason=error.message.trim()}if(typeof error!=="object"||error===null){return failure}const candidate=error;if(typeof candidate.index==="number"&&Number.isInteger(candidate.index)&&candidate.index>=0){failure.patchIndex=candidate.index}if(typeof candidate.operation==="object"&&candidate.operation!==null){const operation=candidate.operation;Object.assign(failure,Object.fromEntries(["op","path","from"].flatMap(field=>{const value=operation[field];return typeof value==="string"?[[field,value]]:[]})))}if(failure.patchIndex!==void 0){const fallback=patch[failure.patchIndex];if(fallback){failure.op??=fallback.op;failure.path??=fallback.path;failure.from??=fallback.from}}return failure}function resolveHistoryTarget(target,history,options={}){const trimmed=target.trim();const errorSubject=options.errorSubject??"history";const errorSubjectTitle=errorSubject==="restore"?"Restore":"History";const{guidance,lastTimestamp}=buildHistoryTargetGuidance(history,historyVersionOffset(history,true));if(!trimmed){throw new PmCliError(`Missing ${errorSubject} target. Use a timestamp or version number.`,EXIT_CODE.USAGE,guidance)}if(/^\d+$/.test(trimmed)){const offset=historyVersionOffset(history);const version=Number(trimmed);if(version>=1&&version<=offset){throw new PmCliError(`History version ${version} was pruned by compaction.`,EXIT_CODE.USAGE,{...guidance,code:"history_version_pruned"})}if(!Number.isSafeInteger(version)||version<1||version>offset+history.length){throw new PmCliError(`${errorSubjectTitle} version must be between ${offset+1} and ${offset+history.length} for this item.`,EXIT_CODE.USAGE,guidance)}return{kind:"version",raw:trimmed,historyIndex:version-offset-1}}const parsedTarget=Date.parse(trimmed);if(!Number.isFinite(parsedTarget)){throw new PmCliError(`Invalid ${errorSubject} target "${target}". Use a positive version number or ISO timestamp.`,EXIT_CODE.USAGE,guidance)}const historyIndex=findHistoryIndexAtTimestamp(history,parsedTarget);if(historyIndex<0||options.allowFutureTimestamp!==true&&parsedTarget>Date.parse(lastTimestamp)){throw new PmCliError(errorSubject==="restore"?`No history entries exist at or before timestamp ${trimmed}.`:`No history entry exists at timestamp ${trimmed}.`,EXIT_CODE.USAGE,guidance)}return{kind:"timestamp",raw:trimmed,historyIndex}}function applyHistoryPatch(current,patch,entryNumber,entryOp){const applied=tryApplyReplayPatch(current,patch);if(applied.ok){return applied.document}const failure=extractPatchFailureContext(patch,applied.error);const tokens=[`history_op=${entryOp}`,failure.patchIndex===void 0?null:`patch_index=${failure.patchIndex}`,failure.op?`op=${failure.op}`:null,failure.path?`path=${failure.path}`:null,failure.from?`from=${failure.from}`:null].filter(token=>token!==null);throw new PmCliError(`Failed to apply history patch at entry ${entryNumber} (${tokens.join(", ")}). ${failure.reason??String(applied.error)}`,EXIT_CODE.GENERIC_FAILURE)}function replayHistoryToTarget(history,targetIndex){const first=history[0];if(first&&first.op!=="create"&&first.op!=="history_compact_baseline"){const baseline=tryApplyReplayPatch(EMPTY_REPLAY_DOCUMENT,first.patch);if(!baseline.ok||typeof baseline.document.metadata.id!=="string"){throw new PmCliError("History starts without a reconstructable item baseline.",EXIT_CODE.GENERIC_FAILURE,{code:"history_baseline_unavailable",required:"Recover the original create entry or a complete checkpoint from version control.",nextSteps:["Run pm history <id> --full to inspect the missing baseline."]})}}const selected=history.slice(0,targetIndex+1);const verification=verifyHistoryChain([...selected]);let document=structuredClone(EMPTY_REPLAY_DOCUMENT);for(let index=0;index<=targetIndex;index+=1){const entry=history[index];if(!entry){throw new PmCliError(`History target entry ${index+1} does not exist.`,EXIT_CODE.USAGE)}document=applyHistoryPatch(document,entry.patch,index+1,entry.op)}if(!verification.ok){throw new PmCliError(`History cannot be replayed: ${verification.errors.join(", ")}.`,EXIT_CODE.GENERIC_FAILURE,{code:"history_replay_invalid",verification_errors:verification.errors,required:"Inspect the history integrity findings before attempting recovery.",nextSteps:["Run pm history <id> --verify --full."]})}return document}function ensureMaterializedHistoryTarget(replayDocument,target){if(Object.keys(replayDocument.metadata).length>0){if(typeof replayDocument.metadata.id!=="string"||!Array.isArray(replayDocument.metadata.tags)){throw new PmCliError("History has no complete item baseline for this target.",EXIT_CODE.GENERIC_FAILURE,{code:"history_baseline_unavailable",required:"Recover the original create entry or a complete checkpoint from version control.",nextSteps:["Run pm history <id> --full to inspect the first recorded state."]})}return replayDocument}throw new PmCliError(`History target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,EXIT_CODE.USAGE)}export{applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,replayHistoryToTarget,resolveHistoryTarget};
 //# sourceMappingURL=projection.js.map
-//# debugId=2efbffc1-722c-5f3a-9ca5-e4e7a4f97729

package/dist/core/history/read.d.ts

@@ -1,3 +1,12 @@
 import type { HistoryEntry } from "../../types/index.js";
+/** Exact bytes and decoded entries from one read, suitable for optimistic concurrency checks. */
+export interface HistoryStreamSnapshot {
+    /** Null means the stream did not exist; an empty string means it existed without entries. */
+    raw: string | null;
+    /** Entries decoded from precisely the bytes in `raw`, after read hooks run. */
+    entries: HistoryEntry[];
+}
+/** Read one history stream once so replay input and the concurrency snapshot cannot disagree. */
+export declare function readHistorySnapshot(historyPath: string, itemId: string): Promise<HistoryStreamSnapshot>;
 /** Read and validate one item's JSONL history stream without mutating it. */
 export declare function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]>;

package/dist/core/history/read.js

@@ -1,58 +1,2 @@
-/**
- * @module core/history/read
- *
- * Reads append-only item history streams with conflict-marker detection,
- * extension read hooks, and line-specific JSONL diagnostics. Keeping this
- * storage primitive below both the CLI and SDK prevents public history
- * maintenance APIs from depending on presentation-layer modules.
- */
-
-!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]="999c126a-112a-50f6-b53e-bd36dbc5b885")}catch(e){}}();
-import { readFileIfExists } from "../fs/fs-utils.js";
-import { runActiveOnReadHooks } from "../extensions/index.js";
-import { EXIT_CODE } from "../shared/constants.js";
-import { findFirstMergeConflictMarker } from "../shared/conflict-markers.js";
-import { PmCliError } from "../shared/errors.js";
-/** Read and validate one item's JSONL history stream without mutating it. */
-export async function readHistoryEntries(historyPath, itemId) {
-    const raw = await readFileIfExists(historyPath);
-    if (raw === null) {
-        return [];
-    }
-    await runActiveOnReadHooks({ path: historyPath, scope: "project" });
-    if (raw.trim() === "") {
-        return [];
-    }
-    const conflictMarker = findFirstMergeConflictMarker(raw);
-    if (conflictMarker) {
-        throw new PmCliError(`History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "history_merge_conflict_markers_detected",
-            required: "Repair the history stream by resolving merge-conflict markers.",
-            why: "Conflict markers break JSONL parsing and invalidate deterministic audit history.",
-            examples: [
-                `pm history ${itemId}`,
-                `pm restore ${itemId} <timestamp-or-version>`,
-            ],
-            nextSteps: ["Resolve or restore the history file, then rerun the command."],
-        });
-    }
-    const entries = [];
-    for (const [index, rawLine] of raw.split(/\r?\n/).entries()) {
-        const line = rawLine.trim();
-        if (!line) {
-            continue;
-        }
-        try {
-            entries.push(JSON.parse(line));
-        }
-        catch {
-            throw new PmCliError(`History for ${itemId} contains invalid JSON at line ${index + 1}. Repair or restore the history stream and retry.`, EXIT_CODE.GENERIC_FAILURE, {
-                code: "history_json_invalid",
-                nextSteps: [`Run pm history-repair ${itemId} --salvage-tail --dry-run to check whether only an invalid suffix is damaged.`],
-            });
-        }
-    }
-    return entries;
-}
+!(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]="bfa74c9e-a366-5b09-a7bc-869226fb6140")}catch(e2){}})();import{readFileIfExists}from"../fs/fs-utils.js";import{runActiveOnReadHooks}from"../extensions/index.js";import{EXIT_CODE}from"../shared/constants.js";import{findFirstMergeConflictMarker}from"../shared/conflict-markers.js";import{PmCliError}from"../shared/errors.js";async function readHistorySnapshot(historyPath,itemId){const raw=await readFileIfExists(historyPath);if(raw===null){return{raw,entries:[]}}await runActiveOnReadHooks({path:historyPath,scope:"project"});if(raw.trim()===""){return{raw,entries:[]}}const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){throw new PmCliError(`History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,EXIT_CODE.GENERIC_FAILURE,{code:"history_merge_conflict_markers_detected",required:"Repair the history stream by resolving merge-conflict markers.",why:"Conflict markers break JSONL parsing and invalidate deterministic audit history.",examples:[`pm history ${itemId}`,`pm restore ${itemId} <timestamp-or-version>`],nextSteps:["Resolve or restore the history file, then rerun the command."]})}const entries=[];for(const[index,rawLine]of raw.split(/\r?\n/).entries()){const line=rawLine.trim();if(!line){continue}try{entries.push(JSON.parse(line))}catch{throw new PmCliError(`History for ${itemId} contains invalid JSON at line ${index+1}. Repair or restore the history stream and retry.`,EXIT_CODE.GENERIC_FAILURE,{code:"history_json_invalid",nextSteps:[`Run pm history-repair ${itemId} --salvage-tail --dry-run to check whether only an invalid suffix is damaged.`]})}}return{raw,entries}}async function readHistoryEntries(historyPath,itemId){return(await readHistorySnapshot(historyPath,itemId)).entries}export{readHistoryEntries,readHistorySnapshot};
 //# sourceMappingURL=read.js.map
-//# debugId=999c126a-112a-50f6-b53e-bd36dbc5b885