@unbrained/pm-cli 2026.6.19 → 2026.6.21

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/history/drift-scan.ts"],"sourcesContent":["/**\n * @module core/history/drift-scan\n *\n * Implements append-only history and replay behavior for Drift Scan.\n */\nimport fs from \"fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Documents the drift scan result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 3;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\n/**\n * Controls how cached history stream verification is trusted when the file stat\n * tuple still matches a previous scan.\n */\nexport type DriftCacheHitVerification = \"content_hash\" | \"metadata\";\n\n/**\n * Documents the history drift scan options shared by health, validate, and\n * repair callers.\n */\nexport interface DriftScanOptions {\n  cacheHitVerification?: DriftCacheHitVerification;\n}\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a large history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size plus content hash. Strict callers keep recomputing the\n * content hash on metadata hits; latency-sensitive health checks can opt into\n * trusting the stat tuple and skip rereading unchanged streams.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n  options: DriftScanOptions = {},\n): Promise<DriftScanResult> {\n  const missingStreams: string[] = [];\n  const unreadableStreams: string[] = [];\n  const hashMismatches: string[] = [];\n  const chainMismatches: string[] = [];\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n  // Metadata mode does not open a stat-matched stream, so unreadable-after-stat\n  // failures are intentionally deferred to strict validate/history-repair scans.\n  const verifyCacheHitByContent = options.cacheHitVerification !== \"metadata\";\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        missingStreams.push(item.id);\n      } else {\n        unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const loadStreamVerification = async (): Promise<StreamVerification | null | \"unreadable\"> => {\n      try {\n        return await verifyHistoryStream(historyPath);\n      } catch {\n        return \"unreadable\";\n      }\n    };\n\n    const loadFreshVerification = async (): Promise<StreamVerification | null> => {\n      const loaded = await loadStreamVerification();\n      if (loaded === \"unreadable\") {\n        unreadableStreams.push(item.id);\n        return null;\n      }\n      if (!loaded) {\n        missingStreams.push(item.id);\n        return null;\n      }\n      return loaded;\n    };\n\n    const cached = previousEntries[item.id];\n    let verification: StreamVerification;\n    const metadataMatchesCache =\n      cached !== undefined &&\n      cached.mtime_ms === stat.mtimeMs &&\n      cached.ctime_ms === stat.ctimeMs &&\n      cached.size === stat.size;\n    const cachedContentHash =\n      typeof cached?.content_hash === \"string\" && cached.content_hash.length > 0 ? cached.content_hash : undefined;\n    const canUseCache = metadataMatchesCache && cachedContentHash !== undefined;\n    if (canUseCache && cached) {\n      let currentContentHash: string;\n      if (verifyCacheHitByContent) {\n        try {\n          currentContentHash = await readHistoryContentHash(historyPath);\n        } catch {\n          unreadableStreams.push(item.id);\n          continue;\n        }\n      } else {\n        currentContentHash = cachedContentHash;\n      }\n      if (!verifyCacheHitByContent || currentContentHash === cachedContentHash) {\n        verification = {\n          latestAfterHash: cached.latest_after_hash,\n          chainOk: cached.chain_ok,\n          contentHash: currentContentHash,\n        };\n      } else {\n        cacheDirty = true;\n        const refreshed = await loadFreshVerification();\n        if (!refreshed) {\n          continue;\n        }\n        verification = refreshed;\n      }\n    } else {\n      cacheDirty = true;\n      const refreshed = await loadFreshVerification();\n      if (!refreshed) {\n        continue;\n      }\n      verification = refreshed;\n    }\n\n    if (!verification.chainOk) {\n      chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: verification.contentHash,\n      latest_after_hash: verification.latestAfterHash,\n      chain_ok: verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== verification.latestAfterHash) {\n      hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };\n}\n"],"names":[],"mappings":"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","debugId":"7919579f-9834-5809-8c55-f7618807569e"}

package/dist/cli-bundle/chunks/{chunk-XV6N3QND.js → chunk-O47BPOPC.js}

@@ -2,7 +2,7 @@
 !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]="441a6d77-64b5-5a92-93f7-a5ddfe6d8748")}catch(e){}}();
 import {
   normalizeAddTypeInput
-} from "./chunk-CSRFOIHG.js";
+} from "./chunk-2EIMPCE4.js";
 
 // dist/core/schema/type-presets.js
 var TYPE_PRESET_NAMES = ["agile", "ops", "research"];
@@ -78,6 +78,6 @@ export {
   normalizeTypePresetName,
   resolveTypePresetDefinitions
 };
-//# sourceMappingURL=chunk-XV6N3QND.js.map
+//# sourceMappingURL=chunk-O47BPOPC.js.map
 
 //# debugId=441a6d77-64b5-5a92-93f7-a5ddfe6d8748

package/dist/cli-bundle/chunks/{chunk-X26ODPU4.js → chunk-OFYMIDF2.js}

@@ -3,13 +3,15 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-QTWWHFI3.js";
+} from "./chunk-RVHYI7SL.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
+  replayToCanonicalItemDocument,
+  replayToItemDocument,
   toReplayDocument
-} from "./chunk-2RI3BDFK.js";
+} from "./chunk-HIP7WVTL.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -17,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-X7RKOJXL.js";
+} from "./chunk-SX75ADBK.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-5NS6TJ2F.js";
+} from "./chunk-7D3SAQXM.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-QSH34DSQ.js";
+} from "./chunk-QGG32QHW.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SO2IOH37.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-MTGMNUMJ.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -47,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-5QLHQK7V.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -55,7 +57,7 @@ import fs from "node:fs/promises";
 !(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] = "3553cab0-2c85-52dd-950a-dd48e0b07e11");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2a9ec353-cabe-59ee-a47c-e69ea28f7ab0");
   } catch (e2) {
   }
 })();
@@ -192,10 +194,7 @@ function replayCurrentDocument(history) {
       body: currentReplay.body
     };
   }
-  return canonicalDocument({
-    metadata: currentReplay.metadata,
-    body: currentReplay.body
-  });
+  return canonicalDocument(replayToItemDocument(currentReplay));
 }
 async function resolveRestoreSubject(pmRoot, id, settings, typeToFolder) {
   const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);
@@ -261,10 +260,7 @@ async function runRestore(id, target, options, global2) {
   }
   const resolvedTarget = ensureReplayTarget(target, history);
   const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);
-  const restoredDocument = canonicalDocument({
-    metadata: replayDocument.metadata,
-    body: replayDocument.body
-  }, { schema: settings.schema });
+  const restoredDocument = replayToCanonicalItemDocument(replayDocument, { schema: settings.schema });
   if (restoredDocument.metadata.id !== resolvedId) {
     throw new PmCliError(`Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`, EXIT_CODE.GENERIC_FAILURE);
   }
@@ -395,4 +391,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-X26ODPU4.js.map
+//# sourceMappingURL=chunk-OFYMIDF2.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/restore.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/restore\n *\n * Implements the pm restore command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../../core/history/history.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  normalizeReplayPatchOps,\n  replayHash,\n  replayToCanonicalItemDocument,\n  replayToItemDocument,\n  toReplayDocument,\n  type ReplayDocument as CanonicalReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ResolvedRestoreTarget {\n  kind: \"version\" | \"timestamp\";\n  raw: string;\n  historyIndex: number;\n}\n\ninterface ResolvedRestoreSubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n  historyPolicyWarnings: string[];\n}\n\n/**\n * Documents the restore command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreCommandOptions {\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the restore result payload exchanged by command, SDK, and package integrations.\n */\nexport interface RestoreResult {\n  item: ItemMetadata;\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction ensureReplayTarget(target: string, history: HistoryEntry[]): ResolvedRestoreTarget {\n  const trimmed = target.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"Missing restore target. Use a timestamp or version number.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(trimmed)) {\n    const version = Number(trimmed);\n    if (!Number.isSafeInteger(version) || version < 1 || version > history.length) {\n      throw new PmCliError(\n        `Restore version must be between 1 and ${history.length} for this item.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      kind: \"version\",\n      raw: trimmed,\n      historyIndex: version - 1,\n    };\n  }\n\n  const parsedTarget = Date.parse(trimmed);\n  if (!Number.isFinite(parsedTarget)) {\n    throw new PmCliError(\n      `Invalid restore target \"${target}\". Use a positive version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let index = -1;\n  for (let i = 0; i < history.length; i += 1) {\n    const entryTimestamp = Date.parse(history[i].ts);\n    if (!Number.isFinite(entryTimestamp)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTimestamp <= parsedTarget) {\n      index = i;\n    }\n  }\n\n  if (index < 0) {\n    throw new PmCliError(`No history entries exist at or before timestamp ${trimmed}.`, EXIT_CODE.USAGE);\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw: trimmed,\n    historyIndex: index,\n  };\n}\n\nfunction extractPatchFailureContext(\n  patch: HistoryPatchOp[],\n  error: unknown,\n): { patchIndex?: number; op?: string; path?: string; from?: string; reason?: string } {\n  const context: { patchIndex?: number; op?: string; path?: string; from?: string; reason?: string } = {};\n  if (error instanceof Error && error.message.trim().length > 0) {\n    context.reason = error.message.trim();\n  }\n  if (typeof error !== \"object\" || error === null) {\n    return context;\n  }\n  const candidate = error as {\n    index?: unknown;\n    operation?: unknown;\n  };\n  /* c8 ignore start -- parser-generated patch errors may omit index metadata in current fixtures. */\n  if (typeof candidate.index === \"number\" && Number.isInteger(candidate.index) && candidate.index >= 0) {\n    context.patchIndex = candidate.index;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- operation payload metadata is optional in upstream json-patch failures. */\n  const operationRecord =\n    typeof candidate.operation === \"object\" && candidate.operation !== null\n      ? (candidate.operation as { op?: unknown; path?: unknown; from?: unknown })\n      : null;\n  /* c8 ignore stop */\n  if (operationRecord && typeof operationRecord.op === \"string\") {\n    context.op = operationRecord.op;\n  }\n  if (operationRecord && typeof operationRecord.path === \"string\") {\n    context.path = operationRecord.path;\n  }\n  if (operationRecord && typeof operationRecord.from === \"string\") {\n    context.from = operationRecord.from;\n  }\n  if ((context.op === undefined || context.path === undefined) && context.patchIndex !== undefined) {\n    const fallback = patch[context.patchIndex];\n    /* c8 ignore start -- fallback enrichment paths are only exercised by malformed patch telemetry payloads. */\n    if (fallback) {\n      context.op = context.op ?? fallback.op;\n      context.path = context.path ?? fallback.path;\n      context.from = context.from ?? fallback.from;\n    }\n    /* c8 ignore stop */\n  }\n  return context;\n}\n\nfunction applyHistoryPatch(\n  current: CanonicalReplayDocument,\n  patch: HistoryPatchOp[],\n  entryNumber: number,\n  entryOp: string,\n): CanonicalReplayDocument {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (\n      typeof applied !== \"object\" ||\n      applied === null ||\n      !(\"metadata\" in applied) ||\n      !(\"body\" in applied) ||\n      typeof (applied as { body: unknown }).body !== \"string\" ||\n      typeof (applied as { metadata: unknown }).metadata !== \"object\" ||\n      (applied as { metadata: unknown }).metadata === null\n    ) {\n      throw new PmCliError(\n        `History replay produced an invalid document shape at entry ${entryNumber}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    const replay = applied as { metadata: Record<string, unknown>; body: string };\n    return {\n      metadata: replay.metadata,\n      body: replay.body,\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    const failureContext = extractPatchFailureContext(patch, error);\n    const contextTokens = [\n      `history_op=${entryOp}`,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.patchIndex !== undefined ? `patch_index=${failureContext.patchIndex}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.op ? `op=${failureContext.op}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.path ? `path=${failureContext.path}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.from ? `from=${failureContext.from}` : null,\n    ].filter((token): token is string => token !== null);\n    /* c8 ignore start -- jsonPatch/structuredClone/normalizeReplayPatchOps always throw Error instances with non-empty messages here, so extractPatchFailureContext always sets reason; the empty-suffix fallback is unreachable through applyHistoryPatch. */\n    const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : \"\";\n    /* c8 ignore stop */\n    throw new PmCliError(\n      `Failed to apply history patch at entry ${entryNumber} (${contextTokens.join(\", \")}).${reasonSuffix}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nfunction replayToTarget(history: HistoryEntry[], targetIndex: number): CanonicalReplayDocument {\n  let document: CanonicalReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n\n  for (let i = 0; i <= targetIndex; i += 1) {\n    const entry = history[i];\n    const beforeHash = replayHash(document);\n    if (beforeHash !== entry.before_hash) {\n      throw new PmCliError(\n        `History hash mismatch before replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n\n    document = applyHistoryPatch(document, entry.patch, i + 1, entry.op);\n\n    const afterHash = replayHash(document);\n    if (afterHash !== entry.after_hash) {\n      throw new PmCliError(\n        `History hash mismatch after replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n\n  return document;\n}\n\nfunction ensureMaterializedRestoreTarget(\n  replayDocument: CanonicalReplayDocument,\n  target: ResolvedRestoreTarget,\n): CanonicalReplayDocument {\n  if (Object.keys(replayDocument.metadata).length > 0) {\n    return replayDocument;\n  }\n  throw new PmCliError(\n    `Restore target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction replayCurrentDocument(history: HistoryEntry[]): ItemDocument {\n  const currentReplay = replayToTarget(history, history.length - 1);\n  if (Object.keys(currentReplay.metadata).length === 0) {\n    return {\n      metadata: {} as ItemMetadata,\n      body: currentReplay.body,\n    };\n  }\n  return canonicalDocument(replayToItemDocument(currentReplay));\n}\n\nasync function resolveRestoreSubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<ResolvedRestoreSubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"restore\",\n    });\n    return {\n      id: located.id,\n      historyPath,\n      located,\n      historyPolicyWarnings: historyPolicy.warnings,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  /* c8 ignore stop */\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n        historyPolicyWarnings: [],\n      };\n    }\n  }\n\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\nfunction changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(beforeReplay, afterReplay) as HistoryPatchOp[];\n  const fields = new Set<string>();\n\n  for (const op of patch) {\n    if (op.path === \"/body\" || op.path.startsWith(\"/body/\")) {\n      fields.add(\"body\");\n      continue;\n    }\n    const segment = op.path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    fields.add(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n  }\n\n  return Array.from(fields).sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Implements run restore for the public runtime surface of this module.\n */\nexport async function runRestore(\n  id: string,\n  target: string,\n  options: RestoreCommandOptions,\n  global: GlobalOptions,\n): Promise<RestoreResult> {\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 settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const resolvedId = subject.id;\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const history = await readHistoryEntries(subject.historyPath, resolvedId);\n  if (history.length === 0) {\n    throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);\n  const restoredDocument = replayToCanonicalItemDocument(replayDocument, { schema: settings.schema });\n\n  if (restoredDocument.metadata.id !== resolvedId) {\n    throw new PmCliError(\n      `Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  const loadedItemBeforeLock = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const releaseLock = await acquireLock(\n    pmRoot,\n    resolvedId,\n    settings.locks.ttl_seconds,\n    author,\n    Boolean(options.force),\n    settings.governance.force_required_for_stale_lock,\n  );\n\n  try {\n    const historyRawUnderLock = await readFileIfExists(subject.historyPath);\n    if (historyRawUnderLock !== historyRawBeforeLock) {\n      throw new PmCliError(\n        `History for ${resolvedId} changed while waiting for lock; retry restore.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    const locatedUnderLock = await locateItem(\n      pmRoot,\n      resolvedId,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    const loadedItemUnderLock = locatedUnderLock ? await readLocatedItem(locatedUnderLock, { schema: settings.schema }) : null;\n    if ((loadedItemUnderLock?.raw ?? null) !== currentItemRawBeforeLock) {\n      throw new PmCliError(`Item ${resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n    }\n\n    const existingItemPath = locatedUnderLock?.itemPath ?? null;\n    const itemFormat = \"toon\";\n    let resolvedCurrentDocument: ItemDocument;\n    let resolvedOriginalRaw: string | null = null;\n    if (loadedItemUnderLock) {\n      resolvedCurrentDocument = loadedItemUnderLock.document;\n      resolvedOriginalRaw = loadedItemUnderLock.raw;\n    } else {\n      resolvedCurrentDocument = replayCurrentDocument(history);\n    }\n    const assigned = resolvedCurrentDocument.metadata.assignee?.trim();\n    const ownershipWarnings: string[] = [];\n    const hasOwnershipConflict = assigned && assigned !== author && !options.force;\n    if (hasOwnershipConflict) {\n      if (settings.governance.ownership_enforcement === \"strict\") {\n        throw new PmCliError(\n          `Item ${resolvedId} is assigned to ${assigned}. Use --force to override.`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      if (settings.governance.ownership_enforcement === \"warn\") {\n        ownershipWarnings.push(`ownership_warning:assignee_conflict:${resolvedId}:${assigned}`);\n      }\n    }\n\n    const serializedRestore = serializeItemDocument(restoredDocument, { format: itemFormat, schema: settings.schema });\n    /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */\n    const restoredItemPath = getItemPath(\n      pmRoot,\n      restoredDocument.metadata.type,\n      resolvedId,\n      itemFormat,\n      typeRegistry.type_to_folder,\n    );\n    await writeFileAtomic(restoredItemPath, serializedRestore);\n    if (existingItemPath && restoredItemPath !== existingItemPath) {\n      await fs.rm(existingItemPath);\n    }\n\n    const historyEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"restore\",\n      before: resolvedCurrentDocument,\n      after: restoredDocument,\n      message: options.message,\n    });\n\n    try {\n      await appendHistoryEntry(subject.historyPath, historyEntry);\n    } catch (error: unknown) {\n      if (existingItemPath && resolvedOriginalRaw !== null && restoredItemPath !== existingItemPath) {\n        await writeFileAtomic(existingItemPath, resolvedOriginalRaw);\n        await fs.rm(restoredItemPath, { force: true });\n      } else if (existingItemPath && resolvedOriginalRaw !== null) {\n        await writeFileAtomic(existingItemPath, resolvedOriginalRaw);\n      } else {\n        await fs.rm(restoredItemPath, { force: true });\n      }\n      throw error;\n    }\n    const restoreChangedFields = changedFields(resolvedCurrentDocument, restoredDocument);\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: restoredItemPath,\n        scope: \"project\",\n        op: \"restore\",\n        item_id: restoredDocument.metadata.id,\n        item_type: restoredDocument.metadata.type,\n        before: resolvedCurrentDocument,\n        after: restoredDocument,\n        changed_fields: [\"restored\"],\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: subject.historyPath,\n        scope: \"project\",\n        op: \"restore:history\",\n        item_id: restoredDocument.metadata.id,\n        item_type: restoredDocument.metadata.type,\n        before: resolvedCurrentDocument,\n        after: restoredDocument,\n        changed_fields: [\"restored\"],\n      })),\n    ];\n    recordAfterCommandAffectedItem({\n      id: restoredDocument.metadata.id,\n      op: \"restore\",\n      item_type: restoredDocument.metadata.type,\n      previous_status: resolvedCurrentDocument.metadata.status,\n      status: restoredDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(resolvedCurrentDocument.metadata, restoreChangedFields),\n      current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),\n      changed_fields: restoreChangedFields,\n    });\n\n    const targetEntry = history[resolvedTarget.historyIndex];\n    return {\n      item: restoredDocument.metadata,\n      restored_from: {\n        kind: resolvedTarget.kind,\n        target: resolvedTarget.raw,\n        history_index: resolvedTarget.historyIndex + 1,\n        entry_ts: targetEntry.ts,\n        entry_op: targetEntry.op,\n      },\n      changed_fields: restoreChangedFields,\n      warnings: [...subject.historyPolicyWarnings, ...ownershipWarnings, ...hookWarnings],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-QCHNPN24.js → chunk-OTHIWLMB.js}

@@ -3,13 +3,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-GL3QKIET.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-BQVESTOG.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   nowIso
-} from "./chunk-5P2LQV2F.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -24,7 +24,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-I2VJM36R.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/search/http-client.js
 var DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 3e4;
@@ -1914,9 +1914,11 @@ export {
   resolveProviderConfigSource,
   resolveEmbeddingProviders,
   executeEmbeddingRequest,
+  resolveSearchCorpusFields,
   buildReminderCorpus,
   buildEventCorpus,
   buildPlanFlatCorpus,
+  buildSearchCorpus,
   resolveSettingsWithSemanticRuntimeDefaults,
   shouldRunSearchRefreshInForeground,
   resolveVectorStores,
@@ -1927,6 +1929,6 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-QCHNPN24.js.map
+//# sourceMappingURL=chunk-OTHIWLMB.js.map
 
 //# debugId=e4dd61f7-7b30-57b1-b453-e99626f6b69a

package/dist/cli-bundle/chunks/{chunk-YVYJQR6S.js → chunk-PFSRUHDH.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-QTWWHFI3.js";
+} from "./chunk-RVHYI7SL.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -11,27 +11,27 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-2RI3BDFK.js";
+} from "./chunk-HIP7WVTL.js";
 import {
   acquireLock,
   createHistoryEntry,
   locateItem,
   readLocatedItem
-} from "./chunk-X7RKOJXL.js";
+} from "./chunk-SX75ADBK.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-5NS6TJ2F.js";
+} from "./chunk-7D3SAQXM.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-QSH34DSQ.js";
+} from "./chunk-QGG32QHW.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-SO2IOH37.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-MTGMNUMJ.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -46,7 +46,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-5QLHQK7V.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/history-redact.js
 import fs from "node:fs/promises";
@@ -591,4 +591,4 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-YVYJQR6S.js.map
+//# sourceMappingURL=chunk-PFSRUHDH.js.map

package/dist/cli-bundle/chunks/{chunk-M35R7LFX.js → chunk-PP2U4NMT.js}

@@ -7,13 +7,13 @@ import {
   mutateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-GL3QKIET.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   isTerminalStatus
-} from "./chunk-EMFDZ7N3.js";
+} from "./chunk-LEU5GHRC.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-BQVESTOG.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -22,7 +22,7 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-I2VJM36R.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/close.js
 function toAuthor(candidate, defaultAuthor) {
@@ -388,6 +388,6 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-M35R7LFX.js.map
+//# sourceMappingURL=chunk-PP2U4NMT.js.map
 
 //# debugId=847742a0-59c5-54d8-a607-7ee2d435b0a6

package/dist/cli-bundle/chunks/{chunk-ZGEWEO7B.js → chunk-PUH4D67U.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-I2VJM36R.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/item/parent-reference-policy.js
 function normalizeParentReferencePolicy(value) {
@@ -75,6 +75,6 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-ZGEWEO7B.js.map
+//# sourceMappingURL=chunk-PUH4D67U.js.map
 
 //# debugId=988af926-d0be-5a81-992f-a0200bb8aebe

package/dist/cli-bundle/chunks/{chunk-LEC57E7K.js → chunk-Q2J2HJUN.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-I2VJM36R.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/item/parse.js
 var STDIN_TOKEN = "-";
@@ -351,6 +351,6 @@ export {
   createStdinTokenResolver,
   parseOptionalNumber
 };
-//# sourceMappingURL=chunk-LEC57E7K.js.map
+//# sourceMappingURL=chunk-Q2J2HJUN.js.map
 
 //# debugId=41b3db5d-9c78-5ab6-9868-2b31d0e5eac2

package/dist/cli-bundle/chunks/{chunk-QSH34DSQ.js → chunk-QGG32QHW.js}

@@ -1,7 +1,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-MTGMNUMJ.js";
+} from "./chunk-YCJX76PW.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -17,7 +17,7 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-5QLHQK7V.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/core/schema/runtime-field-values.js
 !(function() {
@@ -173,6 +173,55 @@ function collectRuntimeUpdateFieldValues(options, fieldRegistry, commands = ["up
   return values;
 }
 
+// dist/core/item/item-format-version.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] = "f0e67d63-2f7b-5f4a-b441-7a499c82e0a8");
+  } catch (e2) {
+  }
+})();
+var BASELINE_ITEM_FORMAT_VERSION = 1;
+var CURRENT_ITEM_FORMAT_VERSION = 1;
+function effectiveItemFormatVersion(metadata) {
+  const raw = metadata.pm_format_version;
+  if (typeof raw === "number" && Number.isInteger(raw) && raw >= BASELINE_ITEM_FORMAT_VERSION) {
+    return raw;
+  }
+  return BASELINE_ITEM_FORMAT_VERSION;
+}
+function normalizeItemFormatVersion(value) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value <= BASELINE_ITEM_FORMAT_VERSION) {
+    return void 0;
+  }
+  return value;
+}
+function classifyItemFormatVersion(version, current = CURRENT_ITEM_FORMAT_VERSION) {
+  if (version < current) {
+    return "outdated";
+  }
+  if (version > current) {
+    return "ahead";
+  }
+  return "current";
+}
+function scanItemFormatVersions(entries, current = CURRENT_ITEM_FORMAT_VERSION) {
+  const outdated = [];
+  const ahead = [];
+  for (const entry of entries) {
+    const status = classifyItemFormatVersion(entry.version, current);
+    if (status === "outdated") {
+      outdated.push(entry.ref);
+    } else if (status === "ahead") {
+      ahead.push(entry.ref);
+    }
+  }
+  return {
+    outdated: outdated.sort((left, right) => left.localeCompare(right)),
+    ahead: ahead.sort((left, right) => left.localeCompare(right))
+  };
+}
+
 // dist/core/item/status.js
 !(function() {
   try {
@@ -290,7 +339,7 @@ function decodeToonItemContent(content) {
 !(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] = "c295802c-f55f-56e8-afdc-257cdef6a4cb");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "777ea2a9-5aa6-5a90-abb5-a0b6052645f2");
   } catch (e2) {
   }
 })();
@@ -405,6 +454,10 @@ function assertValidFrontMatter(frontMatter, runtimeContext) {
   }
   const itemType = record.type;
   assertFrontMatterCondition(typeof itemType === "string" && itemType.trim().length > 0, "type must be a non-empty string");
+  const formatVersion = record.pm_format_version;
+  if (formatVersion !== void 0) {
+    assertFrontMatterCondition(typeof formatVersion === "number" && Number.isInteger(formatVersion) && formatVersion >= BASELINE_ITEM_FORMAT_VERSION, `pm_format_version must be an integer >= ${BASELINE_ITEM_FORMAT_VERSION}`);
+  }
   const status = record.status;
   assertFrontMatterCondition(typeof status === "string" && status.trim().length > 0, "status must be a non-empty string");
   const statusRegistry = runtimeContext?.statusRegistry;
@@ -1052,6 +1105,7 @@ function normalizeFrontMatter(frontMatter, options = {}) {
     title: frontMatter.title,
     description: frontMatter.description,
     type: frontMatter.type,
+    pm_format_version: normalizeItemFormatVersion(frontMatter.pm_format_version),
     source_type: frontMatter.source_type?.trim() || void 0,
     type_options: normalizeTypeOptions(frontMatter.type_options),
     status: normalizedStatus,
@@ -1322,6 +1376,9 @@ export {
   coerceRuntimeFieldValue,
   collectRuntimeCreateFieldValues,
   collectRuntimeUpdateFieldValues,
+  CURRENT_ITEM_FORMAT_VERSION,
+  effectiveItemFormatVersion,
+  scanItemFormatVersions,
   normalizeStatusInput,
   normalizeStatusForRegistry,
   isTerminalStatus,
@@ -1331,4 +1388,4 @@ export {
   serializeItemDocument,
   canonicalDocument
 };
-//# sourceMappingURL=chunk-QSH34DSQ.js.map
+//# sourceMappingURL=chunk-QGG32QHW.js.map