@unbrained/pm-cli 2026.7.1 → 2026.7.2

package/dist/cli/commands/history-repair.js

@@ -4,7 +4,7 @@
  * Implements the pm history repair command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2f8c8809-b9f6-5bf1-8308-e6ece1e947b5")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="56565288-b529-5ce0-9fb0-6e5ec50cfb5c")}catch(e){}}();
 import fs from "node:fs/promises";
 import jsonPatch from "fast-json-patch";
 import { pathExists, readFileIfExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
@@ -27,6 +27,98 @@ function toAuthor(candidate, defaultAuthor) {
     const trimmed = resolved.trim();
     return trimmed.length > 0 ? trimmed : "unknown";
 }
+async function loadHistoryRepairItemReplay(subject, settings, historyEntries) {
+    const currentItemPath = subject.located?.itemPath ?? null;
+    const loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;
+    if (!loadedItem) {
+        return {
+            currentItemReplay: null,
+            currentItemPath,
+            matchedChainBefore: null,
+            currentItemRawBeforeLock: null,
+            loadedItem: null,
+        };
+    }
+    const currentItemReplay = toReplayDocument(loadedItem.document);
+    const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;
+    return {
+        currentItemReplay,
+        currentItemPath,
+        matchedChainBefore: replayHash(currentItemReplay) === lastOriginalAfterHash,
+        currentItemRawBeforeLock: loadedItem.raw,
+        loadedItem,
+    };
+}
+function buildHistoryRepairMessage(params) {
+    if (typeof params.message === "string" && params.message.trim().length > 0) {
+        return params.message;
+    }
+    /* v8 ignore start -- message suffix/plural variants are deterministic formatting fallbacks around the covered repair outcomes */
+    return `history-repair re-anchored ${params.entriesRehashed} entr${params.entriesRehashed === 1 ? "y" : "ies"}${params.entriesPatchRepaired > 0 ? `, repaired ${params.entriesPatchRepaired} patch(es)` : ""}${params.reconcileNeeded ? ", reconciled chain with on-disk item" : ""}.`;
+    /* v8 ignore stop */
+}
+function buildHistoryRepairEntries(params) {
+    const rewrittenEntries = [...params.reanchorEntries];
+    if (!params.changed) {
+        return { rewrittenEntries, auditEntryAdded: false };
+    }
+    const afterReplay = params.reconcileNeeded && params.currentItemReplay ? params.currentItemReplay : params.finalReplay;
+    rewrittenEntries.push({
+        ts: nowIso(),
+        author: params.author,
+        op: "history_repair",
+        patch: params.reconcileNeeded && params.currentItemReplay
+            ? jsonPatch.compare(params.finalReplay, params.currentItemReplay)
+            : [],
+        before_hash: replayHash(params.finalReplay),
+        after_hash: replayHash(afterReplay),
+        message: params.message,
+    });
+    return { rewrittenEntries, auditEntryAdded: true };
+}
+function collectHistoryRepairWarnings(changed, skippedOps) {
+    const warnings = [];
+    if (!changed) {
+        warnings.push("history_repair_no_changes");
+    }
+    if (skippedOps > 0) {
+        warnings.push(`history_repair_skipped_unresolvable_ops:${skippedOps}`);
+    }
+    return warnings;
+}
+async function applyHistoryRepairRewrite(params) {
+    return executeHistoryRewrite({
+        pmRoot: params.pmRoot,
+        subject: params.subject,
+        settings: params.settings,
+        typeRegistry: params.typeRegistry,
+        historyRawBeforeLock: params.historyRawBeforeLock,
+        currentItemRawBeforeLock: params.currentItemRawBeforeLock,
+        operation: "history-repair",
+        author: params.author,
+        force: params.force,
+        itemDocument: params.loadedItem?.document ?? null,
+        applyRewrite: async ({ historyRawUnderLock }) => {
+            try {
+                await writeFileAtomic(params.historyPath, historyEntriesToRaw(params.rewrittenEntries));
+            }
+            catch (error) {
+                if (historyRawUnderLock === null) {
+                    await fs.rm(params.historyPath, { force: true });
+                }
+                else {
+                    await writeFileAtomic(params.historyPath, historyRawUnderLock);
+                }
+                throw error;
+            }
+        },
+        applyPostRewrite: async () => runActiveOnWriteHooks({
+            path: params.historyPath,
+            scope: "project",
+            op: "history_repair:history",
+        }),
+    });
+}
 /**
  * Implements run history repair for the public runtime surface of this module.
  */
@@ -48,102 +140,45 @@ export async function runHistoryRepair(id, options, global) {
     }
     const chainBefore = verifyHistoryChain(historyEntries);
     const reanchor = reanchorHistoryEntries(historyEntries);
-    // Reconcile the replayed chain with the current on-disk item document so the
-    // latest after_hash matches what pm validate/health compute for the item.
-    let currentItemReplay = null;
-    const currentItemPath = subject.located?.itemPath ?? null;
-    let matchedChainBefore = null;
-    const loadedItem = subject.located
-        ? await readLocatedItem(subject.located, { schema: settings.schema })
-        : null;
-    const currentItemRawBeforeLock = loadedItem?.raw ?? null;
-    if (loadedItem) {
-        // Use the shared canonical replay form so reconciliation hashing matches the
-        // semantics pm validate/health use for the on-disk item (avoids hash divergence).
-        currentItemReplay = toReplayDocument(loadedItem.document);
-        const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;
-        matchedChainBefore = replayHash(currentItemReplay) === lastOriginalAfterHash;
-    }
+    const itemReplayContext = await loadHistoryRepairItemReplay(subject, settings, historyEntries);
     const finalReplay = reanchor.finalDocument;
-    const reconcileNeeded = currentItemReplay !== null && replayHash(finalReplay) !== replayHash(currentItemReplay);
+    const reconcileNeeded = itemReplayContext.currentItemReplay !== null && replayHash(finalReplay) !== replayHash(itemReplayContext.currentItemReplay);
     const changed = reanchor.entriesRehashed > 0 || reanchor.entriesPatchRepaired > 0 || reconcileNeeded;
     const author = toAuthor(options.author, settings.author_default);
     const dryRun = Boolean(options.dryRun);
-    const repairMessage = 
-    /* c8 ignore next -- generated repair summaries include optional clauses based on rare drift shapes. */
-    typeof options.message === "string" && options.message.trim().length > 0
-        ? options.message
-        : `history-repair re-anchored ${reanchor.entriesRehashed} entr${reanchor.entriesRehashed === 1 ? "y" : "ies"}${reanchor.entriesPatchRepaired > 0 ? `, repaired ${reanchor.entriesPatchRepaired} patch(es)` : ""}${reconcileNeeded ? ", reconciled chain with on-disk item" : ""}.`;
-    const rewrittenEntries = [...reanchor.entries];
-    let auditEntryAdded = false;
-    if (changed) {
-        /* c8 ignore next -- reconcile append branch requires hash-drift plus loadable on-disk replay. */
-        if (reconcileNeeded && currentItemReplay) {
-            rewrittenEntries.push({
-                ts: nowIso(),
-                author,
-                op: "history_repair",
-                patch: jsonPatch.compare(finalReplay, currentItemReplay),
-                before_hash: replayHash(finalReplay),
-                after_hash: replayHash(currentItemReplay),
-                message: repairMessage,
-            });
-        }
-        else {
-            rewrittenEntries.push({
-                ts: nowIso(),
-                author,
-                op: "history_repair",
-                patch: [],
-                before_hash: replayHash(finalReplay),
-                after_hash: replayHash(finalReplay),
-                message: repairMessage,
-            });
-        }
-        auditEntryAdded = true;
-    }
+    const repairMessage = buildHistoryRepairMessage({
+        message: options.message,
+        entriesRehashed: reanchor.entriesRehashed,
+        entriesPatchRepaired: reanchor.entriesPatchRepaired,
+        reconcileNeeded,
+    });
+    const { rewrittenEntries, auditEntryAdded } = buildHistoryRepairEntries({
+        reanchorEntries: reanchor.entries,
+        changed,
+        reconcileNeeded,
+        currentItemReplay: itemReplayContext.currentItemReplay,
+        finalReplay,
+        author,
+        message: repairMessage,
+    });
     const historyVerify = verifyHistoryChain(rewrittenEntries);
     if (!historyVerify.ok) {
         throw new PmCliError(`history-repair produced an invalid rewritten chain (${historyVerify.errors.join(", ")}).`, EXIT_CODE.GENERIC_FAILURE);
     }
-    const warnings = [];
-    if (!changed) {
-        warnings.push("history_repair_no_changes");
-    }
-    if (reanchor.skippedOps > 0) {
-        warnings.push(`history_repair_skipped_unresolvable_ops:${reanchor.skippedOps}`);
-    }
+    const warnings = collectHistoryRepairWarnings(changed, reanchor.skippedOps);
     if (changed && !dryRun) {
-        warnings.push(...(await executeHistoryRewrite({
+        warnings.push(...(await applyHistoryRepairRewrite({
             pmRoot,
             subject,
             settings,
             typeRegistry,
             historyRawBeforeLock,
-            currentItemRawBeforeLock,
-            operation: "history-repair",
+            currentItemRawBeforeLock: itemReplayContext.currentItemRawBeforeLock,
             author,
             force: options.force,
-            itemDocument: loadedItem?.document ?? null,
-            applyRewrite: async ({ historyRawUnderLock }) => {
-                try {
-                    await writeFileAtomic(subject.historyPath, historyEntriesToRaw(rewrittenEntries));
-                }
-                catch (error) {
-                    if (historyRawUnderLock === null) {
-                        await fs.rm(subject.historyPath, { force: true });
-                    }
-                    else {
-                        await writeFileAtomic(subject.historyPath, historyRawUnderLock);
-                    }
-                    throw error;
-                }
-            },
-            applyPostRewrite: async () => runActiveOnWriteHooks({
-                path: subject.historyPath,
-                scope: "project",
-                op: "history_repair:history",
-            }),
+            loadedItem: itemReplayContext.loadedItem,
+            historyPath: subject.historyPath,
+            rewrittenEntries,
         })));
     }
     return {
@@ -164,9 +199,9 @@ export async function runHistoryRepair(id, options, global) {
             verify_errors: historyVerify.errors,
         },
         item: {
-            exists: currentItemPath !== null,
-            path: currentItemPath,
-            matched_chain_before: matchedChainBefore,
+            exists: itemReplayContext.currentItemPath !== null,
+            path: itemReplayContext.currentItemPath,
+            matched_chain_before: itemReplayContext.matchedChainBefore,
         },
         warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
         generated_at: nowIso(),
@@ -239,4 +274,4 @@ export async function runHistoryRepairAll(options, global) {
     };
 }
 //# sourceMappingURL=history-repair.js.map
-//# debugId=2f8c8809-b9f6-5bf1-8308-e6ece1e947b5
+//# debugId=56565288-b529-5ce0-9fb0-6e5ec50cfb5c

package/dist/cli/commands/history-repair.js.map

@@ -1 +1 @@
-{"version":3,"file":"history-repair.js","sources":["cli/commands/history-repair.ts"],"sourceRoot":"/","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":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,+BAA+B,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAyC5D,SAAS,QAAQ,CAAC,SAA6B,EAAE,aAAqB;IACpE,iFAAiF;IACjF,MAAM,QAAQ,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAU,EACV,OAAoC,EACpC,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAE/F,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAAC,gCAAgC,OAAO,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,oBAAoB,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAAC,gCAAgC,OAAO,CAAC,EAAE,sBAAsB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAExD,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,iBAAiB,GAA0B,IAAI,CAAC;IACpD,MAAM,eAAe,GAAkB,OAAO,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IACzE,IAAI,kBAAkB,GAAmB,IAAI,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO;QAChC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,wBAAwB,GAAG,UAAU,EAAE,GAAG,IAAI,IAAI,CAAC;IACzD,IAAI,UAAU,EAAE,CAAC;QACf,6EAA6E;QAC7E,kFAAkF;QAClF,iBAAiB,GAAG,gBAAgB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,qBAAqB,GAAG,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC;QACpF,kBAAkB,GAAG,UAAU,CAAC,iBAAiB,CAAC,KAAK,qBAAqB,CAAC;IAC/E,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC;IAC3C,MAAM,eAAe,GACnB,iBAAiB,KAAK,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE1F,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,GAAG,CAAC,IAAI,QAAQ,CAAC,oBAAoB,GAAG,CAAC,IAAI,eAAe,CAAC;IACrG,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,MAAM,aAAa;IACjB,uGAAuG;IACvG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACtE,CAAC,CAAC,OAAO,CAAC,OAAO;QACjB,CAAC,CAAC,8BAA8B,QAAQ,CAAC,eAAe,QACpD,QAAQ,CAAC,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KACzC,GAAG,QAAQ,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,oBAAoB,YAAY,CAAC,CAAC,CAAC,EAAE,GACjG,eAAe,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAC7D,GAAG,CAAC;IAEV,MAAM,gBAAgB,GAAmB,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,OAAO,EAAE,CAAC;QACZ,iGAAiG;QACjG,IAAI,eAAe,IAAI,iBAAiB,EAAE,CAAC;YACzC,gBAAgB,CAAC,IAAI,CAAC;gBACpB,EAAE,EAAE,MAAM,EAAE;gBACZ,MAAM;gBACN,EAAE,EAAE,gBAAgB;gBACpB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,iBAAiB,CAAqB;gBAC5E,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;gBACpC,UAAU,EAAE,UAAU,CAAC,iBAAiB,CAAC;gBACzC,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,IAAI,CAAC;gBACpB,EAAE,EAAE,MAAM,EAAE;gBACZ,MAAM;gBACN,EAAE,EAAE,gBAAgB;gBACpB,KAAK,EAAE,EAAE;gBACT,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;gBACpC,UAAU,EAAE,UAAU,CAAC,WAAW,CAAC;gBACnC,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;QACL,CAAC;QACD,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAC3D,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,uDAAuD,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAC1F,SAAS,CAAC,eAAe,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,2CAA2C,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,GAAG,CAAC,MAAM,qBAAqB,CAAC;YAC9B,MAAM;YACN,OAAO;YACP,QAAQ;YACR,YAAY;YACZ,oBAAoB;YACpB,wBAAwB;YACxB,SAAS,EAAE,gBAAgB;YAC3B,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,UAAU,EAAE,QAAQ,IAAI,IAAI;YAC1C,YAAY,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE;gBAC9C,IAAI,CAAC;oBACH,MAAM,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACpF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,mBAAmB,KAAK,IAAI,EAAE,CAAC;wBACjC,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpD,CAAC;yBAAM,CAAC;wBACN,MAAM,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;oBAClE,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAC3B,qBAAqB,CAAC;gBACpB,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,KAAK,EAAE,SAAS;gBAChB,EAAE,EAAE,wBAAwB;aAC7B,CAAC;SACL,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,MAAM;QACf,OAAO;QACP,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,WAAW;YACzB,eAAe,EAAE,cAAc,CAAC,MAAM;YACtC,kBAAkB,EAAE,CAAC,WAAW,CAAC,EAAE;YACnC,gBAAgB,EAAE,QAAQ,CAAC,eAAe;YAC1C,sBAAsB,EAAE,QAAQ,CAAC,oBAAoB;YACrD,wBAAwB,EAAE,QAAQ,CAAC,qBAAqB;YACxD,WAAW,EAAE,QAAQ,CAAC,UAAU;YAChC,oBAAoB,EAAE,eAAe;YACrC,iBAAiB,EAAE,eAAe;YAClC,SAAS,EAAE,aAAa,CAAC,EAAE;YAC3B,aAAa,EAAE,aAAa,CAAC,MAAM;SACpC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,eAAe,KAAK,IAAI;YAChC,IAAI,EAAE,eAAe;YACrB,oBAAoB,EAAE,kBAAkB;SACzC;QACD,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACjF,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC;AA6BD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAsB,EAAE,GAAY;IAC5E,IAAI,GAAG,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAClB,sIAAsI,EACtI,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAClB,oFAAoF,EACpF,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoC,EACpC,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,iCAAiC,MAAM,sBAAsB,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAC5C,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,YAAY,CAAC,cAAc,EAC3B,gBAAgB,EAChB,QAAQ,CAAC,MAAM,CAChB,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAA+C,CAAC,CAAC;IAE9F,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC5D,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAClE,uFAAuF;YACvF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,SAAS;gBACb,OAAO;gBACP,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB;gBACjD,sBAAsB,EAAE,MAAM,CAAC,OAAO,CAAC,sBAAsB;gBAC7D,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,oBAAoB;aAC1D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,SAAS;gBACb,OAAO,EAAE,QAAQ;gBACjB,8EAA8E;gBAC9E,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,eAAe,EAAE,KAAK,CAAC,MAAM;QAC7B,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM;QAC1C,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzF,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC","debugId":"2f8c8809-b9f6-5bf1-8308-e6ece1e947b5"}
+{"version":3,"file":"history-repair.js","sources":["cli/commands/history-repair.ts"],"sourceRoot":"/","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\ninterface HistoryRepairItemReplayContext {\n  currentItemReplay: ReplayDocument | null;\n  currentItemPath: string | null;\n  matchedChainBefore: boolean | null;\n  currentItemRawBeforeLock: string | null;\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\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\nasync function loadHistoryRepairItemReplay(\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  historyEntries: HistoryEntry[],\n): Promise<HistoryRepairItemReplayContext> {\n  const currentItemPath = subject.located?.itemPath ?? null;\n  const loadedItem = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  if (!loadedItem) {\n    return {\n      currentItemReplay: null,\n      currentItemPath,\n      matchedChainBefore: null,\n      currentItemRawBeforeLock: null,\n      loadedItem: null,\n    };\n  }\n  const currentItemReplay = toReplayDocument(loadedItem.document);\n  const lastOriginalAfterHash = historyEntries[historyEntries.length - 1]?.after_hash;\n  return {\n    currentItemReplay,\n    currentItemPath,\n    matchedChainBefore: replayHash(currentItemReplay) === lastOriginalAfterHash,\n    currentItemRawBeforeLock: loadedItem.raw,\n    loadedItem,\n  };\n}\n\nfunction buildHistoryRepairMessage(params: {\n  message: string | undefined;\n  entriesRehashed: number;\n  entriesPatchRepaired: number;\n  reconcileNeeded: boolean;\n}): string {\n  if (typeof params.message === \"string\" && params.message.trim().length > 0) {\n    return params.message;\n  }\n  /* v8 ignore start -- message suffix/plural variants are deterministic formatting fallbacks around the covered repair outcomes */\n  return `history-repair re-anchored ${params.entriesRehashed} entr${\n    params.entriesRehashed === 1 ? \"y\" : \"ies\"\n  }${params.entriesPatchRepaired > 0 ? `, repaired ${params.entriesPatchRepaired} patch(es)` : \"\"}${\n    params.reconcileNeeded ? \", reconciled chain with on-disk item\" : \"\"\n  }.`;\n  /* v8 ignore stop */\n}\n\nfunction buildHistoryRepairEntries(params: {\n  reanchorEntries: HistoryEntry[];\n  changed: boolean;\n  reconcileNeeded: boolean;\n  currentItemReplay: ReplayDocument | null;\n  finalReplay: ReplayDocument;\n  author: string;\n  message: string;\n}): { rewrittenEntries: HistoryEntry[]; auditEntryAdded: boolean } {\n  const rewrittenEntries: HistoryEntry[] = [...params.reanchorEntries];\n  if (!params.changed) {\n    return { rewrittenEntries, auditEntryAdded: false };\n  }\n  const afterReplay = params.reconcileNeeded && params.currentItemReplay ? params.currentItemReplay : params.finalReplay;\n  rewrittenEntries.push({\n    ts: nowIso(),\n    author: params.author,\n    op: \"history_repair\",\n    patch: params.reconcileNeeded && params.currentItemReplay\n      ? (jsonPatch.compare(params.finalReplay, params.currentItemReplay) as HistoryPatchOp[])\n      : [],\n    before_hash: replayHash(params.finalReplay),\n    after_hash: replayHash(afterReplay),\n    message: params.message,\n  });\n  return { rewrittenEntries, auditEntryAdded: true };\n}\n\nfunction collectHistoryRepairWarnings(changed: boolean, skippedOps: number): string[] {\n  const warnings: string[] = [];\n  if (!changed) {\n    warnings.push(\"history_repair_no_changes\");\n  }\n  if (skippedOps > 0) {\n    warnings.push(`history_repair_skipped_unresolvable_ops:${skippedOps}`);\n  }\n  return warnings;\n}\n\nasync function applyHistoryRepairRewrite(params: {\n  pmRoot: string;\n  subject: Awaited<ReturnType<typeof resolveHistorySubject>>;\n  settings: Awaited<ReturnType<typeof readSettings>>;\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;\n  historyRawBeforeLock: string | null;\n  currentItemRawBeforeLock: string | null;\n  author: string;\n  force: boolean | undefined;\n  loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;\n  historyPath: string;\n  rewrittenEntries: HistoryEntry[];\n}): Promise<string[]> {\n  return executeHistoryRewrite({\n    pmRoot: params.pmRoot,\n    subject: params.subject,\n    settings: params.settings,\n    typeRegistry: params.typeRegistry,\n    historyRawBeforeLock: params.historyRawBeforeLock,\n    currentItemRawBeforeLock: params.currentItemRawBeforeLock,\n    operation: \"history-repair\",\n    author: params.author,\n    force: params.force,\n    itemDocument: params.loadedItem?.document ?? null,\n    applyRewrite: async ({ historyRawUnderLock }) => {\n      try {\n        await writeFileAtomic(params.historyPath, historyEntriesToRaw(params.rewrittenEntries));\n      } catch (error) {\n        if (historyRawUnderLock === null) {\n          await fs.rm(params.historyPath, { force: true });\n        } else {\n          await writeFileAtomic(params.historyPath, historyRawUnderLock);\n        }\n        throw error;\n      }\n    },\n    applyPostRewrite: async () =>\n      runActiveOnWriteHooks({\n        path: params.historyPath,\n        scope: \"project\",\n        op: \"history_repair:history\",\n      }),\n  });\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  const itemReplayContext = await loadHistoryRepairItemReplay(subject, settings, historyEntries);\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    itemReplayContext.currentItemReplay !== null && replayHash(finalReplay) !== replayHash(itemReplayContext.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 = buildHistoryRepairMessage({\n    message: options.message,\n    entriesRehashed: reanchor.entriesRehashed,\n    entriesPatchRepaired: reanchor.entriesPatchRepaired,\n    reconcileNeeded,\n  });\n  const { rewrittenEntries, auditEntryAdded } = buildHistoryRepairEntries({\n    reanchorEntries: reanchor.entries,\n    changed,\n    reconcileNeeded,\n    currentItemReplay: itemReplayContext.currentItemReplay,\n    finalReplay,\n    author,\n    message: repairMessage,\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 = collectHistoryRepairWarnings(changed, reanchor.skippedOps);\n\n  if (changed && !dryRun) {\n    warnings.push(\n      ...(await applyHistoryRepairRewrite({\n        pmRoot,\n        subject,\n        settings,\n        typeRegistry,\n        historyRawBeforeLock,\n        currentItemRawBeforeLock: itemReplayContext.currentItemRawBeforeLock,\n        author,\n        force: options.force,\n        loadedItem: itemReplayContext.loadedItem,\n        historyPath: subject.historyPath,\n        rewrittenEntries,\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: itemReplayContext.currentItemPath !== null,\n      path: itemReplayContext.currentItemPath,\n      matched_chain_before: itemReplayContext.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":"56565288-b529-5ce0-9fb0-6e5ec50cfb5c"}

package/dist/cli/commands/init.d.ts

@@ -28,6 +28,12 @@ export interface InitRegisteredTypePresetSummary {
     updated: string[];
     file: string;
 }
+/**
+ * Documents the init agent-guidance summary plus generated next-step hints returned by init.
+ */
+export type InitAgentGuidanceResult = InitAgentGuidanceSummary & {
+    next_steps: string[];
+};
 /**
  * Documents the init result payload exchanged by command, SDK, and package integrations.
  */
@@ -42,7 +48,7 @@ export interface InitResult {
     registered_type_preset?: InitRegisteredTypePresetSummary;
     installed_packages?: InitInstalledPackagesSummary;
     next_steps: string[];
-    agent_guidance: InitAgentGuidanceSummary;
+    agent_guidance: InitAgentGuidanceResult;
 }
 /**
  * Documents the init command options payload exchanged by command, SDK, and package integrations.
@@ -81,7 +87,7 @@ export interface InitConciseResult {
     registered_type_preset?: InitRegisteredTypePresetSummary;
     installed_packages?: InitInstalledPackagesSummary;
     next_steps: string[];
-    agent_guidance: InitAgentGuidanceSummary;
+    agent_guidance: InitAgentGuidanceResult;
     hint: string;
 }
 /**