@unbrained/pm-cli 2026.6.6 → 2026.6.8

package/dist/cli-bundle/chunks/{chunk-NUZ5HKR4.js → chunk-F33VC5EX.js}

@@ -6,7 +6,7 @@ import {
   runActiveRendererOverride,
   runActiveServiceOverrideSync,
   setActiveCommandResult
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/core/output/mutation-projection.js
 var CHANGED_FIELDS_KEY = "changed_fields";
@@ -327,6 +327,6 @@ export {
   printResult,
   printError
 };
-//# sourceMappingURL=chunk-NUZ5HKR4.js.map
+//# sourceMappingURL=chunk-F33VC5EX.js.map
 
 //# debugId=522b0ebd-699c-5123-b28a-4232c08e9e97

package/dist/cli-bundle/chunks/{chunk-WKY2IBOQ.js → chunk-FGRJZVXD.js}

@@ -1,10 +1,10 @@
 import {
   resolveTypeName
-} from "./chunk-KJE2FOS4.js";
+} from "./chunk-2BYKYPWY.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/cli/shared-parsers.js
 !(function() {
@@ -57,4 +57,4 @@ export {
   parsePriority,
   parseType
 };
-//# sourceMappingURL=chunk-WKY2IBOQ.js.map
+//# sourceMappingURL=chunk-FGRJZVXD.js.map

package/dist/cli-bundle/chunks/{chunk-77GFDHGF.js → chunk-FO2TYSQZ.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/core/item/parent-reference-policy.js
 function normalizeParentReferencePolicy(value) {
@@ -75,6 +75,6 @@ export {
   normalizeSprintReleaseFormatPolicy,
   validateSprintOrReleaseValue
 };
-//# sourceMappingURL=chunk-77GFDHGF.js.map
+//# sourceMappingURL=chunk-FO2TYSQZ.js.map
 
 //# debugId=399b6987-8865-5489-b1c8-bf64257b2ad8

package/dist/cli-bundle/chunks/{chunk-GXSUPCBV.js → chunk-HOA3GMB6.js}

@@ -3,16 +3,16 @@
 import {
   hashDocument,
   toItemRecord
-} from "./chunk-GGYWB3Y2.js";
+} from "./chunk-ODN53S6H.js";
 import {
   canonicalDocument
-} from "./chunk-LB3RUL2N.js";
+} from "./chunk-XEKZCBCS.js";
 import {
   FRONT_MATTER_KEY_ORDER,
   orderObject,
   sha256Hex,
   stableStringify
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/core/history/replay.js
 import jsonPatch from "fast-json-patch";
@@ -226,6 +226,6 @@ export {
   reanchorHistoryEntries,
   historyEntriesToRaw
 };
-//# sourceMappingURL=chunk-GXSUPCBV.js.map
+//# sourceMappingURL=chunk-HOA3GMB6.js.map
 
 //# debugId=823be5f8-bbd7-52a9-9c1f-d5fdbfd726c2

package/dist/cli-bundle/chunks/{chunk-OVQCEJPG.js → chunk-HP35AVFS.js}

@@ -1,6 +1,6 @@
 import {
   BUILTIN_ITEM_TYPE_VALUES
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/core/schema/item-types-file.js
 !(function() {
@@ -218,4 +218,4 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-OVQCEJPG.js.map
+//# sourceMappingURL=chunk-HP35AVFS.js.map

package/dist/cli-bundle/chunks/{chunk-KJ33AOCY.js → chunk-J4DKAGTM.js}

@@ -1,7 +1,7 @@
 import {
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-AO442XLN.js";
+} from "./chunk-M7UBTVFT.js";
 import {
   TYPE_TO_FOLDER,
   getItemFormatFromPath,
@@ -10,7 +10,7 @@ import {
   removeFileIfExists,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/core/store/item-format-migration.js
 import fs from "node:fs/promises";
@@ -119,4 +119,4 @@ async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:
 export {
   migrateItemFilesToFormat
 };
-//# sourceMappingURL=chunk-KJ33AOCY.js.map
+//# sourceMappingURL=chunk-J4DKAGTM.js.map

package/dist/cli-bundle/chunks/{chunk-ME2YH6FN.js → chunk-JS47EKLP.js}

@@ -2,22 +2,22 @@
 !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]="ede3cf3f-6ca9-5eb0-aeb7-cd997702397f")}catch(e){}}();
 import {
   readHistoryEntries
-} from "./chunk-2RSPZI5H.js";
+} from "./chunk-OVSSE2JP.js";
 import {
   parseLimit
-} from "./chunk-3VAM3NNM.js";
+} from "./chunk-NDSMKB2I.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-GGYWB3Y2.js";
+} from "./chunk-ODN53S6H.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-2VBQ6ZXS.js";
+} from "./chunk-Z2HXAFFH.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-TCD3R2PF.js";
+} from "./chunk-XZS4MV37.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -27,7 +27,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-5SFCOO6B.js";
+} from "./chunk-YJAKN2N2.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -177,6 +177,6 @@ async function runActivity(options, global) {
 export {
   runActivity
 };
-//# sourceMappingURL=chunk-ME2YH6FN.js.map
+//# sourceMappingURL=chunk-JS47EKLP.js.map
 
 //# debugId=ede3cf3f-6ca9-5eb0-aeb7-cd997702397f

package/dist/cli-bundle/chunks/{chunk-T3LC5LKB.js → chunk-K62SNVVE.js}

@@ -1,7 +1,7 @@
 import {
   TYPE_TO_FOLDER,
   pathExists
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/core/item/id.js
 import crypto from "node:crypto";
@@ -9,7 +9,7 @@ import path from "node:path";
 !(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] = "f427a735-ffab-5a1c-b4cf-7069624a58cd");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "681913fe-dcec-59f2-a0dc-0f3578f11e37");
   } catch (e2) {
   }
 })();
@@ -35,10 +35,9 @@ function normalizeItemId(input, prefix) {
   return `${canonicalPrefix}${normalized}`;
 }
 function randomToken(length) {
-  const bytes = crypto.randomBytes(length);
   let token = "";
-  for (const byte of bytes) {
-    token += (byte % 36).toString(36);
+  for (let index = 0; index < length; index += 1) {
+    token += crypto.randomInt(0, 36).toString(36);
   }
   return token;
 }
@@ -76,4 +75,4 @@ export {
   normalizeItemId,
   generateItemId
 };
-//# sourceMappingURL=chunk-T3LC5LKB.js.map
+//# sourceMappingURL=chunk-K62SNVVE.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/item/id.ts"],
+  "sourcesContent": ["import crypto from \"node:crypto\";\nimport path from \"node:path\";\nimport { TYPE_TO_FOLDER } from \"../shared/constants.js\";\nimport { pathExists } from \"../fs/fs-utils.js\";\n\nexport function normalizePrefix(input: string | undefined): string {\n  const normalized = (input ?? \"\").trim().toLowerCase();\n  if (!normalized) return \"pm-\";\n  return normalized.endsWith(\"-\") ? normalized : `${normalized}-`;\n}\n\nexport function normalizeRawItemId(input: string): string {\n  let normalized = input.trim().toLowerCase();\n  if (normalized.startsWith(\"#\")) {\n    normalized = normalized.slice(1);\n  }\n  return normalized;\n}\n\nexport function normalizeItemId(input: string, prefix: string): string {\n  const canonicalPrefix = normalizePrefix(prefix);\n  const normalized = normalizeRawItemId(input);\n  if (normalized.startsWith(canonicalPrefix)) {\n    return normalized;\n  }\n  return `${canonicalPrefix}${normalized}`;\n}\n\nfunction randomToken(length: number): string {\n  let token = \"\";\n  for (let index = 0; index < length; index += 1) {\n    token += crypto.randomInt(0, 36).toString(36);\n  }\n  return token;\n}\n\nasync function idExists(pmRoot: string, id: string): Promise<boolean> {\n  const checks = Object.values(TYPE_TO_FOLDER).flatMap((folder) => [\n    path.join(pmRoot, folder, `${id}.md`),\n    path.join(pmRoot, folder, `${id}.toon`),\n  ]);\n  for (const target of checks) {\n    if (await pathExists(target)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport async function generateItemId(pmRoot: string, prefix: string): Promise<string> {\n  let tokenLength = 4;\n  let attempts = 0;\n\n  while (tokenLength <= 10) {\n    for (let i = 0; i < 32; i += 1) {\n      const id = `${normalizePrefix(prefix)}${randomToken(tokenLength)}`;\n      if (!(await idExists(pmRoot, id))) {\n        return id;\n      }\n      attempts += 1;\n    }\n    tokenLength += 1;\n  }\n\n  throw new Error(`Unable to generate unique id after ${attempts} attempts`);\n}\n"],
+  "mappings": ";;;;;;AAAA,OAAO,YAAY;AACnB,OAAO,UAAU;;;;;;;;AAIX,SAAU,gBAAgB,OAAyB;AACvD,QAAM,cAAc,SAAS,IAAI,KAAI,EAAG,YAAW;AACnD,MAAI,CAAC;AAAY,WAAO;AACxB,SAAO,WAAW,SAAS,GAAG,IAAI,aAAa,GAAG,UAAU;AAC9D;AAEM,SAAU,mBAAmB,OAAa;AAC9C,MAAI,aAAa,MAAM,KAAI,EAAG,YAAW;AACzC,MAAI,WAAW,WAAW,GAAG,GAAG;AAC9B,iBAAa,WAAW,MAAM,CAAC;EACjC;AACA,SAAO;AACT;AAEM,SAAU,gBAAgB,OAAe,QAAc;AAC3D,QAAM,kBAAkB,gBAAgB,MAAM;AAC9C,QAAM,aAAa,mBAAmB,KAAK;AAC3C,MAAI,WAAW,WAAW,eAAe,GAAG;AAC1C,WAAO;EACT;AACA,SAAO,GAAG,eAAe,GAAG,UAAU;AACxC;AAEA,SAAS,YAAY,QAAc;AACjC,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,QAAQ,SAAS,GAAG;AAC9C,aAAS,OAAO,UAAU,GAAG,EAAE,EAAE,SAAS,EAAE;EAC9C;AACA,SAAO;AACT;AAEA,eAAe,SAAS,QAAgB,IAAU;AAChD,QAAM,SAAS,OAAO,OAAO,cAAc,EAAE,QAAQ,CAAC,WAAW;IAC/D,KAAK,KAAK,QAAQ,QAAQ,GAAG,EAAE,KAAK;IACpC,KAAK,KAAK,QAAQ,QAAQ,GAAG,EAAE,OAAO;GACvC;AACD,aAAW,UAAU,QAAQ;AAC3B,QAAI,MAAM,WAAW,MAAM,GAAG;AAC5B,aAAO;IACT;EACF;AACA,SAAO;AACT;AAEA,eAAsB,eAAe,QAAgB,QAAc;AACjE,MAAI,cAAc;AAClB,MAAI,WAAW;AAEf,SAAO,eAAe,IAAI;AACxB,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK,GAAG;AAC9B,YAAM,KAAK,GAAG,gBAAgB,MAAM,CAAC,GAAG,YAAY,WAAW,CAAC;AAChE,UAAI,CAAE,MAAM,SAAS,QAAQ,EAAE,GAAI;AACjC,eAAO;MACT;AACA,kBAAY;IACd;AACA,mBAAe;EACjB;AAEA,QAAM,IAAI,MAAM,sCAAsC,QAAQ,WAAW;AAC3E;",
+  "names": []
+}

package/dist/cli-bundle/chunks/{chunk-GU2ZJ2VV.js → chunk-KBKJVXUS.js}

@@ -2,13 +2,13 @@ import {
   listAllFrontMatterLight,
   mutateItem,
   toItemRecord
-} from "./chunk-XTGLRY2Y.js";
+} from "./chunk-2HMD3JM2.js";
 import {
   isTerminalStatus
-} from "./chunk-AO442XLN.js";
+} from "./chunk-M7UBTVFT.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KJE2FOS4.js";
+} from "./chunk-2BYKYPWY.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -17,13 +17,13 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-U5SXYXSY.js";
+} from "./chunk-3TXWDGPU.js";
 
 // dist/cli/commands/close.js
 !(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] = "d3eeb72e-9b81-59a6-8541-cca40d98fab5");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "96f50581-e721-5ccd-b360-651ab15f5cca");
   } catch (e2) {
   }
 })();
@@ -32,12 +32,27 @@ function toAuthor(candidate, defaultAuthor) {
   const trimmed = resolved.trim();
   return trimmed || "unknown";
 }
-function ensureCloseReason(reasonText) {
-  const reason = reasonText.trim();
-  if (reason.length === 0) {
-    throw new PmCliError("Close reason text must not be empty", EXIT_CODE.USAGE);
+function normalizeCloseReason(reasonText, required) {
+  const reason = (reasonText ?? "").trim();
+  if (reason.length > 0) {
+    return reason;
   }
-  return reason;
+  if (required) {
+    throw new PmCliError("Close reason text is required because governance.require_close_reason is enabled", EXIT_CODE.USAGE, {
+      code: "close_reason_required",
+      required: "Provide a one-line closing summary as the positional text or via --reason.",
+      why: "governance.require_close_reason is enabled, so every close must record why the item is done.",
+      examples: [
+        'pm close <id> "Done: <what changed and why>"',
+        'pm close <id> --reason "<closing summary>"'
+      ],
+      nextSteps: [
+        "Re-run the close with a closing summary.",
+        "To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled"
+      ]
+    });
+  }
+  return void 0;
 }
 var CLOSE_VALIDATION_FIELDS = [
   { key: "resolution", label: "resolution" },
@@ -83,7 +98,7 @@ async function runClose(id, closeReasonText, options, global2) {
   const settings = await readSettings(pmRoot);
   const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
   const author = toAuthor(options.author, settings.author_default);
-  const closeReason = ensureCloseReason(closeReasonText);
+  const closeReason = normalizeCloseReason(closeReasonText, settings.governance.require_close_reason);
   const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;
   const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);
   const result = await mutateItem({
@@ -130,8 +145,14 @@ async function runClose(id, closeReasonText, options, global2) {
         mutationWarnings.push(`closed_with_active_children:${document.metadata.id}:${activeChildIds.join(",")}`);
       }
       document.metadata.status = statusRegistry.close_status;
-      document.metadata.close_reason = closeReason;
-      const changedFields = ["status", "close_reason"];
+      const changedFields = ["status"];
+      if (closeReason !== void 0) {
+        document.metadata.close_reason = closeReason;
+        changedFields.push("close_reason");
+      } else if (document.metadata.close_reason !== void 0) {
+        delete document.metadata.close_reason;
+        changedFields.push("close_reason");
+      }
       for (const { option, key } of inlineCloseFields) {
         if (typeof option === "string" && option.trim().length > 0) {
           changedFields.push(key);
@@ -182,4 +203,4 @@ async function runClose(id, closeReasonText, options, global2) {
 export {
   runClose
 };
-//# sourceMappingURL=chunk-GU2ZJ2VV.js.map
+//# sourceMappingURL=chunk-KBKJVXUS.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/close.ts"],
+  "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"],
+  "mappings": "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",
+  "names": ["global"]
+}