@unbrained/pm-cli 2026.6.5 → 2026.6.6

package/dist/cli-bundle/chunks/{chunk-V3JQ4IPL.js → chunk-2RSPZI5H.js}

@@ -1,27 +1,29 @@
 
-!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]="c3c3a6a6-848a-5fe4-b29e-00bb9da9ec29")}catch(e){}}();
+!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]="553e38e9-7271-599b-ac5e-73e58e64f044")}catch(e){}}();
 import {
+  cloneEmptyReplayDocument,
+  tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-ASQM3IF5.js";
+} from "./chunk-GXSUPCBV.js";
 import {
   parseLimit
-} from "./chunk-GFWHHMVV.js";
+} from "./chunk-3VAM3NNM.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
   hashEmptyDocument,
   locateItem,
   readLocatedItem
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   normalizeItemId
-} from "./chunk-SSFMJCPF.js";
+} from "./chunk-HZGUAH22.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-KBG47ZOY.js";
+} from "./chunk-LB3RUL2N.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -33,31 +35,106 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
-// dist/cli/commands/history.js
-function limitEntries(values, limit) {
-  if (limit === void 0)
-    return values;
-  return values.slice(Math.max(0, values.length - limit));
-}
+// dist/core/history/history-diff.js
 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 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();
@@ -148,8 +225,11 @@ async function runHistory(id, options, global) {
     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);
@@ -181,6 +261,6 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-V3JQ4IPL.js.map
+//# sourceMappingURL=chunk-2RSPZI5H.js.map
 
-//# debugId=c3c3a6a6-848a-5fe4-b29e-00bb9da9ec29
+//# debugId=553e38e9-7271-599b-ac5e-73e58e64f044

package/dist/cli-bundle/chunks/chunk-2RSPZI5H.js.map

@@ -0,0 +1 @@
+{"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"],"names":["segment"],"mappings":"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","debugId":"553e38e9-7271-599b-ac5e-73e58e64f044"}

package/dist/cli-bundle/chunks/{chunk-SZQCER6S.js → chunk-2VBQ6ZXS.js}

@@ -6,7 +6,7 @@ import {
   normalizeItemTypeDefinition,
   normalizeItemTypeStringList,
   strictPolicyCommand
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/item/type-registry.js
 var DEFAULT_REQUIRED_CREATE_FIELDS = [
@@ -626,6 +626,6 @@ export {
   resolveCommandOptionPolicyState,
   validateTypeOptions
 };
-//# sourceMappingURL=chunk-SZQCER6S.js.map
+//# sourceMappingURL=chunk-2VBQ6ZXS.js.map
 
 //# debugId=504f2618-801b-5331-a3a6-ff97713cf336

package/dist/cli-bundle/chunks/{chunk-A6PEXMYN.js → chunk-2VVCGBNV.js}

@@ -5,13 +5,13 @@ import {
 } from "./chunk-J27KIHTG.js";
 import {
   readHistoryEntries
-} from "./chunk-V3JQ4IPL.js";
+} from "./chunk-2RSPZI5H.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
   toReplayDocument
-} from "./chunk-ASQM3IF5.js";
+} from "./chunk-GXSUPCBV.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -19,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-SSFMJCPF.js";
+} from "./chunk-HZGUAH22.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-KBG47ZOY.js";
+} from "./chunk-LB3RUL2N.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   nowIso
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -49,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -375,6 +375,6 @@ async function runRestore(id, target, options, global) {
 export {
   runRestore
 };
-//# sourceMappingURL=chunk-A6PEXMYN.js.map
+//# sourceMappingURL=chunk-2VVCGBNV.js.map
 
 //# debugId=da2f3582-6928-5ecb-a08e-764043714391

package/dist/cli-bundle/chunks/{chunk-UOVLWB47.js → chunk-3BWOVLTH.js}

@@ -14,27 +14,27 @@ import {
   parseLinkedTestMinLines,
   parseLinkedTestRegexList,
   parseLinkedTestStringList
-} from "./chunk-KCMIYKTA.js";
+} from "./chunk-E5FJNAZA.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-O5IBJE6S.js";
+} from "./chunk-PO3GSVFV.js";
 import {
   runInit
-} from "./chunk-ORTLYVA4.js";
+} from "./chunk-AY43SBIN.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   compareTimestampStrings,
   nowIso
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   EXIT_CODE,
   ITEM_FILE_EXTENSIONS,
@@ -47,7 +47,7 @@ import {
   resolveGlobalPmRoot,
   resolvePmRoot,
   stableValueEquals
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/cli/commands/test.js
 import { spawn } from "node:child_process";
@@ -1659,6 +1659,6 @@ export {
   runLinkedTests,
   runTest
 };
-//# sourceMappingURL=chunk-UOVLWB47.js.map
+//# sourceMappingURL=chunk-3BWOVLTH.js.map
 
 //# debugId=fb2ef78d-78c8-5583-8c98-89541410a9ff

package/dist/cli-bundle/chunks/{chunk-5IRA6IYD.js → chunk-3FI4SEFT.js}

@@ -1,13 +1,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-XG7RJYHV.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-4PJQSECJ.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   nowIso
-} from "./chunk-RANZIID5.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   getActiveExtensionRegistrations,
   getSettingsPath,
@@ -21,7 +21,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/core/search/http-client.js
 !(function() {
@@ -1888,4 +1888,4 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-5IRA6IYD.js.map
+//# sourceMappingURL=chunk-3FI4SEFT.js.map

package/dist/cli-bundle/chunks/{chunk-3OH4DAEB.js → chunk-3LB74A67.js}

@@ -3,16 +3,16 @@ import {
   parseItemTypesFile,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-KK6YPGH3.js";
+} from "./chunk-OVQCEJPG.js";
 import {
   runExtension
-} from "./chunk-OIQIXTNB.js";
+} from "./chunk-ECCMVXGM.js";
 import {
   normalizePrefix
-} from "./chunk-KA24HME7.js";
+} from "./chunk-T3LC5LKB.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-4PJQSECJ.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -31,7 +31,7 @@ import {
   runActiveOnWriteHooks,
   writeFileAtomic,
   writeSettings
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/init.js
 import fs2 from "node:fs/promises";
@@ -758,4 +758,4 @@ export {
   summarizeInitResult,
   runInit
 };
-//# sourceMappingURL=chunk-3OH4DAEB.js.map
+//# sourceMappingURL=chunk-3LB74A67.js.map

package/dist/cli-bundle/chunks/{chunk-GFWHHMVV.js → chunk-3VAM3NNM.js}

@@ -2,11 +2,11 @@
 !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]="5290e29c-a147-56df-94c4-59907951e37f")}catch(e){}}();
 import {
   resolveTypeName
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/cli/shared-parsers.js
 function parseLimit(raw, label = "--limit") {
@@ -52,6 +52,6 @@ export {
   parsePriority,
   parseType
 };
-//# sourceMappingURL=chunk-GFWHHMVV.js.map
+//# sourceMappingURL=chunk-3VAM3NNM.js.map
 
 //# debugId=5290e29c-a147-56df-94c4-59907951e37f

package/dist/cli-bundle/chunks/{chunk-4QCR4QW3.js → chunk-4LL6TK5B.js}

@@ -3,13 +3,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SZQCER6S.js";
+} from "./chunk-2VBQ6ZXS.js";
 import {
   nowIso
-} from "./chunk-NQP3ECKF.js";
+} from "./chunk-TCD3R2PF.js";
 import {
   getActiveExtensionRegistrations,
   getSettingsPath,
@@ -23,7 +23,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/search/http-client.js
 var DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 3e4;
@@ -1827,6 +1827,6 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-4QCR4QW3.js.map
+//# sourceMappingURL=chunk-4LL6TK5B.js.map
 
 //# debugId=4b15a57b-7749-5749-88f4-6d73a35071b5

package/dist/cli-bundle/chunks/{chunk-TBQVUNVH.js → chunk-52MAOQ6J.js}

@@ -1,13 +1,13 @@
 import {
   verifyHistoryChain
-} from "./chunk-S3CV7JGJ.js";
+} from "./chunk-UM2GBHS4.js";
 import {
   hashDocument
-} from "./chunk-XG7RJYHV.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   getHistoryPath,
   writeFileAtomic
-} from "./chunk-SRVKTWPR.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/core/history/drift-scan.js
 import fs from "fs/promises";
@@ -419,4 +419,4 @@ export {
   buildRemediationMap,
   buildRemediationCommands
 };
-//# sourceMappingURL=chunk-TBQVUNVH.js.map
+//# sourceMappingURL=chunk-52MAOQ6J.js.map

package/dist/cli-bundle/chunks/{chunk-5KB4X7YY.js → chunk-5FDATVEZ.js}

@@ -2,14 +2,14 @@
 !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]="7064c464-ee52-5164-a51a-6a337b42c837")}catch(e){}}();
 import {
   verifyHistoryChain
-} from "./chunk-ASQM3IF5.js";
+} from "./chunk-GXSUPCBV.js";
 import {
   hashDocument
-} from "./chunk-CWT53EYT.js";
+} from "./chunk-GGYWB3Y2.js";
 import {
   getHistoryPath,
   writeFileAtomic
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-5SFCOO6B.js";
 
 // dist/core/history/drift-scan.js
 import fs from "fs/promises";
@@ -407,6 +407,6 @@ export {
   buildRemediationMap,
   buildRemediationCommands
 };
-//# sourceMappingURL=chunk-5KB4X7YY.js.map
+//# sourceMappingURL=chunk-5FDATVEZ.js.map
 
 //# debugId=7064c464-ee52-5164-a51a-6a337b42c837

package/dist/cli-bundle/chunks/{chunk-4LTBNUYT.js → chunk-5SFCOO6B.js}

@@ -1,6 +1,6 @@
 // dist/core/fs/fs-utils.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]="ba0e58d6-49b8-5381-ad9e-e68ab249dc60")}catch(e){}}();
+!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]="2113715d-ebf3-5135-897f-495b04e82b35")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -4854,6 +4854,7 @@ function normalizeItemTypeDefinition(definition, options = {}) {
 
 // dist/core/store/settings.js
 var SETTINGS_WRITE_OP = "settings:write";
+var SETTINGS_PERSIST_SOURCE_SYMBOL = /* @__PURE__ */ Symbol("pm.settings.persist_source");
 function resolveGovernanceKnobsFromPreset(preset) {
   return structuredClone(GOVERNANCE_PRESET_DEFAULTS[preset]);
 }
@@ -4928,6 +4929,64 @@ function normalizeSearchMutationRefreshPolicy(value) {
   }
   return SETTINGS_DEFAULTS.search.mutation_refresh_policy;
 }
+function buildSettingsPersistSourceSnapshot(parsedSettings, runtimeSettings) {
+  const sourceSchema = parsedSettings.schema;
+  const sourceStatuses = Array.isArray(sourceSchema?.statuses) ? sourceSchema?.statuses : void 0;
+  const sourceFields = Array.isArray(sourceSchema?.fields) ? sourceSchema?.fields : void 0;
+  const sourceTypeWorkflows = Array.isArray(sourceSchema?.type_workflows) ? sourceSchema?.type_workflows : void 0;
+  return {
+    has_source_item_type_definitions: Array.isArray(parsedSettings.item_types?.definitions),
+    source_item_type_definitions: normalizeItemTypeDefinitions(parsedSettings.item_types?.definitions),
+    has_source_schema_statuses: sourceStatuses !== void 0,
+    source_schema_statuses: sourceStatuses ? structuredClone(sourceStatuses) : [],
+    has_source_schema_fields: sourceFields !== void 0,
+    source_schema_fields: sourceFields ? structuredClone(sourceFields) : [],
+    has_source_schema_type_workflows: sourceTypeWorkflows !== void 0,
+    source_schema_type_workflows: sourceTypeWorkflows ? structuredClone(sourceTypeWorkflows) : [],
+    runtime_item_type_definitions: normalizeItemTypeDefinitions(runtimeSettings.item_types?.definitions),
+    runtime_schema_statuses: structuredClone(runtimeSettings.schema.statuses),
+    runtime_schema_fields: structuredClone(runtimeSettings.schema.fields),
+    runtime_schema_type_workflows: structuredClone(runtimeSettings.schema.type_workflows ?? [])
+  };
+}
+function attachSettingsPersistSourceSnapshot(settings, source) {
+  Object.defineProperty(settings, SETTINGS_PERSIST_SOURCE_SYMBOL, {
+    value: source,
+    writable: true,
+    configurable: true,
+    enumerable: false
+  });
+}
+function getSettingsPersistSourceSnapshot(settings) {
+  const candidate = settings[SETTINGS_PERSIST_SOURCE_SYMBOL];
+  if (!candidate || typeof candidate !== "object") {
+    return void 0;
+  }
+  return candidate;
+}
+function resolvePersistedFileBackedSchemaSections(settings, source) {
+  const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
+  const currentItemTypeDefinitions = normalizeItemTypeDefinitions(settings.item_types?.definitions);
+  if (!source) {
+    return {
+      item_type_definitions: currentItemTypeDefinitions,
+      schema_statuses: normalizedSchema.statuses,
+      schema_fields: normalizedSchema.fields,
+      schema_type_workflows: normalizedSchema.type_workflows
+    };
+  }
+  const currentTypeWorkflows = normalizedSchema.type_workflows ?? [];
+  const itemTypeDefinitionsUnchanged = stableValueEquals(currentItemTypeDefinitions, source.runtime_item_type_definitions);
+  const schemaStatusesUnchanged = stableValueEquals(normalizedSchema.statuses, source.runtime_schema_statuses);
+  const schemaFieldsUnchanged = stableValueEquals(normalizedSchema.fields, source.runtime_schema_fields);
+  const schemaTypeWorkflowsUnchanged = stableValueEquals(currentTypeWorkflows, source.runtime_schema_type_workflows);
+  return {
+    item_type_definitions: itemTypeDefinitionsUnchanged ? source.has_source_item_type_definitions ? normalizeItemTypeDefinitions(source.source_item_type_definitions) : [] : currentItemTypeDefinitions,
+    schema_statuses: schemaStatusesUnchanged ? source.has_source_schema_statuses ? structuredClone(source.source_schema_statuses) : [] : normalizedSchema.statuses,
+    schema_fields: schemaFieldsUnchanged ? source.has_source_schema_fields ? structuredClone(source.source_schema_fields) : [] : normalizedSchema.fields,
+    schema_type_workflows: schemaTypeWorkflowsUnchanged ? source.has_source_schema_type_workflows ? structuredClone(source.source_schema_type_workflows) : void 0 : normalizedSchema.type_workflows
+  };
+}
 function buildFallbackSettingsReadResult(warning) {
   return {
     settings: cloneDefaults(),
@@ -5173,8 +5232,10 @@ function mergeSettings(settings) {
     }
   };
 }
-function serializeSettings(settings) {
+function serializeSettings(settings, options = {}) {
   const governance = resolveGovernanceKnobs(settings);
+  const normalizedSchema = normalizeRuntimeSchemaSettings(settings.schema);
+  const persistedFileBackedSections = resolvePersistedFileBackedSchemaSections(settings, options.persist_source);
   const normalizedSettings = {
     ...settings,
     item_format: "toon",
@@ -5191,9 +5252,14 @@ function serializeSettings(settings) {
     governance,
     agent_guidance: normalizeAgentGuidanceSettings(settings.agent_guidance),
     item_types: {
-      definitions: normalizeItemTypeDefinitions(settings.item_types?.definitions)
+      definitions: persistedFileBackedSections.item_type_definitions
+    },
+    schema: {
+      ...normalizedSchema,
+      statuses: persistedFileBackedSections.schema_statuses,
+      fields: persistedFileBackedSections.schema_fields,
+      type_workflows: persistedFileBackedSections.schema_type_workflows
     },
-    schema: normalizeRuntimeSchemaSettings(settings.schema),
     search: {
       ...SETTINGS_DEFAULTS.search,
       ...settings.search,
@@ -5391,6 +5457,7 @@ async function readSettingsWithMetadata(pmRoot) {
       },
       schema: loadedSchemaSections.schema
     };
+    attachSettingsPersistSourceSnapshot(settings, buildSettingsPersistSourceSnapshot(validated.data, settings));
     return {
       settings,
       metadata: {
@@ -5411,7 +5478,9 @@ async function readSettings(pmRoot) {
 }
 async function writeSettings(pmRoot, settings, op = SETTINGS_WRITE_OP) {
   const settingsPath = getSettingsPath(pmRoot);
-  await writeFileAtomic(settingsPath, serializeSettings(settings));
+  await writeFileAtomic(settingsPath, serializeSettings(settings, {
+    persist_source: getSettingsPersistSourceSnapshot(settings)
+  }));
   await runActiveOnWriteHooks({
     path: settingsPath,
     scope: "project",
@@ -5548,6 +5617,6 @@ export {
   readSettings,
   writeSettings
 };
-//# sourceMappingURL=chunk-4LTBNUYT.js.map
+//# sourceMappingURL=chunk-5SFCOO6B.js.map
 
-//# debugId=ba0e58d6-49b8-5381-ad9e-e68ab249dc60
+//# debugId=2113715d-ebf3-5135-897f-495b04e82b35