@unbrained/pm-cli 2026.5.12 → 2026.5.18

package/dist/cli/commands/claim.d.ts

@@ -4,6 +4,8 @@ export interface ClaimResult {
     claimed_by: string;
     previous_assignee: string | null;
     forced: boolean;
+    skipped?: boolean;
+    warnings?: string[];
 }
 export interface ReleaseResult {
     item: Record<string, unknown>;
@@ -15,6 +17,7 @@ export interface ReleaseResult {
 export interface ClaimMutationOptions {
     author?: string;
     message?: string;
+    ifAvailable?: boolean;
 }
 export interface ReleaseMutationOptions extends ClaimMutationOptions {
     allowAuditRelease?: boolean;

package/dist/cli/commands/claim.js

@@ -1,3 +1,5 @@
+
+!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]="41409d93-c5da-5b53-86d0-3fd2339f6965")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { resolveRuntimeStatusRegistry, statusIsTerminal } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -19,6 +21,8 @@ export async function runClaim(id, force, global, options = {}) {
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const author = resolveAuthor(options.author, settings.author_default);
     let previousAssignee = null;
+    let skipped = false;
+    const mutationWarnings = [];
     const result = await mutateItem({
         pmRoot,
         settings,
@@ -32,15 +36,26 @@ export async function runClaim(id, force, global, options = {}) {
             if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {
                 throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);
             }
+            const heldByOther = previousAssignee !== null && previousAssignee !== author;
+            if (heldByOther && options.ifAvailable === true) {
+                skipped = true;
+                mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);
+                return { changedFields: [] };
+            }
+            if (heldByOther) {
+                mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);
+            }
             document.metadata.assignee = author;
-            return { changedFields: ["assignee"] };
+            return { changedFields: ["assignee"], warnings: mutationWarnings };
         },
     });
     return {
         item: result.item,
-        claimed_by: author,
+        claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,
         previous_assignee: previousAssignee,
         forced: force,
+        ...(skipped ? { skipped: true } : {}),
+        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),
     };
 }
 export async function runRelease(id, force, global, options = {}) {
@@ -97,4 +112,5 @@ export async function runRelease(id, force, global, options = {}) {
         forced: force,
     };
 }
-//# sourceMappingURL=claim.js.map
+//# sourceMappingURL=claim.js.map
+//# debugId=41409d93-c5da-5b53-86d0-3fd2339f6965

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

@@ -1 +1 @@
-{"version":3,"file":"claim.js","sourceRoot":"/","sources":["cli/commands/claim.ts"],"names":[],"mappings":"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","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveRuntimeStatusRegistry, statusIsTerminal } 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 { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n}\n\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n}\n\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\nfunction resolveAuthor(candidate: string | undefined, fallback: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? fallback;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\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 statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    mutate(document) {\n      previousAssignee = document.metadata.assignee ?? null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"] };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    claimed_by: author,\n    previous_assignee: previousAssignee,\n    forced: force,\n  };\n}\n\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\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 author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\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: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n        examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\n        nextSteps: [\n          \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n          \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n        ],\n      });\n    }\n    throw error;\n  }\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"]}
+{"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveRuntimeStatusRegistry, statusIsTerminal } 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 { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n  skipped?: boolean;\n  warnings?: string[];\n}\n\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n  ifAvailable?: boolean;\n}\n\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\nfunction resolveAuthor(candidate: string | undefined, fallback: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? fallback;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\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 statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    mutate(document) {\n      previousAssignee = document.metadata.assignee ?? null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      const heldByOther = previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\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 author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\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: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n        examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\n        nextSteps: [\n          \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n          \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n        ],\n      });\n    }\n    throw error;\n  }\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"41409d93-c5da-5b53-86d0-3fd2339f6965"}

package/dist/cli/commands/close.js

@@ -1,3 +1,5 @@
+
+!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]="6b8dfd25-e293-5021-9863-18d1fa5e5856")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { normalizeStatusInput } from "../../core/item/status.js";
 import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
@@ -104,4 +106,5 @@ export async function runClose(id, closeReasonText, options, global) {
         warnings: result.warnings,
     };
 }
-//# sourceMappingURL=close.js.map
+//# sourceMappingURL=close.js.map
+//# debugId=6b8dfd25-e293-5021-9863-18d1fa5e5856

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","sourceRoot":"/","sources":["cli/commands/close.ts"],"names":[],"mappings":"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","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } 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 { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, ItemStatus } from \"../../types/index.js\";\n\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n}\n\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction ensureCloseReason(reasonText: string): string {\n  const reason = reasonText.trim();\n  if (reason.length === 0) {\n    throw new PmCliError(\"Close reason text must not be empty\", EXIT_CODE.USAGE);\n  }\n  return reason;\n}\n\nfunction isTerminal(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean {\n  const normalized = normalizeStatusInput(status, statusRegistry) ?? status;\n  return statusRegistry.terminal_statuses.has(normalized);\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\nconst CLOSE_VALIDATION_FIELDS: Array<{ key: keyof Pick<ItemFrontMatter, \"resolution\" | \"expected_result\" | \"actual_result\">; label: string }> = [\n  { key: \"resolution\", label: \"resolution\" },\n  { key: \"expected_result\", label: \"expected_result\" },\n  { key: \"actual_result\", label: \"actual_result\" },\n];\n\nfunction parseValidateCloseMode(raw: string | undefined): ValidateCloseMode | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized.length === 0 || normalized === \"warn\") {\n    return \"warn\";\n  }\n  if (normalized === \"off\" || normalized === \"none\" || normalized === \"disabled\") {\n    return \"off\";\n  }\n  if (normalized === \"strict\") {\n    return \"strict\";\n  }\n  throw new PmCliError(`Invalid --validate-close mode \"${raw}\" (expected \"off\", \"warn\", or \"strict\")`, EXIT_CODE.USAGE);\n}\n\nfunction findMissingCloseValidationFields(frontMatter: ItemFrontMatter): string[] {\n  const missing: string[] = [];\n  for (const field of CLOSE_VALIDATION_FIELDS) {\n    const rawValue = frontMatter[field.key];\n    if (typeof rawValue !== \"string\" || rawValue.trim().length === 0) {\n      missing.push(field.label);\n    }\n  }\n  return missing;\n}\n\nexport async function runClose(\n  id: string,\n  closeReasonText: string,\n  options: CloseCommandOptions,\n  global: GlobalOptions,\n): Promise<CloseResult> {\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\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = toAuthor(options.author, settings.author_default);\n  const closeReason = ensureCloseReason(closeReasonText);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"close\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (isTerminal(document.metadata.status, statusRegistry) && !options.force) {\n        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n      }\n      const mutationWarnings: string[] = [];\n      if (validateCloseMode !== \"off\") {\n        const missingFields = findMissingCloseValidationFields(document.metadata);\n        if (missingFields.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(\",\")}`);\n        }\n      }\n\n      document.metadata.status = statusRegistry.close_status;\n      document.metadata.close_reason = closeReason;\n\n      const changedFields = [\"status\", \"close_reason\"];\n      if (document.metadata.assignee !== undefined) {\n        delete document.metadata.assignee;\n        changedFields.push(\"assignee\");\n      }\n\n      return {\n        changedFields,\n        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n      };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    changed_fields: result.changedFields,\n    warnings: result.warnings,\n  };\n}\n"]}
+{"version":3,"file":"close.js","sources":["cli/commands/close.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } 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 { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, ItemStatus } from \"../../types/index.js\";\n\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n}\n\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction ensureCloseReason(reasonText: string): string {\n  const reason = reasonText.trim();\n  if (reason.length === 0) {\n    throw new PmCliError(\"Close reason text must not be empty\", EXIT_CODE.USAGE);\n  }\n  return reason;\n}\n\nfunction isTerminal(status: ItemStatus, statusRegistry: RuntimeStatusRegistry): boolean {\n  const normalized = normalizeStatusInput(status, statusRegistry) ?? status;\n  return statusRegistry.terminal_statuses.has(normalized);\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\nconst CLOSE_VALIDATION_FIELDS: Array<{ key: keyof Pick<ItemFrontMatter, \"resolution\" | \"expected_result\" | \"actual_result\">; label: string }> = [\n  { key: \"resolution\", label: \"resolution\" },\n  { key: \"expected_result\", label: \"expected_result\" },\n  { key: \"actual_result\", label: \"actual_result\" },\n];\n\nfunction parseValidateCloseMode(raw: string | undefined): ValidateCloseMode | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized.length === 0 || normalized === \"warn\") {\n    return \"warn\";\n  }\n  if (normalized === \"off\" || normalized === \"none\" || normalized === \"disabled\") {\n    return \"off\";\n  }\n  if (normalized === \"strict\") {\n    return \"strict\";\n  }\n  throw new PmCliError(`Invalid --validate-close mode \"${raw}\" (expected \"off\", \"warn\", or \"strict\")`, EXIT_CODE.USAGE);\n}\n\nfunction findMissingCloseValidationFields(frontMatter: ItemFrontMatter): string[] {\n  const missing: string[] = [];\n  for (const field of CLOSE_VALIDATION_FIELDS) {\n    const rawValue = frontMatter[field.key];\n    if (typeof rawValue !== \"string\" || rawValue.trim().length === 0) {\n      missing.push(field.label);\n    }\n  }\n  return missing;\n}\n\nexport async function runClose(\n  id: string,\n  closeReasonText: string,\n  options: CloseCommandOptions,\n  global: GlobalOptions,\n): Promise<CloseResult> {\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\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = toAuthor(options.author, settings.author_default);\n  const closeReason = ensureCloseReason(closeReasonText);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"close\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (isTerminal(document.metadata.status, statusRegistry) && !options.force) {\n        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n      }\n      const mutationWarnings: string[] = [];\n      if (validateCloseMode !== \"off\") {\n        const missingFields = findMissingCloseValidationFields(document.metadata);\n        if (missingFields.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(\",\")}`);\n        }\n      }\n\n      document.metadata.status = statusRegistry.close_status;\n      document.metadata.close_reason = closeReason;\n\n      const changedFields = [\"status\", \"close_reason\"];\n      if (document.metadata.assignee !== undefined) {\n        delete document.metadata.assignee;\n        changedFields.push(\"assignee\");\n      }\n\n      return {\n        changedFields,\n        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n      };\n    },\n  });\n\n  return {\n    item: result.item as unknown as Record<string, unknown>,\n    changed_fields: result.changedFields,\n    warnings: result.warnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"6b8dfd25-e293-5021-9863-18d1fa5e5856"}

package/dist/cli/commands/comments-audit.js

@@ -1,3 +1,5 @@
+
+!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]="d19ec42b-bf16-54f8-a48b-d4f0defcc3b3")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { normalizeStatusInput } from "../../core/item/status.js";
@@ -192,4 +194,5 @@ export async function runCommentsAudit(options, global) {
         ...(listed.warnings && listed.warnings.length > 0 ? { warnings: listed.warnings } : {}),
     };
 }
-//# sourceMappingURL=comments-audit.js.map
+//# sourceMappingURL=comments-audit.js.map
+//# debugId=d19ec42b-bf16-54f8-a48b-d4f0defcc3b3

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

@@ -1 +1 @@
-{"version":3,"file":"comments-audit.js","sourceRoot":"/","sources":["cli/commands/comments-audit.ts"],"names":[],"mappings":"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","sourcesContent":["import { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { type Comment, type ItemStatus } from \"../../types/index.js\";\nimport { runList } from \"./list.js\";\n\nexport interface CommentsAuditOptions {\n  status?: string;\n  type?: string;\n  tag?: string;\n  priority?: string;\n  parent?: string;\n  sprint?: string;\n  release?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  limit?: string;\n  limitItems?: string;\n  latest?: string;\n  fullHistory?: boolean;\n}\n\nexport interface CommentsAuditEntry {\n  id: string;\n  title: string;\n  type: string;\n  status: ItemStatus;\n  assignee: string | null;\n  updated_at: string;\n  comment_count: number;\n  comments: Comment[];\n}\n\nexport interface CommentsAuditResult {\n  items: CommentsAuditEntry[];\n  count: number;\n  summary: CommentsAuditSummary;\n  filters: {\n    status: ItemStatus | null;\n    type: string | null;\n    tag: string | null;\n    priority: number | null;\n    parent: string | null;\n    sprint: string | null;\n    release: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    limit_items: number | null;\n    latest: number | null;\n    full_history: boolean;\n  };\n  export: {\n    mode: \"latest\" | \"full_history\";\n    row_count: number;\n  };\n  rows?: CommentsAuditHistoryRow[];\n  now: string;\n  warnings?: string[];\n}\n\nexport interface CommentsAuditSummary {\n  totals: {\n    items_scanned: number;\n    items_with_comments: number;\n    zero_comment_items: number;\n    comments_total: number;\n    comments_exported: number;\n  };\n  coverage: {\n    items_with_comments_ratio: number;\n    items_with_comments_percent: number;\n  };\n  by_type: CommentsAuditTypeSummary[];\n}\n\nexport interface CommentsAuditTypeSummary {\n  type: string;\n  items_scanned: number;\n  items_with_comments: number;\n  zero_comment_items: number;\n  comments_total: number;\n  comments_exported: number;\n  items_with_comments_ratio: number;\n  items_with_comments_percent: number;\n}\n\nexport interface CommentsAuditHistoryRow {\n  item_id: string;\n  item_title: string;\n  item_type: string;\n  item_status: ItemStatus;\n  item_assignee: string | null;\n  item_updated_at: string;\n  comment_index: number;\n  comment_count: number;\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nfunction parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(raw, statusRegistry);\n  if (!normalized) {\n    throw new PmCliError(\n      `Status filter must be one of ${statusRegistry.definitions.map((definition) => definition.id).join(\"|\")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction parseNonNegativeInteger(raw: string | undefined, flag: string): number | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const parsed = Number(raw);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new PmCliError(`${flag} must be a non-negative integer`, EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction limitComments(values: Comment[], latest: number): Comment[] {\n  if (latest <= 0) {\n    return [];\n  }\n  return values.slice(Math.max(0, values.length - latest));\n}\n\nfunction toHistoryRows(items: CommentsAuditEntry[]): CommentsAuditHistoryRow[] {\n  const rows: CommentsAuditHistoryRow[] = [];\n  for (const item of items) {\n    for (let index = 0; index < item.comments.length; index += 1) {\n      const comment = item.comments[index];\n      rows.push({\n        item_id: item.id,\n        item_title: item.title,\n        item_type: item.type,\n        item_status: item.status,\n        item_assignee: item.assignee,\n        item_updated_at: item.updated_at,\n        comment_index: index,\n        comment_count: item.comment_count,\n        created_at: comment.created_at,\n        author: comment.author,\n        text: comment.text,\n      });\n    }\n  }\n  return rows;\n}\n\nfunction ratioPercent(numerator: number, denominator: number): { ratio: number; percent: number } {\n  if (denominator <= 0) {\n    return {\n      ratio: 0,\n      percent: 0,\n    };\n  }\n  const ratio = numerator / denominator;\n  return {\n    ratio: Number(ratio.toFixed(4)),\n    percent: Number((ratio * 100).toFixed(2)),\n  };\n}\n\nfunction buildCommentsAuditSummary(items: CommentsAuditEntry[]): CommentsAuditSummary {\n  const itemsScanned = items.length;\n  const itemsWithComments = items.filter((entry) => entry.comment_count > 0).length;\n  const zeroCommentItems = itemsScanned - itemsWithComments;\n  const commentsTotal = items.reduce((sum, entry) => sum + entry.comment_count, 0);\n  const commentsExported = items.reduce((sum, entry) => sum + entry.comments.length, 0);\n  const overallCoverage = ratioPercent(itemsWithComments, itemsScanned);\n  const byTypeAccumulator = new Map<\n    string,\n    {\n      items_scanned: number;\n      items_with_comments: number;\n      comments_total: number;\n      comments_exported: number;\n    }\n  >();\n  for (const item of items) {\n    const entry = byTypeAccumulator.get(item.type) ?? {\n      items_scanned: 0,\n      items_with_comments: 0,\n      comments_total: 0,\n      comments_exported: 0,\n    };\n    entry.items_scanned += 1;\n    if (item.comment_count > 0) {\n      entry.items_with_comments += 1;\n    }\n    entry.comments_total += item.comment_count;\n    entry.comments_exported += item.comments.length;\n    byTypeAccumulator.set(item.type, entry);\n  }\n  const byType: CommentsAuditTypeSummary[] = [...byTypeAccumulator.entries()]\n    .sort(([left], [right]) => left.localeCompare(right))\n    .map(([type, stats]) => {\n      const zeroCount = stats.items_scanned - stats.items_with_comments;\n      const coverage = ratioPercent(stats.items_with_comments, stats.items_scanned);\n      return {\n        type,\n        items_scanned: stats.items_scanned,\n        items_with_comments: stats.items_with_comments,\n        zero_comment_items: zeroCount,\n        comments_total: stats.comments_total,\n        comments_exported: stats.comments_exported,\n        items_with_comments_ratio: coverage.ratio,\n        items_with_comments_percent: coverage.percent,\n      };\n    });\n  return {\n    totals: {\n      items_scanned: itemsScanned,\n      items_with_comments: itemsWithComments,\n      zero_comment_items: zeroCommentItems,\n      comments_total: commentsTotal,\n      comments_exported: commentsExported,\n    },\n    coverage: {\n      items_with_comments_ratio: overallCoverage.ratio,\n      items_with_comments_percent: overallCoverage.percent,\n    },\n    by_type: byType,\n  };\n}\n\nexport async function runCommentsAudit(options: CommentsAuditOptions, global: GlobalOptions): Promise<CommentsAuditResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const status = parseStatus(options.status, statusRegistry);\n  const fullHistory = options.fullHistory === true;\n  const latestParsed = parseNonNegativeInteger(options.latest, \"--latest\");\n  if (fullHistory && latestParsed !== undefined) {\n    throw new PmCliError(\"--full-history cannot be combined with --latest\", EXIT_CODE.USAGE);\n  }\n  const latest = fullHistory ? undefined : latestParsed ?? 1;\n  const limitItemsPrimary = parseNonNegativeInteger(options.limitItems, \"--limit-items\");\n  const limitItemsAlias = parseNonNegativeInteger(options.limit, \"--limit\");\n  if (\n    limitItemsPrimary !== undefined &&\n    limitItemsAlias !== undefined &&\n    limitItemsPrimary !== limitItemsAlias\n  ) {\n    throw new PmCliError(\"--limit and --limit-items must match when both are provided\", EXIT_CODE.USAGE);\n  }\n  const limitItems = limitItemsPrimary ?? limitItemsAlias;\n\n  const listed = await runList(\n    status,\n    {\n      type: options.type,\n      tag: options.tag,\n      priority: options.priority,\n      parent: options.parent,\n      sprint: options.sprint,\n      release: options.release,\n      assignee: options.assignee,\n      assigneeFilter: options.assigneeFilter,\n      limit: limitItems === undefined ? undefined : String(limitItems),\n    },\n    global,\n  );\n\n  const items = listed.items.map((item) => {\n    const comments = item.comments ?? [];\n    return {\n      id: item.id,\n      title: item.title,\n      type: item.type,\n      status: item.status,\n      assignee: item.assignee ?? null,\n      updated_at: item.updated_at,\n      comment_count: comments.length,\n      comments: latest === undefined ? comments : limitComments(comments, latest),\n    };\n  });\n  const rows = fullHistory ? toHistoryRows(items) : undefined;\n  const latestRowCount = items.reduce((sum, entry) => sum + entry.comments.length, 0);\n\n  return {\n    items,\n    count: items.length,\n    summary: buildCommentsAuditSummary(items),\n    filters: {\n      status: status ?? null,\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority === undefined ? null : Number(options.priority),\n      parent: options.parent ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      limit_items: limitItems ?? null,\n      latest: latest ?? null,\n      full_history: fullHistory,\n    },\n    export: {\n      mode: fullHistory ? \"full_history\" : \"latest\",\n      row_count: fullHistory ? rows?.length ?? 0 : latestRowCount,\n    },\n    ...(rows ? { rows } : {}),\n    now: listed.now,\n    ...(listed.warnings && listed.warnings.length > 0 ? { warnings: listed.warnings } : {}),\n  };\n}\n"]}
+{"version":3,"file":"comments-audit.js","sources":["cli/commands/comments-audit.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { normalizeStatusInput } from \"../../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { type Comment, type ItemStatus } from \"../../types/index.js\";\nimport { runList } from \"./list.js\";\n\nexport interface CommentsAuditOptions {\n  status?: string;\n  type?: string;\n  tag?: string;\n  priority?: string;\n  parent?: string;\n  sprint?: string;\n  release?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  limit?: string;\n  limitItems?: string;\n  latest?: string;\n  fullHistory?: boolean;\n}\n\nexport interface CommentsAuditEntry {\n  id: string;\n  title: string;\n  type: string;\n  status: ItemStatus;\n  assignee: string | null;\n  updated_at: string;\n  comment_count: number;\n  comments: Comment[];\n}\n\nexport interface CommentsAuditResult {\n  items: CommentsAuditEntry[];\n  count: number;\n  summary: CommentsAuditSummary;\n  filters: {\n    status: ItemStatus | null;\n    type: string | null;\n    tag: string | null;\n    priority: number | null;\n    parent: string | null;\n    sprint: string | null;\n    release: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    limit_items: number | null;\n    latest: number | null;\n    full_history: boolean;\n  };\n  export: {\n    mode: \"latest\" | \"full_history\";\n    row_count: number;\n  };\n  rows?: CommentsAuditHistoryRow[];\n  now: string;\n  warnings?: string[];\n}\n\nexport interface CommentsAuditSummary {\n  totals: {\n    items_scanned: number;\n    items_with_comments: number;\n    zero_comment_items: number;\n    comments_total: number;\n    comments_exported: number;\n  };\n  coverage: {\n    items_with_comments_ratio: number;\n    items_with_comments_percent: number;\n  };\n  by_type: CommentsAuditTypeSummary[];\n}\n\nexport interface CommentsAuditTypeSummary {\n  type: string;\n  items_scanned: number;\n  items_with_comments: number;\n  zero_comment_items: number;\n  comments_total: number;\n  comments_exported: number;\n  items_with_comments_ratio: number;\n  items_with_comments_percent: number;\n}\n\nexport interface CommentsAuditHistoryRow {\n  item_id: string;\n  item_title: string;\n  item_type: string;\n  item_status: ItemStatus;\n  item_assignee: string | null;\n  item_updated_at: string;\n  comment_index: number;\n  comment_count: number;\n  created_at: string;\n  author: string;\n  text: string;\n}\n\nfunction parseStatus(raw: string | undefined, statusRegistry: RuntimeStatusRegistry): ItemStatus | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = normalizeStatusInput(raw, statusRegistry);\n  if (!normalized) {\n    throw new PmCliError(\n      `Status filter must be one of ${statusRegistry.definitions.map((definition) => definition.id).join(\"|\")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized;\n}\n\nfunction parseNonNegativeInteger(raw: string | undefined, flag: string): number | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const parsed = Number(raw);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new PmCliError(`${flag} must be a non-negative integer`, EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction limitComments(values: Comment[], latest: number): Comment[] {\n  if (latest <= 0) {\n    return [];\n  }\n  return values.slice(Math.max(0, values.length - latest));\n}\n\nfunction toHistoryRows(items: CommentsAuditEntry[]): CommentsAuditHistoryRow[] {\n  const rows: CommentsAuditHistoryRow[] = [];\n  for (const item of items) {\n    for (let index = 0; index < item.comments.length; index += 1) {\n      const comment = item.comments[index];\n      rows.push({\n        item_id: item.id,\n        item_title: item.title,\n        item_type: item.type,\n        item_status: item.status,\n        item_assignee: item.assignee,\n        item_updated_at: item.updated_at,\n        comment_index: index,\n        comment_count: item.comment_count,\n        created_at: comment.created_at,\n        author: comment.author,\n        text: comment.text,\n      });\n    }\n  }\n  return rows;\n}\n\nfunction ratioPercent(numerator: number, denominator: number): { ratio: number; percent: number } {\n  if (denominator <= 0) {\n    return {\n      ratio: 0,\n      percent: 0,\n    };\n  }\n  const ratio = numerator / denominator;\n  return {\n    ratio: Number(ratio.toFixed(4)),\n    percent: Number((ratio * 100).toFixed(2)),\n  };\n}\n\nfunction buildCommentsAuditSummary(items: CommentsAuditEntry[]): CommentsAuditSummary {\n  const itemsScanned = items.length;\n  const itemsWithComments = items.filter((entry) => entry.comment_count > 0).length;\n  const zeroCommentItems = itemsScanned - itemsWithComments;\n  const commentsTotal = items.reduce((sum, entry) => sum + entry.comment_count, 0);\n  const commentsExported = items.reduce((sum, entry) => sum + entry.comments.length, 0);\n  const overallCoverage = ratioPercent(itemsWithComments, itemsScanned);\n  const byTypeAccumulator = new Map<\n    string,\n    {\n      items_scanned: number;\n      items_with_comments: number;\n      comments_total: number;\n      comments_exported: number;\n    }\n  >();\n  for (const item of items) {\n    const entry = byTypeAccumulator.get(item.type) ?? {\n      items_scanned: 0,\n      items_with_comments: 0,\n      comments_total: 0,\n      comments_exported: 0,\n    };\n    entry.items_scanned += 1;\n    if (item.comment_count > 0) {\n      entry.items_with_comments += 1;\n    }\n    entry.comments_total += item.comment_count;\n    entry.comments_exported += item.comments.length;\n    byTypeAccumulator.set(item.type, entry);\n  }\n  const byType: CommentsAuditTypeSummary[] = [...byTypeAccumulator.entries()]\n    .sort(([left], [right]) => left.localeCompare(right))\n    .map(([type, stats]) => {\n      const zeroCount = stats.items_scanned - stats.items_with_comments;\n      const coverage = ratioPercent(stats.items_with_comments, stats.items_scanned);\n      return {\n        type,\n        items_scanned: stats.items_scanned,\n        items_with_comments: stats.items_with_comments,\n        zero_comment_items: zeroCount,\n        comments_total: stats.comments_total,\n        comments_exported: stats.comments_exported,\n        items_with_comments_ratio: coverage.ratio,\n        items_with_comments_percent: coverage.percent,\n      };\n    });\n  return {\n    totals: {\n      items_scanned: itemsScanned,\n      items_with_comments: itemsWithComments,\n      zero_comment_items: zeroCommentItems,\n      comments_total: commentsTotal,\n      comments_exported: commentsExported,\n    },\n    coverage: {\n      items_with_comments_ratio: overallCoverage.ratio,\n      items_with_comments_percent: overallCoverage.percent,\n    },\n    by_type: byType,\n  };\n}\n\nexport async function runCommentsAudit(options: CommentsAuditOptions, global: GlobalOptions): Promise<CommentsAuditResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const status = parseStatus(options.status, statusRegistry);\n  const fullHistory = options.fullHistory === true;\n  const latestParsed = parseNonNegativeInteger(options.latest, \"--latest\");\n  if (fullHistory && latestParsed !== undefined) {\n    throw new PmCliError(\"--full-history cannot be combined with --latest\", EXIT_CODE.USAGE);\n  }\n  const latest = fullHistory ? undefined : latestParsed ?? 1;\n  const limitItemsPrimary = parseNonNegativeInteger(options.limitItems, \"--limit-items\");\n  const limitItemsAlias = parseNonNegativeInteger(options.limit, \"--limit\");\n  if (\n    limitItemsPrimary !== undefined &&\n    limitItemsAlias !== undefined &&\n    limitItemsPrimary !== limitItemsAlias\n  ) {\n    throw new PmCliError(\"--limit and --limit-items must match when both are provided\", EXIT_CODE.USAGE);\n  }\n  const limitItems = limitItemsPrimary ?? limitItemsAlias;\n\n  const listed = await runList(\n    status,\n    {\n      type: options.type,\n      tag: options.tag,\n      priority: options.priority,\n      parent: options.parent,\n      sprint: options.sprint,\n      release: options.release,\n      assignee: options.assignee,\n      assigneeFilter: options.assigneeFilter,\n      limit: limitItems === undefined ? undefined : String(limitItems),\n    },\n    global,\n  );\n\n  const items = listed.items.map((item) => {\n    const comments = item.comments ?? [];\n    return {\n      id: item.id,\n      title: item.title,\n      type: item.type,\n      status: item.status,\n      assignee: item.assignee ?? null,\n      updated_at: item.updated_at,\n      comment_count: comments.length,\n      comments: latest === undefined ? comments : limitComments(comments, latest),\n    };\n  });\n  const rows = fullHistory ? toHistoryRows(items) : undefined;\n  const latestRowCount = items.reduce((sum, entry) => sum + entry.comments.length, 0);\n\n  return {\n    items,\n    count: items.length,\n    summary: buildCommentsAuditSummary(items),\n    filters: {\n      status: status ?? null,\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority === undefined ? null : Number(options.priority),\n      parent: options.parent ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      limit_items: limitItems ?? null,\n      latest: latest ?? null,\n      full_history: fullHistory,\n    },\n    export: {\n      mode: fullHistory ? \"full_history\" : \"latest\",\n      row_count: fullHistory ? rows?.length ?? 0 : latestRowCount,\n    },\n    ...(rows ? { rows } : {}),\n    now: listed.now,\n    ...(listed.warnings && listed.warnings.length > 0 ? { warnings: listed.warnings } : {}),\n  };\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAA8B,MAAM,qCAAqC,CAAC;AAC/G,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgGpC,SAAS,WAAW,CAAC,GAAuB,EAAE,cAAqC;IACjF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAClB,gCAAgC,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACzG,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAuB,EAAE,IAAY;IACpE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,iCAAiC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,MAAiB,EAAE,MAAc;IACtD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,aAAa,CAAC,KAA2B;IAChD,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC;gBACR,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,UAAU,EAAE,IAAI,CAAC,KAAK;gBACtB,SAAS,EAAE,IAAI,CAAC,IAAI;gBACpB,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,aAAa,EAAE,IAAI,CAAC,QAAQ;gBAC5B,eAAe,EAAE,IAAI,CAAC,UAAU;gBAChC,aAAa,EAAE,KAAK;gBACpB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,SAAiB,EAAE,WAAmB;IAC1D,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;SACX,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACtC,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,KAA2B;IAC5D,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,MAAM,gBAAgB,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAC1D,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,eAAe,GAAG,YAAY,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAQ9B,CAAC;IACJ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAChD,aAAa,EAAE,CAAC;YAChB,mBAAmB,EAAE,CAAC;YACtB,cAAc,EAAE,CAAC;YACjB,iBAAiB,EAAE,CAAC;SACrB,CAAC;QACF,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,aAAa,CAAC;QAC3C,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChD,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAA+B,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC;SACxE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACrB,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,mBAAmB,CAAC;QAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9E,OAAO;YACL,IAAI;YACJ,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;YAC9C,kBAAkB,EAAE,SAAS;YAC7B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,yBAAyB,EAAE,QAAQ,CAAC,KAAK;YACzC,2BAA2B,EAAE,QAAQ,CAAC,OAAO;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,OAAO;QACL,MAAM,EAAE;YACN,aAAa,EAAE,YAAY;YAC3B,mBAAmB,EAAE,iBAAiB;YACtC,kBAAkB,EAAE,gBAAgB;YACpC,cAAc,EAAE,aAAa;YAC7B,iBAAiB,EAAE,gBAAgB;SACpC;QACD,QAAQ,EAAE;YACR,yBAAyB,EAAE,eAAe,CAAC,KAAK;YAChD,2BAA2B,EAAE,eAAe,CAAC,OAAO;SACrD;QACD,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA6B,EAAE,MAAqB;IACzF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,WAAW,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,iDAAiD,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACvF,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1E,IACE,iBAAiB,KAAK,SAAS;QAC/B,eAAe,KAAK,SAAS;QAC7B,iBAAiB,KAAK,eAAe,EACrC,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,6DAA6D,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,UAAU,GAAG,iBAAiB,IAAI,eAAe,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,MAAM,EACN;QACE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;KACjE,EACD,MAAM,CACP,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpF,OAAO;QACL,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC;QACzC,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,IAAI,IAAI;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC1E,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC/C,WAAW,EAAE,UAAU,IAAI,IAAI;YAC/B,MAAM,EAAE,MAAM,IAAI,IAAI;YACtB,YAAY,EAAE,WAAW;SAC1B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ;YAC7C,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc;SAC5D;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxF,CAAC;AACJ,CAAC","debugId":"d19ec42b-bf16-54f8-a48b-d4f0defcc3b3"}

package/dist/cli/commands/comments.js

@@ -1,3 +1,5 @@
+
+!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]="c703814c-81c4-5e2e-b5bc-b2e9c6a8bfc3")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
@@ -167,4 +169,5 @@ export async function runComments(id, options, global) {
         count: comments.length,
     };
 }
-//# sourceMappingURL=comments.js.map
+//# sourceMappingURL=comments.js.map
+//# debugId=c703814c-81c4-5e2e-b5bc-b2e9c6a8bfc3

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

@@ -1 +1 @@
-{"version":3,"file":"comments.js","sourceRoot":"/","sources":["cli/commands/comments.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { 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 { createStdinTokenResolver, parseCsvKv } from \"../../core/item/parse.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\";\nimport type { Comment } from \"../../types/index.js\";\n\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n}\n\nfunction resolveAuthor(candidate: string | undefined, fallback: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? fallback;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction limitComments(values: Comment[], limit: number | undefined): Comment[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction parseCommentTextInput(raw: string): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\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\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\";\n  value?: string;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\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 { mode: \"list\" };\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 {\n      mode: \"add\",\n      value: addInput ?? \"\",\n    };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return {\n      mode: \"stdin\",\n      value: stdinInput ?? \"\",\n    };\n  }\n  const filePath = options.file?.trim() ?? \"\";\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return {\n      mode: \"file\",\n      value: fileInput,\n    };\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\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\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  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  if (commentInput.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 comments = limitComments(loaded.document.metadata.comments ?? [], limit);\n    return {\n      id: located.id,\n      comments,\n      count: comments.length,\n    };\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const text = commentInput.mode === \"add\" ? parseCommentTextInput(commentInput.value ?? \"\") : (commentInput.value ?? \"\");\n  if (!text.trim()) {\n    const inputFlag = commentInput.mode === \"add\" ? \"--add\" : commentInput.mode === \"stdin\" ? \"--stdin\" : \"--file\";\n    throw new PmCliError(`${inputFlag} text cannot be empty`, EXIT_CODE.USAGE);\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"comment_add\",\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: Boolean(options.allowAuditComment),\n      mutate(document) {\n        const comments = document.metadata.comments ?? [];\n        comments.push({\n          created_at: nowIso(),\n          author,\n          text,\n        });\n        document.metadata.comments = comments;\n        return { changedFields: [\"comments\"] };\n      },\n    });\n  } catch (error: unknown) {\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:\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    throw error;\n  }\n\n  const comments = limitComments(result.item.comments as Comment[], limit);\n  return {\n    id: result.item.id,\n    comments,\n    count: comments.length,\n  };\n}\n"]}
+{"version":3,"file":"comments.js","sources":["cli/commands/comments.ts"],"sourceRoot":"/","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { 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 { createStdinTokenResolver, parseCsvKv } from \"../../core/item/parse.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\";\nimport type { Comment } from \"../../types/index.js\";\n\nexport interface CommentsCommandOptions {\n  add?: string;\n  stdin?: boolean;\n  file?: string;\n  limit?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  allowAuditComment?: boolean;\n}\n\nexport interface CommentsResult {\n  id: string;\n  comments: Comment[];\n  count: number;\n}\n\nfunction resolveAuthor(candidate: string | undefined, fallback: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? fallback;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction limitComments(values: Comment[], limit: number | undefined): Comment[] {\n  if (limit === undefined) return values;\n  if (limit === 0) return [];\n  return values.slice(Math.max(0, values.length - limit));\n}\n\nfunction parseCommentTextInput(raw: string): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return \"\";\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\ninterface ResolvedCommentInput {\n  mode: \"list\" | \"add\" | \"stdin\" | \"file\";\n  value?: string;\n}\n\nfunction isErrnoError(error: unknown): error is NodeJS.ErrnoException {\n  return typeof error === \"object\" && error !== null && \"code\" in error;\n}\n\nasync function resolveCommentInput(\n  options: CommentsCommandOptions,\n  stdinResolver: ReturnType<typeof createStdinTokenResolver>,\n): Promise<ResolvedCommentInput> {\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 { mode: \"list\" };\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 {\n      mode: \"add\",\n      value: addInput ?? \"\",\n    };\n  }\n  if (hasStdin) {\n    const stdinInput = await stdinResolver.resolveValue(\"-\", \"--stdin\");\n    return {\n      mode: \"stdin\",\n      value: stdinInput ?? \"\",\n    };\n  }\n  const filePath = options.file?.trim() ?? \"\";\n  if (!filePath) {\n    throw new PmCliError(\"--file path cannot be empty\", EXIT_CODE.USAGE);\n  }\n  try {\n    const fileInput = await readFile(filePath, \"utf8\");\n    return {\n      mode: \"file\",\n      value: fileInput,\n    };\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\nexport async function runComments(id: string, options: CommentsCommandOptions, global: GlobalOptions): Promise<CommentsResult> {\n  const stdinResolver = createStdinTokenResolver();\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  const commentInput = await resolveCommentInput(options, stdinResolver);\n\n  if (commentInput.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 comments = limitComments(loaded.document.metadata.comments ?? [], limit);\n    return {\n      id: located.id,\n      comments,\n      count: comments.length,\n    };\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const text = commentInput.mode === \"add\" ? parseCommentTextInput(commentInput.value ?? \"\") : (commentInput.value ?? \"\");\n  if (!text.trim()) {\n    const inputFlag = commentInput.mode === \"add\" ? \"--add\" : commentInput.mode === \"stdin\" ? \"--stdin\" : \"--file\";\n    throw new PmCliError(`${inputFlag} text cannot be empty`, EXIT_CODE.USAGE);\n  }\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"comment_add\",\n      author,\n      message: options.message,\n      force: options.force,\n      bypassAssigneeConflict: Boolean(options.allowAuditComment),\n      mutate(document) {\n        const comments = document.metadata.comments ?? [];\n        comments.push({\n          created_at: nowIso(),\n          author,\n          text,\n        });\n        document.metadata.comments = comments;\n        return { changedFields: [\"comments\"] };\n      },\n    });\n  } catch (error: unknown) {\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:\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    throw error;\n  }\n\n  const comments = limitComments(result.item.comments as Comment[], limit);\n  return {\n    id: result.item.id,\n    comments,\n    count: comments.length,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"c703814c-81c4-5e2e-b5bc-b2e9c6a8bfc3"}

package/dist/cli/commands/completion.js

@@ -1,6 +1,8 @@
+
+!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]="f31aa5f9-6785-5b5e-9c34-167ef6e9f543")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
-import { ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NORMALIZE_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, SEARCH_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "../../sdk/cli-contracts.js";
+import { ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NORMALIZE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, SEARCH_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "../../sdk/cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
 import { listGuideTopicIds } from "../guide-topics.js";
 const VALID_SHELLS = ["bash", "zsh", "fish"];
@@ -22,6 +24,8 @@ const SEARCH_FLAGS = toCompletionFlagString(SEARCH_FLAG_CONTRACTS);
 const HEALTH_FLAGS = toCompletionFlagString(HEALTH_FLAG_CONTRACTS);
 const INIT_FLAGS = toCompletionFlagString(INIT_FLAG_CONTRACTS);
 const CONTRACTS_FLAGS = toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);
+const PLAN_FLAGS = toCompletionFlagString(PLAN_FLAG_CONTRACTS);
+const PLAN_SUBCOMMANDS_LIST = "create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";
 const COMPLETION_FLAGS = toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);
 const COMPLETION_SHELL_CHOICES = `${COMPLETION_FLAGS} bash zsh fish`;
 const GUIDE_TOPIC_CHOICES = joinCompletionValues(listGuideTopicIds());
@@ -198,6 +202,12 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "    history)",
         `      COMPREPLY=(${compgen("--limit --diff --verify --json --quiet --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
+        "    history-redact)",
+        `      COMPREPLY=(${compgen("--literal --regex --replacement --dry-run --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        "      ;;",
+        "    plan)",
+        `      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
+        "      ;;",
         "    activity)",
         `      COMPREPLY=(${compgen(ACTIVITY_FLAGS)})`,
         "      ;;",
@@ -286,6 +296,8 @@ _pm_commands() {
     'search:Search items with keyword, semantic, or hybrid modes'
     'reindex:Rebuild search artifacts'
     'history:Show item history entries'
+    'history-redact:Redact sensitive literals/patterns and recompute history hashes'
+    'plan:Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)'
     'activity:Show recent activity across items'
     'restore:Restore an item to an earlier state'
     'update:Update item fields and metadata'
@@ -658,6 +670,43 @@ _pm() {
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        history-redact)
+          _arguments \\
+            '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
+            '--regex[Regex matcher to redact (/pattern/flags or raw pattern)]:regex' \\
+            '--replacement[Replacement text (defaults to [redacted])]:replacement' \\
+            '--dry-run[Preview redaction impact without writing files]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Audit history message]:message' \\
+            '--force[Force ownership/lock override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        plan)
+          _arguments \\
+            '1:subcommand:(create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize)' \\
+            '--title[Plan title]:title' \\
+            '--scope[Plan scope statement]:scope' \\
+            '--harness[Plan harness provenance]:harness:(codex claude-code cursor generic)' \\
+            '--mode[Plan mode]:mode:(draft research review approved executing paused completed superseded)' \\
+            '--resume-context[Resume context summary]:text' \\
+            '--step-title[Step title]:title' \\
+            '--step-status[Step status]:status:(pending in_progress completed blocked skipped superseded)' \\
+            '--step-evidence[Step evidence]:text' \\
+            '--depends-on[Pm item id step depends on]:id' \\
+            '--link[Pm item id to link]:id' \\
+            '--link-kind[Link kind]:kind:(related blocks blocked_by depends_on discovered_from implements verifies supersedes)' \\
+            '--depth[Show depth]:depth:(brief standard deep)' \\
+            '--steps[Step ids/orders for materialize]:steps' \\
+            '--materialize-type[Item type for materialized steps]:type' \\
+            '--allow-multiple-active[Allow multiple in_progress steps]' \\
+            '--promote-to-item-dep[Also add link as top-level item dependency]' \\
+            '--author[Mutation author]:author' \\
+            '--message[Mutation message]:message' \\
+            '--force[Force ownership override]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
         activity)
           _arguments \\
             '--id[Filter by item ID]:id' \\
@@ -797,12 +846,24 @@ _pm() {
         init)
           _arguments \\
             '--preset[Governance preset for new setups]:preset:(minimal default strict)' \\
+            '--defaults[Use non-interactive setup defaults]' \\
+            '-y[Alias for --defaults]' \\
+            '--yes[Alias for --defaults]' \\
+            '--author[Set the default mutation author for this project]:author' \\
+            '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
+            '--with-packages[Install bundled first-party packages during initialization]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         init)
           _arguments \\
             '--preset[Governance preset for new setups]:preset:(minimal default strict)' \\
+            '--defaults[Use non-interactive setup defaults]' \\
+            '-y[Alias for --defaults]' \\
+            '--yes[Alias for --defaults]' \\
+            '--author[Set the default mutation author for this project]:author' \\
+            '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
+            '--with-packages[Install bundled first-party packages during initialization]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -1035,6 +1096,8 @@ complete -c pm -n __pm_no_subcommand -a get           -d 'Show item details by I
 complete -c pm -n __pm_no_subcommand -a search        -d 'Search items with keyword, semantic, or hybrid modes'
 complete -c pm -n __pm_no_subcommand -a reindex       -d 'Rebuild search artifacts'
 complete -c pm -n __pm_no_subcommand -a history       -d 'Show item history entries'
+complete -c pm -n __pm_no_subcommand -a history-redact -d 'Redact sensitive literals/patterns and recompute history hashes'
+complete -c pm -n __pm_no_subcommand -a plan          -d 'Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)'
 complete -c pm -n __pm_no_subcommand -a activity      -d 'Show recent activity across items'
 complete -c pm -n __pm_no_subcommand -a restore       -d 'Restore an item to an earlier state'
 complete -c pm -n __pm_no_subcommand -a update        -d 'Update item fields and metadata'
@@ -1345,6 +1408,33 @@ complete -c pm -n '__fish_seen_subcommand_from reindex' -l progress -d 'Emit pro
 complete -c pm -n '__fish_seen_subcommand_from history'  -l limit -d 'Max history entries' -r
 complete -c pm -n '__fish_seen_subcommand_from history'  -l diff -d 'Include changed-field patch summary'
 complete -c pm -n '__fish_seen_subcommand_from history'  -l verify -d 'Verify history hash chain and replay integrity'
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l dry-run -d 'Preview redaction impact without writing files'
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l message -d 'Audit history message' -r
+complete -c pm -n '__fish_seen_subcommand_from history-redact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from plan' -a 'create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize' -d 'Plan subcommand'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l title -d 'Plan title' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l scope -d 'Plan scope statement' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l harness -d 'Plan harness provenance' -r -a 'codex claude-code cursor generic'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l mode -d 'Plan mode' -r -a 'draft research review approved executing paused completed superseded'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l resume-context -d 'Resume context summary' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-title -d 'Step title' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-status -d 'Step status' -r -a 'pending in_progress completed blocked skipped superseded'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l step-evidence -d 'Step evidence' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l depends-on -d 'Pm item id step depends on' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l link -d 'Pm item id to link' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l link-kind -d 'Link kind' -r -a 'related blocks blocked_by depends_on discovered_from implements verifies supersedes'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l depth -d 'Show depth' -r -a 'brief standard deep'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l steps -d 'Step ids/orders for materialize' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l materialize-type -d 'Item type for materialized steps' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l allow-multiple-active -d 'Allow multiple in_progress steps'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l promote-to-item-dep -d 'Also add link as item dependency'
+complete -c pm -n '__fish_seen_subcommand_from plan' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l message -d 'Mutation message' -r
+complete -c pm -n '__fish_seen_subcommand_from plan' -l force -d 'Force ownership override'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l id -d 'Filter by item ID' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l op -d 'Filter by history operation' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l author -d 'Filter by history author' -r
@@ -1459,6 +1549,11 @@ complete -c pm -n '__fish_seen_subcommand_from validate' -l fail-on-warn -d 'Ali
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
 complete -c pm -n '__fish_seen_subcommand_from init' -l preset -d 'Governance preset for new setups' -r -a 'minimal default strict'
+complete -c pm -n '__fish_seen_subcommand_from init' -l defaults -d 'Use non-interactive setup defaults'
+complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for --defaults'
+complete -c pm -n '__fish_seen_subcommand_from init' -l author -d 'Set the default mutation author for this project' -r
+complete -c pm -n '__fish_seen_subcommand_from init' -l agent-guidance -d 'Agent guidance mode' -r -a 'ask add skip status'
+complete -c pm -n '__fish_seen_subcommand_from init' -l with-packages -d 'Install bundled first-party packages during initialization'
 complete -c pm -n '__fish_seen_subcommand_from config' -l criterion -d 'Criteria value for definition-of-done metadata-required-fields or lifecycle pattern keys (repeatable for set)' -r
 complete -c pm -n '__fish_seen_subcommand_from config' -l clear-criteria -d 'Clear config criteria-list key values'
 complete -c pm -n '__fish_seen_subcommand_from config' -l format -d 'Item format for item-format key' -r -a 'toon'
@@ -1546,4 +1641,5 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
         setup_hint: SETUP_HINTS[validShell],
     };
 }
-//# sourceMappingURL=completion.js.map
+//# sourceMappingURL=completion.js.map
+//# debugId=f31aa5f9-6785-5b5e-9c34-167ef6e9f543