@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/dist/cli-bundle/chunks/{chunk-B6JBI7JX.js → chunk-ANLHBXAE.js}

@@ -5,10 +5,10 @@ import {
 } from "./chunk-CUFW7ITY.js";
 import {
   parseLimit
-} from "./chunk-FCZ6WYSR.js";
+} from "./chunk-LEXFDABF.js";
 import {
   parseCsvKv
-} from "./chunk-K2PDZYUF.js";
+} from "./chunk-OC2CLNMS.js";
 import {
   getActiveExtensionRegistrations,
   locateItem,
@@ -16,7 +16,7 @@ import {
   nowIso,
   readLocatedItem,
   readSettings
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -24,7 +24,7 @@ import {
   pathExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/cli/commands/annotation-command.js
 function limitAnnotationEntries(values, limit) {
@@ -238,6 +238,6 @@ export {
   wrapOwnershipConflict,
   runAnnotationCommand
 };
-//# sourceMappingURL=chunk-B6JBI7JX.js.map
+//# sourceMappingURL=chunk-ANLHBXAE.js.map
 
 //# debugId=a1dcddc0-7537-5669-b618-b2abc624ce1a

package/dist/cli-bundle/chunks/{chunk-2KQG6L3J.js → chunk-AS62PEJE.js}

@@ -1,6 +1,6 @@
 import {
   parseLimit
-} from "./chunk-GJNBKU6G.js";
+} from "./chunk-TWELUDDF.js";
 import {
   canonicalDocument,
   enforceHistoryStreamPolicyForItem,
@@ -17,7 +17,7 @@ import {
   sha256Hex,
   stableStringify,
   toItemRecord
-} from "./chunk-Y476SA4V.js";
+} from "./chunk-NEJKKTCG.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -28,7 +28,7 @@ import {
   readFileIfExists,
   resolveItemTypeRegistry,
   resolvePmRoot
-} from "./chunk-7324AI5M.js";
+} from "./chunk-66YL6RR5.js";
 
 // dist/core/history/replay.js
 import jsonPatch from "fast-json-patch";
@@ -511,4 +511,4 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-2KQG6L3J.js.map
+//# sourceMappingURL=chunk-AS62PEJE.js.map

package/dist/cli-bundle/chunks/{chunk-OJ64VYGO.js → chunk-BAK2VLTQ.js}

@@ -1,14 +1,14 @@
 
-!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]="d41bddef-9b85-5450-aee1-bea698eaa9f4")}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]="b72598d6-d0d8-59ca-ac1b-23541407ff77")}catch(e){}}();
 import {
   isRemoteLinkedArtifactReference
 } from "./chunk-FUOK7JZ6.js";
 import {
   scanHistoryDrift
-} from "./chunk-YCSDMIQW.js";
+} from "./chunk-4MO4PPR2.js";
 import {
   wrapOwnershipConflict
-} from "./chunk-B6JBI7JX.js";
+} from "./chunk-ANLHBXAE.js";
 import {
   resolveAuthor
 } from "./chunk-CUFW7ITY.js";
@@ -17,29 +17,29 @@ import {
   TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,
   TELEMETRY_SCHEMA_VERSION,
   flushTelemetryQueueNow
-} from "./chunk-7HQQT6AT.js";
+} from "./chunk-7TYZTBEV.js";
 import {
   buildCapabilityContractMetadata,
   buildRegistrationCollisionRemediation,
   collectUnknownCapabilityGuidance,
   readManagedExtensionState,
   runInit
-} from "./chunk-MORRAQXQ.js";
+} from "./chunk-UAZ6W3H3.js";
 import {
   collectStaleVectorizationIds,
   runNext
-} from "./chunk-2WGV5WRW.js";
+} from "./chunk-DJI5IS46.js";
 import {
   computeContentFieldUtilization
-} from "./chunk-VOXOXART.js";
+} from "./chunk-DLZ3RXAL.js";
 import {
   computeMetadataCoverage,
   groupItemsByDimension,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-5F7UJHFY.js";
+} from "./chunk-HO6CDURZ.js";
 import {
   parseLimit
-} from "./chunk-FCZ6WYSR.js";
+} from "./chunk-LEXFDABF.js";
 import {
   buildVectorizationEmbeddingIdentity,
   hasVectorizationEmbeddingIdentityChanged,
@@ -49,7 +49,7 @@ import {
   resolveProviderConfigSource,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-WBKZAO3P.js";
+} from "./chunk-A6AVSYRJ.js";
 import {
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   ACTIVITY_FLAG_CONTRACTS,
@@ -142,7 +142,7 @@ import {
   UPGRADE_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   compactFlagAliasContracts
-} from "./chunk-RAC2UXLT.js";
+} from "./chunk-QPWXNK56.js";
 import {
   LINKED_TEST_PM_CONTEXT_MODE_VALUES,
   LINKED_TEST_PROTECTED_ENV_KEYS,
@@ -159,12 +159,12 @@ import {
   parseLinkedTestRegexList,
   parseLinkedTestStringList,
   runCreate
-} from "./chunk-ROH64TST.js";
+} from "./chunk-6XNMSLBT.js";
 import {
   createStdinTokenResolver,
   parseCsvKv,
   parseOptionalNumber
-} from "./chunk-K2PDZYUF.js";
+} from "./chunk-OC2CLNMS.js";
 import {
   CURRENT_ITEM_FORMAT_VERSION,
   compareTimestampStrings,
@@ -191,7 +191,7 @@ import {
   stableValueEquals,
   toItemRecord,
   writeSettings
-} from "./chunk-NAGOH4YJ.js";
+} from "./chunk-VXUWCJS7.js";
 import {
   DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,
   DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
@@ -233,7 +233,7 @@ import {
   statusIsTerminal,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-QCKPSFII.js";
+} from "./chunk-AHIEDSW2.js";
 
 // dist/sdk/start-task-status.js
 function resolveStartTaskInProgressStatus(statusRegistry) {
@@ -241,6 +241,7 @@ function resolveStartTaskInProgressStatus(statusRegistry) {
 }
 
 // dist/cli/commands/claim.js
+var NO_AVAILABLE_NEXT_ITEM_CODE = "no_available_next_item";
 function isAlreadyClaimedError(error) {
   return error instanceof PmCliError && error.context?.code === "already_claimed_by";
 }
@@ -305,37 +306,65 @@ async function runClaim(id, force, global, options = {}) {
   };
 }
 async function runClaimNext(force, global, options = {}, nextOptions = {}) {
-  const next = await runNext({ ...nextOptions, callerAuthor: options.author, limit: "10" }, global);
+  const maxAttempts = parseClaimNextAttempts(options.maxAttempts);
+  const settings = await readSettings(resolvePmRoot(process.cwd(), global.path));
+  const claimOptions = {
+    ...options,
+    author: resolveAuthor(options.author, settings.author_default)
+  };
+  const next = await runNext({
+    ...nextOptions,
+    callerAuthor: claimOptions.author,
+    limit: String(maxAttempts)
+  }, global);
   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, global, options);
+  return claimNextFromRecommendations(recommendations.slice(0, maxAttempts), force, global, 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, global, options = {}, claimRunner = runClaim) {
   let attempts = 0;
-  let lastSkipped;
   for (const recommendation of recommendations) {
     attempts += 1;
     try {
       const claimed = await claimRunner(recommendation.id, force, global, 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."
     ]
   });
 }
@@ -10627,7 +10656,7 @@ async function applyValidateFix(fix, global) {
     case "set_estimate":
     case "reparent":
     case "unset_parent": {
-      const { runUpdate } = await import("./update-ZCDGTSNL.js");
+      const { runUpdate } = await import("./update-IKMNH3W4.js");
       const updateOptions = {
         message: VALIDATE_AUTO_FIX_MESSAGE
       };
@@ -10689,10 +10718,10 @@ async function applyValidateFixes(applicable, global) {
     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-RNFWG435.js");
+        const { runFiles } = await import("./files-2QEI2V3C.js");
         await runFiles(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global);
       } else {
-        const { runDocs } = await import("./docs-HN6QKGEU.js");
+        const { runDocs } = await import("./docs-UKTQVUHS.js");
         await runDocs(first.item_id, { remove, message: VALIDATE_AUTO_FIX_MESSAGE }, global);
       }
       applied.push(...batch);
@@ -10882,6 +10911,6 @@ export {
   runTestRunsWorker,
   runValidate
 };
-//# sourceMappingURL=chunk-OJ64VYGO.js.map
+//# sourceMappingURL=chunk-BAK2VLTQ.js.map
 
-//# debugId=d41bddef-9b85-5450-aee1-bea698eaa9f4
+//# debugId=b72598d6-d0d8-59ca-ac1b-23541407ff77