@unbrained/pm-cli 2026.6.7 → 2026.6.9

package/dist/cli-bundle/chunks/{chunk-THDEID2Z.js → chunk-I3UILOUU.js}

@@ -3,7 +3,7 @@ import {
   PmCliError,
   isPathWithinDirectory,
   pathExists
-} from "./chunk-UJUT6AHZ.js";
+} from "./chunk-C72IQIBT.js";
 
 // dist/cli/commands/extension/shared.js
 import fs from "node:fs/promises";
@@ -112,4 +112,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-THDEID2Z.js.map
+//# sourceMappingURL=chunk-I3UILOUU.js.map

package/dist/cli-bundle/chunks/{chunk-YPH4ESA2.js → chunk-I4FGL3K2.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]="a6f5399f-ddc1-5e27-8343-9912514306ee")}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]="a07f6898-1c0c-5eb9-98f9-4f8aef2001f5")}catch(e){}}();
 import {
   verifyHistoryChain
-} from "./chunk-3A2CMEM7.js";
+} from "./chunk-NJRZIJ4N.js";
 import {
   hashDocument
-} from "./chunk-YBZW2QQ7.js";
+} from "./chunk-AVGOVJGV.js";
 import {
   getHistoryPath,
   writeFileAtomic
-} from "./chunk-X4IZKYHP.js";
+} from "./chunk-5JF76OJF.js";
 
 // dist/core/history/drift-scan.js
 import fs from "fs/promises";
@@ -240,6 +240,11 @@ var REMEDIATION_REGISTRY = Object.freeze([
     command: "pm health --check-telemetry",
     summary: "The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."
   },
+  {
+    code: "telemetry_schema_version_behind",
+    command: "pm health --check-telemetry",
+    summary: "Client schema is behind server; upgrade pm-cli to emit the latest event shape."
+  },
   // --- pm health: integrity ---
   {
     code: "integrity_item_unreadable",
@@ -456,6 +461,6 @@ export {
   buildRemediationMap,
   buildRemediationCommands
 };
-//# sourceMappingURL=chunk-YPH4ESA2.js.map
+//# sourceMappingURL=chunk-I4FGL3K2.js.map
 
-//# debugId=a6f5399f-ddc1-5e27-8343-9912514306ee
+//# debugId=a07f6898-1c0c-5eb9-98f9-4f8aef2001f5

package/dist/cli-bundle/chunks/chunk-I4FGL3K2.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_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  // --- 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":"a07f6898-1c0c-5eb9-98f9-4f8aef2001f5"}

package/dist/cli-bundle/chunks/{chunk-HMMMWBK2.js → chunk-JEGFLKSI.js}

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

package/dist/cli-bundle/chunks/{chunk-OKSKJKHX.js → chunk-JN3BT7UY.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-O7IWB35H.js";
 import {
   readHistoryEntries
-} from "./chunk-4CHEG6UK.js";
+} from "./chunk-EQ6N6IDR.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
   toReplayDocument
-} from "./chunk-3EOBJOF4.js";
+} from "./chunk-H37YPWLM.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -17,21 +17,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-TP4DDY27.js";
+} from "./chunk-LF2VNLEZ.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-2IXCHCLM.js";
+} from "./chunk-WCWIDJII.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-WCQZBDDH.js";
+} from "./chunk-NHRZSYAA.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-HRMHZ4RV.js";
+} from "./chunk-U3Z4OCZC.js";
 import {
   nowIso
-} from "./chunk-FHHBD7PN.js";
+} from "./chunk-SAUXUI6U.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -47,7 +47,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-UJUT6AHZ.js";
+} from "./chunk-C72IQIBT.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -380,4 +380,4 @@ async function runRestore(id, target, options, global2) {
 export {
   runRestore
 };
-//# sourceMappingURL=chunk-OKSKJKHX.js.map
+//# sourceMappingURL=chunk-JN3BT7UY.js.map

package/dist/cli-bundle/chunks/{chunk-XS3O2TFJ.js → chunk-JVMAOD54.js}

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1c087bbd-09b2-5bf1-92e3-1e243f0854ae")}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]="61aa7e55-919b-5f8e-8f56-c90b9e815366")}catch(e){}}();
 import {
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,
@@ -12,15 +12,15 @@ import {
   readFirstStringFromCommanderOptions,
   readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-CLD3XNCH.js";
+} from "./chunk-GPOSGWCN.js";
 import {
   refreshSearchArtifactsForMutation,
   shouldRunSearchRefreshInForeground
-} from "./chunk-4GHZR3BA.js";
+} from "./chunk-BACSNVWE.js";
 import {
   printError,
   writeStdout
-} from "./chunk-LIN2BPJ7.js";
+} from "./chunk-ANKG2JKL.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -29,7 +29,7 @@ import {
   readSettings,
   resolvePmRoot,
   setActiveCommandResult
-} from "./chunk-X4IZKYHP.js";
+} from "./chunk-5JF76OJF.js";
 
 // dist/cli/registration-helpers.js
 var RESOLVED_GLOBAL_OPTIONS = /* @__PURE__ */ Symbol("pm.resolvedGlobalOptions");
@@ -53,7 +53,7 @@ function getGlobalOptions(command) {
     json: opts.json === true ? true : void 0,
     quiet: Boolean(opts.quiet),
     noChangedFields: opts.changedFields === false,
-    path: typeof opts.path === "string" ? opts.path : void 0,
+    path: typeof opts.pmPath === "string" ? opts.pmPath : typeof opts.path === "string" ? opts.path : void 0,
     noExtensions: opts.extensions === false,
     noPager: Boolean(opts.noPager),
     profile: Boolean(opts.profile)
@@ -712,6 +712,6 @@ export {
   normalizeContextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-XS3O2TFJ.js.map
+//# sourceMappingURL=chunk-JVMAOD54.js.map
 
-//# debugId=1c087bbd-09b2-5bf1-92e3-1e243f0854ae
+//# debugId=61aa7e55-919b-5f8e-8f56-c90b9e815366

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/registration-helpers.ts"],"sourcesContent":["import type { Command } from \"commander\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport { normalizeStatusInput } from \"../core/item/status.js\";\nimport { refreshSearchArtifactsForMutation } from \"../core/search/cache.js\";\nimport { shouldRunSearchRefreshInForeground } from \"../core/search/background-refresh.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { printError, printResult, writeStdout } from \"../core/output/output.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport {\n  setActiveCommandResult,\n} from \"../core/extensions/index.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport type { ItemStatus } from \"../types/index.js\";\nimport {\n  ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,\n  CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  CREATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  LIST_COMMANDER_STRING_OPTION_CONTRACTS,\n  SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  readFirstValueFromCommanderOptions,\n  readFirstStringFromCommanderOptions,\n  readStringArrayFromCommanderOptions,\n} from \"../sdk/cli-contracts.js\";\nimport type {\n  ContextOptions,\n  CreateCommandOptions,\n  AggregateOptions,\n  ListOptions,\n} from \"./commands/index.js\";\nimport type { runList, runActivity } from \"./commands/index.js\";\n\nexport {\n  printError,\n  printResult,\n  writeStdout,\n};\n\nconst RESOLVED_GLOBAL_OPTIONS = Symbol(\"pm.resolvedGlobalOptions\");\n\ntype CommandWithResolvedGlobals = Command & {\n  [RESOLVED_GLOBAL_OPTIONS]?: GlobalOptions;\n};\n\ninterface CommandOptionsReader {\n  optsWithGlobals?: () => Record<string, unknown>;\n  opts?: () => Record<string, unknown>;\n}\n\nfunction commandOptionsReader(command: unknown): CommandOptionsReader {\n  return typeof command === \"object\" && command !== null ? command as CommandOptionsReader : {};\n}\n\nexport function setResolvedGlobalOptions(command: Command, globalOptions: GlobalOptions): void {\n  (command as CommandWithResolvedGlobals)[RESOLVED_GLOBAL_OPTIONS] = { ...globalOptions };\n}\n\nexport function clearResolvedGlobalOptions(command: Command): void {\n  delete (command as CommandWithResolvedGlobals)[RESOLVED_GLOBAL_OPTIONS];\n}\n\nexport function getGlobalOptions(command: Command): GlobalOptions {\n  const resolved = (command as CommandWithResolvedGlobals)[RESOLVED_GLOBAL_OPTIONS];\n  if (resolved) {\n    return { ...resolved };\n  }\n  const reader = commandOptionsReader(command);\n  const opts = typeof reader.optsWithGlobals === \"function\"\n    ? reader.optsWithGlobals()\n    : typeof reader.opts === \"function\"\n      ? reader.opts()\n      : {};\n  return {\n    json: opts.json === true ? true : undefined,\n    quiet: Boolean(opts.quiet),\n    noChangedFields: opts.changedFields === false,\n    path: typeof opts.pmPath === \"string\"\n      ? opts.pmPath\n      : typeof opts.path === \"string\"\n        ? opts.path\n        : undefined,\n    noExtensions: opts.extensions === false,\n    noPager: Boolean(opts.noPager),\n    profile: Boolean(opts.profile),\n  };\n}\n\nexport function getCommandPath(command: Command): string {\n  const parts: string[] = [];\n  let current: Command | null = command;\n  while (current?.parent) {\n    parts.unshift(current.name());\n    current = current.parent;\n  }\n  return parts.join(\" \");\n}\n\nexport async function applyDefaultOutputFormat(globalOptions: GlobalOptions): Promise<GlobalOptions> {\n  if (globalOptions.json === true) {\n    return globalOptions;\n  }\n  const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    return globalOptions;\n  }\n  const settings = await readSettings(pmRoot);\n  return {\n    ...globalOptions,\n    defaultOutputFormat: settings.output.default_format,\n  };\n}\n\nexport function collect(value: string, previous: string[] | undefined): string[] {\n  const next = previous ?? [];\n  next.push(value);\n  return next;\n}\n\nfunction pushOptionalValueFlag(args: string[], flag: string, value: unknown): void {\n  if (typeof value !== \"string\") {\n    return;\n  }\n  const trimmed = value.trim();\n  if (trimmed.length === 0) {\n    return;\n  }\n  args.push(flag, trimmed);\n}\n\nfunction pushOptionalBooleanFlag(args: string[], flag: string, value: unknown): void {\n  if (value === true) {\n    args.push(flag);\n  }\n}\n\nfunction pushRepeatableValueFlag(args: string[], flag: string, values: unknown): void {\n  if (!Array.isArray(values)) {\n    return;\n  }\n  for (const value of values) {\n    if (typeof value !== \"string\") {\n      continue;\n    }\n    const trimmed = value.trim();\n    if (trimmed.length === 0) {\n      continue;\n    }\n    args.push(flag, trimmed);\n  }\n}\n\nexport function buildBackgroundTestCommandArgs(id: string, options: Record<string, unknown>): string[] {\n  const args: string[] = [\"test\", id, \"--run\", \"--json\", \"--progress\"];\n  pushRepeatableValueFlag(args, \"--add\", options.add);\n  pushRepeatableValueFlag(args, \"--remove\", options.remove);\n  pushOptionalValueFlag(args, \"--timeout\", options.timeout);\n  pushRepeatableValueFlag(args, \"--env-set\", options.envSet);\n  pushRepeatableValueFlag(args, \"--env-clear\", options.envClear);\n  pushOptionalBooleanFlag(args, \"--shared-host-safe\", options.sharedHostSafe);\n  pushOptionalValueFlag(args, \"--pm-context\", options.pmContext);\n  pushOptionalBooleanFlag(args, \"--override-linked-pm-context\", options.overrideLinkedPmContext);\n  pushOptionalBooleanFlag(args, \"--fail-on-context-mismatch\", options.failOnContextMismatch);\n  pushOptionalBooleanFlag(args, \"--fail-on-skipped\", options.failOnSkipped);\n  pushOptionalBooleanFlag(args, \"--fail-on-empty-test-run\", options.failOnEmptyTestRun);\n  pushOptionalBooleanFlag(args, \"--require-assertions-for-pm\", options.requireAssertionsForPm);\n  pushOptionalBooleanFlag(args, \"--check-context\", options.checkContext);\n  pushOptionalBooleanFlag(args, \"--auto-pm-context\", options.autoPmContext);\n  pushOptionalValueFlag(args, \"--author\", options.author);\n  pushOptionalValueFlag(args, \"--message\", options.message);\n  pushOptionalBooleanFlag(args, \"--force\", options.force);\n  return args;\n}\n\nexport function buildBackgroundTestAllCommandArgs(options: Record<string, unknown>): string[] {\n  const args: string[] = [\"test-all\", \"--json\", \"--progress\"];\n  pushOptionalValueFlag(args, \"--status\", options.status);\n  pushOptionalValueFlag(args, \"--limit\", options.limit);\n  pushOptionalValueFlag(args, \"--offset\", options.offset);\n  pushOptionalValueFlag(args, \"--timeout\", options.timeout);\n  pushRepeatableValueFlag(args, \"--env-set\", options.envSet);\n  pushRepeatableValueFlag(args, \"--env-clear\", options.envClear);\n  pushOptionalBooleanFlag(args, \"--shared-host-safe\", options.sharedHostSafe);\n  pushOptionalValueFlag(args, \"--pm-context\", options.pmContext);\n  pushOptionalBooleanFlag(args, \"--override-linked-pm-context\", options.overrideLinkedPmContext);\n  pushOptionalBooleanFlag(args, \"--fail-on-context-mismatch\", options.failOnContextMismatch);\n  pushOptionalBooleanFlag(args, \"--fail-on-skipped\", options.failOnSkipped);\n  pushOptionalBooleanFlag(args, \"--fail-on-empty-test-run\", options.failOnEmptyTestRun);\n  pushOptionalBooleanFlag(args, \"--require-assertions-for-pm\", options.requireAssertionsForPm);\n  pushOptionalBooleanFlag(args, \"--check-context\", options.checkContext);\n  pushOptionalBooleanFlag(args, \"--auto-pm-context\", options.autoPmContext);\n  return args;\n}\n\nexport function formatHookWarnings(warnings: string[]): string {\n  return warnings.join(\",\");\n}\n\nexport function normalizeCreateOptions(\n  commandOptions: Record<string, unknown>,\n  options: { requireType?: boolean } = {},\n): CreateCommandOptions {\n  const readCreateString = (target: string): string | undefined =>\n    readFirstStringFromCommanderOptions(\n      commandOptions,\n      CREATE_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n  const readCreateList = (target: string): string[] | undefined =>\n    readStringArrayFromCommanderOptions(\n      commandOptions,\n      CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n\n  const type = readCreateString(\"type\");\n  if (options.requireType !== false && type === undefined) {\n    throw new PmCliError(\n      \"Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).\",\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const normalized: Record<string, unknown> = {\n    title: readCreateString(\"title\"),\n    description: readCreateString(\"description\"),\n    type,\n    template: readCreateString(\"template\"),\n    createMode: readCreateString(\"createMode\"),\n    schedulePreset: readCreateString(\"schedulePreset\"),\n    status: readCreateString(\"status\"),\n    priority: readCreateString(\"priority\"),\n    tags: readCreateString(\"tags\"),\n    addTags: readCreateList(\"addTags\"),\n    body: readCreateString(\"body\"),\n    deadline: readCreateString(\"deadline\"),\n    estimatedMinutes: readCreateString(\"estimatedMinutes\"),\n    acceptanceCriteria: readCreateString(\"acceptanceCriteria\"),\n    definitionOfReady: readCreateString(\"definitionOfReady\"),\n    order: readCreateString(\"order\"),\n    rank: readCreateString(\"rank\"),\n    goal: readCreateString(\"goal\"),\n    objective: readCreateString(\"objective\"),\n    value: readCreateString(\"value\"),\n    impact: readCreateString(\"impact\"),\n    outcome: readCreateString(\"outcome\"),\n    whyNow: readCreateString(\"whyNow\"),\n    author: readCreateString(\"author\"),\n    message: readCreateString(\"message\"),\n    assignee: readCreateString(\"assignee\"),\n    parent: readCreateString(\"parent\"),\n    reviewer: readCreateString(\"reviewer\"),\n    risk: readCreateString(\"risk\"),\n    confidence: readCreateString(\"confidence\"),\n    sprint: readCreateString(\"sprint\"),\n    release: readCreateString(\"release\"),\n    blockedBy: readCreateString(\"blockedBy\"),\n    blockedReason: readCreateString(\"blockedReason\"),\n    unblockNote: readCreateString(\"unblockNote\"),\n    reporter: readCreateString(\"reporter\"),\n    severity: readCreateString(\"severity\"),\n    environment: readCreateString(\"environment\"),\n    reproSteps: readCreateString(\"reproSteps\"),\n    resolution: readCreateString(\"resolution\"),\n    expectedResult: readCreateString(\"expectedResult\"),\n    actualResult: readCreateString(\"actualResult\"),\n    affectedVersion: readCreateString(\"affectedVersion\"),\n    fixedVersion: readCreateString(\"fixedVersion\"),\n    component: readCreateString(\"component\"),\n    regression: readCreateString(\"regression\"),\n    customerImpact: readCreateString(\"customerImpact\"),\n    dep: readCreateList(\"dep\"),\n    comment: readCreateList(\"comment\"),\n    note: readCreateList(\"note\"),\n    learning: readCreateList(\"learning\"),\n    file: readCreateList(\"file\"),\n    test: readCreateList(\"test\"),\n    doc: readCreateList(\"doc\"),\n    reminder: readCreateList(\"reminder\"),\n    event: readCreateList(\"event\"),\n    typeOption: readCreateList(\"typeOption\"),\n    field: readCreateList(\"field\"),\n    unset: readCreateList(\"unset\"),\n    clearDeps: commandOptions.clearDeps === true ? true : undefined,\n    clearComments: commandOptions.clearComments === true ? true : undefined,\n    clearNotes: commandOptions.clearNotes === true ? true : undefined,\n    clearLearnings: commandOptions.clearLearnings === true ? true : undefined,\n    clearFiles: commandOptions.clearFiles === true ? true : undefined,\n    clearTests: commandOptions.clearTests === true ? true : undefined,\n    clearDocs: commandOptions.clearDocs === true ? true : undefined,\n    clearReminders: commandOptions.clearReminders === true ? true : undefined,\n    clearEvents: commandOptions.clearEvents === true ? true : undefined,\n    clearTypeOptions: commandOptions.clearTypeOptions === true ? true : undefined,\n  };\n  for (const [key, value] of Object.entries(commandOptions)) {\n    if (Object.hasOwn(normalized, key)) {\n      continue;\n    }\n    normalized[key] = value;\n  }\n  return normalized as CreateCommandOptions;\n}\n\nexport function normalizeUpdateOptions(commandOptions: Record<string, unknown>): Record<string, unknown> {\n  const readUpdateString = (target: string): string | undefined =>\n    readFirstStringFromCommanderOptions(\n      commandOptions,\n      UPDATE_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n  const readUpdateList = (target: string): string[] | undefined =>\n    readStringArrayFromCommanderOptions(\n      commandOptions,\n      UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n\n  const normalized: Record<string, unknown> = {\n    title: readUpdateString(\"title\"),\n    description: readUpdateString(\"description\"),\n    body: readUpdateString(\"body\"),\n    status: readUpdateString(\"status\"),\n    closeReason: readUpdateString(\"closeReason\"),\n    priority: readUpdateString(\"priority\"),\n    type: readUpdateString(\"type\"),\n    tags: readUpdateString(\"tags\"),\n    addTags: readUpdateList(\"addTags\"),\n    removeTags: readUpdateList(\"removeTags\"),\n    deadline: readUpdateString(\"deadline\"),\n    estimatedMinutes: readUpdateString(\"estimatedMinutes\"),\n    acceptanceCriteria: readUpdateString(\"acceptanceCriteria\"),\n    definitionOfReady: readUpdateString(\"definitionOfReady\"),\n    order: readUpdateString(\"order\"),\n    rank: readUpdateString(\"rank\"),\n    goal: readUpdateString(\"goal\"),\n    objective: readUpdateString(\"objective\"),\n    value: readUpdateString(\"value\"),\n    impact: readUpdateString(\"impact\"),\n    outcome: readUpdateString(\"outcome\"),\n    whyNow: readUpdateString(\"whyNow\"),\n    author: readUpdateString(\"author\"),\n    message: readUpdateString(\"message\"),\n    force: Boolean(commandOptions.force),\n    allowAuditUpdate:\n      commandOptions.allowAuditUpdate === true || commandOptions.allow_audit_update === true ? true : undefined,\n    allowAuditDepUpdate:\n      commandOptions.allowAuditDepUpdate === true || commandOptions.allow_audit_dep_update === true ? true : undefined,\n    assignee: readUpdateString(\"assignee\"),\n    parent: readUpdateString(\"parent\"),\n    reviewer: readUpdateString(\"reviewer\"),\n    risk: readUpdateString(\"risk\"),\n    confidence: readUpdateString(\"confidence\"),\n    sprint: readUpdateString(\"sprint\"),\n    release: readUpdateString(\"release\"),\n    blockedBy: readUpdateString(\"blockedBy\"),\n    blockedReason: readUpdateString(\"blockedReason\"),\n    unblockNote: readUpdateString(\"unblockNote\"),\n    reporter: readUpdateString(\"reporter\"),\n    severity: readUpdateString(\"severity\"),\n    environment: readUpdateString(\"environment\"),\n    reproSteps: readUpdateString(\"reproSteps\"),\n    resolution: readUpdateString(\"resolution\"),\n    expectedResult: readUpdateString(\"expectedResult\"),\n    actualResult: readUpdateString(\"actualResult\"),\n    affectedVersion: readUpdateString(\"affectedVersion\"),\n    fixedVersion: readUpdateString(\"fixedVersion\"),\n    component: readUpdateString(\"component\"),\n    regression: readUpdateString(\"regression\"),\n    customerImpact: readUpdateString(\"customerImpact\"),\n    dep: readUpdateList(\"dep\"),\n    depRemove: readUpdateList(\"depRemove\"),\n    replaceDeps: commandOptions.replaceDeps === true ? true : undefined,\n    replaceTests: commandOptions.replaceTests === true ? true : undefined,\n    comment: readUpdateList(\"comment\"),\n    note: readUpdateList(\"note\"),\n    learning: readUpdateList(\"learning\"),\n    file: readUpdateList(\"file\"),\n    test: readUpdateList(\"test\"),\n    doc: readUpdateList(\"doc\"),\n    reminder: readUpdateList(\"reminder\"),\n    event: readUpdateList(\"event\"),\n    typeOption: readUpdateList(\"typeOption\"),\n    field: readUpdateList(\"field\"),\n    unset: readUpdateList(\"unset\"),\n    clearDeps: commandOptions.clearDeps === true ? true : undefined,\n    clearComments: commandOptions.clearComments === true ? true : undefined,\n    clearNotes: commandOptions.clearNotes === true ? true : undefined,\n    clearLearnings: commandOptions.clearLearnings === true ? true : undefined,\n    clearFiles: commandOptions.clearFiles === true ? true : undefined,\n    clearTests: commandOptions.clearTests === true ? true : undefined,\n    clearDocs: commandOptions.clearDocs === true ? true : undefined,\n    clearReminders: commandOptions.clearReminders === true ? true : undefined,\n    clearEvents: commandOptions.clearEvents === true ? true : undefined,\n    clearTypeOptions: commandOptions.clearTypeOptions === true ? true : undefined,\n  };\n  for (const [key, value] of Object.entries(commandOptions)) {\n    if (Object.hasOwn(normalized, key)) {\n      continue;\n    }\n    normalized[key] = value;\n  }\n  return normalized;\n}\n\nconst UPDATE_MANY_CONTROL_OPTION_KEYS = new Set<string>([\n  \"filterStatus\",\n  \"filterType\",\n  \"filterTag\",\n  \"filterPriority\",\n  \"filterDeadlineBefore\",\n  \"filterDeadlineAfter\",\n  \"filterUpdatedAfter\",\n  \"filterUpdatedBefore\",\n  \"filterCreatedAfter\",\n  \"filterCreatedBefore\",\n  \"filterAssignee\",\n  \"filterAssigneeFilter\",\n  \"filterAssignee_filter\",\n  \"filterParent\",\n  \"filterSprint\",\n  \"filterRelease\",\n  \"ids\",\n  \"limit\",\n  \"offset\",\n  \"dryRun\",\n  \"rollback\",\n  \"checkpoint\",\n]);\n\nexport function extractUpdateManyMutationOptionSource(commandOptions: Record<string, unknown>): Record<string, unknown> {\n  const mutationOptions: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(commandOptions)) {\n    if (UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)) {\n      continue;\n    }\n    mutationOptions[key] = value;\n  }\n  return mutationOptions;\n}\n\nfunction readListOptionString(options: Record<string, unknown>, target: string): string | undefined {\n  const contract = LIST_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n    target,\n    keys: [target],\n  };\n  const stringValue = readFirstStringFromCommanderOptions(options, contract);\n  if (stringValue !== undefined) {\n    return stringValue;\n  }\n  for (const key of contract.keys) {\n    const value = options[key];\n    if (target === \"ids\" && typeof value === \"string\") {\n      return value;\n    }\n    if (typeof value === \"number\" && Number.isFinite(value)) {\n      return String(value);\n    }\n  }\n  return undefined;\n}\n\nexport function normalizeListOptions(options: Record<string, unknown>): ListOptions {\n  const normalized: Record<string, unknown> = {\n    status: readListOptionString(options, \"status\"),\n    type: readListOptionString(options, \"type\"),\n    tag: readListOptionString(options, \"tag\"),\n    priority: readListOptionString(options, \"priority\"),\n    deadlineBefore: readListOptionString(options, \"deadlineBefore\"),\n    deadlineAfter: readListOptionString(options, \"deadlineAfter\"),\n    updatedAfter: readListOptionString(options, \"updatedAfter\"),\n    updatedBefore: readListOptionString(options, \"updatedBefore\"),\n    createdAfter: readListOptionString(options, \"createdAfter\"),\n    createdBefore: readListOptionString(options, \"createdBefore\"),\n    ids: readListOptionString(options, \"ids\"),\n    assignee: readListOptionString(options, \"assignee\"),\n    assigneeFilter: readListOptionString(options, \"assigneeFilter\"),\n    parent: readListOptionString(options, \"parent\"),\n    sprint: readListOptionString(options, \"sprint\"),\n    release: readListOptionString(options, \"release\"),\n    limit: readListOptionString(options, \"limit\"),\n    offset: readListOptionString(options, \"offset\"),\n    includeBody: options.includeBody === true ? true : undefined,\n    compact: options.compact === true ? true : undefined,\n    brief: options.brief === true ? true : undefined,\n    full: options.full === true ? true : undefined,\n    fields: readListOptionString(options, \"fields\"),\n    sort: readListOptionString(options, \"sort\"),\n    order: readListOptionString(options, \"order\"),\n    tree: options.tree === true ? true : undefined,\n    treeDepth: readListOptionString(options, \"treeDepth\"),\n  };\n  for (const [key, value] of Object.entries(options)) {\n    if (Object.hasOwn(normalized, key)) {\n      continue;\n    }\n    normalized[key] = value;\n  }\n  return normalized as ListOptions;\n}\n\nexport function normalizeAggregateOptions(options: Record<string, unknown>): AggregateOptions {\n  return {\n    groupBy: typeof options.groupBy === \"string\" ? options.groupBy : undefined,\n    count: options.count === true ? true : undefined,\n    sum: typeof options.sum === \"string\" ? options.sum : undefined,\n    avg: typeof options.avg === \"string\" ? options.avg : undefined,\n    includeUnparented: options.includeUnparented === true || options.include_unparented === true,\n    status: typeof options.status === \"string\" ? options.status : undefined,\n    type: readListOptionString(options, \"type\"),\n    tag: readListOptionString(options, \"tag\"),\n    priority: readListOptionString(options, \"priority\"),\n    deadlineBefore: readListOptionString(options, \"deadlineBefore\"),\n    deadlineAfter: readListOptionString(options, \"deadlineAfter\"),\n    assignee: readListOptionString(options, \"assignee\"),\n    assigneeFilter: readListOptionString(options, \"assigneeFilter\"),\n    parent: readListOptionString(options, \"parent\"),\n    sprint: readListOptionString(options, \"sprint\"),\n    release: readListOptionString(options, \"release\"),\n  };\n}\n\ntype ListCommandResult = Awaited<ReturnType<typeof runList>>;\n\nexport function printListJsonStream(commandName: string, result: ListCommandResult, globalOptions: GlobalOptions): void {\n  setActiveCommandResult(result);\n  if (globalOptions.quiet) {\n    return;\n  }\n  const warnings = Array.isArray(result.warnings) ? result.warnings : [];\n  const metaPayload: Record<string, unknown> = {\n    type: \"meta\",\n    command: commandName,\n    count: result.count,\n    now: result.now,\n    filters: result.filters,\n  };\n  if (warnings.length > 0) {\n    metaPayload.warnings = warnings;\n  }\n  if (!writeStdout(`${JSON.stringify(metaPayload)}\\n`)) {\n    return;\n  }\n  for (const item of result.items) {\n    if (!writeStdout(`${JSON.stringify({ type: \"item\", command: commandName, item })}\\n`)) {\n      return;\n    }\n  }\n  writeStdout(`${JSON.stringify({ type: \"end\", command: commandName, count: result.count })}\\n`);\n}\n\ntype ActivityCommandResult = Awaited<ReturnType<typeof runActivity>>;\n\nexport function printActivityJsonStream(\n  result: ActivityCommandResult,\n  options: {\n    id?: string;\n    op?: string;\n    author?: string;\n    from?: string;\n    to?: string;\n    limit?: string;\n  },\n  globalOptions: GlobalOptions,\n): void {\n  setActiveCommandResult(result);\n  if (globalOptions.quiet) {\n    return;\n  }\n  const metaPayload = {\n    type: \"meta\",\n    command: \"activity\",\n    count: result.count,\n    filters: {\n      id: options.id ?? null,\n      op: options.op ?? null,\n      author: options.author ?? null,\n      from: options.from ?? null,\n      to: options.to ?? null,\n      limit: options.limit ?? null,\n    },\n  };\n  if (!writeStdout(`${JSON.stringify(metaPayload)}\\n`)) {\n    return;\n  }\n  const entries = result.compact && result.compact_activity ? result.compact_activity : result.activity;\n  for (const entry of entries) {\n    if (!writeStdout(`${JSON.stringify({ type: \"entry\", command: \"activity\", entry })}\\n`)) {\n      return;\n    }\n  }\n  writeStdout(`${JSON.stringify({ type: \"end\", command: \"activity\", count: result.count })}\\n`);\n}\n\nexport function normalizeSearchOptions(options: Record<string, unknown>): Record<string, unknown> {\n  const readSearchString = (target: string): string | undefined =>\n    readFirstStringFromCommanderOptions(\n      options,\n      SEARCH_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n  const readSearchStringOrNumber = (target: string): string | number | undefined => {\n    const candidate = readFirstValueFromCommanderOptions(\n      options,\n      SEARCH_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n    if (typeof candidate === \"string\") {\n      return candidate;\n    }\n    if (typeof candidate === \"number\" && Number.isFinite(candidate)) {\n      return candidate;\n    }\n    return undefined;\n  };\n  const fields = readSearchString(\"fields\");\n  const compactRequested = options.compact === true;\n  const fullRequested = options.full === true;\n  const defaultCompact = !compactRequested && !fullRequested && fields === undefined;\n  const mode = options.semantic === true ? \"semantic\"\n    : options.hybrid === true ? \"hybrid\"\n    : readSearchString(\"mode\");\n  const normalized: Record<string, unknown> = {\n    mode,\n    semanticWeight: readSearchStringOrNumber(\"semanticWeight\"),\n    includeLinked: options.includeLinked === true ? true : undefined,\n    titleExact: options.titleExact === true ? true : undefined,\n    phraseExact: options.phraseExact === true ? true : undefined,\n    status: readSearchString(\"status\"),\n    type: readSearchString(\"type\"),\n    tag: readSearchString(\"tag\"),\n    priority: readSearchString(\"priority\"),\n    deadlineBefore: readSearchString(\"deadlineBefore\"),\n    deadlineAfter: readSearchString(\"deadlineAfter\"),\n    limit: readSearchString(\"limit\"),\n    fields,\n    compact: compactRequested || defaultCompact ? true : undefined,\n    full: fullRequested ? true : undefined,\n  };\n  for (const [key, value] of Object.entries(options)) {\n    if (Object.hasOwn(normalized, key)) {\n      continue;\n    }\n    normalized[key] = value;\n  }\n  return normalized;\n}\n\nexport function normalizeSearchKeywordsInput(keywords: string[]): string {\n  const query = keywords\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0)\n    .join(\" \");\n  if (query.length === 0) {\n    throw new PmCliError(\"Search query must not be empty\", EXIT_CODE.USAGE);\n  }\n  return query;\n}\n\n\nexport function normalizeActivityOptions(options: Record<string, unknown>): {\n  id?: string;\n  op?: string;\n  author?: string;\n  from?: string;\n  to?: string;\n  limit?: string;\n  compact?: boolean;\n} {\n  const readActivityString = (target: string): string | undefined =>\n    readFirstStringFromCommanderOptions(\n      options,\n      ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n  return {\n    id: readActivityString(\"id\"),\n    op: readActivityString(\"op\"),\n    author: readActivityString(\"author\"),\n    from: readActivityString(\"from\"),\n    to: readActivityString(\"to\"),\n    limit: readActivityString(\"limit\"),\n    compact: options.full === true ? false : options.compact === false ? false : true,\n  };\n}\n\nexport function resolveActivityStreamMode(raw: unknown): boolean {\n  if (raw === true) {\n    return true;\n  }\n  if (raw === false || raw === undefined || raw === null) {\n    return false;\n  }\n  if (typeof raw === \"string\") {\n    const normalized = raw.trim().toLowerCase();\n    if (\n      normalized.length === 0 ||\n      normalized === \"rows\" ||\n      normalized === \"ndjson\" ||\n      normalized === \"jsonl\" ||\n      normalized === \"true\" ||\n      normalized === \"1\" ||\n      normalized === \"yes\" ||\n      normalized === \"on\"\n    ) {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"off\" || normalized === \"none\" || normalized === \"0\") {\n      return false;\n    }\n  }\n  throw new PmCliError(\"Activity --stream accepts rows|ndjson|jsonl (or no value)\", EXIT_CODE.USAGE);\n}\n\nexport function normalizeContextOptions(options: Record<string, unknown>): ContextOptions {\n  const readContextString = (target: string): string | undefined =>\n    readFirstStringFromCommanderOptions(\n      options,\n      CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS.find((entry) => entry.target === target) ?? {\n        target,\n        keys: [target],\n      },\n    );\n  const sectionRaw = options.section;\n  const section: string[] | undefined = Array.isArray(sectionRaw)\n    ? (sectionRaw as string[]).filter((v) => typeof v === \"string\" && v.trim().length > 0)\n    : typeof sectionRaw === \"string\" && sectionRaw.trim().length > 0\n      ? [sectionRaw]\n      : undefined;\n  const normalized: Record<string, unknown> = {\n    date: readContextString(\"date\"),\n    from: readContextString(\"from\"),\n    to: readContextString(\"to\"),\n    past: options.past === true ? true : undefined,\n    type: readContextString(\"type\"),\n    tag: readContextString(\"tag\"),\n    priority: readContextString(\"priority\"),\n    assignee: readContextString(\"assignee\"),\n    assigneeFilter: readContextString(\"assigneeFilter\"),\n    sprint: readContextString(\"sprint\"),\n    release: readContextString(\"release\"),\n    limit: readContextString(\"limit\"),\n    format: readContextString(\"format\"),\n    depth: readContextString(\"depth\"),\n    section: section && section.length > 0 ? section : undefined,\n    activityLimit: readContextString(\"activityLimit\"),\n    staleThreshold: readContextString(\"staleThreshold\"),\n  };\n  for (const [key, value] of Object.entries(options)) {\n    if (Object.hasOwn(normalized, key)) {\n      continue;\n    }\n    normalized[key] = value;\n  }\n  return normalized as ContextOptions;\n}\n\nfunction collectMutationItemIds(result: unknown): string[] {\n  if (!result || typeof result !== \"object\") {\n    return [];\n  }\n  const record = result as Record<string, unknown>;\n  const ids = new Set<string>();\n  const pushId = (value: unknown): void => {\n    if (typeof value !== \"string\") {\n      return;\n    }\n    const normalized = value.trim();\n    if (normalized.length === 0) {\n      return;\n    }\n    ids.add(normalized);\n  };\n\n  pushId(record.id);\n\n  const item = record.item;\n  if (item && typeof item === \"object\") {\n    pushId((item as { id?: unknown }).id);\n  }\n\n  const explicitIds = record.ids;\n  if (Array.isArray(explicitIds)) {\n    for (const candidate of explicitIds) {\n      pushId(candidate);\n    }\n  }\n\n  const items = record.items;\n  if (Array.isArray(items)) {\n    for (const candidate of items) {\n      if (!candidate || typeof candidate !== \"object\") {\n        continue;\n      }\n      pushId((candidate as { id?: unknown }).id);\n    }\n  }\n\n  return [...ids].sort((left, right) => left.localeCompare(right));\n}\n\nexport async function invalidateSearchCachesForMutation(globalOptions: GlobalOptions, result?: unknown): Promise<void> {\n  const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);\n  const refreshResult = await refreshSearchArtifactsForMutation(pmRoot, collectMutationItemIds(result), {\n    background: !shouldRunSearchRefreshInForeground(),\n  });\n  if (globalOptions.profile && refreshResult.warnings.length > 0) {\n    printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`);\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAM,0BAA0B,uBAAO,0BAA0B;AAWjE,SAAS,qBAAqB,SAAgB;AAC5C,SAAO,OAAO,YAAY,YAAY,YAAY,OAAO,UAAkC,CAAA;AAC7F;AAEM,SAAU,yBAAyB,SAAkB,eAA4B;AACpF,UAAuC,uBAAuB,IAAI,EAAE,GAAG,cAAa;AACvF;AAEM,SAAU,2BAA2B,SAAgB;AACzD,SAAQ,QAAuC,uBAAuB;AACxE;AAEM,SAAU,iBAAiB,SAAgB;AAC/C,QAAM,WAAY,QAAuC,uBAAuB;AAChF,MAAI,UAAU;AACZ,WAAO,EAAE,GAAG,SAAQ;EACtB;AACA,QAAM,SAAS,qBAAqB,OAAO;AAC3C,QAAM,OAAO,OAAO,OAAO,oBAAoB,aAC3C,OAAO,gBAAe,IACtB,OAAO,OAAO,SAAS,aACrB,OAAO,KAAI,IACX,CAAA;AACN,SAAO;IACL,MAAM,KAAK,SAAS,OAAO,OAAO;IAClC,OAAO,QAAQ,KAAK,KAAK;IACzB,iBAAiB,KAAK,kBAAkB;IACxC,MAAM,OAAO,KAAK,WAAW,WACzB,KAAK,SACL,OAAO,KAAK,SAAS,WACnB,KAAK,OACL;IACN,cAAc,KAAK,eAAe;IAClC,SAAS,QAAQ,KAAK,OAAO;IAC7B,SAAS,QAAQ,KAAK,OAAO;;AAEjC;AAEM,SAAU,eAAe,SAAgB;AAC7C,QAAM,QAAkB,CAAA;AACxB,MAAI,UAA0B;AAC9B,SAAO,SAAS,QAAQ;AACtB,UAAM,QAAQ,QAAQ,KAAI,CAAE;AAC5B,cAAU,QAAQ;EACpB;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAEA,eAAsB,yBAAyB,eAA4B;AACzE,MAAI,cAAc,SAAS,MAAM;AAC/B,WAAO;EACT;AACA,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,cAAc,IAAI;AAC9D,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,WAAO;EACT;AACA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,SAAO;IACL,GAAG;IACH,qBAAqB,SAAS,OAAO;;AAEzC;AAEM,SAAU,QAAQ,OAAe,UAA8B;AACnE,QAAM,OAAO,YAAY,CAAA;AACzB,OAAK,KAAK,KAAK;AACf,SAAO;AACT;AAEA,SAAS,sBAAsB,MAAgB,MAAc,OAAc;AACzE,MAAI,OAAO,UAAU,UAAU;AAC7B;EACF;AACA,QAAM,UAAU,MAAM,KAAI;AAC1B,MAAI,QAAQ,WAAW,GAAG;AACxB;EACF;AACA,OAAK,KAAK,MAAM,OAAO;AACzB;AAEA,SAAS,wBAAwB,MAAgB,MAAc,OAAc;AAC3E,MAAI,UAAU,MAAM;AAClB,SAAK,KAAK,IAAI;EAChB;AACF;AAEA,SAAS,wBAAwB,MAAgB,MAAc,QAAe;AAC5E,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B;EACF;AACA,aAAW,SAAS,QAAQ;AAC1B,QAAI,OAAO,UAAU,UAAU;AAC7B;IACF;AACA,UAAM,UAAU,MAAM,KAAI;AAC1B,QAAI,QAAQ,WAAW,GAAG;AACxB;IACF;AACA,SAAK,KAAK,MAAM,OAAO;EACzB;AACF;AAEM,SAAU,+BAA+B,IAAY,SAAgC;AACzF,QAAM,OAAiB,CAAC,QAAQ,IAAI,SAAS,UAAU,YAAY;AACnE,0BAAwB,MAAM,SAAS,QAAQ,GAAG;AAClD,0BAAwB,MAAM,YAAY,QAAQ,MAAM;AACxD,wBAAsB,MAAM,aAAa,QAAQ,OAAO;AACxD,0BAAwB,MAAM,aAAa,QAAQ,MAAM;AACzD,0BAAwB,MAAM,eAAe,QAAQ,QAAQ;AAC7D,0BAAwB,MAAM,sBAAsB,QAAQ,cAAc;AAC1E,wBAAsB,MAAM,gBAAgB,QAAQ,SAAS;AAC7D,0BAAwB,MAAM,gCAAgC,QAAQ,uBAAuB;AAC7F,0BAAwB,MAAM,8BAA8B,QAAQ,qBAAqB;AACzF,0BAAwB,MAAM,qBAAqB,QAAQ,aAAa;AACxE,0BAAwB,MAAM,4BAA4B,QAAQ,kBAAkB;AACpF,0BAAwB,MAAM,+BAA+B,QAAQ,sBAAsB;AAC3F,0BAAwB,MAAM,mBAAmB,QAAQ,YAAY;AACrE,0BAAwB,MAAM,qBAAqB,QAAQ,aAAa;AACxE,wBAAsB,MAAM,YAAY,QAAQ,MAAM;AACtD,wBAAsB,MAAM,aAAa,QAAQ,OAAO;AACxD,0BAAwB,MAAM,WAAW,QAAQ,KAAK;AACtD,SAAO;AACT;AAEM,SAAU,kCAAkC,SAAgC;AAChF,QAAM,OAAiB,CAAC,YAAY,UAAU,YAAY;AAC1D,wBAAsB,MAAM,YAAY,QAAQ,MAAM;AACtD,wBAAsB,MAAM,WAAW,QAAQ,KAAK;AACpD,wBAAsB,MAAM,YAAY,QAAQ,MAAM;AACtD,wBAAsB,MAAM,aAAa,QAAQ,OAAO;AACxD,0BAAwB,MAAM,aAAa,QAAQ,MAAM;AACzD,0BAAwB,MAAM,eAAe,QAAQ,QAAQ;AAC7D,0BAAwB,MAAM,sBAAsB,QAAQ,cAAc;AAC1E,wBAAsB,MAAM,gBAAgB,QAAQ,SAAS;AAC7D,0BAAwB,MAAM,gCAAgC,QAAQ,uBAAuB;AAC7F,0BAAwB,MAAM,8BAA8B,QAAQ,qBAAqB;AACzF,0BAAwB,MAAM,qBAAqB,QAAQ,aAAa;AACxE,0BAAwB,MAAM,4BAA4B,QAAQ,kBAAkB;AACpF,0BAAwB,MAAM,+BAA+B,QAAQ,sBAAsB;AAC3F,0BAAwB,MAAM,mBAAmB,QAAQ,YAAY;AACrE,0BAAwB,MAAM,qBAAqB,QAAQ,aAAa;AACxE,SAAO;AACT;AAEM,SAAU,mBAAmB,UAAkB;AACnD,SAAO,SAAS,KAAK,GAAG;AAC1B;AAEM,SAAU,uBACd,gBACA,UAAqC,CAAA,GAAE;AAEvC,QAAM,mBAAmB,CAAC,WACxB,oCACE,gBACA,yCAAyC,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACnF;IACA,MAAM,CAAC,MAAM;GACd;AAEL,QAAM,iBAAiB,CAAC,WACtB,oCACE,gBACA,6CAA6C,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACvF;IACA,MAAM,CAAC,MAAM;GACd;AAGL,QAAM,OAAO,iBAAiB,MAAM;AACpC,MAAI,QAAQ,gBAAgB,SAAS,SAAS,QAAW;AACvD,UAAM,IAAI,WACR,uMACA,UAAU,KAAK;EAEnB;AAEA,QAAM,aAAsC;IAC1C,OAAO,iBAAiB,OAAO;IAC/B,aAAa,iBAAiB,aAAa;IAC3C;IACA,UAAU,iBAAiB,UAAU;IACrC,YAAY,iBAAiB,YAAY;IACzC,gBAAgB,iBAAiB,gBAAgB;IACjD,QAAQ,iBAAiB,QAAQ;IACjC,UAAU,iBAAiB,UAAU;IACrC,MAAM,iBAAiB,MAAM;IAC7B,SAAS,eAAe,SAAS;IACjC,MAAM,iBAAiB,MAAM;IAC7B,UAAU,iBAAiB,UAAU;IACrC,kBAAkB,iBAAiB,kBAAkB;IACrD,oBAAoB,iBAAiB,oBAAoB;IACzD,mBAAmB,iBAAiB,mBAAmB;IACvD,OAAO,iBAAiB,OAAO;IAC/B,MAAM,iBAAiB,MAAM;IAC7B,MAAM,iBAAiB,MAAM;IAC7B,WAAW,iBAAiB,WAAW;IACvC,OAAO,iBAAiB,OAAO;IAC/B,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,QAAQ,iBAAiB,QAAQ;IACjC,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,UAAU,iBAAiB,UAAU;IACrC,QAAQ,iBAAiB,QAAQ;IACjC,UAAU,iBAAiB,UAAU;IACrC,MAAM,iBAAiB,MAAM;IAC7B,YAAY,iBAAiB,YAAY;IACzC,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,WAAW,iBAAiB,WAAW;IACvC,eAAe,iBAAiB,eAAe;IAC/C,aAAa,iBAAiB,aAAa;IAC3C,UAAU,iBAAiB,UAAU;IACrC,UAAU,iBAAiB,UAAU;IACrC,aAAa,iBAAiB,aAAa;IAC3C,YAAY,iBAAiB,YAAY;IACzC,YAAY,iBAAiB,YAAY;IACzC,gBAAgB,iBAAiB,gBAAgB;IACjD,cAAc,iBAAiB,cAAc;IAC7C,iBAAiB,iBAAiB,iBAAiB;IACnD,cAAc,iBAAiB,cAAc;IAC7C,WAAW,iBAAiB,WAAW;IACvC,YAAY,iBAAiB,YAAY;IACzC,gBAAgB,iBAAiB,gBAAgB;IACjD,KAAK,eAAe,KAAK;IACzB,SAAS,eAAe,SAAS;IACjC,MAAM,eAAe,MAAM;IAC3B,UAAU,eAAe,UAAU;IACnC,MAAM,eAAe,MAAM;IAC3B,MAAM,eAAe,MAAM;IAC3B,KAAK,eAAe,KAAK;IACzB,UAAU,eAAe,UAAU;IACnC,OAAO,eAAe,OAAO;IAC7B,YAAY,eAAe,YAAY;IACvC,OAAO,eAAe,OAAO;IAC7B,OAAO,eAAe,OAAO;IAC7B,WAAW,eAAe,cAAc,OAAO,OAAO;IACtD,eAAe,eAAe,kBAAkB,OAAO,OAAO;IAC9D,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,gBAAgB,eAAe,mBAAmB,OAAO,OAAO;IAChE,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,WAAW,eAAe,cAAc,OAAO,OAAO;IACtD,gBAAgB,eAAe,mBAAmB,OAAO,OAAO;IAChE,aAAa,eAAe,gBAAgB,OAAO,OAAO;IAC1D,kBAAkB,eAAe,qBAAqB,OAAO,OAAO;;AAEtE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,QAAI,OAAO,OAAO,YAAY,GAAG,GAAG;AAClC;IACF;AACA,eAAW,GAAG,IAAI;EACpB;AACA,SAAO;AACT;AAEM,SAAU,uBAAuB,gBAAuC;AAC5E,QAAM,mBAAmB,CAAC,WACxB,oCACE,gBACA,yCAAyC,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACnF;IACA,MAAM,CAAC,MAAM;GACd;AAEL,QAAM,iBAAiB,CAAC,WACtB,oCACE,gBACA,6CAA6C,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACvF;IACA,MAAM,CAAC,MAAM;GACd;AAGL,QAAM,aAAsC;IAC1C,OAAO,iBAAiB,OAAO;IAC/B,aAAa,iBAAiB,aAAa;IAC3C,MAAM,iBAAiB,MAAM;IAC7B,QAAQ,iBAAiB,QAAQ;IACjC,aAAa,iBAAiB,aAAa;IAC3C,UAAU,iBAAiB,UAAU;IACrC,MAAM,iBAAiB,MAAM;IAC7B,MAAM,iBAAiB,MAAM;IAC7B,SAAS,eAAe,SAAS;IACjC,YAAY,eAAe,YAAY;IACvC,UAAU,iBAAiB,UAAU;IACrC,kBAAkB,iBAAiB,kBAAkB;IACrD,oBAAoB,iBAAiB,oBAAoB;IACzD,mBAAmB,iBAAiB,mBAAmB;IACvD,OAAO,iBAAiB,OAAO;IAC/B,MAAM,iBAAiB,MAAM;IAC7B,MAAM,iBAAiB,MAAM;IAC7B,WAAW,iBAAiB,WAAW;IACvC,OAAO,iBAAiB,OAAO;IAC/B,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,QAAQ,iBAAiB,QAAQ;IACjC,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,OAAO,QAAQ,eAAe,KAAK;IACnC,kBACE,eAAe,qBAAqB,QAAQ,eAAe,uBAAuB,OAAO,OAAO;IAClG,qBACE,eAAe,wBAAwB,QAAQ,eAAe,2BAA2B,OAAO,OAAO;IACzG,UAAU,iBAAiB,UAAU;IACrC,QAAQ,iBAAiB,QAAQ;IACjC,UAAU,iBAAiB,UAAU;IACrC,MAAM,iBAAiB,MAAM;IAC7B,YAAY,iBAAiB,YAAY;IACzC,QAAQ,iBAAiB,QAAQ;IACjC,SAAS,iBAAiB,SAAS;IACnC,WAAW,iBAAiB,WAAW;IACvC,eAAe,iBAAiB,eAAe;IAC/C,aAAa,iBAAiB,aAAa;IAC3C,UAAU,iBAAiB,UAAU;IACrC,UAAU,iBAAiB,UAAU;IACrC,aAAa,iBAAiB,aAAa;IAC3C,YAAY,iBAAiB,YAAY;IACzC,YAAY,iBAAiB,YAAY;IACzC,gBAAgB,iBAAiB,gBAAgB;IACjD,cAAc,iBAAiB,cAAc;IAC7C,iBAAiB,iBAAiB,iBAAiB;IACnD,cAAc,iBAAiB,cAAc;IAC7C,WAAW,iBAAiB,WAAW;IACvC,YAAY,iBAAiB,YAAY;IACzC,gBAAgB,iBAAiB,gBAAgB;IACjD,KAAK,eAAe,KAAK;IACzB,WAAW,eAAe,WAAW;IACrC,aAAa,eAAe,gBAAgB,OAAO,OAAO;IAC1D,cAAc,eAAe,iBAAiB,OAAO,OAAO;IAC5D,SAAS,eAAe,SAAS;IACjC,MAAM,eAAe,MAAM;IAC3B,UAAU,eAAe,UAAU;IACnC,MAAM,eAAe,MAAM;IAC3B,MAAM,eAAe,MAAM;IAC3B,KAAK,eAAe,KAAK;IACzB,UAAU,eAAe,UAAU;IACnC,OAAO,eAAe,OAAO;IAC7B,YAAY,eAAe,YAAY;IACvC,OAAO,eAAe,OAAO;IAC7B,OAAO,eAAe,OAAO;IAC7B,WAAW,eAAe,cAAc,OAAO,OAAO;IACtD,eAAe,eAAe,kBAAkB,OAAO,OAAO;IAC9D,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,gBAAgB,eAAe,mBAAmB,OAAO,OAAO;IAChE,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,YAAY,eAAe,eAAe,OAAO,OAAO;IACxD,WAAW,eAAe,cAAc,OAAO,OAAO;IACtD,gBAAgB,eAAe,mBAAmB,OAAO,OAAO;IAChE,aAAa,eAAe,gBAAgB,OAAO,OAAO;IAC1D,kBAAkB,eAAe,qBAAqB,OAAO,OAAO;;AAEtE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,QAAI,OAAO,OAAO,YAAY,GAAG,GAAG;AAClC;IACF;AACA,eAAW,GAAG,IAAI;EACpB;AACA,SAAO;AACT;AAEA,IAAM,kCAAkC,oBAAI,IAAY;EACtD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACD;AAEK,SAAU,sCAAsC,gBAAuC;AAC3F,QAAM,kBAA2C,CAAA;AACjD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,QAAI,gCAAgC,IAAI,GAAG,GAAG;AAC5C;IACF;AACA,oBAAgB,GAAG,IAAI;EACzB;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,SAAkC,QAAc;AAC5E,QAAM,WAAW,uCAAuC,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IAClG;IACA,MAAM,CAAC,MAAM;;AAEf,QAAM,cAAc,oCAAoC,SAAS,QAAQ;AACzE,MAAI,gBAAgB,QAAW;AAC7B,WAAO;EACT;AACA,aAAW,OAAO,SAAS,MAAM;AAC/B,UAAM,QAAQ,QAAQ,GAAG;AACzB,QAAI,WAAW,SAAS,OAAO,UAAU,UAAU;AACjD,aAAO;IACT;AACA,QAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG;AACvD,aAAO,OAAO,KAAK;IACrB;EACF;AACA,SAAO;AACT;AAEM,SAAU,qBAAqB,SAAgC;AACnE,QAAM,aAAsC;IAC1C,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,MAAM,qBAAqB,SAAS,MAAM;IAC1C,KAAK,qBAAqB,SAAS,KAAK;IACxC,UAAU,qBAAqB,SAAS,UAAU;IAClD,gBAAgB,qBAAqB,SAAS,gBAAgB;IAC9D,eAAe,qBAAqB,SAAS,eAAe;IAC5D,cAAc,qBAAqB,SAAS,cAAc;IAC1D,eAAe,qBAAqB,SAAS,eAAe;IAC5D,cAAc,qBAAqB,SAAS,cAAc;IAC1D,eAAe,qBAAqB,SAAS,eAAe;IAC5D,KAAK,qBAAqB,SAAS,KAAK;IACxC,UAAU,qBAAqB,SAAS,UAAU;IAClD,gBAAgB,qBAAqB,SAAS,gBAAgB;IAC9D,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,SAAS,qBAAqB,SAAS,SAAS;IAChD,OAAO,qBAAqB,SAAS,OAAO;IAC5C,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,aAAa,QAAQ,gBAAgB,OAAO,OAAO;IACnD,SAAS,QAAQ,YAAY,OAAO,OAAO;IAC3C,OAAO,QAAQ,UAAU,OAAO,OAAO;IACvC,MAAM,QAAQ,SAAS,OAAO,OAAO;IACrC,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,MAAM,qBAAqB,SAAS,MAAM;IAC1C,OAAO,qBAAqB,SAAS,OAAO;IAC5C,MAAM,QAAQ,SAAS,OAAO,OAAO;IACrC,WAAW,qBAAqB,SAAS,WAAW;;AAEtD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AAClD,QAAI,OAAO,OAAO,YAAY,GAAG,GAAG;AAClC;IACF;AACA,eAAW,GAAG,IAAI;EACpB;AACA,SAAO;AACT;AAEM,SAAU,0BAA0B,SAAgC;AACxE,SAAO;IACL,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU;IACjE,OAAO,QAAQ,UAAU,OAAO,OAAO;IACvC,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM;IACrD,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM;IACrD,mBAAmB,QAAQ,sBAAsB,QAAQ,QAAQ,uBAAuB;IACxF,QAAQ,OAAO,QAAQ,WAAW,WAAW,QAAQ,SAAS;IAC9D,MAAM,qBAAqB,SAAS,MAAM;IAC1C,KAAK,qBAAqB,SAAS,KAAK;IACxC,UAAU,qBAAqB,SAAS,UAAU;IAClD,gBAAgB,qBAAqB,SAAS,gBAAgB;IAC9D,eAAe,qBAAqB,SAAS,eAAe;IAC5D,UAAU,qBAAqB,SAAS,UAAU;IAClD,gBAAgB,qBAAqB,SAAS,gBAAgB;IAC9D,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,QAAQ,qBAAqB,SAAS,QAAQ;IAC9C,SAAS,qBAAqB,SAAS,SAAS;;AAEpD;AAIM,SAAU,oBAAoB,aAAqB,QAA2B,eAA4B;AAC9G,yBAAuB,MAAM;AAC7B,MAAI,cAAc,OAAO;AACvB;EACF;AACA,QAAM,WAAW,MAAM,QAAQ,OAAO,QAAQ,IAAI,OAAO,WAAW,CAAA;AACpE,QAAM,cAAuC;IAC3C,MAAM;IACN,SAAS;IACT,OAAO,OAAO;IACd,KAAK,OAAO;IACZ,SAAS,OAAO;;AAElB,MAAI,SAAS,SAAS,GAAG;AACvB,gBAAY,WAAW;EACzB;AACA,MAAI,CAAC,YAAY,GAAG,KAAK,UAAU,WAAW,CAAC;CAAI,GAAG;AACpD;EACF;AACA,aAAW,QAAQ,OAAO,OAAO;AAC/B,QAAI,CAAC,YAAY,GAAG,KAAK,UAAU,EAAE,MAAM,QAAQ,SAAS,aAAa,KAAI,CAAE,CAAC;CAAI,GAAG;AACrF;IACF;EACF;AACA,cAAY,GAAG,KAAK,UAAU,EAAE,MAAM,OAAO,SAAS,aAAa,OAAO,OAAO,MAAK,CAAE,CAAC;CAAI;AAC/F;AAIM,SAAU,wBACd,QACA,SAQA,eAA4B;AAE5B,yBAAuB,MAAM;AAC7B,MAAI,cAAc,OAAO;AACvB;EACF;AACA,QAAM,cAAc;IAClB,MAAM;IACN,SAAS;IACT,OAAO,OAAO;IACd,SAAS;MACP,IAAI,QAAQ,MAAM;MAClB,IAAI,QAAQ,MAAM;MAClB,QAAQ,QAAQ,UAAU;MAC1B,MAAM,QAAQ,QAAQ;MACtB,IAAI,QAAQ,MAAM;MAClB,OAAO,QAAQ,SAAS;;;AAG5B,MAAI,CAAC,YAAY,GAAG,KAAK,UAAU,WAAW,CAAC;CAAI,GAAG;AACpD;EACF;AACA,QAAM,UAAU,OAAO,WAAW,OAAO,mBAAmB,OAAO,mBAAmB,OAAO;AAC7F,aAAW,SAAS,SAAS;AAC3B,QAAI,CAAC,YAAY,GAAG,KAAK,UAAU,EAAE,MAAM,SAAS,SAAS,YAAY,MAAK,CAAE,CAAC;CAAI,GAAG;AACtF;IACF;EACF;AACA,cAAY,GAAG,KAAK,UAAU,EAAE,MAAM,OAAO,SAAS,YAAY,OAAO,OAAO,MAAK,CAAE,CAAC;CAAI;AAC9F;AAEM,SAAU,uBAAuB,SAAgC;AACrE,QAAM,mBAAmB,CAAC,WACxB,oCACE,SACA,yCAAyC,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACnF;IACA,MAAM,CAAC,MAAM;GACd;AAEL,QAAM,2BAA2B,CAAC,WAA+C;AAC/E,UAAM,YAAY,mCAChB,SACA,yCAAyC,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;MACnF;MACA,MAAM,CAAC,MAAM;KACd;AAEH,QAAI,OAAO,cAAc,UAAU;AACjC,aAAO;IACT;AACA,QAAI,OAAO,cAAc,YAAY,OAAO,SAAS,SAAS,GAAG;AAC/D,aAAO;IACT;AACA,WAAO;EACT;AACA,QAAM,SAAS,iBAAiB,QAAQ;AACxC,QAAM,mBAAmB,QAAQ,YAAY;AAC7C,QAAM,gBAAgB,QAAQ,SAAS;AACvC,QAAM,iBAAiB,CAAC,oBAAoB,CAAC,iBAAiB,WAAW;AACzE,QAAM,OAAO,QAAQ,aAAa,OAAO,aACrC,QAAQ,WAAW,OAAO,WAC1B,iBAAiB,MAAM;AAC3B,QAAM,aAAsC;IAC1C;IACA,gBAAgB,yBAAyB,gBAAgB;IACzD,eAAe,QAAQ,kBAAkB,OAAO,OAAO;IACvD,YAAY,QAAQ,eAAe,OAAO,OAAO;IACjD,aAAa,QAAQ,gBAAgB,OAAO,OAAO;IACnD,QAAQ,iBAAiB,QAAQ;IACjC,MAAM,iBAAiB,MAAM;IAC7B,KAAK,iBAAiB,KAAK;IAC3B,UAAU,iBAAiB,UAAU;IACrC,gBAAgB,iBAAiB,gBAAgB;IACjD,eAAe,iBAAiB,eAAe;IAC/C,OAAO,iBAAiB,OAAO;IAC/B;IACA,SAAS,oBAAoB,iBAAiB,OAAO;IACrD,MAAM,gBAAgB,OAAO;;AAE/B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AAClD,QAAI,OAAO,OAAO,YAAY,GAAG,GAAG;AAClC;IACF;AACA,eAAW,GAAG,IAAI;EACpB;AACA,SAAO;AACT;AAEM,SAAU,6BAA6B,UAAkB;AAC7D,QAAM,QAAQ,SACX,IAAI,CAAC,UAAU,MAAM,KAAI,CAAE,EAC3B,OAAO,CAAC,UAAU,MAAM,SAAS,CAAC,EAClC,KAAK,GAAG;AACX,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,WAAW,kCAAkC,UAAU,KAAK;EACxE;AACA,SAAO;AACT;AAGM,SAAU,yBAAyB,SAAgC;AASvE,QAAM,qBAAqB,CAAC,WAC1B,oCACE,SACA,2CAA2C,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACrF;IACA,MAAM,CAAC,MAAM;GACd;AAEL,SAAO;IACL,IAAI,mBAAmB,IAAI;IAC3B,IAAI,mBAAmB,IAAI;IAC3B,QAAQ,mBAAmB,QAAQ;IACnC,MAAM,mBAAmB,MAAM;IAC/B,IAAI,mBAAmB,IAAI;IAC3B,OAAO,mBAAmB,OAAO;IACjC,SAAS,QAAQ,SAAS,OAAO,QAAQ,QAAQ,YAAY,QAAQ,QAAQ;;AAEjF;AAEM,SAAU,0BAA0B,KAAY;AACpD,MAAI,QAAQ,MAAM;AAChB,WAAO;EACT;AACA,MAAI,QAAQ,SAAS,QAAQ,UAAa,QAAQ,MAAM;AACtD,WAAO;EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,UAAM,aAAa,IAAI,KAAI,EAAG,YAAW;AACzC,QACE,WAAW,WAAW,KACtB,eAAe,UACf,eAAe,YACf,eAAe,WACf,eAAe,UACf,eAAe,OACf,eAAe,SACf,eAAe,MACf;AACA,aAAO;IACT;AACA,QAAI,eAAe,WAAW,eAAe,SAAS,eAAe,UAAU,eAAe,KAAK;AACjG,aAAO;IACT;EACF;AACA,QAAM,IAAI,WAAW,6DAA6D,UAAU,KAAK;AACnG;AAEM,SAAU,wBAAwB,SAAgC;AACtE,QAAM,oBAAoB,CAAC,WACzB,oCACE,SACA,0CAA0C,KAAK,CAAC,UAAU,MAAM,WAAW,MAAM,KAAK;IACpF;IACA,MAAM,CAAC,MAAM;GACd;AAEL,QAAM,aAAa,QAAQ;AAC3B,QAAM,UAAgC,MAAM,QAAQ,UAAU,IACzD,WAAwB,OAAO,CAAC,MAAM,OAAO,MAAM,YAAY,EAAE,KAAI,EAAG,SAAS,CAAC,IACnF,OAAO,eAAe,YAAY,WAAW,KAAI,EAAG,SAAS,IAC3D,CAAC,UAAU,IACX;AACN,QAAM,aAAsC;IAC1C,MAAM,kBAAkB,MAAM;IAC9B,MAAM,kBAAkB,MAAM;IAC9B,IAAI,kBAAkB,IAAI;IAC1B,MAAM,QAAQ,SAAS,OAAO,OAAO;IACrC,MAAM,kBAAkB,MAAM;IAC9B,KAAK,kBAAkB,KAAK;IAC5B,UAAU,kBAAkB,UAAU;IACtC,UAAU,kBAAkB,UAAU;IACtC,gBAAgB,kBAAkB,gBAAgB;IAClD,QAAQ,kBAAkB,QAAQ;IAClC,SAAS,kBAAkB,SAAS;IACpC,OAAO,kBAAkB,OAAO;IAChC,QAAQ,kBAAkB,QAAQ;IAClC,OAAO,kBAAkB,OAAO;IAChC,SAAS,WAAW,QAAQ,SAAS,IAAI,UAAU;IACnD,eAAe,kBAAkB,eAAe;IAChD,gBAAgB,kBAAkB,gBAAgB;;AAEpD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AAClD,QAAI,OAAO,OAAO,YAAY,GAAG,GAAG;AAClC;IACF;AACA,eAAW,GAAG,IAAI;EACpB;AACA,SAAO;AACT;AAEA,SAAS,uBAAuB,QAAe;AAC7C,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,WAAO,CAAA;EACT;AACA,QAAM,SAAS;AACf,QAAM,MAAM,oBAAI,IAAG;AACnB,QAAM,SAAS,CAAC,UAAwB;AACtC,QAAI,OAAO,UAAU,UAAU;AAC7B;IACF;AACA,UAAM,aAAa,MAAM,KAAI;AAC7B,QAAI,WAAW,WAAW,GAAG;AAC3B;IACF;AACA,QAAI,IAAI,UAAU;EACpB;AAEA,SAAO,OAAO,EAAE;AAEhB,QAAM,OAAO,OAAO;AACpB,MAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,WAAQ,KAA0B,EAAE;EACtC;AAEA,QAAM,cAAc,OAAO;AAC3B,MAAI,MAAM,QAAQ,WAAW,GAAG;AAC9B,eAAW,aAAa,aAAa;AACnC,aAAO,SAAS;IAClB;EACF;AAEA,QAAM,QAAQ,OAAO;AACrB,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,eAAW,aAAa,OAAO;AAC7B,UAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C;MACF;AACA,aAAQ,UAA+B,EAAE;IAC3C;EACF;AAEA,SAAO,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AACjE;AAEA,eAAsB,kCAAkC,eAA8B,QAAgB;AACpG,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,cAAc,IAAI;AAC9D,QAAM,gBAAgB,MAAM,kCAAkC,QAAQ,uBAAuB,MAAM,GAAG;IACpG,YAAY,CAAC,mCAAkC;GAChD;AACD,MAAI,cAAc,WAAW,cAAc,SAAS,SAAS,GAAG;AAC9D,eAAW,mCAAmC,mBAAmB,cAAc,QAAQ,CAAC,EAAE;EAC5F;AACF","debugId":"61aa7e55-919b-5f8e-8f56-c90b9e815366"}

package/dist/cli-bundle/chunks/{chunk-KNGVP5WJ.js → chunk-KDX6VC3P.js}

@@ -2,14 +2,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]="57f95f52-98be-5c1f-b45f-c58fefd14928")}catch(e){}}();
 import {
   nowIso
-} from "./chunk-B2KZGPM2.js";
+} from "./chunk-PW7C262O.js";
 import {
   EXIT_CODE,
   PmCliError,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-X4IZKYHP.js";
+} from "./chunk-5JF76OJF.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -123,6 +123,6 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-KNGVP5WJ.js.map
+//# sourceMappingURL=chunk-KDX6VC3P.js.map
 
 //# debugId=57f95f52-98be-5c1f-b45f-c58fefd14928

package/dist/cli-bundle/chunks/{chunk-TNPBPNII.js → chunk-KTVXLI54.js}

@@ -1,21 +1,21 @@
 import {
   readHistoryEntries
-} from "./chunk-4CHEG6UK.js";
+} from "./chunk-EQ6N6IDR.js";
 import {
   parseLimit
-} from "./chunk-SFFVGNHC.js";
+} from "./chunk-VDVVOLR6.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-TP4DDY27.js";
+} from "./chunk-LF2VNLEZ.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-HRMHZ4RV.js";
+} from "./chunk-U3Z4OCZC.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-FHHBD7PN.js";
+} from "./chunk-SAUXUI6U.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -25,7 +25,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-UJUT6AHZ.js";
+} from "./chunk-C72IQIBT.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -182,4 +182,4 @@ async function runActivity(options, global2) {
 export {
   runActivity
 };
-//# sourceMappingURL=chunk-TNPBPNII.js.map
+//# sourceMappingURL=chunk-KTVXLI54.js.map

package/dist/cli-bundle/chunks/{chunk-TP4DDY27.js → chunk-LF2VNLEZ.js}

@@ -1,18 +1,18 @@
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-2IXCHCLM.js";
+} from "./chunk-WCWIDJII.js";
 import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-WCQZBDDH.js";
+} from "./chunk-NHRZSYAA.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-HRMHZ4RV.js";
+} from "./chunk-U3Z4OCZC.js";
 import {
   nowIso
-} from "./chunk-FHHBD7PN.js";
+} from "./chunk-SAUXUI6U.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -28,6 +28,7 @@ import {
   getItemPath,
   getLockPath,
   hasActiveOnReadHooks,
+  normalizeItemFieldType,
   orderObject,
   pathExists,
   projectAfterCommandItemSnapshot,
@@ -40,13 +41,13 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-UJUT6AHZ.js";
+} from "./chunk-C72IQIBT.js";
 
 // dist/core/extensions/item-fields.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] = "60ed024d-4341-5166-bd9e-abed9b240b11");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1d92831e-54a7-5c1f-af04-7441908e8e5a");
   } catch (e2) {
   }
 })();
@@ -62,11 +63,7 @@ function normalizeFieldType(value) {
   if (typeof value !== "string") {
     return null;
   }
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "string" || normalized === "number" || normalized === "boolean" || normalized === "array" || normalized === "object") {
-    return normalized;
-  }
-  return null;
+  return normalizeItemFieldType(value);
 }
 function cloneFieldValue(value) {
   try {
@@ -1382,4 +1379,4 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-TP4DDY27.js.map
+//# sourceMappingURL=chunk-LF2VNLEZ.js.map