@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/sdk/history-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-compact.js","sources":["sdk/history-compact.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/history-compact\n *\n * Implements the pm history compact command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createHistoryEntry } from \"../core/history/history.js\";\nimport {\n  selectHistoryCompactBulkTargets,\n  type HistoryCompactBulkCandidate,\n  type HistoryCompactBulkSkipReason,\n  type HistoryCompactScope,\n} from \"../core/history/history-compact-bulk.js\";\nimport {\n  executeHistoryRewrite,\n  writeHistoryRawWithRollback,\n} from \"../core/history/history-rewrite.js\";\nimport {\n  cloneEmptyReplayDocument,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../core/history/replay.js\";\nimport { applyHistoryPatch } from \"../core/history/projection.js\";\nimport { readHistoryEntries } from \"../core/history/read.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { lifecycleClassifierFromStatusRegistry } from \"../core/governance/metadata-coverage.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { listAllItemMetadataLight } from \"../core/store/item-store.js\";\nimport { pathExists, readFileIfExists } from \"../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nimport { readLocatedItem } from \"../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { resolveAuthor } from \"../core/shared/author.js\";\nimport type { HistoryEntry } from \"../types/index.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCompactCommandOptions {\n  /** Value that configures or reports before for this contract. */\n  before?: string;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\ntype HistoryCompactBoundaryKind = \"default\" | \"version\" | \"timestamp\";\n\ninterface HistoryCompactBoundary {\n  kind: HistoryCompactBoundaryKind;\n  raw: string | null;\n  compactCount: number;\n  retainedCount: number;\n}\n\ninterface HistoryCompactCurrentItem {\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  currentItemRawBeforeLock: string | null;\n  matchedChainBefore: boolean | null;\n}\n\n/** Documents the history compact result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCompactResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports compact boundary for this contract. */\n  compact_boundary: {\n    kind: HistoryCompactBoundaryKind;\n    before: string | null;\n    entries_compacted: number;\n    entries_retained: number;\n    first_retained_entry: number | null;\n  };\n  /** Value that configures or reports history for this contract. */\n  history: {\n    path: string;\n    entries_scanned: number;\n    entries_after: number;\n    baseline_entry_added: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  /** Value that configures or reports item for this contract. */\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\nfunction parseBeforeBoundary(\n  before: string | undefined,\n  entries: HistoryEntry[],\n): HistoryCompactBoundary {\n  if (before === undefined) {\n    return {\n      kind: \"default\",\n      raw: null,\n      compactCount: entries.length,\n      retainedCount: 0,\n    };\n  }\n\n  const raw = before.trim();\n  if (raw.length === 0) {\n    throw new PmCliError(\n      \"history-compact --before requires a non-empty value.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  if (/^\\d+$/.test(raw)) {\n    const version = Number.parseInt(raw, 10);\n    if (\n      !Number.isSafeInteger(version) ||\n      version < 1 ||\n      version > entries.length + 1\n    ) {\n      throw new PmCliError(\n        `history-compact --before version must be between 1 and ${entries.length + 1}.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const compactCount = Math.max(0, Math.min(entries.length, version - 1));\n    return {\n      kind: \"version\",\n      raw,\n      compactCount,\n      retainedCount: entries.length - compactCount,\n    };\n  }\n\n  const beforeTs = Date.parse(raw);\n  if (!Number.isFinite(beforeTs)) {\n    throw new PmCliError(\n      `Invalid history-compact --before value \"${before}\". Use a version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let compactCount = 0;\n  for (const [index, entry] of entries.entries()) {\n    const entryTs = Date.parse(entry.ts);\n    if (!Number.isFinite(entryTs)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${index + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTs >= beforeTs) {\n      break;\n    }\n    compactCount += 1;\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw,\n    compactCount,\n    retainedCount: entries.length - compactCount,\n  };\n}\n\nfunction replayHistoryAndResolveCheckpoint(\n  entries: HistoryEntry[],\n  compactCount: number,\n): {\n  checkpoint: ReplayDocument;\n  finalReplay: ReplayDocument;\n} {\n  let replay = cloneEmptyReplayDocument();\n  let checkpoint = cloneEmptyReplayDocument();\n  for (let index = 0; index < entries.length; index += 1) {\n    const entry = entries[index];\n    if (replayHash(replay) !== entry.before_hash) {\n      throw new PmCliError(\n        `history-compact detected before-hash drift at entry ${index + 1}; run pm history-repair first.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    replay = applyHistoryPatch(replay, entry.patch, index + 1, entry.op);\n    if (replayHash(replay) !== entry.after_hash) {\n      throw new PmCliError(\n        `history-compact detected after-hash drift at entry ${index + 1}; run pm history-repair first.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    if (index + 1 === compactCount) {\n      checkpoint = structuredClone(replay);\n    }\n  }\n  return {\n    checkpoint,\n    finalReplay: replay,\n  };\n}\n\nfunction reanchorRetainedEntries(\n  retainedEntries: HistoryEntry[],\n  seed: ReplayDocument,\n  retainedEntryOffset: number,\n): {\n  entries: HistoryEntry[];\n  finalReplay: ReplayDocument;\n} {\n  let replay = structuredClone(seed);\n  const rewritten: HistoryEntry[] = [];\n  for (const [index, entry] of retainedEntries.entries()) {\n    const beforeHash = replayHash(replay);\n    replay = applyHistoryPatch(\n      replay,\n      entry.patch,\n      retainedEntryOffset + index + 1,\n      entry.op,\n    );\n    rewritten.push({\n      ...entry,\n      before_hash: beforeHash,\n      after_hash: replayHash(replay),\n    });\n  }\n  return {\n    entries: rewritten,\n    finalReplay: replay,\n  };\n}\n\nasync function loadHistoryCompactCurrentItem(\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  historyEntries: HistoryEntry[],\n): Promise<HistoryCompactCurrentItem> {\n  const loadedItem = subject.located\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : null;\n  if (!loadedItem) {\n    return {\n      loadedItem: null,\n      currentItemRawBeforeLock: null,\n      matchedChainBefore: null,\n    };\n  }\n  return {\n    loadedItem,\n    currentItemRawBeforeLock: loadedItem.raw,\n    matchedChainBefore:\n      replayHash(toReplayDocument(loadedItem.document)) ===\n      historyEntries[historyEntries.length - 1]?.after_hash,\n  };\n}\n\nfunction buildHistoryCompactMessage(\n  options: HistoryCompactCommandOptions,\n  boundary: HistoryCompactBoundary,\n): string {\n  if (\n    typeof options.message === \"string\" &&\n    options.message.trim().length > 0\n  ) {\n    return options.message;\n  }\n  if (boundary.raw === null) {\n    return `history-compact compacted full stream (${boundary.compactCount} entr${\n      boundary.compactCount === 1 ? \"y\" : \"ies\"\n    }).`;\n  }\n  return `history-compact compacted ${boundary.compactCount} entr${\n    boundary.compactCount === 1 ? \"y\" : \"ies\"\n  } before ${boundary.raw}.`;\n}\n\nfunction buildHistoryCompactBaselineMessage(\n  boundary: HistoryCompactBoundary,\n): string {\n  if (boundary.raw === null) {\n    return `history-compact baseline snapshot after compacting ${boundary.compactCount} entr${\n      boundary.compactCount === 1 ? \"y\" : \"ies\"\n    }.`;\n  }\n  return `history-compact baseline snapshot before ${boundary.raw}.`;\n}\n\nfunction buildHistoryCompactEntries(params: {\n  historyEntries: HistoryEntry[];\n  boundary: HistoryCompactBoundary;\n  changed: boolean;\n  dryRun: boolean;\n  author: string;\n  options: HistoryCompactCommandOptions;\n}): {\n  rewrittenEntries: HistoryEntry[];\n  baselineEntryAdded: boolean;\n  auditEntryAdded: boolean;\n} {\n  if (!params.changed) {\n    return {\n      rewrittenEntries: params.historyEntries,\n      baselineEntryAdded: false,\n      auditEntryAdded: false,\n    };\n  }\n  const { checkpoint, finalReplay } = replayHistoryAndResolveCheckpoint(\n    params.historyEntries,\n    params.boundary.compactCount,\n  );\n  const retained = params.historyEntries.slice(params.boundary.compactCount);\n  const reanchored = reanchorRetainedEntries(\n    retained,\n    checkpoint,\n    params.boundary.compactCount,\n  );\n  const baselineEntry = createHistoryEntry({\n    nowIso: nowIso(),\n    author: params.author,\n    op: \"history_compact_baseline\",\n    before: replayToItemDocument(cloneEmptyReplayDocument()),\n    after: replayToItemDocument(checkpoint),\n    message: buildHistoryCompactBaselineMessage(params.boundary),\n  });\n  const rewrittenEntries = [baselineEntry, ...reanchored.entries];\n  if (!params.dryRun) {\n    rewrittenEntries.push(\n      createHistoryEntry({\n        nowIso: nowIso(),\n        author: params.author,\n        op: \"history_compact\",\n        before: replayToItemDocument(finalReplay),\n        after: replayToItemDocument(finalReplay),\n        message: buildHistoryCompactMessage(params.options, params.boundary),\n      }),\n    );\n  }\n  return {\n    rewrittenEntries,\n    baselineEntryAdded: true,\n    auditEntryAdded: !params.dryRun,\n  };\n}\n\nasync function applyHistoryCompactRewrite(params: {\n  pmRoot: string;\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string;\n  currentItemRawBeforeLock: string | null;\n  author: string;\n  force: boolean | undefined;\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  historyPath: string;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItemRawBeforeLock,\n    operation: \"history-compact\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.loadedItem?.document ?? null,\n    applyRewrite: async ({ historyRawUnderLock }) =>\n      writeHistoryRawWithRollback({\n        historyPath: params.historyPath,\n        nextHistoryRaw: historyEntriesToRaw(params.rewrittenEntries),\n        historyRawUnderLock,\n      }),\n    applyPostRewrite: async () =>\n      runActiveOnWriteHooks({\n        path: params.historyPath,\n        scope: \"project\",\n        op: \"history_compact:history\",\n      }),\n  });\n}\n\n/** Implements run history compact for the public runtime surface of this module. */\nexport async function runHistoryCompact(\n  id: string,\n  options: HistoryCompactCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryCompactResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveHistorySubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\n  const historyPath = subject.historyPath;\n  const historyRawBeforeLock = await readFileIfExists(historyPath);\n  if (historyRawBeforeLock === null) {\n    throw new PmCliError(\n      `No history stream exists for ${subject.id}.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const historyEntries = await readHistoryEntries(historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(\n      `No history entries exist for ${subject.id}; nothing to compact.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const chainVerification = verifyHistoryChain(historyEntries);\n  if (!chainVerification.ok) {\n    throw new PmCliError(\n      `history-compact requires a valid history chain (${chainVerification.errors.join(\", \")}). Run pm history-repair ${subject.id} first.`,\n      EXIT_CODE.CONFLICT,\n    );\n  }\n\n  const boundary = parseBeforeBoundary(options.before, historyEntries);\n  const changed = boundary.compactCount > 0;\n  const dryRun = Boolean(options.dryRun);\n  const author = resolveAuthor(options.author, settings.author_default);\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_compact_noop_before_boundary\");\n  }\n\n  const currentItem = await loadHistoryCompactCurrentItem(\n    subject,\n    settings,\n    historyEntries,\n  );\n  if (currentItem.matchedChainBefore === false) {\n    warnings.push(\"history_compact_item_chain_mismatch\");\n  }\n\n  const { rewrittenEntries, baselineEntryAdded, auditEntryAdded } =\n    buildHistoryCompactEntries({\n      historyEntries,\n      boundary,\n      changed,\n      dryRun,\n      author,\n      options,\n    });\n\n  const rewrittenVerify = verifyHistoryChain(rewrittenEntries);\n  if (!rewrittenVerify.ok) {\n    throw new PmCliError(\n      `history-compact produced an invalid rewritten chain (${rewrittenVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...(await applyHistoryCompactRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock: currentItem.currentItemRawBeforeLock,\n        author,\n        force: options.force,\n        loadedItem: currentItem.loadedItem,\n        historyPath,\n        rewrittenEntries,\n      })),\n    );\n  }\n\n  const firstRetainedEntry =\n    boundary.retainedCount > 0 ? boundary.compactCount + 1 : null;\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    compact_boundary: {\n      kind: boundary.kind,\n      before: boundary.raw,\n      entries_compacted: boundary.compactCount,\n      entries_retained: boundary.retainedCount,\n      first_retained_entry: firstRetainedEntry,\n    },\n    history: {\n      path: historyPath,\n      entries_scanned: historyEntries.length,\n      entries_after: rewrittenEntries.length,\n      baseline_entry_added: baselineEntryAdded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: rewrittenVerify.ok,\n      verify_errors: rewrittenVerify.errors,\n    },\n    item: {\n      exists: subject.located !== null,\n      path: subject.located?.itemPath ?? null,\n      matched_chain_before: currentItem.matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n\n/** Default entry floor below which a stream is treated as already compact. */\nexport const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;\n\n/** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCompactBulkCommandOptions {\n  /** Value that configures or reports ids for this contract. */\n  ids?: string[];\n  /** Value that configures or reports scope for this contract. */\n  scope?: HistoryCompactScope;\n  /** Value that configures or reports all over for this contract. */\n  allOver?: number;\n  /** Value that configures or reports min entries for this contract. */\n  minEntries?: number;\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Per-item outcome row in a bulk compaction pass. */\nexport interface HistoryCompactBulkItemResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports outcome for this contract. */\n  outcome: \"compacted\" | \"skipped\" | \"errored\";\n  /** Value that configures or reports entries before for this contract. */\n  entries_before: number;\n  /** Value that configures or reports entries after for this contract. */\n  entries_after: number | null;\n  /** Value that configures or reports skip reason for this contract. */\n  skip_reason: HistoryCompactBulkSkipReason | null;\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports error for this contract. */\n  error: string | null;\n}\n\n/** Documents the bulk history compact result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryCompactBulkResult {\n  /** Value that configures or reports bulk for this contract. */\n  bulk: true;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports mode for this contract. */\n  mode: \"ids\" | \"scan\";\n  /** Value that configures or reports scope for this contract. */\n  scope: HistoryCompactScope | null;\n  /** Value that configures or reports criteria for this contract. */\n  criteria: {\n    min_entries: number;\n    all_over: number | null;\n    policy_threshold_applied: boolean;\n  };\n  /** Value that configures or reports totals for this contract. */\n  totals: {\n    streams_considered: number;\n    selected: number;\n    items_compacted: number;\n    items_skipped: number;\n    items_errored: number;\n  };\n  /** Value that configures or reports results for this contract. */\n  results: HistoryCompactBulkItemResult[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\n/** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */\nexport function assertHistoryCompactTarget(\n  id: string | undefined,\n  bulk: { ids?: string[]; allOver?: number; scope?: HistoryCompactScope },\n): void {\n  const hasIds = bulk.ids !== undefined && bulk.ids.length > 0;\n  const hasScan = bulk.allOver !== undefined || bulk.scope !== undefined;\n  const selectorCount =\n    (id !== undefined ? 1 : 0) + (hasIds ? 1 : 0) + (hasScan ? 1 : 0);\n  if (selectorCount === 0) {\n    throw new PmCliError(\n      \"history-compact: provide an item <id>, or a bulk selector (--ids, --all-over <N>, --closed, or --all-streams).\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (id !== undefined && (hasIds || hasScan)) {\n    throw new PmCliError(\n      \"history-compact: <id> and bulk selectors (--ids/--all-over/--closed/--all-streams) are mutually exclusive; pass one item id, or use bulk mode without a positional id.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (hasIds && hasScan) {\n    throw new PmCliError(\n      \"history-compact: --ids is mutually exclusive with --all-over/--closed/--all-streams; pass an explicit id list or a scan selector, not both.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction countHistoryStreamEntries(raw: string): number {\n  let count = 0;\n  for (const line of raw.split(/\\r?\\n/)) {\n    if (line.trim().length > 0) {\n      count += 1;\n    }\n  }\n  return count;\n}\n\nasync function collectHistoryCompactBulkCandidates(params: {\n  pmRoot: string;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeToFolder: Record<string, string>;\n}): Promise<{\n  candidates: HistoryCompactBulkCandidate[];\n  preselectionErrors: HistoryCompactBulkItemResult[];\n}> {\n  const statusRegistry = resolveRuntimeStatusRegistry(params.settings.schema);\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const items = await listAllItemMetadataLight(\n    params.pmRoot,\n    params.settings.item_format,\n    params.typeToFolder,\n    undefined,\n    params.settings.schema,\n  );\n  const bucketById = new Map(\n    items.map((item) => [item.id, classifier.classify(item.status)] as const),\n  );\n  const historyDir = path.join(params.pmRoot, \"history\");\n  const candidates: HistoryCompactBulkCandidate[] = [];\n  const preselectionErrors: HistoryCompactBulkItemResult[] = [];\n  if (!(await pathExists(historyDir))) {\n    return { candidates, preselectionErrors };\n  }\n  const historyFiles = (await fs.readdir(historyDir))\n    .filter((entry) => entry.endsWith(\".jsonl\"))\n    .sort((left, right) => left.localeCompare(right));\n  for (const fileName of historyFiles) {\n    const historyPath = path.join(historyDir, fileName);\n    const id = fileName.slice(0, -\".jsonl\".length);\n    try {\n      const raw = await fs.readFile(historyPath, \"utf8\");\n      await runActiveOnReadHooks({ path: historyPath, scope: \"project\" });\n      candidates.push({\n        id,\n        entries: countHistoryStreamEntries(raw),\n        bucket: bucketById.get(id) ?? null,\n      });\n    } catch (error) {\n      preselectionErrors.push({\n        id,\n        outcome: \"errored\",\n        entries_before: 0,\n        entries_after: null,\n        skip_reason: null,\n        changed: false,\n        /* c8 ignore next -- non-Error throws are normalized in defensive fallback. */\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return { candidates, preselectionErrors };\n}\n\nasync function runHistoryCompactBulkRow(params: {\n  row: ReturnType<typeof selectHistoryCompactBulkTargets>[number];\n  options: HistoryCompactBulkCommandOptions;\n  dryRun: boolean;\n  global: GlobalOptions;\n}): Promise<{\n  result: HistoryCompactBulkItemResult;\n  selected: boolean;\n  compacted: boolean;\n  errored: boolean;\n}> {\n  if (!params.row.selected) {\n    return {\n      selected: false,\n      compacted: false,\n      errored: false,\n      result: {\n        id: params.row.id,\n        outcome: \"skipped\",\n        entries_before: params.row.entries,\n        entries_after: null,\n        skip_reason: params.row.skip_reason,\n        changed: false,\n        error: null,\n      },\n    };\n  }\n  try {\n    const result = await runHistoryCompact(\n      params.row.id,\n      {\n        dryRun: params.dryRun,\n        author: params.options.author,\n        message: params.options.message,\n        force: params.options.force,\n      },\n      params.global,\n    );\n    return {\n      selected: true,\n      compacted: true,\n      errored: false,\n      result: {\n        id: params.row.id,\n        outcome: \"compacted\",\n        entries_before: params.row.entries,\n        entries_after: result.history.entries_after,\n        skip_reason: null,\n        changed: result.changed,\n        error: null,\n      },\n    };\n  } catch (error) {\n    return {\n      selected: true,\n      compacted: false,\n      errored: true,\n      result: {\n        id: params.row.id,\n        outcome: \"errored\",\n        entries_before: params.row.entries,\n        entries_after: null,\n        skip_reason: null,\n        changed: false,\n        /* c8 ignore next -- non-Error throws are normalized in defensive fallback. */\n        error: error instanceof Error ? error.message : String(error),\n      },\n    };\n  }\n}\n\n/**\n * Bulk history compaction: compact every history stream matching the requested\n * selection (explicit `--ids`, a `--scope` lifecycle filter, and/or an\n * `--all-over <N>` entry threshold) in one audited pass. Each selected stream is\n * compacted with the same single-item logic ({@link runHistoryCompact}); one\n * failing stream never aborts the rest, and the caller decides the exit code\n * from `totals.items_errored`.\n *\n * When `history.compact_policy` is enabled and no explicit `--all-over` is\n * given, the policy's `max_entries` is used as the scan threshold so the\n * configured policy drives the sweep.\n */\nexport async function runHistoryCompactBulk(\n  options: HistoryCompactBulkCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryCompactBulkResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const { candidates, preselectionErrors } =\n    await collectHistoryCompactBulkCandidates({\n      pmRoot,\n      settings,\n      typeToFolder: typeRegistry.type_to_folder,\n    });\n\n  const mode: \"ids\" | \"scan\" =\n    options.ids !== undefined && options.ids.length > 0 ? \"ids\" : \"scan\";\n  const minEntries =\n    options.minEntries ?? HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES;\n  const policy = settings.history.compact_policy;\n  const policyThresholdApplied =\n    mode === \"scan\" && options.allOver === undefined && policy.enabled;\n  const allOver =\n    options.allOver ??\n    (policyThresholdApplied ? policy.max_entries : undefined);\n\n  const selection = selectHistoryCompactBulkTargets(candidates, {\n    ids: options.ids,\n    scope: options.scope,\n    minEntries,\n    allOver,\n  });\n\n  const dryRun = Boolean(options.dryRun);\n  const results: HistoryCompactBulkItemResult[] = [...preselectionErrors];\n  const totals = {\n    streams_considered: candidates.length + preselectionErrors.length,\n    selected: 0,\n    items_compacted: 0,\n    items_skipped: 0,\n    items_errored: preselectionErrors.length,\n  };\n  for (const row of selection) {\n    const outcome = await runHistoryCompactBulkRow({\n      row,\n      options,\n      dryRun,\n      global,\n    });\n    results.push(outcome.result);\n    if (!outcome.selected) {\n      totals.items_skipped += 1;\n      continue;\n    }\n    totals.selected += 1;\n    if (outcome.compacted) {\n      totals.items_compacted += 1;\n    }\n    if (outcome.errored) {\n      totals.items_errored += 1;\n    }\n  }\n\n  return {\n    bulk: true,\n    dry_run: dryRun,\n    mode,\n    scope: options.scope ?? null,\n    criteria: {\n      min_entries: minEntries,\n      all_over: allOver ?? null,\n      policy_threshold_applied: policyThresholdApplied,\n    },\n    totals,\n    results,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,+BAA+B,GAIhC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqE5D,SAAS,mBAAmB,CAC1B,MAA0B,EAC1B,OAAuB;IAEvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,IAAI;YACT,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,UAAU,CAClB,sDAAsD,EACtD,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;YAC9B,OAAO,GAAG,CAAC;YACX,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAC5B,CAAC;YACD,MAAM,IAAI,UAAU,CAClB,0DAA0D,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,EAC/E,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO;YACL,IAAI,EAAE,SAAS;YACf,GAAG;YACH,YAAY;YACZ,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,YAAY;SAC7C,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,UAAU,CAClB,2CAA2C,MAAM,2CAA2C,EAC5F,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAClB,6DAA6D,KAAK,GAAG,CAAC,GAAG,EACzE,SAAS,CAAC,eAAe,CAC1B,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACxB,MAAM;QACR,CAAC;QACD,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,GAAG;QACH,YAAY;QACZ,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,YAAY;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,OAAuB,EACvB,YAAoB;IAKpB,IAAI,MAAM,GAAG,wBAAwB,EAAE,CAAC;IACxC,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,IAAI,UAAU,CAClB,uDAAuD,KAAK,GAAG,CAAC,gCAAgC,EAChG,SAAS,CAAC,QAAQ,CACnB,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,IAAI,UAAU,CAClB,sDAAsD,KAAK,GAAG,CAAC,gCAAgC,EAC/F,SAAS,CAAC,QAAQ,CACnB,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,KAAK,YAAY,EAAE,CAAC;YAC/B,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO;QACL,UAAU;QACV,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,eAA+B,EAC/B,IAAoB,EACpB,mBAA2B;IAK3B,IAAI,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,GAAG,iBAAiB,CACxB,MAAM,EACN,KAAK,CAAC,KAAK,EACX,mBAAmB,GAAG,KAAK,GAAG,CAAC,EAC/B,KAAK,CAAC,EAAE,CACT,CAAC;QACF,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,KAAK;YACR,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,OAA0D,EAC1D,QAAkD,EAClD,cAA8B;IAE9B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO;QAChC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC;IACT,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,wBAAwB,EAAE,IAAI;YAC9B,kBAAkB,EAAE,IAAI;SACzB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,UAAU;QACV,wBAAwB,EAAE,UAAU,CAAC,GAAG;QACxC,kBAAkB,EAChB,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjD,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,OAAqC,EACrC,QAAgC;IAEhC,IACE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EACjC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,0CAA0C,QAAQ,CAAC,YAAY,QACpE,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KACtC,IAAI,CAAC;IACP,CAAC;IACD,OAAO,6BAA6B,QAAQ,CAAC,YAAY,QACvD,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KACtC,WAAW,QAAQ,CAAC,GAAG,GAAG,CAAC;AAC7B,CAAC;AAED,SAAS,kCAAkC,CACzC,QAAgC;IAEhC,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,sDAAsD,QAAQ,CAAC,YAAY,QAChF,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KACtC,GAAG,CAAC;IACN,CAAC;IACD,OAAO,4CAA4C,QAAQ,CAAC,GAAG,GAAG,CAAC;AACrE,CAAC;AAED,SAAS,0BAA0B,CAAC,MAOnC;IAKC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,gBAAgB,EAAE,MAAM,CAAC,cAAc;YACvC,kBAAkB,EAAE,KAAK;YACzB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,iCAAiC,CACnE,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,QAAQ,CAAC,YAAY,CAC7B,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,uBAAuB,CACxC,QAAQ,EACR,UAAU,EACV,MAAM,CAAC,QAAQ,CAAC,YAAY,CAC7B,CAAC;IACF,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,EAAE,EAAE,0BAA0B;QAC9B,MAAM,EAAE,oBAAoB,CAAC,wBAAwB,EAAE,CAAC;QACxD,KAAK,EAAE,oBAAoB,CAAC,UAAU,CAAC;QACvC,OAAO,EAAE,kCAAkC,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC7D,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,CAAC,aAAa,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,gBAAgB,CAAC,IAAI,CACnB,kBAAkB,CAAC;YACjB,MAAM,EAAE,MAAM,EAAE;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,EAAE,EAAE,iBAAiB;YACrB,MAAM,EAAE,oBAAoB,CAAC,WAAW,CAAC;YACzC,KAAK,EAAE,oBAAoB,CAAC,WAAW,CAAC;YACxC,OAAO,EAAE,0BAA0B,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;SACrE,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,gBAAgB;QAChB,kBAAkB,EAAE,IAAI;QACxB,eAAe,EAAE,CAAC,MAAM,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,MAYzC;IACC,OAAO,qBAAqB,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;QACzD,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,IAAI,IAAI;QACjD,YAAY,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAC9C,2BAA2B,CAAC;YAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC5D,mBAAmB;SACpB,CAAC;QACJ,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAC3B,qBAAqB,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,KAAK,EAAE,SAAS;YAChB,EAAE,EAAE,yBAAyB;SAC9B,CAAC;KACL,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAU,EACV,OAAqC,EACrC,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,iCAAiC,MAAM,sBAAsB,EAC7D,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,CAC1C,QAAQ,EACR,+BAA+B,EAAE,CAClC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,qBAAqB,CACzC,MAAM,EACN,EAAE,EACF,QAAQ,EACR,YAAY,CAAC,cAAc,CAC5B,CAAC;IACF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,MAAM,oBAAoB,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACjE,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAClB,gCAAgC,OAAO,CAAC,EAAE,GAAG,EAC7C,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAClB,gCAAgC,OAAO,CAAC,EAAE,uBAAuB,EACjE,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAC7D,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAClB,mDAAmD,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,OAAO,CAAC,EAAE,SAAS,EACrI,SAAS,CAAC,QAAQ,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,6BAA6B,CACrD,OAAO,EACP,QAAQ,EACR,cAAc,CACf,CAAC;IACF,IAAI,WAAW,CAAC,kBAAkB,KAAK,KAAK,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAC7D,0BAA0B,CAAC;QACzB,cAAc;QACd,QAAQ;QACR,OAAO;QACP,MAAM;QACN,MAAM;QACN,OAAO;KACR,CAAC,CAAC;IAEL,MAAM,eAAe,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,wDAAwD,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAC7F,SAAS,CAAC,eAAe,CAC1B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,GAAG,CAAC,MAAM,0BAA0B,CAAC;YACnC,MAAM;YACN,OAAO;YACP,QAAQ;YACR,YAAY;YACZ,oBAAoB;YACpB,wBAAwB,EAAE,WAAW,CAAC,wBAAwB;YAC9D,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,WAAW;YACX,gBAAgB;SACjB,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GACtB,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,MAAM;QACf,OAAO;QACP,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,GAAG;YACpB,iBAAiB,EAAE,QAAQ,CAAC,YAAY;YACxC,gBAAgB,EAAE,QAAQ,CAAC,aAAa;YACxC,oBAAoB,EAAE,kBAAkB;SACzC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,eAAe,EAAE,cAAc,CAAC,MAAM;YACtC,aAAa,EAAE,gBAAgB,CAAC,MAAM;YACtC,oBAAoB,EAAE,kBAAkB;YACxC,iBAAiB,EAAE,eAAe;YAClC,SAAS,EAAE,eAAe,CAAC,EAAE;YAC7B,aAAa,EAAE,eAAe,CAAC,MAAM;SACtC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;YAChC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI;YACvC,oBAAoB,EAAE,WAAW,CAAC,kBAAkB;SACrD;QACD,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B;QACD,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC;AAsE1D,0OAA0O;AAC1O,MAAM,UAAU,0BAA0B,CACxC,EAAsB,EACtB,IAAuE;IAEvE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IACvE,MAAM,aAAa,GACjB,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAClB,gHAAgH,EAChH,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,UAAU,CAClB,wKAAwK,EACxK,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,6IAA6I,EAC7I,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAW;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,mCAAmC,CAAC,MAIlD;IAIC,MAAM,cAAc,GAAG,4BAA4B,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAC1C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,CAAC,WAAW,EAC3B,MAAM,CAAC,YAAY,EACnB,SAAS,EACT,MAAM,CAAC,QAAQ,CAAC,MAAM,CACvB,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAU,CAAC,CAC1E,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,UAAU,GAAkC,EAAE,CAAC;IACrD,MAAM,kBAAkB,GAAmC,EAAE,CAAC;IAC9D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACpE,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE;gBACF,OAAO,EAAE,yBAAyB,CAAC,GAAG,CAAC;gBACvC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kBAAkB,CAAC,IAAI,CAAC;gBACtB,EAAE;gBACF,OAAO,EAAE,SAAS;gBAClB,cAAc,EAAE,CAAC;gBACjB,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,KAAK;gBACd,8EAA8E;gBAC9E,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,MAKvC;IAMC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;gBACjB,OAAO,EAAE,SAAS;gBAClB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;gBAClC,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW;gBACnC,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI;aACZ;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,MAAM,CAAC,GAAG,CAAC,EAAE,EACb;YACE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;YAC/B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;SAC5B,EACD,MAAM,CAAC,MAAM,CACd,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;gBACjB,OAAO,EAAE,WAAW;gBACpB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;gBAClC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa;gBAC3C,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,IAAI;aACZ;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;gBACjB,OAAO,EAAE,SAAS;gBAClB,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO;gBAClC,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,KAAK;gBACd,8EAA8E;gBAC9E,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAyC,EACzC,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,iCAAiC,MAAM,sBAAsB,EAC7D,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,CAC1C,QAAQ,EACR,+BAA+B,EAAE,CAClC,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,GACtC,MAAM,mCAAmC,CAAC;QACxC,MAAM;QACN,QAAQ;QACR,YAAY,EAAE,YAAY,CAAC,cAAc;KAC1C,CAAC,CAAC;IAEL,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,wCAAwC,CAAC;IACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/C,MAAM,sBAAsB,GAC1B,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;IACrE,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;QACf,CAAC,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE5D,MAAM,SAAS,GAAG,+BAA+B,CAAC,UAAU,EAAE;QAC5D,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU;QACV,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAmC,CAAC,GAAG,kBAAkB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG;QACb,kBAAkB,EAAE,UAAU,CAAC,MAAM,GAAG,kBAAkB,CAAC,MAAM;QACjE,QAAQ,EAAE,CAAC;QACX,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,kBAAkB,CAAC,MAAM;KACzC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC;YAC7C,GAAG;YACH,OAAO;YACP,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,MAAM;QACf,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,QAAQ,EAAE;YACR,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,OAAO,IAAI,IAAI;YACzB,wBAAwB,EAAE,sBAAsB;SACjD;QACD,MAAM;QACN,OAAO;QACP,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC","debugId":"a58bdcf8-a01b-55b7-ac6e-57432c9422bf"}

package/dist/sdk/history-mcp.d.ts

@@ -0,0 +1,17 @@
+import type { GlobalOptions } from "../core/shared/command-types.js";
+import { type HistoryCompactBulkResult, type HistoryCompactResult } from "./history-compact.js";
+/** Minimal action context required by MCP history maintenance adapters. */
+export interface HistoryMcpActionContext {
+    /** Optional positional item id used by single-stream mode. */
+    id?: string;
+    /** Alias-rich MCP options normalized by the selected history adapter. */
+    options: Record<string, unknown>;
+    /** Force flag forwarded to integrity-sensitive maintenance engines. */
+    force?: boolean;
+    /** Global tracker and output controls shared with native command handlers. */
+    global: GlobalOptions;
+}
+/** Dispatch single-stream or all-stream history repair from an MCP payload. */
+export declare function runMcpHistoryRepairAction(context: HistoryMcpActionContext): Promise<unknown>;
+/** Dispatch single or bounded bulk history compaction from an MCP payload. */
+export declare function runMcpHistoryCompactAction(context: HistoryMcpActionContext): Promise<HistoryCompactResult | HistoryCompactBulkResult>;

package/dist/sdk/history-mcp.js

@@ -0,0 +1,68 @@
+
+!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]="00e24636-c03a-5c14-a9cd-bb67ef4caf6d")}catch(e){}}();
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { assertHistoryCompactTarget, runHistoryCompact, runHistoryCompactBulk, } from "./history-compact.js";
+import { assertHistoryRepairTarget, runHistoryRepair, runHistoryRepairAll, } from "./history-repair.js";
+import { parseRuntimeInteger, readRuntimeString } from "./runtime-input.js";
+/** Dispatch single-stream or all-stream history repair from an MCP payload. */
+export function runMcpHistoryRepairAction(context) {
+    const repairAll = context.options.all === true;
+    const repairId = context.id ?? readRuntimeString(context.options, "id");
+    assertHistoryRepairTarget(repairId, repairAll);
+    return repairAll
+        ? runHistoryRepairAll(context.options, context.global)
+        : runHistoryRepair(repairId, context.options, context.global);
+}
+/** Dispatch single or bounded bulk history compaction from an MCP payload. */
+export function runMcpHistoryCompactAction(context) {
+    const idsSource = context.options.ids;
+    const ids = Array.isArray(idsSource)
+        ? idsSource.map(String).filter((value) => value.trim().length > 0)
+        : typeof idsSource === "string"
+            ? idsSource
+                .split(",")
+                .map((value) => value.trim())
+                .filter(Boolean)
+            : undefined;
+    const allOver = parseRuntimeInteger(context.options.allOver ?? context.options.all_over, "history-compact allOver");
+    const minEntries = parseRuntimeInteger(context.options.minEntries ?? context.options.min_entries, "history-compact minEntries");
+    const explicitScope = readRuntimeString(context.options, "scope");
+    const requestedScopes = [];
+    if (context.options.closed === true)
+        requestedScopes.push("closed");
+    if (context.options.allStreams === true ||
+        context.options.all_streams === true) {
+        requestedScopes.push("all-streams");
+    }
+    if (explicitScope === "closed" || explicitScope === "all-streams") {
+        requestedScopes.push(explicitScope);
+    }
+    const distinctScopes = [...new Set(requestedScopes)];
+    if (distinctScopes.length > 1) {
+        throw new PmCliError("history-compact: closed and all-streams scopes are mutually exclusive.", EXIT_CODE.USAGE);
+    }
+    const scope = distinctScopes[0];
+    assertHistoryCompactTarget(context.id, { ids, allOver, scope });
+    if (context.id !== undefined) {
+        return runHistoryCompact(context.id, {
+            before: readRuntimeString(context.options, "before"),
+            dryRun: context.options.dryRun === true || context.options.dry_run === true,
+            author: readRuntimeString(context.options, "author"),
+            message: readRuntimeString(context.options, "message"),
+            force: context.force,
+        }, context.global);
+    }
+    return runHistoryCompactBulk({
+        ids,
+        scope,
+        allOver,
+        minEntries,
+        dryRun: context.options.dryRun === true || context.options.dry_run === true,
+        author: readRuntimeString(context.options, "author"),
+        message: readRuntimeString(context.options, "message"),
+        force: context.force,
+    }, context.global);
+}
+//# sourceMappingURL=history-mcp.js.map
+//# debugId=00e24636-c03a-5c14-a9cd-bb67ef4caf6d

package/dist/sdk/history-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-mcp.js","sources":["sdk/history-mcp.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/history-mcp\n *\n * Adapts MCP's alias-rich untyped option bags to the typed public history\n * maintenance engines without duplicating their selection or integrity policy.\n */\nimport type { HistoryCompactScope } from \"../core/history/history-compact-bulk.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport {\n  assertHistoryCompactTarget,\n  runHistoryCompact,\n  runHistoryCompactBulk,\n  type HistoryCompactBulkResult,\n  type HistoryCompactResult,\n} from \"./history-compact.js\";\nimport {\n  assertHistoryRepairTarget,\n  runHistoryRepair,\n  runHistoryRepairAll,\n} from \"./history-repair.js\";\nimport { parseRuntimeInteger, readRuntimeString } from \"./runtime-input.js\";\n\n/** Minimal action context required by MCP history maintenance adapters. */\nexport interface HistoryMcpActionContext {\n  /** Optional positional item id used by single-stream mode. */\n  id?: string;\n  /** Alias-rich MCP options normalized by the selected history adapter. */\n  options: Record<string, unknown>;\n  /** Force flag forwarded to integrity-sensitive maintenance engines. */\n  force?: boolean;\n  /** Global tracker and output controls shared with native command handlers. */\n  global: GlobalOptions;\n}\n\n/** Dispatch single-stream or all-stream history repair from an MCP payload. */\nexport function runMcpHistoryRepairAction(\n  context: HistoryMcpActionContext,\n): Promise<unknown> {\n  const repairAll = context.options.all === true;\n  const repairId = context.id ?? readRuntimeString(context.options, \"id\");\n  assertHistoryRepairTarget(repairId, repairAll);\n  return repairAll\n    ? runHistoryRepairAll(context.options, context.global)\n    : runHistoryRepair(repairId as string, context.options, context.global);\n}\n\n/** Dispatch single or bounded bulk history compaction from an MCP payload. */\nexport function runMcpHistoryCompactAction(\n  context: HistoryMcpActionContext,\n): Promise<HistoryCompactResult | HistoryCompactBulkResult> {\n  const idsSource = context.options.ids;\n  const ids = Array.isArray(idsSource)\n    ? idsSource.map(String).filter((value) => value.trim().length > 0)\n    : typeof idsSource === \"string\"\n      ? idsSource\n          .split(\",\")\n          .map((value) => value.trim())\n          .filter(Boolean)\n      : undefined;\n  const allOver = parseRuntimeInteger(\n    context.options.allOver ?? context.options.all_over,\n    \"history-compact allOver\",\n  );\n  const minEntries = parseRuntimeInteger(\n    context.options.minEntries ?? context.options.min_entries,\n    \"history-compact minEntries\",\n  );\n  const explicitScope = readRuntimeString(context.options, \"scope\");\n  const requestedScopes: HistoryCompactScope[] = [];\n  if (context.options.closed === true) requestedScopes.push(\"closed\");\n  if (\n    context.options.allStreams === true ||\n    context.options.all_streams === true\n  ) {\n    requestedScopes.push(\"all-streams\");\n  }\n  if (explicitScope === \"closed\" || explicitScope === \"all-streams\") {\n    requestedScopes.push(explicitScope);\n  }\n  const distinctScopes = [...new Set(requestedScopes)];\n  if (distinctScopes.length > 1) {\n    throw new PmCliError(\n      \"history-compact: closed and all-streams scopes are mutually exclusive.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  const scope = distinctScopes[0];\n  assertHistoryCompactTarget(context.id, { ids, allOver, scope });\n  if (context.id !== undefined) {\n    return runHistoryCompact(\n      context.id,\n      {\n        before: readRuntimeString(context.options, \"before\"),\n        dryRun:\n          context.options.dryRun === true || context.options.dry_run === true,\n        author: readRuntimeString(context.options, \"author\"),\n        message: readRuntimeString(context.options, \"message\"),\n        force: context.force,\n      },\n      context.global,\n    );\n  }\n  return runHistoryCompactBulk(\n    {\n      ids,\n      scope,\n      allOver,\n      minEntries,\n      dryRun:\n        context.options.dryRun === true || context.options.dry_run === true,\n      author: readRuntimeString(context.options, \"author\"),\n      message: readRuntimeString(context.options, \"message\"),\n      force: context.force,\n    },\n    context.global,\n  );\n}\n"],"names":[],"mappings":"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","debugId":"00e24636-c03a-5c14-a9cd-bb67ef4caf6d"}

package/dist/sdk/history-read.d.ts

@@ -0,0 +1,31 @@
+import { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, replayHistoryToTarget, resolveHistoryTarget, type ResolvedHistoryTarget } from "../core/history/projection.js";
+import { readHistoryEntries } from "../core/history/read.js";
+import type { ItemDocument } from "../types/index.js";
+/** Workspace resolution controls accepted by {@link getItemAt}. */
+export interface GetItemAtOptions {
+    /** Explicit tracker root, equivalent to the CLI global `--path`. */
+    pmRoot?: string;
+    /** Working directory used when discovering the nearest tracker. */
+    cwd?: string;
+}
+/** Verified historical item projection returned by {@link getItemAt}. */
+export interface GetItemAtResult {
+    /** Reconstructed canonical item document at the selected version. */
+    document: ItemDocument;
+    /** Always true, preventing consumers from confusing this with current state. */
+    reconstructed: true;
+    /** One-based version included in the projection. */
+    as_of_version: number;
+    /** Timestamp of the final included history entry. */
+    as_of_timestamp: string;
+    /** Normalized target resolution metadata shared with restore. */
+    target: ResolvedHistoryTarget;
+    /** Total number of entries currently available in the stream. */
+    history_length: number;
+}
+/**
+ * Reconstruct one item at a one-based version or ISO timestamp without locks,
+ * item writes, history writes, or derived-index mutations.
+ */
+export declare function getItemAt(id: string, target: string, options?: GetItemAtOptions): Promise<GetItemAtResult>;
+export { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, readHistoryEntries, replayHistoryToTarget, resolveHistoryTarget, };

package/dist/sdk/history-read.js

@@ -0,0 +1,58 @@
+/**
+ * @module sdk/history-read
+ *
+ * Public, mutation-free item time-travel reads backed by the same verified
+ * replay kernel used by `pm restore`. Integrators can use this primitive as a
+ * building block for provenance browsers, immutable records, and VCS-like
+ * systems without acquiring locks or appending history.
+ */
+
+!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]="0f4accd8-bd71-5eaa-b84c-02cacf15b7bf")}catch(e){}}();
+import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
+import { pathExists } from "../core/fs/fs-utils.js";
+import { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, replayHistoryToTarget, resolveHistoryTarget, } from "../core/history/projection.js";
+import { readHistoryEntries } from "../core/history/read.js";
+import { replayToCanonicalItemDocument } from "../core/history/replay.js";
+import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
+import { readSettings } from "../core/store/settings.js";
+import { resolveHistorySubject } from "./history-redact.js";
+/**
+ * Reconstruct one item at a one-based version or ISO timestamp without locks,
+ * item writes, history writes, or derived-index mutations.
+ */
+export async function getItemAt(id, target, options = {}) {
+    const pmRoot = resolvePmRoot(options.cwd ?? process.cwd(), options.pmRoot);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+    const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);
+    const history = await readHistoryEntries(subject.historyPath, subject.id);
+    if (history.length === 0) {
+        throw new PmCliError(`No history exists for ${subject.id}; point-in-time reads are unavailable.`, EXIT_CODE.NOT_FOUND);
+    }
+    const resolvedTarget = resolveHistoryTarget(target, history);
+    const replay = ensureMaterializedHistoryTarget(replayHistoryToTarget(history, resolvedTarget.historyIndex), resolvedTarget);
+    const document = replayToCanonicalItemDocument(replay, {
+        schema: settings.schema,
+    });
+    if (document.metadata.id !== subject.id) {
+        throw new PmCliError(`History target resolved to item ${document.metadata.id}, expected ${subject.id}.`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const targetEntry = history[resolvedTarget.historyIndex];
+    return {
+        document,
+        reconstructed: true,
+        as_of_version: resolvedTarget.historyIndex + 1,
+        as_of_timestamp: targetEntry.ts,
+        target: resolvedTarget,
+        history_length: history.length,
+    };
+}
+export { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, readHistoryEntries, replayHistoryToTarget, resolveHistoryTarget, };
+//# sourceMappingURL=history-read.js.map
+//# debugId=0f4accd8-bd71-5eaa-b84c-02cacf15b7bf

package/dist/sdk/history-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-read.js","sources":["sdk/history-read.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/history-read\n *\n * Public, mutation-free item time-travel reads backed by the same verified\n * replay kernel used by `pm restore`. Integrators can use this primitive as a\n * building block for provenance browsers, immutable records, and VCS-like\n * systems without acquiring locks or appending history.\n */\nimport { getActiveExtensionRegistrations } from \"../core/extensions/index.js\";\nimport { pathExists } from \"../core/fs/fs-utils.js\";\nimport {\n  applyHistoryPatch,\n  ensureMaterializedHistoryTarget,\n  extractPatchFailureContext,\n  replayHistoryToTarget,\n  resolveHistoryTarget,\n  type ResolvedHistoryTarget,\n} from \"../core/history/projection.js\";\nimport { readHistoryEntries } from \"../core/history/read.js\";\nimport { replayToCanonicalItemDocument } from \"../core/history/replay.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport type { ItemDocument } from \"../types/index.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/** Workspace resolution controls accepted by {@link getItemAt}. */\nexport interface GetItemAtOptions {\n  /** Explicit tracker root, equivalent to the CLI global `--path`. */\n  pmRoot?: string;\n  /** Working directory used when discovering the nearest tracker. */\n  cwd?: string;\n}\n\n/** Verified historical item projection returned by {@link getItemAt}. */\nexport interface GetItemAtResult {\n  /** Reconstructed canonical item document at the selected version. */\n  document: ItemDocument;\n  /** Always true, preventing consumers from confusing this with current state. */\n  reconstructed: true;\n  /** One-based version included in the projection. */\n  as_of_version: number;\n  /** Timestamp of the final included history entry. */\n  as_of_timestamp: string;\n  /** Normalized target resolution metadata shared with restore. */\n  target: ResolvedHistoryTarget;\n  /** Total number of entries currently available in the stream. */\n  history_length: number;\n}\n\n/**\n * Reconstruct one item at a one-based version or ISO timestamp without locks,\n * item writes, history writes, or derived-index mutations.\n */\nexport async function getItemAt(\n  id: string,\n  target: string,\n  options: GetItemAtOptions = {},\n): Promise<GetItemAtResult> {\n  const pmRoot = resolvePmRoot(options.cwd ?? process.cwd(), options.pmRoot);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveHistorySubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\n  const history = await readHistoryEntries(subject.historyPath, subject.id);\n  if (history.length === 0) {\n    throw new PmCliError(\n      `No history exists for ${subject.id}; point-in-time reads are unavailable.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const resolvedTarget = resolveHistoryTarget(target, history);\n  const replay = ensureMaterializedHistoryTarget(\n    replayHistoryToTarget(history, resolvedTarget.historyIndex),\n    resolvedTarget,\n  );\n  const document = replayToCanonicalItemDocument(replay, {\n    schema: settings.schema,\n  });\n  if (document.metadata.id !== subject.id) {\n    throw new PmCliError(\n      `History target resolved to item ${document.metadata.id}, expected ${subject.id}.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  const targetEntry = history[resolvedTarget.historyIndex];\n  return {\n    document,\n    reconstructed: true,\n    as_of_version: resolvedTarget.historyIndex + 1,\n    as_of_timestamp: targetEntry.ts,\n    target: resolvedTarget,\n    history_length: history.length,\n  };\n}\n\nexport {\n  applyHistoryPatch,\n  ensureMaterializedHistoryTarget,\n  extractPatchFailureContext,\n  readHistoryEntries,\n  replayHistoryToTarget,\n  resolveHistoryTarget,\n};\n"],"names":[],"mappings":"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","debugId":"0f4accd8-bd71-5eaa-b84c-02cacf15b7bf"}

package/dist/sdk/history-redact.d.ts

@@ -0,0 +1,120 @@
+import { type ReplayDocument } from "../core/history/replay.js";
+import type { GlobalOptions } from "../core/shared/command-types.js";
+import { locateItem } from "../core/store/item-store.js";
+import { readSettings } from "../core/store/settings.js";
+/** Documents the history redact command options payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRedactCommandOptions {
+    /** Value that configures or reports literal for this contract. */
+    literal?: string[] | string;
+    /** Value that configures or reports regex for this contract. */
+    regex?: string[] | string;
+    /** Value that configures or reports replacement for this contract. */
+    replacement?: string;
+    /** Value that configures or reports dry run for this contract. */
+    dryRun?: boolean;
+    /** Value that configures or reports author for this contract. */
+    author?: string;
+    /** Human-readable explanation suitable for logs and agent-facing output. */
+    message?: string;
+    /** Value that configures or reports force for this contract. */
+    force?: boolean;
+}
+interface RegexRule {
+    kind: "regex";
+    source: string;
+    flags: string;
+    label: string;
+}
+interface LiteralRule {
+    kind: "literal";
+    value: string;
+    label: string;
+}
+type RedactionRule = RegexRule | LiteralRule;
+/** Documents the history subject payload exchanged by command, SDK, and package integrations. */
+export interface HistorySubject {
+    /** Stable identifier used to reference this record across commands and storage. */
+    id: string;
+    /** Filesystem path used for history resolution. */
+    historyPath: string;
+    /** Value that configures or reports located for this contract. */
+    located: Awaited<ReturnType<typeof locateItem>>;
+}
+/** Documents the history redact result payload exchanged by command, SDK, and package integrations. */
+export interface HistoryRedactResult {
+    /** Stable identifier used to reference this record across commands and storage. */
+    id: string;
+    /** Value that configures or reports dry run for this contract. */
+    dry_run: boolean;
+    /** Value that configures or reports changed for this contract. */
+    changed: boolean;
+    /** Value that configures or reports patterns for this contract. */
+    patterns: {
+        literals: string[];
+        regex: string[];
+        replacement: string;
+    };
+    /** Value that configures or reports history for this contract. */
+    history: {
+        path: string;
+        entries_scanned: number;
+        entries_changed: number;
+        replacements: number;
+        hash_mismatches_before: number;
+        hash_mismatches_after: number;
+        preexisting_hash_mismatches: number;
+        audit_entry_added: boolean;
+        verify_ok: boolean;
+        verify_errors: string[];
+    };
+    /** Value that configures or reports item for this contract. */
+    item: {
+        existed_before: boolean;
+        exists_after: boolean;
+        path_before: string | null;
+        path_after: string | null;
+        changed: boolean;
+    };
+    /** Value that configures or reports warnings for this contract. */
+    warnings: string[];
+    /** ISO 8601 timestamp recording when generated occurred. */
+    generated_at: string;
+}
+declare function normalizeStringArrayInput(value: string[] | string | undefined): string[];
+declare function normalizeRegexFlags(flags: string): string;
+declare function parseRegexRule(spec: string): RegexRule;
+declare function buildRedactionRules(literalInput: string[] | string | undefined, regexInput: string[] | string | undefined): RedactionRule[];
+declare function applyLiteralRule(value: string, literal: string, replacement: string): {
+    value: string;
+    replacements: number;
+};
+declare function applyRegexRule(value: string, rule: RegexRule, replacement: string): {
+    value: string;
+    replacements: number;
+};
+declare function redactStringValue(value: string, rules: RedactionRule[], replacement: string): {
+    value: string;
+    replacements: number;
+};
+declare function redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): {
+    value: unknown;
+    replacements: number;
+};
+declare function hasItemMetadata(replay: ReplayDocument): boolean;
+/** Implements resolve history subject for the public runtime surface of this module. */
+export declare function resolveHistorySubject(pmRoot: string, id: string, settings: Awaited<ReturnType<typeof readSettings>>, typeToFolder: Record<string, string>): Promise<HistorySubject>;
+/** Implements run history redact for the public runtime surface of this module. */
+export declare function runHistoryRedact(id: string, options: HistoryRedactCommandOptions, global: GlobalOptions): Promise<HistoryRedactResult>;
+/** Public contract for test only, shared by SDK and presentation-layer consumers. */
+export declare const _testOnly: {
+    applyLiteralRule: typeof applyLiteralRule;
+    applyRegexRule: typeof applyRegexRule;
+    buildRedactionRules: typeof buildRedactionRules;
+    hasItemMetadata: typeof hasItemMetadata;
+    normalizeRegexFlags: typeof normalizeRegexFlags;
+    normalizeStringArrayInput: typeof normalizeStringArrayInput;
+    parseRegexRule: typeof parseRegexRule;
+    redactStringValue: typeof redactStringValue;
+    redactUnknownValue: typeof redactUnknownValue;
+};
+export {};