@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/cli-bundle/chunks/{chunk-QG4GFLQ6.js → chunk-XD6UF2NB.js}

@@ -8,11 +8,12 @@ import {
   replayToItemDocument,
   resolveHistoryTarget,
   toReplayDocument
-} from "./chunk-2L6ZP22J.js";
+} from "./chunk-GSP6IZFU.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
 import {
+  acquireItemMetadataDerivedIndexLock,
   acquireLock,
   appendHistoryEntry,
   canonicalDocument,
@@ -27,9 +28,10 @@ import {
   readLocatedItem,
   readSettings,
   recordAfterCommandAffectedItem,
+  refreshItemMetadataDerivedIndex,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-IY6VZ3IW.js";
+} from "./chunk-5FAG2JUC.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -41,7 +43,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   writeFileAtomic
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -49,7 +51,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] = "85cceb36-61f7-52a0-9d61-a0159b3565dc");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e58ea1e1-fbed-5760-83c5-fa3190502e23");
   } catch (e2) {
   }
 })();
@@ -240,27 +242,42 @@ async function runRestore(id, target, options, global2) {
       schema: settings.schema
     });
     const restoredItemPath = getItemPath(pmRoot, restoredDocument.metadata.type, resolvedId, itemFormat, typeRegistry.type_to_folder);
-    await writeFileAtomic(restoredItemPath, serializedRestore);
-    if (existingItemPath && restoredItemPath !== existingItemPath) {
-      await fs.rm(existingItemPath);
-    }
-    const historyEntry = createHistoryEntry({
-      nowIso: nowIso(),
-      author,
-      op: "restore",
-      before: currentState.document,
-      after: restoredDocument,
-      message: options.message
-    });
+    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(pmRoot, author);
+    let derivedIndexWarnings = [];
     try {
-      await appendHistoryEntry(subject.historyPath, historyEntry);
-    } catch (error) {
-      await restorePreviousItemAfterHistoryFailure({
-        existingItemPath,
-        resolvedOriginalRaw: currentState.originalRaw,
-        restoredItemPath
+      await writeFileAtomic(restoredItemPath, serializedRestore);
+      if (existingItemPath && restoredItemPath !== existingItemPath) {
+        await fs.rm(existingItemPath);
+      }
+      const historyEntry = createHistoryEntry({
+        nowIso: nowIso(),
+        author,
+        op: "restore",
+        before: currentState.document,
+        after: restoredDocument,
+        message: options.message
+      });
+      try {
+        await appendHistoryEntry(subject.historyPath, historyEntry);
+      } catch (error) {
+        await restorePreviousItemAfterHistoryFailure({
+          existingItemPath,
+          resolvedOriginalRaw: currentState.originalRaw,
+          restoredItemPath
+        });
+        throw error;
+      }
+      derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
+        pmRoot,
+        preferredFormat: settings.item_format,
+        typeToFolder: typeRegistry.type_to_folder,
+        schema: settings.schema,
+        itemPath: restoredItemPath,
+        previousItemPath: existingItemPath ?? void 0,
+        document: restoredDocument
       });
-      throw error;
+    } finally {
+      await releaseDerivedIndexLock();
     }
     const restoreChangedFields = changedFields(currentState.document, restoredDocument);
     const hookWarnings = await runRestoreWriteHooks({
@@ -293,6 +310,7 @@ async function runRestore(id, target, options, global2) {
       warnings: [
         ...subject.historyPolicyWarnings,
         ...ownershipWarnings,
+        ...derivedIndexWarnings,
         ...hookWarnings
       ]
     };
@@ -315,4 +333,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-QG4GFLQ6.js.map
+//# sourceMappingURL=chunk-XD6UF2NB.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/restore.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/restore\n *\n * Implements the pm restore command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport fs from \"node:fs/promises\";\nimport {\n  pathExists,\n  readFileIfExists,\n  writeFileAtomic,\n} from \"../../core/fs/fs-utils.js\";\nimport {\n  appendHistoryEntry,\n  createHistoryEntry,\n} from \"../../core/history/history.js\";\nimport {\n  replayToCanonicalItemDocument,\n  replayToItemDocument,\n  toReplayDocument,\n} from \"../../core/history/replay.js\";\nimport {\n  applyHistoryPatch,\n  ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget,\n  extractPatchFailureContext,\n  readHistoryEntries,\n  replayHistoryToTarget as replayToTarget,\n  resolveHistoryTarget,\n} from \"../../sdk/history-read.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport {\n  canonicalDocument,\n  serializeItemDocument,\n} 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 {\n  acquireItemMetadataDerivedIndexLock,\n  refreshItemMetadataDerivedIndex,\n} from \"../../sdk/item-metadata-index.js\";\nimport {\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemDocument,\n  ItemMetadata,\n} from \"../../types/index.js\";\n\ninterface ResolvedRestoreSubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n  historyPolicyWarnings: string[];\n}\n\ninterface RestoreCurrentState {\n  document: ItemDocument;\n  originalRaw: string | null;\n}\n\n/** Documents the restore command options payload exchanged by command, SDK, and package integrations. */\nexport interface RestoreCommandOptions {\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the restore result payload exchanged by command, SDK, and package integrations. */\nexport interface RestoreResult {\n  /** Value that configures or reports item for this contract. */\n  item: ItemMetadata;\n  /** Value that configures or reports restored from for this contract. */\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */\nfunction ensureReplayTarget(target: string, history: readonly HistoryEntry[]) {\n  return resolveHistoryTarget(target, history, {\n    errorSubject: \"restore\",\n    allowFutureTimestamp: true,\n  });\n}\n\nfunction replayCurrentDocument(history: HistoryEntry[]): ItemDocument {\n  const currentReplay = replayToTarget(history, history.length - 1);\n  if (Object.keys(currentReplay.metadata).length === 0) {\n    return {\n      metadata: {} as ItemMetadata,\n      body: currentReplay.body,\n    };\n  }\n  return canonicalDocument(replayToItemDocument(currentReplay));\n}\n\nasync function resolveRestoreSubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<ResolvedRestoreSubject> {\n  const located = await locateItem(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeToFolder,\n  );\n  if (located) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"restore\",\n    });\n    return {\n      id: located.id,\n      historyPath,\n      located,\n      historyPolicyWarnings: historyPolicy.warnings,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */\n  const candidateIds =\n    normalizedId === rawNormalizedId\n      ? [normalizedId]\n      : [normalizedId, rawNormalizedId];\n  /* c8 ignore stop */\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n        historyPolicyWarnings: [],\n      };\n    }\n  }\n\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\nfunction changedFields(\n  beforeDocument: ItemDocument,\n  afterDocument: ItemDocument,\n): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(\n    beforeReplay,\n    afterReplay,\n  ) 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\n      .replace(/^\\/(?:metadata|front_matter)\\/?/, \"\")\n      .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\nasync function loadRestoreStateUnderLock(params: {\n  pmRoot: string;\n  resolvedId: string;\n  subject: ResolvedRestoreSubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n}): Promise<{\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  existingItemPath: string | null;\n}> {\n  const historyRawUnderLock = await readFileIfExists(\n    params.subject.historyPath,\n  );\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(\n      `History for ${params.resolvedId} changed while waiting for lock; retry restore.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.resolvedId,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeToFolder,\n  );\n  const loadedItemUnderLock = locatedUnderLock\n    ? await readLocatedItem(locatedUnderLock, {\n        schema: params.settings.schema,\n      })\n    : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== params.currentItemRawBeforeLock) {\n    throw new PmCliError(\n      `Item ${params.resolvedId} changed while waiting for lock; retry restore.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return {\n    loadedItemUnderLock,\n    existingItemPath: locatedUnderLock?.itemPath ?? null,\n  };\n}\n\nfunction resolveRestoreCurrentState(\n  loadedItemUnderLock: Awaited<ReturnType<typeof readLocatedItem>> | null,\n  history: HistoryEntry[],\n): RestoreCurrentState {\n  if (loadedItemUnderLock) {\n    return {\n      document: loadedItemUnderLock.document,\n      originalRaw: loadedItemUnderLock.raw,\n    };\n  }\n  return { document: replayCurrentDocument(history), originalRaw: null };\n}\n\nfunction collectRestoreOwnershipWarnings(params: {\n  document: ItemDocument;\n  author: string;\n  force: boolean | undefined;\n  enforcement: \"strict\" | \"warn\" | \"none\";\n  resolvedId: string;\n}): string[] {\n  const assigned = params.document.metadata.assignee?.trim();\n  const hasOwnershipConflict =\n    assigned && assigned !== params.author && !params.force;\n  if (!hasOwnershipConflict) {\n    return [];\n  }\n  if (params.enforcement === \"strict\") {\n    throw new PmCliError(\n      `Item ${params.resolvedId} is assigned to ${assigned}. Use --force to override.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return params.enforcement === \"warn\"\n    ? [`ownership_warning:assignee_conflict:${params.resolvedId}:${assigned}`]\n    : [];\n}\n\nasync function restorePreviousItemAfterHistoryFailure(params: {\n  existingItemPath: string | null;\n  resolvedOriginalRaw: string | null;\n  restoredItemPath: string;\n}): Promise<void> {\n  if (\n    params.existingItemPath &&\n    params.resolvedOriginalRaw !== null &&\n    params.restoredItemPath !== params.existingItemPath\n  ) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    await fs.rm(params.restoredItemPath, { force: true });\n    return;\n  }\n  if (params.existingItemPath && params.resolvedOriginalRaw !== null) {\n    await writeFileAtomic(params.existingItemPath, params.resolvedOriginalRaw);\n    return;\n  }\n  await fs.rm(params.restoredItemPath, { force: true });\n}\n\nasync function runRestoreWriteHooks(params: {\n  restoredItemPath: string;\n  historyPath: string;\n  before: ItemDocument;\n  after: ItemDocument;\n}): Promise<string[]> {\n  return [\n    ...(await runActiveOnWriteHooks({\n      path: params.restoredItemPath,\n      scope: \"project\",\n      op: \"restore\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n    ...(await runActiveOnWriteHooks({\n      path: params.historyPath,\n      scope: \"project\",\n      op: \"restore:history\",\n      item_id: params.after.metadata.id,\n      item_type: params.after.metadata.type,\n      before: params.before,\n      after: params.after,\n      changed_fields: [\"restored\"],\n    })),\n  ];\n}\n\n/** Implements run restore for the public runtime surface of this module. */\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(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveRestoreSubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\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(\n      `No history exists for ${resolvedId}; restore is unavailable.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(\n    replayToTarget(history, resolvedTarget.historyIndex),\n    resolvedTarget,\n  );\n  const restoredDocument = replayToCanonicalItemDocument(replayDocument, {\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\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : 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    settings.locks.wait_ms,\n  );\n\n  try {\n    const { loadedItemUnderLock, existingItemPath } =\n      await loadRestoreStateUnderLock({\n        pmRoot,\n        resolvedId,\n        subject,\n        settings,\n        typeToFolder: typeRegistry.type_to_folder,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n      });\n    const itemFormat = \"toon\";\n    const currentState = resolveRestoreCurrentState(\n      loadedItemUnderLock,\n      history,\n    );\n    const ownershipWarnings = collectRestoreOwnershipWarnings({\n      document: currentState.document,\n      author,\n      force: options.force,\n      enforcement: settings.governance.ownership_enforcement,\n      resolvedId,\n    });\n\n    const serializedRestore = serializeItemDocument(restoredDocument, {\n      format: itemFormat,\n      schema: settings.schema,\n    });\n    /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */\n    const restoredItemPath = getItemPath(\n      pmRoot,\n      restoredDocument.metadata.type,\n      resolvedId,\n      itemFormat,\n      typeRegistry.type_to_folder,\n    );\n    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(\n      pmRoot,\n      author,\n    );\n    let derivedIndexWarnings: string[] = [];\n    try {\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: currentState.document,\n        after: restoredDocument,\n        message: options.message,\n      });\n      try {\n        await appendHistoryEntry(subject.historyPath, historyEntry);\n      } catch (error: unknown) {\n        await restorePreviousItemAfterHistoryFailure({\n          existingItemPath,\n          resolvedOriginalRaw: currentState.originalRaw,\n          restoredItemPath,\n        });\n        throw error;\n      }\n      derivedIndexWarnings = await refreshItemMetadataDerivedIndex({\n        pmRoot,\n        preferredFormat: settings.item_format,\n        typeToFolder: typeRegistry.type_to_folder,\n        schema: settings.schema,\n        itemPath: restoredItemPath,\n        previousItemPath: existingItemPath ?? undefined,\n        document: restoredDocument,\n      });\n    } finally {\n      await releaseDerivedIndexLock();\n    }\n    const restoreChangedFields = changedFields(\n      currentState.document,\n      restoredDocument,\n    );\n    const hookWarnings = await runRestoreWriteHooks({\n      restoredItemPath,\n      historyPath: subject.historyPath,\n      before: currentState.document,\n      after: restoredDocument,\n    });\n    recordAfterCommandAffectedItem({\n      id: restoredDocument.metadata.id,\n      op: \"restore\",\n      item_type: restoredDocument.metadata.type,\n      previous_status: currentState.document.metadata.status,\n      status: restoredDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(\n        currentState.document.metadata,\n        restoreChangedFields,\n      ),\n      current: projectAfterCommandItemSnapshot(\n        restoredDocument.metadata,\n        restoreChangedFields,\n      ),\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: [\n        ...subject.historyPolicyWarnings,\n        ...ownershipWarnings,\n        ...derivedIndexWarnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\n/** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-AF2CCM5U.js → chunk-XKRVX4B3.js}

@@ -1,6 +1,6 @@
 import {
   collectBlockedByIds
-} from "./chunk-TVYYO5A7.js";
+} from "./chunk-MBHYQYCS.js";
 import {
   buildItemNotFoundError,
   isTerminalStatus,
@@ -10,7 +10,7 @@ import {
   readLocatedItem,
   readSettings,
   toItemRecord
-} from "./chunk-IY6VZ3IW.js";
+} from "./chunk-5FAG2JUC.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -19,7 +19,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/cli/commands/close.js
 !(function() {
@@ -463,4 +463,4 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-AF2CCM5U.js.map
+//# sourceMappingURL=chunk-XKRVX4B3.js.map

package/dist/cli-bundle/chunks/{chunk-JGUKMMRS.js → chunk-XN4NQZJK.js}

@@ -7,14 +7,14 @@ import {
   deleteItem,
   readSettings,
   toItemRecord
-} from "./chunk-POG76WWZ.js";
+} from "./chunk-L7DZV6EZ.js";
 import {
   EXIT_CODE,
   PmCliError,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/cli/commands/delete.js
 import path from "node:path";
@@ -47,6 +47,6 @@ async function runDelete(id, options, global) {
 export {
   runDelete
 };
-//# sourceMappingURL=chunk-JGUKMMRS.js.map
+//# sourceMappingURL=chunk-XN4NQZJK.js.map
 
 //# debugId=d8843f20-911c-538e-bf11-1dfb1c189304

package/dist/cli-bundle/chunks/{chunk-3P7UJQOX.js → chunk-YKFMLQNK.js}

@@ -1,6 +1,6 @@
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/core/governance/metadata-coverage.js
 !(function() {
@@ -262,4 +262,4 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-3P7UJQOX.js.map
+//# sourceMappingURL=chunk-YKFMLQNK.js.map

package/dist/cli-bundle/chunks/{chunk-YCIUJJOD.js → chunk-YKWKMGL7.js}

@@ -1,7 +1,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/core/item/parse.js
 !(function() {
@@ -412,4 +412,4 @@ export {
   parseOptionalNumber,
   parseOptionalNonNegativeInteger
 };
-//# sourceMappingURL=chunk-YCIUJJOD.js.map
+//# sourceMappingURL=chunk-YKWKMGL7.js.map

package/dist/cli-bundle/chunks/{chunk-TOBGV45Y.js → chunk-YUKIFPWK.js}

@@ -3,7 +3,7 @@
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   toDefaultFolder
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/core/schema/item-types-file.js
 var BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
@@ -258,6 +258,6 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-TOBGV45Y.js.map
+//# sourceMappingURL=chunk-YUKIFPWK.js.map
 
 //# debugId=a810fa9a-5882-5c6c-a0e8-52338dae3ad9

package/dist/cli-bundle/chunks/{chunk-72LQ4TKV.js → chunk-YYEZEP3E.js}

@@ -1,13 +1,13 @@
 import {
   nowIso
-} from "./chunk-IY6VZ3IW.js";
+} from "./chunk-5FAG2JUC.js";
 import {
   EXIT_CODE,
   PmCliError,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -135,4 +135,4 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-72LQ4TKV.js.map
+//# sourceMappingURL=chunk-YYEZEP3E.js.map

package/dist/cli-bundle/chunks/{chunk-X3W65QK3.js → chunk-ZEY3XSZQ.js}

@@ -1,10 +1,10 @@
 import {
   createStdinTokenResolver,
   parseCsvKv
-} from "./chunk-YCIUJJOD.js";
+} from "./chunk-YKWKMGL7.js";
 import {
   parseLimit
-} from "./chunk-UVN66B3M.js";
+} from "./chunk-Q3Z2Y5WJ.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -15,7 +15,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-IY6VZ3IW.js";
+} from "./chunk-5FAG2JUC.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -23,7 +23,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-7AVEY74G.js";
+} from "./chunk-VTOCZ343.js";
 
 // dist/sdk/annotations.js
 import { readFile } from "node:fs/promises";
@@ -328,4 +328,4 @@ export {
   runAnnotationCommand,
   resolveAnnotationIndex
 };
-//# sourceMappingURL=chunk-X3W65QK3.js.map
+//# sourceMappingURL=chunk-ZEY3XSZQ.js.map

package/dist/cli-bundle/chunks/{chunk-MWQ2HC2A.js → chunk-ZKOQHLJP.js}

@@ -1,31 +1,33 @@
 
-!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]="6ddf4107-908d-5eae-b775-abc852c08596")}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]="073a78a9-691f-5f08-b71e-b1e15fac22fa")}catch(e){}}();
 import {
   assertParentReferenceIsNotSelf,
   isPlaceholderReferenceToken,
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-PEQGTJ5Q.js";
+} from "./chunk-JCLXCGIL.js";
 import {
   collectOrderingCycles
 } from "./chunk-H7EAER5L.js";
 import {
   printError
-} from "./chunk-VJQG4BIM.js";
+} from "./chunk-DSFTAQ7T.js";
 import {
   getFocusedItem
-} from "./chunk-ZOY5K4D3.js";
+} from "./chunk-3PWJWLLQ.js";
 import {
   normalizeDependencyGraphTarget,
+  normalizeDependencySeedId,
+  normalizeDependencySourceKind,
   resolveWorkspaceRelationshipKindRegistry
-} from "./chunk-K36WV5J6.js";
+} from "./chunk-B7O44UBR.js";
 import {
   splitCommaList
 } from "./chunk-NETP4DY4.js";
 import {
   buildInvalidTypeError
-} from "./chunk-TOBGV45Y.js";
+} from "./chunk-YUKIFPWK.js";
 import {
   assertNoUnknownCsvKeys,
   createStdinTokenResolver,
@@ -35,8 +37,9 @@ import {
   parseOptionalNonNegativeInteger,
   parseOptionalNumber,
   parseTags
-} from "./chunk-AELMUANP.js";
+} from "./chunk-DVB6SQU7.js";
 import {
+  acquireItemMetadataDerivedIndexLock,
   acquireLock,
   appendHistoryEntry,
   canonicalDocument,
@@ -53,11 +56,12 @@ import {
   projectAfterCommandItemSnapshot,
   readSettings,
   recordAfterCommandAffectedItem,
+  refreshItemMetadataDerivedIndex,
   resolveIsoOrRelative,
   runActiveCommandHandler,
   runActiveOnWriteHooks,
   serializeItemDocument
-} from "./chunk-POG76WWZ.js";
+} from "./chunk-L7DZV6EZ.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   CREATE_DIRECT_CLOSE_REASON_DEFAULT,
@@ -92,7 +96,7 @@ import {
   validateTypeOptions,
   weekdayOrderIndex,
   writeFileAtomic
-} from "./chunk-HYW67VJ5.js";
+} from "./chunk-TLF52ZDP.js";
 
 // dist/core/item/priority.js
 var PRIORITY_NAME_TO_VALUE = {
@@ -1644,7 +1648,14 @@ function parseCreateUnsetTargets(raw, runtimeFieldRegistry) {
     resolveDefinition: (trimmed) => CREATE_UNSET_ALIAS_MAP.get(trimmed) ?? resolveRuntimeUnsetFieldDefinition(trimmed, "create", runtimeFieldRegistry)
   });
 }
-var DEP_SEED_KEYS = ["id", "kind", "type", "author", "created_at"];
+var DEP_SEED_KEYS = [
+  "id",
+  "kind",
+  "type",
+  "author",
+  "created_at",
+  "source_kind"
+];
 var LINKED_ARTIFACT_SEED_KEYS = ["path", "scope", "note"];
 function parseDependencies(raw, nowValue, prefix) {
   if (!raw || raw.length === 0)
@@ -1666,11 +1677,13 @@ function parseDependencies(raw, nowValue, prefix) {
     if (id.trim().toLowerCase() === "undefined") {
       throw new PmCliError(`--dep id must not use placeholder token "${id}". Use --clear-deps to clear dependencies.`, EXIT_CODE.USAGE);
     }
+    const sourceKind = normalizeDependencySourceKind(parseOptionalString(kv.source_kind));
     return {
-      id: normalizeItemId(id, prefix),
+      id: normalizeDependencySeedId(id, prefix, sourceKind),
       kind: ensureEnumValue(kind, DEPENDENCY_KIND_VALUES, "dependency kind"),
       created_at: parseCreatedAt(kv.created_at, nowValue),
-      author: parseOptionalString(kv.author)
+      author: parseOptionalString(kv.author),
+      source_kind: sourceKind
     };
   });
   return { values, explicitEmpty: false };
@@ -2739,27 +2752,42 @@ async function writeCreatedItem(params) {
     if (existing) {
       throw new PmCliError(`Item "${id}" already exists`, EXIT_CODE.CONFLICT);
     }
-    await writeFileAtomic(itemPath, serializeItemDocument(afterDocument, {
-      format: settings.item_format,
-      schema: settings.schema,
-      extensionFieldNames
-    }));
+    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(pmRoot, author);
+    let derivedIndexWarnings = [];
     try {
-      const entry = createHistoryEntry({
-        nowIso: nowValue,
-        author,
-        op: "create",
-        before: beforeDocument,
-        after: afterDocument,
-        message: historyMessage
+      await writeFileAtomic(itemPath, serializeItemDocument(afterDocument, {
+        format: settings.item_format,
+        schema: settings.schema,
+        extensionFieldNames
+      }));
+      try {
+        const entry = createHistoryEntry({
+          nowIso: nowValue,
+          author,
+          op: "create",
+          before: beforeDocument,
+          after: afterDocument,
+          message: historyMessage
+        });
+        await appendHistoryEntry(historyPath, entry);
+      } catch (error) {
+        await removeFileIfExists(itemPath);
+        throw error;
+      }
+      derivedIndexWarnings = await refreshItemMetadataDerivedIndex({
+        pmRoot,
+        preferredFormat: settings.item_format,
+        typeToFolder: typeRegistry.type_to_folder,
+        schema: settings.schema,
+        itemPath,
+        document: afterDocument
       });
-      await appendHistoryEntry(historyPath, entry);
-    } catch (error) {
-      await removeFileIfExists(itemPath);
-      throw error;
+    } finally {
+      await releaseDerivedIndexLock();
     }
     hookWarnings = [
       ...graphBeforeCreate ? collectNewOrderingCycleWarnings(graphBeforeCreate, [...graphBeforeCreate, afterDocument.metadata], id) : [],
+      ...derivedIndexWarnings,
       ...await runActiveOnWriteHooks({
         path: itemPath,
         scope: "project",
@@ -3034,10 +3062,7 @@ async function runCreate(options, global) {
   return {
     item: outputItem,
     changed_fields: changedFields,
-    warnings: [
-      ...validationWarnings,
-      ...hookWarnings
-    ],
+    warnings: [...validationWarnings, ...hookWarnings],
     ...parentSource !== void 0 ? { parent_source: parentSource } : {},
     ...nextTransition !== void 0 ? { next_transition: nextTransition } : {}
   };
@@ -3110,6 +3135,6 @@ export {
   runCreate,
   _testOnlyCreateCommand
 };
-//# sourceMappingURL=chunk-MWQ2HC2A.js.map
+//# sourceMappingURL=chunk-ZKOQHLJP.js.map
 
-//# debugId=6ddf4107-908d-5eae-b775-abc852c08596
+//# debugId=073a78a9-691f-5f08-b71e-b1e15fac22fa