@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/cli-bundle/chunks/{chunk-A5EQPNV7.js → chunk-GVT754PX.js}

@@ -1,13 +1,13 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/core/item/parse.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] = "fb39edac-1965-5a52-9c0c-c4330fe3a8c7");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bef9b240-c34d-5d8b-a08f-e0fb77fceef5");
   } catch (e2) {
   }
 })();
@@ -64,6 +64,45 @@ function normalizeBaseTags(baseTags) {
   }
   return baseTags.filter((tag) => typeof tag === "string").map((tag) => tag.trim().toLowerCase()).filter(Boolean);
 }
+function splitAcceptanceCriteria(value) {
+  if (typeof value !== "string") {
+    return [];
+  }
+  return value.split(";").map((criterion) => criterion.trim()).filter(Boolean);
+}
+function applyAcceptanceCriteriaMutations(baseCriteria, add, remove) {
+  const criteria = baseCriteria.map((criterion) => criterion.trim()).filter(Boolean);
+  for (const raw of add ?? []) {
+    const criterion = raw.trim();
+    if (criterion.includes(";")) {
+      throw new PmCliError('Acceptance criteria added with --add-ac cannot contain ";" because semicolons delimit stored criteria', EXIT_CODE.USAGE, {
+        code: "acceptance_criteria_semicolon_forbidden",
+        required: "Pass one semicolon-free criterion per --add-ac value",
+        why: "A semicolon inside one criterion would be re-read as multiple criteria",
+        nextSteps: [
+          "Split the text into repeated --add-ac values, or replace the semicolon with punctuation that is not the storage delimiter"
+        ]
+      });
+    }
+    if (criterion.length > 0 && !criteria.includes(criterion)) {
+      criteria.push(criterion);
+    }
+  }
+  const unmatchedRemovals = [];
+  let remaining = criteria;
+  for (const raw of remove ?? []) {
+    const criterion = raw.trim();
+    if (criterion.length === 0) {
+      continue;
+    }
+    if (!remaining.includes(criterion)) {
+      unmatchedRemovals.push(criterion);
+      continue;
+    }
+    remaining = remaining.filter((entry) => entry !== criterion);
+  }
+  return { criteria: remaining, unmatchedRemovals };
+}
 function mergeAdditiveTags(baseTags, add) {
   const normalizedBase = normalizeBaseTags(baseTags);
   if (!add || add.length === 0) {
@@ -356,6 +395,8 @@ function parseOptionalNonNegativeInteger(raw, optionName) {
 
 export {
   parseTags,
+  splitAcceptanceCriteria,
+  applyAcceptanceCriteriaMutations,
   mergeAdditiveTags,
   applyTagRemovals,
   parseCsvKv,
@@ -365,4 +406,4 @@ export {
   parseOptionalNumber,
   parseOptionalNonNegativeInteger
 };
-//# sourceMappingURL=chunk-A5EQPNV7.js.map
+//# sourceMappingURL=chunk-GVT754PX.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/item/parse.ts"],
+  "sourcesContent": ["/**\n * @module core/item/parse\n *\n * Defines item parsing, formatting, and lifecycle helpers for Parse.\n */\nimport { PmCliError } from \"../shared/errors.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\n\nconst STDIN_TOKEN = \"-\";\nconst CONTINUABLE_VALUE_KEYS = new Set([\n  \"actual_result\",\n  \"body\",\n  \"cmd\",\n  \"command\",\n  \"customer_impact\",\n  \"description\",\n  \"environment\",\n  \"expected_result\",\n  \"impact\",\n  \"location\",\n  \"message\",\n  \"note\",\n  \"outcome\",\n  \"repro_steps\",\n  \"resolution\",\n  \"text\",\n  \"title\",\n  \"unblock_note\",\n  \"value\",\n  \"why_now\",\n]);\n\n/** Implements parse tags for the public runtime surface of this module. */\nexport function parseTags(raw: string): string[] {\n  const trimmed = raw.trim();\n  if (trimmed === \"\") {\n    return [];\n  }\n  const source = coerceJsonTagArray(trimmed) ?? trimmed;\n  const tags = source\n    .split(\",\")\n    .map((tag) => tag.trim())\n    .filter(Boolean)\n    .map((tag) => tag.toLowerCase());\n  return Array.from(new Set(tags)).sort((a, b) => a.localeCompare(b));\n}\n\n/** Merge repeated `--add-tags` / `--remove-tags` values into a single normalized tag list. Each entry can itself be CSV or a JSON array, mirroring the format accepted by `--tags`. Returns a deterministically sorted, deduped list. */\nexport function collectTagFlagValues(\n  values: readonly string[] | undefined,\n): string[] {\n  if (!Array.isArray(values) || values.length === 0) {\n    return [];\n  }\n  const collected: string[] = [];\n  for (const raw of values) {\n    if (typeof raw !== \"string\") {\n      continue;\n    }\n    for (const tag of parseTags(raw)) {\n      collected.push(tag);\n    }\n  }\n  return Array.from(new Set(collected)).sort((a, b) => a.localeCompare(b));\n}\n\n/** Normalize a base tag list to the canonical form pm stores: trimmed, lowercased, non-empty. Existing item-metadata tags are almost always already canonical (parseTags lowercases on write), but legacy or hand-edited `.toon` files can carry mixed-case entries — normalizing here keeps additive and subtractive mutations case-insensitive (so `--add-tags beta` dedupes against an existing `Beta`, and `--remove-tags alpha` removes an existing `Alpha`). */\nfunction normalizeBaseTags(baseTags: readonly string[]): string[] {\n  // Defensive: item-metadata parsed from corrupted/hand-edited `.toon` (or an\n  // external SDK caller) could pass a non-array or non-string entries despite\n  // the `string[]` type — guard the array and skip non-strings rather than\n  // throwing on `.filter`/`.trim()`.\n  if (!Array.isArray(baseTags)) {\n    return [];\n  }\n  return baseTags\n    .filter((tag): tag is string => typeof tag === \"string\")\n    .map((tag) => tag.trim().toLowerCase())\n    .filter(Boolean);\n}\n\n/** Split a stored `acceptance_criteria` value into its individual criteria. Criteria are stored as one string joined with `\"; \"` (repeated `--ac` values accumulate that way), so the semicolon is the criterion boundary and cannot appear inside one criterion; entries are trimmed and blanks dropped. Non-string/absent values yield an empty list. */\nexport function splitAcceptanceCriteria(value: unknown): string[] {\n  if (typeof value !== \"string\") {\n    return [];\n  }\n  return value\n    .split(\";\")\n    .map((criterion) => criterion.trim())\n    .filter(Boolean);\n}\n\n/** Apply additive/subtractive acceptance-criteria mutations to a base criteria list. Used by `pm update --add-ac/--remove-ac` so individual semicolon-free criteria can be edited without replacing the whole `acceptance_criteria` value (tag-API parity; disjoint additions merge cleanly across branches). Additions append in argv order and dedupe on exact trimmed text; removals match exact trimmed text and report unmatched selectors so a typo never becomes a silent no-op. */\nexport function applyAcceptanceCriteriaMutations(\n  baseCriteria: readonly string[],\n  add: readonly string[] | undefined,\n  remove: readonly string[] | undefined,\n): { criteria: string[]; unmatchedRemovals: string[] } {\n  const criteria = baseCriteria\n    .map((criterion) => criterion.trim())\n    .filter(Boolean);\n  for (const raw of add ?? []) {\n    const criterion = raw.trim();\n    if (criterion.includes(\";\")) {\n      throw new PmCliError(\n        'Acceptance criteria added with --add-ac cannot contain \";\" because semicolons delimit stored criteria',\n        EXIT_CODE.USAGE,\n        {\n          code: \"acceptance_criteria_semicolon_forbidden\",\n          required: \"Pass one semicolon-free criterion per --add-ac value\",\n          why: \"A semicolon inside one criterion would be re-read as multiple criteria\",\n          nextSteps: [\n            \"Split the text into repeated --add-ac values, or replace the semicolon with punctuation that is not the storage delimiter\",\n          ],\n        },\n      );\n    }\n    if (criterion.length > 0 && !criteria.includes(criterion)) {\n      criteria.push(criterion);\n    }\n  }\n  const unmatchedRemovals: string[] = [];\n  let remaining = criteria;\n  for (const raw of remove ?? []) {\n    const criterion = raw.trim();\n    if (criterion.length === 0) {\n      continue;\n    }\n    if (!remaining.includes(criterion)) {\n      unmatchedRemovals.push(criterion);\n      continue;\n    }\n    remaining = remaining.filter((entry) => entry !== criterion);\n  }\n  return { criteria: remaining, unmatchedRemovals };\n}\n\n/** Apply an additive tag mutation to a base tag list. Used by `pm create` and `pm update` so `--add-tags` extends `--tags` (or the existing tags) without replacing them. Output is sorted + deduped lowercase, matching `parseTags`. */\nexport function mergeAdditiveTags(\n  baseTags: readonly string[],\n  add: readonly string[] | undefined,\n): string[] {\n  const normalizedBase = normalizeBaseTags(baseTags);\n  if (!add || add.length === 0) {\n    return Array.from(new Set(normalizedBase)).sort((a, b) =>\n      a.localeCompare(b),\n    );\n  }\n  const merged = new Set<string>(normalizedBase);\n  for (const tag of collectTagFlagValues(add)) {\n    merged.add(tag);\n  }\n  return Array.from(merged).sort((a, b) => a.localeCompare(b));\n}\n\n/** Apply a subtractive tag mutation to a base tag list. Used by `pm update` so `--remove-tags x,y` prunes those entries without rewriting the full set. Removal is case-insensitive: both the base list and the removal selectors are normalized to canonical lowercase before matching. */\nexport function applyTagRemovals(\n  baseTags: readonly string[],\n  remove: readonly string[] | undefined,\n): string[] {\n  const normalizedBase = Array.from(new Set(normalizeBaseTags(baseTags))).sort(\n    (a, b) => a.localeCompare(b),\n  );\n  if (!remove || remove.length === 0) {\n    return normalizedBase;\n  }\n  const removeSet = new Set(collectTagFlagValues(remove));\n  if (removeSet.size === 0) {\n    return normalizedBase;\n  }\n  return normalizedBase.filter((tag) => !removeSet.has(tag));\n}\n\n// Agents and MCP callers frequently pass --tags as a JSON array (e.g.\n// `--tags '[\"a\",\"b\"]'`). The MCP server normalizes that upstream, but direct\n// CLI invocations used to write the raw bracket string into item metadata,\n// silently corrupting tags. Accept JSON arrays of primitives transparently.\nfunction coerceJsonTagArray(trimmed: string): string | null {\n  if (!trimmed.startsWith(\"[\")) {\n    return null;\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(trimmed);\n  } catch {\n    return null;\n  }\n  const parsedArray = parsed as unknown[];\n  return parsedArray\n    .map((entry) =>\n      typeof entry === \"string\" ||\n      typeof entry === \"number\" ||\n      typeof entry === \"boolean\"\n        ? String(entry).replace(/,/g, \" \")\n        : \"\",\n    )\n    .filter((entry) => entry.length > 0)\n    .join(\",\");\n}\n\nfunction normalizeLineEndings(value: string): string {\n  return value.replace(/\\r\\n/g, \"\\n\");\n}\n\nfunction stripCodeFenceEnvelope(value: string): string {\n  const normalized = normalizeLineEndings(value).trim();\n  if (!normalized.startsWith(\"```\")) {\n    return value;\n  }\n  const lines = normalized.split(\"\\n\");\n  if (lines.length < 2) {\n    return value;\n  }\n  if (lines.at(-1)?.trim() !== \"```\") {\n    return value;\n  }\n  return lines.slice(1, -1).join(\"\\n\");\n}\n\nfunction splitCsvSegments(raw: string): string[] {\n  const segments: string[] = [];\n  let current = \"\";\n  let inQuotes = false;\n  let escaped = false;\n\n  for (const char of raw) {\n    if (escaped) {\n      current += char;\n      escaped = false;\n      continue;\n    }\n    if (char === \"\\\\\") {\n      current += char;\n      escaped = true;\n      continue;\n    }\n    if (char === '\"') {\n      inQuotes = !inQuotes;\n      current += char;\n      continue;\n    }\n    if (char === \",\" && !inQuotes) {\n      segments.push(current.trim());\n      current = \"\";\n      continue;\n    }\n    current += char;\n  }\n  if (current.trim()) {\n    segments.push(current.trim());\n  }\n  return segments;\n}\n\nfunction unquoteValue(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return trimmed.slice(1, -1).replace(/\\\\\"/g, '\"');\n  }\n  return value;\n}\n\nfunction findKeyValueDelimiter(segment: string): number {\n  const equalsIndex = segment.indexOf(\"=\");\n  const colonIndex = segment.indexOf(\":\");\n  const hasEquals = equalsIndex > 0;\n  const hasColon = colonIndex > 0;\n  if (hasEquals && hasColon) {\n    return Math.min(equalsIndex, colonIndex);\n  }\n  if (hasEquals) {\n    return equalsIndex;\n  }\n  if (hasColon) {\n    return colonIndex;\n  }\n  return -1;\n}\n\nfunction buildOptionSpecificKvGuidance(\n  raw: string,\n  optionName: string,\n): string {\n  if (optionName === \"--add\" || optionName === \"--add-glob\") {\n    const looksLikePath =\n      /[./\\\\]/.test(raw) || /\\.[a-z]{1,6}$/i.test(raw.trim());\n    if (looksLikePath) {\n      return \"For file/doc paths use: path=<file-path>[,scope=project|global]. The scope field is optional and defaults to project (example: path=src/api.ts or path=README.md,scope=project). \";\n    }\n  }\n  if (optionName !== \"--event\") {\n    return \"\";\n  }\n  const lowered = raw.toLowerCase();\n  const recurrenceHint =\n    lowered.includes(\"recur_\") || lowered.includes(\"recurrence\")\n      ? ' Recurrence list values must stay in one field and use \"|\" delimiters (for example recur_by_weekday=mon|wed or recur_by_month_day=1|15).'\n      : \"\";\n  const weekdayAliasHint = lowered.includes(\"recur_byweekday\")\n    ? \" Use recur_by_weekday (with underscores) for weekday recurrence filters.\"\n    : \"\";\n  return `${recurrenceHint}${weekdayAliasHint}`;\n}\n\nfunction buildInvalidKvMessage(raw: string, optionName: string): string {\n  const condensed = raw.replaceAll(/\\s+/g, \" \").trim();\n  const preview =\n    condensed.length > 160 ? `${condensed.slice(0, 157)}...` : condensed;\n  const optionSpecificGuidance = buildOptionSpecificKvGuidance(raw, optionName);\n  return (\n    `Invalid ${optionName} value \"${preview}\". Expected key=value entries separated by commas. ` +\n    optionSpecificGuidance +\n    'Also accepts markdown-style key/value lines (for example \"- path: README.md\"). ' +\n    `Use ${optionName} ${STDIN_TOKEN} to read piped stdin input.`\n  );\n}\n\nfunction parseMarkdownKeyValueLines(\n  raw: string,\n): Record<string, string> | null {\n  const normalized = stripCodeFenceEnvelope(raw).trim();\n  if (normalized.length === 0) {\n    return null;\n  }\n  if (\n    !normalized.includes(\"\\n\") &&\n    !normalized.startsWith(\"-\") &&\n    !normalized.startsWith(\"*\") &&\n    !normalized.startsWith(\"+\")\n  ) {\n    return null;\n  }\n\n  const result: Record<string, string> = {};\n  let activeKey: string | undefined;\n  const lines = normalizeLineEndings(normalized)\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n\n  for (const line of lines) {\n    const match = line.match(/^(?:[-*+]\\s+)?([a-zA-Z0-9_.-]+)\\s*(=|:)\\s*(.*)$/);\n    if (match) {\n      const key = match[1].trim();\n      result[key] = unquoteValue(match[3].trim());\n      activeKey = key;\n      continue;\n    }\n    if (activeKey && CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())) {\n      result[activeKey] = `${result[activeKey]}\\n${line}`;\n      continue;\n    }\n    return null;\n  }\n\n  return result;\n}\n\n/** Implements parse csv kv for the public runtime surface of this module. */\nexport function parseCsvKv(\n  raw: string,\n  optionName: string,\n): Record<string, string> {\n  const trimmed = stripCodeFenceEnvelope(raw).trim();\n  if (!trimmed) {\n    throw new PmCliError(`${optionName} cannot be empty`, EXIT_CODE.USAGE);\n  }\n\n  const markdownStyle = parseMarkdownKeyValueLines(trimmed);\n  if (markdownStyle) {\n    return markdownStyle;\n  }\n\n  const result: Record<string, string> = {};\n  let activeKey: string | undefined;\n  const segments = splitCsvSegments(trimmed);\n\n  for (const segment of segments) {\n    const delimiterIndex = findKeyValueDelimiter(segment);\n    if (delimiterIndex > 0) {\n      const key = segment.slice(0, delimiterIndex).trim();\n      const value = unquoteValue(segment.slice(delimiterIndex + 1).trim());\n      result[key] = value;\n      activeKey = key;\n      continue;\n    }\n    if (activeKey && CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())) {\n      result[activeKey] = `${result[activeKey]},${segment.trim()}`;\n      continue;\n    }\n    throw new PmCliError(\n      buildInvalidKvMessage(raw, optionName),\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return result;\n}\n\nconst WINDOWS_ABSOLUTE_PATH_PATTERN = /^[A-Za-z]:[\\\\/]/;\nconst GENERIC_LEADING_KV_KEY_PATTERN =\n  /^(?:[-*+]\\s+)?[A-Za-z_][A-Za-z0-9_.-]*\\s*=/;\n\n/**\n * Detect a CSV/markdown entry that opens with a generic `key=` token even when\n * that key is unknown (e.g. a typo like `lable=main,path=README.md`). Callers\n * combine this with their known-key prefix check so a first-key typo is routed\n * through structured parsing and rejected by {@link assertNoUnknownCsvKeys}\n * (GH-258) instead of being silently swallowed as a bare path/value.\n *\n * Windows absolute paths (`C:\\…`) are excluded so a drive-lettered bare path is\n * never misread as a `C=…` key/value entry.\n */\nexport function looksLikeGenericKeyValueEntry(raw: string): boolean {\n  const trimmed = raw.trim();\n  if (WINDOWS_ABSOLUTE_PATH_PATTERN.test(trimmed)) {\n    return false;\n  }\n  return GENERIC_LEADING_KV_KEY_PATTERN.test(trimmed);\n}\n\n/**\n * Reject any key in a parsed CSV/markdown key/value map that is not part of the\n * caller's allowed-key contract, mirroring the strict `test --add` behavior\n * (see linked-test-parsers). This closes the cross-command consistency defect\n * (GH-258) where structured link/metadata parsers silently DROPPED typoed keys\n * (e.g. `lable=` instead of `label=`), storing data the author never intended.\n *\n * Comparison is case-insensitive so a key the downstream reader would accept\n * (e.g. `Path`) is never falsely rejected; the emitted \"Allowed keys\" list\n * preserves the canonical casing the caller passes in. Recognized keys are then\n * normalized in-place to their lowercase canonical form so downstream readers\n * (`kv.path`, `kv.id`, `kv.at`, …) see the value even when the input used mixed\n * casing — otherwise `Path=README.md` would pass validation yet read back as an\n * undefined `path` and surface a confusing \"requires path\" error. A key that\n * collides with another after normalization (e.g. `path=a,Path=b`) is rejected.\n *\n * Parsers with an intentional plaintext fallback (`--comment`/`--note`/\n * `--learning`, annotation `--add`) deliberately do NOT call this — there an\n * unrecognized key means \"treat the whole entry as plaintext\", not an error.\n */\nexport function assertNoUnknownCsvKeys(\n  kv: Record<string, string>,\n  optionName: string,\n  allowedKeys: readonly string[],\n): void {\n  const allowed = new Set(allowedKeys.map((key) => key.toLowerCase()));\n  const unknownKeys = Object.keys(kv).filter(\n    (key) => !allowed.has(key.toLowerCase()),\n  );\n  if (unknownKeys.length > 0) {\n    throw new PmCliError(\n      `${optionName} does not recognize key${unknownKeys.length > 1 ? \"s\" : \"\"} ${unknownKeys\n        .map((key) => `\"${key}\"`)\n        .join(\", \")}. Allowed keys: ${allowedKeys.join(\", \")}.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  for (const key of Object.keys(kv)) {\n    const normalizedKey = key.toLowerCase();\n    if (normalizedKey === key) {\n      continue;\n    }\n    if (Object.hasOwn(kv, normalizedKey)) {\n      throw new PmCliError(\n        `${optionName} provides key \"${key}\" more than once after case normalization.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    kv[normalizedKey] = kv[key];\n    delete kv[key];\n  }\n}\n\nasync function readStdinText(optionName: string): Promise<string> {\n  if (process.stdin.isTTY === true) {\n    throw new PmCliError(\n      `${optionName} value \"${STDIN_TOKEN}\" requires piped stdin input. Pipe content into the command, or end manual stdin with Ctrl+D (Unix/macOS) or Ctrl+Z then Enter (Windows).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  process.stdin.setEncoding(\"utf8\");\n  return await new Promise<string>((resolve, reject) => {\n    let input = \"\";\n    process.stdin.on(\"data\", (chunk: string) => {\n      input += chunk;\n    });\n    process.stdin.on(\"end\", () => {\n      resolve(normalizeLineEndings(input));\n    });\n    process.stdin.on(\"error\", (error) => {\n      reject(error);\n    });\n  });\n}\n\n/** Documents the stdin token resolver payload exchanged by command, SDK, and package integrations. */\nexport interface StdinTokenResolver {\n  /** Value that configures or reports resolve value for this contract. */\n  resolveValue(\n    value: string | undefined,\n    optionName: string,\n  ): Promise<string | undefined>;\n  /** Value that configures or reports resolve list for this contract. */\n  resolveList(\n    values: string[] | undefined,\n    optionName: string,\n  ): Promise<string[] | undefined>;\n}\n\n/** Implements create stdin token resolver for the public runtime surface of this module. */\nexport function createStdinTokenResolver(): StdinTokenResolver {\n  let stdinValuePromise: Promise<string> | undefined;\n  let stdinConsumerOption: string | undefined;\n\n  const consumeStdin = async (optionName: string): Promise<string> => {\n    if (stdinConsumerOption && stdinConsumerOption !== optionName) {\n      throw new PmCliError(\n        `Only one option may use \"${STDIN_TOKEN}\" stdin token per command invocation. Already used by ${stdinConsumerOption}.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    stdinConsumerOption = optionName;\n    if (!stdinValuePromise) {\n      stdinValuePromise = readStdinText(optionName);\n    }\n    return await stdinValuePromise;\n  };\n\n  const resolveValue = async (\n    value: string | undefined,\n    optionName: string,\n  ): Promise<string | undefined> => {\n    if (value === undefined) {\n      return undefined;\n    }\n    if (value.trim() !== STDIN_TOKEN) {\n      return value;\n    }\n    return await consumeStdin(optionName);\n  };\n\n  const resolveList = async (\n    values: string[] | undefined,\n    optionName: string,\n  ): Promise<string[] | undefined> => {\n    if (!values) {\n      return undefined;\n    }\n    const tokenIndexes = values\n      .map((entry, index) => (entry.trim() === STDIN_TOKEN ? index : -1))\n      .filter((index) => index >= 0);\n    if (tokenIndexes.length === 0) {\n      return values;\n    }\n    if (tokenIndexes.length > 1) {\n      throw new PmCliError(\n        `${optionName} accepts \"${STDIN_TOKEN}\" stdin token at most once per command invocation`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const stdinValue = await consumeStdin(optionName);\n    const next = [...values];\n    next[tokenIndexes[0]] = stdinValue;\n    return next;\n  };\n\n  return {\n    resolveValue,\n    resolveList,\n  };\n}\n\n/** Implements parse optional number for the public runtime surface of this module. */\nexport function parseOptionalNumber(raw: string, optionName: string): number {\n  const value = Number(raw);\n  if (!Number.isFinite(value)) {\n    throw new PmCliError(\n      `Invalid ${optionName} value \"${raw}\"`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/** Parse a non-negative integer option such as an item duration estimate. */\nexport function parseOptionalNonNegativeInteger(\n  raw: string,\n  optionName: string,\n): number {\n  const trimmed = raw.trim();\n  const value = Number(trimmed);\n  if (trimmed === \"\" || !Number.isInteger(value) || value < 0) {\n    throw new PmCliError(\n      `Invalid ${optionName} value \"${raw}\". Expected a non-negative integer.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  coerceJsonTagArray,\n  stripCodeFenceEnvelope,\n  parseMarkdownKeyValueLines,\n};\n"],
+  "mappings": ";;;;;;;;;;;;;AAQA,IAAM,cAAc;AACpB,IAAM,yBAAyB,oBAAI,IAAI;EACrC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACD;AAGK,SAAU,UAAU,KAAW;AACnC,QAAM,UAAU,IAAI,KAAI;AACxB,MAAI,YAAY,IAAI;AAClB,WAAO,CAAA;EACT;AACA,QAAM,SAAS,mBAAmB,OAAO,KAAK;AAC9C,QAAM,OAAO,OACV,MAAM,GAAG,EACT,IAAI,CAAC,QAAQ,IAAI,KAAI,CAAE,EACvB,OAAO,OAAO,EACd,IAAI,CAAC,QAAQ,IAAI,YAAW,CAAE;AACjC,SAAO,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACpE;AAGM,SAAU,qBACd,QAAqC;AAErC,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,GAAG;AACjD,WAAO,CAAA;EACT;AACA,QAAM,YAAsB,CAAA;AAC5B,aAAW,OAAO,QAAQ;AACxB,QAAI,OAAO,QAAQ,UAAU;AAC3B;IACF;AACA,eAAW,OAAO,UAAU,GAAG,GAAG;AAChC,gBAAU,KAAK,GAAG;IACpB;EACF;AACA,SAAO,MAAM,KAAK,IAAI,IAAI,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACzE;AAGA,SAAS,kBAAkB,UAA2B;AAKpD,MAAI,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC5B,WAAO,CAAA;EACT;AACA,SAAO,SACJ,OAAO,CAAC,QAAuB,OAAO,QAAQ,QAAQ,EACtD,IAAI,CAAC,QAAQ,IAAI,KAAI,EAAG,YAAW,CAAE,EACrC,OAAO,OAAO;AACnB;AAGM,SAAU,wBAAwB,OAAc;AACpD,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,CAAA;EACT;AACA,SAAO,MACJ,MAAM,GAAG,EACT,IAAI,CAAC,cAAc,UAAU,KAAI,CAAE,EACnC,OAAO,OAAO;AACnB;AAGM,SAAU,iCACd,cACA,KACA,QAAqC;AAErC,QAAM,WAAW,aACd,IAAI,CAAC,cAAc,UAAU,KAAI,CAAE,EACnC,OAAO,OAAO;AACjB,aAAW,OAAO,OAAO,CAAA,GAAI;AAC3B,UAAM,YAAY,IAAI,KAAI;AAC1B,QAAI,UAAU,SAAS,GAAG,GAAG;AAC3B,YAAM,IAAI,WACR,yGACA,UAAU,OACV;QACE,MAAM;QACN,UAAU;QACV,KAAK;QACL,WAAW;UACT;;OAEH;IAEL;AACA,QAAI,UAAU,SAAS,KAAK,CAAC,SAAS,SAAS,SAAS,GAAG;AACzD,eAAS,KAAK,SAAS;IACzB;EACF;AACA,QAAM,oBAA8B,CAAA;AACpC,MAAI,YAAY;AAChB,aAAW,OAAO,UAAU,CAAA,GAAI;AAC9B,UAAM,YAAY,IAAI,KAAI;AAC1B,QAAI,UAAU,WAAW,GAAG;AAC1B;IACF;AACA,QAAI,CAAC,UAAU,SAAS,SAAS,GAAG;AAClC,wBAAkB,KAAK,SAAS;AAChC;IACF;AACA,gBAAY,UAAU,OAAO,CAAC,UAAU,UAAU,SAAS;EAC7D;AACA,SAAO,EAAE,UAAU,WAAW,kBAAiB;AACjD;AAGM,SAAU,kBACd,UACA,KAAkC;AAElC,QAAM,iBAAiB,kBAAkB,QAAQ;AACjD,MAAI,CAAC,OAAO,IAAI,WAAW,GAAG;AAC5B,WAAO,MAAM,KAAK,IAAI,IAAI,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,MAClD,EAAE,cAAc,CAAC,CAAC;EAEtB;AACA,QAAM,SAAS,IAAI,IAAY,cAAc;AAC7C,aAAW,OAAO,qBAAqB,GAAG,GAAG;AAC3C,WAAO,IAAI,GAAG;EAChB;AACA,SAAO,MAAM,KAAK,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAC7D;AAGM,SAAU,iBACd,UACA,QAAqC;AAErC,QAAM,iBAAiB,MAAM,KAAK,IAAI,IAAI,kBAAkB,QAAQ,CAAC,CAAC,EAAE,KACtE,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAE9B,MAAI,CAAC,UAAU,OAAO,WAAW,GAAG;AAClC,WAAO;EACT;AACA,QAAM,YAAY,IAAI,IAAI,qBAAqB,MAAM,CAAC;AACtD,MAAI,UAAU,SAAS,GAAG;AACxB,WAAO;EACT;AACA,SAAO,eAAe,OAAO,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC;AAC3D;AAMA,SAAS,mBAAmB,SAAe;AACzC,MAAI,CAAC,QAAQ,WAAW,GAAG,GAAG;AAC5B,WAAO;EACT;AACA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,OAAO;EAC7B,QAAQ;AACN,WAAO;EACT;AACA,QAAM,cAAc;AACpB,SAAO,YACJ,IAAI,CAAC,UACJ,OAAO,UAAU,YACjB,OAAO,UAAU,YACjB,OAAO,UAAU,YACb,OAAO,KAAK,EAAE,QAAQ,MAAM,GAAG,IAC/B,EAAE,EAEP,OAAO,CAAC,UAAU,MAAM,SAAS,CAAC,EAClC,KAAK,GAAG;AACb;AAEA,SAAS,qBAAqB,OAAa;AACzC,SAAO,MAAM,QAAQ,SAAS,IAAI;AACpC;AAEA,SAAS,uBAAuB,OAAa;AAC3C,QAAM,aAAa,qBAAqB,KAAK,EAAE,KAAI;AACnD,MAAI,CAAC,WAAW,WAAW,KAAK,GAAG;AACjC,WAAO;EACT;AACA,QAAM,QAAQ,WAAW,MAAM,IAAI;AACnC,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO;EACT;AACA,MAAI,MAAM,GAAG,EAAE,GAAG,KAAI,MAAO,OAAO;AAClC,WAAO;EACT;AACA,SAAO,MAAM,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI;AACrC;AAEA,SAAS,iBAAiB,KAAW;AACnC,QAAM,WAAqB,CAAA;AAC3B,MAAI,UAAU;AACd,MAAI,WAAW;AACf,MAAI,UAAU;AAEd,aAAW,QAAQ,KAAK;AACtB,QAAI,SAAS;AACX,iBAAW;AACX,gBAAU;AACV;IACF;AACA,QAAI,SAAS,MAAM;AACjB,iBAAW;AACX,gBAAU;AACV;IACF;AACA,QAAI,SAAS,KAAK;AAChB,iBAAW,CAAC;AACZ,iBAAW;AACX;IACF;AACA,QAAI,SAAS,OAAO,CAAC,UAAU;AAC7B,eAAS,KAAK,QAAQ,KAAI,CAAE;AAC5B,gBAAU;AACV;IACF;AACA,eAAW;EACb;AACA,MAAI,QAAQ,KAAI,GAAI;AAClB,aAAS,KAAK,QAAQ,KAAI,CAAE;EAC9B;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAa;AACjC,QAAM,UAAU,MAAM,KAAI;AAC1B,MAAI,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG;AACpD,WAAO,QAAQ,MAAM,GAAG,EAAE,EAAE,QAAQ,QAAQ,GAAG;EACjD;AACA,SAAO;AACT;AAEA,SAAS,sBAAsB,SAAe;AAC5C,QAAM,cAAc,QAAQ,QAAQ,GAAG;AACvC,QAAM,aAAa,QAAQ,QAAQ,GAAG;AACtC,QAAM,YAAY,cAAc;AAChC,QAAM,WAAW,aAAa;AAC9B,MAAI,aAAa,UAAU;AACzB,WAAO,KAAK,IAAI,aAAa,UAAU;EACzC;AACA,MAAI,WAAW;AACb,WAAO;EACT;AACA,MAAI,UAAU;AACZ,WAAO;EACT;AACA,SAAO;AACT;AAEA,SAAS,8BACP,KACA,YAAkB;AAElB,MAAI,eAAe,WAAW,eAAe,cAAc;AACzD,UAAM,gBACJ,SAAS,KAAK,GAAG,KAAK,iBAAiB,KAAK,IAAI,KAAI,CAAE;AACxD,QAAI,eAAe;AACjB,aAAO;IACT;EACF;AACA,MAAI,eAAe,WAAW;AAC5B,WAAO;EACT;AACA,QAAM,UAAU,IAAI,YAAW;AAC/B,QAAM,iBACJ,QAAQ,SAAS,QAAQ,KAAK,QAAQ,SAAS,YAAY,IACvD,6IACA;AACN,QAAM,mBAAmB,QAAQ,SAAS,iBAAiB,IACvD,6EACA;AACJ,SAAO,GAAG,cAAc,GAAG,gBAAgB;AAC7C;AAEA,SAAS,sBAAsB,KAAa,YAAkB;AAC5D,QAAM,YAAY,IAAI,WAAW,QAAQ,GAAG,EAAE,KAAI;AAClD,QAAM,UACJ,UAAU,SAAS,MAAM,GAAG,UAAU,MAAM,GAAG,GAAG,CAAC,QAAQ;AAC7D,QAAM,yBAAyB,8BAA8B,KAAK,UAAU;AAC5E,SACE,WAAW,UAAU,WAAW,OAAO,wDACvC,yBACA,sFACO,UAAU,IAAI,WAAW;AAEpC;AAEA,SAAS,2BACP,KAAW;AAEX,QAAM,aAAa,uBAAuB,GAAG,EAAE,KAAI;AACnD,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;EACT;AACA,MACE,CAAC,WAAW,SAAS,IAAI,KACzB,CAAC,WAAW,WAAW,GAAG,KAC1B,CAAC,WAAW,WAAW,GAAG,KAC1B,CAAC,WAAW,WAAW,GAAG,GAC1B;AACA,WAAO;EACT;AAEA,QAAM,SAAiC,CAAA;AACvC,MAAI;AACJ,QAAM,QAAQ,qBAAqB,UAAU,EAC1C,MAAM,IAAI,EACV,IAAI,CAAC,SAAS,KAAK,KAAI,CAAE,EACzB,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;AAEnC,aAAW,QAAQ,OAAO;AACxB,UAAM,QAAQ,KAAK,MAAM,iDAAiD;AAC1E,QAAI,OAAO;AACT,YAAM,MAAM,MAAM,CAAC,EAAE,KAAI;AACzB,aAAO,GAAG,IAAI,aAAa,MAAM,CAAC,EAAE,KAAI,CAAE;AAC1C,kBAAY;AACZ;IACF;AACA,QAAI,aAAa,uBAAuB,IAAI,UAAU,YAAW,CAAE,GAAG;AACpE,aAAO,SAAS,IAAI,GAAG,OAAO,SAAS,CAAC;EAAK,IAAI;AACjD;IACF;AACA,WAAO;EACT;AAEA,SAAO;AACT;AAGM,SAAU,WACd,KACA,YAAkB;AAElB,QAAM,UAAU,uBAAuB,GAAG,EAAE,KAAI;AAChD,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,WAAW,GAAG,UAAU,oBAAoB,UAAU,KAAK;EACvE;AAEA,QAAM,gBAAgB,2BAA2B,OAAO;AACxD,MAAI,eAAe;AACjB,WAAO;EACT;AAEA,QAAM,SAAiC,CAAA;AACvC,MAAI;AACJ,QAAM,WAAW,iBAAiB,OAAO;AAEzC,aAAW,WAAW,UAAU;AAC9B,UAAM,iBAAiB,sBAAsB,OAAO;AACpD,QAAI,iBAAiB,GAAG;AACtB,YAAM,MAAM,QAAQ,MAAM,GAAG,cAAc,EAAE,KAAI;AACjD,YAAM,QAAQ,aAAa,QAAQ,MAAM,iBAAiB,CAAC,EAAE,KAAI,CAAE;AACnE,aAAO,GAAG,IAAI;AACd,kBAAY;AACZ;IACF;AACA,QAAI,aAAa,uBAAuB,IAAI,UAAU,YAAW,CAAE,GAAG;AACpE,aAAO,SAAS,IAAI,GAAG,OAAO,SAAS,CAAC,IAAI,QAAQ,KAAI,CAAE;AAC1D;IACF;AACA,UAAM,IAAI,WACR,sBAAsB,KAAK,UAAU,GACrC,UAAU,KAAK;EAEnB;AAEA,SAAO;AACT;AAEA,IAAM,gCAAgC;AACtC,IAAM,iCACJ;AAYI,SAAU,8BAA8B,KAAW;AACvD,QAAM,UAAU,IAAI,KAAI;AACxB,MAAI,8BAA8B,KAAK,OAAO,GAAG;AAC/C,WAAO;EACT;AACA,SAAO,+BAA+B,KAAK,OAAO;AACpD;AAsBM,SAAU,uBACd,IACA,YACA,aAA8B;AAE9B,QAAM,UAAU,IAAI,IAAI,YAAY,IAAI,CAAC,QAAQ,IAAI,YAAW,CAAE,CAAC;AACnE,QAAM,cAAc,OAAO,KAAK,EAAE,EAAE,OAClC,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,YAAW,CAAE,CAAC;AAE1C,MAAI,YAAY,SAAS,GAAG;AAC1B,UAAM,IAAI,WACR,GAAG,UAAU,0BAA0B,YAAY,SAAS,IAAI,MAAM,EAAE,IAAI,YACzE,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,EACvB,KAAK,IAAI,CAAC,mBAAmB,YAAY,KAAK,IAAI,CAAC,KACtD,UAAU,KAAK;EAEnB;AACA,aAAW,OAAO,OAAO,KAAK,EAAE,GAAG;AACjC,UAAM,gBAAgB,IAAI,YAAW;AACrC,QAAI,kBAAkB,KAAK;AACzB;IACF;AACA,QAAI,OAAO,OAAO,IAAI,aAAa,GAAG;AACpC,YAAM,IAAI,WACR,GAAG,UAAU,kBAAkB,GAAG,8CAClC,UAAU,KAAK;IAEnB;AACA,OAAG,aAAa,IAAI,GAAG,GAAG;AAC1B,WAAO,GAAG,GAAG;EACf;AACF;AAEA,eAAe,cAAc,YAAkB;AAC7C,MAAI,QAAQ,MAAM,UAAU,MAAM;AAChC,UAAM,IAAI,WACR,GAAG,UAAU,WAAW,WAAW,6IACnC,UAAU,KAAK;EAEnB;AACA,UAAQ,MAAM,YAAY,MAAM;AAChC,SAAO,MAAM,IAAI,QAAgB,CAAC,SAAS,WAAU;AACnD,QAAI,QAAQ;AACZ,YAAQ,MAAM,GAAG,QAAQ,CAAC,UAAiB;AACzC,eAAS;IACX,CAAC;AACD,YAAQ,MAAM,GAAG,OAAO,MAAK;AAC3B,cAAQ,qBAAqB,KAAK,CAAC;IACrC,CAAC;AACD,YAAQ,MAAM,GAAG,SAAS,CAAC,UAAS;AAClC,aAAO,KAAK;IACd,CAAC;EACH,CAAC;AACH;AAiBM,SAAU,2BAAwB;AACtC,MAAI;AACJ,MAAI;AAEJ,QAAM,eAAe,OAAO,eAAuC;AACjE,QAAI,uBAAuB,wBAAwB,YAAY;AAC7D,YAAM,IAAI,WACR,4BAA4B,WAAW,yDAAyD,mBAAmB,KACnH,UAAU,KAAK;IAEnB;AACA,0BAAsB;AACtB,QAAI,CAAC,mBAAmB;AACtB,0BAAoB,cAAc,UAAU;IAC9C;AACA,WAAO,MAAM;EACf;AAEA,QAAM,eAAe,OACnB,OACA,eAC+B;AAC/B,QAAI,UAAU,QAAW;AACvB,aAAO;IACT;AACA,QAAI,MAAM,KAAI,MAAO,aAAa;AAChC,aAAO;IACT;AACA,WAAO,MAAM,aAAa,UAAU;EACtC;AAEA,QAAM,cAAc,OAClB,QACA,eACiC;AACjC,QAAI,CAAC,QAAQ;AACX,aAAO;IACT;AACA,UAAM,eAAe,OAClB,IAAI,CAAC,OAAO,UAAW,MAAM,KAAI,MAAO,cAAc,QAAQ,EAAG,EACjE,OAAO,CAAC,UAAU,SAAS,CAAC;AAC/B,QAAI,aAAa,WAAW,GAAG;AAC7B,aAAO;IACT;AACA,QAAI,aAAa,SAAS,GAAG;AAC3B,YAAM,IAAI,WACR,GAAG,UAAU,aAAa,WAAW,qDACrC,UAAU,KAAK;IAEnB;AACA,UAAM,aAAa,MAAM,aAAa,UAAU;AAChD,UAAM,OAAO,CAAC,GAAG,MAAM;AACvB,SAAK,aAAa,CAAC,CAAC,IAAI;AACxB,WAAO;EACT;AAEA,SAAO;IACL;IACA;;AAEJ;AAGM,SAAU,oBAAoB,KAAa,YAAkB;AACjE,QAAM,QAAQ,OAAO,GAAG;AACxB,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,UAAM,IAAI,WACR,WAAW,UAAU,WAAW,GAAG,KACnC,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAGM,SAAU,gCACd,KACA,YAAkB;AAElB,QAAM,UAAU,IAAI,KAAI;AACxB,QAAM,QAAQ,OAAO,OAAO;AAC5B,MAAI,YAAY,MAAM,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AAC3D,UAAM,IAAI,WACR,WAAW,UAAU,WAAW,GAAG,uCACnC,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/cli-bundle/chunks/{chunk-Y2VSGFT4.js → chunk-HB3P4M52.js}

@@ -1,12 +1,12 @@
 
-!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]="1d3e8c05-a64c-5eb5-abc1-d39235f19add")}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]="2d594eeb-b3b9-55ff-80ae-8acbfeadd295")}catch(e){}}();
 import {
   createStdinTokenResolver,
   parseCsvKv
-} from "./chunk-SVAWG7EE.js";
+} from "./chunk-J4FBIFU6.js";
 import {
   parseLimit
-} from "./chunk-FIUTBFC6.js";
+} from "./chunk-K4CI6Y45.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -17,7 +17,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-QFG4MB7P.js";
+} from "./chunk-POG76WWZ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -25,7 +25,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-D35WYXWC.js";
+} from "./chunk-HYW67VJ5.js";
 
 // dist/sdk/annotations.js
 import { readFile } from "node:fs/promises";
@@ -163,7 +163,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, global, config) {
+  assertAnnotationMessageHasTextSource(config, options);
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -308,6 +323,6 @@ export {
   runAnnotationCommand,
   resolveAnnotationIndex
 };
-//# sourceMappingURL=chunk-Y2VSGFT4.js.map
+//# sourceMappingURL=chunk-HB3P4M52.js.map
 
-//# debugId=1d3e8c05-a64c-5eb5-abc1-d39235f19add
+//# debugId=2d594eeb-b3b9-55ff-80ae-8acbfeadd295

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

@@ -0,0 +1 @@
+{"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/**\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"],"names":["allEntries","result"],"mappings":"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","debugId":"2d594eeb-b3b9-55ff-80ae-8acbfeadd295"}

package/dist/cli-bundle/chunks/{chunk-STBCBDKF.js → chunk-HCEBZNC3.js}

@@ -1,23 +1,23 @@
 import {
   parseNestedSettingValue,
   resolveNestedSettingDescriptor
-} from "./chunk-Q3K5XPAQ.js";
+} from "./chunk-SR3JOATZ.js";
 import {
   normalizeStatusToken
-} from "./chunk-KAE727L2.js";
+} from "./chunk-FSRHYUDA.js";
 import {
   TYPE_PRESET_DEFINITIONS,
   normalizeAddFieldInput,
   normalizeAddStatusInput
-} from "./chunk-OK7VSX3N.js";
+} from "./chunk-UZLJOEAC.js";
 import {
   normalizeAddTypeInput
-} from "./chunk-4M6RZJXF.js";
+} from "./chunk-WWNL6WMH.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   DEFAULT_RUNTIME_STATUS_DEFINITIONS,
   toErrorMessage
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/core/profile/profile-presets.js
 !(function() {
@@ -680,4 +680,4 @@ export {
   PROFILE_LINT_CODES,
   lintProjectProfile
 };
-//# sourceMappingURL=chunk-STBCBDKF.js.map
+//# sourceMappingURL=chunk-HCEBZNC3.js.map

package/dist/cli-bundle/chunks/{chunk-EEECAV5M.js → chunk-HEWM6CEN.js}

@@ -9,7 +9,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-WCBB6VI3.js";
+} from "./chunk-7AVEY74G.js";
 
 // dist/sdk/cli-contracts/command-aliases.js
 !(function() {
@@ -184,7 +184,7 @@ function readStringArrayFromCommanderOptions(options, contract) {
 !(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] = "e24dde30-eff8-578f-9538-c727c730e651");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "51857768-f713-5ad4-b280-c0947735cc22");
   } catch (e2) {
   }
 })();
@@ -793,6 +793,26 @@ var UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
       }
     ]
   },
+  {
+    target: "addAc",
+    keys: ["addAc", "add_ac"],
+    option: "--add-ac <value>",
+    description: "Add one semicolon-free acceptance criterion without replacing the existing list (repeatable)",
+    repeatable: true,
+    aliasOptions: [
+      { option: "--add_ac <value>", description: "Alias for --add-ac" }
+    ]
+  },
+  {
+    target: "removeAc",
+    keys: ["removeAc", "remove_ac"],
+    option: "--remove-ac <value>",
+    description: "Remove one semicolon-free acceptance criterion by exact text match (repeatable)",
+    repeatable: true,
+    aliasOptions: [
+      { option: "--remove_ac <value>", description: "Alias for --remove-ac" }
+    ]
+  },
   {
     target: "definitionOfReady",
     keys: ["definitionOfReady", "definition_of_ready"],
@@ -1173,7 +1193,7 @@ var UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_REGIS
 !(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] = "a665adfd-c6a7-544c-a3f9-55a6d5fa4472");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f20198fe-b251-5de9-ad5d-d045726195e4");
   } catch (e2) {
   }
 })();
@@ -1226,6 +1246,7 @@ var PM_CORE_COMMAND_NAMES = [
   "history-redact",
   "history-repair",
   "history-compact",
+  "merge",
   "schema",
   "profile",
   "activity",
@@ -1381,7 +1402,7 @@ function isPmExtensionPolicySurfaceContract(value) {
 !(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] = "bbb41f64-eaab-546b-b21e-9535853ee1f9");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b8a7f15e-86ea-5601-9af2-31307e1ba2f1");
   } catch (e2) {
   }
 })();
@@ -1493,7 +1514,7 @@ var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
   { param: "limit", flag: "--limit" },
   { param: "after", flag: "--after" }
 ];
-var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
+var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE = [
   { param: "parent", flag: "--parent" },
   { param: "reviewer", flag: "--reviewer" },
   { param: "risk", flag: "--risk" },
@@ -1528,7 +1549,9 @@ var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
   { param: "outcome", flag: "--outcome" },
   { param: "whyNow", flag: "--why-now" }
 ];
-var TOOL_CREATE_OPTION_CONTRACTS = [
+var TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE);
+var TOOL_CREATE_OPTION_CONTRACT_SOURCE = [
+  { param: "id", flag: "--id" },
   { param: "title", flag: "--title" },
   { param: "description", flag: "--description", allowEmpty: true },
   { param: "type", flag: "--type" },
@@ -1574,7 +1597,8 @@ var TOOL_CREATE_OPTION_CONTRACTS = [
   { param: "clearEvents", flag: "--clear-events" },
   { param: "clearTypeOptions", flag: "--clear-type-options" }
 ];
-var TOOL_UPDATE_OPTION_CONTRACTS = [
+var TOOL_CREATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_CREATE_OPTION_CONTRACT_SOURCE);
+var TOOL_UPDATE_OPTION_CONTRACT_SOURCE = [
   { param: "title", flag: "--title" },
   { param: "description", flag: "--description", allowEmpty: true },
   { param: "body", flag: "--body", allowEmpty: true },
@@ -1592,6 +1616,8 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
     flag: "--acceptance-criteria",
     allowEmpty: true
   },
+  { param: "addAc", flag: "--add-ac", repeatable: true },
+  { param: "removeAc", flag: "--remove-ac", repeatable: true },
   { param: "author", flag: "--author" },
   { param: "message", flag: "--message", allowEmpty: true },
   { param: "assignee", flag: "--assignee" },
@@ -1621,7 +1647,8 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
   { param: "clearEvents", flag: "--clear-events" },
   { param: "clearTypeOptions", flag: "--clear-type-options" }
 ];
-var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
+var TOOL_UPDATE_OPTION_CONTRACTS = cloneOptionContracts(TOOL_UPDATE_OPTION_CONTRACT_SOURCE);
+var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE = [
   { param: "filterStatus", flag: "--filter-status" },
   { param: "filterType", flag: "--filter-type" },
   { param: "filterTag", flag: "--filter-tag" },
@@ -1664,8 +1691,8 @@ var TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS = [
   { param: "limit", flag: "--limit" },
   { param: "offset", flag: "--offset" }
 ];
-var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)];
-var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [...cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACTS)];
+var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE);
+var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = cloneOptionContracts(TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE);
 var TOOL_CALENDAR_OPTION_CONTRACTS = [
   { param: "view", flag: "--view" },
   { param: "date", flag: "--date" },
@@ -1749,7 +1776,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "c5e59d37-0b45-54cc-93a0-4e52a78d6dd0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "68a38b11-9be2-50ea-b718-a4d2e579b2b6");
   } catch (e2) {
   }
 })();
@@ -1997,8 +2024,16 @@ var HISTORY_FLAG_CONTRACTS = [
   { flag: "--diff" },
   { flag: "--field" },
   { flag: "--verify" },
+  { flag: "--strict-exit" },
+  { flag: "--fail-on-warn" },
   { flag: "--format" }
 ];
+var MERGE_FLAG_CONTRACTS = [
+  { flag: "--dry-run" },
+  { flag: "--output" },
+  { flag: "--item-path" },
+  { flag: "--prefer" }
+];
 var HISTORY_REDACT_FLAG_CONTRACTS = [
   { flag: "--literal" },
   { flag: "--regex" },
@@ -2501,7 +2536,8 @@ var VALIDATE_FLAG_CONTRACTS = [
   { flag: "--fix-scope" },
   { flag: "--prune-missing" },
   { flag: "--check-history-drift" },
-  { flag: "--check-command-references" }
+  { flag: "--check-command-references" },
+  { flag: "--check-storage-integrity" }
 ];
 var CREATE_FLAG_CONTRACTS = [
   { short: "-t", flag: "--title" },
@@ -2630,6 +2666,8 @@ var UPDATE_FLAG_CONTRACTS = [
   { flag: "--acceptance-criteria" },
   { flag: "--acceptance_criteria" },
   { flag: "--ac" },
+  { flag: "--add-ac", aliases: ["--add_ac"] },
+  { flag: "--remove-ac", aliases: ["--remove_ac"] },
   { flag: "--assignee" },
   { flag: "--parent" },
   { flag: "--reviewer" },
@@ -2751,6 +2789,8 @@ var UPDATE_MANY_FLAG_CONTRACTS = [
   { flag: "--acceptance-criteria" },
   { flag: "--acceptance_criteria" },
   { flag: "--ac" },
+  { flag: "--add-ac", aliases: ["--add_ac"] },
+  { flag: "--remove-ac", aliases: ["--remove_ac"] },
   { flag: "--definition-of-ready" },
   { flag: "--definition_of_ready" },
   { flag: "--order" },
@@ -3048,6 +3088,7 @@ var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
   ["history-redact", HISTORY_REDACT_FLAG_CONTRACTS],
   ["history-repair", HISTORY_REPAIR_FLAG_CONTRACTS],
   ["history-compact", HISTORY_COMPACT_FLAG_CONTRACTS],
+  ["merge", MERGE_FLAG_CONTRACTS],
   ["schema", SCHEMA_FLAG_CONTRACTS],
   ["profile", PROFILE_FLAG_CONTRACTS],
   ["plan", PLAN_FLAG_CONTRACTS],
@@ -3139,7 +3180,7 @@ function toCompletionFlagString(flagContracts, includeGlobal = true) {
 !(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] = "d9640c02-2d99-5ec4-b954-c6f5800d3af4");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "199e5ddc-b0fd-5080-84d6-ea8deba6cad8");
   } catch (e2) {
   }
 })();
@@ -3226,6 +3267,8 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   tags: { type: "string" },
   addTags: { type: "array", items: { type: "string" } },
   removeTags: { type: "array", items: { type: "string" } },
+  addAc: { type: "array", items: { type: "string" } },
+  removeAc: { type: "array", items: { type: "string" } },
   body: { type: "string" },
   deadline: { type: "string" },
   estimate: { anyOf: [{ type: "string" }, { type: "number" }] },
@@ -3929,6 +3972,14 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Tags to add to the existing list without replacing it. Each entry may be CSV or a JSON array.",
     examples: [["agent-ux"], ["fix", "security"]]
   },
+  addAc: {
+    description: "Acceptance criteria appended individually without replacing the existing list (one criterion per entry).",
+    examples: [["error path covered by a regression test"]]
+  },
+  removeAc: {
+    description: "Acceptance criteria removed individually by exact text match (one criterion per entry).",
+    examples: [["superseded manual QA step"]]
+  },
   removeTags: {
     description: "Tags to remove from the existing list. Each entry may be CSV or a JSON array.",
     examples: [["stale"], ["legacy", "wontfix"]]
@@ -4111,7 +4162,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "For focus action: clear the session focused item instead of setting it (mutually exclusive with id)."
   },
   gcScope: {
-    description: "Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints).",
+    description: "Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints, transactions).",
     examples: [
       ["index", "embeddings"],
       ["runtime"],
@@ -4533,7 +4584,7 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
 !(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] = "b2640e2f-8ec1-5746-a121-018b7de82393");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bec68349-edf8-5d8c-af83-8a9a8d6e4a6c");
   } catch (e2) {
   }
 })();
@@ -4707,6 +4758,16 @@ var NEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "includeDecisions"
 ]);
 var AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
+var CLOSE_ACTION_OPTION_KEYS = [
+  "text",
+  "reason",
+  "closeReason",
+  "duplicateOf",
+  "validateClose",
+  "resolution",
+  "expectedResult",
+  "actualResult"
+];
 var LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = [
   "author",
   "assignee",
@@ -5047,14 +5108,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   close: {
     required: ["id"],
     optional: [
-      "text",
-      "reason",
-      "closeReason",
-      "duplicateOf",
-      "validateClose",
-      "resolution",
-      "expectedResult",
-      "actualResult",
+      ...CLOSE_ACTION_OPTION_KEYS,
       ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS
     ]
   },
@@ -5587,7 +5641,7 @@ var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderC
 !(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] = "04a1cf17-7ffe-56c2-bf4d-73e4368161f5");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b44f482f-1898-5cd5-b56e-9a62c1420a57");
   } catch (e2) {
   }
 })();
@@ -5647,6 +5701,7 @@ export {
   FILES_FLAG_CONTRACTS,
   DOCS_FLAG_CONTRACTS,
   HISTORY_FLAG_CONTRACTS,
+  MERGE_FLAG_CONTRACTS,
   HISTORY_REDACT_FLAG_CONTRACTS,
   HISTORY_REPAIR_FLAG_CONTRACTS,
   HISTORY_COMPACT_FLAG_CONTRACTS,
@@ -5721,4 +5776,4 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-EEECAV5M.js.map
+//# sourceMappingURL=chunk-HEWM6CEN.js.map