@unbrained/pm-cli 2026.7.4 → 2026.7.5

package/dist/cli-bundle/chunks/{chunk-4PJYRA3V.js → chunk-FDBARR33.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-EB4BBEZD.js";
+} from "./chunk-3Y4OESPP.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   historyEntriesToRaw,
@@ -11,38 +11,40 @@ import {
   replayToItemDocument,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-HL742IBM.js";
+} from "./chunk-D3UCE7RW.js";
 import {
   acquireLock,
   createHistoryEntry,
   locateItem,
-  normalizeItemId,
-  normalizeRawItemId,
   readLocatedItem
-} from "./chunk-CN4OAA2G.js";
+} from "./chunk-3U3VEWK6.js";
 import {
   canonicalDocument,
+  normalizeItemId,
+  normalizeRawItemId,
   serializeItemDocument
-} from "./chunk-CQFZRLXQ.js";
+} from "./chunk-EZFKWSC7.js";
 import {
   nowIso
-} from "./chunk-MZG6I2Q2.js";
+} from "./chunk-DRBV5UC2.js";
 import {
-  EXIT_CODE,
   PmCliError,
   getActiveExtensionRegistrations,
+  readSettings,
+  resolveGovernanceKnobs,
+  runActiveOnWriteHooks
+} from "./chunk-P5YORJRH.js";
+import {
+  EXIT_CODE,
   getHistoryPath,
   getItemPath,
   getSettingsPath,
   pathExists,
   readFileIfExists,
-  readSettings,
-  resolveGovernanceKnobs,
   resolveItemTypeRegistry,
   resolvePmRoot,
-  runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-BDDYM4LH.js";
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/history-redact.js
 import fs2 from "node:fs/promises";
@@ -52,7 +54,7 @@ import fs from "node:fs/promises";
 !(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] = "f03392a5-662f-5a2d-97c6-7a51a575dd39");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b9f14848-6edc-507a-a543-7bf01d91db50");
   } catch (e2) {
   }
 })();
@@ -108,7 +110,7 @@ async function executeHistoryRewrite(params) {
     force: params.force,
     settings: params.settings
   })];
-  const releaseLock = await acquireLock(params.pmRoot, params.subject.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock);
+  const releaseLock = await acquireLock(params.pmRoot, params.subject.id, params.settings.locks.ttl_seconds, params.author, Boolean(params.force), params.settings.governance.force_required_for_stale_lock, params.settings.locks.wait_ms);
   try {
     const verified = await verifyHistoryRewriteNoDrift({
       pmRoot: params.pmRoot,
@@ -650,4 +652,4 @@ export {
   runHistoryRedact,
   _testOnly
 };
-//# sourceMappingURL=chunk-4PJYRA3V.js.map
+//# sourceMappingURL=chunk-FDBARR33.js.map

package/dist/cli-bundle/chunks/{chunk-4PJYRA3V.js.map → chunk-FDBARR33.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/history-redact.ts", "../../../../../../../../core/history/history-rewrite.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/history-redact\n *\n * Implements the pm history redact command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { createHistoryEntry } from \"../../core/history/history.js\";\nimport { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  tryApplyReplayPatch,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.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 { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\n/**\n * Documents the history redact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRedactCommandOptions {\n  literal?: string[] | string;\n  regex?: string[] | string;\n  replacement?: string;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\ninterface RegexRule {\n  kind: \"regex\";\n  source: string;\n  flags: string;\n  label: string;\n}\n\ninterface LiteralRule {\n  kind: \"literal\";\n  value: string;\n  label: string;\n}\n\ntype RedactionRule = RegexRule | LiteralRule;\n\ninterface RedactionRewriteResult {\n  entries: HistoryEntry[];\n  finalDocument: ReplayDocument;\n  entriesChanged: number;\n  replacements: number;\n}\n\ninterface HistoryIntegritySnapshot {\n  hashMismatchesBefore: number;\n  hashMismatchesAfter: number;\n  finalDocument: ReplayDocument;\n}\n\ninterface HistoryRedactCurrentItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\ninterface HistoryRedactNextItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\n/**\n * Documents the history subject payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistorySubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n}\n\n/**\n * Documents the history redact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRedactResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  patterns: {\n    literals: string[];\n    regex: string[];\n    replacement: string;\n  };\n  history: {\n    path: string;\n    entries_scanned: number;\n    entries_changed: number;\n    replacements: number;\n    hash_mismatches_before: number;\n    hash_mismatches_after: number;\n    preexisting_hash_mismatches: number;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    existed_before: boolean;\n    exists_after: boolean;\n    path_before: string | null;\n    path_after: string | null;\n    changed: boolean;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction normalizeStringArrayInput(value: string[] | string | undefined): string[] {\n  if (Array.isArray(value)) {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    return [value];\n  }\n  return [];\n}\n\nfunction normalizeRegexFlags(flags: string): string {\n  const unique: string[] = [];\n  for (const token of flags) {\n    if (!unique.includes(token)) {\n      unique.push(token);\n    }\n  }\n  if (!unique.includes(\"g\")) {\n    unique.push(\"g\");\n  }\n  return unique.join(\"\");\n}\n\nfunction parseRegexRule(spec: string): RegexRule {\n  const trimmed = spec.trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\"history-redact --regex requires a non-empty pattern.\", EXIT_CODE.USAGE);\n  }\n\n  let source = trimmed;\n  let flags = \"g\";\n  if (trimmed.startsWith(\"/\") && trimmed.length > 1) {\n    /* c8 ignore start -- bare-slash regex literals are rejected earlier in argument validation. */\n    const slashIndex = trimmed.lastIndexOf(\"/\");\n    if (slashIndex > 0) {\n      source = trimmed.slice(1, slashIndex);\n      flags = normalizeRegexFlags(trimmed.slice(slashIndex + 1));\n    }\n    /* c8 ignore stop */\n  }\n  if (source.length === 0) {\n    throw new PmCliError(\"history-redact --regex cannot use an empty pattern.\", EXIT_CODE.USAGE);\n  }\n  try {\n    new RegExp(source, flags);\n  } catch (error) {\n    /* c8 ignore start -- RegExp constructor failures are normalized in higher-level parser tests. */\n    throw new PmCliError(\n      `Invalid --regex value \"${spec}\": ${error instanceof Error ? error.message : String(error)}`,\n      EXIT_CODE.USAGE,\n    );\n    /* c8 ignore stop */\n  }\n\n  return {\n    kind: \"regex\",\n    source,\n    flags,\n    label: `/${source}/${flags}`,\n  };\n}\n\nfunction buildRedactionRules(\n  literalInput: string[] | string | undefined,\n  regexInput: string[] | string | undefined,\n): RedactionRule[] {\n  const literalRules = [...new Set(normalizeStringArrayInput(literalInput).map((entry) => entry.trim()))]\n    .filter((entry) => entry.length > 0)\n    .map<LiteralRule>((entry) => ({\n      kind: \"literal\",\n      value: entry,\n      label: entry,\n    }));\n  const regexRules = [...new Set(normalizeStringArrayInput(regexInput).map((entry) => entry.trim()))]\n    .filter((entry) => entry.length > 0)\n    .map(parseRegexRule);\n\n  const rules = [...literalRules, ...regexRules];\n  if (rules.length === 0) {\n    throw new PmCliError(\n      \"history-redact requires at least one matcher via --literal or --regex.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\n        required: \"Provide --literal <value> and/or --regex <pattern>.\",\n        examples: [\n          'pm history-redact pm-a1b2 --literal \"[redacted_path_prefix]/private\"',\n          'pm history-redact pm-a1b2 --regex \"/192\\\\\\\\.168\\\\\\\\.[0-9.]+/g\" --replacement \"[scrubbed_ip]\"',\n        ],\n      },\n    );\n  }\n  return rules;\n}\n\nfunction applyLiteralRule(value: string, literal: string, replacement: string): { value: string; replacements: number } {\n  if (literal.length === 0) {\n    return { value, replacements: 0 };\n  }\n  let cursor = 0;\n  let replacements = 0;\n  while (cursor <= value.length) {\n    const index = value.indexOf(literal, cursor);\n    if (index === -1) {\n      break;\n    }\n    replacements += 1;\n    cursor = index + Math.max(1, literal.length);\n  }\n  if (replacements === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.split(literal).join(replacement),\n    replacements,\n  };\n}\n\nfunction applyRegexRule(value: string, rule: RegexRule, replacement: string): { value: string; replacements: number } {\n  const regex = new RegExp(rule.source, rule.flags);\n  const matches = [...value.matchAll(regex)];\n  if (matches.length === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.replace(regex, replacement),\n    replacements: matches.length,\n  };\n}\n\nfunction redactStringValue(value: string, rules: RedactionRule[], replacement: string): { value: string; replacements: number } {\n  let next = value;\n  let replacements = 0;\n  for (const rule of rules) {\n    const result =\n      rule.kind === \"literal\"\n        ? applyLiteralRule(next, rule.value, replacement)\n        : applyRegexRule(next, rule, replacement);\n    next = result.value;\n    replacements += result.replacements;\n  }\n  return {\n    value: next,\n    replacements,\n  };\n}\n\nfunction redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): { value: unknown; replacements: number } {\n  if (typeof value === \"string\") {\n    return redactStringValue(value, rules, replacement);\n  }\n  if (Array.isArray(value)) {\n    let replacements = 0;\n    const nextValues = value.map((entry) => {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      return redacted.value;\n    });\n    return {\n      value: nextValues,\n      replacements,\n    };\n  }\n  if (typeof value === \"object\" && value !== null) {\n    let replacements = 0;\n    const nextRecord: Record<string, unknown> = {};\n    for (const [key, entry] of Object.entries(value)) {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      nextRecord[key] = redacted.value;\n    }\n    return {\n      value: nextRecord,\n      replacements,\n    };\n  }\n  return {\n    value,\n    replacements: 0,\n  };\n}\n\nfunction applyHistoryPatch(current: ReplayDocument, patch: HistoryPatchOp[], entryNumber: number, op: string): ReplayDocument {\n  const result = tryApplyReplayPatch(current, patch);\n  /* c8 ignore start -- invalid patch replay paths are covered by replay helper tests. */\n  if (!result.ok) {\n    throw new PmCliError(\n      `history-redact failed to apply patch at entry ${entryNumber} (op=${op}): ${\n        result.error instanceof Error ? result.error.message : String(result.error)\n      }`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  /* c8 ignore stop */\n  return result.document;\n}\n\nfunction inspectHistoryIntegrity(entries: HistoryEntry[]): HistoryIntegritySnapshot {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let hashMismatchesBefore = 0;\n  let hashMismatchesAfter = 0;\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      hashMismatchesBefore += 1;\n    }\n    replay = applyHistoryPatch(replay, entry.patch, index + 1, entry.op);\n    /* c8 ignore start -- after-hash mismatch branch is exercised in dedicated history integrity tests. */\n    if (replayHash(replay) !== entry.after_hash) {\n      hashMismatchesAfter += 1;\n    }\n    /* c8 ignore stop */\n  }\n  return {\n    hashMismatchesBefore,\n    hashMismatchesAfter,\n    finalDocument: replay,\n  };\n}\n\nfunction redactHistoryEntry(entry: HistoryEntry, rules: RedactionRule[], replacement: string): {\n  entry: HistoryEntry;\n  replacements: number;\n  changed: boolean;\n} {\n  let replacements = 0;\n  let changed = false;\n  let nextMessage = entry.message;\n\n  if (typeof entry.message === \"string\") {\n    const redactedMessage = redactStringValue(entry.message, rules, replacement);\n    nextMessage = redactedMessage.value;\n    replacements += redactedMessage.replacements;\n    if (redactedMessage.replacements > 0) {\n      changed = true;\n    }\n  }\n\n  const nextPatch = entry.patch.map((operation) => {\n    /* c8 ignore start -- patch operations without `value` are covered in lower-level patch adapters. */\n    if (!Object.prototype.hasOwnProperty.call(operation, \"value\")) {\n      return operation;\n    }\n    /* c8 ignore stop */\n    const redactedValue = redactUnknownValue(operation.value, rules, replacement);\n    replacements += redactedValue.replacements;\n    if (redactedValue.replacements > 0) {\n      changed = true;\n      return {\n        ...operation,\n        value: redactedValue.value,\n      };\n    }\n    return operation;\n  });\n\n  return {\n    entry: {\n      ...entry,\n      message: nextMessage,\n      patch: nextPatch,\n    },\n    replacements,\n    changed,\n  };\n}\n\nfunction rewriteHistoryEntries(entries: HistoryEntry[], rules: RedactionRule[], replacement: string): RedactionRewriteResult {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let entriesChanged = 0;\n  let replacements = 0;\n  const rewrittenEntries: HistoryEntry[] = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const redacted = redactHistoryEntry(entries[index], rules, replacement);\n    replacements += redacted.replacements;\n    if (redacted.changed) {\n      entriesChanged += 1;\n    }\n    const beforeHash = replayHash(replay);\n    replay = applyHistoryPatch(replay, redacted.entry.patch, index + 1, redacted.entry.op);\n    const afterHash = replayHash(replay);\n    rewrittenEntries.push({\n      ...redacted.entry,\n      before_hash: beforeHash,\n      after_hash: afterHash,\n    });\n  }\n\n  return {\n    entries: rewrittenEntries,\n    finalDocument: replay,\n    entriesChanged,\n    replacements,\n  };\n}\n\nfunction hasItemMetadata(replay: ReplayDocument): boolean {\n  return Object.keys(replay.metadata).length > 0;\n}\n\nasync function loadHistoryRedactCurrentItem(\n  subject: HistorySubject,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<HistoryRedactCurrentItem> {\n  const currentItemPath = subject.located?.itemPath ?? null;\n  if (!subject.located) {\n    return { raw: null, path: currentItemPath, document: null };\n  }\n  const loaded = await readLocatedItem(subject.located, { schema: settings.schema });\n  return { raw: loaded.raw, path: currentItemPath, document: loaded.document };\n}\n\nfunction resolveHistoryRedactNextItem(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  finalDocument: ReplayDocument;\n}): HistoryRedactNextItem {\n  if (!hasItemMetadata(params.finalDocument)) {\n    return { raw: null, path: null, document: null };\n  }\n  const canonical = canonicalDocument(replayToItemDocument(params.finalDocument), { schema: params.settings.schema });\n  if (canonical.metadata.id !== params.subject.id) {\n    throw new PmCliError(\n      `history-redact would change item id from ${params.subject.id} to ${canonical.metadata.id}; narrow your patterns.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    document: canonical,\n    path: getItemPath(params.pmRoot, canonical.metadata.type, params.subject.id, \"toon\", params.typeToFolder),\n    raw: serializeItemDocument(canonical, {\n      format: \"toon\",\n      schema: params.settings.schema,\n    }),\n  };\n}\n\n/* v8 ignore start -- message passthrough/plural formatting is deterministic around covered redaction outcomes */\nfunction buildHistoryRedactMessage(options: HistoryRedactCommandOptions, rewritten: RedactionRewriteResult): string {\n  if (typeof options.message === \"string\" && options.message.trim().length > 0) {\n    return options.message;\n  }\n  return `history-redact replaced ${rewritten.replacements} match(es) across ${rewritten.entriesChanged} entr${\n    rewritten.entriesChanged === 1 ? \"y\" : \"ies\"\n  }.`;\n}\n/* v8 ignore stop */\n\nfunction buildHistoryRedactEntries(params: {\n  rewritten: RedactionRewriteResult;\n  dryRun: boolean;\n  changed: boolean;\n  nextItemDocument: ItemDocument | null;\n  author: string;\n  message: string;\n}): { rewrittenEntries: HistoryEntry[]; auditEntryAdded: boolean } {\n  const rewrittenEntries = [...params.rewritten.entries];\n  if (params.dryRun || !params.changed) {\n    return { rewrittenEntries, auditEntryAdded: false };\n  }\n  /* c8 ignore next -- fallback replay-to-item conversion runs only when rewritten final metadata is absent. */\n  const finalDocument = params.nextItemDocument ?? replayToItemDocument(params.rewritten.finalDocument);\n  rewrittenEntries.push(\n    createHistoryEntry({\n      nowIso: nowIso(),\n      author: params.author,\n      op: \"history_redact\",\n      before: finalDocument,\n      after: finalDocument,\n      message: params.message,\n    }),\n  );\n  return { rewrittenEntries, auditEntryAdded: true };\n}\n\nasync function applyHistoryRedactRewrite(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string | null;\n  currentItem: HistoryRedactCurrentItem;\n  nextItem: HistoryRedactNextItem;\n  author: string;\n  force: boolean | undefined;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItem.raw,\n    operation: \"history-redact\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.currentItem.document,\n    applyRewrite: async ({ historyRawUnderLock }) => {\n      const affectedItemPaths = new Set<string>();\n      if (params.currentItem.path) {\n        affectedItemPaths.add(params.currentItem.path);\n      }\n      if (params.nextItem.path) {\n        affectedItemPaths.add(params.nextItem.path);\n      }\n      const itemSnapshots = new Map<string, string>();\n      if (params.currentItem.path && params.currentItem.raw !== null) {\n        itemSnapshots.set(params.currentItem.path, params.currentItem.raw);\n      }\n      try {\n        /* c8 ignore next -- item-write diff branch requires path and content divergence under lock races. */\n        if (params.nextItem.path && params.nextItem.raw !== null && params.nextItem.raw !== params.currentItem.raw) {\n          await writeFileAtomic(params.nextItem.path, params.nextItem.raw);\n        }\n        if (params.currentItem.path && (!params.nextItem.path || params.nextItem.path !== params.currentItem.path)) {\n          await fs.rm(params.currentItem.path, { force: true });\n        }\n        await writeFileAtomic(params.subject.historyPath, historyEntriesToRaw(params.rewrittenEntries));\n      } catch (error) {\n        await rollbackHistoryRedactRewrite(params.subject.historyPath, historyRawUnderLock, affectedItemPaths, itemSnapshots);\n        throw error;\n      }\n    },\n    applyPostRewrite: async () => runHistoryRedactWriteHooks(params.subject.historyPath, [\n      params.nextItem.path,\n      params.currentItem.path,\n    ]),\n  });\n}\n\nasync function rollbackHistoryRedactRewrite(\n  historyPath: string,\n  historyRawUnderLock: string | null,\n  affectedItemPaths: Set<string>,\n  itemSnapshots: Map<string, string>,\n): Promise<void> {\n  /* c8 ignore start -- no-history-under-lock rollback path is exercised in lock-race integration tests. */\n  if (historyRawUnderLock === null) {\n    await fs.rm(historyPath, { force: true });\n  } else {\n    await writeFileAtomic(historyPath, historyRawUnderLock);\n  }\n  /* c8 ignore stop */\n  for (const itemPath of affectedItemPaths) {\n    const snapshot = itemSnapshots.get(itemPath);\n    /* c8 ignore start -- missing snapshot rollback occurs only for create/delete race permutations. */\n    if (snapshot === undefined) {\n      await fs.rm(itemPath, { force: true });\n    } else {\n      await writeFileAtomic(itemPath, snapshot);\n    }\n    /* c8 ignore stop */\n  }\n}\n\nasync function runHistoryRedactWriteHooks(historyPath: string, itemHookPaths: Array<string | null>): Promise<string[]> {\n  const hookWarnings: string[] = [];\n  const uniqueItemHookPaths = new Set(itemHookPaths.filter((itemPath): itemPath is string => itemPath !== null));\n  for (const itemHookPath of uniqueItemHookPaths) {\n    hookWarnings.push(\n      ...(await runActiveOnWriteHooks({\n        path: itemHookPath,\n        scope: \"project\",\n        op: \"history_redact\",\n      })),\n    );\n  }\n  hookWarnings.push(\n    ...(await runActiveOnWriteHooks({\n      path: historyPath,\n      scope: \"project\",\n      op: \"history_redact:history\",\n    })),\n  );\n  return hookWarnings;\n}\n\n/**\n * Implements resolve history subject for the public runtime surface of this module.\n */\nexport async function resolveHistorySubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<HistorySubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    return {\n      id: located.id,\n      historyPath: getHistoryPath(pmRoot, located.id),\n      located,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n      };\n    }\n  }\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\n/**\n * Implements run history redact for the public runtime surface of this module.\n */\nexport async function runHistoryRedact(\n  id: string,\n  options: HistoryRedactCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRedactResult> {\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 typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const replacement = typeof options.replacement === \"string\" && options.replacement.length > 0 ? options.replacement : \"[redacted]\";\n  const rules = buildRedactionRules(options.literal, options.regex);\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to redact.`, EXIT_CODE.USAGE);\n  }\n\n  const integritySnapshot = inspectHistoryIntegrity(historyEntries);\n  const rewritten = rewriteHistoryEntries(historyEntries, rules, replacement);\n  const preexistingHashMismatches = integritySnapshot.hashMismatchesBefore + integritySnapshot.hashMismatchesAfter;\n  const dryRun = Boolean(options.dryRun);\n  const changed = rewritten.replacements > 0;\n  const warnings: string[] = [];\n  if (preexistingHashMismatches > 0) {\n    warnings.push(`history_redact_preexisting_hash_mismatches:${preexistingHashMismatches}`);\n  }\n  if (!changed) {\n    warnings.push(\"history_redact_no_matches\");\n  }\n\n  const currentItem = await loadHistoryRedactCurrentItem(subject, settings);\n  const nextItem = resolveHistoryRedactNextItem({\n    pmRoot,\n    subject,\n    settings,\n    typeToFolder: typeRegistry.type_to_folder,\n    finalDocument: rewritten.finalDocument,\n  });\n\n  const itemChanged =\n    /* c8 ignore next -- null-coalescing item-path comparison branch is exercised in broader command integration coverage. */\n    (currentItem.path ?? null) !== (nextItem.path ?? null) ||\n    /* c8 ignore next -- null-coalescing item-content comparison branch is exercised in broader command integration coverage. */\n    (currentItem.raw ?? null) !== (nextItem.raw ?? null);\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const redactionMessage = buildHistoryRedactMessage(options, rewritten);\n  const { rewrittenEntries, auditEntryAdded } = buildHistoryRedactEntries({\n    rewritten,\n    dryRun,\n    changed,\n    nextItemDocument: nextItem.document,\n    author,\n    message: redactionMessage,\n  });\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  /* c8 ignore start -- invalid rewritten chains are covered by history verification unit tests. */\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-redact produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  /* c8 ignore stop */\n\n  if (!dryRun && changed) {\n    warnings.push(\n      ...(await applyHistoryRedactRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItem,\n        nextItem,\n        author,\n        force: options.force,\n        rewrittenEntries,\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    patterns: {\n      literals: rules.filter((rule): rule is LiteralRule => rule.kind === \"literal\").map((rule) => rule.value),\n      regex: rules.filter((rule): rule is RegexRule => rule.kind === \"regex\").map((rule) => `/${rule.source}/${rule.flags}`),\n      replacement,\n    },\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      entries_changed: rewritten.entriesChanged,\n      replacements: rewritten.replacements,\n      hash_mismatches_before: integritySnapshot.hashMismatchesBefore,\n      hash_mismatches_after: integritySnapshot.hashMismatchesAfter,\n      preexisting_hash_mismatches: preexistingHashMismatches,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      existed_before: currentItem.path !== null,\n      exists_after: nextItem.path !== null,\n      path_before: currentItem.path,\n      path_after: nextItem.path,\n      changed: itemChanged,\n    },\n    /* c8 ignore next -- warning dedupe ordering is covered indirectly by command-level smoke tests. */\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n\nexport const _testOnly = {\n  applyLiteralRule,\n  applyRegexRule,\n  buildRedactionRules,\n  hasItemMetadata,\n  normalizeRegexFlags,\n  normalizeStringArrayInput,\n  parseRegexRule,\n  redactStringValue,\n  redactUnknownValue,\n};\n", "/**\n * @module core/history/history-rewrite\n *\n * Implements append-only history and replay behavior for History Rewrite.\n */\nimport fs from \"node:fs/promises\";\nimport { readFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport type { ItemTypeRegistry } from \"../item/type-registry.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { resolveGovernanceKnobs } from \"../store/settings.js\";\nimport type { ItemDocument, PmSettings } from \"../../types/index.js\";\n\ntype LoadedItem = Awaited<ReturnType<typeof readLocatedItem>>;\ntype HistoryRawWriter = (filePath: string, content: string) => Promise<void>;\n\n/**\n * Documents the history rewrite subject payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRewriteSubject {\n  id: string;\n  historyPath: string;\n}\n\n/**\n * Documents the history rewrite ownership params payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRewriteOwnershipParams {\n  itemDocument: ItemDocument | null;\n  subjectId: string;\n  author: string;\n  force: boolean | undefined;\n  settings: PmSettings;\n}\n\n/**\n * Apply ownership_enforcement governance to a history-rewriting operation.\n * Returns the warning(s) the caller should append (empty when no conflict or strict-throws).\n * Throws PmCliError(CONFLICT) in strict mode when the assignee conflicts and --force is not set.\n */\nexport function checkHistoryRewriteOwnership(params: HistoryRewriteOwnershipParams): string[] {\n  if (!params.itemDocument) return [];\n  const assigned = params.itemDocument.metadata?.assignee?.trim();\n  if (!assigned || assigned === params.author || params.force) return [];\n\n  const governance = resolveGovernanceKnobs(params.settings);\n  if (governance.ownership_enforcement === \"strict\") {\n    throw new PmCliError(\n      `Item ${params.subjectId} is assigned to ${assigned}. Use --force to override.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  if (governance.ownership_enforcement === \"warn\") {\n    return [`ownership_warning:assignee_conflict:${params.subjectId}:${assigned}`];\n  }\n  return [];\n}\n\n/**\n * Documents the verify history rewrite drift params payload exchanged by command, SDK, and package integrations.\n */\nexport interface VerifyHistoryRewriteDriftParams {\n  pmRoot: string;\n  subject: HistoryRewriteSubject;\n  settings: PmSettings;\n  typeRegistry: ItemTypeRegistry;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in the conflict message (e.g. \"history-redact\"). */\n  operation: string;\n}\n\n/**\n * Documents the verified history rewrite state payload exchanged by command, SDK, and package integrations.\n */\nexport interface VerifiedHistoryRewriteState {\n  historyRawUnderLock: string | null;\n  locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;\n  loadedItemUnderLock: LoadedItem | null;\n}\n\n/**\n * Re-read the history stream and the located item document under the acquired lock and\n * compare both with the pre-lock raw snapshots. Throws PmCliError(CONFLICT) if either\n * diverged while waiting for the lock so the caller surfaces an actionable retry.\n */\nexport async function verifyHistoryRewriteNoDrift(\n  params: VerifyHistoryRewriteDriftParams,\n): Promise<VerifiedHistoryRewriteState> {\n  const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(\n      `History for ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeRegistry.type_to_folder,\n  );\n  const loadedItemUnderLock = locatedUnderLock\n    ? await readLocatedItem(locatedUnderLock, { schema: params.settings.schema })\n    : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== (params.currentItemRawBeforeLock ?? null)) {\n    throw new PmCliError(\n      `Item ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return { historyRawUnderLock, locatedUnderLock, loadedItemUnderLock };\n}\n\n/**\n * Documents the execute history rewrite params payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExecuteHistoryRewriteParams {\n  pmRoot: string;\n  subject: HistoryRewriteSubject;\n  settings: PmSettings;\n  typeRegistry: ItemTypeRegistry;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in conflict guidance (e.g. \"history-redact\"). */\n  operation: string;\n  author: string;\n  force: boolean | undefined;\n  itemDocument: ItemDocument | null;\n  applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;\n  applyPostRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<string[]>;\n}\n\n/**\n * Writes the rewritten history stream and restores the under-lock snapshot on failure.\n */\nexport async function writeHistoryRawWithRollback(params: {\n  historyPath: string;\n  nextHistoryRaw: string;\n  historyRawUnderLock: string | null;\n  writeHistoryRaw?: HistoryRawWriter;\n}): Promise<void> {\n  const writeHistoryRaw = params.writeHistoryRaw ?? writeFileAtomic;\n  try {\n    await writeHistoryRaw(params.historyPath, params.nextHistoryRaw);\n  } catch (error) {\n    try {\n      if (params.historyRawUnderLock === null) {\n        await fs.rm(params.historyPath, { force: true });\n      } else {\n        await writeHistoryRaw(params.historyPath, params.historyRawUnderLock);\n      }\n    } catch (rollbackError) {\n      throw new AggregateError(\n        [error, rollbackError],\n        `History rewrite failed and rollback also failed: ${String(error)}`,\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Shared lock/verify/ownership orchestration for history-rewrite commands.\n * Callers provide the operation-specific write/rollback logic and optional\n * post-write hook execution while this helper enforces the common governance +\n * lock sequencing contract.\n */\nexport async function executeHistoryRewrite(params: ExecuteHistoryRewriteParams): Promise<string[]> {\n  const warnings = [...checkHistoryRewriteOwnership({\n    itemDocument: params.itemDocument,\n    subjectId: params.subject.id,\n    author: params.author,\n    force: params.force,\n    settings: params.settings,\n  })];\n  const releaseLock = await acquireLock(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.locks.ttl_seconds,\n    params.author,\n    Boolean(params.force),\n    params.settings.governance.force_required_for_stale_lock,\n  );\n  try {\n    const verified = await verifyHistoryRewriteNoDrift({\n      pmRoot: params.pmRoot,\n      subject: params.subject,\n      settings: params.settings,\n      typeRegistry: params.typeRegistry,\n      historyRawBeforeLock: params.historyRawBeforeLock,\n      currentItemRawBeforeLock: params.currentItemRawBeforeLock,\n      operation: params.operation,\n    });\n    await params.applyRewrite(verified);\n    if (params.applyPostRewrite) {\n      warnings.push(...(await params.applyPostRewrite(verified)));\n    }\n    return warnings;\n  } finally {\n    await releaseLock();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @module cli/commands/history-redact\n *\n * Implements the pm history redact command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { createHistoryEntry } from \"../../core/history/history.js\";\nimport { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  tryApplyReplayPatch,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.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 { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\n/**\n * Documents the history redact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRedactCommandOptions {\n  literal?: string[] | string;\n  regex?: string[] | string;\n  replacement?: string;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\ninterface RegexRule {\n  kind: \"regex\";\n  source: string;\n  flags: string;\n  label: string;\n}\n\ninterface LiteralRule {\n  kind: \"literal\";\n  value: string;\n  label: string;\n}\n\ntype RedactionRule = RegexRule | LiteralRule;\n\ninterface RedactionRewriteResult {\n  entries: HistoryEntry[];\n  finalDocument: ReplayDocument;\n  entriesChanged: number;\n  replacements: number;\n}\n\ninterface HistoryIntegritySnapshot {\n  hashMismatchesBefore: number;\n  hashMismatchesAfter: number;\n  finalDocument: ReplayDocument;\n}\n\ninterface HistoryRedactCurrentItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\ninterface HistoryRedactNextItem {\n  raw: string | null;\n  path: string | null;\n  document: ItemDocument | null;\n}\n\n/**\n * Documents the history subject payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistorySubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n}\n\n/**\n * Documents the history redact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRedactResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  patterns: {\n    literals: string[];\n    regex: string[];\n    replacement: string;\n  };\n  history: {\n    path: string;\n    entries_scanned: number;\n    entries_changed: number;\n    replacements: number;\n    hash_mismatches_before: number;\n    hash_mismatches_after: number;\n    preexisting_hash_mismatches: number;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    existed_before: boolean;\n    exists_after: boolean;\n    path_before: string | null;\n    path_after: string | null;\n    changed: boolean;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction normalizeStringArrayInput(value: string[] | string | undefined): string[] {\n  if (Array.isArray(value)) {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    return [value];\n  }\n  return [];\n}\n\nfunction normalizeRegexFlags(flags: string): string {\n  const unique: string[] = [];\n  for (const token of flags) {\n    if (!unique.includes(token)) {\n      unique.push(token);\n    }\n  }\n  if (!unique.includes(\"g\")) {\n    unique.push(\"g\");\n  }\n  return unique.join(\"\");\n}\n\nfunction parseRegexRule(spec: string): RegexRule {\n  const trimmed = spec.trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\"history-redact --regex requires a non-empty pattern.\", EXIT_CODE.USAGE);\n  }\n\n  let source = trimmed;\n  let flags = \"g\";\n  if (trimmed.startsWith(\"/\") && trimmed.length > 1) {\n    /* c8 ignore start -- bare-slash regex literals are rejected earlier in argument validation. */\n    const slashIndex = trimmed.lastIndexOf(\"/\");\n    if (slashIndex > 0) {\n      source = trimmed.slice(1, slashIndex);\n      flags = normalizeRegexFlags(trimmed.slice(slashIndex + 1));\n    }\n    /* c8 ignore stop */\n  }\n  if (source.length === 0) {\n    throw new PmCliError(\"history-redact --regex cannot use an empty pattern.\", EXIT_CODE.USAGE);\n  }\n  try {\n    new RegExp(source, flags);\n  } catch (error) {\n    /* c8 ignore start -- RegExp constructor failures are normalized in higher-level parser tests. */\n    throw new PmCliError(\n      `Invalid --regex value \"${spec}\": ${error instanceof Error ? error.message : String(error)}`,\n      EXIT_CODE.USAGE,\n    );\n    /* c8 ignore stop */\n  }\n\n  return {\n    kind: \"regex\",\n    source,\n    flags,\n    label: `/${source}/${flags}`,\n  };\n}\n\nfunction buildRedactionRules(\n  literalInput: string[] | string | undefined,\n  regexInput: string[] | string | undefined,\n): RedactionRule[] {\n  const literalRules = [...new Set(normalizeStringArrayInput(literalInput).map((entry) => entry.trim()))]\n    .filter((entry) => entry.length > 0)\n    .map<LiteralRule>((entry) => ({\n      kind: \"literal\",\n      value: entry,\n      label: entry,\n    }));\n  const regexRules = [...new Set(normalizeStringArrayInput(regexInput).map((entry) => entry.trim()))]\n    .filter((entry) => entry.length > 0)\n    .map(parseRegexRule);\n\n  const rules = [...literalRules, ...regexRules];\n  if (rules.length === 0) {\n    throw new PmCliError(\n      \"history-redact requires at least one matcher via --literal or --regex.\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"missing_required_argument\",\n        required: \"Provide --literal <value> and/or --regex <pattern>.\",\n        examples: [\n          'pm history-redact pm-a1b2 --literal \"[redacted_path_prefix]/private\"',\n          'pm history-redact pm-a1b2 --regex \"/192\\\\\\\\.168\\\\\\\\.[0-9.]+/g\" --replacement \"[scrubbed_ip]\"',\n        ],\n      },\n    );\n  }\n  return rules;\n}\n\nfunction applyLiteralRule(value: string, literal: string, replacement: string): { value: string; replacements: number } {\n  if (literal.length === 0) {\n    return { value, replacements: 0 };\n  }\n  let cursor = 0;\n  let replacements = 0;\n  while (cursor <= value.length) {\n    const index = value.indexOf(literal, cursor);\n    if (index === -1) {\n      break;\n    }\n    replacements += 1;\n    cursor = index + Math.max(1, literal.length);\n  }\n  if (replacements === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.split(literal).join(replacement),\n    replacements,\n  };\n}\n\nfunction applyRegexRule(value: string, rule: RegexRule, replacement: string): { value: string; replacements: number } {\n  const regex = new RegExp(rule.source, rule.flags);\n  const matches = [...value.matchAll(regex)];\n  if (matches.length === 0) {\n    return { value, replacements: 0 };\n  }\n  return {\n    value: value.replace(regex, replacement),\n    replacements: matches.length,\n  };\n}\n\nfunction redactStringValue(value: string, rules: RedactionRule[], replacement: string): { value: string; replacements: number } {\n  let next = value;\n  let replacements = 0;\n  for (const rule of rules) {\n    const result =\n      rule.kind === \"literal\"\n        ? applyLiteralRule(next, rule.value, replacement)\n        : applyRegexRule(next, rule, replacement);\n    next = result.value;\n    replacements += result.replacements;\n  }\n  return {\n    value: next,\n    replacements,\n  };\n}\n\nfunction redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): { value: unknown; replacements: number } {\n  if (typeof value === \"string\") {\n    return redactStringValue(value, rules, replacement);\n  }\n  if (Array.isArray(value)) {\n    let replacements = 0;\n    const nextValues = value.map((entry) => {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      return redacted.value;\n    });\n    return {\n      value: nextValues,\n      replacements,\n    };\n  }\n  if (typeof value === \"object\" && value !== null) {\n    let replacements = 0;\n    const nextRecord: Record<string, unknown> = {};\n    for (const [key, entry] of Object.entries(value)) {\n      const redacted = redactUnknownValue(entry, rules, replacement);\n      replacements += redacted.replacements;\n      nextRecord[key] = redacted.value;\n    }\n    return {\n      value: nextRecord,\n      replacements,\n    };\n  }\n  return {\n    value,\n    replacements: 0,\n  };\n}\n\nfunction applyHistoryPatch(current: ReplayDocument, patch: HistoryPatchOp[], entryNumber: number, op: string): ReplayDocument {\n  const result = tryApplyReplayPatch(current, patch);\n  /* c8 ignore start -- invalid patch replay paths are covered by replay helper tests. */\n  if (!result.ok) {\n    throw new PmCliError(\n      `history-redact failed to apply patch at entry ${entryNumber} (op=${op}): ${\n        result.error instanceof Error ? result.error.message : String(result.error)\n      }`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  /* c8 ignore stop */\n  return result.document;\n}\n\nfunction inspectHistoryIntegrity(entries: HistoryEntry[]): HistoryIntegritySnapshot {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let hashMismatchesBefore = 0;\n  let hashMismatchesAfter = 0;\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      hashMismatchesBefore += 1;\n    }\n    replay = applyHistoryPatch(replay, entry.patch, index + 1, entry.op);\n    /* c8 ignore start -- after-hash mismatch branch is exercised in dedicated history integrity tests. */\n    if (replayHash(replay) !== entry.after_hash) {\n      hashMismatchesAfter += 1;\n    }\n    /* c8 ignore stop */\n  }\n  return {\n    hashMismatchesBefore,\n    hashMismatchesAfter,\n    finalDocument: replay,\n  };\n}\n\nfunction redactHistoryEntry(entry: HistoryEntry, rules: RedactionRule[], replacement: string): {\n  entry: HistoryEntry;\n  replacements: number;\n  changed: boolean;\n} {\n  let replacements = 0;\n  let changed = false;\n  let nextMessage = entry.message;\n\n  if (typeof entry.message === \"string\") {\n    const redactedMessage = redactStringValue(entry.message, rules, replacement);\n    nextMessage = redactedMessage.value;\n    replacements += redactedMessage.replacements;\n    if (redactedMessage.replacements > 0) {\n      changed = true;\n    }\n  }\n\n  const nextPatch = entry.patch.map((operation) => {\n    /* c8 ignore start -- patch operations without `value` are covered in lower-level patch adapters. */\n    if (!Object.prototype.hasOwnProperty.call(operation, \"value\")) {\n      return operation;\n    }\n    /* c8 ignore stop */\n    const redactedValue = redactUnknownValue(operation.value, rules, replacement);\n    replacements += redactedValue.replacements;\n    if (redactedValue.replacements > 0) {\n      changed = true;\n      return {\n        ...operation,\n        value: redactedValue.value,\n      };\n    }\n    return operation;\n  });\n\n  return {\n    entry: {\n      ...entry,\n      message: nextMessage,\n      patch: nextPatch,\n    },\n    replacements,\n    changed,\n  };\n}\n\nfunction rewriteHistoryEntries(entries: HistoryEntry[], rules: RedactionRule[], replacement: string): RedactionRewriteResult {\n  let replay = structuredClone(EMPTY_REPLAY_DOCUMENT);\n  let entriesChanged = 0;\n  let replacements = 0;\n  const rewrittenEntries: HistoryEntry[] = [];\n\n  for (let index = 0; index < entries.length; index += 1) {\n    const redacted = redactHistoryEntry(entries[index], rules, replacement);\n    replacements += redacted.replacements;\n    if (redacted.changed) {\n      entriesChanged += 1;\n    }\n    const beforeHash = replayHash(replay);\n    replay = applyHistoryPatch(replay, redacted.entry.patch, index + 1, redacted.entry.op);\n    const afterHash = replayHash(replay);\n    rewrittenEntries.push({\n      ...redacted.entry,\n      before_hash: beforeHash,\n      after_hash: afterHash,\n    });\n  }\n\n  return {\n    entries: rewrittenEntries,\n    finalDocument: replay,\n    entriesChanged,\n    replacements,\n  };\n}\n\nfunction hasItemMetadata(replay: ReplayDocument): boolean {\n  return Object.keys(replay.metadata).length > 0;\n}\n\nasync function loadHistoryRedactCurrentItem(\n  subject: HistorySubject,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n): Promise<HistoryRedactCurrentItem> {\n  const currentItemPath = subject.located?.itemPath ?? null;\n  if (!subject.located) {\n    return { raw: null, path: currentItemPath, document: null };\n  }\n  const loaded = await readLocatedItem(subject.located, { schema: settings.schema });\n  return { raw: loaded.raw, path: currentItemPath, document: loaded.document };\n}\n\nfunction resolveHistoryRedactNextItem(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n  finalDocument: ReplayDocument;\n}): HistoryRedactNextItem {\n  if (!hasItemMetadata(params.finalDocument)) {\n    return { raw: null, path: null, document: null };\n  }\n  const canonical = canonicalDocument(replayToItemDocument(params.finalDocument), { schema: params.settings.schema });\n  if (canonical.metadata.id !== params.subject.id) {\n    throw new PmCliError(\n      `history-redact would change item id from ${params.subject.id} to ${canonical.metadata.id}; narrow your patterns.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    document: canonical,\n    path: getItemPath(params.pmRoot, canonical.metadata.type, params.subject.id, \"toon\", params.typeToFolder),\n    raw: serializeItemDocument(canonical, {\n      format: \"toon\",\n      schema: params.settings.schema,\n    }),\n  };\n}\n\n/* v8 ignore start -- message passthrough/plural formatting is deterministic around covered redaction outcomes */\nfunction buildHistoryRedactMessage(options: HistoryRedactCommandOptions, rewritten: RedactionRewriteResult): string {\n  if (typeof options.message === \"string\" && options.message.trim().length > 0) {\n    return options.message;\n  }\n  return `history-redact replaced ${rewritten.replacements} match(es) across ${rewritten.entriesChanged} entr${\n    rewritten.entriesChanged === 1 ? \"y\" : \"ies\"\n  }.`;\n}\n/* v8 ignore stop */\n\nfunction buildHistoryRedactEntries(params: {\n  rewritten: RedactionRewriteResult;\n  dryRun: boolean;\n  changed: boolean;\n  nextItemDocument: ItemDocument | null;\n  author: string;\n  message: string;\n}): { rewrittenEntries: HistoryEntry[]; auditEntryAdded: boolean } {\n  const rewrittenEntries = [...params.rewritten.entries];\n  if (params.dryRun || !params.changed) {\n    return { rewrittenEntries, auditEntryAdded: false };\n  }\n  /* c8 ignore next -- fallback replay-to-item conversion runs only when rewritten final metadata is absent. */\n  const finalDocument = params.nextItemDocument ?? replayToItemDocument(params.rewritten.finalDocument);\n  rewrittenEntries.push(\n    createHistoryEntry({\n      nowIso: nowIso(),\n      author: params.author,\n      op: \"history_redact\",\n      before: finalDocument,\n      after: finalDocument,\n      message: params.message,\n    }),\n  );\n  return { rewrittenEntries, auditEntryAdded: true };\n}\n\nasync function applyHistoryRedactRewrite(params: {\n  pmRoot: string;\n  subject: HistorySubject;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string | null;\n  currentItem: HistoryRedactCurrentItem;\n  nextItem: HistoryRedactNextItem;\n  author: string;\n  force: boolean | undefined;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItem.raw,\n    operation: \"history-redact\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.currentItem.document,\n    applyRewrite: async ({ historyRawUnderLock }) => {\n      const affectedItemPaths = new Set<string>();\n      if (params.currentItem.path) {\n        affectedItemPaths.add(params.currentItem.path);\n      }\n      if (params.nextItem.path) {\n        affectedItemPaths.add(params.nextItem.path);\n      }\n      const itemSnapshots = new Map<string, string>();\n      if (params.currentItem.path && params.currentItem.raw !== null) {\n        itemSnapshots.set(params.currentItem.path, params.currentItem.raw);\n      }\n      try {\n        /* c8 ignore next -- item-write diff branch requires path and content divergence under lock races. */\n        if (params.nextItem.path && params.nextItem.raw !== null && params.nextItem.raw !== params.currentItem.raw) {\n          await writeFileAtomic(params.nextItem.path, params.nextItem.raw);\n        }\n        if (params.currentItem.path && (!params.nextItem.path || params.nextItem.path !== params.currentItem.path)) {\n          await fs.rm(params.currentItem.path, { force: true });\n        }\n        await writeFileAtomic(params.subject.historyPath, historyEntriesToRaw(params.rewrittenEntries));\n      } catch (error) {\n        await rollbackHistoryRedactRewrite(params.subject.historyPath, historyRawUnderLock, affectedItemPaths, itemSnapshots);\n        throw error;\n      }\n    },\n    applyPostRewrite: async () => runHistoryRedactWriteHooks(params.subject.historyPath, [\n      params.nextItem.path,\n      params.currentItem.path,\n    ]),\n  });\n}\n\nasync function rollbackHistoryRedactRewrite(\n  historyPath: string,\n  historyRawUnderLock: string | null,\n  affectedItemPaths: Set<string>,\n  itemSnapshots: Map<string, string>,\n): Promise<void> {\n  /* c8 ignore start -- no-history-under-lock rollback path is exercised in lock-race integration tests. */\n  if (historyRawUnderLock === null) {\n    await fs.rm(historyPath, { force: true });\n  } else {\n    await writeFileAtomic(historyPath, historyRawUnderLock);\n  }\n  /* c8 ignore stop */\n  for (const itemPath of affectedItemPaths) {\n    const snapshot = itemSnapshots.get(itemPath);\n    /* c8 ignore start -- missing snapshot rollback occurs only for create/delete race permutations. */\n    if (snapshot === undefined) {\n      await fs.rm(itemPath, { force: true });\n    } else {\n      await writeFileAtomic(itemPath, snapshot);\n    }\n    /* c8 ignore stop */\n  }\n}\n\nasync function runHistoryRedactWriteHooks(historyPath: string, itemHookPaths: Array<string | null>): Promise<string[]> {\n  const hookWarnings: string[] = [];\n  const uniqueItemHookPaths = new Set(itemHookPaths.filter((itemPath): itemPath is string => itemPath !== null));\n  for (const itemHookPath of uniqueItemHookPaths) {\n    hookWarnings.push(\n      ...(await runActiveOnWriteHooks({\n        path: itemHookPath,\n        scope: \"project\",\n        op: \"history_redact\",\n      })),\n    );\n  }\n  hookWarnings.push(\n    ...(await runActiveOnWriteHooks({\n      path: historyPath,\n      scope: \"project\",\n      op: \"history_redact:history\",\n    })),\n  );\n  return hookWarnings;\n}\n\n/**\n * Implements resolve history subject for the public runtime surface of this module.\n */\nexport async function resolveHistorySubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<HistorySubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    return {\n      id: located.id,\n      historyPath: getHistoryPath(pmRoot, located.id),\n      located,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n      };\n    }\n  }\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\n/**\n * Implements run history redact for the public runtime surface of this module.\n */\nexport async function runHistoryRedact(\n  id: string,\n  options: HistoryRedactCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRedactResult> {\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 typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const replacement = typeof options.replacement === \"string\" && options.replacement.length > 0 ? options.replacement : \"[redacted]\";\n  const rules = buildRedactionRules(options.literal, options.regex);\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to redact.`, EXIT_CODE.USAGE);\n  }\n\n  const integritySnapshot = inspectHistoryIntegrity(historyEntries);\n  const rewritten = rewriteHistoryEntries(historyEntries, rules, replacement);\n  const preexistingHashMismatches = integritySnapshot.hashMismatchesBefore + integritySnapshot.hashMismatchesAfter;\n  const dryRun = Boolean(options.dryRun);\n  const changed = rewritten.replacements > 0;\n  const warnings: string[] = [];\n  if (preexistingHashMismatches > 0) {\n    warnings.push(`history_redact_preexisting_hash_mismatches:${preexistingHashMismatches}`);\n  }\n  if (!changed) {\n    warnings.push(\"history_redact_no_matches\");\n  }\n\n  const currentItem = await loadHistoryRedactCurrentItem(subject, settings);\n  const nextItem = resolveHistoryRedactNextItem({\n    pmRoot,\n    subject,\n    settings,\n    typeToFolder: typeRegistry.type_to_folder,\n    finalDocument: rewritten.finalDocument,\n  });\n\n  const itemChanged =\n    /* c8 ignore next -- null-coalescing item-path comparison branch is exercised in broader command integration coverage. */\n    (currentItem.path ?? null) !== (nextItem.path ?? null) ||\n    /* c8 ignore next -- null-coalescing item-content comparison branch is exercised in broader command integration coverage. */\n    (currentItem.raw ?? null) !== (nextItem.raw ?? null);\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const redactionMessage = buildHistoryRedactMessage(options, rewritten);\n  const { rewrittenEntries, auditEntryAdded } = buildHistoryRedactEntries({\n    rewritten,\n    dryRun,\n    changed,\n    nextItemDocument: nextItem.document,\n    author,\n    message: redactionMessage,\n  });\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  /* c8 ignore start -- invalid rewritten chains are covered by history verification unit tests. */\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-redact produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  /* c8 ignore stop */\n\n  if (!dryRun && changed) {\n    warnings.push(\n      ...(await applyHistoryRedactRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItem,\n        nextItem,\n        author,\n        force: options.force,\n        rewrittenEntries,\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    patterns: {\n      literals: rules.filter((rule): rule is LiteralRule => rule.kind === \"literal\").map((rule) => rule.value),\n      regex: rules.filter((rule): rule is RegexRule => rule.kind === \"regex\").map((rule) => `/${rule.source}/${rule.flags}`),\n      replacement,\n    },\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      entries_changed: rewritten.entriesChanged,\n      replacements: rewritten.replacements,\n      hash_mismatches_before: integritySnapshot.hashMismatchesBefore,\n      hash_mismatches_after: integritySnapshot.hashMismatchesAfter,\n      preexisting_hash_mismatches: preexistingHashMismatches,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      existed_before: currentItem.path !== null,\n      exists_after: nextItem.path !== null,\n      path_before: currentItem.path,\n      path_after: nextItem.path,\n      changed: itemChanged,\n    },\n    /* c8 ignore next -- warning dedupe ordering is covered indirectly by command-level smoke tests. */\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n\nexport const _testOnly = {\n  applyLiteralRule,\n  applyRegexRule,\n  buildRedactionRules,\n  hasItemMetadata,\n  normalizeRegexFlags,\n  normalizeStringArrayInput,\n  parseRegexRule,\n  redactStringValue,\n  redactUnknownValue,\n};\n", "/**\n * @module core/history/history-rewrite\n *\n * Implements append-only history and replay behavior for History Rewrite.\n */\nimport fs from \"node:fs/promises\";\nimport { readFileIfExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport type { ItemTypeRegistry } from \"../item/type-registry.js\";\nimport { acquireLock } from \"../lock/lock.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { locateItem, readLocatedItem } from \"../store/item-store.js\";\nimport { resolveGovernanceKnobs } from \"../store/settings.js\";\nimport type { ItemDocument, PmSettings } from \"../../types/index.js\";\n\ntype LoadedItem = Awaited<ReturnType<typeof readLocatedItem>>;\ntype HistoryRawWriter = (filePath: string, content: string) => Promise<void>;\n\n/**\n * Documents the history rewrite subject payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRewriteSubject {\n  id: string;\n  historyPath: string;\n}\n\n/**\n * Documents the history rewrite ownership params payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRewriteOwnershipParams {\n  itemDocument: ItemDocument | null;\n  subjectId: string;\n  author: string;\n  force: boolean | undefined;\n  settings: PmSettings;\n}\n\n/**\n * Apply ownership_enforcement governance to a history-rewriting operation.\n * Returns the warning(s) the caller should append (empty when no conflict or strict-throws).\n * Throws PmCliError(CONFLICT) in strict mode when the assignee conflicts and --force is not set.\n */\nexport function checkHistoryRewriteOwnership(params: HistoryRewriteOwnershipParams): string[] {\n  if (!params.itemDocument) return [];\n  const assigned = params.itemDocument.metadata?.assignee?.trim();\n  if (!assigned || assigned === params.author || params.force) return [];\n\n  const governance = resolveGovernanceKnobs(params.settings);\n  if (governance.ownership_enforcement === \"strict\") {\n    throw new PmCliError(\n      `Item ${params.subjectId} is assigned to ${assigned}. Use --force to override.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  if (governance.ownership_enforcement === \"warn\") {\n    return [`ownership_warning:assignee_conflict:${params.subjectId}:${assigned}`];\n  }\n  return [];\n}\n\n/**\n * Documents the verify history rewrite drift params payload exchanged by command, SDK, and package integrations.\n */\nexport interface VerifyHistoryRewriteDriftParams {\n  pmRoot: string;\n  subject: HistoryRewriteSubject;\n  settings: PmSettings;\n  typeRegistry: ItemTypeRegistry;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in the conflict message (e.g. \"history-redact\"). */\n  operation: string;\n}\n\n/**\n * Documents the verified history rewrite state payload exchanged by command, SDK, and package integrations.\n */\nexport interface VerifiedHistoryRewriteState {\n  historyRawUnderLock: string | null;\n  locatedUnderLock: Awaited<ReturnType<typeof locateItem>>;\n  loadedItemUnderLock: LoadedItem | null;\n}\n\n/**\n * Re-read the history stream and the located item document under the acquired lock and\n * compare both with the pre-lock raw snapshots. Throws PmCliError(CONFLICT) if either\n * diverged while waiting for the lock so the caller surfaces an actionable retry.\n */\nexport async function verifyHistoryRewriteNoDrift(\n  params: VerifyHistoryRewriteDriftParams,\n): Promise<VerifiedHistoryRewriteState> {\n  const historyRawUnderLock = await readFileIfExists(params.subject.historyPath);\n  if (historyRawUnderLock !== params.historyRawBeforeLock) {\n    throw new PmCliError(\n      `History for ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  const locatedUnderLock = await locateItem(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.id_prefix,\n    params.settings.item_format,\n    params.typeRegistry.type_to_folder,\n  );\n  const loadedItemUnderLock = locatedUnderLock\n    ? await readLocatedItem(locatedUnderLock, { schema: params.settings.schema })\n    : null;\n  if ((loadedItemUnderLock?.raw ?? null) !== (params.currentItemRawBeforeLock ?? null)) {\n    throw new PmCliError(\n      `Item ${params.subject.id} changed while waiting for lock; retry ${params.operation}.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n  return { historyRawUnderLock, locatedUnderLock, loadedItemUnderLock };\n}\n\n/**\n * Documents the execute history rewrite params payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExecuteHistoryRewriteParams {\n  pmRoot: string;\n  subject: HistoryRewriteSubject;\n  settings: PmSettings;\n  typeRegistry: ItemTypeRegistry;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  /** Short operation name used in conflict guidance (e.g. \"history-redact\"). */\n  operation: string;\n  author: string;\n  force: boolean | undefined;\n  itemDocument: ItemDocument | null;\n  applyRewrite: (verified: VerifiedHistoryRewriteState) => Promise<void>;\n  applyPostRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<string[]>;\n}\n\n/**\n * Writes the rewritten history stream and restores the under-lock snapshot on failure.\n */\nexport async function writeHistoryRawWithRollback(params: {\n  historyPath: string;\n  nextHistoryRaw: string;\n  historyRawUnderLock: string | null;\n  writeHistoryRaw?: HistoryRawWriter;\n}): Promise<void> {\n  const writeHistoryRaw = params.writeHistoryRaw ?? writeFileAtomic;\n  try {\n    await writeHistoryRaw(params.historyPath, params.nextHistoryRaw);\n  } catch (error) {\n    try {\n      if (params.historyRawUnderLock === null) {\n        await fs.rm(params.historyPath, { force: true });\n      } else {\n        await writeHistoryRaw(params.historyPath, params.historyRawUnderLock);\n      }\n    } catch (rollbackError) {\n      throw new AggregateError(\n        [error, rollbackError],\n        `History rewrite failed and rollback also failed: ${String(error)}`,\n      );\n    }\n    throw error;\n  }\n}\n\n/**\n * Shared lock/verify/ownership orchestration for history-rewrite commands.\n * Callers provide the operation-specific write/rollback logic and optional\n * post-write hook execution while this helper enforces the common governance +\n * lock sequencing contract.\n */\nexport async function executeHistoryRewrite(params: ExecuteHistoryRewriteParams): Promise<string[]> {\n  const warnings = [...checkHistoryRewriteOwnership({\n    itemDocument: params.itemDocument,\n    subjectId: params.subject.id,\n    author: params.author,\n    force: params.force,\n    settings: params.settings,\n  })];\n  const releaseLock = await acquireLock(\n    params.pmRoot,\n    params.subject.id,\n    params.settings.locks.ttl_seconds,\n    params.author,\n    Boolean(params.force),\n    params.settings.governance.force_required_for_stale_lock,\n    params.settings.locks.wait_ms,\n  );\n  try {\n    const verified = await verifyHistoryRewriteNoDrift({\n      pmRoot: params.pmRoot,\n      subject: params.subject,\n      settings: params.settings,\n      typeRegistry: params.typeRegistry,\n      historyRawBeforeLock: params.historyRawBeforeLock,\n      currentItemRawBeforeLock: params.currentItemRawBeforeLock,\n      operation: params.operation,\n    });\n    await params.applyRewrite(verified);\n    if (params.applyPostRewrite) {\n      warnings.push(...(await params.applyPostRewrite(verified)));\n    }\n    return warnings;\n  } finally {\n    await releaseLock();\n  }\n}\n"],
+  "mappings": "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",
   "names": ["fs", "fs", "global"]
 }

package/dist/cli-bundle/chunks/{chunk-NGDK3KEZ.js → chunk-FGQKEDE4.js}

@@ -1,6 +1,6 @@
 import {
   collectBlockedByIds
-} from "./chunk-W5X3AHJN.js";
+} from "./chunk-YOF5VPKM.js";
 import {
   buildItemNotFoundError,
   listAllFrontMatterLight,
@@ -8,26 +8,28 @@ import {
   mutateItem,
   readLocatedItem,
   toItemRecord
-} from "./chunk-CN4OAA2G.js";
+} from "./chunk-3U3VEWK6.js";
 import {
   isTerminalStatus
-} from "./chunk-CQFZRLXQ.js";
+} from "./chunk-EZFKWSC7.js";
 import {
-  EXIT_CODE,
   PmCliError,
+  readSettings
+} from "./chunk-P5YORJRH.js";
+import {
+  EXIT_CODE,
   getSettingsPath,
   pathExists,
-  readSettings,
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-BDDYM4LH.js";
+} from "./chunk-5VVUKE3U.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] = "b66319bc-0c15-5e2a-9400-f38fe46b9b58");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "19dbc992-675b-554c-83bd-4aa14b766810");
   } catch (e2) {
   }
 })();
@@ -44,11 +46,12 @@ function normalizeCloseReason(reasonText, required) {
   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.",
+      required: "Provide a one-line closing summary as the positional text, --reason, or --message.",
       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>"',
+        'pm close <id> -m "<closing summary>"',
         "pm close <id> --duplicate-of <canonical-id>"
       ],
       nextSteps: [
@@ -60,6 +63,23 @@ function normalizeCloseReason(reasonText, required) {
   }
   return void 0;
 }
+function resolveEffectiveCloseReasonText(input) {
+  if ((input.closeReasonText ?? "").trim().length > 0) {
+    return input.closeReasonText;
+  }
+  if (input.duplicateOf !== void 0) {
+    return `Duplicate of ${input.duplicateOf}`;
+  }
+  const trimmedResolution = typeof input.resolution === "string" ? input.resolution.trim() : "";
+  if (trimmedResolution.length > 0) {
+    return trimmedResolution;
+  }
+  const trimmedMessage = typeof input.message === "string" ? input.message.trim() : "";
+  if (input.requireCloseReason && trimmedMessage.length > 0) {
+    return trimmedMessage;
+  }
+  return input.closeReasonText;
+}
 var CLOSE_VALIDATION_FIELDS = [
   { key: "resolution", label: "resolution" },
   { key: "expected_result", label: "expected_result" },
@@ -380,9 +400,13 @@ async function runClose(id, closeReasonText, options, global2) {
     throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeToFolder);
   }
   const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);
-  const hasExplicitReason = (closeReasonText ?? "").trim().length > 0;
-  const trimmedResolution = typeof options.resolution === "string" ? options.resolution.trim() : "";
-  const effectiveCloseReasonText = hasExplicitReason ? closeReasonText : duplicateOf !== void 0 ? `Duplicate of ${duplicateOf}` : trimmedResolution.length > 0 ? trimmedResolution : closeReasonText;
+  const effectiveCloseReasonText = resolveEffectiveCloseReasonText({
+    closeReasonText,
+    duplicateOf,
+    resolution: options.resolution,
+    message: options.message,
+    requireCloseReason: settings.governance.require_close_reason
+  });
   const closeReason = normalizeCloseReason(effectiveCloseReasonText, settings.governance.require_close_reason);
   const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;
   const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);
@@ -420,4 +444,4 @@ export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=chunk-NGDK3KEZ.js.map
+//# sourceMappingURL=chunk-FGQKEDE4.js.map

package/dist/cli-bundle/chunks/chunk-FGQKEDE4.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 \"../../core/item/actionability.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport {\n  buildItemNotFoundError,\n  listAllFrontMatterLight,\n  locateItem,\n  mutateItem,\n  readLocatedItem,\n} from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\n\n/**\n * Documents the close command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n  // pm-fl0c #11 (2026-05-28): allow setting the three closure validation\n  // fields inline on `pm close` so agents do not have to issue a prior\n  // `pm update` just to satisfy --validate-close warn|strict. These map 1:1\n  // to ItemFrontMatter.{resolution,expected_result,actual_result}.\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  duplicateOf?: string;\n}\n\n/**\n * Documents the close result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\ninterface AutoUnblockCandidate {\n  id: string;\n  blocker_ids: string[];\n}\n\ntype CloseInlineFieldKey = \"resolution\" | \"expected_result\" | \"actual_result\";\n\ninterface CloseMutationContext {\n  statusRegistry: RuntimeStatusRegistry;\n  force: boolean | undefined;\n  options: CloseCommandOptions;\n  duplicateOf: string | undefined;\n  validateCloseMode: ValidateCloseMode;\n  activeChildIds: string[];\n  closeReason: string | undefined;\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction normalizeCloseReason(reasonText: string | undefined, required: boolean): string | undefined {\n  const reason = (reasonText ?? \"\").trim();\n  if (reason.length > 0) {\n    return reason;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"Close reason text is required because governance.require_close_reason is enabled\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a one-line closing summary as the positional text, --reason, or --message.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the item is done.\",\n        examples: [\n          'pm close <id> \"Done: <what changed and why>\"',\n          'pm close <id> --reason \"<closing summary>\"',\n          'pm close <id> -m \"<closing summary>\"',\n          \"pm close <id> --duplicate-of <canonical-id>\",\n        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\n          'When closing as a duplicate, --duplicate-of <id> auto-fills the close reason as \"Duplicate of <id>\".',\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\ninterface CloseReasonFallbackInput {\n  closeReasonText: string | undefined;\n  duplicateOf: string | undefined;\n  resolution: string | undefined;\n  message: string | undefined;\n  requireCloseReason: boolean;\n}\n\nfunction resolveEffectiveCloseReasonText(input: CloseReasonFallbackInput): string | undefined {\n  if ((input.closeReasonText ?? \"\").trim().length > 0) {\n    return input.closeReasonText;\n  }\n  if (input.duplicateOf !== undefined) {\n    return `Duplicate of ${input.duplicateOf}`;\n  }\n  const trimmedResolution = typeof input.resolution === \"string\" ? input.resolution.trim() : \"\";\n  if (trimmedResolution.length > 0) {\n    return trimmedResolution;\n  }\n  const trimmedMessage = typeof input.message === \"string\" ? input.message.trim() : \"\";\n  if (input.requireCloseReason && trimmedMessage.length > 0) {\n    return trimmedMessage;\n  }\n  return input.closeReasonText;\n}\n\nconst CLOSE_VALIDATION_FIELDS: Array<{ key: keyof Pick<ItemFrontMatter, \"resolution\" | \"expected_result\" | \"actual_result\">; label: string }> = [\n  { key: \"resolution\", label: \"resolution\" },\n  { key: \"expected_result\", label: \"expected_result\" },\n  { key: \"actual_result\", label: \"actual_result\" },\n];\n\nfunction parseValidateCloseMode(raw: string | undefined): ValidateCloseMode | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized.length === 0 || normalized === \"warn\") {\n    return \"warn\";\n  }\n  if (normalized === \"off\" || normalized === \"none\" || normalized === \"disabled\") {\n    return \"off\";\n  }\n  if (normalized === \"strict\") {\n    return \"strict\";\n  }\n  throw new PmCliError(`Invalid --validate-close mode \"${raw}\" (expected \"off\", \"warn\", or \"strict\")`, EXIT_CODE.USAGE);\n}\n\nfunction findMissingCloseValidationFields(frontMatter: ItemFrontMatter): string[] {\n  const missing: string[] = [];\n  for (const field of CLOSE_VALIDATION_FIELDS) {\n    const rawValue = frontMatter[field.key];\n    if (typeof rawValue !== \"string\" || rawValue.trim().length === 0) {\n      missing.push(field.label);\n    }\n  }\n  return missing;\n}\n\nasync function duplicateChainReferencesClosingItem(\n  loadItemById: (id: string) => Promise<ItemFrontMatter | null>,\n  initialDuplicateOf: unknown,\n  closingId: string,\n): Promise<boolean> {\n  const visited = new Set<string>();\n  let current = initialDuplicateOf;\n  while (typeof current === \"string\" && current.trim().length > 0) {\n    const currentId = current.trim();\n    if (currentId === closingId) {\n      return true;\n    }\n    if (visited.has(currentId)) {\n      return false;\n    }\n    visited.add(currentId);\n    current = (await loadItemById(currentId))?.duplicate_of;\n  }\n  return false;\n}\n\nfunction shouldApplyDuplicateFallback(value: unknown): boolean {\n  return typeof value !== \"string\" || value.trim().length === 0;\n}\n\nasync function assertDuplicateTargetExists(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  duplicateOf: string | undefined,\n  closingId: string,\n): Promise<string | undefined> {\n  const rawTarget = duplicateOf?.trim();\n  if (!rawTarget) {\n    return undefined;\n  }\n  if (rawTarget === closingId) {\n    throw new PmCliError(\"An item cannot be closed as a duplicate of itself.\", EXIT_CODE.USAGE, {\n      code: \"duplicate_target_self\",\n      why: \"--duplicate-of must identify the canonical item that should remain open or already represent the work.\",\n    });\n  }\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const itemCache = new Map<string, ItemFrontMatter | null>();\n  const loadItemById = async (id: string): Promise<ItemFrontMatter | null> => {\n    if (itemCache.has(id)) {\n      return itemCache.get(id) ?? null;\n    }\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      itemCache.set(id, null);\n      return null;\n    }\n    const { document } = await readLocatedItem(located, { schema: settings.schema });\n    itemCache.set(id, document.metadata);\n    return document.metadata;\n  };\n  const target = await loadItemById(rawTarget);\n  if (!target) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_missing\",\n      why: \"Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${rawTarget}\" --duplicate-of ${rawTarget}`],\n      nextSteps: [\"Run pm search/list to find the canonical item, then retry with --duplicate-of <id>.\"],\n    });\n  }\n  if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {\n    throw new PmCliError(`Circular duplicate reference detected. Target \"${rawTarget}\" points back to \"${closingId}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_circular\",\n      why: \"Circular duplicate relationships create loops for dedupe and status propagation tooling.\",\n      nextSteps: [\"Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate.\"],\n    });\n  }\n  if (typeof target.duplicate_of === \"string\" && target.duplicate_of.trim().length > 0) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" is already marked as a duplicate of \"${target.duplicate_of.trim()}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_is_duplicate\",\n      why: \"Duplicate closure should point directly at the canonical item, not another duplicate.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${target.duplicate_of.trim()}\" --duplicate-of ${target.duplicate_of.trim()}`],\n      nextSteps: [\"Use the canonical item referenced by duplicate_of as the --duplicate-of target.\"],\n    });\n  }\n  return target.id;\n}\n\nasync function findActiveChildIds(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  parentId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  return items\n    .filter((item) => item.parent === parentId && !isTerminalStatus(item.status, statusRegistry))\n    .map((item) => item.id)\n    .sort((left, right) => left.localeCompare(right));\n}\n\nasync function findAutoUnblockCandidates(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<AutoUnblockCandidate[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  const itemsById = new Map(items.map((item) => [item.id, item]));\n  const blockedStatuses = statusRegistry.blocked_statuses;\n  return items\n    .filter((item) => blockedStatuses.has(item.status))\n    .map((item) => ({ item, blockerIds: collectBlockedByIds(item) }))\n    .filter(({ blockerIds }) => blockerIds.includes(closedId))\n    .filter(({ blockerIds }) =>\n      blockerIds.every((blockerId) => {\n        const blocker = itemsById.get(blockerId);\n        return blocker !== undefined && isTerminalStatus(blocker.status, statusRegistry);\n      }),\n    )\n    .map(({ item, blockerIds }) => ({ id: item.id, blocker_ids: blockerIds }))\n    .sort((left, right) => left.id.localeCompare(right.id));\n}\n\nasync function autoUnblockResolvedDependents(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  closedId: string,\n  author: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const candidates = await findAutoUnblockCandidates(pmRoot, settings, closedId, statusRegistry);\n  const warnings: string[] = [];\n  for (const candidate of candidates) {\n    try {\n      const unblocked = await mutateItem({\n        pmRoot,\n        settings,\n        id: candidate.id,\n        op: \"update\",\n        author,\n        message: `Auto-unblocked after blocker ${closedId} closed`,\n        mutate(document) {\n          /* c8 ignore start -- normal auto-unblock candidates carry dependency metadata; fallback preserves hand-edited scalar-only blockers. */\n          const dependencies = document.metadata.dependencies ?? [];\n          /* c8 ignore stop */\n          const remainingDependencies = dependencies.filter((dependency) => {\n            const dependencyId = dependency.id.trim();\n            return dependency.kind !== \"blocked_by\" || !candidate.blocker_ids.includes(dependencyId);\n          });\n          document.metadata.status = statusRegistry.open_status;\n          delete document.metadata.blocked_by;\n          delete document.metadata.blocked_reason;\n          document.metadata.unblock_note = `Auto-unblocked after blocker ${closedId} closed; all blockers resolved (${candidate.blocker_ids.join(\", \")}).`;\n          if (remainingDependencies.length > 0) {\n            document.metadata.dependencies = remainingDependencies;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          const changedFields = [\"status\", \"blocked_by\", \"blocked_reason\", \"unblock_note\"];\n          if (remainingDependencies.length !== dependencies.length) {\n            changedFields.push(\"dependencies\");\n          }\n          return {\n            changedFields,\n          };\n        },\n      });\n      warnings.push(`auto_unblocked:${unblocked.item.id}:resolved_blockers=${candidate.blocker_ids.join(\",\")}`);\n    /* c8 ignore start -- defensive fan-out failure path; normal lock/claim state is auditable and still unblocks. */\n    } catch (error) {\n      const reason = error instanceof Error ? error.message.replace(/\\s+/g, \" \").trim() : \"unknown\";\n      warnings.push(`auto_unblock_failed:${candidate.id}:${reason}`);\n    }\n    /* c8 ignore stop */\n  }\n  return warnings;\n}\n\nfunction applyInlineCloseFields(metadata: ItemFrontMatter, options: CloseCommandOptions): CloseInlineFieldKey[] {\n  const changedFields: CloseInlineFieldKey[] = [];\n  const inlineCloseFields: Array<{ option: string | undefined; key: CloseInlineFieldKey }> = [\n    { option: options.resolution, key: \"resolution\" },\n    { option: options.expectedResult, key: \"expected_result\" },\n    { option: options.actualResult, key: \"actual_result\" },\n  ];\n  for (const { option, key } of inlineCloseFields) {\n    if (typeof option !== \"string\") {\n      continue;\n    }\n    const trimmed = option.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    metadata[key] = trimmed;\n    changedFields.push(key);\n  }\n  return changedFields;\n}\n\nfunction applyDuplicateCloseMetadata(metadata: ItemFrontMatter, duplicateOf: string | undefined): CloseInlineFieldKey[] {\n  if (duplicateOf === undefined) {\n    return [];\n  }\n  metadata.duplicate_of = duplicateOf;\n  const duplicateFallbackFields: CloseInlineFieldKey[] = [];\n  const fallbackValues: Array<{ key: CloseInlineFieldKey; value: string }> = [\n    { key: \"resolution\", value: `Duplicate of ${duplicateOf}` },\n    { key: \"expected_result\", value: `Canonical item ${duplicateOf} tracks the work.` },\n    { key: \"actual_result\", value: `Closed as duplicate of ${duplicateOf}.` },\n  ];\n  for (const { key, value } of fallbackValues) {\n    if (shouldApplyDuplicateFallback(metadata[key])) {\n      metadata[key] = value;\n      duplicateFallbackFields.push(key);\n    }\n  }\n  return duplicateFallbackFields;\n}\n\nfunction collectCloseValidationWarnings(\n  metadata: ItemFrontMatter,\n  validateCloseMode: ValidateCloseMode,\n  activeChildIds: string[],\n): string[] {\n  const warnings: string[] = [];\n  if (validateCloseMode !== \"off\") {\n    const missingFields = findMissingCloseValidationFields(metadata);\n    if (missingFields.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_missing_fields:${metadata.id}:${missingFields.join(\",\")}`);\n    }\n    if (activeChildIds.length > 0) {\n      if (validateCloseMode === \"strict\") {\n        throw new PmCliError(\n          `Cannot close item ${metadata.id}: active child items remain open (${activeChildIds.join(\", \")}). Close, cancel, or re-parent them first, or use --validate-close warn.`,\n          EXIT_CODE.USAGE,\n        );\n      }\n      warnings.push(`close_validation_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n    }\n    return warnings;\n  }\n  if (activeChildIds.length > 0) {\n    warnings.push(`closed_with_active_children:${metadata.id}:${activeChildIds.join(\",\")}`);\n  }\n  return warnings;\n}\n\nfunction applyCloseReason(metadata: ItemFrontMatter, closeReason: string | undefined): string[] {\n  if (closeReason !== undefined) {\n    metadata.close_reason = closeReason;\n    return [\"close_reason\"];\n  }\n  if (metadata.close_reason !== undefined) {\n    delete metadata.close_reason;\n    return [\"close_reason\"];\n  }\n  return [];\n}\n\nfunction clearCloseAssignee(metadata: ItemFrontMatter): string[] {\n  if (metadata.assignee === undefined) {\n    return [];\n  }\n  delete metadata.assignee;\n  return [\"assignee\"];\n}\n\nfunction clearClosedBlockerSignals(metadata: ItemFrontMatter): { changedFields: string[]; warnings: string[] } {\n  const previousBlockedBy = typeof metadata.blocked_by === \"string\" ? metadata.blocked_by.trim() : \"\";\n  const existingDeps = metadata.dependencies ?? [];\n  const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n  const hadBlockedReason = metadata.blocked_reason !== undefined;\n  if (previousBlockedBy.length === 0 && blockedByEdge === undefined && !hadBlockedReason) {\n    return { changedFields: [], warnings: [] };\n  }\n  const changedFields: string[] = [];\n  if (previousBlockedBy.length > 0) {\n    delete metadata.blocked_by;\n    changedFields.push(\"blocked_by\");\n  }\n  if (hadBlockedReason) {\n    delete metadata.blocked_reason;\n    changedFields.push(\"blocked_reason\");\n  }\n  if (blockedByEdge !== undefined) {\n    const remainingDeps = existingDeps.filter((dep) => dep.kind !== \"blocked_by\");\n    if (remainingDeps.length > 0) {\n      metadata.dependencies = remainingDeps;\n    } else {\n      delete metadata.dependencies;\n    }\n    changedFields.push(\"dependencies\");\n  }\n  // A stale reason-only close has no blocker identity; omit the blocker-clear warning instead of inventing one.\n  const reportedBlocker = previousBlockedBy || blockedByEdge?.id;\n  return {\n    changedFields,\n    warnings: reportedBlocker ? [`closed_cleared_blocked_by:${metadata.id}:${reportedBlocker}`] : [],\n  };\n}\n\nfunction mutateCloseMetadata(metadata: ItemFrontMatter, context: CloseMutationContext): { changedFields: string[]; warnings?: string[] } {\n  if (isTerminalStatus(metadata.status, context.statusRegistry) && !context.force) {\n    throw new PmCliError(`Item ${metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n  }\n  const inlineChangedFields = applyInlineCloseFields(metadata, context.options);\n  const duplicateFallbackFields = applyDuplicateCloseMetadata(metadata, context.duplicateOf);\n  const mutationWarnings = collectCloseValidationWarnings(metadata, context.validateCloseMode, context.activeChildIds);\n  metadata.status = context.statusRegistry.close_status;\n  const changedFields = [\n    \"status\",\n    ...applyCloseReason(metadata, context.closeReason),\n    ...inlineChangedFields,\n  ];\n  if (context.duplicateOf !== undefined) {\n    changedFields.push(\"duplicate_of\");\n    for (const key of duplicateFallbackFields) {\n      /* v8 ignore start -- duplicate fallback keys are already pre-deduped by applyDuplicateCloseMetadata in covered close paths */\n      if (!changedFields.includes(key)) {\n        changedFields.push(key);\n      }\n      /* v8 ignore stop */\n    }\n  }\n  changedFields.push(...clearCloseAssignee(metadata));\n  const blockerCleanup = clearClosedBlockerSignals(metadata);\n  changedFields.push(...blockerCleanup.changedFields);\n  mutationWarnings.push(...blockerCleanup.warnings);\n  return {\n    changedFields,\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\nexport const _testOnlyCloseCommand = {\n  blockedByIds: collectBlockedByIds,\n};\n\n/**\n * Implements run close for the public runtime surface of this module.\n */\nexport async function runClose(\n  id: string,\n  closeReasonText: string | undefined,\n  options: CloseCommandOptions,\n  global: GlobalOptions,\n): Promise<CloseResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = toAuthor(options.author, settings.author_default);\n  // GH-250: verify the target item EXISTS before the governance close-reason\n  // gate fires. Otherwise closing a typo'd id with no reason reports\n  // \"Close reason text is required\" and hides the real cause (bad id) until a\n  // reason is supplied. Existence is the more fundamental precondition, so it\n  // is validated first regardless of whether a reason was provided.\n  const typeToFolder = resolveItemTypeRegistry(settings).type_to_folder;\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (!located) {\n    throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeToFolder);\n  }\n  // GH-204: resolve the duplicate target BEFORE reason validation so\n  // `pm close <id> --duplicate-of <canonical>` succeeds under\n  // governance.require_close_reason without a manual reason — when no\n  // positional/--reason text is provided the reason defaults to\n  // \"Duplicate of <id>\" (mirroring the auto-filled closure metadata).\n  // Explicit reason text still wins.\n  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);\n  // pm-7x8d / pm-9hry / GH-204: when no explicit positional/--reason text is given, derive\n  // the close reason from the next-best closure signal instead of hard-blocking\n  // under governance.require_close_reason. Precedence: explicit reason text >\n  // --duplicate-of (\"Duplicate of <id>\") > --resolution summary > --message.\n  // Resolution still writes metadata.resolution below; message still writes the\n  // history entry through mutateItem. Reusing either as the close reason just lets\n  // a single agent-authored close command succeed when it already supplied a\n  // closure summary through another structured option.\n  const effectiveCloseReasonText = resolveEffectiveCloseReasonText({\n    closeReasonText,\n    duplicateOf,\n    resolution: options.resolution,\n    message: options.message,\n    requireCloseReason: settings.governance.require_close_reason,\n  });\n  const closeReason = normalizeCloseReason(effectiveCloseReasonText, settings.governance.require_close_reason);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n  // C3 (pm-fu5d): scan for active children even under minimal governance so\n  // closing a parent is never silently orphaning — off mode emits an\n  // informational note instead of the warn/strict validation warning.\n  const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"close\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      return mutateCloseMetadata(document.metadata, {\n        statusRegistry,\n        force: options.force,\n        options,\n        duplicateOf,\n        validateCloseMode,\n        activeChildIds,\n        closeReason,\n      });\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: [\n      ...result.warnings,\n      ...(await autoUnblockResolvedDependents(pmRoot, settings, located.id, author, statusRegistry)),\n    ],\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,SAAS,SAAS,WAA+B,eAAqB;AACpE,QAAM,WAAW,aAAa,QAAQ,IAAI,aAAa;AACvD,QAAM,UAAU,SAAS,KAAI;AAC7B,SAAO,WAAW;AACpB;AAEA,SAAS,qBAAqB,YAAgC,UAAiB;AAC7E,QAAM,UAAU,cAAc,IAAI,KAAI;AACtC,MAAI,OAAO,SAAS,GAAG;AACrB,WAAO;EACT;AACA,MAAI,UAAU;AACZ,UAAM,IAAI,WACR,oFACA,UAAU,OACV;MACE,MAAM;MACN,UAAU;MACV,KAAK;MACL,UAAU;QACR;QACA;QACA;QACA;;MAEF,WAAW;QACT;QACA;QACA;;KAEH;EAEL;AACA,SAAO;AACT;AAYA,SAAS,gCAAgC,OAA+B;AACtE,OAAK,MAAM,mBAAmB,IAAI,KAAI,EAAG,SAAS,GAAG;AACnD,WAAO,MAAM;EACf;AACA,MAAI,MAAM,gBAAgB,QAAW;AACnC,WAAO,gBAAgB,MAAM,WAAW;EAC1C;AACA,QAAM,oBAAoB,OAAO,MAAM,eAAe,WAAW,MAAM,WAAW,KAAI,IAAK;AAC3F,MAAI,kBAAkB,SAAS,GAAG;AAChC,WAAO;EACT;AACA,QAAM,iBAAiB,OAAO,MAAM,YAAY,WAAW,MAAM,QAAQ,KAAI,IAAK;AAClF,MAAI,MAAM,sBAAsB,eAAe,SAAS,GAAG;AACzD,WAAO;EACT;AACA,SAAO,MAAM;AACf;AAEA,IAAM,0BAA0I;EAC9I,EAAE,KAAK,cAAc,OAAO,aAAY;EACxC,EAAE,KAAK,mBAAmB,OAAO,kBAAiB;EAClD,EAAE,KAAK,iBAAiB,OAAO,gBAAe;;AAGhD,SAAS,uBAAuB,KAAuB;AACrD,MAAI,QAAQ,QAAW;AACrB,WAAO;EACT;AACA,QAAM,aAAa,IAAI,KAAI,EAAG,YAAW;AACzC,MAAI,WAAW,WAAW,KAAK,eAAe,QAAQ;AACpD,WAAO;EACT;AACA,MAAI,eAAe,SAAS,eAAe,UAAU,eAAe,YAAY;AAC9E,WAAO;EACT;AACA,MAAI,eAAe,UAAU;AAC3B,WAAO;EACT;AACA,QAAM,IAAI,WAAW,kCAAkC,GAAG,2CAA2C,UAAU,KAAK;AACtH;AAEA,SAAS,iCAAiC,aAA4B;AACpE,QAAM,UAAoB,CAAA;AAC1B,aAAW,SAAS,yBAAyB;AAC3C,UAAM,WAAW,YAAY,MAAM,GAAG;AACtC,QAAI,OAAO,aAAa,YAAY,SAAS,KAAI,EAAG,WAAW,GAAG;AAChE,cAAQ,KAAK,MAAM,KAAK;IAC1B;EACF;AACA,SAAO;AACT;AAEA,eAAe,oCACb,cACA,oBACA,WAAiB;AAEjB,QAAM,UAAU,oBAAI,IAAG;AACvB,MAAI,UAAU;AACd,SAAO,OAAO,YAAY,YAAY,QAAQ,KAAI,EAAG,SAAS,GAAG;AAC/D,UAAM,YAAY,QAAQ,KAAI;AAC9B,QAAI,cAAc,WAAW;AAC3B,aAAO;IACT;AACA,QAAI,QAAQ,IAAI,SAAS,GAAG;AAC1B,aAAO;IACT;AACA,YAAQ,IAAI,SAAS;AACrB,eAAW,MAAM,aAAa,SAAS,IAAI;EAC7C;AACA,SAAO;AACT;AAEA,SAAS,6BAA6B,OAAc;AAClD,SAAO,OAAO,UAAU,YAAY,MAAM,KAAI,EAAG,WAAW;AAC9D;AAEA,eAAe,4BACb,QACA,UACA,aACA,WAAiB;AAEjB,QAAM,YAAY,aAAa,KAAI;AACnC,MAAI,CAAC,WAAW;AACd,WAAO;EACT;AACA,MAAI,cAAc,WAAW;AAC3B,UAAM,IAAI,WAAW,sDAAsD,UAAU,OAAO;MAC1F,MAAM;MACN,KAAK;KACN;EACH;AACA,QAAM,eAAe,wBAAwB,QAAQ;AACrD,QAAM,YAAY,oBAAI,IAAG;AACzB,QAAM,eAAe,OAAO,OAA+C;AACzE,QAAI,UAAU,IAAI,EAAE,GAAG;AACrB,aAAO,UAAU,IAAI,EAAE,KAAK;IAC9B;AACA,UAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,aAAa,cAAc;AAClH,QAAI,CAAC,SAAS;AACZ,gBAAU,IAAI,IAAI,IAAI;AACtB,aAAO;IACT;AACA,UAAM,EAAE,SAAQ,IAAK,MAAM,gBAAgB,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE;AAC/E,cAAU,IAAI,IAAI,SAAS,QAAQ;AACnC,WAAO,SAAS;EAClB;AACA,QAAM,SAAS,MAAM,aAAa,SAAS;AAC3C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,WAAW,qBAAqB,SAAS,+DAA+D,UAAU,OAAO;MACjI,MAAM;MACN,KAAK;MACL,UAAU,CAAC,YAAY,SAAS,kBAAkB,SAAS,oBAAoB,SAAS,EAAE;MAC1F,WAAW,CAAC,qFAAqF;KAClG;EACH;AACA,MAAI,MAAM,oCAAoC,cAAc,OAAO,cAAc,SAAS,GAAG;AAC3F,UAAM,IAAI,WAAW,kDAAkD,SAAS,qBAAqB,SAAS,MAAM,UAAU,OAAO;MACnI,MAAM;MACN,KAAK;MACL,WAAW,CAAC,wHAAwH;KACrI;EACH;AACA,MAAI,OAAO,OAAO,iBAAiB,YAAY,OAAO,aAAa,KAAI,EAAG,SAAS,GAAG;AACpF,UAAM,IAAI,WAAW,qBAAqB,SAAS,0CAA0C,OAAO,aAAa,KAAI,CAAE,MAAM,UAAU,OAAO;MAC5I,MAAM;MACN,KAAK;MACL,UAAU,CAAC,YAAY,SAAS,kBAAkB,OAAO,aAAa,KAAI,CAAE,oBAAoB,OAAO,aAAa,KAAI,CAAE,EAAE;MAC5H,WAAW,CAAC,iFAAiF;KAC9F;EACH;AACA,SAAO,OAAO;AAChB;AAEA,eAAe,mBACb,QACA,UACA,UACA,gBAAqC;AAErC,QAAM,eAAe,wBAAwB,QAAQ;AACrD,QAAM,QAAQ,MAAM,wBAClB,QACA,SAAS,aACT,aAAa,gBACb,QACA,SAAS,MAAM;AAEjB,SAAO,MACJ,OAAO,CAAC,SAAS,KAAK,WAAW,YAAY,CAAC,iBAAiB,KAAK,QAAQ,cAAc,CAAC,EAC3F,IAAI,CAAC,SAAS,KAAK,EAAE,EACrB,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AACpD;AAEA,eAAe,0BACb,QACA,UACA,UACA,gBAAqC;AAErC,QAAM,eAAe,wBAAwB,QAAQ;AACrD,QAAM,QAAQ,MAAM,wBAClB,QACA,SAAS,aACT,aAAa,gBACb,QACA,SAAS,MAAM;AAEjB,QAAM,YAAY,IAAI,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AAC9D,QAAM,kBAAkB,eAAe;AACvC,SAAO,MACJ,OAAO,CAAC,SAAS,gBAAgB,IAAI,KAAK,MAAM,CAAC,EACjD,IAAI,CAAC,UAAU,EAAE,MAAM,YAAY,oBAAoB,IAAI,EAAC,EAAG,EAC/D,OAAO,CAAC,EAAE,WAAU,MAAO,WAAW,SAAS,QAAQ,CAAC,EACxD,OAAO,CAAC,EAAE,WAAU,MACnB,WAAW,MAAM,CAAC,cAAa;AAC7B,UAAM,UAAU,UAAU,IAAI,SAAS;AACvC,WAAO,YAAY,UAAa,iBAAiB,QAAQ,QAAQ,cAAc;EACjF,CAAC,CAAC,EAEH,IAAI,CAAC,EAAE,MAAM,WAAU,OAAQ,EAAE,IAAI,KAAK,IAAI,aAAa,WAAU,EAAG,EACxE,KAAK,CAAC,MAAM,UAAU,KAAK,GAAG,cAAc,MAAM,EAAE,CAAC;AAC1D;AAEA,eAAe,8BACb,QACA,UACA,UACA,QACA,gBAAqC;AAErC,QAAM,aAAa,MAAM,0BAA0B,QAAQ,UAAU,UAAU,cAAc;AAC7F,QAAM,WAAqB,CAAA;AAC3B,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,YAAY,MAAM,WAAW;QACjC;QACA;QACA,IAAI,UAAU;QACd,IAAI;QACJ;QACA,SAAS,gCAAgC,QAAQ;QACjD,OAAO,UAAQ;AAEb,gBAAM,eAAe,SAAS,SAAS,gBAAgB,CAAA;AAEvD,gBAAM,wBAAwB,aAAa,OAAO,CAAC,eAAc;AAC/D,kBAAM,eAAe,WAAW,GAAG,KAAI;AACvC,mBAAO,WAAW,SAAS,gBAAgB,CAAC,UAAU,YAAY,SAAS,YAAY;UACzF,CAAC;AACD,mBAAS,SAAS,SAAS,eAAe;AAC1C,iBAAO,SAAS,SAAS;AACzB,iBAAO,SAAS,SAAS;AACzB,mBAAS,SAAS,eAAe,gCAAgC,QAAQ,mCAAmC,UAAU,YAAY,KAAK,IAAI,CAAC;AAC5I,cAAI,sBAAsB,SAAS,GAAG;AACpC,qBAAS,SAAS,eAAe;UACnC,OAAO;AACL,mBAAO,SAAS,SAAS;UAC3B;AACA,gBAAM,gBAAgB,CAAC,UAAU,cAAc,kBAAkB,cAAc;AAC/E,cAAI,sBAAsB,WAAW,aAAa,QAAQ;AACxD,0BAAc,KAAK,cAAc;UACnC;AACA,iBAAO;YACL;;QAEJ;OACD;AACD,eAAS,KAAK,kBAAkB,UAAU,KAAK,EAAE,sBAAsB,UAAU,YAAY,KAAK,GAAG,CAAC,EAAE;IAE1G,SAAS,OAAO;AACd,YAAM,SAAS,iBAAiB,QAAQ,MAAM,QAAQ,QAAQ,QAAQ,GAAG,EAAE,KAAI,IAAK;AACpF,eAAS,KAAK,uBAAuB,UAAU,EAAE,IAAI,MAAM,EAAE;IAC/D;EAEF;AACA,SAAO;AACT;AAEA,SAAS,uBAAuB,UAA2B,SAA4B;AACrF,QAAM,gBAAuC,CAAA;AAC7C,QAAM,oBAAqF;IACzF,EAAE,QAAQ,QAAQ,YAAY,KAAK,aAAY;IAC/C,EAAE,QAAQ,QAAQ,gBAAgB,KAAK,kBAAiB;IACxD,EAAE,QAAQ,QAAQ,cAAc,KAAK,gBAAe;;AAEtD,aAAW,EAAE,QAAQ,IAAG,KAAM,mBAAmB;AAC/C,QAAI,OAAO,WAAW,UAAU;AAC9B;IACF;AACA,UAAM,UAAU,OAAO,KAAI;AAC3B,QAAI,QAAQ,WAAW,GAAG;AACxB;IACF;AACA,aAAS,GAAG,IAAI;AAChB,kBAAc,KAAK,GAAG;EACxB;AACA,SAAO;AACT;AAEA,SAAS,4BAA4B,UAA2B,aAA+B;AAC7F,MAAI,gBAAgB,QAAW;AAC7B,WAAO,CAAA;EACT;AACA,WAAS,eAAe;AACxB,QAAM,0BAAiD,CAAA;AACvD,QAAM,iBAAqE;IACzE,EAAE,KAAK,cAAc,OAAO,gBAAgB,WAAW,GAAE;IACzD,EAAE,KAAK,mBAAmB,OAAO,kBAAkB,WAAW,oBAAmB;IACjF,EAAE,KAAK,iBAAiB,OAAO,0BAA0B,WAAW,IAAG;;AAEzE,aAAW,EAAE,KAAK,MAAK,KAAM,gBAAgB;AAC3C,QAAI,6BAA6B,SAAS,GAAG,CAAC,GAAG;AAC/C,eAAS,GAAG,IAAI;AAChB,8BAAwB,KAAK,GAAG;IAClC;EACF;AACA,SAAO;AACT;AAEA,SAAS,+BACP,UACA,mBACA,gBAAwB;AAExB,QAAM,WAAqB,CAAA;AAC3B,MAAI,sBAAsB,OAAO;AAC/B,UAAM,gBAAgB,iCAAiC,QAAQ;AAC/D,QAAI,cAAc,SAAS,GAAG;AAC5B,UAAI,sBAAsB,UAAU;AAClC,cAAM,IAAI,WACR,qBAAqB,SAAS,EAAE,aAAa,cAAc,KAAK,IAAI,CAAC,mDACrE,UAAU,KAAK;MAEnB;AACA,eAAS,KAAK,mCAAmC,SAAS,EAAE,IAAI,cAAc,KAAK,GAAG,CAAC,EAAE;IAC3F;AACA,QAAI,eAAe,SAAS,GAAG;AAC7B,UAAI,sBAAsB,UAAU;AAClC,cAAM,IAAI,WACR,qBAAqB,SAAS,EAAE,qCAAqC,eAAe,KAAK,IAAI,CAAC,4EAC9F,UAAU,KAAK;MAEnB;AACA,eAAS,KAAK,oCAAoC,SAAS,EAAE,IAAI,eAAe,KAAK,GAAG,CAAC,EAAE;IAC7F;AACA,WAAO;EACT;AACA,MAAI,eAAe,SAAS,GAAG;AAC7B,aAAS,KAAK,+BAA+B,SAAS,EAAE,IAAI,eAAe,KAAK,GAAG,CAAC,EAAE;EACxF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,UAA2B,aAA+B;AAClF,MAAI,gBAAgB,QAAW;AAC7B,aAAS,eAAe;AACxB,WAAO,CAAC,cAAc;EACxB;AACA,MAAI,SAAS,iBAAiB,QAAW;AACvC,WAAO,SAAS;AAChB,WAAO,CAAC,cAAc;EACxB;AACA,SAAO,CAAA;AACT;AAEA,SAAS,mBAAmB,UAAyB;AACnD,MAAI,SAAS,aAAa,QAAW;AACnC,WAAO,CAAA;EACT;AACA,SAAO,SAAS;AAChB,SAAO,CAAC,UAAU;AACpB;AAEA,SAAS,0BAA0B,UAAyB;AAC1D,QAAM,oBAAoB,OAAO,SAAS,eAAe,WAAW,SAAS,WAAW,KAAI,IAAK;AACjG,QAAM,eAAe,SAAS,gBAAgB,CAAA;AAC9C,QAAM,gBAAgB,aAAa,KAAK,CAAC,QAAQ,IAAI,SAAS,YAAY;AAC1E,QAAM,mBAAmB,SAAS,mBAAmB;AACrD,MAAI,kBAAkB,WAAW,KAAK,kBAAkB,UAAa,CAAC,kBAAkB;AACtF,WAAO,EAAE,eAAe,CAAA,GAAI,UAAU,CAAA,EAAE;EAC1C;AACA,QAAM,gBAA0B,CAAA;AAChC,MAAI,kBAAkB,SAAS,GAAG;AAChC,WAAO,SAAS;AAChB,kBAAc,KAAK,YAAY;EACjC;AACA,MAAI,kBAAkB;AACpB,WAAO,SAAS;AAChB,kBAAc,KAAK,gBAAgB;EACrC;AACA,MAAI,kBAAkB,QAAW;AAC/B,UAAM,gBAAgB,aAAa,OAAO,CAAC,QAAQ,IAAI,SAAS,YAAY;AAC5E,QAAI,cAAc,SAAS,GAAG;AAC5B,eAAS,eAAe;IAC1B,OAAO;AACL,aAAO,SAAS;IAClB;AACA,kBAAc,KAAK,cAAc;EACnC;AAEA,QAAM,kBAAkB,qBAAqB,eAAe;AAC5D,SAAO;IACL;IACA,UAAU,kBAAkB,CAAC,6BAA6B,SAAS,EAAE,IAAI,eAAe,EAAE,IAAI,CAAA;;AAElG;AAEA,SAAS,oBAAoB,UAA2B,SAA6B;AACnF,MAAI,iBAAiB,SAAS,QAAQ,QAAQ,cAAc,KAAK,CAAC,QAAQ,OAAO;AAC/E,UAAM,IAAI,WAAW,QAAQ,SAAS,EAAE,qDAAqD,UAAU,QAAQ;EACjH;AACA,QAAM,sBAAsB,uBAAuB,UAAU,QAAQ,OAAO;AAC5E,QAAM,0BAA0B,4BAA4B,UAAU,QAAQ,WAAW;AACzF,QAAM,mBAAmB,+BAA+B,UAAU,QAAQ,mBAAmB,QAAQ,cAAc;AACnH,WAAS,SAAS,QAAQ,eAAe;AACzC,QAAM,gBAAgB;IACpB;IACA,GAAG,iBAAiB,UAAU,QAAQ,WAAW;IACjD,GAAG;;AAEL,MAAI,QAAQ,gBAAgB,QAAW;AACrC,kBAAc,KAAK,cAAc;AACjC,eAAW,OAAO,yBAAyB;AAEzC,UAAI,CAAC,cAAc,SAAS,GAAG,GAAG;AAChC,sBAAc,KAAK,GAAG;MACxB;IAEF;EACF;AACA,gBAAc,KAAK,GAAG,mBAAmB,QAAQ,CAAC;AAClD,QAAM,iBAAiB,0BAA0B,QAAQ;AACzD,gBAAc,KAAK,GAAG,eAAe,aAAa;AAClD,mBAAiB,KAAK,GAAG,eAAe,QAAQ;AAChD,SAAO;IACL;IACA,GAAI,iBAAiB,SAAS,IAAI,EAAE,UAAU,iBAAgB,IAAK,CAAA;;AAEvE;AAEO,IAAM,wBAAwB;EACnC,cAAc;;AAMhB,eAAsB,SACpB,IACA,iBACA,SACAA,SAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AACnE,QAAM,SAAS,SAAS,QAAQ,QAAQ,SAAS,cAAc;AAM/D,QAAM,eAAe,wBAAwB,QAAQ,EAAE;AACvD,QAAM,UAAU,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW,SAAS,aAAa,YAAY;AACnG,MAAI,CAAC,SAAS;AACZ,UAAM,MAAM,uBAAuB,QAAQ,IAAI,SAAS,WAAW,YAAY;EACjF;AAOA,QAAM,cAAc,MAAM,4BAA4B,QAAQ,UAAU,QAAQ,aAAa,EAAE;AAS/F,QAAM,2BAA2B,gCAAgC;IAC/D;IACA;IACA,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,oBAAoB,SAAS,WAAW;GACzC;AACD,QAAM,cAAc,qBAAqB,0BAA0B,SAAS,WAAW,oBAAoB;AAC3G,QAAM,oBAAoB,uBAAuB,QAAQ,aAAa,KAAK,SAAS,WAAW;AAI/F,QAAM,iBAAiB,MAAM,mBAAmB,QAAQ,UAAU,IAAI,cAAc;AAEpF,QAAM,SAAS,MAAM,WAAW;IAC9B;IACA;IACA;IACA,IAAI;IACJ;IACA,SAAS,QAAQ;IACjB,OAAO,QAAQ;IACf,OAAO,UAAQ;AACb,aAAO,oBAAoB,SAAS,UAAU;QAC5C;QACA,OAAO,QAAQ;QACf;QACA;QACA;QACA;QACA;OACD;IACH;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,gBAAgB,OAAO;IACvB,UAAU;MACR,GAAG,OAAO;MACV,GAAI,MAAM,8BAA8B,QAAQ,UAAU,QAAQ,IAAI,QAAQ,cAAc;;;AAGlG;",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-FMWQRMHS.js → chunk-FJRKQREY.js}

@@ -1,21 +1,14 @@
 
-!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]="8b8a7dc0-b7eb-5093-a13c-9d1adf4f3023")}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]="6beae0c5-95ce-5ca2-9c64-67075f518c1a")}catch(e){}}();
 import {
-  EXIT_CODE,
   PmCliError
-} from "./chunk-SL2ANJSV.js";
-
-// dist/core/shared/memo.js
-function evictOldestMemoEntries(memo) {
-  let remaining = Math.ceil(memo.size / 2);
-  for (const key of memo.keys()) {
-    if (remaining === 0) {
-      return;
-    }
-    memo.delete(key);
-    remaining -= 1;
-  }
-}
+} from "./chunk-US3T3W5J.js";
+import {
+  evictOldestMemoEntries
+} from "./chunk-NNHHXJB2.js";
+import {
+  EXIT_CODE
+} from "./chunk-YD5FML7K.js";
 
 // dist/core/shared/time.js
 var RELATIVE_DEADLINE = /^([+-]?)(\d+)([hdwm])$/i;
@@ -225,12 +218,11 @@ function resolveIsoOrRelative(input, now = /* @__PURE__ */ new Date(), fieldLabe
 }
 
 export {
-  evictOldestMemoEntries,
   nowIso,
   isTimestampLiteral,
   compareTimestampStrings,
   resolveIsoOrRelative
 };
-//# sourceMappingURL=chunk-FMWQRMHS.js.map
+//# sourceMappingURL=chunk-FJRKQREY.js.map
 
-//# debugId=8b8a7dc0-b7eb-5093-a13c-9d1adf4f3023
+//# debugId=6beae0c5-95ce-5ca2-9c64-67075f518c1a

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/shared/time.ts"],"sourcesContent":["/**\n * @module core/shared/time\n *\n * Provides shared primitives and utilities for Time.\n */\nimport { PmCliError } from \"./errors.js\";\nimport { evictOldestMemoEntries } from \"./memo.js\";\nimport { EXIT_CODE } from \"./constants.js\";\n\nconst RELATIVE_DEADLINE = /^([+-]?)(\\d+)([hdwm])$/i;\nconst COMPOUND_RELATIVE_DEADLINE = /^[+-]?\\d+[hdwm](?:[+-]\\d+[hdwm])+$/i;\nconst COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})$/;\nconst COMPACT_DATETIME = /^(\\d{4})(\\d{2})(\\d{2})(?:[T\\s]?)(\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst HYPHEN_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})-(\\d{2})(?:-(\\d{2}))?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst COMPACT_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\n\n/**\n * Implements now iso for the public runtime surface of this module.\n */\nexport function nowIso(): string {\n  return new Date().toISOString();\n}\n\n/**\n * Implements check whether timestamp literal for the public runtime surface of this module.\n */\nexport function isTimestampLiteral(input: string): boolean {\n  return Number.isFinite(Date.parse(input));\n}\n\n/**\n * Memoized `Date.parse` for {@link compareTimestampStrings}. Sort comparators call it\n * O(n log n) times over a corpus whose timestamp strings repeat heavily, and\n * `Date.parse` is expensive enough to show up in list/next/context profiles. The cap\n * bounds memory in long-lived hosts (the MCP server); half-eviction keeps the\n * newest-inserted half when the cap is hit.\n */\nconst TIMESTAMP_PARSE_MEMO_MAX_ENTRIES = 10_000;\nconst timestampParseMemo = new Map<string, number>();\n\nfunction parseTimestampMsMemoized(value: string): number {\n  const memoized = timestampParseMemo.get(value);\n  if (memoized !== undefined) {\n    return memoized;\n  }\n  const parsed = Date.parse(value);\n  if (timestampParseMemo.size >= TIMESTAMP_PARSE_MEMO_MAX_ENTRIES) {\n    evictOldestMemoEntries(timestampParseMemo);\n  }\n  timestampParseMemo.set(value, parsed);\n  return parsed;\n}\n\n/**\n * Implements compare timestamp strings for the public runtime surface of this module.\n */\nexport function compareTimestampStrings(left: string, right: string): number {\n  const leftMs = parseTimestampMsMemoized(left);\n  const rightMs = parseTimestampMsMemoized(right);\n  if (Number.isFinite(leftMs) && Number.isFinite(rightMs) && leftMs !== rightMs) {\n    return leftMs - rightMs;\n  }\n  return left.localeCompare(right);\n}\n\nfunction normalizeFraction(raw: string | undefined): string {\n  if (!raw) return \"\";\n  const digits = raw.slice(1);\n  return `.${digits.padEnd(3, \"0\").slice(0, 3)}`;\n}\n\nfunction normalizeOffset(raw: string | undefined): string {\n  if (!raw) return \"\";\n  if (raw.toUpperCase() === \"Z\") return \"Z\";\n  const compact = /^([+-]\\d{2})(\\d{2})$/.exec(raw);\n  if (compact) return `${compact[1]}:${compact[2]}`;\n  return raw;\n}\n\nfunction pushTimestampCandidate(candidates: string[], input: string, value: string | undefined): void {\n  if (!value) return;\n  if (value === input) return;\n  if (candidates.includes(value)) return;\n  candidates.push(value);\n}\n\nfunction normalizeTimestampCandidates(input: string): string[] {\n  const candidates: string[] = [];\n  const push = (value: string | undefined): void => pushTimestampCandidate(candidates, input, value);\n\n  const compactDate = COMPACT_DATE.exec(input);\n  if (compactDate) {\n    const [, year, month, day] = compactDate;\n    push(`${year}-${month}-${day}`);\n  }\n\n  const compactDateTime = COMPACT_DATETIME.exec(input);\n  if (compactDateTime) {\n    const [, year, month, day, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactDateTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(\n      `${year}-${month}-${day}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`,\n    );\n  }\n\n  const hyphenTime = HYPHEN_TIME.exec(input);\n  if (hyphenTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = hyphenTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const compactTime = COMPACT_TIME.exec(input);\n  if (compactTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const datePrefixLength = 10;\n  const datePrefix = input.slice(0, datePrefixLength);\n  if (isHyphenDatePrefix(datePrefix)) {\n    let index = datePrefixLength;\n    while (index < input.length && isWhitespaceCharacter(input[index])) {\n      index += 1;\n    }\n    if (index < input.length) {\n      push(`${datePrefix}T${input.slice(index)}`);\n    }\n  }\n\n  return candidates;\n}\n\nfunction parseTimestampWithFallbacks(input: string): number {\n  const direct = Date.parse(input);\n  if (Number.isFinite(direct)) return direct;\n  for (const candidate of normalizeTimestampCandidates(input)) {\n    const parsed = Date.parse(candidate);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return Number.NaN;\n}\n\nfunction isHyphenDatePrefix(value: string): boolean {\n  if (value.length !== 10) {\n    return false;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const character = value[index];\n    if (index === 4 || index === 7) {\n      if (character !== \"-\") {\n        return false;\n      }\n      continue;\n    }\n    const code = character.charCodeAt(0);\n    if (code < 48 || code > 57) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction isWhitespaceCharacter(character: string | undefined): boolean {\n  if (!character) {\n    return false;\n  }\n  return (\n    character === \" \" ||\n    character === \"\\t\" ||\n    character === \"\\n\" ||\n    character === \"\\r\" ||\n    character === \"\\f\" ||\n    character === \"\\v\"\n  );\n}\n\nfunction daysInUtcMonth(year: number, monthIndex: number): number {\n  return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();\n}\n\nconst MONTH_NAMES = [\n  \"January\",\n  \"February\",\n  \"March\",\n  \"April\",\n  \"May\",\n  \"June\",\n  \"July\",\n  \"August\",\n  \"September\",\n  \"October\",\n  \"November\",\n  \"December\",\n] as const;\n\n// Leading literal calendar date in either hyphenated (`2026-02-30`) or compact\n// (`20260230`) form, optionally followed by any time/zone component. We validate\n// the digits the caller actually typed — not the parsed instant — so timezone\n// offsets never produce a false \"impossible date\" rejection. The hyphenated form\n// is unambiguous, so anything may follow (`T`/space time, `Z`, `+/-` offset). The\n// compact form must be followed by end-of-string or a time digit (with an optional\n// `T`/space separator) so a no-separator compact datetime like `20260230135900Z`\n// is still guarded and a 7-digit non-date is not misread as a date.\nconst LEADING_HYPHEN_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})/;\nconst LEADING_COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})(?:[T ]?\\d{2}|$)/;\n\n/**\n * Reject literal calendar dates whose day cannot exist (e.g. `2026-02-30`, which JS\n * `Date` silently rolls forward to March 2). Without this, agents that pass an\n * impossible deadline get a silently-wrong stored date instead of an actionable\n * error. Only triggers on a leading literal date; relative tokens, \"now\", and pure\n * times are untouched. Month 00 / >12 is also rejected with a clear message rather\n * than falling through to the generic \"invalid value\" path.\n */\nfunction assertRealCalendarDate(originalInput: string, trimmed: string, fieldLabel: string): void {\n  const match = LEADING_HYPHEN_DATE.exec(trimmed) ?? LEADING_COMPACT_DATE.exec(trimmed);\n  if (!match) {\n    return;\n  }\n  const year = Number.parseInt(match[1], 10);\n  const month = Number.parseInt(match[2], 10);\n  const day = Number.parseInt(match[3], 10);\n  const label = fieldLabel?.trim() || \"deadline\";\n  if (month < 1 || month > 12) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". Month \"${match[2]}\" is out of range — use a month between 01 and 12.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const maxDay = daysInUtcMonth(year, month - 1);\n  if (day < 1 || day > maxDay) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". ${MONTH_NAMES[month - 1]} ${year} has ${maxDay} days, so day \"${match[3]}\" does not exist. Use a real YYYY-MM-DD calendar date.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction addUtcMonths(now: Date, amount: number): Date {\n  const result = new Date(now.getTime());\n  const startDay = result.getUTCDate();\n  const targetMonthIndex = result.getUTCMonth() + amount;\n  const targetYear = result.getUTCFullYear() + Math.floor(targetMonthIndex / 12);\n  const targetMonth = ((targetMonthIndex % 12) + 12) % 12;\n  const day = Math.min(startDay, daysInUtcMonth(targetYear, targetMonth));\n  result.setUTCFullYear(targetYear, targetMonth, day);\n  return result;\n}\n\n/**\n * Implements resolve iso or relative for the public runtime surface of this module.\n */\nexport function resolveIsoOrRelative(\n  input: string,\n  now: Date = new Date(),\n  fieldLabel = \"deadline\",\n): string {\n  const trimmed = input.trim();\n  if (trimmed.toLowerCase() === \"now\") {\n    return now.toISOString();\n  }\n  const relative = RELATIVE_DEADLINE.exec(trimmed);\n  if (relative) {\n    const sign = relative[1] === \"-\" ? -1 : 1;\n    const amount = Number.parseInt(relative[2], 10) * sign;\n    const unit = relative[3].toLowerCase();\n    if (unit === \"m\") {\n      return addUtcMonths(now, amount).toISOString();\n    }\n    const msPerUnit = unit === \"h\" ? 60 * 60 * 1000 : unit === \"d\" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;\n    return new Date(now.getTime() + amount * msPerUnit).toISOString();\n  }\n\n  assertRealCalendarDate(input, trimmed, fieldLabel);\n\n  const timestamp = parseTimestampWithFallbacks(trimmed);\n  if (!Number.isFinite(timestamp)) {\n    const normalizedLabel = fieldLabel.trim().length > 0 ? fieldLabel.trim() : \"deadline\";\n    const guidance = COMPOUND_RELATIVE_DEADLINE.test(trimmed)\n      ? \"Compound relative expressions like +3d+1h are not supported; use a single relative token (for example +3d) or an ISO/date string.\"\n      : 'Use ISO/date string input, \"now\", or relative +6h/-6h/+1d/-1d/+2w/-2w/+6m/-6m.';\n    throw new PmCliError(\n      `Invalid ${normalizedLabel} value \"${input}\". ${guidance}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return new Date(timestamp).toISOString();\n}\n\nexport const _testOnly = {\n  normalizeOffset,\n  pushTimestampCandidate,\n  normalizeTimestampCandidates,\n  parseTimestampWithFallbacks,\n  isWhitespaceCharacter,\n};\n"],"names":[],"mappings":"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","debugId":"6beae0c5-95ce-5ca2-9c64-67075f518c1a"}