@unbrained/pm-cli 2026.7.5 → 2026.7.7

package/dist/cli-bundle/chunks/{chunk-K3AGVXSF.js → chunk-6LCJRGPD.js}

@@ -1,23 +1,19 @@
 
-!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]="0c02a002-ef0a-50f4-9165-676c2dcfcb8a")}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]="5249c38b-0c03-5818-a5d1-6f63742d0a73")}catch(e){}}();
 import {
   collectBlockedByIds
-} from "./chunk-N6DNM2FA.js";
+} from "./chunk-P3MJJW7P.js";
 import {
+  PmCliError,
   buildItemNotFoundError,
+  isTerminalStatus,
   listAllFrontMatterLight,
   locateItem,
   mutateItem,
   readLocatedItem,
+  readSettings,
   toItemRecord
-} from "./chunk-57C2RLW5.js";
-import {
-  isTerminalStatus
-} from "./chunk-HK72NWAD.js";
-import {
-  PmCliError,
-  readSettings
-} from "./chunk-US3T3W5J.js";
+} from "./chunk-GH73UOSJ.js";
 import {
   EXIT_CODE,
   getSettingsPath,
@@ -25,7 +21,7 @@ import {
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-YD5FML7K.js";
+} from "./chunk-UO7XAZK6.js";
 
 // dist/cli/commands/close.js
 function toAuthor(candidate, defaultAuthor) {
@@ -439,6 +435,6 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-K3AGVXSF.js.map
+//# sourceMappingURL=chunk-6LCJRGPD.js.map
 
-//# debugId=0c02a002-ef0a-50f4-9165-676c2dcfcb8a
+//# debugId=5249c38b-0c03-5818-a5d1-6f63742d0a73

package/dist/cli-bundle/chunks/{chunk-K3AGVXSF.js.map → chunk-6LCJRGPD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/close.ts"],"sourcesContent":["/**\n * @module cli/commands/close\n *\n * Implements the pm close command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { collectBlockedByIds } from \"../../core/item/actionability.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.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 {\n  buildItemNotFoundError,\n  listAllFrontMatterLight,\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\n\n/**\n * Documents the close command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n  // pm-fl0c #11 (2026-05-28): allow setting the three closure validation\n  // fields inline on `pm close` so agents do not have to issue a prior\n  // `pm update` just to satisfy --validate-close warn|strict. These map 1:1\n  // to ItemFrontMatter.{resolution,expected_result,actual_result}.\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  duplicateOf?: string;\n}\n\n/**\n * Documents the close result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\ninterface AutoUnblockCandidate {\n  id: string;\n  blocker_ids: string[];\n}\n\ntype CloseInlineFieldKey = \"resolution\" | \"expected_result\" | \"actual_result\";\n\ninterface CloseMutationContext {\n  statusRegistry: RuntimeStatusRegistry;\n  force: boolean | undefined;\n  options: CloseCommandOptions;\n  duplicateOf: string | undefined;\n  validateCloseMode: ValidateCloseMode;\n  activeChildIds: string[];\n  closeReason: string | undefined;\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 normalizeCloseReason(reasonText: string | undefined, required: boolean): string | undefined {\n  const reason = (reasonText ?? \"\").trim();\n  if (reason.length > 0) {\n    return reason;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"Close reason text is required because governance.require_close_reason is enabled\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a one-line closing summary as the positional text, --reason, or --message.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the item is done.\",\n        examples: [\n          'pm close <id> \"Done: <what changed and why>\"',\n          'pm close <id> --reason \"<closing summary>\"',\n          'pm close <id> -m \"<closing summary>\"',\n          \"pm close <id> --duplicate-of <canonical-id>\",\n        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\n          'When closing as a duplicate, --duplicate-of <id> auto-fills the close reason as \"Duplicate of <id>\".',\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\ninterface CloseReasonFallbackInput {\n  closeReasonText: string | undefined;\n  duplicateOf: string | undefined;\n  resolution: string | undefined;\n  message: string | undefined;\n  requireCloseReason: boolean;\n}\n\nfunction resolveEffectiveCloseReasonText(input: CloseReasonFallbackInput): string | undefined {\n  if ((input.closeReasonText ?? \"\").trim().length > 0) {\n    return input.closeReasonText;\n  }\n  if (input.duplicateOf !== undefined) {\n    return `Duplicate of ${input.duplicateOf}`;\n  }\n  const trimmedResolution = typeof input.resolution === \"string\" ? input.resolution.trim() : \"\";\n  if (trimmedResolution.length > 0) {\n    return trimmedResolution;\n  }\n  const trimmedMessage = typeof input.message === \"string\" ? input.message.trim() : \"\";\n  if (input.requireCloseReason && trimmedMessage.length > 0) {\n    return trimmedMessage;\n  }\n  return input.closeReasonText;\n}\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\nasync function duplicateChainReferencesClosingItem(\n  loadItemById: (id: string) => Promise<ItemFrontMatter | null>,\n  initialDuplicateOf: unknown,\n  closingId: string,\n): Promise<boolean> {\n  const visited = new Set<string>();\n  let current = initialDuplicateOf;\n  while (typeof current === \"string\" && current.trim().length > 0) {\n    const currentId = current.trim();\n    if (currentId === closingId) {\n      return true;\n    }\n    if (visited.has(currentId)) {\n      return false;\n    }\n    visited.add(currentId);\n    current = (await loadItemById(currentId))?.duplicate_of;\n  }\n  return false;\n}\n\nfunction shouldApplyDuplicateFallback(value: unknown): boolean {\n  return typeof value !== \"string\" || value.trim().length === 0;\n}\n\nasync function assertDuplicateTargetExists(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  duplicateOf: string | undefined,\n  closingId: string,\n): Promise<string | undefined> {\n  const rawTarget = duplicateOf?.trim();\n  if (!rawTarget) {\n    return undefined;\n  }\n  if (rawTarget === closingId) {\n    throw new PmCliError(\"An item cannot be closed as a duplicate of itself.\", EXIT_CODE.USAGE, {\n      code: \"duplicate_target_self\",\n      why: \"--duplicate-of must identify the canonical item that should remain open or already represent the work.\",\n    });\n  }\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const itemCache = new Map<string, ItemFrontMatter | null>();\n  const loadItemById = async (id: string): Promise<ItemFrontMatter | null> => {\n    if (itemCache.has(id)) {\n      return itemCache.get(id) ?? null;\n    }\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      itemCache.set(id, null);\n      return null;\n    }\n    const { document } = await readLocatedItem(located, { schema: settings.schema });\n    itemCache.set(id, document.metadata);\n    return document.metadata;\n  };\n  const target = await loadItemById(rawTarget);\n  if (!target) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_missing\",\n      why: \"Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${rawTarget}\" --duplicate-of ${rawTarget}`],\n      nextSteps: [\"Run pm search/list to find the canonical item, then retry with --duplicate-of <id>.\"],\n    });\n  }\n  if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {\n    throw new PmCliError(`Circular duplicate reference detected. Target \"${rawTarget}\" points back to \"${closingId}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_circular\",\n      why: \"Circular duplicate relationships create loops for dedupe and status propagation tooling.\",\n      nextSteps: [\"Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate.\"],\n    });\n  }\n  if (typeof target.duplicate_of === \"string\" && target.duplicate_of.trim().length > 0) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" is already marked as a duplicate of \"${target.duplicate_of.trim()}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_is_duplicate\",\n      why: \"Duplicate closure should point directly at the canonical item, not another duplicate.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${target.duplicate_of.trim()}\" --duplicate-of ${target.duplicate_of.trim()}`],\n      nextSteps: [\"Use the canonical item referenced by duplicate_of as the --duplicate-of target.\"],\n    });\n  }\n  return target.id;\n}\n\nasync function findActiveChildIds(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  parentId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  return items\n    .filter((item) => item.parent === parentId && !isTerminalStatus(item.status, statusRegistry))\n    .map((item) => item.id)\n    .sort((left, right) => left.localeCompare(right));\n}\n\nasync function findAutoUnblockCandidates(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<AutoUnblockCandidate[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const itemsById = new Map(items.map((item) => [item.id, item]));\n  const blockedStatuses = statusRegistry.blocked_statuses;\n  return items\n    .filter((item) => blockedStatuses.has(item.status))\n    .map((item) => ({ item, blockerIds: collectBlockedByIds(item) }))\n    .filter(({ blockerIds }) => blockerIds.includes(closedId))\n    .filter(({ blockerIds }) =>\n      blockerIds.every((blockerId) => {\n        const blocker = itemsById.get(blockerId);\n        return blocker !== undefined && isTerminalStatus(blocker.status, statusRegistry);\n      }),\n    )\n    .map(({ item, blockerIds }) => ({ id: item.id, blocker_ids: blockerIds }))\n    .sort((left, right) => left.id.localeCompare(right.id));\n}\n\nasync function autoUnblockResolvedDependents(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  author: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const candidates = await findAutoUnblockCandidates(pmRoot, settings, closedId, statusRegistry);\n  const warnings: string[] = [];\n  for (const candidate of candidates) {\n    try {\n      const unblocked = await mutateItem({\n        pmRoot,\n        settings,\n        id: candidate.id,\n        op: \"update\",\n        author,\n        message: `Auto-unblocked after blocker ${closedId} closed`,\n        mutate(document) {\n          /* c8 ignore start -- normal auto-unblock candidates carry dependency metadata; fallback preserves hand-edited scalar-only blockers. */\n          const dependencies = document.metadata.dependencies ?? [];\n          /* c8 ignore stop */\n          const remainingDependencies = dependencies.filter((dependency) => {\n            const dependencyId = dependency.id.trim();\n            return dependency.kind !== \"blocked_by\" || !candidate.blocker_ids.includes(dependencyId);\n          });\n          document.metadata.status = statusRegistry.open_status;\n          delete document.metadata.blocked_by;\n          delete document.metadata.blocked_reason;\n          document.metadata.unblock_note = `Auto-unblocked after blocker ${closedId} closed; all blockers resolved (${candidate.blocker_ids.join(\", \")}).`;\n          if (remainingDependencies.length > 0) {\n            document.metadata.dependencies = remainingDependencies;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          const changedFields = [\"status\", \"blocked_by\", \"blocked_reason\", \"unblock_note\"];\n          if (remainingDependencies.length !== dependencies.length) {\n            changedFields.push(\"dependencies\");\n          }\n          return {\n            changedFields,\n          };\n        },\n      });\n      warnings.push(`auto_unblocked:${unblocked.item.id}:resolved_blockers=${candidate.blocker_ids.join(\",\")}`);\n    /* c8 ignore start -- defensive fan-out failure path; normal lock/claim state is auditable and still unblocks. */\n    } catch (error) {\n      const reason = error instanceof Error ? error.message.replace(/\\s+/g, \" \").trim() : \"unknown\";\n      warnings.push(`auto_unblock_failed:${candidate.id}:${reason}`);\n    }\n    /* c8 ignore stop */\n  }\n  return warnings;\n}\n\nfunction applyInlineCloseFields(metadata: ItemFrontMatter, options: CloseCommandOptions): CloseInlineFieldKey[] {\n  const changedFields: CloseInlineFieldKey[] = [];\n  const inlineCloseFields: Array<{ option: string | undefined; key: CloseInlineFieldKey }> = [\n    { option: options.resolution, key: \"resolution\" },\n    { option: options.expectedResult, key: \"expected_result\" },\n    { option: options.actualResult, key: \"actual_result\" },\n  ];\n  for (const { option, key } of inlineCloseFields) {\n    if (typeof option !== \"string\") {\n      continue;\n    }\n    const trimmed = option.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    metadata[key] = trimmed;\n    changedFields.push(key);\n  }\n  return changedFields;\n}\n\nfunction applyDuplicateCloseMetadata(metadata: ItemFrontMatter, duplicateOf: string | undefined): CloseInlineFieldKey[] {\n  if (duplicateOf === undefined) {\n    return [];\n  }\n  metadata.duplicate_of = duplicateOf;\n  const duplicateFallbackFields: CloseInlineFieldKey[] = [];\n  const fallbackValues: Array<{ key: CloseInlineFieldKey; value: string }> = [\n    { key: \"resolution\", value: `Duplicate of ${duplicateOf}` },\n    { key: \"expected_result\", value: `Canonical item ${duplicateOf} tracks the work.` },\n    { key: \"actual_result\", value: `Closed as duplicate of ${duplicateOf}.` },\n  ];\n  for (const { key, value } of fallbackValues) {\n    if (shouldApplyDuplicateFallback(metadata[key])) {\n      metadata[key] = value;\n      duplicateFallbackFields.push(key);\n    }\n  }\n  return duplicateFallbackFields;\n}\n\nfunction collectCloseValidationWarnings(\n  metadata: ItemFrontMatter,\n  validateCloseMode: ValidateCloseMode,\n  activeChildIds: string[],\n): string[] {\n  const warnings: string[] = [];\n  if (validateCloseMode !== \"off\") {\n    const missingFields = findMissingCloseValidationFields(metadata);\n    if (missingFields.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_missing_fields:${metadata.id}:${missingFields.join(\",\")}`);\n    }\n    if (activeChildIds.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: active child items remain open (${activeChildIds.join(\", \")}). Close, cancel, or re-parent them first, or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n    }\n    return warnings;\n  }\n  if (activeChildIds.length > 0) {\n    warnings.push(`closed_with_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n  }\n  return warnings;\n}\n\nfunction applyCloseReason(metadata: ItemFrontMatter, closeReason: string | undefined): string[] {\n  if (closeReason !== undefined) {\n    metadata.close_reason = closeReason;\n    return [\"close_reason\"];\n  }\n  if (metadata.close_reason !== undefined) {\n    delete metadata.close_reason;\n    return [\"close_reason\"];\n  }\n  return [];\n}\n\nfunction clearCloseAssignee(metadata: ItemFrontMatter): string[] {\n  if (metadata.assignee === undefined) {\n    return [];\n  }\n  delete metadata.assignee;\n  return [\"assignee\"];\n}\n\nfunction clearClosedBlockerSignals(metadata: ItemFrontMatter): { changedFields: string[]; warnings: string[] } {\n  const previousBlockedBy = typeof metadata.blocked_by === \"string\" ? metadata.blocked_by.trim() : \"\";\n  const existingDeps = metadata.dependencies ?? [];\n  const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n  const hadBlockedReason = metadata.blocked_reason !== undefined;\n  if (previousBlockedBy.length === 0 && blockedByEdge === undefined && !hadBlockedReason) {\n    return { changedFields: [], warnings: [] };\n  }\n  const changedFields: string[] = [];\n  if (previousBlockedBy.length > 0) {\n    delete metadata.blocked_by;\n    changedFields.push(\"blocked_by\");\n  }\n  if (hadBlockedReason) {\n    delete metadata.blocked_reason;\n    changedFields.push(\"blocked_reason\");\n  }\n  if (blockedByEdge !== undefined) {\n    const remainingDeps = existingDeps.filter((dep) => dep.kind !== \"blocked_by\");\n    if (remainingDeps.length > 0) {\n      metadata.dependencies = remainingDeps;\n    } else {\n      delete metadata.dependencies;\n    }\n    changedFields.push(\"dependencies\");\n  }\n  // A stale reason-only close has no blocker identity; omit the blocker-clear warning instead of inventing one.\n  const reportedBlocker = previousBlockedBy || blockedByEdge?.id;\n  return {\n    changedFields,\n    warnings: reportedBlocker ? [`closed_cleared_blocked_by:${metadata.id}:${reportedBlocker}`] : [],\n  };\n}\n\nfunction mutateCloseMetadata(metadata: ItemFrontMatter, context: CloseMutationContext): { changedFields: string[]; warnings?: string[] } {\n  if (isTerminalStatus(metadata.status, context.statusRegistry) && !context.force) {\n    throw new PmCliError(`Item ${metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n  }\n  const inlineChangedFields = applyInlineCloseFields(metadata, context.options);\n  const duplicateFallbackFields = applyDuplicateCloseMetadata(metadata, context.duplicateOf);\n  const mutationWarnings = collectCloseValidationWarnings(metadata, context.validateCloseMode, context.activeChildIds);\n  metadata.status = context.statusRegistry.close_status;\n  const changedFields = [\n    \"status\",\n    ...applyCloseReason(metadata, context.closeReason),\n    ...inlineChangedFields,\n  ];\n  if (context.duplicateOf !== undefined) {\n    changedFields.push(\"duplicate_of\");\n    for (const key of duplicateFallbackFields) {\n      /* v8 ignore start -- duplicate fallback keys are already pre-deduped by applyDuplicateCloseMetadata in covered close paths */\n      if (!changedFields.includes(key)) {\n        changedFields.push(key);\n      }\n      /* v8 ignore stop */\n    }\n  }\n  changedFields.push(...clearCloseAssignee(metadata));\n  const blockerCleanup = clearClosedBlockerSignals(metadata);\n  changedFields.push(...blockerCleanup.changedFields);\n  mutationWarnings.push(...blockerCleanup.warnings);\n  return {\n    changedFields,\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport const _testOnlyCloseCommand = {\n  blockedByIds: collectBlockedByIds,\n};\n\n/**\n * Implements run close for the public runtime surface of this module.\n */\nexport async function runClose(\n  id: string,\n  closeReasonText: string | undefined,\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  // GH-250: verify the target item EXISTS before the governance close-reason\n  // gate fires. Otherwise closing a typo'd id with no reason reports\n  // \"Close reason text is required\" and hides the real cause (bad id) until a\n  // reason is supplied. Existence is the more fundamental precondition, so it\n  // is validated first regardless of whether a reason was provided.\n  const typeToFolder = resolveItemTypeRegistry(settings).type_to_folder;\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeToFolder);\n  }\n  // GH-204: resolve the duplicate target BEFORE reason validation so\n  // `pm close <id> --duplicate-of <canonical>` succeeds under\n  // governance.require_close_reason without a manual reason — when no\n  // positional/--reason text is provided the reason defaults to\n  // \"Duplicate of <id>\" (mirroring the auto-filled closure metadata).\n  // Explicit reason text still wins.\n  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);\n  // pm-7x8d / pm-9hry / GH-204: when no explicit positional/--reason text is given, derive\n  // the close reason from the next-best closure signal instead of hard-blocking\n  // under governance.require_close_reason. Precedence: explicit reason text >\n  // --duplicate-of (\"Duplicate of <id>\") > --resolution summary > --message.\n  // Resolution still writes metadata.resolution below; message still writes the\n  // history entry through mutateItem. Reusing either as the close reason just lets\n  // a single agent-authored close command succeed when it already supplied a\n  // closure summary through another structured option.\n  const effectiveCloseReasonText = resolveEffectiveCloseReasonText({\n    closeReasonText,\n    duplicateOf,\n    resolution: options.resolution,\n    message: options.message,\n    requireCloseReason: settings.governance.require_close_reason,\n  });\n  const closeReason = normalizeCloseReason(effectiveCloseReasonText, settings.governance.require_close_reason);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n  // C3 (pm-fu5d): scan for active children even under minimal governance so\n  // closing a parent is never silently orphaning — off mode emits an\n  // informational note instead of the warn/strict validation warning.\n  const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);\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      return mutateCloseMetadata(document.metadata, {\n        statusRegistry,\n        force: options.force,\n        options,\n        duplicateOf,\n        validateCloseMode,\n        activeChildIds,\n        closeReason,\n      });\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: [\n      ...result.warnings,\n      ...(await autoUnblockResolvedDependents(pmRoot, settings, located.id, author, statusRegistry)),\n    ],\n  };\n}\n"],"names":[],"mappings":"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","debugId":"0c02a002-ef0a-50f4-9165-676c2dcfcb8a"}
+{"version":3,"sources":["../../../../../../../../cli/commands/close.ts"],"sourcesContent":["/**\n * @module cli/commands/close\n *\n * Implements the pm close command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { collectBlockedByIds } from \"../../core/item/actionability.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.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 {\n  buildItemNotFoundError,\n  listAllFrontMatterLight,\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\n\n/**\n * Documents the close command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n  // pm-fl0c #11 (2026-05-28): allow setting the three closure validation\n  // fields inline on `pm close` so agents do not have to issue a prior\n  // `pm update` just to satisfy --validate-close warn|strict. These map 1:1\n  // to ItemFrontMatter.{resolution,expected_result,actual_result}.\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  duplicateOf?: string;\n}\n\n/**\n * Documents the close result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\ninterface AutoUnblockCandidate {\n  id: string;\n  blocker_ids: string[];\n}\n\ntype CloseInlineFieldKey = \"resolution\" | \"expected_result\" | \"actual_result\";\n\ninterface CloseMutationContext {\n  statusRegistry: RuntimeStatusRegistry;\n  force: boolean | undefined;\n  options: CloseCommandOptions;\n  duplicateOf: string | undefined;\n  validateCloseMode: ValidateCloseMode;\n  activeChildIds: string[];\n  closeReason: string | undefined;\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 normalizeCloseReason(reasonText: string | undefined, required: boolean): string | undefined {\n  const reason = (reasonText ?? \"\").trim();\n  if (reason.length > 0) {\n    return reason;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"Close reason text is required because governance.require_close_reason is enabled\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a one-line closing summary as the positional text, --reason, or --message.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the item is done.\",\n        examples: [\n          'pm close <id> \"Done: <what changed and why>\"',\n          'pm close <id> --reason \"<closing summary>\"',\n          'pm close <id> -m \"<closing summary>\"',\n          \"pm close <id> --duplicate-of <canonical-id>\",\n        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\n          'When closing as a duplicate, --duplicate-of <id> auto-fills the close reason as \"Duplicate of <id>\".',\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\ninterface CloseReasonFallbackInput {\n  closeReasonText: string | undefined;\n  duplicateOf: string | undefined;\n  resolution: string | undefined;\n  message: string | undefined;\n  requireCloseReason: boolean;\n}\n\nfunction resolveEffectiveCloseReasonText(input: CloseReasonFallbackInput): string | undefined {\n  if ((input.closeReasonText ?? \"\").trim().length > 0) {\n    return input.closeReasonText;\n  }\n  if (input.duplicateOf !== undefined) {\n    return `Duplicate of ${input.duplicateOf}`;\n  }\n  const trimmedResolution = typeof input.resolution === \"string\" ? input.resolution.trim() : \"\";\n  if (trimmedResolution.length > 0) {\n    return trimmedResolution;\n  }\n  const trimmedMessage = typeof input.message === \"string\" ? input.message.trim() : \"\";\n  if (input.requireCloseReason && trimmedMessage.length > 0) {\n    return trimmedMessage;\n  }\n  return input.closeReasonText;\n}\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\nasync function duplicateChainReferencesClosingItem(\n  loadItemById: (id: string) => Promise<ItemFrontMatter | null>,\n  initialDuplicateOf: unknown,\n  closingId: string,\n): Promise<boolean> {\n  const visited = new Set<string>();\n  let current = initialDuplicateOf;\n  while (typeof current === \"string\" && current.trim().length > 0) {\n    const currentId = current.trim();\n    if (currentId === closingId) {\n      return true;\n    }\n    if (visited.has(currentId)) {\n      return false;\n    }\n    visited.add(currentId);\n    current = (await loadItemById(currentId))?.duplicate_of;\n  }\n  return false;\n}\n\nfunction shouldApplyDuplicateFallback(value: unknown): boolean {\n  return typeof value !== \"string\" || value.trim().length === 0;\n}\n\nasync function assertDuplicateTargetExists(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  duplicateOf: string | undefined,\n  closingId: string,\n): Promise<string | undefined> {\n  const rawTarget = duplicateOf?.trim();\n  if (!rawTarget) {\n    return undefined;\n  }\n  if (rawTarget === closingId) {\n    throw new PmCliError(\"An item cannot be closed as a duplicate of itself.\", EXIT_CODE.USAGE, {\n      code: \"duplicate_target_self\",\n      why: \"--duplicate-of must identify the canonical item that should remain open or already represent the work.\",\n    });\n  }\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const itemCache = new Map<string, ItemFrontMatter | null>();\n  const loadItemById = async (id: string): Promise<ItemFrontMatter | null> => {\n    if (itemCache.has(id)) {\n      return itemCache.get(id) ?? null;\n    }\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      itemCache.set(id, null);\n      return null;\n    }\n    const { document } = await readLocatedItem(located, { schema: settings.schema });\n    itemCache.set(id, document.metadata);\n    return document.metadata;\n  };\n  const target = await loadItemById(rawTarget);\n  if (!target) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_missing\",\n      why: \"Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${rawTarget}\" --duplicate-of ${rawTarget}`],\n      nextSteps: [\"Run pm search/list to find the canonical item, then retry with --duplicate-of <id>.\"],\n    });\n  }\n  if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {\n    throw new PmCliError(`Circular duplicate reference detected. Target \"${rawTarget}\" points back to \"${closingId}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_circular\",\n      why: \"Circular duplicate relationships create loops for dedupe and status propagation tooling.\",\n      nextSteps: [\"Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate.\"],\n    });\n  }\n  if (typeof target.duplicate_of === \"string\" && target.duplicate_of.trim().length > 0) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" is already marked as a duplicate of \"${target.duplicate_of.trim()}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_is_duplicate\",\n      why: \"Duplicate closure should point directly at the canonical item, not another duplicate.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${target.duplicate_of.trim()}\" --duplicate-of ${target.duplicate_of.trim()}`],\n      nextSteps: [\"Use the canonical item referenced by duplicate_of as the --duplicate-of target.\"],\n    });\n  }\n  return target.id;\n}\n\nasync function findActiveChildIds(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  parentId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  return items\n    .filter((item) => item.parent === parentId && !isTerminalStatus(item.status, statusRegistry))\n    .map((item) => item.id)\n    .sort((left, right) => left.localeCompare(right));\n}\n\nasync function findAutoUnblockCandidates(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<AutoUnblockCandidate[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const itemsById = new Map(items.map((item) => [item.id, item]));\n  const blockedStatuses = statusRegistry.blocked_statuses;\n  return items\n    .filter((item) => blockedStatuses.has(item.status))\n    .map((item) => ({ item, blockerIds: collectBlockedByIds(item) }))\n    .filter(({ blockerIds }) => blockerIds.includes(closedId))\n    .filter(({ blockerIds }) =>\n      blockerIds.every((blockerId) => {\n        const blocker = itemsById.get(blockerId);\n        return blocker !== undefined && isTerminalStatus(blocker.status, statusRegistry);\n      }),\n    )\n    .map(({ item, blockerIds }) => ({ id: item.id, blocker_ids: blockerIds }))\n    .sort((left, right) => left.id.localeCompare(right.id));\n}\n\nasync function autoUnblockResolvedDependents(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  author: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const candidates = await findAutoUnblockCandidates(pmRoot, settings, closedId, statusRegistry);\n  const warnings: string[] = [];\n  for (const candidate of candidates) {\n    try {\n      const unblocked = await mutateItem({\n        pmRoot,\n        settings,\n        id: candidate.id,\n        op: \"update\",\n        author,\n        message: `Auto-unblocked after blocker ${closedId} closed`,\n        mutate(document) {\n          /* c8 ignore start -- normal auto-unblock candidates carry dependency metadata; fallback preserves hand-edited scalar-only blockers. */\n          const dependencies = document.metadata.dependencies ?? [];\n          /* c8 ignore stop */\n          const remainingDependencies = dependencies.filter((dependency) => {\n            const dependencyId = dependency.id.trim();\n            return dependency.kind !== \"blocked_by\" || !candidate.blocker_ids.includes(dependencyId);\n          });\n          document.metadata.status = statusRegistry.open_status;\n          delete document.metadata.blocked_by;\n          delete document.metadata.blocked_reason;\n          document.metadata.unblock_note = `Auto-unblocked after blocker ${closedId} closed; all blockers resolved (${candidate.blocker_ids.join(\", \")}).`;\n          if (remainingDependencies.length > 0) {\n            document.metadata.dependencies = remainingDependencies;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          const changedFields = [\"status\", \"blocked_by\", \"blocked_reason\", \"unblock_note\"];\n          if (remainingDependencies.length !== dependencies.length) {\n            changedFields.push(\"dependencies\");\n          }\n          return {\n            changedFields,\n          };\n        },\n      });\n      warnings.push(`auto_unblocked:${unblocked.item.id}:resolved_blockers=${candidate.blocker_ids.join(\",\")}`);\n    /* c8 ignore start -- defensive fan-out failure path; normal lock/claim state is auditable and still unblocks. */\n    } catch (error) {\n      const reason = error instanceof Error ? error.message.replace(/\\s+/g, \" \").trim() : \"unknown\";\n      warnings.push(`auto_unblock_failed:${candidate.id}:${reason}`);\n    }\n    /* c8 ignore stop */\n  }\n  return warnings;\n}\n\nfunction applyInlineCloseFields(metadata: ItemFrontMatter, options: CloseCommandOptions): CloseInlineFieldKey[] {\n  const changedFields: CloseInlineFieldKey[] = [];\n  const inlineCloseFields: Array<{ option: string | undefined; key: CloseInlineFieldKey }> = [\n    { option: options.resolution, key: \"resolution\" },\n    { option: options.expectedResult, key: \"expected_result\" },\n    { option: options.actualResult, key: \"actual_result\" },\n  ];\n  for (const { option, key } of inlineCloseFields) {\n    if (typeof option !== \"string\") {\n      continue;\n    }\n    const trimmed = option.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    metadata[key] = trimmed;\n    changedFields.push(key);\n  }\n  return changedFields;\n}\n\nfunction applyDuplicateCloseMetadata(metadata: ItemFrontMatter, duplicateOf: string | undefined): CloseInlineFieldKey[] {\n  if (duplicateOf === undefined) {\n    return [];\n  }\n  metadata.duplicate_of = duplicateOf;\n  const duplicateFallbackFields: CloseInlineFieldKey[] = [];\n  const fallbackValues: Array<{ key: CloseInlineFieldKey; value: string }> = [\n    { key: \"resolution\", value: `Duplicate of ${duplicateOf}` },\n    { key: \"expected_result\", value: `Canonical item ${duplicateOf} tracks the work.` },\n    { key: \"actual_result\", value: `Closed as duplicate of ${duplicateOf}.` },\n  ];\n  for (const { key, value } of fallbackValues) {\n    if (shouldApplyDuplicateFallback(metadata[key])) {\n      metadata[key] = value;\n      duplicateFallbackFields.push(key);\n    }\n  }\n  return duplicateFallbackFields;\n}\n\nfunction collectCloseValidationWarnings(\n  metadata: ItemFrontMatter,\n  validateCloseMode: ValidateCloseMode,\n  activeChildIds: string[],\n): string[] {\n  const warnings: string[] = [];\n  if (validateCloseMode !== \"off\") {\n    const missingFields = findMissingCloseValidationFields(metadata);\n    if (missingFields.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_missing_fields:${metadata.id}:${missingFields.join(\",\")}`);\n    }\n    if (activeChildIds.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: active child items remain open (${activeChildIds.join(\", \")}). Close, cancel, or re-parent them first, or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n    }\n    return warnings;\n  }\n  if (activeChildIds.length > 0) {\n    warnings.push(`closed_with_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n  }\n  return warnings;\n}\n\nfunction applyCloseReason(metadata: ItemFrontMatter, closeReason: string | undefined): string[] {\n  if (closeReason !== undefined) {\n    metadata.close_reason = closeReason;\n    return [\"close_reason\"];\n  }\n  if (metadata.close_reason !== undefined) {\n    delete metadata.close_reason;\n    return [\"close_reason\"];\n  }\n  return [];\n}\n\nfunction clearCloseAssignee(metadata: ItemFrontMatter): string[] {\n  if (metadata.assignee === undefined) {\n    return [];\n  }\n  delete metadata.assignee;\n  return [\"assignee\"];\n}\n\nfunction clearClosedBlockerSignals(metadata: ItemFrontMatter): { changedFields: string[]; warnings: string[] } {\n  const previousBlockedBy = typeof metadata.blocked_by === \"string\" ? metadata.blocked_by.trim() : \"\";\n  const existingDeps = metadata.dependencies ?? [];\n  const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n  const hadBlockedReason = metadata.blocked_reason !== undefined;\n  if (previousBlockedBy.length === 0 && blockedByEdge === undefined && !hadBlockedReason) {\n    return { changedFields: [], warnings: [] };\n  }\n  const changedFields: string[] = [];\n  if (previousBlockedBy.length > 0) {\n    delete metadata.blocked_by;\n    changedFields.push(\"blocked_by\");\n  }\n  if (hadBlockedReason) {\n    delete metadata.blocked_reason;\n    changedFields.push(\"blocked_reason\");\n  }\n  if (blockedByEdge !== undefined) {\n    const remainingDeps = existingDeps.filter((dep) => dep.kind !== \"blocked_by\");\n    if (remainingDeps.length > 0) {\n      metadata.dependencies = remainingDeps;\n    } else {\n      delete metadata.dependencies;\n    }\n    changedFields.push(\"dependencies\");\n  }\n  // A stale reason-only close has no blocker identity; omit the blocker-clear warning instead of inventing one.\n  const reportedBlocker = previousBlockedBy || blockedByEdge?.id;\n  return {\n    changedFields,\n    warnings: reportedBlocker ? [`closed_cleared_blocked_by:${metadata.id}:${reportedBlocker}`] : [],\n  };\n}\n\nfunction mutateCloseMetadata(metadata: ItemFrontMatter, context: CloseMutationContext): { changedFields: string[]; warnings?: string[] } {\n  if (isTerminalStatus(metadata.status, context.statusRegistry) && !context.force) {\n    throw new PmCliError(`Item ${metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n  }\n  const inlineChangedFields = applyInlineCloseFields(metadata, context.options);\n  const duplicateFallbackFields = applyDuplicateCloseMetadata(metadata, context.duplicateOf);\n  const mutationWarnings = collectCloseValidationWarnings(metadata, context.validateCloseMode, context.activeChildIds);\n  metadata.status = context.statusRegistry.close_status;\n  const changedFields = [\n    \"status\",\n    ...applyCloseReason(metadata, context.closeReason),\n    ...inlineChangedFields,\n  ];\n  if (context.duplicateOf !== undefined) {\n    changedFields.push(\"duplicate_of\");\n    for (const key of duplicateFallbackFields) {\n      /* v8 ignore start -- duplicate fallback keys are already pre-deduped by applyDuplicateCloseMetadata in covered close paths */\n      if (!changedFields.includes(key)) {\n        changedFields.push(key);\n      }\n      /* v8 ignore stop */\n    }\n  }\n  changedFields.push(...clearCloseAssignee(metadata));\n  const blockerCleanup = clearClosedBlockerSignals(metadata);\n  changedFields.push(...blockerCleanup.changedFields);\n  mutationWarnings.push(...blockerCleanup.warnings);\n  return {\n    changedFields,\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport const _testOnlyCloseCommand = {\n  blockedByIds: collectBlockedByIds,\n};\n\n/**\n * Implements run close for the public runtime surface of this module.\n */\nexport async function runClose(\n  id: string,\n  closeReasonText: string | undefined,\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  // GH-250: verify the target item EXISTS before the governance close-reason\n  // gate fires. Otherwise closing a typo'd id with no reason reports\n  // \"Close reason text is required\" and hides the real cause (bad id) until a\n  // reason is supplied. Existence is the more fundamental precondition, so it\n  // is validated first regardless of whether a reason was provided.\n  const typeToFolder = resolveItemTypeRegistry(settings).type_to_folder;\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeToFolder);\n  }\n  // GH-204: resolve the duplicate target BEFORE reason validation so\n  // `pm close <id> --duplicate-of <canonical>` succeeds under\n  // governance.require_close_reason without a manual reason — when no\n  // positional/--reason text is provided the reason defaults to\n  // \"Duplicate of <id>\" (mirroring the auto-filled closure metadata).\n  // Explicit reason text still wins.\n  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);\n  // pm-7x8d / pm-9hry / GH-204: when no explicit positional/--reason text is given, derive\n  // the close reason from the next-best closure signal instead of hard-blocking\n  // under governance.require_close_reason. Precedence: explicit reason text >\n  // --duplicate-of (\"Duplicate of <id>\") > --resolution summary > --message.\n  // Resolution still writes metadata.resolution below; message still writes the\n  // history entry through mutateItem. Reusing either as the close reason just lets\n  // a single agent-authored close command succeed when it already supplied a\n  // closure summary through another structured option.\n  const effectiveCloseReasonText = resolveEffectiveCloseReasonText({\n    closeReasonText,\n    duplicateOf,\n    resolution: options.resolution,\n    message: options.message,\n    requireCloseReason: settings.governance.require_close_reason,\n  });\n  const closeReason = normalizeCloseReason(effectiveCloseReasonText, settings.governance.require_close_reason);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n  // C3 (pm-fu5d): scan for active children even under minimal governance so\n  // closing a parent is never silently orphaning — off mode emits an\n  // informational note instead of the warn/strict validation warning.\n  const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);\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      return mutateCloseMetadata(document.metadata, {\n        statusRegistry,\n        force: options.force,\n        options,\n        duplicateOf,\n        validateCloseMode,\n        activeChildIds,\n        closeReason,\n      });\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: [\n      ...result.warnings,\n      ...(await autoUnblockResolvedDependents(pmRoot, settings, located.id, author, statusRegistry)),\n    ],\n  };\n}\n"],"names":[],"mappings":"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","debugId":"5249c38b-0c03-5818-a5d1-6f63742d0a73"}

package/dist/cli-bundle/chunks/{chunk-7MDXZAZS.js → chunk-6UQCNWFV.js}

@@ -1,14 +1,12 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="377e5452-9452-5178-b4ae-182fb89455c0")}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]="e5aa93b8-d63d-557c-9183-bbd636aa5dee")}catch(e){}}();
 import {
+  PmCliError,
   normalizeItemId
-} from "./chunk-HK72NWAD.js";
-import {
-  PmCliError
-} from "./chunk-US3T3W5J.js";
+} from "./chunk-GH73UOSJ.js";
 import {
   EXIT_CODE
-} from "./chunk-YD5FML7K.js";
+} from "./chunk-UO7XAZK6.js";
 
 // dist/core/item/parent-reference-policy.js
 var PLACEHOLDER_REFERENCE_TOKENS = /* @__PURE__ */ new Set(["none", "null", "undefined"]);
@@ -97,6 +95,6 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-7MDXZAZS.js.map
+//# sourceMappingURL=chunk-6UQCNWFV.js.map
 
-//# debugId=377e5452-9452-5178-b4ae-182fb89455c0
+//# debugId=e5aa93b8-d63d-557c-9183-bbd636aa5dee

package/dist/cli-bundle/chunks/{chunk-7MDXZAZS.js.map → chunk-6UQCNWFV.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../core/item/parent-reference-policy.ts","../../../../../../../../core/item/sprint-release-format.ts"],"sourcesContent":["/**\n * @module core/item/parent-reference-policy\n *\n * Defines item parsing, formatting, and lifecycle helpers for Parent Reference Policy.\n */\nimport type { ParentReferencePolicy } from \"../../types/index.js\";\nimport { normalizeItemId } from \"./id.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst PLACEHOLDER_REFERENCE_TOKENS = new Set([\"none\", \"null\", \"undefined\"]);\n\n/**\n * Implements normalize parent reference policy for the public runtime surface of this module.\n */\nexport function normalizeParentReferencePolicy(value: string | undefined): ParentReferencePolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\n/**\n * Implements normalize parent reference value for the public runtime surface of this module.\n */\nexport function normalizeParentReferenceValue(rawValue: unknown): string {\n  if (typeof rawValue !== \"string\") {\n    throw new PmCliError(\"--parent must be a string. Use --unset parent to clear this field.\", EXIT_CODE.USAGE);\n  }\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(\"--parent must not be empty. Use --parent none to unset.\", EXIT_CODE.USAGE);\n  }\n  if (isPlaceholderReferenceToken(value)) {\n    throw new PmCliError(\n      `--parent must not use placeholder token \"${value}\". Use --unset parent to clear this field.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/**\n * Detects parent-style placeholder tokens that should never become stored ids.\n */\nexport function isPlaceholderReferenceToken(value: string): boolean {\n  return PLACEHOLDER_REFERENCE_TOKENS.has(value.trim().toLowerCase());\n}\n\n/**\n * Implements validate missing parent reference for the public runtime surface of this module.\n */\nexport function validateMissingParentReference(\n  parentId: string,\n  policy: ParentReferencePolicy,\n): { warnings: string[] } {\n  if (policy === \"strict_error\") {\n    throw new PmCliError(\n      `Parent item \"${parentId}\" was not found. Create it first or use --parent none.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    warnings: [`validation_warning:parent_reference_missing:${parentId}`],\n  };\n}\n\n/**\n * Rejects the one-node hierarchy cycle where an item points at itself.\n */\nexport function assertParentReferenceIsNotSelf(itemId: string, parentId: string, prefix: string): void {\n  const normalizedItemId = normalizeItemId(itemId, prefix);\n  const normalizedParentId = normalizeItemId(parentId, prefix);\n  if (normalizedItemId !== normalizedParentId) {\n    return;\n  }\n  const normalizationDetail =\n    parentId !== normalizedParentId || itemId !== normalizedItemId\n      ? ` (normalized from parent \"${parentId}\" and item \"${itemId}\")`\n      : \"\";\n  throw new PmCliError(\n    `Parent item \"${normalizedParentId}\" cannot be the same as item \"${normalizedItemId}\"${normalizationDetail}. Use --unset parent to clear this field.`,\n    EXIT_CODE.USAGE,\n  );\n}\n","/**\n * @module core/item/sprint-release-format\n *\n * Defines item parsing, formatting, and lifecycle helpers for Sprint Release Format.\n */\nimport type { SprintReleaseFormatPolicy } from \"../../types/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst SPRINT_RELEASE_VALUE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;\nconst SPRINT_RELEASE_MAX_LENGTH = 64;\n\n/**\n * Implements normalize sprint release format policy for the public runtime surface of this module.\n */\nexport function normalizeSprintReleaseFormatPolicy(value: string | undefined): SprintReleaseFormatPolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set sprint-release-format-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\n/**\n * Implements validate sprint or release value for the public runtime surface of this module.\n */\nexport function validateSprintOrReleaseValue(\n  field: \"sprint\" | \"release\",\n  rawValue: string,\n  policy: SprintReleaseFormatPolicy,\n): { value: string; warnings: string[] } {\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(`--${field} must not be empty. Use --${field} none to unset.`, EXIT_CODE.USAGE);\n  }\n  const isValid = value.length <= SPRINT_RELEASE_MAX_LENGTH && SPRINT_RELEASE_VALUE_PATTERN.test(value);\n  if (isValid) {\n    return { value, warnings: [] };\n  }\n  const guidance = \"Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._/-]* (no spaces).\";\n  if (policy === \"strict_error\") {\n    throw new PmCliError(`Invalid --${field} value \"${value}\". ${guidance}`, EXIT_CODE.USAGE);\n  }\n  return {\n    value,\n    warnings: [`validation_warning:${field}_format:${value}`],\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAUA,IAAM,+BAA+B,oBAAI,IAAI,CAAC,QAAQ,QAAQ,WAAW,CAAC;AAKpE,SAAU,+BAA+B,OAAyB;AACtE,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,wGACA,UAAU,KAAK;AAEnB;AAKM,SAAU,8BAA8B,UAAiB;AAC7D,MAAI,OAAO,aAAa,UAAU;AAChC,UAAM,IAAI,WAAW,sEAAsE,UAAU,KAAK;EAC5G;AACA,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,2DAA2D,UAAU,KAAK;EACjG;AACA,MAAI,4BAA4B,KAAK,GAAG;AACtC,UAAM,IAAI,WACR,4CAA4C,KAAK,8CACjD,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAKM,SAAU,4BAA4B,OAAa;AACvD,SAAO,6BAA6B,IAAI,MAAM,KAAI,EAAG,YAAW,CAAE;AACpE;AAKM,SAAU,+BACd,UACA,QAA6B;AAE7B,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WACR,gBAAgB,QAAQ,0DACxB,UAAU,KAAK;EAEnB;AACA,SAAO;IACL,UAAU,CAAC,+CAA+C,QAAQ,EAAE;;AAExE;AAKM,SAAU,+BAA+B,QAAgB,UAAkB,QAAc;AAC7F,QAAM,mBAAmB,gBAAgB,QAAQ,MAAM;AACvD,QAAM,qBAAqB,gBAAgB,UAAU,MAAM;AAC3D,MAAI,qBAAqB,oBAAoB;AAC3C;EACF;AACA,QAAM,sBACJ,aAAa,sBAAsB,WAAW,mBAC1C,6BAA6B,QAAQ,eAAe,MAAM,OAC1D;AACN,QAAM,IAAI,WACR,gBAAgB,kBAAkB,iCAAiC,gBAAgB,IAAI,mBAAmB,6CAC1G,UAAU,KAAK;AAEnB;;;AClFA,IAAM,+BAA+B;AACrC,IAAM,4BAA4B;AAK5B,SAAU,mCAAmC,OAAyB;AAC1E,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,6GACA,UAAU,KAAK;AAEnB;AAKM,SAAU,6BACd,OACA,UACA,QAAiC;AAEjC,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,KAAK,KAAK,6BAA6B,KAAK,mBAAmB,UAAU,KAAK;EACrG;AACA,QAAM,UAAU,MAAM,UAAU,6BAA6B,6BAA6B,KAAK,KAAK;AACpG,MAAI,SAAS;AACX,WAAO,EAAE,OAAO,UAAU,CAAA,EAAE;EAC9B;AACA,QAAM,WAAW;AACjB,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WAAW,aAAa,KAAK,WAAW,KAAK,MAAM,QAAQ,IAAI,UAAU,KAAK;EAC1F;AACA,SAAO;IACL;IACA,UAAU,CAAC,sBAAsB,KAAK,WAAW,KAAK,EAAE;;AAE5D","debugId":"377e5452-9452-5178-b4ae-182fb89455c0"}
+{"version":3,"sources":["../../../../../../../../core/item/parent-reference-policy.ts","../../../../../../../../core/item/sprint-release-format.ts"],"sourcesContent":["/**\n * @module core/item/parent-reference-policy\n *\n * Defines item parsing, formatting, and lifecycle helpers for Parent Reference Policy.\n */\nimport type { ParentReferencePolicy } from \"../../types/index.js\";\nimport { normalizeItemId } from \"./id.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst PLACEHOLDER_REFERENCE_TOKENS = new Set([\"none\", \"null\", \"undefined\"]);\n\n/**\n * Implements normalize parent reference policy for the public runtime surface of this module.\n */\nexport function normalizeParentReferencePolicy(value: string | undefined): ParentReferencePolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set parent-reference-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\n/**\n * Implements normalize parent reference value for the public runtime surface of this module.\n */\nexport function normalizeParentReferenceValue(rawValue: unknown): string {\n  if (typeof rawValue !== \"string\") {\n    throw new PmCliError(\"--parent must be a string. Use --unset parent to clear this field.\", EXIT_CODE.USAGE);\n  }\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(\"--parent must not be empty. Use --parent none to unset.\", EXIT_CODE.USAGE);\n  }\n  if (isPlaceholderReferenceToken(value)) {\n    throw new PmCliError(\n      `--parent must not use placeholder token \"${value}\". Use --unset parent to clear this field.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\n/**\n * Detects parent-style placeholder tokens that should never become stored ids.\n */\nexport function isPlaceholderReferenceToken(value: string): boolean {\n  return PLACEHOLDER_REFERENCE_TOKENS.has(value.trim().toLowerCase());\n}\n\n/**\n * Implements validate missing parent reference for the public runtime surface of this module.\n */\nexport function validateMissingParentReference(\n  parentId: string,\n  policy: ParentReferencePolicy,\n): { warnings: string[] } {\n  if (policy === \"strict_error\") {\n    throw new PmCliError(\n      `Parent item \"${parentId}\" was not found. Create it first or use --parent none.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    warnings: [`validation_warning:parent_reference_missing:${parentId}`],\n  };\n}\n\n/**\n * Rejects the one-node hierarchy cycle where an item points at itself.\n */\nexport function assertParentReferenceIsNotSelf(itemId: string, parentId: string, prefix: string): void {\n  const normalizedItemId = normalizeItemId(itemId, prefix);\n  const normalizedParentId = normalizeItemId(parentId, prefix);\n  if (normalizedItemId !== normalizedParentId) {\n    return;\n  }\n  const normalizationDetail =\n    parentId !== normalizedParentId || itemId !== normalizedItemId\n      ? ` (normalized from parent \"${parentId}\" and item \"${itemId}\")`\n      : \"\";\n  throw new PmCliError(\n    `Parent item \"${normalizedParentId}\" cannot be the same as item \"${normalizedItemId}\"${normalizationDetail}. Use --unset parent to clear this field.`,\n    EXIT_CODE.USAGE,\n  );\n}\n","/**\n * @module core/item/sprint-release-format\n *\n * Defines item parsing, formatting, and lifecycle helpers for Sprint Release Format.\n */\nimport type { SprintReleaseFormatPolicy } from \"../../types/index.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst SPRINT_RELEASE_VALUE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;\nconst SPRINT_RELEASE_MAX_LENGTH = 64;\n\n/**\n * Implements normalize sprint release format policy for the public runtime surface of this module.\n */\nexport function normalizeSprintReleaseFormatPolicy(value: string | undefined): SprintReleaseFormatPolicy {\n  const normalized = value?.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (normalized === \"warn\" || normalized === \"strict_error\") {\n    return normalized;\n  }\n  if (normalized === \"strict\") {\n    return \"strict_error\";\n  }\n  throw new PmCliError(\n    \"Config set sprint-release-format-policy requires --policy with one of: warn, strict_error (alias: strict)\",\n    EXIT_CODE.USAGE,\n  );\n}\n\n/**\n * Implements validate sprint or release value for the public runtime surface of this module.\n */\nexport function validateSprintOrReleaseValue(\n  field: \"sprint\" | \"release\",\n  rawValue: string,\n  policy: SprintReleaseFormatPolicy,\n): { value: string; warnings: string[] } {\n  const value = rawValue.trim();\n  if (value.length === 0) {\n    throw new PmCliError(`--${field} must not be empty. Use --${field} none to unset.`, EXIT_CODE.USAGE);\n  }\n  const isValid = value.length <= SPRINT_RELEASE_MAX_LENGTH && SPRINT_RELEASE_VALUE_PATTERN.test(value);\n  if (isValid) {\n    return { value, warnings: [] };\n  }\n  const guidance = \"Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._/-]* (no spaces).\";\n  if (policy === \"strict_error\") {\n    throw new PmCliError(`Invalid --${field} value \"${value}\". ${guidance}`, EXIT_CODE.USAGE);\n  }\n  return {\n    value,\n    warnings: [`validation_warning:${field}_format:${value}`],\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAUA,IAAM,+BAA+B,oBAAI,IAAI,CAAC,QAAQ,QAAQ,WAAW,CAAC;AAKpE,SAAU,+BAA+B,OAAyB;AACtE,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,wGACA,UAAU,KAAK;AAEnB;AAKM,SAAU,8BAA8B,UAAiB;AAC7D,MAAI,OAAO,aAAa,UAAU;AAChC,UAAM,IAAI,WAAW,sEAAsE,UAAU,KAAK;EAC5G;AACA,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,2DAA2D,UAAU,KAAK;EACjG;AACA,MAAI,4BAA4B,KAAK,GAAG;AACtC,UAAM,IAAI,WACR,4CAA4C,KAAK,8CACjD,UAAU,KAAK;EAEnB;AACA,SAAO;AACT;AAKM,SAAU,4BAA4B,OAAa;AACvD,SAAO,6BAA6B,IAAI,MAAM,KAAI,EAAG,YAAW,CAAE;AACpE;AAKM,SAAU,+BACd,UACA,QAA6B;AAE7B,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WACR,gBAAgB,QAAQ,0DACxB,UAAU,KAAK;EAEnB;AACA,SAAO;IACL,UAAU,CAAC,+CAA+C,QAAQ,EAAE;;AAExE;AAKM,SAAU,+BAA+B,QAAgB,UAAkB,QAAc;AAC7F,QAAM,mBAAmB,gBAAgB,QAAQ,MAAM;AACvD,QAAM,qBAAqB,gBAAgB,UAAU,MAAM;AAC3D,MAAI,qBAAqB,oBAAoB;AAC3C;EACF;AACA,QAAM,sBACJ,aAAa,sBAAsB,WAAW,mBAC1C,6BAA6B,QAAQ,eAAe,MAAM,OAC1D;AACN,QAAM,IAAI,WACR,gBAAgB,kBAAkB,iCAAiC,gBAAgB,IAAI,mBAAmB,6CAC1G,UAAU,KAAK;AAEnB;;;AClFA,IAAM,+BAA+B;AACrC,IAAM,4BAA4B;AAK5B,SAAU,mCAAmC,OAAyB;AAC1E,QAAM,aAAa,OAAO,KAAI,EAAG,YAAW,EAAG,WAAW,KAAK,GAAG;AAClE,MAAI,eAAe,UAAU,eAAe,gBAAgB;AAC1D,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WACR,6GACA,UAAU,KAAK;AAEnB;AAKM,SAAU,6BACd,OACA,UACA,QAAiC;AAEjC,QAAM,QAAQ,SAAS,KAAI;AAC3B,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,KAAK,KAAK,6BAA6B,KAAK,mBAAmB,UAAU,KAAK;EACrG;AACA,QAAM,UAAU,MAAM,UAAU,6BAA6B,6BAA6B,KAAK,KAAK;AACpG,MAAI,SAAS;AACX,WAAO,EAAE,OAAO,UAAU,CAAA,EAAE;EAC9B;AACA,QAAM,WAAW;AACjB,MAAI,WAAW,gBAAgB;AAC7B,UAAM,IAAI,WAAW,aAAa,KAAK,WAAW,KAAK,MAAM,QAAQ,IAAI,UAAU,KAAK;EAC1F;AACA,SAAO;IACL;IACA,UAAU,CAAC,sBAAsB,KAAK,WAAW,KAAK,EAAE;;AAE5D","debugId":"e5aa93b8-d63d-557c-9183-bbd636aa5dee"}