@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/chunk-LP3HSFZ2.js

@@ -0,0 +1,140 @@
+
+!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]="2ff57283-3b10-516c-ac69-0ad3bb9ba425")}catch(e){}}();
+import {
+  wrapOwnershipConflict
+} from "./chunk-EKFNL33R.js";
+import {
+  resolveAuthor
+} from "./chunk-T5RRNDA7.js";
+import {
+  mutateItem,
+  toItemRecord
+} from "./chunk-ENGQOEUY.js";
+import {
+  PmCliError,
+  readSettings
+} from "./chunk-E3SZTQ4K.js";
+import {
+  EXIT_CODE,
+  getSettingsPath,
+  pathExists,
+  resolvePmRoot,
+  resolveRuntimeStatusRegistry,
+  statusIsTerminal
+} from "./chunk-57NWPFF2.js";
+
+// dist/cli/commands/claim.js
+async function runClaim(id, force, global, options = {}) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const author = resolveAuthor(options.author, settings.author_default);
+  let previousAssignee = null;
+  let skipped = false;
+  const mutationWarnings = [];
+  const result = await mutateItem({
+    pmRoot,
+    settings,
+    id,
+    op: "claim",
+    author,
+    message: options.message,
+    force,
+    skipNoop: true,
+    mutate(document) {
+      const currentAssignee = document.metadata.assignee;
+      const currentAssigneeText = typeof currentAssignee === "string" ? currentAssignee : "";
+      previousAssignee = currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;
+      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {
+        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);
+      }
+      const heldByOther = previousAssignee !== null && previousAssignee !== author;
+      if (heldByOther && options.ifAvailable === true) {
+        skipped = true;
+        mutationWarnings.push(`claim_skipped_held_by:${previousAssignee}`);
+        return { changedFields: [] };
+      }
+      if (heldByOther && !force) {
+        throw new PmCliError(`Item ${document.metadata.id} is already claimed by ${previousAssignee}. Use --force to take over, or --if-available to skip without failing.`, EXIT_CODE.CONFLICT, {
+          code: "already_claimed_by",
+          why: "Claim is an atomic test-and-set so parallel agents never proceed believing they own the same item.",
+          nextSteps: [
+            "Run pm next to pick a different unclaimed item.",
+            "Re-run with --if-available to treat a held item as a no-op skip.",
+            "Re-run with --force only when taking over the item is coordinated."
+          ]
+        });
+      }
+      if (heldByOther) {
+        mutationWarnings.push(`claim_takeover:${previousAssignee}->${author}`);
+      }
+      document.metadata.assignee = author;
+      return { changedFields: ["assignee"], warnings: mutationWarnings };
+    }
+  });
+  return {
+    item: toItemRecord(result.item),
+    claimed_by: skipped && previousAssignee !== null ? previousAssignee : author,
+    previous_assignee: previousAssignee,
+    forced: force,
+    ...skipped ? { skipped: true } : {},
+    ...mutationWarnings.length > 0 ? { warnings: mutationWarnings } : {}
+  };
+}
+async function runRelease(id, force, global, options = {}) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const author = resolveAuthor(options.author, settings.author_default);
+  let previousAssignee = null;
+  let result;
+  try {
+    result = await mutateItem({
+      pmRoot,
+      settings,
+      id,
+      op: "release",
+      author,
+      message: options.message,
+      force,
+      bypassAssigneeConflict: Boolean(options.allowAuditRelease),
+      mutate(document) {
+        previousAssignee = document.metadata.assignee ?? null;
+        if (!previousAssignee) {
+          return { changedFields: [] };
+        }
+        delete document.metadata.assignee;
+        return { changedFields: ["assignee"] };
+      }
+    });
+  } catch (error) {
+    wrapOwnershipConflict(error, {
+      required: "For audited non-owner handoffs, prefer --allow-audit-release before considering --force.",
+      examples: ['pm release pm-a1b2 --author "reviewer" --allow-audit-release'],
+      nextSteps: [
+        "Use --allow-audit-release for append-only release handoffs that only clear assignee metadata.",
+        "Use --force only when an explicit override is approved for broader ownership conflicts."
+      ]
+    });
+  }
+  return {
+    item: toItemRecord(result.item),
+    released_by: author,
+    previous_assignee: previousAssignee,
+    audit_release: options.allowAuditRelease === true,
+    forced: force
+  };
+}
+
+export {
+  runClaim,
+  runRelease
+};
+//# sourceMappingURL=chunk-LP3HSFZ2.js.map
+
+//# debugId=2ff57283-3b10-516c-ac69-0ad3bb9ba425

package/dist/cli-bundle/chunks/chunk-LP3HSFZ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/claim.ts"],"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 { resolveRuntimeStatusRegistry, statusIsTerminal } 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\";\n\n/**\n * Documents the claim result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ClaimResult {\n  item: Record<string, unknown>;\n  claimed_by: string;\n  previous_assignee: string | null;\n  forced: boolean;\n  skipped?: boolean;\n  warnings?: string[];\n}\n\n/**\n * Documents the release result payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReleaseResult {\n  item: Record<string, unknown>;\n  released_by: string;\n  previous_assignee: string | null;\n  audit_release: boolean;\n  forced: boolean;\n}\n\n/**\n * Documents the claim mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ClaimMutationOptions {\n  author?: string;\n  message?: string;\n  ifAvailable?: boolean;\n}\n\n/**\n * Documents the release mutation options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ReleaseMutationOptions extends ClaimMutationOptions {\n  allowAuditRelease?: boolean;\n}\n\n/**\n * Implements run claim for the public runtime surface of this module.\n */\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\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 = typeof currentAssignee === \"string\" ? currentAssignee : \"\";\n      previousAssignee = currentAssigneeText.trim().length > 0 ? currentAssigneeText : null;\n      if (statusIsTerminal(document.metadata.status, statusRegistry) && !force) {\n        throw new PmCliError(`Cannot claim terminal item ${document.metadata.id} without --force`, EXIT_CODE.CONFLICT);\n      }\n      const heldByOther = 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: 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/**\n * Implements run release for the public runtime surface of this module.\n */\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(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\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: \"For audited non-owner handoffs, prefer --allow-audit-release before considering --force.\",\n      examples: ['pm release pm-a1b2 --author \"reviewer\" --allow-audit-release'],\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":"2ff57283-3b10-516c-ac69-0ad3bb9ba425"}