@unbrained/pm-cli 2026.7.6 → 2026.7.7

package/dist/sdk/runtime.d.ts

@@ -2,9 +2,15 @@ import { type ExtensionRegistrationRegistry } from "../core/extensions/index.js"
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { PmToolAction } from "./cli-contracts/enum-contracts.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
+import { type AggregateOptions, type AggregateResult } from "../cli/commands/index.js";
+import type { ContextOptions, ContextResult } from "../cli/commands/context.js";
+import type { GetOptions, GetResult } from "../cli/commands/get.js";
 import type { CloseManyCommandOptions } from "../cli/commands/close-many.js";
 import { type ContractsCommandOptions, type ContractsResult } from "../cli/commands/contracts.js";
-import type { ListOptions } from "../cli/commands/list.js";
+import type { ListOptions, ListResult } from "../cli/commands/list.js";
+import type { NextOptions, NextResult } from "../cli/commands/next.js";
+import type { SearchOptions, SearchResult } from "../cli/commands/search.js";
+import type { StatsCommandOptions, StatsResult } from "../cli/commands/stats.js";
 import type { UpdateManyCommandOptions } from "../cli/commands/update-many.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
@@ -26,6 +32,13 @@ export { isTimestampLiteral, nowIso } from "../core/shared/time.js";
 export { listAllFrontMatter, locateItem, readLocatedItem } from "../core/store/item-store.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 export { readSettings } from "../core/store/settings.js";
+export { runAggregate, type AggregateOptions, type AggregateResult, type AggregateRow, } from "../cli/commands/aggregate.js";
+export { CONTEXT_OUTPUT_VALUES, runContext, type BlockerEntry, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextResult, type HierarchyChild, type HierarchyNode, type HotFile, type ProgressEntry, type RecentContextItem, type StaleEntry, type TestHealthSummary, type WorkloadEntry, } from "../cli/commands/context.js";
+export { runGet, type GetOptions, type GetResult, } from "../cli/commands/get.js";
+export { runList, type ListCompactResult, type ListedItem, type ListOptions, type ListResult, type ListSortField, type ListSortOrder, type ListVerboseResult, } from "../cli/commands/list.js";
+export { NEXT_OUTPUT_VALUES, runNext, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, } from "../cli/commands/next.js";
+export { runSearch, type SearchCompactResult, type SearchHit, type SearchHitHighlight, type SearchMatchMode, type SearchOptions, type SearchResult, type SearchResultItem, type SearchVerboseResult, } from "../cli/commands/search.js";
+export { runStats, type StatsCommandOptions, type StatsResult, } from "../cli/commands/stats.js";
 export { renderCalendarMarkdown, renderCalendarToon, resolveCalendarOutputFormat, runCalendar, type CalendarOptions, type CalendarResult, } from "../cli/commands/calendar.js";
 export { renderGuideMarkdown, resolveGuideOutputFormat, runGuide, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, } from "../cli/commands/guide.js";
 export { runCompletion, type CompletionResult, type CompletionShell } from "../cli/commands/completion.js";
@@ -34,7 +47,6 @@ export { runDedupeAudit, type DedupeAuditCandidate, type DedupeAuditCluster, typ
 export { runDedupeMerge, type DedupeMergeChildReparent, type DedupeMergeCloseAction, type DedupeMergeDuplicateOutcome, type DedupeMergeOptions, type DedupeMergeResult, } from "../cli/commands/dedupe-merge.js";
 export { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from "../cli/commands/normalize.js";
 export { runReindex, type ReindexOptions, type ReindexResult } from "../cli/commands/reindex.js";
-export { runSearch, type SearchOptions, type SearchResult } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type CreateTemplateOptions, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
@@ -146,35 +158,166 @@ export declare class PmClient {
      * Run any native or extension-contributed action through the SDK dispatcher.
      */
     run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>;
+    private runTyped;
     /**
      * Return the same context snapshot produced by `pm context`.
      */
-    context(options?: PmActionOptions): Promise<unknown>;
+    context(options?: ContextOptions): Promise<ContextResult>;
     /**
      * List items with the MCP/agent compact defaults.
      */
-    list(options?: PmActionOptions): Promise<unknown>;
+    list(options?: ListOptions): Promise<ListResult>;
     /**
      * Search items with the MCP/agent compact defaults.
      */
-    search(query: string, options?: PmActionOptions): Promise<unknown>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult>;
     /**
      * Read one item by id.
      */
-    get(id: string, options?: PmActionOptions): Promise<unknown>;
+    get(id: string, options?: GetOptions): Promise<GetResult>;
+    /**
+     * Return the ranked next-work recommendation produced by `pm next`.
+     */
+    next(options?: NextOptions): Promise<NextResult>;
+    /**
+     * Group matching items with the same semantics as `pm aggregate`.
+     */
+    aggregate(options?: AggregateOptions): Promise<AggregateResult>;
+    /**
+     * Return project tracker statistics with the same sections as `pm stats`.
+     */
+    stats(options?: StatsCommandOptions): Promise<StatsResult>;
     /**
      * Create an item using the same mutation path as `pm create`.
      */
-    create(options: PmClientMutationOptions): Promise<unknown>;
+    create(options?: PmClientMutationOptions): Promise<unknown>;
     /**
      * Update an item using the same mutation path as `pm update`.
      */
-    update(id: string, options: PmClientMutationOptions): Promise<unknown>;
+    update(id: string, options?: PmClientMutationOptions): Promise<unknown>;
     /**
      * Close an item using the same mutation path as `pm close`.
      */
     close(id: string, reason: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Claim an item using the same mutation path as `pm claim`.
+     */
+    claim(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Release an item's active claim using the same mutation path as `pm release`.
+     */
+    release(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Copy an item using the same mutation path as `pm copy`.
+     */
+    copy(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Delete an item using the same mutation path as `pm delete`.
+     */
+    delete(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Restore an item to a history version or timestamp using `pm restore`.
+     */
+    restore(id: string, target: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Set, clear, or read workspace focus using the same path as `pm focus`.
+     */
+    focus(id?: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Claim an item and transition it to the workspace in-progress status.
+     */
+    startTask(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Move an item back to the workspace open status and release the claim.
+     */
+    pauseTask(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Close an item and release its active assignment.
+     */
+    closeTask(id: string, reason: string, options?: PmClientMutationOptions): Promise<unknown>;
 }
+/**
+ * Return the same context snapshot produced by `pm context` without constructing
+ * a reusable client.
+ */
+export declare function context(options?: ContextOptions, clientOptions?: PmClientOptions): Promise<ContextResult>;
+/**
+ * List items with the MCP/agent compact defaults without constructing a
+ * reusable client.
+ */
+export declare function list(options?: ListOptions, clientOptions?: PmClientOptions): Promise<ListResult>;
+/**
+ * Search items with the MCP/agent compact defaults without constructing a
+ * reusable client.
+ */
+export declare function search(query: string, options?: SearchOptions, clientOptions?: PmClientOptions): Promise<SearchResult>;
+/**
+ * Read one item by id without constructing a reusable client.
+ */
+export declare function get(id: string, options?: GetOptions, clientOptions?: PmClientOptions): Promise<GetResult>;
+/**
+ * Return the ranked next-work recommendation produced by `pm next` without
+ * constructing a reusable client.
+ */
+export declare function next(options?: NextOptions, clientOptions?: PmClientOptions): Promise<NextResult>;
+/**
+ * Group matching items with the same semantics as `pm aggregate` without
+ * constructing a reusable client.
+ */
+export declare function aggregate(options?: AggregateOptions, clientOptions?: PmClientOptions): Promise<AggregateResult>;
+/**
+ * Return project tracker statistics with the same sections as `pm stats`
+ * without constructing a reusable client.
+ */
+export declare function stats(options?: StatsCommandOptions, clientOptions?: PmClientOptions): Promise<StatsResult>;
+/**
+ * Create an item without constructing a reusable client.
+ */
+export declare function create(options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Update an item without constructing a reusable client.
+ */
+export declare function update(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Close an item without constructing a reusable client.
+ */
+export declare function close(id: string, reason: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Claim an item without constructing a reusable client.
+ */
+export declare function claim(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Release an item's active claim without constructing a reusable client.
+ */
+export declare function release(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Copy an item without constructing a reusable client.
+ */
+export declare function copy(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Delete an item without constructing a reusable client.
+ */
+export declare function deleteItem(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Restore an item without constructing a reusable client.
+ */
+export declare function restore(id: string, target: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Set, clear, or read workspace focus without constructing a reusable client.
+ */
+export declare function focus(id?: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Claim an item and transition it to in-progress without constructing a client.
+ */
+export declare function startTask(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Move an item to open and release it without constructing a client.
+ */
+export declare function pauseTask(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Close an item and release its active assignment without constructing a client.
+ */
+export declare function closeTask(id: string, reason: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
 /**
  * Implements get workspace contracts for the public runtime surface of this module.
  */

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!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")}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]="89db1e15-b152-57e2-910d-64ed77eb540b")}catch(e){}}();
 import path from "node:path";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
 import { activateExtensions, deactivateExtensions, loadExtensions, runActiveCommandHandler, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
@@ -24,7 +24,7 @@ import { clearWorkspaceContractsCache, memoizeWorkspaceExtensionRegistrations, }
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
 import { assertHistoryRepairTarget, runActivity, runAggregate, runAppend, runClaim, runClose, runCloseMany, runComments, runConfig, runContext, runCopy, runCreate, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runFocus, runGc, runGet, runHealth, runHistory, runHistoryCompact, runHistoryRedact, runHistoryRepair, runHistoryRepairAll, runInit, runLearnings, runList, runNext, runNotes, runPlan, runProfileApply, runProfileLint, runProfileList, runProfileShow, runRestore, runRelease, runSchemaAddField, runSchemaAddStatus, runSchemaAddType, runSchemaApplyPreset, runSchemaInferTypes, runSchemaList, runSchemaListFields, runSchemaRemoveField, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowField, runSchemaShowStatus, runSearch, runStats, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
 import { runContracts, } from "../cli/commands/contracts.js";
-import { resolveStartTaskInProgressStatus } from "../cli/register-operations.js";
+import { resolveStartTaskInProgressStatus } from "./start-task-status.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
@@ -45,6 +45,13 @@ export { isTimestampLiteral, nowIso } from "../core/shared/time.js";
 export { listAllFrontMatter, locateItem, readLocatedItem } from "../core/store/item-store.js";
 export { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
 export { readSettings } from "../core/store/settings.js";
+export { runAggregate, } from "../cli/commands/aggregate.js";
+export { CONTEXT_OUTPUT_VALUES, runContext, } from "../cli/commands/context.js";
+export { runGet, } from "../cli/commands/get.js";
+export { runList, } from "../cli/commands/list.js";
+export { NEXT_OUTPUT_VALUES, runNext, } from "../cli/commands/next.js";
+export { runSearch, } from "../cli/commands/search.js";
+export { runStats, } from "../cli/commands/stats.js";
 export { renderCalendarMarkdown, renderCalendarToon, resolveCalendarOutputFormat, runCalendar, } from "../cli/commands/calendar.js";
 export { renderGuideMarkdown, resolveGuideOutputFormat, runGuide, } from "../cli/commands/guide.js";
 export { runCompletion } from "../cli/commands/completion.js";
@@ -53,7 +60,6 @@ export { runDedupeAudit, } from "../cli/commands/dedupe-audit.js";
 export { runDedupeMerge, } from "../cli/commands/dedupe-merge.js";
 export { runNormalize } from "../cli/commands/normalize.js";
 export { runReindex } from "../cli/commands/reindex.js";
-export { runSearch } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
@@ -95,40 +101,61 @@ export class PmClient {
     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) });
     }
     /**
@@ -137,6 +164,186 @@ export class PmClient {
     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 === undefined ? {} : { fullChangedFields }),
+            ...(idOnly === undefined ? {} : { 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 === undefined ? {} : { 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) });
+    }
+}
+/**
+ * Return the same context snapshot produced by `pm context` without constructing
+ * a reusable client.
+ */
+export function context(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).context(options);
+}
+/**
+ * List items with the MCP/agent compact defaults without constructing a
+ * reusable client.
+ */
+export function list(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).list(options);
+}
+/**
+ * Search items with the MCP/agent compact defaults without constructing a
+ * reusable client.
+ */
+export function search(query, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).search(query, options);
+}
+/**
+ * Read one item by id without constructing a reusable client.
+ */
+export function get(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).get(id, options);
+}
+/**
+ * Return the ranked next-work recommendation produced by `pm next` without
+ * constructing a reusable client.
+ */
+export function next(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).next(options);
+}
+/**
+ * Group matching items with the same semantics as `pm aggregate` without
+ * constructing a reusable client.
+ */
+export function aggregate(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).aggregate(options);
+}
+/**
+ * Return project tracker statistics with the same sections as `pm stats`
+ * without constructing a reusable client.
+ */
+export function stats(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).stats(options);
+}
+/**
+ * Create an item without constructing a reusable client.
+ */
+export function create(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).create(options);
+}
+/**
+ * Update an item without constructing a reusable client.
+ */
+export function update(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).update(id, options);
+}
+/**
+ * Close an item without constructing a reusable client.
+ */
+export function close(id, reason, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).close(id, reason, options);
+}
+/**
+ * Claim an item without constructing a reusable client.
+ */
+export function claim(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).claim(id, options);
+}
+/**
+ * Release an item's active claim without constructing a reusable client.
+ */
+export function release(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).release(id, options);
+}
+/**
+ * Copy an item without constructing a reusable client.
+ */
+export function copy(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).copy(id, options);
+}
+/**
+ * Delete an item without constructing a reusable client.
+ */
+export function deleteItem(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).delete(id, options);
+}
+/**
+ * Restore an item without constructing a reusable client.
+ */
+export function restore(id, target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).restore(id, target, options);
+}
+/**
+ * Set, clear, or read workspace focus without constructing a reusable client.
+ */
+export function focus(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).focus(id, options);
+}
+/**
+ * Claim an item and transition it to in-progress without constructing a client.
+ */
+export function startTask(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).startTask(id, options);
+}
+/**
+ * Move an item to open and release it without constructing a client.
+ */
+export function pauseTask(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).pauseTask(id, options);
+}
+/**
+ * Close an item and release its active assignment without constructing a client.
+ */
+export function closeTask(id, reason, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).closeTask(id, reason, options);
 }
 /**
  * Process-lifetime memo of activated extension registrations, keyed by resolved
@@ -271,6 +478,13 @@ const ARRAY_ADD_REMOVE_ACTIONS = new Set([
     "test",
     "test-all",
 ]);
+const LIFECYCLE_AUTHOR_ALIAS_ACTIONS = new Set([
+    "claim",
+    "release",
+    "start-task",
+    "pause-task",
+    "close-task",
+]);
 function normalizeMcpOptionsArrays(options, action) {
     const result = {};
     const promoteAddRemove = action !== undefined && ARRAY_ADD_REMOVE_ACTIONS.has(action);
@@ -317,6 +531,16 @@ function optionsWithAuthor(args, action) {
         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") {
@@ -331,7 +555,14 @@ function optionsWithAuthor(args, action) {
     }
     const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
     const author = readString(args, "author");
-    return author && options.author === undefined ? { ...options, author } : options;
+    const authorFromAssignee = action !== undefined && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readString(args, "assignee") ?? readString(options, "assignee") : undefined;
+    if (author && options.author === undefined) {
+        return { ...options, author };
+    }
+    if (authorFromAssignee && options.author === undefined) {
+        return { ...options, author: authorFromAssignee };
+    }
+    return options;
 }
 // GH-170 (pm-pfnx): the narrow pm_files/pm_docs tools spell the CLI --note flag
 // as `addNote` (the shared `note` parameter is the array-typed create/update
@@ -1120,7 +1351,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);
@@ -1128,7 +1369,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) {
@@ -1136,7 +1377,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 };
 }
@@ -1259,4 +1500,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=86af7c43-06f8-5e32-87ee-676c070b7e71
+//# debugId=89db1e15-b152-57e2-910d-64ed77eb540b