@unbrained/pm-cli 2026.6.6 → 2026.6.7

package/dist/cli-bundle/chunks/{close-many-ERFO6LHR.js → close-many-LAC5VR4G.js}

@@ -1,41 +1,41 @@
 
-!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]="962ecda8-e91c-5375-bcff-db5afb2e4bc7")}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]="60081a5b-37a0-5d2a-9e3e-0c94a5826738")}catch(e){}}();
 import {
   createCheckpointId,
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-2HVRUSQA.js";
+} from "./chunk-KNGVP5WJ.js";
+import {
+  runClose
+} from "./chunk-NHR2QXXZ.js";
 import {
   runRestore
-} from "./chunk-2VVCGBNV.js";
+} from "./chunk-R3V3YCMH.js";
 import {
   resolveAuthor
 } from "./chunk-J27KIHTG.js";
-import "./chunk-2RSPZI5H.js";
-import "./chunk-GXSUPCBV.js";
-import {
-  runClose
-} from "./chunk-FRAUKRU2.js";
+import "./chunk-6RZXO5M2.js";
+import "./chunk-3A2CMEM7.js";
 import {
   runList
-} from "./chunk-W7XABV4H.js";
-import "./chunk-GCOQW437.js";
-import "./chunk-3VAM3NNM.js";
+} from "./chunk-TINUJMWN.js";
+import "./chunk-6J4K6JLA.js";
+import "./chunk-FY6Z3FYY.js";
 import "./chunk-XSLQSXAH.js";
 import {
   listAllFrontMatterLight
-} from "./chunk-GGYWB3Y2.js";
-import "./chunk-HZGUAH22.js";
+} from "./chunk-YBZW2QQ7.js";
+import "./chunk-UT6WFXW2.js";
 import {
   isTerminalStatus
-} from "./chunk-LB3RUL2N.js";
+} from "./chunk-UYQ7HXH4.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-2VBQ6ZXS.js";
+} from "./chunk-GUZBNB3G.js";
 import {
   nowIso
-} from "./chunk-TCD3R2PF.js";
+} from "./chunk-B2KZGPM2.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -46,7 +46,7 @@ import {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   toErrorMessage
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-X4IZKYHP.js";
 
 // dist/cli/commands/close-many.js
 var CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
@@ -88,10 +88,13 @@ function activeListOptions(list) {
   }
   return active;
 }
-function ensureReason(reason) {
+function resolveReason(reason, required) {
   const trimmed = String(reason ?? "").trim();
-  if (trimmed.length === 0) {
-    throw new PmCliError("pm close-many requires a shared close reason via --reason. Close mutations are auditable.", EXIT_CODE.USAGE, {
+  if (trimmed.length > 0) {
+    return trimmed;
+  }
+  if (required) {
+    throw new PmCliError("pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.", EXIT_CODE.USAGE, {
       code: "missing_required_argument",
       examples: [
         'pm close-many --filter-sprint S-12 --reason "Sprint S-12 acceptance criteria met"',
@@ -99,7 +102,7 @@ function ensureReason(reason) {
       ]
     });
   }
-  return trimmed;
+  return void 0;
 }
 async function buildActiveChildrenByParent(pmRoot, settings) {
   const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
@@ -199,7 +202,7 @@ async function runCloseMany(options, global) {
   if (!hasCloseManyFilters(options.list, options.status)) {
     throw new PmCliError(`close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`, EXIT_CODE.USAGE);
   }
-  const reason = ensureReason(options.reason);
+  const reason = resolveReason(options.reason, settings.governance.require_close_reason);
   const validateCloseMode = options.validateClose;
   const force = options.force === true;
   const listOptions = activeListOptions(options.list);
@@ -229,7 +232,7 @@ async function runCloseMany(options, global) {
       mode: "dry_run",
       matched_count: matched.length,
       dry_run: true,
-      reason,
+      ...reason !== void 0 ? { reason } : {},
       filters: listed.filters,
       ...validateCloseMode ? { validate_close: validateCloseMode } : {},
       item_plans: planRows,
@@ -248,7 +251,7 @@ async function runCloseMany(options, global) {
       id: checkpointId,
       created_at: nowValue,
       author: resolveAuthor(options.author, "unknown"),
-      reason,
+      ...reason !== void 0 ? { reason } : {},
       filters: listed.filters,
       items: checkpointItems
     });
@@ -292,7 +295,7 @@ async function runCloseMany(options, global) {
     mode: "apply",
     matched_count: matched.length,
     dry_run: false,
-    reason,
+    ...reason !== void 0 ? { reason } : {},
     filters: listed.filters,
     ...validateCloseMode ? { validate_close: validateCloseMode } : {},
     ...checkpointInfo ? { checkpoint: checkpointInfo } : {},
@@ -306,6 +309,6 @@ async function runCloseMany(options, global) {
 export {
   runCloseMany
 };
-//# sourceMappingURL=close-many-ERFO6LHR.js.map
+//# sourceMappingURL=close-many-LAC5VR4G.js.map
 
-//# debugId=962ecda8-e91c-5375-bcff-db5afb2e4bc7
+//# debugId=60081a5b-37a0-5d2a-9e3e-0c94a5826738

package/dist/cli-bundle/chunks/close-many-LAC5VR4G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/close-many.ts"],"sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  createCheckpointId,\n  loadMutationCheckpoint,\n  restoreCheckpointItems,\n  writeMutationCheckpoint,\n  type MutationCheckpointItem,\n} from \"../../core/checkpoint/mutation-checkpoint.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { toErrorMessage } from \"../../core/shared/primitives.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { runClose, type CloseCommandOptions } from \"./close.js\";\nimport { runList, type ListOptions, type ListedItem } from \"./list.js\";\nimport { runRestore } from \"./restore.js\";\n\nconst CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;\nconst CLOSE_MANY_CHECKPOINT_SUBDIR = \"close-many\";\n\nconst CLOSE_MANY_FILTER_GUIDANCE = [\n  \"--filter-status\",\n  \"--filter-type\",\n  \"--filter-tag\",\n  \"--filter-priority\",\n  \"--filter-sprint\",\n  \"--filter-release\",\n  \"--filter-parent\",\n  \"--filter-assignee\",\n  \"--filter-updated-before\",\n  \"--ids\",\n].join(\", \");\n\nexport interface CloseManyCommandOptions {\n  status?: string;\n  list?: ListOptions;\n  reason?: string;\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  validateClose?: string;\n  author?: string;\n  message?: string;\n  force?: boolean;\n  dryRun?: boolean;\n  rollback?: string;\n  checkpoint?: boolean;\n}\n\ninterface CloseManyPlanRow {\n  id: string;\n  title: string;\n  status: string;\n  action: \"close\" | \"skip\";\n  skip_reason?: string;\n  active_child_ids?: string[];\n}\n\ninterface CloseManyApplyRow {\n  id: string;\n  status: \"closed\" | \"skipped\" | \"failed\";\n  skip_reason?: string;\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\nexport interface CloseManyResult {\n  mode: \"dry_run\" | \"apply\" | \"rollback\";\n  matched_count: number;\n  dry_run: boolean;\n  reason?: string;\n  filters?: Record<string, unknown>;\n  validate_close?: string;\n  item_plans?: CloseManyPlanRow[];\n  checkpoint?: {\n    id: string;\n    created_at: string;\n    path: string;\n    rollback_command: string;\n  };\n  closed_count?: number;\n  skipped_count?: number;\n  failed_count?: number;\n  restored_count?: number;\n  rollback_checkpoint_id?: string;\n  rows?: CloseManyApplyRow[] | Array<{ id: string; status: \"restored\" | \"failed\"; changed_fields?: string[]; warnings?: string[]; error?: string }>;\n  ids: string[];\n}\n\nfunction hasCloseManyFilters(list: ListOptions | undefined, status: string | undefined): boolean {\n  const isActive = (value: unknown): boolean =>\n    value != null && (typeof value !== \"string\" || value.split(\",\").some((entry) => entry.trim().length > 0));\n  return (\n    isActive(status) ||\n    isActive(list?.status) ||\n    isActive(list?.type) ||\n    isActive(list?.tag) ||\n    isActive(list?.priority) ||\n    isActive(list?.deadlineBefore) ||\n    isActive(list?.deadlineAfter) ||\n    isActive(list?.updatedAfter) ||\n    isActive(list?.updatedBefore) ||\n    isActive(list?.createdAfter) ||\n    isActive(list?.createdBefore) ||\n    isActive(list?.ids) ||\n    isActive(list?.assignee) ||\n    isActive(list?.assigneeFilter) ||\n    isActive(list?.parent) ||\n    isActive(list?.sprint) ||\n    isActive(list?.release)\n  );\n}\n\nfunction hasCloseManyRollbackConflicts(list: ListOptions | undefined, status: string | undefined): boolean {\n  return (\n    hasCloseManyFilters(list, status) ||\n    (list?.limit != null && String(list.limit).trim().length > 0) ||\n    (list?.offset != null && String(list.offset).trim().length > 0)\n  );\n}\n\nfunction rejectBlankIdsFilter(list: ListOptions | undefined): void {\n  if (list?.ids != null && String(list.ids).trim().length === 0) {\n    throw new PmCliError(\"--ids requires at least one non-empty item ID\", EXIT_CODE.USAGE);\n  }\n}\n\nfunction activeListOptions(list: ListOptions | undefined): ListOptions {\n  const active: ListOptions = {};\n  if (!list) {\n    return active;\n  }\n  for (const [key, value] of Object.entries(list) as Array<[keyof ListOptions, unknown]>) {\n    if (value == null || (typeof value === \"string\" && !value.split(\",\").some((entry) => entry.trim().length > 0))) {\n      continue;\n    }\n    (active as Record<string, unknown>)[key] = value;\n  }\n  return active;\n}\n\nfunction resolveReason(reason: unknown, required: boolean): string | undefined {\n  const trimmed = String(reason ?? \"\").trim();\n  if (trimmed.length > 0) {\n    return trimmed;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"pm close-many requires a shared close reason via --reason because governance.require_close_reason is enabled.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\n        examples: [\n          'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\"',\n          'pm close-many --ids pm-a,pm-b --reason \"Superseded by redesign\"',\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\n// Build a parent -> non-terminal child id map in a single light scan so each\n// matched parent can be annotated with the active children that closing it\n// would orphan (the same signal runClose surfaces per item on apply).\nasync function buildActiveChildrenByParent(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<{ childrenByParent: Map<string, string[]>; parentByChild: Map<string, string> }> {\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const childrenByParent = new Map<string, string[]>();\n  const parentByChild = new Map<string, string>();\n  for (const item of items) {\n    if (typeof item.parent !== \"string\" || item.parent.length === 0) {\n      continue;\n    }\n    parentByChild.set(item.id, item.parent);\n    if (isTerminalStatus(item.status, statusRegistry)) {\n      continue;\n    }\n    const existing = childrenByParent.get(item.parent);\n    if (existing) {\n      existing.push(item.id);\n    } else {\n      childrenByParent.set(item.parent, [item.id]);\n    }\n  }\n  for (const ids of childrenByParent.values()) {\n    ids.sort((left, right) => left.localeCompare(right));\n  }\n  return { childrenByParent, parentByChild };\n}\n\nfunction hierarchyDepth(id: string, parentByChild: Map<string, string>, cache?: Map<string, number>): number {\n  const cached = cache?.get(id);\n  if (cached !== undefined) {\n    return cached;\n  }\n  let depth = 0;\n  let current = parentByChild.get(id);\n  const path: string[] = [];\n  const visited = new Set<string>();\n  let hasCycle = false;\n  while (current !== undefined && !visited.has(current)) {\n    const cachedCurrent = cache?.get(current);\n    if (cachedCurrent !== undefined) {\n      depth += cachedCurrent + 1;\n      break;\n    }\n    visited.add(current);\n    path.push(current);\n    depth += 1;\n    current = parentByChild.get(current);\n  }\n  if (current !== undefined && visited.has(current)) {\n    hasCycle = true;\n  }\n  if (!hasCycle) {\n    cache?.set(id, depth);\n    for (const [index, ancestorId] of path.entries()) {\n      cache?.set(ancestorId, depth - index - 1);\n    }\n  }\n  return depth;\n}\n\nexport async function runCloseMany(options: CloseManyCommandOptions, global: GlobalOptions): Promise<CloseManyResult> {\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\n  const dryRun = options.dryRun === true;\n  const rollbackId = typeof options.rollback === \"string\" ? options.rollback : undefined;\n  rejectBlankIdsFilter(options.list);\n\n  if (rollbackId) {\n    if (dryRun) {\n      throw new PmCliError(\"--dry-run cannot be combined with --rollback\", EXIT_CODE.USAGE);\n    }\n    if (hasCloseManyRollbackConflicts(options.list, options.status)) {\n      throw new PmCliError(\"Rollback mode does not accept filter options\", EXIT_CODE.USAGE);\n    }\n    const checkpoint = await loadMutationCheckpoint(\n      pmRoot,\n      CLOSE_MANY_CHECKPOINT_SUBDIR,\n      rollbackId,\n      CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n    );\n    const restoreMessage = options.message ?? `Rollback close-many checkpoint ${checkpoint.id}`;\n    const rollback = await restoreCheckpointItems(checkpoint.items, (id, targetUpdatedAt) =>\n      runRestore(id, targetUpdatedAt, { author: options.author, message: restoreMessage, force: true }, global),\n    );\n    return {\n      mode: \"rollback\",\n      matched_count: checkpoint.items.length,\n      dry_run: false,\n      rollback_checkpoint_id: checkpoint.id,\n      checkpoint: {\n        id: checkpoint.id,\n        created_at: checkpoint.created_at,\n        path: checkpoint.path,\n        rollback_command: `pm close-many --rollback ${checkpoint.id}`,\n      },\n      restored_count: rollback.restored_ids.length,\n      failed_count: rollback.failed_count,\n      rows: rollback.rows,\n      ids: rollback.restored_ids,\n    };\n  }\n\n  if (!hasCloseManyFilters(options.list, options.status)) {\n    throw new PmCliError(\n      `close-many requires at least one filter to scope the close (for example: ${CLOSE_MANY_FILTER_GUIDANCE}). Refusing to match every item.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const reason = resolveReason(options.reason, settings.governance.require_close_reason);\n  const validateCloseMode = options.validateClose;\n  const force = options.force === true;\n\n  const listOptions = activeListOptions(options.list);\n  const listed = await runList(options.status, listOptions, global);\n  const { childrenByParent, parentByChild } = await buildActiveChildrenByParent(pmRoot, settings);\n  const depthCache = new Map<string, number>();\n  const matched = [...(listed.items as ListedItem[])].sort((left, right) => {\n    const depthDelta = hierarchyDepth(right.id, parentByChild, depthCache) - hierarchyDepth(left.id, parentByChild, depthCache);\n    return depthDelta !== 0 ? depthDelta : left.id.localeCompare(right.id);\n  });\n  const closePlannedIds = new Set(\n    matched\n      .filter((item) => force || !isTerminalStatus(item.status, statusRegistry))\n      .map((item) => item.id),\n  );\n\n  const planRows: CloseManyPlanRow[] = matched.map((item) => {\n    const alreadyTerminal = isTerminalStatus(item.status, statusRegistry);\n    const activeChildIds = (childrenByParent.get(item.id) ?? []).filter((childId) => !closePlannedIds.has(childId));\n    const willSkip = alreadyTerminal && !force;\n    return {\n      id: item.id,\n      title: typeof item.title === \"string\" ? item.title : \"\",\n      status: item.status,\n      action: willSkip ? \"skip\" : \"close\",\n      ...(willSkip ? { skip_reason: \"already_terminal\" } : {}),\n      ...(activeChildIds.length > 0 ? { active_child_ids: activeChildIds } : {}),\n    };\n  });\n\n  if (dryRun) {\n    return {\n      mode: \"dry_run\",\n      matched_count: matched.length,\n      dry_run: true,\n      ...(reason !== undefined ? { reason } : {}),\n      filters: listed.filters,\n      ...(validateCloseMode ? { validate_close: validateCloseMode } : {}),\n      item_plans: planRows,\n      ids: [],\n    };\n  }\n\n  const closableIds = new Set(planRows.filter((row) => row.action === \"close\").map((row) => row.id));\n\n  const nowValue = nowIso();\n  const checkpointId = createCheckpointId(CLOSE_MANY_CHECKPOINT_SUBDIR, nowValue);\n  const checkpointEnabled = options.checkpoint !== false;\n  let checkpointInfo: CloseManyResult[\"checkpoint\"] | undefined;\n  if (checkpointEnabled && closableIds.size > 0) {\n    const checkpointItems: MutationCheckpointItem[] = matched\n      .filter((item) => closableIds.has(item.id))\n      .map((item) => ({ id: item.id, target_updated_at: item.updated_at }));\n    const checkpointPath = await writeMutationCheckpoint(pmRoot, CLOSE_MANY_CHECKPOINT_SUBDIR, checkpointId, {\n      schema_version: CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION,\n      id: checkpointId,\n      created_at: nowValue,\n      author: resolveAuthor(options.author, \"unknown\"),\n      ...(reason !== undefined ? { reason } : {}),\n      filters: listed.filters,\n      items: checkpointItems,\n    });\n    checkpointInfo = {\n      id: checkpointId,\n      created_at: nowValue,\n      path: checkpointPath,\n      rollback_command: `pm close-many --rollback ${checkpointId}`,\n    };\n  }\n\n  const closeOptions: CloseCommandOptions = {\n    author: options.author,\n    message: options.message ?? `close-many apply ${checkpointId}`,\n    validateClose: validateCloseMode,\n    force,\n    resolution: options.resolution,\n    expectedResult: options.expectedResult,\n    actualResult: options.actualResult,\n  };\n\n  const rows: CloseManyApplyRow[] = [];\n  const closedIds: string[] = [];\n  for (const item of matched) {\n    if (!closableIds.has(item.id)) {\n      rows.push({ id: item.id, status: \"skipped\", skip_reason: \"already_terminal\" });\n      continue;\n    }\n    try {\n      const result = await runClose(item.id, reason, closeOptions, global);\n      rows.push({\n        id: item.id,\n        status: \"closed\",\n        changed_fields: result.changed_fields,\n        ...(result.warnings && result.warnings.length > 0 ? { warnings: result.warnings } : {}),\n      });\n      closedIds.push(item.id);\n    } catch (error: unknown) {\n      rows.push({ id: item.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n\n  return {\n    mode: \"apply\",\n    matched_count: matched.length,\n    dry_run: false,\n    ...(reason !== undefined ? { reason } : {}),\n    filters: listed.filters,\n    ...(validateCloseMode ? { validate_close: validateCloseMode } : {}),\n    ...(checkpointInfo ? { checkpoint: checkpointInfo } : {}),\n    closed_count: rows.filter((row) => row.status === \"closed\").length,\n    skipped_count: rows.filter((row) => row.status === \"skipped\").length,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n    rows,\n    ids: closedIds,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"60081a5b-37a0-5d2a-9e3e-0c94a5826738"}

package/dist/cli-bundle/chunks/{comments-QKBYCWKD.js → comments-JEO6HHVM.js}

@@ -1,21 +1,21 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-R6UFP2GE.js";
+} from "./chunk-V6EYFTRL.js";
 import "./chunk-O7IWB35H.js";
 import {
   createStdinTokenResolver
-} from "./chunk-XLTD2HN3.js";
-import "./chunk-WKY2IBOQ.js";
-import "./chunk-XTGLRY2Y.js";
-import "./chunk-T3LC5LKB.js";
-import "./chunk-AO442XLN.js";
-import "./chunk-KJE2FOS4.js";
-import "./chunk-QO7EBBOM.js";
+} from "./chunk-HV5SSZXF.js";
+import "./chunk-SFFVGNHC.js";
+import "./chunk-TP4DDY27.js";
+import "./chunk-2IXCHCLM.js";
+import "./chunk-WCQZBDDH.js";
+import "./chunk-HRMHZ4RV.js";
+import "./chunk-FHHBD7PN.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-UJUT6AHZ.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -100,4 +100,4 @@ async function runComments(id, options, global2) {
 export {
   runComments
 };
-//# sourceMappingURL=comments-QKBYCWKD.js.map
+//# sourceMappingURL=comments-JEO6HHVM.js.map

package/dist/cli-bundle/chunks/{comments-OONGABK5.js → comments-YT2PQ5DD.js}

@@ -3,21 +3,21 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-RWPSOIEE.js";
+} from "./chunk-GNIUOLZ2.js";
 import "./chunk-J27KIHTG.js";
 import {
   createStdinTokenResolver
-} from "./chunk-PO3GSVFV.js";
-import "./chunk-3VAM3NNM.js";
-import "./chunk-GGYWB3Y2.js";
-import "./chunk-HZGUAH22.js";
-import "./chunk-LB3RUL2N.js";
-import "./chunk-2VBQ6ZXS.js";
-import "./chunk-TCD3R2PF.js";
+} from "./chunk-UIIQC5YO.js";
+import "./chunk-FY6Z3FYY.js";
+import "./chunk-YBZW2QQ7.js";
+import "./chunk-UT6WFXW2.js";
+import "./chunk-UYQ7HXH4.js";
+import "./chunk-GUZBNB3G.js";
+import "./chunk-B2KZGPM2.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-X4IZKYHP.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -95,6 +95,6 @@ async function runComments(id, options, global) {
 export {
   runComments
 };
-//# sourceMappingURL=comments-OONGABK5.js.map
+//# sourceMappingURL=comments-YT2PQ5DD.js.map
 
 //# debugId=1e3f73a8-4331-568d-ab80-3e435948371c

package/dist/cli-bundle/chunks/{config-6FXCQKIF.js → config-RZRVS3ZV.js}

@@ -1,21 +1,21 @@
 
-!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]="16a22327-ab5b-5ab9-a4ac-aa5984fb0050")}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]="89cfb2b9-e002-55dd-871d-95addf25c0f3")}catch(e){}}();
 import {
   normalizeParentReferencePolicy,
   normalizeSprintReleaseFormatPolicy
-} from "./chunk-77GFDHGF.js";
+} from "./chunk-HLC3KTLP.js";
 import {
   migrateItemFilesToFormat
-} from "./chunk-RZN6VURO.js";
+} from "./chunk-C5W2UH56.js";
 import {
   buildInvalidTypeError
-} from "./chunk-6P6GGMOG.js";
-import "./chunk-LB3RUL2N.js";
+} from "./chunk-2IF7WLB7.js";
+import "./chunk-UYQ7HXH4.js";
 import {
   resolveItemTypeRegistry,
   resolveTypeName
-} from "./chunk-2VBQ6ZXS.js";
-import "./chunk-TCD3R2PF.js";
+} from "./chunk-GUZBNB3G.js";
+import "./chunk-B2KZGPM2.js";
 import {
   CONTEXT_DEPTH_VALUES,
   EXIT_CODE,
@@ -27,7 +27,7 @@ import {
   resolveGlobalPmRoot,
   resolvePmRoot,
   writeSettings
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-X4IZKYHP.js";
 
 // dist/core/config/positional-value.js
 var FORMAT_KEYS = /* @__PURE__ */ new Set(["item_format"]);
@@ -48,6 +48,7 @@ var POLICY_KEYS = /* @__PURE__ */ new Set([
   "governance_ownership_enforcement",
   "governance_create_mode_default",
   "governance_close_validation_default",
+  "governance_require_close_reason",
   "governance_create_default_type",
   "governance_workflow_enforcement",
   "governance_parent_reference_policy",
@@ -57,6 +58,7 @@ var POLICY_KEYS = /* @__PURE__ */ new Set([
   "telemetry_tracking"
 ]);
 var ENABLED_DISABLED_POLICY_KEYS = /* @__PURE__ */ new Set([
+  "governance_require_close_reason",
   "governance_force_required_for_stale_lock",
   "test_result_tracking",
   "telemetry_tracking"
@@ -119,12 +121,50 @@ var NESTED_SETTING_DESCRIPTORS = [
     choices: ["cache_only", "semantic_configured", "semantic_auto"],
     summary: "Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto."
   },
+  {
+    key: "search_query_expansion_enabled",
+    path: "search.query_expansion.enabled",
+    kind: "boolean",
+    summary: "Enable or disable query expansion for semantic/hybrid search."
+  },
+  {
+    key: "search_query_expansion_provider",
+    path: "search.query_expansion.provider",
+    kind: "string",
+    summary: "Query expansion provider name (built-in openai/ollama or extension provider)."
+  },
+  {
+    key: "search_rerank_enabled",
+    path: "search.rerank.enabled",
+    kind: "boolean",
+    summary: "Enable or disable post-retrieval reranking for hybrid search."
+  },
+  {
+    key: "search_rerank_model",
+    path: "search.rerank.model",
+    kind: "string",
+    summary: "Rerank model name override used by built-in providers."
+  },
+  {
+    key: "search_rerank_top_k",
+    path: "search.rerank.top_k",
+    kind: "integer",
+    min: 1,
+    summary: "Number of top hybrid candidates to rerank when rerank is enabled."
+  },
   {
     key: "search_embedding_model",
     path: "search.embedding_model",
     kind: "string",
     summary: "Default embedding model name (overrides provider-specific model when set)."
   },
+  {
+    key: "search_embedding_corpus_max_characters",
+    path: "search.embedding_corpus_max_characters",
+    kind: "integer",
+    min: 1,
+    summary: "Maximum semantic corpus characters per item before truncation."
+  },
   {
     key: "search_embedding_batch_size",
     path: "search.embedding_batch_size",
@@ -194,6 +234,13 @@ var NESTED_SETTING_DESCRIPTORS = [
     kind: "string",
     summary: "Vector store adapter name (lancedb, qdrant, or an extension adapter)."
   },
+  {
+    key: "vector_store_collection_name",
+    path: "vector_store.collection_name",
+    kind: "string",
+    non_empty: true,
+    summary: "Vector collection/table name shared by Qdrant and LanceDB adapters."
+  },
   {
     key: "qdrant_url",
     path: "vector_store.qdrant.url",
@@ -230,7 +277,28 @@ function parseNestedSettingValue(descriptor, rawValue) {
     return { ok: false, error: { message: `Config set ${descriptor.key} requires a string value` } };
   }
   const trimmed = rawValue.trim();
+  if (descriptor.kind === "boolean") {
+    const normalized = trimmed.toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
+      return { ok: true, parsed: { descriptor, value: true } };
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
+      return { ok: true, parsed: { descriptor, value: false } };
+    }
+    return {
+      ok: false,
+      error: {
+        message: `Config set ${descriptor.key} requires a boolean value (true|false), got "${rawValue}"`
+      }
+    };
+  }
   if (descriptor.kind === "string") {
+    if (descriptor.non_empty === true && trimmed.length === 0) {
+      return {
+        ok: false,
+        error: { message: `Config set ${descriptor.key} requires a non-empty value` }
+      };
+    }
     if (descriptor.choices && !descriptor.choices.includes(trimmed)) {
       return {
         ok: false,
@@ -297,7 +365,7 @@ function readNestedSettingValue(settings, descriptor) {
     }
     cursor = cursor[segment];
   }
-  if (typeof cursor === "string" || typeof cursor === "number") {
+  if (typeof cursor === "string" || typeof cursor === "number" || typeof cursor === "boolean") {
     return cursor;
   }
   return null;
@@ -358,6 +426,8 @@ var CONFIG_KEY_VALUES = [
   "governance_create_mode_default",
   "governance-close-validation-default",
   "governance_close_validation_default",
+  "governance-require-close-reason",
+  "governance_require_close_reason",
   "governance-create-default-type",
   "governance_create_default_type",
   "governance-workflow-enforcement",
@@ -405,6 +475,10 @@ var CONFIG_KEY_ALIASES = {
     "governance-close-validation-default",
     "governance_close_validation_default"
   ],
+  governance_require_close_reason: [
+    "governance-require-close-reason",
+    "governance_require_close_reason"
+  ],
   governance_create_default_type: ["governance-create-default-type", "governance_create_default_type"],
   governance_workflow_enforcement: ["governance-workflow-enforcement", "governance_workflow_enforcement"],
   governance_parent_reference_policy: ["governance-parent-reference-policy", "governance_parent_reference_policy"],
@@ -437,6 +511,7 @@ var CONFIG_KEY_SUMMARIES = {
   governance_ownership_enforcement: "Governance ownership enforcement policy (none|warn|strict).",
   governance_create_mode_default: "Governance default create mode (progressive|strict).",
   governance_close_validation_default: "Governance default close validation mode (off|warn|strict).",
+  governance_require_close_reason: "Governance close-reason requirement policy (enabled|disabled).",
   governance_create_default_type: "Governance default item type for `pm create` when --type is omitted.",
   governance_workflow_enforcement: "Governance per-type transition enforcement mode (off|warn|strict).",
   governance_parent_reference_policy: "Governance parent reference policy (warn|strict_error).",
@@ -511,6 +586,9 @@ function normalizeKey(value) {
     if (value === "governance-close-validation-default" || value === "governance_close_validation_default") {
       return "governance_close_validation_default";
     }
+    if (value === "governance-require-close-reason" || value === "governance_require_close_reason") {
+      return "governance_require_close_reason";
+    }
     if (value === "governance-create-default-type" || value === "governance_create_default_type") {
       return "governance_create_default_type";
     }
@@ -639,6 +717,13 @@ function normalizeGovernanceForceRequiredForStaleLockPolicy(value) {
   }
   throw new PmCliError("Config set governance-force-required-for-stale-lock requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
 }
+function normalizeGovernanceRequireCloseReasonPolicy(value) {
+  const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
+  if (normalized === "enabled" || normalized === "disabled") {
+    return normalized;
+  }
+  throw new PmCliError("Config set governance-require-close-reason requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
+}
 function normalizePolicyForConflict(key, value) {
   switch (key) {
     case "history_missing_stream_policy":
@@ -659,6 +744,8 @@ function normalizePolicyForConflict(key, value) {
       return normalizeGovernanceCreateModeDefault(value);
     case "governance_close_validation_default":
       return normalizeGovernanceCloseValidationDefault(value);
+    case "governance_require_close_reason":
+      return normalizeGovernanceRequireCloseReasonPolicy(value);
     case "governance_workflow_enforcement":
       return normalizeGovernanceWorkflowEnforcement(value);
     case "governance_force_required_for_stale_lock":
@@ -786,6 +873,9 @@ function readConfigValue(settings, key) {
   if (key === "governance_close_validation_default") {
     return settings.governance.close_validation_default;
   }
+  if (key === "governance_require_close_reason") {
+    return settings.governance.require_close_reason ? "enabled" : "disabled";
+  }
   if (key === "governance_create_default_type") {
     return settings.governance.create_default_type ?? "";
   }
@@ -1042,6 +1132,7 @@ async function runConfig(scopeValue, actionValue, keyValue, options, global, val
       governance_ownership_enforcement: readConfigValue(settings, "governance_ownership_enforcement"),
       governance_create_mode_default: readConfigValue(settings, "governance_create_mode_default"),
       governance_close_validation_default: readConfigValue(settings, "governance_close_validation_default"),
+      governance_require_close_reason: readConfigValue(settings, "governance_require_close_reason"),
       governance_create_default_type: readConfigValue(settings, "governance_create_default_type"),
       governance_workflow_enforcement: readConfigValue(settings, "governance_workflow_enforcement"),
       governance_parent_reference_policy: readConfigValue(settings, "governance_parent_reference_policy"),
@@ -1189,6 +1280,15 @@ async function runConfig(scopeValue, actionValue, keyValue, options, global, val
         changed: false
       }, warnings);
     }
+    if (key === "governance_require_close_reason") {
+      return withWarnings({
+        scope,
+        key,
+        policy: settings.governance.require_close_reason ? "enabled" : "disabled",
+        settings_path: target.settingsPath,
+        changed: false
+      }, warnings);
+    }
     if (key === "governance_create_default_type") {
       return withWarnings({
         scope,
@@ -1509,6 +1609,22 @@ async function runConfig(scopeValue, actionValue, keyValue, options, global, val
       changed: changed2
     }, warnings);
   }
+  if (key === "governance_require_close_reason") {
+    const nextPolicy = normalizeGovernanceRequireCloseReasonPolicy(options.policy);
+    const nextEnabled = nextPolicy === "enabled";
+    const changed2 = settings.governance.require_close_reason !== nextEnabled;
+    settings.governance.require_close_reason = nextEnabled;
+    if (changed2) {
+      await writeSettings(target.pmRoot, settings, "config:set:governance_require_close_reason");
+    }
+    return withWarnings({
+      scope,
+      key,
+      policy: settings.governance.require_close_reason ? "enabled" : "disabled",
+      settings_path: target.settingsPath,
+      changed: changed2
+    }, warnings);
+  }
   if (key === "governance_create_default_type") {
     const policyProvided = typeof options.policy === "string";
     const rawType = policyProvided ? options.policy.trim() : "";
@@ -1666,6 +1782,6 @@ async function runConfig(scopeValue, actionValue, keyValue, options, global, val
 export {
   runConfig
 };
-//# sourceMappingURL=config-6FXCQKIF.js.map
+//# sourceMappingURL=config-RZRVS3ZV.js.map
 
-//# debugId=16a22327-ab5b-5ab9-a4ac-aa5984fb0050
+//# debugId=89cfb2b9-e002-55dd-871d-95addf25c0f3