@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli-bundle/chunks/{chunk-4DC5XNMS.js → chunk-GFBV2254.js}

@@ -2,12 +2,12 @@ import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-RPZ57GQ7.js";
+} from "./chunk-QFCCN4JO.js";
 import {
   parseIntegerLimit,
   parsePriority,
   parseType
-} from "./chunk-GJNBKU6G.js";
+} from "./chunk-TWELUDDF.js";
 import {
   HEAVY_METADATA_KEYS,
   coerceRuntimeFieldValue,
@@ -25,7 +25,7 @@ import {
   resolveIsoOrRelative,
   stableValueEquals,
   toItemRecord
-} from "./chunk-Y476SA4V.js";
+} from "./chunk-NEJKKTCG.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -37,7 +37,7 @@ import {
   resolvePmRoot,
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/core/item/status-filter.js
 !(function() {
@@ -1207,4 +1207,4 @@ export {
   buildGovernanceMissingFilterEcho,
   runList
 };
-//# sourceMappingURL=chunk-4DC5XNMS.js.map
+//# sourceMappingURL=chunk-GFBV2254.js.map

package/dist/cli-bundle/chunks/{chunk-OKZ35F3Y.js → chunk-GRB3TFOC.js}

@@ -1,10 +1,10 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-WCRAUCJO.js";
+} from "./chunk-546WPG33.js";
 import {
   createStdinTokenResolver
-} from "./chunk-SN7Q7M4U.js";
+} from "./chunk-OKUFGORG.js";
 
 // dist/cli/commands/learnings.js
 !(function() {
@@ -45,4 +45,4 @@ async function runLearnings(id, options, global2) {
 export {
   runLearnings
 };
-//# sourceMappingURL=chunk-OKZ35F3Y.js.map
+//# sourceMappingURL=chunk-GRB3TFOC.js.map

package/dist/cli-bundle/chunks/{chunk-TZFULSN4.js → chunk-GVGFLZQS.js}

@@ -9,7 +9,7 @@ import {
   createStdinTokenResolver,
   looksLikeGenericKeyValueEntry,
   parseCsvKv
-} from "./chunk-SN7Q7M4U.js";
+} from "./chunk-OKUFGORG.js";
 import {
   splitCommaList
 } from "./chunk-D6HZN36B.js";
@@ -20,7 +20,7 @@ import {
   mutateItem,
   readLocatedItem,
   readSettings
-} from "./chunk-Y476SA4V.js";
+} from "./chunk-NEJKKTCG.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -29,7 +29,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/cli/commands/linked-artifacts.js
 import fs from "node:fs/promises";
@@ -425,4 +425,4 @@ export {
   runLinkedArtifacts,
   renameArtifactsResultKey
 };
-//# sourceMappingURL=chunk-TZFULSN4.js.map
+//# sourceMappingURL=chunk-GVGFLZQS.js.map

package/dist/cli-bundle/chunks/{chunk-RTG2LHQ7.js → chunk-HLZXQKGZ.js}

@@ -1,7 +1,7 @@
 import {
   collectUsedExtensionCapabilities,
   normalizeExtensionName
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/core/extensions/activation-summary.js
 !(function() {
@@ -157,4 +157,4 @@ export {
   describeExtensionActivation,
   renderExtensionSurfaceMarkdown
 };
-//# sourceMappingURL=chunk-RTG2LHQ7.js.map
+//# sourceMappingURL=chunk-HLZXQKGZ.js.map

package/dist/cli-bundle/chunks/{chunk-5F7UJHFY.js → chunk-HO6CDURZ.js}

@@ -2,7 +2,7 @@
 !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]="808221df-7514-5d5b-b96f-52279d8f361d")}catch(e){}}();
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/core/governance/metadata-coverage.js
 function normalizeStatus(status, registry) {
@@ -257,6 +257,6 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-5F7UJHFY.js.map
+//# sourceMappingURL=chunk-HO6CDURZ.js.map
 
 //# debugId=808221df-7514-5d5b-b96f-52279d8f361d

package/dist/cli-bundle/chunks/{chunk-MN2YMU55.js → chunk-HOE3UV3G.js}

@@ -1,6 +1,6 @@
 import {
   resolveSubcommandFlagContractsForCommand
-} from "./chunk-GZNB5V5J.js";
+} from "./chunk-J2ZDZG4A.js";
 import {
   DEFAULT_EXTENSION_PRIORITY,
   EXIT_CODE,
@@ -9,7 +9,7 @@ import {
   isPathWithinDirectory,
   levenshteinDistanceWithinLimit,
   pathExists
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/cli/argv-utils.js
 !(function() {
@@ -872,4 +872,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-MN2YMU55.js.map
+//# sourceMappingURL=chunk-HOE3UV3G.js.map

package/dist/cli-bundle/chunks/{chunk-XQLLRYOX.js → chunk-HRCJGQXL.js}

@@ -1,23 +1,24 @@
 
-!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]="db81baf1-2832-563b-aa1a-40fc623a58a1")}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]="eb82a6cb-8d42-5105-8ed5-234f5059c657")}catch(e){}}();
 import {
   runFiles,
   runFilesDiscover
-} from "./chunk-GC5ME4ZU.js";
+} from "./chunk-FF523THY.js";
 import {
   runDocs
-} from "./chunk-YCHJLOO2.js";
+} from "./chunk-A6AK7W5M.js";
 import {
   runDeps
-} from "./chunk-K7HEURQ4.js";
+} from "./chunk-J2XEW4YL.js";
 import {
   assertHistoryRepairTarget,
   runHistoryRepair,
   runHistoryRepairAll
-} from "./chunk-HT5P3WC6.js";
+} from "./chunk-2Z36LSAT.js";
 import {
   resolveStartTaskInProgressStatus,
   runClaim,
+  runClaimNext,
   runContracts,
   runGc,
   runHealth,
@@ -27,67 +28,67 @@ import {
   runTest,
   runTestAll,
   runValidate
-} from "./chunk-OJ64VYGO.js";
+} from "./chunk-BAK2VLTQ.js";
 import {
   runComments
-} from "./chunk-FMFSUTTD.js";
+} from "./chunk-PTJ7NVUU.js";
 import {
   runCopy
-} from "./chunk-Q3EW4RE5.js";
+} from "./chunk-NGL3X3XM.js";
 import {
   runFocus
-} from "./chunk-ITIUEWD5.js";
+} from "./chunk-RFDT674H.js";
 import {
   runDelete
-} from "./chunk-C3QR2DPR.js";
+} from "./chunk-YP6DWEWQ.js";
 import {
   runAppend
-} from "./chunk-O2Q7YQGO.js";
+} from "./chunk-J7XSQCJO.js";
 import {
   runProfileApply,
   runProfileLint,
   runProfileList,
   runProfileShow
-} from "./chunk-2BUNV627.js";
+} from "./chunk-SJ2DADDH.js";
 import {
   runNotes
-} from "./chunk-AQLKMQQA.js";
+} from "./chunk-3M5BWYUA.js";
 import {
   runLearnings
-} from "./chunk-YMP6AKGU.js";
+} from "./chunk-2XWRFOPR.js";
 import {
   runCloseMany
-} from "./chunk-RYASC6U3.js";
+} from "./chunk-ZUB725AA.js";
 import {
   runUpdateMany
-} from "./chunk-YIWYD7TC.js";
+} from "./chunk-FVZEIWTL.js";
 import {
   runRestore
-} from "./chunk-2JWIRG4V.js";
+} from "./chunk-VF24O6TV.js";
 import {
   runUpdate
-} from "./chunk-KDNZSVCK.js";
+} from "./chunk-CDR2A3VI.js";
 import {
   runClose
-} from "./chunk-I535LTZ2.js";
+} from "./chunk-IS6M4ETF.js";
 import {
   runPlan
-} from "./chunk-GPBKJERW.js";
+} from "./chunk-3WASQS5G.js";
 import {
   runHistoryCompact
-} from "./chunk-HLBSL5KE.js";
+} from "./chunk-FVWQFTTW.js";
 import {
   runHistoryRedact
-} from "./chunk-47CCRGRH.js";
+} from "./chunk-47TKJR3D.js";
 import {
   runConfig,
   runUpgrade
-} from "./chunk-5URFS7C4.js";
+} from "./chunk-PUMGO764.js";
 import {
   SCAFFOLD_CAPABILITIES,
   runExtension,
   runInit
-} from "./chunk-MORRAQXQ.js";
+} from "./chunk-UAZ6W3H3.js";
 import {
   runSchemaAddField,
   runSchemaAddStatus,
@@ -102,7 +103,7 @@ import {
   runSchemaShow,
   runSchemaShowField,
   runSchemaShowStatus
-} from "./chunk-L7C6RTGH.js";
+} from "./chunk-ACDIA6NP.js";
 import {
   jaccardSimilarity,
   normalizeLowercaseWhitespace,
@@ -110,24 +111,24 @@ import {
   runGet,
   runSearch,
   tokenizeAlphaNumeric
-} from "./chunk-RY57ESL2.js";
+} from "./chunk-ND3MDD6L.js";
 import {
   runActivity,
   runContext,
   runNext
-} from "./chunk-2WGV5WRW.js";
+} from "./chunk-DJI5IS46.js";
 import {
   buildListQueryFilters
 } from "./chunk-N7V7TI6J.js";
 import {
   runList
-} from "./chunk-VOXOXART.js";
+} from "./chunk-DLZ3RXAL.js";
 import {
   runHistory
-} from "./chunk-PZBRTJ3Y.js";
+} from "./chunk-VLVTXEGG.js";
 import {
   parseIntegerLimit
-} from "./chunk-FCZ6WYSR.js";
+} from "./chunk-LEXFDABF.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -154,7 +155,7 @@ import {
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores,
   writeVectorizationStatusLedger
-} from "./chunk-WBKZAO3P.js";
+} from "./chunk-A6AVSYRJ.js";
 import {
   ACTIVITY_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -187,19 +188,19 @@ import {
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   toCompletionFlagString
-} from "./chunk-RAC2UXLT.js";
+} from "./chunk-QPWXNK56.js";
 import {
   runCreate
-} from "./chunk-ROH64TST.js";
+} from "./chunk-6XNMSLBT.js";
 import {
   parseTags
-} from "./chunk-K2PDZYUF.js";
+} from "./chunk-OC2CLNMS.js";
 import {
   splitCommaList
 } from "./chunk-NETP4DY4.js";
 import {
   projectMutationResult
-} from "./chunk-KHQYX2QB.js";
+} from "./chunk-NN57FRRN.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -227,7 +228,7 @@ import {
   setActiveExtensionRenderers,
   setActiveExtensionServices,
   toItemRecord
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -256,7 +257,7 @@ import {
   toErrorMessage,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/sdk/runtime.js
 import path3 from "node:path";
@@ -2837,6 +2838,15 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--force[Force override]' \\
             '--if-available[Skip work held by another author]' \\
             '--next[Atomically claim the next actionable item]' \\
+            '--type[Filter --next candidates by type]:(${typeChoices})' \\
+            '--tag[Filter --next candidates by tag]:(${zshTagChoices})' \\
+            '--priority[Filter --next candidates by priority]:(0 1 2 3 4)' \\
+            '--assignee-filter[Filter --next candidates by ownership]:assignee_filter:(assigned unassigned)' \\
+            '--parent[Scope --next candidates to a subtree]:parent' \\
+            '--sprint[Filter --next candidates by sprint]:sprint' \\
+            '--release[Filter --next candidates by release]:release' \\
+            '--max-attempts[Bound the --next candidate walk]:max_attempts' \\
+            '--include-decisions[Allow human-gated Decision candidates]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -5909,6 +5919,79 @@ var PmClient = class {
   gc(options = {}) {
     return this.runTyped("gc", { options });
   }
+  /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
+  plan(subcommand, id, options = {}, stepRef, reorderTo) {
+    return this.runTyped("plan", {
+      ...id === void 0 ? {} : { id },
+      ...stepRef === void 0 ? {} : { stepRef },
+      ...reorderTo === void 0 ? {} : { reorderTo },
+      options: { ...options, subcommand }
+    });
+  }
+  /** Create a durable plan with optional ordered seed steps. */
+  planCreate(options) {
+    return this.plan("create", void 0, options);
+  }
+  /** Read a plan using brief, standard, deep, or field-projected output. */
+  planShow(id, options = {}) {
+    return this.plan("show", id, options);
+  }
+  /** Append an ordered step to a plan. */
+  planAddStep(id, options) {
+    return this.plan("add-step", id, options);
+  }
+  /** Update any mutable property of an existing plan step. */
+  planUpdateStep(id, stepRef, options) {
+    return this.plan("update-step", id, options, stepRef);
+  }
+  /** Complete a plan step and record its evidence. */
+  planCompleteStep(id, stepRef, options = {}) {
+    return this.plan("complete-step", id, options, stepRef);
+  }
+  /** Block a plan step with an actionable reason. */
+  planBlockStep(id, stepRef, options) {
+    return this.plan("block-step", id, options, stepRef);
+  }
+  /** Reorder a plan step while preserving stable step identifiers. */
+  planReorderStep(id, stepRef, reorderTo, options = {}) {
+    return this.plan("reorder-step", id, options, stepRef, reorderTo);
+  }
+  /** Remove a step from a plan and compact the remaining order. */
+  planRemoveStep(id, stepRef, options = {}) {
+    return this.plan("remove-step", id, options, stepRef);
+  }
+  /** Link a tracker item to a plan step. */
+  planLink(id, stepRef, options) {
+    return this.plan("link", id, options, stepRef);
+  }
+  /** Remove tracker-item links from a plan step. */
+  planUnlink(id, stepRef, options) {
+    return this.plan("unlink", id, options, stepRef);
+  }
+  /** Append a durable plan decision. */
+  planDecision(id, options) {
+    return this.plan("decision", id, options);
+  }
+  /** Append a durable plan discovery. */
+  planDiscovery(id, options) {
+    return this.plan("discovery", id, options);
+  }
+  /** Append a plan validation expectation or result. */
+  planValidation(id, options) {
+    return this.plan("validation", id, options);
+  }
+  /** Update the bounded resume context for a stateless future agent. */
+  planResume(id, options) {
+    return this.plan("resume", id, options);
+  }
+  /** Approve a plan for execution. */
+  planApprove(id, options = {}) {
+    return this.plan("approve", id, options);
+  }
+  /** Materialize selected plan steps into governed tracker items. */
+  planMaterialize(id, options) {
+    return this.plan("materialize", id, options);
+  }
   /** Create an item using the same mutation path as `pm create`. */
   create(options = {}) {
     return this.runTyped("create", splitFullClientMutationOptions(options));
@@ -5935,6 +6018,13 @@ var PmClient = class {
       ...splitFullClientMutationOptions(options)
     });
   }
+  /** Atomically claim the highest-ranked available item using the public next-work filters. */
+  claimNext(options = {}) {
+    return this.runTyped("claim", {
+      next: true,
+      ...splitFullClientMutationOptions(options)
+    });
+  }
   /** Release an item's active claim using the same mutation path as `pm release`. */
   release(id, options = {}) {
     return this.runTyped("release", {
@@ -6202,6 +6292,9 @@ function close(id, reason, options = {}, clientOptions = {}) {
 function claim(id, options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).claim(id, options);
 }
+function claimNext(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).claimNext(options);
+}
 function release(id, options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).release(id, options);
 }
@@ -7281,7 +7374,7 @@ var SDK_ACTION_HANDLERS = {
   focus: (ctx) => runFocus(ctx.id, { clear: ctx.options.clear === true || ctx.args.clear === true }, ctx.global),
   update: runMcpUpdateAction,
   restore: runMcpRestoreAction,
-  claim: (ctx) => runClaim(requireMcpItemId(ctx), ctx.force, ctx.global, ctx.options),
+  claim: (ctx) => ctx.options.next === true || ctx.args.next === true ? runClaimNext(ctx.force, ctx.global, { ...ctx.options, ...ctx.args }, { ...ctx.options, ...ctx.args }) : runClaim(requireMcpItemId(ctx), ctx.force, ctx.global, ctx.options),
   release: (ctx) => runRelease(requireMcpItemId(ctx), ctx.force, ctx.global, ctx.options),
   "start-task": runMcpStartTaskAction,
   "pause-task": runMcpPauseTaskAction,
@@ -7456,6 +7549,7 @@ export {
   update,
   close,
   claim,
+  claimNext,
   release,
   copy,
   deleteItem,
@@ -7485,6 +7579,6 @@ export {
   readRequiredString,
   runAction
 };
-//# sourceMappingURL=chunk-XQLLRYOX.js.map
+//# sourceMappingURL=chunk-HRCJGQXL.js.map
 
-//# debugId=db81baf1-2832-563b-aa1a-40fc623a58a1
+//# debugId=eb82a6cb-8d42-5105-8ed5-234f5059c657