@unbrained/pm-cli 2026.6.13 → 2026.6.16

package/dist/cli-bundle/chunks/{chunk-XXLMJDUB.js → chunk-4KBK4BA3.js}

@@ -1,18 +1,18 @@
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-LGOXXQUW.js";
+} from "./chunk-WZCQVABQ.js";
 import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-MACCNKSZ.js";
+} from "./chunk-GYMG7AG6.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-W6KNFAMZ.js";
+} from "./chunk-6BV7ENQL.js";
 import {
   nowIso
-} from "./chunk-IXVSSHGV.js";
+} from "./chunk-OY3P2I6B.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -42,13 +42,13 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-LV5FFQ7M.js";
 
 // dist/core/extensions/item-fields.js
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1d92831e-54a7-5c1f-af04-7441908e8e5a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a347b372-2690-5b65-a35c-7d2cfa3790d1");
   } catch (e2) {
   }
 })();
@@ -81,9 +81,6 @@ function parseFieldAssignment(raw) {
   }
   const key = trimmed.slice(0, separatorIndex).trim();
   const value = trimmed.slice(separatorIndex + 1);
-  if (key.length === 0) {
-    throw new PmCliError("--field entries require a non-empty field name", EXIT_CODE.USAGE);
-  }
   return { key, value };
 }
 function parseJsonFieldValue(raw, fieldName, expectedType) {
@@ -253,7 +250,7 @@ import jsonPatch from "fast-json-patch";
 !(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] = "9a356560-3dec-5529-a2b5-1b4224116c14");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b165ab2e-26f4-5ccd-83f4-39b5cf86c2cf");
   } catch (e2) {
   }
 })();
@@ -462,7 +459,7 @@ import path2 from "node:path";
 !(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] = "5747034b-5b93-59ff-8764-7594ff8c0617");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1a8d523b-e42a-54c0-98b8-2cf802a795ef");
   } catch (e2) {
   }
 })();
@@ -930,7 +927,7 @@ import path4 from "node:path";
 !(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] = "19b07c25-5234-52e7-9418-630480f5e1b1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d6538d11-5ec9-5c34-88ab-d477e36eaf06");
   } catch (e2) {
   }
 })();
@@ -1011,7 +1008,8 @@ async function listAllFrontMatterWithBody(pmRoot, preferredFormat, typeToFolder
   const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, { includeBody: true });
   return candidates.map((candidate) => ({
     ...candidate.metadata,
-    body: candidate.body ?? ""
+    // includeBody:true guarantees candidate bodies are materialized.
+    body: candidate.body
   }));
 }
 async function listKnownItemIds(pmRoot, typeToFolder) {
@@ -1051,7 +1049,7 @@ async function buildItemNotFoundError(pmRoot, badId, idPrefix, typeToFolder) {
   return new PmCliError(`Item ${badId} not found`, EXIT_CODE.NOT_FOUND, { nextSteps });
 }
 function bypassesAssigneeConflict(op, bypassAssigneeConflict) {
-  return op === "claim" || bypassAssigneeConflict === true && (op === "comment_add" || op === "note_add" || op === "learning_add" || op === "release" || op === "update" || op === "update_audit");
+  return op === "claim" || bypassAssigneeConflict === true && (op === "comment_add" || op === "comment_edit" || op === "comment_delete" || op === "note_add" || op === "learning_add" || op === "release" || op === "update" || op === "update_audit");
 }
 async function prepareLockedItem(params) {
   const typeToFolder = params.typeToFolder ?? resolveItemTypeRegistry(params.settings, getActiveExtensionRegistrations()).type_to_folder;
@@ -1363,4 +1361,4 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-XXLMJDUB.js.map
+//# sourceMappingURL=chunk-4KBK4BA3.js.map

package/dist/cli-bundle/chunks/chunk-4KBK4BA3.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/extensions/item-fields.ts", "../../../../../../../../core/item/item-record.ts", "../../../../../../../../core/history/history.ts", "../../../../../../../../core/history/history-stream-policy.ts", "../../../../../../../../core/lock/lock.ts", "../../../../../../../../core/store/front-matter-cache.ts", "../../../../../../../../core/store/item-store.ts"],
+  "sourcesContent": ["import type { ExtensionRegistrationRegistry } from \"./loader.js\";\nimport { normalizeItemFieldType, type KnownItemFieldType } from \"./item-field-types.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);\n\nfunction normalizeFieldName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeFieldType(value: unknown): KnownItemFieldType | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  return normalizeItemFieldType(value);\n}\n\nfunction cloneFieldValue<T>(value: T): T {\n  try {\n    return structuredClone(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction parseFieldAssignment(raw: string): { key: string; value: string } {\n  const trimmed = raw.trim();\n  const separatorIndex = trimmed.indexOf(\"=\");\n  if (separatorIndex <= 0) {\n    throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);\n  }\n  // `separatorIndex > 0` guarantees a non-`=` first character on the already\n  // trimmed string, so the trimmed key is always non-empty here.\n  const key = trimmed.slice(0, separatorIndex).trim();\n  const value = trimmed.slice(separatorIndex + 1);\n  return { key, value };\n}\n\nfunction parseJsonFieldValue(raw: string, fieldName: string, expectedType: \"array\" | \"object\"): unknown {\n  try {\n    const parsed = JSON.parse(raw);\n    if (expectedType === \"array\" && Array.isArray(parsed)) {\n      return parsed;\n    }\n    if (expectedType === \"object\" && typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Fall through to the typed usage error below.\n  }\n  throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);\n}\n\nfunction coerceRegisteredFieldValue(fieldName: string, fieldType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\", raw: string): unknown {\n  if (fieldType === \"string\") {\n    return raw;\n  }\n  if (fieldType === \"number\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    const parsed = Number(trimmed);\n    if (!Number.isFinite(parsed)) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n  if (fieldType === \"boolean\") {\n    const normalized = raw.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n      return false;\n    }\n    throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n  }\n  return parseJsonFieldValue(raw, fieldName, fieldType);\n}\n\nfunction collectRegisteredFieldDefinitions(\n  registrations: ExtensionRegistrationRegistry | null,\n): Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }> {\n  const definitions = new Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }>();\n  if (!registrations) {\n    return definitions;\n  }\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      const fieldType = normalizeFieldType(definition.type);\n      if (!fieldName || !fieldType) {\n        continue;\n      }\n      const existing = definitions.get(fieldName);\n      if (existing && existing.type !== fieldType) {\n        throw new PmCliError(\n          `Extension item field \"${fieldName}\" is declared with conflicting types: ${existing.type}, ${fieldType}`,\n          EXIT_CODE.USAGE,\n          {\n            code: \"extension_item_field_type_conflict\",\n            nextSteps: [\"Make every active extension declaration for this field use the same type.\"],\n          },\n        );\n      }\n      definitions.set(fieldName, { name: fieldName, type: fieldType });\n    }\n  }\n  return definitions;\n}\n\nfunction assertNotReservedItemFieldName(fieldName: string): void {\n  if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {\n    return;\n  }\n  throw new PmCliError(`Extension item field \"${fieldName}\" collides with reserved item metadata`, EXIT_CODE.USAGE, {\n    code: \"extension_item_field_reserved\",\n    nextSteps: [\"Rename the extension item field, preferably with an extension-specific prefix.\"],\n  });\n}\n\nexport function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[] {\n  return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));\n}\n\nexport function parseRegisteredItemFieldAssignments(\n  rawFields: string[] | undefined,\n  registrations: ExtensionRegistrationRegistry | null,\n): Record<string, unknown> {\n  if (!rawFields || rawFields.length === 0) {\n    return {};\n  }\n  const definitions = collectRegisteredFieldDefinitions(registrations);\n  const values: Record<string, unknown> = {};\n  for (const raw of rawFields) {\n    const { key, value } = parseFieldAssignment(raw);\n    const definition = definitions.get(key);\n    if (!definition) {\n      const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));\n      throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {\n        code: \"extension_item_field_unknown\",\n        recovery: { provided_fields: known },\n        nextSteps: known.length > 0\n          ? [`Use one of the declared fields: ${known.join(\", \")}`]\n          : [\"Activate an extension that calls registerItemFields before setting extension fields.\"],\n      });\n    }\n    assertNotReservedItemFieldName(definition.name);\n    values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);\n  }\n  return values;\n}\n\nfunction isValidFieldType(value: unknown, expectedType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\"): boolean {\n  if (expectedType === \"string\") {\n    return typeof value === \"string\";\n  }\n  if (expectedType === \"number\") {\n    return typeof value === \"number\" && Number.isFinite(value);\n  }\n  if (expectedType === \"boolean\") {\n    return typeof value === \"boolean\";\n  }\n  if (expectedType === \"array\") {\n    return Array.isArray(value);\n  }\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isAllowedFieldValue(value: unknown, allowed: unknown[] | undefined): boolean {\n  if (!allowed || allowed.length === 0) {\n    return true;\n  }\n  return allowed.some((candidate) => Object.is(candidate, value));\n}\n\nexport function applyRegisteredItemFieldDefaultsAndValidation(\n  frontMatter: Record<string, unknown>,\n  registrations: ExtensionRegistrationRegistry | null,\n  options: { skipDefaultFields?: ReadonlySet<string> } = {},\n): void {\n  if (!registrations) {\n    return;\n  }\n  collectRegisteredFieldDefinitions(registrations);\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      if (!fieldName) {\n        continue;\n      }\n      assertNotReservedItemFieldName(fieldName);\n      if (\n        !(fieldName in frontMatter) &&\n        !options.skipDefaultFields?.has(fieldName) &&\n        Object.prototype.hasOwnProperty.call(definition, \"default\")\n      ) {\n        frontMatter[fieldName] = cloneFieldValue(definition.default);\n      }\n\n      const currentValue = frontMatter[fieldName];\n      if (currentValue === undefined) {\n        continue;\n      }\n      const expectedType = normalizeFieldType(definition.type);\n      if (expectedType && !isValidFieldType(currentValue, expectedType)) {\n        throw new TypeError(`Item field \"${fieldName}\" must be of type ${expectedType}`);\n      }\n\n      const allowedValues = Array.isArray(definition.values) ? definition.values : undefined;\n      if (!isAllowedFieldValue(currentValue, allowedValues)) {\n        throw new TypeError(`Item field \"${fieldName}\" must match one of the configured allowed values`);\n      }\n    }\n  }\n}\n", "import type { ItemMetadata } from \"../../types/index.js\";\n\n/**\n * Bridge a typed item record into the generic `Record<string, unknown>` shape\n * consumed by formatters, field projections, history canonicalization, and\n * JSON output paths.\n *\n * `ItemMetadata` carries an index signature, but the structural mismatch on its\n * concretely-typed fields means TypeScript still requires a double cast to widen\n * it. Centralizing that `as unknown as Record<string, unknown>` widening here\n * gives the type bridge a single, named, documented home instead of scattering\n * the cast across command and core modules.\n *\n * This is a compile-time-only widening: the returned value is the very same\n * object reference, with no runtime transformation. (It is intentionally\n * distinct from the runtime `asRecord*` guards in `core/shared/primitives.ts`,\n * which validate `typeof` at runtime.) `ItemFrontMatter` is an alias of\n * `ItemMetadata`, so front-matter values are accepted as-is.\n */\nexport function toItemRecord(item: ItemMetadata): Record<string, unknown> {\n  return item as unknown as Record<string, unknown>;\n}\n", "import jsonPatch from \"fast-json-patch\";\nimport { FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { runActiveServiceOverride } from \"../extensions/index.js\";\nimport { appendLineAtomic } from \"../fs/fs-utils.js\";\nimport { canonicalDocument } from \"../item/item-format.js\";\nimport { toItemRecord } from \"../item/item-record.js\";\nimport { orderObject, sha256Hex, stableStringify } from \"../shared/serialization.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument } from \"../../types/index.js\";\n\nconst EMPTY_LEGACY_HASH_DOCUMENT = {\n  front_matter: {},\n  body: \"\",\n};\n\nfunction decodeJsonPointer(path: string): string[] {\n  if (!path || path === \"/\") {\n    return [];\n  }\n  if (!path.startsWith(\"/\")) {\n    return [];\n  }\n  return path\n    .slice(1)\n    .split(\"/\")\n    .map((segment) => segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n}\n\nfunction isDefinedPointerPath(document: unknown, path: string): boolean {\n  const segments = decodeJsonPointer(path);\n  if (segments.length === 0) {\n    return true;\n  }\n  let cursor: unknown = document;\n  for (const segment of segments) {\n    if (Array.isArray(cursor)) {\n      if (segment === \"-\" || !/^(0|[1-9]\\d*)$/.test(segment)) {\n        return false;\n      }\n      const index = Number(segment);\n      if (!Number.isInteger(index) || index < 0 || index >= cursor.length) {\n        return false;\n      }\n      const next = cursor[index];\n      if (next === undefined) {\n        return false;\n      }\n      cursor = next;\n      continue;\n    }\n    if (typeof cursor !== \"object\" || cursor === null) {\n      return false;\n    }\n    if (!Object.prototype.hasOwnProperty.call(cursor, segment)) {\n      return false;\n    }\n    const next = (cursor as Record<string, unknown>)[segment];\n    if (next === undefined) {\n      return false;\n    }\n    cursor = next;\n  }\n  return true;\n}\n\nfunction normalizeHistoryPatchOps(\n  beforeDocument: { metadata: Record<string, unknown>; body: string },\n  patch: HistoryPatchOp[],\n): HistoryPatchOp[] {\n  const normalized: HistoryPatchOp[] = [];\n  let replayCursor: unknown = structuredClone(beforeDocument);\n  for (const operation of patch) {\n    const normalizedOperation =\n      operation.op === \"replace\" && !isDefinedPointerPath(replayCursor, operation.path)\n        ? ({ ...operation, op: \"add\" } as HistoryPatchOp)\n        : operation;\n    normalized.push(normalizedOperation);\n    replayCursor = jsonPatch.applyPatch(\n      replayCursor,\n      [normalizedOperation as jsonPatch.Operation],\n      true,\n      true,\n    ).newDocument as unknown;\n  }\n  return normalized;\n}\n\nfunction canonicalHashDocument(document: ItemDocument): { front_matter: Record<string, unknown>; body: string } {\n  const hasMetadata = document.metadata && Object.keys(document.metadata).length > 0;\n  if (!hasMetadata) {\n    return {\n      front_matter: {},\n      body: document.body ?? \"\",\n    };\n  }\n  const canonical = canonicalDocument(document);\n  const orderedFrontMatter = orderObject(toItemRecord(canonical.metadata), FRONT_MATTER_KEY_ORDER);\n  return {\n    front_matter: orderedFrontMatter,\n    body: canonical.body,\n  };\n}\n\nfunction canonicalPatchDocument(document: ItemDocument): { metadata: Record<string, unknown>; body: string } {\n  const hasMetadata = document.metadata && Object.keys(document.metadata).length > 0;\n  if (!hasMetadata) {\n    return {\n      metadata: {},\n      body: document.body ?? \"\",\n    };\n  }\n  const canonical = canonicalDocument(document);\n  const orderedMetadata = orderObject(toItemRecord(canonical.metadata), FRONT_MATTER_KEY_ORDER);\n  return {\n    metadata: orderedMetadata,\n    body: canonical.body,\n  };\n}\n\nexport function hashDocument(document: ItemDocument): string {\n  return sha256Hex(stableStringify(canonicalHashDocument(document)));\n}\n\nexport function hashEmptyDocument(): string {\n  return sha256Hex(stableStringify(EMPTY_LEGACY_HASH_DOCUMENT));\n}\n\nexport function createHistoryEntry(params: {\n  nowIso: string;\n  author: string;\n  op: string;\n  before: ItemDocument;\n  after: ItemDocument;\n  message?: string;\n}): HistoryEntry {\n  const beforeHashCanonical = canonicalHashDocument(params.before);\n  const afterHashCanonical = canonicalHashDocument(params.after);\n  const beforePatchCanonical = canonicalPatchDocument(params.before);\n  const afterPatchCanonical = canonicalPatchDocument(params.after);\n  const rawPatch = jsonPatch.compare(beforePatchCanonical, afterPatchCanonical) as HistoryPatchOp[];\n  const patch = normalizeHistoryPatchOps(beforePatchCanonical, rawPatch);\n\n  return {\n    ts: params.nowIso,\n    author: params.author,\n    op: params.op,\n    patch,\n    before_hash: sha256Hex(stableStringify(beforeHashCanonical)),\n    after_hash: sha256Hex(stableStringify(afterHashCanonical)),\n    message: params.message === undefined ? undefined : params.message,\n  };\n}\n\nexport async function appendHistoryEntry(historyPath: string, entry: HistoryEntry): Promise<void> {\n  const override = await runActiveServiceOverride(\"history_append\", {\n    history_path: historyPath,\n    entry,\n  });\n  if (override.handled) {\n    if (override.result === false) {\n      return;\n    }\n    if (typeof override.result === \"string\") {\n      await appendLineAtomic(historyPath, override.result);\n      return;\n    }\n    if (typeof override.result === \"object\" && override.result !== null) {\n      const record = override.result as {\n        history_path?: unknown;\n        entry?: unknown;\n        line?: unknown;\n        skip?: unknown;\n      };\n      if (record.skip === true) {\n        return;\n      }\n      const nextHistoryPath = typeof record.history_path === \"string\" ? record.history_path : historyPath;\n      if (typeof record.line === \"string\") {\n        await appendLineAtomic(nextHistoryPath, record.line);\n        return;\n      }\n      const nextEntry = (record.entry ?? entry) as HistoryEntry;\n      await appendLineAtomic(nextHistoryPath, JSON.stringify(nextEntry));\n      return;\n    }\n  }\n  await appendLineAtomic(historyPath, JSON.stringify(entry));\n}\n\nexport const _testOnly = {\n  decodeJsonPointer,\n  isDefinedPointerPath,\n};\n", "import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnWriteHooks } from \"../extensions/index.js\";\nimport { ensureDir, pathExists } from \"../fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport type { PmSettings } from \"../../types/index.js\";\n\ninterface HistoryStreamPolicyParams {\n  pmRoot: string;\n  settings: PmSettings;\n  itemId: string;\n  commandLabel: string;\n}\n\ninterface HistoryStreamPolicyManyParams {\n  pmRoot: string;\n  settings: PmSettings;\n  itemIds: string[];\n  commandLabel: string;\n}\n\nexport interface HistoryStreamPolicyResult {\n  auto_created_ids: string[];\n  warnings: string[];\n}\n\nfunction toSortedUniqueItemIds(itemIds: string[]): string[] {\n  return [...new Set(itemIds.filter((value) => value.trim().length > 0))].sort((left, right) => left.localeCompare(right));\n}\n\nfunction strictMissingStreamError(itemId: string, commandLabel: string): PmCliError {\n  return new PmCliError(\n    `Missing history stream for ${itemId}. ${commandLabel} requires history streams when settings.history.missing_stream is strict_error.`,\n    EXIT_CODE.NOT_FOUND,\n  );\n}\n\nasync function createStream(historyPath: string, commandLabel: string): Promise<string[]> {\n  await ensureDir(path.dirname(historyPath));\n  const handle = await fs.open(historyPath, \"a\");\n  await handle.close();\n  return runActiveOnWriteHooks({\n    path: historyPath,\n    scope: \"project\",\n    op: `${commandLabel}:history:auto_create`,\n  });\n}\n\nexport async function enforceHistoryStreamPolicyForItem(params: HistoryStreamPolicyParams): Promise<HistoryStreamPolicyResult> {\n  return enforceHistoryStreamPolicyForItems({\n    pmRoot: params.pmRoot,\n    settings: params.settings,\n    itemIds: [params.itemId],\n    commandLabel: params.commandLabel,\n  });\n}\n\nexport async function enforceHistoryStreamPolicyForItems(\n  params: HistoryStreamPolicyManyParams,\n): Promise<HistoryStreamPolicyResult> {\n  const ids = toSortedUniqueItemIds(params.itemIds);\n  const autoCreated: string[] = [];\n  const warnings: string[] = [];\n\n  for (const itemId of ids) {\n    const historyPath = getHistoryPath(params.pmRoot, itemId);\n    if (await pathExists(historyPath)) {\n      continue;\n    }\n    if (params.settings.history.missing_stream === \"strict_error\") {\n      throw strictMissingStreamError(itemId, params.commandLabel);\n    }\n    warnings.push(...(await createStream(historyPath, params.commandLabel)));\n    warnings.push(`history_stream_auto_created:${itemId}`);\n    autoCreated.push(itemId);\n  }\n\n  return {\n    auto_created_ids: autoCreated,\n    warnings,\n  };\n}\n", "import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runActiveOnReadHooks, runActiveOnWriteHooks, runActiveServiceOverride } from \"../extensions/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { getLockPath } from \"../store/paths.js\";\nimport { nowIso } from \"../shared/time.js\";\n\ninterface LockInfo {\n  id: string;\n  pid: number;\n  owner: string;\n  created_at: string;\n  ttl_seconds: number;\n}\n\ntype LockWriteOp = \"lock:create\" | \"lock:release\" | \"lock:stale_remove\";\n\ninterface LockReadResult {\n  info: LockInfo | null;\n  warnings: string[];\n}\n\nfunction parseLockInfo(raw: string): LockReadResult {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return {\n      info: null,\n      warnings: [\"lock_info_invalid_json\"],\n    };\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return {\n      info: null,\n      warnings: [\"lock_info_invalid_shape\"],\n    };\n  }\n  const candidate = parsed as Record<string, unknown>;\n  const id = candidate.id;\n  const pid = candidate.pid;\n  const owner = candidate.owner;\n  const createdAt = candidate.created_at;\n  const ttlSeconds = candidate.ttl_seconds;\n  if (\n    typeof id !== \"string\" ||\n    typeof pid !== \"number\" ||\n    !Number.isFinite(pid) ||\n    typeof owner !== \"string\" ||\n    typeof createdAt !== \"string\" ||\n    typeof ttlSeconds !== \"number\" ||\n    !Number.isFinite(ttlSeconds)\n  ) {\n    return {\n      info: null,\n      warnings: [\"lock_info_invalid_shape\"],\n    };\n  }\n  return {\n    info: {\n      id,\n      pid,\n      owner,\n      created_at: createdAt,\n      ttl_seconds: ttlSeconds,\n    },\n    warnings: [],\n  };\n}\n\nasync function readLockInfo(lockPath: string): Promise<LockReadResult> {\n  try {\n    const raw = await fs.readFile(lockPath, \"utf8\");\n    await runActiveOnReadHooks({\n      path: lockPath,\n      scope: \"project\",\n    });\n    return parseLockInfo(raw);\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        info: null,\n        warnings: [],\n      };\n    }\n    return {\n      info: null,\n      warnings: [\"lock_info_read_failed\"],\n    };\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\nasync function emitLockWriteHook(lockPath: string, op: LockWriteOp): Promise<void> {\n  await runActiveOnWriteHooks({\n    path: lockPath,\n    scope: \"project\",\n    op,\n  });\n}\n\nfunction buildLockPayload(id: string, owner: string, ttlSeconds: number): LockInfo {\n  return {\n    id,\n    pid: process.pid,\n    owner,\n    created_at: nowIso(),\n    ttl_seconds: ttlSeconds,\n  };\n}\n\nasync function createLockFile(lockPath: string, id: string, owner: string, ttlSeconds: number): Promise<void> {\n  await fs.mkdir(path.dirname(lockPath), { recursive: true });\n  const handle = await fs.open(lockPath, \"wx\");\n  try {\n    await handle.writeFile(`${JSON.stringify(buildLockPayload(id, owner, ttlSeconds), null, 2)}\\n`, \"utf8\");\n  } finally {\n    await handle.close();\n  }\n  await emitLockWriteHook(lockPath, \"lock:create\");\n}\n\nasync function unlinkLockWithHook(lockPath: string, op: \"lock:release\" | \"lock:stale_remove\"): Promise<void> {\n  try {\n    await fs.unlink(lockPath);\n    await emitLockWriteHook(lockPath, op);\n  } catch {\n    // Lock cleanup is best-effort.\n  }\n}\n\nfunction isStaleLock(info: LockInfo | null, ttlSeconds: number): boolean {\n  const createdAtMs = info?.created_at ? Date.parse(info.created_at) : Number.NaN;\n  const ageMs = Number.isFinite(createdAtMs) ? Date.now() - createdAtMs : Number.POSITIVE_INFINITY;\n  return ageMs > ttlSeconds * 1000;\n}\n\nfunction lockOwnerSuffix(info: LockInfo | null): string {\n  return info?.owner ? ` (owner ${info.owner})` : \"\";\n}\n\nasync function handleExistingLock(\n  lockPath: string,\n  id: string,\n  ttlSeconds: number,\n  force: boolean,\n  forceRequiredForStaleLock: boolean,\n): Promise<void> {\n  const lockInfo = await readLockInfo(lockPath);\n  if (!isStaleLock(lockInfo.info, ttlSeconds)) {\n    throw new PmCliError(`Item ${id} is locked${lockOwnerSuffix(lockInfo.info)}`, EXIT_CODE.CONFLICT);\n  }\n\n  if (!force && forceRequiredForStaleLock) {\n    const warningSuffix = lockInfo.warnings.length > 0 ? ` (${lockInfo.warnings.join(\",\")})` : \"\";\n    throw new PmCliError(\n      `Item ${id} lock is stale${warningSuffix}; rerun with --force when supported for this command`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n\n  await unlinkLockWithHook(lockPath, \"lock:stale_remove\");\n}\n\nexport const _testOnly = {\n  parseLockInfo,\n  readLockInfo,\n  isErrno,\n  buildLockPayload,\n  isStaleLock,\n  lockOwnerSuffix,\n};\n\n\nexport async function acquireLock(\n  pmRoot: string,\n  id: string,\n  ttlSeconds: number,\n  owner: string,\n  force = false,\n  forceRequiredForStaleLock = true,\n): Promise<() => Promise<void>> {\n  const lockOverride = await runActiveServiceOverride(\"lock_acquire\", {\n    pm_root: pmRoot,\n    id,\n    ttl_seconds: ttlSeconds,\n    owner,\n    force,\n    force_required_for_stale_lock: forceRequiredForStaleLock,\n  });\n  if (lockOverride.handled) {\n    const releaseFromFunction = typeof lockOverride.result === \"function\" ? lockOverride.result : null;\n    const releaseFromObject =\n      typeof lockOverride.result === \"object\" &&\n      lockOverride.result !== null &&\n      \"release\" in lockOverride.result &&\n      typeof (lockOverride.result as { release?: unknown }).release === \"function\"\n        ? ((lockOverride.result as { release: () => Promise<void> | void }).release as () => Promise<void> | void)\n        : null;\n    const release = releaseFromFunction ?? releaseFromObject;\n    if (release) {\n      return async () => {\n        await Promise.resolve(release());\n        await runActiveServiceOverride(\"lock_release\", {\n          pm_root: pmRoot,\n          id,\n          owner,\n        });\n      };\n    }\n  }\n\n  const lockPath = getLockPath(pmRoot, id);\n\n  for (let attempt = 0; attempt < 3; attempt += 1) {\n    try {\n      await createLockFile(lockPath, id, owner, ttlSeconds);\n      return async () => {\n        await unlinkLockWithHook(lockPath, \"lock:release\");\n        await runActiveServiceOverride(\"lock_release\", {\n          pm_root: pmRoot,\n          id,\n          owner,\n        });\n      };\n    } catch (error: unknown) {\n      if (!isErrno(error, \"EEXIST\")) {\n        throw new PmCliError(`Failed to acquire lock for ${id}: ${toErrorMessage(error)}`, EXIT_CODE.GENERIC_FAILURE);\n      }\n      await handleExistingLock(lockPath, id, ttlSeconds, force, forceRequiredForStaleLock);\n    }\n  }\n\n  throw new PmCliError(`Failed to acquire lock for ${id}`, EXIT_CODE.CONFLICT);\n}\n", "import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { getActiveExtensionRegistrations, hasActiveOnReadHooks, runActiveOnReadHooks } from \"../extensions/index.js\";\nimport { collectRegisteredItemFieldNames } from \"../extensions/item-fields.js\";\nimport { parseItemDocument } from \"../item/item-format.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { ITEM_FILE_EXTENSIONS, getItemFormatFromPath } from \"./paths.js\";\nimport type { ItemDocument, ItemFormat, ItemMetadata, ItemType, RuntimeSchemaSettings } from \"../../types/index.js\";\n\nconst CACHE_VERSION = 6;\nconst CACHE_FILENAME = \"metadata-cache.json\";\nconst BODY_CACHE_FILENAME = \"metadata-cache-bodies.json\";\nconst COLLECTIONS_CACHE_FILENAME = \"metadata-cache-collections.json\";\n\n/**\n * Heavy \"collection\" front-matter fields. These arrays dominate the on-disk cache\n * (e.g. a single item's comment thread can be hundreds of KB) yet the hot list path\n * (`pm list`, stats, deps, activity, calendar, close) never reads them. They are\n * stored in a separate collections cache that is parsed only when a caller opts in\n * (`includeCollections`), keeping the always-loaded light cache an order of magnitude\n * smaller and its JSON.parse correspondingly cheaper.\n */\nexport const HEAVY_METADATA_KEYS = [\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"tests\",\n  \"test_runs\",\n  \"docs\",\n] as const;\n\nfunction resolveActiveExtensionFieldNames(): readonly string[] {\n  return collectRegisteredItemFieldNames(getActiveExtensionRegistrations());\n}\n\ninterface StatSignature {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n}\n\ninterface CachedEntry extends StatSignature {\n  metadata: ItemMetadata;\n  body_length: number;\n}\n\ninterface CachedBody extends StatSignature {\n  body: string;\n}\n\ninterface CachedCollections extends StatSignature {\n  collections: Record<string, unknown>;\n}\n\ninterface CacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  entries: Record<string, CachedEntry>;\n}\n\ninterface BodyCacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  bodies: Record<string, CachedBody>;\n}\n\ninterface CollectionsCacheEnvelope {\n  version: number;\n  context_fingerprint: string;\n  collections: Record<string, CachedCollections>;\n}\n\n/**\n * Split parsed front-matter into the light scalar/small fields (everything except the\n * heavy collection arrays) and the heavy collection fields. Only keys that are actually\n * present are moved, so an item without comments stays without comments in both tiers.\n */\nfunction splitHeavyMetadata(metadata: ItemMetadata): {\n  light: ItemMetadata;\n  heavy: Record<string, unknown>;\n} {\n  const light = { ...metadata } as Record<string, unknown>;\n  const heavy: Record<string, unknown> = {};\n  for (const key of HEAVY_METADATA_KEYS) {\n    if (key in light) {\n      heavy[key] = light[key];\n      delete light[key];\n    }\n  }\n  return { light: light as ItemMetadata, heavy };\n}\n\n/**\n * Recombine light metadata with cached heavy collection fields. Key order differs from\n * the on-disk document, but every downstream hash/serialization canonicalizes and\n * sorts keys (`stableStringify`), so the merged record is byte-identical once hashed.\n */\nfunction mergeHeavyMetadata(light: ItemMetadata, heavy: Record<string, unknown> | undefined): ItemMetadata {\n  if (!heavy || Object.keys(heavy).length === 0) {\n    return light;\n  }\n  return { ...light, ...heavy } as ItemMetadata;\n}\n\nexport interface CachedDocumentCandidate {\n  metadata: ItemMetadata;\n  body?: string;\n  item_format: ItemFormat;\n  item_path: string;\n}\n\nfunction computeContextFingerprint(\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  schema: RuntimeSchemaSettings | undefined,\n  extensionFieldNames: readonly string[],\n): string {\n  const hash = createHash(\"sha256\");\n  hash.update(`format:${preferredFormat ?? \"default\"}`);\n  const sortedTypes = Object.entries(typeToFolder)\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([type, folder]) => `${type}=${folder}`)\n    .join(\",\");\n  hash.update(`|types:${sortedTypes}`);\n  if (schema) {\n    hash.update(`|schema:${JSON.stringify(schema)}`);\n  }\n  if (extensionFieldNames.length > 0) {\n    hash.update(`|extension_fields:${extensionFieldNames.join(\",\")}`);\n  }\n  return hash.digest(\"hex\").slice(0, 16);\n}\n\nfunction getCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", CACHE_FILENAME);\n}\n\nfunction getBodyCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", BODY_CACHE_FILENAME);\n}\n\nfunction getCollectionsCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", COLLECTIONS_CACHE_FILENAME);\n}\n\nasync function loadCache(pmRoot: string): Promise<CacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as CacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function loadBodyCache(pmRoot: string): Promise<BodyCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getBodyCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as BodyCacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.bodies !== \"object\" || parsed.bodies === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function loadCollectionsCache(pmRoot: string): Promise<CollectionsCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getCollectionsCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as CollectionsCacheEnvelope;\n    if (parsed.version !== CACHE_VERSION || typeof parsed.collections !== \"object\" || parsed.collections === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nasync function persistCache(\n  cachePath: string,\n  envelope: CacheEnvelope | BodyCacheEnvelope | CollectionsCacheEnvelope,\n): Promise<void> {\n  await fs.mkdir(path.dirname(cachePath), { recursive: true });\n  await writeFileAtomic(cachePath, JSON.stringify(envelope));\n}\n\nfunction appendWarning(warnings: string[] | undefined, warning: string): void {\n  if (warnings && !warnings.includes(warning)) {\n    warnings.push(warning);\n  }\n}\n\nfunction statMatches(signature: StatSignature, mtimeMs: number, ctimeMs: number, size: number): boolean {\n  return signature.mtime_ms === mtimeMs && signature.ctime_ms === ctimeMs && signature.size === size;\n}\n\nexport interface ListCacheOptions {\n  /**\n   * When false, item bodies are neither loaded from nor written to the separate\n   * body cache. Metadata-only callers (`pm list`, stats, deps, activity, …) skip\n   * the large body cache entirely; only body consumers (search/reindex) pay for it.\n   */\n  includeBody?: boolean;\n  /**\n   * When false, heavy collection fields (comments/notes/learnings/files/tests/\n   * test_runs/docs) are neither loaded from nor written to the separate collections\n   * cache, and are absent from the returned metadata. Light-only callers (`pm list`\n   * compact, stats, deps, activity, calendar, close) skip the large collections cache\n   * entirely. Defaults to true so any caller that does read those fields stays correct.\n   */\n  includeCollections?: boolean;\n}\n\n/**\n * List all item documents using a persistent on-disk metadata cache.\n *\n * Metadata and bodies are stored in two separate cache files so the hot path\n * (`pm list` and friends, which discard bodies) never loads or rewrites the much\n * larger body payload. Each file is rewritten only when its contents actually\n * change, and per-file onRead hooks are dispatched only when an extension\n * registers one. Only files whose mtime/ctime/size changed since the last run are\n * re-parsed.\n */\nexport async function listAllDocumentCandidatesCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n  options: ListCacheOptions = {},\n): Promise<CachedDocumentCandidate[]> {\n  const includeBody = options.includeBody !== false;\n  const includeCollections = options.includeCollections !== false;\n  const extensionFieldNames = resolveActiveExtensionFieldNames();\n  const contextFingerprint = computeContextFingerprint(preferredFormat, typeToFolder, schema, extensionFieldNames);\n\n  const existingCache = await loadCache(pmRoot);\n  const previousEntries: Record<string, CachedEntry> =\n    existingCache && existingCache.context_fingerprint === contextFingerprint ? existingCache.entries : {};\n\n  const existingBodyCache = includeBody ? await loadBodyCache(pmRoot) : null;\n  const previousBodies: Record<string, CachedBody> =\n    existingBodyCache && existingBodyCache.context_fingerprint === contextFingerprint ? existingBodyCache.bodies : {};\n\n  const existingCollectionsCache = includeCollections ? await loadCollectionsCache(pmRoot) : null;\n  const previousCollections: Record<string, CachedCollections> =\n    existingCollectionsCache && existingCollectionsCache.context_fingerprint === contextFingerprint\n      ? existingCollectionsCache.collections\n      : {};\n\n  const entries = Object.entries(typeToFolder) as Array<[ItemType, string]>;\n  const dirResults = await Promise.all(\n    entries.map(async ([, folder]) => {\n      const dirPath = path.join(pmRoot, folder);\n      try {\n        const files = await fs.readdir(dirPath);\n        return { folder, dirPath, files };\n      } catch (error: unknown) {\n        if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code !== \"ENOENT\") {\n          appendWarning(warnings, `item_list_directory_read_failed:${folder}`);\n        }\n        return { folder, dirPath, files: [] as string[] };\n      }\n    }),\n  );\n\n  const dispatchReadHooks = hasActiveOnReadHooks();\n  const newEntries: Record<string, CachedEntry> = {};\n  const newBodies: Record<string, CachedBody> = {};\n  const newCollections: Record<string, CachedCollections> = {};\n  const documentsById = new Map<string, { candidate: CachedDocumentCandidate; itemFormat: ItemFormat }>();\n  let metadataMiss = false;\n  let bodyMiss = false;\n  let collectionsMiss = false;\n\n  const parseTasks: Array<Promise<void>> = [];\n\n  for (const { folder, dirPath, files } of dirResults) {\n    for (const file of files) {\n      if (!ITEM_FILE_EXTENSIONS.some((ext) => file.toLowerCase().endsWith(ext))) {\n        continue;\n      }\n      const filePath = path.join(dirPath, file);\n      const relativePath = path.relative(pmRoot, filePath);\n\n      parseTasks.push(\n        (async () => {\n          try {\n            const stat = await fs.stat(filePath);\n            const mtimeMs = stat.mtimeMs;\n            const ctimeMs = stat.ctimeMs;\n            const { size } = stat;\n            const itemFormat = getItemFormatFromPath(filePath) as ItemFormat;\n\n            // Preserve onRead hook semantics even when served from cache, but only\n            // when an extension actually observes reads. Surface hook warnings so\n            // read-hook failures are not silently hidden.\n            if (dispatchReadHooks) {\n              for (const warning of await runActiveOnReadHooks({ path: filePath, scope: \"project\" })) {\n                appendWarning(warnings, warning);\n              }\n            }\n\n            const cachedEntry = previousEntries[relativePath];\n            const metadataCached = cachedEntry !== undefined && statMatches(cachedEntry, mtimeMs, ctimeMs, size);\n            const cachedBody = previousBodies[relativePath];\n            const bodyCached = cachedBody !== undefined && statMatches(cachedBody, mtimeMs, ctimeMs, size);\n            const cachedCollections = previousCollections[relativePath];\n            const collectionsCached =\n              cachedCollections !== undefined && statMatches(cachedCollections, mtimeMs, ctimeMs, size);\n\n            const needRead =\n              !metadataCached || (includeBody && !bodyCached) || (includeCollections && !collectionsCached);\n            let lightMetadata: ItemMetadata;\n            let heavyMetadata: Record<string, unknown> | undefined;\n            let bodyLength: number;\n            let body: string | undefined;\n\n            if (needRead) {\n            const raw = await fs.readFile(filePath, \"utf8\");\n            const parsed = parseItemDocument(raw, {\n              format: itemFormat,\n              schema,\n              extensionFieldNames,\n              onWarning: (w) => appendWarning(warnings, w),\n            });\n              const split = splitHeavyMetadata(parsed.metadata);\n              lightMetadata = metadataCached ? cachedEntry.metadata : split.light;\n              bodyLength = metadataCached ? cachedEntry.body_length : parsed.body.length;\n              body = includeBody ? parsed.body : undefined;\n              if (includeCollections) {\n                heavyMetadata = collectionsCached ? cachedCollections.collections : split.heavy;\n              }\n              if (!metadataCached) {\n                metadataMiss = true;\n              }\n              if (includeBody && !bodyCached) {\n                bodyMiss = true;\n              }\n              if (includeCollections && !collectionsCached) {\n                collectionsMiss = true;\n              }\n            } else {\n              lightMetadata = cachedEntry.metadata;\n              bodyLength = cachedEntry.body_length;\n              body = includeBody ? cachedBody.body : undefined;\n              heavyMetadata = includeCollections && cachedCollections ? cachedCollections.collections : undefined;\n            }\n\n            newEntries[relativePath] = {\n              mtime_ms: mtimeMs,\n              ctime_ms: ctimeMs,\n              size,\n              metadata: lightMetadata,\n              body_length: bodyLength,\n            };\n            if (includeBody && body !== undefined) {\n              newBodies[relativePath] = { mtime_ms: mtimeMs, ctime_ms: ctimeMs, size, body };\n            }\n            if (includeCollections && heavyMetadata !== undefined) {\n              newCollections[relativePath] = { mtime_ms: mtimeMs, ctime_ms: ctimeMs, size, collections: heavyMetadata };\n            }\n\n            const metadata = includeCollections ? mergeHeavyMetadata(lightMetadata, heavyMetadata) : lightMetadata;\n            const existing = documentsById.get(metadata.id);\n            const candidate: CachedDocumentCandidate = {\n              metadata,\n              body,\n              item_format: itemFormat,\n              item_path: filePath,\n            };\n            if (!existing) {\n              documentsById.set(metadata.id, { candidate, itemFormat });\n            } else {\n              const shouldReplace = preferredFormat\n                ? itemFormat === preferredFormat && existing.itemFormat !== preferredFormat\n                : itemFormat === \"toon\" && existing.itemFormat !== \"toon\";\n              if (shouldReplace) {\n                documentsById.set(metadata.id, { candidate, itemFormat });\n              }\n            }\n          } catch {\n            appendWarning(warnings, `item_list_item_read_failed:${folder}/${file}`);\n          }\n        })(),\n      );\n    }\n  }\n\n  await Promise.all(parseTasks);\n\n  // Rewrite a cache file only when its contents changed: any re-parsed (missing or\n  // stale) entry, or a different set of keys (additions/deletions).\n  const metadataDirty = metadataMiss || Object.keys(previousEntries).length !== Object.keys(newEntries).length;\n  if (metadataDirty || existingCache === null || existingCache.context_fingerprint !== contextFingerprint) {\n    await persistCache(getCachePath(pmRoot), {\n      version: CACHE_VERSION,\n      context_fingerprint: contextFingerprint,\n      entries: newEntries,\n    }).catch(() => {});\n  }\n\n  if (includeBody) {\n    const bodyDirty = bodyMiss || Object.keys(previousBodies).length !== Object.keys(newBodies).length;\n    if (bodyDirty || existingBodyCache === null || existingBodyCache.context_fingerprint !== contextFingerprint) {\n      await persistCache(getBodyCachePath(pmRoot), {\n        version: CACHE_VERSION,\n        context_fingerprint: contextFingerprint,\n        bodies: newBodies,\n      }).catch(() => {});\n    }\n  }\n\n  if (includeCollections) {\n    const collectionsDirty =\n      collectionsMiss || Object.keys(previousCollections).length !== Object.keys(newCollections).length;\n    if (\n      collectionsDirty ||\n      existingCollectionsCache === null ||\n      existingCollectionsCache.context_fingerprint !== contextFingerprint\n    ) {\n      await persistCache(getCollectionsCachePath(pmRoot), {\n        version: CACHE_VERSION,\n        context_fingerprint: contextFingerprint,\n        collections: newCollections,\n      }).catch(() => {});\n    }\n  }\n\n  return [...documentsById.values()]\n    .sort((left, right) => left.candidate.metadata.id.localeCompare(right.candidate.metadata.id))\n    .map((entry) => entry.candidate);\n}\n\nexport async function listAllDocumentsCached(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n): Promise<ItemDocument[]> {\n  const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, {\n    includeBody: false,\n  });\n  return candidates.map((candidate) => ({\n    metadata: candidate.metadata,\n    body: candidate.body ?? \"\",\n  }));\n}\n\n/**\n * Light variant of {@link listAllDocumentsCached}: returns metadata WITHOUT the heavy\n * collection fields (comments/notes/learnings/files/tests/test_runs/docs), skipping the\n * large collections cache entirely. Only safe for callers that read just the light\n * scalar/small fields (id/title/status/type/priority/parent/tags/dates/dependencies/…).\n */\nexport async function listAllDocumentsCachedLight(\n  pmRoot: string,\n  preferredFormat: ItemFormat | undefined,\n  typeToFolder: Record<string, string>,\n  warnings: string[] | undefined,\n  schema: RuntimeSchemaSettings | undefined,\n): Promise<ItemDocument[]> {\n  const candidates = await listAllDocumentCandidatesCached(pmRoot, preferredFormat, typeToFolder, warnings, schema, {\n    includeBody: false,\n    includeCollections: false,\n  });\n  return candidates.map((candidate) => ({\n    metadata: candidate.metadata,\n    body: candidate.body ?? \"\",\n  }));\n}\n", "import 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 { EMPTY_CANONICAL_DOCUMENT, EXIT_CODE, TYPE_TO_FOLDER } 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 { canonicalDocument, parseItemDocument, serializeItemDocument } 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 { listAllDocumentCandidatesCached, listAllDocumentsCached, listAllDocumentsCachedLight } from \"./front-matter-cache.js\";\nimport { getHistoryPath, getItemFormatFromPath, getItemPath, ITEM_FILE_EXTENSIONS } from \"./paths.js\";\nimport { resolveGovernanceKnobs } from \"./settings.js\";\nimport { nowIso } from \"../shared/time.js\";\nimport type { ItemDocument, ItemFormat, ItemFrontMatter, ItemType, PmSettings, RuntimeSchemaSettings } from \"../../types/index.js\";\n\nexport interface LocatedItem {\n  id: string;\n  type: ItemType;\n  itemPath: string;\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 typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\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(explicit: readonly string[] | undefined): readonly string[] {\n  return explicit ?? collectRegisteredItemFieldNames(getActiveExtensionRegistrations());\n}\n\nfunction resolveItemFormatSearchOrder(preferredFormat?: ItemFormat): 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\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 = normalizedId === rawNormalizedId ? [normalizedId] : [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(pmRoot, type, candidateId, itemFormat, typeToFolder);\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\nexport async function readLocatedItem(\n  item: LocatedItem,\n  options: { schema?: RuntimeSchemaSettings; extensionFieldNames?: readonly string[]; warnings?: string[] } = {},\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(options.extensionFieldNames),\n    onWarning: (warning) => appendWarning(options.warnings, warning),\n  });\n  return { raw, document };\n}\n\nexport async function listAllFrontMatter(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemFrontMatter[]> {\n  const documents = await listAllDocumentsCached(pmRoot, preferredFormat, typeToFolder, warnings, schema);\n  return documents.map((document) => document.metadata);\n}\n\n/**\n * Light variant of {@link listAllFrontMatter}: returns front-matter 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 listAllFrontMatterLight(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<ItemFrontMatter[]> {\n  const documents = await listAllDocumentsCachedLight(pmRoot, preferredFormat, typeToFolder, warnings, schema);\n  return documents.map((document) => document.metadata);\n}\n\nexport async function listAllFrontMatterWithBody(\n  pmRoot: string,\n  preferredFormat?: ItemFormat,\n  typeToFolder: Record<string, string> = TYPE_TO_FOLDER,\n  warnings?: string[],\n  schema?: RuntimeSchemaSettings,\n): Promise<Array<ItemFrontMatter & { 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) => ({ id, distance: levenshteinDistanceWithinLimit(id, normalized, limit) }))\n    .filter((entry): entry is { id: string; distance: number } => entry.distance !== null)\n    .sort((left, right) => left.distance - right.distance)\n    .slice(0, 3)\n    .map((entry) => entry.id);\n  return scored;\n}\n\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(pmRoot, badId, idPrefix, typeToFolder);\n  const nextSteps: string[] = [\"Confirm the active --path/PM_PATH scope, then retry with a valid id.\"];\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, { nextSteps });\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_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  );\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\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  extensionFieldNames?: readonly string[];\n  typeToFolder?: Record<string, string>;\n  mutate: (document: ItemDocument) => {\n    changedFields: string[];\n    warnings?: string[];\n  };\n}): Promise<{\n  item: ItemFrontMatter;\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 historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot: params.pmRoot,\n      settings: params.settings,\n      itemId: located.id,\n      commandLabel: params.op,\n    });\n\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    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(\"item_store_write\", {\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    let effectiveTargetItemPath = targetItemPath;\n    let effectiveSerializedAfter = serializedAfter;\n    let skipItemWrite = false;\n    if (\n      serviceWriteOverride.handled &&\n      typeof serviceWriteOverride.result === \"object\" &&\n      serviceWriteOverride.result !== null\n    ) {\n      const overrideRecord = serviceWriteOverride.result as {\n        target_item_path?: unknown;\n        contents?: unknown;\n        skip_write?: unknown;\n      };\n      if (typeof overrideRecord.target_item_path === \"string\" && overrideRecord.target_item_path.trim().length > 0) {\n        effectiveTargetItemPath = overrideRecord.target_item_path;\n      }\n      if (typeof overrideRecord.contents === \"string\") {\n        effectiveSerializedAfter = overrideRecord.contents;\n      }\n      if (overrideRecord.skip_write === true) {\n        skipItemWrite = true;\n      }\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      if (!skipItemWrite && effectiveTargetItemPath !== located.itemPath) {\n        await writeFileAtomic(located.itemPath, originalRaw);\n        await fs.rm(effectiveTargetItemPath, { force: true });\n      } else if (!skipItemWrite) {\n        await writeFileAtomic(located.itemPath, 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(beforeDocument.metadata, mutation.changedFields),\n      current: projectAfterCommandItemSnapshot(afterDocument.metadata, mutation.changedFields),\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\nexport const itemStoreTestOnly = {\n  appendWarning,\n  bypassesAssigneeConflict,\n  buildDidYouMeanSuggestions,\n  isErrno,\n};\n\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<{ item: ItemFrontMatter; changedFields: string[]; warnings: string[]; targetPath?: string }> {\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 { located, originalRaw, document, warnings: parseWarnings, releaseLock } = 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, { schema: params.settings.schema });\n    const deletionTimestamp = nowIso();\n    const tombstoneDocument = 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(\"item_store_delete\", {\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    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 (typeof overrideRecord.item_path === \"string\" && overrideRecord.item_path.trim().length > 0) {\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: [...parseWarnings, ...historyPolicy.warnings, ...serviceDeleteOverride.warnings],\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(beforeDocument.metadata, Object.keys(beforeDocument.metadata)),\n      changed_fields: [\"deleted\"],\n    });\n\n    return {\n      item: beforeDocument.metadata,\n      changedFields: [\"deleted\"],\n      warnings: [...parseWarnings, ...historyPolicy.warnings, ...serviceDeleteOverride.warnings, ...hookWarnings],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["path", "next", "fs", "path", "fs", "path", "fs", "path", "path", "fs", "fs", "path", "fs", "appendWarning", "resolveActiveExtensionFieldNames", "fs", "path", "fs"]
+}

package/dist/cli-bundle/chunks/{chunk-UCVJP4JL.js → chunk-4VLB4JH2.js}

@@ -1,16 +1,25 @@
+import {
+  toDefaultFolder
+} from "./chunk-6BV7ENQL.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-LV5FFQ7M.js";
 
 // dist/core/schema/item-types-file.js
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "77a0faf1-6f19-5f27-9123-f589cf398634");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "995e9919-c166-505a-8821-d8a859a60ae8");
   } catch (e2) {
   }
 })();
 var BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
+var TYPE_NAME_TOKEN_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function assertValidTypeToken(value, label) {
+  if (!TYPE_NAME_TOKEN_PATTERN.test(value)) {
+    throw new Error(`${label} "${value}" is not a valid identifier. Use a single letter-led token of letters, digits, hyphen, or underscore with no spaces or punctuation (e.g. "Spike" or "code-review").`);
+  }
+}
 function matchBuiltinTypeName(name) {
   return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());
 }
@@ -39,6 +48,7 @@ function normalizeAddTypeInput(raw) {
   if (name.length === 0) {
     throw new Error("Type name must not be empty.");
   }
+  assertValidTypeToken(name, "Type name");
   const builtinMatch = matchBuiltinTypeName(name);
   if (builtinMatch) {
     throw new Error(`Cannot redefine built-in item type "${builtinMatch}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
@@ -48,6 +58,7 @@ function normalizeAddTypeInput(raw) {
   const folder = raw.folder?.trim();
   const aliases = dedupeAliases(raw.aliases ?? []);
   for (const alias of aliases) {
+    assertValidTypeToken(alias, "Alias");
     const aliasBuiltin = matchBuiltinTypeName(alias);
     if (aliasBuiltin) {
       throw new Error(`Alias "${alias}" collides with built-in item type "${aliasBuiltin}". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(", ")}.`);
@@ -90,6 +101,35 @@ function assertAliasesAvailable(input, existing) {
     }
   }
 }
+function resolveDefinitionFolder(name, folder) {
+  if (typeof folder === "string" && folder.trim().length > 0) {
+    return folder.trim().toLowerCase();
+  }
+  return toDefaultFolder(name).toLowerCase();
+}
+function assertTypeFolderAvailable(input, existing, reservedFolders) {
+  const selfLower = input.name.toLowerCase();
+  const inputFolder = resolveDefinitionFolder(input.name, input.folder);
+  const fail = (ownerName) => {
+    throw new Error(`Item type "${input.name}" would store items in folder "${inputFolder}", which already belongs to existing item type "${ownerName}". Pass a distinct --folder to keep their storage separate.`);
+  };
+  for (const definition of existing.definitions) {
+    if (typeof definition.name !== "string") {
+      continue;
+    }
+    const definitionName = definition.name.trim();
+    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {
+      continue;
+    }
+    if (resolveDefinitionFolder(definitionName, definition.folder) === inputFolder) {
+      fail(definitionName);
+    }
+  }
+  const reservedOwner = reservedFolders?.get(inputFolder);
+  if (reservedOwner !== void 0 && reservedOwner.toLowerCase() !== selfLower) {
+    fail(reservedOwner);
+  }
+}
 function parseItemTypesFile(raw) {
   if (raw === null || raw === void 0 || raw.trim().length === 0) {
     return { definitions: [] };
@@ -168,7 +208,8 @@ function upsertItemType(file, input) {
   return {
     file: { definitions },
     definition: next,
-    replaced: existingIndex >= 0
+    replaced: existingIndex >= 0,
+    ...existing && typeof existing.name === "string" ? { previousName: existing.name } : {}
   };
 }
 function removeItemType(file, name) {
@@ -199,18 +240,20 @@ function serializeItemTypesFile(file) {
   return `${JSON.stringify({ definitions: file.definitions }, null, 2)}
 `;
 }
-function buildInvalidTypeHint(name) {
+function buildInvalidTypeHint(name, typesFilePath) {
   const safeName = name.trim().length > 0 ? name.trim() : name;
-  return `To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes .agents/pm/schema/types.json).`;
+  const target = typesFilePath?.trim() || ".agents/pm/schema/types.json";
+  return `To register a custom type, run: pm schema add-type "${escapeForDoubleQuotes(safeName)}" (writes ${target}).`;
 }
-function buildInvalidTypeError(name, allowedTypes) {
-  return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name)}`;
+function buildInvalidTypeError(name, allowedTypes, typesFilePath) {
+  return `Invalid type value "${name}". Allowed: ${allowedTypes.join(", ")}. ${buildInvalidTypeHint(name, typesFilePath)}`;
 }
 
 export {
   escapeForDoubleQuotes,
   normalizeAddTypeInput,
   assertAliasesAvailable,
+  assertTypeFolderAvailable,
   parseItemTypesFile,
   upsertItemType,
   removeItemType,
@@ -218,4 +261,4 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-UCVJP4JL.js.map
+//# sourceMappingURL=chunk-4VLB4JH2.js.map

package/dist/cli-bundle/chunks/chunk-4VLB4JH2.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/schema/item-types-file.ts"],
+  "sourcesContent": ["import { BUILTIN_ITEM_TYPE_VALUES } from \"../../types/index.js\";\nimport type { ItemTypeDefinition } from \"../../types/index.js\";\nimport { toDefaultFolder } from \"../item/type-registry.js\";\n\nexport type { ItemTypeDefinition } from \"../../types/index.js\";\n\n/**\n * Pure logic for the `pm schema add-type` command and the create/update\n * invalid-type discoverability hint. The CLI command file (schema.ts) handles\n * IO/governance; everything testable and side-effect-free lives here so it can\n * be coverage-gated to 100%.\n */\n\nconst BUILTIN_NAME_LOOKUP = new Map<string, string>(\n  BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]),\n);\n\n/**\n * The shape persisted at `.agents/pm/schema/types.json`.\n */\nexport interface ItemTypesFile {\n  definitions: ItemTypeDefinition[];\n}\n\nexport interface NormalizedAddTypeInput {\n  name: string;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases: string[];\n}\n\nexport interface RawAddTypeInput {\n  name: string | undefined;\n  description?: string;\n  defaultStatus?: string;\n  folder?: string;\n  aliases?: string[];\n}\n\nexport interface UpsertItemTypeResult {\n  file: ItemTypesFile;\n  /** The definition as stored after the upsert (existing fields preserved). */\n  definition: ItemTypeDefinition;\n  /** True when an existing definition with the same (case-insensitive) name was replaced. */\n  replaced: boolean;\n  /**\n   * The canonical name of the replaced definition (only present when `replaced`).\n   * Lets the caller detect a silent recase (e.g. \"Spike\" -> \"spike\") and warn.\n   */\n  previousName?: string;\n}\n\n/**\n * Custom item type names (and aliases) must be a single letter-led identifier\n * token: letters, digits, hyphen, or underscore — no whitespace or other\n * punctuation. This keeps names copy-pasteable as shell arguments and folder\n * slugs deterministic, matching the single-token PascalCase shape of every\n * built-in type. Folder/slug overlap between two distinct valid tokens (e.g.\n * \"Spike\"/\"Spikes\", \"code-review\"/\"code_review\") is rejected separately by\n * assertTypeFolderAvailable.\n */\nconst TYPE_NAME_TOKEN_PATTERN = /^[A-Za-z][A-Za-z0-9_-]*$/;\n\nfunction assertValidTypeToken(value: string, label: string): void {\n  if (!TYPE_NAME_TOKEN_PATTERN.test(value)) {\n    throw new Error(\n      `${label} \"${value}\" is not a valid identifier. Use a single letter-led token of letters, digits, hyphen, or underscore with no spaces or punctuation (e.g. \"Spike\" or \"code-review\").`,\n    );\n  }\n}\n\nexport interface RemoveItemTypeResult {\n  file: ItemTypesFile;\n  /** True when a matching definition existed and was dropped from the file. */\n  removed: boolean;\n  /** The removed definition, when one matched (case-insensitively) the requested name. */\n  definition?: ItemTypeDefinition;\n}\n\n/**\n * Returns the canonical built-in name when `name` collides (case-insensitively)\n * with a reserved built-in item type, otherwise undefined.\n */\nexport function matchBuiltinTypeName(name: string): string | undefined {\n  return BUILTIN_NAME_LOOKUP.get(name.trim().toLowerCase());\n}\n\n/**\n * Coerces a persisted `aliases` value into a string array, tolerating malformed\n * data (a non-array, or an array containing non-string entries) without throwing\n * or exploding a stray string into character aliases.\n */\nfunction coerceAliasArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : [];\n}\n\n/**\n * Escapes a value for safe interpolation inside a double-quoted shell string so\n * suggested copy-pasteable commands stay well-formed for names containing\n * `\"`, `` ` ``, `$`, or `\\`.\n */\nexport function escapeForDoubleQuotes(value: string): string {\n  return value.replace(/[\\\\\"`$]/g, (char) => `\\\\${char}`);\n}\n\nfunction dedupeAliases(values: Iterable<string>): string[] {\n  const seen = new Map<string, string>();\n  for (const value of values) {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const key = trimmed.toLowerCase();\n    if (!seen.has(key)) {\n      seen.set(key, trimmed);\n    }\n  }\n  return [...seen.values()].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Validates and normalizes raw add-type CLI input. Throws a plain Error with a\n * stable message when the name is missing/empty or collides with a built-in;\n * the CLI layer maps these to PmCliError exit codes.\n */\nexport function normalizeAddTypeInput(raw: RawAddTypeInput): NormalizedAddTypeInput {\n  const name = (raw.name ?? \"\").trim();\n  if (name.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  assertValidTypeToken(name, \"Type name\");\n  const builtinMatch = matchBuiltinTypeName(name);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot redefine built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const description = raw.description?.trim();\n  const defaultStatus = raw.defaultStatus?.trim();\n  const folder = raw.folder?.trim();\n  const aliases = dedupeAliases(raw.aliases ?? []);\n  for (const alias of aliases) {\n    assertValidTypeToken(alias, \"Alias\");\n    const aliasBuiltin = matchBuiltinTypeName(alias);\n    if (aliasBuiltin) {\n      throw new Error(\n        `Alias \"${alias}\" collides with built-in item type \"${aliasBuiltin}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n      );\n    }\n  }\n  return {\n    name,\n    description: description && description.length > 0 ? description : undefined,\n    defaultStatus: defaultStatus && defaultStatus.length > 0 ? defaultStatus : undefined,\n    folder: folder && folder.length > 0 ? folder : undefined,\n    aliases,\n  };\n}\n\n/**\n * Throws when the requested name or any alias collides (case-insensitively)\n * with the canonical name or an alias of a DIFFERENT existing definition.\n * Such collisions would make `pm create`/`pm update --type` resolve\n * ambiguously (the runtime registry keys a single lowercase alias map), so\n * they are rejected. Tokens belonging to the same-named definition being\n * upserted are ignored, keeping re-runs idempotent.\n */\nexport function assertAliasesAvailable(input: NormalizedAddTypeInput, existing: ItemTypesFile): void {\n  const selfLower = input.name.toLowerCase();\n  const taken = new Map<string, string>();\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    taken.set(definitionName.toLowerCase(), definitionName);\n    for (const alias of coerceAliasArray(definition.aliases)) {\n      if (alias.trim().length > 0) {\n        taken.set(alias.trim().toLowerCase(), definitionName);\n      }\n    }\n  }\n  const nameOwner = taken.get(selfLower);\n  if (nameOwner) {\n    throw new Error(`Type name \"${input.name}\" collides with an alias of existing item type \"${nameOwner}\".`);\n  }\n  for (const alias of input.aliases) {\n    const owner = taken.get(alias.toLowerCase());\n    if (owner) {\n      throw new Error(`Alias \"${alias}\" already maps to existing item type \"${owner}\".`);\n    }\n  }\n}\n\n/**\n * Resolves the storage folder a definition would use: an explicit non-empty\n * `folder` wins, otherwise the deterministic slug derived from the name (the\n * same derivation the runtime registry applies, single-sourced from\n * type-registry.toDefaultFolder).\n */\nfunction resolveDefinitionFolder(name: string, folder: unknown): string {\n  if (typeof folder === \"string\" && folder.trim().length > 0) {\n    return folder.trim().toLowerCase();\n  }\n  return toDefaultFolder(name).toLowerCase();\n}\n\n/**\n * Throws when the requested type's storage folder would collide with a\n * DIFFERENT existing definition's folder. Two distinct type names can slug to\n * one folder (\"Spike\"/\"Spikes\", \"code-review\"/\"code_review\"), which would make\n * their item files share a directory and silently corrupt the taxonomy. The\n * same-named definition being upserted is ignored (folder reuse on re-run is\n * expected). Resolving the collision is a matter of passing a distinct\n * `--folder`, so the error says so.\n *\n * `reservedFolders` carries the folders already owned by built-in and extension\n * types (folder-slug → owner name); a custom type whose slug matches one of\n * those (e.g. \"Tasks\" → \"tasks\", owned by the built-in Task) is just as\n * corrupting as a custom-vs-custom collision, so both are checked.\n */\nexport function assertTypeFolderAvailable(\n  input: NormalizedAddTypeInput,\n  existing: ItemTypesFile,\n  reservedFolders?: ReadonlyMap<string, string>,\n): void {\n  const selfLower = input.name.toLowerCase();\n  const inputFolder = resolveDefinitionFolder(input.name, input.folder);\n  const fail = (ownerName: string): never => {\n    throw new Error(\n      `Item type \"${input.name}\" would store items in folder \"${inputFolder}\", which already belongs to existing item type \"${ownerName}\". Pass a distinct --folder to keep their storage separate.`,\n    );\n  };\n  for (const definition of existing.definitions) {\n    if (typeof definition.name !== \"string\") {\n      continue;\n    }\n    const definitionName = definition.name.trim();\n    if (definitionName.length === 0 || definitionName.toLowerCase() === selfLower) {\n      continue;\n    }\n    if (resolveDefinitionFolder(definitionName, definition.folder) === inputFolder) {\n      fail(definitionName);\n    }\n  }\n  const reservedOwner = reservedFolders?.get(inputFolder);\n  if (reservedOwner !== undefined && reservedOwner.toLowerCase() !== selfLower) {\n    fail(reservedOwner);\n  }\n}\n\n/**\n * Coerces an arbitrary parsed value from types.json into an ItemTypesFile.\n * Accepts the canonical `{ definitions: [...] }` shape, a bare array of\n * definitions, or a nested `{ item_types: { definitions: [...] } }` form, and\n * tolerates a missing/invalid file by returning an empty definitions list.\n */\nexport function parseItemTypesFile(raw: string | null | undefined): ItemTypesFile {\n  if (raw === null || raw === undefined || raw.trim().length === 0) {\n    return { definitions: [] };\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    throw new Error(\"schema/types.json contains invalid JSON.\");\n  }\n  return { definitions: extractDefinitions(parsed) };\n}\n\nfunction extractDefinitions(parsed: unknown): ItemTypeDefinition[] {\n  const candidate = selectDefinitionsArray(parsed);\n  if (!candidate) {\n    return [];\n  }\n  const definitions: ItemTypeDefinition[] = [];\n  for (const entry of candidate) {\n    if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n      continue;\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.name !== \"string\" || record.name.trim().length === 0) {\n      continue;\n    }\n    definitions.push(record as unknown as ItemTypeDefinition);\n  }\n  return definitions;\n}\n\nfunction selectDefinitionsArray(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return undefined;\n  }\n  const record = parsed as Record<string, unknown>;\n  if (Array.isArray(record.definitions)) {\n    return record.definitions;\n  }\n  if (typeof record.item_types === \"object\" && record.item_types !== null) {\n    const nested = record.item_types as Record<string, unknown>;\n    if (Array.isArray(nested.definitions)) {\n      return nested.definitions;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Idempotent UPSERT of a custom item type into the parsed file. Matching is\n * case-insensitive by name. When a definition already exists, fields supplied\n * in `input` override the previous values; aliases are merged (deduped); other\n * fields not addressed by add-type flags are preserved untouched.\n */\nexport function upsertItemType(file: ItemTypesFile, input: NormalizedAddTypeInput): UpsertItemTypeResult {\n  const lowerName = input.name.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  const existing = existingIndex >= 0 ? definitions[existingIndex] : undefined;\n\n  const mergedAliases = dedupeAliases([...coerceAliasArray(existing?.aliases), ...input.aliases]);\n\n  const next: ItemTypeDefinition = {\n    ...(existing ?? {}),\n    name: input.name,\n  };\n  if (input.folder !== undefined) {\n    next.folder = input.folder;\n  }\n  if (mergedAliases.length > 0) {\n    next.aliases = mergedAliases;\n  } else if (next.aliases !== undefined) {\n    delete next.aliases;\n  }\n  applyAttribute(next, \"description\", input.description);\n  applyAttribute(next, \"default_status\", input.defaultStatus);\n\n  if (existingIndex >= 0) {\n    definitions[existingIndex] = next;\n  } else {\n    definitions.push(next);\n  }\n  definitions.sort((left, right) => left.name.localeCompare(right.name));\n\n  return {\n    file: { definitions },\n    definition: next,\n    replaced: existingIndex >= 0,\n    ...(existing && typeof existing.name === \"string\" ? { previousName: existing.name } : {}),\n  };\n}\n\n/**\n * Removes a custom item type definition from the parsed file by name\n * (case-insensitive). Throws a plain Error when `name` is empty or collides\n * with a reserved built-in type (built-ins are not stored in the file and must\n * never be deletable). Returns `removed: false` when no matching custom\n * definition exists so the CLI layer can treat the call as an idempotent no-op.\n */\nexport function removeItemType(file: ItemTypesFile, name: string | undefined): RemoveItemTypeResult {\n  const trimmed = (name ?? \"\").trim();\n  if (trimmed.length === 0) {\n    throw new Error(\"Type name must not be empty.\");\n  }\n  const builtinMatch = matchBuiltinTypeName(trimmed);\n  if (builtinMatch) {\n    throw new Error(\n      `Cannot remove built-in item type \"${builtinMatch}\". Built-in types are reserved: ${BUILTIN_ITEM_TYPE_VALUES.join(\", \")}.`,\n    );\n  }\n  const lowerName = trimmed.toLowerCase();\n  const definitions = file.definitions.slice();\n  const existingIndex = definitions.findIndex(\n    (definition) => typeof definition.name === \"string\" && definition.name.trim().toLowerCase() === lowerName,\n  );\n  if (existingIndex < 0) {\n    return { file: { definitions }, removed: false };\n  }\n  const [definition] = definitions.splice(existingIndex, 1);\n  return { file: { definitions }, removed: true, definition };\n}\n\nfunction applyAttribute(definition: ItemTypeDefinition, key: string, value: string | undefined): void {\n  const record = definition as unknown as Record<string, unknown>;\n  if (value !== undefined) {\n    record[key] = value;\n  }\n}\n\n/**\n * Serializes the item types file with a trailing newline (matches the rest of\n * the schema scaffold files written by pm).\n */\nexport function serializeItemTypesFile(file: ItemTypesFile): string {\n  return `${JSON.stringify({ definitions: file.definitions }, null, 2)}\\n`;\n}\n\n/**\n * Appends a discoverable hint to the \"Invalid type\" error so agents learn that\n * custom types exist and how to register one. Quotes are chosen so the printed\n * line is copy-pasteable as a shell command.\n */\nexport function buildInvalidTypeHint(name: string, typesFilePath?: string): string {\n  const safeName = name.trim().length > 0 ? name.trim() : name;\n  const target = typesFilePath?.trim() || \".agents/pm/schema/types.json\";\n  return `To register a custom type, run: pm schema add-type \"${escapeForDoubleQuotes(safeName)}\" (writes ${target}).`;\n}\n\n/**\n * Builds the full invalid-type error message used by create/update: the\n * existing \"Invalid type ... Allowed: ...\" line plus the discoverable hint.\n * `typesFilePath` should be the resolved schema/types.json path for the active\n * tracker (see {@link resolveItemTypesFilePath}) so the hint reflects a custom\n * `--pm-path` instead of the hardcoded `.agents/pm` default.\n */\nexport function buildInvalidTypeError(name: string, allowedTypes: readonly string[], typesFilePath?: string): string {\n  return `Invalid type value \"${name}\". Allowed: ${allowedTypes.join(\", \")}. ${buildInvalidTypeHint(name, typesFilePath)}`;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAaA,IAAM,sBAAsB,IAAI,IAC9B,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,YAAW,GAAI,IAAI,CAAC,CAAC;AAgDpE,IAAM,0BAA0B;AAEhC,SAAS,qBAAqB,OAAe,OAAa;AACxD,MAAI,CAAC,wBAAwB,KAAK,KAAK,GAAG;AACxC,UAAM,IAAI,MACR,GAAG,KAAK,KAAK,KAAK,qKAAqK;EAE3L;AACF;AAcM,SAAU,qBAAqB,MAAY;AAC/C,SAAO,oBAAoB,IAAI,KAAK,KAAI,EAAG,YAAW,CAAE;AAC1D;AAOA,SAAS,iBAAiB,OAAc;AACtC,SAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ,IAAI,CAAA;AACtG;AAOM,SAAU,sBAAsB,OAAa;AACjD,SAAO,MAAM,QAAQ,YAAY,CAAC,SAAS,KAAK,IAAI,EAAE;AACxD;AAEA,SAAS,cAAc,QAAwB;AAC7C,QAAM,OAAO,oBAAI,IAAG;AACpB,aAAW,SAAS,QAAQ;AAC1B,UAAM,UAAU,MAAM,KAAI;AAC1B,QAAI,QAAQ,WAAW,GAAG;AACxB;IACF;AACA,UAAM,MAAM,QAAQ,YAAW;AAC/B,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAClB,WAAK,IAAI,KAAK,OAAO;IACvB;EACF;AACA,SAAO,CAAC,GAAG,KAAK,OAAM,CAAE,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AAC3E;AAOM,SAAU,sBAAsB,KAAoB;AACxD,QAAM,QAAQ,IAAI,QAAQ,IAAI,KAAI;AAClC,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,8BAA8B;EAChD;AACA,uBAAqB,MAAM,WAAW;AACtC,QAAM,eAAe,qBAAqB,IAAI;AAC9C,MAAI,cAAc;AAChB,UAAM,IAAI,MACR,uCAAuC,YAAY,mCAAmC,yBAAyB,KAAK,IAAI,CAAC,GAAG;EAEhI;AACA,QAAM,cAAc,IAAI,aAAa,KAAI;AACzC,QAAM,gBAAgB,IAAI,eAAe,KAAI;AAC7C,QAAM,SAAS,IAAI,QAAQ,KAAI;AAC/B,QAAM,UAAU,cAAc,IAAI,WAAW,CAAA,CAAE;AAC/C,aAAW,SAAS,SAAS;AAC3B,yBAAqB,OAAO,OAAO;AACnC,UAAM,eAAe,qBAAqB,KAAK;AAC/C,QAAI,cAAc;AAChB,YAAM,IAAI,MACR,UAAU,KAAK,uCAAuC,YAAY,mCAAmC,yBAAyB,KAAK,IAAI,CAAC,GAAG;IAE/I;EACF;AACA,SAAO;IACL;IACA,aAAa,eAAe,YAAY,SAAS,IAAI,cAAc;IACnE,eAAe,iBAAiB,cAAc,SAAS,IAAI,gBAAgB;IAC3E,QAAQ,UAAU,OAAO,SAAS,IAAI,SAAS;IAC/C;;AAEJ;AAUM,SAAU,uBAAuB,OAA+B,UAAuB;AAC3F,QAAM,YAAY,MAAM,KAAK,YAAW;AACxC,QAAM,QAAQ,oBAAI,IAAG;AACrB,aAAW,cAAc,SAAS,aAAa;AAC7C,QAAI,OAAO,WAAW,SAAS,UAAU;AACvC;IACF;AACA,UAAM,iBAAiB,WAAW,KAAK,KAAI;AAC3C,QAAI,eAAe,WAAW,KAAK,eAAe,YAAW,MAAO,WAAW;AAC7E;IACF;AACA,UAAM,IAAI,eAAe,YAAW,GAAI,cAAc;AACtD,eAAW,SAAS,iBAAiB,WAAW,OAAO,GAAG;AACxD,UAAI,MAAM,KAAI,EAAG,SAAS,GAAG;AAC3B,cAAM,IAAI,MAAM,KAAI,EAAG,YAAW,GAAI,cAAc;MACtD;IACF;EACF;AACA,QAAM,YAAY,MAAM,IAAI,SAAS;AACrC,MAAI,WAAW;AACb,UAAM,IAAI,MAAM,cAAc,MAAM,IAAI,mDAAmD,SAAS,IAAI;EAC1G;AACA,aAAW,SAAS,MAAM,SAAS;AACjC,UAAM,QAAQ,MAAM,IAAI,MAAM,YAAW,CAAE;AAC3C,QAAI,OAAO;AACT,YAAM,IAAI,MAAM,UAAU,KAAK,yCAAyC,KAAK,IAAI;IACnF;EACF;AACF;AAQA,SAAS,wBAAwB,MAAc,QAAe;AAC5D,MAAI,OAAO,WAAW,YAAY,OAAO,KAAI,EAAG,SAAS,GAAG;AAC1D,WAAO,OAAO,KAAI,EAAG,YAAW;EAClC;AACA,SAAO,gBAAgB,IAAI,EAAE,YAAW;AAC1C;AAgBM,SAAU,0BACd,OACA,UACA,iBAA6C;AAE7C,QAAM,YAAY,MAAM,KAAK,YAAW;AACxC,QAAM,cAAc,wBAAwB,MAAM,MAAM,MAAM,MAAM;AACpE,QAAM,OAAO,CAAC,cAA4B;AACxC,UAAM,IAAI,MACR,cAAc,MAAM,IAAI,kCAAkC,WAAW,mDAAmD,SAAS,6DAA6D;EAElM;AACA,aAAW,cAAc,SAAS,aAAa;AAC7C,QAAI,OAAO,WAAW,SAAS,UAAU;AACvC;IACF;AACA,UAAM,iBAAiB,WAAW,KAAK,KAAI;AAC3C,QAAI,eAAe,WAAW,KAAK,eAAe,YAAW,MAAO,WAAW;AAC7E;IACF;AACA,QAAI,wBAAwB,gBAAgB,WAAW,MAAM,MAAM,aAAa;AAC9E,WAAK,cAAc;IACrB;EACF;AACA,QAAM,gBAAgB,iBAAiB,IAAI,WAAW;AACtD,MAAI,kBAAkB,UAAa,cAAc,YAAW,MAAO,WAAW;AAC5E,SAAK,aAAa;EACpB;AACF;AAQM,SAAU,mBAAmB,KAA8B;AAC/D,MAAI,QAAQ,QAAQ,QAAQ,UAAa,IAAI,KAAI,EAAG,WAAW,GAAG;AAChE,WAAO,EAAE,aAAa,CAAA,EAAE;EAC1B;AACA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,GAAG;EACzB,QAAQ;AACN,UAAM,IAAI,MAAM,0CAA0C;EAC5D;AACA,SAAO,EAAE,aAAa,mBAAmB,MAAM,EAAC;AAClD;AAEA,SAAS,mBAAmB,QAAe;AACzC,QAAM,YAAY,uBAAuB,MAAM;AAC/C,MAAI,CAAC,WAAW;AACd,WAAO,CAAA;EACT;AACA,QAAM,cAAoC,CAAA;AAC1C,aAAW,SAAS,WAAW;AAC7B,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE;IACF;AACA,UAAM,SAAS;AACf,QAAI,OAAO,OAAO,SAAS,YAAY,OAAO,KAAK,KAAI,EAAG,WAAW,GAAG;AACtE;IACF;AACA,gBAAY,KAAK,MAAuC;EAC1D;AACA,SAAO;AACT;AAEA,SAAS,uBAAuB,QAAe;AAC7C,MAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,WAAO;EACT;AACA,MAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,WAAO;EACT;AACA,QAAM,SAAS;AACf,MAAI,MAAM,QAAQ,OAAO,WAAW,GAAG;AACrC,WAAO,OAAO;EAChB;AACA,MAAI,OAAO,OAAO,eAAe,YAAY,OAAO,eAAe,MAAM;AACvE,UAAM,SAAS,OAAO;AACtB,QAAI,MAAM,QAAQ,OAAO,WAAW,GAAG;AACrC,aAAO,OAAO;IAChB;EACF;AACA,SAAO;AACT;AAQM,SAAU,eAAe,MAAqB,OAA6B;AAC/E,QAAM,YAAY,MAAM,KAAK,YAAW;AACxC,QAAM,cAAc,KAAK,YAAY,MAAK;AAC1C,QAAM,gBAAgB,YAAY,UAChC,CAAC,eAAe,OAAO,WAAW,SAAS,YAAY,WAAW,KAAK,KAAI,EAAG,YAAW,MAAO,SAAS;AAE3G,QAAM,WAAW,iBAAiB,IAAI,YAAY,aAAa,IAAI;AAEnE,QAAM,gBAAgB,cAAc,CAAC,GAAG,iBAAiB,UAAU,OAAO,GAAG,GAAG,MAAM,OAAO,CAAC;AAE9F,QAAM,OAA2B;IAC/B,GAAI,YAAY,CAAA;IAChB,MAAM,MAAM;;AAEd,MAAI,MAAM,WAAW,QAAW;AAC9B,SAAK,SAAS,MAAM;EACtB;AACA,MAAI,cAAc,SAAS,GAAG;AAC5B,SAAK,UAAU;EACjB,WAAW,KAAK,YAAY,QAAW;AACrC,WAAO,KAAK;EACd;AACA,iBAAe,MAAM,eAAe,MAAM,WAAW;AACrD,iBAAe,MAAM,kBAAkB,MAAM,aAAa;AAE1D,MAAI,iBAAiB,GAAG;AACtB,gBAAY,aAAa,IAAI;EAC/B,OAAO;AACL,gBAAY,KAAK,IAAI;EACvB;AACA,cAAY,KAAK,CAAC,MAAM,UAAU,KAAK,KAAK,cAAc,MAAM,IAAI,CAAC;AAErE,SAAO;IACL,MAAM,EAAE,YAAW;IACnB,YAAY;IACZ,UAAU,iBAAiB;IAC3B,GAAI,YAAY,OAAO,SAAS,SAAS,WAAW,EAAE,cAAc,SAAS,KAAI,IAAK,CAAA;;AAE1F;AASM,SAAU,eAAe,MAAqB,MAAwB;AAC1E,QAAM,WAAW,QAAQ,IAAI,KAAI;AACjC,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,IAAI,MAAM,8BAA8B;EAChD;AACA,QAAM,eAAe,qBAAqB,OAAO;AACjD,MAAI,cAAc;AAChB,UAAM,IAAI,MACR,qCAAqC,YAAY,mCAAmC,yBAAyB,KAAK,IAAI,CAAC,GAAG;EAE9H;AACA,QAAM,YAAY,QAAQ,YAAW;AACrC,QAAM,cAAc,KAAK,YAAY,MAAK;AAC1C,QAAM,gBAAgB,YAAY,UAChC,CAACA,gBAAe,OAAOA,YAAW,SAAS,YAAYA,YAAW,KAAK,KAAI,EAAG,YAAW,MAAO,SAAS;AAE3G,MAAI,gBAAgB,GAAG;AACrB,WAAO,EAAE,MAAM,EAAE,YAAW,GAAI,SAAS,MAAK;EAChD;AACA,QAAM,CAAC,UAAU,IAAI,YAAY,OAAO,eAAe,CAAC;AACxD,SAAO,EAAE,MAAM,EAAE,YAAW,GAAI,SAAS,MAAM,WAAU;AAC3D;AAEA,SAAS,eAAe,YAAgC,KAAa,OAAyB;AAC5F,QAAM,SAAS;AACf,MAAI,UAAU,QAAW;AACvB,WAAO,GAAG,IAAI;EAChB;AACF;AAMM,SAAU,uBAAuB,MAAmB;AACxD,SAAO,GAAG,KAAK,UAAU,EAAE,aAAa,KAAK,YAAW,GAAI,MAAM,CAAC,CAAC;;AACtE;AAOM,SAAU,qBAAqB,MAAc,eAAsB;AACvE,QAAM,WAAW,KAAK,KAAI,EAAG,SAAS,IAAI,KAAK,KAAI,IAAK;AACxD,QAAM,SAAS,eAAe,KAAI,KAAM;AACxC,SAAO,uDAAuD,sBAAsB,QAAQ,CAAC,aAAa,MAAM;AAClH;AASM,SAAU,sBAAsB,MAAc,cAAiC,eAAsB;AACzG,SAAO,uBAAuB,IAAI,eAAe,aAAa,KAAK,IAAI,CAAC,KAAK,qBAAqB,MAAM,aAAa,CAAC;AACxH;",
+  "names": ["definition"]
+}

package/dist/cli-bundle/chunks/{chunk-BVL5KGVA.js → chunk-656HPQPO.js}

@@ -1,17 +1,17 @@
 
-!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]="da2f3582-6928-5ecb-a08e-764043714391")}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]="b983245f-0499-5725-9073-d2ebb98d9533")}catch(e){}}();
 import {
   resolveAuthor
 } from "./chunk-J27KIHTG.js";
 import {
   readHistoryEntries
-} from "./chunk-XWDZVCBJ.js";
+} from "./chunk-L6FJPOT4.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
   toReplayDocument
-} from "./chunk-JE5IZXDS.js";
+} from "./chunk-UUKORJSN.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -19,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-L6YQONLM.js";
+} from "./chunk-7K2MXFMX.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-6ZFTM65G.js";
+} from "./chunk-2JEGCDYT.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-QQG4HEX7.js";
+} from "./chunk-GAVE4MYM.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-32XSW44C.js";
+} from "./chunk-ZONXMSVB.js";
 import {
   nowIso
-} from "./chunk-IZHCCG4S.js";
+} from "./chunk-G2YVUY7I.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -49,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-S2CDTRJ6.js";
+} from "./chunk-KTVETP66.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -144,9 +144,13 @@ function applyHistoryPatch(current, patch, entryNumber, entryOp) {
     const failureContext = extractPatchFailureContext(patch, error);
     const contextTokens = [
       `history_op=${entryOp}`,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.patchIndex !== void 0 ? `patch_index=${failureContext.patchIndex}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.op ? `op=${failureContext.op}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.path ? `path=${failureContext.path}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.from ? `from=${failureContext.from}` : null
     ].filter((token) => token !== null);
     const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : "";
@@ -371,10 +375,21 @@ async function runRestore(id, target, options, global) {
     await releaseLock();
   }
 }
+var _testOnlyRestoreCommand = {
+  applyHistoryPatch,
+  changedFields,
+  ensureMaterializedRestoreTarget,
+  ensureReplayTarget,
+  extractPatchFailureContext,
+  replayCurrentDocument,
+  replayToTarget,
+  resolveRestoreSubject
+};
 
 export {
-  runRestore
+  runRestore,
+  _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-BVL5KGVA.js.map
+//# sourceMappingURL=chunk-656HPQPO.js.map
 
-//# debugId=da2f3582-6928-5ecb-a08e-764043714391
+//# debugId=b983245f-0499-5725-9073-d2ebb98d9533