@unbrained/pm-cli 2026.7.4 → 2026.7.5

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

@@ -0,0 +1,241 @@
+import {
+  PmCliError
+} from "./chunk-P5YORJRH.js";
+import {
+  EXIT_CODE,
+  isPathWithinDirectory,
+  pathExists
+} from "./chunk-5VVUKE3U.js";
+
+// dist/core/packages/manifest.js
+import fs from "node:fs/promises";
+import path from "node:path";
+!(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] = "7abddddb-c56b-5fe9-9516-908b8fbc75db");
+  } catch (e2) {
+  }
+})();
+var PM_PACKAGE_RESOURCE_KINDS = [
+  "extensions",
+  "docs",
+  "examples",
+  "assets",
+  "prompts"
+];
+var PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS = Object.freeze({
+  extensions: Object.freeze([
+    ".agents/pm/extensions",
+    "extensions",
+    ".custom/pm-extensions",
+    ".custom/pm-extension"
+  ]),
+  docs: Object.freeze([
+    "docs",
+    "documentation"
+  ]),
+  examples: Object.freeze([
+    "examples",
+    "docs/examples"
+  ]),
+  assets: Object.freeze([
+    "assets",
+    ".agents/pm/assets"
+  ]),
+  prompts: Object.freeze([
+    "prompts",
+    ".agents/pm/prompts"
+  ])
+});
+function isKnownPackageResourceKind(value) {
+  return PM_PACKAGE_RESOURCE_KINDS.includes(value);
+}
+function normalizePackageResourceEntries(kind, raw) {
+  if (raw === void 0 || raw === null) {
+    return [];
+  }
+  const entries = Array.isArray(raw) ? raw : [raw];
+  const normalized = [];
+  for (const entry of entries) {
+    if (typeof entry !== "string" || entry.trim().length === 0) {
+      throw new PmCliError(`Package manifest field pm.${kind} must contain string paths.`, EXIT_CODE.USAGE);
+    }
+    normalized.push(entry.trim());
+  }
+  return [...new Set(normalized)].sort((left, right) => left.localeCompare(right));
+}
+function normalizePackageResourceMap(raw) {
+  if (raw === void 0 || raw === null) {
+    return {};
+  }
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    throw new PmCliError("Package manifest field pm must be an object.", EXIT_CODE.USAGE);
+  }
+  const resources = {};
+  const candidate = raw;
+  for (const [key, value] of Object.entries(candidate)) {
+    if (!isKnownPackageResourceKind(key)) {
+      continue;
+    }
+    const entries = normalizePackageResourceEntries(key, value);
+    if (entries.length > 0) {
+      resources[key] = entries;
+    }
+  }
+  return resources;
+}
+function readStringField(source, key) {
+  const value = source[key];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function normalizeStringArray(raw) {
+  if (!Array.isArray(raw)) {
+    return void 0;
+  }
+  const values = raw.map((value) => typeof value === "string" ? value.trim() : "").filter((value) => value.length > 0);
+  return values.length > 0 ? [...new Set(values)].sort((left, right) => left.localeCompare(right)) : void 0;
+}
+function readUrlLikeField(raw) {
+  if (typeof raw === "string" && raw.trim().length > 0) {
+    return raw.trim();
+  }
+  if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+    const value = raw.url;
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+  }
+  return void 0;
+}
+function normalizeCatalogLinks(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return void 0;
+  }
+  const source = raw;
+  const links = {
+    docs: readStringField(source, "docs"),
+    npm: readStringField(source, "npm"),
+    repository: readStringField(source, "repository"),
+    report: readStringField(source, "report")
+  };
+  return Object.values(links).some((value) => typeof value === "string") ? links : void 0;
+}
+function normalizeCatalogMedia(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return void 0;
+  }
+  const source = raw;
+  const media = {
+    image: readStringField(source, "image"),
+    video: readStringField(source, "video")
+  };
+  return Object.values(media).some((value) => typeof value === "string") ? media : void 0;
+}
+function normalizePackageCatalogMetadata(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return void 0;
+  }
+  const source = raw;
+  const catalog = {
+    display_name: readStringField(source, "display_name") ?? readStringField(source, "displayName"),
+    category: readStringField(source, "category"),
+    summary: readStringField(source, "summary"),
+    links: normalizeCatalogLinks(source.links),
+    media: normalizeCatalogMedia(source.media),
+    tags: normalizeStringArray(source.tags)
+  };
+  return Object.values(catalog).some((value) => value !== void 0) ? catalog : void 0;
+}
+async function readPmPackageManifest(packageRoot) {
+  const packageJsonPath = path.join(packageRoot, "package.json");
+  if (!await pathExists(packageJsonPath)) {
+    return {
+      source: "convention",
+      resources: {}
+    };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  } catch (error) {
+    throw new PmCliError(`Failed to parse package manifest at "${packageJsonPath}": ${String(error)}`, EXIT_CODE.USAGE);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new PmCliError(`Package manifest at "${packageJsonPath}" must be a JSON object.`, EXIT_CODE.USAGE);
+  }
+  const packageJson = parsed;
+  const pmManifest = packageJson.pm;
+  const hasPmManifest = pmManifest !== void 0 && pmManifest !== null;
+  const pmManifestRecord = typeof pmManifest === "object" && pmManifest !== null && !Array.isArray(pmManifest) ? pmManifest : {};
+  return {
+    source: hasPmManifest ? "pm" : "convention",
+    package_json_path: packageJsonPath,
+    package_name: typeof packageJson.name === "string" ? packageJson.name : void 0,
+    package_version: typeof packageJson.version === "string" ? packageJson.version : void 0,
+    package_private: packageJson.private === true,
+    package_description: typeof packageJson.description === "string" ? packageJson.description : void 0,
+    package_keywords: normalizeStringArray(packageJson.keywords),
+    package_homepage: typeof packageJson.homepage === "string" ? packageJson.homepage : void 0,
+    package_repository_url: readUrlLikeField(packageJson.repository),
+    package_bugs_url: readUrlLikeField(packageJson.bugs),
+    aliases: normalizeStringArray(pmManifestRecord.aliases),
+    resources: normalizePackageResourceMap(pmManifest),
+    catalog: normalizePackageCatalogMetadata(pmManifestRecord.catalog)
+  };
+}
+async function listExtensionManifestDirectories(parentDirectory) {
+  if (!await pathExists(parentDirectory)) {
+    return [];
+  }
+  const entries = await fs.readdir(parentDirectory, { withFileTypes: true });
+  const candidates = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const directory = path.join(parentDirectory, entry.name);
+    if (await pathExists(path.join(directory, "manifest.json"))) {
+      candidates.push(directory);
+    }
+  }
+  return candidates.sort((left, right) => left.localeCompare(right));
+}
+async function collectPackageExtensionDirectories(packageRoot) {
+  if (await pathExists(path.join(packageRoot, "manifest.json"))) {
+    return [packageRoot];
+  }
+  const manifest = await readPmPackageManifest(packageRoot);
+  const manifestEntries = manifest.resources.extensions ?? [];
+  const discovered = /* @__PURE__ */ new Set();
+  for (const entry of manifestEntries) {
+    if (entry.includes("*") || entry.startsWith("!")) {
+      throw new PmCliError(`Package extension entry "${entry}" uses a glob/exclusion pattern. pm package installs currently require concrete extension paths or directories.`, EXIT_CODE.USAGE);
+    }
+    const absolute = path.resolve(packageRoot, entry);
+    if (!isPathWithinDirectory(packageRoot, absolute)) {
+      throw new PmCliError(`Package extension entry "${entry}" resolves outside package root.`, EXIT_CODE.USAGE);
+    }
+    if (await pathExists(path.join(absolute, "manifest.json"))) {
+      discovered.add(absolute);
+      continue;
+    }
+    for (const child of await listExtensionManifestDirectories(absolute)) {
+      discovered.add(child);
+    }
+  }
+  if (manifestEntries.length === 0) {
+    for (const root of PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS.extensions) {
+      for (const child of await listExtensionManifestDirectories(path.join(packageRoot, root))) {
+        discovered.add(child);
+      }
+    }
+  }
+  return [...discovered].sort((left, right) => left.localeCompare(right));
+}
+
+export {
+  PM_PACKAGE_RESOURCE_KINDS,
+  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,
+  readPmPackageManifest,
+  collectPackageExtensionDirectories
+};
+//# sourceMappingURL=chunk-ZVDL32GJ.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/packages/manifest.ts"],
+  "sourcesContent": ["/**\n * @module core/packages/manifest\n *\n * Discovers and validates pm package manifests for Manifest.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../fs/path-utils.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nexport const PM_PACKAGE_RESOURCE_KINDS = [\n  \"extensions\",\n  \"docs\",\n  \"examples\",\n  \"assets\",\n  \"prompts\",\n] as const;\n\n/**\n * Restricts pm package resource kind values accepted by command, SDK, and storage contracts.\n */\nexport type PmPackageResourceKind = (typeof PM_PACKAGE_RESOURCE_KINDS)[number];\n\n/**\n * Restricts pm package resource map values accepted by command, SDK, and storage contracts.\n */\nexport type PmPackageResourceMap = Partial<Record<PmPackageResourceKind, string[]>>;\n\n/**\n * Documents the pm package catalog link map payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmPackageCatalogLinkMap {\n  docs?: string;\n  npm?: string;\n  repository?: string;\n  report?: string;\n}\n\n/**\n * Documents the pm package catalog media map payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmPackageCatalogMediaMap {\n  image?: string;\n  video?: string;\n}\n\n/**\n * Documents the pm package catalog metadata payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmPackageCatalogMetadata {\n  display_name?: string;\n  category?: string;\n  summary?: string;\n  links?: PmPackageCatalogLinkMap;\n  media?: PmPackageCatalogMediaMap;\n  tags?: string[];\n}\n\n/**\n * Documents the pm package manifest payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmPackageManifest {\n  source: \"pm\" | \"convention\";\n  package_json_path?: string;\n  package_name?: string;\n  package_version?: string;\n  package_private?: boolean;\n  package_description?: string;\n  package_keywords?: string[];\n  package_homepage?: string;\n  package_repository_url?: string;\n  package_bugs_url?: string;\n  aliases?: string[];\n  resources: PmPackageResourceMap;\n  catalog?: PmPackageCatalogMetadata;\n}\n\nexport const PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS: Readonly<Record<PmPackageResourceKind, readonly string[]>> =\n  Object.freeze({\n    extensions: Object.freeze([\n      \".agents/pm/extensions\",\n      \"extensions\",\n      \".custom/pm-extensions\",\n      \".custom/pm-extension\",\n    ]),\n    docs: Object.freeze([\n      \"docs\",\n      \"documentation\",\n    ]),\n    examples: Object.freeze([\n      \"examples\",\n      \"docs/examples\",\n    ]),\n    assets: Object.freeze([\n      \"assets\",\n      \".agents/pm/assets\",\n    ]),\n    prompts: Object.freeze([\n      \"prompts\",\n      \".agents/pm/prompts\",\n    ]),\n  });\n\nfunction isKnownPackageResourceKind(value: string): value is PmPackageResourceKind {\n  return (PM_PACKAGE_RESOURCE_KINDS as readonly string[]).includes(value);\n}\n\nfunction normalizePackageResourceEntries(kind: PmPackageResourceKind, raw: unknown): string[] {\n  if (raw === undefined || raw === null) {\n    return [];\n  }\n  const entries = Array.isArray(raw) ? raw : [raw];\n  const normalized: string[] = [];\n  for (const entry of entries) {\n    if (typeof entry !== \"string\" || entry.trim().length === 0) {\n      throw new PmCliError(`Package manifest field pm.${kind} must contain string paths.`, EXIT_CODE.USAGE);\n    }\n    normalized.push(entry.trim());\n  }\n  return [...new Set(normalized)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction normalizePackageResourceMap(raw: unknown): PmPackageResourceMap {\n  if (raw === undefined || raw === null) {\n    return {};\n  }\n  if (typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new PmCliError(\"Package manifest field pm must be an object.\", EXIT_CODE.USAGE);\n  }\n  const resources: PmPackageResourceMap = {};\n  const candidate = raw as Record<string, unknown>;\n  for (const [key, value] of Object.entries(candidate)) {\n    if (!isKnownPackageResourceKind(key)) {\n      continue;\n    }\n    const entries = normalizePackageResourceEntries(key, value);\n    if (entries.length > 0) {\n      resources[key] = entries;\n    }\n  }\n  return resources;\n}\n\nfunction readStringField(source: Record<string, unknown>, key: string): string | undefined {\n  const value = source[key];\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction normalizeStringArray(raw: unknown): string[] | undefined {\n  if (!Array.isArray(raw)) {\n    return undefined;\n  }\n  const values = raw\n    .map((value) => typeof value === \"string\" ? value.trim() : \"\")\n    .filter((value) => value.length > 0);\n  return values.length > 0 ? [...new Set(values)].sort((left, right) => left.localeCompare(right)) : undefined;\n}\n\nfunction readUrlLikeField(raw: unknown): string | undefined {\n  if (typeof raw === \"string\" && raw.trim().length > 0) {\n    return raw.trim();\n  }\n  if (typeof raw === \"object\" && raw !== null && !Array.isArray(raw)) {\n    const value = (raw as Record<string, unknown>).url;\n    return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n  }\n  return undefined;\n}\n\nfunction normalizeCatalogLinks(raw: unknown): PmPackageCatalogLinkMap | undefined {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    return undefined;\n  }\n  const source = raw as Record<string, unknown>;\n  const links: PmPackageCatalogLinkMap = {\n    docs: readStringField(source, \"docs\"),\n    npm: readStringField(source, \"npm\"),\n    repository: readStringField(source, \"repository\"),\n    report: readStringField(source, \"report\"),\n  };\n  return Object.values(links).some((value) => typeof value === \"string\") ? links : undefined;\n}\n\nfunction normalizeCatalogMedia(raw: unknown): PmPackageCatalogMediaMap | undefined {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    return undefined;\n  }\n  const source = raw as Record<string, unknown>;\n  const media: PmPackageCatalogMediaMap = {\n    image: readStringField(source, \"image\"),\n    video: readStringField(source, \"video\"),\n  };\n  return Object.values(media).some((value) => typeof value === \"string\") ? media : undefined;\n}\n\nfunction normalizePackageCatalogMetadata(raw: unknown): PmPackageCatalogMetadata | undefined {\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    return undefined;\n  }\n  const source = raw as Record<string, unknown>;\n  const catalog: PmPackageCatalogMetadata = {\n    display_name: readStringField(source, \"display_name\") ?? readStringField(source, \"displayName\"),\n    category: readStringField(source, \"category\"),\n    summary: readStringField(source, \"summary\"),\n    links: normalizeCatalogLinks(source.links),\n    media: normalizeCatalogMedia(source.media),\n    tags: normalizeStringArray(source.tags),\n  };\n  return Object.values(catalog).some((value) => value !== undefined) ? catalog : undefined;\n}\n\n/**\n * Implements read pm package manifest for the public runtime surface of this module.\n */\nexport async function readPmPackageManifest(packageRoot: string): Promise<PmPackageManifest> {\n  const packageJsonPath = path.join(packageRoot, \"package.json\");\n  if (!(await pathExists(packageJsonPath))) {\n    return {\n      source: \"convention\",\n      resources: {},\n    };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Failed to parse package manifest at \"${packageJsonPath}\": ${String(error)}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new PmCliError(`Package manifest at \"${packageJsonPath}\" must be a JSON object.`, EXIT_CODE.USAGE);\n  }\n\n  const packageJson = parsed as Record<string, unknown>;\n  const pmManifest = packageJson.pm;\n  const hasPmManifest = pmManifest !== undefined && pmManifest !== null;\n  const pmManifestRecord = typeof pmManifest === \"object\" && pmManifest !== null && !Array.isArray(pmManifest)\n    ? pmManifest as Record<string, unknown>\n    : {};\n  return {\n    source: hasPmManifest ? \"pm\" : \"convention\",\n    package_json_path: packageJsonPath,\n    package_name: typeof packageJson.name === \"string\" ? packageJson.name : undefined,\n    package_version: typeof packageJson.version === \"string\" ? packageJson.version : undefined,\n    package_private: packageJson.private === true,\n    package_description: typeof packageJson.description === \"string\" ? packageJson.description : undefined,\n    package_keywords: normalizeStringArray(packageJson.keywords),\n    package_homepage: typeof packageJson.homepage === \"string\" ? packageJson.homepage : undefined,\n    package_repository_url: readUrlLikeField(packageJson.repository),\n    package_bugs_url: readUrlLikeField(packageJson.bugs),\n    aliases: normalizeStringArray(pmManifestRecord.aliases),\n    resources: normalizePackageResourceMap(pmManifest),\n    catalog: normalizePackageCatalogMetadata(pmManifestRecord.catalog),\n  };\n}\n\nasync function listExtensionManifestDirectories(parentDirectory: string): Promise<string[]> {\n  if (!(await pathExists(parentDirectory))) {\n    return [];\n  }\n  const entries = await fs.readdir(parentDirectory, { withFileTypes: true });\n  const candidates: string[] = [];\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n    const directory = path.join(parentDirectory, entry.name);\n    if (await pathExists(path.join(directory, \"manifest.json\"))) {\n      candidates.push(directory);\n    }\n  }\n  return candidates.sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Implements collect package extension directories for the public runtime surface of this module.\n */\nexport async function collectPackageExtensionDirectories(packageRoot: string): Promise<string[]> {\n  if (await pathExists(path.join(packageRoot, \"manifest.json\"))) {\n    return [packageRoot];\n  }\n\n  const manifest = await readPmPackageManifest(packageRoot);\n  const manifestEntries = manifest.resources.extensions ?? [];\n  const discovered = new Set<string>();\n\n  for (const entry of manifestEntries) {\n    if (entry.includes(\"*\") || entry.startsWith(\"!\")) {\n      throw new PmCliError(\n        `Package extension entry \"${entry}\" uses a glob/exclusion pattern. pm package installs currently require concrete extension paths or directories.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const absolute = path.resolve(packageRoot, entry);\n    if (!isPathWithinDirectory(packageRoot, absolute)) {\n      throw new PmCliError(`Package extension entry \"${entry}\" resolves outside package root.`, EXIT_CODE.USAGE);\n    }\n    if (await pathExists(path.join(absolute, \"manifest.json\"))) {\n      discovered.add(absolute);\n      continue;\n    }\n    for (const child of await listExtensionManifestDirectories(absolute)) {\n      discovered.add(child);\n    }\n  }\n\n  if (manifestEntries.length === 0) {\n    for (const root of PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS.extensions) {\n      for (const child of await listExtensionManifestDirectories(path.join(packageRoot, root))) {\n        discovered.add(child);\n      }\n    }\n  }\n\n  return [...discovered].sort((left, right) => left.localeCompare(right));\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cli-bundle/chunks/{claim-D6L33A5Y.js → claim-4DROPSIS.js}

@@ -1,29 +1,32 @@
 
-!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]="230791bf-0057-5639-aad3-2bb852119f5e")}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]="17de491f-f579-5c44-8876-71e6393cb1da")}catch(e){}}();
 import {
   wrapOwnershipConflict
-} from "./chunk-V655JQ5J.js";
+} from "./chunk-JLA7EVYV.js";
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
-import "./chunk-3C5T3ZEO.js";
-import "./chunk-NHKXOMZ5.js";
+import "./chunk-7WYXBPYQ.js";
+import "./chunk-YFIE7YK6.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-UYLA5ROU.js";
-import "./chunk-AOP2EMK3.js";
-import "./chunk-FMWQRMHS.js";
+} from "./chunk-57C2RLW5.js";
+import "./chunk-HK72NWAD.js";
+import "./chunk-FJRKQREY.js";
 import {
-  EXIT_CODE,
   PmCliError,
+  readSettings
+} from "./chunk-US3T3W5J.js";
+import "./chunk-NNHHXJB2.js";
+import {
+  EXIT_CODE,
   getSettingsPath,
   pathExists,
-  readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   statusIsTerminal
-} from "./chunk-SL2ANJSV.js";
+} from "./chunk-YD5FML7K.js";
 
 // dist/cli/commands/claim.js
 async function runClaim(id, force, global, options = {}) {
@@ -45,8 +48,11 @@ async function runClaim(id, force, global, options = {}) {
     author,
     message: options.message,
     force,
+    skipNoop: true,
     mutate(document) {
-      previousAssignee = document.metadata.assignee ?? null;
+      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);
       }
@@ -56,6 +62,17 @@ async function runClaim(id, force, global, options = {}) {
         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}`);
       }
@@ -122,6 +139,6 @@ export {
   runClaim,
   runRelease
 };
-//# sourceMappingURL=claim-D6L33A5Y.js.map
+//# sourceMappingURL=claim-4DROPSIS.js.map
 
-//# debugId=230791bf-0057-5639-aad3-2bb852119f5e
+//# debugId=17de491f-f579-5c44-8876-71e6393cb1da

package/dist/cli-bundle/chunks/claim-4DROPSIS.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":"17de491f-f579-5c44-8876-71e6393cb1da"}

package/dist/cli-bundle/chunks/{claim-YAFUTPVK.js → claim-VX54TV5U.js}

@@ -1,33 +1,36 @@
 import {
   wrapOwnershipConflict
-} from "./chunk-XBIYI23P.js";
+} from "./chunk-5J2XPTAD.js";
 import {
   resolveAuthor
 } from "./chunk-WW4E2DC3.js";
-import "./chunk-N2LOJUBB.js";
-import "./chunk-3MLQZI3H.js";
+import "./chunk-T3ABIMGW.js";
+import "./chunk-EEY54JMF.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-CN4OAA2G.js";
-import "./chunk-CQFZRLXQ.js";
-import "./chunk-MZG6I2Q2.js";
+} from "./chunk-3U3VEWK6.js";
+import "./chunk-EZFKWSC7.js";
+import "./chunk-DRBV5UC2.js";
 import {
-  EXIT_CODE,
   PmCliError,
+  readSettings
+} from "./chunk-P5YORJRH.js";
+import "./chunk-7C2O74AE.js";
+import {
+  EXIT_CODE,
   getSettingsPath,
   pathExists,
-  readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   statusIsTerminal
-} from "./chunk-BDDYM4LH.js";
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/claim.js
 !(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] = "57172a1c-6f59-512b-a3cd-907ed169e861");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a652eb69-9925-57a5-9c26-602cfb588a03");
   } catch (e2) {
   }
 })();
@@ -50,8 +53,11 @@ async function runClaim(id, force, global2, options = {}) {
     author,
     message: options.message,
     force,
+    skipNoop: true,
     mutate(document) {
-      previousAssignee = document.metadata.assignee ?? null;
+      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);
       }
@@ -61,6 +67,17 @@ async function runClaim(id, force, global2, options = {}) {
         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}`);
       }
@@ -127,4 +144,4 @@ export {
   runClaim,
   runRelease
 };
-//# sourceMappingURL=claim-YAFUTPVK.js.map
+//# sourceMappingURL=claim-VX54TV5U.js.map

package/dist/cli-bundle/chunks/claim-VX54TV5U.js.map

@@ -0,0 +1,7 @@
+{
+  "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"],
+  "mappings": "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",
+  "names": ["global"]
+}

package/dist/cli-bundle/chunks/{close-TGYXG7TV.js → close-3YRR3XY6.js}

@@ -3,16 +3,18 @@
 import {
   _testOnlyCloseCommand,
   runClose
-} from "./chunk-WBWRQS32.js";
-import "./chunk-4EVY7CQN.js";
-import "./chunk-UYLA5ROU.js";
-import "./chunk-AOP2EMK3.js";
-import "./chunk-FMWQRMHS.js";
-import "./chunk-SL2ANJSV.js";
+} from "./chunk-K3AGVXSF.js";
+import "./chunk-N6DNM2FA.js";
+import "./chunk-57C2RLW5.js";
+import "./chunk-HK72NWAD.js";
+import "./chunk-FJRKQREY.js";
+import "./chunk-US3T3W5J.js";
+import "./chunk-NNHHXJB2.js";
+import "./chunk-YD5FML7K.js";
 export {
   _testOnlyCloseCommand,
   runClose
 };
-//# sourceMappingURL=close-TGYXG7TV.js.map
+//# sourceMappingURL=close-3YRR3XY6.js.map
 
 //# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/close-OB2Y4QP5.js

@@ -0,0 +1,16 @@
+import {
+  _testOnlyCloseCommand,
+  runClose
+} from "./chunk-FGQKEDE4.js";
+import "./chunk-YOF5VPKM.js";
+import "./chunk-3U3VEWK6.js";
+import "./chunk-EZFKWSC7.js";
+import "./chunk-DRBV5UC2.js";
+import "./chunk-P5YORJRH.js";
+import "./chunk-7C2O74AE.js";
+import "./chunk-5VVUKE3U.js";
+export {
+  _testOnlyCloseCommand,
+  runClose
+};
+//# sourceMappingURL=close-OB2Y4QP5.js.map

package/dist/cli-bundle/chunks/{close-many-SNA6LNZH.js → close-many-AP4MWU36.js}

@@ -1,53 +1,56 @@
 
-!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]="2a91a002-c3ac-5ecc-8196-c2070529b3e8")}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]="36947f0b-c1fc-5c0e-8d0e-bd968315cecc")}catch(e){}}();
 import {
   createCheckpointId,
   loadMutationCheckpoint,
   restoreCheckpointItems,
   writeMutationCheckpoint
-} from "./chunk-T5RTYLZJ.js";
+} from "./chunk-S5AYOUT5.js";
 import {
   runRestore
-} from "./chunk-OTSP6UEX.js";
+} from "./chunk-HBYZDSK5.js";
 import {
   resolveAuthor
 } from "./chunk-T5RRNDA7.js";
+import "./chunk-T3F4DF23.js";
+import "./chunk-BFVHCAOO.js";
 import {
   runClose
-} from "./chunk-WBWRQS32.js";
+} from "./chunk-K3AGVXSF.js";
 import {
   hasListFilters
 } from "./chunk-VY3VQ22F.js";
-import "./chunk-4EVY7CQN.js";
-import "./chunk-FDNJMYZB.js";
-import "./chunk-Y2VSCQ77.js";
+import "./chunk-N6DNM2FA.js";
 import {
   runList
-} from "./chunk-4IW7STMB.js";
+} from "./chunk-YSAH5FY5.js";
 import "./chunk-QB7XMHJW.js";
-import "./chunk-4SHME4VR.js";
-import "./chunk-NHKXOMZ5.js";
+import "./chunk-5JE6SMYS.js";
+import "./chunk-YFIE7YK6.js";
 import {
   listAllFrontMatterLight
-} from "./chunk-UYLA5ROU.js";
+} from "./chunk-57C2RLW5.js";
 import {
   isTerminalStatus
-} from "./chunk-AOP2EMK3.js";
+} from "./chunk-HK72NWAD.js";
 import {
   nowIso
-} from "./chunk-FMWQRMHS.js";
+} from "./chunk-FJRKQREY.js";
 import {
-  EXIT_CODE,
   PmCliError,
   getActiveExtensionRegistrations,
+  readSettings
+} from "./chunk-US3T3W5J.js";
+import "./chunk-NNHHXJB2.js";
+import {
+  EXIT_CODE,
   getSettingsPath,
   pathExists,
-  readSettings,
   resolveItemTypeRegistry,
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   toErrorMessage
-} from "./chunk-SL2ANJSV.js";
+} from "./chunk-YD5FML7K.js";
 
 // dist/cli/commands/close-many.js
 var CLOSE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
@@ -389,6 +392,6 @@ export {
   _testOnly,
   runCloseMany
 };
-//# sourceMappingURL=close-many-SNA6LNZH.js.map
+//# sourceMappingURL=close-many-AP4MWU36.js.map
 
-//# debugId=2a91a002-c3ac-5ecc-8196-c2070529b3e8
+//# debugId=36947f0b-c1fc-5c0e-8d0e-bd968315cecc