@unbrained/pm-cli 2026.7.11 → 2026.7.12

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "1.4.1"
+    "version": "2026.7.12"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "1.4.1",
+      "version": "2026.7.12",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 2026.7.12 - 2026-07-12
+
+### Added
+
+- Promote plan workflow primitives to the public SDK: plan create/steps/dependencies/decisions/discoveries/validation/materialization ([pm-je50](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-je50.toon))
+
+### Fixed
+
+- Restore 100% SDK workspace read-error coverage ([pm-jw2a](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-jw2a.toon))
+- GH-510: macOS nightly red — withTempPmPath skips realpath canonicalization; init-path-guard probe-root assertion fails (/var vs /private/var) ([pm-dprb](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-dprb.toon))
+- GH-454: schema add-field accepts reserved built-in names silently; collision error names no partner ([pm-b9ov](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-b9ov.toon))
+- GH-516: pm init seeds unrelated managed packages into fresh PM_GLOBAL_PATH workspaces ([pm-b0se](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-b0se.toon))
+- GH-448: boolean custom field is silently never persisted (data-loss class) ([pm-sjfs](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-sjfs.toon))
+- GH-509: pm claim --next lacks candidate filters and race-loss walk — thread next filters + advance to next candidate ([pm-fjxm](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-fjxm.toon))
+- Prevent Decision items from entering agent work lanes by default; allow explicit maintainer opt-in ([pm-eqk0](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-eqk0.toon))
+- GH-513: pm next ready\[\] documented as ranked but not priority-ordered; no rank/score exposed ([pm-1mwk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-1mwk.toon))
+- Fix red main coverage gate: measure-agent-token-surface.mjs landed without a covering spec ([pm-ksca](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ksca.toon))
+- GH-508: dedupe LegacyNoneCollectionNormalizer tables duplicated between create.ts and update.ts (CodeFactor) ([pm-zuw8](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-zuw8.toon))
+- Release-readiness guard expects pre-sync version:check command after date-version synchronization ([pm-pmmv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-pmmv.toon))
+- Restore generated-loader docstrings and redact host path from tracker history ([pm-9ugc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9ugc.toon))
+- Full coverage contention times out metadata content-filter integration case ([pm-d30l](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-d30l.toon))
+- GH-453: plan materialize --json response omits title/type/parent on materialized entries ([pm-ypha](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-ypha.toon))
+- GH-452: plan materialize dead-ends on types with required-on-create custom fields ([pm-qd2h](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-qd2h.toon))
+- GH-507: recovery suggested_retry appends <value\> to missing boolean EXTENSION flags (contract arity ignored) ([pm-9qcr](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-9qcr.toon))
+- GH-505: nested extension failures suggest irrelevant missing flags instead of preserving tracker recovery ([pm-o71e](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-o71e.toon))
+- GH-504: importer/exporter registered without options yields an unusable CLI command (no arg/flag contracts) ([pm-0mjz](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-0mjz.toon))
+- GH-503: flattened extension-command aliases (csv-export, jira-sync) drop option contracts ([pm-s9iu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-s9iu.toon))
+
+### Other
+
+- CI/CD + test-suite performance: in-process CLI runner and dedupe redundant matrix legs ([pm-7rlp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-7rlp.toon))
+- Coverage to 100%: src/core, src/mcp, and src/sdk modules ([pm-krwu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-krwu.toon))
+- Baseline agent token cost of the CLI surface: measure pm --help, per-command help, and contracts payload sizes before consolidation ([pm-a22j](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-a22j.toon))
+- Research and document the July 2026 native ChatGPT/Codex plugin implementation plan ([pm-n28t](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-n28t.toon))
+- Align all plugin and package manifests to date-based versioning with release-time sync ([pm-hxsv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-hxsv.toon))
+
 ## 2026.7.11 - 2026-07-11
 
 ### Added
@@ -587,7 +623,6 @@
 - ADR: literal all-src coverage supersedes curated include/exclude allowlist ([pm-w13j](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-w13j.toon))
 - Literal 100% all-source test coverage & module-mirrored test reorganization ([pm-xau3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/epics/pm-xau3.toon))
 - Coverage to 100%: packages, plugins, and docs examples ([pm-6tch](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-6tch.toon))
-- Coverage to 100%: src/core, src/mcp, and src/sdk modules ([pm-krwu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-krwu.toon))
 - Coverage to 100%: src/cli command handlers (group B — query, search, calendar, test, init, extension) ([pm-7v9s](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-7v9s.toon))
 - Coverage to 100%: src/cli command handlers (group A — mutation, history, storage, schema) ([pm-ud1x](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-ud1x.toon))
 - Coverage to 100%: src/cli infrastructure (registration, bootstrap, help, main) ([pm-uvxc](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-uvxc.toon))
@@ -1076,7 +1111,6 @@
 - Calendar + SDK + vector-search + docs review (2026-05-27) ([pm-a0w4](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-a0w4.toon))
 - Code-quality & dead/duplicate code audit (2026-05-27) ([pm-jvbt](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-jvbt.toon))
 - Keep large modules maintainable via barrel re-export splits + explicit uncovered allowlist ([pm-3cbk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/decisions/pm-3cbk.toon))
-- CI/CD + test-suite performance: in-process CLI runner and dedupe redundant matrix legs ([pm-7rlp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-7rlp.toon))
 - Bump @sentry/node 10.53.1 to 10.54.0 ([pm-0g2p](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-0g2p.toon))
 - Dedupe history-redact + history-repair lock+ownership scaffolding ([pm-kbm9](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-kbm9.toon))
 - Agent-UX combined PR: compact mutation output (pm-ch59) + smarter unknown-flag recovery (pm-8nyc) ([pm-70mi](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/plans/pm-70mi.toon))

package/README.md

@@ -27,8 +27,6 @@
 | Settings, storage, search, and output | [Configuration](docs/CONFIGURATION.md) |
 | Safe test execution and linked tests | [Testing](docs/TESTING.md) |
 | Package and extension authoring | [Packages and Extensions](docs/EXTENSIONS.md) and [SDK](docs/SDK.md) |
-| Codex native integration | [Codex Plugin](docs/CODEX_PLUGIN.md) |
-| Claude Code native integration | [Claude Code Plugin](docs/CLAUDE_CODE_PLUGIN.md) |
 | Maintainer release process (daily auto-release + local parity) | [Releasing](docs/RELEASING.md) |
 | Contributor internals | [Architecture](docs/ARCHITECTURE.md) |
 
@@ -54,14 +52,6 @@ Project-local invocation also works:
 npx --yes @unbrained/pm-cli@latest --help
 ```
 
-For Claude Code, install the native plugin (no `pm` CLI required):
-
-```
-/plugin install pm-claude@pm
-```
-
-This registers 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI tracking, and a session-start context hook — all without shelling out to the `pm` CLI.
-
 `pm` packages use the same package-first vocabulary:
 
 ```bash
@@ -115,15 +105,6 @@ If no relevant item exists, create a parent lineage before child work, claim the
 
 For token-aware local routing, install `guide-shell` with `pm install guide-shell --project`, then use `pm guide workflows` and drill into related topics (`commands`, `skills`, `release`) only when needed.
 
-## Release Automation
-
-- Daily release preparation runs in `.github/workflows/auto-release.yml`.
-- Tag-driven publishing remains in `.github/workflows/release.yml`.
-- Local parity commands:
-  - `pnpm release:pipeline:dry-run`
-  - `pnpm release:pipeline`
-  - run maintainer-only reliability checks separately and keep their raw details in ignored local notes
-
 ## Core Model
 
 - Items live under `.agents/pm/` as TOON by default, with JSON-front-matter markdown also supported.
@@ -136,20 +117,6 @@ For token-aware local routing, install `guide-shell` with `pm install guide-shel
 
 Search behavior (lexical `search.tuning` weights, hybrid `--semantic-weight`, query expansion, reranking, and vector-store options) is fully configurable — see [Search Configuration](docs/CONFIGURATION.md#search-configuration).
 
-## Tracker References
-
-Current documentation work is tracked through:
-
-- [pm-u9d0](.agents/pm/epics/pm-u9d0.toon) - docs, onboarding, release, and CI capability epic
-
-Legacy documentation baseline references (closed):
-
-- [pm-3042](.agents/pm/epics/pm-3042.toon) - documentation overhaul epic (closed)
-- [pm-r9gu](.agents/pm/features/pm-r9gu.toon) - documentation structure feature (closed)
-- [pm-1sb2](.agents/pm/tasks/pm-1sb2.toon) - README and public docs rewrite task (closed)
-
-Docs should link to relevant `pm` items, and `pm` items should link back to changed docs through `pm docs`.
-
 ## License
 
 [MIT](LICENSE)

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

@@ -1,5 +1,7 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type NextRecommendation, type NextOptions } from "./next.js";
+/** Stable warning/error code for an exhausted atomic next-work walk. */
+export declare const NO_AVAILABLE_NEXT_ITEM_CODE = "no_available_next_item";
 /** Documents the claim result payload exchanged by command, SDK, and package integrations. */
 export interface ClaimResult {
     /** Value that configures or reports item for this contract. */
@@ -16,12 +18,37 @@ export interface ClaimResult {
     warnings?: string[];
 }
 /** Result of atomically selecting and claiming the next caller-available item. */
-export interface ClaimNextResult extends ClaimResult {
+export interface ClaimNextAvailableResult extends ClaimResult {
+    /** True when an actionable candidate was claimed. */
+    available: true;
     /** Value that configures or reports recommendation for this contract. */
     recommendation: NextRecommendation;
     /** Value that configures or reports attempts for this contract. */
     attempts: number;
 }
+/** Non-error empty result returned when an if-available candidate walk is exhausted. */
+export interface ClaimNextUnavailableResult {
+    /** Indicates that no candidate remained claimable. */
+    available: false;
+    /** Empty item projection for a deliberately unavailable selection. */
+    item: null;
+    /** Caller identity that attempted the selection. */
+    claimed_by: string;
+    /** No previous owner exists for an empty selection. */
+    previous_assignee: null;
+    /** Whether forced selection was requested. */
+    forced: boolean;
+    /** Signals a deliberate non-error skip. */
+    skipped: true;
+    /** No recommendation survived the bounded walk. */
+    recommendation: null;
+    /** Number of ranked candidates attempted. */
+    attempts: number;
+    /** Stable machine-readable exhaustion warning. */
+    warnings: [typeof NO_AVAILABLE_NEXT_ITEM_CODE];
+}
+/** Result of a successful or deliberately empty atomic next-work claim. */
+export type ClaimNextResult = ClaimNextAvailableResult | ClaimNextUnavailableResult;
 /** Returns whether a failed claim lost the atomic test-and-set race. */
 export declare function isAlreadyClaimedError(error: unknown): boolean;
 type ClaimRunner = (id: string, force: boolean, global: GlobalOptions, options: ClaimMutationOptions) => Promise<ClaimResult>;
@@ -46,6 +73,8 @@ export interface ClaimMutationOptions {
     message?: string;
     /** Value that configures or reports if available for this contract. */
     ifAvailable?: boolean;
+    /** Maximum ranked candidates attempted by `claim --next`. */
+    maxAttempts?: string | number;
 }
 /** Documents the release mutation options payload exchanged by command, SDK, and package integrations. */
 export interface ReleaseMutationOptions extends ClaimMutationOptions {
@@ -56,6 +85,8 @@ export interface ReleaseMutationOptions extends ClaimMutationOptions {
 export declare function runClaim(id: string, force: boolean, global: GlobalOptions, options?: ClaimMutationOptions): Promise<ClaimResult>;
 /** Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. */
 export declare function runClaimNext(force: boolean, global: GlobalOptions, options?: ClaimMutationOptions, nextOptions?: NextOptions): Promise<ClaimNextResult>;
+/** Parses the bounded candidate walk used by `claim --next`. */
+export declare function parseClaimNextAttempts(raw: string | number | undefined): number;
 /** Claims the first still-available row from a pre-ranked recommendation set. */
 export declare function claimNextFromRecommendations(recommendations: NextRecommendation[], force: boolean, global: GlobalOptions, options?: ClaimMutationOptions, claimRunner?: ClaimRunner): Promise<ClaimNextResult>;
 /** Implements run release for the public runtime surface of this module. */

package/dist/cli/commands/claim.js

@@ -4,7 +4,7 @@
  * Implements the pm claim 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]="de297ba8-c57e-5d25-8e88-8df02a74d5c6")}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]="c0e18740-ab85-5611-94aa-3e49751f63d0")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { resolveRuntimeStatusRegistry, statusIsTerminal, } from "../../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -16,6 +16,8 @@ import { readSettings } from "../../core/store/settings.js";
 import { resolveAuthor } from "../../core/shared/author.js";
 import { wrapOwnershipConflict } from "./annotation-command.js";
 import { runNext } from "./next.js";
+/** Stable warning/error code for an exhausted atomic next-work walk. */
+export const NO_AVAILABLE_NEXT_ITEM_CODE = "no_available_next_item";
 /** Returns whether a failed claim lost the atomic test-and-set race. */
 export function isAlreadyClaimedError(error) {
     return (error instanceof PmCliError && error.context?.code === "already_claimed_by");
@@ -85,27 +87,44 @@ export async function runClaim(id, force, global, options = {}) {
 }
 /** Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. */
 export 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);
+}
+/** Parses the bounded candidate walk used by `claim --next`. */
+export function parseClaimNextAttempts(raw) {
+    if (raw === undefined)
+        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;
 }
 /** Claims the first still-available row from a pre-ranked recommendation set. */
 export 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) {
@@ -113,13 +132,31 @@ export async function claimNextFromRecommendations(recommendations, force, globa
                 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.",
         ],
     });
 }
@@ -174,4 +211,4 @@ export async function runRelease(id, force, global, options = {}) {
     };
 }
 //# sourceMappingURL=claim.js.map
-//# debugId=de297ba8-c57e-5d25-8e88-8df02a74d5c6
+//# debugId=c0e18740-ab85-5611-94aa-3e49751f63d0

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

@@ -1 +1 @@
-{"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/claim\n *\n * Implements the pm claim command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  resolveRuntimeStatusRegistry,\n  statusIsTerminal,\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 { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"./annotation-command.js\";\nimport { runNext, type NextRecommendation, type NextOptions } from \"./next.js\";\n\n/** Documents the claim result payload exchanged by command, SDK, and package integrations. */\nexport interface ClaimResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports claimed by for this contract. */\n  claimed_by: string;\n  /** Value that configures or reports previous assignee for this contract. */\n  previous_assignee: string | null;\n  /** Value that configures or reports forced for this contract. */\n  forced: boolean;\n  /** Value that configures or reports skipped for this contract. */\n  skipped?: boolean;\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n}\n\n/** Result of atomically selecting and claiming the next caller-available item. */\nexport interface ClaimNextResult extends ClaimResult {\n  /** Value that configures or reports recommendation for this contract. */\n  recommendation: NextRecommendation;\n  /** Value that configures or reports attempts for this contract. */\n  attempts: number;\n}\n\n/** Returns whether a failed claim lost the atomic test-and-set race. */\nexport function isAlreadyClaimedError(error: unknown): boolean {\n  return (\n    error instanceof PmCliError && error.context?.code === \"already_claimed_by\"\n  );\n}\n\ntype ClaimRunner = (\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions,\n) => Promise<ClaimResult>;\n\n/** Documents the release result payload exchanged by command, SDK, and package integrations. */\nexport interface ReleaseResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports released by for this contract. */\n  released_by: string;\n  /** Value that configures or reports previous assignee for this contract. */\n  previous_assignee: string | null;\n  /** Value that configures or reports audit release for this contract. */\n  audit_release: boolean;\n  /** Value that configures or reports forced for this contract. */\n  forced: boolean;\n}\n\n/** Documents the claim mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface ClaimMutationOptions {\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports if available for this contract. */\n  ifAvailable?: boolean;\n}\n\n/** Documents the release mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  /** Value that configures or reports allow audit release for this contract. */\n  allowAuditRelease?: boolean;\n}\n\n/** Implements run claim for the public runtime surface of this module. */\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    skipNoop: true,\n    mutate(document) {\n      const currentAssignee = document.metadata.assignee;\n      const currentAssigneeText =\n        typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n      previousAssignee =\n        currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n      if (\n        statusIsTerminal(document.metadata.status, statusRegistry) &&\n        !force\n      ) {\n        throw new PmCliError(\n          `Cannot claim terminal item ${document.metadata.id} without --force`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      const heldByOther =\n        previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther && !force) {\n        throw new PmCliError(\n          `Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`,\n          EXIT_CODE.CONFLICT,\n          {\n            code: \"already_claimed_by\",\n            why: \"Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.\",\n            nextSteps: [\n              \"Run pm next to pick a different unclaimed item.\",\n              \"Re-run with --if-available to treat a held item as a no-op skip.\",\n              \"Re-run with --force only when taking over the item is coordinated.\",\n            ],\n          },\n        );\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    claimed_by:\n      skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\n/** Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. */\nexport async function runClaimNext(\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n  nextOptions: NextOptions = {},\n): Promise<ClaimNextResult> {\n  const next = await runNext(\n    { ...nextOptions, callerAuthor: options.author, limit: \"10\" },\n    global,\n  );\n  const recommendations = [next.recommended, ...next.ready]\n    .filter((entry): entry is NextRecommendation => entry !== null)\n    .map((entry) => ({\n      ...entry,\n      reasons: \"reasons\" in entry ? entry.reasons : [\"ranked ready candidate\"],\n    }));\n  return claimNextFromRecommendations(recommendations, force, global, options);\n}\n\n/** Claims the first still-available row from a pre-ranked recommendation set. */\nexport async function claimNextFromRecommendations(\n  recommendations: NextRecommendation[],\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n  claimRunner: ClaimRunner = runClaim,\n): Promise<ClaimNextResult> {\n  let attempts = 0;\n  let lastSkipped: ClaimNextResult | undefined;\n  for (const recommendation of recommendations) {\n    attempts += 1;\n    try {\n      const claimed = await claimRunner(\n        recommendation.id,\n        force,\n        global,\n        options,\n      );\n      const result = { ...claimed, recommendation, attempts };\n      if (claimed.skipped) lastSkipped = result;\n      else return result;\n    } catch (error: unknown) {\n      if (!isAlreadyClaimedError(error)) throw error;\n    }\n  }\n  if (lastSkipped) return lastSkipped;\n  throw new PmCliError(\n    \"No actionable item remained available to claim\",\n    EXIT_CODE.CONFLICT,\n    {\n      code: \"no_available_next_item\",\n      why: \"Every ranked candidate was claimed by another agent before this atomic selection completed.\",\n      nextSteps: [\n        \"Run pm claim --next again to refresh the ranked candidate set.\",\n      ],\n    },\n  );\n}\n\n/** Implements run release for the public runtime surface of this module. */\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, {\n      required:\n        \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: [\n        'pm release pm-a1b2 --author \"reviewer\" --allow-audit-release',\n      ],\n      nextSteps: [\n        \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n        \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n      ],\n    });\n  }\n\n  return {\n    item: toItemRecord(result.item),\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,OAAO,EAA6C,MAAM,WAAW,CAAC;AA0B/E,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,CACL,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,oBAAoB,CAC5E,CAAC;AACJ,CAAC;AAuCD,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAU,EACV,KAAc,EACd,MAAqB,EACrB,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,iCAAiC,MAAM,sBAAsB,EAC7D,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM;QACN,QAAQ;QACR,EAAE;QACF,EAAE,EAAE,OAAO;QACX,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,CAAC,QAAQ;YACb,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACnD,MAAM,mBAAmB,GACvB,OAAO,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,gBAAgB;gBACd,mBAAmB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,IACE,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAC1D,CAAC,KAAK,EACN,CAAC;gBACD,MAAM,IAAI,UAAU,CAClB,8BAA8B,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,EACpE,SAAS,CAAC,QAAQ,CACnB,CAAC;YACJ,CAAC;YACD,MAAM,WAAW,GACf,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,KAAK,MAAM,CAAC;YAC3D,IAAI,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,GAAG,IAAI,CAAC;gBACf,gBAAgB,CAAC,IAAI,CAAC,yBAAyB,gBAAgB,EAAE,CAAC,CAAC;gBACnE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,IAAI,UAAU,CAClB,QAAQ,QAAQ,CAAC,QAAQ,CAAC,EAAE,0BAA0B,gBAAgB,wEAAwE,EAC9I,SAAS,CAAC,QAAQ,EAClB;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,GAAG,EAAE,oGAAoG;oBACzG,SAAS,EAAE;wBACT,iDAAiD;wBACjD,kEAAkE;wBAClE,oEAAoE;qBACrE;iBACF,CACF,CAAC;YACJ,CAAC;YACD,IAAI,WAAW,EAAE,CAAC;gBAChB,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,gBAAgB,KAAK,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC;YACpC,OAAO,EAAE,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QACrE,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,UAAU,EACR,OAAO,IAAI,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM;QAClE,iBAAiB,EAAE,gBAAgB;QACnC,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,6NAA6N;AAC7N,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAc,EACd,MAAqB,EACrB,UAAgC,EAAE,EAClC,cAA2B,EAAE;IAE7B,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,EAAE,GAAG,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAC7D,MAAM,CACP,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;SACtD,MAAM,CAAC,CAAC,KAAK,EAA+B,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SAC9D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,GAAG,KAAK;QACR,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;KACzE,CAAC,CAAC,CAAC;IACN,OAAO,4BAA4B,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,eAAqC,EACrC,KAAc,EACd,MAAqB,EACrB,UAAgC,EAAE,EAClC,cAA2B,QAAQ;IAEnC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,WAAwC,CAAC;IAC7C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,QAAQ,IAAI,CAAC,CAAC;QACd,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,cAAc,CAAC,EAAE,EACjB,KAAK,EACL,MAAM,EACN,OAAO,CACR,CAAC;YACF,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;YACxD,IAAI,OAAO,CAAC,OAAO;gBAAE,WAAW,GAAG,MAAM,CAAC;;gBACrC,OAAO,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;QACjD,CAAC;IACH,CAAC;IACD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,IAAI,UAAU,CAClB,gDAAgD,EAChD,SAAS,CAAC,QAAQ,EAClB;QACE,IAAI,EAAE,wBAAwB;QAC9B,GAAG,EAAE,6FAA6F;QAClG,SAAS,EAAE;YACT,gEAAgE;SACjE;KACF,CACF,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAU,EACV,KAAc,EACd,MAAqB,EACrB,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,iCAAiC,MAAM,sBAAsB,EAC7D,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAE3C,IAAI,MAA8C,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC;YACxB,MAAM;YACN,QAAQ;YACR,EAAE;YACF,EAAE,EAAE,SAAS;YACb,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK;YACL,sBAAsB,EAAE,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC1D,MAAM,CAAC,QAAQ;gBACb,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;gBACtD,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;gBAC/B,CAAC;gBACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAClC,OAAO,EAAE,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,qBAAqB,CAAC,KAAK,EAAE;YAC3B,QAAQ,EACN,0FAA0F;YAC5F,QAAQ,EAAE;gBACR,8DAA8D;aAC/D;YACD,SAAS,EAAE;gBACT,+FAA+F;gBAC/F,yFAAyF;aAC1F;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,WAAW,EAAE,MAAM;QACnB,iBAAiB,EAAE,gBAAgB;QACnC,aAAa,EAAE,OAAO,CAAC,iBAAiB,KAAK,IAAI;QACjD,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC","debugId":"de297ba8-c57e-5d25-8e88-8df02a74d5c6"}
+{"version":3,"file":"claim.js","sources":["cli/commands/claim.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/claim\n *\n * Implements the pm claim command surface and its agent-facing runtime behavior.\n */\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  resolveRuntimeStatusRegistry,\n  statusIsTerminal,\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 { toItemRecord } from \"../../core/item/item-record.js\";\nimport { mutateItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport { wrapOwnershipConflict } from \"./annotation-command.js\";\nimport { runNext, type NextRecommendation, type NextOptions } from \"./next.js\";\n\n/** Stable warning/error code for an exhausted atomic next-work walk. */\nexport const NO_AVAILABLE_NEXT_ITEM_CODE = \"no_available_next_item\";\n\n/** Documents the claim result payload exchanged by command, SDK, and package integrations. */\nexport interface ClaimResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports claimed by for this contract. */\n  claimed_by: string;\n  /** Value that configures or reports previous assignee for this contract. */\n  previous_assignee: string | null;\n  /** Value that configures or reports forced for this contract. */\n  forced: boolean;\n  /** Value that configures or reports skipped for this contract. */\n  skipped?: boolean;\n  /** Value that configures or reports warnings for this contract. */\n  warnings?: string[];\n}\n\n/** Result of atomically selecting and claiming the next caller-available item. */\nexport interface ClaimNextAvailableResult extends ClaimResult {\n  /** True when an actionable candidate was claimed. */\n  available: true;\n  /** Value that configures or reports recommendation for this contract. */\n  recommendation: NextRecommendation;\n  /** Value that configures or reports attempts for this contract. */\n  attempts: number;\n}\n\n/** Non-error empty result returned when an if-available candidate walk is exhausted. */\nexport interface ClaimNextUnavailableResult {\n  /** Indicates that no candidate remained claimable. */\n  available: false;\n  /** Empty item projection for a deliberately unavailable selection. */\n  item: null;\n  /** Caller identity that attempted the selection. */\n  claimed_by: string;\n  /** No previous owner exists for an empty selection. */\n  previous_assignee: null;\n  /** Whether forced selection was requested. */\n  forced: boolean;\n  /** Signals a deliberate non-error skip. */\n  skipped: true;\n  /** No recommendation survived the bounded walk. */\n  recommendation: null;\n  /** Number of ranked candidates attempted. */\n  attempts: number;\n  /** Stable machine-readable exhaustion warning. */\n  warnings: [typeof NO_AVAILABLE_NEXT_ITEM_CODE];\n}\n\n/** Result of a successful or deliberately empty atomic next-work claim. */\nexport type ClaimNextResult =\n  | ClaimNextAvailableResult\n  | ClaimNextUnavailableResult;\n\n/** Returns whether a failed claim lost the atomic test-and-set race. */\nexport function isAlreadyClaimedError(error: unknown): boolean {\n  return (\n    error instanceof PmCliError && error.context?.code === \"already_claimed_by\"\n  );\n}\n\ntype ClaimRunner = (\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions,\n) => Promise<ClaimResult>;\n\n/** Documents the release result payload exchanged by command, SDK, and package integrations. */\nexport interface ReleaseResult {\n  /** Value that configures or reports item for this contract. */\n  item: Record<string, unknown>;\n  /** Value that configures or reports released by for this contract. */\n  released_by: string;\n  /** Value that configures or reports previous assignee for this contract. */\n  previous_assignee: string | null;\n  /** Value that configures or reports audit release for this contract. */\n  audit_release: boolean;\n  /** Value that configures or reports forced for this contract. */\n  forced: boolean;\n}\n\n/** Documents the claim mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface ClaimMutationOptions {\n  /** Value that configures or reports author for this contract. */\n  author?: string;\n  /** Human-readable explanation suitable for logs and agent-facing output. */\n  message?: string;\n  /** Value that configures or reports if available for this contract. */\n  ifAvailable?: boolean;\n  /** Maximum ranked candidates attempted by `claim --next`. */\n  maxAttempts?: string | number;\n}\n\n/** Documents the release mutation options payload exchanged by command, SDK, and package integrations. */\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  /** Value that configures or reports allow audit release for this contract. */\n  allowAuditRelease?: boolean;\n}\n\n/** Implements run claim for the public runtime surface of this module. */\nexport async function runClaim(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n): Promise<ClaimResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n  let skipped = false;\n  const mutationWarnings: string[] = [];\n\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: \"claim\",\n    author,\n    message: options.message,\n    force,\n    skipNoop: true,\n    mutate(document) {\n      const currentAssignee = document.metadata.assignee;\n      const currentAssigneeText =\n        typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n      previousAssignee =\n        currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n      if (\n        statusIsTerminal(document.metadata.status, statusRegistry) &&\n        !force\n      ) {\n        throw new PmCliError(\n          `Cannot claim terminal item ${document.metadata.id} without --force`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      const heldByOther =\n        previousAssignee !== null && previousAssignee !== author;\n      if (heldByOther && options.ifAvailable === true) {\n        skipped = true;\n        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);\n        return { changedFields: [] };\n      }\n      if (heldByOther && !force) {\n        throw new PmCliError(\n          `Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`,\n          EXIT_CODE.CONFLICT,\n          {\n            code: \"already_claimed_by\",\n            why: \"Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.\",\n            nextSteps: [\n              \"Run pm next to pick a different unclaimed item.\",\n              \"Re-run with --if-available to treat a held item as a no-op skip.\",\n              \"Re-run with --force only when taking over the item is coordinated.\",\n            ],\n          },\n        );\n      }\n      if (heldByOther) {\n        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);\n      }\n      document.metadata.assignee = author;\n      return { changedFields: [\"assignee\"], warnings: mutationWarnings };\n    },\n  });\n\n  return {\n    item: toItemRecord(result.item),\n    claimed_by:\n      skipped && previousAssignee !== null ? previousAssignee : author,\n    previous_assignee: previousAssignee,\n    forced: force,\n    ...(skipped ? { skipped: true } : {}),\n    ...(mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}),\n  };\n}\n\n/** Selects ranked actionable work and claims the first candidate still available under the item lock. Conflicts caused by parallel claimers advance to the next candidate instead of returning a thundering-herd failure. */\nexport async function runClaimNext(\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n  nextOptions: NextOptions = {},\n): Promise<ClaimNextResult> {\n  const maxAttempts = parseClaimNextAttempts(options.maxAttempts);\n  const settings = await readSettings(resolvePmRoot(process.cwd(), global.path));\n  const claimOptions = {\n    ...options,\n    author: resolveAuthor(options.author, settings.author_default),\n  };\n  const next = await runNext(\n    {\n      ...nextOptions,\n      callerAuthor: claimOptions.author,\n      limit: String(maxAttempts),\n    },\n    global,\n  );\n  const recommendations = [next.recommended, ...next.ready]\n    .filter((entry): entry is NextRecommendation => entry !== null)\n    .map((entry) => ({\n      ...entry,\n      reasons: \"reasons\" in entry ? entry.reasons : [\"ranked ready candidate\"],\n    }));\n  return claimNextFromRecommendations(\n    recommendations.slice(0, maxAttempts),\n    force,\n    global,\n    claimOptions,\n  );\n}\n\n/** Parses the bounded candidate walk used by `claim --next`. */\nexport function parseClaimNextAttempts(raw: string | number | undefined): number {\n  if (raw === undefined) return 10;\n  const parsed = Number(raw);\n  if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 100) {\n    throw new PmCliError(\n      \"--max-attempts must be an integer from 1 to 100\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  return parsed;\n}\n\n/** Claims the first still-available row from a pre-ranked recommendation set. */\nexport async function claimNextFromRecommendations(\n  recommendations: NextRecommendation[],\n  force: boolean,\n  global: GlobalOptions,\n  options: ClaimMutationOptions = {},\n  claimRunner: ClaimRunner = runClaim,\n): Promise<ClaimNextResult> {\n  let attempts = 0;\n  for (const recommendation of recommendations) {\n    attempts += 1;\n    try {\n      const claimed = await claimRunner(\n        recommendation.id,\n        force,\n        global,\n        options,\n      );\n      const result = { ...claimed, recommendation, attempts, available: true as const };\n      if (!claimed.skipped) return result;\n    } catch (error: unknown) {\n      if (!isAlreadyClaimedError(error)) throw error;\n    }\n  }\n  if (options.ifAvailable === true) {\n    return {\n      available: false,\n      item: null,\n      claimed_by: options.author ?? process.env.PM_AUTHOR ?? \"unknown\",\n      previous_assignee: null,\n      forced: force,\n      skipped: true,\n      recommendation: null,\n      attempts,\n      warnings: [NO_AVAILABLE_NEXT_ITEM_CODE],\n    };\n  }\n  const noCandidatesMatched = attempts === 0;\n  throw new PmCliError(\n    noCandidatesMatched\n      ? \"No actionable items matched the selection filters\"\n      : \"No actionable item remained available to claim\",\n    noCandidatesMatched ? EXIT_CODE.NOT_FOUND : EXIT_CODE.CONFLICT,\n    {\n      code: NO_AVAILABLE_NEXT_ITEM_CODE,\n      why: noCandidatesMatched\n        ? \"No ready items matched the specified filters or selection criteria.\"\n        : \"Every ranked candidate was claimed by another agent before this atomic selection completed.\",\n      nextSteps: [\n        noCandidatesMatched\n          ? \"Verify the filters or run pm next to inspect all ready work.\"\n          : \"Run pm claim --next again to refresh the ranked candidate set.\",\n      ],\n    },\n  );\n}\n\n/** Implements run release for the public runtime surface of this module. */\nexport async function runRelease(\n  id: string,\n  force: boolean,\n  global: GlobalOptions,\n  options: ReleaseMutationOptions = {},\n): Promise<ReleaseResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n  const settings = await readSettings(pmRoot);\n  const author = resolveAuthor(options.author, settings.author_default);\n  let previousAssignee: string | null = null;\n\n  let result: Awaited<ReturnType<typeof mutateItem>>;\n  try {\n    result = await mutateItem({\n      pmRoot,\n      settings,\n      id,\n      op: \"release\",\n      author,\n      message: options.message,\n      force,\n      bypassAssigneeConflict: Boolean(options.allowAuditRelease),\n      mutate(document) {\n        previousAssignee = document.metadata.assignee ?? null;\n        if (!previousAssignee) {\n          return { changedFields: [] };\n        }\n        delete document.metadata.assignee;\n        return { changedFields: [\"assignee\"] };\n      },\n    });\n  } catch (error: unknown) {\n    wrapOwnershipConflict(error, {\n      required:\n        \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: [\n        'pm release pm-a1b2 --author \"reviewer\" --allow-audit-release',\n      ],\n      nextSteps: [\n        \"Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.\",\n        \"Use --force only when an explicit override is approved for broader ownership conflicts.\",\n      ],\n    });\n  }\n\n  return {\n    item: toItemRecord(result.item),\n    released_by: author,\n    previous_assignee: previousAssignee,\n    audit_release: options.allowAuditRelease === true,\n    forced: force,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"c0e18740-ab85-5611-94aa-3e49751f63d0"}

package/dist/cli/commands/completion.js

@@ -4,7 +4,7 @@
  * Implements the pm completion 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]="cbbd277f-b6c7-5852-9b91-19df2baa0f03")}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]="cd8e131d-bdef-5850-9a84-d9784c113804")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { SCAFFOLD_CAPABILITIES } from "./extension/scaffold.js";
@@ -1501,6 +1501,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]'
           ;;
@@ -2651,4 +2660,4 @@ export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansio
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=cbbd277f-b6c7-5852-9b91-19df2baa0f03
+//# debugId=cd8e131d-bdef-5850-9a84-d9784c113804