@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli/commands/legacy-none-tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-none-tokens.js","sources":["cli/commands/legacy-none-tokens.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/legacy-none-tokens\n *\n * Implements the pm legacy none tokens command surface and its agent-facing runtime behavior.\n */\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\n\n/**\n * Shared legacy \"none\"/\"null\" sentinel handling for the create and update\n * commands. These tokens used to mean \"clear this field\"; they are now\n * rejected in favour of explicit --unset / --clear-* flags.\n *\n * Extracted verbatim from create.ts and update.ts (pm-why9) — behaviour and\n * error strings are identical to the previous per-command copies.\n */\nconst LEGACY_NONE_TOKENS = new Set([\"none\", \"null\"]);\n\n/** Describes a repeatable option whose legacy none/null token maps to a clear flag. */\nexport interface LegacyNoneCollectionNormalizer<\n  TOptions extends Record<string, unknown>,\n> {\n  /** Value that configures or reports option key for this contract. */\n  optionKey: keyof TOptions;\n  /** Value that configures or reports clear flag key for this contract. */\n  clearFlagKey: keyof TOptions;\n  /** Value that configures or reports value flag for this contract. */\n  valueFlag: string;\n  /** Value that configures or reports clear flag for this contract. */\n  clearFlag: string;\n  /** Value that configures or reports disable flag key for this contract. */\n  disableFlagKey?: keyof TOptions;\n}\n\n/** Implements check whether legacy none token for the public runtime surface of this module. */\nexport function isLegacyNoneToken(value: string | undefined): boolean {\n  if (value === undefined) {\n    return false;\n  }\n  return LEGACY_NONE_TOKENS.has(value.trim().toLowerCase());\n}\n\n/** Implements assert no legacy none token for the public runtime surface of this module. */\nexport function assertNoLegacyNoneToken(\n  value: string | undefined,\n  flag: string,\n  replacementHint?: string,\n): void {\n  if (!isLegacyNoneToken(value)) {\n    return;\n  }\n  const suffix = replacementHint ? ` ${replacementHint}` : \"\";\n  throw new PmCliError(\n    `${flag} no longer accepts \"none\" or \"null\".${suffix}`.trim(),\n    EXIT_CODE.USAGE,\n  );\n}\n\n/** Implements assert no legacy none tokens for the public runtime surface of this module. */\nexport function assertNoLegacyNoneTokens(\n  values: string[] | undefined,\n  flag: string,\n  replacementHint?: string,\n): void {\n  if (!values || values.length === 0) {\n    return;\n  }\n  const hasLegacyToken = values.some((value) => isLegacyNoneToken(value));\n  if (!hasLegacyToken) {\n    return;\n  }\n  const suffix = replacementHint ? ` ${replacementHint}` : \"\";\n  throw new PmCliError(\n    `${flag} no longer accepts \"none\" or \"null\".${suffix}`.trim(),\n    EXIT_CODE.USAGE,\n  );\n}\n\n/** Convert collection-level legacy none/null tokens into their explicit clear flags. */\nexport function applyLegacyNoneCollectionNormalizers<\n  TOptions extends Record<string, unknown>,\n>(\n  normalized: TOptions,\n  definitions: ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>,\n): TOptions {\n  for (const definition of definitions) {\n    const candidate = normalized[definition.optionKey];\n    if (!Array.isArray(candidate) || candidate.length === 0) {\n      continue;\n    }\n    if (\n      !candidate.every((entry): entry is string => typeof entry === \"string\")\n    ) {\n      throw new PmCliError(\n        `${definition.valueFlag} entries must be strings.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const entries = candidate;\n    const hasLegacy = entries.some((entry) => isLegacyNoneToken(entry));\n    if (!hasLegacy) {\n      continue;\n    }\n    const concreteEntries = entries.filter(\n      (entry) => !isLegacyNoneToken(entry),\n    );\n    if (concreteEntries.length > 0) {\n      throw new PmCliError(\n        `Cannot mix legacy clear token \"none\"/\"null\" with concrete ${definition.valueFlag} entries. Use ${definition.clearFlag} to clear or provide explicit entries.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    normalized[definition.optionKey] = undefined as TOptions[keyof TOptions];\n    normalized[definition.clearFlagKey] = true as TOptions[keyof TOptions];\n    if (definition.disableFlagKey) {\n      normalized[definition.disableFlagKey] = false as TOptions[keyof TOptions];\n    }\n  }\n  return normalized;\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAkBrD,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CACrC,KAAyB,EACzB,IAAY,EACZ,eAAwB;IAExB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,IAAI,UAAU,CAClB,GAAG,IAAI,uCAAuC,MAAM,EAAE,CAAC,IAAI,EAAE,EAC7D,SAAS,CAAC,KAAK,CAChB,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB,CACtC,MAA4B,EAC5B,IAAY,EACZ,eAAwB;IAExB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,IAAI,UAAU,CAClB,GAAG,IAAI,uCAAuC,MAAM,EAAE,CAAC,IAAI,EAAE,EAC7D,SAAS,CAAC,KAAK,CAChB,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oCAAoC,CAGlD,UAAoB,EACpB,WAAoE;IAEpE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QACD,IACE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EACvE,CAAC;YACD,MAAM,IAAI,UAAU,CAClB,GAAG,UAAU,CAAC,SAAS,2BAA2B,EAClD,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC;QAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CACpC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CACrC,CAAC;QACF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAClB,6DAA6D,UAAU,CAAC,SAAS,iBAAiB,UAAU,CAAC,SAAS,wCAAwC,EAC9J,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,SAAqC,CAAC;QACzE,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,IAAgC,CAAC;QACvE,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9B,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,KAAiC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC","debugId":"af642aea-a253-5bd0-bc0d-e2e01d4be025"}
+{"version":3,"file":"legacy-none-tokens.js","sources":["cli/commands/legacy-none-tokens.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/legacy-none-tokens\n *\n * Implements the pm legacy none tokens command surface and its agent-facing runtime behavior.\n */\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\n\n/**\n * Shared legacy \"none\"/\"null\" sentinel handling for the create and update\n * commands. These tokens used to mean \"clear this field\"; they are now\n * rejected in favour of explicit --unset / --clear-* flags.\n *\n * Extracted verbatim from create.ts and update.ts (pm-why9) — behaviour and\n * error strings are identical to the previous per-command copies.\n */\nconst LEGACY_NONE_TOKENS = new Set([\"none\", \"null\"]);\n\n/** Describes a repeatable option whose legacy none/null token maps to a clear flag. */\nexport interface LegacyNoneCollectionNormalizer<\n  TOptions extends object,\n> {\n  /** Value that configures or reports option key for this contract. */\n  optionKey: keyof TOptions;\n  /** Value that configures or reports clear flag key for this contract. */\n  clearFlagKey: keyof TOptions;\n  /** Value that configures or reports value flag for this contract. */\n  valueFlag: string;\n  /** Value that configures or reports clear flag for this contract. */\n  clearFlag: string;\n  /** Value that configures or reports disable flag key for this contract. */\n  disableFlagKey?: keyof TOptions;\n}\n\n/** Collection and clear options shared by create and update legacy-token normalization. */\nexport interface LegacyNoneCollectionOptions {\n  /** Dependency entries accepted by create and update. */\n  dep?: string[];\n  /** Whether dependency entries should be cleared. */\n  clearDeps?: boolean;\n  /** Comment entries accepted by create and update. */\n  comment?: string[];\n  /** Whether comment entries should be cleared. */\n  clearComments?: boolean;\n  /** Note entries accepted by create and update. */\n  note?: string[];\n  /** Whether note entries should be cleared. */\n  clearNotes?: boolean;\n  /** Learning entries accepted by create and update. */\n  learning?: string[];\n  /** Whether learning entries should be cleared. */\n  clearLearnings?: boolean;\n  /** Linked-file entries accepted by create and update. */\n  file?: string[];\n  /** Whether linked-file entries should be cleared. */\n  clearFiles?: boolean;\n  /** Linked-test entries accepted by create and update. */\n  test?: string[];\n  /** Whether linked-test entries should be cleared. */\n  clearTests?: boolean;\n  /** Linked-document entries accepted by create and update. */\n  doc?: string[];\n  /** Whether linked-document entries should be cleared. */\n  clearDocs?: boolean;\n  /** Reminder entries accepted by create and update. */\n  reminder?: string[];\n  /** Whether reminder entries should be cleared. */\n  clearReminders?: boolean;\n  /** Event entries accepted by create and update. */\n  event?: string[];\n  /** Whether event entries should be cleared. */\n  clearEvents?: boolean;\n  /** Custom type-option entries accepted by create and update. */\n  typeOption?: string[];\n  /** Whether custom type-option entries should be cleared. */\n  clearTypeOptions?: boolean;\n}\n\n/** Build the shared create/update collection normalizer table with optional replacement-mode guards. */\nexport function createLegacyNoneCollectionNormalizers<\n  TOptions extends LegacyNoneCollectionOptions,\n>(\n  options: {\n    depDisableFlagKey?: keyof TOptions;\n    testDisableFlagKey?: keyof TOptions;\n  } = {},\n): ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>> {\n  return [\n    {\n      optionKey: \"dep\",\n      clearFlagKey: \"clearDeps\",\n      valueFlag: \"--dep\",\n      clearFlag: \"--clear-deps\",\n      ...(options.depDisableFlagKey === undefined\n        ? {}\n        : { disableFlagKey: options.depDisableFlagKey }),\n    },\n    {\n      optionKey: \"comment\",\n      clearFlagKey: \"clearComments\",\n      valueFlag: \"--comment\",\n      clearFlag: \"--clear-comments\",\n    },\n    {\n      optionKey: \"note\",\n      clearFlagKey: \"clearNotes\",\n      valueFlag: \"--note\",\n      clearFlag: \"--clear-notes\",\n    },\n    {\n      optionKey: \"learning\",\n      clearFlagKey: \"clearLearnings\",\n      valueFlag: \"--learning\",\n      clearFlag: \"--clear-learnings\",\n    },\n    {\n      optionKey: \"file\",\n      clearFlagKey: \"clearFiles\",\n      valueFlag: \"--file\",\n      clearFlag: \"--clear-files\",\n    },\n    {\n      optionKey: \"test\",\n      clearFlagKey: \"clearTests\",\n      valueFlag: \"--test\",\n      clearFlag: \"--clear-tests\",\n      ...(options.testDisableFlagKey === undefined\n        ? {}\n        : { disableFlagKey: options.testDisableFlagKey }),\n    },\n    {\n      optionKey: \"doc\",\n      clearFlagKey: \"clearDocs\",\n      valueFlag: \"--doc\",\n      clearFlag: \"--clear-docs\",\n    },\n    {\n      optionKey: \"reminder\",\n      clearFlagKey: \"clearReminders\",\n      valueFlag: \"--reminder\",\n      clearFlag: \"--clear-reminders\",\n    },\n    {\n      optionKey: \"event\",\n      clearFlagKey: \"clearEvents\",\n      valueFlag: \"--event\",\n      clearFlag: \"--clear-events\",\n    },\n    {\n      optionKey: \"typeOption\",\n      clearFlagKey: \"clearTypeOptions\",\n      valueFlag: \"--type-option\",\n      clearFlag: \"--clear-type-options\",\n    },\n  ];\n}\n\n/** Implements check whether legacy none token for the public runtime surface of this module. */\nexport function isLegacyNoneToken(value: string | undefined): boolean {\n  if (value === undefined) {\n    return false;\n  }\n  return LEGACY_NONE_TOKENS.has(value.trim().toLowerCase());\n}\n\n/** Implements assert no legacy none token for the public runtime surface of this module. */\nexport function assertNoLegacyNoneToken(\n  value: string | undefined,\n  flag: string,\n  replacementHint?: string,\n): void {\n  if (!isLegacyNoneToken(value)) {\n    return;\n  }\n  const suffix = replacementHint ? ` ${replacementHint}` : \"\";\n  throw new PmCliError(\n    `${flag} no longer accepts \"none\" or \"null\".${suffix}`.trim(),\n    EXIT_CODE.USAGE,\n  );\n}\n\n/** Implements assert no legacy none tokens for the public runtime surface of this module. */\nexport function assertNoLegacyNoneTokens(\n  values: string[] | undefined,\n  flag: string,\n  replacementHint?: string,\n): void {\n  if (!values || values.length === 0) {\n    return;\n  }\n  const hasLegacyToken = values.some((value) => isLegacyNoneToken(value));\n  if (!hasLegacyToken) {\n    return;\n  }\n  const suffix = replacementHint ? ` ${replacementHint}` : \"\";\n  throw new PmCliError(\n    `${flag} no longer accepts \"none\" or \"null\".${suffix}`.trim(),\n    EXIT_CODE.USAGE,\n  );\n}\n\n/** Convert collection-level legacy none/null tokens into their explicit clear flags. */\nexport function applyLegacyNoneCollectionNormalizers<\n  TOptions extends Record<string, unknown>,\n>(\n  normalized: TOptions,\n  definitions: ReadonlyArray<LegacyNoneCollectionNormalizer<TOptions>>,\n): TOptions {\n  for (const definition of definitions) {\n    const candidate = normalized[definition.optionKey];\n    if (!Array.isArray(candidate) || candidate.length === 0) {\n      continue;\n    }\n    if (\n      !candidate.every((entry): entry is string => typeof entry === \"string\")\n    ) {\n      throw new PmCliError(\n        `${definition.valueFlag} entries must be strings.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const entries = candidate;\n    const hasLegacy = entries.some((entry) => isLegacyNoneToken(entry));\n    if (!hasLegacy) {\n      continue;\n    }\n    const concreteEntries = entries.filter(\n      (entry) => !isLegacyNoneToken(entry),\n    );\n    if (concreteEntries.length > 0) {\n      throw new PmCliError(\n        `Cannot mix legacy clear token \"none\"/\"null\" with concrete ${definition.valueFlag} entries. Use ${definition.clearFlag} to clear or provide explicit entries.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    normalized[definition.optionKey] = undefined as TOptions[keyof TOptions];\n    normalized[definition.clearFlagKey] = true as TOptions[keyof TOptions];\n    if (definition.disableFlagKey) {\n      normalized[definition.disableFlagKey] = false as TOptions[keyof TOptions];\n    }\n  }\n  return normalized;\n}\n"],"names":[],"mappings":"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","debugId":"66cfe799-e16b-5591-93ac-c022ecd71609"}

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

@@ -23,7 +23,7 @@ export interface NextOptions {
     /** Value that configures or reports tag for this contract. */
     tag?: string;
     /** Value that configures or reports priority for this contract. */
-    priority?: string;
+    priority?: string | number;
     /** Value that configures or reports assignee for this contract. */
     assignee?: string;
     /** Value that configures or reports assignee filter for this contract. */
@@ -44,6 +44,8 @@ export interface NextOptions {
     format?: string;
     /** Value that configures or reports explain ranking for this contract. */
     explainRanking?: boolean;
+    /** Include human-gated Decision items in the claimable ready queue. */
+    includeDecisions?: boolean;
     /** Internal caller override used to align claim-next ranking with --author. */
     callerAuthor?: string;
     [key: string]: unknown;
@@ -63,6 +65,8 @@ export interface NextBlockerRef {
  * would unblock.
  */
 export interface NextActionableItem extends ContextFocusItem {
+    /** One-based position in the complete ranked actionable queue. */
+    rank: number;
     /** Number of open blocker entries represented by this result. */
     open_blocker_count: number;
     /** Value that configures or reports blockers for this contract. */
@@ -93,6 +97,8 @@ export interface NextResult {
     recommended: NextRecommendation | null;
     /** Value that configures or reports ready for this contract. */
     ready: NextActionableItem[];
+    /** Human-gated decisions kept visible without dispatching them to agents. */
+    decision_needed: NextActionableItem[];
     /** Value that configures or reports blocked for this contract. */
     blocked: NextActionableItem[];
     /** Value that configures or reports held by others for this contract. */
@@ -106,7 +112,7 @@ export interface NextResult {
     filters: {
         type: string | null;
         tag: string | null;
-        priority: string | null;
+        priority: string | number | null;
         assignee: string | null;
         assignee_filter: string | null;
         sprint: string | null;
@@ -115,6 +121,7 @@ export interface NextResult {
         limit: number;
         blocked_limit: number;
         ready_only: boolean;
+        include_decisions: boolean;
     };
     /** Value that configures or reports suggestions for this contract. */
     suggestions?: string[];
@@ -136,6 +143,11 @@ declare function partitionCallerOwnedReady(ready: ActionableEntry[], fallbackAut
 export declare const _testOnlyNextCommand: {
     partitionCallerOwnedReady: typeof partitionCallerOwnedReady;
 };
+/** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */
+export declare function partitionDecisionEntries(ready: ActionableEntry[], includeDecisions: boolean): {
+    agent: ActionableEntry[];
+    decisions: ActionableEntry[];
+};
 /** Implements `pm next`: computes the ranked ready/blocked actionable queues and a single recommended next item with rationale for the public runtime surface. */
 export declare function runNext(options: NextOptions, global: GlobalOptions): Promise<NextResult>;
 /**

package/dist/cli/commands/next.js

@@ -9,7 +9,7 @@
  * re-deriving readiness from a full `pm context` snapshot every turn.
  */
 
-!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]="93dea0f7-51ad-50a9-8517-35ecc48e66ff")}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]="36ef6d7f-a1ec-5dd9-a3df-9ff03156dc87")}catch(e){}}();
 import { collectBlockedByIds, computeActionabilityReport, } from "../../core/item/actionability.js";
 import { resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -56,7 +56,7 @@ function parseNextLimit(raw, flag, fallback) {
 }
 // Projects an actionable entry onto its output row. Ready entries carry no
 // blockers; blocked entries surface their unresolved blockers for the agent.
-function toNextActionableItem(entry, statusRegistry, childrenByParent) {
+function toNextActionableItem(entry, statusRegistry, childrenByParent, rank) {
     return {
         ...toContextFocusItem(entry.item, statusRegistry, childrenByParent),
         open_blocker_count: entry.open_blockers.length,
@@ -66,6 +66,7 @@ function toNextActionableItem(entry, statusRegistry, childrenByParent) {
             status: blocker.status,
         })),
         unblocks: entry.unblocks,
+        rank,
     };
 }
 // Builds the human+agent readable rationale for the recommended item, ordering
@@ -113,6 +114,16 @@ function partitionCallerOwnedReady(ready, fallbackAuthor, explicitAuthor) {
 }
 /** Test-only access to deterministic next-work partitioning edge cases. */
 export const _testOnlyNextCommand = { partitionCallerOwnedReady };
+/** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */
+export function partitionDecisionEntries(ready, includeDecisions) {
+    const decisions = ready.filter((entry) => entry.item.type.trim().toLowerCase() === "decision");
+    return {
+        agent: includeDecisions
+            ? ready
+            : ready.filter((entry) => entry.item.type.trim().toLowerCase() !== "decision"),
+        decisions: includeDecisions ? [] : decisions,
+    };
+}
 // Renders a deadline as a date token plus a relative tag (overdue/today/in Nd).
 // The relative delta is computed on UTC calendar dates (both sides normalized to
 // midnight) so a deadline due today never reads as "overdue 1d" just because the
@@ -151,7 +162,9 @@ function nextListOptions(options, extra) {
     return {
         type: options.type,
         tag: options.tag,
-        priority: options.priority,
+        priority: typeof options.priority === "number"
+            ? String(options.priority)
+            : options.priority,
         assignee: options.assignee,
         assigneeFilter: options.assigneeFilter,
         sprint: options.sprint,
@@ -209,10 +222,10 @@ function filterCandidatesByParentScope(candidates, corpus, parentScope) {
     }
     return candidates.filter((item) => subtree.ids.has(item.id.trim().toLowerCase()));
 }
-async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now) {
+async function rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, callerAuthor) {
     const concreteReady = rankedReady.filter((entry) => !hasCompletedDescendants(entry.item, childrenByParent));
     const structuralReady = concreteReady.length > 0 ? concreteReady : rankedReady;
-    const ranking = await scoreContextCandidatesWithActiveExtensions("next", buildItemContextRelevanceCandidates(structuralReady.map((entry) => entry.item), statusRegistry, now, process.env.PM_AUTHOR));
+    const ranking = await scoreContextCandidatesWithActiveExtensions("next", buildItemContextRelevanceCandidates(structuralReady.map((entry) => entry.item), statusRegistry, now, callerAuthor ?? process.env.PM_AUTHOR));
     const readyById = new Map(structuralReady.map((entry) => [entry.item.id, entry]));
     const projectedReady = ranking.ranked
         .map((entry) => readyById.get(entry.id))
@@ -244,12 +257,14 @@ export async function runNext(options, global) {
     const corpus = corpusList.items;
     const report = computeActionabilityReport(candidates, corpus, statusRegistry);
     const childrenByParent = buildChildrenByParent(corpus);
-    const callerPartition = partitionCallerOwnedReady(report.ready, settings.author_default, options.callerAuthor);
+    const partitionedByDecision = partitionDecisionEntries(report.ready, options.includeDecisions === true);
+    const callerPartition = partitionCallerOwnedReady(partitionedByDecision.agent, settings.author_default, options.callerAuthor);
     const rankedReady = rankNextReadyEntries(callerPartition.available, childrenByParent, statusRegistry);
     const rankedBlocked = [...report.blocked].sort((left, right) => compareCriticalItems(left.item, right.item, statusRegistry));
-    const { projectedReady, ranking: readyRanking, completedContainer, } = await rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now);
-    const readyRows = projectedReady.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
-    const blockedRows = rankedBlocked.map((entry) => toNextActionableItem(entry, statusRegistry, childrenByParent));
+    const { projectedReady, ranking: readyRanking, completedContainer, } = await rankReadyEntriesWithRelevance(rankedReady, childrenByParent, statusRegistry, now, options.callerAuthor);
+    const readyRows = projectedReady.map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
+    const blockedRows = rankedBlocked.map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
+    const decisionRows = rankNextReadyEntries(partitionedByDecision.decisions, childrenByParent, statusRegistry).map((entry, index) => toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1));
     const recommended = buildNextRecommendation({
         projectedReady,
         readyRows,
@@ -262,6 +277,7 @@ export async function runNext(options, global) {
         now,
         recommended,
         ready: readyRows.slice(1, limit + 1),
+        decision_needed: decisionRows,
         blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),
         held_by_others: callerPartition.held,
         summary: {
@@ -284,6 +300,7 @@ export async function runNext(options, global) {
             limit,
             blocked_limit: blockedLimit,
             ready_only: readyOnly,
+            include_decisions: options.includeDecisions === true,
         },
     };
     const warnings = [
@@ -322,6 +339,16 @@ export function renderNextMarkdown(result) {
         lines.push("No ready work.");
     }
     lines.push("");
+    lines.push("## Decision needed");
+    const decisionNeeded = result.decision_needed ?? [];
+    if (decisionNeeded.length === 0) {
+        lines.push("No human-gated decisions.");
+    }
+    else {
+        for (const item of decisionNeeded)
+            lines.push(`- ${formatNextLine(item)}`);
+    }
+    lines.push("");
     lines.push("## Ready");
     if (result.ready.length === 0) {
         lines.push("No ready items.");
@@ -361,7 +388,8 @@ function formatNextLine(item) {
     const deadlineToken = item.deadline ?? "-";
     const parentToken = item.parent ? ` parent:${item.parent}` : "";
     const unblocksToken = item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : "";
-    return `${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;
+    const rankToken = Number.isInteger(item.rank) ? `#${item.rank} ` : "";
+    return `${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;
 }
 //# sourceMappingURL=next.js.map
-//# debugId=93dea0f7-51ad-50a9-8517-35ecc48e66ff
+//# debugId=36ef6d7f-a1ec-5dd9-a3df-9ff03156dc87

package/dist/cli/commands/next.js.map

@@ -1 +1 @@
-{"version":3,"file":"next.js","sources":["cli/commands/next.ts"],"sourceRoot":"/","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 {\n  resolveRuntimeStatusRegistry,\n  type RuntimeStatusRegistry,\n} 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 {\n  normalizeStatusInput,\n  normalizeStatusForRegistry,\n} 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  buildItemContextRelevanceCandidates,\n  collectSubtreeIds,\n  compareCriticalItems,\n  toContextRankingSummary,\n  toContextFocusItem,\n  type ContextFocusItem,\n  type ContextRankingSummary,\n} from \"./context.js\";\nimport { runList, type ListOptions } from \"./list.js\";\nimport { scoreContextCandidatesWithActiveExtensions } from \"../../sdk/context-relevance.js\";\n\n/** Supported values accepted by the next output contract. */\nexport const NEXT_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\n/** Restricts `pm next` output format values accepted by command, SDK, and storage contracts. */\nexport type NextOutputFormat = (typeof NEXT_OUTPUT_VALUES)[number];\n\nconst DEFAULT_NEXT_LIMIT = 5;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\n\n/** Documents the `pm next` options payload exchanged by command, SDK, and package integrations. */\nexport interface NextOptions {\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports tag for this contract. */\n  tag?: string;\n  /** Value that configures or reports priority for this contract. */\n  priority?: string;\n  /** Value that configures or reports assignee for this contract. */\n  assignee?: string;\n  /** Value that configures or reports assignee filter for this contract. */\n  assigneeFilter?: string;\n  /** Value that configures or reports sprint for this contract. */\n  sprint?: string;\n  /** Value that configures or reports release for this contract. */\n  release?: string;\n  /** Value that configures or reports parent for this contract. */\n  parent?: string;\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports blocked limit for this contract. */\n  blockedLimit?: string;\n  /** Value that configures or reports ready only for this contract. */\n  readyOnly?: boolean;\n  /** Value that configures or reports format for this contract. */\n  format?: string;\n  /** Value that configures or reports explain ranking for this contract. */\n  explainRanking?: boolean;\n  /** Internal caller override used to align claim-next ranking with --author. */\n  callerAuthor?: string;\n  [key: string]: unknown;\n}\n\n/** A blocker reference projected onto the `pm next` output. */\nexport interface NextBlockerRef {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports title for this contract. */\n  title: string | null;\n  /** Lifecycle state reported for status. */\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  /** Number of open blocker entries represented by this result. */\n  open_blocker_count: number;\n  /** Value that configures or reports blockers for this contract. */\n  blockers: NextBlockerRef[];\n  /** Value that configures or reports unblocks for this contract. */\n  unblocks: string[];\n}\n\n/** The single recommended next item: an actionable row plus its rationale. */\nexport interface NextRecommendation extends NextActionableItem {\n  /** Value that configures or reports reasons for this contract. */\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/** Documents the `pm next` result payload exchanged by command, SDK, and package integrations. */\nexport interface NextResult {\n  /** Value that configures or reports output default for this contract. */\n  output_default: \"toon\";\n  /** Value that configures or reports now for this contract. */\n  now: string;\n  /** Value that configures or reports recommended for this contract. */\n  recommended: NextRecommendation | null;\n  /** Value that configures or reports ready for this contract. */\n  ready: NextActionableItem[];\n  /** Value that configures or reports blocked for this contract. */\n  blocked: NextActionableItem[];\n  /** Value that configures or reports held by others for this contract. */\n  held_by_others: Array<{ id: string; assignee: string }>;\n  /** Value that configures or reports summary for this contract. */\n  summary: NextSummary;\n  /** Value that configures or reports filters for this contract. */\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  /** Value that configures or reports suggestions for this contract. */\n  suggestions?: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextRankingSummary;\n}\n\nfunction parseNextOutputFormat(\n  raw: string | undefined,\n): 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(\n      \"Next format must be one of markdown|toon|json\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized as NextOutputFormat;\n}\n\n/** Resolves the effective `pm next` output format from the command `--format` flag and the global `--json` switch, rejecting the contradictory `--json --format markdown|toon` combination. Defaults to `toon`. */\nexport function resolveNextOutputFormat(\n  options: NextOptions,\n  global: GlobalOptions,\n): NextOutputFormat {\n  const commandFormat = parseNextOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\n      \"Cannot combine --json with --format markdown|toon\",\n      EXIT_CODE.USAGE,\n    );\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(\n  raw: string | undefined,\n  flag: string,\n  fallback: number,\n): 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) => ({\n      id: blocker.id,\n      title: blocker.title,\n      status: blocker.status,\n    })),\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(\n    `priority p${item.priority}${item.priority === 0 ? \" (highest)\" : \"\"}`,\n  );\n  if (typeof item.deadline === \"string\" && item.deadline.trim().length > 0) {\n    reasons.push(describeDeadline(item.deadline, now));\n  }\n  reasons.push(\n    collectBlockedByIds(item).length > 0\n      ? \"all blockers resolved\"\n      : \"no blockers\",\n  );\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(\n      `unblocks ${entry.unblocks.length} item(s): ${entry.unblocks.join(\", \")}`,\n    );\n  }\n  return reasons;\n}\n\nfunction partitionCallerOwnedReady(\n  ready: ActionableEntry[],\n  fallbackAuthor: string,\n  explicitAuthor?: string,\n): {\n  available: ActionableEntry[];\n  held: Array<{ id: string; assignee: string }>;\n} {\n  const caller =\n    (explicitAuthor ?? process.env.PM_AUTHOR ?? fallbackAuthor).trim() ||\n    \"unknown\";\n  const available: ActionableEntry[] = [];\n  const held: Array<{ id: string; assignee: string }> = [];\n  for (const entry of ready) {\n    const assignee =\n      typeof entry.item.assignee === \"string\" ? entry.item.assignee.trim() : \"\";\n    const isForeignWork = assignee.length > 0 && assignee !== caller;\n    if (isForeignWork) held.push({ id: entry.item.id, assignee });\n    else available.push(entry);\n  }\n  return { available, held };\n}\n\n/** Test-only access to deterministic next-work partitioning edge cases. */\nexport const _testOnlyNextCommand = { partitionCallerOwnedReady };\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(\n    (Date.parse(dateToken) - Date.parse(nowToken)) / MS_PER_DAY,\n  );\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(\n  ready: NextActionableItem[],\n  statusRegistry: RuntimeStatusRegistry,\n): number {\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  return ready.filter(\n    (item) =>\n      normalizeStatusForRegistry(item.status, statusRegistry) ===\n      inProgressStatus,\n  ).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(\n  item: ItemFrontMatter,\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n): 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(\n  options: NextOptions,\n  extra: Partial<ListOptions>,\n): 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(\n      left.item,\n      childrenByParent,\n    );\n    const rightCompletedContainer = hasCompletedDescendants(\n      right.item,\n      childrenByParent,\n    );\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(\n  recommended: NextRecommendation | null,\n  blockedRows: NextActionableItem[],\n): string[] | undefined {\n  if (recommended !== null) {\n    return undefined;\n  }\n  if (blockedRows.length > 0) {\n    const blockedWithReferences = blockedRows.find(\n      (item) => item.blockers.length > 0,\n    );\n    return [\n      blockedWithReferences\n        ? `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedWithReferences.blockers.map((blocker) => blocker.id).join(\", \")}`\n        : `${blockedRows.length} item(s) are blocked; add blocker context or move the top item back to an active status`,\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\nfunction filterCandidatesByParentScope(\n  candidates: ItemFrontMatter[],\n  corpus: ItemFrontMatter[],\n  parentScope: string,\n): ItemFrontMatter[] {\n  if (!parentScope) {\n    return candidates;\n  }\n  const subtree = collectSubtreeIds(corpus, parentScope);\n  if (!subtree.found) {\n    throw new PmCliError(\n      `Next --parent item not found: ${parentScope}`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  return candidates.filter((item) =>\n    subtree.ids.has(item.id.trim().toLowerCase()),\n  );\n}\n\nasync function rankReadyEntriesWithRelevance(\n  rankedReady: ActionableEntry[],\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n  statusRegistry: RuntimeStatusRegistry,\n  now: string,\n): Promise<{\n  projectedReady: ActionableEntry[];\n  ranking: Awaited<\n    ReturnType<\n      typeof scoreContextCandidatesWithActiveExtensions<ItemFrontMatter>\n    >\n  >;\n  completedContainer: boolean;\n}> {\n  const concreteReady = rankedReady.filter(\n    (entry) => !hasCompletedDescendants(entry.item, childrenByParent),\n  );\n  const structuralReady =\n    concreteReady.length > 0 ? concreteReady : rankedReady;\n  const ranking = await scoreContextCandidatesWithActiveExtensions(\n    \"next\",\n    buildItemContextRelevanceCandidates(\n      structuralReady.map((entry) => entry.item),\n      statusRegistry,\n      now,\n      process.env.PM_AUTHOR,\n    ),\n  );\n  const readyById = new Map(\n    structuralReady.map((entry) => [entry.item.id, entry]),\n  );\n  const projectedReady = ranking.ranked\n    .map((entry) => readyById.get(entry.id))\n    .filter((entry): entry is ActionableEntry => entry !== undefined);\n  return {\n    projectedReady,\n    ranking,\n    completedContainer: concreteReady.length === 0,\n  };\n}\n\n/** Implements `pm next`: computes the ranked ready/blocked actionable queues and a single recommended next item with rationale for the public runtime surface. */\nexport async function runNext(\n  options: NextOptions,\n  global: GlobalOptions,\n): 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(\n    options.blockedLimit,\n    \"--blocked-limit\",\n    limit,\n  );\n  const readyOnly = options.readyOnly === true;\n  const parentScope =\n    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(\n    undefined,\n    nextListOptions(options, { excludeTerminal: true }),\n    global,\n  );\n  const corpusList = await runList(\n    undefined,\n    { excludeTerminal: false, noTruncate: true },\n    global,\n  );\n  const candidates = filterCandidatesByParentScope(\n    candidatesList.items as ItemFrontMatter[],\n    corpusList.items as ItemFrontMatter[],\n    parentScope,\n  );\n  const corpus = corpusList.items as ItemFrontMatter[];\n\n  const report = computeActionabilityReport(candidates, corpus, statusRegistry);\n  const childrenByParent = buildChildrenByParent(corpus);\n  const callerPartition = partitionCallerOwnedReady(\n    report.ready,\n    settings.author_default,\n    options.callerAuthor,\n  );\n  const rankedReady = rankNextReadyEntries(\n    callerPartition.available,\n    childrenByParent,\n    statusRegistry,\n  );\n  const rankedBlocked = [...report.blocked].sort((left, right) =>\n    compareCriticalItems(left.item, right.item, statusRegistry),\n  );\n  const {\n    projectedReady,\n    ranking: readyRanking,\n    completedContainer,\n  } = await rankReadyEntriesWithRelevance(\n    rankedReady,\n    childrenByParent,\n    statusRegistry,\n    now,\n  );\n\n  const readyRows = projectedReady.map((entry) =>\n    toNextActionableItem(entry, statusRegistry, childrenByParent),\n  );\n  const blockedRows = rankedBlocked.map((entry) =>\n    toNextActionableItem(entry, statusRegistry, childrenByParent),\n  );\n\n  const recommended = buildNextRecommendation({\n    projectedReady,\n    readyRows,\n    statusRegistry,\n    now,\n    completedContainer,\n  });\n\n  const result: NextResult = {\n    output_default: \"toon\",\n    now,\n    recommended,\n    ready: readyRows.slice(1, limit + 1),\n    blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),\n    held_by_others: callerPartition.held,\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 = [\n    ...new Set([\n      ...(candidatesList.warnings ?? []),\n      ...(corpusList.warnings ?? []),\n      ...(readyRanking.warnings ?? []),\n    ]),\n  ].sort((a, b) => a.localeCompare(b));\n  if (warnings.length > 0) result.warnings = warnings;\n  if (options.explainRanking === true)\n    result.ranking = toContextRankingSummary(readyRanking);\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 =\n    item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : \"\";\n  return `${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;;AACH,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,4BAA4B,GAE7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,mCAAmC,EACnC,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GAGnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,0CAA0C,EAAE,MAAM,gCAAgC,CAAC;AAE5F,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAIxE,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAgHvC,SAAS,qBAAqB,CAC5B,GAAuB;IAEvB,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,UAA8B,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,UAAU,CAClB,+CAA+C,EAC/C,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,UAA8B,CAAC;AACxC,CAAC;AAED,mNAAmN;AACnN,MAAM,UAAU,uBAAuB,CACrC,OAAoB,EACpB,MAAqB;IAErB,MAAM,aAAa,GAAG,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,IAAI,IAAI,aAAa,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QAC7D,MAAM,IAAI,UAAU,CAClB,mDAAmD,EACnD,SAAS,CAAC,KAAK,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,aAAa,IAAI,MAAM,CAAC;AACjC,CAAC;AAED,iFAAiF;AACjF,4DAA4D;AAC5D,SAAS,cAAc,CACrB,GAAuB,EACvB,IAAY,EACZ,QAAgB;IAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,SAAS,oBAAoB,CAC3B,KAAsB,EACtB,cAAqC,EACrC,gBAAgD;IAEhD,OAAO;QACL,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,gBAAgB,CAAC;QACnE,kBAAkB,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM;QAC9C,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9C,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,2EAA2E;AAC3E,uDAAuD;AACvD,SAAS,0BAA0B,CACjC,KAAsB,EACtB,cAAqC,EACrC,GAAW,EACX,kBAA2B;IAE3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,CACV,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,gBAAgB;QAC1E,CAAC,CAAC,gCAAgC;QAClC,CAAC,CAAC,yBAAyB,CAC9B,CAAC;IACF,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,IAAI,CACV,aAAa,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CACvE,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,IAAI,CACV,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAClC,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,aAAa,CAClB,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CACV,YAAY,KAAK,CAAC,QAAQ,CAAC,MAAM,aAAa,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAwB,EACxB,cAAsB,EACtB,cAAuB;IAKvB,MAAM,MAAM,GACV,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE;QAClE,SAAS,CAAC;IACZ,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,MAAM,IAAI,GAA4C,EAAE,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,QAAQ,GACZ,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,MAAM,CAAC;QACjE,IAAI,aAAa;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;;YACzD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,yBAAyB,EAAE,CAAC;AAElE,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,qEAAqE;AACrE,SAAS,gBAAgB,CAAC,QAAgB,EAAE,GAAW;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,wGAAwG;IACxG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO,YAAY,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAC5D,CAAC;IACF,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,YAAY,SAAS,aAAa,CAAC,IAAI,IAAI,CAAC;IACjE,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,YAAY,SAAS,cAAc,CAAC;IAC3D,OAAO,YAAY,SAAS,QAAQ,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2B,EAC3B,cAAqC;IAErC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAE,EAAE,CACP,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC;QACvD,gBAAgB,CACnB,CAAC,MAAM,CAAC;AACX,CAAC;AAED,iFAAiF;AACjF,kFAAkF;AAClF,2CAA2C;AAC3C,SAAS,uBAAuB,CAC9B,IAAqB,EACrB,gBAAgD;IAEhD,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,SAAS,eAAe,CACtB,OAAoB,EACpB,KAA2B;IAE3B,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,IAAI;QAChB,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAwB,EACxB,gBAAgD,EAChD,cAAqC;IAErC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrC,MAAM,sBAAsB,GAAG,uBAAuB,CACpD,IAAI,CAAC,IAAI,EACT,gBAAgB,CACjB,CAAC;QACF,MAAM,uBAAuB,GAAG,uBAAuB,CACrD,KAAK,CAAC,IAAI,EACV,gBAAgB,CACjB,CAAC;QACF,IAAI,sBAAsB,KAAK,uBAAuB,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAAC,MAMhC;IACC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACtB,OAAO,EAAE,0BAA0B,CACjC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EACxB,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,kBAAkB,CAC1B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAAsC,EACtC,WAAiC;IAEjC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,qBAAqB,GAAG,WAAW,CAAC,IAAI,CAC5C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CACnC,CAAC;QACF,OAAO;YACL,qBAAqB;gBACnB,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,wDAAwD,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACvJ,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,yFAAyF;YAClH,oEAAoE;YACpE,2DAA2D;SAC5D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,4DAA4D;QAC5D,8DAA8D;QAC9D,uDAAuD;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,UAA6B,EAC7B,MAAyB,EACzB,WAAmB;IAEnB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAClB,iCAAiC,WAAW,EAAE,EAC9C,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,WAA8B,EAC9B,gBAAgD,EAChD,cAAqC,EACrC,GAAW;IAUX,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAClE,CAAC;IACF,MAAM,eAAe,GACnB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,0CAA0C,CAC9D,MAAM,EACN,mCAAmC,CACjC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAC1C,cAAc,EACd,GAAG,EACH,OAAO,CAAC,GAAG,CAAC,SAAS,CACtB,CACF,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CACvD,CAAC;IACF,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;SAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACpE,OAAO;QACL,cAAc;QACd,OAAO;QACP,kBAAkB,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,kKAAkK;AAClK,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAoB,EACpB,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,cAAc,CACjC,OAAO,CAAC,YAAY,EACpB,iBAAiB,EACjB,KAAK,CACN,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAC7C,MAAM,WAAW,GACf,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,iFAAiF;IACjF,4EAA4E;IAC5E,iFAAiF;IACjF,gFAAgF;IAChF,gEAAgE;IAChE,MAAM,cAAc,GAAG,MAAM,OAAO,CAClC,SAAS,EACT,eAAe,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EACnD,MAAM,CACP,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,OAAO,CAC9B,SAAS,EACT,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAC5C,MAAM,CACP,CAAC;IACF,MAAM,UAAU,GAAG,6BAA6B,CAC9C,cAAc,CAAC,KAA0B,EACzC,UAAU,CAAC,KAA0B,EACrC,WAAW,CACZ,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,KAA0B,CAAC;IAErD,MAAM,MAAM,GAAG,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9E,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,yBAAyB,CAC/C,MAAM,CAAC,KAAK,EACZ,QAAQ,CAAC,cAAc,EACvB,OAAO,CAAC,YAAY,CACrB,CAAC;IACF,MAAM,WAAW,GAAG,oBAAoB,CACtC,eAAe,CAAC,SAAS,EACzB,gBAAgB,EAChB,cAAc,CACf,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC7D,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAC5D,CAAC;IACF,MAAM,EACJ,cAAc,EACd,OAAO,EAAE,YAAY,EACrB,kBAAkB,GACnB,GAAG,MAAM,6BAA6B,CACrC,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,GAAG,CACJ,CAAC;IAEF,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAC9D,CAAC;IACF,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAC9D,CAAC;IAEF,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC1C,cAAc;QACd,SAAS;QACT,cAAc;QACd,GAAG;QACH,kBAAkB;KACnB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAe;QACzB,cAAc,EAAE,MAAM;QACtB,GAAG;QACH,WAAW;QACX,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;QACpC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;QAC5D,cAAc,EAAE,eAAe,CAAC,IAAI;QACpC,OAAO,EAAE;YACP,WAAW,EAAE,WAAW,KAAK,IAAI;YACjC,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,OAAO,EAAE,WAAW,CAAC,MAAM;YAC3B,WAAW,EAAE,oBAAoB,CAAC,SAAS,EAAE,cAAc,CAAC;YAC5D,UAAU,EAAE,MAAM,CAAC,YAAY;YAC/B,UAAU,EAAE,MAAM,CAAC,eAAe;SACnC;QACD,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC/C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;YAChC,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;YACnD,KAAK;YACL,aAAa,EAAE,YAAY;YAC3B,UAAU,EAAE,SAAS;SACtB;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,GAAG,IAAI,GAAG,CAAC;YACT,GAAG,CAAC,cAAc,CAAC,QAAQ,IAAI,EAAE,CAAC;YAClC,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC9B,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC;SACjC,CAAC;KACH,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACpD,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI;QACjC,MAAM,CAAC,OAAO,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAEzD,MAAM,CAAC,WAAW,GAAG,oBAAoB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,KAAK,GAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CACR,YAAY,MAAM,CAAC,OAAO,CAAC,KAAK,kBAAkB,MAAM,CAAC,OAAO,CAAC,WAAW,eAAe,MAAM,CAAC,OAAO,CAAC,OAAO,iBAAiB,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAC9J,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ;qBACrB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC;qBAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,KAAK,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,iFAAiF;AACjF,6EAA6E;AAC7E,SAAS,cAAc,CAAC,IAAwB;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,aAAa,GACjB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,aAAa,aAAa,GAAG,WAAW,GAAG,aAAa,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;AAC1I,CAAC","debugId":"93dea0f7-51ad-50a9-8517-35ecc48e66ff"}
+{"version":3,"file":"next.js","sources":["cli/commands/next.ts"],"sourceRoot":"/","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 {\n  resolveRuntimeStatusRegistry,\n  type RuntimeStatusRegistry,\n} 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 {\n  normalizeStatusInput,\n  normalizeStatusForRegistry,\n} 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  buildItemContextRelevanceCandidates,\n  collectSubtreeIds,\n  compareCriticalItems,\n  toContextRankingSummary,\n  toContextFocusItem,\n  type ContextFocusItem,\n  type ContextRankingSummary,\n} from \"./context.js\";\nimport { runList, type ListOptions } from \"./list.js\";\nimport { scoreContextCandidatesWithActiveExtensions } from \"../../sdk/context-relevance.js\";\n\n/** Supported values accepted by the next output contract. */\nexport const NEXT_OUTPUT_VALUES = [\"markdown\", \"toon\", \"json\"] as const;\n/** Restricts `pm next` output format values accepted by command, SDK, and storage contracts. */\nexport type NextOutputFormat = (typeof NEXT_OUTPUT_VALUES)[number];\n\nconst DEFAULT_NEXT_LIMIT = 5;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\n\n/** Documents the `pm next` options payload exchanged by command, SDK, and package integrations. */\nexport interface NextOptions {\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports tag for this contract. */\n  tag?: string;\n  /** Value that configures or reports priority for this contract. */\n  priority?: string | number;\n  /** Value that configures or reports assignee for this contract. */\n  assignee?: string;\n  /** Value that configures or reports assignee filter for this contract. */\n  assigneeFilter?: string;\n  /** Value that configures or reports sprint for this contract. */\n  sprint?: string;\n  /** Value that configures or reports release for this contract. */\n  release?: string;\n  /** Value that configures or reports parent for this contract. */\n  parent?: string;\n  /** Value that configures or reports limit for this contract. */\n  limit?: string;\n  /** Value that configures or reports blocked limit for this contract. */\n  blockedLimit?: string;\n  /** Value that configures or reports ready only for this contract. */\n  readyOnly?: boolean;\n  /** Value that configures or reports format for this contract. */\n  format?: string;\n  /** Value that configures or reports explain ranking for this contract. */\n  explainRanking?: boolean;\n  /** Include human-gated Decision items in the claimable ready queue. */\n  includeDecisions?: boolean;\n  /** Internal caller override used to align claim-next ranking with --author. */\n  callerAuthor?: string;\n  [key: string]: unknown;\n}\n\n/** A blocker reference projected onto the `pm next` output. */\nexport interface NextBlockerRef {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports title for this contract. */\n  title: string | null;\n  /** Lifecycle state reported for status. */\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  /** One-based position in the complete ranked actionable queue. */\n  rank: number;\n  /** Number of open blocker entries represented by this result. */\n  open_blocker_count: number;\n  /** Value that configures or reports blockers for this contract. */\n  blockers: NextBlockerRef[];\n  /** Value that configures or reports unblocks for this contract. */\n  unblocks: string[];\n}\n\n/** The single recommended next item: an actionable row plus its rationale. */\nexport interface NextRecommendation extends NextActionableItem {\n  /** Value that configures or reports reasons for this contract. */\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/** Documents the `pm next` result payload exchanged by command, SDK, and package integrations. */\nexport interface NextResult {\n  /** Value that configures or reports output default for this contract. */\n  output_default: \"toon\";\n  /** Value that configures or reports now for this contract. */\n  now: string;\n  /** Value that configures or reports recommended for this contract. */\n  recommended: NextRecommendation | null;\n  /** Value that configures or reports ready for this contract. */\n  ready: NextActionableItem[];\n  /** Human-gated decisions kept visible without dispatching them to agents. */\n  decision_needed: NextActionableItem[];\n  /** Value that configures or reports blocked for this contract. */\n  blocked: NextActionableItem[];\n  /** Value that configures or reports held by others for this contract. */\n  held_by_others: Array<{ id: string; assignee: string }>;\n  /** Value that configures or reports summary for this contract. */\n  summary: NextSummary;\n  /** Value that configures or reports filters for this contract. */\n  filters: {\n    type: string | null;\n    tag: string | null;\n    priority: string | number | 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    include_decisions: boolean;\n  };\n  /** Value that configures or reports suggestions for this contract. */\n  suggestions?: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n  /** Value that configures or reports ranking for this contract. */\n  ranking?: ContextRankingSummary;\n}\n\nfunction parseNextOutputFormat(\n  raw: string | undefined,\n): 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(\n      \"Next format must be one of markdown|toon|json\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  return normalized as NextOutputFormat;\n}\n\n/** Resolves the effective `pm next` output format from the command `--format` flag and the global `--json` switch, rejecting the contradictory `--json --format markdown|toon` combination. Defaults to `toon`. */\nexport function resolveNextOutputFormat(\n  options: NextOptions,\n  global: GlobalOptions,\n): NextOutputFormat {\n  const commandFormat = parseNextOutputFormat(options.format);\n  if (global.json && commandFormat && commandFormat !== \"json\") {\n    throw new PmCliError(\n      \"Cannot combine --json with --format markdown|toon\",\n      EXIT_CODE.USAGE,\n    );\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(\n  raw: string | undefined,\n  flag: string,\n  fallback: number,\n): 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  rank: number,\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) => ({\n      id: blocker.id,\n      title: blocker.title,\n      status: blocker.status,\n    })),\n    unblocks: entry.unblocks,\n    rank,\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(\n    `priority p${item.priority}${item.priority === 0 ? \" (highest)\" : \"\"}`,\n  );\n  if (typeof item.deadline === \"string\" && item.deadline.trim().length > 0) {\n    reasons.push(describeDeadline(item.deadline, now));\n  }\n  reasons.push(\n    collectBlockedByIds(item).length > 0\n      ? \"all blockers resolved\"\n      : \"no blockers\",\n  );\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(\n      `unblocks ${entry.unblocks.length} item(s): ${entry.unblocks.join(\", \")}`,\n    );\n  }\n  return reasons;\n}\n\nfunction partitionCallerOwnedReady(\n  ready: ActionableEntry[],\n  fallbackAuthor: string,\n  explicitAuthor?: string,\n): {\n  available: ActionableEntry[];\n  held: Array<{ id: string; assignee: string }>;\n} {\n  const caller =\n    (explicitAuthor ?? process.env.PM_AUTHOR ?? fallbackAuthor).trim() ||\n    \"unknown\";\n  const available: ActionableEntry[] = [];\n  const held: Array<{ id: string; assignee: string }> = [];\n  for (const entry of ready) {\n    const assignee =\n      typeof entry.item.assignee === \"string\" ? entry.item.assignee.trim() : \"\";\n    const isForeignWork = assignee.length > 0 && assignee !== caller;\n    if (isForeignWork) held.push({ id: entry.item.id, assignee });\n    else available.push(entry);\n  }\n  return { available, held };\n}\n\n/** Test-only access to deterministic next-work partitioning edge cases. */\nexport const _testOnlyNextCommand = { partitionCallerOwnedReady };\n\n/** Separates human-gated decisions from autonomous agent work unless the caller explicitly opts into decision claims. */\nexport function partitionDecisionEntries(\n  ready: ActionableEntry[],\n  includeDecisions: boolean,\n): { agent: ActionableEntry[]; decisions: ActionableEntry[] } {\n  const decisions = ready.filter(\n    (entry) => entry.item.type.trim().toLowerCase() === \"decision\",\n  );\n  return {\n    agent: includeDecisions\n      ? ready\n      : ready.filter(\n          (entry) => entry.item.type.trim().toLowerCase() !== \"decision\",\n        ),\n    decisions: includeDecisions ? [] : decisions,\n  };\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(\n    (Date.parse(dateToken) - Date.parse(nowToken)) / MS_PER_DAY,\n  );\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(\n  ready: NextActionableItem[],\n  statusRegistry: RuntimeStatusRegistry,\n): number {\n  const inProgressStatus = normalizeStatusInput(\"in_progress\", statusRegistry);\n  return ready.filter(\n    (item) =>\n      normalizeStatusForRegistry(item.status, statusRegistry) ===\n      inProgressStatus,\n  ).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(\n  item: ItemFrontMatter,\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n): 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(\n  options: NextOptions,\n  extra: Partial<ListOptions>,\n): ListOptions {\n  return {\n    type: options.type,\n    tag: options.tag,\n    priority:\n      typeof options.priority === \"number\"\n        ? String(options.priority)\n        : 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(\n      left.item,\n      childrenByParent,\n    );\n    const rightCompletedContainer = hasCompletedDescendants(\n      right.item,\n      childrenByParent,\n    );\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(\n  recommended: NextRecommendation | null,\n  blockedRows: NextActionableItem[],\n): string[] | undefined {\n  if (recommended !== null) {\n    return undefined;\n  }\n  if (blockedRows.length > 0) {\n    const blockedWithReferences = blockedRows.find(\n      (item) => item.blockers.length > 0,\n    );\n    return [\n      blockedWithReferences\n        ? `${blockedRows.length} item(s) are blocked; unblock the top one by closing ${blockedWithReferences.blockers.map((blocker) => blocker.id).join(\", \")}`\n        : `${blockedRows.length} item(s) are blocked; add blocker context or move the top item back to an active status`,\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\nfunction filterCandidatesByParentScope(\n  candidates: ItemFrontMatter[],\n  corpus: ItemFrontMatter[],\n  parentScope: string,\n): ItemFrontMatter[] {\n  if (!parentScope) {\n    return candidates;\n  }\n  const subtree = collectSubtreeIds(corpus, parentScope);\n  if (!subtree.found) {\n    throw new PmCliError(\n      `Next --parent item not found: ${parentScope}`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  return candidates.filter((item) =>\n    subtree.ids.has(item.id.trim().toLowerCase()),\n  );\n}\n\nasync function rankReadyEntriesWithRelevance(\n  rankedReady: ActionableEntry[],\n  childrenByParent: Map<string, ItemFrontMatter[]>,\n  statusRegistry: RuntimeStatusRegistry,\n  now: string,\n  callerAuthor: string | undefined,\n): Promise<{\n  projectedReady: ActionableEntry[];\n  ranking: Awaited<\n    ReturnType<\n      typeof scoreContextCandidatesWithActiveExtensions<ItemFrontMatter>\n    >\n  >;\n  completedContainer: boolean;\n}> {\n  const concreteReady = rankedReady.filter(\n    (entry) => !hasCompletedDescendants(entry.item, childrenByParent),\n  );\n  const structuralReady =\n    concreteReady.length > 0 ? concreteReady : rankedReady;\n  const ranking = await scoreContextCandidatesWithActiveExtensions(\n    \"next\",\n    buildItemContextRelevanceCandidates(\n      structuralReady.map((entry) => entry.item),\n      statusRegistry,\n      now,\n      callerAuthor ?? process.env.PM_AUTHOR,\n    ),\n  );\n  const readyById = new Map(\n    structuralReady.map((entry) => [entry.item.id, entry]),\n  );\n  const projectedReady = ranking.ranked\n    .map((entry) => readyById.get(entry.id))\n    .filter((entry): entry is ActionableEntry => entry !== undefined);\n  return {\n    projectedReady,\n    ranking,\n    completedContainer: concreteReady.length === 0,\n  };\n}\n\n/** Implements `pm next`: computes the ranked ready/blocked actionable queues and a single recommended next item with rationale for the public runtime surface. */\nexport async function runNext(\n  options: NextOptions,\n  global: GlobalOptions,\n): 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(\n    options.blockedLimit,\n    \"--blocked-limit\",\n    limit,\n  );\n  const readyOnly = options.readyOnly === true;\n  const parentScope =\n    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(\n    undefined,\n    nextListOptions(options, { excludeTerminal: true }),\n    global,\n  );\n  const corpusList = await runList(\n    undefined,\n    { excludeTerminal: false, noTruncate: true },\n    global,\n  );\n  const candidates = filterCandidatesByParentScope(\n    candidatesList.items as ItemFrontMatter[],\n    corpusList.items as ItemFrontMatter[],\n    parentScope,\n  );\n  const corpus = corpusList.items as ItemFrontMatter[];\n\n  const report = computeActionabilityReport(candidates, corpus, statusRegistry);\n  const childrenByParent = buildChildrenByParent(corpus);\n  const partitionedByDecision = partitionDecisionEntries(\n    report.ready,\n    options.includeDecisions === true,\n  );\n  const callerPartition = partitionCallerOwnedReady(\n    partitionedByDecision.agent,\n    settings.author_default,\n    options.callerAuthor,\n  );\n  const rankedReady = rankNextReadyEntries(\n    callerPartition.available,\n    childrenByParent,\n    statusRegistry,\n  );\n  const rankedBlocked = [...report.blocked].sort((left, right) =>\n    compareCriticalItems(left.item, right.item, statusRegistry),\n  );\n  const {\n    projectedReady,\n    ranking: readyRanking,\n    completedContainer,\n  } = await rankReadyEntriesWithRelevance(\n    rankedReady,\n    childrenByParent,\n    statusRegistry,\n    now,\n    options.callerAuthor,\n  );\n\n  const readyRows = projectedReady.map((entry, index) =>\n    toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1),\n  );\n  const blockedRows = rankedBlocked.map((entry, index) =>\n    toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1),\n  );\n  const decisionRows = rankNextReadyEntries(\n    partitionedByDecision.decisions,\n    childrenByParent,\n    statusRegistry,\n  ).map((entry, index) =>\n    toNextActionableItem(entry, statusRegistry, childrenByParent, index + 1),\n  );\n\n  const recommended = buildNextRecommendation({\n    projectedReady,\n    readyRows,\n    statusRegistry,\n    now,\n    completedContainer,\n  });\n\n  const result: NextResult = {\n    output_default: \"toon\",\n    now,\n    recommended,\n    ready: readyRows.slice(1, limit + 1),\n    decision_needed: decisionRows,\n    blocked: readyOnly ? [] : blockedRows.slice(0, blockedLimit),\n    held_by_others: callerPartition.held,\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      include_decisions: options.includeDecisions === true,\n    },\n  };\n\n  const warnings = [\n    ...new Set([\n      ...(candidatesList.warnings ?? []),\n      ...(corpusList.warnings ?? []),\n      ...(readyRanking.warnings ?? []),\n    ]),\n  ].sort((a, b) => a.localeCompare(b));\n  if (warnings.length > 0) result.warnings = warnings;\n  if (options.explainRanking === true)\n    result.ranking = toContextRankingSummary(readyRanking);\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(\"## Decision needed\");\n  const decisionNeeded = result.decision_needed ?? [];\n  if (decisionNeeded.length === 0) {\n    lines.push(\"No human-gated decisions.\");\n  } else {\n    for (const item of decisionNeeded) lines.push(`- ${formatNextLine(item)}`);\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 =\n    item.unblocks.length > 0 ? ` unblocks:${item.unblocks.length}` : \"\";\n  const rankToken = Number.isInteger(item.rank) ? `#${item.rank} ` : \"\";\n  return `${rankToken}${item.id} p${item.priority} ${item.status} ${item.type} deadline:${deadlineToken}${parentToken}${unblocksToken} ${item.title}`;\n}\n"],"names":[],"mappings":"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","debugId":"36ef6d7f-a1ec-5dd9-a3df-9ff03156dc87"}

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

@@ -108,6 +108,8 @@ export interface PlanCommandOptions {
     materializeParent?: string;
     /** Value that configures or reports materialize tags for this contract. */
     materializeTags?: string;
+    /** Custom field values forwarded to every materialized item as `name=value` pairs. */
+    field?: string | string[];
     /** Value that configures or reports author for this contract. */
     author?: string;
     /** Human-readable explanation suitable for logs and agent-facing output. */
@@ -130,7 +132,10 @@ export interface PlanCommandResult {
     /** Value that configures or reports materialized for this contract. */
     materialized?: {
         id: string;
+        title: string;
         type: string;
+        parent?: string;
+        tags: string[];
         from_step: string;
     }[];
     /** Value that configures or reports materialize skipped for this contract. */

package/dist/cli/commands/plan.js

@@ -4,7 +4,7 @@
  * Implements the pm plan command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="dfb007cc-8308-5cc0-8fd2-3604ab7ffecc")}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]="5ec672ec-6e36-5040-aa20-ef02ed65ee3a")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { resolveItemTypeRegistry, resolveTypeName, } from "../../core/item/type-registry.js";
@@ -1330,8 +1330,47 @@ function buildMaterializeDependencies(parent, planItemId, step) {
 }
 async function createMaterializedStepItems(params) {
     const materialized = [];
+    const materializeFields = {};
+    const reservedMaterializeKeys = new Set([
+        "title",
+        "description",
+        "type",
+        "parent",
+        "tags",
+        "author",
+        "message",
+        "dep",
+    ]);
+    for (const specification of toSpecArray(params.options.field)) {
+        const separator = specification.indexOf("=");
+        if (separator <= 0) {
+            throw new PmCliError(`Invalid --field entry "${specification}"; expected name=value`, EXIT_CODE.USAGE);
+        }
+        const name = specification.slice(0, separator).trim();
+        const value = specification.slice(separator + 1).trim();
+        if (name.length === 0) {
+            throw new PmCliError(`Invalid --field entry "${specification}"; expected name=value`, EXIT_CODE.USAGE);
+        }
+        const segments = name
+            .trim()
+            .replaceAll(/([a-z0-9])([A-Z])/g, "$1 $2")
+            .replaceAll(/[^A-Za-z0-9]+/g, " ")
+            .split(/\s+/)
+            .filter(Boolean)
+            .map((segment) => segment.toLowerCase());
+        if (segments.length === 0) {
+            throw new PmCliError(`Invalid --field entry "${specification}"; expected name=value`, EXIT_CODE.USAGE);
+        }
+        const [first, ...rest] = segments;
+        const fieldKey = `${first}${rest.map((segment) => `${segment.slice(0, 1).toUpperCase()}${segment.slice(1)}`).join("")}`;
+        if (reservedMaterializeKeys.has(fieldKey)) {
+            throw new PmCliError(`Invalid --field entry "${specification}"; "${fieldKey}" is reserved by materialize and cannot be overridden`, EXIT_CODE.USAGE);
+        }
+        materializeFields[fieldKey] = value;
+    }
     for (const step of params.targets) {
         const created = await runCreate({
+            ...materializeFields,
             title: step.title,
             description: step.body?.trim() || step.title,
             type: params.resolvedTypeName,
@@ -1344,7 +1383,10 @@ async function createMaterializedStepItems(params) {
         }, { ...{}, path: params.pmRoot });
         materialized.push({
             id: created.item.id,
+            title: created.item.title,
             type: params.resolvedTypeName,
+            parent: created.item.parent,
+            tags: created.item.tags ?? [],
             from_step: step.id,
         });
     }
@@ -1525,4 +1567,4 @@ export async function runPlan(input) {
     return resolvePlanDispatcher(normalizedInput.subcommand)(normalizedInput, ctx);
 }
 //# sourceMappingURL=plan.js.map
-//# debugId=dfb007cc-8308-5cc0-8fd2-3604ab7ffecc
+//# debugId=5ec672ec-6e36-5040-aa20-ef02ed65ee3a