@unbrained/pm-cli 2026.7.6 → 2026.7.8

package/dist/cli-bundle/chunks/{chunk-COSPOP7H.js → chunk-3FRNNVWY.js}

@@ -1,146 +1,131 @@
 import {
-  runValidate
-} from "./chunk-Y6BK55A3.js";
-import {
-  runGc
-} from "./chunk-QX6HM775.js";
-import {
-  runContracts
-} from "./chunk-5GZ7TDD6.js";
+  runFiles,
+  runFilesDiscover
+} from "./chunk-D6J5673C.js";
 import {
-  runClaim,
-  runRelease
-} from "./chunk-PZUGEOPS.js";
+  runDocs
+} from "./chunk-KFL3XHMA.js";
 import {
-  resolveStartTaskInProgressStatus
-} from "./chunk-Z3U3U5KD.js";
+  runDeps
+} from "./chunk-MCH6IKK7.js";
 import {
   assertHistoryRepairTarget,
   runHistoryRepair,
   runHistoryRepairAll
-} from "./chunk-7D7OOEYG.js";
+} from "./chunk-FJR2S7S4.js";
 import {
-  runTestAll
-} from "./chunk-XDB7RWQT.js";
-import {
-  runTest
-} from "./chunk-C5JBZRPU.js";
+  resolveStartTaskInProgressStatus,
+  runClaim,
+  runContracts,
+  runGc,
+  runHealth,
+  runRelease,
+  runStats,
+  runTelemetry,
+  runTest,
+  runTestAll,
+  runValidate
+} from "./chunk-ASMRSIDX.js";
 import {
-  runTelemetry
-} from "./chunk-IQNVQHOP.js";
+  runComments
+} from "./chunk-EEJKHF7M.js";
 import {
-  runStats
-} from "./chunk-4HIFVN7N.js";
+  runCopy
+} from "./chunk-FFB3WITE.js";
 import {
-  runHealth
-} from "./chunk-N745W3B3.js";
+  runFocus
+} from "./chunk-7TBUV7XS.js";
 import {
   runDelete
-} from "./chunk-NB7RLQFW.js";
+} from "./chunk-UH6VFRV6.js";
 import {
   runAppend
-} from "./chunk-XHET7YUZ.js";
+} from "./chunk-GSQVQINP.js";
 import {
   runProfileApply,
   runProfileLint,
   runProfileList,
   runProfileShow
-} from "./chunk-3N6RRO2Q.js";
+} from "./chunk-MYHFZNBO.js";
 import {
   runNotes
-} from "./chunk-NO442GWJ.js";
+} from "./chunk-QJZM5WO5.js";
 import {
   runLearnings
-} from "./chunk-HIHMT6WS.js";
-import {
-  runFiles,
-  runFilesDiscover
-} from "./chunk-RCQZK2GO.js";
-import {
-  runDocs
-} from "./chunk-R5BMJX33.js";
+} from "./chunk-WVEMZZCR.js";
 import {
-  runDeps
-} from "./chunk-M7JNBQAD.js";
+  runCloseMany
+} from "./chunk-YQEKE4FO.js";
 import {
   runUpdateMany
-} from "./chunk-NZEHECMW.js";
+} from "./chunk-EYPIUFWJ.js";
+import {
+  runRestore
+} from "./chunk-NGBWEYNY.js";
 import {
   runUpdate
-} from "./chunk-3UJRFJ5R.js";
+} from "./chunk-DUBC6TI3.js";
+import {
+  runClose
+} from "./chunk-RDJXIAJB.js";
 import {
   runPlan
-} from "./chunk-E42XTBSP.js";
+} from "./chunk-SN5X5GTU.js";
 import {
   runHistoryCompact
-} from "./chunk-SQOIV3OQ.js";
+} from "./chunk-UIHDZS6X.js";
 import {
   runHistoryRedact
-} from "./chunk-MA4SM3QZ.js";
+} from "./chunk-K52C6YPA.js";
 import {
-  runComments
-} from "./chunk-NC33K5ZS.js";
+  runConfig,
+  runUpgrade
+} from "./chunk-P2WE5KCU.js";
 import {
-  runCopy
-} from "./chunk-4ZBE5GUN.js";
+  SCAFFOLD_CAPABILITIES,
+  runExtension,
+  runInit
+} from "./chunk-FL625JJM.js";
 import {
-  runFocus
-} from "./chunk-MVSP7WGJ.js";
+  runSchemaAddField,
+  runSchemaAddStatus,
+  runSchemaAddType,
+  runSchemaApplyPreset,
+  runSchemaInferTypes,
+  runSchemaList,
+  runSchemaListFields,
+  runSchemaRemoveField,
+  runSchemaRemoveStatus,
+  runSchemaRemoveType,
+  runSchemaShow,
+  runSchemaShowField,
+  runSchemaShowStatus
+} from "./chunk-UURYLDDC.js";
 import {
   jaccardSimilarity,
   normalizeLowercaseWhitespace,
+  runActivity,
+  runAggregate,
+  runContext,
+  runGet,
+  runNext,
   runSearch,
   tokenizeAlphaNumeric
-} from "./chunk-3KTN6IBA.js";
-import {
-  runGet
-} from "./chunk-RQLT6ZWB.js";
-import {
-  runCreate
-} from "./chunk-SCUR7K7N.js";
-import {
-  parseTags
-} from "./chunk-AZYGZGGI.js";
-import {
-  runCloseMany
-} from "./chunk-ZJ262CED.js";
-import {
-  runClose
-} from "./chunk-W3DSJQIO.js";
-import {
-  runRestore
-} from "./chunk-6LLVNJXT.js";
-import {
-  runUpgrade
-} from "./chunk-HN6NSXNW.js";
-import {
-  runAggregate
-} from "./chunk-KERMZVY5.js";
-import {
-  buildListQueryFilters
-} from "./chunk-4BU75MF4.js";
-import {
-  runNext
-} from "./chunk-ZO3XKAOP.js";
-import {
-  runContext
-} from "./chunk-MR6FJ7LL.js";
+} from "./chunk-TTCJCKUJ.js";
 import {
+  buildListQueryFilters,
   runList
-} from "./chunk-46CUF5L6.js";
-import {
-  runActivity
-} from "./chunk-2XG4IZON.js";
+} from "./chunk-RLHQ3G4M.js";
 import {
   runHistory
-} from "./chunk-L5PSPMZ4.js";
+} from "./chunk-LHDHS4Z6.js";
 import {
   parseIntegerLimit
-} from "./chunk-7DT4WSH2.js";
+} from "./chunk-BFNFTHWQ.js";
 import {
-  normalizeListOptions,
-  normalizeUpdateOptions
-} from "./chunk-T42JWV3F.js";
+  resolveRegisteredSearchProvider,
+  resolveRegisteredVectorStoreAdapter
+} from "./chunk-B5KXLBSJ.js";
 import {
   REINDEX_LOCK_ID,
   buildSearchCorpus,
@@ -154,6 +139,8 @@ import {
   hasVectorizationEmbeddingIdentityChanged,
   hasVectorizationVectorDimensionChanged,
   inferConsistentVectorDimension,
+  normalizeListOptions,
+  normalizeUpdateOptions,
   readVectorizationStatusLedger,
   resolveEmbeddingProviders,
   resolveSearchCorpusFields,
@@ -161,26 +148,7 @@ import {
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores,
   writeVectorizationStatusLedger
-} from "./chunk-ZSUS2OD3.js";
-import {
-  projectMutationResult
-} from "./chunk-VPIM42PC.js";
-import {
-  resolveRegisteredSearchProvider,
-  resolveRegisteredVectorStoreAdapter
-} from "./chunk-B5KXLBSJ.js";
-import {
-  runInit
-} from "./chunk-GZRDYONU.js";
-import {
-  runExtension
-} from "./chunk-COWTDV6B.js";
-import {
-  SCAFFOLD_CAPABILITIES
-} from "./chunk-JQXPY7DN.js";
-import {
-  splitCommaList
-} from "./chunk-5HIZDR5A.js";
+} from "./chunk-PJPZTE7P.js";
 import {
   ACTIVITY_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -213,60 +181,48 @@ import {
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   toCompletionFlagString
-} from "./chunk-VIIUS6N6.js";
+} from "./chunk-TR2C6V5T.js";
 import {
-  runSchemaAddField,
-  runSchemaAddStatus,
-  runSchemaAddType,
-  runSchemaApplyPreset,
-  runSchemaInferTypes,
-  runSchemaList,
-  runSchemaListFields,
-  runSchemaRemoveField,
-  runSchemaRemoveStatus,
-  runSchemaRemoveType,
-  runSchemaShow,
-  runSchemaShowField,
-  runSchemaShowStatus
-} from "./chunk-W572BIEB.js";
+  runCreate
+} from "./chunk-XPSGJ4IV.js";
+import {
+  parseTags
+} from "./chunk-CGDUIPJL.js";
 import {
+  splitCommaList
+} from "./chunk-5HIZDR5A.js";
+import {
+  projectMutationResult
+} from "./chunk-C6XSTACC.js";
+import {
+  PmCliError,
   acquireLock,
   appendHistoryEntry,
   collectRegisteredItemFieldNames,
+  compareTimestampStrings,
   createHistoryEntry,
+  getActiveExtensionRegistrations,
+  isTerminalStatus,
   listAllDocumentCandidatesCached,
   locateItem,
-  readLocatedItem,
-  toItemRecord
-} from "./chunk-5VAA4YHR.js";
-import {
-  runConfig
-} from "./chunk-W6DYWXPQ.js";
-import {
-  isTerminalStatus,
   normalizeStatusInput,
+  nowIso,
   parseItemDocument,
-  serializeItemDocument
-} from "./chunk-NMP5I3I5.js";
-import {
-  compareTimestampStrings,
-  nowIso
-} from "./chunk-FLZSGSQR.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
+  readLocatedItem,
   readSettings,
   runActiveCommandHandler,
   runActiveOnIndexHooks,
   runActiveOnWriteHooks,
+  serializeItemDocument,
   setActiveExtensionCommands,
   setActiveExtensionHooks,
   setActiveExtensionParsers,
   setActiveExtensionPreflight,
   setActiveExtensionRegistrations,
   setActiveExtensionRenderers,
-  setActiveExtensionServices
-} from "./chunk-SHQY2IDC.js";
+  setActiveExtensionServices,
+  toItemRecord
+} from "./chunk-BPJ5NYSJ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -293,7 +249,7 @@ import {
   toErrorMessage,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-LK6XLOGP.js";
+} from "./chunk-2BVD4ZD2.js";
 
 // dist/sdk/runtime.js
 import path3 from "node:path";
@@ -1422,7 +1378,7 @@ function renderGuideMarkdown(result) {
 !(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] = "c5c33ca2-acd6-55cc-8bf9-de815086e990");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6aac8389-5103-50a6-98bd-fde0720289ba");
   } catch (e2) {
   }
 })();
@@ -2921,6 +2877,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--trace[Include registration traces in doctor deep diagnostics]' \\
             '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
             '--fix-managed-state[Adopt unmanaged extensions before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope extensions only]' \\
+            '--ignore-global[Alias for --isolated]' \\
             '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
             '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
             '--json[Output JSON]' \\
@@ -2959,6 +2917,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--trace[Include registration traces in doctor deep diagnostics]' \\
             '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
             '--fix-managed-state[Adopt unmanaged packages before diagnostics/update checks]' \\
+            '--isolated[Run doctor against project-scope packages only]' \\
+            '--ignore-global[Alias for --isolated]' \\
             '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
             '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
             '--json[Output JSON]' \\
@@ -3857,6 +3817,8 @@ complete -c pm -n '__fish_seen_subcommand_from extension' -l detail -d 'Detail m
 complete -c pm -n '__fish_seen_subcommand_from extension' -l trace -d 'Include registration traces in doctor deep diagnostics'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l fix-managed-state -d 'Adopt unmanaged extensions before diagnostics/update checks'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l isolated -d 'Run doctor against project-scope extensions only'
+complete -c pm -n '__fish_seen_subcommand_from extension' -l ignore-global -d 'Alias for --isolated'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
 complete -c pm -n '__fish_seen_subcommand_from extension' -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
 
@@ -3892,6 +3854,8 @@ for package_cmd in package packages
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l trace -d 'Include registration traces in doctor deep diagnostics'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fix-managed-state -d 'Adopt unmanaged packages before diagnostics/update checks'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l isolated -d 'Run doctor against project-scope packages only'
+  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ignore-global -d 'Alias for --isolated'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
 end`;
@@ -4014,16 +3978,16 @@ function buildCommentsAuditSummary(items) {
     entry.comments_exported += item.comments.length;
     byTypeAccumulator.set(item.type, entry);
   }
-  const byType = [...byTypeAccumulator.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([type, stats]) => {
-    const zeroCount = stats.items_scanned - stats.items_with_comments;
-    const coverage = ratioPercent(stats.items_with_comments, stats.items_scanned);
+  const byType = [...byTypeAccumulator.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([type, stats2]) => {
+    const zeroCount = stats2.items_scanned - stats2.items_with_comments;
+    const coverage = ratioPercent(stats2.items_with_comments, stats2.items_scanned);
     return {
       type,
-      items_scanned: stats.items_scanned,
-      items_with_comments: stats.items_with_comments,
+      items_scanned: stats2.items_scanned,
+      items_with_comments: stats2.items_with_comments,
       zero_comment_items: zeroCount,
-      comments_total: stats.comments_total,
-      comments_exported: stats.comments_exported,
+      comments_total: stats2.comments_total,
+      comments_exported: stats2.comments_exported,
       items_with_comments_ratio: coverage.ratio,
       items_with_comments_percent: coverage.percent
     };
@@ -4543,17 +4507,17 @@ async function applyDedupeMergeReparents(params) {
 }
 async function applyDedupeMergeClose(params) {
   const reason = `Duplicate of ${params.keep}`;
-  const close = { duplicate_of: params.keep, reason, applied: false };
+  const close2 = { duplicate_of: params.keep, reason, applied: false };
   if (isTerminalStatus(params.duplicate.metadata.status, params.statusRegistry)) {
-    close.skipped_reason = "already_terminal";
+    close2.skipped_reason = "already_terminal";
     if (params.duplicate.metadata.duplicate_of?.trim() !== params.keep) {
       params.warnings.push(`close_skipped_terminal:${params.duplicate.id}:already_closed`);
     }
-    return close;
+    return close2;
   }
   if (!params.apply) {
-    close.skipped_reason = "dry_run";
-    return close;
+    close2.skipped_reason = "dry_run";
+    return close2;
   }
   try {
     await runClose(params.duplicate.id, void 0, {
@@ -4561,12 +4525,12 @@ async function applyDedupeMergeClose(params) {
       author: params.options.author,
       message: params.options.message ?? `dedupe-merge: close ${params.duplicate.id} as duplicate of ${params.keep}`
     }, params.global);
-    close.applied = true;
+    close2.applied = true;
   } catch (error) {
-    close.skipped_reason = "failed";
+    close2.skipped_reason = "failed";
     params.warnings.push(`close_failed:${params.duplicate.id}:${error instanceof Error ? error.message : String(error)}`);
   }
-  return close;
+  return close2;
 }
 async function runDedupeMerge(options, global2) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
@@ -4613,14 +4577,14 @@ async function runDedupeMerge(options, global2) {
       global: global2,
       warnings
     });
-    const close = await applyDedupeMergeClose({ duplicate, keep, apply, options, global: global2, statusRegistry, warnings });
+    const close2 = await applyDedupeMergeClose({ duplicate, keep, apply, options, global: global2, statusRegistry, warnings });
     outcomes.push({
       duplicate_id: duplicate.id,
       duplicate_title: duplicate.title,
       canonical_id: keep,
       reparented_children: reparented,
       skipped_children: skippedChildren,
-      close
+      close: close2
     });
   }
   const childrenReparented = outcomes.reduce((total, outcome) => total + outcome.reparented_children.filter((child) => child.applied).length, 0);
@@ -4931,7 +4895,7 @@ import path2 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] = "0b364753-7767-5ef6-9ce6-18c79d6c47c7");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7fc8eb46-f035-5bfa-bacd-90d176ad4e2b");
   } catch (e2) {
   }
 })();
@@ -5067,9 +5031,9 @@ function resolveExtensionVectorAdapter(settings) {
     ...typeof deleteHandler === "function" ? { delete: deleteHandler } : {}
   };
 }
-function assertVector(value, context) {
+function assertVector(value, context2) {
   if (!Array.isArray(value) || value.some((entry) => typeof entry !== "number" || !Number.isFinite(entry))) {
-    throw new PmCliError(`Invalid vector returned by ${context}`, EXIT_CODE.GENERIC_FAILURE);
+    throw new PmCliError(`Invalid vector returned by ${context2}`, EXIT_CODE.GENERIC_FAILURE);
   }
   return value;
 }
@@ -5238,7 +5202,7 @@ function assertSemanticRuntimeAvailable(params) {
   if (!providerResolution.active && !params.extensionEmbedding) {
     throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured embedding provider in settings.providers.openai/settings.providers.ollama or an extension provider selected by settings.search.provider`, EXIT_CODE.USAGE);
   }
-  const vectorResolution = resolveVectorStores(params.settings);
+  const vectorResolution = resolveVectorStores(params.settings, params.pmRoot);
   if (!vectorResolution.active && !params.extensionVectorAdapter) {
     throw new PmCliError(`Reindex mode '${params.requestedMode}' requires a configured vector store in settings.vector_store.qdrant/settings.vector_store.lancedb or an extension adapter selected by settings.vector_store.adapter`, EXIT_CODE.USAGE);
   }
@@ -5509,6 +5473,7 @@ async function runReindex(options, global2) {
     const extensionVectorAdapter = resolveExtensionVectorAdapter(settings);
     const semanticRuntime = assertSemanticRuntimeAvailable({
       requestedMode,
+      pmRoot,
       settings,
       extensionEmbedding,
       extensionVectorAdapter
@@ -5601,7 +5566,7 @@ async function runReindex(options, global2) {
 !(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] = "86af7c43-06f8-5e32-87ee-676c070b7e71");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6781d5a3-3e21-5198-a534-fb2be114b6e1");
   } catch (e2) {
   }
 })();
@@ -5632,40 +5597,61 @@ var PmClient = class {
   run(action, args = {}) {
     return runAction({ ...this.defaults, ...args, action });
   }
+  runTyped(action, args = {}) {
+    return this.run(action, args);
+  }
   /**
    * Return the same context snapshot produced by `pm context`.
    */
   context(options = {}) {
-    return this.run("context", { options });
+    return this.runTyped("context", { options });
   }
   /**
    * List items with the MCP/agent compact defaults.
    */
   list(options = {}) {
-    return this.run("list", { options });
+    return this.runTyped("list", { options });
   }
   /**
    * Search items with the MCP/agent compact defaults.
    */
   search(query, options = {}) {
-    return this.run("search", { query, options });
+    return this.runTyped("search", { query, options });
   }
   /**
    * Read one item by id.
    */
   get(id, options = {}) {
-    return this.run("get", { id, options });
+    return this.runTyped("get", { id, options });
+  }
+  /**
+   * Return the ranked next-work recommendation produced by `pm next`.
+   */
+  next(options = {}) {
+    return this.runTyped("next", { options });
+  }
+  /**
+   * Group matching items with the same semantics as `pm aggregate`.
+   */
+  aggregate(options = {}) {
+    return this.runTyped("aggregate", { options });
+  }
+  /**
+   * Return project tracker statistics with the same sections as `pm stats`.
+   */
+  stats(options = {}) {
+    return this.runTyped("stats", { options });
   }
   /**
    * Create an item using the same mutation path as `pm create`.
    */
-  create(options) {
+  create(options = {}) {
     return this.run("create", splitClientMutationOptions(options));
   }
   /**
    * Update an item using the same mutation path as `pm update`.
    */
-  update(id, options) {
+  update(id, options = {}) {
     return this.run("update", { id, ...splitClientMutationOptions(options) });
   }
   /**
@@ -5674,7 +5660,271 @@ var PmClient = class {
   close(id, reason, options = {}) {
     return this.run("close", { id, reason, ...splitClientMutationOptions(options) });
   }
+  /**
+   * Claim an item using the same mutation path as `pm claim`.
+   */
+  claim(id, options = {}) {
+    return this.run("claim", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Release an item's active claim using the same mutation path as `pm release`.
+   */
+  release(id, options = {}) {
+    return this.run("release", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Copy an item using the same mutation path as `pm copy`.
+   */
+  copy(id, options = {}) {
+    return this.run("copy", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Delete an item using the same mutation path as `pm delete`.
+   */
+  delete(id, options = {}) {
+    return this.run("delete", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Restore an item to a history version or timestamp using `pm restore`.
+   */
+  restore(id, target, options = {}) {
+    const { fullChangedFields, idOnly, ...runnerOptions } = options;
+    return this.run("restore", {
+      ...fullChangedFields === void 0 ? {} : { fullChangedFields },
+      ...idOnly === void 0 ? {} : { idOnly },
+      id,
+      options: { ...runnerOptions, target }
+    });
+  }
+  /**
+   * Set, clear, or read workspace focus using the same path as `pm focus`.
+   */
+  focus(id, options = {}) {
+    return this.run("focus", { ...id === void 0 ? {} : { id }, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Claim an item and transition it to the workspace in-progress status.
+   */
+  startTask(id, options = {}) {
+    return this.run("start-task", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Move an item back to the workspace open status and release the claim.
+   */
+  pauseTask(id, options = {}) {
+    return this.run("pause-task", { id, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Close an item and release its active assignment.
+   */
+  closeTask(id, reason, options = {}) {
+    return this.run("close-task", { id, reason, ...splitClientMutationOptions(options) });
+  }
+  /**
+   * Run the extension lifecycle surface with the same result shape as `pm extension`.
+   */
+  extension(target, options = {}) {
+    return this.runTyped("extension", { ...target === void 0 ? {} : { target }, options });
+  }
+  /**
+   * List project or global extensions without constructing command-line argv.
+   */
+  extensionList(options = {}) {
+    return this.extension("list", options);
+  }
+  /**
+   * Enable an installed extension using the same action as `pm extension activate`.
+   */
+  extensionActivate(target, options = {}) {
+    return this.runTyped("extension-activate", { target, options });
+  }
+  /**
+   * Disable an installed extension using the same action as `pm extension deactivate`.
+   */
+  extensionDeactivate(target, options = {}) {
+    return this.runTyped("extension-deactivate", { target, options });
+  }
+  /**
+   * Run the package lifecycle surface with package vocabulary preserved.
+   */
+  package(target, options = {}) {
+    return this.runTyped("package", {
+      ...target === void 0 ? {} : { target },
+      options: { ...options, vocabulary: "package" }
+    });
+  }
+  /**
+   * List project or global packages through the package lifecycle primitive.
+   */
+  packageList(options = {}) {
+    return this.package("list", options);
+  }
+  /**
+   * Install a package or extension source using the same action as `pm package install`.
+   */
+  packageInstall(target, options = {}) {
+    return this.runTyped("package-install", { target, options });
+  }
+  /**
+   * Uninstall a package or extension using the same action as `pm package uninstall`.
+   */
+  packageUninstall(target, options = {}) {
+    return this.runTyped("package-uninstall", { target, options });
+  }
+  /**
+   * Read package lifecycle diagnostics using the same action as `pm package doctor`.
+   */
+  packageDoctor(options = {}) {
+    return this.runTyped("package-doctor", { options });
+  }
+  /**
+   * Inspect managed package state using the same action as `pm package manage`.
+   */
+  packageManage(target, options = {}) {
+    return this.runTyped("package-manage", { ...target === void 0 ? {} : { target }, options });
+  }
+  /**
+   * Describe installed package surfaces using the same action as `pm package describe`.
+   */
+  packageDescribe(target, options = {}) {
+    return this.runTyped("package-describe", { ...target === void 0 ? {} : { target }, options });
+  }
+  /**
+   * Reload installed package extensions using the same action as `pm package reload`.
+   */
+  packageReload(options = {}) {
+    return this.runTyped("package-reload", { options });
+  }
+  /**
+   * Read bundled package catalog metadata using the same action as `pm package catalog`.
+   */
+  packageCatalog(options = {}) {
+    return this.runTyped("package-catalog", { options });
+  }
+  /**
+   * Enable an installed package using the same action as `pm package activate`.
+   */
+  packageActivate(target, options = {}) {
+    return this.runTyped("package-activate", { target, options });
+  }
+  /**
+   * Disable an installed package using the same action as `pm package deactivate`.
+   */
+  packageDeactivate(target, options = {}) {
+    return this.runTyped("package-deactivate", { target, options });
+  }
+  /**
+   * Upgrade the pm CLI and/or managed packages through the public SDK dispatcher.
+   */
+  upgrade(target, options = {}) {
+    return this.runTyped("upgrade", { ...target === void 0 ? {} : { target }, options });
+  }
 };
+function context(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).context(options);
+}
+function list(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).list(options);
+}
+function search(query, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).search(query, options);
+}
+function get(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).get(id, options);
+}
+function next(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).next(options);
+}
+function aggregate(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).aggregate(options);
+}
+function stats(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).stats(options);
+}
+function create(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).create(options);
+}
+function update(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).update(id, options);
+}
+function close(id, reason, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).close(id, reason, options);
+}
+function claim(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).claim(id, options);
+}
+function release(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).release(id, options);
+}
+function copy(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).copy(id, options);
+}
+function deleteItem(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).delete(id, options);
+}
+function restore(id, target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).restore(id, target, options);
+}
+function focus(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).focus(id, options);
+}
+function startTask(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).startTask(id, options);
+}
+function pauseTask(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).pauseTask(id, options);
+}
+function closeTask(id, reason, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).closeTask(id, reason, options);
+}
+function extension(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).extension(target, options);
+}
+function extensionList(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).extensionList(options);
+}
+function extensionActivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).extensionActivate(target, options);
+}
+function extensionDeactivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).extensionDeactivate(target, options);
+}
+function packageLifecycle(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).package(target, options);
+}
+function packageList(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageList(options);
+}
+function packageInstall(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageInstall(target, options);
+}
+function packageUninstall(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageUninstall(target, options);
+}
+function packageDoctor(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDoctor(options);
+}
+function packageManage(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageManage(target, options);
+}
+function packageDescribe(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDescribe(target, options);
+}
+function packageReload(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageReload(options);
+}
+function packageCatalog(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageCatalog(options);
+}
+function packageActivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageActivate(target, options);
+}
+function packageDeactivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDeactivate(target, options);
+}
+function upgrade(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).upgrade(target, options);
+}
 function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd) {
   return JSON.stringify([
     path3.resolve(pmRoot),
@@ -5779,6 +6029,13 @@ var ARRAY_ADD_REMOVE_ACTIONS = /* @__PURE__ */ new Set([
   "test",
   "test-all"
 ]);
+var LIFECYCLE_AUTHOR_ALIAS_ACTIONS = /* @__PURE__ */ new Set([
+  "claim",
+  "release",
+  "start-task",
+  "pause-task",
+  "close-task"
+]);
 function normalizeMcpOptionsArrays(options, action) {
   const result = {};
   const promoteAddRemove = action !== void 0 && ARRAY_ADD_REMOVE_ACTIONS.has(action);
@@ -5823,6 +6080,16 @@ function optionsWithAuthor(args, action) {
     hoistKey("priority");
     hoistKey("limit");
   } else if (action === "create") {
+    hoistKey("title");
+    hoistKey("type");
+    hoistKey("status");
+    hoistKey("description");
+    hoistKey("body");
+    hoistKey("priority");
+    hoistKey("tags");
+    hoistKey("parent");
+    hoistKey("createMode");
+    hoistKey("create_mode");
     hoistKey("allowMissingParent");
   } else if (action === "close") {
     hoistKey("duplicateOf");
@@ -5831,27 +6098,34 @@ function optionsWithAuthor(args, action) {
   }
   const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
   const author = readString(args, "author");
-  return author && options.author === void 0 ? { ...options, author } : options;
+  const authorFromAssignee = action !== void 0 && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readString(args, "assignee") ?? readString(options, "assignee") : void 0;
+  if (author && options.author === void 0) {
+    return { ...options, author };
+  }
+  if (authorFromAssignee && options.author === void 0) {
+    return { ...options, author: authorFromAssignee };
+  }
+  return options;
 }
 function withAddNoteOption(options) {
   if (options.addNote === void 0) {
     return options;
   }
-  const next = { ...options };
-  if (next.note === void 0 && typeof next.addNote === "string") {
-    next.note = next.addNote;
+  const next2 = { ...options };
+  if (next2.note === void 0 && typeof next2.addNote === "string") {
+    next2.note = next2.addNote;
   }
-  delete next.addNote;
-  return next;
+  delete next2.addNote;
+  return next2;
 }
 function withFilesDiscoveryOptions(options) {
-  const next = { ...options };
-  if (next.discoveryNote !== void 0 && next.note === void 0 && typeof next.discoveryNote === "string") {
-    next.note = next.discoveryNote;
+  const next2 = { ...options };
+  if (next2.discoveryNote !== void 0 && next2.note === void 0 && typeof next2.discoveryNote === "string") {
+    next2.note = next2.discoveryNote;
   }
-  delete next.discover;
-  delete next.discoveryNote;
-  return next;
+  delete next2.discover;
+  delete next2.discoveryNote;
+  return next2;
 }
 function normalizeActionName(value) {
   const chunks = [];
@@ -6060,14 +6334,14 @@ var UPDATE_MANY_FLAT_CONTROL_KEYS = /* @__PURE__ */ new Set([
   "no_checkpoint"
 ]);
 function updateManyUpdateOptionsFromFlat(options) {
-  const update = {};
+  const update2 = {};
   for (const [key, value] of Object.entries(options)) {
     if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {
       continue;
     }
-    update[key] = value;
+    update2[key] = value;
   }
-  return normalizeMcpUpdateOptions(update);
+  return normalizeMcpUpdateOptions(update2);
 }
 function normalizeMcpUpdateOptions(options) {
   const normalizedInput = normalizeMcpOptionsArrays(options, "update-many");
@@ -6173,6 +6447,9 @@ function resolveSdkActionInput(args) {
   if (alias?.options !== void 0) {
     resolvedArgs.options = { ...alias.options, ...asRecordClone(args.options) };
   }
+  if (action === "package") {
+    resolvedArgs.options = { ...asRecordClone(resolvedArgs.options), vocabulary: "package" };
+  }
   return { action, args: resolvedArgs };
 }
 function shouldInvalidateWorkspaceContractsCacheAfterAction(action) {
@@ -6498,7 +6775,17 @@ async function runMcpCloseManyAction(ctx) {
   return projectMutationResult(await runCloseMany(closeManyOptionsFromFlat(closeManyRunnerOptions), ctx.global), { changedFields });
 }
 async function runMcpRestoreAction(ctx) {
-  return runRestore(requireMcpItemId(ctx), readRequiredString(ctx.options, "target"), ctx.options, ctx.global);
+  const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
+  const target = readString(runnerOptions, "target") ?? readRequiredString(ctx.args, "target");
+  return projectMutationResult(await runRestore(requireMcpItemId(ctx, runnerOptions), target, runnerOptions, ctx.global), {
+    changedFields,
+    idOnly
+  });
+}
+function withoutLifecycleAssigneeAlias(options) {
+  const updateOptions = { ...options };
+  delete updateOptions.assignee;
+  return updateOptions;
 }
 async function runMcpStartTaskAction(ctx) {
   const pmRoot = resolvePmRoot(process.cwd(), ctx.global.path);
@@ -6506,7 +6793,7 @@ async function runMcpStartTaskAction(ctx) {
   const inProgressStatus = resolveStartTaskInProgressStatus(resolveRuntimeStatusRegistry(settings.schema));
   const id = requireMcpItemId(ctx);
   const claimResult = await runClaim(id, ctx.force, ctx.global, ctx.options);
-  const updateResult = await runUpdate(id, { ...ctx.options, status: inProgressStatus, force: ctx.force }, ctx.global);
+  const updateResult = await runUpdate(id, { ...withoutLifecycleAssigneeAlias(ctx.options), status: inProgressStatus, force: ctx.force }, ctx.global);
   return { id, action: "start_task", claim: claimResult, update: updateResult };
 }
 async function runMcpPauseTaskAction(ctx) {
@@ -6514,7 +6801,7 @@ async function runMcpPauseTaskAction(ctx) {
   const settings = await readSettings(pmRoot);
   const id = requireMcpItemId(ctx);
   const openStatus = resolveRuntimeStatusRegistry(settings.schema).open_status;
-  const updateResult = await runUpdate(id, { ...ctx.options, status: openStatus, force: ctx.force }, ctx.global);
+  const updateResult = await runUpdate(id, { ...withoutLifecycleAssigneeAlias(ctx.options), status: openStatus, force: ctx.force }, ctx.global);
   const releaseResult = await runRelease(id, ctx.force, ctx.global, ctx.options);
   return { id, action: "pause_task", update: updateResult, release: releaseResult };
 }
@@ -6669,9 +6956,44 @@ export {
   runNormalize,
   runReindex,
   PmClient,
+  context,
+  list,
+  search,
+  get,
+  next,
+  aggregate,
+  stats,
+  create,
+  update,
+  close,
+  claim,
+  release,
+  copy,
+  deleteItem,
+  restore,
+  focus,
+  startTask,
+  pauseTask,
+  closeTask,
+  extension,
+  extensionList,
+  extensionActivate,
+  extensionDeactivate,
+  packageLifecycle,
+  packageList,
+  packageInstall,
+  packageUninstall,
+  packageDoctor,
+  packageManage,
+  packageDescribe,
+  packageReload,
+  packageCatalog,
+  packageActivate,
+  packageDeactivate,
+  upgrade,
   getWorkspaceContracts,
   getContracts,
   readRequiredString,
   runAction
 };
-//# sourceMappingURL=chunk-COSPOP7H.js.map
+//# sourceMappingURL=chunk-3FRNNVWY.js.map