@unbrained/pm-cli 2026.6.9 → 2026.6.10

package/dist/cli/commands/close.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="96f50581-e721-5ccd-b360-651ab15f5cca")}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]="3c2738c8-5226-561a-b6c6-e321597f6658")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { toItemRecord } from "../../core/item/item-record.js";
 import { isTerminalStatus } from "../../core/item/status.js";
@@ -7,7 +7,7 @@ import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
-import { listAllFrontMatterLight, mutateItem } from "../../core/store/item-store.js";
+import { listAllFrontMatterLight, locateItem, mutateItem, readLocatedItem } from "../../core/store/item-store.js";
 import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
 import { readSettings } from "../../core/store/settings.js";
 function toAuthor(candidate, defaultAuthor) {
@@ -68,6 +68,77 @@ function findMissingCloseValidationFields(frontMatter) {
     }
     return missing;
 }
+async function duplicateChainReferencesClosingItem(loadItemById, initialDuplicateOf, closingId) {
+    const visited = new Set();
+    let current = initialDuplicateOf;
+    while (typeof current === "string" && current.trim().length > 0) {
+        const currentId = current.trim();
+        if (currentId === closingId) {
+            return true;
+        }
+        if (visited.has(currentId)) {
+            return false;
+        }
+        visited.add(currentId);
+        current = (await loadItemById(currentId))?.duplicate_of;
+    }
+    return false;
+}
+function shouldApplyDuplicateFallback(value) {
+    return typeof value !== "string" || value.trim().length === 0;
+}
+async function assertDuplicateTargetExists(pmRoot, settings, duplicateOf, closingId) {
+    const rawTarget = duplicateOf?.trim();
+    if (!rawTarget) {
+        return undefined;
+    }
+    if (rawTarget === closingId) {
+        throw new PmCliError("An item cannot be closed as a duplicate of itself.", EXIT_CODE.USAGE, {
+            code: "duplicate_target_self",
+            why: "--duplicate-of must identify the canonical item that should remain open or already represent the work.",
+        });
+    }
+    const typeRegistry = resolveItemTypeRegistry(settings);
+    const itemCache = new Map();
+    const loadItemById = async (id) => {
+        if (itemCache.has(id)) {
+            return itemCache.get(id) ?? null;
+        }
+        const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
+        if (!located) {
+            itemCache.set(id, null);
+            return null;
+        }
+        const { document } = await readLocatedItem(located, { schema: settings.schema });
+        itemCache.set(id, document.metadata);
+        return document.metadata;
+    };
+    const target = await loadItemById(rawTarget);
+    if (!target) {
+        throw new PmCliError(`Duplicate target "${rawTarget}" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {
+            code: "duplicate_target_missing",
+            why: "Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.",
+            examples: [`pm close ${closingId} "Duplicate of ${rawTarget}" --duplicate-of ${rawTarget}`],
+            nextSteps: ["Run pm search/list to find the canonical item, then retry with --duplicate-of <id>."],
+        });
+    }
+    if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {
+        throw new PmCliError(`Circular duplicate reference detected. Target "${rawTarget}" points back to "${closingId}".`, EXIT_CODE.USAGE, {
+            code: "duplicate_target_circular",
+            why: "Circular duplicate relationships create loops for dedupe and status propagation tooling.",
+            nextSteps: ["Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate."],
+        });
+    }
+    if (typeof target.duplicate_of === "string" && target.duplicate_of.trim().length > 0) {
+        throw new PmCliError(`Duplicate target "${rawTarget}" is already marked as a duplicate of "${target.duplicate_of.trim()}".`, EXIT_CODE.USAGE, {
+            code: "duplicate_target_is_duplicate",
+            why: "Duplicate closure should point directly at the canonical item, not another duplicate.",
+            examples: [`pm close ${closingId} "Duplicate of ${target.duplicate_of.trim()}" --duplicate-of ${target.duplicate_of.trim()}`],
+            nextSteps: ["Use the canonical item referenced by duplicate_of as the --duplicate-of target."],
+        });
+    }
+    return target.id;
+}
 async function findActiveChildIds(pmRoot, settings, parentId, statusRegistry) {
     const typeRegistry = resolveItemTypeRegistry(settings);
     const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);
@@ -85,6 +156,7 @@ export async function runClose(id, closeReasonText, options, global) {
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const author = toAuthor(options.author, settings.author_default);
     const closeReason = normalizeCloseReason(closeReasonText, settings.governance.require_close_reason);
+    const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);
     const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;
     // C3 (pm-fu5d): scan for active children even under minimal governance so
     // closing a parent is never silently orphaning — off mode emits an
@@ -112,6 +184,7 @@ export async function runClose(id, closeReasonText, options, global) {
                 { option: options.expectedResult, key: "expected_result" },
                 { option: options.actualResult, key: "actual_result" },
             ];
+            const duplicateFallbackFields = [];
             for (const { option, key } of inlineCloseFields) {
                 if (typeof option !== "string")
                     continue;
@@ -120,6 +193,24 @@ export async function runClose(id, closeReasonText, options, global) {
                     continue;
                 document.metadata[key] = trimmed;
             }
+            if (duplicateOf !== undefined) {
+                document.metadata.duplicate_of = duplicateOf;
+                const duplicateResolution = `Duplicate of ${duplicateOf}`;
+                const duplicateExpectedResult = `Canonical item ${duplicateOf} tracks the work.`;
+                const duplicateActualResult = `Closed as duplicate of ${duplicateOf}.`;
+                if (shouldApplyDuplicateFallback(document.metadata.resolution)) {
+                    document.metadata.resolution = duplicateResolution;
+                    duplicateFallbackFields.push("resolution");
+                }
+                if (shouldApplyDuplicateFallback(document.metadata.expected_result)) {
+                    document.metadata.expected_result = duplicateExpectedResult;
+                    duplicateFallbackFields.push("expected_result");
+                }
+                if (shouldApplyDuplicateFallback(document.metadata.actual_result)) {
+                    document.metadata.actual_result = duplicateActualResult;
+                    duplicateFallbackFields.push("actual_result");
+                }
+            }
             if (validateCloseMode !== "off") {
                 const missingFields = findMissingCloseValidationFields(document.metadata);
                 if (missingFields.length > 0) {
@@ -155,6 +246,18 @@ export async function runClose(id, closeReasonText, options, global) {
                     changedFields.push(key);
                 }
             }
+            if (duplicateOf !== undefined) {
+                changedFields.push("duplicate_of");
+                if (duplicateFallbackFields.includes("resolution") && !changedFields.includes("resolution")) {
+                    changedFields.push("resolution");
+                }
+                if (duplicateFallbackFields.includes("expected_result") && !changedFields.includes("expected_result")) {
+                    changedFields.push("expected_result");
+                }
+                if (duplicateFallbackFields.includes("actual_result") && !changedFields.includes("actual_result")) {
+                    changedFields.push("actual_result");
+                }
+            }
             if (document.metadata.assignee !== undefined) {
                 delete document.metadata.assignee;
                 changedFields.push("assignee");
@@ -204,4 +307,4 @@ export async function runClose(id, closeReasonText, options, global) {
     };
 }
 //# sourceMappingURL=close.js.map
-//# debugId=96f50581-e721-5ccd-b360-651ab15f5cca
+//# debugId=3c2738c8-5226-561a-b6c6-e321597f6658

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","sources":["cli/commands/close.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.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 { listAllFrontMatterLight, mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\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}\n\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction 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 or via --reason.\",\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        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\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\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 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\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  const closeReason = normalizeCloseReason(closeReasonText, 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      if (isTerminalStatus(document.metadata.status, statusRegistry) && !options.force) {\n        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n      }\n      const mutationWarnings: string[] = [];\n      // pm-fl0c #11: apply inline closure fields BEFORE the validation pass so\n      // a single `pm close <id> \"reason\" --resolution \"...\"` call satisfies\n      // strict validation without a prior pm update. Only meaningful trimmed\n      // text writes; an empty/whitespace value is a no-op rather than a clear.\n      const inlineCloseFields: Array<{ option: string | undefined; key: \"resolution\" | \"expected_result\" | \"actual_result\" }> = [\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\") continue;\n        const trimmed = option.trim();\n        if (trimmed.length === 0) continue;\n        document.metadata[key] = trimmed;\n      }\n      if (validateCloseMode !== \"off\") {\n        const missingFields = findMissingCloseValidationFields(document.metadata);\n        if (missingFields.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(\",\")}`);\n        }\n        if (activeChildIds.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.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          mutationWarnings.push(`close_validation_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n        }\n      } else if (activeChildIds.length > 0) {\n        // C3: minimal governance (validate-close off) should still tell the\n        // agent it just closed a parent with open children, without blocking.\n        mutationWarnings.push(`closed_with_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n      }\n\n      document.metadata.status = statusRegistry.close_status;\n      const changedFields = [\"status\"];\n      if (closeReason !== undefined) {\n        document.metadata.close_reason = closeReason;\n        changedFields.push(\"close_reason\");\n      } else if (document.metadata.close_reason !== undefined) {\n        delete document.metadata.close_reason;\n        changedFields.push(\"close_reason\");\n      }\n      for (const { option, key } of inlineCloseFields) {\n        if (typeof option === \"string\" && option.trim().length > 0) {\n          changedFields.push(key);\n        }\n      }\n      if (document.metadata.assignee !== undefined) {\n        delete document.metadata.assignee;\n        changedFields.push(\"assignee\");\n      }\n\n      // C4 (pm-fu5d): a terminal item is no longer blocked. Clear every active\n      // blocker signal independently — scalar blocked_by, blocked_reason, and the\n      // blocked_by dependency edges (kept consistent with the kyd6 invariant) —\n      // even if only some are present (e.g. an orphaned edge or a stale\n      // blocked_reason left by manual edits), so closed work stops surfacing in\n      // blockers views, and annotate the cleanup.\n      const previousBlockedBy =\n        typeof document.metadata.blocked_by === \"string\" ? document.metadata.blocked_by.trim() : \"\";\n      const existingDeps = document.metadata.dependencies ?? [];\n      const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n      const hadBlockedReason = document.metadata.blocked_reason !== undefined;\n      if (previousBlockedBy.length > 0 || blockedByEdge !== undefined || hadBlockedReason) {\n        if (previousBlockedBy.length > 0) {\n          delete document.metadata.blocked_by;\n          changedFields.push(\"blocked_by\");\n        }\n        if (hadBlockedReason) {\n          delete document.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            document.metadata.dependencies = remainingDeps;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          changedFields.push(\"dependencies\");\n        }\n        const reportedBlocker = previousBlockedBy || blockedByEdge?.id || \"unknown\";\n        mutationWarnings.push(`closed_cleared_blocked_by:${document.metadata.id}:${reportedBlocker}`);\n      }\n\n      return {\n        changedFields,\n        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n      };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: result.warnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"96f50581-e721-5ccd-b360-651ab15f5cca"}
+{"version":3,"file":"close.js","sources":["cli/commands/close.ts"],"sourceRoot":"/","sourcesContent":["import { pathExists } from \"../../core/fs/fs-utils.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 { listAllFrontMatterLight, locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\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\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction 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 or via --reason.\",\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        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\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\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\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  const closeReason = normalizeCloseReason(closeReasonText, settings.governance.require_close_reason);\n  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);\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      if (isTerminalStatus(document.metadata.status, statusRegistry) && !options.force) {\n        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n      }\n      const mutationWarnings: string[] = [];\n      // pm-fl0c #11: apply inline closure fields BEFORE the validation pass so\n      // a single `pm close <id> \"reason\" --resolution \"...\"` call satisfies\n      // strict validation without a prior pm update. Only meaningful trimmed\n      // text writes; an empty/whitespace value is a no-op rather than a clear.\n      const inlineCloseFields: Array<{ option: string | undefined; key: \"resolution\" | \"expected_result\" | \"actual_result\" }> = [\n        { option: options.resolution, key: \"resolution\" },\n        { option: options.expectedResult, key: \"expected_result\" },\n        { option: options.actualResult, key: \"actual_result\" },\n      ];\n      const duplicateFallbackFields: Array<\"resolution\" | \"expected_result\" | \"actual_result\"> = [];\n      for (const { option, key } of inlineCloseFields) {\n        if (typeof option !== \"string\") continue;\n        const trimmed = option.trim();\n        if (trimmed.length === 0) continue;\n        document.metadata[key] = trimmed;\n      }\n      if (duplicateOf !== undefined) {\n        document.metadata.duplicate_of = duplicateOf;\n        const duplicateResolution = `Duplicate of ${duplicateOf}`;\n        const duplicateExpectedResult = `Canonical item ${duplicateOf} tracks the work.`;\n        const duplicateActualResult = `Closed as duplicate of ${duplicateOf}.`;\n        if (shouldApplyDuplicateFallback(document.metadata.resolution)) {\n          document.metadata.resolution = duplicateResolution;\n          duplicateFallbackFields.push(\"resolution\");\n        }\n        if (shouldApplyDuplicateFallback(document.metadata.expected_result)) {\n          document.metadata.expected_result = duplicateExpectedResult;\n          duplicateFallbackFields.push(\"expected_result\");\n        }\n        if (shouldApplyDuplicateFallback(document.metadata.actual_result)) {\n          document.metadata.actual_result = duplicateActualResult;\n          duplicateFallbackFields.push(\"actual_result\");\n        }\n      }\n      if (validateCloseMode !== \"off\") {\n        const missingFields = findMissingCloseValidationFields(document.metadata);\n        if (missingFields.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(\",\")}`);\n        }\n        if (activeChildIds.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.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          mutationWarnings.push(`close_validation_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n        }\n      } else if (activeChildIds.length > 0) {\n        // C3: minimal governance (validate-close off) should still tell the\n        // agent it just closed a parent with open children, without blocking.\n        mutationWarnings.push(`closed_with_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n      }\n\n      document.metadata.status = statusRegistry.close_status;\n      const changedFields = [\"status\"];\n      if (closeReason !== undefined) {\n        document.metadata.close_reason = closeReason;\n        changedFields.push(\"close_reason\");\n      } else if (document.metadata.close_reason !== undefined) {\n        delete document.metadata.close_reason;\n        changedFields.push(\"close_reason\");\n      }\n      for (const { option, key } of inlineCloseFields) {\n        if (typeof option === \"string\" && option.trim().length > 0) {\n          changedFields.push(key);\n        }\n      }\n      if (duplicateOf !== undefined) {\n        changedFields.push(\"duplicate_of\");\n        if (duplicateFallbackFields.includes(\"resolution\") && !changedFields.includes(\"resolution\")) {\n          changedFields.push(\"resolution\");\n        }\n        if (duplicateFallbackFields.includes(\"expected_result\") && !changedFields.includes(\"expected_result\")) {\n          changedFields.push(\"expected_result\");\n        }\n        if (duplicateFallbackFields.includes(\"actual_result\") && !changedFields.includes(\"actual_result\")) {\n          changedFields.push(\"actual_result\");\n        }\n      }\n      if (document.metadata.assignee !== undefined) {\n        delete document.metadata.assignee;\n        changedFields.push(\"assignee\");\n      }\n\n      // C4 (pm-fu5d): a terminal item is no longer blocked. Clear every active\n      // blocker signal independently — scalar blocked_by, blocked_reason, and the\n      // blocked_by dependency edges (kept consistent with the kyd6 invariant) —\n      // even if only some are present (e.g. an orphaned edge or a stale\n      // blocked_reason left by manual edits), so closed work stops surfacing in\n      // blockers views, and annotate the cleanup.\n      const previousBlockedBy =\n        typeof document.metadata.blocked_by === \"string\" ? document.metadata.blocked_by.trim() : \"\";\n      const existingDeps = document.metadata.dependencies ?? [];\n      const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n      const hadBlockedReason = document.metadata.blocked_reason !== undefined;\n      if (previousBlockedBy.length > 0 || blockedByEdge !== undefined || hadBlockedReason) {\n        if (previousBlockedBy.length > 0) {\n          delete document.metadata.blocked_by;\n          changedFields.push(\"blocked_by\");\n        }\n        if (hadBlockedReason) {\n          delete document.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            document.metadata.dependencies = remainingDeps;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          changedFields.push(\"dependencies\");\n        }\n        const reportedBlocker = previousBlockedBy || blockedByEdge?.id || \"unknown\";\n        mutationWarnings.push(`closed_cleared_blocked_by:${document.metadata.id}:${reportedBlocker}`);\n      }\n\n      return {\n        changedFields,\n        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n      };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: result.warnings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3c2738c8-5226-561a-b6c6-e321597f6658"}

package/dist/cli/commands/completion.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="809a8e14-8f15-5207-851e-a06cf5d89308")}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]="bfb4fb54-cf3d-5b6d-860d-f4f653e21b8e")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NORMALIZE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, SEARCH_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "../../sdk/cli-contracts.js";
@@ -33,10 +33,10 @@ const PLAN_SUBCOMMANDS_LIST = "create show add-step update-step complete-step bl
 const COMPLETION_FLAGS = toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);
 const COMPLETION_SHELL_CHOICES = `${COMPLETION_FLAGS} bash zsh fish`;
 const GUIDE_TOPIC_CHOICES = joinCompletionValues(listGuideTopicIds());
-const MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help";
-const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help";
-const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help";
-const RELEASE_MUTATION_FLAGS = "--allow-audit-release --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help";
+const MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
+const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
+const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
+const RELEASE_MUTATION_FLAGS = "--allow-audit-release --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
 const GLOBAL_FLAGS = GLOBAL_FLAG_CONTRACTS.flatMap((entry) => [entry.short, entry.flag, ...(entry.aliases ?? [])])
     .filter((value) => Boolean(value))
     .join(" ");
@@ -320,7 +320,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen(DEPS_FLAGS)})`,
         "      ;;",
         "    test)",
-        `      COMPREPLY=(${compgen("--add --remove --run --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    test-all)",
         `      COMPREPLY=(${compgen("--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
@@ -562,6 +562,7 @@ ${zshListRuntimeFieldFlags}            '--json[Output JSON]' \\
           _arguments \\
             '--group-by[Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)]:fields' \\
             '--count[Return grouped counts]' \\
+            '--completion[Add open/in_progress/closed/other counts and completion percentage]' \\
             '--sum[Numeric field to sum per group]:field' \\
             '--avg[Numeric field to average per group]:field' \\
             '--include-unparented[Include unparented rows when grouping by parent]' \\
@@ -1088,8 +1089,13 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
         test)
           _arguments \\
             '--add[Add linked test entry]:entry' \\
+            '--add-json[Add linked test entry from JSON object/array]:json' \\
             '--remove[Remove linked test entry by command/path]:entry' \\
+            '--list[List linked tests without mutating]' \\
             '--run[Run linked tests]' \\
+            '--match[Run linked tests whose command/path contains substring]:substring' \\
+            '--only-index[Run one linked test by 1-based index]:number' \\
+            '--only-last[Run the most recently added linked test]' \\
             '--background[Run linked tests in managed background mode]' \\
             '--timeout[Default timeout seconds]:seconds' \\
             '--progress[Emit linked-test progress to stderr]' \\
@@ -1397,6 +1403,7 @@ complete -c pm -f
 complete -c pm -l json -d 'Output JSON instead of TOON'
 complete -c pm -l quiet -d 'Suppress stdout output'
 complete -c pm -l no-changed-fields -d 'Omit changed_fields array from mutation output'
+complete -c pm -l id-only -d 'Print only id and status for single-item mutation output'
 complete -c pm -l pm-path -d 'Explicit tracker storage path for this command' -r
 complete -c pm -l path -d 'Override PM path for this command' -r
 complete -c pm -l no-extensions -d 'Disable extension loading'
@@ -1506,6 +1513,7 @@ ${fishListRuntimeFieldFlags}
 # aggregate flags
 complete -c pm -n '__fish_seen_subcommand_from aggregate' -l group-by -d 'Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)' -r
 complete -c pm -n '__fish_seen_subcommand_from aggregate' -l count -d 'Return grouped counts'
+complete -c pm -n '__fish_seen_subcommand_from aggregate' -l completion -d 'Add completion counts and percentage per group'
 complete -c pm -n '__fish_seen_subcommand_from aggregate' -l sum -d 'Numeric field to sum per group' -r
 complete -c pm -n '__fish_seen_subcommand_from aggregate' -l avg -d 'Numeric field to average per group' -r
 complete -c pm -n '__fish_seen_subcommand_from aggregate' -l include-unparented -d 'Include unparented rows when grouping by parent'
@@ -1881,8 +1889,13 @@ complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l forc
 
 # test flags
 complete -c pm -n '__fish_seen_subcommand_from test' -l add -d 'Add linked test entry' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l add-json -d 'Add linked test entry from JSON object/array' -r
 complete -c pm -n '__fish_seen_subcommand_from test' -l remove -d 'Remove linked test entry' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l list -d 'List linked tests without mutating'
 complete -c pm -n '__fish_seen_subcommand_from test' -l run -d 'Run linked tests'
+complete -c pm -n '__fish_seen_subcommand_from test' -l match -d 'Run linked tests whose command/path contains substring' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l only-index -d 'Run one linked test by 1-based index' -r
+complete -c pm -n '__fish_seen_subcommand_from test' -l only-last -d 'Run the most recently added linked test'
 complete -c pm -n '__fish_seen_subcommand_from test' -l background -d 'Run linked tests in managed background mode'
 complete -c pm -n '__fish_seen_subcommand_from test' -l timeout -d 'Default timeout seconds' -r
 complete -c pm -n '__fish_seen_subcommand_from test' -l progress -d 'Emit linked-test progress to stderr'
@@ -2104,4 +2117,4 @@ export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansio
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=809a8e14-8f15-5207-851e-a06cf5d89308
+//# debugId=bfb4fb54-cf3d-5b6d-860d-f4f653e21b8e