@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/cli-bundle/chunks/{chunk-RGXD5JJR.js → chunk-LSG2U345.js}

@@ -1,19 +1,17 @@
 import {
   scanHistoryDrift
-} from "./chunk-M6ASXYCU.js";
+} from "./chunk-KG44YSKD.js";
 import {
   executeHistoryRewrite,
-  resolveHistorySubject,
-  writeHistoryRawWithRollback
-} from "./chunk-DYEX6NFH.js";
-import {
   historyEntriesToRaw,
   readHistoryEntries,
   reanchorHistoryEntries,
   replayHash,
+  resolveHistorySubject,
   toReplayDocument,
-  verifyHistoryChain
-} from "./chunk-4WREH7RT.js";
+  verifyHistoryChain,
+  writeHistoryRawWithRollback
+} from "./chunk-TD3LVC7D.js";
 import {
   getActiveExtensionRegistrations,
   listAllItemMetadataWithBody,
@@ -21,7 +19,7 @@ import {
   readLocatedItem,
   readSettings,
   runActiveOnWriteHooks
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -30,14 +28,14 @@ import {
   readFileIfExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
-// dist/cli/commands/history-repair.js
+// dist/sdk/history-repair.js
 import jsonPatch from "fast-json-patch";
 !(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] = "141c6ac4-734f-5395-8af1-b6233b8cc886");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "681e79d9-140b-5a78-9e24-6714efd974dc");
   } catch (e2) {
   }
 })();
@@ -264,9 +262,18 @@ async function runHistoryRepairAll(options, global2) {
   };
 }
 
+// dist/cli/commands/history-repair.js
+!(function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "0c797b34-1f8d-5218-b7ee-127688fab2a1");
+  } catch (e2) {
+  }
+})();
+
 export {
   runHistoryRepair,
   assertHistoryRepairTarget,
   runHistoryRepairAll
 };
-//# sourceMappingURL=chunk-RGXD5JJR.js.map
+//# sourceMappingURL=chunk-LSG2U345.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../sdk/history-repair.ts"],
+  "sourcesContent": ["/**\n * @module sdk/history-repair\n *\n * Implements the pm history repair command surface and its agent-facing runtime behavior.\n */\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists } from \"../core/fs/fs-utils.js\";\nimport {\n  executeHistoryRewrite,\n  writeHistoryRawWithRollback,\n} 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 { readHistoryEntries } from \"../core/history/read.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 {\n  getActiveExtensionRegistrations,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nimport {\n  listAllItemMetadataWithBody,\n  readLocatedItem,\n} from \"../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport type {\n  HistoryEntry,\n  HistoryPatchOp,\n  ItemMetadata,\n} from \"../types/index.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/** Documents the history repair command options payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairCommandOptions {\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports force for this contract. */\n  force?: boolean;\n}\n\n/** Documents the history repair result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports changed for this contract. */\n  changed: boolean;\n  /** Value that configures or reports history for this contract. */\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  /** Value that configures or reports item for this contract. */\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\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(\n  candidate: string | undefined,\n  defaultAuthor: string,\n): 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\n    ? await readLocatedItem(subject.located, { schema: settings.schema })\n    : 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 =\n    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 =\n    params.reconcileNeeded && params.currentItemReplay\n      ? params.currentItemReplay\n      : params.finalReplay;\n  rewrittenEntries.push({\n    ts: nowIso(),\n    author: params.author,\n    op: \"history_repair\",\n    patch:\n      params.reconcileNeeded && params.currentItemReplay\n        ? (jsonPatch.compare(\n            params.finalReplay,\n            params.currentItemReplay,\n          ) 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(\n  changed: boolean,\n  skippedOps: number,\n): 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      writeHistoryRawWithRollback({\n        historyPath: params.historyPath,\n        nextHistoryRaw: historyEntriesToRaw(params.rewrittenEntries),\n        historyRawUnderLock,\n      }),\n    applyPostRewrite: async () =>\n      runActiveOnWriteHooks({\n        path: params.historyPath,\n        scope: \"project\",\n        op: \"history_repair:history\",\n      }),\n  });\n}\n\n/** Implements run history repair for the public runtime surface of this module. */\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(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const subject = await resolveHistorySubject(\n    pmRoot,\n    id,\n    settings,\n    typeRegistry.type_to_folder,\n  );\n\n  if (!(await pathExists(subject.historyPath))) {\n    throw new PmCliError(\n      `No history stream exists for ${subject.id}.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const historyEntries = await readHistoryEntries(\n    subject.historyPath,\n    subject.id,\n  );\n  if (historyEntries.length === 0) {\n    throw new PmCliError(\n      `No history entries exist for ${subject.id}; nothing to repair.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  const chainBefore = verifyHistoryChain(historyEntries);\n  const reanchor = reanchorHistoryEntries(historyEntries);\n\n  const itemReplayContext = await loadHistoryRepairItemReplay(\n    subject,\n    settings,\n    historyEntries,\n  );\n\n  const finalReplay = reanchor.finalDocument;\n  const reconcileNeeded =\n    itemReplayContext.currentItemReplay !== null &&\n    replayHash(finalReplay) !== replayHash(itemReplayContext.currentItemReplay);\n\n  const changed =\n    reanchor.entriesRehashed > 0 ||\n    reanchor.entriesPatchRepaired > 0 ||\n    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) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n\n/** Documents the history repair all stream result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairAllStreamResult {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports outcome for this contract. */\n  outcome: \"repaired\" | \"skipped_clean\" | \"failed\";\n  /** Value that configures or reports entries rehashed for this contract. */\n  entries_rehashed?: number;\n  /** Value that configures or reports entries patch repaired for this contract. */\n  entries_patch_repaired?: number;\n  /** Value that configures or reports reconciled with item for this contract. */\n  reconciled_with_item?: boolean;\n  /** Value that configures or reports error for this contract. */\n  error?: string;\n}\n\n/** Documents the history repair all result payload exchanged by command, SDK, and package integrations. */\nexport interface HistoryRepairAllResult {\n  /** Value that configures or reports all for this contract. */\n  all: true;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports scanned streams for this contract. */\n  scanned_streams: number;\n  /** Value that configures or reports drifted streams for this contract. */\n  drifted_streams: number;\n  /** One compact row per drifted stream (clean streams are summarized by the counts only). */\n  streams: HistoryRepairAllStreamResult[];\n  /** Value that configures or reports totals for this contract. */\n  totals: { repaired: number; skipped_clean: number; failed: number };\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\n/** Enforce the `pm history-repair` target contract shared by the CLI and MCP surfaces: exactly one of an item `<id>` or `--all` must be provided. */\nexport function assertHistoryRepairTarget(\n  id: string | undefined,\n  all: boolean,\n): 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/** Bulk drift repair: scan every item's history stream with the same drift scan `pm health` uses, then run the audited single-stream repair (ownership check, lock, no-drift verification, audit marker) for each drifted stream. One failing stream never aborts the rest; failures are collected per row and the caller decides the exit code from `totals.failed`. */\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(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\n  const itemReadWarnings: string[] = [];\n  const items = await listAllItemMetadataWithBody(\n    pmRoot,\n    settings.item_format,\n    typeRegistry.type_to_folder,\n    itemReadWarnings,\n    settings.schema,\n  );\n  const drift = await scanHistoryDrift(\n    pmRoot,\n    items as Array<ItemMetadata & { body: string }>,\n  );\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) =>\n      left.localeCompare(right),\n    ),\n    generated_at: nowIso(),\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/chunk-MIQDDLB5.js

@@ -0,0 +1,5 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="45eac7fa-f181-5cca-93b7-cfb58909dbb3")}catch(e){}}();
+//# sourceMappingURL=chunk-MIQDDLB5.js.map
+
+//# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/{chunk-UJ4HJYWL.js → chunk-NLDFBC6J.js}

@@ -1,7 +1,7 @@
 import {
   isTerminalStatus,
   normalizeStatusForRegistry
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 
 // dist/core/item/actionability.js
 !(function() {
@@ -129,4 +129,4 @@ export {
   collectBlockedByIds,
   computeActionabilityReport
 };
-//# sourceMappingURL=chunk-UJ4HJYWL.js.map
+//# sourceMappingURL=chunk-NLDFBC6J.js.map

package/dist/cli-bundle/chunks/{chunk-WRKB56FC.js → chunk-NP22ERDF.js}

@@ -2,7 +2,7 @@ import {
   nowIso,
   readSettings,
   writeSettings
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 import {
   EXIT_CODE,
   appendLineAtomic,
@@ -11,7 +11,7 @@ import {
   resolvePmPackageRootFromModule,
   resolveTelemetryErrorCategory,
   writeFileAtomic
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/core/telemetry/observability.js
 !(function() {
@@ -1838,4 +1838,4 @@ export {
   finishTelemetryCommand,
   emitTelemetryErrorEvent
 };
-//# sourceMappingURL=chunk-WRKB56FC.js.map
+//# sourceMappingURL=chunk-NP22ERDF.js.map

package/dist/cli-bundle/chunks/{chunk-YQYG2V23.js → chunk-NU3IMIEA.js}

@@ -1,7 +1,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/core/shared/numeric-parsers.js
 !(function() {
@@ -24,4 +24,4 @@ function parseLimit(raw, label = "--limit") {
 export {
   parseLimit
 };
-//# sourceMappingURL=chunk-YQYG2V23.js.map
+//# sourceMappingURL=chunk-NU3IMIEA.js.map

package/dist/cli-bundle/chunks/{chunk-3I3LRT2G.js → chunk-NVPZIJVR.js}

@@ -3,7 +3,7 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-GXXC7QSK.js";
+} from "./chunk-QKECXBBG.js";
 
 // dist/core/shared/numeric-parsers.js
 function parseLimit(raw, label = "--limit") {
@@ -19,6 +19,6 @@ function parseLimit(raw, label = "--limit") {
 export {
   parseLimit
 };
-//# sourceMappingURL=chunk-3I3LRT2G.js.map
+//# sourceMappingURL=chunk-NVPZIJVR.js.map
 
 //# debugId=627d7fc9-9482-5889-9c96-735ac260cf05

package/dist/cli-bundle/chunks/{chunk-JAF4TUQ7.js → chunk-ODALILG3.js}

@@ -1,7 +1,7 @@
 import {
   renameArtifactsResultKey,
   runLinkedArtifacts
-} from "./chunk-FIGXOCEQ.js";
+} from "./chunk-WUJQK4YV.js";
 
 // dist/sdk/docs.js
 !(function() {
@@ -24,4 +24,4 @@ async function runDocs(id, options, global2) {
 export {
   runDocs
 };
-//# sourceMappingURL=chunk-JAF4TUQ7.js.map
+//# sourceMappingURL=chunk-ODALILG3.js.map

package/dist/cli-bundle/chunks/{chunk-CDJYP7OQ.js → chunk-ONG5V5CI.js}

@@ -1,8 +1,8 @@
 
-!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]="fa5c921d-05ab-548a-a7c5-6c3c0ca14357")}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]="9a21d12c-d2fd-5325-930c-dfc8bbfe8247")}catch(e){}}();
 import {
   collectStaleVectorizationIds
-} from "./chunk-BPD26E3P.js";
+} from "./chunk-7Z4LKRS4.js";
 import {
   buildListQueryFilters
 } from "./chunk-N7V7TI6J.js";
@@ -11,33 +11,38 @@ import {
   buildContentFilterEcho,
   buildGovernanceMissingFilterEcho,
   collectRuntimeFilterValues,
-  createQueryFingerprint,
   hasContentFieldFilter,
   itemMatchesContentFilters,
   matchesRuntimeFilters,
-  paginateQueryRows,
+  parseIntegerLimit,
+  parsePriority,
   parseStatusFilterCsv,
+  parseType,
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-6TTOHMTB.js";
+} from "./chunk-UXONS674.js";
+import {
+  createQueryFingerprint,
+  paginateQueryRows
+} from "./chunk-HDH3JUGG.js";
+import {
+  getItemAt
+} from "./chunk-OW4JWD5M.js";
 import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-Q7E6OYZK.js";
+} from "./chunk-2VPAVL7O.js";
 import {
-  parseIntegerLimit,
-  parsePriority,
-  parseType,
   readHistoryEntries
-} from "./chunk-2GA3NK35.js";
+} from "./chunk-GOSLKLFE.js";
 import {
   parseLimit
-} from "./chunk-3I3LRT2G.js";
+} from "./chunk-NVPZIJVR.js";
 import {
   recordContextUsageTouches
-} from "./chunk-ZNP64HOW.js";
+} from "./chunk-RLCHOOHC.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -54,7 +59,7 @@ import {
   resolveSearchCorpusFields,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-J4NZOP3I.js";
+} from "./chunk-JXQUXVMI.js";
 import {
   splitCommaList
 } from "./chunk-NETP4DY4.js";
@@ -76,11 +81,12 @@ import {
   resolveIsoOrRelative,
   runActiveOnReadHooks,
   toItemRecord
-} from "./chunk-GSEADLRH.js";
+} from "./chunk-Q7A43DS4.js";
 import {
   EXIT_CODE,
   ITEM_METADATA_KEY_ORDER,
   PmCliError,
+  TYPE_TO_FOLDER,
   coerceNumberInRange,
   coercePositiveInteger,
   collectRegisteredItemFieldNames,
@@ -96,7 +102,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyString,
   toNonEmptyStringOrUndefined
-} from "./chunk-GXXC7QSK.js";
+} from "./chunk-QKECXBBG.js";
 
 // dist/cli/commands/aggregate.js
 var AGGREGATE_GROUP_FIELDS = [
@@ -2949,9 +2955,94 @@ async function runEval(options, global) {
   };
 }
 
+// dist/sdk/item-children.js
+var MAX_CHILD_PROJECTION_ITEMS = 1e6;
+var DEFAULT_CHILD_SAMPLE_LIMIT = 20;
+function buildItemChildrenRollup(parentId, corpus, statusRegistry, sampleLimit = DEFAULT_CHILD_SAMPLE_LIMIT) {
+  if (!Number.isSafeInteger(sampleLimit) || sampleLimit < 0) {
+    throw new PmCliError("Child projection sample limit must be a non-negative integer.", EXIT_CODE.USAGE);
+  }
+  const normalizedParentId = parentId.trim().toLowerCase();
+  const byStatus = {};
+  const children = [];
+  let active = 0;
+  let scanned = 0;
+  for (const candidate of corpus) {
+    scanned += 1;
+    if (scanned > MAX_CHILD_PROJECTION_ITEMS) {
+      throw new PmCliError(`Child projection exceeded the ${MAX_CHILD_PROJECTION_ITEMS.toLocaleString("en-US")} item safety bound.`, EXIT_CODE.GENERIC_FAILURE, {
+        code: "child_projection_item_bound_exceeded",
+        required: "Use an indexed or parent-filtered metadata source.",
+        why: "Unbounded graph scans can exhaust memory in universal project stores.",
+        nextSteps: ["Build the derived item index, then retry the parent read."]
+      });
+    }
+    if (candidate.parent?.trim().toLowerCase() !== normalizedParentId) {
+      continue;
+    }
+    children.push(candidate);
+    const status = candidate.status.trim().toLowerCase();
+    byStatus[status] = (byStatus[status] ?? 0) + 1;
+    if (!isTerminalStatus(status, statusRegistry)) {
+      active += 1;
+    }
+  }
+  children.sort((left, right) => left.id.localeCompare(right.id));
+  const sample = children.slice(0, sampleLimit).map((child) => ({
+    id: child.id,
+    title: child.title,
+    type: child.type,
+    status: child.status,
+    priority: child.priority
+  }));
+  const truncated = children.length > sample.length;
+  return {
+    count: children.length,
+    active,
+    by_status: Object.fromEntries(Object.entries(byStatus).sort(([left], [right]) => left.localeCompare(right))),
+    sample,
+    sample_limit: sampleLimit,
+    truncated,
+    next_offset: truncated ? sample.length : null,
+    continuation: truncated ? `pm list --status all --parent ${parentId} --offset ${sample.length} --limit ${sampleLimit}` : null,
+    scanned
+  };
+}
+
+// dist/sdk/item-schedule.js
+var BUILTIN_SCHEDULE_TYPES = /* @__PURE__ */ new Set(["event", "meeting", "reminder"]);
+function itemHasSchedule(item) {
+  return BUILTIN_SCHEDULE_TYPES.has(item.type.trim().toLowerCase()) || item.deadline !== void 0 || (item.reminders?.length ?? 0) > 0 || (item.events?.length ?? 0) > 0;
+}
+function buildItemSchedule(item) {
+  if (!itemHasSchedule(item)) {
+    return void 0;
+  }
+  const events = [...item.events ?? []].sort((left, right) => left.start_at.localeCompare(right.start_at));
+  const primary = events[0];
+  return {
+    deadline: item.deadline ?? null,
+    start_at: primary?.start_at ?? null,
+    end_at: primary?.end_at ?? null,
+    location: primary?.location ?? null,
+    reminders: [...item.reminders ?? []],
+    events
+  };
+}
+
 // dist/cli/commands/get.js
-var CHILD_ROLLUP_TYPES = /* @__PURE__ */ new Set(["milestone", "epic"]);
 var GET_DEPTH_VALUES = ["brief", "standard", "deep"];
+var AUTOMATIC_CHILD_ROLLUP_TYPES = /* @__PURE__ */ new Set([
+  "epic",
+  "feature",
+  "milestone",
+  "plan"
+]);
+var BUILTIN_ITEM_TYPES = new Set(Object.keys(TYPE_TO_FOLDER).map((type) => type.toLowerCase()));
+function shouldAutoIncludeGetChildren(itemType) {
+  const normalizedType = itemType.trim().toLowerCase();
+  return normalizedType.length > 0 && (AUTOMATIC_CHILD_ROLLUP_TYPES.has(normalizedType) || !BUILTIN_ITEM_TYPES.has(normalizedType));
+}
 function toClaimHistoryContext(entry) {
   return {
     ts: entry.ts,
@@ -3016,7 +3107,8 @@ function validateGetFields(fields, runtimeMetadataKeys) {
     "body",
     "linked",
     "claim_state",
-    "children"
+    "children",
+    "schedule"
   ]);
   const allowedLinkedFields = /* @__PURE__ */ new Set([
     "linked.files",
@@ -3029,9 +3121,17 @@ function validateGetFields(fields, runtimeMetadataKeys) {
     "claim_state.last_claim",
     "claim_state.last_release"
   ]);
+  const allowedScheduleFields = /* @__PURE__ */ new Set([
+    "schedule.deadline",
+    "schedule.start_at",
+    "schedule.end_at",
+    "schedule.location",
+    "schedule.reminders",
+    "schedule.events"
+  ]);
   const unknown = fields.filter((field) => {
     const normalized = normalizeGetField(field);
-    return !itemFields.has(normalized) && !allowedRootFields.has(normalized) && !allowedLinkedFields.has(normalized) && !allowedClaimStateFields.has(normalized);
+    return !itemFields.has(normalized) && !allowedRootFields.has(normalized) && !allowedLinkedFields.has(normalized) && !allowedClaimStateFields.has(normalized) && !allowedScheduleFields.has(normalized);
   });
   if (unknown.length > 0) {
     throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
@@ -3048,8 +3148,8 @@ function projectItemForFields(item, fields) {
   const source = toItemRecord(item);
   const projected = {};
   for (const field of fields) {
-    const normalized = field.startsWith("item.") ? field.slice("item.".length) : field;
-    if (normalized === "body" || normalized === "linked" || normalized.startsWith("linked.")) {
+    const normalized = normalizeGetField(field);
+    if (normalized === "body" || normalized === "linked" || normalized.startsWith("linked.") || normalized === "claim_state" || normalized.startsWith("claim_state.") || normalized === "children" || normalized.startsWith("children.") || normalized === "schedule" || normalized.startsWith("schedule.")) {
       continue;
     }
     projected[normalized] = source[normalized];
@@ -3060,7 +3160,10 @@ function fieldsInclude(fields, name) {
   return fields?.some((field) => field === name || field === `item.${name}`) ?? false;
 }
 function fieldsIncludeRoot(fields, name) {
-  return fields.some((field) => field === name || field.startsWith(`${name}.`));
+  return fields.some((field) => {
+    const normalized = normalizeGetField(field);
+    return normalized === name || normalized.startsWith(`${name}.`);
+  });
 }
 function resolveGetProjection(options) {
   if (options.full && (options.fields !== void 0 || options.depth !== void 0)) {
@@ -3069,6 +3172,9 @@ function resolveGetProjection(options) {
   if (options.tree !== true && options.treeDepth !== void 0) {
     throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
   }
+  if (options.at !== void 0 && options.tree === true) {
+    throw new PmCliError("Get --at cannot be combined with --tree because workspace-level historical projections are not yet indexed.", EXIT_CODE.USAGE);
+  }
   return {
     depth: options.full ? "deep" : parseGetDepth(options.depth),
     treeDepth: options.tree === true ? parseIntegerLimit(options.treeDepth, "--tree-depth") : void 0,
@@ -3076,13 +3182,25 @@ function resolveGetProjection(options) {
     fieldProjection: options.fields !== void 0
   };
 }
-async function loadGetItemContext(id, global) {
+async function loadGetItemContext(id, global, at) {
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
     throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
   }
   const settings = await readSettings(pmRoot);
   const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  if (at !== void 0) {
+    const historical = await getItemAt(id, at, { pmRoot: global.path });
+    return {
+      pmRoot,
+      settings,
+      typeToFolder: typeRegistry.type_to_folder,
+      locatedId: historical.document.metadata.id,
+      metadata: historical.document.metadata,
+      body: historical.document.body,
+      historical
+    };
+  }
   const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
   if (!located) {
     throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);
@@ -3097,21 +3215,21 @@ async function loadGetItemContext(id, global) {
     body: loaded.document.body
   };
 }
-function validateGetProjectionFields(fields, settings) {
+function validateGetProjectionFields(fields, settings, historical) {
   const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);
   validateGetFields(fields, runtimeMetadataKeys);
+  if (historical && fieldsIncludeRoot(fields ?? [], "children")) {
+    throw new PmCliError("Get --at cannot project children because workspace-level historical relationships are not yet indexed.", EXIT_CODE.USAGE);
+  }
 }
 function shouldIncludeGetField(params) {
-  const { fieldProjection, depth, fields, field, itemType } = params;
+  const { fieldProjection, depth, fields, field } = params;
   if (fieldProjection) {
     if (field === "body" || field === "linked") {
       return fieldsInclude(fields, field);
     }
     return fieldsIncludeRoot(fields, field);
   }
-  if (field === "children") {
-    return depth !== "brief" && CHILD_ROLLUP_TYPES.has(itemType);
-  }
   return depth !== "brief";
 }
 async function resolveGetClaimState(context, includeClaimState) {
@@ -3120,7 +3238,7 @@ async function resolveGetClaimState(context, includeClaimState) {
   }
   const historyPath = getHistoryPath(context.pmRoot, context.locatedId);
   const history = await readHistoryEntries(historyPath, context.locatedId);
-  return resolveClaimStateContext(context.metadata.assignee, history);
+  return resolveClaimStateContext(context.metadata.assignee, context.historical ? history.slice(0, context.historical.as_of_version) : history);
 }
 function attachGetLinked(result, context, fields, includeLinked) {
   const includeLinkedFiles = includeLinked || fieldsInclude(fields, "linked.files");
@@ -3135,28 +3253,28 @@ function attachGetLinked(result, context, fields, includeLinked) {
     docs: includeLinkedDocs ? context.metadata.docs ?? [] : []
   };
 }
-async function buildGetChildrenRollup(context, includeChildren) {
+async function buildGetChildrenRollup(context, includeChildren, includeEmpty) {
   if (!includeChildren) {
     return void 0;
   }
   const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);
   const corpus = await listAllItemMetadataLight(context.pmRoot, context.settings.item_format, context.typeToFolder, void 0, context.settings.schema);
-  const byStatus = {};
-  let active = 0;
-  let count = 0;
-  const locatedId = context.locatedId.trim().toLowerCase();
-  for (const candidate of corpus) {
-    const parentId = typeof candidate.parent === "string" ? candidate.parent.trim().toLowerCase() : "";
-    if (parentId !== locatedId)
-      continue;
-    const candidateStatus = candidate.status.trim().toLowerCase();
-    count += 1;
-    byStatus[candidateStatus] = (byStatus[candidateStatus] ?? 0) + 1;
-    if (!isTerminalStatus(candidateStatus, statusRegistry)) {
-      active += 1;
-    }
+  const rollup = buildItemChildrenRollup(context.locatedId, corpus, statusRegistry);
+  return rollup.count > 0 || includeEmpty ? rollup : void 0;
+}
+function attachGetSchedule(result, context, fields, includeSchedule) {
+  if (!includeSchedule) {
+    return;
+  }
+  const schedule = buildItemSchedule(context.metadata);
+  if (!schedule) {
+    return;
   }
-  return { count, active, by_status: byStatus };
+  if (fields === null || fieldsInclude(fields, "schedule")) {
+    result.schedule = schedule;
+    return;
+  }
+  result.schedule = Object.fromEntries(Object.entries(schedule).filter(([key]) => fields.some((field) => normalizeGetField(field) === `schedule.${key}`)));
 }
 async function buildGetTree(context, options, treeDepth, global) {
   if (options.tree !== true) {
@@ -3178,8 +3296,8 @@ async function buildGetTree(context, options, treeDepth, global) {
 }
 async function runGet(id, global, options = {}) {
   const projection = resolveGetProjection(options);
-  const context = await loadGetItemContext(id, global);
-  validateGetProjectionFields(projection.fields, context.settings);
+  const context = await loadGetItemContext(id, global, options.at);
+  validateGetProjectionFields(projection.fields, context.settings, context.historical !== void 0);
   const includeBody = shouldIncludeGetField({ ...projection, field: "body" });
   const includeLinked = shouldIncludeGetField({
     ...projection,
@@ -3189,12 +3307,8 @@ async function runGet(id, global, options = {}) {
     ...projection,
     field: "claim_state"
   });
-  const itemType = context.metadata.type.trim().toLowerCase();
-  const includeChildren = shouldIncludeGetField({
-    ...projection,
-    field: "children",
-    itemType
-  });
+  const includeChildren = context.historical === void 0 && (projection.fieldProjection ? fieldsIncludeRoot(projection.fields, "children") : projection.depth !== "brief" && shouldAutoIncludeGetChildren(context.metadata.type));
+  const includeSchedule = projection.fieldProjection ? fieldsIncludeRoot(projection.fields, "schedule") : projection.depth !== "brief";
   const claimState = await resolveGetClaimState(context, includeClaimState);
   const result = {
     item: projection.fieldProjection ? projectItemForFields(context.metadata, projection.fields) : projectItemForDepth(context.metadata, projection.depth)
@@ -3206,16 +3320,24 @@ async function runGet(id, global, options = {}) {
   if (claimState) {
     result.claim_state = claimState;
   }
-  result.children = await buildGetChildrenRollup(context, includeChildren);
+  attachGetSchedule(result, context, projection.fields, includeSchedule);
+  result.children = await buildGetChildrenRollup(context, includeChildren, projection.fieldProjection);
   result.tree = await buildGetTree(context, options, projection.treeDepth, global);
-  try {
-    await recordContextUsageTouches({
-      pmRoot: context.pmRoot,
-      author: (process.env.PM_AUTHOR ?? context.settings.author_default).trim() || "unknown",
-      itemIds: [context.locatedId],
-      intent: "get"
-    });
-  } catch {
+  if (context.historical) {
+    result.reconstructed = true;
+    result.as_of_version = context.historical.as_of_version;
+    result.as_of_timestamp = context.historical.as_of_timestamp;
+  }
+  if (context.historical === void 0) {
+    try {
+      await recordContextUsageTouches({
+        pmRoot: context.pmRoot,
+        author: (process.env.PM_AUTHOR ?? context.settings.author_default).trim() || "unknown",
+        itemIds: [context.locatedId],
+        intent: "get"
+      });
+    } catch {
+    }
   }
   return result;
 }
@@ -3224,8 +3346,13 @@ export {
   runAggregate,
   runSearch,
   runEval,
+  MAX_CHILD_PROJECTION_ITEMS,
+  DEFAULT_CHILD_SAMPLE_LIMIT,
+  buildItemChildrenRollup,
+  itemHasSchedule,
+  buildItemSchedule,
   runGet
 };
-//# sourceMappingURL=chunk-CDJYP7OQ.js.map
+//# sourceMappingURL=chunk-ONG5V5CI.js.map
 
-//# debugId=fa5c921d-05ab-548a-a7c5-6c3c0ca14357
+//# debugId=9a21d12c-d2fd-5325-930c-dfc8bbfe8247