@unbrained/pm-cli 2026.7.1 → 2026.7.2

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../cli/commands/history-repair.ts"],
+  "sourcesContent": ["/**\n * @module cli/commands/history-repair\n *\n * Implements the pm history repair command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport jsonPatch from \"fast-json-patch\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { executeHistoryRewrite } from \"../../core/history/history-rewrite.js\";\nimport {\n  historyEntriesToRaw,\n  reanchorHistoryEntries,\n  replayHash,\n  toReplayDocument,\n  verifyHistoryChain,\n  type ReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { scanHistoryDrift } from \"../../core/history/drift-scan.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getActiveExtensionRegistrations, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { listAllFrontMatterWithBody, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\nimport { resolveHistorySubject } from \"./history-redact.js\";\n\n/**\n * Documents the history repair command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairCommandOptions {\n  dryRun?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\n/**\n * Documents the history repair result payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryRepairResult {\n  id: string;\n  dry_run: boolean;\n  changed: boolean;\n  history: {\n    path: string;\n    entries_scanned: number;\n    chain_drift_before: boolean;\n    entries_rehashed: number;\n    entries_patch_repaired: number;\n    converted_replace_to_add: number;\n    skipped_ops: number;\n    reconciled_with_item: boolean;\n    audit_entry_added: boolean;\n    verify_ok: boolean;\n    verify_errors: string[];\n  };\n  item: {\n    exists: boolean;\n    path: string | null;\n    matched_chain_before: boolean | null;\n  };\n  warnings: string[];\n  generated_at: string;\n}\n\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"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{init-64XDLQJB.js → init-F27NHENZ.js}

@@ -4,23 +4,23 @@ import {
   _testOnly,
   runInit,
   summarizeInitResult
-} from "./chunk-V3NOKJF2.js";
-import "./chunk-NU2UEROZ.js";
+} from "./chunk-6YCYF2AI.js";
+import "./chunk-3AZUFQK6.js";
 import "./chunk-P4SESZGT.js";
-import "./chunk-2D4HATP2.js";
-import "./chunk-MAUKX7JC.js";
-import "./chunk-6AQZPVHQ.js";
-import "./chunk-4A3BJ675.js";
-import "./chunk-HXTQJXWT.js";
-import "./chunk-JSU5P7VS.js";
-import "./chunk-QCWF6IYD.js";
-import "./chunk-AXIDKKAT.js";
-import "./chunk-7R4QEMZZ.js";
+import "./chunk-YLZZ6T54.js";
+import "./chunk-ZNT7KEWE.js";
+import "./chunk-KIYCOJ63.js";
+import "./chunk-OTUJZKGI.js";
+import "./chunk-5GVTFFTC.js";
+import "./chunk-NRZS637N.js";
+import "./chunk-KN3URLKS.js";
+import "./chunk-K2VYLVX4.js";
+import "./chunk-I66WE2HE.js";
 export {
   _testOnly,
   runInit,
   summarizeInitResult
 };
-//# sourceMappingURL=init-64XDLQJB.js.map
+//# sourceMappingURL=init-F27NHENZ.js.map
 
 //# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

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

@@ -0,0 +1,22 @@
+import {
+  _testOnly,
+  runInit,
+  summarizeInitResult
+} from "./chunk-66Z3X7ZG.js";
+import "./chunk-N3QCJS4M.js";
+import "./chunk-5HIZDR5A.js";
+import "./chunk-SPM2XLWI.js";
+import "./chunk-3LCUASYG.js";
+import "./chunk-GRRG3MCT.js";
+import "./chunk-BVZZN2LH.js";
+import "./chunk-XWGEMNBR.js";
+import "./chunk-JXAUVO6X.js";
+import "./chunk-IEEJQCZ4.js";
+import "./chunk-AIAIXG7I.js";
+import "./chunk-7NSPKJUS.js";
+export {
+  _testOnly,
+  runInit,
+  summarizeInitResult
+};
+//# sourceMappingURL=init-HHVQQP6C.js.map

package/dist/cli-bundle/chunks/{learnings-LPKCSJX7.js → learnings-HJVDQIGY.js}

@@ -3,16 +3,16 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-W4ULYO7Z.js";
+} from "./chunk-55XRYWEG.js";
 import {
   createStdinTokenResolver
-} from "./chunk-ZRP4VG5U.js";
+} from "./chunk-KLXF7NCC.js";
 import "./chunk-T5RRNDA7.js";
-import "./chunk-UZIWVBE6.js";
-import "./chunk-JSU5P7VS.js";
-import "./chunk-QCWF6IYD.js";
-import "./chunk-AXIDKKAT.js";
-import "./chunk-7R4QEMZZ.js";
+import "./chunk-2CHRYUXL.js";
+import "./chunk-NRZS637N.js";
+import "./chunk-KN3URLKS.js";
+import "./chunk-K2VYLVX4.js";
+import "./chunk-I66WE2HE.js";
 
 // dist/cli/commands/learnings.js
 async function runLearnings(id, options, global) {
@@ -38,6 +38,6 @@ async function runLearnings(id, options, global) {
 export {
   runLearnings
 };
-//# sourceMappingURL=learnings-LPKCSJX7.js.map
+//# sourceMappingURL=learnings-HJVDQIGY.js.map
 
 //# debugId=1c9d8c84-f7be-5045-b1ae-18cdc9f272f2

package/dist/cli-bundle/chunks/{learnings-JR6MA5TI.js → learnings-XSFSUUWK.js}

@@ -1,16 +1,16 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-2466X6E4.js";
+} from "./chunk-FFOQHGNH.js";
 import {
   createStdinTokenResolver
-} from "./chunk-DDPTYJIM.js";
+} from "./chunk-ZNHEYCDD.js";
 import "./chunk-WW4E2DC3.js";
-import "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
+import "./chunk-JMK5GCK2.js";
+import "./chunk-JXAUVO6X.js";
+import "./chunk-IEEJQCZ4.js";
+import "./chunk-AIAIXG7I.js";
+import "./chunk-7NSPKJUS.js";
 
 // dist/cli/commands/learnings.js
 !(function() {
@@ -43,4 +43,4 @@ async function runLearnings(id, options, global2) {
 export {
   runLearnings
 };
-//# sourceMappingURL=learnings-JR6MA5TI.js.map
+//# sourceMappingURL=learnings-XSFSUUWK.js.map

package/dist/cli-bundle/chunks/{list-G5Y65VF6.js → list-HPMEKCAA.js}

@@ -8,14 +8,14 @@ import {
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-3S2KT7NG.js";
+} from "./chunk-W47SML5B.js";
 import "./chunk-R23CSHGI.js";
-import "./chunk-NFDPYAIP.js";
-import "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
-import "./chunk-BHO33VBQ.js";
-import "./chunk-WYDHYJPO.js";
-import "./chunk-RVUALSJF.js";
+import "./chunk-36UGKF4O.js";
+import "./chunk-JMK5GCK2.js";
+import "./chunk-JXAUVO6X.js";
+import "./chunk-IEEJQCZ4.js";
+import "./chunk-AIAIXG7I.js";
+import "./chunk-7NSPKJUS.js";
 export {
   LIST_SORT_FIELDS,
   LIST_SORT_ORDER_VALUES,
@@ -27,4 +27,4 @@ export {
   resolveMissingMetadataFilters,
   runList
 };
-//# sourceMappingURL=list-G5Y65VF6.js.map
+//# sourceMappingURL=list-HPMEKCAA.js.map

package/dist/cli-bundle/chunks/{list-DNBJVO3E.js → list-VMPWTURB.js}

@@ -10,14 +10,14 @@ import {
   resolveContentFieldFilters,
   resolveMissingMetadataFilters,
   runList
-} from "./chunk-5CGRF3L5.js";
+} from "./chunk-Q6K2OACU.js";
 import "./chunk-QB7XMHJW.js";
-import "./chunk-3VGN2UWE.js";
-import "./chunk-UZIWVBE6.js";
-import "./chunk-JSU5P7VS.js";
-import "./chunk-QCWF6IYD.js";
-import "./chunk-AXIDKKAT.js";
-import "./chunk-7R4QEMZZ.js";
+import "./chunk-EMPGXBUF.js";
+import "./chunk-2CHRYUXL.js";
+import "./chunk-NRZS637N.js";
+import "./chunk-KN3URLKS.js";
+import "./chunk-K2VYLVX4.js";
+import "./chunk-I66WE2HE.js";
 export {
   LIST_SORT_FIELDS,
   LIST_SORT_ORDER_VALUES,
@@ -29,6 +29,6 @@ export {
   resolveMissingMetadataFilters,
   runList
 };
-//# sourceMappingURL=list-DNBJVO3E.js.map
+//# sourceMappingURL=list-VMPWTURB.js.map
 
 //# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/{next-BCERKDUR.js → next-ETXF2ZCN.js}

@@ -1,45 +1,45 @@
 import {
   collectBlockedByIds,
   computeActionabilityReport
-} from "./chunk-HPPFYYOV.js";
+} from "./chunk-3Q2HBMTI.js";
 import {
   buildChildrenByParent,
   collectSubtreeIds,
   compareCriticalItems,
   toContextFocusItem
-} from "./chunk-55SNVXRQ.js";
-import "./chunk-JLM7BHI7.js";
-import "./chunk-64HNBBFQ.js";
-import "./chunk-G7I7DEZA.js";
+} from "./chunk-XEWQKDYZ.js";
+import "./chunk-GFMSLORL.js";
+import "./chunk-A6VOGKBA.js";
+import "./chunk-N2JSWVWG.js";
 import {
   runList
-} from "./chunk-3S2KT7NG.js";
+} from "./chunk-W47SML5B.js";
 import "./chunk-R23CSHGI.js";
-import "./chunk-NFDPYAIP.js";
+import "./chunk-36UGKF4O.js";
 import {
   parseIntegerLimit
-} from "./chunk-4DUVCVLZ.js";
-import "./chunk-3K2M5OYU.js";
+} from "./chunk-JMK5GCK2.js";
+import "./chunk-JXAUVO6X.js";
 import {
   normalizeStatusForRegistry,
   normalizeStatusInput
-} from "./chunk-BHO33VBQ.js";
+} from "./chunk-IEEJQCZ4.js";
 import {
   nowIso
-} from "./chunk-WYDHYJPO.js";
+} from "./chunk-AIAIXG7I.js";
 import {
   EXIT_CODE,
   PmCliError,
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-RVUALSJF.js";
+} from "./chunk-7NSPKJUS.js";
 
 // dist/cli/commands/next.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] = "38a305c9-7ad5-5b16-9eaf-c0f210ef70e3");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b7714e87-e515-5188-a513-254a194d692d");
   } catch (e2) {
   }
 })();
@@ -134,6 +134,42 @@ function nextListOptions(options, extra) {
     ...extra
   };
 }
+function rankNextReadyEntries(ready, childrenByParent, statusRegistry) {
+  return [...ready].sort((left, right) => {
+    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);
+    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);
+    if (leftCompletedContainer !== rightCompletedContainer) {
+      return Number(leftCompletedContainer) - Number(rightCompletedContainer);
+    }
+    return compareCriticalItems(left.item, right.item, statusRegistry);
+  });
+}
+function buildNextRecommendation(params) {
+  if (params.projectedReady.length === 0) {
+    return null;
+  }
+  return {
+    ...params.readyRows[0],
+    reasons: buildRecommendationReasons(params.projectedReady[0], params.statusRegistry, params.now, params.completedContainer)
+  };
+}
+function buildNextSuggestions(recommended, blockedRows) {
+  if (recommended !== null) {
+    return void 0;
+  }
+  if (blockedRows.length > 0) {
+    return [
+      `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers.map((blocker) => blocker.id).join(", ")}`,
+      "pm next --ready-only after a blocker closes to re-check ready work",
+      'pm create --type Task --title "..." to add new ready work'
+    ];
+  }
+  return [
+    'pm create --type Task --title "..." to add a new work item',
+    "pm list --status in_progress to review work already underway",
+    "pm context --depth deep for the full project snapshot"
+  ];
+}
 async function runNext(options, global2) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   const settings = await readSettings(pmRoot);
@@ -156,23 +192,19 @@ async function runNext(options, global2) {
   }
   const report = computeActionabilityReport(candidates, corpus, statusRegistry);
   const childrenByParent = buildChildrenByParent(corpus);
-  const rankedReady = [...report.ready].sort((left, right) => {
-    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);
-    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);
-    if (leftCompletedContainer !== rightCompletedContainer) {
-      return Number(leftCompletedContainer) - Number(rightCompletedContainer);
-    }
-    return compareCriticalItems(left.item, right.item, statusRegistry);
-  });
+  const rankedReady = rankNextReadyEntries(report.ready, childrenByParent, statusRegistry);
   const rankedBlocked = [...report.blocked].sort((left, right) => compareCriticalItems(left.item, right.item, statusRegistry));
   const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));
   const projectedReady = concreteReady.length > 0 ? concreteReady : rankedReady;
   const readyRows = projectedReady.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
   const blockedRows = rankedBlocked.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
-  const recommended = projectedReady.length > 0 ? {
-    ...readyRows[0],
-    reasons: buildRecommendationReasons(projectedReady[0], statusRegistry, now, concreteReady.length === 0)
-  } : null;
+  const recommended = buildNextRecommendation({
+    projectedReady,
+    readyRows,
+    statusRegistry,
+    now,
+    completedContainer: concreteReady.length === 0
+  });
   const result = {
     output_default: "toon",
     now,
@@ -204,17 +236,7 @@ async function runNext(options, global2) {
   const warnings = [.../* @__PURE__ */ new Set([...candidatesList.warnings ?? [], ...corpusList.warnings ?? []])].sort((a, b) => a.localeCompare(b));
   if (warnings.length > 0)
     result.warnings = warnings;
-  if (recommended === null) {
-    result.suggestions = blockedRows.length > 0 ? [
-      `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers.map((blocker) => blocker.id).join(", ")}`,
-      "pm next --ready-only after a blocker closes to re-check ready work",
-      'pm create --type Task --title "..." to add new ready work'
-    ] : [
-      'pm create --type Task --title "..." to add a new work item',
-      "pm list --status in_progress to review work already underway",
-      "pm context --depth deep for the full project snapshot"
-    ];
-  }
+  result.suggestions = buildNextSuggestions(recommended, blockedRows);
   return result;
 }
 function renderNextMarkdown(result) {
@@ -274,4 +296,4 @@ export {
   resolveNextOutputFormat,
   runNext
 };
-//# sourceMappingURL=next-BCERKDUR.js.map
+//# sourceMappingURL=next-ETXF2ZCN.js.map

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

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

package/dist/cli-bundle/chunks/{next-FYTQF6HG.js → next-QM6YJIIS.js}

@@ -1,41 +1,41 @@
 
-!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]="bca61937-38ff-5efd-a053-cedbe61bd792")}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]="96adc783-27b6-59a3-a10d-61aa718f92fb")}catch(e){}}();
 import {
   collectBlockedByIds,
   computeActionabilityReport
-} from "./chunk-NOLPZMSV.js";
+} from "./chunk-BTX5MIQF.js";
 import {
   buildChildrenByParent,
   collectSubtreeIds,
   compareCriticalItems,
   toContextFocusItem
-} from "./chunk-JWXRETDF.js";
-import "./chunk-22WKIL3H.js";
-import "./chunk-OGXLACHC.js";
-import "./chunk-SLMUGTK3.js";
+} from "./chunk-XCHUVHKU.js";
+import "./chunk-YPKFV2JR.js";
+import "./chunk-HQTPRV4D.js";
+import "./chunk-2ASNV4DH.js";
 import {
   runList
-} from "./chunk-5CGRF3L5.js";
+} from "./chunk-Q6K2OACU.js";
 import "./chunk-QB7XMHJW.js";
-import "./chunk-3VGN2UWE.js";
+import "./chunk-EMPGXBUF.js";
 import {
   parseIntegerLimit
-} from "./chunk-UZIWVBE6.js";
-import "./chunk-JSU5P7VS.js";
+} from "./chunk-2CHRYUXL.js";
+import "./chunk-NRZS637N.js";
 import {
   normalizeStatusForRegistry,
   normalizeStatusInput
-} from "./chunk-QCWF6IYD.js";
+} from "./chunk-KN3URLKS.js";
 import {
   nowIso
-} from "./chunk-AXIDKKAT.js";
+} from "./chunk-K2VYLVX4.js";
 import {
   EXIT_CODE,
   PmCliError,
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-7R4QEMZZ.js";
+} from "./chunk-I66WE2HE.js";
 
 // dist/cli/commands/next.js
 var NEXT_OUTPUT_VALUES = ["markdown", "toon", "json"];
@@ -129,6 +129,42 @@ function nextListOptions(options, extra) {
     ...extra
   };
 }
+function rankNextReadyEntries(ready, childrenByParent, statusRegistry) {
+  return [...ready].sort((left, right) => {
+    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);
+    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);
+    if (leftCompletedContainer !== rightCompletedContainer) {
+      return Number(leftCompletedContainer) - Number(rightCompletedContainer);
+    }
+    return compareCriticalItems(left.item, right.item, statusRegistry);
+  });
+}
+function buildNextRecommendation(params) {
+  if (params.projectedReady.length === 0) {
+    return null;
+  }
+  return {
+    ...params.readyRows[0],
+    reasons: buildRecommendationReasons(params.projectedReady[0], params.statusRegistry, params.now, params.completedContainer)
+  };
+}
+function buildNextSuggestions(recommended, blockedRows) {
+  if (recommended !== null) {
+    return void 0;
+  }
+  if (blockedRows.length > 0) {
+    return [
+      `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers.map((blocker) => blocker.id).join(", ")}`,
+      "pm next --ready-only after a blocker closes to re-check ready work",
+      'pm create --type Task --title "..." to add new ready work'
+    ];
+  }
+  return [
+    'pm create --type Task --title "..." to add a new work item',
+    "pm list --status in_progress to review work already underway",
+    "pm context --depth deep for the full project snapshot"
+  ];
+}
 async function runNext(options, global) {
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
   const settings = await readSettings(pmRoot);
@@ -151,23 +187,19 @@ async function runNext(options, global) {
   }
   const report = computeActionabilityReport(candidates, corpus, statusRegistry);
   const childrenByParent = buildChildrenByParent(corpus);
-  const rankedReady = [...report.ready].sort((left, right) => {
-    const leftCompletedContainer = hasCompletedDescendants(left.item, childrenByParent);
-    const rightCompletedContainer = hasCompletedDescendants(right.item, childrenByParent);
-    if (leftCompletedContainer !== rightCompletedContainer) {
-      return Number(leftCompletedContainer) - Number(rightCompletedContainer);
-    }
-    return compareCriticalItems(left.item, right.item, statusRegistry);
-  });
+  const rankedReady = rankNextReadyEntries(report.ready, childrenByParent, statusRegistry);
   const rankedBlocked = [...report.blocked].sort((left, right) => compareCriticalItems(left.item, right.item, statusRegistry));
   const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));
   const projectedReady = concreteReady.length > 0 ? concreteReady : rankedReady;
   const readyRows = projectedReady.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
   const blockedRows = rankedBlocked.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
-  const recommended = projectedReady.length > 0 ? {
-    ...readyRows[0],
-    reasons: buildRecommendationReasons(projectedReady[0], statusRegistry, now, concreteReady.length === 0)
-  } : null;
+  const recommended = buildNextRecommendation({
+    projectedReady,
+    readyRows,
+    statusRegistry,
+    now,
+    completedContainer: concreteReady.length === 0
+  });
   const result = {
     output_default: "toon",
     now,
@@ -199,17 +231,7 @@ async function runNext(options, global) {
   const warnings = [.../* @__PURE__ */ new Set([...candidatesList.warnings ?? [], ...corpusList.warnings ?? []])].sort((a, b) => a.localeCompare(b));
   if (warnings.length > 0)
     result.warnings = warnings;
-  if (recommended === null) {
-    result.suggestions = blockedRows.length > 0 ? [
-      `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedRows[0].blockers.map((blocker) => blocker.id).join(", ")}`,
-      "pm next --ready-only after a blocker closes to re-check ready work",
-      'pm create --type Task --title "..." to add new ready work'
-    ] : [
-      'pm create --type Task --title "..." to add a new work item',
-      "pm list --status in_progress to review work already underway",
-      "pm context --depth deep for the full project snapshot"
-    ];
-  }
+  result.suggestions = buildNextSuggestions(recommended, blockedRows);
   return result;
 }
 function renderNextMarkdown(result) {
@@ -269,6 +291,6 @@ export {
   resolveNextOutputFormat,
   runNext
 };
-//# sourceMappingURL=next-FYTQF6HG.js.map
+//# sourceMappingURL=next-QM6YJIIS.js.map
 
-//# debugId=bca61937-38ff-5efd-a053-cedbe61bd792
+//# debugId=96adc783-27b6-59a3-a10d-61aa718f92fb