@unbrained/pm-cli 2026.7.18 → 2026.7.19

package/dist/core/store/item-store.d.ts

@@ -57,7 +57,10 @@ export declare function mutateItem(params: {
     mutate: (document: ItemDocument) => {
         changedFields: string[];
         warnings?: string[];
-    };
+    } | Promise<{
+        changedFields: string[];
+        warnings?: string[];
+    }>;
 }): Promise<{
     item: ItemMetadata;
     body: string;

package/dist/core/store/item-store.js

@@ -4,7 +4,7 @@
  * Reads and writes tracker storage with format-aware helpers for Item Store.
  */
 
-!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]="17b9e6b4-3761-534e-8e93-c488016914e0")}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]="0e2102ef-7489-53f5-b639-1e3d582eaf63")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveOnReadHooks, runActiveOnWriteHooks, runActiveServiceOverride, } from "../extensions/index.js";
@@ -290,7 +290,7 @@ export async function mutateItem(params) {
             schema: params.settings.schema,
             extensionFieldNames: params.extensionFieldNames,
         });
-        const mutation = params.mutate(mutableDocument);
+        const mutation = await params.mutate(mutableDocument);
         if (params.skipNoop === true && mutation.changedFields.length === 0) {
             return {
                 item: beforeDocument.metadata,
@@ -537,4 +537,4 @@ export async function deleteItem(params) {
     }
 }
 //# sourceMappingURL=item-store.js.map
-//# debugId=17b9e6b4-3761-534e-8e93-c488016914e0
+//# debugId=0e2102ef-7489-53f5-b639-1e3d582eaf63

package/dist/core/store/item-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-store.js","sources":["core/store/item-store.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/store/item-store\n *\n * Reads and writes tracker storage with format-aware helpers for Item Store.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runActiveServiceOverride,\n} from \"../extensions/index.js\";\nimport { collectRegisteredItemFieldNames } from \"../extensions/item-fields.js\";\nimport {\n  EMPTY_CANONICAL_DOCUMENT,\n  EXIT_CODE,\n  TYPE_TO_FOLDER,\n} from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { levenshteinDistanceWithinLimit } from \"../shared/levenshtein.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../history/history.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../history/history-stream-policy.js\";\nimport {\n  canonicalDocument,\n  parseItemDocument,\n  serializeItemDocument,\n} from \"../item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../item/id.js\";\nimport {\n  listAllDocumentCandidatesCached,\n  listAllDocumentsCached,\n  listAllDocumentsCachedLight,\n} from \"./item-metadata-cache.js\";\nimport {\n  getHistoryPath,\n  getItemFormatFromPath,\n  getItemPath,\n  ITEM_FILE_EXTENSIONS,\n} from \"./paths.js\";\nimport { resolveGovernanceKnobs } from \"./settings.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type {\n  ItemDocument,\n  ItemFormat,\n  ItemMetadata,\n  ItemType,\n  PmSettings,\n  RuntimeSchemaSettings,\n} from \"../../types/index.js\";\n\n/** Documents the located item payload exchanged by command, SDK, and package integrations. */\nexport interface LocatedItem {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type: ItemType;\n  /** Filesystem path used for item resolution. */\n  itemPath: string;\n  /** Value that configures or reports item format for this contract. */\n  item_format: ItemFormat;\n}\n\nasync function fileExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === code\n  );\n}\n\nfunction appendWarning(warnings: string[] | undefined, warning: string): void {\n  if (!warnings) {\n    return;\n  }\n  if (!warnings.includes(warning)) {\n    warnings.push(warning);\n  }\n}\n\nfunction resolveActiveExtensionFieldNames(\n  explicit: readonly string[] | undefined,\n): readonly string[] {\n  return (\n    explicit ??\n    collectRegisteredItemFieldNames(getActiveExtensionRegistrations())\n  );\n}\n\nfunction resolveItemFormatSearchOrder(\n  preferredFormat?: ItemFormat,\n): ItemFormat[] {\n  if (preferredFormat === \"toon\") {\n    return [\"toon\", \"json_markdown\"];\n  }\n  if (preferredFormat === \"json_markdown\") {\n    return [\"json_markdown\", \"toon\"];\n  }\n  return [\"toon\", \"json_markdown\"];\n}\n\n/** Implements locate item for the public runtime surface of this module. */\nexport async function locateItem(\n  pmRoot: string,\n  rawId: string,\n  idPrefix = \"pm-\",\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): Promise<LocatedItem | null> {\n  const normalizedId = normalizeItemId(rawId, idPrefix);\n  const rawNormalizedId = normalizeRawItemId(rawId);\n  const candidateIds =\n    normalizedId === rawNormalizedId\n      ? [normalizedId]\n      : [normalizedId, rawNormalizedId];\n  const entries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n  const searchOrder = resolveItemFormatSearchOrder(preferredFormat);\n  for (const candidateId of candidateIds) {\n    for (const [type] of entries) {\n      for (const itemFormat of searchOrder) {\n        const itemPath = getItemPath(\n          pmRoot,\n          type,\n          candidateId,\n          itemFormat,\n          typeToFolder,\n        );\n        if (await fileExists(itemPath)) {\n          return {\n            id: candidateId,\n            type,\n            itemPath,\n            item_format: itemFormat,\n          };\n        }\n      }\n    }\n  }\n  return null;\n}\n\n/** Implements read located item for the public runtime surface of this module. */\nexport async function readLocatedItem(\n  item: LocatedItem,\n  options: {\n    schema?: RuntimeSchemaSettings;\n    extensionFieldNames?: readonly string[];\n    warnings?: string[];\n  } = {},\n): Promise<{ raw: string; document: ItemDocument }> {\n  const raw = await fs.readFile(item.itemPath, \"utf8\");\n  await runActiveOnReadHooks({\n    path: item.itemPath,\n    scope: \"project\",\n  });\n  const document = parseItemDocument(raw, {\n    format: item.item_format,\n    schema: options.schema,\n    extensionFieldNames: resolveActiveExtensionFieldNames(\n      options.extensionFieldNames,\n    ),\n    onWarning: (warning) => appendWarning(options.warnings, warning),\n  });\n  return { raw, document };\n}\n\n/** Implements list all item metadata for the public runtime surface of this module. */\nexport async function listAllItemMetadata(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemMetadata[]> {\n  const documents = await listAllDocumentsCached(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n  );\n  return documents.map((document) => document.metadata);\n}\n\n/**\n * Light variant of {@link listAllItemMetadata}: returns item-metadata WITHOUT the heavy\n * collection fields (comments/notes/learnings/files/tests/test_runs/docs). Skips the\n * large collections cache so the hot list path stays cheap. Only use for callers that\n * read just the light scalar/small fields — see {@link listAllDocumentsCachedLight}.\n */\nexport async function listAllItemMetadataLight(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemMetadata[]> {\n  const documents = await listAllDocumentsCachedLight(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n  );\n  return documents.map((document) => document.metadata);\n}\n\n/** Implements list all item metadata with body for the public runtime surface of this module. */\nexport async function listAllItemMetadataWithBody(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<Array<ItemMetadata & { body: string }>> {\n  const candidates = await listAllDocumentCandidatesCached(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n    { includeBody: true },\n  );\n  return candidates.map((candidate) => ({\n    ...candidate.metadata,\n    // includeBody:true guarantees candidate bodies are materialized.\n    body: candidate.body!,\n  }));\n}\n\nasync function listKnownItemIds(\n  pmRoot: string,\n  typeToFolder: Record<string, string>,\n): Promise<string[]> {\n  const folders = new Set(Object.values(typeToFolder));\n  const allIds: string[] = [];\n  await Promise.all(\n    [...folders].map(async (folder) => {\n      try {\n        const entries = await fs.readdir(path.join(pmRoot, folder));\n        for (const entry of entries) {\n          for (const ext of ITEM_FILE_EXTENSIONS) {\n            if (entry.toLowerCase().endsWith(ext)) {\n              allIds.push(entry.slice(0, -ext.length));\n              break;\n            }\n          }\n        }\n      } catch {\n        // ignore missing folders\n      }\n    }),\n  );\n  return allIds;\n}\n\nasync function buildDidYouMeanSuggestions(\n  pmRoot: string,\n  badId: string,\n  idPrefix: string,\n  typeToFolder: Record<string, string>,\n): Promise<string[]> {\n  const normalized = normalizeItemId(badId, idPrefix);\n  const ids = await listKnownItemIds(pmRoot, typeToFolder);\n  if (ids.length === 0) return [];\n  const limit = Math.max(3, Math.floor(normalized.length / 2));\n  const scored = ids\n    .map((id) => ({\n      id,\n      distance: levenshteinDistanceWithinLimit(id, normalized, limit),\n    }))\n    .filter(\n      (entry): entry is { id: string; distance: number } =>\n        entry.distance !== null,\n    )\n    .sort((left, right) => left.distance - right.distance)\n    .slice(0, 3)\n    .map((entry) => entry.id);\n  return scored;\n}\n\n/** Implements build item not found error for the public runtime surface of this module. */\nexport async function buildItemNotFoundError(\n  pmRoot: string,\n  badId: string,\n  idPrefix: string,\n  typeToFolder: Record<string, string>,\n): Promise<PmCliError> {\n  const suggestions = await buildDidYouMeanSuggestions(\n    pmRoot,\n    badId,\n    idPrefix,\n    typeToFolder,\n  );\n  const nextSteps: string[] = [\n    \"Confirm the active --path/PM_PATH scope, then retry with a valid id.\",\n  ];\n  if (suggestions.length > 0) {\n    nextSteps.unshift(`Did you mean one of: ${suggestions.join(\", \")}?`);\n  }\n  return new PmCliError(`Item ${badId} not found`, EXIT_CODE.NOT_FOUND, {\n    nextSteps,\n  });\n}\n\nfunction bypassesAssigneeConflict(\n  op: string,\n  bypassAssigneeConflict?: boolean,\n): boolean {\n  return (\n    op === \"claim\" ||\n    (bypassAssigneeConflict === true &&\n      (op === \"comment_add\" ||\n        op === \"comment_edit\" ||\n        op === \"comment_delete\" ||\n        op === \"note_add\" ||\n        op === \"learning_add\" ||\n        op === \"release\" ||\n        op === \"update\" ||\n        op === \"update_ownership_bypass\" ||\n        // Historical compatibility for streams written before the optional\n        // governance package moved its ownership workflow out of core.\n        op === \"update_audit\"))\n  );\n}\n\nasync function prepareLockedItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  op: string;\n  author: string;\n  force?: boolean;\n  bypassAssigneeConflict?: boolean;\n  extensionFieldNames?: readonly string[];\n  typeToFolder?: Record<string, string>;\n}): Promise<{\n  typeToFolder: Record<string, string>;\n  located: LocatedItem;\n  originalRaw: string;\n  document: ItemDocument;\n  warnings: string[];\n  releaseLock: () => Promise<void>;\n}> {\n  const typeToFolder =\n    params.typeToFolder ??\n    resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations())\n      .type_to_folder;\n  const located = await locateItem(\n    params.pmRoot,\n    params.id,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    typeToFolder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      params.pmRoot,\n      params.id,\n      params.settings.id_prefix,\n      typeToFolder,\n    );\n  }\n\n  const releaseLock = await acquireLock(\n    params.pmRoot,\n    located.id,\n    params.settings.locks.ttl_seconds,\n    params.author,\n    Boolean(params.force),\n    params.settings.governance.force_required_for_stale_lock,\n    params.settings.locks.wait_ms,\n  );\n\n  try {\n    const warnings: string[] = [];\n    const { raw: originalRaw, document } = await readLocatedItem(located, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n      warnings,\n    });\n\n    const assigned = document.metadata.assignee?.trim();\n    const governance = resolveGovernanceKnobs(params.settings);\n    const hasOwnershipConflict =\n      assigned &&\n      assigned !== params.author &&\n      !params.force &&\n      !bypassesAssigneeConflict(params.op, params.bypassAssigneeConflict);\n    if (hasOwnershipConflict) {\n      if (governance.ownership_enforcement === \"strict\") {\n        throw new PmCliError(\n          `Item ${located.id} is assigned to ${assigned}. Use --force to override.`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      if (governance.ownership_enforcement === \"warn\") {\n        warnings.push(\n          `ownership_warning:assignee_conflict:${located.id}:${assigned}`,\n        );\n      }\n    }\n\n    return {\n      typeToFolder,\n      located,\n      originalRaw,\n      document,\n      warnings,\n      releaseLock,\n    };\n  } catch (error: unknown) {\n    await releaseLock();\n    throw error;\n  }\n}\n\nfunction resolveItemStoreWriteOverride(\n  serviceWriteOverride: { handled: boolean; result?: unknown },\n  targetItemPath: string,\n  serializedAfter: string,\n): {\n  effectiveTargetItemPath: string;\n  effectiveSerializedAfter: string;\n  skipItemWrite: boolean;\n} {\n  if (\n    !serviceWriteOverride.handled ||\n    typeof serviceWriteOverride.result !== \"object\" ||\n    serviceWriteOverride.result === null\n  ) {\n    return {\n      effectiveTargetItemPath: targetItemPath,\n      effectiveSerializedAfter: serializedAfter,\n      skipItemWrite: false,\n    };\n  }\n  const overrideRecord = serviceWriteOverride.result as {\n    target_item_path?: unknown;\n    contents?: unknown;\n    skip_write?: unknown;\n  };\n  return {\n    effectiveTargetItemPath:\n      typeof overrideRecord.target_item_path === \"string\" &&\n      overrideRecord.target_item_path.trim().length > 0\n        ? overrideRecord.target_item_path\n        : targetItemPath,\n    effectiveSerializedAfter:\n      typeof overrideRecord.contents === \"string\"\n        ? overrideRecord.contents\n        : serializedAfter,\n    skipItemWrite: overrideRecord.skip_write === true,\n  };\n}\n\nasync function rollbackMutatedItemWrite(params: {\n  skipItemWrite: boolean;\n  effectiveTargetItemPath: string;\n  originalItemPath: string;\n  originalRaw: string;\n}): Promise<void> {\n  if (params.skipItemWrite) {\n    return;\n  }\n  if (params.effectiveTargetItemPath !== params.originalItemPath) {\n    await writeFileAtomic(params.originalItemPath, params.originalRaw);\n    await fs.rm(params.effectiveTargetItemPath, { force: true });\n    return;\n  }\n  await writeFileAtomic(params.originalItemPath, params.originalRaw);\n}\n\n/** Implements mutate item for the public runtime surface of this module. */\nexport async function mutateItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  op: string;\n  author: string;\n  message?: string;\n  force?: boolean;\n  bypassAssigneeConflict?: boolean;\n  skipNoop?: boolean;\n  extensionFieldNames?: readonly string[];\n  typeToFolder?: Record<string, string>;\n  mutate: (document: ItemDocument) => {\n    changedFields: string[];\n    warnings?: string[];\n  };\n}): Promise<{\n  item: ItemMetadata;\n  body: string;\n  changedFields: string[];\n  warnings: string[];\n}> {\n  const prepared = await prepareLockedItem({\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    id: params.id,\n    op: params.op,\n    author: params.author,\n    force: params.force,\n    bypassAssigneeConflict: params.bypassAssigneeConflict,\n    extensionFieldNames: params.extensionFieldNames,\n    typeToFolder: params.typeToFolder,\n  });\n  const {\n    typeToFolder,\n    located,\n    originalRaw,\n    document,\n    warnings: parseWarnings,\n    releaseLock,\n  } = prepared;\n\n  try {\n    const beforeDocument = canonicalDocument(document, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const mutableDocument = canonicalDocument(structuredClone(document), {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const mutation = params.mutate(mutableDocument);\n    if (params.skipNoop === true && mutation.changedFields.length === 0) {\n      return {\n        item: beforeDocument.metadata,\n        body: beforeDocument.body,\n        changedFields: [],\n        warnings: [...parseWarnings, ...(mutation.warnings ?? [])],\n      };\n    }\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot: params.pmRoot,\n      settings: params.settings,\n      itemId: located.id,\n      commandLabel: params.op,\n    });\n    mutableDocument.metadata.updated_at = nowIso();\n    const afterDocument = canonicalDocument(mutableDocument, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const targetItemFormat: ItemFormat = \"toon\";\n    const serializedAfter = serializeItemDocument(afterDocument, {\n      format: targetItemFormat,\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const targetItemPath = getItemPath(\n      params.pmRoot,\n      afterDocument.metadata.type,\n      located.id,\n      targetItemFormat,\n      typeToFolder,\n    );\n    const historyPath = getHistoryPath(params.pmRoot, located.id);\n    const serviceWriteOverride = await runActiveServiceOverride(\n      \"item_store_write\",\n      {\n        op: params.op,\n        pm_root: params.pmRoot,\n        item_id: located.id,\n        source_item_path: located.itemPath,\n        target_item_path: targetItemPath,\n        history_path: historyPath,\n        item_format: targetItemFormat,\n        before: beforeDocument,\n        after: afterDocument,\n        contents: serializedAfter,\n      },\n    );\n    const { effectiveTargetItemPath, effectiveSerializedAfter, skipItemWrite } =\n      resolveItemStoreWriteOverride(\n        serviceWriteOverride,\n        targetItemPath,\n        serializedAfter,\n      );\n\n    if (!skipItemWrite) {\n      await writeFileAtomic(effectiveTargetItemPath, effectiveSerializedAfter);\n    }\n    if (!skipItemWrite && effectiveTargetItemPath !== located.itemPath) {\n      await fs.rm(located.itemPath);\n    }\n    const entry = createHistoryEntry({\n      nowIso: afterDocument.metadata.updated_at,\n      author: params.author,\n      op: params.op,\n      before: beforeDocument,\n      after: afterDocument,\n      message: params.message,\n    });\n\n    try {\n      await appendHistoryEntry(historyPath, entry);\n    } catch (error: unknown) {\n      await rollbackMutatedItemWrite({\n        skipItemWrite,\n        effectiveTargetItemPath,\n        originalItemPath: located.itemPath,\n        originalRaw,\n      });\n      throw error;\n    }\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: effectiveTargetItemPath,\n        scope: \"project\",\n        op: params.op,\n        item_id: afterDocument.metadata.id,\n        item_type: afterDocument.metadata.type,\n        before: beforeDocument,\n        after: afterDocument,\n        changed_fields: mutation.changedFields,\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: `${params.op}:history`,\n        item_id: afterDocument.metadata.id,\n        item_type: afterDocument.metadata.type,\n        before: beforeDocument,\n        after: afterDocument,\n        changed_fields: mutation.changedFields,\n      })),\n    ];\n\n    recordAfterCommandAffectedItem({\n      id: afterDocument.metadata.id,\n      op: params.op,\n      item_type: afterDocument.metadata.type,\n      previous_status: beforeDocument.metadata.status,\n      status: afterDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(\n        beforeDocument.metadata,\n        mutation.changedFields,\n      ),\n      current: projectAfterCommandItemSnapshot(\n        afterDocument.metadata,\n        mutation.changedFields,\n      ),\n      changed_fields: mutation.changedFields,\n    });\n\n    return {\n      item: afterDocument.metadata,\n      body: afterDocument.body,\n      changedFields: mutation.changedFields,\n      warnings: [\n        ...parseWarnings,\n        ...(mutation.warnings ?? []),\n        ...historyPolicy.warnings,\n        ...serviceWriteOverride.warnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\n/** Public contract for item store test only, shared by SDK and presentation-layer consumers. */\nexport const itemStoreTestOnly = {\n  appendWarning,\n  bypassesAssigneeConflict,\n  buildDidYouMeanSuggestions,\n  isErrno,\n};\n\n/** Implements delete item for the public runtime surface of this module. */\nexport async function deleteItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  author: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n}): Promise<{\n  item: ItemMetadata;\n  changedFields: string[];\n  warnings: string[];\n  targetPath?: string;\n}> {\n  const prepared = await prepareLockedItem({\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    id: params.id,\n    op: \"delete\",\n    author: params.author,\n    force: params.force,\n  });\n  const {\n    located,\n    originalRaw,\n    document,\n    warnings: parseWarnings,\n    releaseLock,\n  } = prepared;\n\n  try {\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot: params.pmRoot,\n      settings: params.settings,\n      itemId: located.id,\n      commandLabel: \"delete\",\n    });\n\n    const beforeDocument = canonicalDocument(document, {\n      schema: params.settings.schema,\n    });\n    const deletionTimestamp = nowIso();\n    const tombstoneDocument =\n      EMPTY_CANONICAL_DOCUMENT as unknown as ItemDocument;\n    const historyEntry = createHistoryEntry({\n      nowIso: deletionTimestamp,\n      author: params.author,\n      op: \"delete\",\n      before: beforeDocument,\n      after: tombstoneDocument,\n      message: params.message,\n    });\n    const historyPath = getHistoryPath(params.pmRoot, located.id);\n    const serviceDeleteOverride = await runActiveServiceOverride(\n      \"item_store_delete\",\n      {\n        op: \"delete\",\n        pm_root: params.pmRoot,\n        item_id: located.id,\n        item_path: located.itemPath,\n        history_path: historyPath,\n        before: beforeDocument,\n      },\n    );\n    let effectiveItemPath = located.itemPath;\n    let skipDelete = false;\n    if (\n      serviceDeleteOverride.handled &&\n      typeof serviceDeleteOverride.result === \"object\" &&\n      serviceDeleteOverride.result !== null\n    ) {\n      const overrideRecord = serviceDeleteOverride.result as {\n        item_path?: unknown;\n        skip_delete?: unknown;\n      };\n      if (\n        typeof overrideRecord.item_path === \"string\" &&\n        overrideRecord.item_path.trim().length > 0\n      ) {\n        effectiveItemPath = overrideRecord.item_path;\n      }\n      if (overrideRecord.skip_delete === true) {\n        skipDelete = true;\n      }\n    }\n\n    if (params.dryRun === true) {\n      return {\n        item: beforeDocument.metadata,\n        changedFields: [\"deleted\"],\n        targetPath: effectiveItemPath,\n        warnings: [\n          ...parseWarnings,\n          ...historyPolicy.warnings,\n          ...serviceDeleteOverride.warnings,\n        ],\n      };\n    }\n\n    if (!skipDelete) {\n      await fs.rm(effectiveItemPath);\n    }\n    try {\n      await appendHistoryEntry(historyPath, historyEntry);\n    } catch (error: unknown) {\n      if (!skipDelete) {\n        await writeFileAtomic(effectiveItemPath, originalRaw);\n      }\n      throw error;\n    }\n\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: effectiveItemPath,\n        scope: \"project\",\n        op: \"delete\",\n        item_id: beforeDocument.metadata.id,\n        item_type: beforeDocument.metadata.type,\n        before: beforeDocument,\n        after: tombstoneDocument,\n        changed_fields: [\"deleted\"],\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: \"delete:history\",\n        item_id: beforeDocument.metadata.id,\n        item_type: beforeDocument.metadata.type,\n        before: beforeDocument,\n        after: tombstoneDocument,\n        changed_fields: [\"deleted\"],\n      })),\n    ];\n\n    recordAfterCommandAffectedItem({\n      id: beforeDocument.metadata.id,\n      op: \"delete\",\n      item_type: beforeDocument.metadata.type,\n      previous_status: beforeDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(\n        beforeDocument.metadata,\n        Object.keys(beforeDocument.metadata),\n      ),\n      changed_fields: [\"deleted\"],\n    });\n\n    return {\n      item: beforeDocument.metadata,\n      changedFields: [\"deleted\"],\n      warnings: [\n        ...parseWarnings,\n        ...historyPolicy.warnings,\n        ...serviceDeleteOverride.warnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n"],"names":[],"mappings":"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","debugId":"17b9e6b4-3761-534e-8e93-c488016914e0"}
+{"version":3,"file":"item-store.js","sources":["core/store/item-store.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/store/item-store\n *\n * Reads and writes tracker storage with format-aware helpers for Item Store.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runActiveServiceOverride,\n} from \"../extensions/index.js\";\nimport { collectRegisteredItemFieldNames } from \"../extensions/item-fields.js\";\nimport {\n  EMPTY_CANONICAL_DOCUMENT,\n  EXIT_CODE,\n  TYPE_TO_FOLDER,\n} from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { levenshteinDistanceWithinLimit } from \"../shared/levenshtein.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../history/history.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../history/history-stream-policy.js\";\nimport {\n  canonicalDocument,\n  parseItemDocument,\n  serializeItemDocument,\n} from \"../item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../item/type-registry.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../item/id.js\";\nimport {\n  listAllDocumentCandidatesCached,\n  listAllDocumentsCached,\n  listAllDocumentsCachedLight,\n} from \"./item-metadata-cache.js\";\nimport {\n  getHistoryPath,\n  getItemFormatFromPath,\n  getItemPath,\n  ITEM_FILE_EXTENSIONS,\n} from \"./paths.js\";\nimport { resolveGovernanceKnobs } from \"./settings.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type {\n  ItemDocument,\n  ItemFormat,\n  ItemMetadata,\n  ItemType,\n  PmSettings,\n  RuntimeSchemaSettings,\n} from \"../../types/index.js\";\n\n/** Documents the located item payload exchanged by command, SDK, and package integrations. */\nexport interface LocatedItem {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type: ItemType;\n  /** Filesystem path used for item resolution. */\n  itemPath: string;\n  /** Value that configures or reports item format for this contract. */\n  item_format: ItemFormat;\n}\n\nasync function fileExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === code\n  );\n}\n\nfunction appendWarning(warnings: string[] | undefined, warning: string): void {\n  if (!warnings) {\n    return;\n  }\n  if (!warnings.includes(warning)) {\n    warnings.push(warning);\n  }\n}\n\nfunction resolveActiveExtensionFieldNames(\n  explicit: readonly string[] | undefined,\n): readonly string[] {\n  return (\n    explicit ??\n    collectRegisteredItemFieldNames(getActiveExtensionRegistrations())\n  );\n}\n\nfunction resolveItemFormatSearchOrder(\n  preferredFormat?: ItemFormat,\n): ItemFormat[] {\n  if (preferredFormat === \"toon\") {\n    return [\"toon\", \"json_markdown\"];\n  }\n  if (preferredFormat === \"json_markdown\") {\n    return [\"json_markdown\", \"toon\"];\n  }\n  return [\"toon\", \"json_markdown\"];\n}\n\n/** Implements locate item for the public runtime surface of this module. */\nexport async function locateItem(\n  pmRoot: string,\n  rawId: string,\n  idPrefix = \"pm-\",\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): Promise<LocatedItem | null> {\n  const normalizedId = normalizeItemId(rawId, idPrefix);\n  const rawNormalizedId = normalizeRawItemId(rawId);\n  const candidateIds =\n    normalizedId === rawNormalizedId\n      ? [normalizedId]\n      : [normalizedId, rawNormalizedId];\n  const entries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n  const searchOrder = resolveItemFormatSearchOrder(preferredFormat);\n  for (const candidateId of candidateIds) {\n    for (const [type] of entries) {\n      for (const itemFormat of searchOrder) {\n        const itemPath = getItemPath(\n          pmRoot,\n          type,\n          candidateId,\n          itemFormat,\n          typeToFolder,\n        );\n        if (await fileExists(itemPath)) {\n          return {\n            id: candidateId,\n            type,\n            itemPath,\n            item_format: itemFormat,\n          };\n        }\n      }\n    }\n  }\n  return null;\n}\n\n/** Implements read located item for the public runtime surface of this module. */\nexport async function readLocatedItem(\n  item: LocatedItem,\n  options: {\n    schema?: RuntimeSchemaSettings;\n    extensionFieldNames?: readonly string[];\n    warnings?: string[];\n  } = {},\n): Promise<{ raw: string; document: ItemDocument }> {\n  const raw = await fs.readFile(item.itemPath, \"utf8\");\n  await runActiveOnReadHooks({\n    path: item.itemPath,\n    scope: \"project\",\n  });\n  const document = parseItemDocument(raw, {\n    format: item.item_format,\n    schema: options.schema,\n    extensionFieldNames: resolveActiveExtensionFieldNames(\n      options.extensionFieldNames,\n    ),\n    onWarning: (warning) => appendWarning(options.warnings, warning),\n  });\n  return { raw, document };\n}\n\n/** Implements list all item metadata for the public runtime surface of this module. */\nexport async function listAllItemMetadata(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemMetadata[]> {\n  const documents = await listAllDocumentsCached(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n  );\n  return documents.map((document) => document.metadata);\n}\n\n/**\n * Light variant of {@link listAllItemMetadata}: returns item-metadata WITHOUT the heavy\n * collection fields (comments/notes/learnings/files/tests/test_runs/docs). Skips the\n * large collections cache so the hot list path stays cheap. Only use for callers that\n * read just the light scalar/small fields — see {@link listAllDocumentsCachedLight}.\n */\nexport async function listAllItemMetadataLight(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemMetadata[]> {\n  const documents = await listAllDocumentsCachedLight(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n  );\n  return documents.map((document) => document.metadata);\n}\n\n/** Implements list all item metadata with body for the public runtime surface of this module. */\nexport async function listAllItemMetadataWithBody(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<Array<ItemMetadata & { body: string }>> {\n  const candidates = await listAllDocumentCandidatesCached(\n    pmRoot,\n    preferredFormat,\n    typeToFolder,\n    warnings,\n    schema,\n    { includeBody: true },\n  );\n  return candidates.map((candidate) => ({\n    ...candidate.metadata,\n    // includeBody:true guarantees candidate bodies are materialized.\n    body: candidate.body!,\n  }));\n}\n\nasync function listKnownItemIds(\n  pmRoot: string,\n  typeToFolder: Record<string, string>,\n): Promise<string[]> {\n  const folders = new Set(Object.values(typeToFolder));\n  const allIds: string[] = [];\n  await Promise.all(\n    [...folders].map(async (folder) => {\n      try {\n        const entries = await fs.readdir(path.join(pmRoot, folder));\n        for (const entry of entries) {\n          for (const ext of ITEM_FILE_EXTENSIONS) {\n            if (entry.toLowerCase().endsWith(ext)) {\n              allIds.push(entry.slice(0, -ext.length));\n              break;\n            }\n          }\n        }\n      } catch {\n        // ignore missing folders\n      }\n    }),\n  );\n  return allIds;\n}\n\nasync function buildDidYouMeanSuggestions(\n  pmRoot: string,\n  badId: string,\n  idPrefix: string,\n  typeToFolder: Record<string, string>,\n): Promise<string[]> {\n  const normalized = normalizeItemId(badId, idPrefix);\n  const ids = await listKnownItemIds(pmRoot, typeToFolder);\n  if (ids.length === 0) return [];\n  const limit = Math.max(3, Math.floor(normalized.length / 2));\n  const scored = ids\n    .map((id) => ({\n      id,\n      distance: levenshteinDistanceWithinLimit(id, normalized, limit),\n    }))\n    .filter(\n      (entry): entry is { id: string; distance: number } =>\n        entry.distance !== null,\n    )\n    .sort((left, right) => left.distance - right.distance)\n    .slice(0, 3)\n    .map((entry) => entry.id);\n  return scored;\n}\n\n/** Implements build item not found error for the public runtime surface of this module. */\nexport async function buildItemNotFoundError(\n  pmRoot: string,\n  badId: string,\n  idPrefix: string,\n  typeToFolder: Record<string, string>,\n): Promise<PmCliError> {\n  const suggestions = await buildDidYouMeanSuggestions(\n    pmRoot,\n    badId,\n    idPrefix,\n    typeToFolder,\n  );\n  const nextSteps: string[] = [\n    \"Confirm the active --path/PM_PATH scope, then retry with a valid id.\",\n  ];\n  if (suggestions.length > 0) {\n    nextSteps.unshift(`Did you mean one of: ${suggestions.join(\", \")}?`);\n  }\n  return new PmCliError(`Item ${badId} not found`, EXIT_CODE.NOT_FOUND, {\n    nextSteps,\n  });\n}\n\nfunction bypassesAssigneeConflict(\n  op: string,\n  bypassAssigneeConflict?: boolean,\n): boolean {\n  return (\n    op === \"claim\" ||\n    (bypassAssigneeConflict === true &&\n      (op === \"comment_add\" ||\n        op === \"comment_edit\" ||\n        op === \"comment_delete\" ||\n        op === \"note_add\" ||\n        op === \"learning_add\" ||\n        op === \"release\" ||\n        op === \"update\" ||\n        op === \"update_ownership_bypass\" ||\n        // Historical compatibility for streams written before the optional\n        // governance package moved its ownership workflow out of core.\n        op === \"update_audit\"))\n  );\n}\n\nasync function prepareLockedItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  op: string;\n  author: string;\n  force?: boolean;\n  bypassAssigneeConflict?: boolean;\n  extensionFieldNames?: readonly string[];\n  typeToFolder?: Record<string, string>;\n}): Promise<{\n  typeToFolder: Record<string, string>;\n  located: LocatedItem;\n  originalRaw: string;\n  document: ItemDocument;\n  warnings: string[];\n  releaseLock: () => Promise<void>;\n}> {\n  const typeToFolder =\n    params.typeToFolder ??\n    resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations())\n      .type_to_folder;\n  const located = await locateItem(\n    params.pmRoot,\n    params.id,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    typeToFolder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      params.pmRoot,\n      params.id,\n      params.settings.id_prefix,\n      typeToFolder,\n    );\n  }\n\n  const releaseLock = await acquireLock(\n    params.pmRoot,\n    located.id,\n    params.settings.locks.ttl_seconds,\n    params.author,\n    Boolean(params.force),\n    params.settings.governance.force_required_for_stale_lock,\n    params.settings.locks.wait_ms,\n  );\n\n  try {\n    const warnings: string[] = [];\n    const { raw: originalRaw, document } = await readLocatedItem(located, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n      warnings,\n    });\n\n    const assigned = document.metadata.assignee?.trim();\n    const governance = resolveGovernanceKnobs(params.settings);\n    const hasOwnershipConflict =\n      assigned &&\n      assigned !== params.author &&\n      !params.force &&\n      !bypassesAssigneeConflict(params.op, params.bypassAssigneeConflict);\n    if (hasOwnershipConflict) {\n      if (governance.ownership_enforcement === \"strict\") {\n        throw new PmCliError(\n          `Item ${located.id} is assigned to ${assigned}. Use --force to override.`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      if (governance.ownership_enforcement === \"warn\") {\n        warnings.push(\n          `ownership_warning:assignee_conflict:${located.id}:${assigned}`,\n        );\n      }\n    }\n\n    return {\n      typeToFolder,\n      located,\n      originalRaw,\n      document,\n      warnings,\n      releaseLock,\n    };\n  } catch (error: unknown) {\n    await releaseLock();\n    throw error;\n  }\n}\n\nfunction resolveItemStoreWriteOverride(\n  serviceWriteOverride: { handled: boolean; result?: unknown },\n  targetItemPath: string,\n  serializedAfter: string,\n): {\n  effectiveTargetItemPath: string;\n  effectiveSerializedAfter: string;\n  skipItemWrite: boolean;\n} {\n  if (\n    !serviceWriteOverride.handled ||\n    typeof serviceWriteOverride.result !== \"object\" ||\n    serviceWriteOverride.result === null\n  ) {\n    return {\n      effectiveTargetItemPath: targetItemPath,\n      effectiveSerializedAfter: serializedAfter,\n      skipItemWrite: false,\n    };\n  }\n  const overrideRecord = serviceWriteOverride.result as {\n    target_item_path?: unknown;\n    contents?: unknown;\n    skip_write?: unknown;\n  };\n  return {\n    effectiveTargetItemPath:\n      typeof overrideRecord.target_item_path === \"string\" &&\n      overrideRecord.target_item_path.trim().length > 0\n        ? overrideRecord.target_item_path\n        : targetItemPath,\n    effectiveSerializedAfter:\n      typeof overrideRecord.contents === \"string\"\n        ? overrideRecord.contents\n        : serializedAfter,\n    skipItemWrite: overrideRecord.skip_write === true,\n  };\n}\n\nasync function rollbackMutatedItemWrite(params: {\n  skipItemWrite: boolean;\n  effectiveTargetItemPath: string;\n  originalItemPath: string;\n  originalRaw: string;\n}): Promise<void> {\n  if (params.skipItemWrite) {\n    return;\n  }\n  if (params.effectiveTargetItemPath !== params.originalItemPath) {\n    await writeFileAtomic(params.originalItemPath, params.originalRaw);\n    await fs.rm(params.effectiveTargetItemPath, { force: true });\n    return;\n  }\n  await writeFileAtomic(params.originalItemPath, params.originalRaw);\n}\n\n/** Implements mutate item for the public runtime surface of this module. */\nexport async function mutateItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  op: string;\n  author: string;\n  message?: string;\n  force?: boolean;\n  bypassAssigneeConflict?: boolean;\n  skipNoop?: boolean;\n  extensionFieldNames?: readonly string[];\n  typeToFolder?: Record<string, string>;\n  mutate: (\n    document: ItemDocument,\n  ) =>\n    | { changedFields: string[]; warnings?: string[] }\n    | Promise<{ changedFields: string[]; warnings?: string[] }>;\n}): Promise<{\n  item: ItemMetadata;\n  body: string;\n  changedFields: string[];\n  warnings: string[];\n}> {\n  const prepared = await prepareLockedItem({\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    id: params.id,\n    op: params.op,\n    author: params.author,\n    force: params.force,\n    bypassAssigneeConflict: params.bypassAssigneeConflict,\n    extensionFieldNames: params.extensionFieldNames,\n    typeToFolder: params.typeToFolder,\n  });\n  const {\n    typeToFolder,\n    located,\n    originalRaw,\n    document,\n    warnings: parseWarnings,\n    releaseLock,\n  } = prepared;\n\n  try {\n    const beforeDocument = canonicalDocument(document, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const mutableDocument = canonicalDocument(structuredClone(document), {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const mutation = await params.mutate(mutableDocument);\n    if (params.skipNoop === true && mutation.changedFields.length === 0) {\n      return {\n        item: beforeDocument.metadata,\n        body: beforeDocument.body,\n        changedFields: [],\n        warnings: [...parseWarnings, ...(mutation.warnings ?? [])],\n      };\n    }\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot: params.pmRoot,\n      settings: params.settings,\n      itemId: located.id,\n      commandLabel: params.op,\n    });\n    mutableDocument.metadata.updated_at = nowIso();\n    const afterDocument = canonicalDocument(mutableDocument, {\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const targetItemFormat: ItemFormat = \"toon\";\n    const serializedAfter = serializeItemDocument(afterDocument, {\n      format: targetItemFormat,\n      schema: params.settings.schema,\n      extensionFieldNames: params.extensionFieldNames,\n    });\n    const targetItemPath = getItemPath(\n      params.pmRoot,\n      afterDocument.metadata.type,\n      located.id,\n      targetItemFormat,\n      typeToFolder,\n    );\n    const historyPath = getHistoryPath(params.pmRoot, located.id);\n    const serviceWriteOverride = await runActiveServiceOverride(\n      \"item_store_write\",\n      {\n        op: params.op,\n        pm_root: params.pmRoot,\n        item_id: located.id,\n        source_item_path: located.itemPath,\n        target_item_path: targetItemPath,\n        history_path: historyPath,\n        item_format: targetItemFormat,\n        before: beforeDocument,\n        after: afterDocument,\n        contents: serializedAfter,\n      },\n    );\n    const { effectiveTargetItemPath, effectiveSerializedAfter, skipItemWrite } =\n      resolveItemStoreWriteOverride(\n        serviceWriteOverride,\n        targetItemPath,\n        serializedAfter,\n      );\n\n    if (!skipItemWrite) {\n      await writeFileAtomic(effectiveTargetItemPath, effectiveSerializedAfter);\n    }\n    if (!skipItemWrite && effectiveTargetItemPath !== located.itemPath) {\n      await fs.rm(located.itemPath);\n    }\n    const entry = createHistoryEntry({\n      nowIso: afterDocument.metadata.updated_at,\n      author: params.author,\n      op: params.op,\n      before: beforeDocument,\n      after: afterDocument,\n      message: params.message,\n    });\n\n    try {\n      await appendHistoryEntry(historyPath, entry);\n    } catch (error: unknown) {\n      await rollbackMutatedItemWrite({\n        skipItemWrite,\n        effectiveTargetItemPath,\n        originalItemPath: located.itemPath,\n        originalRaw,\n      });\n      throw error;\n    }\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: effectiveTargetItemPath,\n        scope: \"project\",\n        op: params.op,\n        item_id: afterDocument.metadata.id,\n        item_type: afterDocument.metadata.type,\n        before: beforeDocument,\n        after: afterDocument,\n        changed_fields: mutation.changedFields,\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: `${params.op}:history`,\n        item_id: afterDocument.metadata.id,\n        item_type: afterDocument.metadata.type,\n        before: beforeDocument,\n        after: afterDocument,\n        changed_fields: mutation.changedFields,\n      })),\n    ];\n\n    recordAfterCommandAffectedItem({\n      id: afterDocument.metadata.id,\n      op: params.op,\n      item_type: afterDocument.metadata.type,\n      previous_status: beforeDocument.metadata.status,\n      status: afterDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(\n        beforeDocument.metadata,\n        mutation.changedFields,\n      ),\n      current: projectAfterCommandItemSnapshot(\n        afterDocument.metadata,\n        mutation.changedFields,\n      ),\n      changed_fields: mutation.changedFields,\n    });\n\n    return {\n      item: afterDocument.metadata,\n      body: afterDocument.body,\n      changedFields: mutation.changedFields,\n      warnings: [\n        ...parseWarnings,\n        ...(mutation.warnings ?? []),\n        ...historyPolicy.warnings,\n        ...serviceWriteOverride.warnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\n/** Public contract for item store test only, shared by SDK and presentation-layer consumers. */\nexport const itemStoreTestOnly = {\n  appendWarning,\n  bypassesAssigneeConflict,\n  buildDidYouMeanSuggestions,\n  isErrno,\n};\n\n/** Implements delete item for the public runtime surface of this module. */\nexport async function deleteItem(params: {\n  pmRoot: string;\n  settings: PmSettings;\n  id: string;\n  author: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n}): Promise<{\n  item: ItemMetadata;\n  changedFields: string[];\n  warnings: string[];\n  targetPath?: string;\n}> {\n  const prepared = await prepareLockedItem({\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    id: params.id,\n    op: \"delete\",\n    author: params.author,\n    force: params.force,\n  });\n  const {\n    located,\n    originalRaw,\n    document,\n    warnings: parseWarnings,\n    releaseLock,\n  } = prepared;\n\n  try {\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot: params.pmRoot,\n      settings: params.settings,\n      itemId: located.id,\n      commandLabel: \"delete\",\n    });\n\n    const beforeDocument = canonicalDocument(document, {\n      schema: params.settings.schema,\n    });\n    const deletionTimestamp = nowIso();\n    const tombstoneDocument =\n      EMPTY_CANONICAL_DOCUMENT as unknown as ItemDocument;\n    const historyEntry = createHistoryEntry({\n      nowIso: deletionTimestamp,\n      author: params.author,\n      op: \"delete\",\n      before: beforeDocument,\n      after: tombstoneDocument,\n      message: params.message,\n    });\n    const historyPath = getHistoryPath(params.pmRoot, located.id);\n    const serviceDeleteOverride = await runActiveServiceOverride(\n      \"item_store_delete\",\n      {\n        op: \"delete\",\n        pm_root: params.pmRoot,\n        item_id: located.id,\n        item_path: located.itemPath,\n        history_path: historyPath,\n        before: beforeDocument,\n      },\n    );\n    let effectiveItemPath = located.itemPath;\n    let skipDelete = false;\n    if (\n      serviceDeleteOverride.handled &&\n      typeof serviceDeleteOverride.result === \"object\" &&\n      serviceDeleteOverride.result !== null\n    ) {\n      const overrideRecord = serviceDeleteOverride.result as {\n        item_path?: unknown;\n        skip_delete?: unknown;\n      };\n      if (\n        typeof overrideRecord.item_path === \"string\" &&\n        overrideRecord.item_path.trim().length > 0\n      ) {\n        effectiveItemPath = overrideRecord.item_path;\n      }\n      if (overrideRecord.skip_delete === true) {\n        skipDelete = true;\n      }\n    }\n\n    if (params.dryRun === true) {\n      return {\n        item: beforeDocument.metadata,\n        changedFields: [\"deleted\"],\n        targetPath: effectiveItemPath,\n        warnings: [\n          ...parseWarnings,\n          ...historyPolicy.warnings,\n          ...serviceDeleteOverride.warnings,\n        ],\n      };\n    }\n\n    if (!skipDelete) {\n      await fs.rm(effectiveItemPath);\n    }\n    try {\n      await appendHistoryEntry(historyPath, historyEntry);\n    } catch (error: unknown) {\n      if (!skipDelete) {\n        await writeFileAtomic(effectiveItemPath, originalRaw);\n      }\n      throw error;\n    }\n\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: effectiveItemPath,\n        scope: \"project\",\n        op: \"delete\",\n        item_id: beforeDocument.metadata.id,\n        item_type: beforeDocument.metadata.type,\n        before: beforeDocument,\n        after: tombstoneDocument,\n        changed_fields: [\"deleted\"],\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: historyPath,\n        scope: \"project\",\n        op: \"delete:history\",\n        item_id: beforeDocument.metadata.id,\n        item_type: beforeDocument.metadata.type,\n        before: beforeDocument,\n        after: tombstoneDocument,\n        changed_fields: [\"deleted\"],\n      })),\n    ];\n\n    recordAfterCommandAffectedItem({\n      id: beforeDocument.metadata.id,\n      op: \"delete\",\n      item_type: beforeDocument.metadata.type,\n      previous_status: beforeDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(\n        beforeDocument.metadata,\n        Object.keys(beforeDocument.metadata),\n      ),\n      changed_fields: [\"deleted\"],\n    });\n\n    return {\n      item: beforeDocument.metadata,\n      changedFields: [\"deleted\"],\n      warnings: [\n        ...parseWarnings,\n        ...historyPolicy.warnings,\n        ...serviceDeleteOverride.warnings,\n        ...hookWarnings,\n      ],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,SAAS,EACT,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,cAAc,EAEd,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAsB3C,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA2B,CAAC,IAAI,KAAK,IAAI,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAA8B,EAAE,OAAe;IACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,gCAAgC,CACvC,QAAuC;IAEvC,OAAO,CACL,QAAQ;QACR,+BAA+B,CAAC,+BAA+B,EAAE,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,eAA4B;IAE5B,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;QACxC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AACnC,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,KAAa,EACb,QAAQ,GAAG,KAAK,EAChB,eAA4B,EAC5B,eAAuC,cAAc;IAErD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,YAAY,GAChB,YAAY,KAAK,eAAe;QAC9B,CAAC,CAAC,CAAC,YAAY,CAAC;QAChB,CAAC,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAA8B,CAAC;IAC1E,MAAM,WAAW,GAAG,4BAA4B,CAAC,eAAe,CAAC,CAAC;IAClE,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,WAAW,CAC1B,MAAM,EACN,IAAI,EACJ,WAAW,EACX,UAAU,EACV,YAAY,CACb,CAAC;gBACF,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/B,OAAO;wBACL,EAAE,EAAE,WAAW;wBACf,IAAI;wBACJ,QAAQ;wBACR,WAAW,EAAE,UAAU;qBACxB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAiB,EACjB,UAII,EAAE;IAEN,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,oBAAoB,CAAC;QACzB,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,EAAE;QACtC,MAAM,EAAE,IAAI,CAAC,WAAW;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,mBAAmB,EAAE,gCAAgC,CACnD,OAAO,CAAC,mBAAmB,CAC5B;QACD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;KACjE,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,eAA4B,EAC5B,eAAuC,cAAc,EACrD,QAAmB,EACnB,MAA8B;IAE9B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAC5C,MAAM,EACN,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,MAAM,CACP,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,eAA4B,EAC5B,eAAuC,cAAc,EACrD,QAAmB,EACnB,MAA8B;IAE9B,MAAM,SAAS,GAAG,MAAM,2BAA2B,CACjD,MAAM,EACN,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,MAAM,CACP,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAc,EACd,eAA4B,EAC5B,eAAuC,cAAc,EACrD,QAAmB,EACnB,MAA8B;IAE9B,MAAM,UAAU,GAAG,MAAM,+BAA+B,CACtD,MAAM,EACN,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAC;IACF,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,SAAS,CAAC,QAAQ;QACrB,iEAAiE;QACjE,IAAI,EAAE,SAAS,CAAC,IAAK;KACtB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,YAAoC;IAEpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;oBACvC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;wBACzC,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,MAAc,EACd,KAAa,EACb,QAAgB,EAChB,YAAoC;IAEpC,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,GAAG;SACf,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,EAAE;QACF,QAAQ,EAAE,8BAA8B,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC;KAChE,CAAC,CAAC;SACF,MAAM,CACL,CAAC,KAAK,EAA6C,EAAE,CACnD,KAAK,CAAC,QAAQ,KAAK,IAAI,CAC1B;SACA,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;SACrD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,KAAa,EACb,QAAgB,EAChB,YAAoC;IAEpC,MAAM,WAAW,GAAG,MAAM,0BAA0B,CAClD,MAAM,EACN,KAAK,EACL,QAAQ,EACR,YAAY,CACb,CAAC;IACF,MAAM,SAAS,GAAa;QAC1B,sEAAsE;KACvE,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,OAAO,CAAC,wBAAwB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,QAAQ,KAAK,YAAY,EAAE,SAAS,CAAC,SAAS,EAAE;QACpE,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAC/B,EAAU,EACV,sBAAgC;IAEhC,OAAO,CACL,EAAE,KAAK,OAAO;QACd,CAAC,sBAAsB,KAAK,IAAI;YAC9B,CAAC,EAAE,KAAK,aAAa;gBACnB,EAAE,KAAK,cAAc;gBACrB,EAAE,KAAK,gBAAgB;gBACvB,EAAE,KAAK,UAAU;gBACjB,EAAE,KAAK,cAAc;gBACrB,EAAE,KAAK,SAAS;gBAChB,EAAE,KAAK,QAAQ;gBACf,EAAE,KAAK,yBAAyB;gBAChC,mEAAmE;gBACnE,+DAA+D;gBAC/D,EAAE,KAAK,cAAc,CAAC,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAUhC;IAQC,MAAM,YAAY,GAChB,MAAM,CAAC,YAAY;QACnB,uBAAuB,CAAC,MAAM,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC;aACxE,cAAc,CAAC;IACpB,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,QAAQ,CAAC,SAAS,EACzB,MAAM,CAAC,QAAQ,CAAC,WAAW,EAC3B,YAAY,CACb,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,sBAAsB,CAChC,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,QAAQ,CAAC,SAAS,EACzB,YAAY,CACb,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,WAAW,CACnC,MAAM,CAAC,MAAM,EACb,OAAO,CAAC,EAAE,EACV,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EACjC,MAAM,CAAC,MAAM,EACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EACrB,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,6BAA6B,EACxD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAC9B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE;YACpE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,oBAAoB,GACxB,QAAQ;YACR,QAAQ,KAAK,MAAM,CAAC,MAAM;YAC1B,CAAC,MAAM,CAAC,KAAK;YACb,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACtE,IAAI,oBAAoB,EAAE,CAAC;YACzB,IAAI,UAAU,CAAC,qBAAqB,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,IAAI,UAAU,CAClB,QAAQ,OAAO,CAAC,EAAE,mBAAmB,QAAQ,4BAA4B,EACzE,SAAS,CAAC,QAAQ,CACnB,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,qBAAqB,KAAK,MAAM,EAAE,CAAC;gBAChD,QAAQ,CAAC,IAAI,CACX,uCAAuC,OAAO,CAAC,EAAE,IAAI,QAAQ,EAAE,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,YAAY;YACZ,OAAO;YACP,WAAW;YACX,QAAQ;YACR,QAAQ;YACR,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,6BAA6B,CACpC,oBAA4D,EAC5D,cAAsB,EACtB,eAAuB;IAMvB,IACE,CAAC,oBAAoB,CAAC,OAAO;QAC7B,OAAO,oBAAoB,CAAC,MAAM,KAAK,QAAQ;QAC/C,oBAAoB,CAAC,MAAM,KAAK,IAAI,EACpC,CAAC;QACD,OAAO;YACL,uBAAuB,EAAE,cAAc;YACvC,wBAAwB,EAAE,eAAe;YACzC,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAI3C,CAAC;IACF,OAAO;QACL,uBAAuB,EACrB,OAAO,cAAc,CAAC,gBAAgB,KAAK,QAAQ;YACnD,cAAc,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAC/C,CAAC,CAAC,cAAc,CAAC,gBAAgB;YACjC,CAAC,CAAC,cAAc;QACpB,wBAAwB,EACtB,OAAO,cAAc,CAAC,QAAQ,KAAK,QAAQ;YACzC,CAAC,CAAC,cAAc,CAAC,QAAQ;YACzB,CAAC,CAAC,eAAe;QACrB,aAAa,EAAE,cAAc,CAAC,UAAU,KAAK,IAAI;KAClD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,MAKvC;IACC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,uBAAuB,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/D,MAAM,eAAe,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,MAAM,eAAe,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAiBhC;IAMC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;QACrD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAC;IACH,MAAM,EACJ,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EAAE,aAAa,EACvB,WAAW,GACZ,GAAG,QAAQ,CAAC;IAEb,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,iBAAiB,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE;YACnE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,OAAO;gBACL,IAAI,EAAE,cAAc,CAAC,QAAQ;gBAC7B,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,aAAa,EAAE,EAAE;gBACjB,QAAQ,EAAE,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;aAC3D,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,iCAAiC,CAAC;YAC5D,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,YAAY,EAAE,MAAM,CAAC,EAAE;SACxB,CAAC,CAAC;QACH,eAAe,CAAC,QAAQ,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,iBAAiB,CAAC,eAAe,EAAE;YACvD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,MAAM,gBAAgB,GAAe,MAAM,CAAC;QAC5C,MAAM,eAAe,GAAG,qBAAqB,CAAC,aAAa,EAAE;YAC3D,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,WAAW,CAChC,MAAM,CAAC,MAAM,EACb,aAAa,CAAC,QAAQ,CAAC,IAAI,EAC3B,OAAO,CAAC,EAAE,EACV,gBAAgB,EAChB,YAAY,CACb,CAAC;QACF,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,oBAAoB,GAAG,MAAM,wBAAwB,CACzD,kBAAkB,EAClB;YACE,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,EAAE;YACnB,gBAAgB,EAAE,OAAO,CAAC,QAAQ;YAClC,gBAAgB,EAAE,cAAc;YAChC,YAAY,EAAE,WAAW;YACzB,WAAW,EAAE,gBAAgB;YAC7B,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE,eAAe;SAC1B,CACF,CAAC;QACF,MAAM,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,aAAa,EAAE,GACxE,6BAA6B,CAC3B,oBAAoB,EACpB,cAAc,EACd,eAAe,CAChB,CAAC;QAEJ,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,eAAe,CAAC,uBAAuB,EAAE,wBAAwB,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,aAAa,IAAI,uBAAuB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnE,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,KAAK,GAAG,kBAAkB,CAAC;YAC/B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,UAAU;YACzC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,wBAAwB,CAAC;gBAC7B,aAAa;gBACb,uBAAuB;gBACvB,gBAAgB,EAAE,OAAO,CAAC,QAAQ;gBAClC,WAAW;aACZ,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,YAAY,GAAG;YACnB,GAAG,CAAC,MAAM,qBAAqB,CAAC;gBAC9B,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,SAAS;gBAChB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE;gBAClC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI;gBACtC,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,aAAa;gBACpB,cAAc,EAAE,QAAQ,CAAC,aAAa;aACvC,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,qBAAqB,CAAC;gBAC9B,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,SAAS;gBAChB,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,UAAU;gBAC1B,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE;gBAClC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI;gBACtC,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,aAAa;gBACpB,cAAc,EAAE,QAAQ,CAAC,aAAa;aACvC,CAAC,CAAC;SACJ,CAAC;QAEF,8BAA8B,CAAC;YAC7B,EAAE,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE;YAC7B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI;YACtC,eAAe,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM;YAC/C,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM;YACrC,QAAQ,EAAE,+BAA+B,CACvC,cAAc,CAAC,QAAQ,EACvB,QAAQ,CAAC,aAAa,CACvB;YACD,OAAO,EAAE,+BAA+B,CACtC,aAAa,CAAC,QAAQ,EACtB,QAAQ,CAAC,aAAa,CACvB;YACD,cAAc,EAAE,QAAQ,CAAC,aAAa;SACvC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,aAAa,CAAC,QAAQ;YAC5B,IAAI,EAAE,aAAa,CAAC,IAAI;YACxB,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,QAAQ,EAAE;gBACR,GAAG,aAAa;gBAChB,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC5B,GAAG,aAAa,CAAC,QAAQ;gBACzB,GAAG,oBAAoB,CAAC,QAAQ;gBAChC,GAAG,YAAY;aAChB;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,aAAa;IACb,wBAAwB;IACxB,0BAA0B;IAC1B,OAAO;CACR,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAQhC;IAMC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IACH,MAAM,EACJ,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EAAE,aAAa,EACvB,WAAW,GACZ,GAAG,QAAQ,CAAC;IAEb,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,iCAAiC,CAAC;YAC5D,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,YAAY,EAAE,QAAQ;SACvB,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;SAC/B,CAAC,CAAC;QACH,MAAM,iBAAiB,GAAG,MAAM,EAAE,CAAC;QACnC,MAAM,iBAAiB,GACrB,wBAAmD,CAAC;QACtD,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,EAAE,EAAE,QAAQ;YACZ,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,qBAAqB,GAAG,MAAM,wBAAwB,CAC1D,mBAAmB,EACnB;YACE,EAAE,EAAE,QAAQ;YACZ,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,EAAE;YACnB,SAAS,EAAE,OAAO,CAAC,QAAQ;YAC3B,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,cAAc;SACvB,CACF,CAAC;QACF,IAAI,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;QACzC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IACE,qBAAqB,CAAC,OAAO;YAC7B,OAAO,qBAAqB,CAAC,MAAM,KAAK,QAAQ;YAChD,qBAAqB,CAAC,MAAM,KAAK,IAAI,EACrC,CAAC;YACD,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAG5C,CAAC;YACF,IACE,OAAO,cAAc,CAAC,SAAS,KAAK,QAAQ;gBAC5C,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAC1C,CAAC;gBACD,iBAAiB,GAAG,cAAc,CAAC,SAAS,CAAC;YAC/C,CAAC;YACD,IAAI,cAAc,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACxC,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO;gBACL,IAAI,EAAE,cAAc,CAAC,QAAQ;gBAC7B,aAAa,EAAE,CAAC,SAAS,CAAC;gBAC1B,UAAU,EAAE,iBAAiB;gBAC7B,QAAQ,EAAE;oBACR,GAAG,aAAa;oBAChB,GAAG,aAAa,CAAC,QAAQ;oBACzB,GAAG,qBAAqB,CAAC,QAAQ;iBAClC;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,eAAe,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG;YACnB,GAAG,CAAC,MAAM,qBAAqB,CAAC;gBAC9B,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,SAAS;gBAChB,EAAE,EAAE,QAAQ;gBACZ,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE;gBACnC,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI;gBACvC,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,iBAAiB;gBACxB,cAAc,EAAE,CAAC,SAAS,CAAC;aAC5B,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,qBAAqB,CAAC;gBAC9B,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,SAAS;gBAChB,EAAE,EAAE,gBAAgB;gBACpB,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE;gBACnC,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI;gBACvC,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,iBAAiB;gBACxB,cAAc,EAAE,CAAC,SAAS,CAAC;aAC5B,CAAC,CAAC;SACJ,CAAC;QAEF,8BAA8B,CAAC;YAC7B,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE;YAC9B,EAAE,EAAE,QAAQ;YACZ,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI;YACvC,eAAe,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM;YAC/C,QAAQ,EAAE,+BAA+B,CACvC,cAAc,CAAC,QAAQ,EACvB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CACrC;YACD,cAAc,EAAE,CAAC,SAAS,CAAC;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,cAAc,CAAC,QAAQ;YAC7B,aAAa,EAAE,CAAC,SAAS,CAAC;YAC1B,QAAQ,EAAE;gBACR,GAAG,aAAa;gBAChB,GAAG,aAAa,CAAC,QAAQ;gBACzB,GAAG,qBAAqB,CAAC,QAAQ;gBACjC,GAAG,YAAY;aAChB;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC;AACH,CAAC","debugId":"0e2102ef-7489-53f5-b639-1e3d582eaf63"}

package/dist/core/store/paths.d.ts

@@ -7,6 +7,8 @@ declare const ITEM_FORMAT_BY_EXTENSION: {
 };
 /** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */
 export declare const ITEM_FILE_EXTENSIONS: Array<keyof typeof ITEM_FORMAT_BY_EXTENSION>;
+/** Find a directly nested custom tracker root so recovery guidance can preserve existing data instead of recommending a second initialization. */
+export declare function discoverNearbyPmRoot(cwd: string, excludedRoot?: string): string | undefined;
 /** Implements resolve pm root for the public runtime surface of this module. */
 export declare function resolvePmRoot(cwd: string, cliPath?: string): string;
 /** Resolve the project workspace that owns a tracker root. */

package/dist/core/store/paths.js

@@ -4,8 +4,8 @@
  * Reads and writes tracker storage with format-aware helpers for Paths.
  */
 
-!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]="c608ecfa-22ff-57f1-ba73-5c9d9dcda559")}catch(e){}}();
-import { readFileSync, statSync } from "node:fs";
+!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]="d048a0fa-7ce5-56bf-90b4-beec55a3cb93")}catch(e){}}();
+import { readFileSync, readdirSync, statSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { PM_DIRNAME, SETTINGS_FILENAME, TYPE_TO_FOLDER, } from "../shared/constants.js";
@@ -19,6 +19,12 @@ const ITEM_FORMAT_BY_EXTENSION = {
     ".md": "json_markdown",
     ".toon": "toon",
 };
+const NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES = new Set([
+    ".git",
+    "coverage",
+    "dist",
+    "node_modules",
+]);
 /** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */
 export const ITEM_FILE_EXTENSIONS = [".md", ".toon"];
 function pathExists(pathValue) {
@@ -73,6 +79,23 @@ function discoverPmRootFromAncestors(cwd) {
         current = parent;
     }
 }
+/** Find a directly nested custom tracker root so recovery guidance can preserve existing data instead of recommending a second initialization. */
+export function discoverNearbyPmRoot(cwd, excludedRoot) {
+    const normalizedExcluded = excludedRoot ? path.resolve(excludedRoot) : undefined;
+    try {
+        return readdirSync(path.resolve(cwd), { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() &&
+            !NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES.has(entry.name))
+            .map((entry) => path.join(path.resolve(cwd), entry.name))
+            .filter((candidate) => candidate !== normalizedExcluded)
+            .filter((candidate) => pathExists(getSettingsPath(candidate)))
+            .filter((candidate) => isPmSettingsFile(getSettingsPath(candidate)))
+            .sort((left, right) => left.localeCompare(right))[0];
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Implements resolve pm root for the public runtime surface of this module. */
 export function resolvePmRoot(cwd, cliPath) {
     const envPath = process.env.PM_PATH;
@@ -187,4 +210,4 @@ export function getTestRunResultPath(pmRoot, runId) {
     return path.join(getTestRunsResultsPath(pmRoot), `${runId}.json`);
 }
 //# sourceMappingURL=paths.js.map
-//# debugId=c608ecfa-22ff-57f1-ba73-5c9d9dcda559
+//# debugId=d048a0fa-7ce5-56bf-90b4-beec55a3cb93

package/dist/core/store/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sources":["core/store/paths.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/store/paths\n *\n * Reads and writes tracker storage with format-aware helpers for Paths.\n */\nimport { readFileSync, statSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport {\n  PM_DIRNAME,\n  SETTINGS_FILENAME,\n  TYPE_TO_FOLDER,\n} from \"../shared/constants.js\";\nimport { toDefaultFolder } from \"../item/type-registry.js\";\nimport type { ItemFormat, ItemType } from \"../../types/index.js\";\n\n/** Public contract for item file extension by format, shared by SDK and presentation-layer consumers. */\nexport const ITEM_FILE_EXTENSION_BY_FORMAT: Record<\n  ItemFormat,\n  \".md\" | \".toon\"\n> = {\n  json_markdown: \".md\",\n  toon: \".toon\",\n};\n\nconst ITEM_FORMAT_BY_EXTENSION = {\n  \".md\": \"json_markdown\",\n  \".toon\": \"toon\",\n} as const satisfies Record<string, ItemFormat>;\n\n/** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */\nexport const ITEM_FILE_EXTENSIONS: Array<\n  keyof typeof ITEM_FORMAT_BY_EXTENSION\n> = [\".md\", \".toon\"];\n\nfunction pathExists(pathValue: string): boolean {\n  try {\n    statSync(pathValue);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// Adopting a bare <dir>/settings.json during implicit ancestor discovery must\n// not let an unrelated tool's settings.json hijack tracker resolution (and\n// receive pm writes), so root-layout candidates need a pm-specific marker.\n// `pm init` always writes both markers; explicit --path/PM_PATH targets skip\n// this check because they carry user intent.\nfunction isPmSettingsFile(settingsPath: string): boolean {\n  try {\n    const parsed: unknown = JSON.parse(readFileSync(settingsPath, \"utf8\"));\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      Array.isArray(parsed)\n    ) {\n      return false;\n    }\n    return \"id_prefix\" in parsed || \"item_format\" in parsed;\n  } catch {\n    return false;\n  }\n}\n\nfunction discoverPmRootFromAncestors(cwd: string): string | undefined {\n  let current = path.resolve(cwd);\n  while (true) {\n    const candidateRoot = path.join(current, PM_DIRNAME);\n    const candidateSettingsPath = path.join(candidateRoot, SETTINGS_FILENAME);\n    if (pathExists(candidateSettingsPath)) {\n      return candidateRoot;\n    }\n    // Root-layout trackers (`pm init <dir>` writes settings.json directly into\n    // <dir>) must be discoverable too; otherwise implicit invocations — and the\n    // pm_root handed to extensions — fall back to a non-existent\n    // <cwd>/.agents/pm (GH-495).\n    const rootLayoutSettingsPath = path.join(current, SETTINGS_FILENAME);\n    if (\n      pathExists(rootLayoutSettingsPath) &&\n      isPmSettingsFile(rootLayoutSettingsPath)\n    ) {\n      return current;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n}\n\n/** Implements resolve pm root for the public runtime surface of this module. */\nexport function resolvePmRoot(cwd: string, cliPath?: string): string {\n  const envPath = process.env.PM_PATH;\n  const explicitPath = cliPath?.trim() || envPath?.trim();\n  if (explicitPath) {\n    const resolved = path.resolve(cwd, explicitPath);\n    // When an explicit --path/PM_PATH points at a project root that contains an\n    // initialized `.agents/pm`, resolve into it. Without this, an agent passing\n    // the directory where it ran `pm init` (which creates `<dir>/.agents/pm`)\n    // hits a hard \"tracker not initialized\" dead-end, while cwd discovery walks\n    // up to find the same `.agents/pm`. We only redirect when the path itself is\n    // not already a tracker root, so `pm init --path <dir>` (which writes\n    // `<dir>/settings.json` directly) and existing tracker roots keep working.\n    if (!pathExists(getSettingsPath(resolved))) {\n      const nestedRoot = path.join(resolved, PM_DIRNAME);\n      if (pathExists(getSettingsPath(nestedRoot))) {\n        return nestedRoot;\n      }\n    }\n    return resolved;\n  }\n  const discoveredRoot = discoverPmRootFromAncestors(cwd);\n  if (discoveredRoot) {\n    return discoveredRoot;\n  }\n  const selected = PM_DIRNAME;\n  return path.resolve(cwd, selected);\n}\n\n/** Resolve the project workspace that owns a tracker root. */\nexport function resolveWorkspaceRoot(pmRoot: string): string {\n  const normalizedRoot = path.resolve(pmRoot);\n  const parent = path.dirname(normalizedRoot);\n  return path.basename(normalizedRoot) === \"pm\" && path.basename(parent) === \".agents\"\n    ? path.dirname(parent)\n    : normalizedRoot;\n}\n\n/** Implements resolve global pm root for the public runtime surface of this module. */\nexport function resolveGlobalPmRoot(cwd: string): string {\n  const envPath = process.env.PM_GLOBAL_PATH?.trim();\n  const selected =\n    envPath && envPath.length > 0\n      ? envPath\n      : path.join(os.homedir(), \".pm-cli\");\n  return path.resolve(cwd, selected);\n}\n\n/** Implements get settings path for the public runtime surface of this module. */\nexport function getSettingsPath(pmRoot: string): string {\n  return path.join(pmRoot, SETTINGS_FILENAME);\n}\n\n/** Implements get type dir path for the public runtime surface of this module. */\nexport function getTypeDirPath(\n  pmRoot: string,\n  type: ItemType,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): string {\n  const folder = typeToFolder[type] ?? toDefaultFolder(type);\n  return path.join(pmRoot, folder);\n}\n\n/** Implements get item path for the public runtime surface of this module. */\nexport function getItemPath(\n  pmRoot: string,\n  type: ItemType,\n  id: string,\n  itemFormat: ItemFormat = \"toon\",\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): string {\n  return path.join(\n    getTypeDirPath(pmRoot, type, typeToFolder),\n    `${id}${ITEM_FILE_EXTENSION_BY_FORMAT[itemFormat]}`,\n  );\n}\n\n/** Implements get item format from path for the public runtime surface of this module. */\nexport function getItemFormatFromPath(itemPath: string): ItemFormat | null {\n  const normalizedItemPath = itemPath.replaceAll(\"\\\\\", \"/\");\n  const extension = path.posix\n    .extname(normalizedItemPath)\n    .toLowerCase() as keyof typeof ITEM_FORMAT_BY_EXTENSION;\n  return ITEM_FORMAT_BY_EXTENSION[extension] ?? null;\n}\n\n/** Implements get history path for the public runtime surface of this module. */\nexport function getHistoryPath(pmRoot: string, id: string): string {\n  return path.join(pmRoot, \"history\", `${id}.jsonl`);\n}\n\n/** Implements get lock path for the public runtime surface of this module. */\nexport function getLockPath(pmRoot: string, id: string): string {\n  return path.join(pmRoot, \"locks\", `${id}.lock`);\n}\n\n/** Implements get runtime path for the public runtime surface of this module. */\nexport function getRuntimePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\");\n}\n\n/** Implements get test runs path for the public runtime surface of this module. */\nexport function getTestRunsPath(pmRoot: string): string {\n  return path.join(getRuntimePath(pmRoot), \"test-runs\");\n}\n\n/** Implements get test runs records path for the public runtime surface of this module. */\nexport function getTestRunsRecordsPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"runs\");\n}\n\n/** Implements get test run record path for the public runtime surface of this module. */\nexport function getTestRunRecordPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsRecordsPath(pmRoot), `${runId}.json`);\n}\n\n/** Implements get test runs stdout path for the public runtime surface of this module. */\nexport function getTestRunsStdoutPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"stdout\");\n}\n\n/** Implements get test runs stderr path for the public runtime surface of this module. */\nexport function getTestRunsStderrPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"stderr\");\n}\n\n/** Implements get test run stdout path for the public runtime surface of this module. */\nexport function getTestRunStdoutPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsStdoutPath(pmRoot), `${runId}.log`);\n}\n\n/** Implements get test run stderr path for the public runtime surface of this module. */\nexport function getTestRunStderrPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsStderrPath(pmRoot), `${runId}.log`);\n}\n\n/** Implements get test runs results path for the public runtime surface of this module. */\nexport function getTestRunsResultsPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"results\");\n}\n\n/** Implements get test run result path for the public runtime surface of this module. */\nexport function getTestRunResultPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsResultsPath(pmRoot), `${runId}.json`);\n}\n"],"names":[],"mappings":"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","debugId":"c608ecfa-22ff-57f1-ba73-5c9d9dcda559"}
+{"version":3,"file":"paths.js","sources":["core/store/paths.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/store/paths\n *\n * Reads and writes tracker storage with format-aware helpers for Paths.\n */\nimport { readFileSync, readdirSync, statSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport {\n  PM_DIRNAME,\n  SETTINGS_FILENAME,\n  TYPE_TO_FOLDER,\n} from \"../shared/constants.js\";\nimport { toDefaultFolder } from \"../item/type-registry.js\";\nimport type { ItemFormat, ItemType } from \"../../types/index.js\";\n\n/** Public contract for item file extension by format, shared by SDK and presentation-layer consumers. */\nexport const ITEM_FILE_EXTENSION_BY_FORMAT: Record<\n  ItemFormat,\n  \".md\" | \".toon\"\n> = {\n  json_markdown: \".md\",\n  toon: \".toon\",\n};\n\nconst ITEM_FORMAT_BY_EXTENSION = {\n  \".md\": \"json_markdown\",\n  \".toon\": \"toon\",\n} as const satisfies Record<string, ItemFormat>;\n\nconst NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES = new Set([\n  \".git\",\n  \"coverage\",\n  \"dist\",\n  \"node_modules\",\n]);\n\n/** Public contract for item file extensions, shared by SDK and presentation-layer consumers. */\nexport const ITEM_FILE_EXTENSIONS: Array<\n  keyof typeof ITEM_FORMAT_BY_EXTENSION\n> = [\".md\", \".toon\"];\n\nfunction pathExists(pathValue: string): boolean {\n  try {\n    statSync(pathValue);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// Adopting a bare <dir>/settings.json during implicit ancestor discovery must\n// not let an unrelated tool's settings.json hijack tracker resolution (and\n// receive pm writes), so root-layout candidates need a pm-specific marker.\n// `pm init` always writes both markers; explicit --path/PM_PATH targets skip\n// this check because they carry user intent.\nfunction isPmSettingsFile(settingsPath: string): boolean {\n  try {\n    const parsed: unknown = JSON.parse(readFileSync(settingsPath, \"utf8\"));\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      Array.isArray(parsed)\n    ) {\n      return false;\n    }\n    return \"id_prefix\" in parsed || \"item_format\" in parsed;\n  } catch {\n    return false;\n  }\n}\n\nfunction discoverPmRootFromAncestors(cwd: string): string | undefined {\n  let current = path.resolve(cwd);\n  while (true) {\n    const candidateRoot = path.join(current, PM_DIRNAME);\n    const candidateSettingsPath = path.join(candidateRoot, SETTINGS_FILENAME);\n    if (pathExists(candidateSettingsPath)) {\n      return candidateRoot;\n    }\n    // Root-layout trackers (`pm init <dir>` writes settings.json directly into\n    // <dir>) must be discoverable too; otherwise implicit invocations — and the\n    // pm_root handed to extensions — fall back to a non-existent\n    // <cwd>/.agents/pm (GH-495).\n    const rootLayoutSettingsPath = path.join(current, SETTINGS_FILENAME);\n    if (\n      pathExists(rootLayoutSettingsPath) &&\n      isPmSettingsFile(rootLayoutSettingsPath)\n    ) {\n      return current;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n}\n\n/** Find a directly nested custom tracker root so recovery guidance can preserve existing data instead of recommending a second initialization. */\nexport function discoverNearbyPmRoot(\n  cwd: string,\n  excludedRoot?: string,\n): string | undefined {\n  const normalizedExcluded = excludedRoot ? path.resolve(excludedRoot) : undefined;\n  try {\n    return readdirSync(path.resolve(cwd), { withFileTypes: true })\n      .filter(\n        (entry) =>\n          entry.isDirectory() &&\n          !NEARBY_TRACKER_SCAN_IGNORED_DIRECTORIES.has(entry.name),\n      )\n      .map((entry) => path.join(path.resolve(cwd), entry.name))\n      .filter((candidate) => candidate !== normalizedExcluded)\n      .filter((candidate) => pathExists(getSettingsPath(candidate)))\n      .filter((candidate) => isPmSettingsFile(getSettingsPath(candidate)))\n      .sort((left, right) => left.localeCompare(right))[0];\n  } catch {\n    return undefined;\n  }\n}\n\n/** Implements resolve pm root for the public runtime surface of this module. */\nexport function resolvePmRoot(cwd: string, cliPath?: string): string {\n  const envPath = process.env.PM_PATH;\n  const explicitPath = cliPath?.trim() || envPath?.trim();\n  if (explicitPath) {\n    const resolved = path.resolve(cwd, explicitPath);\n    // When an explicit --path/PM_PATH points at a project root that contains an\n    // initialized `.agents/pm`, resolve into it. Without this, an agent passing\n    // the directory where it ran `pm init` (which creates `<dir>/.agents/pm`)\n    // hits a hard \"tracker not initialized\" dead-end, while cwd discovery walks\n    // up to find the same `.agents/pm`. We only redirect when the path itself is\n    // not already a tracker root, so `pm init --path <dir>` (which writes\n    // `<dir>/settings.json` directly) and existing tracker roots keep working.\n    if (!pathExists(getSettingsPath(resolved))) {\n      const nestedRoot = path.join(resolved, PM_DIRNAME);\n      if (pathExists(getSettingsPath(nestedRoot))) {\n        return nestedRoot;\n      }\n    }\n    return resolved;\n  }\n  const discoveredRoot = discoverPmRootFromAncestors(cwd);\n  if (discoveredRoot) {\n    return discoveredRoot;\n  }\n  const selected = PM_DIRNAME;\n  return path.resolve(cwd, selected);\n}\n\n/** Resolve the project workspace that owns a tracker root. */\nexport function resolveWorkspaceRoot(pmRoot: string): string {\n  const normalizedRoot = path.resolve(pmRoot);\n  const parent = path.dirname(normalizedRoot);\n  return path.basename(normalizedRoot) === \"pm\" && path.basename(parent) === \".agents\"\n    ? path.dirname(parent)\n    : normalizedRoot;\n}\n\n/** Implements resolve global pm root for the public runtime surface of this module. */\nexport function resolveGlobalPmRoot(cwd: string): string {\n  const envPath = process.env.PM_GLOBAL_PATH?.trim();\n  const selected =\n    envPath && envPath.length > 0\n      ? envPath\n      : path.join(os.homedir(), \".pm-cli\");\n  return path.resolve(cwd, selected);\n}\n\n/** Implements get settings path for the public runtime surface of this module. */\nexport function getSettingsPath(pmRoot: string): string {\n  return path.join(pmRoot, SETTINGS_FILENAME);\n}\n\n/** Implements get type dir path for the public runtime surface of this module. */\nexport function getTypeDirPath(\n  pmRoot: string,\n  type: ItemType,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): string {\n  const folder = typeToFolder[type] ?? toDefaultFolder(type);\n  return path.join(pmRoot, folder);\n}\n\n/** Implements get item path for the public runtime surface of this module. */\nexport function getItemPath(\n  pmRoot: string,\n  type: ItemType,\n  id: string,\n  itemFormat: ItemFormat = \"toon\",\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n): string {\n  return path.join(\n    getTypeDirPath(pmRoot, type, typeToFolder),\n    `${id}${ITEM_FILE_EXTENSION_BY_FORMAT[itemFormat]}`,\n  );\n}\n\n/** Implements get item format from path for the public runtime surface of this module. */\nexport function getItemFormatFromPath(itemPath: string): ItemFormat | null {\n  const normalizedItemPath = itemPath.replaceAll(\"\\\\\", \"/\");\n  const extension = path.posix\n    .extname(normalizedItemPath)\n    .toLowerCase() as keyof typeof ITEM_FORMAT_BY_EXTENSION;\n  return ITEM_FORMAT_BY_EXTENSION[extension] ?? null;\n}\n\n/** Implements get history path for the public runtime surface of this module. */\nexport function getHistoryPath(pmRoot: string, id: string): string {\n  return path.join(pmRoot, \"history\", `${id}.jsonl`);\n}\n\n/** Implements get lock path for the public runtime surface of this module. */\nexport function getLockPath(pmRoot: string, id: string): string {\n  return path.join(pmRoot, \"locks\", `${id}.lock`);\n}\n\n/** Implements get runtime path for the public runtime surface of this module. */\nexport function getRuntimePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\");\n}\n\n/** Implements get test runs path for the public runtime surface of this module. */\nexport function getTestRunsPath(pmRoot: string): string {\n  return path.join(getRuntimePath(pmRoot), \"test-runs\");\n}\n\n/** Implements get test runs records path for the public runtime surface of this module. */\nexport function getTestRunsRecordsPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"runs\");\n}\n\n/** Implements get test run record path for the public runtime surface of this module. */\nexport function getTestRunRecordPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsRecordsPath(pmRoot), `${runId}.json`);\n}\n\n/** Implements get test runs stdout path for the public runtime surface of this module. */\nexport function getTestRunsStdoutPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"stdout\");\n}\n\n/** Implements get test runs stderr path for the public runtime surface of this module. */\nexport function getTestRunsStderrPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"stderr\");\n}\n\n/** Implements get test run stdout path for the public runtime surface of this module. */\nexport function getTestRunStdoutPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsStdoutPath(pmRoot), `${runId}.log`);\n}\n\n/** Implements get test run stderr path for the public runtime surface of this module. */\nexport function getTestRunStderrPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsStderrPath(pmRoot), `${runId}.log`);\n}\n\n/** Implements get test runs results path for the public runtime surface of this module. */\nexport function getTestRunsResultsPath(pmRoot: string): string {\n  return path.join(getTestRunsPath(pmRoot), \"results\");\n}\n\n/** Implements get test run result path for the public runtime surface of this module. */\nexport function getTestRunResultPath(pmRoot: string, runId: string): string {\n  return path.join(getTestRunsResultsPath(pmRoot), `${runId}.json`);\n}\n"],"names":[],"mappings":"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","debugId":"d048a0fa-7ce5-56bf-90b4-beec55a3cb93"}

package/dist/sdk/cli-contracts/enum-contracts.d.ts

@@ -19,7 +19,7 @@ export declare const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS: readonly ["none", "
 /** Restricts pm extension sandbox profile contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS)[number];
 /** Public contract for pm extension policy surface contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
+export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.relationshipkinds", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
 /** Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 /** Public contract for pm core command names, shared by SDK and presentation-layer consumers. */

package/dist/sdk/compose.d.ts

@@ -29,6 +29,7 @@ import type { AfterCommandHook, BeforeCommandHook, CommandDefinition, CommandOve
 import type { ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
 import type { ProjectProfileRegistrationInput } from "../core/profile/profile-presets.js";
 import type { PmMaxVersionExceededMode } from "../core/extensions/extension-types.js";
+import type { RelationshipKindDefinition } from "./relationships.js";
 import { type PmVersionBoundKind } from "../core/extensions/version-compat.js";
 /**
  * Documents the extension module payload exchanged by command, SDK, and package integrations.
@@ -139,6 +140,8 @@ export interface ExtensionBlueprint {
     itemTypes?: SchemaItemTypeDefinition[];
     /** Custom item-metadata fields registered in a single `api.registerItemFields(fields)` call. */
     itemFields?: SchemaFieldDefinition[];
+    /** Versioned relationship semantics registered in one atomic batch. */
+    relationshipKinds?: RelationshipKindDefinition[];
     /** Schema migrations registered one at a time via `api.registerMigration(definition)`. */
     migrations?: SchemaMigrationDefinition[];
     /** Project profiles registered one at a time via `api.registerProfile(profile)`. */

package/dist/sdk/compose.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d2ae1af2-9303-517a-97bb-abd697e725b0")}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]="7deb88bd-5556-5c09-baff-cce614cc9dca")}catch(e){}}();
 import { normalizeKnownExtensionCapability, resolveLegacyExtensionCapabilityAlias, } from "../core/extensions/extension-capability-aliases.js";
 import { normalizeCommandName } from "../core/extensions/extension-runtime-helpers.js";
 import { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
@@ -74,6 +74,10 @@ function registerBlueprintSchemaSurfaces(api, blueprint) {
     if (itemFields.length > 0) {
         api.registerItemFields(itemFields);
     }
+    const relationshipKinds = blueprint.relationshipKinds ?? [];
+    if (relationshipKinds.length > 0) {
+        api.registerRelationshipKinds(relationshipKinds);
+    }
     for (const migration of blueprint.migrations ?? []) {
         api.registerMigration(migration);
     }
@@ -261,6 +265,7 @@ export function mergeExtensionBlueprints(...blueprints) {
     assign("preflights", mergeArraySurface(blueprints.map((blueprint) => blueprint.preflights)));
     assign("itemTypes", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemTypes)));
     assign("itemFields", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemFields)));
+    assign("relationshipKinds", mergeArraySurface(blueprints.map((blueprint) => blueprint.relationshipKinds)));
     assign("migrations", mergeArraySurface(blueprints.map((blueprint) => blueprint.migrations)));
     assign("profiles", mergeArraySurface(blueprints.map((blueprint) => blueprint.profiles)));
     assign("searchProviders", mergeArraySurface(blueprints.map((blueprint) => blueprint.searchProviders)));
@@ -332,6 +337,7 @@ const BLUEPRINT_FIELD_CAPABILITIES = [
     ["flags", "schema"],
     ["itemTypes", "schema"],
     ["itemFields", "schema"],
+    ["relationshipKinds", "schema"],
     ["migrations", "schema"],
     ["profiles", "schema"],
     ["parsers", "parser"],
@@ -478,6 +484,11 @@ function collectBlueprintSurfaceSummary(blueprint, importers, exporters) {
     return {
         item_types: sortUnique((blueprint.itemTypes ?? []).map((type) => type.name)),
         item_fields: sortUnique((blueprint.itemFields ?? []).map((field) => field.name)),
+        ...((blueprint.relationshipKinds?.length ?? 0) > 0
+            ? {
+                relationship_kinds: sortUnique(blueprint.relationshipKinds.map((definition) => definition.kind)),
+            }
+            : {}),
         // id-less migrations register but carry no identifier, so they are omitted —
         // exactly as describeExtensionActivation drops them from its `migrations` list.
         migrations: sortUnique((blueprint.migrations ?? []).flatMap((migration) => typeof migration.id === "string" ? [migration.id] : [])),
@@ -561,6 +572,7 @@ const BLUEPRINT_LINTABLE_SURFACE_FIELDS = [
     "preflights",
     "itemTypes",
     "itemFields",
+    "relationshipKinds",
     "migrations",
     "profiles",
     "searchProviders",
@@ -981,4 +993,4 @@ export function preflightExtension(blueprint, options = {}) {
     };
 }
 //# sourceMappingURL=compose.js.map
-//# debugId=d2ae1af2-9303-517a-97bb-abd697e725b0
+//# debugId=7deb88bd-5556-5c09-baff-cce614cc9dca