@unbrained/pm-cli 2026.7.6 → 2026.7.8

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 2026.7.8 - 2026-07-08
+
+### Added
+
+- GH-467: isolated package/extension diagnostics — project-scoped doctor and smoke tests without global pm state leaking in ([pm-6abs](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-6abs.toon))
+- GH-474: pm search --limit support in hybrid mode ([pm-alnj](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-alnj.toon))
+
+### Fixed
+
+- Triage: close GH-455 with shipped evidence once the Ollama embedding auto-default fix releases ([pm-hq0r](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-hq0r.toon))
+
+### Other
+
+- Expose package lifecycle primitives through public SDK helpers ([pm-kffw](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-kffw.toon))
+- Expose sentry telemetry gate as package script alias ([pm-w86l](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-w86l.toon))
+- ADR: 2026-06-07 deep review + remediation pass (never-block, MCP/version coherence, docs/CI hardening) ([pm-96wm](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-96wm.toon))
+- GH-476: pm context rejects --max-items with an untargeted unknown_option (alias or recovery hint) ([pm-5h9g](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-5h9g.toon))
+
+## 2026.7.7 - 2026-07-07
+
+### Added
+
+- Promote item lifecycle primitives to the public SDK: create, update, close, claim/release, copy, delete, restore, focus ([pm-98cz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-98cz.toon))
+- Promote query/read primitives to the public SDK: list, get, search, context, next, aggregate, stats ([pm-rjqr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-rjqr.toon))
+
+### Fixed
+
+- SDK client.run() rejects structured payloads for create: raw {type,title} fails with 'Missing required option --title' ([pm-395t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-395t.toon))
+- GH-427: Windows Node 24 nightly fails — POSIX-only error-code assertions (EACCES/EISDIR) in restore-command and history-rewrite specs ([pm-lt6n](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-lt6n.toon))
+- Annotation --add silently stores flag-like tokens as content: pm notes <id\> --add --stdin records the literal note "--stdin" ([pm-vcu7](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-vcu7.toon))
+- pm extension --install pm-<alias\> / @unbrained/pm-<alias\> fails with 'Local extension source does not exist' instead of suggesting the bundled catalog alias ([pm-jqd2](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jqd2.toon))
+- pm plan create silently ignores the root --id-only flag (prints full plan envelope) ([pm-oz0k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-oz0k.toon))
+- Bare extension command group (pm changelog / pm graph) exits 0 with zero output instead of rendering group help ([pm-1k57](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-1k57.toon))
+- GH-463: linked PM tracker-read tests should auto-remediate or suggest --auto-pm-context ([pm-6e1d](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-6e1d.toon))
+- Relative lancedb vector-store path resolves against process cwd, creating nested .agents/pm/.agents/pm stores ([pm-og1v](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-og1v.toon))
+- GH-455: pm health auto-selects an uninstalled Ollama embedding model then fails vector refresh ([pm-aems](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-aems.toon))
+
+### Other
+
+- GH-458: claim/start-task reject --assignee with an untargeted recovery hint (alias or better hint) ([pm-qfte](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-qfte.toon))
+- GH-468: clarify or publish the pm SDK npm package coordinates (@unbrained/pm-sdk is 404) ([pm-25d0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-25d0.toon))
+- 2026-07-07 ecosystem audit \#16: all-status review, long-horizon gap items (merge semantics, event stream, policy roles, flow metrics) ([pm-su60](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-su60.toon))
+- 2026-07-06 ecosystem audit \#15: WIP hygiene, GH/commit coverage verification, grammar+SDK domain completions, horizon-4 planning ([pm-pvij](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-pvij.toon))
+- chore: 2026-07-06 ecosystem audit \#14 — WIP status hygiene (docstring family reset) + stale in-progress detection backlog ([pm-6a1g](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-6a1g.toon))
+- chore: 2026-07-06 ecosystem audit \#13 — Semgrep-issue metadata backfill, scale-out initiative pm-9rxu, composability contract set ([pm-lgim](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-lgim.toon))
+- 2026-07-06 ecosystem audit \#12: GH-467..474 backlog coverage + code-scanning capability epic ([pm-3rgp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-3rgp.toon))
+- Unblock dependabot PRs: @types/node 26 type error, pnpm release-age cooldown, codeql-action lockstep group ([pm-2czc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-2czc.toon))
+- pm install should accept multiple package targets (help already advertises \[targets...\]) ([pm-hj9h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-hj9h.toon))
+- Triage: close stale dogfood reports GH-436 (pm next/focus) and GH-440 (context --fields) with shipped evidence ([pm-7cx8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-7cx8.toon))
+
 ## 2026.7.6 - 2026-07-06
 
 ### Added

package/dist/cli/commands/annotation-command.d.ts

@@ -16,6 +16,7 @@ interface AnnotationCommandOptions {
 interface AnnotationInput {
     mode: "list" | "add" | "stdin" | "file" | "edit" | "delete";
     value?: string;
+    rawValue?: string;
     emptyFlag?: string;
     index?: number;
 }

package/dist/cli/commands/annotation-command.js

@@ -4,7 +4,7 @@
  * Implements the pm annotation command command surface and its agent-facing runtime behavior.
  */
 
-!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]="e64198f6-7323-5f3c-b336-dde5cf28a5fa")}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]="5fd7e12e-f272-574b-8e22-e4d6d077b280")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
@@ -81,6 +81,31 @@ export function wrapOwnershipConflict(error, guidance) {
     }
     throw error;
 }
+function annotationStdinHint(collectionKey) {
+    return collectionKey === "comments" ? "--stdin" : "--add -";
+}
+function assertAnnotationAddValueIsNotFlagLike(raw, config) {
+    const emptyFlag = config.input.emptyFlag ?? "--add";
+    if (emptyFlag !== "--add") {
+        return;
+    }
+    const trimmed = raw.trim();
+    if (!/^-{1,2}[A-Za-z][\w-]*(?:=.*)?$/.test(trimmed)) {
+        return;
+    }
+    const stdinHint = annotationStdinHint(config.collectionKey);
+    const commandPrefix = config.input.mode === "edit"
+        ? `pm ${config.collectionKey} <id> --edit <index>`
+        : `pm ${config.collectionKey} <id>`;
+    throw new PmCliError(`--add value "${trimmed}" looks like an option, not annotation text. Use ${stdinHint} to read stdin, or use text=${trimmed} for literal dash-leading text.`, EXIT_CODE.USAGE, {
+        code: "annotation_flag_like_value",
+        required: `Use ${stdinHint} for stdin input, pass plain text, or use text=${trimmed} when the text really starts with "-".`,
+        examples: [
+            `${commandPrefix} ${stdinHint}`,
+            `${commandPrefix} --add text=${trimmed}`,
+        ],
+    });
+}
 /**
  * Implements run annotation command for the public runtime surface of this module.
  */
@@ -130,6 +155,8 @@ export async function runAnnotationCommand(id, options, global, config) {
         const allEntries = readAnnotationEntries(result.item, config.collectionKey);
         return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);
     }
+    const rawText = config.input.rawValue ?? config.input.value ?? "";
+    assertAnnotationAddValueIsNotFlagLike(rawText, config);
     const text = config.parseText(config.input.value ?? "");
     if (!text.trim()) {
         throw new PmCliError(`${config.input.emptyFlag ?? "--add"} text cannot be empty`, EXIT_CODE.USAGE);
@@ -225,4 +252,4 @@ function renderAnnotationResult(id, collectionKey, allEntries, limit, includeMet
     };
 }
 //# sourceMappingURL=annotation-command.js.map
-//# debugId=e64198f6-7323-5f3c-b336-dde5cf28a5fa
+//# debugId=5fd7e12e-f272-574b-8e22-e4d6d077b280

package/dist/cli/commands/annotation-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"annotation-command.js","sources":["cli/commands/annotation-command.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/annotation-command\n *\n * Implements the pm annotation command command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { 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 { nowIso } from \"../../core/shared/time.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\n\ninterface AnnotationEntry {\n  created_at: string;\n  author: string;\n  text: string;\n  edited_at?: string;\n}\n\ninterface AnnotationCommandOptions {\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  includeMeta?: boolean;\n}\n\ninterface AnnotationInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\ninterface OwnershipConflictGuidance {\n  required: string;\n  examples: string[];\n  nextSteps: string[];\n}\n\ninterface AnnotationCommandConfig<TKey extends string> {\n  input: AnnotationInput;\n  collectionKey: TKey;\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  editOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  deleteOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  parseText: (raw: string) => string;\n  allowAuditBypass: boolean;\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\ntype AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = {\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/**\n * Implements limit annotation entries for the public runtime surface of this module.\n */\nexport function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): 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/**\n * Implements read annotation entries for the public runtime surface of this module.\n */\nexport function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\n/**\n * Implements parse annotation text input for the public runtime surface of this module.\n */\nexport function parseAnnotationTextInput(raw: string, options: { stripPlainTextPrefix?: boolean } = {}): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (options.stripPlainTextPrefix === true && textPrefixMatch && !trimmed.startsWith(\"```\")) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured = /^(?:[-*+]\\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/**\n * Implements wrap ownership conflict for the public runtime surface of this module.\n */\nexport function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): 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\n/**\n * Implements run annotation command for the public runtime surface of this module.\n */\nexport async function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\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>(loaded.document.metadata, config.collectionKey);\n    return renderAnnotationResult(located.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\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.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\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>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n  }\n\n  const text = config.parseText(config.input.value ?? \"\");\n  if (!text.trim()) {\n    throw new PmCliError(`${config.input.emptyFlag ?? \"--add\"} text cannot be empty`, EXIT_CODE.USAGE);\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.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\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>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\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.allowAuditBypass,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\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>(result.item, config.collectionKey);\n  return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n}\n\n/**\n * Implements resolve annotation index for the public runtime surface of this module.\n */\nexport function resolveAnnotationIndex(\n  oneBasedIndex: number | undefined,\n  count: number,\n  collectionKey: string,\n): number {\n  if (oneBasedIndex === undefined || !Number.isInteger(oneBasedIndex) || oneBasedIndex < 1 || oneBasedIndex > count) {\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<TKey extends string, TEntry extends AnnotationEntry>(\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":[],"mappings":"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","debugId":"e64198f6-7323-5f3c-b336-dde5cf28a5fa"}
+{"version":3,"file":"annotation-command.js","sources":["cli/commands/annotation-command.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/annotation-command\n *\n * Implements the pm annotation command command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { 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 { nowIso } from \"../../core/shared/time.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { parseLimit } from \"../shared-parsers.js\";\n\ninterface AnnotationEntry {\n  created_at: string;\n  author: string;\n  text: string;\n  edited_at?: string;\n}\n\ninterface AnnotationCommandOptions {\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  includeMeta?: boolean;\n}\n\ninterface AnnotationInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  rawValue?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\ninterface OwnershipConflictGuidance {\n  required: string;\n  examples: string[];\n  nextSteps: string[];\n}\n\ninterface AnnotationCommandConfig<TKey extends string> {\n  input: AnnotationInput;\n  collectionKey: TKey;\n  op: Parameters<typeof mutateItem>[0][\"op\"];\n  editOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  deleteOp?: Parameters<typeof mutateItem>[0][\"op\"];\n  parseText: (raw: string) => string;\n  allowAuditBypass: boolean;\n  conflictGuidance: OwnershipConflictGuidance;\n}\n\ntype AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = {\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/**\n * Implements limit annotation entries for the public runtime surface of this module.\n */\nexport function limitAnnotationEntries<TEntry>(values: TEntry[], limit: number | undefined): 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/**\n * Implements read annotation entries for the public runtime surface of this module.\n */\nexport function readAnnotationEntries<TEntry>(source: Record<string, unknown>, collectionKey: string): TEntry[] {\n  const value = source[collectionKey];\n  return Array.isArray(value) ? (value as TEntry[]) : [];\n}\n\n/**\n * Implements parse annotation text input for the public runtime surface of this module.\n */\nexport function parseAnnotationTextInput(raw: string, options: { stripPlainTextPrefix?: boolean } = {}): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\n  }\n  const textPrefixMatch = /^(?:[-*+]\\s*)?text\\s*[:=]/i.exec(trimmed);\n  if (options.stripPlainTextPrefix === true && textPrefixMatch && !trimmed.startsWith(\"```\")) {\n    const text = trimmed.slice(textPrefixMatch[0].length).trim();\n    return text || trimmed;\n  }\n  const looksStructured = /^(?:[-*+]\\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/**\n * Implements wrap ownership conflict for the public runtime surface of this module.\n */\nexport function wrapOwnershipConflict(error: unknown, guidance: OwnershipConflictGuidance): 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(raw: string, config: AnnotationCommandConfig<string>): 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 * Implements run annotation command for the public runtime surface of this module.\n */\nexport async function runAnnotationCommand<TKey extends string, TEntry extends AnnotationEntry>(\n  id: string,\n  options: AnnotationCommandOptions,\n  global: GlobalOptions,\n  config: AnnotationCommandConfig<TKey>,\n): Promise<AnnotationCommandResult<TKey, TEntry>> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const limit = parseLimit(options.limit);\n\n  if (config.input.mode === \"list\") {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\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>(loaded.document.metadata, config.collectionKey);\n    return renderAnnotationResult(located.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\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.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\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>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\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(`${config.input.emptyFlag ?? \"--add\"} text cannot be empty`, EXIT_CODE.USAGE);\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.allowAuditBypass,\n        mutate(document) {\n          const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\n          const arrayIndex = resolveAnnotationIndex(config.input.index, entries.length, config.collectionKey);\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>(result.item, config.collectionKey);\n    return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\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.allowAuditBypass,\n      mutate(document) {\n        const entries = readAnnotationEntries<TEntry>(document.metadata, config.collectionKey);\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>(result.item, config.collectionKey);\n  return renderAnnotationResult(result.item.id, config.collectionKey, allEntries, limit, options.includeMeta === true);\n}\n\n/**\n * Implements resolve annotation index for the public runtime surface of this module.\n */\nexport function resolveAnnotationIndex(\n  oneBasedIndex: number | undefined,\n  count: number,\n  collectionKey: string,\n): number {\n  if (oneBasedIndex === undefined || !Number.isInteger(oneBasedIndex) || oneBasedIndex < 1 || oneBasedIndex > count) {\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<TKey extends string, TEntry extends AnnotationEntry>(\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":[],"mappings":"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","debugId":"5fd7e12e-f272-574b-8e22-e4d6d077b280"}

package/dist/cli/commands/comments.js

@@ -4,7 +4,7 @@
  * Implements the pm comments command surface and its agent-facing runtime behavior.
  */
 
-!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]="6a6f6522-973f-5abd-a34d-7770ef5a367b")}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]="76f33725-4d43-5197-98c4-d7c8431df92b")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -89,12 +89,11 @@ export async function runComments(id, options, global) {
     const stdinResolver = createStdinTokenResolver();
     const commentInput = await resolveCommentInput(options, stdinResolver);
     const shouldParseText = commentInput.mode === "add" || commentInput.mode === "edit";
-    // list/delete carry no text (value undefined → ""); add/edit/stdin/file always
-    // resolve to a string. Normalize once so neither branch below is unreachable.
     const rawValue = commentInput.value ?? "";
     return runAnnotationCommand(id, options, global, {
         input: {
             ...commentInput,
+            rawValue: options.add ?? rawValue,
             value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,
         },
         collectionKey: "comments",
@@ -114,4 +113,4 @@ export async function runComments(id, options, global) {
     });
 }
 //# sourceMappingURL=comments.js.map
-//# debugId=6a6f6522-973f-5abd-a34d-7770ef5a367b
+//# debugId=76f33725-4d43-5197-98c4-d7c8431df92b

package/dist/cli/commands/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sources":["cli/commands/comments.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  // list/delete carry no text (value undefined → \"\"); add/edit/stdin/file always\n  // resolve to a string. Normalize once so neither branch below is unreachable.\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":[],"mappings":"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","debugId":"6a6f6522-973f-5abd-a34d-7770ef5a367b"}
+{"version":3,"file":"comments.js","sources":["cli/commands/comments.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/comments\n *\n * Implements the pm comments command surface and its agent-facing runtime behavior.\n */\nimport { readFile } from \"node:fs/promises\";\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 { createStdinTokenResolver } from \"../../core/item/parse.js\";\nimport type { Comment } from \"../../types/index.js\";\nimport { parseAnnotationTextInput, runAnnotationCommand } from \"./annotation-command.js\";\n\n/**\n * Documents the comments command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  edit?: number;\n  delete?: number;\n  limit?: string;\n  includeMeta?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\n/**\n * Documents the comments result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n  total_count?: number;\n  returned_count?: number;\n  has_more?: boolean;\n  limit?: number;\n}\n\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\" | \"edit\" | \"delete\";\n  value?: string;\n  emptyFlag?: string;\n  index?: number;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentTextSource(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<{ value: string; emptyFlag: string } | undefined> {\n  const hasAdd = options.add !== undefined;\n  const hasStdin = options.stdin === true;\n  const hasFile = typeof options.file === \"string\";\n  const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);\n  if (sourceCount === 0) {\n    return undefined;\n  }\n  if (sourceCount > 1) {\n    throw new PmCliError(\"Specify comment text using only one input source: --add, --stdin, or --file\", EXIT_CODE.USAGE);\n  }\n  if (hasAdd) {\n    const addInput = await stdinResolver.resolveValue(options.add, \"--add\");\n    return { value: addInput ?? \"\", emptyFlag: \"--add\" };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return { value: stdinInput ?? \"\", emptyFlag: \"--stdin\" };\n  }\n  const filePath = (options.file as string).trim();\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return { value: fileInput, emptyFlag: \"--file\" };\n  } catch (error: unknown) {\n    if (isErrnoError(error) && error.code === \"ENOENT\") {\n      throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);\n    }\n    const detail = error instanceof Error ? error.message : String(error);\n    throw new PmCliError(`Failed to read --file path \"${filePath}\": ${detail}`, EXIT_CODE.USAGE);\n  }\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\n  const hasEdit = options.edit !== undefined;\n  const hasDelete = options.delete !== undefined;\n  if (hasEdit && hasDelete) {\n    throw new PmCliError(\"Specify only one of --edit or --delete\", EXIT_CODE.USAGE);\n  }\n\n  if (hasDelete) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource !== undefined) {\n      throw new PmCliError(\"--delete does not take comment text\", EXIT_CODE.USAGE);\n    }\n    return { mode: \"delete\", index: options.delete };\n  }\n\n  if (hasEdit) {\n    const textSource = await resolveCommentTextSource(options, stdinResolver);\n    if (textSource === undefined) {\n      throw new PmCliError(\n        \"--edit requires replacement text via positional [text], --add, --stdin, or --file\",\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      mode: \"edit\",\n      index: options.edit,\n      value: textSource.value,\n      emptyFlag: textSource.emptyFlag,\n    };\n  }\n\n  const textSource = await resolveCommentTextSource(options, stdinResolver);\n  if (textSource === undefined) {\n    return { mode: \"list\" };\n  }\n  // Map the single resolved input source back to its add/stdin/file mode so the\n  // caller still knows whether to run plain-text markdown parsing (add-only).\n  const mode = textSource.emptyFlag === \"--add\" ? \"add\" : textSource.emptyFlag === \"--stdin\" ? \"stdin\" : \"file\";\n  return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };\n}\n\n/**\n * Implements run comments for the public runtime surface of this module.\n */\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\n  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  const shouldParseText = commentInput.mode === \"add\" || commentInput.mode === \"edit\";\n  const rawValue = commentInput.value ?? \"\";\n  return runAnnotationCommand<\"comments\", Comment>(id, options, global, {\n    input: {\n      ...commentInput,\n      rawValue: options.add ?? rawValue,\n      value: shouldParseText ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true }) : rawValue,\n    },\n    collectionKey: \"comments\",\n    op: \"comment_add\",\n    editOp: \"comment_edit\",\n    deleteOp: \"comment_delete\",\n    parseText: (raw) => raw,\n    allowAuditBypass: Boolean(options.allowAuditComment),\n    conflictGuidance: {\n      required:\n        \"For append-only comment audits on another owner's item, prefer --allow-audit-comment before considering --force.\",\n      examples: ['pm comments pm-a1b2 --add \"audit note\" --author \"reviewer\" --allow-audit-comment'],\n      nextSteps: [\n        \"Retry with --allow-audit-comment for append-only audits that do not mutate item metadata beyond comments.\",\n        \"Use --force only when an ownership override is explicitly approved.\",\n      ],\n    },\n  });\n}\n"],"names":[],"mappings":"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","debugId":"76f33725-4d43-5197-98c4-d7c8431df92b"}

package/dist/cli/commands/completion.js

@@ -4,7 +4,7 @@
  * Implements the pm completion command surface and its agent-facing runtime behavior.
  */
 
-!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]="c5c33ca2-acd6-55cc-8bf9-de815086e990")}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]="6aac8389-5103-50a6-98bd-fde0720289ba")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { SCAFFOLD_CAPABILITIES } from "./extension/scaffold.js";
@@ -1536,6 +1536,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--trace[Include registration traces in doctor deep diagnostics]' \\
             '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
             '--fix-managed-state[Adopt unmanaged extensions before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope extensions only]' \\
+            '--ignore-global[Alias for --isolated]' \\
             '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
             '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
             '--json[Output JSON]' \\
@@ -1574,6 +1576,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--trace[Include registration traces in doctor deep diagnostics]' \\
             '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
             '--fix-managed-state[Adopt unmanaged packages before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope packages only]' \\
+            '--ignore-global[Alias for --isolated]' \\
             '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
             '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
             '--json[Output JSON]' \\
@@ -2475,6 +2479,8 @@ complete -c pm -n '__fish_seen_subcommand_from extension' -l detail -d 'Detail m
 complete -c pm -n '__fish_seen_subcommand_from extension' -l trace -d 'Include registration traces in doctor deep diagnostics'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l fix-managed-state -d 'Adopt unmanaged extensions before diagnostics/update checks'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l isolated -d 'Run doctor against project-scope extensions only'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l ignore-global -d 'Alias for --isolated'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
 
@@ -2510,6 +2516,8 @@ for package_cmd in package packages
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l trace -d 'Include registration traces in doctor deep diagnostics'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fix-managed-state -d 'Adopt unmanaged packages before diagnostics/update checks'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l isolated -d 'Run doctor against project-scope packages only'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ignore-global -d 'Alias for --isolated'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
 end`;
@@ -2545,4 +2553,4 @@ export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansio
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=c5c33ca2-acd6-55cc-8bf9-de815086e990
+//# debugId=6aac8389-5103-50a6-98bd-fde0720289ba