@unbrained/pm-cli 2026.7.17 → 2026.7.18

package/dist/cli-bundle/chunks/{chunk-XYJK6GIQ.js → chunk-TGBTLGPX.js}

@@ -1,7 +1,7 @@
 import {
   EXECUTABLE_COMMAND_ALIASES,
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-S6FF7VW6.js";
+} from "./chunk-WQXRZMFN.js";
 import {
   writeStdout
 } from "./chunk-EHJFUOXL.js";
@@ -848,4 +848,4 @@ export {
   applyInvocationAuthorOverride,
   createPmCliProgram
 };
-//# sourceMappingURL=chunk-XYJK6GIQ.js.map
+//# sourceMappingURL=chunk-TGBTLGPX.js.map

package/dist/cli-bundle/chunks/{chunk-37V5MXAU.js → chunk-TLWJP5BF.js}

@@ -1,6 +1,6 @@
 import {
   collectBlockedByIds
-} from "./chunk-P56LKFQX.js";
+} from "./chunk-BDA35QG5.js";
 import {
   buildItemNotFoundError,
   isTerminalStatus,
@@ -25,7 +25,7 @@ import {
 !(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] = "0d8fc5b7-1ebe-55cb-96d0-f174fe1f738a");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "cd698989-6067-569b-9ca0-81f33fa89cfd");
   } catch (e2) {
   }
 })();
@@ -463,4 +463,4 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-37V5MXAU.js.map
+//# sourceMappingURL=chunk-TLWJP5BF.js.map

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

@@ -0,0 +1,7 @@
+{
+  "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 \"../../sdk/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 {\n  resolveRuntimeStatusRegistry,\n  type RuntimeStatusRegistry,\n} from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  buildItemNotFoundError,\n  listAllItemMetadataLight,\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 { ItemMetadata } from \"../../types/index.js\";\n\n/** Documents the close command options payload exchanged by command, SDK, and package integrations. */\nexport interface CloseCommandOptions {\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports validate close for this contract. */\n  validateClose?: string;\n  /** Value that configures or reports force for this contract. */\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 ItemMetadata.{resolution,expected_result,actual_result}.\n  /** Value that configures or reports resolution for this contract. */\n  resolution?: string;\n  /** Structured result returned by the expected operation. */\n  expectedResult?: string;\n  /** Structured result returned by the actual operation. */\n  actualResult?: string;\n  /** Value that configures or reports duplicate of for this contract. */\n  duplicateOf?: string;\n}\n\n/** Documents the close result payload exchanged by command, SDK, and package integrations. */\nexport interface CloseResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports changed fields for this contract. */\n  changed_fields: string[];\n  /** Value that configures or reports warnings for this contract. */\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  closedAt: string;\n}\n\nfunction toAuthor(\n  candidate: string | undefined,\n  defaultAuthor: string,\n): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction normalizeCloseReason(\n  reasonText: string | undefined,\n  required: boolean,\n): 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:\n          \"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(\n  input: CloseReasonFallbackInput,\n): 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 =\n    typeof input.resolution === \"string\" ? input.resolution.trim() : \"\";\n  if (trimmedResolution.length > 0) {\n    return trimmedResolution;\n  }\n  const trimmedMessage =\n    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<{\n  key: keyof Pick<\n    ItemMetadata,\n    \"resolution\" | \"expected_result\" | \"actual_result\"\n  >;\n  label: string;\n}> = [\n  { key: \"resolution\", label: \"resolution\" },\n  { key: \"expected_result\", label: \"expected_result\" },\n  { key: \"actual_result\", label: \"actual_result\" },\n];\n\nfunction parseValidateCloseMode(\n  raw: string | undefined,\n): 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 (\n    normalized === \"off\" ||\n    normalized === \"none\" ||\n    normalized === \"disabled\"\n  ) {\n    return \"off\";\n  }\n  if (normalized === \"strict\") {\n    return \"strict\";\n  }\n  throw new PmCliError(\n    `Invalid --validate-close mode \"${raw}\" (expected \"off\", \"warn\", or \"strict\")`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction findMissingCloseValidationFields(\n  itemMetadata: ItemMetadata,\n): string[] {\n  const missing: string[] = [];\n  for (const field of CLOSE_VALIDATION_FIELDS) {\n    const rawValue = itemMetadata[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<ItemMetadata | 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(\n      \"An item cannot be closed as a duplicate of itself.\",\n      EXIT_CODE.USAGE,\n      {\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  }\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const itemCache = new Map<string, ItemMetadata | null>();\n  const loadItemById = async (id: string): Promise<ItemMetadata | null> => {\n    if (itemCache.has(id)) {\n      return itemCache.get(id) ?? null;\n    }\n    const located = await locateItem(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    if (!located) {\n      itemCache.set(id, null);\n      return null;\n    }\n    const { document } = await readLocatedItem(located, {\n      schema: settings.schema,\n    });\n    itemCache.set(id, document.metadata);\n    return document.metadata;\n  };\n  const target = await loadItemById(rawTarget);\n  if (!target) {\n    throw new PmCliError(\n      `Duplicate target \"${rawTarget}\" was not found. Create or locate the canonical item first.`,\n      EXIT_CODE.USAGE,\n      {\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: [\n          `pm close ${closingId} \"Duplicate of ${rawTarget}\" --duplicate-of ${rawTarget}`,\n        ],\n        nextSteps: [\n          \"Run pm search/list to find the canonical item, then retry with --duplicate-of <id>.\",\n        ],\n      },\n    );\n  }\n  if (\n    await duplicateChainReferencesClosingItem(\n      loadItemById,\n      target.duplicate_of,\n      closingId,\n    )\n  ) {\n    throw new PmCliError(\n      `Circular duplicate reference detected. Target \"${rawTarget}\" points back to \"${closingId}\".`,\n      EXIT_CODE.USAGE,\n      {\n        code: \"duplicate_target_circular\",\n        why: \"Circular duplicate relationships create loops for dedupe and status propagation tooling.\",\n        nextSteps: [\n          \"Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate.\",\n        ],\n      },\n    );\n  }\n  if (\n    typeof target.duplicate_of === \"string\" &&\n    target.duplicate_of.trim().length > 0\n  ) {\n    throw new PmCliError(\n      `Duplicate target \"${rawTarget}\" is already marked as a duplicate of \"${target.duplicate_of.trim()}\".`,\n      EXIT_CODE.USAGE,\n      {\n        code: \"duplicate_target_is_duplicate\",\n        why: \"Duplicate closure should point directly at the canonical item, not another duplicate.\",\n        examples: [\n          `pm close ${closingId} \"Duplicate of ${target.duplicate_of.trim()}\" --duplicate-of ${target.duplicate_of.trim()}`,\n        ],\n        nextSteps: [\n          \"Use the canonical item referenced by duplicate_of as the --duplicate-of target.\",\n        ],\n      },\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 listAllItemMetadataLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  return items\n    .filter(\n      (item) =>\n        item.parent === parentId &&\n        !isTerminalStatus(item.status, statusRegistry),\n    )\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 listAllItemMetadataLight(\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 (\n          blocker !== undefined &&\n          isTerminalStatus(blocker.status, statusRegistry)\n        );\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(\n    pmRoot,\n    settings,\n    closedId,\n    statusRegistry,\n  );\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 (\n              dependency.kind !== \"blocked_by\" ||\n              !candidate.blocker_ids.includes(dependencyId)\n            );\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 = [\n            \"status\",\n            \"blocked_by\",\n            \"blocked_reason\",\n            \"unblock_note\",\n          ];\n          if (remainingDependencies.length !== dependencies.length) {\n            changedFields.push(\"dependencies\");\n          }\n          return {\n            changedFields,\n          };\n        },\n      });\n      warnings.push(\n        `auto_unblocked:${unblocked.item.id}:resolved_blockers=${candidate.blocker_ids.join(\",\")}`,\n      );\n      /* c8 ignore start -- defensive fan-out failure path; normal lock/claim state is auditable and still unblocks. */\n    } catch (error) {\n      const reason =\n        error instanceof Error\n          ? error.message.replace(/\\s+/g, \" \").trim()\n          : \"unknown\";\n      warnings.push(`auto_unblock_failed:${candidate.id}:${reason}`);\n    }\n    /* c8 ignore stop */\n  }\n  return warnings;\n}\n\nfunction applyInlineCloseFields(\n  metadata: ItemMetadata,\n  options: CloseCommandOptions,\n): CloseInlineFieldKey[] {\n  const changedFields: CloseInlineFieldKey[] = [];\n  const inlineCloseFields: Array<{\n    option: string | undefined;\n    key: CloseInlineFieldKey;\n  }> = [\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(\n  metadata: ItemMetadata,\n  duplicateOf: string | undefined,\n): 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    {\n      key: \"expected_result\",\n      value: `Canonical item ${duplicateOf} tracks the work.`,\n    },\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: ItemMetadata,\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(\n        `close_validation_missing_fields:${metadata.id}:${missingFields.join(\",\")}`,\n      );\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(\n        `close_validation_active_children:${metadata.id}:${activeChildIds.join(\",\")}`,\n      );\n    }\n    return warnings;\n  }\n  if (activeChildIds.length > 0) {\n    warnings.push(\n      `closed_with_active_children:${metadata.id}:${activeChildIds.join(\",\")}`,\n    );\n  }\n  return warnings;\n}\n\nfunction applyCloseReason(\n  metadata: ItemMetadata,\n  closeReason: string | undefined,\n): 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: ItemMetadata): string[] {\n  if (metadata.assignee === undefined) {\n    return [];\n  }\n  delete metadata.assignee;\n  return [\"assignee\"];\n}\n\nfunction clearClosedBlockerSignals(metadata: ItemMetadata): {\n  changedFields: string[];\n  warnings: string[];\n} {\n  const previousBlockedBy =\n    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 (\n    previousBlockedBy.length === 0 &&\n    blockedByEdge === undefined &&\n    !hadBlockedReason\n  ) {\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(\n      (dep) => dep.kind !== \"blocked_by\",\n    );\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\n      ? [`closed_cleared_blocked_by:${metadata.id}:${reportedBlocker}`]\n      : [],\n  };\n}\n\nfunction mutateCloseMetadata(\n  metadata: ItemMetadata,\n  context: CloseMutationContext,\n): { changedFields: string[]; warnings?: string[] } {\n  if (\n    isTerminalStatus(metadata.status, context.statusRegistry) &&\n    !context.force\n  ) {\n    throw new PmCliError(\n      `Item ${metadata.id} is already terminal; use --force to close again.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  const inlineChangedFields = applyInlineCloseFields(metadata, context.options);\n  const duplicateFallbackFields = applyDuplicateCloseMetadata(\n    metadata,\n    context.duplicateOf,\n  );\n  const mutationWarnings = collectCloseValidationWarnings(\n    metadata,\n    context.validateCloseMode,\n    context.activeChildIds,\n  );\n  metadata.status = context.statusRegistry.close_status;\n  metadata.closed_at = context.closedAt;\n  const changedFields = [\n    \"status\",\n    \"closed_at\",\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\n/** Public contract for test only close command, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyCloseCommand = {\n  blockedByIds: collectBlockedByIds,\n};\n\n/** Implements run close for the public runtime surface of this module. */\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(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\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(\n    pmRoot,\n    id,\n    settings.id_prefix,\n    settings.item_format,\n    typeToFolder,\n  );\n  if (!located) {\n    throw await buildItemNotFoundError(\n      pmRoot,\n      id,\n      settings.id_prefix,\n      typeToFolder,\n    );\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(\n    pmRoot,\n    settings,\n    options.duplicateOf,\n    id,\n  );\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(\n    effectiveCloseReasonText,\n    settings.governance.require_close_reason,\n  );\n  const validateCloseMode =\n    parseValidateCloseMode(options.validateClose) ??\n    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(\n    pmRoot,\n    settings,\n    id,\n    statusRegistry,\n  );\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        closedAt: new Date().toISOString(),\n      });\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: [\n      ...result.warnings,\n      ...(await autoUnblockResolvedDependents(\n        pmRoot,\n        settings,\n        located.id,\n        author,\n        statusRegistry,\n      )),\n    ],\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-3D4YVTNG.js → chunk-TZAE66GQ.js}

@@ -27,7 +27,7 @@ import {
 } from "./chunk-YRYYFGV3.js";
 import {
   CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS
-} from "./chunk-S6FF7VW6.js";
+} from "./chunk-WQXRZMFN.js";
 import {
   normalizeAddTypeInput,
   parseItemTypesFile,
@@ -875,4 +875,4 @@ export {
   formatProfileLintHuman,
   formatProfileApplyHuman
 };
-//# sourceMappingURL=chunk-3D4YVTNG.js.map
+//# sourceMappingURL=chunk-TZAE66GQ.js.map

package/dist/cli-bundle/chunks/{chunk-S6FF7VW6.js → chunk-WQXRZMFN.js}

@@ -1173,7 +1173,7 @@ var UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_REGIS
 !(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] = "2f7d8ae8-4fb8-5ec4-a440-d42f8499589f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a665adfd-c6a7-544c-a3f9-55a6d5fa4472");
   } catch (e2) {
   }
 })();
@@ -1218,6 +1218,7 @@ var PM_CORE_COMMAND_NAMES = [
   "context",
   "ctx",
   "get",
+  "graph",
   "search",
   "eval",
   "next",
@@ -1260,6 +1261,20 @@ var PM_CORE_COMMAND_NAMES = [
   "remind",
   "help"
 ];
+var GRAPH_SUBCOMMAND_VALUES = [
+  "ancestors",
+  "descendants",
+  "predecessors",
+  "successors",
+  "paths",
+  "impact",
+  "analyze",
+  "audit",
+  "communities",
+  "redundancy",
+  "dominators",
+  "plan"
+];
 var PM_TOOL_ACTIONS = [
   "init",
   "config",
@@ -1331,6 +1346,7 @@ var PM_TOOL_ACTIONS = [
   "files",
   "docs",
   "deps",
+  "graph",
   "test",
   "test-all",
   "telemetry",
@@ -1365,7 +1381,7 @@ function isPmExtensionPolicySurfaceContract(value) {
 !(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] = "737c225c-aa32-5277-b169-faedbb057f39");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bbb41f64-eaab-546b-b21e-9535853ee1f9");
   } catch (e2) {
   }
 })();
@@ -1710,7 +1726,9 @@ var TOOL_DEPS_OPTION_CONTRACTS = [
   { param: "nodeLimit", flag: "--node-limit" },
   { param: "edgeLimit", flag: "--edge-limit" },
   { param: "tokenBudget", flag: "--token-budget" },
-  { param: "cursor", flag: "--cursor" }
+  { param: "cursor", flag: "--cursor" },
+  { param: "direction", flag: "--direction" },
+  { param: "kind", flag: "--kind", repeatable: true }
 ];
 
 // dist/sdk/cli-contracts/string-lists.js
@@ -1731,7 +1749,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "cb1e2010-bf9f-5eb9-a77d-70e31f5463ac");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c5e59d37-0b45-54cc-93a0-4e52a78d6dd0");
   } catch (e2) {
   }
 })();
@@ -2878,6 +2896,23 @@ var DEPS_FLAG_CONTRACTS = [
   { flag: "--format" },
   { flag: "--max-depth" },
   { flag: "--collapse" },
+  { flag: "--summary" },
+  { flag: "--node-limit" },
+  { flag: "--edge-limit" },
+  { flag: "--token-budget" },
+  { flag: "--cursor" },
+  { flag: "--direction" },
+  { flag: "--kind", list: true }
+];
+var GRAPH_FLAG_CONTRACTS = [
+  { flag: "--kind", list: true },
+  { flag: "--max-depth" },
+  { flag: "--limit" },
+  { flag: "--after" },
+  { flag: "--direction" },
+  { flag: "--max-paths" },
+  { flag: "--sample" },
+  { flag: "--exempt-isolate", list: true },
   { flag: "--summary" }
 ];
 var EVAL_FLAG_CONTRACTS = [
@@ -3030,6 +3065,7 @@ var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
   ["files", FILES_FLAG_CONTRACTS],
   ["docs", DOCS_FLAG_CONTRACTS],
   ["deps", DEPS_FLAG_CONTRACTS],
+  ["graph", GRAPH_FLAG_CONTRACTS],
   ["test", TEST_FLAG_CONTRACTS],
   ["test-all", TEST_ALL_FLAG_CONTRACTS],
   ["telemetry", TELEMETRY_FLAG_CONTRACTS],
@@ -3103,7 +3139,7 @@ function toCompletionFlagString(flagContracts, includeGlobal = true) {
 !(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] = "ced0a4db-9b0d-50c6-9de1-1d08dcf39c93");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d9640c02-2d99-5ec4-b954-c6f5800d3af4");
   } catch (e2) {
   }
 })();
@@ -3449,6 +3485,22 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   edgeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
   tokenBudget: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
   cursor: { type: "string" },
+  direction: { type: "string", enum: ["outgoing", "incoming", "both"] },
+  kind: {
+    anyOf: [
+      { type: "string" },
+      { type: "array", items: { type: "string" } }
+    ]
+  },
+  after: { type: "string" },
+  maxPaths: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  sample: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  exemptIsolate: {
+    anyOf: [
+      { type: "string" },
+      { type: "array", items: { type: "string" } }
+    ]
+  },
   collapse: { type: "string", enum: ["none", "repeated"] },
   shell: { type: "string", enum: ["bash", "zsh", "fish"] },
   stdin: { type: "boolean" },
@@ -3764,7 +3816,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     examples: ["Task", "Feature"]
   },
   subcommand: {
-    description: "Subcommand selector for schema, profile, and telemetry actions."
+    description: "Subcommand selector for schema, profile, telemetry, and graph actions."
   },
   name: {
     description: "Custom item type name (schema add-type/remove-type/show), custom status id (schema show-status/add-status/remove-status), custom field key (schema add-field/remove-field/show-field), or profile name (profile show/apply/lint).",
@@ -4344,6 +4396,30 @@ var PM_TOOL_PARAMETER_METADATA = {
   cursor: {
     description: "Opaque continuation cursor returned by deps --format context."
   },
+  direction: {
+    description: 'Graph-context traversal direction for deps action ("outgoing", "incoming", or "both").',
+    examples: ["both", "incoming"]
+  },
+  kind: {
+    description: "Registered relationship kinds narrowing deps --format context traversal (string, comma-separated, or array).",
+    examples: ["blocked_by", ["parent", "related"]]
+  },
+  after: {
+    description: "Continuation cursor resuming a bounded listing or traversal after this previously returned id.",
+    examples: ["pm-x1y2"]
+  },
+  maxPaths: {
+    description: "Maximum enumerated paths for graph paths queries.",
+    examples: [5, "10"]
+  },
+  sample: {
+    description: "Maximum evidence sample entries per graph audit finding.",
+    examples: [10, "25"]
+  },
+  exemptIsolate: {
+    description: "Item ids the graph audit treats as explicitly valid isolates (string, comma-separated, or array).",
+    examples: ["pm-x1y2", ["pm-x1y2", "pm-a3b4"]]
+  },
   collapse: {
     description: 'Dependency tree collapse mode for deps action ("none" or "repeated").',
     examples: ["none", "repeated"]
@@ -4413,6 +4489,43 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
       description: "Profile name for show/apply/lint. Built-in profiles are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.",
       examples: ["agile", "ops", "research"]
     }
+  },
+  graph: {
+    subcommand: {
+      description: "Graph query selector: ancestors|descendants|predecessors|successors|paths|impact|analyze|audit|communities|redundancy|dominators|plan. Traversals, paths, impact, and dominators require id; paths also requires target; plan derives dry-run remediation proposals from the governance audit.",
+      examples: ["successors", "audit"]
+    },
+    id: {
+      description: "Root item id for traversal, paths, impact, and dominators graph queries.",
+      examples: ["pm-x1y2"]
+    },
+    target: {
+      description: "Target item id for graph paths queries.",
+      examples: ["pm-a3b4"]
+    },
+    direction: {
+      description: 'Edge orientation for graph paths/impact/dominators queries ("outgoing", "incoming", or "both"; default "both").',
+      examples: ["incoming"]
+    },
+    kind: {
+      description: "Registered relationship kinds narrowing the graph query (string, comma-separated, or array).",
+      examples: ["blocked_by", ["parent", "related"]]
+    },
+    maxDepth: {
+      description: "Maximum graph traversal depth (non-negative integer).",
+      examples: [2, "4"]
+    },
+    after: {
+      description: "Resume a hierarchy/ordering graph traversal after this previously returned node id.",
+      examples: ["pm-x1y2"]
+    },
+    limit: {
+      description: "Maximum returned rows per bounded graph collection (traversal ids, impact rows, analyze/communities samples, redundancy rows, dominator bottlenecks).",
+      examples: [10, "25"]
+    },
+    summary: {
+      description: "When true, return counts-first graph envelopes without row collections."
+    }
   }
 };
 
@@ -4420,7 +4533,7 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
 !(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] = "15ef6d3d-a3e4-50ab-a3d8-ac9cfa57c110");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b2640e2f-8ec1-5746-a121-018b7de82393");
   } catch (e2) {
   }
 })();
@@ -4444,6 +4557,29 @@ var PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS = {
   "update-many": ["fullChangedFields"],
   "close-many": ["fullChangedFields"]
 };
+var PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS = Object.freeze({
+  "close-many": [
+    "list",
+    "expected_result",
+    "expected",
+    "actual_result",
+    "actual",
+    "validate_close",
+    "dry_run",
+    "checkpoint",
+    "no_checkpoint",
+    "filterAssignee_filter"
+  ],
+  "update-many": [
+    "list",
+    "update",
+    "dry_run",
+    "checkpoint",
+    "no_checkpoint",
+    "filterAssignee_filter"
+  ],
+  ...Object.fromEntries(PM_TOOL_ACTIONS.filter((action) => action === "install" || action === "extension" || action === "package" || action.startsWith("extension-") || action.startsWith("package-")).map((action) => [action, ["project", "local", "global"]]))
+});
 function toSchemaKeyList(values) {
   return normalizeUniqueStringList(values);
 }
@@ -5008,7 +5144,34 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   },
   deps: {
     required: ["id"],
-    optional: ["format", "maxDepth", "collapse", "summary", "nodeLimit", "edgeLimit", "tokenBudget", "cursor"]
+    optional: [
+      "format",
+      "maxDepth",
+      "collapse",
+      "summary",
+      "nodeLimit",
+      "edgeLimit",
+      "tokenBudget",
+      "cursor",
+      "direction",
+      "kind"
+    ]
+  },
+  graph: {
+    required: ["subcommand"],
+    optional: [
+      "id",
+      "target",
+      "kind",
+      "maxDepth",
+      "limit",
+      "after",
+      "direction",
+      "maxPaths",
+      "sample",
+      "exemptIsolate",
+      "summary"
+    ]
   },
   test: {
     required: ["id"],
@@ -5308,18 +5471,24 @@ function buildActionScopedAllOf(contract) {
   }
   return allOf;
 }
-function buildActionScopedToolSchema(action) {
+function pmToolActionParameterKeys(action) {
+  if (!Object.prototype.hasOwnProperty.call(PM_TOOL_ACTION_SCHEMA_CONTRACTS, action)) {
+    return void 0;
+  }
   const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
-  const required = toSchemaKeyList(contract.required ?? []);
-  const optional = toSchemaKeyList(contract.optional ?? []);
   const mutationParameterKeys = PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS[action] ?? [];
-  const allowedKeys = toSchemaKeyList([
+  return toSchemaKeyList([
     "action",
     ...PM_TOOL_GLOBAL_PARAMETER_KEYS,
     ...mutationParameterKeys,
-    ...required,
-    ...optional
+    ...contract.required ?? [],
+    ...contract.optional ?? []
   ]);
+}
+function buildActionScopedToolSchema(action) {
+  const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
+  const required = toSchemaKeyList(contract.required ?? []);
+  const allowedKeys = pmToolActionParameterKeys(action);
   const schema = {
     type: "object",
     additionalProperties: false,
@@ -5418,7 +5587,7 @@ var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderC
 !(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] = "03628345-205e-5ae0-9a16-1f47628ea7af");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "04a1cf17-7ffe-56c2-bf4d-73e4368161f5");
   } catch (e2) {
   }
 })();
@@ -5447,6 +5616,7 @@ export {
   PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,
   PM_EXTENSION_POLICY_SURFACE_CONTRACTS,
   PM_CORE_COMMAND_NAMES,
+  GRAPH_SUBCOMMAND_VALUES,
   PM_TOOL_ACTIONS,
   isPmToolAction,
   isPmExtensionCapabilityContract,
@@ -5536,6 +5706,7 @@ export {
   GET_FLAG_CONTRACTS,
   GUIDE_FLAG_CONTRACTS,
   DEPS_FLAG_CONTRACTS,
+  GRAPH_FLAG_CONTRACTS,
   EVAL_FLAG_CONTRACTS,
   NEXT_FLAG_CONTRACTS,
   SEARCH_FLAG_CONTRACTS,
@@ -5550,4 +5721,4 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-S6FF7VW6.js.map
+//# sourceMappingURL=chunk-WQXRZMFN.js.map