@unbrained/pm-cli 2026.6.5 → 2026.6.6

package/dist/cli-bundle/chunks/{chunk-KBG47ZOY.js → chunk-LB3RUL2N.js}

@@ -3,7 +3,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -19,7 +19,7 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/schema/runtime-field-values.js
 function toCamelToken(value) {
@@ -1320,6 +1320,6 @@ export {
   serializeItemDocument,
   canonicalDocument
 };
-//# sourceMappingURL=chunk-KBG47ZOY.js.map
+//# sourceMappingURL=chunk-LB3RUL2N.js.map
 
 //# debugId=b9b7439e-7986-5a85-9356-8d54578b038a

package/dist/cli-bundle/chunks/{chunk-HZOS2UG5.js → chunk-LCM63IXU.js}

@@ -4,7 +4,7 @@ import {
   runActiveRendererOverride,
   runActiveServiceOverrideSync,
   setActiveCommandResult
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/core/output/mutation-projection.js
 !(function() {
@@ -339,4 +339,4 @@ export {
   printResult,
   printError
 };
-//# sourceMappingURL=chunk-HZOS2UG5.js.map
+//# sourceMappingURL=chunk-LCM63IXU.js.map

package/dist/cli-bundle/chunks/{chunk-VGO2T3TY.js → chunk-ME2YH6FN.js}

@@ -2,22 +2,22 @@
 !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]="ede3cf3f-6ca9-5eb0-aeb7-cd997702397f")}catch(e){}}();
 import {
   readHistoryEntries
-} from "./chunk-V3JQ4IPL.js";
+} from "./chunk-2RSPZI5H.js";
 import {
   parseLimit
-} from "./chunk-GFWHHMVV.js";
+} from "./chunk-3VAM3NNM.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -27,7 +27,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -177,6 +177,6 @@ async function runActivity(options, global) {
 export {
   runActivity
 };
-//# sourceMappingURL=chunk-VGO2T3TY.js.map
+//# sourceMappingURL=chunk-ME2YH6FN.js.map
 
 //# debugId=ede3cf3f-6ca9-5eb0-aeb7-cd997702397f

package/dist/cli-bundle/chunks/{chunk-ZRVSMOMR.js → chunk-MITFDD35.js}

@@ -12,25 +12,25 @@ import {
   parseLinkedTestMinLines,
   parseLinkedTestRegexList,
   parseLinkedTestStringList
-} from "./chunk-KCMIYKTA.js";
+} from "./chunk-E5FJNAZA.js";
 import {
   createStdinTokenResolver,
   mergeAdditiveTags,
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-O5IBJE6S.js";
+} from "./chunk-PO3GSVFV.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-MISYRLEP.js";
+} from "./chunk-77GFDHGF.js";
 import {
   buildInvalidTypeError
-} from "./chunk-26KTVXJW.js";
+} from "./chunk-6P6GGMOG.js";
 import {
   printError
-} from "./chunk-AXXKLVTW.js";
+} from "./chunk-NUZ5HKR4.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -39,18 +39,18 @@ import {
   createHistoryEntry,
   locateItem,
   parseRegisteredItemFieldAssignments
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   generateItemId,
   normalizeItemId
-} from "./chunk-SSFMJCPF.js";
+} from "./chunk-HZGUAH22.js";
 import {
   canonicalDocument,
   collectRuntimeCreateFieldValues,
   normalizeFrontMatter,
   normalizeStatusInput,
   serializeItemDocument
-} from "./chunk-KBG47ZOY.js";
+} from "./chunk-LB3RUL2N.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -59,11 +59,11 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   DEPENDENCY_KIND_VALUES,
@@ -91,7 +91,7 @@ import {
   runActiveOnWriteHooks,
   weekdayOrderIndex,
   writeFileAtomic
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/item/priority.js
 var PRIORITY_NAME_TO_VALUE = {
@@ -1804,6 +1804,6 @@ export {
   parseDocs,
   runCreate
 };
-//# sourceMappingURL=chunk-ZRVSMOMR.js.map
+//# sourceMappingURL=chunk-MITFDD35.js.map
 
 //# debugId=67af10d9-cb2f-5b7f-9238-a7eae5edeb4d

package/dist/cli-bundle/chunks/{chunk-Y2AKE2HS.js → chunk-N7ACFE26.js}

@@ -1,13 +1,13 @@
 import {
   parseOptionalNumber
-} from "./chunk-CJDQB2ED.js";
+} from "./chunk-XLTD2HN3.js";
 import {
   splitCommaList
 } from "./chunk-3HUE7XOF.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/linked-test-parsers.js
 !(function() {
@@ -249,4 +249,4 @@ export {
   looksLikeStructuredLinkedTestEntry,
   normalizeStructuredLinkedTestEntry
 };
-//# sourceMappingURL=chunk-Y2AKE2HS.js.map
+//# sourceMappingURL=chunk-N7ACFE26.js.map

package/dist/cli-bundle/chunks/{chunk-AXXKLVTW.js → chunk-NUZ5HKR4.js}

@@ -6,7 +6,7 @@ import {
   runActiveRendererOverride,
   runActiveServiceOverrideSync,
   setActiveCommandResult
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/output/mutation-projection.js
 var CHANGED_FIELDS_KEY = "changed_fields";
@@ -327,6 +327,6 @@ export {
   printResult,
   printError
 };
-//# sourceMappingURL=chunk-AXXKLVTW.js.map
+//# sourceMappingURL=chunk-NUZ5HKR4.js.map
 
 //# debugId=522b0ebd-699c-5123-b28a-4232c08e9e97

package/dist/cli-bundle/chunks/{chunk-KK6YPGH3.js → chunk-OVQCEJPG.js}

@@ -1,6 +1,6 @@
 import {
   BUILTIN_ITEM_TYPE_VALUES
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/core/schema/item-types-file.js
 !(function() {
@@ -218,4 +218,4 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-KK6YPGH3.js.map
+//# sourceMappingURL=chunk-OVQCEJPG.js.map

package/dist/cli-bundle/chunks/{chunk-B3N4TKNL.js → chunk-OZ7NSQHL.js}

@@ -12,27 +12,27 @@ import {
   parseLinkedTestMinLines,
   parseLinkedTestRegexList,
   parseLinkedTestStringList
-} from "./chunk-Y2AKE2HS.js";
+} from "./chunk-N7ACFE26.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-CJDQB2ED.js";
+} from "./chunk-XLTD2HN3.js";
 import {
   runInit
-} from "./chunk-3OH4DAEB.js";
+} from "./chunk-3LB74A67.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-XG7RJYHV.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-4PJQSECJ.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   compareTimestampStrings,
   nowIso
-} from "./chunk-RANZIID5.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   EXIT_CODE,
   ITEM_FILE_EXTENSIONS,
@@ -45,7 +45,7 @@ import {
   resolveGlobalPmRoot,
   resolvePmRoot,
   stableValueEquals
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/test.js
 import { spawn } from "node:child_process";
@@ -1678,4 +1678,4 @@ export {
   runLinkedTests,
   runTest
 };
-//# sourceMappingURL=chunk-B3N4TKNL.js.map
+//# sourceMappingURL=chunk-OZ7NSQHL.js.map

package/dist/cli-bundle/chunks/{chunk-TK633IVD.js → chunk-PDDFYW4X.js}

@@ -9,15 +9,15 @@ import {
   UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,
   readFirstStringFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-ZQ4F6EC4.js";
+} from "./chunk-PROOHX4K.js";
 import {
   refreshSearchArtifactsForMutation,
   shouldRunSearchRefreshInForeground
-} from "./chunk-5IRA6IYD.js";
+} from "./chunk-3FI4SEFT.js";
 import {
   printError,
   writeStdout
-} from "./chunk-HZOS2UG5.js";
+} from "./chunk-LCM63IXU.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -26,7 +26,7 @@ import {
   readSettings,
   resolvePmRoot,
   setActiveCommandResult
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/registration-helpers.js
 !(function() {
@@ -698,4 +698,4 @@ export {
   normalizeContextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-TK633IVD.js.map
+//# sourceMappingURL=chunk-PDDFYW4X.js.map

package/dist/cli-bundle/chunks/{chunk-DFIZGAI5.js → chunk-PIU6RSL3.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-O7IWB35H.js";
 import {
   readHistoryEntries
-} from "./chunk-WIKR7KFL.js";
+} from "./chunk-PRJCELV4.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -11,27 +11,27 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-S3CV7JGJ.js";
+} from "./chunk-UM2GBHS4.js";
 import {
   acquireLock,
   createHistoryEntry,
   locateItem,
   readLocatedItem
-} from "./chunk-XG7RJYHV.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-KA24HME7.js";
+} from "./chunk-T3LC5LKB.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-HPH6X4ZZ.js";
+} from "./chunk-AO442XLN.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-4PJQSECJ.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   nowIso
-} from "./chunk-RANZIID5.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -46,7 +46,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/history-redact.js
 import fs from "node:fs/promises";
@@ -547,4 +547,4 @@ export {
   resolveHistorySubject,
   runHistoryRedact
 };
-//# sourceMappingURL=chunk-DFIZGAI5.js.map
+//# sourceMappingURL=chunk-PIU6RSL3.js.map

package/dist/cli-bundle/chunks/{chunk-O5IBJE6S.js → chunk-PO3GSVFV.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/item/parse.js
 var STDIN_TOKEN = "-";
@@ -333,6 +333,6 @@ export {
   createStdinTokenResolver,
   parseOptionalNumber
 };
-//# sourceMappingURL=chunk-O5IBJE6S.js.map
+//# sourceMappingURL=chunk-PO3GSVFV.js.map
 
 //# debugId=782e6b42-6c10-51ac-b9b8-088e686821d0

package/dist/cli-bundle/chunks/{chunk-WIKR7KFL.js → chunk-PRJCELV4.js}

@@ -1,25 +1,27 @@
 import {
+  cloneEmptyReplayDocument,
+  tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-S3CV7JGJ.js";
+} from "./chunk-UM2GBHS4.js";
 import {
   parseLimit
-} from "./chunk-K47WAYQV.js";
+} from "./chunk-WKY2IBOQ.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
   hashEmptyDocument,
   locateItem,
   readLocatedItem
-} from "./chunk-XG7RJYHV.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   normalizeItemId
-} from "./chunk-KA24HME7.js";
+} from "./chunk-T3LC5LKB.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-HPH6X4ZZ.js";
+} from "./chunk-AO442XLN.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-4PJQSECJ.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -31,38 +33,120 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
-// dist/cli/commands/history.js
+// dist/core/history/history-diff.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] = "7dab57b7-674a-5649-ac20-6307a59ce87d");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2b77be38-f27c-5a56-86de-9625777f7211");
   } catch (e2) {
   }
 })();
-function limitEntries(values, limit) {
-  if (limit === void 0)
-    return values;
-  return values.slice(Math.max(0, values.length - limit));
-}
 function decodeJsonPointerSegment(segment) {
   return segment.replaceAll("~1", "/").replaceAll("~0", "~");
 }
 function patchPathToChangedField(path) {
-  if (path === "/body" || path.startsWith("/body/")) {
+  if (path === "/body" || path.startsWith("/body/"))
     return "body";
-  }
   if (path === "/metadata" || path.startsWith("/metadata/") || path === "/front_matter" || path.startsWith("/front_matter/")) {
     const segment2 = path.replace(/^\/(?:metadata|front_matter)\/?/, "").split("/")[0];
-    if (!segment2) {
+    if (!segment2)
       return "metadata";
-    }
     return decodeJsonPointerSegment(segment2);
   }
   const segment = path.replace(/^\//, "").split("/")[0];
   return segment ? decodeJsonPointerSegment(segment) : "root";
 }
+function readFieldValue(doc, field) {
+  if (field === "body")
+    return doc.body;
+  if (field === "metadata")
+    return doc.metadata;
+  if (field === "root")
+    return doc;
+  return doc.metadata[field];
+}
+function computeHistoryDiff(fullEntries, options) {
+  const windowStartIndex = options?.windowStartIndex ?? 0;
+  const fieldFilter = options?.field;
+  if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {
+    return [];
+  }
+  let current = cloneEmptyReplayDocument();
+  const result = [];
+  for (let p = 0; p < fullEntries.length; p += 1) {
+    const entry = fullEntries[p];
+    const beforeDoc = current;
+    const applied = tryApplyReplayPatch(current, entry.patch);
+    let afterDoc;
+    if (applied.ok) {
+      afterDoc = applied.document;
+      current = afterDoc;
+    } else {
+      afterDoc = beforeDoc;
+    }
+    const changedFieldSet = /* @__PURE__ */ new Set();
+    for (const patchOp of entry.patch) {
+      changedFieldSet.add(patchPathToChangedField(patchOp.path));
+      if (patchOp.from !== void 0) {
+        changedFieldSet.add(patchPathToChangedField(patchOp.from));
+      }
+    }
+    const sortedFields = [...changedFieldSet].sort((a, b) => a.localeCompare(b));
+    if (p >= windowStartIndex) {
+      if (fieldFilter !== void 0) {
+        if (!changedFieldSet.has(fieldFilter)) {
+          continue;
+        }
+        const change = {
+          field: fieldFilter,
+          before: readFieldValue(beforeDoc, fieldFilter),
+          after: readFieldValue(afterDoc, fieldFilter)
+        };
+        result.push({
+          index: p + 1,
+          ts: entry.ts,
+          op: entry.op,
+          author: entry.author,
+          patch_ops: entry.patch.length,
+          changed_fields: [fieldFilter],
+          changes: [change]
+        });
+      } else {
+        const changes = sortedFields.map((field) => ({
+          field,
+          before: readFieldValue(beforeDoc, field),
+          after: readFieldValue(afterDoc, field)
+        }));
+        result.push({
+          index: p + 1,
+          ts: entry.ts,
+          op: entry.op,
+          author: entry.author,
+          patch_ops: entry.patch.length,
+          changed_fields: sortedFields,
+          changes
+        });
+      }
+    }
+  }
+  return result;
+}
+
+// dist/cli/commands/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] = "50bc01ba-8e6c-54aa-a0f7-81540f1eaddc");
+  } catch (e2) {
+  }
+})();
+function limitEntries(values, limit) {
+  if (limit === void 0)
+    return values;
+  return values.slice(Math.max(0, values.length - limit));
+}
 function buildDiffEntries(entries, startIndex) {
   return entries.map((entry, index) => {
     const changedFields = /* @__PURE__ */ new Set();
@@ -153,8 +237,11 @@ async function runHistory(id, options, global2) {
     count: history.length,
     limit: limit ?? null
   };
-  if (options.diff) {
-    result.diff = compact ? [] : buildDiffEntries(history, Math.max(0, fullHistory.length - history.length));
+  if (options.diff || options.field !== void 0) {
+    result.diff = computeHistoryDiff(fullHistory, {
+      windowStartIndex: Math.max(0, fullHistory.length - history.length),
+      field: options.field
+    });
   }
   if (options.verify) {
     const verification = verifyHistoryChain(fullHistory);
@@ -186,4 +273,4 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-WIKR7KFL.js.map
+//# sourceMappingURL=chunk-PRJCELV4.js.map

package/dist/cli-bundle/chunks/chunk-PRJCELV4.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/history/history-diff.ts", "../../../../../../../../cli/commands/history.ts"],
+  "sourcesContent": ["import { cloneEmptyReplayDocument, tryApplyReplayPatch, type ReplayDocument } from \"./replay.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\nexport interface HistoryFieldChange {\n  field: string;\n  // before and after are the raw field values captured by replaying the history chain.\n  // `undefined` is intentional: it signals that the field was absent in the document at\n  // that point (e.g. after a JSON-Patch `remove` op). JSON serialization will omit\n  // undefined values, which correctly communicates \"field did not exist\".\n  before: unknown;\n  after: unknown;\n}\n\nexport interface HistoryDiffValueEntry {\n  /** 1-based position in the FULL stream (fullEntries index + 1). */\n  index: number;\n  ts: string;\n  op: string;\n  author: string;\n  /** Number of JSON-patch operations in this entry (entry.patch.length). */\n  patch_ops: number;\n  /** Unique field names touched by this entry, sorted by localeCompare. */\n  changed_fields: string[];\n  /** Per-field before/after values, sorted by field name (localeCompare). */\n  changes: HistoryFieldChange[];\n}\n\n// ---------------------------------------------------------------------------\n// JSON-Pointer helpers (ported from src/cli/commands/history.ts so the\n// orchestrator can replace the private copy there with an import from here).\n// ---------------------------------------------------------------------------\n\nfunction decodeJsonPointerSegment(segment: string): string {\n  return segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n}\n\n/**\n * Map a JSON-Patch path string to a human-readable changed-field name.\n *\n * Rules (in priority order):\n *  - \"/body\" or \"/body/…\"                      → \"body\"\n *  - \"/metadata/…\" or \"/front_matter/…\"\n *      with a first segment                     → that decoded segment (e.g. \"status\")\n *      without a first segment (bare prefix)    → \"metadata\"\n *  - \"/\" (root pointer, empty segment after strip) → \"root\"\n *  - anything else                               → decoded first path segment\n */\nexport function patchPathToChangedField(path: string): string {\n  if (path === \"/body\" || path.startsWith(\"/body/\")) return \"body\";\n  if (\n    path === \"/metadata\" ||\n    path.startsWith(\"/metadata/\") ||\n    path === \"/front_matter\" ||\n    path.startsWith(\"/front_matter/\")\n  ) {\n    const segment = path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    if (!segment) return \"metadata\";\n    return decodeJsonPointerSegment(segment);\n  }\n  const segment = path.replace(/^\\//, \"\").split(\"/\")[0];\n  return segment ? decodeJsonPointerSegment(segment) : \"root\";\n}\n\n// ---------------------------------------------------------------------------\n// Field-value reader\n// ---------------------------------------------------------------------------\n\n/**\n * Extract the before/after value for a logical field from a replay document.\n *\n * - \"body\"     → doc.body\n * - \"metadata\" → doc.metadata (the whole object, for a bare /metadata replace)\n * - \"root\"     → the whole document (for a bare \"/\" patch op)\n * - other      → doc.metadata[field] (may be undefined when the field was absent)\n */\nfunction readFieldValue(doc: ReplayDocument, field: string): unknown {\n  if (field === \"body\") return doc.body;\n  if (field === \"metadata\") return doc.metadata;\n  if (field === \"root\") return doc;\n  return doc.metadata[field];\n}\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Replay a full history entry stream and produce enriched diff entries with\n * per-field before/after values.\n *\n * @param fullEntries   The complete ordered history chain to replay.\n * @param options.windowStartIndex  0-based index into fullEntries at which the\n *   DISPLAYED window begins. Entries before this index are still replayed (so\n *   state is accurate) but are not emitted. Defaults to 0.\n * @param options.field  When supplied, only entries that changed this field are\n *   emitted, and each emitted entry's `changes` and `changed_fields` are\n *   restricted to that single field.\n */\nexport function computeHistoryDiff(\n  fullEntries: HistoryEntry[],\n  options?: { windowStartIndex?: number; field?: string },\n): HistoryDiffValueEntry[] {\n  const windowStartIndex = options?.windowStartIndex ?? 0;\n  const fieldFilter = options?.field;\n\n  if (fullEntries.length === 0 || windowStartIndex >= fullEntries.length) {\n    return [];\n  }\n\n  let current = cloneEmptyReplayDocument();\n  const result: HistoryDiffValueEntry[] = [];\n\n  for (let p = 0; p < fullEntries.length; p += 1) {\n    const entry = fullEntries[p];\n\n    // Capture before state.\n    const beforeDoc = current;\n\n    // Attempt to apply patch.\n    const applied = tryApplyReplayPatch(current, entry.patch);\n    let afterDoc: ReplayDocument;\n    if (applied.ok) {\n      afterDoc = applied.document;\n      current = afterDoc;\n    } else {\n      // Patch failed — use before state as after (cannot trust partial result).\n      // Do NOT advance current; keep prior replay state.\n      afterDoc = beforeDoc;\n    }\n\n    // Collect changed field names from patch paths (and from: paths for move/copy).\n    const changedFieldSet = new Set<string>();\n    for (const patchOp of entry.patch) {\n      changedFieldSet.add(patchPathToChangedField(patchOp.path));\n      if (patchOp.from !== undefined) {\n        changedFieldSet.add(patchPathToChangedField(patchOp.from));\n      }\n    }\n    const sortedFields = [...changedFieldSet].sort((a, b) => a.localeCompare(b));\n\n    // Only emit entries in the display window.\n    if (p >= windowStartIndex) {\n      // Apply field filter: skip this entry entirely if it doesn't touch the\n      // requested field; otherwise narrow down to only that field.\n      if (fieldFilter !== undefined) {\n        if (!changedFieldSet.has(fieldFilter)) {\n          // This entry does not touch the requested field — skip it.\n          continue;\n        }\n        // Emit only the filtered field.\n        const change: HistoryFieldChange = {\n          field: fieldFilter,\n          before: readFieldValue(beforeDoc, fieldFilter),\n          after: readFieldValue(afterDoc, fieldFilter),\n        };\n        result.push({\n          index: p + 1,\n          ts: entry.ts,\n          op: entry.op,\n          author: entry.author,\n          patch_ops: entry.patch.length,\n          changed_fields: [fieldFilter],\n          changes: [change],\n        });\n      } else {\n        // Emit all changed fields.\n        const changes: HistoryFieldChange[] = sortedFields.map((field) => ({\n          field,\n          before: readFieldValue(beforeDoc, field),\n          after: readFieldValue(afterDoc, field),\n        }));\n        result.push({\n          index: p + 1,\n          ts: entry.ts,\n          op: entry.op,\n          author: entry.author,\n          patch_ops: entry.patch.length,\n          changed_fields: sortedFields,\n          changes,\n        });\n      }\n    }\n  }\n\n  return result;\n}\n", "import { pathExists, readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport { computeHistoryDiff, patchPathToChangedField, type HistoryDiffValueEntry } from \"../../core/history/history-diff.js\";\nimport { hashDocument, hashEmptyDocument } from \"../../core/history/history.js\";\nimport { verifyHistoryChain } from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { findFirstMergeConflictMarker } from \"../../core/shared/conflict-markers.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport { normalizeItemId } from \"../../core/item/id.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\nexport { verifyHistoryChain } from \"../../core/history/replay.js\";\n\nexport interface HistoryCommandOptions {\n  limit?: string;\n  diff?: boolean;\n  /** Restrict --diff to a single field's before/after transitions (implies --diff). */\n  field?: string;\n  verify?: boolean;\n  compact?: boolean;\n}\n\nexport interface HistoryDiffEntry {\n  index: number;\n  ts: string;\n  op: string;\n  author: string;\n  patch_ops: number;\n  changed_fields: string[];\n}\n\nexport interface HistoryVerificationResult {\n  ok: boolean;\n  entries: number;\n  errors: string[];\n  latest_after_hash?: string;\n  current_item_hash?: string;\n  current_matches_latest?: boolean;\n}\n\nexport interface HistoryResult {\n  id: string;\n  history: HistoryEntry[];\n  compact_history?: HistoryDiffEntry[];\n  compact: boolean;\n  count: number;\n  limit: number | null;\n  diff?: HistoryDiffValueEntry[];\n  verification?: HistoryVerificationResult;\n}\n\nfunction limitEntries<T>(values: T[], limit: number | undefined): T[] {\n  if (limit === undefined) return values;\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction buildDiffEntries(entries: HistoryEntry[], startIndex: number): HistoryDiffEntry[] {\n  return entries.map((entry, index) => {\n    const changedFields = new Set<string>();\n    for (const op of entry.patch) {\n      changedFields.add(patchPathToChangedField(op.path));\n      if (op.from) {\n        changedFields.add(patchPathToChangedField(op.from));\n      }\n    }\n    return {\n      index: startIndex + index + 1,\n      ts: entry.ts,\n      op: entry.op,\n      author: entry.author,\n      patch_ops: entry.patch.length,\n      changed_fields: [...changedFields].sort((left, right) => left.localeCompare(right)),\n    };\n  });\n}\n\nexport async function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]> {\n  const raw = await readFileIfExists(historyPath);\n  if (raw === null) {\n    return [];\n  }\n  await runActiveOnReadHooks({\n    path: historyPath,\n    scope: \"project\",\n  });\n  if (raw.trim() === \"\") {\n    return [];\n  }\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    throw new PmCliError(\n      `History for ${itemId} contains merge conflict markers at line ${conflictMarker.line} (${conflictMarker.marker}). Resolve <<<<<<< ======= >>>>>>> markers and retry.`,\n      EXIT_CODE.GENERIC_FAILURE,\n      {\n        code: \"history_merge_conflict_markers_detected\",\n        required: \"Repair the history stream by resolving merge-conflict markers.\",\n        why: \"Conflict markers break JSONL parsing and invalidate deterministic audit history.\",\n        examples: [`pm history ${itemId}`, `pm restore ${itemId} <timestamp-or-version>`],\n        nextSteps: [\"Resolve or restore the history file, then rerun the command.\"],\n      },\n    );\n  }\n\n  const entries: HistoryEntry[] = [];\n  const lines = raw.split(/\\r?\\n/);\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]?.trim();\n    if (!line) continue;\n    try {\n      entries.push(JSON.parse(line) as HistoryEntry);\n    } catch {\n      throw new PmCliError(\n        `History for ${itemId} contains invalid JSON at line ${index + 1}. Repair or restore the history stream and retry.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n  return entries;\n}\n\nexport async function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const limit = parseLimit(options.limit);\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const located = await locateItem(\n    pmRoot,\n    normalizedId,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  const resolvedId = located?.id ?? normalizedId;\n  const historyPath = getHistoryPath(pmRoot, resolvedId);\n  if (!located && !(await pathExists(historyPath))) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  if (located) {\n    await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"history\",\n    });\n  }\n\n  const fullHistory = await readHistoryEntries(historyPath, resolvedId);\n  const history = limitEntries(fullHistory, limit);\n  const compact = options.compact === true;\n  const compactHistory = compact ? buildDiffEntries(history, Math.max(0, fullHistory.length - history.length)) : undefined;\n  const result: HistoryResult = {\n    id: resolvedId,\n    history: compact ? [] : history,\n    compact_history: compactHistory,\n    compact,\n    count: history.length,\n    limit: limit ?? null,\n  };\n\n  if (options.diff || options.field !== undefined) {\n    // --diff replays the full chain to surface per-field before/after values for\n    // the displayed window (the latest --limit entries). --field narrows to a\n    // single field's transitions (\"when did status change?\"). Unlike the compact\n    // projection above, the value diff is independent of the compact/full toggle.\n    result.diff = computeHistoryDiff(fullHistory, {\n      windowStartIndex: Math.max(0, fullHistory.length - history.length),\n      field: options.field,\n    });\n  }\n\n  if (options.verify) {\n    const verification = verifyHistoryChain(fullHistory);\n    const latestAfterHash = fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : hashEmptyDocument();\n    let currentItemHash: string | undefined;\n    let currentMatchesLatest: boolean | undefined;\n    const errors = [...verification.errors];\n\n    if (located) {\n      const loaded = await readLocatedItem(located, { schema: settings.schema });\n      currentItemHash = hashDocument(loaded.document);\n      currentMatchesLatest = currentItemHash === latestAfterHash;\n      if (!currentMatchesLatest) {\n        errors.push(\"verify_failed:current_item_hash_mismatch\");\n      }\n    }\n\n    result.verification = {\n      ok: errors.length === 0,\n      entries: fullHistory.length,\n      errors,\n      latest_after_hash: fullHistory.length > 0 ? fullHistory[fullHistory.length - 1].after_hash : undefined,\n      current_item_hash: currentItemHash,\n      current_matches_latest: currentMatchesLatest,\n    };\n  }\n\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["segment", "global"]
+}