@unbrained/pm-cli 2026.5.31 → 2026.6.6

package/dist/cli-bundle/chunks/{chunk-U7FMKRXH.js → chunk-6ER6DXH5.js}

@@ -3,37 +3,35 @@ import {
 } from "./chunk-O7IWB35H.js";
 import {
   readHistoryEntries
-} from "./chunk-LRBOHPUE.js";
+} from "./chunk-PRJCELV4.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
   toReplayDocument
-} from "./chunk-JFWUHHS2.js";
+} from "./chunk-UM2GBHS4.js";
 import {
+  acquireLock,
   appendHistoryEntry,
   createHistoryEntry,
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-BUPWJ3IJ.js";
-import {
-  acquireLock
-} from "./chunk-4AEZR5EJ.js";
+} from "./chunk-XTGLRY2Y.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-CEFIVZPG.js";
+} from "./chunk-T3LC5LKB.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-MD7K4JYF.js";
+} from "./chunk-AO442XLN.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-WDPXDQFG.js";
+} from "./chunk-KJE2FOS4.js";
 import {
   nowIso
-} from "./chunk-PVNQLCIS.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -42,12 +40,14 @@ import {
   getItemPath,
   getSettingsPath,
   pathExists,
+  projectAfterCommandItemSnapshot,
   readFileIfExists,
   readSettings,
+  recordAfterCommandAffectedItem,
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -55,7 +55,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] = "d40fa5ec-9a3f-52de-980b-b83b2e0021d1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "33d24f2b-7b7a-5588-9a53-e0511add3644");
   } catch (e2) {
   }
 })();
@@ -326,18 +326,39 @@ async function runRestore(id, target, options, global2) {
       }
       throw error;
     }
+    const restoreChangedFields = changedFields(resolvedCurrentDocument, restoredDocument);
     const hookWarnings = [
       ...await runActiveOnWriteHooks({
         path: restoredItemPath,
         scope: "project",
-        op: "restore"
+        op: "restore",
+        item_id: restoredDocument.metadata.id,
+        item_type: restoredDocument.metadata.type,
+        before: resolvedCurrentDocument,
+        after: restoredDocument,
+        changed_fields: ["restored"]
       }),
       ...await runActiveOnWriteHooks({
         path: subject.historyPath,
         scope: "project",
-        op: "restore:history"
+        op: "restore:history",
+        item_id: restoredDocument.metadata.id,
+        item_type: restoredDocument.metadata.type,
+        before: resolvedCurrentDocument,
+        after: restoredDocument,
+        changed_fields: ["restored"]
       })
     ];
+    recordAfterCommandAffectedItem({
+      id: restoredDocument.metadata.id,
+      op: "restore",
+      item_type: restoredDocument.metadata.type,
+      previous_status: resolvedCurrentDocument.metadata.status,
+      status: restoredDocument.metadata.status,
+      previous: projectAfterCommandItemSnapshot(resolvedCurrentDocument.metadata, restoreChangedFields),
+      current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),
+      changed_fields: restoreChangedFields
+    });
     const targetEntry = history[resolvedTarget.historyIndex];
     return {
       item: restoredDocument.metadata,
@@ -348,7 +369,7 @@ async function runRestore(id, target, options, global2) {
         entry_ts: targetEntry.ts,
         entry_op: targetEntry.op
       },
-      changed_fields: changedFields(resolvedCurrentDocument, restoredDocument),
+      changed_fields: restoreChangedFields,
       warnings: [...subject.historyPolicyWarnings, ...ownershipWarnings, ...hookWarnings]
     };
   } finally {
@@ -359,4 +380,4 @@ async function runRestore(id, target, options, global2) {
 export {
   runRestore
 };
-//# sourceMappingURL=chunk-U7FMKRXH.js.map
+//# sourceMappingURL=chunk-6ER6DXH5.js.map

package/dist/cli-bundle/chunks/chunk-6ER6DXH5.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/restore.ts"],
+  "sourcesContent": ["import 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  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\nexport interface RestoreCommandOptions {\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\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  if (typeof candidate.index === \"number\" && Number.isInteger(candidate.index) && candidate.index >= 0) {\n    context.patchIndex = candidate.index;\n  }\n  const operationRecord =\n    typeof candidate.operation === \"object\" && candidate.operation !== null\n      ? (candidate.operation as { op?: unknown; path?: unknown; from?: unknown })\n      : null;\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    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  }\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      failureContext.patchIndex !== undefined ? `patch_index=${failureContext.patchIndex}` : null,\n      failureContext.op ? `op=${failureContext.op}` : null,\n      failureContext.path ? `path=${failureContext.path}` : null,\n      failureContext.from ? `from=${failureContext.from}` : null,\n    ].filter((token): token is string => token !== null);\n    const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : \"\";\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({\n    metadata: currentReplay.metadata as unknown as ItemMetadata,\n    body: currentReplay.body,\n  });\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  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\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\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 = canonicalDocument(\n    {\n      metadata: replayDocument.metadata as unknown as ItemMetadata,\n      body: replayDocument.body,\n    },\n    { schema: settings.schema },\n  );\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    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"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/chunk-6P6GGMOG.js

@@ -0,0 +1,218 @@
+
+!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]="9d7e4d46-ea22-536a-8a47-90006a264b88")}catch(e){}}();
+import {
+  BUILTIN_ITEM_TYPE_VALUES
+} from "./chunk-5SFCOO6B.js";
+
+// dist/core/schema/item-types-file.js
+var BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
+function matchBuiltinTypeName(name) {
+  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());
+}
+function coerceAliasArray(value) {
+  return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function escapeForDoubleQuotes(value) {
+  return value.replace(/[\\"`$]/g, (char) => `\\${char}`);
+}
+function dedupeAliases(values) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const value of values) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+      continue;
+    }
+    const key = trimmed.toLowerCase();
+    if (!seen.has(key)) {
+      seen.set(key, trimmed);
+    }
+  }
+  return [...seen.values()].sort((left, right) => left.localeCompare(right));
+}
+function normalizeAddTypeInput(raw) {
+  const name = (raw.name ?? "").trim();
+  if (name.length === 0) {
+    throw new Error("Type name must not be empty.");
+  }
+  const builtinMatch = matchBuiltinTypeName(name);
+  if (builtinMatch) {
+    throw new Error(`Cannot redefine built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
+  }
+  const description = raw.description?.trim();
+  const defaultStatus = raw.defaultStatus?.trim();
+  const folder = raw.folder?.trim();
+  const aliases = dedupeAliases(raw.aliases ?? []);
+  for (const alias of aliases) {
+    const aliasBuiltin = matchBuiltinTypeName(alias);
+    if (aliasBuiltin) {
+      throw new Error(`Alias "${alias}" collides with built-in item type "${aliasBuiltin}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
+    }
+  }
+  return {
+    name,
+    description: description && description.length > 0 ? description : void 0,
+    defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : void 0,
+    folder: folder && folder.length > 0 ? folder : void 0,
+    aliases
+  };
+}
+function assertAliasesAvailable(input, existing) {
+  const selfLower = input.name.toLowerCase();
+  const taken = /* @__PURE__ */ new Map();
+  for (const definition of existing.definitions) {
+    if (typeof definition.name !== "string") {
+      continue;
+    }
+    const definitionName = definition.name.trim();
+    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {
+      continue;
+    }
+    taken.set(definitionName.toLowerCase(), definitionName);
+    for (const alias of coerceAliasArray(definition.aliases)) {
+      if (alias.trim().length > 0) {
+        taken.set(alias.trim().toLowerCase(), definitionName);
+      }
+    }
+  }
+  const nameOwner = taken.get(selfLower);
+  if (nameOwner) {
+    throw new Error(`Type name "${input.name}" collides with an alias of existing item type "${nameOwner}".`);
+  }
+  for (const alias of input.aliases) {
+    const owner = taken.get(alias.toLowerCase());
+    if (owner) {
+      throw new Error(`Alias "${alias}" already maps to existing item type "${owner}".`);
+    }
+  }
+}
+function parseItemTypesFile(raw) {
+  if (raw === null || raw === void 0 || raw.trim().length === 0) {
+    return { definitions: [] };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error("schema/types.json contains invalid JSON.");
+  }
+  return { definitions: extractDefinitions(parsed) };
+}
+function extractDefinitions(parsed) {
+  const candidate = selectDefinitionsArray(parsed);
+  if (!candidate) {
+    return [];
+  }
+  const definitions = [];
+  for (const entry of candidate) {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+      continue;
+    }
+    const record = entry;
+    if (typeof record.name !== "string" || record.name.trim().length === 0) {
+      continue;
+    }
+    definitions.push(record);
+  }
+  return definitions;
+}
+function selectDefinitionsArray(parsed) {
+  if (Array.isArray(parsed)) {
+    return parsed;
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    return void 0;
+  }
+  const record = parsed;
+  if (Array.isArray(record.definitions)) {
+    return record.definitions;
+  }
+  if (typeof record.item_types === "object" && record.item_types !== null) {
+    const nested = record.item_types;
+    if (Array.isArray(nested.definitions)) {
+      return nested.definitions;
+    }
+  }
+  return void 0;
+}
+function upsertItemType(file, input) {
+  const lowerName = input.name.toLowerCase();
+  const definitions = file.definitions.slice();
+  const existingIndex = definitions.findIndex((definition) => typeof definition.name === "string" && definition.name.trim().toLowerCase() === lowerName);
+  const existing = existingIndex >= 0 ? definitions[existingIndex] : void 0;
+  const mergedAliases = dedupeAliases([...coerceAliasArray(existing?.aliases), ...input.aliases]);
+  const next = {
+    ...existing ?? {},
+    name: input.name
+  };
+  if (input.folder !== void 0) {
+    next.folder = input.folder;
+  }
+  if (mergedAliases.length > 0) {
+    next.aliases = mergedAliases;
+  } else if (next.aliases !== void 0) {
+    delete next.aliases;
+  }
+  applyAttribute(next, "description", input.description);
+  applyAttribute(next, "default_status", input.defaultStatus);
+  if (existingIndex >= 0) {
+    definitions[existingIndex] = next;
+  } else {
+    definitions.push(next);
+  }
+  definitions.sort((left, right) => left.name.localeCompare(right.name));
+  return {
+    file: { definitions },
+    definition: next,
+    replaced: existingIndex >= 0
+  };
+}
+function removeItemType(file, name) {
+  const trimmed = (name ?? "").trim();
+  if (trimmed.length === 0) {
+    throw new Error("Type name must not be empty.");
+  }
+  const builtinMatch = matchBuiltinTypeName(trimmed);
+  if (builtinMatch) {
+    throw new Error(`Cannot remove built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
+  }
+  const lowerName = trimmed.toLowerCase();
+  const definitions = file.definitions.slice();
+  const existingIndex = definitions.findIndex((definition2) => typeof definition2.name === "string" && definition2.name.trim().toLowerCase() === lowerName);
+  if (existingIndex < 0) {
+    return { file: { definitions }, removed: false };
+  }
+  const [definition] = definitions.splice(existingIndex, 1);
+  return { file: { definitions }, removed: true, definition };
+}
+function applyAttribute(definition, key, value) {
+  const record = definition;
+  if (value !== void 0) {
+    record[key] = value;
+  }
+}
+function serializeItemTypesFile(file) {
+  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}
+`;
+}
+function buildInvalidTypeHint(name) {
+  const safeName = name.trim().length > 0 ? name.trim() : name;
+  return `To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes .agents/pm/schema/types.json).`;
+}
+function buildInvalidTypeError(name, allowedTypes) {
+  return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name)}`;
+}
+
+export {
+  escapeForDoubleQuotes,
+  normalizeAddTypeInput,
+  assertAliasesAvailable,
+  parseItemTypesFile,
+  upsertItemType,
+  removeItemType,
+  serializeItemTypesFile,
+  buildInvalidTypeHint,
+  buildInvalidTypeError
+};
+//# sourceMappingURL=chunk-6P6GGMOG.js.map
+
+//# debugId=9d7e4d46-ea22-536a-8a47-90006a264b88

package/dist/cli-bundle/chunks/chunk-6P6GGMOG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/schema/item-types-file.ts"],"sourcesContent":["import { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport type { ItemTypeDefinition } from \"../../types/index.js\";\n\nexport type { ItemTypeDefinition } from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-type` command and the create/update\n * invalid-type discoverability hint. The CLI command file (schema.ts) handles\n * IO/governance; everything testable and side-effect-free lives here so it can\n * be coverage-gated to 100%.\n */\n\nconst BUILTIN_NAME_LOOKUP = new Map<string, string>(\n  BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]),\n);\n\n/**\n * The shape persisted at `.agents/pm/schema/types.json`.\n */\nexport interface ItemTypesFile {\n  definitions: ItemTypeDefinition[];\n}\n\nexport interface NormalizedAddTypeInput {\n  name: string;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases: string[];\n}\n\nexport interface RawAddTypeInput {\n  name: string | undefined;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases?: string[];\n}\n\nexport interface UpsertItemTypeResult {\n  file: ItemTypesFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: ItemTypeDefinition;\n  /** True when an existing definition with the same (case-insensitive) name was replaced. */\n  replaced: boolean;\n}\n\nexport interface RemoveItemTypeResult {\n  file: ItemTypesFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched (case-insensitively) the requested name. */\n  definition?: ItemTypeDefinition;\n}\n\n/**\n * Returns the canonical built-in name when `name` collides (case-insensitively)\n * with a reserved built-in item type, otherwise undefined.\n */\nexport function matchBuiltinTypeName(name: string): string | undefined {\n  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());\n}\n\n/**\n * Coerces a persisted `aliases` value into a string array, tolerating malformed\n * data (a non-array, or an array containing non-string entries) without throwing\n * or exploding a stray string into character aliases.\n */\nfunction coerceAliasArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * Escapes a value for safe interpolation inside a double-quoted shell string so\n * suggested copy-pasteable commands stay well-formed for names containing\n * `\"`, `` ` ``, `$`, or `\\`.\n */\nexport function escapeForDoubleQuotes(value: string): string {\n  return value.replace(/[\\\\\"`$]/g, (char) => `\\\\${char}`);\n}\n\nfunction dedupeAliases(values: Iterable<string>): string[] {\n  const seen = new Map<string, string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const key = trimmed.toLowerCase();\n    if (!seen.has(key)) {\n      seen.set(key, trimmed);\n    }\n  }\n  return [...seen.values()].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-type CLI input. Throws a plain Error with a\n * stable message when the name is missing/empty or collides with a built-in;\n * the CLI layer maps these to PmCliError exit codes.\n */\nexport function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedAddTypeInput {\n  const name = (raw.name ?? \"\").trim();\n  if (name.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(name);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot redefine built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const description = raw.description?.trim();\n  const defaultStatus = raw.defaultStatus?.trim();\n  const folder = raw.folder?.trim();\n  const aliases = dedupeAliases(raw.aliases ?? []);\n  for (const alias of aliases) {\n    const aliasBuiltin = matchBuiltinTypeName(alias);\n    if (aliasBuiltin) {\n      throw new Error(\n        `Alias \"${alias}\" collides with built-in item type \"${aliasBuiltin}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n      );\n    }\n  }\n  return {\n    name,\n    description: description && description.length > 0 ? description : undefined,\n    defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases,\n  };\n}\n\n/**\n * Throws when the requested name or any alias collides (case-insensitively)\n * with the canonical name or an alias of a DIFFERENT existing definition.\n * Such collisions would make `pm create`/`pm update --type` resolve\n * ambiguously (the runtime registry keys a single lowercase alias map), so\n * they are rejected. Tokens belonging to the same-named definition being\n * upserted are ignored, keeping re-runs idempotent.\n */\nexport function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void {\n  const selfLower = input.name.toLowerCase();\n  const taken = new Map<string, string>();\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    taken.set(definitionName.toLowerCase(), definitionName);\n    for (const alias of coerceAliasArray(definition.aliases)) {\n      if (alias.trim().length > 0) {\n        taken.set(alias.trim().toLowerCase(), definitionName);\n      }\n    }\n  }\n  const nameOwner = taken.get(selfLower);\n  if (nameOwner) {\n    throw new Error(`Type name \"${input.name}\" collides with an alias of existing item type \"${nameOwner}\".`);\n  }\n  for (const alias of input.aliases) {\n    const owner = taken.get(alias.toLowerCase());\n    if (owner) {\n      throw new Error(`Alias \"${alias}\" already maps to existing item type \"${owner}\".`);\n    }\n  }\n}\n\n/**\n * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.\n * Accepts the canonical `{ definitions: [...] }` shape, a bare array of\n * definitions, or a nested `{ item_types: { definitions: [...] } }` form, and\n * tolerates a missing/invalid file by returning an empty definitions list.\n */\nexport function parseItemTypesFile(raw: string | null | undefined): ItemTypesFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { definitions: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/types.json contains invalid JSON.\");\n  }\n  return { definitions: extractDefinitions(parsed) };\n}\n\nfunction extractDefinitions(parsed: unknown): ItemTypeDefinition[] {\n  const candidate = selectDefinitionsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: ItemTypeDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.name !== \"string\" || record.name.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as ItemTypeDefinition);\n  }\n  return definitions;\n}\n\nfunction selectDefinitionsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  if (typeof record.item_types === \"object\" && record.item_types !== null) {\n    const nested = record.item_types as Record<string, unknown>;\n    if (Array.isArray(nested.definitions)) {\n      return nested.definitions;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Idempotent UPSERT of a custom item type into the parsed file. Matching is\n * case-insensitive by name. When a definition already exists, fields supplied\n * in `input` override the previous values; aliases are merged (deduped); other\n * fields not addressed by add-type flags are preserved untouched.\n */\nexport function upsertItemType(file: ItemTypesFile, input: NormalizedAddTypeInput): UpsertItemTypeResult {\n  const lowerName = input.name.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;\n\n  const mergedAliases = dedupeAliases([...coerceAliasArray(existing?.aliases), ...input.aliases]);\n\n  const next: ItemTypeDefinition = {\n    ...(existing ?? {}),\n    name: input.name,\n  };\n  if (input.folder !== undefined) {\n    next.folder = input.folder;\n  }\n  if (mergedAliases.length > 0) {\n    next.aliases = mergedAliases;\n  } else if (next.aliases !== undefined) {\n    delete next.aliases;\n  }\n  applyAttribute(next, \"description\", input.description);\n  applyAttribute(next, \"default_status\", input.defaultStatus);\n\n  if (existingIndex >= 0) {\n    definitions[existingIndex] = next;\n  } else {\n    definitions.push(next);\n  }\n  definitions.sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    file: { definitions },\n    definition: next,\n    replaced: existingIndex >= 0,\n  };\n}\n\n/**\n * Removes a custom item type definition from the parsed file by name\n * (case-insensitive). Throws a plain Error when `name` is empty or collides\n * with a reserved built-in type (built-ins are not stored in the file and must\n * never be deletable). Returns `removed: false` when no matching custom\n * definition exists so the CLI layer can treat the call as an idempotent no-op.\n */\nexport function removeItemType(file: ItemTypesFile, name: string | undefined): RemoveItemTypeResult {\n  const trimmed = (name ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(trimmed);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot remove built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const lowerName = trimmed.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  if (existingIndex < 0) {\n    return { file: { definitions }, removed: false };\n  }\n  const [definition] = definitions.splice(existingIndex, 1);\n  return { file: { definitions }, removed: true, definition };\n}\n\nfunction applyAttribute(definition: ItemTypeDefinition, key: string, value: string | undefined): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined) {\n    record[key] = value;\n  }\n}\n\n/**\n * Serializes the item types file with a trailing newline (matches the rest of\n * the schema scaffold files written by pm).\n */\nexport function serializeItemTypesFile(file: ItemTypesFile): string {\n  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\\n`;\n}\n\n/**\n * Appends a discoverable hint to the \"Invalid type\" error so agents learn that\n * custom types exist and how to register one. Quotes are chosen so the printed\n * line is copy-pasteable as a shell command.\n */\nexport function buildInvalidTypeHint(name: string): string {\n  const safeName = name.trim().length > 0 ? name.trim() : name;\n  return `To register a custom type, run: pm schema add-type \"${escapeForDoubleQuotes(safeName)}\" (writes .agents/pm/schema/types.json).`;\n}\n\n/**\n * Builds the full invalid-type error message used by create/update: the\n * existing \"Invalid type ... Allowed: ...\" line plus the discoverable hint.\n */\nexport function buildInvalidTypeError(name: string, allowedTypes: readonly string[]): string {\n  return `Invalid type value \"${name}\". Allowed: ${allowedTypes.join(\", \")}. ${buildInvalidTypeHint(name)}`;\n}\n"],"names":["definition"],"mappings":"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","debugId":"9d7e4d46-ea22-536a-8a47-90006a264b88"}

package/dist/cli-bundle/chunks/chunk-77GFDHGF.js

@@ -0,0 +1,80 @@
+
+!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]="399b6987-8865-5489-b1c8-bf64257b2ad8")}catch(e){}}();
+import {
+  EXIT_CODE,
+  PmCliError
+} from "./chunk-5SFCOO6B.js";
+
+// dist/core/item/parent-reference-policy.js
+function normalizeParentReferencePolicy(value) {
+  const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
+  if (normalized === "warn" || normalized === "strict_error") {
+    return normalized;
+  }
+  if (normalized === "strict") {
+    return "strict_error";
+  }
+  throw new PmCliError("Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)", EXIT_CODE.USAGE);
+}
+function normalizeParentReferenceValue(rawValue) {
+  const value = rawValue.trim();
+  if (value.length === 0) {
+    throw new PmCliError("--parent must not be empty. Use --parent none to unset.", EXIT_CODE.USAGE);
+  }
+  const normalized = value.toLowerCase();
+  if (normalized === "none" || normalized === "null" || normalized === "undefined") {
+    throw new PmCliError(`--parent must not use placeholder token "${value}". Use --unset parent to clear this field.`, EXIT_CODE.USAGE);
+  }
+  return value;
+}
+function validateMissingParentReference(parentId, policy) {
+  if (policy === "strict_error") {
+    throw new PmCliError(`Parent item "${parentId}" was not found. Create it first or use --parent none.`, EXIT_CODE.USAGE);
+  }
+  return {
+    warnings: [`validation_warning:parent_reference_missing:${parentId}`]
+  };
+}
+
+// dist/core/item/sprint-release-format.js
+var SPRINT_RELEASE_VALUE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+var SPRINT_RELEASE_MAX_LENGTH = 64;
+function normalizeSprintReleaseFormatPolicy(value) {
+  const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
+  if (normalized === "warn" || normalized === "strict_error") {
+    return normalized;
+  }
+  if (normalized === "strict") {
+    return "strict_error";
+  }
+  throw new PmCliError("Config set sprint-release-format-policy requires --policy with one of: warn, strict_error (alias: strict)", EXIT_CODE.USAGE);
+}
+function validateSprintOrReleaseValue(field, rawValue, policy) {
+  const value = rawValue.trim();
+  if (value.length === 0) {
+    throw new PmCliError(`--${field} must not be empty. Use --${field} none to unset.`, EXIT_CODE.USAGE);
+  }
+  const isValid = value.length <= SPRINT_RELEASE_MAX_LENGTH && SPRINT_RELEASE_VALUE_PATTERN.test(value);
+  if (isValid) {
+    return { value, warnings: [] };
+  }
+  const guidance = "Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._/-]* (no spaces).";
+  if (policy === "strict_error") {
+    throw new PmCliError(`Invalid --${field} value "${value}". ${guidance}`, EXIT_CODE.USAGE);
+  }
+  return {
+    value,
+    warnings: [`validation_warning:${field}_format:${value}`]
+  };
+}
+
+export {
+  normalizeParentReferencePolicy,
+  normalizeParentReferenceValue,
+  validateMissingParentReference,
+  normalizeSprintReleaseFormatPolicy,
+  validateSprintOrReleaseValue
+};
+//# sourceMappingURL=chunk-77GFDHGF.js.map
+
+//# debugId=399b6987-8865-5489-b1c8-bf64257b2ad8

package/dist/cli-bundle/chunks/chunk-77GFDHGF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/item/parent-reference-policy.ts","../../../../../../../../core/item/sprint-release-format.ts"],"sourcesContent":["import type { ParentReferencePolicy } from \"../../types/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nexport function normalizeParentReferencePolicy(value: string | undefined): ParentReferencePolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\nexport function normalizeParentReferenceValue(rawValue: string): string {\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(\"--parent must not be empty. Use --parent none to unset.\", EXIT_CODE.USAGE);\n  }\n  const normalized = value.toLowerCase();\n  if (normalized === \"none\" || normalized === \"null\" || normalized === \"undefined\") {\n    throw new PmCliError(\n      `--parent must not use placeholder token \"${value}\". Use --unset parent to clear this field.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\nexport function validateMissingParentReference(\n  parentId: string,\n  policy: ParentReferencePolicy,\n): { warnings: string[] } {\n  if (policy === \"strict_error\") {\n    throw new PmCliError(\n      `Parent item \"${parentId}\" was not found. Create it first or use --parent none.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    warnings: [`validation_warning:parent_reference_missing:${parentId}`],\n  };\n}\n","import type { SprintReleaseFormatPolicy } from \"../../types/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst SPRINT_RELEASE_VALUE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;\nconst SPRINT_RELEASE_MAX_LENGTH = 64;\n\nexport function normalizeSprintReleaseFormatPolicy(value: string | undefined): SprintReleaseFormatPolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set sprint-release-format-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\nexport function validateSprintOrReleaseValue(\n  field: \"sprint\" | \"release\",\n  rawValue: string,\n  policy: SprintReleaseFormatPolicy,\n): { value: string; warnings: string[] } {\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(`--${field} must not be empty. Use --${field} none to unset.`, EXIT_CODE.USAGE);\n  }\n  const isValid = value.length <= SPRINT_RELEASE_MAX_LENGTH && SPRINT_RELEASE_VALUE_PATTERN.test(value);\n  if (isValid) {\n    return { value, warnings: [] };\n  }\n  const guidance = \"Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._/-]* (no spaces).\";\n  if (policy === \"strict_error\") {\n    throw new PmCliError(`Invalid --${field} value \"${value}\". ${guidance}`, EXIT_CODE.USAGE);\n  }\n  return {\n    value,\n    warnings: [`validation_warning:${field}_format:${value}`],\n  };\n}\n"],"names":[],"mappings":";;;;;;;;AAIM,SAAU,+BAA+B,OAAyB;AACtE,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,wGACA,UAAU,KAAK;AAEnB;AAEM,SAAU,8BAA8B,UAAgB;AAC5D,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,2DAA2D,UAAU,KAAK;EACjG;AACA,QAAM,aAAa,MAAM,YAAW;AACpC,MAAI,eAAe,UAAU,eAAe,UAAU,eAAe,aAAa;AAChF,UAAM,IAAI,WACR,4CAA4C,KAAK,8CACjD,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAEM,SAAU,+BACd,UACA,QAA6B;AAE7B,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WACR,gBAAgB,QAAQ,0DACxB,UAAU,KAAK;EAEnB;AACA,SAAO;IACL,UAAU,CAAC,+CAA+C,QAAQ,EAAE;;AAExE;;;AC1CA,IAAM,+BAA+B;AACrC,IAAM,4BAA4B;AAE5B,SAAU,mCAAmC,OAAyB;AAC1E,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,6GACA,UAAU,KAAK;AAEnB;AAEM,SAAU,6BACd,OACA,UACA,QAAiC;AAEjC,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,KAAK,KAAK,6BAA6B,KAAK,mBAAmB,UAAU,KAAK;EACrG;AACA,QAAM,UAAU,MAAM,UAAU,6BAA6B,6BAA6B,KAAK,KAAK;AACpG,MAAI,SAAS;AACX,WAAO,EAAE,OAAO,UAAU,CAAA,EAAE;EAC9B;AACA,QAAM,WAAW;AACjB,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WAAW,aAAa,KAAK,WAAW,KAAK,MAAM,QAAQ,IAAI,UAAU,KAAK;EAC1F;AACA,SAAO;IACL;IACA,UAAU,CAAC,sBAAsB,KAAK,WAAW,KAAK,EAAE;;AAE5D","debugId":"399b6987-8865-5489-b1c8-bf64257b2ad8"}

package/dist/cli-bundle/chunks/{chunk-MD7K4JYF.js → chunk-AO442XLN.js}

@@ -1,7 +1,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-PVNQLCIS.js";
+} from "./chunk-QO7EBBOM.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -17,13 +17,13 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/core/schema/runtime-field-values.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] = "9ea6c17b-212c-5632-a953-dd14f552a1f2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "9404b5dc-84de-5e85-86d5-fc0eabe52348");
   } catch (e2) {
   }
 })();
@@ -155,13 +155,19 @@ function collectRuntimeCreateFieldValues(options, fieldRegistry, itemTypeName) {
     missing_required_flags: [...new Set(missingRequiredFlags)].sort((left, right) => left.localeCompare(right))
   };
 }
-function collectRuntimeUpdateFieldValues(options, fieldRegistry) {
+function collectRuntimeUpdateFieldValues(options, fieldRegistry, commands = ["update"]) {
   const values = {};
-  for (const definition of fieldRegistry.command_to_fields.get("update") ?? []) {
+  const definitions = (commands ?? ["update"]).flatMap((command) => fieldRegistry.command_to_fields.get(command) ?? []);
+  const seen = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
     const rawValue = readRuntimeFieldOptionValue(options, definition);
     if (rawValue === void 0) {
       continue;
     }
+    if (seen.has(definition.metadata_key)) {
+      continue;
+    }
+    seen.add(definition.metadata_key);
     values[definition.metadata_key] = coerceRuntimeFieldValue(definition, rawValue);
   }
   return values;
@@ -284,7 +290,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] = "7ce34b61-0ca0-51e3-8969-50ee0dbe020b");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "375a5879-64b1-55a4-a83e-90ee50031713");
   } catch (e2) {
   }
 })();
@@ -308,6 +314,7 @@ function resolveRuntimeSchemaValidationContext(options) {
     statusRegistry: resolveRuntimeStatusRegistry(options.schema),
     fieldRegistry: resolveRuntimeFieldRegistry(options.schema),
     unknownFieldPolicy: options.schema.unknown_field_policy ?? "allow",
+    extensionFieldNames: new Set(options.extensionFieldNames ?? []),
     onWarning: options.onWarning
   };
 }
@@ -323,6 +330,16 @@ function runtimeFieldRequiredForType(definition, typeName) {
 function validationError(message) {
   throw new PmCliError(`Invalid item front matter: ${message}`, EXIT_CODE.GENERIC_FAILURE);
 }
+function buildKnownFrontMatterKeys(runtimeContext) {
+  const knownKeys = new Set(STATIC_FRONT_MATTER_FIELD_SET);
+  for (const definition of runtimeContext.fieldRegistry?.definitions ?? []) {
+    knownKeys.add(definition.metadata_key);
+  }
+  for (const fieldName of runtimeContext.extensionFieldNames) {
+    knownKeys.add(fieldName);
+  }
+  return knownKeys;
+}
 function assertFrontMatterCondition(condition, message) {
   if (!condition) {
     validationError(message);
@@ -505,10 +522,7 @@ function assertValidFrontMatter(frontMatter, runtimeContext) {
     }
   }
   if (runtimeContext && runtimeContext.unknownFieldPolicy !== "allow") {
-    const knownKeys = new Set(STATIC_FRONT_MATTER_FIELD_SET);
-    for (const definition of runtimeContext.fieldRegistry?.definitions ?? []) {
-      knownKeys.add(definition.metadata_key);
-    }
+    const knownKeys = buildKnownFrontMatterKeys(runtimeContext);
     const unknownKeys = Object.keys(record).filter((key) => !knownKeys.has(key)).sort((left, right) => left.localeCompare(right));
     if (unknownKeys.length > 0) {
       if (runtimeContext.unknownFieldPolicy === "reject") {
@@ -1142,10 +1156,7 @@ function normalizeFrontMatter(frontMatter, options = {}) {
     }
   }
   if (runtimeContext && runtimeContext.unknownFieldPolicy !== "allow") {
-    const knownKeys = new Set(STATIC_FRONT_MATTER_FIELD_SET);
-    for (const definition of runtimeContext.fieldRegistry?.definitions ?? []) {
-      knownKeys.add(definition.metadata_key);
-    }
+    const knownKeys = buildKnownFrontMatterKeys(runtimeContext);
     const unknownKeys = Object.keys(normalized).filter((key) => !knownKeys.has(key)).sort((left, right) => left.localeCompare(right));
     if (unknownKeys.length > 0) {
       if (runtimeContext.unknownFieldPolicy === "reject") {
@@ -1342,4 +1353,4 @@ export {
   serializeItemDocument,
   canonicalDocument
 };
-//# sourceMappingURL=chunk-MD7K4JYF.js.map
+//# sourceMappingURL=chunk-AO442XLN.js.map