@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-GKCEEXMA.js → chunk-HQ3SB4CN.js}

@@ -1,10 +1,10 @@
 import {
   createStdinTokenResolver,
   parseCsvKv
-} from "./chunk-A5EQPNV7.js";
+} from "./chunk-GVT754PX.js";
 import {
   parseLimit
-} from "./chunk-7CHWLT2J.js";
+} from "./chunk-UVN66B3M.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -15,7 +15,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-RLLOZAM2.js";
+} from "./chunk-IY6VZ3IW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -23,14 +23,14 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/sdk/annotations.js
 import { readFile } from "node:fs/promises";
 !(function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c7504b88-d784-5b2b-9037-a42002ec439b");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "8be9d5fc-c3fd-5e9e-b4e3-7a0ed25f3d97");
   } catch (e2) {
   }
 })();
@@ -168,7 +168,22 @@ function assertAnnotationAddValueIsNotFlagLike(raw, config) {
     ]
   });
 }
+function assertAnnotationMessageHasTextSource(config, options) {
+  if (config.input.mode !== "list" || options.message === void 0) {
+    return;
+  }
+  const noun = config.collectionKey.replace(/s$/, "");
+  throw new PmCliError(`--message labels a ${noun} mutation but does not provide ${noun} text. Pass text positionally or with --add, --stdin, or --file.`, EXIT_CODE.USAGE, {
+    code: "annotation_message_without_text",
+    required: `Provide ${noun} text through a content source; --message only annotates the history entry of a mutation.`,
+    examples: [
+      `pm ${config.collectionKey} <id> --add "text" --message "why"`,
+      `pm ${config.collectionKey} <id> ${annotationStdinHint(config.collectionKey)}`
+    ]
+  });
+}
 async function runAnnotationCommand(id, options, global2, config) {
+  assertAnnotationMessageHasTextSource(config, options);
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -313,4 +328,4 @@ export {
   runAnnotationCommand,
   resolveAnnotationIndex
 };
-//# sourceMappingURL=chunk-GKCEEXMA.js.map
+//# sourceMappingURL=chunk-HQ3SB4CN.js.map

package/dist/cli-bundle/chunks/{chunk-GKCEEXMA.js.map → chunk-HQ3SB4CN.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../sdk/annotations.ts"],
-  "sourcesContent": ["/**\n * @module sdk/annotations\n *\n * Implements the pm annotation command command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { createStdinTokenResolver, parseCsvKv } from \"../core/item/parse.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { parseLimit } from \"../core/shared/numeric-parsers.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport { resolveAuthor } from \"../core/shared/author.js\";\nimport {\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\n\n/** Common persisted shape shared by comments, notes, and learnings. */\nexport interface AnnotationEntry {\n  /** Creation timestamp for the persisted entry. */\n  created_at: string;\n  /** Stable author attribution recorded with the entry. */\n  author: string;\n  /** Human-readable annotation body. */\n  text: string;\n  /** Last edit timestamp when the entry was changed in place. */\n  edited_at?: string;\n}\n\n/** Common options accepted by annotation primitive operations. */\nexport interface AnnotationCommandOptions {\n  /** Maximum number of newest entries returned. */\n  limit?: string;\n  /** Author override for mutation attribution. */\n  author?: string;\n  /** Optional history message describing the mutation. */\n  message?: string;\n  /** Whether to override an active ownership conflict. */\n  force?: boolean;\n  /** Whether list results include paging metadata. */\n  includeMeta?: boolean;\n}\n\n/** Presentation-layer inputs accepted by the shared annotation source resolver. */\nexport interface AnnotationSourceOptions {\n  /** Inline annotation text or the stdin token (`-`). */\n  add?: string;\n  /** Read annotation text directly from stdin. */\n  stdin?: boolean;\n  /** Read annotation text from a UTF-8 file. */\n  file?: string;\n  /** One-based entry index to replace. */\n  edit?: number;\n  /** One-based entry index to delete. */\n  delete?: number;\n}\n\n/** Normalized annotation operation supplied by a presentation layer. */\nexport interface AnnotationInput {\n  /** Normalized operation selected by the presentation layer. */\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  /** Resolved annotation text. */\n  value?: string;\n  /** Original input used for flag-like value validation. */\n  rawValue?: string;\n  /** Flag name used in validation messages. */\n  emptyFlag?: string;\n  /** One-based entry index for edit and delete operations. */\n  index?: number;\n}\n\n/** Agent-facing recovery guidance for ownership conflicts. */\nexport interface OwnershipConflictGuidance {\n  /** Actionable requirement shown to the caller. */\n  required: string;\n  /** Copyable retry examples. */\n  examples: string[];\n  /** Ordered recovery guidance. */\n  nextSteps: string[];\n}\n\n/** Domain configuration for one annotation collection primitive. */\nexport interface AnnotationCommandConfig<TKey extends string> {\n  /** Normalized annotation operation. */\n  input: AnnotationInput;\n  /** Metadata collection that stores this annotation family. */\n  collectionKey: TKey;\n  /** History operation used for additions. */\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  /** History operation used for edits. */\n  editOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  /** History operation used for deletions. */\n  deleteOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  /** Domain parser that normalizes resolved text. */\n  parseText: (raw: string) => string;\n  /** Whether this operation may bypass ownership for a caller-authorized annotation workflow. */\n  bypassOwnershipConflict: boolean;\n  /** Recovery guidance for ownership conflicts. */\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\n/** Structured result returned by an annotation primitive. */\nexport type AnnotationCommandResult<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n> = {\n  id: string;\n  count: number;\n} & Record<TKey, TEntry[]> & {\n    total_count?: number;\n    returned_count?: number;\n    has_more?: boolean;\n    limit?: number;\n  };\n\n/** Implements limit annotation entries for the public runtime surface of this module. */\nexport function limitAnnotationEntries<TEntry>(\n  values: TEntry[],\n  limit: number | undefined,\n): TEntry[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\n/** Implements read annotation entries for the public runtime surface of this module. */\nexport function readAnnotationEntries<TEntry>(\n  source: Record<string, unknown>,\n  collectionKey: string,\n): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\n/** Implements parse annotation text input for the public runtime surface of this module. */\nexport function parseAnnotationTextInput(\n  raw: string,\n  options: { stripPlainTextPrefix?: boolean } = {},\n): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (\n    options.stripPlainTextPrefix === true &&\n    textPrefixMatch &&\n    !trimmed.startsWith(\"```\")\n  ) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured =\n    /^(?:[-*+]\\s*)?text\\s*[:=]/im.test(trimmed) || trimmed.startsWith(\"```\");\n  if (!looksStructured) {\n    return trimmed;\n  }\n  try {\n    const kv = parseCsvKv(trimmed, \"--add\");\n    const keys = Object.keys(kv).map((key) => key.trim().toLowerCase());\n    if (keys.some((key) => key !== \"text\")) {\n      return trimmed;\n    }\n    const text = kv.text?.trim();\n    return text || trimmed;\n  } catch {\n    return trimmed;\n  }\n}\n\n/** Returns whether an unknown file-system failure exposes an errno-like code. */\nexport function isErrnoError(error: unknown): error is { code?: unknown } {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveAnnotationTextSource(\n  options: AnnotationSourceOptions,\n  noun: string,\n): Promise<\n  { value: string; rawValue?: string; emptyFlag: string } | undefined\n> {\n  const sourceCount =\n    Number(options.add !== undefined) +\n    Number(options.stdin === true) +\n    Number(typeof options.file === \"string\");\n  if (sourceCount > 1) {\n    throw new PmCliError(\n      `Specify ${noun} text using only one input source: --add, --stdin, or --file`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const stdinResolver = createStdinTokenResolver();\n  if (options.add !== undefined) {\n    return {\n      value: (await stdinResolver.resolveValue(options.add, \"--add\")) ?? \"\",\n      rawValue: options.add,\n      emptyFlag: \"--add\",\n    };\n  }\n  if (options.stdin === true) {\n    return {\n      value: (await stdinResolver.resolveValue(\"-\", \"--stdin\")) ?? \"\",\n      emptyFlag: \"--stdin\",\n    };\n  }\n  if (typeof options.file !== \"string\") return undefined;\n  const filePath = options.file.trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    return { value: await readFile(filePath, \"utf8\"), emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(\n        `--file path not found: ${filePath}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(\n      `Failed to read --file path \"${filePath}\": ${detail}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n/** Resolves mutually exclusive annotation input flags into one normalized SDK operation. */\nexport async function resolveAnnotationInput(\n  options: AnnotationSourceOptions,\n  noun: string,\n): Promise<AnnotationInput> {\n  if (options.edit !== undefined && options.delete !== undefined) {\n    throw new PmCliError(\n      \"Specify only one of --edit or --delete\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (options.delete !== undefined) {\n    if (\n      options.add !== undefined ||\n      options.stdin === true ||\n      typeof options.file === \"string\"\n    ) {\n      throw new PmCliError(\n        \"--delete cannot be combined with replacement text\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (!Number.isInteger(options.delete) || options.delete < 1) {\n      throw new PmCliError(\n        \"--delete must be a positive integer\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n  if (\n    options.edit !== undefined &&\n    (!Number.isInteger(options.edit) || options.edit < 1)\n  ) {\n    throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  const resolved = await resolveAnnotationTextSource(options, noun);\n  if (options.edit !== undefined) {\n    if (!resolved) {\n      throw new PmCliError(\n        \"--edit requires replacement text from --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"edit\", index: options.edit, ...resolved };\n  }\n  return resolved ? { mode: \"add\", ...resolved } : { mode: \"list\" };\n}\n\n/** Implements wrap ownership conflict for the public runtime surface of this module. */\nexport function wrapOwnershipConflict(\n  error: unknown,\n  guidance: OwnershipConflictGuidance,\n): never {\n  if (\n    error instanceof PmCliError &&\n    error.exitCode === EXIT_CODE.CONFLICT &&\n    error.message.includes(\"is assigned to\") &&\n    error.message.includes(\"Use --force to override\")\n  ) {\n    throw new PmCliError(error.message, error.exitCode, {\n      code: \"ownership_conflict\",\n      required: guidance.required,\n      examples: guidance.examples,\n      nextSteps: guidance.nextSteps,\n    });\n  }\n  throw error;\n}\n\nfunction annotationStdinHint(collectionKey: string): string {\n  return collectionKey === \"comments\" ? \"--stdin\" : \"--add -\";\n}\n\nfunction assertAnnotationAddValueIsNotFlagLike(\n  raw: string,\n  config: AnnotationCommandConfig<string>,\n): void {\n  const emptyFlag = config.input.emptyFlag ?? \"--add\";\n  if (emptyFlag !== \"--add\") {\n    return;\n  }\n  const trimmed = raw.trim();\n  if (!/^-{1,2}[A-Za-z][\\w-]*(?:=.*)?$/.test(trimmed)) {\n    return;\n  }\n  const stdinHint = annotationStdinHint(config.collectionKey);\n  const commandPrefix =\n    config.input.mode === \"edit\"\n      ? `pm ${config.collectionKey} <id> --edit <index>`\n      : `pm ${config.collectionKey} <id>`;\n  throw new PmCliError(\n    `--add value \"${trimmed}\" looks like an option, not annotation text. Use ${stdinHint} to read stdin, or use text=${trimmed} for literal dash-leading text.`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"annotation_flag_like_value\",\n      required: `Use ${stdinHint} for stdin input, pass plain text, or use text=${trimmed} when the text really starts with \"-\".`,\n      examples: [\n        `${commandPrefix} ${stdinHint}`,\n        `${commandPrefix} --add text=${trimmed}`,\n      ],\n    },\n  );\n}\n\n/** Implements run annotation command for the public runtime surface of this module. */\nexport async function runAnnotationCommand<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const allEntries = readAnnotationEntries<TEntry>(\n      loaded.document.metadata,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      located.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n\n  if (config.input.mode === \"delete\") {\n    const op = config.deleteOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.bypassOwnershipConflict,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(\n            document.metadata,\n            config.collectionKey,\n          );\n          const arrayIndex = resolveAnnotationIndex(\n            config.input.index,\n            entries.length,\n            config.collectionKey,\n          );\n          entries.splice(arrayIndex, 1);\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(\n      result.item,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      result.item.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  const rawText = config.input.rawValue ?? config.input.value ?? \"\";\n  assertAnnotationAddValueIsNotFlagLike(rawText, config);\n  const text = config.parseText(config.input.value ?? \"\");\n  if (!text.trim()) {\n    throw new PmCliError(\n      `${config.input.emptyFlag ?? \"--add\"} text cannot be empty`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  if (config.input.mode === \"edit\") {\n    const op = config.editOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.bypassOwnershipConflict,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(\n            document.metadata,\n            config.collectionKey,\n          );\n          const arrayIndex = resolveAnnotationIndex(\n            config.input.index,\n            entries.length,\n            config.collectionKey,\n          );\n          const existing = entries[arrayIndex];\n          entries[arrayIndex] = {\n            ...existing,\n            text,\n            edited_at: nowIso(),\n          } as TEntry;\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(\n      result.item,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      result.item.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: config.op,\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: config.bypassOwnershipConflict,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(\n          document.metadata,\n          config.collectionKey,\n        );\n        entries.push({\n          created_at: nowIso(),\n          author,\n          text,\n        } as TEntry);\n        document.metadata[config.collectionKey] = entries as never;\n        return { changedFields: [config.collectionKey] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, config.conflictGuidance);\n  }\n\n  const allEntries = readAnnotationEntries<TEntry>(\n    result.item,\n    config.collectionKey,\n  );\n  return renderAnnotationResult(\n    result.item.id,\n    config.collectionKey,\n    allEntries,\n    limit,\n    options.includeMeta === true,\n  );\n}\n\n/** Implements resolve annotation index for the public runtime surface of this module. */\nexport function resolveAnnotationIndex(\n  oneBasedIndex: number | undefined,\n  count: number,\n  collectionKey: string,\n): number {\n  if (\n    oneBasedIndex === undefined ||\n    !Number.isInteger(oneBasedIndex) ||\n    oneBasedIndex < 1 ||\n    oneBasedIndex > count\n  ) {\n    const singular = collectionKey.replace(/s$/, \"\");\n    const label = `${singular.charAt(0).toUpperCase()}${singular.slice(1)}`;\n    const noun = count === 1 ? `1 ${singular}` : `${count} ${collectionKey}`;\n    throw new PmCliError(\n      `${label} index ${oneBasedIndex ?? \"(missing)\"} out of range (item has ${noun})`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return oneBasedIndex - 1;\n}\n\nfunction renderAnnotationResult<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n>(\n  id: string,\n  collectionKey: TKey,\n  allEntries: TEntry[],\n  limit: number | undefined,\n  includeMeta: boolean,\n): AnnotationCommandResult<TKey, TEntry> {\n  const entries = limitAnnotationEntries(allEntries, limit);\n  return {\n    id,\n    [collectionKey]: entries,\n    count: entries.length,\n    ...(includeMeta\n      ? {\n          total_count: allEntries.length,\n          returned_count: entries.length,\n          has_more: entries.length < allEntries.length,\n          ...(limit !== undefined ? { limit } : {}),\n        }\n      : {}),\n  } as AnnotationCommandResult<TKey, TEntry>;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @module sdk/annotations\n *\n * Implements the pm annotation command command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { createStdinTokenResolver, parseCsvKv } from \"../core/item/parse.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { parseLimit } from \"../core/shared/numeric-parsers.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport { resolveAuthor } from \"../core/shared/author.js\";\nimport {\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\n\n/** Common persisted shape shared by comments, notes, and learnings. */\nexport interface AnnotationEntry {\n  /** Creation timestamp for the persisted entry. */\n  created_at: string;\n  /** Stable author attribution recorded with the entry. */\n  author: string;\n  /** Human-readable annotation body. */\n  text: string;\n  /** Last edit timestamp when the entry was changed in place. */\n  edited_at?: string;\n}\n\n/** Common options accepted by annotation primitive operations. */\nexport interface AnnotationCommandOptions {\n  /** Maximum number of newest entries returned. */\n  limit?: string;\n  /** Author override for mutation attribution. */\n  author?: string;\n  /** Optional history message describing the mutation. */\n  message?: string;\n  /** Whether to override an active ownership conflict. */\n  force?: boolean;\n  /** Whether list results include paging metadata. */\n  includeMeta?: boolean;\n}\n\n/** Presentation-layer inputs accepted by the shared annotation source resolver. */\nexport interface AnnotationSourceOptions {\n  /** Inline annotation text or the stdin token (`-`). */\n  add?: string;\n  /** Read annotation text directly from stdin. */\n  stdin?: boolean;\n  /** Read annotation text from a UTF-8 file. */\n  file?: string;\n  /** One-based entry index to replace. */\n  edit?: number;\n  /** One-based entry index to delete. */\n  delete?: number;\n}\n\n/** Normalized annotation operation supplied by a presentation layer. */\nexport interface AnnotationInput {\n  /** Normalized operation selected by the presentation layer. */\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  /** Resolved annotation text. */\n  value?: string;\n  /** Original input used for flag-like value validation. */\n  rawValue?: string;\n  /** Flag name used in validation messages. */\n  emptyFlag?: string;\n  /** One-based entry index for edit and delete operations. */\n  index?: number;\n}\n\n/** Agent-facing recovery guidance for ownership conflicts. */\nexport interface OwnershipConflictGuidance {\n  /** Actionable requirement shown to the caller. */\n  required: string;\n  /** Copyable retry examples. */\n  examples: string[];\n  /** Ordered recovery guidance. */\n  nextSteps: string[];\n}\n\n/** Domain configuration for one annotation collection primitive. */\nexport interface AnnotationCommandConfig<TKey extends string> {\n  /** Normalized annotation operation. */\n  input: AnnotationInput;\n  /** Metadata collection that stores this annotation family. */\n  collectionKey: TKey;\n  /** History operation used for additions. */\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  /** History operation used for edits. */\n  editOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  /** History operation used for deletions. */\n  deleteOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  /** Domain parser that normalizes resolved text. */\n  parseText: (raw: string) => string;\n  /** Whether this operation may bypass ownership for a caller-authorized annotation workflow. */\n  bypassOwnershipConflict: boolean;\n  /** Recovery guidance for ownership conflicts. */\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\n/** Structured result returned by an annotation primitive. */\nexport type AnnotationCommandResult<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n> = {\n  id: string;\n  count: number;\n} & Record<TKey, TEntry[]> & {\n    total_count?: number;\n    returned_count?: number;\n    has_more?: boolean;\n    limit?: number;\n  };\n\n/** Implements limit annotation entries for the public runtime surface of this module. */\nexport function limitAnnotationEntries<TEntry>(\n  values: TEntry[],\n  limit: number | undefined,\n): TEntry[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\n/** Implements read annotation entries for the public runtime surface of this module. */\nexport function readAnnotationEntries<TEntry>(\n  source: Record<string, unknown>,\n  collectionKey: string,\n): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\n/** Implements parse annotation text input for the public runtime surface of this module. */\nexport function parseAnnotationTextInput(\n  raw: string,\n  options: { stripPlainTextPrefix?: boolean } = {},\n): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (\n    options.stripPlainTextPrefix === true &&\n    textPrefixMatch &&\n    !trimmed.startsWith(\"```\")\n  ) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured =\n    /^(?:[-*+]\\s*)?text\\s*[:=]/im.test(trimmed) || trimmed.startsWith(\"```\");\n  if (!looksStructured) {\n    return trimmed;\n  }\n  try {\n    const kv = parseCsvKv(trimmed, \"--add\");\n    const keys = Object.keys(kv).map((key) => key.trim().toLowerCase());\n    if (keys.some((key) => key !== \"text\")) {\n      return trimmed;\n    }\n    const text = kv.text?.trim();\n    return text || trimmed;\n  } catch {\n    return trimmed;\n  }\n}\n\n/** Returns whether an unknown file-system failure exposes an errno-like code. */\nexport function isErrnoError(error: unknown): error is { code?: unknown } {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveAnnotationTextSource(\n  options: AnnotationSourceOptions,\n  noun: string,\n): Promise<\n  { value: string; rawValue?: string; emptyFlag: string } | undefined\n> {\n  const sourceCount =\n    Number(options.add !== undefined) +\n    Number(options.stdin === true) +\n    Number(typeof options.file === \"string\");\n  if (sourceCount > 1) {\n    throw new PmCliError(\n      `Specify ${noun} text using only one input source: --add, --stdin, or --file`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const stdinResolver = createStdinTokenResolver();\n  if (options.add !== undefined) {\n    return {\n      value: (await stdinResolver.resolveValue(options.add, \"--add\")) ?? \"\",\n      rawValue: options.add,\n      emptyFlag: \"--add\",\n    };\n  }\n  if (options.stdin === true) {\n    return {\n      value: (await stdinResolver.resolveValue(\"-\", \"--stdin\")) ?? \"\",\n      emptyFlag: \"--stdin\",\n    };\n  }\n  if (typeof options.file !== \"string\") return undefined;\n  const filePath = options.file.trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    return { value: await readFile(filePath, \"utf8\"), emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(\n        `--file path not found: ${filePath}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(\n      `Failed to read --file path \"${filePath}\": ${detail}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n/** Resolves mutually exclusive annotation input flags into one normalized SDK operation. */\nexport async function resolveAnnotationInput(\n  options: AnnotationSourceOptions,\n  noun: string,\n): Promise<AnnotationInput> {\n  if (options.edit !== undefined && options.delete !== undefined) {\n    throw new PmCliError(\n      \"Specify only one of --edit or --delete\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (options.delete !== undefined) {\n    if (\n      options.add !== undefined ||\n      options.stdin === true ||\n      typeof options.file === \"string\"\n    ) {\n      throw new PmCliError(\n        \"--delete cannot be combined with replacement text\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (!Number.isInteger(options.delete) || options.delete < 1) {\n      throw new PmCliError(\n        \"--delete must be a positive integer\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n  if (\n    options.edit !== undefined &&\n    (!Number.isInteger(options.edit) || options.edit < 1)\n  ) {\n    throw new PmCliError(\"--edit must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  const resolved = await resolveAnnotationTextSource(options, noun);\n  if (options.edit !== undefined) {\n    if (!resolved) {\n      throw new PmCliError(\n        \"--edit requires replacement text from --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return { mode: \"edit\", index: options.edit, ...resolved };\n  }\n  return resolved ? { mode: \"add\", ...resolved } : { mode: \"list\" };\n}\n\n/** Implements wrap ownership conflict for the public runtime surface of this module. */\nexport function wrapOwnershipConflict(\n  error: unknown,\n  guidance: OwnershipConflictGuidance,\n): never {\n  if (\n    error instanceof PmCliError &&\n    error.exitCode === EXIT_CODE.CONFLICT &&\n    error.message.includes(\"is assigned to\") &&\n    error.message.includes(\"Use --force to override\")\n  ) {\n    throw new PmCliError(error.message, error.exitCode, {\n      code: \"ownership_conflict\",\n      required: guidance.required,\n      examples: guidance.examples,\n      nextSteps: guidance.nextSteps,\n    });\n  }\n  throw error;\n}\n\nfunction annotationStdinHint(collectionKey: string): string {\n  return collectionKey === \"comments\" ? \"--stdin\" : \"--add -\";\n}\n\nfunction assertAnnotationAddValueIsNotFlagLike(\n  raw: string,\n  config: AnnotationCommandConfig<string>,\n): void {\n  const emptyFlag = config.input.emptyFlag ?? \"--add\";\n  if (emptyFlag !== \"--add\") {\n    return;\n  }\n  const trimmed = raw.trim();\n  if (!/^-{1,2}[A-Za-z][\\w-]*(?:=.*)?$/.test(trimmed)) {\n    return;\n  }\n  const stdinHint = annotationStdinHint(config.collectionKey);\n  const commandPrefix =\n    config.input.mode === \"edit\"\n      ? `pm ${config.collectionKey} <id> --edit <index>`\n      : `pm ${config.collectionKey} <id>`;\n  throw new PmCliError(\n    `--add value \"${trimmed}\" looks like an option, not annotation text. Use ${stdinHint} to read stdin, or use text=${trimmed} for literal dash-leading text.`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"annotation_flag_like_value\",\n      required: `Use ${stdinHint} for stdin input, pass plain text, or use text=${trimmed} when the text really starts with \"-\".`,\n      examples: [\n        `${commandPrefix} ${stdinHint}`,\n        `${commandPrefix} --add text=${trimmed}`,\n      ],\n    },\n  );\n}\n\n/**\n * Reject list-mode invocations that pass `--message` without any content\n * source. `--message` only labels a mutation's history entry, so accepting it\n * alone would exit 0 while recording nothing — the GH-588/GH-615 silent\n * data-loss trap. Shared here so comments, notes, and learnings all fail fast\n * with the same structured recovery bundle.\n */\nfunction assertAnnotationMessageHasTextSource(\n  config: AnnotationCommandConfig<string>,\n  options: AnnotationCommandOptions,\n): void {\n  if (config.input.mode !== \"list\" || options.message === undefined) {\n    return;\n  }\n  const noun = config.collectionKey.replace(/s$/, \"\");\n  throw new PmCliError(\n    `--message labels a ${noun} mutation but does not provide ${noun} text. Pass text positionally or with --add, --stdin, or --file.`,\n    EXIT_CODE.USAGE,\n    {\n      code: \"annotation_message_without_text\",\n      required: `Provide ${noun} text through a content source; --message only annotates the history entry of a mutation.`,\n      examples: [\n        `pm ${config.collectionKey} <id> --add \"text\" --message \"why\"`,\n        `pm ${config.collectionKey} <id> ${annotationStdinHint(config.collectionKey)}`,\n      ],\n    },\n  );\n}\n\n/** Implements run annotation command for the public runtime surface of this module. */\nexport async function runAnnotationCommand<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\n  assertAnnotationMessageHasTextSource(config, options);\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const allEntries = readAnnotationEntries<TEntry>(\n      loaded.document.metadata,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      located.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n\n  if (config.input.mode === \"delete\") {\n    const op = config.deleteOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.bypassOwnershipConflict,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(\n            document.metadata,\n            config.collectionKey,\n          );\n          const arrayIndex = resolveAnnotationIndex(\n            config.input.index,\n            entries.length,\n            config.collectionKey,\n          );\n          entries.splice(arrayIndex, 1);\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(\n      result.item,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      result.item.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  const rawText = config.input.rawValue ?? config.input.value ?? \"\";\n  assertAnnotationAddValueIsNotFlagLike(rawText, config);\n  const text = config.parseText(config.input.value ?? \"\");\n  if (!text.trim()) {\n    throw new PmCliError(\n      `${config.input.emptyFlag ?? \"--add\"} text cannot be empty`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  if (config.input.mode === \"edit\") {\n    const op = config.editOp ?? config.op;\n    let result: Awaited<ReturnType<typeof mutateItem>>;\n    try {\n      result = await mutateItem({\n        pmRoot,\n        settings,\n        id,\n        op,\n        author,\n        message: options.message,\n        force: options.force,\n        bypassAssigneeConflict: config.bypassOwnershipConflict,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(\n            document.metadata,\n            config.collectionKey,\n          );\n          const arrayIndex = resolveAnnotationIndex(\n            config.input.index,\n            entries.length,\n            config.collectionKey,\n          );\n          const existing = entries[arrayIndex];\n          entries[arrayIndex] = {\n            ...existing,\n            text,\n            edited_at: nowIso(),\n          } as TEntry;\n          document.metadata[config.collectionKey] = entries as never;\n          return { changedFields: [config.collectionKey] };\n        },\n      });\n    } catch (error: unknown) {\n      wrapOwnershipConflict(error, config.conflictGuidance);\n    }\n    const allEntries = readAnnotationEntries<TEntry>(\n      result.item,\n      config.collectionKey,\n    );\n    return renderAnnotationResult(\n      result.item.id,\n      config.collectionKey,\n      allEntries,\n      limit,\n      options.includeMeta === true,\n    );\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: config.op,\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: config.bypassOwnershipConflict,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(\n          document.metadata,\n          config.collectionKey,\n        );\n        entries.push({\n          created_at: nowIso(),\n          author,\n          text,\n        } as TEntry);\n        document.metadata[config.collectionKey] = entries as never;\n        return { changedFields: [config.collectionKey] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, config.conflictGuidance);\n  }\n\n  const allEntries = readAnnotationEntries<TEntry>(\n    result.item,\n    config.collectionKey,\n  );\n  return renderAnnotationResult(\n    result.item.id,\n    config.collectionKey,\n    allEntries,\n    limit,\n    options.includeMeta === true,\n  );\n}\n\n/** Implements resolve annotation index for the public runtime surface of this module. */\nexport function resolveAnnotationIndex(\n  oneBasedIndex: number | undefined,\n  count: number,\n  collectionKey: string,\n): number {\n  if (\n    oneBasedIndex === undefined ||\n    !Number.isInteger(oneBasedIndex) ||\n    oneBasedIndex < 1 ||\n    oneBasedIndex > count\n  ) {\n    const singular = collectionKey.replace(/s$/, \"\");\n    const label = `${singular.charAt(0).toUpperCase()}${singular.slice(1)}`;\n    const noun = count === 1 ? `1 ${singular}` : `${count} ${collectionKey}`;\n    throw new PmCliError(\n      `${label} index ${oneBasedIndex ?? \"(missing)\"} out of range (item has ${noun})`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return oneBasedIndex - 1;\n}\n\nfunction renderAnnotationResult<\n  TKey extends string,\n  TEntry extends AnnotationEntry,\n>(\n  id: string,\n  collectionKey: TKey,\n  allEntries: TEntry[],\n  limit: number | undefined,\n  includeMeta: boolean,\n): AnnotationCommandResult<TKey, TEntry> {\n  const entries = limitAnnotationEntries(allEntries, limit);\n  return {\n    id,\n    [collectionKey]: entries,\n    count: entries.length,\n    ...(includeMeta\n      ? {\n          total_count: allEntries.length,\n          returned_count: entries.length,\n          has_more: entries.length < allEntries.length,\n          ...(limit !== undefined ? { limit } : {}),\n        }\n      : {}),\n  } as AnnotationCommandResult<TKey, TEntry>;\n}\n"],
+  "mappings": "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",
   "names": ["global", "allEntries", "result"]
 }

package/dist/cli-bundle/chunks/{chunk-U6RYD446.js → chunk-HRW7GF6T.js}

@@ -5,19 +5,19 @@ import {
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-V4QHAMI5.js";
+} from "./chunk-GROYI4RB.js";
 import {
   hasListFilters
 } from "./chunk-N7V7TI6J.js";
 import {
   runList
-} from "./chunk-YG56M3NE.js";
+} from "./chunk-7DOJC3HS.js";
 import {
   runClose
-} from "./chunk-EI3UIMZM.js";
+} from "./chunk-OWXOPDHD.js";
 import {
   runRestore
-} from "./chunk-FQF6VVPH.js";
+} from "./chunk-MYSS5H2A.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -27,7 +27,7 @@ import {
   listAllItemMetadataLight,
   nowIso,
   readSettings
-} from "./chunk-QFG4MB7P.js";
+} from "./chunk-POG76WWZ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -37,7 +37,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   toErrorMessage
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/cli/commands/close-many.js
 var CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
@@ -399,6 +399,6 @@ export {
   runCloseMany,
   _testOnly
 };
-//# sourceMappingURL=chunk-U6RYD446.js.map
+//# sourceMappingURL=chunk-HRW7GF6T.js.map
 
 //# debugId=25f9bc90-a71d-54c0-916a-8c3972f6df68

package/dist/cli-bundle/chunks/{chunk-D35WYXWC.js → chunk-HYW67VJ5.js}

@@ -1,6 +1,6 @@
 // dist/core/fs/fs-utils.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]="236f0bc3-3408-510b-9449-4755558bc2fb")}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]="3af22af8-c497-5963-8e12-98ea9732ce39")}catch(e){}}();
 import * as fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -450,6 +450,9 @@ function cloneOptionalArray(values) {
 var SETTINGS_DEFAULTS = {
   version: 1,
   id_prefix: "pm-",
+  ids: {
+    token_length: 4
+  },
   author_default: "",
   item_format: "toon",
   locks: {
@@ -6855,6 +6858,6 @@ export {
   parseRegisteredItemFieldAssignments,
   applyRegisteredItemFieldDefaultsAndValidation
 };
-//# sourceMappingURL=chunk-D35WYXWC.js.map
+//# sourceMappingURL=chunk-HYW67VJ5.js.map
 
-//# debugId=236f0bc3-3408-510b-9449-4755558bc2fb
+//# debugId=3af22af8-c497-5963-8e12-98ea9732ce39