@unbrained/pm-cli 2026.7.8 → 2026.7.10

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

@@ -1,18 +1,18 @@
 import {
   runFiles,
   runFilesDiscover
-} from "./chunk-D6J5673C.js";
+} from "./chunk-4BINCIRM.js";
 import {
   runDocs
-} from "./chunk-KFL3XHMA.js";
+} from "./chunk-AYPXY3HF.js";
 import {
   runDeps
-} from "./chunk-MCH6IKK7.js";
+} from "./chunk-E2RJZQNW.js";
 import {
   assertHistoryRepairTarget,
   runHistoryRepair,
   runHistoryRepairAll
-} from "./chunk-FJR2S7S4.js";
+} from "./chunk-CYBW4HK7.js";
 import {
   resolveStartTaskInProgressStatus,
   runClaim,
@@ -25,67 +25,67 @@ import {
   runTest,
   runTestAll,
   runValidate
-} from "./chunk-ASMRSIDX.js";
+} from "./chunk-HWUIK7YL.js";
 import {
   runComments
-} from "./chunk-EEJKHF7M.js";
+} from "./chunk-7TRVVYPI.js";
 import {
   runCopy
-} from "./chunk-FFB3WITE.js";
+} from "./chunk-DT6NDP53.js";
 import {
   runFocus
-} from "./chunk-7TBUV7XS.js";
+} from "./chunk-DNHILSD7.js";
 import {
   runDelete
-} from "./chunk-UH6VFRV6.js";
+} from "./chunk-J3Z2JMDV.js";
 import {
   runAppend
-} from "./chunk-GSQVQINP.js";
+} from "./chunk-FBD2WUNS.js";
 import {
   runProfileApply,
   runProfileLint,
   runProfileList,
   runProfileShow
-} from "./chunk-MYHFZNBO.js";
+} from "./chunk-JFOBTM4D.js";
 import {
   runNotes
-} from "./chunk-QJZM5WO5.js";
+} from "./chunk-7TRCAREE.js";
 import {
   runLearnings
-} from "./chunk-WVEMZZCR.js";
+} from "./chunk-TEKAGPZV.js";
 import {
   runCloseMany
-} from "./chunk-YQEKE4FO.js";
+} from "./chunk-DLHFJZ2S.js";
 import {
   runUpdateMany
-} from "./chunk-EYPIUFWJ.js";
+} from "./chunk-62KPBB2W.js";
 import {
   runRestore
-} from "./chunk-NGBWEYNY.js";
+} from "./chunk-W2FXYQ6D.js";
 import {
   runUpdate
-} from "./chunk-DUBC6TI3.js";
+} from "./chunk-YA4B6P3L.js";
 import {
   runClose
-} from "./chunk-RDJXIAJB.js";
+} from "./chunk-SMKQFGDI.js";
 import {
   runPlan
-} from "./chunk-SN5X5GTU.js";
+} from "./chunk-PEACKWHL.js";
 import {
   runHistoryCompact
-} from "./chunk-UIHDZS6X.js";
+} from "./chunk-HFQ7QQZL.js";
 import {
   runHistoryRedact
-} from "./chunk-K52C6YPA.js";
+} from "./chunk-QTJCMK2S.js";
 import {
   runConfig,
   runUpgrade
-} from "./chunk-P2WE5KCU.js";
+} from "./chunk-AKCHJXJ4.js";
 import {
   SCAFFOLD_CAPABILITIES,
   runExtension,
   runInit
-} from "./chunk-FL625JJM.js";
+} from "./chunk-Z3R2Z5KW.js";
 import {
   runSchemaAddField,
   runSchemaAddStatus,
@@ -100,7 +100,7 @@ import {
   runSchemaShow,
   runSchemaShowField,
   runSchemaShowStatus
-} from "./chunk-UURYLDDC.js";
+} from "./chunk-WZ7EPGUX.js";
 import {
   jaccardSimilarity,
   normalizeLowercaseWhitespace,
@@ -111,17 +111,17 @@ import {
   runNext,
   runSearch,
   tokenizeAlphaNumeric
-} from "./chunk-TTCJCKUJ.js";
+} from "./chunk-SL337EYZ.js";
 import {
   buildListQueryFilters,
   runList
-} from "./chunk-RLHQ3G4M.js";
+} from "./chunk-Z5MFM54X.js";
 import {
   runHistory
-} from "./chunk-LHDHS4Z6.js";
+} from "./chunk-4QE5HOJY.js";
 import {
   parseIntegerLimit
-} from "./chunk-BFNFTHWQ.js";
+} from "./chunk-O67XP4FD.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -148,7 +148,7 @@ import {
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores,
   writeVectorizationStatusLedger
-} from "./chunk-PJPZTE7P.js";
+} from "./chunk-A62N3BM3.js";
 import {
   ACTIVITY_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -181,19 +181,19 @@ import {
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   toCompletionFlagString
-} from "./chunk-TR2C6V5T.js";
+} from "./chunk-EXG6XTJC.js";
 import {
   runCreate
-} from "./chunk-XPSGJ4IV.js";
+} from "./chunk-OVYXSZOQ.js";
 import {
   parseTags
-} from "./chunk-CGDUIPJL.js";
+} from "./chunk-22PW73KV.js";
 import {
   splitCommaList
 } from "./chunk-5HIZDR5A.js";
 import {
   projectMutationResult
-} from "./chunk-C6XSTACC.js";
+} from "./chunk-TTRL5GE6.js";
 import {
   PmCliError,
   acquireLock,
@@ -201,6 +201,7 @@ import {
   collectRegisteredItemFieldNames,
   compareTimestampStrings,
   createHistoryEntry,
+  createSerialQueue,
   getActiveExtensionRegistrations,
   isTerminalStatus,
   listAllDocumentCandidatesCached,
@@ -222,7 +223,7 @@ import {
   setActiveExtensionRenderers,
   setActiveExtensionServices,
   toItemRecord
-} from "./chunk-BPJ5NYSJ.js";
+} from "./chunk-F7UA74OZ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -249,7 +250,7 @@ import {
   toErrorMessage,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.js";
 
 // dist/sdk/runtime.js
 import path3 from "node:path";
@@ -292,43 +293,6 @@ function withQuerySummary(result, options) {
   };
 }
 
-// dist/core/shared/serial-queue.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] = "76b8d242-9348-5daf-9085-901aa5f84197");
-  } catch (e2) {
-  }
-})();
-function createSerialQueue() {
-  let tail = Promise.resolve();
-  let pending = 0;
-  const idleWaiters = [];
-  const notifyIdle = () => {
-    if (pending !== 0) {
-      return;
-    }
-    const waiters = idleWaiters.splice(0);
-    for (const resolve of waiters) {
-      resolve();
-    }
-  };
-  return {
-    enqueue(task) {
-      pending++;
-      const run = tail.then(() => task());
-      tail = run.then(() => void 0, () => void 0).finally(() => {
-        pending--;
-        notifyIdle();
-      });
-      return run;
-    },
-    idle() {
-      return pending === 0 ? Promise.resolve() : new Promise((resolve) => idleWaiters.push(resolve));
-    }
-  };
-}
-
 // dist/sdk/workspace-contracts-cache.js
 !(function() {
   try {
@@ -1186,11 +1150,11 @@ function toExcerpt(content, maxLines, maxCharacters) {
 async function renderGuideDocs(topic, depth, packageRoot) {
   const includeContent = depth !== "brief";
   const contentMode = includeContent ? depth === "deep" ? "full" : "excerpt" : "none";
-  const docs = [];
+  const docs2 = [];
   for (const doc of topic.docs) {
     const absolutePath = path.resolve(packageRoot, doc.path);
     if (!includeContent) {
-      docs.push({
+      docs2.push({
         path: doc.path,
         purpose: doc.purpose,
         optional: doc.optional === true,
@@ -1206,7 +1170,7 @@ async function renderGuideDocs(topic, depth, packageRoot) {
       const rawContent = await readFile(absolutePath, "utf8");
       if (depth === "deep") {
         const normalized = normalizeLineEndings(rawContent).trimEnd();
-        docs.push({
+        docs2.push({
           path: doc.path,
           purpose: doc.purpose,
           optional: doc.optional === true,
@@ -1218,7 +1182,7 @@ async function renderGuideDocs(topic, depth, packageRoot) {
         });
       } else {
         const excerpt = toExcerpt(rawContent, 120, 12e3);
-        docs.push({
+        docs2.push({
           path: doc.path,
           purpose: doc.purpose,
           optional: doc.optional === true,
@@ -1232,7 +1196,7 @@ async function renderGuideDocs(topic, depth, packageRoot) {
     } catch (error) {
       const code = error?.code;
       const missing = code === "ENOENT";
-      docs.push({
+      docs2.push({
         path: doc.path,
         purpose: doc.purpose,
         optional: doc.optional === true,
@@ -1247,7 +1211,7 @@ async function renderGuideDocs(topic, depth, packageRoot) {
       }
     }
   }
-  return docs;
+  return docs2;
 }
 function buildGuideIndex(depth) {
   const topics = listGuideTopics().map((topic) => ({
@@ -1290,15 +1254,15 @@ async function runGuide(options, global2) {
   }
   const topic = ensureGuideTopic(topicRaw);
   const packageRoot = resolvePackageRoot();
-  const docs = await renderGuideDocs(topic, depth, packageRoot);
-  const warnings = docs.filter((doc) => !doc.exists && !doc.optional).map((doc) => `Missing required guide document: ${doc.path}`);
+  const docs2 = await renderGuideDocs(topic, depth, packageRoot);
+  const warnings = docs2.filter((doc) => !doc.exists && !doc.optional).map((doc) => `Missing required guide document: ${doc.path}`);
   return {
     output_default: "toon",
     mode: "topic",
     depth,
     requested_topic: topicRaw,
     topic,
-    docs,
+    docs: docs2,
     warnings
   };
 }
@@ -1378,7 +1342,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] = "6aac8389-5103-50a6-98bd-fde0720289ba");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "470e1fde-dbda-54fe-b821-9175c37b1cd3");
   } catch (e2) {
   }
 })();
@@ -2064,6 +2028,8 @@ _pm() {
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
             '--deadline-before[Filter by deadline upper bound (ISO/date string or relative)]:date' \\
             '--deadline-after[Filter by deadline lower bound (ISO/date string or relative)]:date' \\
+            '--today[Filter to items updated since local midnight today]' \\
+            '--recent[Filter to items updated in the last 7 days]' \\
             '--updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp' \\
             '--updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp' \\
             '--created-after[Filter by created_at lower bound (ISO/relative)]:timestamp' \\
@@ -2566,6 +2532,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           _arguments \\
             '--action[Filter schema by tool action]:action' \\
             '--command[Scope output to one command (narrow-by-default)]:command' \\
+            '--summary[Return compact command intent summary]' \\
             '--schema-only[Return schema-only payload]' \\
             '--flags-only[Return command flag contracts only]' \\
             '--availability-only[Return action availability only]' \\
@@ -3041,6 +3008,8 @@ for list_cmd in ${listCmds}
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l stream -d 'Emit line-delimited JSON rows (requires --json)'
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-before -d 'Filter by deadline upper bound (ISO/date string or relative)' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-after  -d 'Filter by deadline lower bound (ISO/date string or relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l today -d 'Filter to items updated since local midnight today'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l recent -d 'Filter to items updated in the last 7 days'
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-after  -d 'Filter by updated_at lower bound (ISO/relative)' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-before -d 'Filter by updated_at upper bound (ISO/relative)' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-after  -d 'Filter by created_at lower bound (ISO/relative)' -r
@@ -3535,6 +3504,7 @@ complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full a
 complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
+complete -c pm -n '__fish_seen_subcommand_from contracts' -l summary -d 'Return compact command intent summary'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l schema-only -d 'Return schema-only payload'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l flags-only -d 'Return command flag contracts only'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l availability-only -d 'Return action availability only'
@@ -4025,7 +3995,7 @@ function resolveCommentsAuditLimits(options) {
   };
 }
 function toCommentsAuditEntry(item, latest) {
-  const comments = item.comments ?? [];
+  const comments2 = item.comments ?? [];
   return {
     id: item.id,
     title: item.title,
@@ -4033,8 +4003,8 @@ function toCommentsAuditEntry(item, latest) {
     status: item.status,
     assignee: item.assignee ?? null,
     updated_at: item.updated_at,
-    comment_count: comments.length,
-    comments: latest === void 0 ? comments : limitComments(comments, latest)
+    comment_count: comments2.length,
+    comments: latest === void 0 ? comments2 : limitComments(comments2, latest)
   };
 }
 function buildCommentsAuditFilters(options, status, limitItems, latest, fullHistory) {
@@ -4925,15 +4895,15 @@ function parseMode2(raw) {
   }
   throw new PmCliError("Reindex mode must be one of keyword|semantic|hybrid", EXIT_CODE.USAGE);
 }
-async function loadDocumentCandidates(pmRoot, itemFormat, typeToFolder, schema) {
+async function loadDocumentCandidates(pmRoot, itemFormat, typeToFolder, schema2) {
   const warnings = [];
-  const candidates = await listAllDocumentCandidatesCached(pmRoot, itemFormat, typeToFolder, warnings, schema);
+  const candidates = await listAllDocumentCandidatesCached(pmRoot, itemFormat, typeToFolder, warnings, schema2);
   return {
     candidates,
     warnings
   };
 }
-async function hydrateDocuments(pmRoot, candidates, schema, warnings, itemIds) {
+async function hydrateDocuments(pmRoot, candidates, schema2, warnings, itemIds) {
   const extensionFieldNames = collectRegisteredItemFieldNames(getActiveExtensionRegistrations());
   const hydrated = [];
   for (const candidate of candidates) {
@@ -4951,7 +4921,7 @@ async function hydrateDocuments(pmRoot, candidates, schema, warnings, itemIds) {
       const raw = await fs.readFile(candidate.item_path, "utf8");
       const parsed = parseItemDocument(raw, {
         format: candidate.item_format,
-        schema,
+        schema: schema2,
         extensionFieldNames,
         onWarning: (warning) => warnings.push(warning)
       });
@@ -5566,17 +5536,12 @@ 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] = "6781d5a3-3e21-5198-a534-fb2be114b6e1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a1d2566f-bb81-5e21-aaab-f501f90657ed");
   } catch (e2) {
   }
 })();
-function splitClientMutationOptions(options) {
-  const { fullChangedFields, idOnly, ...runnerOptions } = options;
-  return {
-    ...fullChangedFields === void 0 ? {} : { fullChangedFields },
-    ...idOnly === void 0 ? {} : { idOnly },
-    options: runnerOptions
-  };
+function splitFullClientMutationOptions(options) {
+  return { fullChangedFields: true, options };
 }
 var PmClient = class {
   defaults;
@@ -5642,83 +5607,279 @@ var PmClient = class {
   stats(options = {}) {
     return this.runTyped("stats", { options });
   }
+  /**
+   * List, add, edit, or delete item comments.
+   */
+  comments(id, options = {}) {
+    return this.runTyped("comments", { id, options });
+  }
+  /**
+   * List or append private item notes.
+   */
+  notes(id, options = {}) {
+    return this.runTyped("notes", { id, options });
+  }
+  /**
+   * List or append durable item learnings.
+   */
+  learnings(id, options = {}) {
+    return this.runTyped("learnings", { id, options });
+  }
+  /**
+   * Add, remove, clear, or list linked project files for an item.
+   */
+  files(id, options = {}) {
+    return this.runTyped("files", { id, options });
+  }
+  /**
+   * Discover and optionally attach changed files for an item.
+   */
+  filesDiscover(id, options = {}) {
+    return this.runTyped("files-discover", { id, options });
+  }
+  /**
+   * Add, remove, clear, or list linked documentation for an item.
+   */
+  docs(id, options = {}) {
+    return this.runTyped("docs", { id, options });
+  }
+  /**
+   * Inspect item dependency relationships.
+   */
+  deps(id, options = {}) {
+    return this.runTyped("deps", { id, options });
+  }
+  /**
+   * Append markdown/body text to an item through the mutation pipeline.
+   */
+  append(id, body, options = {}) {
+    return this.runTyped("append", { id, ...splitFullClientMutationOptions({ ...options, body }) });
+  }
+  /**
+   * Initialize a workspace with the same semantics as `pm init`.
+   */
+  init(prefix, options = {}) {
+    return this.runTyped("init", { ...prefix === void 0 ? {} : { prefix }, options });
+  }
+  /**
+   * Read or update project/global configuration.
+   */
+  config(scope, configAction, key, value, options = {}) {
+    return this.runTyped("config", {
+      scope,
+      configAction,
+      ...key === void 0 ? {} : { key },
+      ...value === void 0 ? {} : { value },
+      options
+    });
+  }
+  /**
+   * Run the schema customization surface.
+   */
+  schema(subcommand, options = {}) {
+    return this.runTyped("schema", { options: { ...options, subcommand } });
+  }
+  /**
+   * List built-in, custom, and extension-provided schema types/statuses.
+   */
+  schemaList() {
+    return this.runTyped("schema", { options: { subcommand: "list" } });
+  }
+  /**
+   * Show a schema item type definition.
+   */
+  schemaShow(name) {
+    return this.runTyped("schema", { name, options: { subcommand: "show" } });
+  }
+  /**
+   * Register or replace a custom item type.
+   */
+  schemaAddType(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "add-type" } });
+  }
+  /**
+   * Remove a custom item type.
+   */
+  schemaRemoveType(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "remove-type" } });
+  }
+  /**
+   * Register or replace a custom status.
+   */
+  schemaAddStatus(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "add-status" } });
+  }
+  /**
+   * Remove a custom status.
+   */
+  schemaRemoveStatus(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "remove-status" } });
+  }
+  /**
+   * Register or replace a runtime custom field.
+   */
+  schemaAddField(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "add-field" } });
+  }
+  /**
+   * Remove a runtime custom field.
+   */
+  schemaRemoveField(name, options = {}) {
+    return this.runTyped("schema", { name, options: { ...options, subcommand: "remove-field" } });
+  }
+  /**
+   * List runtime custom fields.
+   */
+  schemaListFields() {
+    return this.runTyped("schema", { options: { subcommand: "list-fields" } });
+  }
+  /**
+   * Show one runtime custom field definition.
+   */
+  schemaShowField(name) {
+    return this.runTyped("schema", { name, options: { subcommand: "show-field" } });
+  }
+  /**
+   * Apply a built-in type preset to the workspace schema.
+   */
+  schemaApplyPreset(typePreset, options = {}) {
+    return this.runTyped("schema", { typePreset, options: { ...options, subcommand: "apply-preset" } });
+  }
+  /**
+   * Infer item types from the current tracker and optionally apply them.
+   */
+  schemaInferTypes(options = {}) {
+    return this.runTyped("schema", { options: { ...options, subcommand: "add-type", infer: true } });
+  }
+  /**
+   * Show one runtime status definition.
+   */
+  schemaShowStatus(name) {
+    return this.runTyped("schema", { name, options: { subcommand: "show-status" } });
+  }
+  /**
+   * Run the profile customization surface.
+   */
+  profile(subcommand, options = {}) {
+    return this.runTyped("profile", { options: { ...options, subcommand } });
+  }
+  /**
+   * List available project profiles.
+   */
+  profileList() {
+    return this.runTyped("profile", { options: { subcommand: "list" } });
+  }
+  /**
+   * Show a project profile.
+   */
+  profileShow(name) {
+    return this.runTyped("profile", { name, options: { subcommand: "show" } });
+  }
+  /**
+   * Apply a project profile.
+   */
+  profileApply(name, options = {}) {
+    return this.runTyped("profile", { name, options: { ...options, subcommand: "apply" } });
+  }
+  /**
+   * Lint a project profile.
+   */
+  profileLint(name) {
+    return this.runTyped("profile", { name, options: { subcommand: "lint" } });
+  }
+  /**
+   * Run project validation checks.
+   */
+  validate(options = {}) {
+    return this.runTyped("validate", { options });
+  }
+  /**
+   * Run project health checks.
+   */
+  health(options = {}) {
+    return this.runTyped("health", { options });
+  }
+  /**
+   * Run tracker cache/runtime garbage collection.
+   */
+  gc(options = {}) {
+    return this.runTyped("gc", { options });
+  }
   /**
    * Create an item using the same mutation path as `pm create`.
    */
   create(options = {}) {
-    return this.run("create", splitClientMutationOptions(options));
+    return this.runTyped("create", splitFullClientMutationOptions(options));
   }
   /**
    * Update an item using the same mutation path as `pm update`.
    */
   update(id, options = {}) {
-    return this.run("update", { id, ...splitClientMutationOptions(options) });
+    return this.runTyped("update", { id, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Close an item using the same mutation path as `pm close`.
    */
   close(id, reason, options = {}) {
-    return this.run("close", { id, reason, ...splitClientMutationOptions(options) });
+    return this.runTyped("close", { id, reason, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Claim an item using the same mutation path as `pm claim`.
    */
   claim(id, options = {}) {
-    return this.run("claim", { id, ...splitClientMutationOptions(options) });
+    return this.runTyped("claim", { id, ...splitFullClientMutationOptions(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) });
+    return this.runTyped("release", { id, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Copy an item using the same mutation path as `pm copy`.
    */
   copy(id, options = {}) {
-    return this.run("copy", { id, ...splitClientMutationOptions(options) });
+    return this.runTyped("copy", { id, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Delete an item using the same mutation path as `pm delete`.
    */
   delete(id, options = {}) {
-    return this.run("delete", { id, ...splitClientMutationOptions(options) });
+    return this.runTyped("delete", { id, ...splitFullClientMutationOptions(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 },
+    return this.runTyped("restore", {
+      fullChangedFields: true,
       id,
-      options: { ...runnerOptions, target }
+      options: { ...options, 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) });
+    return this.runTyped("focus", { ...id === void 0 ? {} : { id }, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Claim an item and transition it to the workspace in-progress status.
    */
   startTask(id, options = {}) {
-    return this.run("start-task", { id, ...splitClientMutationOptions(options) });
+    return this.runTyped("start-task", { id, ...splitFullClientMutationOptions(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) });
+    return this.runTyped("pause-task", { id, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Close an item and release its active assignment.
    */
   closeTask(id, reason, options = {}) {
-    return this.run("close-task", { id, reason, ...splitClientMutationOptions(options) });
+    return this.runTyped("close-task", { id, reason, ...splitFullClientMutationOptions(options) });
   }
   /**
    * Run the extension lifecycle surface with the same result shape as `pm extension`.
@@ -5841,6 +6002,102 @@ function aggregate(options = {}, clientOptions = {}) {
 function stats(options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).stats(options);
 }
+function comments(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).comments(id, options);
+}
+function notes(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).notes(id, options);
+}
+function learnings(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).learnings(id, options);
+}
+function files(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).files(id, options);
+}
+function filesDiscover(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).filesDiscover(id, options);
+}
+function docs(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).docs(id, options);
+}
+function deps(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).deps(id, options);
+}
+function append(id, body, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).append(id, body, options);
+}
+function init(prefix, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).init(prefix, options);
+}
+function config(scope, configAction, key, value, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).config(scope, configAction, key, value, options);
+}
+function schema(subcommand, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schema(subcommand, options);
+}
+function schemaList(clientOptions = {}) {
+  return new PmClient(clientOptions).schemaList();
+}
+function schemaShow(name, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaShow(name);
+}
+function schemaAddType(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaAddType(name, options);
+}
+function schemaRemoveType(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaRemoveType(name, options);
+}
+function schemaAddStatus(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaAddStatus(name, options);
+}
+function schemaRemoveStatus(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaRemoveStatus(name, options);
+}
+function schemaAddField(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaAddField(name, options);
+}
+function schemaRemoveField(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaRemoveField(name, options);
+}
+function schemaListFields(clientOptions = {}) {
+  return new PmClient(clientOptions).schemaListFields();
+}
+function schemaShowField(name, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaShowField(name);
+}
+function schemaApplyPreset(typePreset, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaApplyPreset(typePreset, options);
+}
+function schemaInferTypes(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaInferTypes(options);
+}
+function schemaShowStatus(name, clientOptions = {}) {
+  return new PmClient(clientOptions).schemaShowStatus(name);
+}
+function profile(subcommand, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).profile(subcommand, options);
+}
+function profileList(clientOptions = {}) {
+  return new PmClient(clientOptions).profileList();
+}
+function profileShow(name, clientOptions = {}) {
+  return new PmClient(clientOptions).profileShow(name);
+}
+function profileApply(name, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).profileApply(name, options);
+}
+function profileLint(name, clientOptions = {}) {
+  return new PmClient(clientOptions).profileLint(name);
+}
+function validate(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).validate(options);
+}
+function health(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).health(options);
+}
+function gc(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).gc(options);
+}
 function create(options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).create(options);
 }
@@ -6039,11 +6296,16 @@ var LIFECYCLE_AUTHOR_ALIAS_ACTIONS = /* @__PURE__ */ new Set([
 function normalizeMcpOptionsArrays(options, action) {
   const result = {};
   const promoteAddRemove = action !== void 0 && ARRAY_ADD_REMOVE_ACTIONS.has(action);
+  const preserveStandaloneNote = action === "files" || action === "files-discover" || action === "docs";
   for (const [key, value] of Object.entries(options)) {
     if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {
       result[key] = value.join(",");
       continue;
     }
+    if (key === "note" && preserveStandaloneNote) {
+      result[key] = value;
+      continue;
+    }
     if (typeof value === "string" && SCALAR_TO_ARRAY_FIELDS.has(key)) {
       result[key] = [value];
       continue;
@@ -6642,8 +6904,8 @@ function createMcpSchemaContext(ctx) {
     aliases: aliasSource === void 0 ? void 0 : readStringArray(aliasSource)
   };
 }
-function runMcpSchemaReadOrRemoveAction(schema) {
-  const { ctx, subcommand, name, author, force } = schema;
+function runMcpSchemaReadOrRemoveAction(schema2) {
+  const { ctx, subcommand, name, author, force } = schema2;
   const simpleHandlers = {
     list: () => runSchemaList(ctx.global),
     show: () => runSchemaShow(name, ctx.global),
@@ -6658,8 +6920,8 @@ function runMcpSchemaReadOrRemoveAction(schema) {
   const handler = getOwnHandler(simpleHandlers, subcommand);
   return handler ? handler() : null;
 }
-function runMcpSchemaAddFieldAction(schema) {
-  const { ctx, name, author, force, aliases } = schema;
+function runMcpSchemaAddFieldAction(schema2) {
+  const { ctx, name, author, force, aliases } = schema2;
   const commandsSource = ctx.args.commands ?? ctx.options.commands;
   const requiredTypesSource = ctx.args.requiredTypes ?? ctx.options.requiredTypes;
   return runSchemaAddField(name, {
@@ -6676,8 +6938,8 @@ function runMcpSchemaAddFieldAction(schema) {
     force
   }, ctx.global);
 }
-function runMcpSchemaAddStatusAction(schema) {
-  const { ctx, name, author, force, aliases } = schema;
+function runMcpSchemaAddStatusAction(schema2) {
+  const { ctx, name, author, force, aliases } = schema2;
   const roleSource = ctx.args.role ?? ctx.options.role;
   return runSchemaAddStatus(name, {
     role: roleSource === void 0 ? void 0 : readStringArray(roleSource),
@@ -6688,8 +6950,8 @@ function runMcpSchemaAddStatusAction(schema) {
     force
   }, ctx.global);
 }
-function runMcpSchemaAddTypeAction(schema) {
-  const { ctx, name, author, force, aliases } = schema;
+function runMcpSchemaAddTypeAction(schema2) {
+  const { ctx, name, author, force, aliases } = schema2;
   return runSchemaAddType(name, {
     description: readString(ctx.args, "description") ?? readString(ctx.options, "description"),
     defaultStatus: readString(ctx.args, "defaultStatus") ?? readString(ctx.args, "default_status") ?? readString(ctx.options, "defaultStatus") ?? readString(ctx.options, "default_status"),
@@ -6700,29 +6962,29 @@ function runMcpSchemaAddTypeAction(schema) {
   }, ctx.global);
 }
 function runMcpSchemaAction(ctx) {
-  const schema = createMcpSchemaContext(ctx);
-  const simpleResult = runMcpSchemaReadOrRemoveAction(schema);
+  const schema2 = createMcpSchemaContext(ctx);
+  const simpleResult = runMcpSchemaReadOrRemoveAction(schema2);
   if (simpleResult !== null) {
     return simpleResult;
   }
-  if (schema.subcommand === "add-field") {
-    return runMcpSchemaAddFieldAction(schema);
+  if (schema2.subcommand === "add-field") {
+    return runMcpSchemaAddFieldAction(schema2);
   }
-  if (schema.subcommand === "add-status") {
-    return runMcpSchemaAddStatusAction(schema);
+  if (schema2.subcommand === "add-status") {
+    return runMcpSchemaAddStatusAction(schema2);
   }
-  if (schema.subcommand === "add-type") {
+  if (schema2.subcommand === "add-type") {
     if (ctx.args.infer === true || ctx.options.infer === true) {
       return runSchemaInferTypes({
         minCount: parseMcpInteger(ctx.args.minCount ?? ctx.options.minCount, "schema infer minCount"),
         apply: ctx.args.apply === true || ctx.options.apply === true,
-        author: schema.author,
-        force: schema.force
+        author: schema2.author,
+        force: schema2.force
       }, ctx.global);
     }
-    return runMcpSchemaAddTypeAction(schema);
+    return runMcpSchemaAddTypeAction(schema2);
   }
-  throw new PmCliError(`Unknown pm schema subcommand "${schema.subcommand}". Allowed: add-type, remove-type, add-status, remove-status, add-field, remove-field, list-fields, show-field, apply-preset, list, show, show-status`, 64);
+  throw new PmCliError(`Unknown pm schema subcommand "${schema2.subcommand}". Allowed: add-type, remove-type, add-status, remove-status, add-field, remove-field, list-fields, show-field, apply-preset, list, show, show-status`, 64);
 }
 function runMcpProfileAction(ctx) {
   const subcommand = readString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
@@ -6963,6 +7225,38 @@ export {
   next,
   aggregate,
   stats,
+  comments,
+  notes,
+  learnings,
+  files,
+  filesDiscover,
+  docs,
+  deps,
+  append,
+  init,
+  config,
+  schema,
+  schemaList,
+  schemaShow,
+  schemaAddType,
+  schemaRemoveType,
+  schemaAddStatus,
+  schemaRemoveStatus,
+  schemaAddField,
+  schemaRemoveField,
+  schemaListFields,
+  schemaShowField,
+  schemaApplyPreset,
+  schemaInferTypes,
+  schemaShowStatus,
+  profile,
+  profileList,
+  profileShow,
+  profileApply,
+  profileLint,
+  validate,
+  health,
+  gc,
   create,
   update,
   close,
@@ -6996,4 +7290,4 @@ export {
   readRequiredString,
   runAction
 };
-//# sourceMappingURL=chunk-3FRNNVWY.js.map
+//# sourceMappingURL=chunk-7S2UC7S6.js.map