@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-EI3UIMZM.js → chunk-OWXOPDHD.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]="2ed793a0-44a3-5827-bf30-97e1b5c2896b")}catch(e){}}();
 import {
   collectBlockedByIds
-} from "./chunk-6BNV3G6C.js";
+} from "./chunk-NLR32VFS.js";
 import {
   buildItemNotFoundError,
   isTerminalStatus,
@@ -12,7 +12,7 @@ import {
   readLocatedItem,
   readSettings,
   toItemRecord
-} from "./chunk-QFG4MB7P.js";
+} from "./chunk-POG76WWZ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -21,7 +21,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/cli/commands/close.js
 function toAuthor(candidate, defaultAuthor) {
@@ -458,6 +458,6 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-EI3UIMZM.js.map
+//# sourceMappingURL=chunk-OWXOPDHD.js.map
 
 //# debugId=2ed793a0-44a3-5827-bf30-97e1b5c2896b

package/dist/cli-bundle/chunks/chunk-P7JTWYLH.js

@@ -0,0 +1,246 @@
+
+!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]="d77401e4-b01b-5a23-b696-886d2009861c")}catch(e){}}();
+import {
+  canonicalDocument,
+  hashDocument,
+  orderObject,
+  sha256Hex,
+  stableStringify,
+  toItemRecord
+} from "./chunk-POG76WWZ.js";
+import {
+  ITEM_METADATA_KEY_ORDER
+} from "./chunk-HYW67VJ5.js";
+
+// dist/core/history/replay.js
+import jsonPatch from "fast-json-patch";
+var EMPTY_REPLAY_DOCUMENT = {
+  metadata: {},
+  body: ""
+};
+function cloneEmptyReplayDocument() {
+  return structuredClone(EMPTY_REPLAY_DOCUMENT);
+}
+function replayHash(document) {
+  try {
+    return hashDocument(replayToItemDocument(document));
+  } catch {
+    return sha256Hex(stableStringify({
+      replay_fallback: true,
+      metadata: document.metadata,
+      body: document.body
+    }));
+  }
+}
+function replayToItemDocument(document) {
+  return {
+    metadata: document.metadata,
+    body: document.body
+  };
+}
+function replayToCanonicalItemDocument(document, options = {}) {
+  return canonicalDocument(replayToItemDocument(document), options);
+}
+function toReplayDocument(document) {
+  if (!document.metadata || Object.keys(document.metadata).length === 0) {
+    return {
+      metadata: {},
+      body: document.body ?? ""
+    };
+  }
+  const canonical = canonicalDocument(document);
+  return {
+    metadata: orderObject(toItemRecord(canonical.metadata), ITEM_METADATA_KEY_ORDER),
+    body: canonical.body
+  };
+}
+function normalizeReplayPatchPath(path) {
+  if (path === "/front_matter") {
+    return "/metadata";
+  }
+  if (path.startsWith("/front_matter/")) {
+    return `/metadata/${path.slice("/front_matter/".length)}`;
+  }
+  return path;
+}
+function isHistoryPatchOp(value) {
+  return typeof value === "object" && value !== null && typeof value.op === "string" && typeof value.path === "string";
+}
+function normalizeReplayPatchOps(patch) {
+  if (!Array.isArray(patch)) {
+    return [];
+  }
+  return patch.filter(isHistoryPatchOp).map((operation) => ({
+    ...operation,
+    path: normalizeReplayPatchPath(operation.path),
+    from: typeof operation.from === "string" ? normalizeReplayPatchPath(operation.from) : void 0
+  }));
+}
+function isReplayDocumentShape(value) {
+  return typeof value === "object" && value !== null && "metadata" in value && "body" in value && typeof value.body === "string" && typeof value.metadata === "object" && value.metadata !== null;
+}
+function tryApplyReplayPatch(current, patch) {
+  try {
+    const normalizedPatch = normalizeReplayPatchOps(patch);
+    const applied = jsonPatch.applyPatch(structuredClone(current), normalizedPatch, true, false).newDocument;
+    if (!isReplayDocumentShape(applied)) {
+      return {
+        ok: false,
+        error: new Error("history_replay_invalid_document_shape")
+      };
+    }
+    return {
+      ok: true,
+      document: { metadata: applied.metadata, body: applied.body }
+    };
+  } catch (error) {
+    return { ok: false, error };
+  }
+}
+function verifyHistoryChain(entries) {
+  let replay = cloneEmptyReplayDocument();
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    if (replayHash(replay) !== entry.before_hash) {
+      return {
+        ok: false,
+        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`]
+      };
+    }
+    const applied = tryApplyReplayPatch(replay, entry.patch);
+    if (!applied.ok) {
+      return {
+        ok: false,
+        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`]
+      };
+    }
+    replay = applied.document;
+    if (replayHash(replay) !== entry.after_hash) {
+      return {
+        ok: false,
+        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`]
+      };
+    }
+  }
+  return { ok: true, errors: [] };
+}
+function tryApplySingleOp(document, op) {
+  try {
+    const applied = jsonPatch.applyPatch(structuredClone(document), [op], true, false).newDocument;
+    return { ok: true, document: applied };
+  } catch {
+    return { ok: false };
+  }
+}
+function lenientApplyReplayPatch(current, patch) {
+  let working = structuredClone(current);
+  let convertedReplaceToAdd = 0;
+  let skippedOps = 0;
+  for (const op of normalizeReplayPatchOps(patch)) {
+    const direct = tryApplySingleOp(working, op);
+    if (direct.ok) {
+      working = direct.document;
+      continue;
+    }
+    if (op.op === "replace") {
+      const asAdd = tryApplySingleOp(working, { ...op, op: "add" });
+      if (asAdd.ok) {
+        working = asAdd.document;
+        convertedReplaceToAdd += 1;
+        continue;
+      }
+    }
+    skippedOps += 1;
+  }
+  const candidate = working;
+  const document = {
+    metadata: typeof candidate.metadata === "object" && candidate.metadata !== null ? candidate.metadata : {},
+    body: typeof candidate.body === "string" ? candidate.body : current.body
+  };
+  return { document, convertedReplaceToAdd, skippedOps };
+}
+function reanchorHistoryEntries(entries) {
+  let replay = cloneEmptyReplayDocument();
+  const rewritten = [];
+  const details = [];
+  let entriesRehashed = 0;
+  let entriesPatchRepaired = 0;
+  let convertedReplaceToAdd = 0;
+  let skippedOps = 0;
+  for (let index = 0; index < entries.length; index += 1) {
+    const entry = entries[index];
+    const beforeHash = replayHash(replay);
+    const strict = tryApplyReplayPatch(replay, entry.patch);
+    let next;
+    let outPatch;
+    let patchRepaired = false;
+    let entryConverted = 0;
+    let entrySkipped = 0;
+    if (strict.ok) {
+      next = strict.document;
+      outPatch = entry.patch;
+    } else {
+      const lenient = lenientApplyReplayPatch(replay, entry.patch);
+      next = lenient.document;
+      outPatch = jsonPatch.compare(replay, next);
+      patchRepaired = true;
+      entryConverted = lenient.convertedReplaceToAdd;
+      entrySkipped = lenient.skippedOps;
+      convertedReplaceToAdd += entryConverted;
+      skippedOps += entrySkipped;
+      entriesPatchRepaired += 1;
+    }
+    const afterHash = replayHash(next);
+    const rehashed = beforeHash !== entry.before_hash || afterHash !== entry.after_hash;
+    if (rehashed) {
+      entriesRehashed += 1;
+    }
+    rewritten.push({
+      ...entry,
+      patch: outPatch,
+      before_hash: beforeHash,
+      after_hash: afterHash
+    });
+    details.push({
+      index: index + 1,
+      rehashed,
+      patch_repaired: patchRepaired,
+      converted_replace_to_add: entryConverted,
+      skipped_ops: entrySkipped
+    });
+    replay = next;
+  }
+  return {
+    entries: rewritten,
+    finalDocument: replay,
+    entriesRehashed,
+    entriesPatchRepaired,
+    convertedReplaceToAdd,
+    skippedOps,
+    details
+  };
+}
+function historyEntriesToRaw(entries) {
+  if (entries.length === 0) {
+    return "";
+  }
+  return `${entries.map((entry) => JSON.stringify(entry)).join("\n")}
+`;
+}
+
+export {
+  EMPTY_REPLAY_DOCUMENT,
+  cloneEmptyReplayDocument,
+  replayHash,
+  replayToItemDocument,
+  replayToCanonicalItemDocument,
+  toReplayDocument,
+  normalizeReplayPatchOps,
+  tryApplyReplayPatch,
+  verifyHistoryChain,
+  reanchorHistoryEntries,
+  historyEntriesToRaw
+};
+//# sourceMappingURL=chunk-P7JTWYLH.js.map
+
+//# debugId=d77401e4-b01b-5a23-b696-886d2009861c

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/history/replay.ts"],"sourcesContent":["/**\n * @module core/history/replay\n *\n * Implements append-only history and replay behavior for Replay.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport { ITEM_METADATA_KEY_ORDER } from \"../shared/constants.js\";\nimport { canonicalDocument } from \"../item/item-format.js\";\nimport { toItemRecord } from \"../item/item-record.js\";\nimport {\n  orderObject,\n  sha256Hex,\n  stableStringify,\n} from \"../shared/serialization.js\";\nimport { hashDocument } from \"./history.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemDocument,\n  ItemMetadata,\n} from \"../../types/index.js\";\n\n/**\n * Shared history replay/patch mechanics single-sourced for the history, restore,\n * history-redact, and history-repair commands plus the health/validate drift checks.\n *\n * Each command keeps its own thin error-formatting wrapper so the exact CLI error\n * contracts (restore's rich patch-failure context, redact's op tag, history's\n * generic message) are preserved; only the underlying replay/patch logic is shared.\n */\n\nexport interface ReplayDocument {\n  /** Value that configures or reports metadata for this contract. */\n  metadata: Record<string, unknown>;\n  /** Value that configures or reports body for this contract. */\n  body: string;\n}\n\n/** Public contract for empty replay document, shared by SDK and presentation-layer consumers. */\nexport const EMPTY_REPLAY_DOCUMENT: ReplayDocument = {\n  metadata: {},\n  body: \"\",\n};\n\n/** Implements clone empty replay document for the public runtime surface of this module. */\nexport function cloneEmptyReplayDocument(): ReplayDocument {\n  return structuredClone(EMPTY_REPLAY_DOCUMENT);\n}\n\n/** Implements replay hash for the public runtime surface of this module. */\nexport function replayHash(document: ReplayDocument): string {\n  try {\n    return hashDocument(replayToItemDocument(document));\n  } catch {\n    // Legacy/malformed replay states (for example a stream whose first entry never\n    // established a full `create` document, so the canonicalizer cannot normalize it)\n    // cannot be canonically hashed. Fall back to a deterministic structural hash so\n    // re-anchor and verification stay internally consistent for these streams. Fully\n    // formed documents always take the canonical path above, so valid streams are\n    // unaffected.\n    return sha256Hex(\n      stableStringify({\n        replay_fallback: true,\n        metadata: document.metadata,\n        body: document.body,\n      }),\n    );\n  }\n}\n\n/** Implements replay to item document for the public runtime surface of this module. */\nexport function replayToItemDocument(document: ReplayDocument): ItemDocument {\n  return {\n    metadata: document.metadata as ItemMetadata,\n    body: document.body,\n  };\n}\n\n/** Converts a materialized replay document into a canonical item document. Use this when callers have already rejected the empty/deleted replay state and need restored metadata validated through the normal item-metadata rules. */\nexport function replayToCanonicalItemDocument(\n  document: ReplayDocument,\n  options: Parameters<typeof canonicalDocument>[1] = {},\n): ItemDocument {\n  return canonicalDocument(replayToItemDocument(document), options);\n}\n\n/** Canonicalize an item document into the ordered replay form used when comparing a replayed chain against the on-disk item (restore + history-repair reconciliation). */\nexport function toReplayDocument(document: ItemDocument): ReplayDocument {\n  if (!document.metadata || Object.keys(document.metadata).length === 0) {\n    return {\n      metadata: {},\n      body: document.body ?? \"\",\n    };\n  }\n  const canonical = canonicalDocument(document);\n  return {\n    metadata: orderObject(\n      toItemRecord(canonical.metadata),\n      ITEM_METADATA_KEY_ORDER,\n    ),\n    body: canonical.body,\n  };\n}\n\n/** Implements normalize replay patch path for the public runtime surface of this module. */\nexport function normalizeReplayPatchPath(path: string): string {\n  if (path === \"/front_matter\") {\n    return \"/metadata\";\n  }\n  if (path.startsWith(\"/front_matter/\")) {\n    return `/metadata/${path.slice(\"/front_matter/\".length)}`;\n  }\n  return path;\n}\n\nfunction isHistoryPatchOp(value: unknown): value is HistoryPatchOp {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { op?: unknown }).op === \"string\" &&\n    typeof (value as { path?: unknown }).path === \"string\"\n  );\n}\n\n/** Implements normalize replay patch ops for the public runtime surface of this module. */\nexport function normalizeReplayPatchOps(\n  patch: HistoryPatchOp[] | unknown,\n): HistoryPatchOp[] {\n  if (!Array.isArray(patch)) {\n    return [];\n  }\n  return patch.filter(isHistoryPatchOp).map((operation) => ({\n    ...operation,\n    path: normalizeReplayPatchPath(operation.path),\n    from:\n      typeof operation.from === \"string\"\n        ? normalizeReplayPatchPath(operation.from)\n        : undefined,\n  }));\n}\n\nfunction isReplayDocumentShape(\n  value: unknown,\n): value is { metadata: Record<string, unknown>; body: string } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"metadata\" in value &&\n    \"body\" in value &&\n    typeof (value as { body: unknown }).body === \"string\" &&\n    typeof (value as { metadata: unknown }).metadata === \"object\" &&\n    (value as { metadata: unknown }).metadata !== null\n  );\n}\n\n/** Restricts replay apply result values accepted by command, SDK, and storage contracts. */\nexport type ReplayApplyResult =\n  | { ok: true; document: ReplayDocument }\n  | { ok: false; error: unknown };\n\n/** Strictly apply a history patch (front_matter->metadata normalized) to a replay document. Returns a result envelope rather than throwing so each caller can format its own error contract. */\nexport function tryApplyReplayPatch(\n  current: ReplayDocument,\n  patch: HistoryPatchOp[],\n): ReplayApplyResult {\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 (!isReplayDocumentShape(applied)) {\n      return {\n        ok: false,\n        error: new Error(\"history_replay_invalid_document_shape\"),\n      };\n    }\n    return {\n      ok: true,\n      document: { metadata: applied.metadata, body: applied.body },\n    };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/** Deterministically verify a history chain: each entry's before_hash must equal the prior replayed after_hash, the patch must strictly apply, and the recorded after_hash must equal the replayed result. */\nexport function verifyHistoryChain(entries: HistoryEntry[]): {\n  ok: boolean;\n  errors: string[];\n} {\n  let replay = cloneEmptyReplayDocument();\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:before_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n    const applied = tryApplyReplayPatch(replay, entry.patch);\n    if (!applied.ok) {\n      return {\n        ok: false,\n        errors: [`verify_failed:patch_apply_failed:entry_${index + 1}`],\n      };\n    }\n    replay = applied.document;\n    if (replayHash(replay) !== entry.after_hash) {\n      return {\n        ok: false,\n        errors: [`verify_failed:after_hash_mismatch:entry_${index + 1}`],\n      };\n    }\n  }\n  return { ok: true, errors: [] };\n}\n\n/** Documents the lenient apply result payload exchanged by command, SDK, and package integrations. */\nexport interface LenientApplyResult {\n  /** Value that configures or reports document for this contract. */\n  document: ReplayDocument;\n  /** Value that configures or reports converted replace to add for this contract. */\n  convertedReplaceToAdd: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skippedOps: number;\n}\n\nfunction tryApplySingleOp(\n  document: unknown,\n  op: HistoryPatchOp,\n): { ok: true; document: unknown } | { ok: false } {\n  try {\n    const applied = jsonPatch.applyPatch(\n      structuredClone(document),\n      [op as jsonPatch.Operation],\n      true,\n      false,\n    ).newDocument as unknown;\n    return { ok: true, document: applied };\n  } catch {\n    return { ok: false };\n  }\n}\n\n/** Apply a legacy patch op-by-op, recovering from drift that strict replay rejects: a `replace` whose path no longer exists is retried as `add`, and any op that still cannot apply against the current replay state is skipped. The resulting document is what the repaired entry's recomputed patch should target. */\nexport function lenientApplyReplayPatch(\n  current: ReplayDocument,\n  patch: HistoryPatchOp[],\n): LenientApplyResult {\n  let working: unknown = structuredClone(current);\n  let convertedReplaceToAdd = 0;\n  let skippedOps = 0;\n\n  for (const op of normalizeReplayPatchOps(patch)) {\n    const direct = tryApplySingleOp(working, op);\n    if (direct.ok) {\n      working = direct.document;\n      continue;\n    }\n    if (op.op === \"replace\") {\n      const asAdd = tryApplySingleOp(working, { ...op, op: \"add\" });\n      if (asAdd.ok) {\n        working = asAdd.document;\n        convertedReplaceToAdd += 1;\n        continue;\n      }\n    }\n    skippedOps += 1;\n  }\n\n  const candidate = working as { metadata?: unknown; body?: unknown };\n  const document: ReplayDocument = {\n    metadata:\n      typeof candidate.metadata === \"object\" && candidate.metadata !== null\n        ? (candidate.metadata as Record<string, unknown>)\n        : {},\n    body: typeof candidate.body === \"string\" ? candidate.body : current.body,\n  };\n  return { document, convertedReplaceToAdd, skippedOps };\n}\n\n/** Documents the reanchor entry detail payload exchanged by command, SDK, and package integrations. */\nexport interface ReanchorEntryDetail {\n  /** Value that configures or reports index for this contract. */\n  index: number;\n  /** Value that configures or reports rehashed for this contract. */\n  rehashed: boolean;\n  /** Value that configures or reports patch repaired for this contract. */\n  patch_repaired: boolean;\n  /** Value that configures or reports converted replace to add for this contract. */\n  converted_replace_to_add: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skipped_ops: number;\n}\n\n/** Documents the reanchor result payload exchanged by command, SDK, and package integrations. */\nexport interface ReanchorResult {\n  /** Value that configures or reports entries for this contract. */\n  entries: HistoryEntry[];\n  /** Value that configures or reports final document for this contract. */\n  finalDocument: ReplayDocument;\n  /** Value that configures or reports entries rehashed for this contract. */\n  entriesRehashed: number;\n  /** Value that configures or reports entries patch repaired for this contract. */\n  entriesPatchRepaired: number;\n  /** Value that configures or reports converted replace to add for this contract. */\n  convertedReplaceToAdd: number;\n  /** Value that configures or reports skipped ops for this contract. */\n  skippedOps: number;\n  /** Value that configures or reports details for this contract. */\n  details: ReanchorEntryDetail[];\n}\n\n/** Re-anchor a drifted history chain: replay every entry from empty, recompute the before/after hashes, and only rewrite a patch when the original op set no longer strictly applies (legacy drift). Clean entries keep their patch verbatim so the on-disk diff stays minimal. The returned chain verifies via verifyHistoryChain. */\nexport function reanchorHistoryEntries(\n  entries: HistoryEntry[],\n): ReanchorResult {\n  let replay = cloneEmptyReplayDocument();\n  const rewritten: HistoryEntry[] = [];\n  const details: ReanchorEntryDetail[] = [];\n  let entriesRehashed = 0;\n  let entriesPatchRepaired = 0;\n  let convertedReplaceToAdd = 0;\n  let skippedOps = 0;\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    const beforeHash = replayHash(replay);\n    const strict = tryApplyReplayPatch(replay, entry.patch);\n\n    let next: ReplayDocument;\n    let outPatch: HistoryPatchOp[];\n    let patchRepaired = false;\n    let entryConverted = 0;\n    let entrySkipped = 0;\n\n    if (strict.ok) {\n      next = strict.document;\n      outPatch = entry.patch;\n    } else {\n      const lenient = lenientApplyReplayPatch(replay, entry.patch);\n      next = lenient.document;\n      outPatch = jsonPatch.compare(replay, next) as HistoryPatchOp[];\n      patchRepaired = true;\n      entryConverted = lenient.convertedReplaceToAdd;\n      entrySkipped = lenient.skippedOps;\n      convertedReplaceToAdd += entryConverted;\n      skippedOps += entrySkipped;\n      entriesPatchRepaired += 1;\n    }\n\n    const afterHash = replayHash(next);\n    const rehashed =\n      beforeHash !== entry.before_hash || afterHash !== entry.after_hash;\n    if (rehashed) {\n      entriesRehashed += 1;\n    }\n\n    rewritten.push({\n      ...entry,\n      patch: outPatch,\n      before_hash: beforeHash,\n      after_hash: afterHash,\n    });\n    details.push({\n      index: index + 1,\n      rehashed,\n      patch_repaired: patchRepaired,\n      converted_replace_to_add: entryConverted,\n      skipped_ops: entrySkipped,\n    });\n    replay = next;\n  }\n\n  return {\n    entries: rewritten,\n    finalDocument: replay,\n    entriesRehashed,\n    entriesPatchRepaired,\n    convertedReplaceToAdd,\n    skippedOps,\n    details,\n  };\n}\n\n/** Implements history entries to raw for the public runtime surface of this module. */\nexport function historyEntriesToRaw(entries: HistoryEntry[]): string {\n  if (entries.length === 0) {\n    return \"\";\n  }\n  return `${entries.map((entry) => JSON.stringify(entry)).join(\"\\n\")}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"d77401e4-b01b-5a23-b696-886d2009861c"}

package/dist/cli-bundle/chunks/{chunk-AQUNTB7G.js → chunk-PEQGTJ5Q.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]="22670538-a967-5856-adde-bb5576f11f56")}catch(e){}}();
 import {
   normalizeItemId
-} from "./chunk-QFG4MB7P.js";
+} from "./chunk-POG76WWZ.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/core/item/parent-reference-policy.js
 var PLACEHOLDER_REFERENCE_TOKENS = /* @__PURE__ */ new Set(["none", "null", "undefined"]);
@@ -95,6 +95,6 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-AQUNTB7G.js.map
+//# sourceMappingURL=chunk-PEQGTJ5Q.js.map
 
 //# debugId=22670538-a967-5856-adde-bb5576f11f56

package/dist/cli-bundle/chunks/{chunk-QFG4MB7P.js → chunk-POG76WWZ.js}

@@ -1,5 +1,5 @@
 
-!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]="e9c27dc3-9cd6-5835-835e-9da74ce163c1")}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]="1716fd1b-596b-59b3-8dc9-1131b372683a")}catch(e){}}();
 import {
   CONFIDENCE_TEXT_VALUES,
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
@@ -58,7 +58,7 @@ import {
   toErrorMessage,
   weekdayOrderIndex,
   writeFileAtomic
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/core/extensions/command-hook-context.js
 function createCoreCommandHookContext(options) {
@@ -553,6 +553,9 @@ function vNumber(options = {}) {
     if (typeof options.min === "number" && input < options.min) {
       return FAIL;
     }
+    if (typeof options.max === "number" && input > options.max) {
+      return FAIL;
+    }
     return { ok: true, value: input };
   };
 }
@@ -755,6 +758,9 @@ var extensionPolicy = vOptional(vObject({
 var settingsCheck = vObject({
   version: vNumber({ int: true }),
   id_prefix: vString,
+  ids: vOptional(vObject({
+    token_length: vOptional(vNumber({ int: true, min: 4, max: 12 }))
+  })),
   author_default: vString,
   item_format: vOptional(vLiteral("toon", "json_markdown")),
   locks: vObject({
@@ -1569,6 +1575,7 @@ function mergeSettings(settings) {
     ...settings,
     item_format: normalizeSettingsItemFormat(settings, defaults),
     locks: { ...defaults.locks, ...settings.locks },
+    ids: { ...defaults.ids, ...settings.ids },
     checkpoints: { ...defaults.checkpoints, ...settings.checkpoints },
     output: { ...defaults.output, ...settings.output },
     history: {
@@ -1611,6 +1618,9 @@ function orderSerializedSettingsSections(ordered) {
     "ttl_seconds",
     "wait_ms"
   ]);
+  ordered.ids = orderObject(ordered.ids, [
+    "token_length"
+  ]);
   ordered.checkpoints = orderObject(ordered.checkpoints, ["retention_days"]);
   ordered.output = orderObject(ordered.output, [
     "default_format"
@@ -1764,6 +1774,7 @@ function buildSerializeBaseSettings(settings) {
   return {
     ...settings,
     locks: valueOrDefault(settings.locks, SETTINGS_DEFAULTS.locks),
+    ids: valueOrDefault(settings.ids, SETTINGS_DEFAULTS.ids),
     checkpoints: valueOrDefault(settings.checkpoints, SETTINGS_DEFAULTS.checkpoints),
     output: valueOrDefault(settings.output, SETTINGS_DEFAULTS.output),
     history: valueOrDefault(settings.history, SETTINGS_DEFAULTS.history),
@@ -1872,6 +1883,7 @@ function serializeSettings(settings, options = {}) {
   }, [
     "version",
     "id_prefix",
+    "ids",
     "author_default",
     "item_format",
     "locks",
@@ -4361,10 +4373,19 @@ async function idExists(pmRoot, id) {
   }
   return false;
 }
-async function generateItemId(pmRoot, prefix) {
-  let tokenLength = 4;
+var ID_TOKEN_LENGTH_MIN = 4;
+var ID_TOKEN_LENGTH_MAX = 12;
+function clampIdTokenLength(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    return ID_TOKEN_LENGTH_MIN;
+  }
+  return Math.min(ID_TOKEN_LENGTH_MAX, Math.max(ID_TOKEN_LENGTH_MIN, Math.trunc(value)));
+}
+async function generateItemId(pmRoot, prefix, options = {}) {
+  let tokenLength = clampIdTokenLength(options.tokenLength);
+  const maxTokenLength = Math.min(tokenLength + 6, ID_TOKEN_LENGTH_MAX);
   let attempts = 0;
-  while (tokenLength <= 10) {
+  while (tokenLength <= maxTokenLength) {
     for (let i = 0; i < 32; i += 1) {
       const id = `${normalizePrefix(prefix)}${randomToken(tokenLength)}`;
       if (!await idExists(pmRoot, id)) {
@@ -5462,6 +5483,6 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-QFG4MB7P.js.map
+//# sourceMappingURL=chunk-POG76WWZ.js.map
 
-//# debugId=e9c27dc3-9cd6-5835-835e-9da74ce163c1
+//# debugId=1716fd1b-596b-59b3-8dc9-1131b372683a