@unbrained/pm-cli 2026.7.6 → 2026.7.8

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

@@ -1,140 +0,0 @@
-
-!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

@@ -1 +0,0 @@
-{"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"}