@unbrained/pm-cli 2026.7.1 → 2026.7.3

package/dist/cli-bundle/chunks/history-compact-2WRZ2WK4.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/history-compact.ts", "../../../../../../../../core/history/history-compact-bulk.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/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 { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  cloneEmptyReplayDocument,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  toReplayDocument,\n  tryApplyReplayPatch,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.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 { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { pathExists, readFileIfExists, writeFileAtomic } 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 { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/**\n * Documents the history compact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactCommandOptions {\n  before?: string;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\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\n/**\n * Documents the history compact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\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  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  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction parseBeforeBoundary(before: string | undefined, entries: HistoryEntry[]): 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(\"history-compact --before requires a non-empty value.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(raw)) {\n    const version = Number.parseInt(raw, 10);\n    if (!Number.isSafeInteger(version) || version < 1 || version > entries.length + 1) {\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 applyHistoryPatch(current: ReplayDocument, entry: HistoryEntry, entryNumber: number): ReplayDocument {\n  const result = tryApplyReplayPatch(current, entry.patch);\n  if (!result.ok) {\n    throw new PmCliError(\n      `history-compact failed to apply patch at entry ${entryNumber} (op=${entry.op}): ${\n        result.error instanceof Error ? result.error.message : String(result.error)\n      }`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  return result.document;\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, index + 1);\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(replay, entry, retainedEntryOffset + index + 1);\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\n/**\n * Implements run history compact for the public runtime surface of this module.\n */\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const historyPath = subject.historyPath;\n  const historyRawBeforeLock = await readFileIfExists(historyPath);\n  if (historyRawBeforeLock === null) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyEntries = await readHistoryEntries(historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to compact.`, EXIT_CODE.USAGE);\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 loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItem?.raw ?? null;\n  const matchedChainBefore =\n    loadedItem === null\n      ? null\n      : replayHash(toReplayDocument(loadedItem.document)) === historyEntries[historyEntries.length - 1]?.after_hash;\n  if (matchedChainBefore === false) {\n    warnings.push(\"history_compact_item_chain_mismatch\");\n  }\n\n  let rewrittenEntries: HistoryEntry[] = historyEntries;\n  let baselineEntryAdded = false;\n  let auditEntryAdded = false;\n\n  if (changed) {\n    const { checkpoint, finalReplay } = replayHistoryAndResolveCheckpoint(historyEntries, boundary.compactCount);\n    const retained = historyEntries.slice(boundary.compactCount);\n    const reanchored = reanchorRetainedEntries(retained, checkpoint, boundary.compactCount);\n    const baselineEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"history_compact_baseline\",\n      before: replayToItemDocument(cloneEmptyReplayDocument()),\n      after: replayToItemDocument(checkpoint),\n      message:\n        boundary.raw === null\n          ? `history-compact baseline snapshot after compacting ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }.`\n          : `history-compact baseline snapshot before ${boundary.raw}.`,\n    });\n    rewrittenEntries = [baselineEntry, ...reanchored.entries];\n    baselineEntryAdded = true;\n    const compactMessage =\n      typeof options.message === \"string\" && options.message.trim().length > 0\n        ? options.message\n        : boundary.raw === null\n          ? `history-compact compacted full stream (${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }).`\n          : `history-compact compacted ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            } before ${boundary.raw}.`;\n    if (!dryRun) {\n      rewrittenEntries.push(\n        createHistoryEntry({\n          nowIso: nowIso(),\n          author,\n          op: \"history_compact\",\n          before: replayToItemDocument(finalReplay),\n          after: replayToItemDocument(finalReplay),\n          message: compactMessage,\n        }),\n      );\n      auditEntryAdded = true;\n    }\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 executeHistoryRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n        operation: \"history-compact\",\n        author,\n        force: options.force,\n        itemDocument: loadedItem?.document ?? null,\n        applyRewrite: async ({ historyRawUnderLock }) => {\n          try {\n            await writeFileAtomic(historyPath, historyEntriesToRaw(rewrittenEntries));\n          } catch (error) {\n            if (historyRawUnderLock === null) {\n              await fs.rm(historyPath, { force: true });\n            } else {\n              await writeFileAtomic(historyPath, historyRawUnderLock);\n            }\n            throw error;\n          }\n        },\n        applyPostRewrite: async () =>\n          runActiveOnWriteHooks({\n            path: historyPath,\n            scope: \"project\",\n            op: \"history_compact:history\",\n          }),\n      })),\n    );\n  }\n\n  const firstRetainedEntry = 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: matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\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/**\n * Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactBulkCommandOptions {\n  ids?: string[];\n  scope?: HistoryCompactScope;\n  allOver?: number;\n  minEntries?: number;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/** Per-item outcome row in a bulk compaction pass. */\nexport interface HistoryCompactBulkItemResult {\n  id: string;\n  outcome: \"compacted\" | \"skipped\" | \"errored\";\n  entries_before: number;\n  entries_after: number | null;\n  skip_reason: HistoryCompactBulkSkipReason | null;\n  changed: boolean;\n  error: string | null;\n}\n\n/**\n * Documents the bulk history compact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactBulkResult {\n  bulk: true;\n  dry_run: boolean;\n  mode: \"ids\" | \"scan\";\n  scope: HistoryCompactScope | null;\n  criteria: {\n    min_entries: number;\n    all_over: number | null;\n    policy_threshold_applied: boolean;\n  };\n  totals: {\n    streams_considered: number;\n    selected: number;\n    items_compacted: number;\n    items_skipped: number;\n    items_errored: number;\n  };\n  results: HistoryCompactBulkItemResult[];\n  generated_at: string;\n}\n\n/**\n * Enforce the `pm history-compact` target contract shared by the CLI and MCP\n * surfaces: exactly one selection mode — a single item `<id>`, an explicit\n * `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`).\n */\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 = (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\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  const bucketById = new Map(items.map((item) => [item.id, classifier.classify(item.status)] as const));\n\n  const historyDir = path.join(pmRoot, \"history\");\n  const candidates: HistoryCompactBulkCandidate[] = [];\n  // A stream that cannot be read during enumeration is isolated as an errored\n  // row (mirroring per-stream compaction failures) rather than aborting the pass.\n  const preselectionErrors: HistoryCompactBulkItemResult[] = [];\n  if (await pathExists(historyDir)) {\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({ id, entries: countHistoryStreamEntries(raw), bucket: bucketById.get(id) ?? null });\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  }\n\n  const mode: \"ids\" | \"scan\" = options.ids !== undefined && options.ids.length > 0 ? \"ids\" : \"scan\";\n  const minEntries = options.minEntries ?? HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES;\n  const policy = settings.history.compact_policy;\n  const policyThresholdApplied = mode === \"scan\" && options.allOver === undefined && policy.enabled;\n  const allOver = options.allOver ?? (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    if (!row.selected) {\n      totals.items_skipped += 1;\n      results.push({\n        id: row.id,\n        outcome: \"skipped\",\n        entries_before: row.entries,\n        entries_after: null,\n        skip_reason: row.skip_reason,\n        changed: false,\n        error: null,\n      });\n      continue;\n    }\n    totals.selected += 1;\n    try {\n      const result = await runHistoryCompact(\n        row.id,\n        {\n          dryRun,\n          author: options.author,\n          message: options.message,\n          force: options.force,\n        },\n        global,\n      );\n      totals.items_compacted += 1;\n      results.push({\n        id: row.id,\n        outcome: \"compacted\",\n        entries_before: row.entries,\n        entries_after: result.history.entries_after,\n        skip_reason: null,\n        changed: result.changed,\n        error: null,\n      });\n    } catch (error) {\n      totals.items_errored += 1;\n      results.push({\n        id: row.id,\n        outcome: \"errored\",\n        entries_before: 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  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", "/**\n * @module core/history/history-compact-bulk\n *\n * Pure selection logic for bulk history-stream compaction. Given a set of\n * history-stream candidates (id, entry count, and lifecycle bucket of the\n * owning item) plus the requested selection criteria, this module decides which\n * streams should be compacted and which are skipped (and why).\n *\n * The module performs no filesystem access and imports no heavy runtime\n * dependencies — the command layer reads streams and item statuses, hands the\n * resolved candidates here, then executes per-item compaction on the selection\n * this module returns. Keeping selection pure makes the matrix of scope /\n * threshold / explicit-id rules trivially testable without touching disk.\n */\n\nimport type { LifecycleBucket } from \"../governance/metadata-coverage.js\";\n\n/** Bulk-compaction scope: only closed items, or every history stream. */\nexport type HistoryCompactScope = \"closed\" | \"all-streams\";\n\n/** Why a candidate stream was not selected for compaction. */\nexport type HistoryCompactBulkSkipReason = \"no_stream\" | \"already_compact\" | \"scope_mismatch\" | \"below_threshold\";\n\n/**\n * One history stream considered for bulk compaction.\n *\n * `bucket` is the lifecycle bucket of the owning item, or `null` when no item\n * matches the stream (an orphan history file). Orphan streams never satisfy a\n * `closed` scope filter but are eligible under `all-streams`.\n */\nexport interface HistoryCompactBulkCandidate {\n  id: string;\n  entries: number;\n  bucket: LifecycleBucket | null;\n}\n\n/** Selection criteria resolved from the command flags + policy defaults. */\nexport interface HistoryCompactBulkCriteria {\n  /**\n   * Explicit, ordered list of item ids to compact. When non-empty the selection\n   * runs in \"ids\" mode: scope/allOver are ignored and only the `minEntries`\n   * floor applies. Duplicates are collapsed, preserving first-seen order.\n   */\n  ids?: string[];\n  /** Lifecycle scope filter for scan mode (ignored in ids mode). */\n  scope?: HistoryCompactScope;\n  /**\n   * Streams with at most this many entries are skipped as `already_compact`\n   * (compaction collapses a stream to a 2-entry baseline+audit pair, so smaller\n   * streams gain nothing). Applies in both modes.\n   */\n  minEntries: number;\n  /**\n   * Scan mode only: when set, only streams with strictly more entries than this\n   * are selected. Streams above `minEntries` but at/below `allOver` are skipped\n   * as `below_threshold`.\n   */\n  allOver?: number;\n}\n\n/** Per-candidate selection outcome. */\nexport interface HistoryCompactBulkSelectionRow {\n  id: string;\n  entries: number;\n  selected: boolean;\n  skip_reason: HistoryCompactBulkSkipReason | null;\n}\n\nfunction selectIdsMode(\n  ids: string[],\n  byId: ReadonlyMap<string, HistoryCompactBulkCandidate>,\n  minEntries: number,\n): HistoryCompactBulkSelectionRow[] {\n  const seen = new Set<string>();\n  const rows: HistoryCompactBulkSelectionRow[] = [];\n  for (const rawId of ids) {\n    const id = rawId.trim();\n    if (id.length === 0 || seen.has(id)) {\n      continue;\n    }\n    seen.add(id);\n    const candidate = byId.get(id);\n    if (candidate === undefined) {\n      rows.push({ id, entries: 0, selected: false, skip_reason: \"no_stream\" });\n      continue;\n    }\n    if (candidate.entries <= minEntries) {\n      rows.push({ id, entries: candidate.entries, selected: false, skip_reason: \"already_compact\" });\n      continue;\n    }\n    rows.push({ id, entries: candidate.entries, selected: true, skip_reason: null });\n  }\n  return rows;\n}\n\nfunction selectScanMode(\n  candidates: HistoryCompactBulkCandidate[],\n  criteria: HistoryCompactBulkCriteria,\n): HistoryCompactBulkSelectionRow[] {\n  const ordered = [...candidates].sort((a, b) => b.entries - a.entries || a.id.localeCompare(b.id));\n  const rows: HistoryCompactBulkSelectionRow[] = [];\n  for (const candidate of ordered) {\n    if (criteria.scope === \"closed\" && candidate.bucket !== \"closed\") {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"scope_mismatch\" });\n      continue;\n    }\n    if (candidate.entries <= criteria.minEntries) {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"already_compact\" });\n      continue;\n    }\n    if (criteria.allOver !== undefined && candidate.entries <= criteria.allOver) {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"below_threshold\" });\n      continue;\n    }\n    rows.push({ id: candidate.id, entries: candidate.entries, selected: true, skip_reason: null });\n  }\n  return rows;\n}\n\n/**\n * Decide which history streams to compact.\n *\n * Runs in \"ids\" mode when `criteria.ids` is non-empty (exact, ordered set,\n * honouring only the `minEntries` floor) and \"scan\" mode otherwise (every\n * candidate, filtered by scope and entry thresholds, ordered deepest-first).\n */\nexport function selectHistoryCompactBulkTargets(\n  candidates: HistoryCompactBulkCandidate[],\n  criteria: HistoryCompactBulkCriteria,\n): HistoryCompactBulkSelectionRow[] {\n  if (criteria.ids !== undefined && criteria.ids.length > 0) {\n    const byId = new Map(candidates.map((candidate) => [candidate.id, candidate]));\n    return selectIdsMode(criteria.ids, byId, criteria.minEntries);\n  }\n  return selectScanMode(candidates, criteria);\n}\n"],
-  "mappings": "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",
-  "names": ["compactCount", "global"]
-}

package/dist/cli-bundle/chunks/history-compact-HR7BB4LR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/history-compact.ts","../../../../../../../../core/history/history-compact-bulk.ts"],"sourcesContent":["/**\n * @module cli/commands/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 { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  cloneEmptyReplayDocument,\n  historyEntriesToRaw,\n  replayHash,\n  replayToItemDocument,\n  toReplayDocument,\n  tryApplyReplayPatch,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.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 { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { pathExists, readFileIfExists, writeFileAtomic } 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 { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/**\n * Documents the history compact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactCommandOptions {\n  before?: string;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\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\n/**\n * Documents the history compact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\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  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  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction parseBeforeBoundary(before: string | undefined, entries: HistoryEntry[]): 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(\"history-compact --before requires a non-empty value.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(raw)) {\n    const version = Number.parseInt(raw, 10);\n    if (!Number.isSafeInteger(version) || version < 1 || version > entries.length + 1) {\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 applyHistoryPatch(current: ReplayDocument, entry: HistoryEntry, entryNumber: number): ReplayDocument {\n  const result = tryApplyReplayPatch(current, entry.patch);\n  if (!result.ok) {\n    throw new PmCliError(\n      `history-compact failed to apply patch at entry ${entryNumber} (op=${entry.op}): ${\n        result.error instanceof Error ? result.error.message : String(result.error)\n      }`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  return result.document;\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, index + 1);\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(replay, entry, retainedEntryOffset + index + 1);\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\n/**\n * Implements run history compact for the public runtime surface of this module.\n */\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const historyPath = subject.historyPath;\n  const historyRawBeforeLock = await readFileIfExists(historyPath);\n  if (historyRawBeforeLock === null) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyEntries = await readHistoryEntries(historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to compact.`, EXIT_CODE.USAGE);\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 loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItem?.raw ?? null;\n  const matchedChainBefore =\n    loadedItem === null\n      ? null\n      : replayHash(toReplayDocument(loadedItem.document)) === historyEntries[historyEntries.length - 1]?.after_hash;\n  if (matchedChainBefore === false) {\n    warnings.push(\"history_compact_item_chain_mismatch\");\n  }\n\n  let rewrittenEntries: HistoryEntry[] = historyEntries;\n  let baselineEntryAdded = false;\n  let auditEntryAdded = false;\n\n  if (changed) {\n    const { checkpoint, finalReplay } = replayHistoryAndResolveCheckpoint(historyEntries, boundary.compactCount);\n    const retained = historyEntries.slice(boundary.compactCount);\n    const reanchored = reanchorRetainedEntries(retained, checkpoint, boundary.compactCount);\n    const baselineEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"history_compact_baseline\",\n      before: replayToItemDocument(cloneEmptyReplayDocument()),\n      after: replayToItemDocument(checkpoint),\n      message:\n        boundary.raw === null\n          ? `history-compact baseline snapshot after compacting ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }.`\n          : `history-compact baseline snapshot before ${boundary.raw}.`,\n    });\n    rewrittenEntries = [baselineEntry, ...reanchored.entries];\n    baselineEntryAdded = true;\n    const compactMessage =\n      typeof options.message === \"string\" && options.message.trim().length > 0\n        ? options.message\n        : boundary.raw === null\n          ? `history-compact compacted full stream (${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            }).`\n          : `history-compact compacted ${boundary.compactCount} entr${\n              boundary.compactCount === 1 ? \"y\" : \"ies\"\n            } before ${boundary.raw}.`;\n    if (!dryRun) {\n      rewrittenEntries.push(\n        createHistoryEntry({\n          nowIso: nowIso(),\n          author,\n          op: \"history_compact\",\n          before: replayToItemDocument(finalReplay),\n          after: replayToItemDocument(finalReplay),\n          message: compactMessage,\n        }),\n      );\n      auditEntryAdded = true;\n    }\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 executeHistoryRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n        operation: \"history-compact\",\n        author,\n        force: options.force,\n        itemDocument: loadedItem?.document ?? null,\n        applyRewrite: async ({ historyRawUnderLock }) => {\n          try {\n            await writeFileAtomic(historyPath, historyEntriesToRaw(rewrittenEntries));\n          } catch (error) {\n            if (historyRawUnderLock === null) {\n              await fs.rm(historyPath, { force: true });\n            } else {\n              await writeFileAtomic(historyPath, historyRawUnderLock);\n            }\n            throw error;\n          }\n        },\n        applyPostRewrite: async () =>\n          runActiveOnWriteHooks({\n            path: historyPath,\n            scope: \"project\",\n            op: \"history_compact:history\",\n          }),\n      })),\n    );\n  }\n\n  const firstRetainedEntry = 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: matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\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/**\n * Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactBulkCommandOptions {\n  ids?: string[];\n  scope?: HistoryCompactScope;\n  allOver?: number;\n  minEntries?: number;\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/** Per-item outcome row in a bulk compaction pass. */\nexport interface HistoryCompactBulkItemResult {\n  id: string;\n  outcome: \"compacted\" | \"skipped\" | \"errored\";\n  entries_before: number;\n  entries_after: number | null;\n  skip_reason: HistoryCompactBulkSkipReason | null;\n  changed: boolean;\n  error: string | null;\n}\n\n/**\n * Documents the bulk history compact result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryCompactBulkResult {\n  bulk: true;\n  dry_run: boolean;\n  mode: \"ids\" | \"scan\";\n  scope: HistoryCompactScope | null;\n  criteria: {\n    min_entries: number;\n    all_over: number | null;\n    policy_threshold_applied: boolean;\n  };\n  totals: {\n    streams_considered: number;\n    selected: number;\n    items_compacted: number;\n    items_skipped: number;\n    items_errored: number;\n  };\n  results: HistoryCompactBulkItemResult[];\n  generated_at: string;\n}\n\n/**\n * Enforce the `pm history-compact` target contract shared by the CLI and MCP\n * surfaces: exactly one selection mode — a single item `<id>`, an explicit\n * `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`).\n */\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 = (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\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  const bucketById = new Map(items.map((item) => [item.id, classifier.classify(item.status)] as const));\n\n  const historyDir = path.join(pmRoot, \"history\");\n  const candidates: HistoryCompactBulkCandidate[] = [];\n  // A stream that cannot be read during enumeration is isolated as an errored\n  // row (mirroring per-stream compaction failures) rather than aborting the pass.\n  const preselectionErrors: HistoryCompactBulkItemResult[] = [];\n  if (await pathExists(historyDir)) {\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({ id, entries: countHistoryStreamEntries(raw), bucket: bucketById.get(id) ?? null });\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  }\n\n  const mode: \"ids\" | \"scan\" = options.ids !== undefined && options.ids.length > 0 ? \"ids\" : \"scan\";\n  const minEntries = options.minEntries ?? HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES;\n  const policy = settings.history.compact_policy;\n  const policyThresholdApplied = mode === \"scan\" && options.allOver === undefined && policy.enabled;\n  const allOver = options.allOver ?? (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    if (!row.selected) {\n      totals.items_skipped += 1;\n      results.push({\n        id: row.id,\n        outcome: \"skipped\",\n        entries_before: row.entries,\n        entries_after: null,\n        skip_reason: row.skip_reason,\n        changed: false,\n        error: null,\n      });\n      continue;\n    }\n    totals.selected += 1;\n    try {\n      const result = await runHistoryCompact(\n        row.id,\n        {\n          dryRun,\n          author: options.author,\n          message: options.message,\n          force: options.force,\n        },\n        global,\n      );\n      totals.items_compacted += 1;\n      results.push({\n        id: row.id,\n        outcome: \"compacted\",\n        entries_before: row.entries,\n        entries_after: result.history.entries_after,\n        skip_reason: null,\n        changed: result.changed,\n        error: null,\n      });\n    } catch (error) {\n      totals.items_errored += 1;\n      results.push({\n        id: row.id,\n        outcome: \"errored\",\n        entries_before: 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  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","/**\n * @module core/history/history-compact-bulk\n *\n * Pure selection logic for bulk history-stream compaction. Given a set of\n * history-stream candidates (id, entry count, and lifecycle bucket of the\n * owning item) plus the requested selection criteria, this module decides which\n * streams should be compacted and which are skipped (and why).\n *\n * The module performs no filesystem access and imports no heavy runtime\n * dependencies — the command layer reads streams and item statuses, hands the\n * resolved candidates here, then executes per-item compaction on the selection\n * this module returns. Keeping selection pure makes the matrix of scope /\n * threshold / explicit-id rules trivially testable without touching disk.\n */\n\nimport type { LifecycleBucket } from \"../governance/metadata-coverage.js\";\n\n/** Bulk-compaction scope: only closed items, or every history stream. */\nexport type HistoryCompactScope = \"closed\" | \"all-streams\";\n\n/** Why a candidate stream was not selected for compaction. */\nexport type HistoryCompactBulkSkipReason = \"no_stream\" | \"already_compact\" | \"scope_mismatch\" | \"below_threshold\";\n\n/**\n * One history stream considered for bulk compaction.\n *\n * `bucket` is the lifecycle bucket of the owning item, or `null` when no item\n * matches the stream (an orphan history file). Orphan streams never satisfy a\n * `closed` scope filter but are eligible under `all-streams`.\n */\nexport interface HistoryCompactBulkCandidate {\n  id: string;\n  entries: number;\n  bucket: LifecycleBucket | null;\n}\n\n/** Selection criteria resolved from the command flags + policy defaults. */\nexport interface HistoryCompactBulkCriteria {\n  /**\n   * Explicit, ordered list of item ids to compact. When non-empty the selection\n   * runs in \"ids\" mode: scope/allOver are ignored and only the `minEntries`\n   * floor applies. Duplicates are collapsed, preserving first-seen order.\n   */\n  ids?: string[];\n  /** Lifecycle scope filter for scan mode (ignored in ids mode). */\n  scope?: HistoryCompactScope;\n  /**\n   * Streams with at most this many entries are skipped as `already_compact`\n   * (compaction collapses a stream to a 2-entry baseline+audit pair, so smaller\n   * streams gain nothing). Applies in both modes.\n   */\n  minEntries: number;\n  /**\n   * Scan mode only: when set, only streams with strictly more entries than this\n   * are selected. Streams above `minEntries` but at/below `allOver` are skipped\n   * as `below_threshold`.\n   */\n  allOver?: number;\n}\n\n/** Per-candidate selection outcome. */\nexport interface HistoryCompactBulkSelectionRow {\n  id: string;\n  entries: number;\n  selected: boolean;\n  skip_reason: HistoryCompactBulkSkipReason | null;\n}\n\nfunction selectIdsMode(\n  ids: string[],\n  byId: ReadonlyMap<string, HistoryCompactBulkCandidate>,\n  minEntries: number,\n): HistoryCompactBulkSelectionRow[] {\n  const seen = new Set<string>();\n  const rows: HistoryCompactBulkSelectionRow[] = [];\n  for (const rawId of ids) {\n    const id = rawId.trim();\n    if (id.length === 0 || seen.has(id)) {\n      continue;\n    }\n    seen.add(id);\n    const candidate = byId.get(id);\n    if (candidate === undefined) {\n      rows.push({ id, entries: 0, selected: false, skip_reason: \"no_stream\" });\n      continue;\n    }\n    if (candidate.entries <= minEntries) {\n      rows.push({ id, entries: candidate.entries, selected: false, skip_reason: \"already_compact\" });\n      continue;\n    }\n    rows.push({ id, entries: candidate.entries, selected: true, skip_reason: null });\n  }\n  return rows;\n}\n\nfunction selectScanMode(\n  candidates: HistoryCompactBulkCandidate[],\n  criteria: HistoryCompactBulkCriteria,\n): HistoryCompactBulkSelectionRow[] {\n  const ordered = [...candidates].sort((a, b) => b.entries - a.entries || a.id.localeCompare(b.id));\n  const rows: HistoryCompactBulkSelectionRow[] = [];\n  for (const candidate of ordered) {\n    if (criteria.scope === \"closed\" && candidate.bucket !== \"closed\") {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"scope_mismatch\" });\n      continue;\n    }\n    if (candidate.entries <= criteria.minEntries) {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"already_compact\" });\n      continue;\n    }\n    if (criteria.allOver !== undefined && candidate.entries <= criteria.allOver) {\n      rows.push({ id: candidate.id, entries: candidate.entries, selected: false, skip_reason: \"below_threshold\" });\n      continue;\n    }\n    rows.push({ id: candidate.id, entries: candidate.entries, selected: true, skip_reason: null });\n  }\n  return rows;\n}\n\n/**\n * Decide which history streams to compact.\n *\n * Runs in \"ids\" mode when `criteria.ids` is non-empty (exact, ordered set,\n * honouring only the `minEntries` floor) and \"scan\" mode otherwise (every\n * candidate, filtered by scope and entry thresholds, ordered deepest-first).\n */\nexport function selectHistoryCompactBulkTargets(\n  candidates: HistoryCompactBulkCandidate[],\n  criteria: HistoryCompactBulkCriteria,\n): HistoryCompactBulkSelectionRow[] {\n  if (criteria.ids !== undefined && criteria.ids.length > 0) {\n    const byId = new Map(candidates.map((candidate) => [candidate.id, candidate]));\n    return selectIdsMode(criteria.ids, byId, criteria.minEntries);\n  }\n  return selectScanMode(candidates, criteria);\n}\n"],"names":["compactCount"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,OAAO,QAAQ;AACf,OAAO,UAAU;;;AC8DjB,SAAS,cACP,KACA,MACA,YAAkB;AAElB,QAAM,OAAO,oBAAI,IAAG;AACpB,QAAM,OAAyC,CAAA;AAC/C,aAAW,SAAS,KAAK;AACvB,UAAM,KAAK,MAAM,KAAI;AACrB,QAAI,GAAG,WAAW,KAAK,KAAK,IAAI,EAAE,GAAG;AACnC;IACF;AACA,SAAK,IAAI,EAAE;AACX,UAAM,YAAY,KAAK,IAAI,EAAE;AAC7B,QAAI,cAAc,QAAW;AAC3B,WAAK,KAAK,EAAE,IAAI,SAAS,GAAG,UAAU,OAAO,aAAa,YAAW,CAAE;AACvE;IACF;AACA,QAAI,UAAU,WAAW,YAAY;AACnC,WAAK,KAAK,EAAE,IAAI,SAAS,UAAU,SAAS,UAAU,OAAO,aAAa,kBAAiB,CAAE;AAC7F;IACF;AACA,SAAK,KAAK,EAAE,IAAI,SAAS,UAAU,SAAS,UAAU,MAAM,aAAa,KAAI,CAAE;EACjF;AACA,SAAO;AACT;AAEA,SAAS,eACP,YACA,UAAoC;AAEpC,QAAM,UAAU,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC;AAChG,QAAM,OAAyC,CAAA;AAC/C,aAAW,aAAa,SAAS;AAC/B,QAAI,SAAS,UAAU,YAAY,UAAU,WAAW,UAAU;AAChE,WAAK,KAAK,EAAE,IAAI,UAAU,IAAI,SAAS,UAAU,SAAS,UAAU,OAAO,aAAa,iBAAgB,CAAE;AAC1G;IACF;AACA,QAAI,UAAU,WAAW,SAAS,YAAY;AAC5C,WAAK,KAAK,EAAE,IAAI,UAAU,IAAI,SAAS,UAAU,SAAS,UAAU,OAAO,aAAa,kBAAiB,CAAE;AAC3G;IACF;AACA,QAAI,SAAS,YAAY,UAAa,UAAU,WAAW,SAAS,SAAS;AAC3E,WAAK,KAAK,EAAE,IAAI,UAAU,IAAI,SAAS,UAAU,SAAS,UAAU,OAAO,aAAa,kBAAiB,CAAE;AAC3G;IACF;AACA,SAAK,KAAK,EAAE,IAAI,UAAU,IAAI,SAAS,UAAU,SAAS,UAAU,MAAM,aAAa,KAAI,CAAE;EAC/F;AACA,SAAO;AACT;AASM,SAAU,gCACd,YACA,UAAoC;AAEpC,MAAI,SAAS,QAAQ,UAAa,SAAS,IAAI,SAAS,GAAG;AACzD,UAAM,OAAO,IAAI,IAAI,WAAW,IAAI,CAAC,cAAc,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;AAC7E,WAAO,cAAc,SAAS,KAAK,MAAM,SAAS,UAAU;EAC9D;AACA,SAAO,eAAe,YAAY,QAAQ;AAC5C;;;ADpCA,SAAS,oBAAoB,QAA4B,SAAuB;AAC9E,MAAI,WAAW,QAAW;AACxB,WAAO;MACL,MAAM;MACN,KAAK;MACL,cAAc,QAAQ;MACtB,eAAe;;EAEnB;AAEA,QAAM,MAAM,OAAO,KAAI;AACvB,MAAI,IAAI,WAAW,GAAG;AACpB,UAAM,IAAI,WAAW,wDAAwD,UAAU,KAAK;EAC9F;AAEA,MAAI,QAAQ,KAAK,GAAG,GAAG;AACrB,UAAM,UAAU,OAAO,SAAS,KAAK,EAAE;AACvC,QAAI,CAAC,OAAO,cAAc,OAAO,KAAK,UAAU,KAAK,UAAU,QAAQ,SAAS,GAAG;AACjF,YAAM,IAAI,WACR,0DAA0D,QAAQ,SAAS,CAAC,KAC5E,UAAU,KAAK;IAEnB;AACA,UAAMA,gBAAe,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,QAAQ,UAAU,CAAC,CAAC;AACtE,WAAO;MACL,MAAM;MACN;MACA,cAAAA;MACA,eAAe,QAAQ,SAASA;;EAEpC;AAEA,QAAM,WAAW,KAAK,MAAM,GAAG;AAC/B,MAAI,CAAC,OAAO,SAAS,QAAQ,GAAG;AAC9B,UAAM,IAAI,WACR,2CAA2C,MAAM,6CACjD,UAAU,KAAK;EAEnB;AAEA,MAAI,eAAe;AACnB,aAAW,CAAC,OAAO,KAAK,KAAK,QAAQ,QAAO,GAAI;AAC9C,UAAM,UAAU,KAAK,MAAM,MAAM,EAAE;AACnC,QAAI,CAAC,OAAO,SAAS,OAAO,GAAG;AAC7B,YAAM,IAAI,WACR,6DAA6D,QAAQ,CAAC,KACtE,UAAU,eAAe;IAE7B;AACA,QAAI,WAAW,UAAU;AACvB;IACF;AACA,oBAAgB;EAClB;AAEA,SAAO;IACL,MAAM;IACN;IACA;IACA,eAAe,QAAQ,SAAS;;AAEpC;AAEA,SAAS,kBAAkB,SAAyB,OAAqB,aAAmB;AAC1F,QAAM,SAAS,oBAAoB,SAAS,MAAM,KAAK;AACvD,MAAI,CAAC,OAAO,IAAI;AACd,UAAM,IAAI,WACR,kDAAkD,WAAW,QAAQ,MAAM,EAAE,MAC3E,OAAO,iBAAiB,QAAQ,OAAO,MAAM,UAAU,OAAO,OAAO,KAAK,CAC5E,IACA,UAAU,eAAe;EAE7B;AACA,SAAO,OAAO;AAChB;AAEA,SAAS,kCACP,SACA,cAAoB;AAKpB,MAAI,SAAS,yBAAwB;AACrC,MAAI,aAAa,yBAAwB;AACzC,WAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;AACtD,UAAM,QAAQ,QAAQ,KAAK;AAC3B,QAAI,WAAW,MAAM,MAAM,MAAM,aAAa;AAC5C,YAAM,IAAI,WACR,uDAAuD,QAAQ,CAAC,kCAChE,UAAU,QAAQ;IAEtB;AACA,aAAS,kBAAkB,QAAQ,OAAO,QAAQ,CAAC;AACnD,QAAI,WAAW,MAAM,MAAM,MAAM,YAAY;AAC3C,YAAM,IAAI,WACR,sDAAsD,QAAQ,CAAC,kCAC/D,UAAU,QAAQ;IAEtB;AACA,QAAI,QAAQ,MAAM,cAAc;AAC9B,mBAAa,gBAAgB,MAAM;IACrC;EACF;AACA,SAAO;IACL;IACA,aAAa;;AAEjB;AAEA,SAAS,wBACP,iBACA,MACA,qBAA2B;AAK3B,MAAI,SAAS,gBAAgB,IAAI;AACjC,QAAM,YAA4B,CAAA;AAClC,aAAW,CAAC,OAAO,KAAK,KAAK,gBAAgB,QAAO,GAAI;AACtD,UAAM,aAAa,WAAW,MAAM;AACpC,aAAS,kBAAkB,QAAQ,OAAO,sBAAsB,QAAQ,CAAC;AACzE,cAAU,KAAK;MACb,GAAG;MACH,aAAa;MACb,YAAY,WAAW,MAAM;KAC9B;EACH;AACA,SAAO;IACL,SAAS;IACT,aAAa;;AAEjB;AAKA,eAAsB,kBACpB,IACA,SACA,QAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,UAAU,MAAM,sBAAsB,QAAQ,IAAI,UAAU,aAAa,cAAc;AAC7F,QAAM,cAAc,QAAQ;AAC5B,QAAM,uBAAuB,MAAM,iBAAiB,WAAW;AAC/D,MAAI,yBAAyB,MAAM;AACjC,UAAM,IAAI,WAAW,gCAAgC,QAAQ,EAAE,KAAK,UAAU,SAAS;EACzF;AACA,QAAM,iBAAiB,MAAM,mBAAmB,aAAa,QAAQ,EAAE;AACvE,MAAI,eAAe,WAAW,GAAG;AAC/B,UAAM,IAAI,WAAW,gCAAgC,QAAQ,EAAE,yBAAyB,UAAU,KAAK;EACzG;AAEA,QAAM,oBAAoB,mBAAmB,cAAc;AAC3D,MAAI,CAAC,kBAAkB,IAAI;AACzB,UAAM,IAAI,WACR,mDAAmD,kBAAkB,OAAO,KAAK,IAAI,CAAC,4BAA4B,QAAQ,EAAE,WAC5H,UAAU,QAAQ;EAEtB;AAEA,QAAM,WAAW,oBAAoB,QAAQ,QAAQ,cAAc;AACnE,QAAM,UAAU,SAAS,eAAe;AACxC,QAAM,SAAS,QAAQ,QAAQ,MAAM;AACrC,QAAM,SAAS,cAAc,QAAQ,QAAQ,SAAS,cAAc;AACpE,QAAM,WAAqB,CAAA;AAC3B,MAAI,CAAC,SAAS;AACZ,aAAS,KAAK,sCAAsC;EACtD;AAEA,QAAM,aAAa,QAAQ,UAAU,MAAM,gBAAgB,QAAQ,SAAS,EAAE,QAAQ,SAAS,OAAM,CAAE,IAAI;AAC3G,QAAM,2BAA2B,YAAY,OAAO;AACpD,QAAM,qBACJ,eAAe,OACX,OACA,WAAW,iBAAiB,WAAW,QAAQ,CAAC,MAAM,eAAe,eAAe,SAAS,CAAC,GAAG;AACvG,MAAI,uBAAuB,OAAO;AAChC,aAAS,KAAK,qCAAqC;EACrD;AAEA,MAAI,mBAAmC;AACvC,MAAI,qBAAqB;AACzB,MAAI,kBAAkB;AAEtB,MAAI,SAAS;AACX,UAAM,EAAE,YAAY,YAAW,IAAK,kCAAkC,gBAAgB,SAAS,YAAY;AAC3G,UAAM,WAAW,eAAe,MAAM,SAAS,YAAY;AAC3D,UAAM,aAAa,wBAAwB,UAAU,YAAY,SAAS,YAAY;AACtF,UAAM,gBAAgB,mBAAmB;MACvC,QAAQ,OAAM;MACd;MACA,IAAI;MACJ,QAAQ,qBAAqB,yBAAwB,CAAE;MACvD,OAAO,qBAAqB,UAAU;MACtC,SACE,SAAS,QAAQ,OACb,sDAAsD,SAAS,YAAY,QACzE,SAAS,iBAAiB,IAAI,MAAM,KACtC,MACA,4CAA4C,SAAS,GAAG;KAC/D;AACD,uBAAmB,CAAC,eAAe,GAAG,WAAW,OAAO;AACxD,yBAAqB;AACrB,UAAM,iBACJ,OAAO,QAAQ,YAAY,YAAY,QAAQ,QAAQ,KAAI,EAAG,SAAS,IACnE,QAAQ,UACR,SAAS,QAAQ,OACf,0CAA0C,SAAS,YAAY,QAC7D,SAAS,iBAAiB,IAAI,MAAM,KACtC,OACA,6BAA6B,SAAS,YAAY,QAChD,SAAS,iBAAiB,IAAI,MAAM,KACtC,WAAW,SAAS,GAAG;AAC/B,QAAI,CAAC,QAAQ;AACX,uBAAiB,KACf,mBAAmB;QACjB,QAAQ,OAAM;QACd;QACA,IAAI;QACJ,QAAQ,qBAAqB,WAAW;QACxC,OAAO,qBAAqB,WAAW;QACvC,SAAS;OACV,CAAC;AAEJ,wBAAkB;IACpB;EACF;AAEA,QAAM,kBAAkB,mBAAmB,gBAAgB;AAC3D,MAAI,CAAC,gBAAgB,IAAI;AACvB,UAAM,IAAI,WACR,wDAAwD,gBAAgB,OAAO,KAAK,IAAI,CAAC,MACzF,UAAU,eAAe;EAE7B;AAEA,MAAI,WAAW,CAAC,QAAQ;AACtB,aAAS,KACP,GAAI,MAAM,sBAAsB;MAC9B;MACA;MACA;MACA;MACA;MACA;MACA,WAAW;MACX;MACA,OAAO,QAAQ;MACf,cAAc,YAAY,YAAY;MACtC,cAAc,OAAO,EAAE,oBAAmB,MAAM;AAC9C,YAAI;AACF,gBAAM,gBAAgB,aAAa,oBAAoB,gBAAgB,CAAC;QAC1E,SAAS,OAAO;AACd,cAAI,wBAAwB,MAAM;AAChC,kBAAM,GAAG,GAAG,aAAa,EAAE,OAAO,KAAI,CAAE;UAC1C,OAAO;AACL,kBAAM,gBAAgB,aAAa,mBAAmB;UACxD;AACA,gBAAM;QACR;MACF;MACA,kBAAkB,YAChB,sBAAsB;QACpB,MAAM;QACN,OAAO;QACP,IAAI;OACL;KACJ,CAAE;EAEP;AAEA,QAAM,qBAAqB,SAAS,gBAAgB,IAAI,SAAS,eAAe,IAAI;AACpF,SAAO;IACL,IAAI,QAAQ;IACZ,SAAS;IACT;IACA,kBAAkB;MAChB,MAAM,SAAS;MACf,QAAQ,SAAS;MACjB,mBAAmB,SAAS;MAC5B,kBAAkB,SAAS;MAC3B,sBAAsB;;IAExB,SAAS;MACP,MAAM;MACN,iBAAiB,eAAe;MAChC,eAAe,iBAAiB;MAChC,sBAAsB;MACtB,mBAAmB;MACnB,WAAW,gBAAgB;MAC3B,eAAe,gBAAgB;;IAEjC,MAAM;MACJ,QAAQ,QAAQ,YAAY;MAC5B,MAAM,QAAQ,SAAS,YAAY;MACnC,sBAAsB;;IAExB,UAAU,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;IAChF,cAAc,OAAM;;AAExB;AAGO,IAAM,2CAA2C;AAwDlD,SAAU,2BACd,IACA,MAAuE;AAEvE,QAAM,SAAS,KAAK,QAAQ,UAAa,KAAK,IAAI,SAAS;AAC3D,QAAM,UAAU,KAAK,YAAY,UAAa,KAAK,UAAU;AAC7D,QAAM,iBAAiB,OAAO,SAAY,IAAI,MAAM,SAAS,IAAI,MAAM,UAAU,IAAI;AACrF,MAAI,kBAAkB,GAAG;AACvB,UAAM,IAAI,WACR,kHACA,UAAU,KAAK;EAEnB;AACA,MAAI,OAAO,WAAc,UAAU,UAAU;AAC3C,UAAM,IAAI,WACR,0KACA,UAAU,KAAK;EAEnB;AACA,MAAI,UAAU,SAAS;AACrB,UAAM,IAAI,WACR,+IACA,UAAU,KAAK;EAEnB;AACF;AAEA,SAAS,0BAA0B,KAAW;AAC5C,MAAI,QAAQ;AACZ,aAAW,QAAQ,IAAI,MAAM,OAAO,GAAG;AACrC,QAAI,KAAK,KAAI,EAAG,SAAS,GAAG;AAC1B,eAAS;IACX;EACF;AACA,SAAO;AACT;AAcA,eAAsB,sBACpB,SACA,QAAqB;AAErB,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,OAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AACnE,QAAM,aAAa,sCAAsC,cAAc;AACvE,QAAM,QAAQ,MAAM,wBAAwB,QAAQ,SAAS,aAAa,aAAa,gBAAgB,QAAW,SAAS,MAAM;AACjI,QAAM,aAAa,IAAI,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,WAAW,SAAS,KAAK,MAAM,CAAC,CAAU,CAAC;AAEpG,QAAM,aAAa,KAAK,KAAK,QAAQ,SAAS;AAC9C,QAAM,aAA4C,CAAA;AAGlD,QAAM,qBAAqD,CAAA;AAC3D,MAAI,MAAM,WAAW,UAAU,GAAG;AAChC,UAAM,gBAAgB,MAAM,GAAG,QAAQ,UAAU,GAC9C,OAAO,CAAC,UAAU,MAAM,SAAS,QAAQ,CAAC,EAC1C,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC;AAClD,eAAW,YAAY,cAAc;AACnC,YAAM,cAAc,KAAK,KAAK,YAAY,QAAQ;AAClD,YAAM,KAAK,SAAS,MAAM,GAAG,CAAC,SAAS,MAAM;AAC7C,UAAI;AACF,cAAM,MAAM,MAAM,GAAG,SAAS,aAAa,MAAM;AACjD,cAAM,qBAAqB,EAAE,MAAM,aAAa,OAAO,UAAS,CAAE;AAClE,mBAAW,KAAK,EAAE,IAAI,SAAS,0BAA0B,GAAG,GAAG,QAAQ,WAAW,IAAI,EAAE,KAAK,KAAI,CAAE;MACrG,SAAS,OAAO;AACd,2BAAmB,KAAK;UACtB;UACA,SAAS;UACT,gBAAgB;UAChB,eAAe;UACf,aAAa;UACb,SAAS;;UAET,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;SAC7D;MACH;IACF;EACF;AAEA,QAAM,OAAuB,QAAQ,QAAQ,UAAa,QAAQ,IAAI,SAAS,IAAI,QAAQ;AAC3F,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,SAAS,SAAS,QAAQ;AAChC,QAAM,yBAAyB,SAAS,UAAU,QAAQ,YAAY,UAAa,OAAO;AAC1F,QAAM,UAAU,QAAQ,YAAY,yBAAyB,OAAO,cAAc;AAElF,QAAM,YAAY,gCAAgC,YAAY;IAC5D,KAAK,QAAQ;IACb,OAAO,QAAQ;IACf;IACA;GACD;AAED,QAAM,SAAS,QAAQ,QAAQ,MAAM;AACrC,QAAM,UAA0C,CAAC,GAAG,kBAAkB;AACtE,QAAM,SAAS;IACb,oBAAoB,WAAW,SAAS,mBAAmB;IAC3D,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,eAAe,mBAAmB;;AAEpC,aAAW,OAAO,WAAW;AAC3B,QAAI,CAAC,IAAI,UAAU;AACjB,aAAO,iBAAiB;AACxB,cAAQ,KAAK;QACX,IAAI,IAAI;QACR,SAAS;QACT,gBAAgB,IAAI;QACpB,eAAe;QACf,aAAa,IAAI;QACjB,SAAS;QACT,OAAO;OACR;AACD;IACF;AACA,WAAO,YAAY;AACnB,QAAI;AACF,YAAM,SAAS,MAAM,kBACnB,IAAI,IACJ;QACE;QACA,QAAQ,QAAQ;QAChB,SAAS,QAAQ;QACjB,OAAO,QAAQ;SAEjB,MAAM;AAER,aAAO,mBAAmB;AAC1B,cAAQ,KAAK;QACX,IAAI,IAAI;QACR,SAAS;QACT,gBAAgB,IAAI;QACpB,eAAe,OAAO,QAAQ;QAC9B,aAAa;QACb,SAAS,OAAO;QAChB,OAAO;OACR;IACH,SAAS,OAAO;AACd,aAAO,iBAAiB;AACxB,cAAQ,KAAK;QACX,IAAI,IAAI;QACR,SAAS;QACT,gBAAgB,IAAI;QACpB,eAAe;QACf,aAAa;QACb,SAAS;;QAET,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;OAC7D;IACH;EACF;AAEA,SAAO;IACL,MAAM;IACN,SAAS;IACT;IACA,OAAO,QAAQ,SAAS;IACxB,UAAU;MACR,aAAa;MACb,UAAU,WAAW;MACrB,0BAA0B;;IAE5B;IACA;IACA,cAAc,OAAM;;AAExB","debugId":"da381f85-75a5-5832-9c6d-741fbee57e08"}

package/dist/cli-bundle/chunks/history-redact-MP6CH7U5.js

@@ -1,19 +0,0 @@
-import {
-  _testOnly,
-  resolveHistorySubject,
-  runHistoryRedact
-} from "./chunk-IZBR4NRW.js";
-import "./chunk-WW4E2DC3.js";
-import "./chunk-64HNBBFQ.js";
-import "./chunk-G7I7DEZA.js";
-import "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
-export {
-  _testOnly,
-  resolveHistorySubject,
-  runHistoryRedact
-};
-//# sourceMappingURL=history-redact-MP6CH7U5.js.map

package/dist/cli-bundle/chunks/history-repair-LCMOS45X.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/history-repair.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/history-repair\n *\n * Implements the pm history repair command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  historyEntriesToRaw,\n  reanchorHistoryEntries,\n  replayHash,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { scanHistoryDrift } from \"../../core/history/drift-scan.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { listAllFrontMatterWithBody, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/**\n * Documents the history repair command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairCommandOptions {\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the history repair result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  history: {\n    path: string;\n    entries_scanned: number;\n    chain_drift_before: boolean;\n    entries_rehashed: number;\n    entries_patch_repaired: number;\n    converted_replace_to_add: number;\n    skipped_ops: number;\n    reconciled_with_item: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  /* c8 ignore next -- PM_AUTHOR fallback branch is environment-dependent in CI. */\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\n/**\n * Implements run history repair for the public runtime surface of this module.\n */\nexport async function runHistoryRepair(\n  id: string,\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to repair.`, EXIT_CODE.USAGE);\n  }\n\n  const chainBefore = verifyHistoryChain(historyEntries);\n  const reanchor = reanchorHistoryEntries(historyEntries);\n\n  // Reconcile the replayed chain with the current on-disk item document so the\n  // latest after_hash matches what pm validate/health compute for the item.\n  let currentItemReplay: ReplayDocument | null = null;\n  const currentItemPath: string | null = subject.located?.itemPath ?? null;\n  let matchedChainBefore: boolean | null = null;\n  const loadedItem = subject.located\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : null;\n  const currentItemRawBeforeLock = loadedItem?.raw ?? null;\n  if (loadedItem) {\n    // Use the shared canonical replay form so reconciliation hashing matches the\n    // semantics pm validate/health use for the on-disk item (avoids hash divergence).\n    currentItemReplay = toReplayDocument(loadedItem.document);\n    const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;\n    matchedChainBefore = replayHash(currentItemReplay) === lastOriginalAfterHash;\n  }\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    currentItemReplay !== null && replayHash(finalReplay) !== replayHash(currentItemReplay);\n\n  const changed = reanchor.entriesRehashed > 0 || reanchor.entriesPatchRepaired > 0 || reconcileNeeded;\n  const author = toAuthor(options.author, settings.author_default);\n  const dryRun = Boolean(options.dryRun);\n\n  const repairMessage =\n    /* c8 ignore next -- generated repair summaries include optional clauses based on rare drift shapes. */\n    typeof options.message === \"string\" && options.message.trim().length > 0\n      ? options.message\n      : `history-repair re-anchored ${reanchor.entriesRehashed} entr${\n          reanchor.entriesRehashed === 1 ? \"y\" : \"ies\"\n        }${reanchor.entriesPatchRepaired > 0 ? `, repaired ${reanchor.entriesPatchRepaired} patch(es)` : \"\"}${\n          reconcileNeeded ? \", reconciled chain with on-disk item\" : \"\"\n        }.`;\n\n  const rewrittenEntries: HistoryEntry[] = [...reanchor.entries];\n  let auditEntryAdded = false;\n  if (changed) {\n    /* c8 ignore next -- reconcile append branch requires hash-drift plus loadable on-disk replay. */\n    if (reconcileNeeded && currentItemReplay) {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: jsonPatch.compare(finalReplay, currentItemReplay) as HistoryPatchOp[],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(currentItemReplay),\n        message: repairMessage,\n      });\n    } else {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: [],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(finalReplay),\n        message: repairMessage,\n      });\n    }\n    auditEntryAdded = true;\n  }\n\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-repair produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_repair_no_changes\");\n  }\n  if (reanchor.skippedOps > 0) {\n    warnings.push(`history_repair_skipped_unresolvable_ops:${reanchor.skippedOps}`);\n  }\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...(await executeHistoryRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n        operation: \"history-repair\",\n        author,\n        force: options.force,\n        itemDocument: loadedItem?.document ?? null,\n        applyRewrite: async ({ historyRawUnderLock }) => {\n          try {\n            await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));\n          } catch (error) {\n            if (historyRawUnderLock === null) {\n              await fs.rm(subject.historyPath, { force: true });\n            } else {\n              await writeFileAtomic(subject.historyPath, historyRawUnderLock);\n            }\n            throw error;\n          }\n        },\n        applyPostRewrite: async () =>\n          runActiveOnWriteHooks({\n            path: subject.historyPath,\n            scope: \"project\",\n            op: \"history_repair:history\",\n          }),\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      chain_drift_before: !chainBefore.ok,\n      entries_rehashed: reanchor.entriesRehashed,\n      entries_patch_repaired: reanchor.entriesPatchRepaired,\n      converted_replace_to_add: reanchor.convertedReplaceToAdd,\n      skipped_ops: reanchor.skippedOps,\n      reconciled_with_item: reconcileNeeded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      exists: currentItemPath !== null,\n      path: currentItemPath,\n      matched_chain_before: matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n\n/**\n * Documents the history repair all stream result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairAllStreamResult {\n  id: string;\n  outcome: \"repaired\" | \"skipped_clean\" | \"failed\";\n  entries_rehashed?: number;\n  entries_patch_repaired?: number;\n  reconciled_with_item?: boolean;\n  error?: string;\n}\n\n/**\n * Documents the history repair all result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairAllResult {\n  all: true;\n  dry_run: boolean;\n  scanned_streams: number;\n  drifted_streams: number;\n  /** One compact row per drifted stream (clean streams are summarized by the counts only). */\n  streams: HistoryRepairAllStreamResult[];\n  totals: { repaired: number; skipped_clean: number; failed: number };\n  warnings: string[];\n  generated_at: string;\n}\n\n/**\n * Enforce the `pm history-repair` target contract shared by the CLI and MCP\n * surfaces: exactly one of an item `<id>` or `--all` must be provided.\n */\nexport function assertHistoryRepairTarget(id: string | undefined, all: boolean): void {\n  if (all && id !== undefined) {\n    throw new PmCliError(\n      \"history-repair: <id> and --all are mutually exclusive; pass an item id to repair one stream or --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!all && id === undefined) {\n    throw new PmCliError(\n      \"history-repair: provide an item <id> or pass --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n/**\n * Bulk drift repair: scan every item's history stream with the same drift scan\n * `pm health` uses, then run the audited single-stream repair (ownership check,\n * lock, no-drift verification, audit marker) for each drifted stream. One\n * failing stream never aborts the rest; failures are collected per row and the\n * caller decides the exit code from `totals.failed`.\n */\nexport async function runHistoryRepairAll(\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairAllResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const itemReadWarnings: string[] = [];\n  const items = await listAllFrontMatterWithBody(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    itemReadWarnings,\n    settings.schema,\n  );\n  const drift = await scanHistoryDrift(pmRoot, items as Array<ItemMetadata & { body: string }>);\n\n  const streams: HistoryRepairAllStreamResult[] = [];\n  const totals = { repaired: 0, skipped_clean: 0, failed: 0 };\n  for (const driftedId of drift.driftedItems) {\n    try {\n      const result = await runHistoryRepair(driftedId, options, global);\n      /* c8 ignore next -- mixed repaired/clean outcomes depend on live drift composition. */\n      const outcome = result.changed ? \"repaired\" : \"skipped_clean\";\n      totals[outcome] += 1;\n      streams.push({\n        id: driftedId,\n        outcome,\n        entries_rehashed: result.history.entries_rehashed,\n        entries_patch_repaired: result.history.entries_patch_repaired,\n        reconciled_with_item: result.history.reconciled_with_item,\n      });\n    } catch (error) {\n      totals.failed += 1;\n      streams.push({\n        id: driftedId,\n        outcome: \"failed\",\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  return {\n    all: true,\n    dry_run: Boolean(options.dryRun),\n    scanned_streams: items.length,\n    drifted_streams: drift.driftedItems.length,\n    streams,\n    totals,\n    warnings: [...new Set(itemReadWarnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n"],
-  "mappings": "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",
-  "names": ["global"]
-}

package/dist/cli-bundle/chunks/history-repair-XA3LC4GA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/history-repair.ts"],"sourcesContent":["/**\n * @module cli/commands/history-repair\n *\n * Implements the pm history repair command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  historyEntriesToRaw,\n  reanchorHistoryEntries,\n  replayHash,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { scanHistoryDrift } from \"../../core/history/drift-scan.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { listAllFrontMatterWithBody, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/**\n * Documents the history repair command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairCommandOptions {\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the history repair result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  history: {\n    path: string;\n    entries_scanned: number;\n    chain_drift_before: boolean;\n    entries_rehashed: number;\n    entries_patch_repaired: number;\n    converted_replace_to_add: number;\n    skipped_ops: number;\n    reconciled_with_item: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\nfunction toAuthor(candidate: string | undefined, defaultAuthor: string): string {\n  /* c8 ignore next -- PM_AUTHOR fallback branch is environment-dependent in CI. */\n  const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;\n  const trimmed = resolved.trim();\n  return trimmed.length > 0 ? trimmed : \"unknown\";\n}\n\n/**\n * Implements run history repair for the public runtime surface of this module.\n */\nexport async function runHistoryRepair(\n  id: string,\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(`No history stream exists for ${subject.id}.`, EXIT_CODE.NOT_FOUND);\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(subject.historyPath, subject.id);\n  if (historyEntries.length === 0) {\n    throw new PmCliError(`No history entries exist for ${subject.id}; nothing to repair.`, EXIT_CODE.USAGE);\n  }\n\n  const chainBefore = verifyHistoryChain(historyEntries);\n  const reanchor = reanchorHistoryEntries(historyEntries);\n\n  // Reconcile the replayed chain with the current on-disk item document so the\n  // latest after_hash matches what pm validate/health compute for the item.\n  let currentItemReplay: ReplayDocument | null = null;\n  const currentItemPath: string | null = subject.located?.itemPath ?? null;\n  let matchedChainBefore: boolean | null = null;\n  const loadedItem = subject.located\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : null;\n  const currentItemRawBeforeLock = loadedItem?.raw ?? null;\n  if (loadedItem) {\n    // Use the shared canonical replay form so reconciliation hashing matches the\n    // semantics pm validate/health use for the on-disk item (avoids hash divergence).\n    currentItemReplay = toReplayDocument(loadedItem.document);\n    const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;\n    matchedChainBefore = replayHash(currentItemReplay) === lastOriginalAfterHash;\n  }\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    currentItemReplay !== null && replayHash(finalReplay) !== replayHash(currentItemReplay);\n\n  const changed = reanchor.entriesRehashed > 0 || reanchor.entriesPatchRepaired > 0 || reconcileNeeded;\n  const author = toAuthor(options.author, settings.author_default);\n  const dryRun = Boolean(options.dryRun);\n\n  const repairMessage =\n    /* c8 ignore next -- generated repair summaries include optional clauses based on rare drift shapes. */\n    typeof options.message === \"string\" && options.message.trim().length > 0\n      ? options.message\n      : `history-repair re-anchored ${reanchor.entriesRehashed} entr${\n          reanchor.entriesRehashed === 1 ? \"y\" : \"ies\"\n        }${reanchor.entriesPatchRepaired > 0 ? `, repaired ${reanchor.entriesPatchRepaired} patch(es)` : \"\"}${\n          reconcileNeeded ? \", reconciled chain with on-disk item\" : \"\"\n        }.`;\n\n  const rewrittenEntries: HistoryEntry[] = [...reanchor.entries];\n  let auditEntryAdded = false;\n  if (changed) {\n    /* c8 ignore next -- reconcile append branch requires hash-drift plus loadable on-disk replay. */\n    if (reconcileNeeded && currentItemReplay) {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: jsonPatch.compare(finalReplay, currentItemReplay) as HistoryPatchOp[],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(currentItemReplay),\n        message: repairMessage,\n      });\n    } else {\n      rewrittenEntries.push({\n        ts: nowIso(),\n        author,\n        op: \"history_repair\",\n        patch: [],\n        before_hash: replayHash(finalReplay),\n        after_hash: replayHash(finalReplay),\n        message: repairMessage,\n      });\n    }\n    auditEntryAdded = true;\n  }\n\n  const historyVerify = verifyHistoryChain(rewrittenEntries);\n  if (!historyVerify.ok) {\n    throw new PmCliError(\n      `history-repair produced an invalid rewritten chain (${historyVerify.errors.join(\", \")}).`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_repair_no_changes\");\n  }\n  if (reanchor.skippedOps > 0) {\n    warnings.push(`history_repair_skipped_unresolvable_ops:${reanchor.skippedOps}`);\n  }\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...(await executeHistoryRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock,\n        operation: \"history-repair\",\n        author,\n        force: options.force,\n        itemDocument: loadedItem?.document ?? null,\n        applyRewrite: async ({ historyRawUnderLock }) => {\n          try {\n            await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));\n          } catch (error) {\n            if (historyRawUnderLock === null) {\n              await fs.rm(subject.historyPath, { force: true });\n            } else {\n              await writeFileAtomic(subject.historyPath, historyRawUnderLock);\n            }\n            throw error;\n          }\n        },\n        applyPostRewrite: async () =>\n          runActiveOnWriteHooks({\n            path: subject.historyPath,\n            scope: \"project\",\n            op: \"history_repair:history\",\n          }),\n      })),\n    );\n  }\n\n  return {\n    id: subject.id,\n    dry_run: dryRun,\n    changed,\n    history: {\n      path: subject.historyPath,\n      entries_scanned: historyEntries.length,\n      chain_drift_before: !chainBefore.ok,\n      entries_rehashed: reanchor.entriesRehashed,\n      entries_patch_repaired: reanchor.entriesPatchRepaired,\n      converted_replace_to_add: reanchor.convertedReplaceToAdd,\n      skipped_ops: reanchor.skippedOps,\n      reconciled_with_item: reconcileNeeded,\n      audit_entry_added: auditEntryAdded,\n      verify_ok: historyVerify.ok,\n      verify_errors: historyVerify.errors,\n    },\n    item: {\n      exists: currentItemPath !== null,\n      path: currentItemPath,\n      matched_chain_before: matchedChainBefore,\n    },\n    warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n\n/**\n * Documents the history repair all stream result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairAllStreamResult {\n  id: string;\n  outcome: \"repaired\" | \"skipped_clean\" | \"failed\";\n  entries_rehashed?: number;\n  entries_patch_repaired?: number;\n  reconciled_with_item?: boolean;\n  error?: string;\n}\n\n/**\n * Documents the history repair all result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairAllResult {\n  all: true;\n  dry_run: boolean;\n  scanned_streams: number;\n  drifted_streams: number;\n  /** One compact row per drifted stream (clean streams are summarized by the counts only). */\n  streams: HistoryRepairAllStreamResult[];\n  totals: { repaired: number; skipped_clean: number; failed: number };\n  warnings: string[];\n  generated_at: string;\n}\n\n/**\n * Enforce the `pm history-repair` target contract shared by the CLI and MCP\n * surfaces: exactly one of an item `<id>` or `--all` must be provided.\n */\nexport function assertHistoryRepairTarget(id: string | undefined, all: boolean): void {\n  if (all && id !== undefined) {\n    throw new PmCliError(\n      \"history-repair: <id> and --all are mutually exclusive; pass an item id to repair one stream or --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (!all && id === undefined) {\n    throw new PmCliError(\n      \"history-repair: provide an item <id> or pass --all to repair every drifted stream.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\n/**\n * Bulk drift repair: scan every item's history stream with the same drift scan\n * `pm health` uses, then run the audited single-stream repair (ownership check,\n * lock, no-drift verification, audit marker) for each drifted stream. One\n * failing stream never aborts the rest; failures are collected per row and the\n * caller decides the exit code from `totals.failed`.\n */\nexport async function runHistoryRepairAll(\n  options: HistoryRepairCommandOptions,\n  global: GlobalOptions,\n): Promise<HistoryRepairAllResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const itemReadWarnings: string[] = [];\n  const items = await listAllFrontMatterWithBody(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    itemReadWarnings,\n    settings.schema,\n  );\n  const drift = await scanHistoryDrift(pmRoot, items as Array<ItemMetadata & { body: string }>);\n\n  const streams: HistoryRepairAllStreamResult[] = [];\n  const totals = { repaired: 0, skipped_clean: 0, failed: 0 };\n  for (const driftedId of drift.driftedItems) {\n    try {\n      const result = await runHistoryRepair(driftedId, options, global);\n      /* c8 ignore next -- mixed repaired/clean outcomes depend on live drift composition. */\n      const outcome = result.changed ? \"repaired\" : \"skipped_clean\";\n      totals[outcome] += 1;\n      streams.push({\n        id: driftedId,\n        outcome,\n        entries_rehashed: result.history.entries_rehashed,\n        entries_patch_repaired: result.history.entries_patch_repaired,\n        reconciled_with_item: result.history.reconciled_with_item,\n      });\n    } catch (error) {\n      totals.failed += 1;\n      streams.push({\n        id: driftedId,\n        outcome: \"failed\",\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  return {\n    all: true,\n    dry_run: Boolean(options.dryRun),\n    scanned_streams: items.length,\n    drifted_streams: drift.driftedItems.length,\n    streams,\n    totals,\n    warnings: [...new Set(itemReadWarnings)].sort((left, right) => left.localeCompare(right)),\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3696f386-1731-5e09-adb5-74cebd450c27"}

package/dist/cli-bundle/chunks/init-PAX32BJA.js

@@ -1,22 +0,0 @@
-import {
-  _testOnly,
-  runInit,
-  summarizeInitResult
-} from "./chunk-YITK2PJ6.js";
-import "./chunk-5QFDBI4F.js";
-import "./chunk-5HIZDR5A.js";
-import "./chunk-RMMQ74TG.js";
-import "./chunk-LB6TP6MC.js";
-import "./chunk-SDR5J34Q.js";
-import "./chunk-RH5ZBYFD.js";
-import "./chunk-MDPEOIGN.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
-export {
-  _testOnly,
-  runInit,
-  summarizeInitResult
-};
-//# sourceMappingURL=init-PAX32BJA.js.map

package/dist/cli-bundle/chunks/next-BCERKDUR.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/next.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/next\n *\n * Implements the `pm next` command: the distilled \"what should I work on now?\"\n * query. It loads the active corpus, computes dependency-aware actionability\n * (ready vs blocked leaf work), and returns a single ranked recommendation with a\n * deterministic rationale plus the ranked ready/blocked queues — so an agent gets\n * the next action and the reason for it in one token-efficient read instead of\n * re-deriving readiness from a full `pm context` snapshot every turn.\n */\nimport {\n  collectBlockedByIds,\n  computeActionabilityReport,\n  type ActionableEntry,\n} from \"../../core/item/actionability.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput, normalizeStatusForRegistry } from \"../../core/item/status.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, ItemStatus } from \"../../types/index.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport {\n  buildChildrenByParent,\n  collectSubtreeIds,\n  compareCriticalItems,\n  toContextFocusItem,\n  type ContextFocusItem,\n} from \"./context.js\";\nimport { runList, type ListOptions } from \"./list.js\";\n\nexport const NEXT_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\n/**\n * Restricts `pm next` output format values accepted by command, SDK, and storage contracts.\n */\nexport type NextOutputFormat = (typeof NEXT_OUTPUT_VALUES)[number];\n\nconst DEFAULT_NEXT_LIMIT = 5;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\n\n/**\n * Documents the `pm next` options payload exchanged by command, SDK, and package integrations.\n */\nexport interface NextOptions {\n  type?: string;\n  tag?: string;\n  priority?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  sprint?: string;\n  release?: string;\n  parent?: string;\n  limit?: string;\n  blockedLimit?: string;\n  readyOnly?: boolean;\n  format?: string;\n  [key: string]: unknown;\n}\n\n/** A blocker reference projected onto the `pm next` output. */\nexport interface NextBlockerRef {\n  id: string;\n  title: string | null;\n  status: ItemStatus | null;\n}\n\n/**\n * A classified actionable item on the `pm next` output: a {@link ContextFocusItem}\n * focus row augmented with its open-blocker references and the downstream items it\n * would unblock.\n */\nexport interface NextActionableItem extends ContextFocusItem {\n  open_blocker_count: number;\n  blockers: NextBlockerRef[];\n  unblocks: string[];\n}\n\n/** The single recommended next item: an actionable row plus its rationale. */\nexport interface NextRecommendation extends NextActionableItem {\n  reasons: string[];\n}\n\ninterface NextSummary {\n  recommended: boolean;\n  ready: number;\n  blocked: number;\n  in_progress: number;\n  candidates: number;\n  containers: number;\n}\n\n/**\n * Documents the `pm next` result payload exchanged by command, SDK, and package integrations.\n */\nexport interface NextResult {\n  output_default: \"toon\";\n  now: string;\n  recommended: NextRecommendation | null;\n  ready: NextActionableItem[];\n  blocked: NextActionableItem[];\n  summary: NextSummary;\n  filters: {\n    type: string | null;\n    tag: string | null;\n    priority: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    sprint: string | null;\n    release: string | null;\n    parent: string | null;\n    limit: number;\n    blocked_limit: number;\n    ready_only: boolean;\n  };\n  suggestions?: string[];\n  warnings?: string[];\n}\n\nfunction parseNextOutputFormat(raw: string | undefined): NextOutputFormat | undefined {\n  if (!raw) return undefined;\n  const normalized = raw.trim().toLowerCase();\n  if (!NEXT_OUTPUT_VALUES.includes(normalized as NextOutputFormat)) {\n    throw new PmCliError(\"Next format must be one of markdown|toon|json\", EXIT_CODE.USAGE);\n  }\n  return normalized as NextOutputFormat;\n}\n\n/**\n * Resolves the effective `pm next` output format from the command `--format` flag\n * and the global `--json` switch, rejecting the contradictory `--json --format\n * markdown|toon` combination. Defaults to `toon`.\n */\nexport function resolveNextOutputFormat(options: NextOptions, global: GlobalOptions): NextOutputFormat {\n  const commandFormat = parseNextOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\"Cannot combine --json with --format markdown|toon\", EXIT_CODE.USAGE);\n  }\n  if (global.json) {\n    return \"json\";\n  }\n  return commandFormat ?? \"toon\";\n}\n\n// Per-section row cap. A non-positive or absent value falls back to the default;\n// invalid (non-integer) values throw via parseIntegerLimit.\nfunction parseNextLimit(raw: string | undefined, flag: string, fallback: number): number {\n  const parsed = parseIntegerLimit(raw, flag);\n  if (parsed === undefined || parsed <= 0) return fallback;\n  return parsed;\n}\n\n// Projects an actionable entry onto its output row. Ready entries carry no\n// blockers; blocked entries surface their unresolved blockers for the agent.\nfunction toNextActionableItem(\n  entry: ActionableEntry,\n  statusRegistry: RuntimeStatusRegistry,\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n): NextActionableItem {\n  return {\n    ...toContextFocusItem(entry.item, statusRegistry, childrenByParent),\n    open_blocker_count: entry.open_blockers.length,\n    blockers: entry.open_blockers.map((blocker) => ({ id: blocker.id, title: blocker.title, status: blocker.status })),\n    unblocks: entry.unblocks,\n  };\n}\n\n// Builds the human+agent readable rationale for the recommended item, ordering\n// clauses from most to least decisive (status, priority, deadline, blocker\n// clearance, parent advancement, downstream unblocks).\nfunction buildRecommendationReasons(\n  entry: ActionableEntry,\n  statusRegistry: RuntimeStatusRegistry,\n  now: string,\n  completedContainer: boolean,\n): string[] {\n  const item = entry.item;\n  const reasons: string[] = [];\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  reasons.push(\n    normalizeStatusForRegistry(item.status, statusRegistry) === inProgressStatus\n      ? \"in progress — resume to finish\"\n      : \"open and ready to start\",\n  );\n  if (completedContainer) {\n    reasons.push(\"completed container — governance closeout\");\n  }\n  reasons.push(`priority p${item.priority}${item.priority === 0 ? \" (highest)\" : \"\"}`);\n  if (typeof item.deadline === \"string\" && item.deadline.trim().length > 0) {\n    reasons.push(describeDeadline(item.deadline, now));\n  }\n  reasons.push(collectBlockedByIds(item).length > 0 ? \"all blockers resolved\" : \"no blockers\");\n  if (typeof item.parent === \"string\" && item.parent.trim().length > 0) {\n    reasons.push(`advances ${item.parent.trim()}`);\n  }\n  if (entry.unblocks.length > 0) {\n    reasons.push(`unblocks ${entry.unblocks.length} item(s): ${entry.unblocks.join(\", \")}`);\n  }\n  return reasons;\n}\n\n// Renders a deadline as a date token plus a relative tag (overdue/today/in Nd).\n// The relative delta is computed on UTC calendar dates (both sides normalized to\n// midnight) so a deadline due today never reads as \"overdue 1d\" just because the\n// wall-clock time of `now` has passed midnight. Unparseable deadlines degrade to\n// the raw token (defensive — stored deadlines are always valid ISO).\nfunction describeDeadline(deadline: string, now: string): string {\n  const deadlineMs = Date.parse(deadline);\n  /* c8 ignore start -- defensive: a stored deadline that fails Date.parse still surfaces its raw token */\n  if (!Number.isFinite(deadlineMs)) {\n    return `deadline ${deadline.trim()}`;\n  }\n  /* c8 ignore stop */\n  const dateToken = new Date(deadlineMs).toISOString().slice(0, 10);\n  const nowToken = new Date(Date.parse(now)).toISOString().slice(0, 10);\n  const days = Math.round((Date.parse(dateToken) - Date.parse(nowToken)) / MS_PER_DAY);\n  if (days < 0) return `deadline ${dateToken} (overdue ${-days}d)`;\n  if (days === 0) return `deadline ${dateToken} (due today)`;\n  return `deadline ${dateToken} (in ${days}d)`;\n}\n\nfunction inProgressReadyCount(ready: NextActionableItem[], statusRegistry: RuntimeStatusRegistry): number {\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  return ready.filter((item) => normalizeStatusForRegistry(item.status, statusRegistry) === inProgressStatus).length;\n}\n\n// Returns true when an otherwise-ready item still has terminal descendants. Such\n// rows are useful governance closeout context, but concrete leaf work should rank\n// ahead of them in the default agent loop.\nfunction hasCompletedDescendants(item: ItemFrontMatter, childrenByParent: Map<string, ItemFrontMatter[]>): boolean {\n  return (childrenByParent.get(item.id.trim().toLowerCase()) ?? []).length > 0;\n}\n\n// Strips projection/pagination flags so the corpus reads stay full: limits are\n// per-section display caps applied after classification, never corpus filters.\nfunction nextListOptions(options: NextOptions, extra: Partial<ListOptions>): ListOptions {\n  return {\n    type: options.type,\n    tag: options.tag,\n    priority: options.priority,\n    assignee: options.assignee,\n    assigneeFilter: options.assigneeFilter,\n    sprint: options.sprint,\n    release: options.release,\n    noTruncate: true,\n    ...extra,\n  };\n}\n\n/**\n * Implements `pm next`: computes the ranked ready/blocked actionable queues and a\n * single recommended next item with rationale for the public runtime surface.\n */\nexport async function runNext(options: NextOptions, global: GlobalOptions): Promise<NextResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const now = nowIso();\n  const limit = parseNextLimit(options.limit, \"--limit\", DEFAULT_NEXT_LIMIT);\n  const blockedLimit = parseNextLimit(options.blockedLimit, \"--blocked-limit\", limit);\n  const readyOnly = options.readyOnly === true;\n  const parentScope = typeof options.parent === \"string\" ? options.parent.trim() : \"\";\n\n  // Active (non-terminal) candidates honor the caller's filters; the corpus is the\n  // FULL, UNFILTERED set (every status, every item) so blocker and descendant\n  // resolution still sees items outside the caller's filters or --parent subtree —\n  // otherwise a real blocker assigned to someone else (or a parent of a different\n  // type) would be missing and the blocked item misread as ready.\n  const candidatesList = await runList(undefined, nextListOptions(options, { excludeTerminal: true }), global);\n  const corpusList = await runList(undefined, { excludeTerminal: false, noTruncate: true }, global);\n  let candidates = candidatesList.items as ItemFrontMatter[];\n  const corpus = corpusList.items as ItemFrontMatter[];\n\n  if (parentScope.length > 0) {\n    const subtree = collectSubtreeIds(corpus, parentScope);\n    if (!subtree.found) {\n      throw new PmCliError(`Next --parent item not found: ${parentScope}`, EXIT_CODE.NOT_FOUND);\n    }\n    candidates = candidates.filter((item) => subtree.ids.has(item.id.trim().toLowerCase()));\n  }\n\n  const report = computeActionabilityReport(candidates, corpus, statusRegistry);\n  const childrenByParent = buildChildrenByParent(corpus);\n  const rankedReady = [...report.ready].sort((left, right) => {\n    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);\n    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);\n    if (leftCompletedContainer !== rightCompletedContainer) {\n      return Number(leftCompletedContainer) - Number(rightCompletedContainer);\n    }\n    return compareCriticalItems(left.item, right.item, statusRegistry);\n  });\n  const rankedBlocked = [...report.blocked].sort((left, right) =>\n    compareCriticalItems(left.item, right.item, statusRegistry),\n  );\n  const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));\n  const projectedReady = concreteReady.length > 0 ? concreteReady : rankedReady;\n\n  const readyRows = projectedReady.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));\n  const blockedRows = rankedBlocked.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));\n\n  const recommended: NextRecommendation | null =\n    projectedReady.length > 0\n      ? {\n          ...readyRows[0],\n          reasons: buildRecommendationReasons(\n            projectedReady[0],\n            statusRegistry,\n            now,\n            concreteReady.length === 0,\n          ),\n        }\n      : null;\n\n  const result: NextResult = {\n    output_default: \"toon\",\n    now,\n    recommended,\n    ready: readyRows.slice(0, limit),\n    blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),\n    summary: {\n      recommended: recommended !== null,\n      ready: readyRows.length,\n      blocked: blockedRows.length,\n      in_progress: inProgressReadyCount(readyRows, statusRegistry),\n      candidates: report.active_count,\n      containers: report.container_count,\n    },\n    filters: {\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      parent: parentScope.length > 0 ? parentScope : null,\n      limit,\n      blocked_limit: blockedLimit,\n      ready_only: readyOnly,\n    },\n  };\n\n  const warnings = [...new Set([...(candidatesList.warnings ?? []), ...(corpusList.warnings ?? [])])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  if (warnings.length > 0) result.warnings = warnings;\n\n  if (recommended === null) {\n    result.suggestions =\n      blockedRows.length > 0\n        ? [\n            `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers\n              .map((blocker) => blocker.id)\n              .join(\", \")}`,\n            \"pm next --ready-only after a blocker closes to re-check ready work\",\n            'pm create --type Task --title \"...\" to add new ready work',\n          ]\n        : [\n            'pm create --type Task --title \"...\" to add a new work item',\n            \"pm list --status in_progress to review work already underway\",\n            \"pm context --depth deep for the full project snapshot\",\n          ];\n  }\n\n  return result;\n}\n\n/**\n * Renders a {@link NextResult} as compact agent-readable markdown: the\n * recommendation with its rationale, the ranked ready queue, and (unless\n * `--ready-only`) the blocked queue annotated with each item's open blockers.\n */\nexport function renderNextMarkdown(result: NextResult): string {\n  const lines: string[] = [\"# pm next\", \"\"];\n  lines.push(`- now: ${result.now}`);\n  lines.push(\n    `- ready: ${result.summary.ready} (in_progress: ${result.summary.in_progress}), blocked: ${result.summary.blocked}, candidates: ${result.summary.candidates}`,\n  );\n  if (result.filters.parent) {\n    lines.push(`- scope: subtree of ${result.filters.parent}`);\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Recommended\");\n  if (result.recommended) {\n    lines.push(`- ${formatNextLine(result.recommended)}`);\n    lines.push(`  why: ${result.recommended.reasons.join(\"; \")}`);\n  } else {\n    lines.push(\"No ready work.\");\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Ready\");\n  if (result.ready.length === 0) {\n    lines.push(\"No ready items.\");\n  } else {\n    for (const item of result.ready) {\n      lines.push(`- ${formatNextLine(item)}`);\n    }\n  }\n  lines.push(\"\");\n\n  if (!result.filters.ready_only) {\n    lines.push(\"## Blocked\");\n    if (result.blocked.length === 0) {\n      lines.push(\"No blocked items.\");\n    } else {\n      for (const item of result.blocked) {\n        const by = item.blockers\n          .map((blocker) => `${blocker.id}(${blocker.status ?? \"?\"})`)\n          .join(\", \");\n        lines.push(`- ${formatNextLine(item)} blocked_by:${by}`);\n      }\n    }\n    lines.push(\"\");\n  }\n\n  if (result.suggestions && result.suggestions.length > 0) {\n    lines.push(\"## Suggestions\");\n    for (const suggestion of result.suggestions) {\n      lines.push(`- ${suggestion}`);\n    }\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n}\n\n// Formats a single actionable row: id, priority, status, type, deadline, parent,\n// downstream-unblock count, and title. Mirrors the context focus-line shape.\nfunction formatNextLine(item: NextActionableItem): string {\n  const deadlineToken = item.deadline ?? \"-\";\n  const parentToken = item.parent ? ` parent:${item.parent}` : \"\";\n  const unblocksToken = item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : \"\";\n  return `${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;\n}\n"],
-  "mappings": "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",
-  "names": ["global"]
-}

package/dist/cli-bundle/chunks/next-FYTQF6HG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/next.ts"],"sourcesContent":["/**\n * @module cli/commands/next\n *\n * Implements the `pm next` command: the distilled \"what should I work on now?\"\n * query. It loads the active corpus, computes dependency-aware actionability\n * (ready vs blocked leaf work), and returns a single ranked recommendation with a\n * deterministic rationale plus the ranked ready/blocked queues — so an agent gets\n * the next action and the reason for it in one token-efficient read instead of\n * re-deriving readiness from a full `pm context` snapshot every turn.\n */\nimport {\n  collectBlockedByIds,\n  computeActionabilityReport,\n  type ActionableEntry,\n} from \"../../core/item/actionability.js\";\nimport { resolveRuntimeStatusRegistry, type RuntimeStatusRegistry } from \"../../core/schema/runtime-schema.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { normalizeStatusInput, normalizeStatusForRegistry } from \"../../core/item/status.js\";\nimport { resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemFrontMatter, ItemStatus } from \"../../types/index.js\";\nimport { parseIntegerLimit } from \"../shared-parsers.js\";\nimport {\n  buildChildrenByParent,\n  collectSubtreeIds,\n  compareCriticalItems,\n  toContextFocusItem,\n  type ContextFocusItem,\n} from \"./context.js\";\nimport { runList, type ListOptions } from \"./list.js\";\n\nexport const NEXT_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\n/**\n * Restricts `pm next` output format values accepted by command, SDK, and storage contracts.\n */\nexport type NextOutputFormat = (typeof NEXT_OUTPUT_VALUES)[number];\n\nconst DEFAULT_NEXT_LIMIT = 5;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\n\n/**\n * Documents the `pm next` options payload exchanged by command, SDK, and package integrations.\n */\nexport interface NextOptions {\n  type?: string;\n  tag?: string;\n  priority?: string;\n  assignee?: string;\n  assigneeFilter?: string;\n  sprint?: string;\n  release?: string;\n  parent?: string;\n  limit?: string;\n  blockedLimit?: string;\n  readyOnly?: boolean;\n  format?: string;\n  [key: string]: unknown;\n}\n\n/** A blocker reference projected onto the `pm next` output. */\nexport interface NextBlockerRef {\n  id: string;\n  title: string | null;\n  status: ItemStatus | null;\n}\n\n/**\n * A classified actionable item on the `pm next` output: a {@link ContextFocusItem}\n * focus row augmented with its open-blocker references and the downstream items it\n * would unblock.\n */\nexport interface NextActionableItem extends ContextFocusItem {\n  open_blocker_count: number;\n  blockers: NextBlockerRef[];\n  unblocks: string[];\n}\n\n/** The single recommended next item: an actionable row plus its rationale. */\nexport interface NextRecommendation extends NextActionableItem {\n  reasons: string[];\n}\n\ninterface NextSummary {\n  recommended: boolean;\n  ready: number;\n  blocked: number;\n  in_progress: number;\n  candidates: number;\n  containers: number;\n}\n\n/**\n * Documents the `pm next` result payload exchanged by command, SDK, and package integrations.\n */\nexport interface NextResult {\n  output_default: \"toon\";\n  now: string;\n  recommended: NextRecommendation | null;\n  ready: NextActionableItem[];\n  blocked: NextActionableItem[];\n  summary: NextSummary;\n  filters: {\n    type: string | null;\n    tag: string | null;\n    priority: string | null;\n    assignee: string | null;\n    assignee_filter: string | null;\n    sprint: string | null;\n    release: string | null;\n    parent: string | null;\n    limit: number;\n    blocked_limit: number;\n    ready_only: boolean;\n  };\n  suggestions?: string[];\n  warnings?: string[];\n}\n\nfunction parseNextOutputFormat(raw: string | undefined): NextOutputFormat | undefined {\n  if (!raw) return undefined;\n  const normalized = raw.trim().toLowerCase();\n  if (!NEXT_OUTPUT_VALUES.includes(normalized as NextOutputFormat)) {\n    throw new PmCliError(\"Next format must be one of markdown|toon|json\", EXIT_CODE.USAGE);\n  }\n  return normalized as NextOutputFormat;\n}\n\n/**\n * Resolves the effective `pm next` output format from the command `--format` flag\n * and the global `--json` switch, rejecting the contradictory `--json --format\n * markdown|toon` combination. Defaults to `toon`.\n */\nexport function resolveNextOutputFormat(options: NextOptions, global: GlobalOptions): NextOutputFormat {\n  const commandFormat = parseNextOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\"Cannot combine --json with --format markdown|toon\", EXIT_CODE.USAGE);\n  }\n  if (global.json) {\n    return \"json\";\n  }\n  return commandFormat ?? \"toon\";\n}\n\n// Per-section row cap. A non-positive or absent value falls back to the default;\n// invalid (non-integer) values throw via parseIntegerLimit.\nfunction parseNextLimit(raw: string | undefined, flag: string, fallback: number): number {\n  const parsed = parseIntegerLimit(raw, flag);\n  if (parsed === undefined || parsed <= 0) return fallback;\n  return parsed;\n}\n\n// Projects an actionable entry onto its output row. Ready entries carry no\n// blockers; blocked entries surface their unresolved blockers for the agent.\nfunction toNextActionableItem(\n  entry: ActionableEntry,\n  statusRegistry: RuntimeStatusRegistry,\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n): NextActionableItem {\n  return {\n    ...toContextFocusItem(entry.item, statusRegistry, childrenByParent),\n    open_blocker_count: entry.open_blockers.length,\n    blockers: entry.open_blockers.map((blocker) => ({ id: blocker.id, title: blocker.title, status: blocker.status })),\n    unblocks: entry.unblocks,\n  };\n}\n\n// Builds the human+agent readable rationale for the recommended item, ordering\n// clauses from most to least decisive (status, priority, deadline, blocker\n// clearance, parent advancement, downstream unblocks).\nfunction buildRecommendationReasons(\n  entry: ActionableEntry,\n  statusRegistry: RuntimeStatusRegistry,\n  now: string,\n  completedContainer: boolean,\n): string[] {\n  const item = entry.item;\n  const reasons: string[] = [];\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  reasons.push(\n    normalizeStatusForRegistry(item.status, statusRegistry) === inProgressStatus\n      ? \"in progress — resume to finish\"\n      : \"open and ready to start\",\n  );\n  if (completedContainer) {\n    reasons.push(\"completed container — governance closeout\");\n  }\n  reasons.push(`priority p${item.priority}${item.priority === 0 ? \" (highest)\" : \"\"}`);\n  if (typeof item.deadline === \"string\" && item.deadline.trim().length > 0) {\n    reasons.push(describeDeadline(item.deadline, now));\n  }\n  reasons.push(collectBlockedByIds(item).length > 0 ? \"all blockers resolved\" : \"no blockers\");\n  if (typeof item.parent === \"string\" && item.parent.trim().length > 0) {\n    reasons.push(`advances ${item.parent.trim()}`);\n  }\n  if (entry.unblocks.length > 0) {\n    reasons.push(`unblocks ${entry.unblocks.length} item(s): ${entry.unblocks.join(\", \")}`);\n  }\n  return reasons;\n}\n\n// Renders a deadline as a date token plus a relative tag (overdue/today/in Nd).\n// The relative delta is computed on UTC calendar dates (both sides normalized to\n// midnight) so a deadline due today never reads as \"overdue 1d\" just because the\n// wall-clock time of `now` has passed midnight. Unparseable deadlines degrade to\n// the raw token (defensive — stored deadlines are always valid ISO).\nfunction describeDeadline(deadline: string, now: string): string {\n  const deadlineMs = Date.parse(deadline);\n  /* c8 ignore start -- defensive: a stored deadline that fails Date.parse still surfaces its raw token */\n  if (!Number.isFinite(deadlineMs)) {\n    return `deadline ${deadline.trim()}`;\n  }\n  /* c8 ignore stop */\n  const dateToken = new Date(deadlineMs).toISOString().slice(0, 10);\n  const nowToken = new Date(Date.parse(now)).toISOString().slice(0, 10);\n  const days = Math.round((Date.parse(dateToken) - Date.parse(nowToken)) / MS_PER_DAY);\n  if (days < 0) return `deadline ${dateToken} (overdue ${-days}d)`;\n  if (days === 0) return `deadline ${dateToken} (due today)`;\n  return `deadline ${dateToken} (in ${days}d)`;\n}\n\nfunction inProgressReadyCount(ready: NextActionableItem[], statusRegistry: RuntimeStatusRegistry): number {\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  return ready.filter((item) => normalizeStatusForRegistry(item.status, statusRegistry) === inProgressStatus).length;\n}\n\n// Returns true when an otherwise-ready item still has terminal descendants. Such\n// rows are useful governance closeout context, but concrete leaf work should rank\n// ahead of them in the default agent loop.\nfunction hasCompletedDescendants(item: ItemFrontMatter, childrenByParent: Map<string, ItemFrontMatter[]>): boolean {\n  return (childrenByParent.get(item.id.trim().toLowerCase()) ?? []).length > 0;\n}\n\n// Strips projection/pagination flags so the corpus reads stay full: limits are\n// per-section display caps applied after classification, never corpus filters.\nfunction nextListOptions(options: NextOptions, extra: Partial<ListOptions>): ListOptions {\n  return {\n    type: options.type,\n    tag: options.tag,\n    priority: options.priority,\n    assignee: options.assignee,\n    assigneeFilter: options.assigneeFilter,\n    sprint: options.sprint,\n    release: options.release,\n    noTruncate: true,\n    ...extra,\n  };\n}\n\n/**\n * Implements `pm next`: computes the ranked ready/blocked actionable queues and a\n * single recommended next item with rationale for the public runtime surface.\n */\nexport async function runNext(options: NextOptions, global: GlobalOptions): Promise<NextResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const now = nowIso();\n  const limit = parseNextLimit(options.limit, \"--limit\", DEFAULT_NEXT_LIMIT);\n  const blockedLimit = parseNextLimit(options.blockedLimit, \"--blocked-limit\", limit);\n  const readyOnly = options.readyOnly === true;\n  const parentScope = typeof options.parent === \"string\" ? options.parent.trim() : \"\";\n\n  // Active (non-terminal) candidates honor the caller's filters; the corpus is the\n  // FULL, UNFILTERED set (every status, every item) so blocker and descendant\n  // resolution still sees items outside the caller's filters or --parent subtree —\n  // otherwise a real blocker assigned to someone else (or a parent of a different\n  // type) would be missing and the blocked item misread as ready.\n  const candidatesList = await runList(undefined, nextListOptions(options, { excludeTerminal: true }), global);\n  const corpusList = await runList(undefined, { excludeTerminal: false, noTruncate: true }, global);\n  let candidates = candidatesList.items as ItemFrontMatter[];\n  const corpus = corpusList.items as ItemFrontMatter[];\n\n  if (parentScope.length > 0) {\n    const subtree = collectSubtreeIds(corpus, parentScope);\n    if (!subtree.found) {\n      throw new PmCliError(`Next --parent item not found: ${parentScope}`, EXIT_CODE.NOT_FOUND);\n    }\n    candidates = candidates.filter((item) => subtree.ids.has(item.id.trim().toLowerCase()));\n  }\n\n  const report = computeActionabilityReport(candidates, corpus, statusRegistry);\n  const childrenByParent = buildChildrenByParent(corpus);\n  const rankedReady = [...report.ready].sort((left, right) => {\n    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);\n    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);\n    if (leftCompletedContainer !== rightCompletedContainer) {\n      return Number(leftCompletedContainer) - Number(rightCompletedContainer);\n    }\n    return compareCriticalItems(left.item, right.item, statusRegistry);\n  });\n  const rankedBlocked = [...report.blocked].sort((left, right) =>\n    compareCriticalItems(left.item, right.item, statusRegistry),\n  );\n  const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));\n  const projectedReady = concreteReady.length > 0 ? concreteReady : rankedReady;\n\n  const readyRows = projectedReady.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));\n  const blockedRows = rankedBlocked.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));\n\n  const recommended: NextRecommendation | null =\n    projectedReady.length > 0\n      ? {\n          ...readyRows[0],\n          reasons: buildRecommendationReasons(\n            projectedReady[0],\n            statusRegistry,\n            now,\n            concreteReady.length === 0,\n          ),\n        }\n      : null;\n\n  const result: NextResult = {\n    output_default: \"toon\",\n    now,\n    recommended,\n    ready: readyRows.slice(0, limit),\n    blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),\n    summary: {\n      recommended: recommended !== null,\n      ready: readyRows.length,\n      blocked: blockedRows.length,\n      in_progress: inProgressReadyCount(readyRows, statusRegistry),\n      candidates: report.active_count,\n      containers: report.container_count,\n    },\n    filters: {\n      type: options.type ?? null,\n      tag: options.tag ?? null,\n      priority: options.priority ?? null,\n      assignee: options.assignee ?? null,\n      assignee_filter: options.assigneeFilter ?? null,\n      sprint: options.sprint ?? null,\n      release: options.release ?? null,\n      parent: parentScope.length > 0 ? parentScope : null,\n      limit,\n      blocked_limit: blockedLimit,\n      ready_only: readyOnly,\n    },\n  };\n\n  const warnings = [...new Set([...(candidatesList.warnings ?? []), ...(corpusList.warnings ?? [])])].sort((a, b) =>\n    a.localeCompare(b),\n  );\n  if (warnings.length > 0) result.warnings = warnings;\n\n  if (recommended === null) {\n    result.suggestions =\n      blockedRows.length > 0\n        ? [\n            `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers\n              .map((blocker) => blocker.id)\n              .join(\", \")}`,\n            \"pm next --ready-only after a blocker closes to re-check ready work\",\n            'pm create --type Task --title \"...\" to add new ready work',\n          ]\n        : [\n            'pm create --type Task --title \"...\" to add a new work item',\n            \"pm list --status in_progress to review work already underway\",\n            \"pm context --depth deep for the full project snapshot\",\n          ];\n  }\n\n  return result;\n}\n\n/**\n * Renders a {@link NextResult} as compact agent-readable markdown: the\n * recommendation with its rationale, the ranked ready queue, and (unless\n * `--ready-only`) the blocked queue annotated with each item's open blockers.\n */\nexport function renderNextMarkdown(result: NextResult): string {\n  const lines: string[] = [\"# pm next\", \"\"];\n  lines.push(`- now: ${result.now}`);\n  lines.push(\n    `- ready: ${result.summary.ready} (in_progress: ${result.summary.in_progress}), blocked: ${result.summary.blocked}, candidates: ${result.summary.candidates}`,\n  );\n  if (result.filters.parent) {\n    lines.push(`- scope: subtree of ${result.filters.parent}`);\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Recommended\");\n  if (result.recommended) {\n    lines.push(`- ${formatNextLine(result.recommended)}`);\n    lines.push(`  why: ${result.recommended.reasons.join(\"; \")}`);\n  } else {\n    lines.push(\"No ready work.\");\n  }\n  lines.push(\"\");\n\n  lines.push(\"## Ready\");\n  if (result.ready.length === 0) {\n    lines.push(\"No ready items.\");\n  } else {\n    for (const item of result.ready) {\n      lines.push(`- ${formatNextLine(item)}`);\n    }\n  }\n  lines.push(\"\");\n\n  if (!result.filters.ready_only) {\n    lines.push(\"## Blocked\");\n    if (result.blocked.length === 0) {\n      lines.push(\"No blocked items.\");\n    } else {\n      for (const item of result.blocked) {\n        const by = item.blockers\n          .map((blocker) => `${blocker.id}(${blocker.status ?? \"?\"})`)\n          .join(\", \");\n        lines.push(`- ${formatNextLine(item)} blocked_by:${by}`);\n      }\n    }\n    lines.push(\"\");\n  }\n\n  if (result.suggestions && result.suggestions.length > 0) {\n    lines.push(\"## Suggestions\");\n    for (const suggestion of result.suggestions) {\n      lines.push(`- ${suggestion}`);\n    }\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n}\n\n// Formats a single actionable row: id, priority, status, type, deadline, parent,\n// downstream-unblock count, and title. Mirrors the context focus-line shape.\nfunction formatNextLine(item: NextActionableItem): string {\n  const deadlineToken = item.deadline ?? \"-\";\n  const parentToken = item.parent ? ` parent:${item.parent}` : \"\";\n  const unblocksToken = item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : \"\";\n  return `${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;\n}\n"],"names":[],"mappings":"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","debugId":"bca61937-38ff-5efd-a053-cedbe61bd792"}