@unbrained/pm-cli 2026.7.13 → 2026.7.14

package/dist/cli-bundle/chunks/{chunk-HR2MQAO5.js.map → chunk-WD6MSYMP.js.map}

@@ -1,7 +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/** 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/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  coerceJsonTagArray,\n  stripCodeFenceEnvelope,\n  parseMarkdownKeyValueLines,\n};\n"],
-  "mappings": "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",
+  "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/** 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": "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",
   "names": []
 }

package/dist/cli-bundle/chunks/{chunk-P7IFURWH.js → chunk-WPAWZW7S.js}

@@ -3,7 +3,7 @@
 import {
   getRuntimePath,
   writeFileAtomic
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/core/session/session-state.js
 import { promises as fs } from "node:fs";
@@ -53,6 +53,6 @@ export {
   setFocusedItem,
   clearFocusedItem
 };
-//# sourceMappingURL=chunk-P7IFURWH.js.map
+//# sourceMappingURL=chunk-WPAWZW7S.js.map
 
 //# debugId=fe0c58a0-d285-583a-abd6-66aa25b9b668

package/dist/cli-bundle/chunks/{chunk-36LEOWSX.js → chunk-WQUEHPZB.js}

@@ -1,7 +1,7 @@
 import {
   collectUsedExtensionCapabilities,
   normalizeExtensionName
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/extensions/activation-summary.js
 !(function() {
@@ -157,4 +157,4 @@ export {
   describeExtensionActivation,
   renderExtensionSurfaceMarkdown
 };
-//# sourceMappingURL=chunk-36LEOWSX.js.map
+//# sourceMappingURL=chunk-WQUEHPZB.js.map

package/dist/cli-bundle/chunks/{chunk-FCKJF7G2.js → chunk-WRKB56FC.js}

@@ -2,7 +2,7 @@ import {
   nowIso,
   readSettings,
   writeSettings
-} from "./chunk-QXYKH56X.js";
+} from "./chunk-T4BRCB6Z.js";
 import {
   EXIT_CODE,
   appendLineAtomic,
@@ -11,7 +11,7 @@ import {
   resolvePmPackageRootFromModule,
   resolveTelemetryErrorCategory,
   writeFileAtomic
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/telemetry/observability.js
 !(function() {
@@ -1838,4 +1838,4 @@ export {
   finishTelemetryCommand,
   emitTelemetryErrorEvent
 };
-//# sourceMappingURL=chunk-FCKJF7G2.js.map
+//# sourceMappingURL=chunk-WRKB56FC.js.map

package/dist/cli-bundle/chunks/{chunk-KR5EHAN4.js → chunk-X3GYR4P2.js}

@@ -3,7 +3,7 @@
 import {
   isTerminalStatus,
   normalizeStatusForRegistry
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 
 // dist/core/item/actionability.js
 var BLOCKED_BY_DEPENDENCY_KIND = "blocked_by";
@@ -124,6 +124,6 @@ export {
   collectBlockedByIds,
   computeActionabilityReport
 };
-//# sourceMappingURL=chunk-KR5EHAN4.js.map
+//# sourceMappingURL=chunk-X3GYR4P2.js.map
 
 //# debugId=2fcf91f3-1b2e-5b80-a790-93055aee4f49

package/dist/cli-bundle/chunks/{chunk-J567OZJY.js → chunk-X6BVXQ52.js}

@@ -1,17 +1,17 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7a66ec9a-0bcf-56b7-9bc4-ab1bb888cfee")}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]="3989319a-d22e-5fcf-8ba2-e68e13692e87")}catch(e){}}();
 import {
   createCheckpointId,
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-GNVBUNJQ.js";
+} from "./chunk-ZTRBSABY.js";
 import {
   runRestore
-} from "./chunk-QHIN4UTF.js";
+} from "./chunk-ZAYYDNB3.js";
 import {
   runUpdate
-} from "./chunk-VLFLRFJP.js";
+} from "./chunk-CIOZ376P.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -20,18 +20,19 @@ import {
 } from "./chunk-N7V7TI6J.js";
 import {
   runList
-} from "./chunk-2PR4ZTRO.js";
+} from "./chunk-6TTOHMTB.js";
 import {
   resolvePriority
-} from "./chunk-56DX6QYG.js";
+} from "./chunk-HL7V2PHX.js";
 import {
   applyTagRemovals,
   mergeAdditiveTags,
+  parseOptionalNonNegativeInteger,
   parseTags
-} from "./chunk-L4262MFB.js";
+} from "./chunk-QK2ZN6UL.js";
 import {
   buildInvalidTypeError
-} from "./chunk-3P3RFJIQ.js";
+} from "./chunk-3TL7WOEF.js";
 import {
   collectRuntimeUpdateFieldValues,
   getActiveExtensionRegistrations,
@@ -41,7 +42,7 @@ import {
   resolveIsoOrRelative,
   stableValueEquals,
   toItemRecord
-} from "./chunk-TNGLCRKS.js";
+} from "./chunk-GSEADLRH.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -54,7 +55,7 @@ import {
   resolveRuntimeStatusRegistry,
   resolveTypeName,
   toErrorMessage
-} from "./chunk-TGG7YGMC.js";
+} from "./chunk-GXXC7QSK.js";
 
 // dist/cli/commands/update-many.js
 var UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
@@ -451,6 +452,9 @@ function assertPlannedUpdateValuesValid(update, settings, statusRegistry, pmRoot
   if (update.deadline !== void 0) {
     resolveIsoOrRelative(update.deadline, /* @__PURE__ */ new Date(), "deadline");
   }
+  if (update.estimatedMinutes !== void 0) {
+    parseOptionalNonNegativeInteger(update.estimatedMinutes, "estimated-minutes");
+  }
 }
 async function runUpdateManyRollback(params) {
   const checkpoint = await loadMutationCheckpoint(params.pmRoot, UPDATE_MANY_CHECKPOINT_SUBDIR, params.rollbackId, UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION);
@@ -644,6 +648,6 @@ export {
   runUpdateMany,
   _testOnlyUpdateManyCommand
 };
-//# sourceMappingURL=chunk-J567OZJY.js.map
+//# sourceMappingURL=chunk-X6BVXQ52.js.map
 
-//# debugId=7a66ec9a-0bcf-56b7-9bc4-ab1bb888cfee
+//# debugId=3989319a-d22e-5fcf-8ba2-e68e13692e87

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/update-many.ts"],"sourcesContent":["/**\n * @module cli/commands/update-many\n *\n * Implements the pm update many command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  createCheckpointId,\n  loadMutationCheckpoint,\n  restoreCheckpointItems,\n  writeMutationCheckpoint,\n  type MutationCheckpointItem,\n} from \"../../core/checkpoint/mutation-checkpoint.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport {\n  applyTagRemovals,\n  mergeAdditiveTags,\n  parseOptionalNonNegativeInteger,\n  parseTags,\n} from \"../../core/item/parse.js\";\nimport { resolvePriority } from \"../../core/item/priority.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport {\n  resolveItemTypeRegistry,\n  resolveTypeName,\n} from \"../../core/item/type-registry.js\";\nimport { collectRuntimeUpdateFieldValues } from \"../../core/schema/runtime-field-values.js\";\nimport { buildInvalidTypeError } from \"../../core/schema/item-types-file.js\";\nimport {\n  resolveItemTypesFilePath,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  type RuntimeFieldRegistry,\n  type RuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.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 { toErrorMessage } from \"../../core/shared/primitives.js\";\nimport { stableValueEquals } from \"../../core/shared/serialization.js\";\nimport { nowIso, resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport type { PmSettings } from \"../../types/index.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { ItemStatus } from \"../../types/index.js\";\nimport { hasListFilters } from \"./list-filter-shared.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\nimport { runUpdate, type UpdateCommandOptions } from \"./update.js\";\n\nconst UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst UPDATE_MANY_CHECKPOINT_SUBDIR = \"update-many\";\n\nconst NON_MUTATION_UPDATE_OPTION_KEYS = new Set<PropertyKey>([\n  \"author\",\n  \"message\",\n  \"force\",\n  \"ownershipMetadataBypass\",\n  \"ownershipDependencyBypass\",\n]);\n\nconst UPDATE_MANY_MUTATION_FLAG_GUIDANCE = [\n  \"--status\",\n  \"--priority\",\n  \"--type\",\n  \"--tags\",\n  \"--description\",\n  \"--body\",\n  \"--deadline\",\n  \"--estimate\",\n  \"--assignee\",\n  \"--dep\",\n  \"--dep-remove\",\n  \"--comment\",\n  \"--note\",\n  \"--learning\",\n  \"--file\",\n  \"--test\",\n  \"--doc\",\n  \"--replace-deps\",\n  \"--replace-tests\",\n  \"--unset\",\n  \"--clear-*\",\n].join(\", \");\n\nconst UPDATE_OPTION_TO_ITEM_KEY: Partial<\n  Record<keyof UpdateCommandOptions, string>\n> = {\n  title: \"title\",\n  description: \"description\",\n  body: \"body\",\n  status: \"status\",\n  closeReason: \"close_reason\",\n  priority: \"priority\",\n  type: \"type\",\n  deadline: \"deadline\",\n  estimatedMinutes: \"estimated_minutes\",\n  acceptanceCriteria: \"acceptance_criteria\",\n  definitionOfReady: \"definition_of_ready\",\n  order: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  whyNow: \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blockedBy: \"blocked_by\",\n  blockedReason: \"blocked_reason\",\n  unblockNote: \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  reproSteps: \"repro_steps\",\n  resolution: \"resolution\",\n  expectedResult: \"expected_result\",\n  actualResult: \"actual_result\",\n  affectedVersion: \"affected_version\",\n  fixedVersion: \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customerImpact: \"customer_impact\",\n};\n\ninterface CollectionMutationPlanDefinition {\n  field: string;\n  addKey: keyof UpdateCommandOptions;\n  removeKey?: keyof UpdateCommandOptions;\n  clearKey: keyof UpdateCommandOptions;\n  replaceKey?: keyof UpdateCommandOptions;\n}\n\nconst COLLECTION_MUTATION_PLAN_DEFINITIONS: CollectionMutationPlanDefinition[] =\n  [\n    {\n      field: \"dependencies\",\n      addKey: \"dep\",\n      removeKey: \"depRemove\",\n      clearKey: \"clearDeps\",\n      replaceKey: \"replaceDeps\",\n    },\n    {\n      field: \"comments\",\n      addKey: \"comment\",\n      clearKey: \"clearComments\",\n    },\n    {\n      field: \"notes\",\n      addKey: \"note\",\n      clearKey: \"clearNotes\",\n    },\n    {\n      field: \"learnings\",\n      addKey: \"learning\",\n      clearKey: \"clearLearnings\",\n    },\n    {\n      field: \"files\",\n      addKey: \"file\",\n      clearKey: \"clearFiles\",\n    },\n    {\n      field: \"tests\",\n      addKey: \"test\",\n      clearKey: \"clearTests\",\n      replaceKey: \"replaceTests\",\n    },\n    {\n      field: \"docs\",\n      addKey: \"doc\",\n      clearKey: \"clearDocs\",\n    },\n    {\n      field: \"reminders\",\n      addKey: \"reminder\",\n      clearKey: \"clearReminders\",\n    },\n    {\n      field: \"events\",\n      addKey: \"event\",\n      clearKey: \"clearEvents\",\n    },\n    {\n      field: \"type_options\",\n      addKey: \"typeOption\",\n      clearKey: \"clearTypeOptions\",\n    },\n  ];\n\nconst UNSET_FIELD_ALIASES: Record<string, string> = {\n  close_reason: \"close_reason\",\n  \"close-reason\": \"close_reason\",\n  deadline: \"deadline\",\n  estimate: \"estimated_minutes\",\n  estimated_minutes: \"estimated_minutes\",\n  \"estimated-minutes\": \"estimated_minutes\",\n  acceptance_criteria: \"acceptance_criteria\",\n  \"acceptance-criteria\": \"acceptance_criteria\",\n  ac: \"acceptance_criteria\",\n  definition_of_ready: \"definition_of_ready\",\n  \"definition-of-ready\": \"definition_of_ready\",\n  order: \"order\",\n  rank: \"order\",\n  goal: \"goal\",\n  objective: \"objective\",\n  value: \"value\",\n  impact: \"impact\",\n  outcome: \"outcome\",\n  why_now: \"why_now\",\n  \"why-now\": \"why_now\",\n  assignee: \"assignee\",\n  parent: \"parent\",\n  reviewer: \"reviewer\",\n  risk: \"risk\",\n  confidence: \"confidence\",\n  sprint: \"sprint\",\n  release: \"release\",\n  blocked_by: \"blocked_by\",\n  \"blocked-by\": \"blocked_by\",\n  blocked_reason: \"blocked_reason\",\n  \"blocked-reason\": \"blocked_reason\",\n  unblock_note: \"unblock_note\",\n  \"unblock-note\": \"unblock_note\",\n  reporter: \"reporter\",\n  severity: \"severity\",\n  environment: \"environment\",\n  repro_steps: \"repro_steps\",\n  \"repro-steps\": \"repro_steps\",\n  resolution: \"resolution\",\n  expected_result: \"expected_result\",\n  \"expected-result\": \"expected_result\",\n  actual_result: \"actual_result\",\n  \"actual-result\": \"actual_result\",\n  affected_version: \"affected_version\",\n  \"affected-version\": \"affected_version\",\n  fixed_version: \"fixed_version\",\n  \"fixed-version\": \"fixed_version\",\n  component: \"component\",\n  regression: \"regression\",\n  customer_impact: \"customer_impact\",\n  \"customer-impact\": \"customer_impact\",\n  type_options: \"type_options\",\n  \"type-options\": \"type_options\",\n  tags: \"tags\",\n};\n\ninterface UpdateManyCheckpoint {\n  schema_version: number;\n  id: string;\n  created_at: string;\n  author: string;\n  status_filter: string | null;\n  list_filters: Record<string, unknown>;\n  update_options: Record<string, unknown>;\n  items: MutationCheckpointItem[];\n}\n\n/** Documents the update many command options payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyCommandOptions {\n  /** Lifecycle state reported for status. */\n  status?: string;\n  /** Value that configures or reports list for this contract. */\n  list: ListOptions;\n  /** Value that configures or reports update for this contract. */\n  update: UpdateCommandOptions;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports rollback for this contract. */\n  rollback?: string;\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: boolean;\n}\n\ninterface PlannedChange {\n  field: string;\n  before: unknown;\n  after: unknown;\n}\n\ninterface PlannedItemDiff {\n  id: string;\n  changes: PlannedChange[];\n}\n\ninterface UpdateManyApplyResultRow {\n  id: string;\n  status: \"updated\" | \"failed\" | \"skipped\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\ninterface UpdateManyRollbackResultRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\n/** Documents the update many result payload exchanged by command, SDK, and package integrations. */\nexport interface UpdateManyResult {\n  /** Value that configures or reports mode for this contract. */\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  /** Number of matched entries represented by this result. */\n  matched_count: number;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports filters for this contract. */\n  filters?: Record<string, unknown>;\n  /** Inputs that customize the planned update operation. */\n  planned_update_options?: Record<string, unknown>;\n  /** Value that configures or reports item plans for this contract. */\n  item_plans?: PlannedItemDiff[];\n  /** Value that configures or reports checkpoint for this contract. */\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  /** Number of updated entries represented by this result. */\n  updated_count?: number;\n  /** Number of skipped entries represented by this result. */\n  skipped_count?: number;\n  /** Number of failed entries represented by this result. */\n  failed_count?: number;\n  /** Number of restored entries represented by this result. */\n  restored_count?: number;\n  /** Value that configures or reports rollback checkpoint id for this contract. */\n  rollback_checkpoint_id?: string;\n  /** Value that configures or reports rows for this contract. */\n  rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];\n  /** Value that configures or reports ids for this contract. */\n  ids: string[];\n}\n\nfunction sanitizeUpdateOptionsForSummary(\n  options: UpdateCommandOptions,\n): Record<string, unknown> {\n  const summary: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options) as Array<\n    [keyof UpdateCommandOptions, unknown]\n  >) {\n    if (NON_MUTATION_UPDATE_OPTION_KEYS.has(key)) {\n      continue;\n    }\n    if (value === undefined) {\n      continue;\n    }\n    summary[key] = value;\n  }\n  return summary;\n}\n\nfunction hasAnyUpdateMutationInput(options: UpdateCommandOptions): boolean {\n  return Object.keys(sanitizeUpdateOptionsForSummary(options)).length > 0;\n}\n\nfunction toComparablePreviewValue(\n  optionKey: keyof UpdateCommandOptions,\n  value: unknown,\n): unknown {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (optionKey === \"priority\") {\n    const parsed = Number(String(value).trim());\n    return Number.isInteger(parsed) ? parsed : String(value).trim();\n  }\n  if (\n    optionKey === \"estimatedMinutes\" ||\n    optionKey === \"order\" ||\n    optionKey === \"rank\"\n  ) {\n    const parsed = Number(String(value).trim());\n    return Number.isFinite(parsed) ? parsed : String(value).trim();\n  }\n  if (optionKey === \"regression\") {\n    const normalized = String(value).trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  if (typeof value === \"string\") {\n    return value.trim();\n  }\n  return value;\n}\n\nfunction normalizeUnsetField(rawField: string): string {\n  const normalized = rawField.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  return UNSET_FIELD_ALIASES[normalized] ?? normalized;\n}\n\nfunction areValuesEqual(left: unknown, right: unknown): boolean {\n  return stableValueEquals(left, right);\n}\n\nfunction normalizeCollectionBeforeValue(\n  field: string,\n  value: unknown,\n): unknown {\n  if (value !== undefined) {\n    return value;\n  }\n  if (field === \"type_options\") {\n    return {};\n  }\n  return [];\n}\n\nfunction collectionValueCount(field: string, value: unknown): number {\n  if (Array.isArray(value)) {\n    return value.length;\n  }\n  if (field === \"type_options\" && value && typeof value === \"object\") {\n    return Object.keys(value as Record<string, unknown>).length;\n  }\n  return 0;\n}\n\nfunction buildCollectionMutationPlans(\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange[] {\n  const changes: PlannedChange[] = [];\n  for (const definition of COLLECTION_MUTATION_PLAN_DEFINITIONS) {\n    const addValues = update[definition.addKey];\n    const removeValues = definition.removeKey\n      ? update[definition.removeKey]\n      : undefined;\n    const addCount = Array.isArray(addValues) ? addValues.length : 0;\n    const removeCount = Array.isArray(removeValues) ? removeValues.length : 0;\n    const clear = update[definition.clearKey] === true;\n    const replace = definition.replaceKey\n      ? update[definition.replaceKey] === true\n      : false;\n    if (!clear && !replace && addCount === 0 && removeCount === 0) {\n      continue;\n    }\n\n    const before = normalizeCollectionBeforeValue(\n      definition.field,\n      row[definition.field],\n    );\n    const beforeCount = collectionValueCount(definition.field, before);\n    const operation = replace\n      ? \"replace\"\n      : clear\n        ? \"clear_or_reset\"\n        : removeCount > 0\n          ? \"merge_remove\"\n          : \"append\";\n    changes.push({\n      field: definition.field,\n      before,\n      after: {\n        operation,\n        clear,\n        replace,\n        add_count: addCount,\n        remove_count: removeCount,\n        before_count: beforeCount,\n      },\n    });\n  }\n  return changes;\n}\n\nfunction normalizeExistingTags(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value.filter((tag): tag is string => typeof tag === \"string\");\n}\n\n// Tags support three mutation modes that compose: --tags replaces, --add-tags\n// extends, --remove-tags prunes. Replicate runUpdate's resolution order so the\n// dry-run preview and the apply-mode actionable detection both account for\n// additive/subtractive tag mutations (a --add-tags-only update must NOT be\n// treated as a no-op skip).\nfunction buildTagMutationPlan(\n  row: Record<string, unknown>,\n  update: UpdateCommandOptions,\n): PlannedChange | undefined {\n  const hasReplace = update.tags !== undefined;\n  const hasAdd = Array.isArray(update.addTags) && update.addTags.length > 0;\n  const hasRemove =\n    Array.isArray(update.removeTags) && update.removeTags.length > 0;\n  if (!hasReplace && !hasAdd && !hasRemove) {\n    return undefined;\n  }\n  const existing = normalizeExistingTags(row.tags);\n  const baseTags = hasReplace ? parseTags(update.tags as string) : existing;\n  const withAdditions = mergeAdditiveTags(baseTags, update.addTags);\n  const after = applyTagRemovals(withAdditions, update.removeTags)\n    .slice()\n    .sort((a, b) => a.localeCompare(b));\n  const before = existing.slice().sort((a, b) => a.localeCompare(b));\n  if (areValuesEqual(before, after)) {\n    return undefined;\n  }\n  return { field: \"tags\", before: existing, after };\n}\n\nfunction buildPlannedItemDiff(\n  item: ListedItem,\n  update: UpdateCommandOptions = {},\n  runtimeFieldRegistry: RuntimeFieldRegistry,\n): PlannedItemDiff {\n  const safeUpdate = update;\n  const row = toItemRecord(item);\n  const changes: PlannedChange[] = [];\n  const tagPlan = buildTagMutationPlan(row, safeUpdate);\n  if (tagPlan) {\n    changes.push(tagPlan);\n  }\n  for (const [optionKey, itemKey] of Object.entries(\n    UPDATE_OPTION_TO_ITEM_KEY,\n  ) as Array<[keyof UpdateCommandOptions, string]>) {\n    const candidate = safeUpdate[optionKey];\n    if (candidate === undefined) {\n      continue;\n    }\n    const before = row[itemKey];\n    const after = toComparablePreviewValue(optionKey, candidate);\n    if (areValuesEqual(before, after)) {\n      continue;\n    }\n    changes.push({\n      field: itemKey,\n      before,\n      after,\n    });\n  }\n  changes.push(...buildCollectionMutationPlans(row, safeUpdate));\n\n  const runtimeFieldUpdates = collectRuntimeUpdateFieldValues(\n    safeUpdate as Record<string, unknown>,\n    runtimeFieldRegistry,\n    [\"update_many\"],\n  );\n  for (const [fieldKey, fieldValue] of Object.entries(runtimeFieldUpdates)) {\n    const before = row[fieldKey];\n    if (areValuesEqual(before, fieldValue)) {\n      continue;\n    }\n    changes.push({\n      field: fieldKey,\n      before,\n      after: fieldValue,\n    });\n  }\n\n  if (safeUpdate.unset && safeUpdate.unset.length > 0) {\n    for (const rawUnsetField of safeUpdate.unset) {\n      const field = normalizeUnsetField(rawUnsetField);\n      const before = row[field];\n      if (before === undefined) {\n        continue;\n      }\n      changes.push({\n        field,\n        before,\n        after: null,\n      });\n    }\n  }\n\n  return {\n    id: item.id,\n    changes,\n  };\n}\n\nfunction normalizeStatusFilter(\n  value: string | undefined,\n  statusRegistry: RuntimeStatusRegistry,\n): ItemStatus | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(value, statusRegistry);\n  if (!normalized) {\n    const allowedStatuses = statusRegistry.definitions.map(\n      (definition) => definition.id,\n    );\n    throw new PmCliError(\n      `Invalid --filter-status value \"${value}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction rejectBlankIdsFilter(list: ListOptions | undefined): void {\n  if (list?.ids != null && String(list.ids).trim().length === 0) {\n    throw new PmCliError(\n      \"--ids requires at least one non-empty item ID\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n// GH-256: validate planned scalar enum/format fields up front so a `--dry-run`\n// preview rejects globally-invalid values exactly as apply would (true\n// preview==apply parity), and so apply itself fails fast before creating an\n// orphan checkpoint. Only VALUE/ENUM/FORMAT correctness is checked here — these\n// are invalid regardless of the matched item. Per-item governance and\n// workflow-transition rules stay in the apply path (runUpdate). Each field is\n// validated only when the caller actually provided it, reusing the exact same\n// resolvers and error messages runUpdate raises so single/bulk/dry-run stay\n// consistent.\nfunction assertPlannedUpdateValuesValid(\n  update: UpdateCommandOptions,\n  settings: PmSettings,\n  statusRegistry: RuntimeStatusRegistry,\n  pmRoot: string,\n): void {\n  if (update.priority !== undefined) {\n    resolvePriority(update.priority);\n  }\n  if (update.type !== undefined) {\n    const typeRegistry = resolveItemTypeRegistry(\n      settings,\n      getActiveExtensionRegistrations(),\n    );\n    if (!resolveTypeName(update.type, typeRegistry)) {\n      throw new PmCliError(\n        buildInvalidTypeError(\n          update.type,\n          typeRegistry.types,\n          resolveItemTypesFilePath(pmRoot, settings.schema),\n        ),\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  if (\n    update.status !== undefined &&\n    !normalizeStatusInput(update.status, statusRegistry)\n  ) {\n    const allowedStatuses = statusRegistry.definitions.map(\n      (definition) => definition.id,\n    );\n    throw new PmCliError(\n      `Invalid --status value \"${update.status}\". Allowed: ${allowedStatuses.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (update.deadline !== undefined) {\n    resolveIsoOrRelative(update.deadline, new Date(), \"deadline\");\n  }\n  if (update.estimatedMinutes !== undefined) {\n    parseOptionalNonNegativeInteger(\n      update.estimatedMinutes,\n      \"estimated-minutes\",\n    );\n  }\n}\n\nasync function runUpdateManyRollback(params: {\n  pmRoot: string;\n  rollbackId: string;\n  options: UpdateManyCommandOptions;\n  global: GlobalOptions;\n}): Promise<UpdateManyResult> {\n  const checkpoint = await loadMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.rollbackId,\n    UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n  );\n  const restoreMessage =\n    params.options.update?.message ??\n    `Rollback update-many checkpoint ${checkpoint.id}`;\n  const rollback = await restoreCheckpointItems(\n    checkpoint.items,\n    (id, targetUpdatedAt) =>\n      runRestore(\n        id,\n        targetUpdatedAt,\n        {\n          author: params.options.update?.author,\n          message: restoreMessage,\n          force: params.options.update?.force ?? true,\n        },\n        params.global,\n      ),\n  );\n  return {\n    mode: \"rollback\",\n    matched_count: checkpoint.items.length,\n    dry_run: false,\n    rollback_checkpoint_id: checkpoint.id,\n    checkpoint: {\n      id: checkpoint.id,\n      created_at: checkpoint.created_at,\n      path: checkpoint.path,\n      rollback_command: `pm update-many --rollback ${checkpoint.id}`,\n    },\n    restored_count: rollback.restored_ids.length,\n    failed_count: rollback.failed_count,\n    rows: rollback.rows,\n    ids: rollback.restored_ids,\n  };\n}\n\nasync function writeUpdateManyCheckpoint(params: {\n  pmRoot: string;\n  checkpointId: string;\n  nowValue: string;\n  options: UpdateManyCommandOptions;\n  statusFilter: string | undefined;\n  filters: Record<string, unknown>;\n  updateSummary: Record<string, unknown>;\n  checkpointItems: MutationCheckpointItem[];\n}): Promise<UpdateManyResult[\"checkpoint\"]> {\n  const checkpointPayload: UpdateManyCheckpoint = {\n    schema_version: UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    author: resolveAuthor(params.options.update?.author, \"unknown\"),\n    status_filter: params.statusFilter ?? null,\n    list_filters: params.filters,\n    update_options: params.updateSummary,\n    items: params.checkpointItems,\n  };\n  const checkpointPath = await writeMutationCheckpoint(\n    params.pmRoot,\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    params.checkpointId,\n    checkpointPayload,\n  );\n  return {\n    id: params.checkpointId,\n    created_at: params.nowValue,\n    path: checkpointPath,\n    rollback_command: `pm update-many --rollback ${params.checkpointId}`,\n  };\n}\n\n/** Implements run update many for the public runtime surface of this module. */\nexport async function runUpdateMany(\n  options: UpdateManyCommandOptions,\n  global: GlobalOptions,\n): Promise<UpdateManyResult> {\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 statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);\n\n  const dryRun = options.dryRun === true;\n  const rollbackId =\n    typeof options.rollback === \"string\" ? options.rollback : undefined;\n  const updateSummary = sanitizeUpdateOptionsForSummary(options.update);\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId) {\n    if (dryRun) {\n      throw new PmCliError(\n        \"--dry-run cannot be combined with --rollback\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (hasListFilters(options.list, options.status)) {\n      throw new PmCliError(\n        \"Rollback mode does not accept filter options\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    if (Object.keys(updateSummary).length > 0) {\n      throw new PmCliError(\n        \"Rollback mode does not accept update mutation flags\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return runUpdateManyRollback({ pmRoot, rollbackId, options, global });\n  }\n\n  if (!hasAnyUpdateMutationInput(options.update)) {\n    throw new PmCliError(\n      `No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  // GH-256: validate planned scalar values before listing/checkpointing so\n  // dry-run previews and apply both reject globally-invalid enum/format input.\n  assertPlannedUpdateValuesValid(\n    options.update,\n    settings,\n    statusRegistry,\n    pmRoot,\n  );\n\n  const statusFilter = normalizeStatusFilter(options.status, statusRegistry);\n  const listed = await runList(\n    statusFilter,\n    { ...options.list, includeBody: true },\n    global,\n  );\n  const planned = listed.items.map((item) =>\n    buildPlannedItemDiff(item, options.update, runtimeFieldRegistry),\n  );\n  const actionable = planned.filter((row) => row.changes.length > 0);\n  if (dryRun) {\n    return {\n      mode: \"dry_run\",\n      matched_count: listed.items.length,\n      dry_run: true,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      item_plans: planned,\n      ids: [],\n    };\n  }\n\n  if (actionable.length === 0) {\n    return {\n      mode: \"apply\",\n      matched_count: listed.items.length,\n      dry_run: false,\n      filters: listed.filters,\n      planned_update_options: updateSummary,\n      updated_count: 0,\n      skipped_count: listed.items.length,\n      failed_count: 0,\n      rows: planned.map((row) => ({\n        id: row.id,\n        status: \"skipped\" as const,\n      })),\n      ids: [],\n    };\n  }\n\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(\n    UPDATE_MANY_CHECKPOINT_SUBDIR,\n    nowValue,\n  );\n  const checkpointEnabled = options.checkpoint !== false;\n  const checkpointItems: MutationCheckpointItem[] = listed.items\n    .filter((item) => actionable.some((candidate) => candidate.id === item.id))\n    .map((item) => ({\n      id: item.id,\n      target_updated_at: item.updated_at,\n    }));\n\n  let checkpointInfo: UpdateManyResult[\"checkpoint\"] | undefined;\n  if (checkpointEnabled) {\n    checkpointInfo = await writeUpdateManyCheckpoint({\n      pmRoot,\n      checkpointId,\n      nowValue,\n      options,\n      statusFilter,\n      filters: listed.filters,\n      updateSummary,\n      checkpointItems,\n    });\n  }\n\n  const applyRows: UpdateManyApplyResultRow[] = [];\n  const updatedIds: string[] = [];\n  const updateMessage =\n    options.update.message ?? `update-many apply ${checkpointId}`;\n  const actionableById = new Set(actionable.map((row) => row.id));\n  for (const item of listed.items) {\n    if (!actionableById.has(item.id)) {\n      applyRows.push({ id: item.id, status: \"skipped\" });\n      continue;\n    }\n    try {\n      const result = await runUpdate(\n        item.id,\n        {\n          ...options.update,\n          message: updateMessage,\n          runtimeFieldCommands: [\"update_many\"],\n        },\n        global,\n      );\n      applyRows.push({\n        id: item.id,\n        status: \"updated\",\n        changed_fields: result.changed_fields,\n        warnings: result.warnings,\n      });\n      updatedIds.push(item.id);\n    } catch (error: unknown) {\n      applyRows.push({\n        id: item.id,\n        status: \"failed\",\n        error: toErrorMessage(error),\n      });\n    }\n  }\n\n  const updatedCount = applyRows.filter(\n    (row) => row.status === \"updated\",\n  ).length;\n  const skippedCount = applyRows.filter(\n    (row) => row.status === \"skipped\",\n  ).length;\n  const failedCount = applyRows.filter((row) => row.status === \"failed\").length;\n\n  return {\n    mode: \"apply\",\n    matched_count: listed.items.length,\n    dry_run: false,\n    filters: listed.filters,\n    planned_update_options: updateSummary,\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    updated_count: updatedCount,\n    skipped_count: skippedCount,\n    failed_count: failedCount,\n    rows: applyRows,\n    ids: updatedIds,\n  };\n}\n\n/** Public contract for test only update many command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyUpdateManyCommand = {\n  assertPlannedUpdateValuesValid,\n  buildCollectionMutationPlans,\n  buildPlannedItemDiff,\n  buildTagMutationPlan,\n  collectionValueCount,\n  hasAnyUpdateMutationInput,\n  hasListFilters,\n  normalizeStatusFilter,\n  normalizeCollectionBeforeValue,\n  normalizeExistingTags,\n  normalizeUnsetField,\n  rejectBlankIdsFilter,\n  sanitizeUpdateOptionsForSummary,\n  toComparablePreviewValue,\n};\n"],"names":[],"mappings":"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","debugId":"3989319a-d22e-5fcf-8ba2-e68e13692e87"}

package/dist/cli-bundle/chunks/chunk-Y72FV7RM.js

@@ -0,0 +1,178 @@
+import {
+  acquireLock
+} from "./chunk-T4BRCB6Z.js";
+
+// dist/sdk/context-usage.js
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+!(function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2f1439c6-25a5-526f-a491-d50ee348463f");
+  } catch (e2) {
+  }
+})();
+var DEFAULT_MAX_EVENTS = 2048;
+var DEFAULT_RETENTION_DAYS = 30;
+var DAY_MS = 864e5;
+var DEFAULT_COMPACTION_BYTES = 262144;
+var CONTEXT_USAGE_LOCK_ID = "context-usage-ledger";
+function ledgerPath(pmRoot) {
+  return path.join(pmRoot, "runtime", "context-usage.jsonl");
+}
+function resolveNow(options) {
+  const iso = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const ms = Date.parse(iso);
+  if (!Number.isFinite(ms))
+    throw new TypeError("Context usage now must be a valid timestamp");
+  return { iso: new Date(ms).toISOString(), ms };
+}
+async function readEvents(options) {
+  try {
+    const text = await readFile(ledgerPath(options.pmRoot), "utf8");
+    const events = text.split("\n").filter(Boolean).flatMap((line) => {
+      try {
+        return [JSON.parse(line)];
+      } catch {
+        return [];
+      }
+    });
+    const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;
+    const retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;
+    const cutoff = resolveNow(options).ms - retentionDays * DAY_MS;
+    return events.filter((entry) => Date.parse(entry.at) >= cutoff).slice(-maxEvents);
+  } catch {
+    return [];
+  }
+}
+async function appendEvents(options, events) {
+  const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;
+  const retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;
+  if (!Number.isInteger(maxEvents) || maxEvents < 1 || !Number.isFinite(retentionDays) || retentionDays <= 0) {
+    throw new TypeError("Context usage retention requires positive maxEvents and retentionDays");
+  }
+  const target = ledgerPath(options.pmRoot);
+  const runtimeDirectory = path.dirname(target);
+  const releaseLock = await acquireLock(options.pmRoot, CONTEXT_USAGE_LOCK_ID, 30, `context-usage:${process.pid}`, false, false, 3e3);
+  try {
+    await mkdir(runtimeDirectory, { recursive: true });
+    await appendFile(target, events.map((event) => `${JSON.stringify(event)}
+`).join(""), "utf8");
+    const customBounds = options.maxEvents !== void 0 || options.retentionDays !== void 0;
+    if (!customBounds && (await stat(target)).size <= DEFAULT_COMPACTION_BYTES)
+      return;
+    const retained = await readEvents(options);
+    const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(temporary, `${retained.map((entry) => JSON.stringify(entry)).join("\n")}
+`, "utf8");
+    await rename(temporary, target);
+  } finally {
+    await releaseLock();
+  }
+}
+async function appendEvent(options, event) {
+  await appendEvents(options, [event]);
+}
+async function recordContextUsageServing(options) {
+  if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" || options.enabled === false)
+    return;
+  if (!options.author.trim() || options.rows.some((row) => !row.id.trim() || !Number.isInteger(row.rank) || row.rank < 1)) {
+    throw new TypeError("Context usage serving requires an author and valid ranked rows");
+  }
+  await appendEvent(options, {
+    kind: "serve",
+    at: resolveNow(options).iso,
+    author: options.author.trim(),
+    surface: options.surface,
+    profile: options.profile.trim() || "balanced",
+    rows: options.rows
+  });
+}
+async function recordContextUsageTouch(options) {
+  if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" || options.enabled === false)
+    return;
+  if (!options.author.trim() || !options.itemId.trim() || !options.intent.trim()) {
+    throw new TypeError("Context usage touch requires author, itemId, and intent");
+  }
+  await appendEvent(options, {
+    kind: "touch",
+    at: resolveNow(options).iso,
+    author: options.author.trim(),
+    item_id: options.itemId.trim(),
+    intent: options.intent.trim()
+  });
+}
+async function recordContextUsageTouches(options) {
+  if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" || options.enabled === false || options.itemIds.length === 0)
+    return;
+  const author = options.author.trim();
+  const intent = options.intent.trim();
+  if (!author || !intent) {
+    throw new TypeError("Context usage touch requires author and intent");
+  }
+  const itemIds = /* @__PURE__ */ new Set();
+  for (const itemId of options.itemIds) {
+    if (typeof itemId !== "string") {
+      throw new TypeError("Context usage touch requires string itemIds");
+    }
+    const trimmedId = itemId.trim();
+    if (!trimmedId)
+      throw new TypeError("Context usage touch requires non-empty itemId");
+    itemIds.add(trimmedId);
+  }
+  const at = resolveNow(options).iso;
+  const events = [...itemIds].map((itemId) => ({ kind: "touch", at, author, item_id: itemId, intent }));
+  await appendEvents(options, events);
+}
+function findTouchTimeInHorizon(touches, itemId, servedAt, horizonMs) {
+  return touches.find(({ entry, time }) => entry.item_id === itemId && time >= servedAt && time - servedAt <= horizonMs)?.time;
+}
+async function readContextUsageAffinity(options) {
+  if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" || options.enabled === false)
+    return { affinity: {}, positive_judgments: 0, serving_events: 0 };
+  const events = await readEvents(options);
+  const now = resolveNow(options).ms;
+  const horizonMs = (options.horizonHours ?? 24) * 36e5;
+  if (!Number.isFinite(horizonMs) || horizonMs <= 0)
+    throw new TypeError("Context usage horizonHours must be positive");
+  const author = options.author.trim();
+  const touches = events.filter((event) => event.kind === "touch" && event.author === author).map((entry) => ({ entry, time: Date.parse(entry.at) }));
+  const scores = /* @__PURE__ */ new Map();
+  let servingEvents = 0;
+  let positiveJudgments = 0;
+  for (const event of events) {
+    if (event.kind !== "serve" || event.author !== author)
+      continue;
+    servingEvents += 1;
+    const servedAt = Date.parse(event.at);
+    for (const row of event.rows) {
+      if (!row.included)
+        continue;
+      const touchTime = findTouchTimeInHorizon(touches, row.id, servedAt, horizonMs);
+      if (touchTime === void 0)
+        continue;
+      positiveJudgments += 1;
+      const ageDays = Math.max(0, (now - touchTime) / DAY_MS);
+      scores.set(row.id, (scores.get(row.id) ?? 0) + Math.exp(-ageDays / 14));
+    }
+  }
+  const maximum = Math.max(0, ...scores.values());
+  const affinity = Object.fromEntries([...scores.entries()].map(([id, score]) => [
+    id,
+    0.05 + 0.95 * (maximum > 0 ? score / maximum : 0)
+  ]));
+  return {
+    affinity,
+    positive_judgments: positiveJudgments,
+    serving_events: servingEvents
+  };
+}
+
+export {
+  recordContextUsageServing,
+  recordContextUsageTouch,
+  recordContextUsageTouches,
+  readContextUsageAffinity
+};
+//# sourceMappingURL=chunk-Y72FV7RM.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../sdk/context-usage.ts"],
+  "sourcesContent": ["/**\n * @module sdk/context-usage\n *\n * Privacy-minimal, derived context-usage feedback primitives. The JSONL ledger\n * contains only item ids, timestamps, authors, ranks, profiles, and command\n * intents; it never enters item history and is safe to delete or rebuild.\n */\nimport { randomUUID } from \"node:crypto\";\nimport {\n  appendFile,\n  mkdir,\n  readFile,\n  rename,\n  stat,\n  writeFile,\n} from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { acquireLock } from \"../core/lock/lock.js\";\nimport type { ContextRelevanceSurface } from \"./context-relevance.js\";\n\n/** One propensity row disclosed when context or next serves a candidate. */\nexport interface ContextUsageServingRow {\n  /** Served item identifier. */\n  id: string;\n  /** One-based scorer rank. */\n  rank: number;\n  /** Whether the packer included the item. */\n  included: boolean;\n}\n\n/** Append-only serving or subsequent-touch event. */\nexport type ContextUsageEvent =\n  | {\n      kind: \"serve\";\n      at: string;\n      author: string;\n      surface: ContextRelevanceSurface;\n      profile: string;\n      rows: ContextUsageServingRow[];\n    }\n  | {\n      kind: \"touch\";\n      at: string;\n      author: string;\n      item_id: string;\n      intent: string;\n    };\n\n/** Runtime controls for the bounded derived ledger. */\nexport interface ContextUsageLedgerOptions {\n  /** Tracker root containing the runtime directory. */\n  pmRoot: string;\n  /** Disable all reads and writes with zero filesystem work. */\n  enabled?: boolean;\n  /** Maximum retained event rows. */\n  maxEvents?: number;\n  /** Retention horizon in days. */\n  retentionDays?: number;\n  /** Deterministic timestamp override. */\n  now?: string;\n}\n\n/** Decayed per-item affinity derived for one author. */\nexport interface ContextUsageAffinity {\n  /** Normalized affinity by item id. */\n  affinity: Record<string, number>;\n  /** Number of eligible served-then-touched judgments. */\n  positive_judgments: number;\n  /** Number of retained serving events inspected. */\n  serving_events: number;\n}\n\nconst DEFAULT_MAX_EVENTS = 2_048;\nconst DEFAULT_RETENTION_DAYS = 30;\nconst DAY_MS = 86_400_000;\nconst DEFAULT_COMPACTION_BYTES = 262_144;\nconst CONTEXT_USAGE_LOCK_ID = \"context-usage-ledger\";\n\nfunction ledgerPath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", \"context-usage.jsonl\");\n}\n\nfunction resolveNow(options: ContextUsageLedgerOptions): {\n  iso: string;\n  ms: number;\n} {\n  const iso = options.now ?? new Date().toISOString();\n  const ms = Date.parse(iso);\n  if (!Number.isFinite(ms))\n    throw new TypeError(\"Context usage now must be a valid timestamp\");\n  return { iso: new Date(ms).toISOString(), ms };\n}\n\nasync function readEvents(\n  options: ContextUsageLedgerOptions,\n): Promise<ContextUsageEvent[]> {\n  try {\n    const text = await readFile(ledgerPath(options.pmRoot), \"utf8\");\n    const events = text\n      .split(\"\\n\")\n      .filter(Boolean)\n      .flatMap((line) => {\n        try {\n          return [JSON.parse(line) as ContextUsageEvent];\n        } catch {\n          return [];\n        }\n      });\n    const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;\n    const retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;\n    const cutoff = resolveNow(options).ms - retentionDays * DAY_MS;\n    return events\n      .filter((entry) => Date.parse(entry.at) >= cutoff)\n      .slice(-maxEvents);\n  } catch {\n    return [];\n  }\n}\n\nasync function appendEvents(\n  options: ContextUsageLedgerOptions,\n  events: readonly ContextUsageEvent[],\n): Promise<void> {\n  const maxEvents = options.maxEvents ?? DEFAULT_MAX_EVENTS;\n  const retentionDays = options.retentionDays ?? DEFAULT_RETENTION_DAYS;\n  if (\n    !Number.isInteger(maxEvents) ||\n    maxEvents < 1 ||\n    !Number.isFinite(retentionDays) ||\n    retentionDays <= 0\n  ) {\n    throw new TypeError(\n      \"Context usage retention requires positive maxEvents and retentionDays\",\n    );\n  }\n  const target = ledgerPath(options.pmRoot);\n  const runtimeDirectory = path.dirname(target);\n  const releaseLock = await acquireLock(\n    options.pmRoot,\n    CONTEXT_USAGE_LOCK_ID,\n    30,\n    `context-usage:${process.pid}`,\n    false,\n    false,\n    3_000,\n  );\n  try {\n    await mkdir(runtimeDirectory, { recursive: true });\n    await appendFile(target, events.map((event) => `${JSON.stringify(event)}\\n`).join(\"\"), \"utf8\");\n    const customBounds =\n      options.maxEvents !== undefined || options.retentionDays !== undefined;\n    if (!customBounds && (await stat(target)).size <= DEFAULT_COMPACTION_BYTES)\n      return;\n    const retained = await readEvents(options);\n    const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;\n    await writeFile(\n      temporary,\n      `${retained.map((entry) => JSON.stringify(entry)).join(\"\\n\")}\\n`,\n      \"utf8\",\n    );\n    await rename(temporary, target);\n  } finally {\n    await releaseLock();\n  }\n}\n\nasync function appendEvent(\n  options: ContextUsageLedgerOptions,\n  event: ContextUsageEvent,\n): Promise<void> {\n  await appendEvents(options, [event]);\n}\n\n/** Records a propensity-complete context/next serving event. */\nexport async function recordContextUsageServing(\n  options: ContextUsageLedgerOptions & {\n    author: string;\n    surface: ContextRelevanceSurface;\n    profile: string;\n    rows: ContextUsageServingRow[];\n  },\n): Promise<void> {\n  if (process.env.PM_CONTEXT_USAGE_DISABLED === \"1\" || options.enabled === false) return;\n  if (\n    !options.author.trim() ||\n    options.rows.some(\n      (row) => !row.id.trim() || !Number.isInteger(row.rank) || row.rank < 1,\n    )\n  ) {\n    throw new TypeError(\n      \"Context usage serving requires an author and valid ranked rows\",\n    );\n  }\n  await appendEvent(options, {\n    kind: \"serve\",\n    at: resolveNow(options).iso,\n    author: options.author.trim(),\n    surface: options.surface,\n    profile: options.profile.trim() || \"balanced\",\n    rows: options.rows,\n  });\n}\n\n/** Records one subsequent item read or mutation outcome. */\nexport async function recordContextUsageTouch(\n  options: ContextUsageLedgerOptions & {\n    author: string;\n    itemId: string;\n    intent: string;\n  },\n): Promise<void> {\n  if (process.env.PM_CONTEXT_USAGE_DISABLED === \"1\" || options.enabled === false) return;\n  if (\n    !options.author.trim() ||\n    !options.itemId.trim() ||\n    !options.intent.trim()\n  ) {\n    throw new TypeError(\n      \"Context usage touch requires author, itemId, and intent\",\n    );\n  }\n  await appendEvent(options, {\n    kind: \"touch\",\n    at: resolveNow(options).iso,\n    author: options.author.trim(),\n    item_id: options.itemId.trim(),\n    intent: options.intent.trim(),\n  });\n}\n\n/**\n * Records mutation outcomes as one append and one optional compaction pass.\n */\nexport async function recordContextUsageTouches(\n  options: ContextUsageLedgerOptions & {\n    /** Stable caller identity used to isolate affinity. */\n    author: string;\n    /** Item identifiers affected by the completed command. */\n    itemIds: readonly string[];\n    /** Command or workflow intent associated with the touches. */\n    intent: string;\n  },\n): Promise<void> {\n  if (process.env.PM_CONTEXT_USAGE_DISABLED === \"1\" || options.enabled === false || options.itemIds.length === 0) return;\n  const author = options.author.trim();\n  const intent = options.intent.trim();\n  if (!author || !intent) {\n    throw new TypeError(\"Context usage touch requires author and intent\");\n  }\n  const itemIds = new Set<string>();\n  for (const itemId of options.itemIds) {\n    if (typeof itemId !== \"string\") {\n      throw new TypeError(\"Context usage touch requires string itemIds\");\n    }\n    const trimmedId = itemId.trim();\n    if (!trimmedId) throw new TypeError(\"Context usage touch requires non-empty itemId\");\n    itemIds.add(trimmedId);\n  }\n  const at = resolveNow(options).iso;\n  const events = [...itemIds].map(\n    (itemId): ContextUsageEvent => ({ kind: \"touch\", at, author, item_id: itemId, intent }),\n  );\n  await appendEvents(options, events);\n}\n\nfunction findTouchTimeInHorizon(\n  touches: readonly { entry: Extract<ContextUsageEvent, { kind: \"touch\" }>; time: number }[],\n  itemId: string,\n  servedAt: number,\n  horizonMs: number,\n): number | undefined {\n  return touches.find(({ entry, time }) =>\n    entry.item_id === itemId && time >= servedAt && time - servedAt <= horizonMs\n  )?.time;\n}\n\n/**\n * Derives decayed served-then-touched affinity. A small exploration floor keeps\n * ignored and unseen items eligible, preventing a popularity feedback lock-in.\n */\nexport async function readContextUsageAffinity(\n  options: ContextUsageLedgerOptions & {\n    author: string;\n    horizonHours?: number;\n  },\n): Promise<ContextUsageAffinity> {\n  if (process.env.PM_CONTEXT_USAGE_DISABLED === \"1\" || options.enabled === false)\n    return { affinity: {}, positive_judgments: 0, serving_events: 0 };\n  const events = await readEvents(options);\n  const now = resolveNow(options).ms;\n  const horizonMs = (options.horizonHours ?? 24) * 3_600_000;\n  if (!Number.isFinite(horizonMs) || horizonMs <= 0)\n    throw new TypeError(\"Context usage horizonHours must be positive\");\n  const author = options.author.trim();\n  const touches = events\n    .filter(\n      (event): event is Extract<ContextUsageEvent, { kind: \"touch\" }> =>\n        event.kind === \"touch\" && event.author === author,\n    )\n    .map((entry) => ({ entry, time: Date.parse(entry.at) }));\n  const scores = new Map<string, number>();\n  let servingEvents = 0;\n  let positiveJudgments = 0;\n  for (const event of events) {\n    if (event.kind !== \"serve\" || event.author !== author) continue;\n    servingEvents += 1;\n    const servedAt = Date.parse(event.at);\n    for (const row of event.rows) {\n      if (!row.included) continue;\n      const touchTime = findTouchTimeInHorizon(touches, row.id, servedAt, horizonMs);\n      if (touchTime === undefined) continue;\n      positiveJudgments += 1;\n      const ageDays = Math.max(0, (now - touchTime) / DAY_MS);\n      scores.set(row.id, (scores.get(row.id) ?? 0) + Math.exp(-ageDays / 14));\n    }\n  }\n  const maximum = Math.max(0, ...scores.values());\n  const affinity = Object.fromEntries(\n    [...scores.entries()].map(([id, score]) => [\n      id,\n      0.05 + 0.95 * (maximum > 0 ? score / maximum : 0),\n    ]),\n  );\n  return {\n    affinity,\n    positive_judgments: positiveJudgments,\n    serving_events: servingEvents,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli-bundle/chunks/{chunk-OWW2KXOV.js → chunk-YQYG2V23.js}

@@ -1,7 +1,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-XY3CC3EM.js";
+} from "./chunk-AFWZRL7M.js";
 
 // dist/core/shared/numeric-parsers.js
 !(function() {
@@ -24,4 +24,4 @@ function parseLimit(raw, label = "--limit") {
 export {
   parseLimit
 };
-//# sourceMappingURL=chunk-OWW2KXOV.js.map
+//# sourceMappingURL=chunk-YQYG2V23.js.map