@unbrained/pm-cli 2026.6.9 → 2026.6.11

package/dist/cli-bundle/chunks/{chunk-I4FGL3K2.js → chunk-UOO6BYIA.js}

@@ -1,15 +1,15 @@
 
-!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]="a07f6898-1c0c-5eb9-98f9-4f8aef2001f5")}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]="5597e7ea-39ad-5bd4-9a7a-5a7428ea5e27")}catch(e){}}();
 import {
   verifyHistoryChain
-} from "./chunk-NJRZIJ4N.js";
+} from "./chunk-ZYNJNPYD.js";
 import {
   hashDocument
-} from "./chunk-AVGOVJGV.js";
+} from "./chunk-HI7STVF2.js";
 import {
   getHistoryPath,
   writeFileAtomic
-} from "./chunk-5JF76OJF.js";
+} from "./chunk-A6LXQFO7.js";
 
 // dist/core/history/drift-scan.js
 import fs from "fs/promises";
@@ -230,6 +230,11 @@ var REMEDIATION_REGISTRY = Object.freeze([
     command: "pm health --check-telemetry",
     summary: "Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."
   },
+  {
+    code: "telemetry_queue_high_retries",
+    command: "pm telemetry flush",
+    summary: "Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."
+  },
   {
     code: "telemetry_endpoint_probe_failed",
     command: "pm health --check-telemetry",
@@ -303,6 +308,11 @@ var REMEDIATION_REGISTRY = Object.freeze([
     command: "pm health --refresh-vectors",
     summary: "Some items have stale embeddings; refresh vectors so semantic search results stay current."
   },
+  {
+    code: "vectorization_embedding_identity_changed",
+    command: "pm reindex --mode semantic",
+    summary: "Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."
+  },
   // --- pm validate: metadata ---
   // Note: validate_metadata_missing_author has no entry on purpose. `pm update
   // --author` sets the mutation/audit author (history), not the item's
@@ -461,6 +471,6 @@ export {
   buildRemediationMap,
   buildRemediationCommands
 };
-//# sourceMappingURL=chunk-I4FGL3K2.js.map
+//# sourceMappingURL=chunk-UOO6BYIA.js.map
 
-//# debugId=a07f6898-1c0c-5eb9-98f9-4f8aef2001f5
+//# debugId=5597e7ea-39ad-5bd4-9a7a-5a7428ea5e27

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/history/drift-scan.ts","../../../../../../../../core/diagnostics/remediation.ts"],"sourcesContent":["import fs from \"fs/promises\";\nimport { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { getHistoryPath } from \"../store/paths.js\";\nimport { writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { hashDocument } from \"./history.js\";\nimport { verifyHistoryChain } from \"./replay.js\";\nimport type { HistoryEntry, ItemMetadata } from \"../../types/index.js\";\n\nexport interface DriftScanResult {\n  missingStreams: string[];\n  unreadableStreams: string[];\n  hashMismatches: string[];\n  chainMismatches: string[];\n  driftedItems: string[];\n}\n\nconst DRIFT_CACHE_VERSION = 2;\nconst DRIFT_CACHE_FILENAME = \"history-drift-cache.json\";\n\ninterface DriftCacheEntry {\n  mtime_ms: number;\n  ctime_ms: number;\n  size: number;\n  content_hash: string;\n  latest_after_hash: string;\n  chain_ok: boolean;\n}\n\ninterface DriftCacheEnvelope {\n  version: number;\n  entries: Record<string, DriftCacheEntry>;\n}\n\nfunction getDriftCachePath(pmRoot: string): string {\n  return path.join(pmRoot, \"runtime\", DRIFT_CACHE_FILENAME);\n}\n\nasync function loadDriftCache(pmRoot: string): Promise<DriftCacheEnvelope | null> {\n  try {\n    const raw = await fs.readFile(getDriftCachePath(pmRoot), \"utf8\");\n    const parsed = JSON.parse(raw) as DriftCacheEnvelope;\n    if (parsed.version !== DRIFT_CACHE_VERSION || typeof parsed.entries !== \"object\" || parsed.entries === null) {\n      return null;\n    }\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\ninterface StreamVerification {\n  latestAfterHash: string;\n  chainOk: boolean;\n  contentHash: string;\n}\n\nfunction hashContent(raw: string): string {\n  return createHash(\"sha256\").update(raw).digest(\"hex\");\n}\n\nasync function readHistoryContentHash(historyPath: string): Promise<string> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  return hashContent(raw);\n}\n\n/**\n * Read and fully verify one history stream's hash chain. Returns null for an\n * empty/missing stream (caller records it as a missing stream).\n */\nasync function verifyHistoryStream(historyPath: string): Promise<StreamVerification | null> {\n  const raw = await fs.readFile(historyPath, \"utf8\");\n  const contentHash = hashContent(raw);\n  if (raw.trim().length === 0) {\n    return null;\n  }\n  const entries: HistoryEntry[] = [];\n  let latestAfterHash: string | null = null;\n  for (const line of raw.split(/\\r?\\n/)) {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    const parsed = JSON.parse(trimmed) as HistoryEntry;\n    if (typeof parsed.after_hash !== \"string\" || parsed.after_hash.trim().length === 0) {\n      throw new Error(\"missing after_hash\");\n    }\n    entries.push(parsed);\n    latestAfterHash = parsed.after_hash;\n  }\n  /* c8 ignore start -- defensive guard for future history schema changes. */\n  if (!latestAfterHash) {\n    return null;\n  }\n  /* c8 ignore stop */\n  return {\n    latestAfterHash,\n    chainOk: verifyHistoryChain(entries).ok,\n    contentHash,\n  };\n}\n\n/**\n * Scan every item's history stream for drift (missing/unreadable streams, broken\n * hash chains, and item/history hash mismatches).\n *\n * Full chain re-verification of a 17MB+ history tree is the dominant cost of\n * `pm health`. We cache the per-stream verification keyed by the history file's\n * mtime/ctime/size + content hash: metadata-stable replacements (same stat tuple)\n * can still happen, so each metadata hit recomputes a content hash guard before\n * trusting the cached chain/hash verification.\n */\nexport async function scanHistoryDrift(\n  pmRoot: string,\n  items: Array<ItemMetadata & { body: string }>,\n): Promise<DriftScanResult> {\n  const missingStreams: string[] = [];\n  const unreadableStreams: string[] = [];\n  const hashMismatches: string[] = [];\n  const chainMismatches: string[] = [];\n\n  const cache = await loadDriftCache(pmRoot);\n  const previousEntries: Record<string, DriftCacheEntry> = cache?.entries ?? {};\n  const nextEntries: Record<string, DriftCacheEntry> = {};\n  let cacheDirty = false;\n\n  for (const item of items) {\n    const historyPath = getHistoryPath(pmRoot, item.id);\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(historyPath);\n    } catch (error: unknown) {\n      if (isErrno(error, \"ENOENT\")) {\n        missingStreams.push(item.id);\n      } else {\n        unreadableStreams.push(item.id);\n      }\n      continue;\n    }\n\n    const loadStreamVerification = async (): Promise<StreamVerification | null | \"unreadable\"> => {\n      try {\n        return await verifyHistoryStream(historyPath);\n      } catch {\n        return \"unreadable\";\n      }\n    };\n\n    const loadFreshVerification = async (): Promise<StreamVerification | null> => {\n      const loaded = await loadStreamVerification();\n      if (loaded === \"unreadable\") {\n        unreadableStreams.push(item.id);\n        return null;\n      }\n      if (!loaded) {\n        missingStreams.push(item.id);\n        return null;\n      }\n      return loaded;\n    };\n\n    const cached = previousEntries[item.id];\n    let verification: StreamVerification;\n    const metadataMatchesCache =\n      cached !== undefined &&\n      cached.mtime_ms === stat.mtimeMs &&\n      cached.ctime_ms === stat.ctimeMs &&\n      cached.size === stat.size;\n    const cachedContentHash =\n      typeof cached?.content_hash === \"string\" && cached.content_hash.length > 0 ? cached.content_hash : undefined;\n    const canUseCache = metadataMatchesCache && cachedContentHash !== undefined;\n    if (canUseCache && cached) {\n      let currentContentHash: string;\n      try {\n        currentContentHash = await readHistoryContentHash(historyPath);\n      } catch {\n        unreadableStreams.push(item.id);\n        continue;\n      }\n      if (currentContentHash === cachedContentHash) {\n        verification = {\n          latestAfterHash: cached.latest_after_hash,\n          chainOk: cached.chain_ok,\n          contentHash: currentContentHash,\n        };\n      } else {\n        cacheDirty = true;\n        const refreshed = await loadFreshVerification();\n        if (!refreshed) {\n          continue;\n        }\n        verification = refreshed;\n      }\n    } else {\n      cacheDirty = true;\n      const refreshed = await loadFreshVerification();\n      if (!refreshed) {\n        continue;\n      }\n      verification = refreshed;\n    }\n\n    if (!verification.chainOk) {\n      chainMismatches.push(item.id);\n    }\n    nextEntries[item.id] = {\n      mtime_ms: stat.mtimeMs,\n      ctime_ms: stat.ctimeMs,\n      size: stat.size,\n      content_hash: verification.contentHash,\n      latest_after_hash: verification.latestAfterHash,\n      chain_ok: verification.chainOk,\n    };\n\n    const { body, ...frontMatter } = item;\n    const currentHash = hashDocument({\n      metadata: frontMatter as ItemMetadata,\n      body,\n    });\n    if (currentHash !== verification.latestAfterHash) {\n      hashMismatches.push(item.id);\n    }\n  }\n\n  if (cacheDirty || Object.keys(previousEntries).length !== Object.keys(nextEntries).length) {\n    const cachePath = getDriftCachePath(pmRoot);\n    try {\n      await fs.mkdir(path.dirname(cachePath), { recursive: true });\n      await writeFileAtomic(cachePath, JSON.stringify({ version: DRIFT_CACHE_VERSION, entries: nextEntries }));\n    } catch {\n      // Best-effort cache write: a failed persist must never fail a health scan.\n    }\n  }\n\n  const driftedItems = [...new Set([...missingStreams, ...unreadableStreams, ...hashMismatches, ...chainMismatches])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  return { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems };\n}\n","/**\n * Shared machine-executable remediation registry.\n *\n * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens\n * (for example `history_drift_missing_stream:pm-abcd` or\n * `validate_resolution_missing_fields:3`). Agents that gate on these commands\n * previously had to hardcode the mapping from a warning code to the `pm` command\n * that fixes it. This module is the single source of truth for that mapping so\n * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`\n * (per-check `fix_hints`) can both surface executable remediation without any\n * duplicated, drift-prone lookup tables.\n *\n * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command\n * an operator/agent should run to resolve findings with that code. Per-item\n * findings use an `<id>` placeholder (callers that have the concrete id may\n * substitute it); findings whose only fix is a manual file edit point at the\n * most useful diagnostic/repair command and describe the manual step in\n * {@link RemediationEntry.summary}.\n */\n\nexport interface RemediationEntry {\n  /**\n   * Stable warning-code prefix this entry resolves. A warning matches when it\n   * equals this code or begins with `<code>:`. Registry codes are mutually\n   * exclusive under that colon-boundary rule (no code is a `:`-delimited prefix\n   * of another — e.g. `settings:id_prefix_empty` is distinct from a bare\n   * `settings`, which is intentionally not registered), so `resolveRemediation`\n   * uses first-match with no ordering dependency.\n   */\n  readonly code: string;\n  /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */\n  readonly command: string;\n  /** One-line description of what the command does / which manual step it covers. */\n  readonly summary: string;\n}\n\n/**\n * Registry of every non-extension `pm health` / `pm validate` warning code and\n * its remediation. Extension findings keep their richer, contextual\n * `details.triage.remediation` produced by the extension health triage and are\n * intentionally excluded here (see pm-0hnu: \"all non-extension checks\").\n */\nexport const REMEDIATION_REGISTRY: readonly RemediationEntry[] = Object.freeze([\n  // --- pm health: directories ---\n  {\n    code: \"missing_directory\",\n    command: \"pm init\",\n    summary: \"Recreate missing tracker directories (pm init is idempotent and restores the scaffold).\",\n  },\n  // --- pm health: settings (read/parse) ---\n  {\n    code: \"settings_read_invalid_json\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_schema\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run.\",\n  },\n  {\n    code: \"settings_read_merge_failed\",\n    command: \"pm config list --json\",\n    summary: \"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files.\",\n  },\n  // --- pm health: settings_values ---\n  {\n    code: \"settings:id_prefix_empty\",\n    command: \"pm config list --json\",\n    summary: 'id_prefix is empty; set a non-empty \"id_prefix\" in settings.json so generated item ids are well-formed.',\n  },\n  {\n    code: \"settings:locks_ttl_non_positive\",\n    command: \"pm config list --json\",\n    summary: 'locks.ttl_seconds must be positive; set a positive \"locks.ttl_seconds\" in settings.json.',\n  },\n  // --- pm health: telemetry (advisory) ---\n  {\n    code: \"telemetry_state_invalid_json\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_invalid_rows\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_pending\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_high_retries\",\n    command: \"pm telemetry flush\",\n    summary:\n      \"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_failed\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_http_status\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_schema_version_behind\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Client schema is behind server; upgrade pm-cli to emit the latest event shape.\",\n  },\n  // --- pm health: integrity ---\n  {\n    code: \"integrity_item_unreadable\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file could not be read; restore or repair the file at the reported path.\",\n  },\n  {\n    code: \"integrity_item_parse_failed\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file failed to parse; fix the malformed front matter at the reported path.\",\n  },\n  {\n    code: \"integrity_item_conflict_marker\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line.\",\n  },\n  {\n    code: \"integrity_history_unreadable\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream could not be read; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_invalid_json\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains invalid JSON; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_conflict_marker\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain.\",\n  },\n  // --- pm health: history_drift ---\n  {\n    code: \"history_drift_missing_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item has no history stream; re-anchor the chain to rebuild it.\",\n  },\n  {\n    code: \"history_drift_unreadable_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history stream is unreadable; re-anchor the chain.\",\n  },\n  {\n    code: \"history_drift_hash_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's content hash no longer matches its history; re-anchor the chain.\",\n  },\n  {\n    code: \"history_drift_chain_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history chain is broken; re-anchor the chain.\",\n  },\n  // --- pm health: vectorization ---\n  {\n    code: \"vectorization_stale_items_remaining\",\n    command: \"pm health --refresh-vectors\",\n    summary: \"Some items have stale embeddings; refresh vectors so semantic search results stay current.\",\n  },\n  {\n    code: \"vectorization_embedding_identity_changed\",\n    command: \"pm reindex --mode semantic\",\n    summary: \"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors.\",\n  },\n  // --- pm validate: metadata ---\n  // Note: validate_metadata_missing_author has no entry on purpose. `pm update\n  // --author` sets the mutation/audit author (history), not the item's\n  // `metadata.author` front-matter field, and there is no CLI flag that writes\n  // that field — so emitting a command here would record an audit entry without\n  // clearing the finding. A missing item author must be restored at the source.\n  {\n    code: \"validate_metadata_missing_acceptance_criteria\",\n    command: 'pm update <id> --acceptance-criteria \"<criteria>\"',\n    summary: \"Backfill the missing acceptance criteria on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_estimate\",\n    command: 'pm update <id> --estimate \"<estimate>\"',\n    summary: \"Backfill the missing estimate on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_close_reason\",\n    command: 'pm update <id> --close-reason \"<reason>\"',\n    summary: \"Backfill the missing close reason on the reported closed item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_reviewer\",\n    command: 'pm update <id> --reviewer \"<name>\"',\n    summary: \"Backfill the missing reviewer on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_risk\",\n    command: 'pm update <id> --risk \"<level>\"',\n    summary: \"Backfill the missing risk on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_confidence\",\n    command: 'pm update <id> --confidence \"<level>\"',\n    summary: \"Backfill the missing confidence on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_sprint\",\n    command: 'pm update <id> --sprint \"<sprint>\"',\n    summary: \"Backfill the missing sprint on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_release\",\n    command: 'pm update <id> --release \"<release>\"',\n    summary: \"Backfill the missing release on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_custom_profile_missing_required_fields\",\n    command: 'pm config set metadata-required-fields --criterion \"<field>\"',\n    summary:\n      \"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items.\",\n  },\n  // --- pm validate: resolution ---\n  {\n    code: \"validate_resolution_missing_fields\",\n    command: 'pm update <id> --resolution \"<how resolved>\"',\n    summary: \"Backfill resolution / expected_result / actual_result on the reported closed item(s).\",\n  },\n  // --- pm validate: lifecycle ---\n  {\n    code: \"validate_lifecycle_active_closure_like_metadata\",\n    command: \"pm update <id> --unset <closure-like-field>\",\n    summary:\n      \"Clear the closure-like field the validator flags on this active item — the detail row names it (resolution / actual-result / blocked-reason) — or close the item if it is actually done.\",\n  },\n  {\n    code: \"validate_lifecycle_active_terminal_parent\",\n    command: \"pm update <id> --parent <active-parent-id>\",\n    summary: \"Reopen the terminal parent or move the active child under a non-terminal parent.\",\n  },\n  {\n    code: \"validate_lifecycle_stale_blockers\",\n    command: \"pm update <id> --unset blocked-by --unset blocked-reason\",\n    summary:\n      \"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles_error\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  // --- pm validate: files ---\n  {\n    code: \"validate_files_missing_linked_paths\",\n    command: \"pm <files|docs> <id> --remove <path>\",\n    summary:\n      \"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc).\",\n  },\n  {\n    code: \"validate_files_orphaned_paths\",\n    command: \"pm <files|docs> <id> --add <path>\",\n    summary:\n      \"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace.\",\n  },\n  {\n    code: \"validate_files_tracked_all_strict_forces_pm_internals\",\n    command: \"pm validate --check-files --include-pm-internals\",\n    summary: \"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode.\",\n  },\n  // --- pm validate: history_drift ---\n  {\n    code: \"validate_history_drift_missing_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items missing a history stream.\",\n  },\n  {\n    code: \"validate_history_drift_unreadable_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with an unreadable history stream.\",\n  },\n  {\n    code: \"validate_history_drift_hash_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items whose content hash drifted.\",\n  },\n  {\n    code: \"validate_history_drift_chain_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with a broken history chain.\",\n  },\n  // --- pm validate: command_references ---\n  {\n    code: \"validate_command_references_stale_pm_ids\",\n    command: 'pm update <id> --replace-tests --test \"command=<corrected-command>\" [--test ...]',\n    summary:\n      \"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call.\",\n  },\n]);\n\n/**\n * Resolve the remediation entry for a warning token, or `undefined` when no\n * entry is registered. A warning matches an entry when it equals the entry code\n * or begins with `<code>:` (the colon boundary keeps sibling codes such as\n * `validate_lifecycle_dependency_cycles` and\n * `validate_lifecycle_dependency_cycles_error` disjoint).\n *\n * First match is intentional and correct: registry codes are mutually exclusive\n * under the colon-boundary rule, so at most one entry can ever match a warning\n * and order is irrelevant. That invariant is enforced by a test (see\n * remediation-registry.spec.ts \"keeps every registry code mutually exclusive\"),\n * which is why this stays a simple linear scan rather than a longest-prefix\n * search — a longest-prefix tie-break is unreachable with disjoint codes.\n *\n * Accepts unknown input defensively (this is an exported helper SDK consumers\n * may call from untyped JS): a non-string `warning` resolves to `undefined`.\n */\nexport function resolveRemediation(warning: string): RemediationEntry | undefined {\n  if (typeof warning !== \"string\") {\n    return undefined;\n  }\n  const normalized = warning.trim();\n  for (const entry of REMEDIATION_REGISTRY) {\n    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Build a compact `remediation_map` (code -> command) for a set of warning\n * tokens. First match wins per code; unknown codes are skipped. Used by\n * `pm health --json` per-check details and as the source of deduped executable\n * commands for `pm validate --fix-hints`.\n */\nexport function buildRemediationMap(warnings: Iterable<string>): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const warning of warnings) {\n    const entry = resolveRemediation(warning);\n    if (entry !== undefined && !Object.prototype.hasOwnProperty.call(map, entry.code)) {\n      map[entry.code] = entry.command;\n    }\n  }\n  return map;\n}\n\n/**\n * Build a deduped, ordered list of executable remediation commands for a set of\n * warning tokens (one command per distinct matched code). Used by\n * `pm validate --fix-hints` for checks that do not already emit per-row\n * remediation commands.\n */\nexport function buildRemediationCommands(warnings: Iterable<string>): string[] {\n  return Object.values(buildRemediationMap(warnings));\n}\n"],"names":[],"mappings":"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","debugId":"5597e7ea-39ad-5bd4-9a7a-5a7428ea5e27"}

package/dist/cli-bundle/chunks/{chunk-5ATRWEZO.js → chunk-UUWGCWBU.js}

@@ -3,7 +3,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-PW7C262O.js";
+} from "./chunk-WUNFKP7M.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -19,7 +19,7 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-5JF76OJF.js";
+} from "./chunk-A6LXQFO7.js";
 
 // dist/core/schema/runtime-field-values.js
 function toCamelToken(value) {
@@ -1324,6 +1324,6 @@ export {
   serializeItemDocument,
   canonicalDocument
 };
-//# sourceMappingURL=chunk-5ATRWEZO.js.map
+//# sourceMappingURL=chunk-UUWGCWBU.js.map
 
 //# debugId=8e6380db-298c-5343-b79e-9939444e8ad2

package/dist/cli-bundle/chunks/{chunk-YX5LAKFJ.js → chunk-VAOUX6TK.js}

@@ -5,7 +5,7 @@ import {
   PmCliError,
   isPathWithinDirectory,
   pathExists
-} from "./chunk-5JF76OJF.js";
+} from "./chunk-A6LXQFO7.js";
 
 // dist/cli/commands/extension/shared.js
 import fs from "node:fs/promises";
@@ -107,6 +107,6 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-YX5LAKFJ.js.map
+//# sourceMappingURL=chunk-VAOUX6TK.js.map
 
 //# debugId=537a6d63-6806-5bdc-ae0f-3e84cf25eb7e

package/dist/cli-bundle/chunks/{chunk-RMTI5R76.js → chunk-VFUZV5EB.js}

@@ -1,14 +1,16 @@
 import {
   listAllFrontMatterLight,
+  locateItem,
   mutateItem,
+  readLocatedItem,
   toItemRecord
-} from "./chunk-LF2VNLEZ.js";
+} from "./chunk-3KLPFWZ4.js";
 import {
   isTerminalStatus
-} from "./chunk-NHRZSYAA.js";
+} from "./chunk-73ZPG2I3.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-U3Z4OCZC.js";
+} from "./chunk-5SCT2JCT.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -17,13 +19,13 @@ import {
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-C72IQIBT.js";
+} from "./chunk-FY4SPXSC.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] = "96f50581-e721-5ccd-b360-651ab15f5cca");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3c2738c8-5226-561a-b6c6-e321597f6658");
   } catch (e2) {
   }
 })();
@@ -85,6 +87,77 @@ function findMissingCloseValidationFields(frontMatter) {
   }
   return missing;
 }
+async function duplicateChainReferencesClosingItem(loadItemById, initialDuplicateOf, closingId) {
+  const visited = /* @__PURE__ */ new Set();
+  let current = initialDuplicateOf;
+  while (typeof current === "string" && current.trim().length > 0) {
+    const currentId = current.trim();
+    if (currentId === closingId) {
+      return true;
+    }
+    if (visited.has(currentId)) {
+      return false;
+    }
+    visited.add(currentId);
+    current = (await loadItemById(currentId))?.duplicate_of;
+  }
+  return false;
+}
+function shouldApplyDuplicateFallback(value) {
+  return typeof value !== "string" || value.trim().length === 0;
+}
+async function assertDuplicateTargetExists(pmRoot, settings, duplicateOf, closingId) {
+  const rawTarget = duplicateOf?.trim();
+  if (!rawTarget) {
+    return void 0;
+  }
+  if (rawTarget === closingId) {
+    throw new PmCliError("An item cannot be closed as a duplicate of itself.", EXIT_CODE.USAGE, {
+      code: "duplicate_target_self",
+      why: "--duplicate-of must identify the canonical item that should remain open or already represent the work."
+    });
+  }
+  const typeRegistry = resolveItemTypeRegistry(settings);
+  const itemCache = /* @__PURE__ */ new Map();
+  const loadItemById = async (id) => {
+    if (itemCache.has(id)) {
+      return itemCache.get(id) ?? null;
+    }
+    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
+    if (!located) {
+      itemCache.set(id, null);
+      return null;
+    }
+    const { document } = await readLocatedItem(located, { schema: settings.schema });
+    itemCache.set(id, document.metadata);
+    return document.metadata;
+  };
+  const target = await loadItemById(rawTarget);
+  if (!target) {
+    throw new PmCliError(`Duplicate target "${rawTarget}" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {
+      code: "duplicate_target_missing",
+      why: "Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.",
+      examples: [`pm close ${closingId} "Duplicate of ${rawTarget}" --duplicate-of ${rawTarget}`],
+      nextSteps: ["Run pm search/list to find the canonical item, then retry with --duplicate-of <id>."]
+    });
+  }
+  if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {
+    throw new PmCliError(`Circular duplicate reference detected. Target "${rawTarget}" points back to "${closingId}".`, EXIT_CODE.USAGE, {
+      code: "duplicate_target_circular",
+      why: "Circular duplicate relationships create loops for dedupe and status propagation tooling.",
+      nextSteps: ["Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate."]
+    });
+  }
+  if (typeof target.duplicate_of === "string" && target.duplicate_of.trim().length > 0) {
+    throw new PmCliError(`Duplicate target "${rawTarget}" is already marked as a duplicate of "${target.duplicate_of.trim()}".`, EXIT_CODE.USAGE, {
+      code: "duplicate_target_is_duplicate",
+      why: "Duplicate closure should point directly at the canonical item, not another duplicate.",
+      examples: [`pm close ${closingId} "Duplicate of ${target.duplicate_of.trim()}" --duplicate-of ${target.duplicate_of.trim()}`],
+      nextSteps: ["Use the canonical item referenced by duplicate_of as the --duplicate-of target."]
+    });
+  }
+  return target.id;
+}
 async function findActiveChildIds(pmRoot, settings, parentId, statusRegistry) {
   const typeRegistry = resolveItemTypeRegistry(settings);
   const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
@@ -99,6 +172,7 @@ async function runClose(id, closeReasonText, options, global2) {
   const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
   const author = toAuthor(options.author, settings.author_default);
   const closeReason = normalizeCloseReason(closeReasonText, settings.governance.require_close_reason);
+  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);
   const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;
   const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);
   const result = await mutateItem({
@@ -119,6 +193,7 @@ async function runClose(id, closeReasonText, options, global2) {
         { option: options.expectedResult, key: "expected_result" },
         { option: options.actualResult, key: "actual_result" }
       ];
+      const duplicateFallbackFields = [];
       for (const { option, key } of inlineCloseFields) {
         if (typeof option !== "string")
           continue;
@@ -127,6 +202,24 @@ async function runClose(id, closeReasonText, options, global2) {
           continue;
         document.metadata[key] = trimmed;
       }
+      if (duplicateOf !== void 0) {
+        document.metadata.duplicate_of = duplicateOf;
+        const duplicateResolution = `Duplicate of ${duplicateOf}`;
+        const duplicateExpectedResult = `Canonical item ${duplicateOf} tracks the work.`;
+        const duplicateActualResult = `Closed as duplicate of ${duplicateOf}.`;
+        if (shouldApplyDuplicateFallback(document.metadata.resolution)) {
+          document.metadata.resolution = duplicateResolution;
+          duplicateFallbackFields.push("resolution");
+        }
+        if (shouldApplyDuplicateFallback(document.metadata.expected_result)) {
+          document.metadata.expected_result = duplicateExpectedResult;
+          duplicateFallbackFields.push("expected_result");
+        }
+        if (shouldApplyDuplicateFallback(document.metadata.actual_result)) {
+          document.metadata.actual_result = duplicateActualResult;
+          duplicateFallbackFields.push("actual_result");
+        }
+      }
       if (validateCloseMode !== "off") {
         const missingFields = findMissingCloseValidationFields(document.metadata);
         if (missingFields.length > 0) {
@@ -158,6 +251,18 @@ async function runClose(id, closeReasonText, options, global2) {
           changedFields.push(key);
         }
       }
+      if (duplicateOf !== void 0) {
+        changedFields.push("duplicate_of");
+        if (duplicateFallbackFields.includes("resolution") && !changedFields.includes("resolution")) {
+          changedFields.push("resolution");
+        }
+        if (duplicateFallbackFields.includes("expected_result") && !changedFields.includes("expected_result")) {
+          changedFields.push("expected_result");
+        }
+        if (duplicateFallbackFields.includes("actual_result") && !changedFields.includes("actual_result")) {
+          changedFields.push("actual_result");
+        }
+      }
       if (document.metadata.assignee !== void 0) {
         delete document.metadata.assignee;
         changedFields.push("assignee");
@@ -203,4 +308,4 @@ async function runClose(id, closeReasonText, options, global2) {
 export {
   runClose
 };
-//# sourceMappingURL=chunk-RMTI5R76.js.map
+//# sourceMappingURL=chunk-VFUZV5EB.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/close.ts"],
+  "sourcesContent": ["import { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { toItemRecord } from \"../../core/item/item-record.js\";\nimport { isTerminalStatus } from \"../../core/item/status.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { listAllFrontMatterLight, locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter } from \"../../types/index.js\";\n\nexport interface CloseCommandOptions {\n  author?: string;\n  message?: string;\n  validateClose?: string;\n  force?: boolean;\n  // pm-fl0c #11 (2026-05-28): allow setting the three closure validation\n  // fields inline on `pm close` so agents do not have to issue a prior\n  // `pm update` just to satisfy --validate-close warn|strict. These map 1:1\n  // to ItemFrontMatter.{resolution,expected_result,actual_result}.\n  resolution?: string;\n  expectedResult?: string;\n  actualResult?: string;\n  duplicateOf?: string;\n}\n\nexport interface CloseResult {\n  item: Record<string, unknown>;\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed || \"unknown\";\n}\n\nfunction normalizeCloseReason(reasonText: string | undefined, required: boolean): string | undefined {\n  const reason = (reasonText ?? \"\").trim();\n  if (reason.length > 0) {\n    return reason;\n  }\n  if (required) {\n    throw new PmCliError(\n      \"Close reason text is required because governance.require_close_reason is enabled\",\n      EXIT_CODE.USAGE,\n      {\n        code: \"close_reason_required\",\n        required: \"Provide a one-line closing summary as the positional text or via --reason.\",\n        why: \"governance.require_close_reason is enabled, so every close must record why the item is done.\",\n        examples: [\n          'pm close <id> \"Done: <what changed and why>\"',\n          'pm close <id> --reason \"<closing summary>\"',\n        ],\n        nextSteps: [\n          \"Re-run the close with a closing summary.\",\n          \"To stop requiring reasons, run: pm config set governance-require-close-reason --policy disabled\",\n        ],\n      },\n    );\n  }\n  return undefined;\n}\n\ntype ValidateCloseMode = \"off\" | \"warn\" | \"strict\";\n\nconst CLOSE_VALIDATION_FIELDS: Array<{ key: keyof Pick<ItemFrontMatter, \"resolution\" | \"expected_result\" | \"actual_result\">; label: string }> = [\n  { key: \"resolution\", label: \"resolution\" },\n  { key: \"expected_result\", label: \"expected_result\" },\n  { key: \"actual_result\", label: \"actual_result\" },\n];\n\nfunction parseValidateCloseMode(raw: string | undefined): ValidateCloseMode | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (normalized.length === 0 || normalized === \"warn\") {\n    return \"warn\";\n  }\n  if (normalized === \"off\" || normalized === \"none\" || normalized === \"disabled\") {\n    return \"off\";\n  }\n  if (normalized === \"strict\") {\n    return \"strict\";\n  }\n  throw new PmCliError(`Invalid --validate-close mode \"${raw}\" (expected \"off\", \"warn\", or \"strict\")`, EXIT_CODE.USAGE);\n}\n\nfunction findMissingCloseValidationFields(frontMatter: ItemFrontMatter): string[] {\n  const missing: string[] = [];\n  for (const field of CLOSE_VALIDATION_FIELDS) {\n    const rawValue = frontMatter[field.key];\n    if (typeof rawValue !== \"string\" || rawValue.trim().length === 0) {\n      missing.push(field.label);\n    }\n  }\n  return missing;\n}\n\nasync function duplicateChainReferencesClosingItem(\n  loadItemById: (id: string) => Promise<ItemFrontMatter | null>,\n  initialDuplicateOf: unknown,\n  closingId: string,\n): Promise<boolean> {\n  const visited = new Set<string>();\n  let current = initialDuplicateOf;\n  while (typeof current === \"string\" && current.trim().length > 0) {\n    const currentId = current.trim();\n    if (currentId === closingId) {\n      return true;\n    }\n    if (visited.has(currentId)) {\n      return false;\n    }\n    visited.add(currentId);\n    current = (await loadItemById(currentId))?.duplicate_of;\n  }\n  return false;\n}\n\nfunction shouldApplyDuplicateFallback(value: unknown): boolean {\n  return typeof value !== \"string\" || value.trim().length === 0;\n}\n\nasync function assertDuplicateTargetExists(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  duplicateOf: string | undefined,\n  closingId: string,\n): Promise<string | undefined> {\n  const rawTarget = duplicateOf?.trim();\n  if (!rawTarget) {\n    return undefined;\n  }\n  if (rawTarget === closingId) {\n    throw new PmCliError(\"An item cannot be closed as a duplicate of itself.\", EXIT_CODE.USAGE, {\n      code: \"duplicate_target_self\",\n      why: \"--duplicate-of must identify the canonical item that should remain open or already represent the work.\",\n    });\n  }\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const itemCache = new Map<string, ItemFrontMatter | null>();\n  const loadItemById = async (id: string): Promise<ItemFrontMatter | null> => {\n    if (itemCache.has(id)) {\n      return itemCache.get(id) ?? null;\n    }\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      itemCache.set(id, null);\n      return null;\n    }\n    const { document } = await readLocatedItem(located, { schema: settings.schema });\n    itemCache.set(id, document.metadata);\n    return document.metadata;\n  };\n  const target = await loadItemById(rawTarget);\n  if (!target) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" was not found. Create or locate the canonical item first.`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_missing\",\n      why: \"Duplicate closure should point at a real canonical pm item so future dedupe and changelog tooling can trace the relationship.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${rawTarget}\" --duplicate-of ${rawTarget}`],\n      nextSteps: [\"Run pm search/list to find the canonical item, then retry with --duplicate-of <id>.\"],\n    });\n  }\n  if (await duplicateChainReferencesClosingItem(loadItemById, target.duplicate_of, closingId)) {\n    throw new PmCliError(`Circular duplicate reference detected. Target \"${rawTarget}\" points back to \"${closingId}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_circular\",\n      why: \"Circular duplicate relationships create loops for dedupe and status propagation tooling.\",\n      nextSteps: [\"Choose the existing canonical item, or clear the target duplicate_of metadata before closing this item as a duplicate.\"],\n    });\n  }\n  if (typeof target.duplicate_of === \"string\" && target.duplicate_of.trim().length > 0) {\n    throw new PmCliError(`Duplicate target \"${rawTarget}\" is already marked as a duplicate of \"${target.duplicate_of.trim()}\".`, EXIT_CODE.USAGE, {\n      code: \"duplicate_target_is_duplicate\",\n      why: \"Duplicate closure should point directly at the canonical item, not another duplicate.\",\n      examples: [`pm close ${closingId} \"Duplicate of ${target.duplicate_of.trim()}\" --duplicate-of ${target.duplicate_of.trim()}`],\n      nextSteps: [\"Use the canonical item referenced by duplicate_of as the --duplicate-of target.\"],\n    });\n  }\n  return target.id;\n}\n\nasync function findActiveChildIds(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  parentId: string,\n  statusRegistry: RuntimeStatusRegistry,\n): Promise<string[]> {\n  const typeRegistry = resolveItemTypeRegistry(settings);\n  const items = await listAllFrontMatterLight(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    undefined,\n    settings.schema,\n  );\n  return items\n    .filter((item) => item.parent === parentId && !isTerminalStatus(item.status, statusRegistry))\n    .map((item) => item.id)\n    .sort((left, right) => left.localeCompare(right));\n}\n\nexport async function runClose(\n  id: string,\n  closeReasonText: string | undefined,\n  options: CloseCommandOptions,\n  global: GlobalOptions,\n): Promise<CloseResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = toAuthor(options.author, settings.author_default);\n  const closeReason = normalizeCloseReason(closeReasonText, settings.governance.require_close_reason);\n  const duplicateOf = await assertDuplicateTargetExists(pmRoot, settings, options.duplicateOf, id);\n  const validateCloseMode = parseValidateCloseMode(options.validateClose) ?? settings.governance.close_validation_default;\n  // C3 (pm-fu5d): scan for active children even under minimal governance so\n  // closing a parent is never silently orphaning — off mode emits an\n  // informational note instead of the warn/strict validation warning.\n  const activeChildIds = await findActiveChildIds(pmRoot, settings, id, statusRegistry);\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"close\",\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      if (isTerminalStatus(document.metadata.status, statusRegistry) && !options.force) {\n        throw new PmCliError(`Item ${document.metadata.id} is already terminal; use --force to close again.`, EXIT_CODE.CONFLICT);\n      }\n      const mutationWarnings: string[] = [];\n      // pm-fl0c #11: apply inline closure fields BEFORE the validation pass so\n      // a single `pm close <id> \"reason\" --resolution \"...\"` call satisfies\n      // strict validation without a prior pm update. Only meaningful trimmed\n      // text writes; an empty/whitespace value is a no-op rather than a clear.\n      const inlineCloseFields: Array<{ option: string | undefined; key: \"resolution\" | \"expected_result\" | \"actual_result\" }> = [\n        { option: options.resolution, key: \"resolution\" },\n        { option: options.expectedResult, key: \"expected_result\" },\n        { option: options.actualResult, key: \"actual_result\" },\n      ];\n      const duplicateFallbackFields: Array<\"resolution\" | \"expected_result\" | \"actual_result\"> = [];\n      for (const { option, key } of inlineCloseFields) {\n        if (typeof option !== \"string\") continue;\n        const trimmed = option.trim();\n        if (trimmed.length === 0) continue;\n        document.metadata[key] = trimmed;\n      }\n      if (duplicateOf !== undefined) {\n        document.metadata.duplicate_of = duplicateOf;\n        const duplicateResolution = `Duplicate of ${duplicateOf}`;\n        const duplicateExpectedResult = `Canonical item ${duplicateOf} tracks the work.`;\n        const duplicateActualResult = `Closed as duplicate of ${duplicateOf}.`;\n        if (shouldApplyDuplicateFallback(document.metadata.resolution)) {\n          document.metadata.resolution = duplicateResolution;\n          duplicateFallbackFields.push(\"resolution\");\n        }\n        if (shouldApplyDuplicateFallback(document.metadata.expected_result)) {\n          document.metadata.expected_result = duplicateExpectedResult;\n          duplicateFallbackFields.push(\"expected_result\");\n        }\n        if (shouldApplyDuplicateFallback(document.metadata.actual_result)) {\n          document.metadata.actual_result = duplicateActualResult;\n          duplicateFallbackFields.push(\"actual_result\");\n        }\n      }\n      if (validateCloseMode !== \"off\") {\n        const missingFields = findMissingCloseValidationFields(document.metadata);\n        if (missingFields.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: missing ${missingFields.join(\", \")}. Populate fields or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_missing_fields:${document.metadata.id}:${missingFields.join(\",\")}`);\n        }\n        if (activeChildIds.length > 0) {\n          if (validateCloseMode === \"strict\") {\n            throw new PmCliError(\n              `Cannot close item ${document.metadata.id}: active child items remain open (${activeChildIds.join(\", \")}). Close, cancel, or re-parent them first, or use --validate-close warn.`,\n              EXIT_CODE.USAGE,\n            );\n          }\n          mutationWarnings.push(`close_validation_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n        }\n      } else if (activeChildIds.length > 0) {\n        // C3: minimal governance (validate-close off) should still tell the\n        // agent it just closed a parent with open children, without blocking.\n        mutationWarnings.push(`closed_with_active_children:${document.metadata.id}:${activeChildIds.join(\",\")}`);\n      }\n\n      document.metadata.status = statusRegistry.close_status;\n      const changedFields = [\"status\"];\n      if (closeReason !== undefined) {\n        document.metadata.close_reason = closeReason;\n        changedFields.push(\"close_reason\");\n      } else if (document.metadata.close_reason !== undefined) {\n        delete document.metadata.close_reason;\n        changedFields.push(\"close_reason\");\n      }\n      for (const { option, key } of inlineCloseFields) {\n        if (typeof option === \"string\" && option.trim().length > 0) {\n          changedFields.push(key);\n        }\n      }\n      if (duplicateOf !== undefined) {\n        changedFields.push(\"duplicate_of\");\n        if (duplicateFallbackFields.includes(\"resolution\") && !changedFields.includes(\"resolution\")) {\n          changedFields.push(\"resolution\");\n        }\n        if (duplicateFallbackFields.includes(\"expected_result\") && !changedFields.includes(\"expected_result\")) {\n          changedFields.push(\"expected_result\");\n        }\n        if (duplicateFallbackFields.includes(\"actual_result\") && !changedFields.includes(\"actual_result\")) {\n          changedFields.push(\"actual_result\");\n        }\n      }\n      if (document.metadata.assignee !== undefined) {\n        delete document.metadata.assignee;\n        changedFields.push(\"assignee\");\n      }\n\n      // C4 (pm-fu5d): a terminal item is no longer blocked. Clear every active\n      // blocker signal independently — scalar blocked_by, blocked_reason, and the\n      // blocked_by dependency edges (kept consistent with the kyd6 invariant) —\n      // even if only some are present (e.g. an orphaned edge or a stale\n      // blocked_reason left by manual edits), so closed work stops surfacing in\n      // blockers views, and annotate the cleanup.\n      const previousBlockedBy =\n        typeof document.metadata.blocked_by === \"string\" ? document.metadata.blocked_by.trim() : \"\";\n      const existingDeps = document.metadata.dependencies ?? [];\n      const blockedByEdge = existingDeps.find((dep) => dep.kind === \"blocked_by\");\n      const hadBlockedReason = document.metadata.blocked_reason !== undefined;\n      if (previousBlockedBy.length > 0 || blockedByEdge !== undefined || hadBlockedReason) {\n        if (previousBlockedBy.length > 0) {\n          delete document.metadata.blocked_by;\n          changedFields.push(\"blocked_by\");\n        }\n        if (hadBlockedReason) {\n          delete document.metadata.blocked_reason;\n          changedFields.push(\"blocked_reason\");\n        }\n        if (blockedByEdge !== undefined) {\n          const remainingDeps = existingDeps.filter((dep) => dep.kind !== \"blocked_by\");\n          if (remainingDeps.length > 0) {\n            document.metadata.dependencies = remainingDeps;\n          } else {\n            delete document.metadata.dependencies;\n          }\n          changedFields.push(\"dependencies\");\n        }\n        const reportedBlocker = previousBlockedBy || blockedByEdge?.id || \"unknown\";\n        mutationWarnings.push(`closed_cleared_blocked_by:${document.metadata.id}:${reportedBlocker}`);\n      }\n\n      return {\n        changedFields,\n        ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n      };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    changed_fields: result.changedFields,\n    warnings: result.warnings,\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,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;;MAEF,WAAW;QACT;QACA;;KAEH;EAEL;AACA,SAAO;AACT;AAIA,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,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;AAC/D,QAAM,cAAc,qBAAqB,iBAAiB,SAAS,WAAW,oBAAoB;AAClG,QAAM,cAAc,MAAM,4BAA4B,QAAQ,UAAU,QAAQ,aAAa,EAAE;AAC/F,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,UAAI,iBAAiB,SAAS,SAAS,QAAQ,cAAc,KAAK,CAAC,QAAQ,OAAO;AAChF,cAAM,IAAI,WAAW,QAAQ,SAAS,SAAS,EAAE,qDAAqD,UAAU,QAAQ;MAC1H;AACA,YAAM,mBAA6B,CAAA;AAKnC,YAAM,oBAAoH;QACxH,EAAE,QAAQ,QAAQ,YAAY,KAAK,aAAY;QAC/C,EAAE,QAAQ,QAAQ,gBAAgB,KAAK,kBAAiB;QACxD,EAAE,QAAQ,QAAQ,cAAc,KAAK,gBAAe;;AAEtD,YAAM,0BAAqF,CAAA;AAC3F,iBAAW,EAAE,QAAQ,IAAG,KAAM,mBAAmB;AAC/C,YAAI,OAAO,WAAW;AAAU;AAChC,cAAM,UAAU,OAAO,KAAI;AAC3B,YAAI,QAAQ,WAAW;AAAG;AAC1B,iBAAS,SAAS,GAAG,IAAI;MAC3B;AACA,UAAI,gBAAgB,QAAW;AAC7B,iBAAS,SAAS,eAAe;AACjC,cAAM,sBAAsB,gBAAgB,WAAW;AACvD,cAAM,0BAA0B,kBAAkB,WAAW;AAC7D,cAAM,wBAAwB,0BAA0B,WAAW;AACnE,YAAI,6BAA6B,SAAS,SAAS,UAAU,GAAG;AAC9D,mBAAS,SAAS,aAAa;AAC/B,kCAAwB,KAAK,YAAY;QAC3C;AACA,YAAI,6BAA6B,SAAS,SAAS,eAAe,GAAG;AACnE,mBAAS,SAAS,kBAAkB;AACpC,kCAAwB,KAAK,iBAAiB;QAChD;AACA,YAAI,6BAA6B,SAAS,SAAS,aAAa,GAAG;AACjE,mBAAS,SAAS,gBAAgB;AAClC,kCAAwB,KAAK,eAAe;QAC9C;MACF;AACA,UAAI,sBAAsB,OAAO;AAC/B,cAAM,gBAAgB,iCAAiC,SAAS,QAAQ;AACxE,YAAI,cAAc,SAAS,GAAG;AAC5B,cAAI,sBAAsB,UAAU;AAClC,kBAAM,IAAI,WACR,qBAAqB,SAAS,SAAS,EAAE,aAAa,cAAc,KAAK,IAAI,CAAC,mDAC9E,UAAU,KAAK;UAEnB;AACA,2BAAiB,KAAK,mCAAmC,SAAS,SAAS,EAAE,IAAI,cAAc,KAAK,GAAG,CAAC,EAAE;QAC5G;AACA,YAAI,eAAe,SAAS,GAAG;AAC7B,cAAI,sBAAsB,UAAU;AAClC,kBAAM,IAAI,WACR,qBAAqB,SAAS,SAAS,EAAE,qCAAqC,eAAe,KAAK,IAAI,CAAC,4EACvG,UAAU,KAAK;UAEnB;AACA,2BAAiB,KAAK,oCAAoC,SAAS,SAAS,EAAE,IAAI,eAAe,KAAK,GAAG,CAAC,EAAE;QAC9G;MACF,WAAW,eAAe,SAAS,GAAG;AAGpC,yBAAiB,KAAK,+BAA+B,SAAS,SAAS,EAAE,IAAI,eAAe,KAAK,GAAG,CAAC,EAAE;MACzG;AAEA,eAAS,SAAS,SAAS,eAAe;AAC1C,YAAM,gBAAgB,CAAC,QAAQ;AAC/B,UAAI,gBAAgB,QAAW;AAC7B,iBAAS,SAAS,eAAe;AACjC,sBAAc,KAAK,cAAc;MACnC,WAAW,SAAS,SAAS,iBAAiB,QAAW;AACvD,eAAO,SAAS,SAAS;AACzB,sBAAc,KAAK,cAAc;MACnC;AACA,iBAAW,EAAE,QAAQ,IAAG,KAAM,mBAAmB;AAC/C,YAAI,OAAO,WAAW,YAAY,OAAO,KAAI,EAAG,SAAS,GAAG;AAC1D,wBAAc,KAAK,GAAG;QACxB;MACF;AACA,UAAI,gBAAgB,QAAW;AAC7B,sBAAc,KAAK,cAAc;AACjC,YAAI,wBAAwB,SAAS,YAAY,KAAK,CAAC,cAAc,SAAS,YAAY,GAAG;AAC3F,wBAAc,KAAK,YAAY;QACjC;AACA,YAAI,wBAAwB,SAAS,iBAAiB,KAAK,CAAC,cAAc,SAAS,iBAAiB,GAAG;AACrG,wBAAc,KAAK,iBAAiB;QACtC;AACA,YAAI,wBAAwB,SAAS,eAAe,KAAK,CAAC,cAAc,SAAS,eAAe,GAAG;AACjG,wBAAc,KAAK,eAAe;QACpC;MACF;AACA,UAAI,SAAS,SAAS,aAAa,QAAW;AAC5C,eAAO,SAAS,SAAS;AACzB,sBAAc,KAAK,UAAU;MAC/B;AAQA,YAAM,oBACJ,OAAO,SAAS,SAAS,eAAe,WAAW,SAAS,SAAS,WAAW,KAAI,IAAK;AAC3F,YAAM,eAAe,SAAS,SAAS,gBAAgB,CAAA;AACvD,YAAM,gBAAgB,aAAa,KAAK,CAAC,QAAQ,IAAI,SAAS,YAAY;AAC1E,YAAM,mBAAmB,SAAS,SAAS,mBAAmB;AAC9D,UAAI,kBAAkB,SAAS,KAAK,kBAAkB,UAAa,kBAAkB;AACnF,YAAI,kBAAkB,SAAS,GAAG;AAChC,iBAAO,SAAS,SAAS;AACzB,wBAAc,KAAK,YAAY;QACjC;AACA,YAAI,kBAAkB;AACpB,iBAAO,SAAS,SAAS;AACzB,wBAAc,KAAK,gBAAgB;QACrC;AACA,YAAI,kBAAkB,QAAW;AAC/B,gBAAM,gBAAgB,aAAa,OAAO,CAAC,QAAQ,IAAI,SAAS,YAAY;AAC5E,cAAI,cAAc,SAAS,GAAG;AAC5B,qBAAS,SAAS,eAAe;UACnC,OAAO;AACL,mBAAO,SAAS,SAAS;UAC3B;AACA,wBAAc,KAAK,cAAc;QACnC;AACA,cAAM,kBAAkB,qBAAqB,eAAe,MAAM;AAClE,yBAAiB,KAAK,6BAA6B,SAAS,SAAS,EAAE,IAAI,eAAe,EAAE;MAC9F;AAEA,aAAO;QACL;QACA,GAAI,iBAAiB,SAAS,IAAI,EAAE,UAAU,iBAAgB,IAAK,CAAA;;IAEvE;GACD;AAED,SAAO;IACL,MAAM,aAAa,OAAO,IAAI;IAC9B,gBAAgB,OAAO;IACvB,UAAU,OAAO;;AAErB;",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{chunk-WCWIDJII.js → chunk-VPEAS7PS.js}

@@ -1,7 +1,7 @@
 import {
   TYPE_TO_FOLDER,
   pathExists
-} from "./chunk-C72IQIBT.js";
+} from "./chunk-FY4SPXSC.js";
 
 // dist/core/item/id.js
 import crypto from "node:crypto";
@@ -75,4 +75,4 @@ export {
   normalizeItemId,
   generateItemId
 };
-//# sourceMappingURL=chunk-WCWIDJII.js.map
+//# sourceMappingURL=chunk-VPEAS7PS.js.map

package/dist/cli-bundle/chunks/{chunk-RE2JQJZJ.js → chunk-VSRZRLG3.js}

@@ -1,7 +1,7 @@
 import {
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-NHRZSYAA.js";
+} from "./chunk-73ZPG2I3.js";
 import {
   TYPE_TO_FOLDER,
   getItemFormatFromPath,
@@ -10,7 +10,7 @@ import {
   removeFileIfExists,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-C72IQIBT.js";
+} from "./chunk-FY4SPXSC.js";
 
 // dist/core/store/item-format-migration.js
 import fs from "node:fs/promises";
@@ -119,4 +119,4 @@ async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:
 export {
   migrateItemFilesToFormat
 };
-//# sourceMappingURL=chunk-RE2JQJZJ.js.map
+//# sourceMappingURL=chunk-VSRZRLG3.js.map

package/dist/cli-bundle/chunks/{chunk-PW7C262O.js → chunk-WUNFKP7M.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-5JF76OJF.js";
+} from "./chunk-A6LXQFO7.js";
 
 // dist/core/shared/time.js
 var RELATIVE_DEADLINE = /^([+-]?)(\d+)([hdwm])$/i;
@@ -199,6 +199,6 @@ export {
   compareTimestampStrings,
   resolveIsoOrRelative
 };
-//# sourceMappingURL=chunk-PW7C262O.js.map
+//# sourceMappingURL=chunk-WUNFKP7M.js.map
 
 //# debugId=849dc628-ad6f-57cc-974c-36ea67ca2d07

package/dist/cli-bundle/chunks/{chunk-BACSNVWE.js → chunk-XJDGS74Y.js}

@@ -1,15 +1,15 @@
 
-!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]="751da009-c89c-5d1c-b5cc-ae7e1dbf5866")}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]="e3de33e9-9ffc-5384-b87e-e2dc2457b37e")}catch(e){}}();
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-AVGOVJGV.js";
+} from "./chunk-HI7STVF2.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-42IULX44.js";
+} from "./chunk-CCX4RSYZ.js";
 import {
   nowIso
-} from "./chunk-PW7C262O.js";
+} from "./chunk-WUNFKP7M.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -24,7 +24,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-5JF76OJF.js";
+} from "./chunk-A6LXQFO7.js";
 
 // dist/core/search/http-client.js
 var DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 3e4;
@@ -1101,6 +1101,68 @@ async function executeVectorDelete(store, ids, options = {}) {
   return normalizeQdrantUpsertResponse(payload);
 }
 
+// dist/core/search/vectorization-metadata.js
+function buildVectorizationEmbeddingIdentity(provider, model) {
+  const normalizedProvider = toNonEmptyString(provider);
+  const normalizedModel = toNonEmptyString(model);
+  if (!normalizedProvider || !normalizedModel) {
+    return null;
+  }
+  return {
+    provider: normalizedProvider,
+    model: normalizedModel
+  };
+}
+function normalizeVectorizationEmbeddingMetadata(value) {
+  if (value === void 0 || value === null) {
+    return null;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Vectorization embedding metadata must be an object when set");
+  }
+  const identity = buildVectorizationEmbeddingIdentity(value.provider, value.model);
+  const vectorDimension = value.vector_dimension;
+  if (!identity || typeof vectorDimension !== "number" || !Number.isInteger(vectorDimension) || vectorDimension <= 0) {
+    throw new Error("Vectorization embedding metadata must include provider, model, and positive vector_dimension");
+  }
+  return {
+    ...identity,
+    vector_dimension: vectorDimension
+  };
+}
+function buildVectorizationEmbeddingMetadata(identity, vectorDimension) {
+  if (!Number.isInteger(vectorDimension) || vectorDimension <= 0) {
+    throw new Error("Vectorization embedding metadata requires a positive vector dimension");
+  }
+  return {
+    provider: identity.provider,
+    model: identity.model,
+    vector_dimension: vectorDimension
+  };
+}
+function hasVectorizationEmbeddingIdentityChanged(metadata, identity) {
+  return !metadata || metadata.provider !== identity.provider || metadata.model !== identity.model;
+}
+function hasVectorizationVectorDimensionChanged(metadata, vectorDimension) {
+  return Boolean(metadata && metadata.vector_dimension !== vectorDimension);
+}
+function inferConsistentVectorDimension(vectors, context) {
+  if (vectors.length === 0) {
+    throw new Error(`${context} returned no vectors`);
+  }
+  const firstVector = vectors[0];
+  const dimension = firstVector.length;
+  if (!Number.isInteger(dimension) || dimension <= 0) {
+    throw new Error(`${context} returned an empty vector`);
+  }
+  for (let index = 1; index < vectors.length; index += 1) {
+    if (vectors[index]?.length !== dimension) {
+      throw new Error(`${context} returned mixed vector dimensions`);
+    }
+  }
+  return dimension;
+}
+
 // dist/core/search/cache.js
 import path2 from "node:path";
 
@@ -1384,68 +1446,6 @@ async function scheduleBackgroundSemanticRefresh(pmRoot, itemIds) {
   dispatchRefreshChild(pmRoot);
 }
 
-// dist/core/search/vectorization-metadata.js
-function buildVectorizationEmbeddingIdentity(provider, model) {
-  const normalizedProvider = toNonEmptyString(provider);
-  const normalizedModel = toNonEmptyString(model);
-  if (!normalizedProvider || !normalizedModel) {
-    return null;
-  }
-  return {
-    provider: normalizedProvider,
-    model: normalizedModel
-  };
-}
-function normalizeVectorizationEmbeddingMetadata(value) {
-  if (value === void 0 || value === null) {
-    return null;
-  }
-  if (typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("Vectorization embedding metadata must be an object when set");
-  }
-  const identity = buildVectorizationEmbeddingIdentity(value.provider, value.model);
-  const vectorDimension = value.vector_dimension;
-  if (!identity || typeof vectorDimension !== "number" || !Number.isInteger(vectorDimension) || vectorDimension <= 0) {
-    throw new Error("Vectorization embedding metadata must include provider, model, and positive vector_dimension");
-  }
-  return {
-    ...identity,
-    vector_dimension: vectorDimension
-  };
-}
-function buildVectorizationEmbeddingMetadata(identity, vectorDimension) {
-  if (!Number.isInteger(vectorDimension) || vectorDimension <= 0) {
-    throw new Error("Vectorization embedding metadata requires a positive vector dimension");
-  }
-  return {
-    provider: identity.provider,
-    model: identity.model,
-    vector_dimension: vectorDimension
-  };
-}
-function hasVectorizationEmbeddingIdentityChanged(metadata, identity) {
-  return !metadata || metadata.provider !== identity.provider || metadata.model !== identity.model;
-}
-function hasVectorizationVectorDimensionChanged(metadata, vectorDimension) {
-  return Boolean(metadata && metadata.vector_dimension !== vectorDimension);
-}
-function inferConsistentVectorDimension(vectors, context) {
-  if (vectors.length === 0) {
-    throw new Error(`${context} returned no vectors`);
-  }
-  const firstVector = vectors[0];
-  const dimension = firstVector.length;
-  if (!Number.isInteger(dimension) || dimension <= 0) {
-    throw new Error(`${context} returned an empty vector`);
-  }
-  for (let index = 1; index < vectors.length; index += 1) {
-    if (vectors[index]?.length !== dimension) {
-      throw new Error(`${context} returned mixed vector dimensions`);
-    }
-  }
-  return dimension;
-}
-
 // dist/core/search/cache.js
 var SEARCH_CACHE_ARTIFACT_PATHS = ["index/manifest.json", "search/embeddings.jsonl"];
 var VECTORIZATION_STATUS_LEDGER_PATH = "search/vectorization-status.json";
@@ -1847,10 +1847,12 @@ export {
   shouldRunSearchRefreshInForeground,
   resolveVectorStores,
   executeVectorQuery,
+  buildVectorizationEmbeddingIdentity,
+  hasVectorizationEmbeddingIdentityChanged,
   readVectorizationStatusLedger,
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-BACSNVWE.js.map
+//# sourceMappingURL=chunk-XJDGS74Y.js.map
 
-//# debugId=751da009-c89c-5d1c-b5cc-ae7e1dbf5866
+//# debugId=e3de33e9-9ffc-5384-b87e-e2dc2457b37e