@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/cli/commands/copy.js

@@ -4,7 +4,7 @@
  * Implements the pm copy command surface and its agent-facing runtime behavior.
  */
 
-!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]="deccf6ff-b472-5c49-bd10-165086192cb2")}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]="5e51abfc-3eb4-5e01-a103-d2e236d6e68f")}catch(e){}}();
 import { pathExists, removeFileIfExists, writeFileAtomic, } from "../../core/fs/fs-utils.js";
 import { appendHistoryEntry, createHistoryEntry, } from "../../core/history/history.js";
 import { generateItemId } from "../../core/item/id.js";
@@ -18,6 +18,7 @@ import { nowIso } from "../../core/shared/time.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { buildItemNotFoundError, locateItem, readLocatedItem, } from "../../core/store/item-store.js";
+import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../../sdk/item-metadata-index.js";
 import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 function selectAuthor(explicitAuthor, settingsAuthor) {
@@ -96,27 +97,42 @@ export async function runCopy(sourceId, options, global) {
         metadata: {},
         body: "",
     };
-    let hookWarnings = [];
+    let hookWarnings;
+    let derivedIndexWarnings;
     try {
-        await writeFileAtomic(itemPath, serializeItemDocument(copiedDocument, {
-            format: settings.item_format,
-            schema: settings.schema,
-            extensionFieldNames,
-        }));
+        const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(pmRoot, author);
         try {
-            const historyEntry = createHistoryEntry({
-                nowIso: copiedAt,
-                author,
-                op: "create",
-                before: beforeDocument,
-                after: copiedDocument,
-                message: buildCopyMessage(located.id, options.message),
+            await writeFileAtomic(itemPath, serializeItemDocument(copiedDocument, {
+                format: settings.item_format,
+                schema: settings.schema,
+                extensionFieldNames,
+            }));
+            try {
+                const historyEntry = createHistoryEntry({
+                    nowIso: copiedAt,
+                    author,
+                    op: "create",
+                    before: beforeDocument,
+                    after: copiedDocument,
+                    message: buildCopyMessage(located.id, options.message),
+                });
+                await appendHistoryEntry(historyPath, historyEntry);
+            }
+            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: copiedDocument,
             });
-            await appendHistoryEntry(historyPath, historyEntry);
         }
-        catch (error) {
-            await removeFileIfExists(itemPath);
-            throw error;
+        finally {
+            await releaseDerivedIndexLock();
         }
         hookWarnings = [
             ...(await runActiveOnWriteHooks({
@@ -156,8 +172,8 @@ export async function runCopy(sourceId, options, global) {
         source_id: located.id,
         item: structuredClone(copiedDocument.metadata),
         changed_fields: changedFields,
-        warnings: hookWarnings,
+        warnings: [...derivedIndexWarnings, ...hookWarnings],
     };
 }
 //# sourceMappingURL=copy.js.map
-//# debugId=deccf6ff-b472-5c49-bd10-165086192cb2
+//# debugId=5e51abfc-3eb4-5e01-a103-d2e236d6e68f

package/dist/cli/commands/copy.js.map

@@ -1 +1 @@
-{"version":3,"file":"copy.js","sources":["cli/commands/copy.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/copy\n *\n * Implements the pm copy command surface and its agent-facing runtime behavior.\n */\nimport {\n  pathExists,\n  removeFileIfExists,\n  writeFileAtomic,\n} from \"../../core/fs/fs-utils.js\";\nimport {\n  appendHistoryEntry,\n  createHistoryEntry,\n} from \"../../core/history/history.js\";\nimport { generateItemId } from \"../../core/item/id.js\";\nimport {\n  canonicalDocument,\n  serializeItemDocument,\n} from \"../../core/item/item-format.js\";\nimport { acquireLock } from \"../../core/lock/lock.js\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { collectRegisteredItemFieldNames } from \"../../core/extensions/item-fields.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport {\n  EXIT_CODE,\n  ITEM_METADATA_KEY_ORDER,\n} from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport {\n  buildItemNotFoundError,\n  locateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport {\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  resolvePmRoot,\n} from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemDocument, ItemMetadata } from \"../../types/index.js\";\n\n/** Documents the copy options payload exchanged by command, SDK, and package integrations. */\nexport interface CopyOptions {\n  /** Value that configures or reports title for this contract. */\n  title?: string;\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}\n\n/** Documents the copy result payload exchanged by command, SDK, and package integrations. */\nexport interface CopyResult {\n  /** Value that configures or reports source id for this contract. */\n  source_id: string;\n  /** Value that configures or reports item for this contract. */\n  item: ItemMetadata;\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\nfunction selectAuthor(\n  explicitAuthor: string | undefined,\n  settingsAuthor: string,\n): string {\n  const candidate = explicitAuthor ?? process.env.PM_AUTHOR ?? settingsAuthor;\n  const trimmed = candidate.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\nfunction buildChangedFields(itemMetadata: ItemMetadata, body: string): string[] {\n  const changed = [\n    ...new Set([\n      ...ITEM_METADATA_KEY_ORDER.filter((key) => itemMetadata[key] !== undefined),\n      ...Object.keys(itemMetadata).filter(\n        (key) => itemMetadata[key] !== undefined,\n      ),\n      ...(body.length > 0 ? [\"body\"] : []),\n    ]),\n  ];\n  return changed.sort((left, right) => left.localeCompare(right));\n}\n\nfunction buildCopyMessage(\n  sourceId: string,\n  message: string | undefined,\n): string {\n  const suffix = `copied_from=${sourceId}`;\n  if (!message) {\n    return suffix;\n  }\n  const trimmed = message.trim();\n  return trimmed.length > 0 ? `${trimmed} | ${suffix}` : suffix;\n}\n\n/** Implements run copy for the public runtime surface of this module. */\nexport async function runCopy(\n  sourceId: string,\n  options: CopyOptions,\n  global: GlobalOptions,\n): Promise<CopyResult> {\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 located = await locateItem(\n    pmRoot,\n    sourceId,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      pmRoot,\n      sourceId,\n      settings.id_prefix,\n      typeRegistry.type_to_folder,\n    );\n  }\n  const sourceLoaded = await readLocatedItem(located, {\n    schema: settings.schema,\n  });\n  const sourceMetadata = sourceLoaded.document.metadata;\n  const copiedAt = nowIso();\n  const author = selectAuthor(options.author, settings.author_default);\n  const newId = await generateItemId(pmRoot, settings.id_prefix, {\n    tokenLength: settings.ids.token_length,\n  });\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const titleOverride = options.title?.trim();\n  if (titleOverride !== undefined && titleOverride.length === 0) {\n    throw new PmCliError(\"Copy --title must not be empty\", EXIT_CODE.USAGE);\n  }\n\n  const copiedMetadata: ItemMetadata = {\n    ...(sourceMetadata as Record<string, unknown>),\n    id: newId,\n    title: titleOverride ?? sourceMetadata.title,\n    status: statusRegistry.open_status,\n    created_at: copiedAt,\n    updated_at: copiedAt,\n  } as ItemMetadata;\n  delete copiedMetadata.closed_at;\n  delete copiedMetadata.close_reason;\n  delete copiedMetadata.test_runs;\n\n  const extensionFieldNames = collectRegisteredItemFieldNames(\n    getActiveExtensionRegistrations(),\n  );\n  const copiedDocument = canonicalDocument(\n    {\n      metadata: copiedMetadata,\n      body: sourceLoaded.document.body,\n    },\n    {\n      schema: settings.schema,\n      extensionFieldNames,\n    },\n  );\n  const changedFields = buildChangedFields(\n    copiedDocument.metadata,\n    copiedDocument.body,\n  );\n  const itemPath = getItemPath(\n    pmRoot,\n    copiedDocument.metadata.type,\n    newId,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  const historyPath = getHistoryPath(pmRoot, newId);\n  const lockRelease = await acquireLock(\n    pmRoot,\n    newId,\n    settings.locks.ttl_seconds,\n    author,\n    false,\n    settings.governance.force_required_for_stale_lock,\n    settings.locks.wait_ms,\n  );\n  const beforeDocument: ItemDocument = {\n    metadata: {} as ItemMetadata,\n    body: \"\",\n  };\n\n  let hookWarnings: string[] = [];\n  try {\n    await writeFileAtomic(\n      itemPath,\n      serializeItemDocument(copiedDocument, {\n        format: settings.item_format,\n        schema: settings.schema,\n        extensionFieldNames,\n      }),\n    );\n    try {\n      const historyEntry = createHistoryEntry({\n        nowIso: copiedAt,\n        author,\n        op: \"create\",\n        before: beforeDocument,\n        after: copiedDocument,\n        message: buildCopyMessage(located.id, options.message),\n      });\n      await appendHistoryEntry(historyPath, historyEntry);\n    } catch (error: unknown) {\n      await removeFileIfExists(itemPath);\n      throw error;\n    }\n\n    hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: itemPath,\n        scope: \"project\",\n        op: \"create\",\n        item_id: copiedDocument.metadata.id,\n        item_type: copiedDocument.metadata.type,\n        before: beforeDocument,\n        after: copiedDocument,\n        changed_fields: changedFields,\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: \"create:history\",\n        item_id: copiedDocument.metadata.id,\n        item_type: copiedDocument.metadata.type,\n        before: beforeDocument,\n        after: copiedDocument,\n        changed_fields: changedFields,\n      })),\n    ];\n    recordAfterCommandAffectedItem({\n      id: copiedDocument.metadata.id,\n      op: \"create\",\n      item_type: copiedDocument.metadata.type,\n      status: copiedDocument.metadata.status,\n      current: projectAfterCommandItemSnapshot(\n        copiedDocument.metadata,\n        changedFields,\n      ),\n      changed_fields: changedFields,\n    });\n  } finally {\n    await lockRelease();\n  }\n\n  return {\n    source_id: located.id,\n    item: structuredClone(copiedDocument.metadata),\n    changed_fields: changedFields,\n    warnings: hookWarnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"deccf6ff-b472-5c49-bd10-165086192cb2"}
+{"version":3,"file":"copy.js","sources":["cli/commands/copy.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/copy\n *\n * Implements the pm copy command surface and its agent-facing runtime behavior.\n */\nimport {\n  pathExists,\n  removeFileIfExists,\n  writeFileAtomic,\n} from \"../../core/fs/fs-utils.js\";\nimport {\n  appendHistoryEntry,\n  createHistoryEntry,\n} from \"../../core/history/history.js\";\nimport { generateItemId } from \"../../core/item/id.js\";\nimport {\n  canonicalDocument,\n  serializeItemDocument,\n} from \"../../core/item/item-format.js\";\nimport { acquireLock } from \"../../core/lock/lock.js\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { collectRegisteredItemFieldNames } from \"../../core/extensions/item-fields.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport {\n  EXIT_CODE,\n  ITEM_METADATA_KEY_ORDER,\n} from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport {\n  buildItemNotFoundError,\n  locateItem,\n  readLocatedItem,\n} 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 type { ItemDocument, ItemMetadata } from \"../../types/index.js\";\n\n/** Documents the copy options payload exchanged by command, SDK, and package integrations. */\nexport interface CopyOptions {\n  /** Value that configures or reports title for this contract. */\n  title?: string;\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}\n\n/** Documents the copy result payload exchanged by command, SDK, and package integrations. */\nexport interface CopyResult {\n  /** Value that configures or reports source id for this contract. */\n  source_id: string;\n  /** Value that configures or reports item for this contract. */\n  item: ItemMetadata;\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\nfunction selectAuthor(\n  explicitAuthor: string | undefined,\n  settingsAuthor: string,\n): string {\n  const candidate = explicitAuthor ?? process.env.PM_AUTHOR ?? settingsAuthor;\n  const trimmed = candidate.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\nfunction buildChangedFields(\n  itemMetadata: ItemMetadata,\n  body: string,\n): string[] {\n  const changed = [\n    ...new Set([\n      ...ITEM_METADATA_KEY_ORDER.filter(\n        (key) => itemMetadata[key] !== undefined,\n      ),\n      ...Object.keys(itemMetadata).filter(\n        (key) => itemMetadata[key] !== undefined,\n      ),\n      ...(body.length > 0 ? [\"body\"] : []),\n    ]),\n  ];\n  return changed.sort((left, right) => left.localeCompare(right));\n}\n\nfunction buildCopyMessage(\n  sourceId: string,\n  message: string | undefined,\n): string {\n  const suffix = `copied_from=${sourceId}`;\n  if (!message) {\n    return suffix;\n  }\n  const trimmed = message.trim();\n  return trimmed.length > 0 ? `${trimmed} | ${suffix}` : suffix;\n}\n\n/** Implements run copy for the public runtime surface of this module. */\nexport async function runCopy(\n  sourceId: string,\n  options: CopyOptions,\n  global: GlobalOptions,\n): Promise<CopyResult> {\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 located = await locateItem(\n    pmRoot,\n    sourceId,\n    settings.id_prefix,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      pmRoot,\n      sourceId,\n      settings.id_prefix,\n      typeRegistry.type_to_folder,\n    );\n  }\n  const sourceLoaded = await readLocatedItem(located, {\n    schema: settings.schema,\n  });\n  const sourceMetadata = sourceLoaded.document.metadata;\n  const copiedAt = nowIso();\n  const author = selectAuthor(options.author, settings.author_default);\n  const newId = await generateItemId(pmRoot, settings.id_prefix, {\n    tokenLength: settings.ids.token_length,\n  });\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const titleOverride = options.title?.trim();\n  if (titleOverride !== undefined && titleOverride.length === 0) {\n    throw new PmCliError(\"Copy --title must not be empty\", EXIT_CODE.USAGE);\n  }\n\n  const copiedMetadata: ItemMetadata = {\n    ...(sourceMetadata as Record<string, unknown>),\n    id: newId,\n    title: titleOverride ?? sourceMetadata.title,\n    status: statusRegistry.open_status,\n    created_at: copiedAt,\n    updated_at: copiedAt,\n  } as ItemMetadata;\n  delete copiedMetadata.closed_at;\n  delete copiedMetadata.close_reason;\n  delete copiedMetadata.test_runs;\n\n  const extensionFieldNames = collectRegisteredItemFieldNames(\n    getActiveExtensionRegistrations(),\n  );\n  const copiedDocument = canonicalDocument(\n    {\n      metadata: copiedMetadata,\n      body: sourceLoaded.document.body,\n    },\n    {\n      schema: settings.schema,\n      extensionFieldNames,\n    },\n  );\n  const changedFields = buildChangedFields(\n    copiedDocument.metadata,\n    copiedDocument.body,\n  );\n  const itemPath = getItemPath(\n    pmRoot,\n    copiedDocument.metadata.type,\n    newId,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n  );\n  const historyPath = getHistoryPath(pmRoot, newId);\n  const lockRelease = await acquireLock(\n    pmRoot,\n    newId,\n    settings.locks.ttl_seconds,\n    author,\n    false,\n    settings.governance.force_required_for_stale_lock,\n    settings.locks.wait_ms,\n  );\n  const beforeDocument: ItemDocument = {\n    metadata: {} as ItemMetadata,\n    body: \"\",\n  };\n\n  let hookWarnings: string[];\n  let derivedIndexWarnings: string[];\n  try {\n    const releaseDerivedIndexLock = await acquireItemMetadataDerivedIndexLock(\n      pmRoot,\n      author,\n    );\n    try {\n      await writeFileAtomic(\n        itemPath,\n        serializeItemDocument(copiedDocument, {\n          format: settings.item_format,\n          schema: settings.schema,\n          extensionFieldNames,\n        }),\n      );\n      try {\n        const historyEntry = createHistoryEntry({\n          nowIso: copiedAt,\n          author,\n          op: \"create\",\n          before: beforeDocument,\n          after: copiedDocument,\n          message: buildCopyMessage(located.id, options.message),\n        });\n        await appendHistoryEntry(historyPath, historyEntry);\n      } catch (error: unknown) {\n        await removeFileIfExists(itemPath);\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,\n        document: copiedDocument,\n      });\n    } finally {\n      await releaseDerivedIndexLock();\n    }\n\n    hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: itemPath,\n        scope: \"project\",\n        op: \"create\",\n        item_id: copiedDocument.metadata.id,\n        item_type: copiedDocument.metadata.type,\n        before: beforeDocument,\n        after: copiedDocument,\n        changed_fields: changedFields,\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: \"create:history\",\n        item_id: copiedDocument.metadata.id,\n        item_type: copiedDocument.metadata.type,\n        before: beforeDocument,\n        after: copiedDocument,\n        changed_fields: changedFields,\n      })),\n    ];\n    recordAfterCommandAffectedItem({\n      id: copiedDocument.metadata.id,\n      op: \"create\",\n      item_type: copiedDocument.metadata.type,\n      status: copiedDocument.metadata.status,\n      current: projectAfterCommandItemSnapshot(\n        copiedDocument.metadata,\n        changedFields,\n      ),\n      changed_fields: changedFields,\n    });\n  } finally {\n    await lockRelease();\n  }\n\n  return {\n    source_id: located.id,\n    item: structuredClone(copiedDocument.metadata),\n    changed_fields: changedFields,\n    warnings: [...derivedIndexWarnings, ...hookWarnings],\n  };\n}\n"],"names":[],"mappings":"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","debugId":"5e51abfc-3eb4-5e01-a103-d2e236d6e68f"}

package/dist/cli/commands/create.js

@@ -4,7 +4,7 @@
  * Implements the pm create command surface and its agent-facing runtime behavior.
  */
 
-!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]="f09f0dc4-6701-57b5-ac68-1c676b63e93d")}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]="dd41d74c-1e7a-5543-bf68-ec1a7f490e0e")}catch(e){}}();
 import { pathExists, removeFileIfExists, writeFileAtomic, } from "../../core/fs/fs-utils.js";
 import { appendHistoryEntry, createHistoryEntry, } from "../../core/history/history.js";
 import { generateItemId, normalizeItemId } from "../../core/item/id.js";
@@ -29,6 +29,7 @@ import { nowIso, resolveIsoOrRelative } from "../../core/shared/time.js";
 import { getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveOnWriteHooks, } from "../../core/extensions/index.js";
 import { collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, } from "../../core/extensions/item-fields.js";
 import { listAllItemMetadataLight, locateItem, } from "../../core/store/item-store.js";
+import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../../sdk/item-metadata-index.js";
 import { collectNewOrderingCycleWarnings } from "../../sdk/graph/mutation-advisory.js";
 import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
@@ -40,6 +41,7 @@ import { looksLikeStructuredLinkedTestEntry, normalizeStructuredLinkedTestEntry,
 import { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR, parseCommandUnsetTargets, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
 import { ensureEnumValue } from "./recurrence-parsers.js";
 import { assertValidBareDependencyFlagValue } from "../../sdk/dependency-flag-validation.js";
+import { normalizeDependencySeedId, normalizeDependencySourceKind, } from "../../sdk/dependency-provenance.js";
 import { parseEventEntries, parseReminderEntries, parseTypeOptionEntries, } from "./repeatable-metadata-parsers.js";
 import { DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, SCOPE_VALUES, } from "../../types/index.js";
 const CREATE_MODE_VALUES = ["strict", "progressive"];
@@ -164,7 +166,14 @@ function parseCreateUnsetTargets(raw, runtimeFieldRegistry) {
     });
 }
 /** Allowed CSV/markdown keys for the create `--dep` seed (GH-258). */
-const DEP_SEED_KEYS = ["id", "kind", "type", "author", "created_at"];
+const DEP_SEED_KEYS = [
+    "id",
+    "kind",
+    "type",
+    "author",
+    "created_at",
+    "source_kind",
+];
 /** Allowed CSV/markdown keys for create `--file`/`--doc` seeds (GH-258). */
 const LINKED_ARTIFACT_SEED_KEYS = ["path", "scope", "note"];
 function parseDependencies(raw, nowValue, prefix) {
@@ -189,11 +198,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),
+            source_kind: sourceKind,
         };
     });
     return { values, explicitEmpty: false };
@@ -1428,30 +1439,46 @@ 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",
@@ -1757,10 +1784,7 @@ export async function runCreate(options, global) {
     return {
         item: outputItem,
         changed_fields: changedFields,
-        warnings: [
-            ...validationWarnings,
-            ...hookWarnings,
-        ],
+        warnings: [...validationWarnings, ...hookWarnings],
         ...(parentSource !== undefined ? { parent_source: parentSource } : {}),
         ...(nextTransition !== undefined
             ? { next_transition: nextTransition }
@@ -1791,4 +1815,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=f09f0dc4-6701-57b5-ac68-1c676b63e93d
+//# debugId=dd41d74c-1e7a-5543-bf68-ec1a7f490e0e