@unbrained/pm-cli 2026.6.20 → 2026.6.21

package/dist/cli-bundle/chunks/{chunk-ETJKPURB.js → chunk-NB3PYLQ6.js}

@@ -1,13 +1,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -22,7 +22,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/core/search/http-client.js
 !(function() {
@@ -1990,4 +1990,4 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-ETJKPURB.js.map
+//# sourceMappingURL=chunk-NB3PYLQ6.js.map

package/dist/cli-bundle/chunks/{chunk-7MMXBIRZ.js → chunk-NIGXMNNI.js}

@@ -1,6 +1,6 @@
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/core/governance/metadata-coverage.js
 !(function() {
@@ -270,4 +270,4 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-7MMXBIRZ.js.map
+//# sourceMappingURL=chunk-NIGXMNNI.js.map

package/dist/cli-bundle/chunks/{chunk-XKJDCJEH.js → chunk-NIUEXCFS.js}

@@ -3,18 +3,18 @@
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-K2LBDYDC.js";
+} from "./chunk-D7FYS6PG.js";
 import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-FSOJCFDS.js";
+} from "./chunk-LEU5GHRC.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KCJZREBI.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   nowIso
-} from "./chunk-MTQK5ZSB.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -44,7 +44,7 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/extensions/item-fields.js
 var RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);
@@ -1345,6 +1345,6 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-XKJDCJEH.js.map
+//# sourceMappingURL=chunk-NIUEXCFS.js.map
 
 //# debugId=5960bc7c-dc68-5ab2-b5b1-5d4dda400205

package/dist/cli-bundle/chunks/{chunk-RNKUCHUQ.js → chunk-NJHMAJ6N.js}

@@ -13,27 +13,27 @@ import {
   parseLinkedTestMinLines,
   parseLinkedTestRegexList,
   parseLinkedTestStringList
-} from "./chunk-YBQF4CAW.js";
+} from "./chunk-CZPXY7UW.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-4PW4C3ZB.js";
+} from "./chunk-UV6IYE5U.js";
 import {
   runInit
-} from "./chunk-BYNJWB5F.js";
+} from "./chunk-AZMOLBN3.js";
 import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   compareTimestampStrings,
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   ITEM_FILE_EXTENSIONS,
@@ -46,7 +46,7 @@ import {
   resolveGlobalPmRoot,
   resolvePmRoot,
   stableValueEquals
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/test.js
 import { spawn } from "node:child_process";
@@ -1910,4 +1910,4 @@ export {
   runTest,
   _testOnlyTestCommand
 };
-//# sourceMappingURL=chunk-RNKUCHUQ.js.map
+//# sourceMappingURL=chunk-NJHMAJ6N.js.map

package/dist/cli-bundle/chunks/{chunk-AOCYDQLT.js → chunk-NJN7LL7U.js}

@@ -5,13 +5,13 @@ import {
   mutateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   isTerminalStatus
-} from "./chunk-5MWA46UN.js";
+} from "./chunk-QGG32QHW.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -20,7 +20,7 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/close.js
 !(function() {
@@ -393,4 +393,4 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-AOCYDQLT.js.map
+//# sourceMappingURL=chunk-NJN7LL7U.js.map

package/dist/cli-bundle/chunks/{chunk-MTQK5ZSB.js → chunk-NSBZ2CKF.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/shared/time.js
 var RELATIVE_DEADLINE = /^([+-]?)(\d+)([hdwm])$/i;
@@ -204,6 +204,6 @@ export {
   compareTimestampStrings,
   resolveIsoOrRelative
 };
-//# sourceMappingURL=chunk-MTQK5ZSB.js.map
+//# sourceMappingURL=chunk-NSBZ2CKF.js.map
 
 //# debugId=0a3fbfb5-204d-51b0-9891-61518db945ab

package/dist/cli-bundle/chunks/{chunk-26OQTCGH.js → chunk-NXS7ZKAK.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]="7919579f-9834-5809-8c55-f7618807569e")}catch(e){}}();
 import {
   verifyHistoryChain
-} from "./chunk-WMQBNVZL.js";
+} from "./chunk-Z6T4PQI2.js";
 import {
   hashDocument
-} from "./chunk-XKJDCJEH.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   getHistoryPath,
   writeFileAtomic
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/history/drift-scan.js
 import fs from "fs/promises";
@@ -187,6 +187,6 @@ async function scanHistoryDrift(pmRoot, items, options = {}) {
 export {
   scanHistoryDrift
 };
-//# sourceMappingURL=chunk-26OQTCGH.js.map
+//# sourceMappingURL=chunk-NXS7ZKAK.js.map
 
 //# debugId=7919579f-9834-5809-8c55-f7618807569e

package/dist/cli-bundle/chunks/{chunk-6LTSLEHD.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-RICT5QYR.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-6LTSLEHD.js.map
+//# sourceMappingURL=chunk-O47BPOPC.js.map
 
 //# debugId=441a6d77-64b5-5a92-93f7-a5ddfe6d8748

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

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-FBBPCSJM.js";
+} from "./chunk-RVHYI7SL.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
@@ -11,7 +11,7 @@ import {
   replayToCanonicalItemDocument,
   replayToItemDocument,
   toReplayDocument
-} from "./chunk-NKTUBA2C.js";
+} from "./chunk-HIP7WVTL.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -19,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-ZHCSGIUX.js";
+} from "./chunk-7D3SAQXM.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-5MWA46UN.js";
+} from "./chunk-QGG32QHW.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -49,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -391,4 +391,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-6Y7IQ6XN.js.map
+//# sourceMappingURL=chunk-OFYMIDF2.js.map

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

@@ -3,13 +3,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-XKJDCJEH.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KCJZREBI.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   nowIso
-} from "./chunk-MTQK5ZSB.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -24,7 +24,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/search/http-client.js
 var DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 3e4;
@@ -1929,6 +1929,6 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-4YMX7XFI.js.map
+//# sourceMappingURL=chunk-OTHIWLMB.js.map
 
 //# debugId=e4dd61f7-7b30-57b1-b453-e99626f6b69a

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

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-FBBPCSJM.js";
+} from "./chunk-RVHYI7SL.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -11,27 +11,27 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-NKTUBA2C.js";
+} from "./chunk-HIP7WVTL.js";
 import {
   acquireLock,
   createHistoryEntry,
   locateItem,
   readLocatedItem
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-ZHCSGIUX.js";
+} from "./chunk-7D3SAQXM.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-5MWA46UN.js";
+} from "./chunk-QGG32QHW.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -46,7 +46,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-QWAJPGEI.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-QUTJOHGK.js.map
+//# sourceMappingURL=chunk-PFSRUHDH.js.map

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

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

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

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

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

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

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

@@ -1,7 +1,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -17,7 +17,7 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-QWAJPGEI.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-5MWA46UN.js.map
+//# sourceMappingURL=chunk-QGG32QHW.js.map