@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli-bundle/chunks/{chunk-C4FIA5U6.js → chunk-OYCZDDUC.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-CCAGZCZK.js";
 import {
   scanHistoryDrift
-} from "./chunk-VNCQ7SSG.js";
+} from "./chunk-NNRXTZ7Y.js";
 import {
   wrapOwnershipConflict
-} from "./chunk-WCRAUCJO.js";
+} from "./chunk-546WPG33.js";
 import {
   resolveAuthor
 } from "./chunk-YRYYFGV3.js";
@@ -15,29 +15,29 @@ import {
   TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,
   TELEMETRY_SCHEMA_VERSION,
   flushTelemetryQueueNow
-} from "./chunk-2BKRMFGK.js";
+} from "./chunk-UFY4ETU6.js";
 import {
   buildCapabilityContractMetadata,
   buildRegistrationCollisionRemediation,
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-E72ZO34Z.js";
+} from "./chunk-G6B5XGNV.js";
 import {
   collectStaleVectorizationIds,
   runNext
-} from "./chunk-MSPZSUKQ.js";
+} from "./chunk-SV7PEWKW.js";
 import {
   computeContentFieldUtilization
-} from "./chunk-4DC5XNMS.js";
+} from "./chunk-GFBV2254.js";
 import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-RPZ57GQ7.js";
+} from "./chunk-QFCCN4JO.js";
 import {
   parseLimit
-} from "./chunk-GJNBKU6G.js";
+} from "./chunk-TWELUDDF.js";
 import {
   buildVectorizationEmbeddingIdentity,
   hasVectorizationEmbeddingIdentityChanged,
@@ -47,7 +47,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-TB6364F7.js";
+} from "./chunk-Z7XTVIN5.js";
 import {
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   ACTIVITY_FLAG_CONTRACTS,
@@ -140,7 +140,7 @@ import {
   UPGRADE_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   compactFlagAliasContracts
-} from "./chunk-GZNB5V5J.js";
+} from "./chunk-J2ZDZG4A.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -157,12 +157,12 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-A3AIKEYC.js";
+} from "./chunk-TYCM65DJ.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-SN7Q7M4U.js";
+} from "./chunk-OKUFGORG.js";
 import {
   CURRENT_ITEM_FORMAT_VERSION,
   compareTimestampStrings,
@@ -189,7 +189,7 @@ import {
   stableValueEquals,
   toItemRecord,
   writeSettings
-} from "./chunk-Y476SA4V.js";
+} from "./chunk-NEJKKTCG.js";
 import {
   DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,
   DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
@@ -231,7 +231,7 @@ import {
   statusIsTerminal,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/sdk/start-task-status.js
 !(function() {
@@ -249,10 +249,11 @@ function resolveStartTaskInProgressStatus(statusRegistry) {
 !(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] = "de297ba8-c57e-5d25-8e88-8df02a74d5c6");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c0e18740-ab85-5611-94aa-3e49751f63d0");
   } catch (e2) {
   }
 })();
+var NO_AVAILABLE_NEXT_ITEM_CODE = "no_available_next_item";
 function isAlreadyClaimedError(error) {
   return error instanceof PmCliError && error.context?.code === "already_claimed_by";
 }
@@ -317,37 +318,65 @@ async function runClaim(id, force, global2, options = {}) {
   };
 }
 async function runClaimNext(force, global2, options = {}, nextOptions = {}) {
-  const next = await runNext({ ...nextOptions, callerAuthor: options.author, limit: "10" }, global2);
+  const maxAttempts = parseClaimNextAttempts(options.maxAttempts);
+  const settings = await readSettings(resolvePmRoot(process.cwd(), global2.path));
+  const claimOptions = {
+    ...options,
+    author: resolveAuthor(options.author, settings.author_default)
+  };
+  const next = await runNext({
+    ...nextOptions,
+    callerAuthor: claimOptions.author,
+    limit: String(maxAttempts)
+  }, global2);
   const recommendations = [next.recommended, ...next.ready].filter((entry) => entry !== null).map((entry) => ({
     ...entry,
     reasons: "reasons" in entry ? entry.reasons : ["ranked ready candidate"]
   }));
-  return claimNextFromRecommendations(recommendations, force, global2, options);
+  return claimNextFromRecommendations(recommendations.slice(0, maxAttempts), force, global2, claimOptions);
+}
+function parseClaimNextAttempts(raw) {
+  if (raw === void 0)
+    return 10;
+  const parsed = Number(raw);
+  if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 100) {
+    throw new PmCliError("--max-attempts must be an integer from 1 to 100", EXIT_CODE.USAGE);
+  }
+  return parsed;
 }
 async function claimNextFromRecommendations(recommendations, force, global2, options = {}, claimRunner = runClaim) {
   let attempts = 0;
-  let lastSkipped;
   for (const recommendation of recommendations) {
     attempts += 1;
     try {
       const claimed = await claimRunner(recommendation.id, force, global2, options);
-      const result = { ...claimed, recommendation, attempts };
-      if (claimed.skipped)
-        lastSkipped = result;
-      else
+      const result = { ...claimed, recommendation, attempts, available: true };
+      if (!claimed.skipped)
         return result;
     } catch (error) {
       if (!isAlreadyClaimedError(error))
         throw error;
     }
   }
-  if (lastSkipped)
-    return lastSkipped;
-  throw new PmCliError("No actionable item remained available to claim", EXIT_CODE.CONFLICT, {
-    code: "no_available_next_item",
-    why: "Every ranked candidate was claimed by another agent before this atomic selection completed.",
+  if (options.ifAvailable === true) {
+    return {
+      available: false,
+      item: null,
+      claimed_by: options.author ?? process.env.PM_AUTHOR ?? "unknown",
+      previous_assignee: null,
+      forced: force,
+      skipped: true,
+      recommendation: null,
+      attempts,
+      warnings: [NO_AVAILABLE_NEXT_ITEM_CODE]
+    };
+  }
+  const noCandidatesMatched = attempts === 0;
+  throw new PmCliError(noCandidatesMatched ? "No actionable items matched the selection filters" : "No actionable item remained available to claim", noCandidatesMatched ? EXIT_CODE.NOT_FOUND : EXIT_CODE.CONFLICT, {
+    code: NO_AVAILABLE_NEXT_ITEM_CODE,
+    why: noCandidatesMatched ? "No ready items matched the specified filters or selection criteria." : "Every ranked candidate was claimed by another agent before this atomic selection completed.",
     nextSteps: [
-      "Run pm claim --next again to refresh the ranked candidate set."
+      noCandidatesMatched ? "Verify the filters or run pm next to inspect all ready work." : "Run pm claim --next again to refresh the ranked candidate set."
     ]
   });
 }
@@ -10807,7 +10836,7 @@ async function applyValidateFix(fix, global2) {
     case "set_estimate":
     case "reparent":
     case "unset_parent": {
-      const { runUpdate } = await import("./update-D3ZZ2V7Z.js");
+      const { runUpdate } = await import("./update-2T5EWMXD.js");
       const updateOptions = {
         message: VALIDATE_AUTO_FIX_MESSAGE
       };
@@ -10869,10 +10898,10 @@ async function applyValidateFixes(applicable, global2) {
     const remove = batch.map((fix) => fix.path).filter((value) => typeof value === "string" && value.length > 0);
     try {
       if (first.kind === "prune_file_link") {
-        const { runFiles } = await import("./files-NX4LNOPL.js");
+        const { runFiles } = await import("./files-7OIKZPI3.js");
         await runFiles(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global2);
       } else {
-        const { runDocs } = await import("./docs-J4OI4PWM.js");
+        const { runDocs } = await import("./docs-SILTBWSO.js");
         await runDocs(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global2);
       }
       applied.push(...batch);
@@ -11062,4 +11091,4 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-C4FIA5U6.js.map
+//# sourceMappingURL=chunk-OYCZDDUC.js.map